VPCI_INTERFACE_STANDARD结构 (VPCI_INTERFACE_STANDARD.h)

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

此结构描述 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 (VRI) 总线驱动程序提供,该驱动程序创建物理设备对象(PDO),这些对象分层在 VF 的加载驱动程序下方。 这些驱动程序在 Hyper-V 子分区中运行的来宾作系统中加载。

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

要求

要求 价值
支持的最低服务器 Windows Server 2012
标头 vpi.h

另请参阅

InterfaceDereference

InterfaceReference

IRP_MN_QUERY_INTERFACE

ReadVfConfigBlock

WriteVfConfigBlock