通过

NDIS_NIC_SWITCH_VF_PARAMETERS结构（ntddndis.h）

  • 项目

NDIS_NIC_SWITCH_VF_PARAMETERS 指定网络适配器上的 PCI Express（PCIe）虚拟函数（VF）的资源参数。

语法

typedef struct _NDIS_NIC_SWITCH_VF_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_PARAMETERS, *PNDIS_NIC_SWITCH_VF_PARAMETERS;

成员

Header

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

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

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

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

将 大小 成员设置为NDIS_SIZEOF_NIC_SWITCH_VF_PARAMETERS_REVISION_1。

Flags

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

SwitchId

指定开关标识符的NDIS_NIC_SWITCH_ID值。 此值标识分配 VF 的网络适配器交换机。

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

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

VMName

一个NDIS_VM_NAME值，该值指定附加到 VF 的 Hyper-V 子分区的内部名称。

注意 Hyper-V 子分区也称为虚拟机（VM）。
 

VMFriendlyName

一个NDIS_VM_FRIENDLYNAME值，该值指定附加到 VF 的 Hyper-V 子分区的外部名称。 此成员包含分区的用户友好说明。

NicName

一个NDIS_SWITCH_NIC_NAME值，该值指定虚拟机（VM）网络适配器的名称。 此成员包含网络适配器的用户友好说明。

VM 网络适配器是在 Hyper-V 子分区中运行的来宾作系统中公开的虚拟设备。 VM 网络适配器使用 VF 网络适配器团队，通过 SR-IOV 接口提供基于硬件的 VF 数据路径。

有关 VF 数据路径的详细信息，请参阅 SR-IOV VF 数据路径。

MacAddressLength

一个 USHORT 值，该值指定 PermanentMacAddress 和 CurrentMacAddress 成员的长度。

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

VF 的永久 MAC 地址。 这是来宾作系统中公开的 VF 网络适配器的永久 MAC 地址。

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

VF 的当前 MAC 地址。 这是来宾作系统中公开的 VF 网络适配器的当前 MAC 地址。

VFId

一个NDIS_SRIOV_FUNCTION_ID值，该值指定网络适配器上的 VF 的唯一标识符。

RequestorId

指定 VF 的 PCI Express（PCIe）请求者 ID（RID）的NDIS_VF_RID。

言论

NDIS_NIC_SWITCH_VF_PARAMETERS 结构用于 OID_NIC_SWITCH_ALLOCATE_VF 和 OID_NIC_SWITCH_VF_PARAMETERS的 OID 方法请求中。

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

要求

要求 价值
最低支持的客户端 NDIS 6.30 及更高版本中受支持。
标头 ntddndis.h （include Ndis.h）

另请参阅

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_VF_PARAMETERS