NDIS_NIC_SWITCH_VF_PARAMETERS 结构 (ntddndis.h)

  • 项目

NDIS_NIC_SWITCH_VF_PARAMETERS指定网络适配器上 PCI Express (PCIe) Virtual Function (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 结构。

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

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

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

将 Size 成员设置为 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 (包括 Ndis.h)

另请参阅

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_VF_PARAMETERS