NDIS_SWITCH_PORT_PARAMETERS结构（ntddndis.h）

2025-02-07

NDIS_SWITCH_PORT_PARAMETERS 结构包含 Hyper-V 可扩展交换机端口的配置数据。

语法

typedef struct _NDIS_SWITCH_PORT_PARAMETERS {
  NDIS_OBJECT_HEADER            Header;
  ULONG                         Flags;
  NDIS_SWITCH_PORT_ID           PortId;
  NDIS_SWITCH_PORT_NAME         PortName;
  NDIS_SWITCH_PORT_FRIENDLYNAME PortFriendlyName;
  NDIS_SWITCH_PORT_TYPE         PortType;
  BOOLEAN                       IsValidationPort;
  NDIS_SWITCH_PORT_STATE        PortState;
} NDIS_SWITCH_PORT_PARAMETERS, *PNDIS_SWITCH_PORT_PARAMETERS;

成员

Header

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

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

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

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

将大小成员设置为NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1。

Flags

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

PortId

一个NDIS_SWITCH_PORT_ID值，该值包含可扩展交换机端口的唯一标识符。

PortName

一个NDIS_SWITCH_PORT_NAME值，该值指定可扩展交换机端口的唯一内部名称。

基于 WMI 的策略管理应用程序使用内部端口名称。有关详细信息，请参阅管理 Hyper-V 可扩展交换机策略。

PortFriendlyName

一个NDIS_SWITCH_PORT_FRIENDLYNAME值，该值指定可扩展交换机端口的用户友好说明。

PortType

指定可扩展交换机端口类型的 NDIS_SWITCH_PORT_TYPE 值。

IsValidationPort

如果为 TRUE，则指示在建立 VM 网络适配器连接之前临时创建的端口进行测试和验证。有关此端口类型的详细信息，请参阅验证端口。

PortState

指定端口的当前状态的 NDIS_SWITCH_PORT_STATE 值。

言论

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向以下 OID 请求 NDIS_SWITCH_PORT_PARAMETERS 结构的指针：

OID_SWITCH_PORT_ARRAY 的 OID 查询请求返回包含元素数组的 NDIS_SWITCH_PORT_ARRAY 结构。每个元素的格式设置为 NDIS_SWITCH_PORT_PARAMETERS 结构。

可扩展交换机扩展可以使用 NDIS_SWITCH_PORT_AT_ARRAY_INDEX 宏访问 NDIS_SWITCH_PORT_PARAMETERS 结构内的端口属性缓冲区。

注释NDIS_SWITCH_PORT_NAME 和 NDIS_SWITCH_PORT_FRIENDLYNAME 数据类型由 IF_COUNTED_STRING 结构定义。此结构定义的字符串不必以 null 结尾。但是，字符串的长度必须在此结构的 Length 成员中设置。如果该字符串以 null 结尾，则 Length 成员不得包含终止 null 字符。