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

Article
03/01/2024

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

Partager via