FWPS_CALLOUT0構造体 (fwpsk.h)

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

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

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

構文

typedef struct FWPS_CALLOUT0_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN0           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN0             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT0;

メンバー

calloutKey

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

flags

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

FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW

吹き出しドライバーは、データフローをサポートするレイヤーに追加される吹き出しを登録するときに、このフラグを指定できます。このフラグが指定されている場合、フィルターエンジンは、データフローに関連付けられているコンテキストがある場合にのみ、引き出しドライバーの classifyFn0 吹き出し関数を呼び出します。吹き出しドライバーは、FwpsFlowAssociateContext0 関数を呼び出すことによって、コンテキストをデータフローに関連付けます。

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

吹き出しドライバーは、引き出しドライバーの classifyFn0 引き出し関数がオフロード対応ネットワークインターフェイスカード (NIC) にネットワークデータ処理をオフロードすることによって影響を受けないことを示すために、このフラグを指定します。このフラグが指定されていない場合、フィルターのアクションの吹き出しを指定するフィルターによって処理されるすべてのトラフィックに対して、ネットワークデータ処理のオフロードが無効になります。

classifyFn

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

notifyFn

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

flowDeleteFn

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

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

注釈

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

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