Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Call the NdisFreeNetBufferList function to free a NET_BUFFER_LIST structure that was previously allocated from a NET_BUFFER_LIST structure pool.
Syntax
NDIS_EXPORTED_ROUTINE VOID NdisFreeNetBufferList(
[in] NET_BUFFER_LIST *NetBufferList
);
Parameters
[in] NetBufferList
A pointer to a NET_BUFFER_LIST structure that was allocated by calling the NdisAllocateNetBufferList or NdisAllocateNetBufferAndNetBufferList function.
Return value
None
Remarks
To allocate a NET_BUFFER_LIST structure from a pool, call the NdisAllocateNetBufferList or NdisAllocateNetBufferAndNetBufferList function.
The NET_BUFFER structures that are associated with the NET_BUFFER_LIST structure are not freed unless they were preallocated with the NET_BUFFER_LIST structure. You can reuse any NET_BUFFER structures that were not preallocated or you should free such structures separately.
If you allocated context space for a NET_BUFFER_LIST structure with the NdisAllocateNetBufferListContext function, you must free such context space before you free the NET_BUFFER_LIST structure. You must not attempt to free the context space that you allocated with NdisAllocateNetBufferList or NdisAllocateNetBufferAndNetBufferList by specifying the ContextSize and ContextBackFill parameters.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported in NDIS 6.0 and later. |
| Target Platform | Universal |
| Header | ndis/nblapi.h (include ndis.h) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI compliance rules | Irql_NetBuffer_Function(ndis), NdisAllocateNetBufferList(ndis), NdisAllocateNetBufferList_InitFail(ndis), NdisAllocateNetBufferList2(ndis), NdisAllocateNetBufferList2_InitFail(ndis) |