Функция DwmIsCompositionEnabled (dwmapi.h)

  • Статья

Получает значение, указывающее, включена ли композиция диспетчера окон рабочего стола (DWM). Приложения на компьютерах под управлением Windows 7 или более ранних версий могут прослушивать изменения состояния композиции, обрабатывая уведомления WM_DWMCOMPOSITIONCHANGED .

Синтаксис

HRESULT DwmIsCompositionEnabled(
  [out] BOOL *pfEnabled
);

Параметры

[out] pfEnabled

Указатель на значение, которое при успешном возвращении этой функции получает значение TRUE , если включена композиция DWM; в противном случае — FALSE.

Примечание С Windows 8 композиция DWM всегда включена. Если приложение объявляет Windows 8 совместимости в своем манифесте, эта функция получит значение TRUE через pfEnabled. Если такая запись манифеста не найдена, Windows 8 совместимость не предполагается, и эта функция получает значение FALSE через pfEnabled. Это делается для того, чтобы старые программы, которые интерпретируют значение TRUE , подразумевая, что режим высокой контрастности отключен, могли продолжать принимать правильные решения о отрисовке своих изображений. (Обратите внимание, что это плохая практика. Для определения состояния режима высокой контрастности следует использовать функцию SystemParametersInfo с флагом SPI_GETHIGHCONTRAST .)
 
Дополнительные сведения см. в разделе Поддержка тем с высокой контрастностью.

Возвращаемое значение

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header dwmapi.h
Библиотека Dwmapi.lib
DLL Dwmapi.dll