共用方式為

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