NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 结构 (ntddndis.h)

项目
08/07/2023

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 结构指定 Hyper-V 可扩展交换机的配置文件属性数组。数组中的每个元素都格式化为 NDIS_SWITCH_PROPERTY_ENUM_INFO 结构。

语法

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
} NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PROPERTY_ENUM_PARAMETERS;

成员

Header

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

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

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1。

Flags

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

PropertyType

一个NDIS_SWITCH_PROPERTY_TYPE枚举值，该值指定可扩展开关属性类型。发出 OID_SWITCH_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_PROPERTY_ENUM_PARAMETERS结构后面的第一个NDIS_SWITCH_PROPERTY_ENUM_INFO 元素的偏移量（以字节为单位）。偏移量从 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 结构的开头一直测量到数组中第一个元素的开头。

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

NumProperties

一个 ULONG 值，该值指定 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 结构后面的 NDIS_SWITCH_PROPERTY_ENUM_INFO 元素数。

注解

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

可扩展交换机扩展可以使用 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO 宏访问 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 结构指定的第一个NDIS_SWITCH_PROPERTY_ENUM_INFO 结构。

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