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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | dcomp.h |
| Bibliothèque | Dcomp.lib |
| DLL | Dcomp.dll |