NdisFreeNetBufferList 函式 (ndis/nblapi.h)

發行項
02/29/2024

呼叫 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_LIST結構相關聯的NET_BUFFER結構。您可以重複使用未預先配置的任何NET_BUFFER結構，或應該個別釋放這類結構。

如果您已使用配置NET_BUFFER_LIST結構的內容空間 NdisAllocateNetBufferListContext 函式，您必須先釋放這類內容空間，才能釋放NET_BUFFER_LIST結構。您無法藉由指定 ContextSize 和 ContextBackFill 參數，嘗試釋放您使用 NdisAllocateNetBufferList 或 NdisAllocateNetBufferList 或 NdisAllocateNetBufferList 配置的內容空間。

規格需求

需求	值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平台	Universal
標頭	ndis/nblapi.h (include ndis.h)
程式庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	Irql_NetBuffer_Function (ndis) 、NdisAllocateNetBufferList (ndis) 、NdisAllocateNetBufferList_InitFail (ndis) 、NdisAllocateNetBufferList2 (ndis) 、NdisAllocateNetBufferList2_InitFail (ndis)