NDIS_NIC_SWITCH_VPORT_PARAMETERS 结构 (ntddndis.h)

项目
02/26/2024

NDIS_NIC_SWITCH_VPORT_PARAMETERS 结构指定虚拟端口 (VPort) 网络适配器交换机上的配置。

语法

typedef struct _NDIS_NIC_SWITCH_VPORT_PARAMETERS {
  NDIS_OBJECT_HEADER                         Header;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  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;
  NDIS_NDK_PARAMETERS                        NdkParams;
  NDIS_QOS_SQ_ID                             QosSqId;
} NDIS_NIC_SWITCH_VPORT_PARAMETERS, *PNDIS_NIC_SWITCH_VPORT_PARAMETERS;

成员

Header

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

微型端口驱动程序必须将 Header 的 Type 成员设置为NDIS_OBJECT_TYPE_DEFAULT。

若要指示 NDIS_NIC_SWITCH_VPORT_PARAMETERS 结构的版本，请将 Header 的 Revision 成员设置为以下值之一：

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2

为 NDIS 6.50 添加了 QosSqId 字段。

将 Size 成员设置为NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2。

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1。

Flags

包含标志的按位 OR 的 ULONG 值。为此成员定义了以下标志。

NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED

此标志留作将来使用。微型端口驱动程序必须忽略此标志。

NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED

此标志指定在创建 VPort 后已更新 Flags 成员。在使用 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 集请求创建 VPort 后，可以启用或禁用这些标志。

注意

仅当此结构用于 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求时，此标志才有效。

NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED

此标志指定 VPortName 成员在创建 VPort 后已更新。可以使用 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求更新此成员。

注意

仅当此结构用于 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求时，此标志才有效。

NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED

此标志指定在创建 VPort 后已更新 InterruptModeration 成员。可以使用 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求更新此成员。

注意

仅当此结构用于 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求时，此标志才有效。

NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED

此标志指定 VPortState 成员在创建 VPort 后已更新。可以使用 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求更新此成员。

注意

仅当此结构用于 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求时，此标志才有效。

NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED

此标志指定在创建 VPort 后更新 ProcessoryAffinity 成员。仅当 VPort 连接到网络适配器上的 PF 时，才能更新 VPort 的处理器相关性。可以使用 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 集请求更新 ProcessoryAffinity成员。

注意

仅当此结构用于 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求时，此标志才有效。

NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED

此标志指定在创建 VPort 后更新 NumQueuePairs 成员。启用虚拟机多个队列 (VMMQ) 时，可以更新默认和非默认 Vport 的队列数。可以使用OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求更新 NumQueuePairs成员。

注意仅当此结构用于 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求时，此标志才有效。

SwitchId

一个 NDIS_NIC_SWITCH_ID 值，该值指定要在其中创建 VPort 的交换机的标识符。

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

注意

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

VPortId

一个NDIS_NIC_SWITCH_VPORT_ID值，该值指定网络适配器上 VPort 的标识符。值由 NDIS 分配，在网络适配器中是唯一的。

VPortId 值的范围从零到 (NumVPorts - 1) ，其中 NumVPorts 是微型端口驱动程序在网络适配器上配置的 VPort 数。驱动程序在 NDIS_NIC_SWITCH_INFO 结构的 NumVPorts 成员中指定此数字。驱动程序通过 OID_NIC_SWITCH_ENUM_SWITCHES 的 OID 查询请求返回此结构。

注意

NDIS_DEFAULT_VPORT_ID的 VPort 标识符是为默认 NIC 交换机上附加到 PF 的默认 VPort 保留的。

VPortName

一个NDIS_VPORT_NAME值，该值指定 VPort 的名称。此成员包含 VPort 的用户友好说明。

AttachedFunctionId

一个 NDIS_SRIOV_FUNCTION_ID 值，该值指定 VPort 附加到的物理函数 (PF) 或虚拟函数 (VF) 的 ID。值 NDIS_PF_FUNCTION_ID 指定 VPort 附加到 PF。如果值是有效的 VF 标识符，则 VPort 将附加到 VF。

NumQueuePairs

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

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

InterruptModeration

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

VPortState

一个NDIS_NIC_SWITCH_VPORT_STATE值，该值指定 VPort 的当前状态。

ProcessorAffinity

一个 GROUP_AFFINITY 值，该值指定与此 VPort 关联的 CPU 的组号和位图。此字段仅对附加到 PF 的 VPort 有效。

注意

对于非默认 PF VPort，GROUP_AFFINITY值，该值指定在创建 VPort 时必须仅指定一个处理器。 VPort 是通过 OID_NIC_SWITCH_CREATE_VPORT 的 OID 方法请求创建的。

创建 VPort 后，可以更改与附加到 PF 的非默认 VPort 关联的处理器相关性。还可以通过使用OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集请求来更改与默认 VPort 关联的处理器相关性。

LookaheadSize

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

NdkParams

QosSqId

将 vPort 与计划程序队列 (SQ) 相关联。将此字段设置为有效的 SQ ID，以将 vPort 关联到 SQ。如果没有 SQ 关联，请将此字段设置为零。有关 NDIS_QOS_SQ_ID的详细信息，请参阅 OID_QOS_OFFLOAD_CREATE_SQ。

注解

此结构用于 OID_NIC_SWITCH_CREATE_VPORT 和 OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 请求。

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

要求

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