NDIS_NIC_SWITCH_VF_INFO_ARRAY 结构 (ntddndis.h)

项目
03/05/2024

NDIS_NIC_SWITCH_VF_INFO_ARRAY 结构指定数组。数组中的每个元素指定 PCI Express (PCIe) 虚拟函数 (VF) 的属性，这些函数已在网络适配器上启用和分配。

语法

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

成员

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1。

Flags

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

如果设置了此标志，微型端口驱动程序必须仅返回由 SwitchId 成员指定的网络适配器交换机上分配的 VF NDIS_NIC_SWITCH_VF_INFO 结构的数组。有关详细信息，请参见“备注”部分。

如果 Flags 成员设置为零，则微型端口驱动程序必须为在网络适配器的每个网络适配器交换机上分配的每个 VF 返回 NDIS_NIC_SWITCH_VF_INFO结构的数组。

注意从 Windows Server 2012 开始，SR-IOV 接口仅支持网络适配器上的默认网络适配器交换机。因此，微型端口驱动程序只能为默认网络适配器交换机上分配的每个 VF 返回 NDIS_NIC_SWITCH_VF_INFO结构数组。

SwitchId

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

注意从 Windows Server 2012 开始，SR-IOV 接口仅支持在网络适配器上创建的默认网络适配器交换机。因此，必须始终将此成员设置为 NDIS_DEFAULT_SWITCH_ID。

FirstElementOffset

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

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

NumElements

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

ElementSize

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

注解

NDIS 在处理 OID_NIC_SWITCH_ENUM_VFS 的 OID 方法请求时返回 NDIS_NIC_SWITCH_VF_INFO_ARRAY结构。数组中 NDIS_NIC_SWITCH_VF_INFO_ARRAY 结构后面的每个元素都是
NDIS_NIC_SWITCH_VF_INFO 结构。