FwpsInjectNetworkSendAsync0 函式 (fwpsk.h)

發行項
02/26/2024

FwpsInjectNetworkSendAsync0 函式會將封包數據插入傳送數據路徑。

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

語法

NTSTATUS FwpsInjectNetworkSendAsync0(
  [in]           HANDLE                injectionHandle,
  [in, optional] HANDLE                injectionContext,
  [in]           UINT32                flags,
  [in]           COMPARTMENT_ID        compartmentId,
  [in, out]      NET_BUFFER_LIST       *netBufferList,
  [in]           FWPS_INJECT_COMPLETE0 completionFn,
  [in, optional] HANDLE                completionContext
);

參數

[in] injectionHandle

先前由 FwpsInjectionHandleCreate0 函式呼叫所建立的插入句柄， 並將 flags 參數設定為 FWPS_INJECTION_TYPE_NETWORK。

[in, optional] injectionContext

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

[in] flags

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

[in] compartmentId

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

[in, out] netBufferList

描述所插入封包數據的 NET_BUFFER_LIST 結構的指標。圖說文字驅動程式會透過呼叫 FwpsAllocateCloneNetBufferList0 函式或 FwpsAllocateNetBufferList0 函式，配置用來插入封包數據的NET_BUFFER_LIST結構。 NET_BUFFER_LIST 結構必須以IP標頭開頭。

[in] completionFn

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

[in, optional] completionContext

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

傳回值

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

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

備註

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

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

插入的封包可以再次向圖說驅動程式指出。若要防止無限迴圈，驅動程式應該先呼叫 FwpsQueryPacketInjectionState0 函式，再繼續進行對 classifyFn 圖說文字函式的呼叫，而驅動程式應該允許將插入狀態設定 FWPS_PACKET_INJECTION_STATE為FWPS_PACKET_INJECTED_BY_SELF或FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF的封包。

規格需求

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