NDIS_NIC_SWITCH_VF_INFO 结构 (ntddndis.h)

项目
02/26/2024

NDIS_NIC_SWITCH_VF_INFO结构指定有关在网络适配器上分配的 PCI Express (PCIe) Virtual Function (VF) 的信息。

语法

typedef struct _NDIS_NIC_SWITCH_VF_INFO {
  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_INFO, *PNDIS_NIC_SWITCH_VF_INFO;

成员

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

NDIS 6.30 的原始版本。

将 Size 成员设置为NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1。

Flags

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

SwitchId

一个NDIS_NIC_SWITCH_ID值，该值指定开关标识符。交换机标识符是介于零和网络适配器支持的交换机数之间的整数。 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_INFO 结构包含有关 VF 的信息，该 VF 以前是通过 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 方法请求创建的。发出此 OID 请求时，将在 NDIS_NIC_SWITCH_VF_INFO_ARRAY 结构中返回一个或多个 NDIS_NIC_SWITCH_VF_INFO 结构。

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