NDIS_NIC_SWITCH_PARAMETERS 结构 (ntddndis.h)

  • 项目

NDIS_NIC_SWITCH_PARAMETERS 结构指定网络适配器上网络适配器交换机的配置参数。

语法

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

成员

Header

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

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

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_NIC_SWITCH_PARAMETERS_REVISION_1。

Flags

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

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

此标志指定在 NDIS_NIC_SWITCH_PARAMETERS 结构中已更新的字段是 SwitchName 成员。

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

SwitchType

一个NDIS_NIC_SWITCH_TYPE枚举值，该值指定网络适配器交换机的类型。

注意从 Windows Server 2012 开始，Windows 仅支持 NdisNicSwitchTypeExternal 的开关类型。 外部交换机指定连接到此类交换机的端口可以通过网络适配器上的物理端口访问外部网络。 外部交换机上的默认虚拟端口 (VPort) 提供与 Hyper-V 父分区管理操作系统中运行的虚拟化堆栈的外部网络连接。
 

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) 的数目。 通过调用 NdisMEnableVirtualization 启用虚拟化时，适配器上会启用 VF。

注意必须先通过OID_NIC_SWITCH_ALLOCATE_VF的 OID 方法请求为其分配资源，然后才能将 VF 附加到 Hyper-V 子分区。
 

NdisReserved1

保留给 NDIS。

NdisReserved2

保留给 NDIS。

NdisReserved3

保留给 NDIS。

NumQueuePairsForDefaultVPort

注解

NDIS_NIC_SWITCH_PARAMETERS 结构用于OID_NIC_SWITCH_CREATE_SWITCH和OID_NIC_SWITCH_PARAMETERS的 OID 方法请求。 这些 OID 请求设置或查询网络适配器交换机的配置参数。

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

要求

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

另请参阅

NDIS_OBJECT_HEADER

NdisMEnableVirtualization

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS