共用方式為

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 虛擬化的作用方式與 GetScaleFactorForMonitor 相同，這是在此案例中用來讀取縮放比例的基礎 API。
  • 如果您想要註冊事件，則目前的線程必須執行 Windows.System.DispatcherQueue ，才能接收事件。 該 DispatcherQueue 會在 呼叫 GetForMonitor 時貼齊。 如果沒有 DispatcherQueue，則會在應用程式二進位介面層級 (例外狀況，事件處理程式註冊方法中會傳回 HRESULT) 。
  • 目前的線程可以是 MTA 或 STA。

您必須負責：只要監視的自變數相關，就會快取已建立的 DisplayInformation;取消註冊事件處理程式;並卸除最後一個參考，以終結 DisplayInformation 實例。

範例

請參閱 IDisplayInformationStaticsInterop：：GetForWindow 中的程式碼範例。

規格需求

需求 值
最低支援的用戶端 Windows 11 組建 22621
標頭 windows.graphics.display.interop.h