AdvancedColorInfo 类

定义

命名空间:

Windows.Graphics.Display

包含监视器或显示驱动程序的高级颜色相关信息的快照。

public ref class AdvancedColorInfo 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 AdvancedColorInfo 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 AdvancedColorInfo

Public NotInheritable Class AdvancedColorInfo

继承

Object Platform::Object IInspectable AdvancedColorInfo

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10, version 1803 (在 10.0.17134.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v6.0 中引入)

注解

高级颜色是一个 Windows 开发人员术语，表示支持高动态范围 (HDR) 、宽色域 (WCG) ，以及视频、游戏和照片等视觉内容) 高精度 (位深度。 若要使用高级颜色，计算机必须具有支持颜色的高级 GPU 和显示器;此外，合成和显示堆栈必须进入使用 FP16 呈现和合成的新高级颜色模式。

若要利用高级颜色，必须使用增强的呈现管道更新应用程序， (例如 DirectX) ，并且它们必须检测并适应当前显示器的特定功能。 在 API 设计方面，高级颜色与高 DPI 和立体 3D 等功能相似。

• 应用需要了解当前功能状态，例如 HDR 是否处于活动状态，以及哪种类型的 HDR 处于活动状态。 应用还了解定量显示特征 (例如峰值亮度、颜色初选) 以及硬件 (的基础功能，可以在所有) 启用 HDR。

• 用户操作或 OS 策略可以随时更改功能状态和显示特征。

属性

BluePrimary	获取显示器的本机蓝色主色。
CurrentAdvancedColorKind	获取当前在显示器上设置的 AdvancedColorKind 。
GreenPrimary	获取显示器的本机绿色主色。
MaxAverageFullFrameLuminanceInNits	获取可在整个显示器上实现的显示器的最大帧平均亮度。
MaxLuminanceInNits	获取屏幕的最大峰值亮度（以尼特为单位），这通常对显示器的一小部分有效。
MinLuminanceInNits	获取屏幕的最小亮度（以尼特为单位）。
RedPrimary	获取显示器的本机红色主色。
SdrWhiteLevelInNits	获取亮度值（以尼特为单位），该值当前正由操作系统用于此显示器上的所有 SDR 内容。
WhitePoint	获取显示器的本机白点。

方法

IsAdvancedColorKindAvailable(AdvancedColorKind)	返回一个布尔值，该值描述监视器或显示驱动程序是否本身支持指定的高级颜色类型值。
IsHdrMetadataFormatCurrentlySupported(HdrMetadataFormat)	返回一个布尔值，该值描述当前状态的显示器是否支持指定的 HDR 元数据格式。