FwpsAllocateCloneNetBufferList0 函式 (fwpsk.h)

發行項
02/26/2024

FwpsAllocateCloneNetBufferList0 函式會配置NET_BUFFER_LIST結構，該結構是現有NET_BUFFER_LIST結構的複製品。

注意FwpsAllocateCloneNetBufferList0 是特定版本的 FwpsAllocateCloneNetBufferList。如需詳細資訊，請參閱 Version-Independent 名稱和以特定 Windows 版本為目標。

語法

NTSTATUS FwpsAllocateCloneNetBufferList0(
  [in, out]      NET_BUFFER_LIST *originalNetBufferList,
  [in, optional] NDIS_HANDLE     netBufferListPoolHandle,
  [in, optional] NDIS_HANDLE     netBufferPoolHandle,
  [in]           ULONG           allocateCloneFlags,
  [out]          NET_BUFFER_LIST **netBufferList
);

參數

[in, out] originalNetBufferList

要複製之原始 NET_BUFFER_LIST 結構的指標。

[in, optional] netBufferListPoolHandle

從先前呼叫取得的NET_BUFFER_LIST 集區句柄 NdisAllocateNetBufferListPool 函式。這個參數是選擇性的，而且可以是 NULL。

[in, optional] netBufferPoolHandle

從先前呼叫 NdisAllocateNetBufferPool 函式取得的NET_BUFFER集區句柄。這個參數是選擇性的，而且可以是 NULL。

[in] allocateCloneFlags

目前沒有為此函式定義的旗標。註標驅動程式應該將此參數設定為零。

[out] netBufferList

接收複製 NET_BUFFER_LIST 結構指標之變數的指標。

傳回值

FwpsAllocateCloneNetBufferList0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼	Description
STATUS_SUCCESS	已成功配置複製 NET_BUFFER_LIST 結構。
其他狀態代碼	發生錯誤。

備註

圖說文字驅動程式會呼叫 FwpsAllocateCloneNetBufferList0 函式，以配置現有NET_BUFFER_LIST結構的複製 NET_BUFFER_LIST 結構。

此函式是周圍的包裝函式 NdisAllocateCloneNetBufferList 函式，但它特製化供一般使用之用。

如果複製NET_BUFFER_LIST結構應該有與特定集區相關聯的屬性，圖說文字驅動程式必須在 NetBufferListPoolHandle 或 NetBufferPoolHandle 參數中指定集區句柄。如果這些參數為 NULL，則會使用 NDIS 預先配置的預設集區。

複製NET_BUFFER_LIST結構描述原始NET_BUFFER_LIST結構所描述的相同數據。 FwpsAllocateCloneNetBufferList0 函式不會將原始 MDL 所描述的數據複製到新的數據緩衝區。相反地，複製NET_BUFFER_LIST結構會參考原始數據緩衝區。複製NET_BUFFER_LIST結構不包含初始 NET_BUFFER_LIST_CONTEXT 結構。

此函式會將新建立之複製NET_BUFFER_LIST結構的 ParentNetBufferList 成員設定為指向父NET_BUFFER_LIST結構。父結構的 ChildRefCount 成員會遞增 1。

圖說文字驅動程式可以修改複製NET_BUFFER_LIST結構，並藉由呼叫封包插入函式，將它插入網路堆疊來取代原始NET_BUFFER_LIST結構。成功將複製NET_BUFFER_LIST結構所描述的數據插入網路堆疊之後，圖說文字驅動程式會藉由呼叫 FwpsFreeCloneNetBufferList0 函式釋放複製NET_BUFFER_LIST結構。

圖說文字驅動程式可以在複製 net 緩衝區清單中插入或取代個別 net 緩衝區， (NET_BUFFER) 或 MDL。這類驅動程式也必須在呼叫之前復原修改 FwpsFreeCloneNetBufferList0 函式。

管理複製封包的指導方針

圖說文字驅動程式不得無限期保存複製的封包。複製的封包可能會干擾閑置計算機上的電源管理作業。

預期用於在一個使用者模式應用程式或其他相對快速作業中複製的封包。圖說文字驅動程式不得保存複製的封包，例如等候使用者輸入或等候 Web 服務清除，或等候任何其他可能需要任意時間的作業。

如果圖說文字驅動程式需要等候可能冗長的作業，它會使用建立封包的深層複本 FwpsAllocateNetBufferAndNetBufferList0，它會封鎖並吸收原始封包。

圖說文字驅動程序應該一律儘快傳回保留的封包。

規格需求

需求	值
最低支援的用戶端	從 Windows Vista 開始提供。
目標平台	Universal
標頭	fwpsk.h (包含 Fwpsk.h)
程式庫	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL