Función DwmIsCompositionEnabled (dwmapi.h)

Obtiene un valor que indica si la composición del Administrador de ventanas de escritorio (DWM) está habilitada. Las aplicaciones de las máquinas que ejecutan Windows 7 o versiones anteriores pueden escuchar los cambios de estado de composición controlando la notificación de WM_DWMCOMPOSITIONCHANGED .

Sintaxis

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

Parámetros

[out] pfEnabled

Puntero a un valor que, cuando esta función devuelve correctamente, recibe TRUE si está habilitada la composición de DWM; de lo contrario, FALSE.

Nota A partir de Windows 8, la composición de DWM siempre está habilitada. Si una aplicación declara Windows 8 compatibilidad en su manifiesto, esta función recibirá un valor true a través de pfEnabled. Si no se encuentra ninguna entrada de manifiesto, no se supone Windows 8 compatibilidad y esta función recibe un valor false a través de pfEnabled. Esto se hace para que los programas más antiguos que interpretan un valor de TRUE impliquen que el modo de contraste alto está desactivado puede seguir tomando las decisiones correctas sobre la representación de sus imágenes. (Tenga en cuenta que se trata de una práctica incorrecta: debe usar la función SystemParametersInfo con la marca SPI_GETHIGHCONTRAST para determinar el estado del modo de contraste alto).

 

Para obtener más información, vea Compatibilidad con temas de contraste alto.

Valor devuelto

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

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