NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 结构 (ntddndis.h)

项目
02/26/2024

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 结构指定 Hyper-V 可扩展交换机端口的策略属性的参数。

语法

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

成员

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1。

Flags

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

PortId

一个NDIS_SWITCH_PORT_ID值，该值包含分配给该属性的可扩展交换机端口的唯一标识符。

PropertyType

一个NDIS_SWITCH_PORT_PROPERTY_TYPE枚举值，该值指定属性缓冲区中包含的端口属性的类型。

PropertyId

一个 GUID 值，该值标识可扩展交换机端口的属性。

有关详细信息，请参见“备注”部分。

注意除非 PropertyType 成员设置为 NdisSwitchPortPropertyTypeCustom，否则可扩展开关扩展必须忽略此成员。

PropertyVersion

一个NDIS_SWITCH_OBJECT_VERSION值，该值标识可扩展交换机端口的属性版本。

SerializationVersion

一个NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION值，该值标识序列化端口属性数据的格式版本。此数据由扩展从定义属性的托管对象格式 (MOF) 文件中进行序列化以供访问。

注意对于Windows Server 2012，SerializationVersion 成员必须设置为 NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1。

PropertyInstanceId

一个NDIS_SWITCH_OBJECT_INSTANCE_ID值，该值标识可扩展交换机端口的属性实例。

PropertyBufferLength

一个 ULONG 值，该值指定属性缓冲区的大小（以字节为单位）。

PropertyBufferOffset

一个 ULONG 值，该值指定 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS结构后面的 属性缓冲区的偏移量（以字节为单位）。偏移量是从 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 结构的开头到属性缓冲区的开头测量的。

Reserved

保留供将来使用。

注解

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

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

可扩展交换机扩展在处理 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 结构时必须遵循以下准则：

如果将 PropertyType 成员设置为 NdisSwitchPortPropertyTypeSecurity，则属性缓冲区的格式设置为 NDIS_SWITCH_PORT_PROPERTY_SECURITY 结构。
如果将 PropertyType 成员设置为 NdisSwitchPortPropertyTypeVlan，则属性缓冲区的格式设置为 NDIS_SWITCH_PORT_PROPERTY_VLAN 结构。
如果 PropertyType 成员设置为 NdisSwitchPortPropertyTypeProfile，则属性缓冲区的格式设置为 NDIS_SWITCH_PORT_PROPERTY_PROFILE 结构。
如果 PropertyType 成员设置为 NdisSwitchPortPropertyTypeCustom，则必须将 PropertyId 成员设置为独立软件供应商 (ISV) 为自定义端口属性创建的 GUID 值。属性缓冲区的格式设置为 NDIS_SWITCH_PORT_PROPERTY_CUSTOM 结构，其中包含 ISV 定义的自定义端口属性的参数。