VPCI_READ_BLOCK funzione di callback (vpci.h)
La routine ReadVfConfigBlock legge un blocco di dati di configurazione per una funzione virtuale PCI Express (PCIe). Questa routine viene chiamata dal driver di un PCIe VF in un dispositivo che supporta l'interfaccia di virtualizzazione I/O radice singola (SR-IOV).
Sintassi
VPCI_READ_BLOCK VpciReadBlock;
NTSTATUS VpciReadBlock(
PVOID Context,
ULONG BlockId,
PVOID Buffer,
ULONG Length
)
{...}
Parametri
Context
[in] Puntatore a informazioni di contesto specifiche dell'interfaccia. Il chiamante passa il valore passato come membro Context della struttura VPCI_INTERFACE_STANDARD per l'interfaccia.
BlockId
[in] Identificatore del blocco di configurazione VF da leggere. Questo identificatore è proprietario del fornitore hardware indipendente (IHV) e viene usato solo dai driver per la funzione fisica PCIe (PF) e VF nel dispositivo.
Buffer
[out] Puntatore a un buffer allocato dal chiamante che conterrà i dati di configurazione da leggere. Per altre informazioni, vedere la sezione Osservazioni.
Length
[in] Numero di byte da leggere dal blocco di configurazione VF.
Nota
Il valore di questo parametro non deve superare VPCI_MAX_READ_WRITE_BLOCK_SIZE.
Valore restituito
La routine ReadVfConfigBlock restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, la routine restituisce un valore NTSTATUS appropriato.
Commenti
Quando viene chiamata la routine ReadVfConfigBlock , il driver del pf riceve una notifica per restituire i dati da un blocco di configurazione VF specificato.
Un blocco di configurazione VF viene usato per la comunicazione backchannel tra i driver del pf e un VF in un dispositivo che supporta l'interfaccia SR-IOV. L'IHV può definire uno o più blocchi di configurazione VF per il dispositivo. Ogni blocco di configurazione VF ha un formato, una lunghezza e un ID blocco definiti dall'IHV.
I dati di configurazione VF possono essere scambiati tra i driver seguenti in modo protetto:
- Driver VF, che viene eseguito nel sistema operativo guest. Questo sistema operativo viene eseguito all'interno di una partizione figlio Hyper-V.
- Driver PF, che viene eseguito nel sistema operativo di gestione. Questo sistema operativo viene eseguito all'interno della partizione padre hyper-V.
I dati di ogni blocco di configurazione VF vengono usati solo dai driver di PF e VF.
Nota
Il IOCTL_VPCI_READ_BLOCK IOCTL offre un'alternativa asincrona alla routine ReadVfConfigBlock .
Requisiti
| Requisito | Valore |
|---|---|
| Server minimo supportato | Windows Server 2012 |
| Intestazione | vpci.h |
| IRQL | <= APC_LEVEL |