NDIS_SWITCH_PROPERTY_PARAMETERS 结构 (ntddndis.h)

项目
02/26/2024

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 结构的版本，必须将 Header 的 Revision 成员设置为以下值：

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 可扩展交换机策略。