Freigeben über


D3DKMTRegisterVailProcess-Funktion (d3dkmthk.h)

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

Syntax

NTSTATUS D3DKMTRegisterVailProcess(
  GUID *unnamedParam1
);

Parameter

unnamedParam1

[in] VirtualMachineGuid, bei dem es sich um einen Zeiger auf die GUID handelt, die einer ausgeführten VM zugeordnet ist. Der virtuelle 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 ausreichende Berechtigungen, um diese API aufzurufen. Beachten Sie, dass in diesem Fall andere Statuscodes zurückgegeben werden können.
STATUS_INVALID_PARAMETER Der in VirtualMachineGuid übergebene Wert ist ungültig.
STATUS_GRAPHICS_VAIL_STATE_CHANGED Der virtuelle Computer verfügt nicht über eine virtuelle GPU.
STATUS_INVALID_DISPOSITION Der Prozess hat keinen Grafikkontext erstellt.
STATUS_NOT_FOUND Eine VM mit der angegebenen GUID wurde nicht gefunden.

Auch andere Statuscodes können zurückgegeben werden.

Bemerkungen

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 11, Version 22H2
Zielplattform- Universal
Header- d3dkmthk.h (einschließlich d3dkmthk.h)
Library gdi32.lib
DLL- gdi32.dll