通过

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

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

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

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

将 大小 成员设置为NDIS_SIZEOF_NIC_SWITCH_PARAMETERS_REVISION_1。

Flags

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

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

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

注意 此标志仅在 OID 集请求中使用 OID_NIC_SWITCH_PARAMETERS时有效。
 

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） 虚拟函数（VF）的数量。 通过调用 NdisMEnableVirtualization启用虚拟化时，在适配器上启用 VF。

注释 VF 附加到 Hyper-V 子分区之前，必须通过 OID_NIC_SWITCH_ALLOCATE_VF的 OID 方法请求为其分配资源。
 

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 （include Ndis.h）

另请参阅

NDIS_OBJECT_HEADER

NdisMEnableVirtualization

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS