DwmIsCompositionEnabled-Funktion (dwmapi.h)

Ruft einen Wert ab, der angibt, ob die DWM-Komposition (Desktop Window Manager) aktiviert ist. Anwendungen auf Computern mit Windows 7 oder früher können auf Änderungen des Kompositionszustands lauschen, indem sie die WM_DWMCOMPOSITIONCHANGED Benachrichtigung behandeln.

Syntax

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

Parameter

[out] pfEnabled

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Funktion TRUE empfängt, wenn die DWM-Komposition aktiviert ist; andernfalls FALSE.

Hinweis Ab Windows 8 ist die DWM-Komposition immer aktiviert. Wenn eine App Windows 8 Kompatibilität in ihrem Manifest deklariert, erhält diese Funktion über pfEnabled den Wert TRUE. Wenn kein solcher Manifesteintrag gefunden wird, wird Windows 8 Kompatibilität nicht angenommen, und diese Funktion erhält über pfEnabled den Wert FALSE. Dies geschieht, damit ältere Programme, die den Wert TRUE interpretieren, um zu impliziert, dass der Modus mit hohem Kontrast deaktiviert ist, weiterhin die richtigen Entscheidungen über das Rendern ihrer Bilder treffen können. (Beachten Sie, dass dies eine schlechte Methode ist. Sie sollten die SystemParametersInfo-Funktion mit dem Flag SPI_GETHIGHCONTRAST verwenden, um den Zustand des Modus für hohen Kontrast zu bestimmen.)

 

Weitere Informationen finden Sie unter Unterstützen von Designs mit hohem Kontrast.

Rückgabewert

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

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