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	取得在 nits 中顯示的最大尖峰亮度，這通常對顯示器的一小部分有效。
MinLuminanceInNits	取得 nits 中顯示器的最小亮度。
RedPrimary	取得顯示器的原生紅色主要色彩。
SdrWhiteLevelInNits	取得目前由作業系統用於此顯示上所有 SDR 內容的亮度值，以 nits 為單位。
WhitePoint	取得顯示器的原生白點。

方法

IsAdvancedColorKindAvailable(AdvancedColorKind)	傳回布林值，描述監視器或顯示驅動程式是否原本就支援指定的進階色彩種類值。
IsHdrMetadataFormatCurrentlySupported(HdrMetadataFormat)	傳回布林值，這個值描述目前狀態的顯示器是否支援指定的 HDR 元資料格式。