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 l'interfaccia di virtualizzazione I/O radice singola (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 Contesto della struttura di 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 contenente le informazioni di configurazione letti dallo spazio di configurazione PCIe del VF.

[in] Offset

Offset nei dati dello spazio di configurazione PCIe del VF. Questo membro specifica dove inizia questa 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 riuscita. Se l'operazione di lettura ha esito negativo, la routine restituisce zero.

Commenti

La routine GetVirtualFunctionData è simile alla routine GetBusData , ad eccezione del fatto che legge i dati di configurazione PCIe da una funzione fisica di un dispositivo anziché da una funzione fisica 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 .

Requisiti

Vedi anche

PCI_VIRTUALIZATION_INTERFACE

GetBusData