FwpsPendClassify0 関数 (fwpsk.h)
コールアウトの classifyFn 関数は、fwpsPendClassify0 呼び出して現在の分類要求を処理します。 要求がペンドされた後、コールアウト ドライバーは、fwpsCompleteClassify0 呼び出すことによって、分類要求の処理を非同期的に完了する必要があります。
構文
NTSTATUS FwpsPendClassify0(
[in] UINT64 classifyHandle,
[in] UINT64 filterId,
[in] UINT32 flags,
[in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);
パラメーター
[in] classifyHandle
現在のレイヤーでのコールアウト ドライバーの処理を識別する分類ハンドル。 このハンドルは、次の呼び出しによって取得されます。FwpsAcquireClassifyHandle0 をします。
[in] filterId
FilterIdclassifyFn 関数の filter パラメーターのメンバーの値。 FilterId メンバーの詳細については、「FWPS_FILTER1」を参照してください。
[in] flags
将来の使用のために予約されています。 0 に設定します。
[in, out] classifyOut
吹き出しドライバーの classifyFn 関数の classifyOut パラメーターに設定します。 classifyFn の classifyOut パラメーターは、ヘッダーの出力パラメーターとして一覧表示されますが、FwpsPendClassifyに渡されるときにエンジンに役立つ入力に関する十分な情報が含まれています。
戻り値
FwpsPendClassify0 関数は、次のいずれかの NTSTATUS コードを返します。
| リターン コード | 形容 |
|---|---|
|
分類要求が正常に処理されました。 |
|
エンジンは、呼び出し元のレイヤーで非同期分類を許可しません。 |
|
エラーが発生しました。 |
備考
FwpsPendClassify0 は、指定されたイベントの分類をペンド状態にします。 吹き出しドライバーは通常、分類をペンで分類し、classifyFn 吹き出し関数の範囲外でより多くの処理を実行できるようにします。 コールアウト ドライバーは、分類ハンドルと、ドライバーの吹き出し関数よりもパフォーマンスへの影響が小さい関数に表示に関するその他の関連データを渡すことができます。 処理が完了したら、引き出し線 FwpsCompleteClassify0 を呼び出して、ペンド状態を削除する必要があります。 FwpsCompleteClassify の呼び出し時に、コールアウト ドライバーは、インライン分類の場合と同様に、入力された FWPS_CLASSIFY_OUT0 構造体を返す必要があります。
FwpsPendClassify0 は、classifyHandle パラメーターで渡された分類ハンドルの参照カウントをインクリメントします。 コールアウト ドライバーがこの関数を呼び出した後、呼び出すことができます。FwpsReleaseClassifyHandle0 を して、ローカル インスタンスを解放します。 FwpsCompleteClassify0 呼び出されると、ハンドルへの参照が自動的にデクリメントされます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 7 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fwpsk.h (Fwpsk.h を含む) |
| ライブラリ | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |
関連項目
FwpsAcquireClassifyHandle0 を する