FwpsCloneStreamData0 函式（fwpsk.h）

發行項
02/07/2025

FwpsCloneStreamData0 函式會配置現有 FWPS_STREAM_DATA0 數據流的複製品。

附注FwpsCloneStreamData0 是 FwpsCloneStreamData 的特定版本。如需詳細資訊，請參閱糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

NTSTATUS FwpsCloneStreamData0(
  [in, out]      FWPS_STREAM_DATA0 *calloutStreamData,
  [in, optional] NDIS_HANDLE       netBufferListPoolHandle,
  [in, optional] NDIS_HANDLE       netBufferPoolHandle,
  [in]           ULONG             allocateCloneFlags,
  [out]          NET_BUFFER_LIST   **netBufferListChain
);

參數

[in, out] calloutStreamData

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

[in, optional] netBufferListPoolHandle

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

[in, optional] netBufferPoolHandle

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

[in] allocateCloneFlags

此函式目前沒有定義旗標。圖說文字驅動程式應該將此參數設定為零。

[out] netBufferListChain

位置的指標，接收描述所有複製數據流數據之 NET_BUFFER_LIST 結構鏈結的指標。

傳回值

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

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

言論

這個複製的數據流數據可由圖說文字驅動程式插入 TCP/IP 網路堆疊稍後。

FwpsCloneStreamData0 函式會複製現有 FWPS_STREAM_DATA0 數據流中包含的整個 NET_BUFFER_LIST 結構鏈結。函式會修剪未使用的數據，讓圖說驅動程式可以成功將複製的鏈結傳遞至 FwpsStreamInjectAsync0 函式。

成功將複製NET_BUFFER_LIST結構鏈結中的數據流數據插入網路堆疊之後，會針對每個複製NET_BUFFER_LIST結構呼叫 completionFn 圖說函式，而圖說文字應該呼叫 FwpsFreeCloneNetBufferList0，以釋放複製NET_BUFFER_LIST結構。

如果複製的數據流數據要捨棄而不重新檢視，則圖說文字應該呼叫 FwpsDiscardClonedStreamData0 函式。

要求

要求	價值
最低支援的用戶端	從 Windows Vista 開始提供。
目標平臺	普遍
標頭	fwpsk.h （包括 Fwpsk.h）
連結庫	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL