FWPS_INJECT_COMPLETE0 コールバック関数 (fwpsk.h)

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

フィルターエンジンは、パケットインジェクション関数の 1 つで netBufferList パラメーターによって記述されたパケットデータがネットワークスタックに挿入されるたびに、吹き出しの completionFn 吹き出し関数を呼び出します。

構文

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

void FwpsInjectComplete0(
  [in]      void *context,
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN dispatchLevel
)
{...}

パラメーター

[in] context

吹き出しドライバーによって呼び出されるパケットインジェクション関数の 1 つの completionContext パラメーターへのポインター。

[in, out] netBufferList

吹き出しドライバーによって呼び出されるパケットインジェクション関数の 1 つの netBufferList パラメーターで渡されるポインター。

[in] dispatchLevel

completionFn 吹き出し関数が呼び出されている IRQL を示す値。このパラメーターが TRUE の場合、 completionFn 吹き出し関数は IRQL = DISPATCH_LEVELで呼び出されます。このパラメーターが FALSE の場合、 IRQL< DISPATCH_LEVELで completionFn 吹き出し関数が呼び出されます。

戻り値

なし

解説

FWPS_INJECT_COMPLETE0型は、 completionFn 関数へのポインターとして次のように定義されます。

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

NetBufferList が指すNET_BUFFER_LIST構造体の Status メンバーは、挿入操作の結果を示します。

複製または作成された NET_BUFFER_LIST 構造体チェーン内のパケットデータが、パケットインジェクション関数の 1 つによってネットワークスタックに正常に挿入された後、 completionFn が呼び出されます。

NET_BUFFER_LIST構造体のチェーンを挿入するために FwpsStreamInjectAsync0 関数が呼び出された場合、fwpsStreamInjectAsync0 で指定された同じ completionContext パラメーターを使用するたびに、チェーン内のNET_BUFFER_LISTごとに completionFn が 1 回呼び出されます。この場合、コールアウトドライバーの completionFn 実装では、FwpsFreeCloneNetBufferList0 を呼び出して、現在示されている NET_BUFFER_LISTを解放する必要があります。

フィルターエンジンは、IRQL <= DISPATCH_LEVEL で吹き出しの入力候補Fn 吹き出し関数を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降で使用できます。
対象プラットフォーム	Windows
ヘッダー	fwpsk.h (Fwpsk.h を含む)
IRQL	<= DISPATCH_LEVEL