Share via

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 结构 (ntddndis.h)

  • 项目

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 结构指定数组。 数组中的每个元素指定在网络适配器的网络适配器交换机上创建的虚拟端口 (VPort) 的属性。

语法

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

成员

Header

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

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

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1。

Flags

包含以下标志的按位 OR 的 ULONG 值：

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

此标志指定枚举附加到特定 PCI Express (PCIe) 函数的 VPort。 函数在 AttachedFunctionId 成员中指定。 此标志可用于枚举附加到 PCIe 物理函数的 VPort (PF) 或指定的 PCIe 虚拟函数 (VF) 。

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

此标志指定枚举在特定交换机上创建的 VPort，由 SwitchId 指定。 这会枚举在交换机上创建的所有 VPort。

注意 这些标志互斥。 在 Flags 成员中只能设置一个标志。
 

SwitchId

一个NDIS_NIC_SWITCH_ID值，该值指定开关标识符。 交换机标识符是介于零和网络适配器支持的交换机数之间的整数。 NDIS_DEFAULT_SWITCH_ID值指示默认网络适配器交换机。

仅当在 Flags 成员中指定了 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH 时，SwitchId 成员才有效。

注意从 Windows Server 2012 开始，单根 I/O 虚拟化 (SR-IOV) 接口仅支持网络适配器上的默认网络适配器开关。 此成员的值必须设置为 NDIS_DEFAULT_SWITCH_ID。
 

AttachedFunctionId

一个 NDIS_SRIOV_FUNCTION_ID 值，该值指定网络适配器上的 PF 或 VF 的标识符。

注意 如果此值NDIS_PF_FUNCTION_ID，则 VPort 将附加到 PF。
 
仅当在 Flags 成员中指定了 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION 时，AttachedFunctionId 成员才有效。

FirstElementOffset

一个 ULONG 值，该值指定此结构后面的元素数组中第一个元素的偏移量（以字节为单位）。 偏移量是从 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 结构的开头到第一个元素的开头测量的。 数组中的每个元素都是 NDIS_NIC_SWITCH_VPORT_INFO 结构。

注意 如果 NumElements 设置为零，则忽略此成员。
 

NumElements

一个 ULONG 值，该值指定 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 结构后面的元素数。

ElementSize

一个 ULONG 值，该值指定NDIS_NIC_SWITCH_VPORT_INFO_ARRAY结构后面的每个元素的大小 （ 以字节为单位）。

注解

当 NDIS 处理 OID_NIC_SWITCH_ENUM_VPORTS的 OID 方法请求时，NDIS 返回 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY结构。 数组中 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY结构后面的 每个元素都是
NDIS_NIC_SWITCH_VPORT_INFO 结构。

有关 SR-IOV 接口的详细信息，请参阅 单根 I/O 虚拟化概述 (SR-IOV) 。

要求

要求 值
最低受支持的客户端 在 NDIS 6.30 及更高版本中受支持。
标头 ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS