dwmIsCompositionEnabled 函式 (dwmapi.h)
取得值,指出是否啟用桌面視窗管理員 (DWM) 組合。 執行 Windows 7 或更早版本之電腦上的應用程式可以藉由處理 WM_DWMCOMPOSITIONCHANGED 通知來接聽組合狀態變更。
語法
HRESULT DwmIsCompositionEnabled(
[out] BOOL *pfEnabled
);
參數
[out] pfEnabled
值指標,當此函式成功傳回時,如果已啟用 DWM 組合,就會收到 TRUE ;否則為 FALSE。
注意自 Windows 8 起,一律會啟用 DWM 組合。 如果應用程式在其指令清單中宣告 Windows 8 相容性,此函式將會透過 pfEnabled 收到 TRUE 值。 如果找不到這類指令清單專案,則不會假設 Windows 8 相容性,而且此函式會透過 pfEnabled 接收 FALSE 值。 這麼做可讓解譯 TRUE 值的較舊程式表示高對比度模式已關閉,可以繼續做出轉譯其影像的正確決策。 (請注意,這是錯誤的作法,您應該使用 SystemParametersInfo 函式搭配 SPI_GETHIGHCONTRAST 旗標來判斷高對比度模式的狀態。)
傳回值
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | dwmapi.h |
程式庫 | Dwmapi.lib |
Dll | Dwmapi.dll |