Função DwmEnableComposition (dwmapi.h)

Habilita ou desabilita a composição do DWM (Gerenciador de Janelas da Área de Trabalho).

Nota Essa função é preterida a partir de Windows 8. O DWM não pode mais ser desabilitado programaticamente.

 

Sintaxe

HRESULT DwmEnableComposition(
  [in] UINT uCompositionAction
);

Parâmetros

[in] uCompositionAction

DWM_EC_ENABLECOMPOSITION habilitar a composição dwm; DWM_EC_DISABLECOMPOSITION desabilitar a composição.

Nota A partir de Windows 8, chamar essa função com DWM_EC_DISABLECOMPOSITION não tem efeito. No entanto, a função ainda retornará um código de êxito.

 

Retornar valor

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

Comentários

Desabilitar a composição do DWM a desabilita para toda a área de trabalho. A composição dwm será habilitada automaticamente quando todos os processos que desabilitaram a composição tiverem chamado DwmEnableComposition para habilitá-la ou tiverem sido encerrados. A notificação WM_DWMCOMPOSITIONCHANGED é enviada sempre que a composição dwm está habilitada ou desabilitada.

Exemplos

O exemplo de código a seguir desabilita a composição dwm.

...
HRESULT hr = S_OK;

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

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

Confira também

Habilitar e controlar a composição do DWM