DwmEnableComposition-Funktion (dwmapi.h)

Aktiviert oder deaktiviert die DwM-Komposition (Desktop Window Manager).

Hinweis Diese Funktion ist ab Windows 8 veraltet. DWM kann nicht mehr programmgesteuert deaktiviert werden.

 

Syntax

HRESULT DwmEnableComposition(
  [in] UINT uCompositionAction
);

Parameter

[in] uCompositionAction

DWM_EC_ENABLECOMPOSITION , um die DWM-Komposition zu aktivieren; DWM_EC_DISABLECOMPOSITION , um die Komposition zu deaktivieren.

Hinweis Ab Windows 8 hat das Aufrufen dieser Funktion mit DWM_EC_DISABLECOMPOSITION keine Auswirkung. Die Funktion gibt jedoch weiterhin einen Erfolgscode zurück.

 

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Durch das Deaktivieren der DWM-Komposition wird sie für den gesamten Desktop deaktiviert. DWM-Komposition wird automatisch aktiviert, wenn alle Prozesse, die die Komposition deaktiviert haben, DwmEnableComposition aufgerufen haben, um sie zu aktivieren oder beendet wurden. Die WM_DWMCOMPOSITIONCHANGED Benachrichtigung wird gesendet, wenn die DWM-Komposition aktiviert oder deaktiviert ist.

Beispiele

Im folgenden Codebeispiel wird die DWM-Komposition deaktiviert.

...
HRESULT hr = S_OK;

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dwmapi.h
Bibliothek	Dwmapi.lib
DLL	Dwmapi.dll

Weitere Informationen

Enable and Control DWM Composition (Aktivieren und Steuern der DWM-Komposition)