FWPS_BIND_REQUEST0 構造体 (fwpsk.h)

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

FWPS_BIND_REQUEST0構造体は、FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4レイヤーとFWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6 レイヤーの変更可能なデータを定義します。コールアウトドライバーは、このデータを使用して接続情報を検査または変更します。

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

構文

typedef struct _FWPS_BIND_REQUEST0 {
  SOCKADDR_STORAGE           localAddressAndPort;
  UINT64                     portReservationToken;
  struct _FWPS_BIND_REQUEST0 *previousVersion;
  UINT64                     modifierFilterId;
} FWPS_BIND_REQUEST0;

メンバー

localAddressAndPort

バインド要求のローカルトランスポートアドレス。これは、 SOCKADDR_STORAGE 構造として書式設定された IPV4 または IPV6 アドレスと TCP/UDP ポートです。

portReservationToken

適切なポートを予約するために使用されるトークン。このトークンは、 CreatePersistentTcpPortReservation または CreatePersistentUdpPortReservation を呼び出して、ポートが予約されている場合に取得されます。どちらの予約関数も iphlpapi.h にあります。

previousVersion

以前のバージョンのバインド要求データ。この読み取り専用フィールドは、バインド要求の変更履歴を記録します。このメンバーは、現在のFWPS_BIND_REQUEST0 データのレコードにインデックスが設定された、1 つのリンクされたリストへのポインターを使用して事前初期化されます。

modifierFilterId

classifyFn 関数の filter パラメーターの FilterId メンバーの値。 FilterId メンバーの詳細については、「FWPS_FILTER1」を参照してください。

注釈

コールアウトドライバーは、を呼び出してこの構造体を取得します。 FwpsAcquireWritableLayerDataPointer0 関数。書き込み可能なLayerData パラメーターを介してFWPS_BIND_REQUEST0構造体へのポインターを返します。

classifyFn 関数は、ローカルトランスポートアドレスまたはポートを別のアドレスまたはポートにリダイレクトするなど、バインド要求のパラメーターを変更できます。バインド要求のパラメーターを変更すると、
classifyFn 関数では 、次の操作を行う必要があります。

FwpsAcquireWritableLayerDataPointer0 によって返されたFWPS_BIND_REQUEST0構造体に対するすべての変更を行います。 localAddressAndPort メンバーと portReservationToken メンバーのみを変更できます。
Call (英語の可能性あり)引き出しドライバーがデータを変更しなかった場合でも、modifiedLayerData パラメーターをFWPS_BIND_REQUEST0構造体のアドレスに設定した FwpsApplyModifiedLayerData0。この値は、によって返された modifiedLayerData パラメーター値と同じである必要があります FwpsAcquireWritableLayerDataPointer0。

この構造体は、他の吹き出しドライバーによって行われたすべての変更のレコードを含むリンクリストとして機能します。 previousVersion メンバーが NULL でない場合は、以前のバージョン情報があります。完全なバージョン履歴を調べるには、引き出し線ドライバーは、このメンバーが NULL に設定されているノードが見つかるまで、リスト内の各構造体の previousVersion メンバーを引き続き調べる必要があります。