NdisAllocateNetBufferList 函式（ndis/nblapi.h）

發行項
02/07/2025

呼叫 NdisAllocateNetBufferList 函式，從NET_BUFFER_LIST結構集區配置和初始化 NET_BUFFER_LIST 結構。

語法

NDIS_EXPORTED_ROUTINE NET_BUFFER_LIST * NdisAllocateNetBufferList(
  [in] NDIS_HANDLE PoolHandle,
  [in] USHORT      ContextSize,
  [in] USHORT      ContextBackFill
);

參數

[in] PoolHandle

先前從呼叫傳回的NET_BUFFER_LIST結構集區句柄 NdisAllocateNetBufferListPool。

[in] ContextSize

在 NET_BUFFER_LIST_CONTEXT 結構中，使用的數據空間量 來保留給呼叫端。 ContextSize 必須是MEMORY_ALLOCATION_ALIGNMENT所定義的多個值。

[in] ContextBackFill

呼叫者所需的 未使用資料空間量（回填空間）。 NDIS 會將此值新增至 ContextSize，並配置額外的空間。 ContextBackFill 必須是MEMORY_ALLOCATION_ALIGNMENT所定義的多個值。

傳回值

NdisAllocateNetBufferList 會傳回配置之NET_BUFFER_LIST結構的指標。如果設定失敗，此指標會 NULL。

言論

您可以呼叫 NdisAllocateNetBufferList 或 NdisAllocateNetBufferAndNetBufferList 函式，從集區配置 NET_BUFFER_LIST 結構。

附註NET_BUFFER 和 NET_BUFFER_LIST 結構必須從 NDIS 緩衝池配置。驅動程式不得從其私人記憶體集區或堆疊配置和初始化NET_BUFFER_LIST或NET_BUFFER結構。

如果您呼叫 NdisAllocateNetBufferList，而且已呼叫來配置NET_BUFFER_LIST結構集區 NdisAllocateNetBufferListPool 函式中，fAllocateNetBufferNET_BUFFER_LIST_POOL_PARAMETERS 結構的成員設定 為 true，NDIS 會配置NET_BUFFER_LIST、NET_BUFFER、MDL 和數據。

呼叫 NdisFreeNetBufferList 函式以釋放NET_BUFFER_LIST結構。

要求

要求	價值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平臺	普遍
標頭	ndis/nblapi.h （include ndis.h）
連結庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	Irql_NetBuffer_Function（ndis），NdisAllocateNetBufferList2（ndis），NdisAllocateNetBufferList2_InitFail（ndis）