NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 结构 (ntddndis.h)

项目
02/29/2024

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

语法

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              FeatureStatusBufferLength;
  ULONG              FeatureStatusBufferOffset;
} NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM, *PNDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM;

成员

Header

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

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

NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1

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

将 Size 成员设置为NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1。

Flags

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

FeatureStatusBufferLength

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

FeatureStatusBufferOffset

一个 ULONG 值，该值指定 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM结构后面的 功能状态缓冲区的偏移量（以字节为单位）。偏移量是从 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 结构的开头到功能状态缓冲区的开头测量的。

注解

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缓冲区中返回的自定义状态的版本。 Hyper-v Extensible 开关在发出查询 OID 时填充所有其他成员。
包含指定可扩展交换机端口的功能状态数据的 NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM 结构。开关扩展填充结构的 FeatureStatusCustomBufferLength 成员，以反映返回的自定义状态的大小。 Hyper-v Extensible 开关在发出查询 OID 时填充所有其他成员。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向此信息缓冲区的指针。