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

Weitere Informationen

PCI_VIRTUALIZATION_INTERFACE

GetBusData