GET_VIRTUAL_DEVICE_DATA funzione di callback (wdm.h)
La routine GetVirtualFunctionData legge i dati dallo spazio di configurazione PCI Express (PCIe) di una funzione virtuale (VF) in un dispositivo che supporta la singola interfaccia di I/O radice (SR-IOV).
Sintassi
GET_VIRTUAL_DEVICE_DATA GetVirtualDeviceData;
ULONG GetVirtualDeviceData(
[in, out] PVOID Context,
[in] USHORT VirtualFunction,
[out] PVOID Buffer,
[in] ULONG Offset,
[in] ULONG Length
)
{...}
Parametri
[in, out] Context
Puntatore a informazioni di contesto specifiche dell'interfaccia. Il chiamante passa il valore passato come membro Context della struttura PCI_VIRTUALIZATION_INTERFACE per l'interfaccia.
[in] VirtualFunction
Valore in base zero che specifica il VF nel dispositivo da cui leggere i dati.
[out] Buffer
Puntatore al buffer che contiene le informazioni di configurazione lette dallo spazio di configurazione PCIe del VF.
[in] Offset
Offset nei dati dello spazio di configurazione PCIe del VF. Questo membro specifica dove inizia l'operazione di lettura.
[in] Length
Lunghezza, in byte, dei dati da leggere.
Valore restituito
La routine GetVirtualFunctionData restituisce la lunghezza, in byte, dei dati di configurazione PCIe letti dopo un'operazione di lettura completata. Se l'operazione di lettura ha esito negativo, la routine restituisce zero.
Osservazioni
La routine GetVirtualFunctionData è simile alla routine GetBusData, ad eccezione del fatto che legge i dati di configurazione PCIe da una funzione fisica (PF) di un dispositivo.
La routine GetVirtualFunctionData viene fornita dall'interfaccia GUID_PCI_VIRTUALIZATION_INTERFACE. La routine GetBusData viene fornita dall'interfaccia GUID_BUS_INTERFACE_STANDARD.
Lo stack di virtualizzazione chiama GetVirtualFunctionData quando un driver in esecuzione nel sistema operativo guest chiama la routine GetBusData.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato in Windows Server 2012 e versioni successive di Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | wdm.h (include Wdm.h) |
| IRQL | IRQL <= APC_LEVEL |