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

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

フィルターエンジンは、吹き出しの notifyFn2 吹き出し関数を呼び出して、引き出し線に関連付けられているイベントについて吹き出しドライバーに通知します。

注 notifyFn2 は、Windows 8 以降で使用される notifyFn の特定のバージョンです。詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象とする」を参照してください。 Windows 7 の場合、 notifyFn1 を使用できます。 Windows Vista の場合、 notifyFn0 を使用できます。

構文

FWPS_CALLOUT_NOTIFY_FN2 FwpsCalloutNotifyFn2;

NTSTATUS FwpsCalloutNotifyFn2(
  [in]      FWPS_CALLOUT_NOTIFY_TYPE notifyType,
  [in]      const GUID *filterKey,
  [in, out] FWPS_FILTER2 *filter
)
{...}

パラメーター

[in] notifyType

フィルターエンジンが吹き出しに送信する通知の種類を示す値。このパラメーターの有効な値は次のとおりです。

FWPS_CALLOUT_NOTIFY_ADD_FILTER

フィルターのアクションの吹き出しを指定するフィルターエンジンにフィルターが追加されています。

FWPS_CALLOUT_NOTIFY_DELETE_FILTER

フィルターのアクションの吹き出しを指定するフィルターエンジンからフィルターが削除されています。

FWPS_CALLOUT_NOTIFY_TYPE_MAX

テスト目的の最大値。

[in] filterKey

フィルターを追加または削除しているアプリケーションまたはドライバーによって指定された、フィルターの管理識別子へのポインター。 notifyType パラメーターが FWPS_CALLOUT_NOTIFY_DELETE_FILTER に設定されている場合は NULL にする必要があります。詳細については、「解説」を参照してください。

[in, out] filter

FWPS_FILTER2構造体へのポインター。この構造体は、フィルターエンジンに追加または削除されるフィルターを表します。

吹き出しドライバーの notifyFn2 関数は、フィルターがフィルターエンジンに追加されるときに、この構造体の Context メンバーを、引き出しドライバーが指定したコンテキスト構造を指すよう設定できます。このコンテキスト構造はフィルターエンジンに対して不透明であり、引き出し線ドライバーの classifyFn2 吹き出し関数によって使用され、フィルターエンジンによる呼び出し間のドライバー固有のデータまたは状態情報を引き出しドライバーの呼び出し間で保持できます。
classifyFn2 吹き出し関数。

吹き出しドライバーの notifyFn2 関数は、フィルターエンジンからフィルターが削除されたときに、フィルターに関連付けられている任意のコンテキストをクリーンできます。

戻り値

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

リターンコード	説明
STATUS_SUCCESS	吹き出しドライバーは、フィルターエンジンからの通知を受け入れます。
その他の状態コード	エラーが発生しました。 notifyType パラメーターがFWPS_CALLOUT_NOTIFY_ADD_FILTER場合、フィルターはフィルターエンジンに追加されません。 notifyType パラメーターがFWPS_CALLOUT_NOTIFY_DELETE_FILTER場合でも、フィルターはフィルターエンジンから削除されます。

注釈

吹き出しドライバーは、 FwpsCalloutRegister2 関数を呼び出すことによって、吹き出しの吹き出し関数をフィルターエンジンに登録します。

フィルターエンジンは、吹き出しドライバーの notifyFn2 関数を呼び出して、引き出し線に関連付けられているイベントについて吹き出しドライバーに通知します。吹き出しドライバーの notifyFn2 関数が notifyType パラメーターで渡される通知の種類を認識しない場合は、通知を無視して、STATUS_SUCCESSを返す必要があります。

フィルターのアクションの吹き出しを指定するフィルターがフィルターエンジンに既に追加されている後、引き出しドライバーがフィルターエンジンに引き出し線を登録した場合、フィルターエンジンは引き出しドライバーの notifyFn2 関数を呼び出して既存のフィルターについて吹き出しを通知しません。フィルターエンジンは、吹き出しドライバーの notifyFn2 関数を呼び出して、フィルターのアクションの吹き出しを指定する新しいフィルターがフィルターエンジンに追加されたときに吹き出しを通知します。このような場合、吹き出しの notifyFn2 関数は、フィルターのアクションの吹き出しを指定するフィルターエンジン内のすべてのフィルターに対して呼び出されない場合があります。吹き出しドライバーがフィルターエンジンの起動後に吹き出しを登録し、フィルターのアクションの吹き出しを指定するフィルターエンジン内のすべてのフィルターについて引き出し線を認識する必要がある場合、吹き出しドライバーは、フィルターエンジン内のすべてのフィルターを列挙し、フィルターのアクションの吹き出しを指定するフィルターの結果の一覧を並べ替えるために、適切な管理機能を呼び出す必要があります。これらの関数の呼び出しの詳細については、「他の Windows フィルタープラットフォーム関数の呼び出し」を参照してください。

フィルターのアクションの引き出しを指定するフィルターがフィルターエンジンから削除されると、フィルターエンジンは引き出しドライバーの notifyFn2 関数を呼び出し、 notifyType パラメーターにFWP_CALLOUT_NOTIFY_DELETE_FILTERを渡し、 filterKey パラメーターに NULL を渡します。詳細については、「通知コールアウトの処理」を参照してください。

この関数は、基本的に前のバージョンの notifyFn1 と同じです。唯一の違いは、フィルター パラメーターによって指FWPS_FILTER2更新された構造体です。

要件

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