PCI_VIRTUALIZATION_INTERFACE结构 (wdm.h)

PCI_VIRTUALIZATION_INTERFACE结构使驱动程序能够管理和配置 PCI Express (PCIe) 虚拟函数 (VF) 的配置空间。 VF 由支持单根 I/O 虚拟化 (SR-IOV) 接口的设备在 PCI 总线上公开。

此结构描述 GUID_PCI_VIRTUALIZATION_INTERFACE 接口。

语法

typedef struct _PCI_VIRTUALIZATION_INTERFACE {
  USHORT                            Size;
  USHORT                            Version;
  PVOID                             Context;
  PINTERFACE_REFERENCE              InterfaceReference;
  PINTERFACE_DEREFERENCE            InterfaceDereference;
  PSET_VIRTUAL_DEVICE_DATA          SetVirtualFunctionData;
  PGET_VIRTUAL_DEVICE_DATA          GetVirtualFunctionData;
  PGET_VIRTUAL_DEVICE_LOCATION      GetLocation;
  PGET_VIRTUAL_DEVICE_RESOURCES     GetResources;
  PENABLE_VIRTUALIZATION            EnableVirtualization;
  PGET_VIRTUAL_FUNCTION_PROBED_BARS GetVirtualFunctionProbedBars;
} PCI_VIRTUALIZATION_INTERFACE, *PPCI_VIRTUALIZATION_INTERFACE;

成员

Size

此结构的大小(以字节为单位)。

Version

驱动程序定义的接口版本。

Context

指向特定于接口的上下文信息的指针。

InterfaceReference

指向递增接口引用计数的 InterfaceReference 例程的指针。

InterfaceDereference

指向接口引用计数递减的 InterfaceDereference 例程的指针。

SetVirtualFunctionData

指向 SetVirtualFunctionData 例程的指针,该例程将数据写入 SR-IOV 设备的 VF 的 PCIe 配置空间。

GetVirtualFunctionData

指向 GetVirtualFunctionData 例程的指针,该例程从 SR-IOV 设备的 VF 的 PCIe 配置空间读取数据。

GetLocation

指向 GetLocation 例程的指针,该例程提供有关 PCIe 层次结构中 VF 的当前设备位置的信息。 使用 I/O 内存管理单元 (IOMMU) 将流量路由到设备或从设备路由的虚拟化系统需要此信息。

GetResources

指向 GetResources 例程的指针,提供有关可用于 SR-IOV 设备上的虚拟化的资源的信息。

EnableVirtualization

指向在 SR-IOV 设备上启用或禁用虚拟化的 EnableVirtualization 例程的指针。

GetVirtualFunctionProbedBars

指向 GetVirtualFunctionProbedBars 例程的指针,该例程允许非特权 Hyper-V 虚拟机 (VM) 确定在 PCI 总线驱动程序查询后从 PCIe 基址寄存器 (BAR) 读取的内容。 PCI 驱动程序执行此查询以确定设备所需的内存或 I/O 地址空间。

备注

对于支持 SR-IOV 接口的设备,驱动程序偶尔必须访问和管理设备的 VF 的 PCIe 配置空间。 驱动程序从GUID_PCI_VIRTUALIZATION_INTERFACE接口调用例程,以访问设备上的 VF 的 PCIe 配置空间。

注意

由于设备的 VF 在 PCI 总线上未显示为完整的 PCIe 设备, 因此GUID_BUS_INTERFACE_STANDARD 接口不能用于管理 VF。

PCI_VIRTUALIZATION_INTERFACE结构是 INTERFACE 结构的扩展。

驱动程序通过将 I) RP ( IRP 请求数据包发送到其总线驱动程序,并将 InterfaceType 设置为 GUID_PCI_VIRTUALIZATION_INTERFACE,从而获取指向 IRP_MN_QUERY_INTERFACE PCI_VIRTUALIZATION_INTERFACE结构的指针。

要求

   
最低受支持的服务器 Windows Server 2012
标头 wdm.h

请参阅

GUID_BUS_INTERFACE_STANDARD

InterfaceDereference

InterfaceReference

IRP_MN_QUERY_INTERFACE