DXGKDDI_READVIRTUALFUNCTIONCONFIG Rückruffunktion (dispmprt.h)

Diese Routine stellt den nicht privilegierten virtuellen Computer mit dem Inhalt der Konfigurationsraumwerte einer PCI Express SR-IOV Virtual Function bereit.

Syntax

DXGKDDI_READVIRTUALFUNCTIONCONFIG DxgkddiReadvirtualfunctionconfig;

NTSTATUS DxgkddiReadvirtualfunctionconfig(
  [in]      HANDLE Context,
  [in, out] DXGKARG_READVIRTUALFUNCTIONCONFIG *pArgs
)
{...}

Parameter

[in] Context

Der Miniportkontext, der vom Treiber in der DXGKDDI_SRIOV_INTERFACE-Struktur zurückgegeben wird.

[in, out] pArgs

Ein Zeiger auf die DXGKARG_READVIRTUALFUNCTIONCONFIG-Struktur.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist.

Hinweise

Es kann problematisch sein, der Gastpartition direkten Zugriff auf den Konfigurationsbereich zu gewähren. Daher stellt diese Funktion eine Methode zum sicheren Zugriff auf den Konfigurationsblock für virtuelle Funktionen bereit.

Beachten Sie, dass dadurch Werte zurückgegeben werden sollen, als ob sie aus dem Konfigurationsblock des virtuellen Geräts gelesen würden. Die Verwendung dieser Schnittstelle kann den Lesevorgang erreichen, indem sie intern innerhalb des Treibers verarbeitet wird, der die Schnittstelle zur Verfügung stellt, oder durch Aufrufen von GetVirtualFunctionData (aus dem PCI_VIRTUALIZATION_INTERFACE der niedrigeren PDO) oder einer Kombination aus beiden.

Kernelmodustreiber sollten die Anforderung nach den Parametern für virtuelle Funktionen filtern und fehlschlagen, wenn zugriffsanforderung außerhalb des zulässigen Bereichs vorhanden ist.

Anforderungen

Anforderung	Wert
Header	dispmprt.h