dwmEnableComposition 函式 (dwmapi.h)

啟用或停用桌面視窗管理員 (DWM) 組合。

注意自 Windows 8 起，此函式已被取代。 DWM 無法再以程序設計方式停用。

語法

HRESULT DwmEnableComposition(
  [in] UINT uCompositionAction
);

[in] uCompositionAction

DWM_EC_ENABLECOMPOSITION 啟用 DWM 組合; DWM_EC_DISABLECOMPOSITION 停用組合。

注意從 Windows 8 起，使用 DWM_EC_DISABLECOMPOSITION呼叫此函式沒有任何作用。不過，函式仍會傳回成功碼。

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

停用 DWM 組合會針對整個桌面停用它。當所有已停用組合的進程都呼叫 DwmEnableComposition 來啟用或已終止時，就會自動啟用 DWM 組合。每當啟用或停用 DWM 組合時，就會傳送 WM_DWMCOMPOSITIONCHANGED 通知。

下列程式代碼範例會停用 DWM 組合。


...
HRESULT hr = S_OK;

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