GET_VIRTUAL_DEVICE_DATA Rückruffunktion (wdm.h)
Die GetVirtualFunctionData-Routine liest Daten aus dem PCI Express -Konfigurationsbereich (PCIe) einer virtuellen Funktion (VF) auf einem Gerät, das die Single Root-IOV-Virtualisierungsschnittstelle (Single Root I/O Virtualization, SR-IOV) 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 die VF auf dem Gerät angibt, von dem Die Daten gelesen werden sollen.
[out] Buffer
Ein Zeiger auf den Puffer, der die Konfigurationsinformationen enthält, die aus dem PCIe-Konfigurationsbereich des VF gelesen werden.
[in] Offset
Der Offset in die PCIe-Konfigurationsraumdaten des VF. Dieser Member 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.
Hinweise
Die GetVirtualFunctionData-Routine ähnelt der GetBusData-Routine , mit der Ausnahme, dass sie PCIe-Konfigurationsdaten aus einem VF statt aus der physischen Funktion (PF) eines Geräts liest.
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 |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in Windows Server 2012 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | wdm.h (wdm.h einschließen) |
| IRQL | IRQL <= APC_LEVEL |