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

  • Article

Définit l’appareil Direct3D ou avertit le gestionnaire de périphériques que l’appareil Direct3D a été réinitialisé.

Syntaxe

HRESULT ResetDevice(
  [in] IDirect3DDevice9 *pDevice,
  [in] UINT             resetToken
);

Paramètres

[in] pDevice

Pointeur vers l’interface IDirect3DDevice9 de l’appareil Direct3D.

[in] resetToken

Jeton reçu dans le paramètre pResetToken de la fonction DXVA2CreateDirect3DDeviceManager9 .

Valeur retournée

Elle retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
E_INVALIDARG
 Jeton non valide
D3DERR_INVALIDCALL
 Erreur d’appareil Direct3D.

Remarques

Lorsque vous créez le gestionnaire de périphériques Direct3D pour la première fois, appelez cette méthode avec un pointeur vers l’appareil Direct3D. Le gestionnaire de périphériques ne crée pas l’appareil ; l’appelant doit fournir initialement le pointeur de l’appareil.

Appelez également cette méthode si l’appareil Direct3D est perdu et que vous devez réinitialiser l’appareil ou créer un appareil. Cela se produit si IDirect3DDevice9 ::TestCooperativeLevel retourne D3DERR_DEVICELOST ou D3DERR_DEVICENOTRESET. Pour plus d’informations sur les appareils perdus, consultez la documentation Direct3D.

Le paramètre resetToken garantit que seul le composant qui a créé initialement le gestionnaire de périphériques peut invalider l’appareil actuel.

Si cette méthode réussit, tous les handles d’appareil ouverts deviennent non valides.

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