NDIS_SWITCH_PROPERTY_PARAMETERS 结构 (ntddndis.h)

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

语法

typedef struct _NDIS_SWITCH_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_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;
} NDIS_SWITCH_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PROPERTY_PARAMETERS;

成员

Header

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

标头Type 成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。 若要指定 NDIS_SWITCH_PROPERTY_PARAMETERS 结构的版本,必须将 HeaderRevision 成员设置为以下值:

NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1

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

Size 成员设置为 NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1。

Flags

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

PropertyType

一个NDIS_SWITCH_PROPERTY_TYPE枚举值,该值指定属性缓冲区中包含的可扩展开关属性的类型。

PropertyId

标识可扩展交换机属性的 GUID 值。

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

注意 除非 PropertyType 成员设置为 NdisSwitchPropertyTypeCustom,否则可扩展交换机扩展必须忽略此成员。
 

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_PROPERTY_PARAMETERS结构后面的 属性缓冲区的偏移量(以字节为单位)。 偏移量从 NDIS_SWITCH_PROPERTY_PARAMETERS 结构的开头一直测量到属性缓冲区的开头。

注解

NDIS_SWITCH_PROPERTY_PARAMETERS 结构用于以下 OID 集请求:

属性缓冲区包含与 PropertyType 成员关联的结构。 属性缓冲区遵循与这些 OID 集请求关联的信息缓冲区中的 NDIS_SWITCH_PROPERTY_PARAMETERS 结构。 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向此信息缓冲区的指针。
注意从 Windows Server 2012 开始,PropertyType 成员必须设置为 NdisSwitchPropertyTypeCustom,并且属性缓冲区必须包含NDIS_SWITCH_PROPERTY_CUSTOM结构。
 
可扩展交换机扩展可以使用 NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY 宏访问NDIS_SWITCH_PROPERTY_PARAMETERS结构中的可扩展开关属性缓冲区。

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

要求

要求
最低受支持的客户端 在 NDIS 6.30 及更高版本中受支持。
标头 ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY

NDIS_SWITCH_PROPERTY_TYPE

OID_SWITCH_PROPERTY_ADD

OID_SWITCH_PROPERTY_UPDATE