NDIS_NIC_SWITCH_INFO结构（ntddndis.h）

项目
02/07/2025

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

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

NDIS_NIC_SWITCH_INFO_REVISION_1

NDIS 6.30 的原始版本。

将大小成员设置为NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1。

Flags

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

注释对于 NDIS 6.30，没有为交换机定义配置标志。标志成员必须设置为零。

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）虚拟函数（VF）的数量。已启用的 VF 可以处于已分配或未分配状态。

NumAllocatedVFs

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

NumVPorts

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

此 ULONG 值是以下内容的总和：

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

NumActiveVPorts

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

注意此 ULONG 值包括默认 VPort，以及通过 OID 集请求创建的非默认 VPorts OID_NIC_SWITCH_CREATE_VPORT。

NumQueuePairsForDefaultVPort

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

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

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

NumQueuePairsForNonDefaultVPorts

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

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

NumActiveDefaultVPortMacAddresses

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

NumActiveNonDefaultVPortMacAddresses

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

NumActiveDefaultVPortVlanIds

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

NumActiveNonDefaultVPortVlanIds

一个 ULONG 值，该值指定当前在非默认 VPorts 上设置的 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 请求返回 OID_NIC_SWITCH_ENUM_SWITCHES。

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

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