NDIS_SWITCH_PORT_PROPERTY_SECURITY 结构 (ntddndis.h)

项目
03/05/2024

NDIS_SWITCH_PORT_PROPERTY_SECURITY 结构指定 Hyper-V 可扩展交换机端口的安全策略属性。

语法

typedef struct _NDIS_SWITCH_PORT_PROPERTY_SECURITY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  BOOLEAN            AllowMacSpoofing;
  BOOLEAN            AllowIeeePriorityTag;
  UINT32             VirtualSubnetId;
  BOOLEAN            AllowTeaming;
  UINT32             DynamicIPAddressLimit;
} NDIS_SWITCH_PORT_PROPERTY_SECURITY, *PNDIS_SWITCH_PORT_PROPERTY_SECURITY;

成员

Header

NDIS_SWITCH_PORT_PROPERTY_SECURITY结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

标头的 Type 成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。若要指定NDIS_SWITCH_PORT_PROPERTY_SECURITY结构的版本，必须将 Header 的 Revision 成员设置为以下值：

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将 Size 成员设置为 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1。

Flags

包含标志的按位 OR 的 ULONG 值。此成员是为 NDIS 保留的。

AllowMacSpoofing

一个 BOOLEAN 值，如果设置为 TRUE，则指定允许端口使用源媒体访问控制发送数据包 (MAC) 地址与其永久 MAC 地址不同的地址。端口的永久 MAC 地址是通过对象标识符 (OID) OID_SWITCH_NIC_CREATE集请求配置的。

AllowIeeePriorityTag

一个 BOOLEAN 值，如果设置为 TRUE，则指定当数据包转发到端口时，端口必须保留数据包 NET_BUFFER_LIST 结构中的 802.1Q 优先级信息。仅当在数据包NET_BUFFER_LIST结构的带外数据NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO联合中设置 PreservePriority 成员时，端口才能保留优先级信息。

VirtualSubnetId

一个 UINT32 值，该值指定在端口上配置的网络虚拟化 VirtualSubnetId 。如果未在端口上配置网络虚拟化，则值为 0。 NET_BUFFER_LIST的NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO带外数据包含 VirtualSubnetId，它填充了流量的虚拟子网成员身份。

AllowTeaming

一个 BOOLEAN 值，如果设置为 TRUE，则指定允许对端口进行组合故障转移，以便端口可以发送具有源媒体访问控制的数据包， (MAC) 地址与其 PermanentMacAddress 不同，但等于连接到同一虚拟机的另一个端口当前使用的 MAC 地址。端口的永久 MAC 地址是通过对象标识符 (OID) OID_SWITCH_NIC_CREATE OID_SWITCH_NIC_UPDATE/集请求配置的。

DynamicIPAddressLimit

一个 UINT32 值，该值指定可了解端口的最大动态 IP 地址数。

注解

NDIS_SWITCH_PORT_PROPERTY_SECURITY 结构用于以下 OID 集请求：

NDIS_SWITCH_PORT_PROPERTY_SECURITY结构遵循与这些 OID 集请求关联的缓冲区中的NDIS_SWITCH_PORT_PROPERTY_PARAMETERS结构。 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向此缓冲区的指针。

端口属性（如 NDIS_SWITCH_PORT_PROPERTY_SECURITY）由作为转发扩展安装的可扩展交换机扩展强制执行。这种类型的扩展通过可扩展交换机驱动程序堆栈强制实施自己的规则来转发数据包、OID 和状态指示。每个可扩展交换机实例只能有一个转发扩展。

有关转发扩展的详细信息，请参阅转发扩展。

注意如果未安装转发扩展，可扩展交换机接口将强制实施端口属性本身。