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 |