SET_VIRTUAL_DEVICE_DATA funzione di callback (wdm.h)
Il SetVirtualFunctionData routine scrive i dati nello 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
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 Context della struttura 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 del VF.
[in] Offset
Offset nei dati dello spazio di configurazione PCIe del VF. Questo membro specifica dove inizia l'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 completata. Se l'operazione di scrittura non riesce, la routine restituisce zero.
Osservazioni
La routine *SetVirtualFunctionData è simile alla routine SetBusData, ad eccezione del fatto che scrive i dati di configurazione PCIe in una funzione fisica (PF) 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.
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 |