NDIS_SWITCH_PORT_PARAMETERS 结构 (ntddndis.h)

项目
08/07/2023

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 结构。

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

NDIS_SWITCH_PORT_PARAMETERS_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NDIS_SWITCH_PORT_PARAMETERS_REVISION_1。

Flags

包含标志的按位 OR 的 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 字符。