VPCI_INTERFACE_STANDARD-Struktur (vpci.h)
Die VPCI_INTERFACE_STANDARD-Schnittstellenstruktur ermöglicht Gerätetreibern den Zugriff auf Konfigurationsdatenblöcke, die für eine PCI Express (PCIe) Virtual Function (VF) von Geräten spezifisch sind, die die SINGLE-Root-E/A-Virtualisierungsschnittstelle (SR-IOV) unterstützen.
Diese Struktur beschreibt die GUID_VPCI_INTERFACE_STANDARD-Schnittstelle .
Hinweis
Der Speicherort des VF-Konfigurationsblocks und das Format der Konfigurationsdaten werden vom unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) des Geräts definiert. Sie werden nur von den Treibern der PCIe-Physischen Funktion (PF) und der VF verwendet.
Syntax
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;
Member
Size
Die Größe (in Bytes) dieser Struktur.
Version
Die vom Treiber definierte Schnittstellenversion.
Context
Ein Zeiger auf schnittstellenspezifische Kontextinformationen.
InterfaceReference
Ein Zeiger auf eine InterfaceReference-Routine , die die Referenzanzahl der Schnittstelle erhöht.
InterfaceDereference
Ein Zeiger auf eine InterfaceDereference-Routine , die die Referenzanzahl der Schnittstelle erhöht.
WriteVfConfigBlock
Ein Zeiger auf eine WriteVfConfigBlock-Routine , die einen Block mit Konfigurationsdaten für eine PCIe VF schreibt.
ReadVfConfigBlock
Ein Zeiger auf eine ReadVfConfigBlock-Routine , die einen Block von Konfigurationsdaten für eine PCIe VF liest.
SerialNumber
Ein UINT32-Wert, der die Seriennummer für die PCIe VF auf dem Gerät enthält. Der Virtualisierungsstapel generiert eine eindeutige Seriennummer für jede VF, die auf dem Gerät verfügbar gemacht wird.
Hinweise
Die GUID_VPCI_INTERFACE_STANDARD-Schnittstelle wird vom VPCI-Bustreiber (Virtual PCI) bereitgestellt, der die physischen Geräteobjekte (PDOs) erstellt, die sich unterhalb der geladenen Treiber für die VFs befinden. Diese Treiber werden in das Gastbetriebssystem geladen, das in einer untergeordneten Hyper-V-Partition ausgeführt wird.
Ein Treiber ruft einen Zeiger auf die VPCI_INTERFACE_STANDARD-Struktur ab, indem er eine IRP_MN_QUERY_INTERFACE IRP an seinen Bustreiber sendet, wobei InterfaceType auf GUID_VPCI_INTERFACE_STANDARD festgelegt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Kopfzeile | vpci.h |