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 |