Fonction DwmEnableComposition (dwmapi.h)

Article
26/02/2024

Active ou désactive la composition du Gestionnaire de fenêtres de bureau (DWM).

Note Cette fonction est déconseillée à partir de Windows 8. DWM ne peut plus être désactivé par programmation.

Syntaxe

HRESULT DwmEnableComposition(
  [in] UINT uCompositionAction
);

Paramètres

[in] uCompositionAction

DWM_EC_ENABLECOMPOSITION d’activer la composition DWM ; DWM_EC_DISABLECOMPOSITION pour désactiver la composition.

Note À partir de Windows 8, l’appel de cette fonction avec DWM_EC_DISABLECOMPOSITION n’a aucun effet. Toutefois, la fonction retourne toujours un code de réussite.

Valeur retournée

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

Remarques

La désactivation de la composition DWM la désactive pour l’ensemble du bureau. La composition DWM est automatiquement activée lorsque tous les processus ayant désactivé la composition ont appelé DwmEnableComposition pour l’activer ou ont été arrêtés. La notification WM_DWMCOMPOSITIONCHANGED est envoyée chaque fois que la composition DWM est activée ou désactivée.

Exemples

L’exemple de code suivant désactive la composition DWM.


...
HRESULT hr = S_OK;

// Disable DWM Composition 
hr = DwmEnableComposition(DWM_EC_DISABLECOMPOSITION);
if (SUCCEEDED(hr))
{
   // ...
}
...

Configuration requise

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

Voir aussi

Activer et contrôler la composition du Gestionnaire de fenêtrage

Partager via