VPCI_INTERFACE_STANDARD 结构 (vpci.h)

VPCI_INTERFACE_STANDARD 接口结构使设备驱动程序能够访问特定于 PCI Express (PCIe) 虚拟功能 (VF) 支持单根 I/O 虚拟化 (SR-IOV) 接口的设备的配置数据块。

此结构描述 GUID_VPCI_INTERFACE_STANDARD 接口。

注意

VF 配置块的位置和配置数据的格式由设备的独立硬件供应商 (IHV) 定义。 它们仅由 PCIe 物理功能 (PF) 和 VF 的驱动程序使用。

语法

typedef struct _VPCI_INTERFACE_STANDARD {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  PVPCI_WRITE_BLOCK      WriteVfConfigBlock;
  PVPCI_READ_BLOCK       ReadVfConfigBlock;
  UINT32                 SerialNumber;
} VPCI_INTERFACE_STANDARD, *PVPCI_INTERFACE_STANDARD;

成员

Size

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

Version

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

Context

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

InterfaceReference

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

InterfaceDereference

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

WriteVfConfigBlock

指向 WriteVfConfigBlock 例程的指针,该例程写入 PCIe VF 的配置数据块。

ReadVfConfigBlock

指向 ReadVfConfigBlock 例程的指针,该例程读取 PCIe VF 的配置数据块。

SerialNumber

一个 UINT32 值,该值包含设备上的 PCIe VF 的序列号。 虚拟化堆栈为设备上公开的每个 VF 生成唯一的序列号。

注解

GUID_VPCI_INTERFACE_STANDARD接口由虚拟 PCI (VPCI) 总线驱动程序提供,该驱动程序创建物理设备对象 (PDO) ,这些对象分层在为 VF 加载的驱动程序下。 这些驱动程序加载到 Hyper-V 子分区中运行的来宾操作系统中。

驱动程序通过将 interfaceType 设置为 GUID_VPCI_INTERFACE_STANDARDIRP_MN_QUERY_INTERFACE IRP 发送到其总线驱动程序来获取指向 VPCI_INTERFACE_STANDARD 结构的指针。

要求

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

另请参阅

InterfaceDereference

InterfaceReference

IRP_MN_QUERY_INTERFACE

ReadVfConfigBlock

WriteVfConfigBlock