FWPS_FILTER0 構造体 (fwpstypes.h)

[アーティクル]
05/07/2024

FWPS_FILTER0構造体は、フィルターエンジンの実行時フィルターを定義します。 FWPS_FILTER2 を使用できます。 Windows 7 では、 FWPS_FILTER1 を使用できます。

構文

typedef struct FWPS_FILTER0_ {
  UINT64                 filterId;
  FWP_VALUE0             weight;
  UINT16                 subLayerWeight;
  UINT16                 flags;
  UINT32                 numFilterConditions;
  FWPS_FILTER_CONDITION0 *filterCondition;
  FWPS_ACTION0           action;
  UINT64                 context;
  FWPM_PROVIDER_CONTEXT0 *providerContext;
} FWPS_FILTER0;

メンバー

filterId

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

weight

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

subLayerWeight

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

flags

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

値	意味
FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT	このフラグは、吹き出しの classifyFn0 吹き出し関数に対して、提案されたアクションのFWP_ACTION_BLOCKまたはFWP_ACTION_PERMITを返すときに常にFWPS_RIGHT_ACTION_WRITE フラグをクリアする必要があることを示します。このフラグが設定されていない場合、吹き出しの classifyFn0 吹き出し関数は、提案されたアクションのFWP_ACTION_BLOCKを返すときにのみ、FWPS_RIGHT_ACTION_WRITE フラグをクリアする必要があります。
FWPS_FILTER_FLAG_PERMIT_IF_CALLOUT_UNREGISTERED	このフラグは、吹き出しの classifyFn0 吹き出し関数に対して、吹き出しが登録されていない場合は、吹き出しを許可フィルターとして扱う必要があることを示します。
FWPS_FILTER_FLAG_OR_CONDITIONS	同じフィールドには複数の条件があります。 `OR` セマンティクスが適用されました。
FWPS_FILTER_FLAG_HAS_SECURITY_REALM_PROVIDER_CONTEXT	フィルターは、IPsec セキュリティ領域 ID のプロバイダーコンテキストを参照します。
FWPS_FILTER_FLAG_SILENT_MODE	フィルターはサイレントモードです。
FWPS_FILTER_FLAG_IPSEC_NO_ACQUIRE_INITIATE	パケットがこのフラグを持つフィルターの IPsec ポリシーと一致する場合は、IPsec の取得を開始しないでください。
FWPS_FILTER_FLAG_RESERVED0	システムで使用するために予約されています。
FWPS_FILTER_FLAG_RESERVED1	システムで使用するために予約されています。
FWPS_FILTER_FLAG_RESERVED2	システムで使用するために予約されています。

numFilterConditions

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

filterCondition

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

action

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

context

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

providerContext

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