FwpsAllocateDeepCloneNetBufferList0 函式 （fwpsk.h）
FwpsAllocateDeepCloneNetBufferList0 函式會配置 NET_BUFFER_LIST 結構，這是現有 NET_BUFFER_LIST 結構的深層複製。
語法
NTSTATUS FwpsAllocateDeepCloneNetBufferList0(
[in, out] NET_BUFFER_LIST *originalNetBufferList,
[in, optional] NDIS_HANDLE netBufferListPoolHandle,
[in, optional] NDIS_HANDLE netBufferPoolHandle,
[out] NET_BUFFER_LIST **netBufferList
);
參數
[in, out] originalNetBufferList
正在複製之原始 NET_BUFFER_LIST 結構的指標。
[in, optional] netBufferListPoolHandle
從先前呼叫 NdisAllocateNetBufferListPool 函式取得的 NET_BUFFER_LIST 集區句柄。 這個參數是選擇性的，而且可以 NULL。
[in, optional] netBufferPoolHandle
從先前呼叫 NdisAllocateNetBufferPool 函式取得的 NET_BUFFER_LIST 集區句柄。 這個參數是選擇性的，而且可以 NULL。
[out] netBufferList
接收深層複製 NET_BUFFER_LIST 結構的指標的變數指標。
傳回值
FwpsAllocateDeepCloneNetBufferList0 函式會傳回下列其中一個 NTSTATUS 程式代碼。
| 傳回碼 | 描述 |
|---|---|
| STATUS_SUCCESS | 已成功配置深層複製 NET_BUFFER_LIST 結構。 |
| 其他狀態代碼 | 發生錯誤。 |
言論
圖說驅動程式會呼叫 FwpsAllocateDeepCloneNetBufferList0 函式，以配置現有 NET_BUFFER_LIST 結構的深層複製 NET_BUFFER_LIST 結構。
此函式是 NdisAllocateCloneNetBufferList 函式的包裝函式，但它是特製化 封包插入函式。
如果深層複製 NET_BUFFER_LIST 結構應該有與特定集區相關聯的屬性，圖說驅動程序必須在 netBufferListPoolHandle 或 NetBufferPoolHandle 參數中指定集區句柄。 如果這些參數 NULL，則會使用 NDIS 預先配置的預設集區。
深層複製 NET_BUFFER_LIST 結構描述原始 NET_BUFFER_LIST 結構所描述的相同數據。 FwpsAllocateDeepCloneNetBufferList0 函式會將原始 MDL 描述的數據複製到新的數據緩衝區。 複製 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_BUFFER）或 MDL NET_BUFFER_LIST。 驅動程式必須先復原這些修改，才能呼叫 FwpsFreeCloneNetBufferList0 函式。
管理複製封包的指導方針
圖說文字驅動程式不得無限期保存複製的封包。 複製的封包可能會干擾閑置計算機上的電源管理作業。
預定用於WFP中的深層複製封包，是要從使用者模式應用程式或其他需要與原始無關封包的相對快速作業取得釐清。 圖說文字驅動程式在等候使用者輸入、Web 服務清除或任何其他可能需要任意時間的作業時，不得保存複製的封包。
圖說文字驅動程序應該一律會儘快傳回保留的封包。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | WIP 組建 25324 |
| 目標平臺 | 普遍 |
| 標頭 | fwpsk.h （包括 Fwpsk.h） |
| 連結庫 | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |