SET_VIRTUAL_DEVICE_DATA funzione di callback (wdm.h)
La routine SetVirtualFunctionData scrive i dati nello spazio di configurazione PCI Express (PCIe) di una funzione virtuale (VF) in un dispositivo che supporta l'interfaccia di virtualizzazione I/O radice singola (SR-IOV).
Sintassi
SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;
ULONG SetVirtualDeviceData(
[in, out] PVOID Context,
[in] USHORT VirtualFunction,
[in] 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 Contesto della struttura di PCI_VIRTUALIZATION_INTERFACE per l'interfaccia.
[in] VirtualFunction
Valore in base zero che specifica il VF nel dispositivo da cui scrivere i dati.
[in] Buffer
Puntatore al buffer che contiene le informazioni di configurazione da scrivere nello spazio di configurazione PCIe dell'VF.
[in] Offset
Offset nei dati dello spazio di configurazione PCIe del VF. Questo membro specifica dove inizia questa operazione di scrittura.
[in] Length
Lunghezza, in byte, dei dati da scrivere.
Valore restituito
La routine *SetVirtualFunctionData restituisce la lunghezza, in byte, dei dati di configurazione PCIe scritti dopo un'operazione di scrittura riuscita. Se l'operazione di scrittura ha esito negativo, la routine restituisce zero.
Commenti
La routine *SetVirtualFunctionData è simile alla routine SetBusData , ad eccezione del fatto che scrive i dati di configurazione PCIe in una funzione fisica di un dispositivo anziché in una funzione fisica di un dispositivo.
La routine *SetVirtualFunctionData viene fornita dall'interfaccia GUID_PCI_VIRTUALIZATION_INTERFACE . La routine SetBusData viene fornita dall'interfaccia GUID_BUS_INTERFACE_STANDARD .
Lo stack di virtualizzazione chiama *SetVirtualFunctionData quando un driver in esecuzione nel sistema operativo guest chiama la routine SetBusData .
Requisiti
| 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 |