DisplayAdvancedColorInfo 类

定义

命名空间:

Microsoft.Graphics.Display

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

public ref class DisplayAdvancedColorInfo sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65538)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DisplayAdvancedColorInfo final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65538)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DisplayAdvancedColorInfo

Public NotInheritable Class DisplayAdvancedColorInfo

继承

Object Platform::Object IInspectable DisplayAdvancedColorInfo

属性

ContractVersionAttribute MarshalingBehaviorAttribute

注解

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

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

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

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

属性

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

方法

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