fwpsu.h) (FWPS_INCOMING_METADATA_VALUES0 结构

项目
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

一个 UINT32 值，该值包含元数据字段标识符组合的按位 OR，这些标识符指定在结构中设置的元数据值。

flags

在内部由筛选器引擎使用。标注驱动程序应忽略此成员。

reserved

预留给系统使用。标注驱动程序应忽略此成员。

discardMetadata

描述数据被丢弃的原因的FWPS_DISCARD_METADATA0 结构。仅当 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_DISCARD_REASON标志时，此成员才包含有效数据。

flowHandle

数据流的句柄。仅当在 currentMetadataValues 成员中设置了 FWPS_METADATA_FIELD_FLOW_HANDLE 标志时，此成员才包含有效数据。

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 大于零，则指定从数据偏移位置到 IP 标头末尾的字节数。

此成员不适用于以下层的出站路径：

FWPS_LAYER_DATAGRAM_DATA_V4

FWPS_LAYER_DATAGRAM_DATA_V6

FWPS_LAYER_DATAGRAM_DATA_V4_DISCARD

FWPS_LAYER_DATAGRAM_DATA_V6_DISCARD

仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_IP_HEADER_SIZE标志时，此成员才包含有效数据。

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 指定要从数据偏移位置前进到传输标头末尾的字节数。

仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_TRANSPORT_HEADER_SIZE标志时，此成员才包含有效数据。

processPath

指向 FWP_BYTE_BLOB 结构的指针，该结构包含拥有终结点的进程的完整路径。仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_PROCESS_PATH标志时，此成员才包含有效数据。

token

用于验证用户权限的令牌句柄。仅当 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_TOKEN标志时，此成员才包含有效数据。

processId

拥有终结点的进程的进程 ID。仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_PROCESS_ID标志时，此成员才包含有效数据。

sourceInterfaceIndex

接收传入数据包的网络接口的索引。仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_SOURCE_INTERFACE_INDEX标志时，此成员才包含有效数据。

destinationInterfaceIndex

要在其中发送传出数据包的网络接口的索引。仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_DESTINATION_INTERFACE_INDEX标志时，此成员才包含有效数据。

compartmentId

接收数据包或正在发送数据包的路由隔离舱的标识符。任何修改后的数据包都应注入回为原始数据包指示的同一路由隔离舱。仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_COMPARTMENT_ID标志时，此成员才包含有效数据。

fragmentMetadata

描述接收的数据包片段数据的 FWPS_INBOUND_FRAGMENT_METADATA0 结构。仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_FRAGMENT_DATA标志时，此成员才包含有效数据。

pathMtu

出站数据包的路径最大传输单元 (路径 MTU) 。此值指示网络可以在不分段的情况下传输的最大物理数据包大小（以字节为单位）。仅当 currentMetadataValues 成员中设置了 FWPS_METADATA_FIELD_PATH_MTU 标志时，此成员才包含有效数据。

completionHandle

完成当前筛选操作所需的完成句柄。仅当在 currentMetadataValues 成员中设置了 FWPS_METADATA_FIELD_COMPLETION_HANDLE 标志时，此成员才包含有效数据。

transportEndpointHandle

一个终结点句柄，指示要注入到出站传输层的数据包的末尾。仅当在 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_TRANSPORT_ENDPOINT_HANDLE标志时，此成员才包含有效数据。

remoteScopeId

要用于出站传输层注入的远程范围标识符。仅当 currentMetadataValues 成员中设置了 FWPS_METADATA_FIELD_REMOTE_SCOPE_ID 标志时，此成员才包含有效数据。

controlData

可选的套接字控件数据对象。仅当 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_TRANSPORT_CONTROL_DATA标志时，此成员才包含有效数据。有关 WSACMSGHDR 类型的信息，请参阅 CMSGHDR。

controlDataLength

controlData 成员的长度（以字节为单位）。

packetDirection

网络流量的方向 (由 FWP_DIRECTION 常量值之一指定的入站或出站 ) 。此成员是在重新授权分类操作期间在应用层强制 (ALE) 连接或接收/接受层时设置的。有关详细信息，请参见“备注”部分。

仅当 currentMetadataValues 成员中设置了FWPS_METADATA_FIELD_PACKET_DIRECTION标志时，此成员才包含有效数据。

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 函数以获取重定向状态的重定向记录句柄。