NdisFreeNetBufferList function (ndis/nblapi.h)

Article
04/18/2022

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)