FWPS_FILTER2 構造体 (fwpstypes.h)

  • [アーティクル]

FWPS_FILTER0を使用できます。

構文

typedef struct FWPS_FILTER2_ {
  UINT64                 filterId;
  FWP_VALUE0             weight;
  UINT16                 subLayerWeight;
  UINT16                 flags;
  UINT32                 numFilterConditions;
  FWPS_FILTER_CONDITION0 *filterCondition;
  FWPS_ACTION0           action;
  UINT64                 context;
  FWPM_PROVIDER_CONTEXT2 *providerContext;
} FWPS_FILTER2;

メンバー

filterId

フィルター エンジン内のフィルターを識別するランタイム識別子。

weight

フィルター エンジン内の他のフィルターに対するフィルターの重要度を指定する値を含む FWP_VALUE0 構造体。 重みの値が大きいフィルターは、最初に呼び出されます。 FWP_VALUE0構造体で指定されたデータ型は、FWP_UINT64またはFWP_EMPTYです。 FWP_VALUE0構造体で指定されたデータ型がFWP_EMPTYされている場合、フィルター エンジンは、フィルター エンジン内の他のフィルターと比較して、フィルターがデータをテストする具体的な方法に基づいて、フィルターに重みを自動的に割り当てます。

subLayerWeight

フィルター エンジン内の他のサブレイヤーに対するフィルターのサブレイヤーの重要度を示す 値。 subLayerWeight 値が高いサブレイヤーにあるフィルターは、最初に呼び出されます。

flags

ネットワーク データを処理するときに吹き出しの classifyFn2 吹き出し関数が実行する必要があるアクションを指定するフラグ。 使用可能なフラグは次のとおりです。

値 意味
FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT このフラグは、引き出し線の classifyFn2 吹き出し関数に対して、提案されたアクションのFWP_ACTION_BLOCKまたはFWP_ACTION_PERMITを返すときに、常にFWPS_RIGHT_ACTION_WRITE フラグをクリアする必要があることを示します。 このフラグが設定されていない場合、吹き出しの classifyFn2 吹き出し関数は、提案されたアクションのFWP_ACTION_BLOCKを返すときにのみ、FWPS_RIGHT_ACTION_WRITE フラグをクリアする必要があります。
FWPS_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED このフラグは、吹き出しの classifyFn2 吹き出し関数に対して、吹き出しが登録されていない場合は、吹き出しを許可フィルターとして扱う必要があることを示します。

numFilterConditions

filterCondition メンバーが指す配列内のFWPS_FILTER_CONDITION0構造体の数。 このメンバーは 0 にすることができます。

filterCondition

FWPS_FILTER_CONDITION0構造体の配列へのポインター。 これらの構造体は、フィルターの実行時フィルター条件を定義します。 numFilterConditions メンバーが 0 の場合、このポインターは NULL になります。

action

フィルターのすべてのフィルター条件が true の場合にフィルターが実行する必要があるアクションを指定するFWPS_ACTION0構造体。

context

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

providerContext

プロバイダー コンテキストへのポインター。 これは、FWPM_PROVIDER_CONTEXT2 構造体として書式設定されます。 フィルターで吹き出しが使用され、吹き出しにFWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT フラグが設定されている場合、このメンバーには、対応する FWPM_FILTER0 構造体のプロバイダー コンテキストが含まれます。 それ以外の場合、このパラメーターは NULL です。

解説

フィルター エンジンは、引き出し線の notifyFn2 と classifyFn2 吹き出し関数にFWPS_FILTER2構造体へのポインターを渡します。

フィルターのアクションは、フィルターのすべてのフィルター条件が true の場合にのみ実行されます。 フィルターでフィルター条件が指定されていない場合、指定されたアクションは常に実行されます。

providerContext メンバーは、引き出しドライバーがベース フィルター エンジン (BFE) を呼び出さずにプロバイダー コンテキストを取得するためのメカニズムを提供します。

この構造体は、providerContext メンバーの構造体FWPM_PROVIDER_CONTEXT2以前のバージョンと基本的に同じです。

要件

   
サポートされている最小のクライアント Windows 8 以降で使用できます。
Header fwpstypes.h (Fwpsk.h を含む)

関連項目

FWPM_FILTER0

FWPM_PROVIDER_CONTEXT2

FWPS_ACTION0

FWPS_FILTER0

FWPS_FILTER1

FWPS_FILTER_CONDITION0

FWP_VALUE0

classifyFn2

notifyFn2