NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构 (ntddndis.h)

项目
08/07/2023

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构指定 Hyper-V 可扩展交换机端口的策略属性数组。数组中的每个元素都格式化为 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 结构。

语法

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_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_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

成员

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1。

Flags

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

PortId

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

PropertyType

一个NDIS_SWITCH_PORT_PROPERTY_TYPE枚举值，该值指定端口属性类型。发出 OID_SWITCH_PORT_PROPERTY_ENUM 的 OID 方法请求时，可扩展交换机扩展将返回与此属性类型匹配的端口属性。

PropertyId

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

SerializationVersion

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

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

FirstPropertyOffset

一个 USHORT 值，该值指定NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构后面的第一个NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO元素的偏移量（以字节为单位）。偏移量是从 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构的开头到数组第一个元素的开头测量的。

注意如果 NumProperties 的值为零，则忽略此成员。

NumProperties

一个 ULONG 值，该值指定 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构后面的 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 元素的数目。

Reserved

保留供将来使用。

注解

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构用于OID_SWITCH_PORT_PROPERTY_ENUM的 OID 方法请求。 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 结构的数组遵循与这些 OID 集请求关联的信息缓冲区中的 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构。 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向此信息缓冲区的指针。

可扩展交换机扩展可以使用 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO 宏访问 由 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构指定的第一个NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 结构。

有关可扩展交换机策略的详细信息，请参阅 Hyper-V 可扩展交换机策略。