Partager via


Fonction DwmIsCompositionEnabled (dwmapi.h)

Obtient une valeur qui indique si la composition du Gestionnaire de fenêtres de bureau (DWM) est activée. Les applications sur les machines exécutant Windows 7 ou version antérieure peuvent écouter les modifications d’état de composition en gérant la notification WM_DWMCOMPOSITIONCHANGED .

Syntaxe

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

Paramètres

[out] pfEnabled

Pointeur vers une valeur qui, lorsque cette fonction retourne correctement, reçoit TRUE si la composition DWM est activée ; sinon, FALSE.

Note À partir de Windows 8, la composition DWM est toujours activée. Si une application déclare Windows 8 compatibilité dans son manifeste, cette fonction reçoit la valeur TRUE via pfEnabled. Si aucune entrée de manifeste de ce type n’est trouvée, Windows 8 compatibilité n’est pas supposée et cette fonction reçoit la valeur FALSE via pfEnabled. Cela permet aux programmes plus anciens qui interprètent une valeur TRUE d’impliquer que le mode à contraste élevé est désactivé, de continuer à prendre les bonnes décisions concernant le rendu de leurs images. (Notez qu’il s’agit d’une mauvaise pratique. Vous devez utiliser la fonction SystemParametersInfo avec l’indicateur SPI_GETHIGHCONTRAST pour déterminer l’état du mode de contraste élevé.)
 
Pour plus d’informations, consultez Prise en charge des thèmes à contraste élevé.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

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 dwmapi.h
Bibliothèque Dwmapi.lib
DLL Dwmapi.dll