Funzione DwmEnableComposition (dwmapi.h)

Articolo
08/14/2024

Abilita o disabilita la composizione di Desktop Window Manager (DWM).

Nota Questa funzione è deprecata a partire da Windows 8. DWM non può più essere disabilitato a livello di codice.

Sintassi

HRESULT DwmEnableComposition(
  [in] UINT uCompositionAction
);

Parametri

[in] uCompositionAction

DWM_EC_ENABLECOMPOSITION per abilitare la composizione DWM; DWM_EC_DISABLECOMPOSITION per disabilitare la composizione.

Nota A partire da Windows 8, la chiamata a questa funzione con DWM_EC_DISABLECOMPOSITION non ha alcun effetto. Tuttavia, la funzione restituirà comunque un codice di esito positivo.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La disabilitazione della composizione DWM la disabilita per l'intero desktop. La composizione DWM verrà abilitata automaticamente quando tutti i processi con composizione disabilitata hanno chiamato DwmEnableComposition per abilitarlo o essere stato terminato. La notifica WM_DWMCOMPOSITIONCHANGED viene inviata ogni volta che la composizione DWM è abilitata o disabilitata.

Esempio

Nell'esempio di codice seguente viene disabilitata la composizione DWM.


...
HRESULT hr = S_OK;

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dwmapi.h
Libreria	Dwmapi.lib
DLL	Dwmapi.dll

Vedi anche

Abilitare e controllare la composizione DWM

Condividi tramite