NDIS_NIC_SWITCH_INFO 结构 (ntddndis.h)

项目
08/07/2023

NDIS_NIC_SWITCH_INFO结构指定有关网络适配器上的网络适配器交换机的信息。

语法

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

成员

Header

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

微型端口驱动程序必须将 Header 的 Type 成员设置为 NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_NIC_SWITCH_INFO 结构的版本，驱动程序必须将 Header 的 Revision 成员设置为以下值：

NDIS_NIC_SWITCH_INFO_REVISION_1

NDIS 6.30 的原始版本。

将 Size 成员设置为 NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1。

Flags

一个 ULONG 值，该值包含交换机上启用的配置标志的按位 OR。

注意对于 NDIS 6.30，不会为交换机定义配置标志。 Flags 成员必须设置为零。

SwitchType

一个指定开关类型的NDIS_NIC_SWITCH_TYPE值。

SwitchId

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

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

SwitchFriendlyName

包含开关的用户友好说明的NDIS_NIC_SWITCH_FRIENDLYNAME值。

NumVFs

一个 ULONG 值，该值指定在网络适配器上启用的 PCI Express (PCIe) Virtual Functions (VF) 的数目。已启用的 VF 可以处于已分配或未分配状态。

NumAllocatedVFs

一个 ULONG 值，该值指定在 SwitchId 指定的网络适配器交换机上分配的 VF 数。 VF 通过 OID_NIC_SWITCH_ALLOCATE_VF的 OID 集请求进行分配。

NumVPorts

一个 ULONG 值，该值指定在 SwitchId 指定的网络适配器交换机上配置的虚拟端口数 (VPorts) 。

此 ULONG 值是以下值之和：

可通过 OID_NIC_SWITCH_CREATE_VPORT的 OID 集请求创建的最大 VPort 数。
附加到物理函数的默认 VPort (PF) 。

NumActiveVPorts

一个 ULONG 值，该值指定在 SwitchId 指定的网络适配器交换机上创建的 VPort 数。

注意除了通过OID_NIC_SWITCH_CREATE_VPORT的 OID 集请求创建的非默认 VPort 外，此 ULONG 值还包括默认的 VPort。

NumQueuePairsForDefaultVPort

一个 ULONG 值，该值指定为默认 VPort 分配的队列对数。默认 VPort 始终附加到 PF。

队列对由传输队列和接收队列组成。在创建交换机时，微型端口驱动程序通过 OID_NIC_SWITCH_CREATE_SWITCH 的 OID 方法请求将一个或多个队列对与默认 VPort 相关联。

注意从 NDIS 6.30 开始，只能为默认 VPort 配置一个队列对。

NumQueuePairsForNonDefaultVPorts

一个 ULONG 值，该值指定为非默认 VPort 分配的队列对数。非默认 VPort 可以附加到网络适配器的 PF 或任何 VF。

微型端口驱动程序通过 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法请求，将一个或多个队列对与非默认 VPort 相关联。

NumActiveDefaultVPortMacAddresses

一个 ULONG 值，该值指定当前在附加到网络适配器的 PF 的默认 VPort 上设置的单播 MAC 地址筛选器的数量。

NumActiveNonDefaultVPortMacAddresses

一个 ULONG 值，该值指定当前在非默认 VPort 上设置的单播 MAC 地址筛选器的数量。

NumActiveDefaultVPortVlanIds

一个 ULONG 值，该值指定当前在默认 VPort 上设置的虚拟局域网 (VLAN) 标识符筛选器的数目。

NumActiveNonDefaultVPortVlanIds

一个 ULONG 值，该值指定当前在非默认 VPort 上设置的 VLAN 标识符筛选器的数目。

注解

NDIS_NIC_SWITCH_INFO 结构用于OID_NIC_SWITCH_ENUM_SWITCHES的 OID 查询请求。此 OID 请求用于枚举网络适配器上的网络适配器交换机。发出此 OID 请求时，将在 NDIS_NIC_SWITCH_INFO_ARRAY 结构中返回一个或多个 NDIS_NIC_SWITCH_INFO 结构。

注意从 NDIS 6.30 开始，只有描述有关默认网络适配器交换机信息的 NDIS_NIC_SWITCH_INFO 通过 OID_NIC_SWITCH_ENUM_SWITCHES的 OID 请求返回。

NDIS_NIC_SWITCH_INFO 结构包含有关以前通过 OID_NIC_SWITCH_CREATE_SWITCH 的 OID 方法请求创建的网络适配器交换机的信息。

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