NDIS_NIC_SWITCH_VPORT_INFO结构（ntddndis.h）

项目
02/07/2025

NDIS_NIC_SWITCH_VPORT_INFO 结构指定网络适配器交换机上虚拟端口（VPort）的配置。

语法

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

成员

Header

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

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

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

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

将大小成员设置为NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1。

VPortId

一个唯一标识网络适配器上的虚拟端口（VPort）的NDIS_NIC_SWITCH_VPORT_ID值。

NDIS_DEFAULT_VPORT_ID值指定交换机上的默认 VPort。默认 VPort 始终附加到网络适配器的 PCI Express（PCIe）物理功能（PF）。

注释具有指定 VPortId 值的非默认 VPort 之前必须通过 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法请求创建。

Flags

包含按位 OR 标志的 ULONG 值。此成员保留为 NDIS。

SwitchId

唯一标识在网络适配器上创建的网络适配器交换机的NDIS_NIC_SWITCH_ID值。通过 VPortId 成员标识的 VPort 是在由 SwitchId 成员指定的交换机上创建的。

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

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

VPortName

一个NDIS_VPORT_NAME值，该值指定在网络适配器交换机上创建的 VPort 的名称。此成员包含 VPort 的用户友好说明。

AttachedFunctionId

一个NDIS_SRIOV_FUNCTION_ID值，该值指定 VF 的标识符或 VPort 附加到的 PF。

注意如果此值NDIS_PF_FUNCTION_ID，VPort 将附加到 PF。

NumQueuePairs

一个 ULONG 值，该值指定为此 VPort 配置的队列对数。

队列对由传输队列和接收队列组成。在通过 OID_NIC_SWITCH_CREATE_SWITCH的 OID 方法请求创建交换机时配置与默认 VPort 关联的队列对。通过 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法请求在非默认 VPort 上配置一个或多个队列对。

InterruptModeration

一个 NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION 值，该值指定 VPort 的中断审查设置。

VPortState

一个指定 VPort 状态的 NDIS_NIC_SWITCH_VPORT_STATE 值。

ProcessorAffinity

一个 GROUP_AFFINITY 值，该值指定此 VPort 可以与之关联的 CPU 的组号和位图。

此成员仅对附加到 PF 的 VPorts 有效。对于附加到 VF 的非默认 VPorts，此字段无效。

LookaheadSize

此成员保留供将来使用。此成员必须设置为零。

NumFilters

一个 ULONG 值，该值指定在网络适配器上配置的接收筛选器数。

注释从 NDIS 6.30 开始，微型端口驱动程序必须维护当前在网络适配器上设置的接收筛选器数的计数器。每次通过 OID_RECEIVE_FILTER_SET_FILTER的 OID 集请求设置接收筛选器时，驱动程序都必须递增计数器。驱动程序还必须在每次通过 OID 集请求清除 OID_RECEIVE_FILTER_CLEAR_FILTER时递减计数器。