Freigeben über


AdvancedColorInfo Klasse

Definition

Enthält eine Momentaufnahme der erweiterten Farbinformationen eines Monitors oder Anzeigetreibers.

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
Vererbung
Object Platform::Object IInspectable AdvancedColorInfo
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v6.0)

Hinweise

Erweiterte Farbe ist ein Windows-Entwicklerbegriff, der die Unterstützung für high dynamic range (HDR), Wide Color Gamut (WCG) und visuelle Inhalte mit hoher Genauigkeit (Bittiefe) wie Videos, Spiele und Fotos angibt. Um erweiterte Farben verwenden zu können, muss Ihr Computer über eine erweiterte farbfähige GPU und anzeige verfügen. Außerdem muss der Kompositions- und Anzeigestapel in einen neuen erweiterten Farbmodus wechseln, der FP16-Rendering und -Komposition verwendet.

Um erweiterte Farben zu nutzen, müssen Anwendungen mit erweiterten Renderingpipelines (z. B. DirectX) aktualisiert werden und sie müssen die spezifischen Funktionen der aktuellen Anzeige erkennen und anpassen. In Bezug auf das API-Design weist die erweiterte Farbe Ähnlichkeiten mit Features wie hoher DPI und stereoskopischem 3D auf.

  • Apps müssen den aktuellen Featurestatus verstehen, z. B. ob HDR aktiv ist und welche Art von HDR aktiv ist. Apps verstehen auch die quantitativen Anzeigemerkmale (z. B. Spitzenleuchtigkeit, Farbprimus) und die zugrunde liegenden Funktionen der Hardware (z. B. kann HDR überhaupt aktiviert werden).

  • Benutzeraktionen oder Betriebssystemrichtlinien können den Featurestatus jederzeit ändern und Merkmale anzeigen.

Eigenschaften

BluePrimary

Ruft die native blaue Farbe für die Anzeige ab.

CurrentAdvancedColorKind

Ruft das AdvancedColorKind ab, das derzeit auf der Anzeige festgelegt wird.

GreenPrimary

Ruft die native grüne Farbe für die Anzeige ab.

MaxAverageFullFrameLuminanceInNits

Ruft die maximale durchschnittliche Frameleuchtigkeit der Anzeige ab, die auf dem gesamten Display erreicht werden kann.

MaxLuminanceInNits

Ruft die maximale Spitzenleuchtigkeit der Anzeige in Nits ab, die in der Regel für einen kleinen Teil der Anzeige gültig ist.

MinLuminanceInNits

Rufen Sie die minimale Leuchtdichte der Anzeige in Nissen ab.

RedPrimary

Ruft die native rote Farbe für die Anzeige ab.

SdrWhiteLevelInNits

Rufen Sie den Leuchtdichtewert in Nits ab, der derzeit vom Betriebssystem für alle SDR-Inhalte auf dieser Anzeige verwendet wird.

WhitePoint

Ruft den nativen Weißpunkt für die Anzeige ab.

Methoden

IsAdvancedColorKindAvailable(AdvancedColorKind)

Gibt einen booleschen Wert zurück, der beschreibt, ob der angegebene Wert für die Erweiterte Farbart vom Monitor oder Anzeigetreiber inhärent unterstützt wird.

IsHdrMetadataFormatCurrentlySupported(HdrMetadataFormat)

Gibt einen booleschen Wert zurück, der beschreibt, ob das angegebene HDR-Metadatenformat im aktuellen Zustand von der Anzeige unterstützt wird.

Gilt für: