FwpsInjectionHandleCreate0 関数 (fwpsk.h)

[アーティクル]
08/07/2023

FwpsInjectionHandleCreate0 関数は、パケットインジェクション関数が TCP/IP ネットワークスタックにパケットまたはストリームデータを挿入し、FwpsQueryPacketInjectionState0 関数でパケットインジェクション状態を照会するために使用できるハンドルを作成します。

注FwpsInjectionHandleCreate0 は、 FwpsInjectionHandleCreate の特定のバージョンです。詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象とする」を参照してください。

構文

NTSTATUS FwpsInjectionHandleCreate0(
  [in, optional] ADDRESS_FAMILY addressFamily,
  [in]           UINT32         flags,
  [out]          HANDLE         *injectionHandle
);

パラメーター

[in, optional] addressFamily

挿入ハンドルが作成されるアドレスファミリ。これには、次のいずれかのアドレスファミリを指定できます。

AF_UNSPEC

アドレスファミリが指定されていません。

AF_INET

IPv4 アドレスファミリ。

AF_INET6

IPv6 アドレスファミリ。

トランスポート、ストリーム、および前方挿入の場合、このパラメーターは省略可能であり、指定されていないアドレスファミリを示すAF_UNSPECに設定できます。この値は Ws2def.h で定義されています。

[in] flags

挿入するデータの種類を示すためにコールアウトドライバーによって設定されるフラグ値。このフラグには、次の 1 つ以上の値を指定できます。

FWPS_INJECTION_TYPE_FORWARD

パケットデータは、を呼び出すことによって挿入されます。 FwpsInjectForwardAsync0 関数。

FWPS_INJECTION_TYPE_NETWORK

ネットワークデータは、次のいずれかを呼び出すことによって挿入されます。 FwpsInjectNetworkReceiveAsync0 関数または FwpsInjectNetworkSendAsync0 関数。

FWPS_INJECTION_TYPE_STREAM

Streamデータは、を呼び出すことによって挿入されます。 FwpsStreamInjectAsync0 関数。

FWPS_INJECTION_TYPE_TRANSPORT

トランスポートデータは、次のいずれかを呼び出すことによって挿入されます。 FwpsInjectTransportReceiveAsync0 関数または FwpsInjectTransportSendAsync0 関数。

複数の挿入関数で使用されるインジェクションハンドルを作成するには、インジェクションの種類のビットをビットごとの OR 演算と組み合わせます。フラグ値が 0 に設定されている場合、結果のインジェクションハンドルをトランスポート、ストリーム、および前方挿入に使用できます。

[out] injectionHandle

ハンドルを受け取る変数へのポインター。

戻り値

FwpsInjectionHandleCreate0 関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	インジェクションハンドルが正常に作成されました。
STATUS_FWP_TCPIP_NOT_READY	TCP/IP ネットワークスタックの準備ができていません。コールアウトドライバーは、後で FwpsInjectionHandleCreate0 関数を再度呼び出して、インジェクションハンドルを作成する必要があります。
その他の状態コード	エラーが発生しました。

解説

コールアウトドライバーは FwpsInjectionHandleCreate0 関数を呼び出して、パケットまたはストリームデータを TCP/IP ネットワークスタックに挿入し、パケットインジェクション状態を照会するために使用できるハンドルを作成します。コールアウトドライバーは、作成されたハンドルをパケットインジェクション関数に渡し、 FwpsQueryPacketInjectionState0。

吹き出しドライバーは、インジェクションハンドルの使用が完了した後、 FwpsInjectionHandleDestroy0 関数を呼び出してハンドルを破棄する必要があります。保留中のインジェクションがまだ完了していない場合、この関数は完了するまで待ってから戻ります。

ネットワーク層に対してインジェクションが行われ、IPv4 アドレスファミリと IPv6 アドレスファミリの両方がフィルター処理されている場合、引き出しドライバーは 、FwpsInjectionHandleCreate0 関数を 2 回呼び出して 2 つのインジェクションハンドルを作成する必要があります。 addressFamily を AF_INET に設定した呼び出しと、 addressFamily を AF_INET6 に設定した 2 回目の呼び出しです。

MAC レイヤー (*MAC_FRAME_NATIVE、*MAC_FRAME_ETHERNET、*VSWITCH_ETHERNET) では、FWPS_INJECTION_TYPE_L2 フラグで取得したのと同じインジェクションハンドルを使用できます。インジェクションタイプは、レイヤーよりも射出関数に近い位置に関連付けられます。

コード例については、「 WFPSampler HelperFunctions_InjectionData.cpp」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fwpsk.h (Fwpsk.h を含む)
Library	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

こちらもご覧ください

FwpsInjectionHandleDestroy0

FwpsQueryPacketInjectionState0

パケット挿入関数

次の方法で共有