FwpsPendClassify0 関数 (fwpsk.h)

[アーティクル]
02/26/2024

吹き出しの classifyFn 関数はFwpsPendClassify0 を呼び出して、現在の分類要求を処理します。要求がペンドされた後、コールアウトドライバーは FwpsCompleteClassify0 を呼び出して、分類要求の処理を非同期的に完了する必要があります。

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

構文

NTSTATUS FwpsPendClassify0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

パラメーター

[in] classifyHandle

現在のレイヤーでのコールアウトドライバーの処理を識別する分類ハンドル。このハンドルは、を呼び出すことによって取得されます。 FwpsAcquireClassifyHandle0。

[in] filterId

classifyFn 関数の filter パラメーターの FilterId メンバーの値。 FilterId メンバーの詳細については、「FWPS_FILTER1」を参照してください。

[in] flags

将来利用するために予約されています。 0 に設定します。

[in, out] classifyOut

コールアウトドライバーの classifyFn 関数の classifyOut パラメーターに設定します。 classifyFn の classifyOut パラメーターは、ヘッダーの出力パラメーターとして一覧表示されますが、FwpsPendClassify に渡されるときにエンジンに役立つ入力に関する十分な情報が含まれています。

戻り値

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

リターンコード	説明
STATUS_SUCCESS	分類要求が正常に処理されました。
STATUS_FWP_CANNOT_PEND	エンジンでは、呼び出し元のレイヤーでの非同期分類は許可されません。
その他の状態コード	エラーが発生しました。

解説

FwpsPendClassify0 は 、示されたイベントの分類をペンド状態にします。吹き出しドライバーは通常、分類をペンで処理し、 classifyFn 吹き出し関数の範囲外でより多くの処理を実行できるようにします。その後、コールアウトドライバーは、ドライバーの吹き出し関数よりもパフォーマンスへの影響が少ない関数に、その表示に関する分類ハンドルとその他の関連データを渡すことができます。処理が完了したら、吹き出しで FwpsCompleteClassify0 を呼び出して、ペンド状態を削除する必要があります。 FwpsCompleteClassify の呼び出し時に、コールアウトドライバーは、インライン分類の場合と同様に、入力されたFWPS_CLASSIFY_OUT0 構造体を返す必要があります。

FwpsPendClassify0 は、 classifyHandle パラメーターで渡された分類ハンドルの参照カウントをインクリメントします。コールアウトドライバーは、この関数を呼び出した後、を呼び出すことができます FwpsReleaseClassifyHandle0 を使用してローカルインスタンスを解放します。 FwpsCompleteClassify0 が呼び出されると、ハンドルへの参照が自動的にデクリメントされます。

要件

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