Méthode IDirect3DDevice9Ex::CheckDeviceState (d3d9.h)

Indique la status de niveau coopératif actuelle de l’appareil Direct3D pour une application fenêtré ou en plein écran.

Syntaxe

HRESULT CheckDeviceState(
  [in] HWND hDestinationWindow
);

Paramètres

[in] hDestinationWindow

Type : HWND

Le handle de fenêtre de destination pour case activée pour l’occlusion. Lorsque ce paramètre a la valeur NULL, S_PRESENT_OCCLUDED est retourné lorsqu’un autre appareil a la propriété plein écran. Lorsque le handle de fenêtre n’est pas NULL, la zone cliente de la fenêtre est vérifiée pour l’occlusion. Une fenêtre est obstruée si une partie de celle-ci est masquée par une autre application.

Valeur retournée

Type : HRESULT

Les valeurs de retour possibles sont les suivantes : D3D_OK, D3DERR_DEVICELOST, D3DERR_DEVICEHUNG, D3DERR_DEVICEREMOVED ou D3DERR_OUTOFVIDEOMEMORY (voir D3DERR), S_PRESENT_MODE_CHANGED ou S_PRESENT_OCCLUDED (voir S_PRESENT).

Notes

Cette méthode remplace IDirect3DDevice9::TestCooperativeLevel, qui retourne toujours S_OK dans les applications Direct3D 9Ex.

Nous vous recommandons de ne pas appeler CheckDeviceState chaque image. Au lieu de cela, appelez CheckDeviceState uniquement si la méthode IDirect3DDevice9Ex::P resentEx retourne un code d’échec.

Pour plus d’informations sur les appareils perdus, bloqués et supprimés, consultez Modifications du comportement des appareils perdus.

Spécifications

Plateforme cible	Windows
En-tête	d3d9.h
Bibliothèque	D3D9.lib

Voir aussi

IDirect3DDevice9Ex