Função DwmIsCompositionEnabled (dwmapi.h)

Obtém um valor que indica se a composição do DWM (Gerenciador de Janelas da Área de Trabalho) está habilitada. Aplicativos em computadores que executam o Windows 7 ou anterior podem escutar alterações de estado de composição manipulando a notificação de WM_DWMCOMPOSITIONCHANGED .

Sintaxe

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

Parâmetros

[out] pfEnabled

Um ponteiro para um valor que, quando essa função retorna com êxito, recebe TRUE se a composição dwm está habilitada; caso contrário, FALSE.

Nota A partir de Windows 8, a composição do DWM está sempre habilitada. Se um aplicativo declarar Windows 8 compatibilidade em seu manifesto, essa função receberá um valor true por meio de pfEnabled. Se nenhuma entrada de manifesto for encontrada, Windows 8 compatibilidade não será assumida e essa função receberá um valor de FALSE por meio de pfEnabled. Isso é feito para que programas mais antigos que interpretam um valor true indiquem que o modo de alto contraste está desativado pode continuar a tomar as decisões corretas sobre como renderizar suas imagens. (Observe que essa é uma prática ruim— você deve usar a função SystemParametersInfo com o sinalizador SPI_GETHIGHCONTRAST para determinar o estado do modo de alto contraste.)

 

Para obter mais informações, consulte Suporte a temas de alto contraste.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dwmapi.h
Biblioteca	Dwmapi.lib
DLL	Dwmapi.dll