Функция RegisterScaleChangeNotifications (shellscalingapi.h)

Регистрирует окно для получения обратных вызовов при изменении сведений о масштабировании.

Примечание Эта функция не поддерживается с Windows 8.1. Вместо этого используйте RegisterScaleChangeEvent .

 

Синтаксис

HRESULT RegisterScaleChangeNotifications(
  [in]  DISPLAY_DEVICE_TYPE displayDevice,
  [in]  HWND                hwndNotify,
  [in]  UINT                uMsgNotify,
  [out] DWORD               *pdwCookie
);

Параметры

[in] displayDevice

Тип: DISPLAY_DEVICE_TYPE

Значение перечисления, указывающее, какое устройство отображения будет получать уведомления.

[in] hwndNotify

Тип: HWND

Дескриптор окна, которое будет получать уведомления.

[in] uMsgNotify

Тип: UINT

Определяемое приложением сообщение, которое передается в окно, заданное hwndNotify при изменении данных масштабирования. Как правило, для этого параметра должно быть задано значение WM_APP+x, где x — целочисленное значение.

[out] pdwCookie

Тип: DWORD*

Указатель на значение, которое при успешном возвращении этой функции получает маркер регистрации. Этот маркер используется для отзыва уведомлений путем вызова RevokeScaleChangeNotifications.

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

Тип: STDAPI

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

Комментарии

Это сообщение, указанное uMsgNotify , отправляется в зарегистрированное окно через PostMessage. WParam сообщения может содержать сочетание SCALE_CHANGE_FLAGS, описывающих произошедшие изменения.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	shellscalingapi.h
DLL	Shcore.dll

См. также раздел

GetScaleFactorForMonitor

RegisterScaleChangeEvent

Отмена регистрацииScaleChangeEvent