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 组合。 每当启用或禁用 DWM 组合时,将发送 WM_DWMCOMPOSITIONCHANGED 通知。

示例

下面的代码示例禁用 DWM 组合。


...
HRESULT hr = S_OK;

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

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 dwmapi.h
Library Dwmapi.lib
DLL Dwmapi.dll

另请参阅

启用和控制 DWM 组合