FwpsCalloutRegister3 関数 (fwpsk.h)

  • [アーティクル]

FwpsCalloutRegister3 関数は、FWPS_CALLOUT3 構造体のバージョン 3 の関数ポインターを登録します。

構文

NTSTATUS FwpsCalloutRegister3(
  [in, out]       void                *deviceObject,
  [in]            const FWPS_CALLOUT3 *callout,
  [out, optional] UINT32              *calloutId
);

パラメーター

[in, out] deviceObject

吹き出しドライバーによって以前に作成されたデバイス オブジェクトへのポインター。 吹き出しドライバーがデバイス オブジェクトを作成する方法の詳細については、「デバイス オブジェクトの作成 を参照してください。

[in] callout

フィルター エンジンに吹き出しを登録するために必要なデータを含む定数 FWPS_CALLOUT3 構造体へのポインター。

[out, optional] calloutId

フィルター エンジンの吹き出しを識別するランタイム識別子を受け取る UINT32 型の変数へのポインター。 吹き出しドライバーは、フィルター エンジンから吹き出しの登録を解除するときに、FwpsCalloutUnregisterById0 関数にこの識別子を渡します。 コールアウト ドライバーは、データ フローをフィルター処理している場合、この識別子を FwpsFlowAssociateContext0 に渡し、FwpsFlowRemoveContext0 関数 します。 コールアウト ドライバーは、データ ストリームにデータを挿入する場合、この識別子を FwpsStreamInjectAsync0 関数にも渡します。 フィルター エンジンは、コールアウト ドライバーの FwpsCalloutFlowDeleteNotifyFn0 吹き出し関数にもこの識別子を渡します。 このパラメーターは省略可能であり、NULLできます。

戻り値

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

リターン コード 形容
STATUS_SUCCESS 吹き出しがフィルター エンジンに正常に登録されました。
STATUS_FWP_ALREADY_EXISTS 吹き出しをフィルター エンジンに登録できませんでした。 吹き出しは、吹き出し パラメーターによって指される FWPS_CALLOUT3 構造体の calloutKey メンバーで指定された GUID と同じ識別子を持つ既にフィルター エンジンに登録されています。
その他の NTSTATUS コード エラーが発生しました。

備考

コールアウト ドライバーは、アンロード 前に FwpsCalloutUnregisterById0 を呼び出す必要があります。

コールアウト ドライバーは、FwpsCalloutRegister3 関数を呼び出して、フィルター エンジンにコールアウトを登録します。 吹き出しドライバーは、フィルター エンジンが現在実行されていない場合でも、いつでもフィルター エンジンにコールアウトを登録できます。

吹き出しドライバーがフィルター エンジンに引き出しを登録する前に、フィルター エンジンにフィルター のアクションの吹き出しを指定する吹き出しとフィルターを追加できます。 このような状況では、アクションの種類が FWP_ACTION_CALLOUT_TERMINATING または FWP_ACTION_CALLOUT_UNKNOWN のフィルターは FWP_ACTION_BLOCKとして扱われ、アクションの種類が FWP_ACTION_CALLOUT_INSPECTION のフィルターは、吹き出しがフィルター エンジンに登録されるまで無視されます。

コールアウト ドライバーは、FwpsCalloutUnregisterById0 関数または FwpsCalloutUnregisterByKey0 関数を呼び出すことによって、フィルター エンジンからコールアウトの登録を解除します。 以前にフィルター エンジンに登録されていたすべての吹き出しが正常に登録解除されるまで、引き出しドライバーをアンロードすることはできません。

この関数は基本的に、FwpsCalloutRegister2以前のバージョンと同じです。 唯一の違いは、吹き出しパラメーターによって指 FWPS_CALLOUT3 更新された構造体です。

必要条件

要件 価値
サポートされる最小クライアント Windows 8 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー fwpsk.h
ライブラリ Fwpkclnt.lib
IRQL PASSIVE_LEVEL

関連項目