Поделиться через


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

Регистрирует событие, которое активируется при возможном изменении масштаба. Эта функция заменяет RegisterScaleChangeNotifications.

Синтаксис

HRESULT RegisterScaleChangeEvent(
  [in]  HANDLE    hEvent,
  [out] DWORD_PTR *pdwCookie
);

Параметры

[in] hEvent

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

[out] pdwCookie

При успешном возврате этой функции это значение получает адрес указателя на файл cookie, который можно использовать позже для отмены регистрации уведомлений об изменении масштаба через UnregisterScaleChangeEvent.

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

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

Комментарии

Событие возникает всякий раз, когда что-то может повлиять на изменение масштаба, но только потому, что масштаб может быть затронут, не означает, что это произошло. Вызывающие абоненты могут кэшировать коэффициент масштабирования, чтобы убедиться, что масштаб монитора действительно изменился. Дескриптор события будет дублирован, поэтому вызывающие абоненты могут закрыть свой дескриптор в любое время.

Требования

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

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

GetScaleFactorForMonitor

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