DisplayMonitor 类

定义

命名空间:

Windows.Devices.Display

提供有关连接到系统的显示监视器设备的信息。

这些数据包括监视器的扩展显示标识数据 (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

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 与 Direct3D、 DisplayConfig 和 HolographicSpace API 兼容。
DisplayAdapterTargetId	获取显示适配器用来标识监视器连接到的连接器的不透明 ID。 此目标 ID 可与 DisplayConfig API 一起使用。
DisplayName	获取适合向用户显示的设备的友好名称。
GreenPrimary	获取从监视器的扩展显示标识数据（或 EDID）计算 (色绿色主要点，并且任何驱动程序都替代) 。
IsDolbyVisionSupportedInHdrMode	获取一个值，该值指示监视器的元数据是否已指定它将高动态范围 (HDR) 视为一种特殊的 杜比视觉 模式。 此 API 旨在由媒体中运行的 DolbyVision 视频解码器用来播放经过特殊认证的内容。
MaxAverageFullFrameLuminanceInNits	获取监视器的最大平均全帧亮度（以尼特为单位）。
MaxLuminanceInNits	获取监视器的最大亮度（以尼特为单位）。
MinLuminanceInNits	获取监视器的最小亮度（以尼特为单位）。
NativeResolutionInRawPixels	获取监视器的原始分辨率（以原始像素为单位）。
PhysicalConnector	获取一个值，该值表示用于连接显示器的物理连接器标准。
PhysicalSizeInInches	获取监视器的物理对角线大小（以英寸为单位）。
RawDpiX	根据监视器的本机分辨率和物理大小) 获取监视器 (的物理水平 DPI。
RawDpiY	根据监视器的本机分辨率和物理大小) 获取监视器 (的物理垂直 DPI。
RedPrimary	获取从监视器的扩展显示标识数据（或 EDID）计算 (色红色主要点，并且任何驱动程序都替代) 。
UsageKind	获取一个值，该值表示显示所放置的用途。
WhitePoint	获取从监视器的扩展显示标识数据（或 EDID）计算 (色度白点，并且任何驱动程序都替代) 。

方法

FromIdAsync(String)	(包含 PnP 设备实例路径) 的字符串，为指定的设备标识符异步创建 DisplayMonitor 对象。 请参阅以下代码示例。 注意 参数必须是设备标识符，而不是设备接口标识符。 如果设备接口标识符 (可能) ，请改为调用 FromInterfaceIdAsync 。 有关详细信息，请参阅 DeviceInformation.Id。
FromInterfaceIdAsync(String)	为指定的监视器接口标识符异步创建 DisplayMonitor 对象， (包含 PnP 设备接口路径的字符串) 。 请参阅以下代码示例。 注意 如果调用 DeviceInformation.FindAllAsync，传递高级查询语法 (AQS) DisplayMonitor.GetDeviceSelector 返回的设备接口选择器字符串，则将检索描述监视接口的 DeviceInformation 对象的集合，这些对象描述监视接口 (而不是监视设备) 。 访问其中一个对象的 DeviceInformation.Id 属性会检索监视器接口标识符，该标识符可以传递给 DisplayMonitor.FromInterfaceIdAsync。 请参阅以下代码示例。 大多数提供监视器标识符的 Win32 API 实际上提供监视器接口标识符 (，而不是设备标识符) 。
GetDescriptor(DisplayMonitorDescriptorKind)	检索指定类型的硬件描述符。
GetDeviceSelector()	返回高级查询语法 (AQS) 设备接口选择器字符串，以便检索设备 接口 (而不是设备) 。 DeviceInformation.CreateWatcher 可以使用选择器来watch和枚举系统上的监视器设备。 或者，它可以与 DeviceInformation.FindAllAsync 一起使用，以检索描述 (监视接口的 DeviceInformation 对象的集合，而不是) 监视设备。 访问其中一个对象上的 DeviceInformation.Id 属性会检索监视器接口标识符，有关详细信息，请参阅 DisplayMonitor.FromInterfaceIdA (sync) 的代码示例。 如果从 FindAllAsync 请求 System.Devices.DeviceInstanceId 附加属性，则可以调用 DisplayMonitor.FromIdAsync (有关详细信息，请参阅 DisplayMonitor.FromIdAsync) 的代码示例。