FWPS_CALLOUT3構造体 (fwpsk.h)

FWPS_CALLOUT3 構造体は、吹き出しドライバーがフィルター エンジンに吹き出しを登録するために必要なデータを定義します。

構文

typedef struct FWPS_CALLOUT3_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN3           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN3             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT3;

メンバーズ

calloutKey

引き出し線を一意に識別する引き出しドライバー定義 GUID。

flags

吹き出し固有のパラメーターを指定するフラグ。 使用可能なフラグは次のとおりです。

classifyFn

吹き出しドライバーの classifyFn3 吹き出し関数へのポインター。 フィルター エンジンは、吹き出しによって処理されるネットワーク データがある場合は常に、この関数を呼び出します。

notifyFn

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

flowDeleteFn

引き出し線ドライバーの flowDeleteFn 吹き出し関数へのポインター。 フィルター エンジンは、吹き出しによって処理されているデータ フローが終了するたびに、この関数を呼び出します。

吹き出しドライバーが、引き出し線が処理するデータ フローにコンテキストを関連付けなかった場合は、このメンバーを NULL に設定する必要があります。

備考

コールアウト ドライバーは、フィルター エンジンにコールアウトを登録するときに、初期化された FWPS_CALLOUT3 構造体へのポインターを FwpsCalloutRegister3 関数に渡します。

コールアウトでは、ドライバーがストリーム検査の実行に関心がある接続に対してのみ、FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW フラグを設定できます。 この吹き出しは、他のすべての接続では無視されます。 パフォーマンスが向上し、ドライバーは不要な状態データを維持する必要はありません。

この構造は、基本的に以前のバージョンと同じです,FWPS_CALLOUT3. 唯一の違いは、このバージョンのメンバーが更新されたバージョンの吹き出し関数ポインターを格納し、コールアウト ドライバーが設定できる追加のフラグを使用できる点です。

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

必要条件

関連項目

• FWPS_CALLOUT0
• FWPS_CALLOUT1
• FWPS_CALLOUT2
• FwpsCalloutRegister3 を する
• classifyFn3
• flowDeleteFn を する
• notifyFn3 を する
• レイヤー 2 フィルタリング を使用した