Bewerken

Delen via


NdisFreeNetBufferList function (ndis/nblapi.h)

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)

See also

NET_BUFFER

NET_BUFFER_LIST

NdisAllocateNetBufferAndNetBufferList

NdisAllocateNetBufferList

NdisAllocateNetBufferListContext