2 * COPYRIGHT: See COPYING in the top level directory
3 * PROJECT: ReactOS NDIS library
5 * PURPOSE: Buffer management routines
6 * PROGRAMMERS: Casper S. Hornstrup (chorns@users.sourceforge.net)
8 * CSH 01/08-2000 Created
14 __inline ULONG
SkipToOffset(
20 * FUNCTION: Skips Offset bytes into a buffer chain
22 * Buffer = Pointer to NDIS buffer
23 * Offset = Number of bytes to skip
24 * Data = Address of a pointer that on return will contain the
25 * address of the offset in the buffer
26 * Size = Address of a pointer that on return will contain the
27 * size of the destination buffer
29 * Offset into buffer, -1 if buffer chain was smaller than Offset bytes
39 NdisQueryBuffer(Buffer
, (PVOID
)Data
, Size
);
42 *Data
= (PUCHAR
) ((ULONG_PTR
) *Data
+ Offset
);
49 NdisGetNextBuffer(Buffer
, &Buffer
);
55 UINT
CopyBufferToBufferChain(
56 PNDIS_BUFFER DstBuffer
,
61 * FUNCTION: Copies data from a buffer to an NDIS buffer chain
63 * DstBuffer = Pointer to destination NDIS buffer
64 * DstOffset = Destination start offset
65 * SrcData = Pointer to source buffer
66 * Length = Number of bytes to copy
68 * Number of bytes copied to destination buffer
70 * The number of bytes copied may be limited by the destination
74 UINT BytesCopied
, BytesToCopy
, DstSize
;
77 NDIS_DbgPrint(MAX_TRACE
, ("DstBuffer (0x%X) DstOffset (0x%X) SrcData (0x%X) Length (%d)\n", DstBuffer
, DstOffset
, SrcData
, Length
));
79 /* Skip DstOffset bytes in the destination buffer chain */
80 if (SkipToOffset(DstBuffer
, DstOffset
, &DstData
, &DstSize
) == -1)
83 /* Start copying the data */
86 BytesToCopy
= MIN(DstSize
, Length
);
88 RtlCopyMemory((PVOID
)DstData
, (PVOID
)SrcData
, BytesToCopy
);
89 BytesCopied
+= BytesToCopy
;
90 SrcData
= (PUCHAR
) ((ULONG_PTR
) SrcData
+ BytesToCopy
);
92 Length
-= BytesToCopy
;
96 DstSize
-= BytesToCopy
;
98 /* No more bytes in desination buffer. Proceed to
99 the next buffer in the destination buffer chain */
100 NdisGetNextBuffer(DstBuffer
, &DstBuffer
);
104 NdisQueryBuffer(DstBuffer
, (PVOID
)&DstData
, &DstSize
);
112 UINT
CopyBufferChainToBuffer(
114 PNDIS_BUFFER SrcBuffer
,
118 * FUNCTION: Copies data from an NDIS buffer chain to a buffer
120 * DstData = Pointer to destination buffer
121 * SrcBuffer = Pointer to source NDIS buffer
122 * SrcOffset = Source start offset
123 * Length = Number of bytes to copy
125 * Number of bytes copied to destination buffer
127 * The number of bytes copied may be limited by the source
131 UINT BytesCopied
, BytesToCopy
, SrcSize
;
134 NDIS_DbgPrint(MAX_TRACE
, ("DstData 0x%X SrcBuffer 0x%X SrcOffset 0x%X Length %d\n",DstData
,SrcBuffer
, SrcOffset
, Length
));
136 /* Skip SrcOffset bytes in the source buffer chain */
137 if (SkipToOffset(SrcBuffer
, SrcOffset
, &SrcData
, &SrcSize
) == -1)
140 /* Start copying the data */
143 BytesToCopy
= MIN(SrcSize
, Length
);
145 NDIS_DbgPrint(MAX_TRACE
, ("Copying (%d) bytes from 0x%X to 0x%X\n", BytesToCopy
, SrcData
, DstData
));
147 RtlCopyMemory((PVOID
)DstData
, (PVOID
)SrcData
, BytesToCopy
);
148 BytesCopied
+= BytesToCopy
;
149 DstData
= (PUCHAR
)((ULONG_PTR
) DstData
+ BytesToCopy
);
151 Length
-= BytesToCopy
;
155 SrcSize
-= BytesToCopy
;
157 /* No more bytes in source buffer. Proceed to
158 the next buffer in the source buffer chain */
159 NdisGetNextBuffer(SrcBuffer
, &SrcBuffer
);
163 NdisQueryBuffer(SrcBuffer
, (PVOID
)&SrcData
, &SrcSize
);
171 UINT
CopyPacketToBuffer(
173 PNDIS_PACKET SrcPacket
,
177 * FUNCTION: Copies data from an NDIS packet to a buffer
179 * DstData = Pointer to destination buffer
180 * SrcPacket = Pointer to source NDIS packet
181 * SrcOffset = Source start offset
182 * Length = Number of bytes to copy
184 * Number of bytes copied to destination buffer
186 * The number of bytes copied may be limited by the source
190 PNDIS_BUFFER FirstBuffer
;
195 NDIS_DbgPrint(MAX_TRACE
, ("DstData (0x%X) SrcPacket (0x%X) SrcOffset (0x%X) Length (%d)\n", DstData
, SrcPacket
, SrcOffset
, Length
));
197 NdisGetFirstBufferFromPacket(SrcPacket
,
203 return CopyBufferChainToBuffer(DstData
, FirstBuffer
, SrcOffset
, Length
);
207 UINT
CopyPacketToBufferChain(
208 PNDIS_BUFFER DstBuffer
,
210 PNDIS_PACKET SrcPacket
,
214 * FUNCTION: Copies data from an NDIS packet to an NDIS buffer chain
216 * DstBuffer = Pointer to destination NDIS buffer
217 * DstOffset = Destination start offset
218 * SrcPacket = Pointer to source NDIS packet
219 * SrcOffset = Source start offset
220 * Length = Number of bytes to copy
222 * Number of bytes copied to destination buffer
224 * The number of bytes copied may be limited by the source and
225 * destination buffer sizes
228 PNDIS_BUFFER SrcBuffer
;
229 PUCHAR DstData
, SrcData
;
230 UINT DstSize
, SrcSize
;
233 NDIS_DbgPrint(MAX_TRACE
, ("DstBuffer (0x%X) DstOffset (0x%X) SrcPacket (0x%X) SrcOffset (0x%X) Length (%d)\n", DstBuffer
, DstOffset
, SrcPacket
, SrcOffset
, Length
));
235 /* Skip DstOffset bytes in the destination buffer chain */
236 NdisQueryBuffer(DstBuffer
, (PVOID
)&DstData
, &DstSize
);
237 if (SkipToOffset(DstBuffer
, DstOffset
, &DstData
, &DstSize
) == -1)
239 /* Skip SrcOffset bytes in the source packet */
240 NdisGetFirstBufferFromPacket(SrcPacket
, &SrcBuffer
, (PVOID
)&SrcData
, &SrcSize
, &Total
);
241 if (SkipToOffset(SrcBuffer
, SrcOffset
, &SrcData
, &SrcSize
) == -1)
245 /* Find out how many bytes we can copy at one time */
246 if (Length
< SrcSize
)
253 RtlCopyMemory((PVOID
)DstData
, (PVOID
)SrcData
, Count
);
262 /* No more bytes in destination buffer. Proceed to
263 the next buffer in the destination buffer chain */
264 NdisGetNextBuffer(DstBuffer
, &DstBuffer
);
268 NdisQueryBuffer(DstBuffer
, (PVOID
)&DstData
, &DstSize
);
273 /* No more bytes in source buffer. Proceed to
274 the next buffer in the source buffer chain */
275 NdisGetNextBuffer(SrcBuffer
, &SrcBuffer
);
279 NdisQueryBuffer(SrcBuffer
, (PVOID
)&SrcData
, &SrcSize
);
292 NdisAdjustBufferLength(
293 IN PNDIS_BUFFER Buffer
,
296 * FUNCTION: Modifies the length of an NDIS buffer
298 * Buffer = Pointer to NDIS buffer descriptor
299 * Length = New size of buffer
302 Buffer
->ByteCount
= Length
;
311 NDIS_BUFFER_TO_SPAN_PAGES(
312 IN PNDIS_BUFFER Buffer
)
314 * FUNCTION: Determines how many physical pages a buffer is made of
316 * Buffer = Pointer to NDIS buffer descriptor
319 if (MmGetMdlByteCount(Buffer
) == 0)
322 return ADDRESS_AND_SIZE_TO_SPAN_PAGES(
323 MmGetMdlVirtualAddress(Buffer
),
324 MmGetMdlByteCount(Buffer
));
334 OUT PNDIS_STATUS Status
,
335 OUT PNDIS_BUFFER
* Buffer
,
336 IN NDIS_HANDLE PoolHandle
,
337 IN PVOID VirtualAddress
,
340 * FUNCTION: Allocates an NDIS buffer descriptor
342 * Status = Address of buffer for status
343 * Buffer = Address of buffer for NDIS buffer descriptor
344 * PoolHandle = Handle returned by NdisAllocateBufferPool
345 * VirtualAddress = Pointer to virtual address of data buffer
346 * Length = Number of bytes in data buffer
350 PNETWORK_HEADER Temp
;
351 PNDIS_BUFFER_POOL Pool
= (PNDIS_BUFFER_POOL
)PoolHandle
;
353 NDIS_DbgPrint(MAX_TRACE
, ("Status (0x%X) Buffer (0x%X) PoolHandle (0x%X) "
354 "VirtualAddress (0x%X) Length (%d)\n",
355 Status
, Buffer
, PoolHandle
, VirtualAddress
, Length
));
358 Temp
= Pool
->FreeList
;
360 NDIS_DbgPrint(MID_TRACE
,("Free buffer -> %x\n", Temp
));
364 NDIS_DbgPrint(MID_TRACE
,("|:. <- End free buffers"));
367 if(!VirtualAddress
&& !Length
) return;
369 KeAcquireSpinLock(&Pool
->SpinLock
, &OldIrql
);
371 if (Pool
->FreeList
) {
372 Temp
= Pool
->FreeList
;
373 Pool
->FreeList
= Temp
->Next
;
375 KeReleaseSpinLock(&Pool
->SpinLock
, OldIrql
);
379 MmInitializeMdl(&Temp
->Mdl
, VirtualAddress
, Length
);
380 Temp
->Mdl
.MdlFlags
|= (MDL_SOURCE_IS_NONPAGED_POOL
| MDL_ALLOCATED_FIXED_SIZE
);
381 Temp
->Mdl
.MappedSystemVa
= VirtualAddress
;
383 Temp
->BufferPool
= Pool
;
385 *Buffer
= (PNDIS_BUFFER
)Temp
;
386 *Status
= NDIS_STATUS_SUCCESS
;
388 KeReleaseSpinLock(&Pool
->SpinLock
, OldIrql
);
389 *Status
= NDIS_STATUS_FAILURE
;
390 NDIS_DbgPrint(MID_TRACE
, ("Can't get another packet.\n"));
401 NdisAllocateBufferPool(
402 OUT PNDIS_STATUS Status
,
403 OUT PNDIS_HANDLE PoolHandle
,
404 IN UINT NumberOfDescriptors
)
406 * FUNCTION: Allocates storage for an NDIS buffer pool
408 * Status = Address of buffer for status
409 * PoolHandle = Address of buffer for pool handle
410 * NumberOfDescriptors = Size of buffer pool in number of descriptors
414 PNDIS_BUFFER_POOL Pool
;
415 PNETWORK_HEADER Buffer
;
417 NDIS_DbgPrint(MAX_TRACE
, ("Status (0x%X) PoolHandle (0x%X) NumberOfDescriptors (%d).\n",
418 Status
, PoolHandle
, NumberOfDescriptors
));
420 Pool
= ExAllocatePool(NonPagedPool
,
421 sizeof(NDIS_BUFFER_POOL
) +
422 sizeof(NETWORK_HEADER
) *
423 NumberOfDescriptors
);
425 KeInitializeSpinLock(&Pool
->SpinLock
);
427 if (NumberOfDescriptors
> 0) {
428 Buffer
= &Pool
->Buffers
[0];
429 NDIS_DbgPrint(MAX_TRACE
, ("NDIS BUFFER ADDRESS << %x >>\n", Buffer
));
430 Pool
->FreeList
= Buffer
;
431 for (i
= 1; i
< NumberOfDescriptors
; i
++) {
432 Buffer
->Next
= &Pool
->Buffers
[i
];
433 Buffer
= Buffer
->Next
;
434 NDIS_DbgPrint(MAX_TRACE
, ("NDIS BUFFER ADDRESS << %x >>\n",
439 Pool
->FreeList
= NULL
;
441 *Status
= NDIS_STATUS_SUCCESS
;
442 *PoolHandle
= (PNDIS_HANDLE
)Pool
;
444 *Status
= NDIS_STATUS_RESOURCES
;
454 OUT PNDIS_STATUS Status
,
455 OUT PNDIS_PACKET
* Packet
,
456 IN NDIS_HANDLE PoolHandle
)
458 * FUNCTION: Allocates an NDIS packet descriptor
460 * Status = Address of buffer for status
461 * Packet = Address of buffer for packet descriptor
462 * PoolHandle = Handle returned by NdisAllocatePacketPool
467 PNDIS_PACKET_POOL Pool
= (PNDIS_PACKET_POOL
)PoolHandle
;
469 NDIS_DbgPrint(MAX_TRACE
, ("Status (0x%X) Packet (0x%X) PoolHandle (0x%X).\n",
470 Status
, Packet
, PoolHandle
));
472 KeAcquireSpinLock(&Pool
->SpinLock
.SpinLock
, &OldIrql
);
474 if (Pool
->FreeList
) {
475 Temp
= Pool
->FreeList
;
476 Pool
->FreeList
= (PNDIS_PACKET
)Temp
->Private
.Head
;
478 KeReleaseSpinLock(&Pool
->SpinLock
.SpinLock
, OldIrql
);
480 RtlZeroMemory(&Temp
->Private
, sizeof(NDIS_PACKET_PRIVATE
));
481 Temp
->Private
.Pool
= Pool
;
484 *Status
= NDIS_STATUS_SUCCESS
;
486 *Status
= NDIS_STATUS_RESOURCES
;
487 KeReleaseSpinLock(&Pool
->SpinLock
.SpinLock
, OldIrql
);
497 NdisAllocatePacketPool(
498 OUT PNDIS_STATUS Status
,
499 OUT PNDIS_HANDLE PoolHandle
,
500 IN UINT NumberOfDescriptors
,
501 IN UINT ProtocolReservedLength
)
503 * FUNCTION: Allocates storage for an NDIS packet pool
505 * Status = Address of buffer for status
506 * PoolHandle = Address of buffer for pool handle
507 * NumberOfDescriptors = Size of packet pool in number of descriptors
508 * ProtocolReservedLength = Size of protocol reserved area in bytes
511 PNDIS_PACKET_POOL Pool
;
512 UINT Size
, Length
, i
;
513 PNDIS_PACKET Packet
, NextPacket
;
515 NDIS_DbgPrint(MAX_TRACE
, ("Status (0x%X) PoolHandle (0x%X) "
516 "NumberOfDescriptors (%d) ProtocolReservedLength (%d).\n",
517 Status
, PoolHandle
, NumberOfDescriptors
, ProtocolReservedLength
));
519 Length
= sizeof(NDIS_PACKET
) + ProtocolReservedLength
;
520 Size
= sizeof(NDIS_PACKET_POOL
) + Length
* NumberOfDescriptors
;
522 Pool
= ExAllocatePool(NonPagedPool
, Size
);
524 KeInitializeSpinLock(&Pool
->SpinLock
.SpinLock
);
525 Pool
->PacketLength
= Length
;
527 if (NumberOfDescriptors
> 0) {
528 Packet
= (PNDIS_PACKET
)&Pool
->Buffer
;
529 Pool
->FreeList
= Packet
;
531 NextPacket
= (PNDIS_PACKET
)((ULONG_PTR
)Packet
+ Length
);
532 for (i
= 1; i
< NumberOfDescriptors
; i
++) {
533 Packet
->Private
.Head
= (PNDIS_BUFFER
)NextPacket
;
535 NextPacket
= (PNDIS_PACKET
)((ULONG_PTR
)Packet
+ Length
);
537 Packet
->Private
.Head
= NULL
;
539 Pool
->FreeList
= NULL
;
541 *Status
= NDIS_STATUS_SUCCESS
;
542 *PoolHandle
= (PNDIS_HANDLE
)Pool
;
544 *Status
= NDIS_STATUS_RESOURCES
;
553 NdisAllocatePacketPoolEx(
554 OUT PNDIS_STATUS Status
,
555 OUT PNDIS_HANDLE PoolHandle
,
556 IN UINT NumberOfDescriptors
,
557 IN UINT NumberOfOverflowDescriptors
,
558 IN UINT ProtocolReservedLength
)
576 IN PNDIS_BUFFER Buffer
)
578 * FUNCTION: Modifies the length of an NDIS buffer
580 * Buffer = Pointer to NDIS buffer descriptor
581 * Length = New size of buffer
585 * Length of NDIS buffer
588 return Buffer
->ByteCount
;
597 NdisBufferVirtualAddress(
598 IN PNDIS_BUFFER Buffer
)
618 OUT PNDIS_STATUS Status
,
619 OUT PNDIS_BUFFER
*Buffer
,
620 IN NDIS_HANDLE PoolHandle
,
621 IN PVOID MemoryDescriptor
,
625 * FUNCTION: Returns a new buffer descriptor for a (partial) buffer
627 * Status = Address of a buffer to place status of operation
628 * Buffer = Address of a buffer to place new buffer descriptor
629 * PoolHandle = Handle returned by NdisAllocateBufferPool
630 * MemoryDescriptor = Pointer to a memory descriptor (possibly NDIS_BUFFER)
631 * Offset = Offset in buffer to start copying
632 * Length = Number of bytes to copy
635 *Status
= NDIS_STATUS_FAILURE
;
644 NdisCopyFromPacketToPacket(
645 IN PNDIS_PACKET Destination
,
646 IN UINT DestinationOffset
,
648 IN PNDIS_PACKET Source
,
649 IN UINT SourceOffset
,
650 OUT PUINT BytesCopied
)
652 * FUNCTION: Copies data from one packet to another
654 * Destination = Pointer to packet to copy data to
655 * DestinationOffset = Offset in destination packet to copy data to
656 * BytesToCopy = Number of bytes to copy
657 * Source = Pointer to packet descriptor to copy from
658 * SourceOffset = Offset in source packet to start copying from
659 * BytesCopied = Address of buffer to place number of bytes copied
662 PNDIS_BUFFER SrcBuffer
;
663 PNDIS_BUFFER DstBuffer
;
664 PUCHAR DstData
, SrcData
;
665 UINT DstSize
, SrcSize
;
670 /* Skip DestinationOffset bytes in the destination packet */
671 NdisGetFirstBufferFromPacket(Destination
, &DstBuffer
, (PVOID
)&DstData
, &DstSize
, &Total
);
672 if (SkipToOffset(DstBuffer
, DestinationOffset
, &DstData
, &DstSize
) == -1)
675 /* Skip SourceOffset bytes in the source packet */
676 NdisGetFirstBufferFromPacket(Source
, &SrcBuffer
, (PVOID
)&SrcData
, &SrcSize
, &Total
);
677 if (SkipToOffset(SrcBuffer
, SourceOffset
, &SrcData
, &SrcSize
) == -1)
682 /* Find out how many bytes we can copy at one time */
683 if (BytesToCopy
< SrcSize
)
690 RtlCopyMemory(DstData
, SrcData
, Count
);
693 BytesToCopy
-= Count
;
694 if (BytesToCopy
== 0)
699 /* No more bytes in destination buffer. Proceed to
700 the next buffer in the destination buffer chain */
701 NdisGetNextBuffer(DstBuffer
, &DstBuffer
);
705 NdisQueryBuffer(DstBuffer
, (PVOID
)&DstData
, &DstSize
);
710 /* No more bytes in source buffer. Proceed to
711 the next buffer in the source buffer chain */
712 NdisGetNextBuffer(SrcBuffer
, &SrcBuffer
);
716 NdisQueryBuffer(SrcBuffer
, (PVOID
)&SrcData
, &SrcSize
);
720 *BytesCopied
= Total
;
729 NdisDprAllocatePacket(
730 OUT PNDIS_STATUS Status
,
731 OUT PNDIS_PACKET
*Packet
,
732 IN NDIS_HANDLE PoolHandle
)
734 * FUNCTION: Allocates a packet at IRQL DISPATCH_LEVEL
736 * Status = Address of buffer to place status of operation
737 * Packet = Address of buffer to place a pointer to a packet descriptor
738 * PoolHandle = Handle returned by NdisAllocatePacketPool
749 NdisDprAllocatePacketNonInterlocked(
750 OUT PNDIS_STATUS Status
,
751 OUT PNDIS_PACKET
*Packet
,
752 IN NDIS_HANDLE PoolHandle
)
754 * FUNCTION: Allocates a packet at IRQL DISPATCH_LEVEL (w/o synchronization)
756 * Status = Address of buffer to place status of operation
757 * Packet = Address of buffer to place a pointer to a packet descriptor
758 * PoolHandle = Handle returned by NdisAllocatePacketPool
761 *Status
= NDIS_STATUS_FAILURE
;
771 IN PNDIS_PACKET Packet
)
773 * FUNCTION: Frees a packet at IRQL DISPATCH_LEVEL
775 * Packet = Pointer to packet to free
786 NdisDprFreePacketNonInterlocked(
787 IN PNDIS_PACKET Packet
)
789 * FUNCTION: Frees a packet at IRQL DISPATCH_LEVEL (w/o synchronization)
791 * Packet = Pointer to packet to free
803 IN NDIS_HANDLE PoolHandle
)
805 * FUNCTION: Frees storage allocated for an NDIS buffer pool
807 * PoolHandle = Handle returned by NdisAllocateBufferPool
810 ExFreePool((PVOID
)PoolHandle
);
820 IN NDIS_HANDLE PoolHandle
)
822 * FUNCTION: Frees storage allocated for an NDIS packet pool
824 * PoolHandle = Handle returned by NdisAllocatePacketPool
827 ExFreePool((PVOID
)PoolHandle
);
837 IN PNDIS_BUFFER Buffer
)
839 * FUNCTION: Puts an NDIS buffer descriptor back in it's pool
841 * Buffer = Pointer to buffer descriptor
845 PNDIS_BUFFER_POOL Pool
;
846 PNETWORK_HEADER Temp
= (PNETWORK_HEADER
)Buffer
;
848 NDIS_DbgPrint(MAX_TRACE
, ("Buffer (0x%X).\n", Buffer
));
850 Pool
= Temp
->BufferPool
;
852 KeAcquireSpinLock(&Pool
->SpinLock
, &OldIrql
);
853 Temp
->Next
= (PNETWORK_HEADER
)Pool
->FreeList
;
854 Pool
->FreeList
= (PNETWORK_HEADER
)Temp
;
855 KeReleaseSpinLock(&Pool
->SpinLock
, OldIrql
);
865 IN PNDIS_PACKET Packet
)
867 * FUNCTION: Puts an NDIS packet descriptor back in it's pool
869 * Packet = Pointer to packet descriptor
874 NDIS_DbgPrint(MAX_TRACE
, ("Packet (0x%X).\n", Packet
));
876 KeAcquireSpinLock(&Packet
->Private
.Pool
->SpinLock
.SpinLock
, &OldIrql
);
877 Packet
->Private
.Head
= (PNDIS_BUFFER
)Packet
->Private
.Pool
->FreeList
;
878 Packet
->Private
.Pool
->FreeList
= Packet
;
879 KeReleaseSpinLock(&Packet
->Private
.Pool
->SpinLock
.SpinLock
, OldIrql
);
888 NdisGetBufferPhysicalArraySize(
889 IN PNDIS_BUFFER Buffer
,
892 * FUNCTION: Returns number of discontiguous physical blocks backing a buffer
894 * Buffer = Pointer to buffer descriptor
895 * ArraySize = Address of buffer to place number of physical blocks
898 ASSERT(KeGetCurrentIrql() <= DISPATCH_LEVEL
);
899 ASSERT(Buffer
&& ArraySize
);
901 *ArraySize
= NDIS_BUFFER_TO_SPAN_PAGES(Buffer
);
910 NdisGetFirstBufferFromPacket(
911 IN PNDIS_PACKET _Packet
,
912 OUT PNDIS_BUFFER
*_FirstBuffer
,
913 OUT PVOID
*_FirstBufferVA
,
914 OUT PUINT _FirstBufferLength
,
915 OUT PUINT _TotalBufferLength
)
917 * FUNCTION: Retrieves information about an NDIS packet
919 * _Packet = Pointer to NDIS packet
920 * _FirstBuffer = Address of buffer for pointer to first NDIS buffer
921 * _FirstBufferVA = Address of buffer for address of first NDIS buffer
922 * _FirstBufferLength = Address of buffer for length of first buffer
923 * _TotalBufferLength = Address of buffer for total length of packet
928 Buffer
= _Packet
->Private
.Head
;
929 *_FirstBuffer
= Buffer
;
930 *_FirstBufferVA
= MmGetMdlVirtualAddress(Buffer
);
932 if (Buffer
!= NULL
) {
933 *_FirstBufferLength
= MmGetMdlByteCount(Buffer
);
934 Buffer
= Buffer
->Next
;
936 *_FirstBufferLength
= 0;
938 *_TotalBufferLength
= *_FirstBufferLength
;
940 while (Buffer
!= NULL
) {
941 *_TotalBufferLength
+= MmGetMdlByteCount(Buffer
);
942 Buffer
= Buffer
->Next
;
953 IN PNDIS_PACKET
*PacketsToReturn
,
954 IN UINT NumberOfPackets
)
956 * FUNCTION: Releases ownership of one or more packets
958 * PacketsToReturn = Pointer to an array of pointers to packet descriptors
959 * NumberOfPackets = Number of pointers in descriptor pointer array
972 IN NDIS_HANDLE PoolHandle
)
992 IN PNDIS_BUFFER Buffer
,
993 OUT PVOID
*VirtualAddress OPTIONAL
,
997 * Queries an NDIS buffer for information
999 * Buffer = Pointer to NDIS buffer to query
1000 * VirtualAddress = Address of buffer to place virtual address
1001 * Length = Address of buffer to place length of buffer
1004 if (VirtualAddress
!= NULL
)
1005 *(PVOID
*)VirtualAddress
= MmGetSystemAddressForMdl(Buffer
);
1007 *Length
= MmGetMdlByteCount(Buffer
);
1016 NdisQueryBufferSafe(
1017 IN PNDIS_BUFFER Buffer
,
1018 OUT PVOID
*VirtualAddress OPTIONAL
,
1028 if (VirtualAddress
!= NULL
)
1029 *VirtualAddress
= MmGetSystemAddressForMdlSafe(Buffer
, Priority
);
1030 *Length
= MmGetMdlByteCount(Buffer
);
1039 NdisQueryBufferOffset(
1040 IN PNDIS_BUFFER Buffer
,
1044 *((PUINT
)Offset
) = MmGetMdlByteOffset(Buffer
);
1045 *((PUINT
)Length
) = MmGetMdlByteCount(Buffer
);
1054 NdisUnchainBufferAtBack(
1055 IN OUT PNDIS_PACKET Packet
,
1056 OUT PNDIS_BUFFER
*Buffer
)
1059 * Removes the last buffer in a packet
1061 * Packet = Pointer to NDIS packet
1062 * Buffer = Address of buffer to place pointer to removed NDIS buffer
1065 PNDIS_BUFFER NdisBuffer
, Previous
;
1067 NdisQueryPacket(Packet
,
1078 while (NdisBuffer
->Next
) {
1079 Previous
= NdisBuffer
;
1080 NdisBuffer
= NdisBuffer
->Next
;
1084 Previous
->Next
= NULL
;
1085 Packet
->Private
.Tail
= Previous
;
1087 Packet
->Private
.Head
= NULL
;
1088 Packet
->Private
.Tail
= NULL
;
1091 Packet
->Private
.ValidCounts
= FALSE
;
1093 *Buffer
= NdisBuffer
;
1102 NdisUnchainBufferAtFront(
1103 IN OUT PNDIS_PACKET Packet
,
1104 OUT PNDIS_BUFFER
*Buffer
)
1107 * Removes the first buffer in a packet
1109 * Packet = Pointer to NDIS packet
1110 * Buffer = Address of buffer to place pointer to removed NDIS buffer
1113 PNDIS_BUFFER NdisBuffer
;
1115 NdisQueryPacket(Packet
,
1125 Packet
->Private
.Head
= NdisBuffer
->Next
;
1127 if (!NdisBuffer
->Next
)
1128 Packet
->Private
.Tail
= NULL
;
1130 NdisBuffer
->Next
= NULL
;
1132 Packet
->Private
.ValidCounts
= FALSE
;
1134 *Buffer
= NdisBuffer
;