NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS结构（ntddndis.h）

项目
02/07/2025

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 结构指定 Hyper-V 可扩展交换机端口的自定义状态信息的参数。此信息称为 功能状态 信息。此信息的格式由独立软件供应商（ISV）定义。

状态信息是通过 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 结构指定的，并通过 OID_SWITCH_PORT_FEATURE_STATUS_QUERY的 OID 方法请求返回。

语法

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE     FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  ULONG                                    FeatureStatusBufferLength;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS;

成员

Header

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

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

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

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

将大小成员设置为NDIS_SIZEOF_NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1。

Flags

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

PortId

一个NDIS_SWITCH_PORT_ID值，该值指定可扩展交换机端口的数字标识符。此值唯一标识要为其返回功能状态信息的可扩展交换机上的端口。

FeatureStatusType

一个 NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE 枚举值，该值指定自定义可扩展交换机端口配置文件属性的状态信息的类型。

注释从 NDIS 6.30 开始，此成员必须设置为 NdisSwitchPortPropertyTypeCustom。

FeatureStatusId

一个NDIS_SWITCH_OBJECT_ID值，该值标识可扩展交换机端口的配置文件属性。

FeatureStatusVersion

一个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.

FeatureStatusInstanceId

一个NDIS_SWITCH_OBJECT_INSTANCE_ID值，该值标识可扩展交换机端口的功能状态信息的实例。

FeatureStatusBufferLength

一个 ULONG 值，该值指定功能状态缓冲区的大小（以字节为单位）。

FeatureStatusBufferOffset

一个 ULONG 值，该值指定 NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 结构后面的功能状态缓冲区的偏移量（以字节为单位）。功能状态缓冲区包含 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 结构。

偏移量从 NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 结构的开始到 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 结构的开头。

Reserved

保留以供将来使用。

言论

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 结构用于 OID_SWITCH_PORT_FEATURE_STATUS_QUERY的 OID 方法请求中。此 OID 请求返回与 OID 请求关联的信息缓冲区中的以下结构：

一个 NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS 结构，它指定要为其返回状态信息的可扩展交换机端口的自定义属性的参数。该开关扩展填充结构 FeatureStatusVersion 成员，以反映NDIS_SWITCH_FEATURE_STATUS_CUSTOM缓冲区中返回的自定义状态的版本。发出查询 OID 时，Hyper-v 可扩展开关将填充所有其他成员。
包含可扩展交换机端口属性的状态信息的 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 结构。开关扩展填充 FeatureStatusCustomBufferLength 结构成员，以反映返回的自定义状态的大小。发出查询 OID 时，Hyper-v 可扩展开关将填充所有其他成员。