GET_VIRTUAL_DEVICE_DATA Rückruffunktion (wdm.h)
Die GetVirtualFunctionData Routine liest Daten aus dem PCI Express(PCIe)-Konfigurationsraum einer virtuellen Funktion (VF) auf einem Gerät, das die einzelne Stamm-E/A-Virtualisierung (SR-IOV) -Schnittstelle unterstützt.
Syntax
GET_VIRTUAL_DEVICE_DATA GetVirtualDeviceData;
ULONG GetVirtualDeviceData(
[in, out] PVOID Context,
[in] USHORT VirtualFunction,
[out] PVOID Buffer,
[in] ULONG Offset,
[in] ULONG Length
)
{...}
Parameter
[in, out] Context
Ein Zeiger auf schnittstellenspezifische Kontextinformationen. Der Aufrufer übergibt den Wert, der als Context Member der PCI_VIRTUALIZATION_INTERFACE Struktur für die Schnittstelle übergeben wird.
[in] VirtualFunction
Ein nullbasierter Wert, der den VF auf dem Gerät angibt, aus dem Daten gelesen werden sollen.
[out] Buffer
Ein Zeiger auf den Puffer, der die Konfigurationsinformationen enthält, die aus dem PCIe-Konfigurationsraum des VF gelesen werden.
[in] Offset
Der Offset in den PCIe-Konfigurationsraumdaten des VF. Dieses Element gibt an, wo dieser Lesevorgang beginnt.
[in] Length
Die Länge der zu lesenden Daten in Bytes.
Rückgabewert
Die GetVirtualFunctionData Routine gibt die Länge der PCIe-Konfigurationsdaten in Bytes zurück, die nach einem erfolgreichen Lesevorgang gelesen wurden. Wenn der Lesevorgang nicht erfolgreich ist, gibt die Routine null zurück.
Bemerkungen
Die GetVirtualFunctionData Routine ähnelt der GetBusData- Routine, mit der Ausnahme, dass pcIe-Konfigurationsdaten von einem VF statt von der physischen Funktion eines Geräts (PF) gelesen werden.
Die GetVirtualFunctionData Routine wird von der GUID_PCI_VIRTUALIZATION_INTERFACE Schnittstelle bereitgestellt. Die GetBusData Routine wird von der GUID_BUS_INTERFACE_STANDARD Schnittstelle bereitgestellt.
Der Virtualisierungsstapel ruft GetVirtualFunctionData auf, wenn ein Treiber, der im Gastbetriebssystem ausgeführt wird, die GetBusData Routine aufruft.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in Windows Server 2012 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h) |
| IRQL- | IRQL-<= APC_LEVEL |