D3DKMTRegisterVailProcess-Funktion (d3dkmthk.h)

  • Artikel

Die D3DKMTRegisterVailProcess-Funktion registriert den aktuellen Prozess als einen Prozess, der GPU-Zuordnungen zwischen einem virtuellen Gastcomputer (VM) und dem Host freigeben kann.

Syntax

NTSTATUS D3DKMTRegisterVailProcess(
  GUID *unnamedParam1
);

Parameter

unnamedParam1

[in] VirtualMachineGuid, ein Zeiger auf die GUID, die einer ausgeführten VM zugeordnet ist. Dem virtuellen Computer muss mindestens eine virtuelle GPU zugewiesen sein.

Rückgabewert

D3DKMTRegisterVailProcess gibt einen NTSTATUS-Code wie einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Prozessregistrierung war erfolgreich.
STATUS_ACCESS_DENIED Der Prozess verfügt nicht über genügend Berechtigungen, um diese API aufzurufen. Beachten Sie, dass in diesem Fall andere status Codes zurückgegeben werden können.
STATUS_INVALID_PARAMETER Der in VirtualMachineGuid übergebene Wert ist ungültig.
STATUS_GRAPHICS_VAIL_STATE_CHANGED Dem virtuellen Computer ist keine virtuelle GPU zugewiesen.
STATUS_INVALID_DISPOSITION Für den Prozess wurde kein Grafikkontext erstellt.
STATUS_NOT_FOUND Ein virtueller Computer mit der angegebenen GUID wurde nicht gefunden.

Auch andere status Codes können zurückgegeben werden.

Hinweise

Der aufrufende Prozess muss über die gleichen Berechtigungen wie der Remotedesktopclientprozess (RDP) verfügen, der für die VM erstellt wurde instance durch den VirtualMachineGuid-Parameter angegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 22H2
Zielplattform Universell
Header d3dkmthk.h (include d3dkmthk.h)
Bibliothek gdi32.lib
DLL gdi32.dll