NdisFreeNetBufferList 函数 (ndis/nblapi.h)
调用 NdisFreeNetBufferList 函数以释放以前从 NET_BUFFER_LIST 结构池中分配的NET_BUFFER_LIST结构。
语法
NDIS_EXPORTED_ROUTINE VOID NdisFreeNetBufferList(
[in] NET_BUFFER_LIST *NetBufferList
);
参数
[in] NetBufferList
指向通过调用 NdisAllocateNetBufferList 或 分配的NET_BUFFER_LIST结构的指针 NdisAllocateNetBufferAndNetBufferList 函数。
返回值
无
备注
若要从池中分配 NET_BUFFER_LIST 结构,请调用 NdisAllocateNetBufferList 或 NdisAllocateNetBufferAndNetBufferList 函数。
与 NET_BUFFER_LIST 结构关联的NET_BUFFER结构不会释放,除非它们已与 NET_BUFFER_LIST 结构预先分配。 可以重复使用未预先分配的任何NET_BUFFER结构,或者应单独释放此类结构。
如果为NET_BUFFER_LIST结构分配了上下文空间, NdisAllocateNetBufferListContext 函数,在释放NET_BUFFER_LIST结构之前,必须释放此类上下文空间。 不得尝试通过指定 ContextSize 和 ContextBackFill 参数来释放使用 NdisAllocateNetBufferList 或 NdisAllocateNetBufferAndNetBufferList 分配的上下文空间。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
目标平台 | 通用 |
标头 | ndis/nblapi.h (包括 ndis.h) |
Library | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_NetBuffer_Function (ndis) 、NdisAllocateNetBufferList (ndis) 、NdisAllocateNetBufferList_InitFail (ndis) 、NdisAllocateNetBufferList2 (ndis) 、NdisAllocateNetBufferList2_InitFail (ndis) |