NDIS_SWITCH_PORT_PROPERTY_PARAMETERS结构（ntddndis.h）

项目
02/07/2025

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 结构。

标头的类型成员必须设置为NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 结构的版本，必须将标头修订成员设置为以下值：

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

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

将大小成员设置为NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1。

Flags

包含标志的按位或的 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）文件中的扩展进行序列化以访问。

Note For Windows Server 2012， the SerializationVersion member must be set to 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 定义的自定义端口属性的参数。