Метод IDisplayInformationStaticsInterop::GetForMonitor (windows.graphics.display.interop.h)

Статья
03/04/2024

Извлекает объект DisplayInformation для указанного монитора. GetForMonitor всегда выделяет и возвращает новый объект DisplayInformation.

Синтаксис

HRESULT GetForMonitor(
  HMONITOR monitor,
  REFIID   riid,
  void     **displayInfo
);

Параметры

monitor

Тип: [in]\ HMONITOR

Дескриптор монитора.

riid

Тип: [in]\ REFIID

GUID класса DisplayInformation.

displayInfo

Тип: [iid_is][retval][out] void**

Указатель на блок памяти, получающий указатель на возвращенный объект DisplayInformation .

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

Тип: HRESULT

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

Движения окон не отслеживаются, так как окно отсутствует.
Любой коэффициент масштабирования, возвращаемый DisplayInformation , является текущим коэффициентом масштабирования для всего монитора. Виртуализация DPI действует так же, как и для GetScaleFactorForMonitor, который является базовым API, используемым для чтения масштабирования в данном случае.
Если вы хотите зарегистрироваться для получения событий, для получения событий в текущем потоке должен быть запущен windows.System.DispatcherQueue . Этот DispatcherQueue будет прикреплен при вызове GetForMonitor. Если DispatcherQueue отсутствует, в методах регистрации обработчика событий возвращается исключение (на уровне двоичного интерфейса приложения — HRESULT).
Текущий поток может быть MTA или STA.

Вы несете ответственность за кэширование созданного объекта DisplayInformation до тех пор, пока имеет значение аргумент монитора ; отмена регистрации обработчиков событий; и удаляет последнюю ссылку, чтобы уничтожить экземпляр DisplayInformation .

Примеры

См. пример кода в разделе IDisplayInformationStaticsInterop::GetForWindow.

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 11 22621
Верхняя часть	windows.graphics.display.interop.h

Share via