AdvancedColorInfo Class

Reference

Definition

Namespace:: Windows.Graphics.Display

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Contains a snapshot of the Advanced Color-related information of a monitor or display driver.

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

Inheritance: Object Platform::Object IInspectable AdvancedColorInfo

Attributes: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Device family	Windows 10, version 1803 (introduced in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v6.0)

Remarks

Advanced color is a Windows developer term indicating support for high dynamic range (HDR), wide color gamut (WCG), and high precision (bit depth) visual content such as videos, games and photos. To use advanced color, your computer must have an advanced color-capable GPU and display; further, the composition and display stack must enter a new advanced color mode that uses FP16 rendering and composition.

To exploit advanced color, applications must be updated with enhanced rendering pipelines (for example, DirectX) and they must detect and adapt to the specific capabilities of the current display. In terms of API design, advanced color has similarities to features such as high DPI and stereoscopic 3D.

Apps need to understand the current feature state, such as if HDR active, and what kind of HDR is active. Apps mus also understand the quantitative display characteristics (for example, peak luminance, color primaries) and underlying capabilities of the hardware (for example, can HDR be enabled at all).
User action or OS policy can change the feature state and display characteristics at any time.

Properties

BluePrimary	Gets the native Blue color primary for the display.
CurrentAdvancedColorKind	Gets the AdvancedColorKind which is currently being set on the display.
GreenPrimary	Gets the native Green color primary for the display.
MaxAverageFullFrameLuminanceInNits	Gets the maximum frame average luminance of the display which can be achieved on the whole display.
MaxLuminanceInNits	Gets the maximum peak luminance of the display in nits, which is usually valid for a small part of the display.
MinLuminanceInNits	Get the minimum luminance of the display in nits.
RedPrimary	Gets the native Red color primary for the display.
SdrWhiteLevelInNits	Get the luminance value, in nits, which is currently being used by the operating system for all the SDR content on this display.
WhitePoint	Gets the native white point for the display.

Methods

IsAdvancedColorKindAvailable(AdvancedColorKind)	Returns a boolean value that describes if the specified Advanced Color kind value is inherently supported by the monitor or display driver.
IsHdrMetadataFormatCurrentlySupported(HdrMetadataFormat)	Returns a boolean value that describes whether the specified HDR metadata format is supported by the display in its current state.

Applies to

Share via