NDIS驱动开发笔记整理之NDIS_PACKET,NDIS_BUFFER的关系

1. //     
2. // NDIS_PACKET结构的定义    
3. //     
4. typedef struct _NDIS_PACKET    
5. {    
6. NDIS_PACKET_PRIVATE Private;    
7. //这个其实是一个链表结构,Private.Head指向第一个链表,Private.Tail指向最后一个    
8. //以下有关于这个结构的解释    
9.   
10. union    
11. {    
12. struct // For Connection-less miniports     
13. {    
14. UCHAR MiniportReserved[2*sizeof(PVOID)];    
15. UCHAR WrapperReserved[2*sizeof(PVOID)];    
16. };    
17.   
18. struct    
19. {    
20. //     
21. // For de-serialized miniports. And by implication conn-oriented miniports.     
22. // This is for the send-path only. Packets indicated will use WrapperReserved     
23. // instead of WrapperReservedEx     
24. //     
25. UCHAR MiniportReservedEx[3*sizeof(PVOID)];    
26. UCHAR WrapperReservedEx[sizeof(PVOID)];    
27. };    
28.   
29. struct    
30. {    
31. UCHAR MacReserved[4*sizeof(PVOID)];    
32. };    
33. };    
34.   
35. ULONG_PTR Reserved[2]; // For compatibility with Win    
36. UCHAR ProtocolReserved[1];    
37.   
38. } NDIS_PACKET, *PNDIS_PACKET, **PPNDIS_PACKET;    
39.   
40. // NDIS_PACKET_PRIVATE 的定义    
41. typedef struct _NDIS_PACKET_PRIVATE    
42. {    
43. UINT PhysicalCount; // number of physical pages in packet.     
44. UINT TotalLength; // Total amount of data in the packet.     
45. PNDIS_BUFFER Head; // 链表指针,指向第一个  
46. PNDIS_BUFFER Tail; // 链表指针,指向最后一个    
47.   
48. // if Head is NULL the chain is empty; Tail doesn\'t have to be NULL also     
49.   
50. PNDIS_PACKET_POOL Pool; // so we know where to free it back to     
51. UINT Count;    
52. ULONG Flags;    
53. BOOLEAN ValidCounts;    
54. UCHAR NdisPacketFlags; // See fPACKET_xxx bits below     
55. USHORT NdisPacketOobOffset;    
56. } NDIS_PACKET_PRIVATE, * PNDIS_PACKET_PRIVATE;    
57.   
58. //NDIS_BUFFER定义 其实就是一个内存描述符  
59.   
60. typedef struct _NDIS_BUFFER {    
61. struct _NDIS_BUFFER *Next; //指向下一个节点的指针  
62. PVOID VirtualAddress;      //指向报文首地址  
63. PNDIS_BUFFER_POOL Pool;    
64. UINT Length;               //报文数据长度  
65. UINT Signature;    
66. } NDIS_BUFFER, * PNDIS_BUFFER;    

注释写的很清楚了  那么他们的关系还是不清楚的话看看附图

 NDIS_PACKET只不过是一个关于NDIS_BUFFER链表的结构  在NDIS_PACKET中的成员Private中有指向第一个NDIS_BUFFER的指针和指向最后一个NDIS_BUFFER的指针  分别是Private.Head和Private.Tail ，而NDIS_BUFFER中就记录了数据包的地址和下一个NDIS_BUFFER的地址  操作有很多种方法   由于这些结构体本来对我们是不透明的   所以最安全的方法是用MS提供的一系列函数来操作NDIS_PACKET和NDIS_BUFFER  

  举个例子：

[cpp]  view plain  copy

1. NDIS_STATUS status ;  
2.     PNDIS_BUFFER NdisBuffer ;  
3.     UINT TotalPacketLength =, copysize =, DataOffset =, PhysicalBufferCount  ,  BufferCount   ;  
4.     PUCHAR mybuffer = NULL ,tembuffer = NULL ;    
5.   
6. //假设这个是在PtReceive等函数中得到的PACKET  
7. NdisQueryPacket(packet                     //我们先得到第一个NDISBUFFER 的指针     
8.         , &PhysicalBufferCount                     //物理中断的缓冲区数量
9.         , &BufferCount                             //包的缓冲区数据符的数量
10.         ,&NdisBuffer                               //NdisBuffer就是指向链表头  
11.         , &TotalPacketLength                       //数据包总数量的长度
12.         );  
13. /* 
14. 其实也可以不用那么麻烦 直接  NdisBuffer = packet->Private.Head ;就可以取得第一个BUFFER了 
15. */  
16.   
17.     status = NdisAllocateMemory( &mybuffer, 2048, 0, HighestAcceptableMax );  //分配我们自己的内存块  
18.   
19.     if( status != NDIS_STATUS_SUCCESS )  
20.         return NDIS_STATUS_FAILURE ;  
21.   
22.     NdisZeroMemory( mybuffer,) ;  
23.   
24.     NdisQueryBufferSafe(  //取得NDIS_BUFFER描述符中数据的首地址和大小  
25.                                 NdisBuffer,  
26.                                 &tembuffer,  
27.                                 ©size,  
28.                                 NormalPagePriority  
29.     );    
30.        
31.         //将数据复制到我们的内存中  
32.     NdisMoveMemory(mybuffer, tembuffer, copysize) ;  
33.   
34.     DataOffset = copysize ;  
35.   
36.     while(1)  
37.     {  
38.         /* 
39.                 也可以这样操作而不用NdisGetNextBuffer 
40.         if(NdisBuffer->Next == packet->Private.Tail ) 
41.             break ; 
42.  
43.         NdisBuffer = NdisBuffer->Next ; 
44.  
45.         if(pmdl == NULL ) 
46.            break ; 
47.            */  
48.         //获得下一个NDIS_BUFFER的的指针  
49.     NdisGetNextBuffer(NdisBuffer , &NdisBuffer ) ;  
50.         //如果指针是NULL  那么表示到链表尾了  
51.     if( NdisBuffer == NULL )  
52.         break ;  
53.   
54.     NdisQueryBufferSafe(  
55.                                 NdisBuffer,  
56.                                 &tembuffer,  
57.                                 ©size,  
58.                                 NormalPagePriority  
59.                                 ) ;  
60.   
61.     NdisMoveMemory( mybuffer + DataOffset , tembuffer, copysize) ;  
62.   
63.     DataOffset += copysize  ;  
64.   
65.     }  
66.   
67. //OK  我们要的数据就全部都在我们申请的内存mybuffer 数据大小为DataOffset