Функция 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 отключает ее для всего рабочего стола. Композиция DWM будет включена автоматически, если все процессы, которые отключили композицию, вызвали DwmEnableComposition для включения или были завершены. Уведомление WM_DWMCOMPOSITIONCHANGED отправляется при каждом включении или отключении композиции DWM.
Примеры
В следующем примере кода отключается композиция DWM.
...
HRESULT hr = S_OK;
// Disable DWM Composition
hr = DwmEnableComposition(DWM_EC_DISABLECOMPOSITION);
if (SUCCEEDED(hr))
{
// ...
}
...
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | dwmapi.h |
| Библиотека | Dwmapi.lib |
| DLL | Dwmapi.dll |