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

Статья
07/16/2024

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

Синтаксис

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

Параметры

monitor

Тип: [in]\ HMONITOR

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

riid

Тип: [in]\ REFIID

Guid 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

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