Fonction D3DKMTRegisterVailProcess (d3dkmthk.h)

La fonction D3DKMTRegisterVailProcess inscrit le processus en cours comme un processus qui peut partager des allocations GPU entre une machine virtuelle invitée et l’hôte.

Syntaxe

NTSTATUS D3DKMTRegisterVailProcess(
  GUID *unnamedParam1
);

Paramètres

unnamedParam1

[in] VirtualMachineGuid, qui est un pointeur vers le GUID associé à une machine virtuelle en cours d’exécution. Au moins un GPU virtuel doit être affecté à la machine virtuelle.

Valeur retournée

D3DKMTRegisterVailProcess retourne un code NTSTATUS tel qu’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	L’inscription du processus a réussi.
STATUS_ACCESS_DENIED	Le processus ne dispose pas de suffisamment de privilèges pour appeler cette API. Notez que d’autres codes status peuvent être retournés dans ce cas.
STATUS_INVALID_PARAMETER	La valeur transmise dans VirtualMachineGuid n’est pas valide.
STATUS_GRAPHICS_VAIL_STATE_CHANGED	Aucun GPU virtuel n’est affecté à la machine virtuelle.
STATUS_INVALID_DISPOSITION	Le contexte graphique n’est pas créé pour le processus.
STATUS_NOT_FOUND	Une machine virtuelle avec le GUID donné est introuvable.

D’autres codes status peuvent également être retournés.

Remarques

Le processus appelant doit avoir les mêmes privilèges que le processus client Bureau à distance (RDP) qui a été créé pour la machine virtuelle instance spécifié par le paramètre VirtualMachineGuid.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 11, version 22H2
Plateforme cible	Universal
En-tête	d3dkmthk.h (inclure d3dkmthk.h)
Bibliothèque	gdi32.lib
DLL	gdi32.dll