DisplayMonitor クラス

定義

システムに接続されているディスプレイ モニター デバイスに関する情報を提供します。

これらのデータには、モニターの拡張ディスプレイ識別データ (EDID) からの一般的に使用される情報 (EDID は、ほぼすべてのモニターがサポートされているモードと一般的なデバイス情報の説明を提供するために使用する業界標準のディスプレイ記述子ブロック) と DisplayID (EDID のスーパーセットを提供する新しい業界標準) が含まれます。

public ref class DisplayMonitor sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DisplayMonitor final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DisplayMonitor
Public NotInheritable Class DisplayMonitor
継承
Object Platform::Object IInspectable DisplayMonitor
属性

Windows の要件

デバイス ファミリ
Windows 10, version 1803 (10.0.17134.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v6.0 で導入)

注釈

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
2004 19041 IsDolbyVisionSupportedInHdrMode

プロパティ

BluePrimary

色度ブルーのプライマリ ポイントを取得します (モニターの拡張ディスプレイ識別データ、または EDID、およびドライバーのオーバーライドから計算されます)。

ConnectionKind

ディスプレイが接続されている抽象メソッドを表す値を取得します (物理プロトコルに固有ではありません)。

DeviceId

デバイス識別子を取得します。

DisplayAdapterDeviceId

モニターが接続されているディスプレイ アダプターのデバイス識別子を取得します。 ディスプレイ アダプターがレンダリングに最適なデバイスではない可能性があることに注意してください。

DisplayAdapterId

モニターが接続されているディスプレイ アダプターのローカル一意識別子 (LUID) を取得します。 モニターが接続されているディスプレイ アダプターが、レンダリングに最も適していない可能性があることに注意してください。

LUID は、生成されたシステムでのみ一意であることが保証される 64 ビット値です。 LUID の一意性は、システムが再起動されるまで保証されません。 この LUID は、 Direct3DDisplayConfigHolographicSpace API と互換性があります。

DisplayAdapterTargetId

モニターが接続されているコネクタを識別するためにディスプレイ アダプターによって使用される不透明な ID を取得します。 このターゲット ID は、 DisplayConfig API で使用できます。

DisplayName

ユーザーへの表示に適したデバイスのフレンドリ名を取得します。

GreenPrimary

色度の緑のプライマリ ポイントを取得します (モニターの拡張ディスプレイ識別データ(EDID)、およびドライバーのオーバーライドから計算されます)。

IsDolbyVisionSupportedInHdrMode

モニターのメタデータが高ダイナミック レンジ (HDR) を特殊な Dolby Vision モードとして扱うことを指定したかどうかを示す値を取得します。 この API は、メディア内で実行されている DolbyVision ビデオ デコーダーが、特別に認定されたコンテンツを再生するために使用することを目的としています。

MaxAverageFullFrameLuminanceInNits

モニターの最大平均全フレーム輝度 (ニット単位) を取得します。

MaxLuminanceInNits

モニターの最大輝度 (nits) を取得します。

MinLuminanceInNits

モニターの最小輝度をニット単位で取得します。

NativeResolutionInRawPixels

生ピクセル単位のモニターのネイティブ解像度を取得します。

PhysicalConnector

ディスプレイの接続に使用される物理コネクタ標準を表す値を取得します。

PhysicalSizeInInches

モニターの物理的な対角線サイズをインチ単位で取得します。

RawDpiX

モニターの物理水平 DPI (モニターのネイティブ解像度と物理サイズに基づく) を取得します。

RawDpiY

(モニターのネイティブ解像度と物理サイズに基づいて) モニターの物理的な垂直方向の DPI を取得します。

RedPrimary

色度の赤いプライマリ ポイントを取得します (モニターの拡張ディスプレイ識別データ(EDID)、およびドライバーのオーバーライドから計算されます)。

UsageKind

ディスプレイの配置先となる使用を表す値を取得します。

WhitePoint

色度の白点を取得します (モニターの拡張表示識別データ、または EDID、およびドライバーのオーバーライドから計算されます)。

メソッド

FromIdAsync(String)

指定したデバイス識別子 (PnP デバイス インスタンス パスを含む文字列) の DisplayMonitor オブジェクトを非同期的に作成します。 以下のコード例を参照してください。

注意

引数は、デバイス インターフェイス識別子ではなく、デバイス識別子である必要があります。 デバイス インターフェイス識別子 (おそらく) がある場合は、代わりに FromInterfaceIdAsync を呼び出します。 詳細については、「 DeviceInformation.Id」を参照してください。

FromInterfaceIdAsync(String)

指定したモニター インターフェイス識別子 (PnP デバイス インターフェイス パスを含む文字列) の DisplayMonitor オブジェクトを非同期的に作成します。 以下のコード例を参照してください。

注意

DeviceInformation.FindAllAsync を呼び出し、DisplayMonitor.GetDeviceSelector によって返される高度なクエリ構文 (AQS) デバイス インターフェイス セレクター文字列を渡すと、(モニター デバイスではなく) モニター インターフェイスを記述する DeviceInformation オブジェクトのコレクションを取得します。 これらのオブジェクトのいずれかで DeviceInformation.Id プロパティにアクセスすると、 DisplayMonitor.FromInterfaceIdAsync に渡すことができるモニター インターフェイス識別子が取得されます。 以下のコード例を参照してください。

モニター識別子を提供するほとんどの Win32 API は、実際には (デバイス識別子ではなく) モニター インターフェイス識別子を提供します。

GetDescriptor(DisplayMonitorDescriptorKind)

指定した種類のハードウェア記述子を取得します。

GetDeviceSelector()

(デバイスではなく) デバイス インターフェイスを取得するために、高度なクエリ構文 (AQS) デバイス インターフェイス セレクター文字列を返します。

セレクターは、DeviceInformation.CreateWatcher によって、システム上の監視デバイスをwatchおよび列挙するために使用できます。 または、 DeviceInformation.FindAllAsync と共に使用して、(モニター デバイスではなく) モニター インターフェイスを記述する DeviceInformation オブジェクトのコレクションを取得することもできます。 これらのオブジェクトのいずれかで DeviceInformation.Id プロパティにアクセスすると、 DisplayMonitor.FromInterfaceIdAsync に渡すことができるモニター インターフェイス識別子が取得されます (詳細については、 DisplayMonitor.FromInterfaceIdAsync のコード例を参照してください)。 FindAllAsync から System.Devices.DeviceInstanceId 追加プロパティを要求した場合は、DisplayMonitor.FromIdAsync を呼び出すことができます (詳細については、DisplayMonitor.FromIdAsync のコード例を参照してください)。

適用対象