FwpsReassembleForwardFragmentGroup0 函式（fwpsk.h）

發行項
02/07/2025

FwpsReassembleForwardFragmentGroup0 函式會將轉送數據路徑中的 IP 片段清單組合成單一封包。

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

語法

NTSTATUS FwpsReassembleForwardFragmentGroup0(
  [in]           ADDRESS_FAMILY  addressFamily,
  [in, out]      NET_BUFFER_LIST *fragmentGroupNblChain,
  [in, optional] NDIS_HANDLE     netBufferAndNetBufferListPoolHandle,
  [in]           ULONG           dataBackFill,
  [in]           ULONG           flags,
  [out]          NET_BUFFER_LIST **reassembledNbl
);

參數

[in] addressFamily

下列其中一個位址系列：

AF_INET

IPv4 位址系列。

AF_INET6

IPv6 位址系列。

[in, out] fragmentGroupNblChain

要重新組合成單一封包之IP片段 NET_BUFFER_LIST 鏈結的指標。如需此參數使用方式的詳細資訊，請參閱。

[in, optional] netBufferAndNetBufferListPoolHandle

先前從傳回的選擇性 NET_BUFFER_LIST 結構集區句柄 NdisAllocateNetBufferListPool 函式。 呼叫者傳遞至 NdisAllocateNetBufferListPool 的 NET_BUFFER_LIST_POOL_PARAMETERS 結構 成員 fAllocateNetBufferListPool 成員必須設定為 true TRUE，且 DataSize 成員設定為零。如果此參數 NULL，NDIS 會使用內部集區。

[in] dataBackFill

如果需要配置未使用的資料空間（回填空間），此參數會指定要配置的未使用資料空間位元組數目。

[in] flags

保留。註標驅動程式必須將此參數設定為零。

[out] reassembledNbl

接收重新組譯單一網路緩衝區清單位址之 NET_BUFFER_LIST 指標的指標。

傳回值

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

傳回碼	描述
STATUS_SUCCESS	IP 片段清單已成功重新組合成單一 NET_BUFFER_LIST 結構。
STATUS_FWP_TCPIP_NOT_READY	TCP/IP 網路堆疊尚未準備好重新組譯封包。如果在載入 Tcpip.sys 之前或卸除 Tcpip.sys 之後呼叫此函式，就會發生此錯誤。
其他狀態代碼	發生錯誤。

言論

FwpsReassembleForwardFragmentGroup0 函式會將轉送數據路徑中由 NET_BUFFER_LIST 鏈結描述的 IP 片段清單組合成單一封包。重新組合的封包是包含一個 net 緩衝區的單一 net 緩衝區清單，並參考輸入片段鏈結。此函式通常由邊緣防火牆用來檢查網路封包。

ip 片段的輸入鏈結，fragmentGroupNblChain，必須是設定FWP_CONDITION_FLAG_IS_FRAGMENT_GROUP旗標時，分類Fn 圖說文字 FWPS_LAYER_IPFORWARD_V6 FWPS_LAYER_IPFORWARD_V4函式所指示的 ip 片段輸入鏈結。如果不是這種情況，則未定義 FwpsReassembleForwardFragmentGroup0 的行為。

呼叫 FwpsFreeNetBufferList0 函式，以釋放 重新組合Nbl NET_BUFFER_LIST 結構和所有相關聯的 NET_BUFFER 結構和 MDL 鏈結。 FwpsFreeNetBufferList0 取值原始輸入片段鏈結。

您可以使用下列命令來檢視系統的目前「群組轉送片段」設定：netsh 介面 {ipv4|ipv6} 顯示全域。

由於 FwpsReassembleForwardFragmentGroup0 參考輸入片段鏈結，因此在呼叫此函式之前，不需要圖說文字參考或複製鏈結。

要求

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