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
Library Dwmapi.lib
DLL Dwmapi.dll