IDCompositionDevice ::CheckDeviceState, méthode (dcomp.h)

Détermine si l’objet d’appareil DirectComposition est toujours valide.

Syntaxe

HRESULT CheckDeviceState(
  [out] BOOL *pfValid
);

Paramètres

[out] pfValid

TRUE si l’objet d’appareil DirectComposition est toujours valide ; sinon, FALSE.

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Remarques

Si l’appareil Microsoft DirectX Graphics Infrastructure (DXGI) est perdu, l’appareil DirectComposition associé à l’appareil DXGI est également perdu. Lorsqu’il détecte un appareil perdu, DirectComposition envoie le message WM_PAINT à toutes les fenêtres qui composent du contenu DirectComposition à l’aide de l’appareil perdu. Une application doit appeler CheckDeviceState en réponse à chaque message WM_PAINT pour s’assurer que l’objet d’appareil DirectComposition est toujours valide. L’application doit prendre des mesures pour récupérer du contenu si l’objet d’appareil devient non valide. Les étapes incluent la création de nouveaux appareils DXGI et DirectComposition, et la recréation de tout le contenu. (Il n’est pas possible de créer uniquement un appareil DXGI et de l’associer à l’appareil DirectComposition existant.) Le système garantit que l’objet d’appareil reste valide entre WM_PAINT messages.

Configuration requise

Voir aussi

IDCompositionDevice