FWPS_CALLOUT1 構造体 (fwpsk.h)

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

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

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

構文

typedef struct FWPS_CALLOUT1_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN1           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN1             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT1;

メンバー

calloutKey

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

flags

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

値	意味
FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW 0x00000001	コールアウトドライバーは、データフローをサポートするレイヤーに追加される吹き出しを登録するときに、このフラグを指定できます。このフラグが指定されている場合、フィルターエンジンは、データフローに関連付けられているコンテキストがある場合にのみ、引き出しドライバーの classifyFn1 吹き出し関数を呼び出します。コールアウトドライバーは、FwpsFlowAssociateContext0 関数を呼び出すことによって、コンテキストをデータフローに関連付けます。
FWP_CALLOUT_FLAG_ALLOW_OFFLOAD 0x00000002	コールアウトドライバーは、このフラグを指定して、コールアウトドライバーの classifyFn1 吹き出し関数が、ネットワークデータ処理をオフロード対応のネットワークインターフェイスカード (NIC) にオフロードしても影響を受けないように指定します。このフラグが指定されていない場合、フィルターのアクションの吹き出しを指定するフィルターによって処理されるすべてのトラフィックに対して、ネットワークデータ処理のオフロードが無効になります。
FWP_CALLOUT_FLAG_ENABLE_COMMIT_ADD_NOTIFY 0x00000004	コールアウトドライバーは、トランザクション内に追加されたオブジェクトとフィルターに関する通知を受け取ることができることを示すために、このフラグを指定します。フィルターエンジンは、トランザクションがコミットされた後に通知を送信します。
FWP_CALLOUT_FLAG_ALLOW_MID_STREAM_INSPECTION 0x00000008	吹き出しドライバーは、ストリームレベルでデータフローの動的ストリーム検査を実行できることを示すために、このフラグを指定します。「Stream検査」を参照してください。
FWP_CALLOUT_FLAG_ALLOW_RECLASSIFY 0x00000010	コールアウトドライバーは、既存のソケット操作が再分類されるときに呼び出される自体を登録するために、このフラグを指定します。

classifyFn

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

notifyFn

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

flowDeleteFn

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

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

注釈

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

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

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