Partager via


Méthode IDirect3DDeviceManager9 ::OpenDeviceHandle (dxva2api.h)

Obtient un handle pour l’appareil Direct3D.

Syntaxe

HRESULT OpenDeviceHandle(
  [out] HANDLE *phDevice
);

Paramètres

[out] phDevice

Reçoit le handle de l’appareil.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
S_OK
DXVA2_E_NOT_INITIALIZED
Le gestionnaire de périphériques Direct3D n’a pas été initialisé. Le propriétaire de l’appareil doit appeler IDirect3DDeviceManager9 ::ResetDevice.

Remarques

Pour obtenir le pointeur IDirect3DDevice9 de l’appareil Direct3D, appelez IDirect3DDeviceManager9 ::LockDevice avec le handle retourné dans phDevice. Fermez le handle d’appareil lorsque vous avez terminé de l’utiliser, en appelant IDirect3DDeviceManager9 ::CloseDeviceHandle.

Pour tester si un handle d’appareil est toujours valide, appelez IDirect3DDeviceManager9 ::TestDevice.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête dxva2api.h

Voir aussi

Gestionnaire de périphériques Direct3D

IDirect3DDeviceManager9