FWPS_INCOMING_METADATA_VALUES0構造体 (fwpsu.h)

[アーティクル]
06/12/2024

フィルターエンジンが吹き出しの classifyFn 吹き出し関数に渡すメタデータ値を定義します。

注意

FWPS_INCOMING_METADATA_VALUES0 は、特定のバージョンの FWPS_INCOMING_METADATA_VALUESです。詳細については、「 WFP のバージョンに依存しない名前」と「特定のバージョンの Windows を対象とする」を参照してください。

構文

typedef struct FWPS_INCOMING_METADATA_VALUES0_ {
  UINT32                          currentMetadataValues;
  UINT32                          flags;
  UINT64                          reserved;
  FWPS_DISCARD_METADATA0          discardMetadata;
  UINT64                          flowHandle;
  UINT32                          ipHeaderSize;
  UINT32                          transportHeaderSize;
  FWP_BYTE_BLOB                   *processPath;
  UINT64                          token;
  UINT64                          processId;
  UINT32                          sourceInterfaceIndex;
  UINT32                          destinationInterfaceIndex;
  ULONG                           compartmentId;
  FWPS_INBOUND_FRAGMENT_METADATA0 fragmentMetadata;
  ULONG                           pathMtu;
  HANDLE                          completionHandle;
  UINT64                          transportEndpointHandle;
  SCOPE_ID                        remoteScopeId;
  WSACMSGHDR                      *controlData;
  ULONG                           controlDataLength;
  FWP_DIRECTION                   packetDirection;
  PVOID                           headerIncludeHeader;
  ULONG                           headerIncludeHeaderLength;
  IP_ADDRESS_PREFIX               destinationPrefix;
  UINT16                          frameLength;
  UINT64                          parentEndpointHandle;
  UINT32                          icmpIdAndSequence;
  DWORD                           localRedirectTargetPID;
  SOCKADDR                        *originalDestination;
  HANDLE                          redirectRecords;
  UINT32                          currentL2MetadataValues;
  UINT32                          l2Flags;
  UINT32                          ethernetMacHeaderSize;
  UINT32                          wiFiOperationMode;
  HANDLE                          vSwitchPacketContext;
  PVOID                           subProcessTag;
  UINT64                          reserved1;
} FWPS_INCOMING_METADATA_VALUES0;

メンバー

currentMetadataValues

構造体に設定されるメタデータ値を指定するメタデータフィールド識別子の組み合わせのビットごとの OR を含む UINT32 値。

flags

フィルターエンジンによって内部的に使用されます。吹き出しドライバーは、このメンバーを無視する必要があります。

reserved

システムで使用するために予約されています。吹き出しドライバーは、このメンバーを無視する必要があります。

discardMetadata

データが破棄された理由を説明するFWPS_DISCARD_METADATA0構造体。このメンバーには、FWPS_METADATA_FIELD_DISCARD_REASON フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

flowHandle

データフローのハンドル。このメンバーには、FWPS_METADATA_FIELD_FLOW_HANDLE フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

ipHeaderSize

IP ヘッダーのオフセット (バイト単位)。

受信パスでは、 ipHeaderSize は transportHeaderSize メンバーと組み合わせて使用する場合、データオフセットの場所から IP ヘッダーの先頭に退避するバイト数を指定します。

次の受信 ICMP エラー層では、 ipHeaderSize だけで、データオフセットから IP ヘッダーの先頭に退避する合計バイト数を指定します。

FWPS_LAYER_INBOUND_ICMP_ERROR_V4

FWPS_LAYER_INBOUND_ICMP_ERROR_V6

FWPS_LAYER_INBOUND_ICMP_ERROR_V4_DISCARD

FWPS_LAYER_INBOUND_ICMP_ERROR_V6_DISCARD

送信パスで、 ipHeaderSize が 0 より大きい場合は、データオフセットの場所から IP ヘッダーの末尾に進むバイト数を指定します。

このメンバーは、次のレイヤーの送信パスには適用されません。

FWPS_LAYER_DATAGRAM_DATA_V4

FWPS_LAYER_DATAGRAM_DATA_V6

FWPS_LAYER_DATAGRAM_DATA_V4_DISCARD

FWPS_LAYER_DATAGRAM_DATA_V6_DISCARD

このメンバーには、FWPS_METADATA_FIELD_IP_HEADER_SIZE フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

transportHeaderSize

トランスポートヘッダーのオフセットまたはサイズ (バイト単位)。

受信パスでは、 transportHeaderSize は、データオフセットの場所からトランスポートヘッダーの末尾に退避するバイト数を指定します。

次の受信 ICMP エラー層で、 transportHeaderSize は ICMP ヘッダーのサイズを指定します。

FWPS_LAYER_INBOUND_ICMP_ERROR_V4

FWPS_LAYER_INBOUND_ICMP_ERROR_V6

FWPS_LAYER_INBOUND_ICMP_ERROR_V4_DISCARD

FWPS_LAYER_INBOUND_ICMP_ERROR_V6_DISCARD

送信パスでは、 transportHeaderSize は、データオフセットの場所からトランスポートヘッダーの末尾に進むバイト数を指定します。

このメンバーには、FWPS_METADATA_FIELD_TRANSPORT_HEADER_SIZE フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

processPath

エンドポイントを所有するプロセスへの完全なパスを含むFWP_BYTE_BLOB構造体へのポインター。このメンバーには、FWPS_METADATA_FIELD_PROCESS_PATH フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

token

ユーザーのアクセス許可を検証するために使用されるトークンのハンドル。このメンバーには、FWPS_METADATA_FIELD_TOKEN フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

processId

エンドポイントを所有するプロセスのプロセス ID。このメンバーには、 FWPS_METADATA_FIELD_PROCESS_ID フラグが currentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

sourceInterfaceIndex

受信パケットが受信されたネットワークインターフェイスのインデックス。このメンバーには、FWPS_METADATA_FIELD_SOURCE_INTERFACE_INDEX フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

destinationInterfaceIndex

送信パケットが送信されるネットワークインターフェイスのインデックス。このメンバーには、FWPS_METADATA_FIELD_DESTINATION_INTERFACE_INDEX フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

compartmentId

パケットが受信されたか、または送信されているルーティングコンパートメントの識別子。変更されたパケットは、元のパケットに示されているのと同じルーティングコンパートメントに挿入し直す必要があります。このメンバーには、FWPS_METADATA_FIELD_COMPARTMENT_ID フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

fragmentMetadata

受信したパケットフラグメントのフラグメントデータを記述する FWPS_INBOUND_FRAGMENT_METADATA0 構造体。このメンバーには、FWPS_METADATA_FIELD_FRAGMENT_DATA フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

pathMtu

送信パケットのパス最大伝送単位 (パス MTU)。この値は、ネットワークが断片化なしで送信できる最大の物理パケットサイズ (バイト単位) を示します。このメンバーには、currentMetadataValues メンバーに FWPS_METADATA_FIELD_PATH_MTU フラグが設定されている場合にのみ有効なデータが含まれます。

completionHandle

現在のフィルター処理操作を実行するために必要な完了ハンドル。このメンバーには、 FWPS_METADATA_FIELD_COMPLETION_HANDLE フラグが currentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

transportEndpointHandle

送信トランスポート層に挿入されるパケットの末尾を示すエンドポイントハンドル。このメンバーには、FWPS_METADATA_FIELD_TRANSPORT_ENDPOINT_HANDLE フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

remoteScopeId

送信トランスポート層の挿入で使用されるリモートスコープ識別子。このメンバーには、FWPS_METADATA_FIELD_REMOTE_SCOPE_ID フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

controlData

省略可能なソケットコントロールデータオブジェクト。このメンバーには、FWPS_METADATA_FIELD_TRANSPORT_CONTROL_DATA フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。 WSACMSGHDR タイプの詳細については、CMSGHDR を参照してください。

controlDataLength

controlData メンバーの長さ (バイト単位)。

packetDirection

FWP_DIRECTIONのいずれかの定数値で指定されたネットワークトラフィック (受信または送信) の方向。このメンバーは、再認証分類操作中に、アプリケーション層強制 (ALE) 接続または受信/受け入れレイヤーで設定されます。詳細については、「解説」を参照してください。

このメンバーには、FWPS_METADATA_FIELD_PACKET_DIRECTION フラグがcurrentMetadataValues メンバーに設定されている場合にのみ、有効なデータが含まれます。

headerIncludeHeader

パケットが生ソケットから送信された場合の IP ヘッダーへのポインター。

Windows Server 2008、Windows Vista SP1、およびそれ以降のバージョンの Windows でのみ使用できます。

headerIncludeHeaderLength

headerIncludeHeader が指す IP ヘッダーの長さ (バイト単位)。

Windows Server 2008、Windows Vista SP1、およびそれ以降のバージョンの Windows でのみ使用できます。

destinationPrefix

宛先プレフィックス。

Windows 7 以降のバージョンの Windows でのみ使用できます。

frameLength

フレームの長さ。

Windows 7 以降のバージョンの Windows でのみ使用できます。

parentEndpointHandle

エンドポイントの親のハンドル。

Windows 7 以降のバージョンの Windows でのみ使用できます。

icmpIdAndSequence

ICMP 識別子とシーケンス。

Windows 7 以降のバージョンの Windows でのみ使用できます。

localRedirectTargetPID

リダイレクトされた接続を担当するプロセスの PID。

Windows 7 以降のバージョンの Windows でのみ使用できます。

originalDestination

リダイレクトされた接続の元の宛先。

Windows 7 以降のバージョンの Windows でのみ使用できます。

redirectRecords

リダイレクト状態を取得するために FwpsQueryConnectionRedirectState0 関数に渡すことができるリダイレクトレコードハンドル。