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 VF PCIe 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 di VPCI_INTERFACE_STANDARD per l'interfaccia.
BlockId
[in] Identificatore del blocco di configurazione VF da leggere. Questo identificatore è proprietario del fornitore di 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 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.
Osservazioni
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 da 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 Hyper-V partizione figlio.
- Driver PF, che viene eseguito nel sistema operativo di gestione. Questo sistema operativo viene eseguito all'interno della Hyper-V partizione padre.
I dati di ogni blocco di configurazione VF vengono usati solo dai driver di PF e VF.
Nota
La IOCTL_VPCI_READ_BLOCK IOCTL offre un'alternativa asincrona alla routine ReadVfConfigBlock.
Fabbisogno
| Requisito | Valore |
|---|---|
| server minimo supportato | Windows Server 2012 |
| intestazione | vpci.h |
| IRQL | <= APC_LEVEL |