다음을 통해 공유

IDisplayInformationStaticsInterop::GetForMonitor 메서드(windows.graphics.display.interop.h)

  • 아티클

지정된 모니터에 대한 DisplayInformation 개체를 검색합니다. GetForMonitor 항상 새 DisplayInformation할당하고 반환합니다.

통사론

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

매개 변수

monitor

형식: [in]\ HMONITOR

모니터의 핸들입니다.

riid

형식: [in]\ REFIID

DisplayInformation 클래스의 GUID.

displayInfo

형식: [iid_is][retval][out] void**

반환된 DisplayInformation 개체에 대한 포인터를 수신하는 메모리 블록에 대한 포인터입니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK반환합니다. 그렇지 않으면 HRESULT오류 코드반환합니다.

발언

고려 사항:

  • 창이 없으므로 창 이동은 추적되지 않습니다.
  • DisplayInformation 반환되는 배율 인수는 전체 모니터의 현재 배율 인수입니다. DPI 가상화는 이 경우 크기를 읽는 데 사용되는 기본 API인 getScaleFactorForMonitor것과 동일한 방식으로 작동합니다.
  • 이벤트를 등록하려는 경우 이벤트를 받으려면 현재 스레드에 Windows.System.DispatcherQueue 실행 중이어야 합니다. 해당 DispatcherQueue GetForMonitor호출 시 스냅됩니다. DispatcherQueue없는 경우 예외(애플리케이션 이진 인터페이스 수준에서 HRESULT)가 이벤트 처리기 등록 메서드에 반환됩니다.
  • 현재 스레드는 MTA 또는 STA일 수 있습니다.

모니터 인수가 관련된 한 생성된 DisplayInformation 캐싱해야 합니다. 등록 해제 이벤트 처리기; 및 DisplayInformation 인스턴스를 삭제하기 위해 마지막 참조를 삭제합니다.

예제

IDisplayInformationStaticsInterop::GetForWindow코드 예제를 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows 11 빌드 22621
헤더 windows.graphics.display.interop.h