Función DwmEnableComposition (dwmapi.h)

Habilita o deshabilita la composición del Administrador de ventanas de escritorio (DWM).

Nota Esta función está en desuso a partir de Windows 8. DWM ya no se puede deshabilitar mediante programación.

 

Sintaxis

HRESULT DwmEnableComposition(
  UINT uCompositionAction
);

Parámetros

uCompositionAction

DWM_EC_ENABLECOMPOSITION para habilitar la composición de DWM; DWM_EC_DISABLECOMPOSITION para deshabilitar la composición.

Nota A partir de Windows 8, llamar a esta función con DWM_EC_DISABLECOMPOSITION no tiene ningún efecto. Sin embargo, la función seguirá devolviendo un código correcto.

 

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Al deshabilitar la composición de DWM, se deshabilita para todo el escritorio. La composición de DWM se habilitará automáticamente cuando todos los procesos que hayan deshabilitado la composición hayan llamado DwmEnableComposition para habilitarlo o se hayan terminado. La notificación WM_DWMCOMPOSITIONCHANGED se envía cada vez que la composición de DWM está habilitada o deshabilitada.

Ejemplos

En el ejemplo de código siguiente se deshabilita la composición de DWM.

...
HRESULT hr = S_OK;

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dwmapi.h
Library	Dwmapi.lib
Archivo DLL	Dwmapi.dll

Consulte también

Habilitar y controlar la composición de DWM