struttura VPCI_INTERFACE_STANDARD (vpci.h)

Articolo
02/29/2024

La struttura dell'interfaccia VPCI_INTERFACE_STANDARD consente ai driver di dispositivo di accedere ai blocchi di dati di configurazione specifici di una funzione virtuale PCI Express (PCIe) di dispositivi che supportano l'interfaccia SR-IOV (Single Root I/O Virtualization).

Questa struttura descrive l'interfaccia GUID_VPCI_INTERFACE_STANDARD .

Nota

Il percorso del blocco di configurazione VF e il formato dei dati di configurazione sono definiti dal fornitore hardware indipendente (IHV) del dispositivo. Vengono usati solo dai driver della funzione fisica PCIe (PF) e dalla funzione VF.

Sintassi

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;

Members

Size

Dimensione, in byte, della struttura.

Version

Versione dell'interfaccia definita dal driver.

Context

Puntatore a informazioni di contesto specifiche dell'interfaccia.

InterfaceReference

Puntatore a una routine InterfaceReference che incrementa il conteggio dei riferimenti dell'interfaccia.

InterfaceDereference

Puntatore a una routine InterfaceDereference che decrementa il conteggio dei riferimenti dell'interfaccia.

WriteVfConfigBlock

Puntatore a una routine WriteVfConfigBlock che scrive un blocco di dati di configurazione per un VF PCIe.

ReadVfConfigBlock

Puntatore a una routine ReadVfConfigBlock che legge un blocco di dati di configurazione per un VF PCIe.

SerialNumber

Valore UINT32 che contiene il numero di serie per la funzione PCIe VF nel dispositivo. Lo stack di virtualizzazione genera un numero di serie univoco per ogni VF esposto nel dispositivo.

Commenti

L'interfaccia GUID_VPCI_INTERFACE_STANDARD viene fornita dal driver bus PCI virtuale (VPCI) che crea gli oggetti dispositivo fisico (PDO) sovrapposti sotto i driver caricati per le VFS. Questi driver vengono caricati nel sistema operativo guest eseguito in una partizione figlio Hyper-V.

Un driver ottiene un puntatore alla struttura VPCI_INTERFACE_STANDARD inviando un IRP_MN_QUERY_INTERFACE IRP al driver del bus con InterfaceType impostato su GUID_VPCI_INTERFACE_STANDARD.