FwpsInjectForwardAsync0 函式 (fwpsk.h)

發行項
02/26/2024

FwpsInjectForwardAsync0 函式會將封包數據插入轉送數據路徑。

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

語法

NTSTATUS FwpsInjectForwardAsync0(
  [in]           HANDLE                injectionHandle,
  [in, optional] HANDLE                injectionContext,
  [in]           UINT32                flags,
  [in]           ADDRESS_FAMILY        addressFamily,
  [in]           COMPARTMENT_ID        compartmentId,
  [in]           IF_INDEX              interfaceIndex,
  [in, out]      NET_BUFFER_LIST       *netBufferList,
  [in]           FWPS_INJECT_COMPLETE0 completionFn,
  [in, optional] HANDLE                completionContext
);

參數

[in] injectionHandle

先前由呼叫所建立的插入句柄 FwpsInjectionHandleCreate0 函式。

[in, optional] injectionContext

插入內容的選擇性句柄。如果指定，可以藉由呼叫來取得當封包插入狀態FWPS_PACKET_INJECTION_STATE FWPS_PACKET_INJECTED_BY_SELF或FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF時，FwpsQueryPacketInjectionState0 函式。

[in] flags

保留的。圖說文字驅動程式必須將此參數設定為零。

[in] addressFamily

下列其中一個位址系列：

AF_INET

IPv4 位址系列。

AF_INET6

IPv6 位址系列。

[in] compartmentId

將封包數據插入其中的路由區間標識符，指定為 COMPARTMENT_ID 類型。此標識碼是透過的 compartmentId 成員提供給圖說文字 FWPS_INCOMING_METADATA_VALUES0 傳遞至圖說驅動程式之 classifyFn 圖說文字函式的結構。如果 hierarchyId 成員可供圖說文字使用，FWPS_METADATA_FIELD_COMPARTMENT_ID將會在 currentMetadataValues 成員中設定。否則，請將此參數設定為 UNSPECIFIED_COMPARTMENT_ID。

[in] interfaceIndex

目的地介面的索引 (封包數據要傳送) 。索引是32位值。如果封包要插入原始封包所在的相同介面，圖說文字驅動程序應該使用介面索引的值，當做其中一個傳入數據值傳遞至此參數的 classifyFn 圖說文字函式。

[in, out] netBufferList

描述所插入封包數據的 NET_BUFFER_LIST 結構的指標。圖說文字驅動程式會藉由呼叫其中一個來配置NET_BUFFER_LIST結構來插入封包數據 FwpsAllocateCloneNetBufferList0 函式或 FwpsAllocateNetBufferAndNetBufferList0 函式。 NET_BUFFER_LIST結構必須以IP標頭開頭。

[in] completionFn

圖說文字驅動程式所提供 completionFn 圖說文字函式的指標。篩選引擎會在 netBufferList 參數所描述的封包數據插入網路堆疊之後呼叫此函式。

[in, optional] completionContext

由圖說文字驅動程式提供的內容指標，傳遞至 completionFn 參數所指向的圖說文字函式。這個參數是選擇性的，而且可以是 NULL。

傳回值

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

傳回碼	Description
STATUS_SUCCESS	已成功起始封包數據插入。篩選引擎會在篩選引擎完成將封包數據插入網路堆疊之後，或後續發生錯誤時呼叫完成函式，在此情況下，已完成NET_BUFFER_LIST結構的 Status 成員將會指出失敗的原因。
STATUS_FWP_TCPIP_NOT_READY	TCP/IP 網路堆疊尚未準備好接受插入封包數據。
STATUS_FWP_INJECT_HANDLE_CLOSING	正在關閉插入句柄。
其他狀態代碼	發生錯誤。

備註

圖說文字驅動程式會呼叫 FwpsInjectForwardAsync0 函式，將封包數據或封包片段插入轉送數據路徑。

此函式可以異步執行。修改封包數據時，圖說文字驅動程式通常會將數據插入網路堆疊。如需圖說文字驅動程式如何修改封包數據的詳細資訊，請參閱圖說文字驅動程序作業。

插入此函式的封包或封包片段不會向任何一個的一層指出篩選。

如果未STATUS_SUCCESS傳回值，則不會呼叫完成函式。在此情況下， netBufferList 所指向的 net 緩衝區清單必須由呼叫 FwpsFreeNetBufferList0 釋放或 FwpsFreeCloneNetBufferList0。

IP 封包或片段可以複製、修改和插入回網路堆疊。不過，圖說文字驅動程式必須先將片段群組重新組譯為單一NET_BUFFER_LIST，才能重新執行。

轉送插入的封包不會重新進入轉送層。因此，它們不會重新分類。

規格需求

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