NDIS_SWITCH_PORT_PARAMETERS结构 (ntddndis.h)

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结构的版本,必须将 HeaderRevision 成员设置为以下值:

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_NAMENDIS_SWITCH_PORT_FRIENDLYNAME数据类型由IF_COUNTED_STRING结构定义。 此结构定义的字符串不必以 null 结尾。 但是,必须在此结构的 Length 成员中设置字符串的长度。 如果字符串以 null 结尾, 则 Length 成员不得包含终止 null 字符。
 

要求

   
最低受支持的客户端 在 NDIS 6.30 及更高版本中受支持。
Header ntddndis.h (包括 Ndis.h、Fwpsk.h)

另请参阅

IF_COUNTED_STRING

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_AT_ARRAY_INDEX

NDIS_SWITCH_PORT_PARAMETERS

NDIS_SWITCH_PORT_STATE

NDIS_SWITCH_PORT_TYPE

OID_SWITCH_PORT_ARRAY

OID_SWITCH_PORT_CREATE

OID_SWITCH_PORT_DELETE

OID_SWITCH_PORT_TEARDOWN