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 を指定できます。
監視 の引数が関連している限り、作成された
例
IDisplayInformationStaticsInterop::GetForWindowのコード例を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 11 ビルド 22621 |
ヘッダー | windows.graphics.display.interop.h |