DXGK_COLORIMETRY Struktur (d3dkmddi.h)

Beschreibt die Farbmetrik und eng verwandte Felder, die verwendet werden, um Außerkraftsetzungen aus dem Deskriptor zu beschreiben, der vom Anzeigegerät abgerufen wird.

Syntax

typedef struct _DXGK_COLORIMETRY {
  D3DKMDT_2DOFFSET                   RedPoint;
  D3DKMDT_2DOFFSET                   GreenPoint;
  D3DKMDT_2DOFFSET                   BluePoint;
  D3DKMDT_2DOFFSET                   WhitePoint;
  ULONG                              MinLuminance;
  ULONG                              MaxLuminance;
  ULONG                              MaxFullFrameLuminance;
  D3DKMDT_WIRE_FORMAT_AND_PREFERENCE FormatBitDepths;
  DXGK_STANDARD_COLORIMETRY_FLAGS    StandardColorimetryFlags;
} DXGK_COLORIMETRY, *PDXGK_COLORIMETRY;

Member

RedPoint

Überschreiben sie für den roten Anzeigepunkt. Beachten Sie, dass jede Dimension ein 10-Bit-Wert ist, der in den am wenigsten signifikanten Bits gespeichert ist. Null bedeutet keine Überschreibung.

GreenPoint

Überschreiben sie für den grünen Anzeigepunkt. Beachten Sie, dass jede Dimension ein 10-Bit-Wert ist, der in den am wenigsten signifikanten Bits gespeichert ist.

BluePoint

Überschreiben Sie den blauen Punkt. Beachten Sie, dass jede Dimension ein 10-Bit-Wert ist, der in den am wenigsten signifikanten Bits gespeichert ist.

WhitePoint

Überschreiben sie für den Anzeigeweißpunkt. Beachten Sie, dass jede Dimension ein 10-Bit-Wert ist, der in den am wenigsten signifikanten Bits gespeichert ist.

MinLuminance

Überschreiben Sie den minimalen Leuchtdichtewert, der von der Anzeige in einem Zehntausendstel eines Nits unterstützt wird. Nur gültig, wenn MaxLuminance ungleich 0 ist. Null ist ein gültiger Wert.

MaxLuminance

Überschreiben Sie den maximalen Leuchtdichtewert, der von der Anzeige in einem Zehntausendstel eines Nits unterstützt wird. Es wird erwartet, dass diese Leuchtdichte nur für einen relativ kleinen Bereich in einem bestimmten Frame unterstützt wird.
Null gibt an, dass MaxLuminance, MaxFullFrameLuminance oder MinLuminance nicht außer Kraft gesetzt werden.

MaxFullFrameLuminance

Überschreiben Sie den maximalen Vollbildleuchtigkeitswert, der von der Anzeige in einem Zehntausendstel einer Nit unterstützt wird. Diese Helligkeitsstufe muss für jedes Pixel im Frame gleichzeitig unterstützt werden, um eine Schätzung des durchschnittlichen Leuchtdichtewerts zu ermöglichen, der vom Display über einen Frame unterstützt werden kann. Nur gültig, wenn MaxLuminance ungleich 0 ist. Null ist keine gültige Außerkraftsetzung.

FormatBitDepths

Überschreibt die unterstützten Bits pro Farbkanal in jeder der fünf Farbcodierungen, die für Kabelformate angegeben sind. Es muss mindestens ein Bit festgelegt werden, wobei das Feld "Einstellungen" ausgenommen ist, das reserviert ist und 0 sein muss.

StandardColorimetryFlags

Gibt die Unterstützung für bestimmte Colorimetrie- und EOTF-Funktionen mithilfe von Bitfeldern an.

Hinweise

Diese Struktur wird sowohl für das Abfragen von Außerkraftsetzungen vom Treiber als auch für das Betriebssystem verwendet, das den endgültigen Satz von Werten meldet, den es ausgewählt hat. Außerkraftsetzungen werden für integrierte Anzeigen unterstützt, die diese Struktur verwenden, die in die DXGK_QUERYINTEGRATEDDISPLAYOUT-Struktur eingebettet ist, und für externe Anzeigen, bei denen diese Struktur als Ausgabepuffer für einen Adapterabfragetyp DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES verwendet wird. Die ausgewählten und angepassten Außerkraftsetzungen werden mithilfe von DxgkDdiSetTargetAdjustedColorimetry an den Treiber zurückgemeldet.

Beim Abfragen von Außerkraftsetzungen erfordert das Betriebssystem, dass entweder alle Felder vom Treiber gefüllt werden oder der Puffer auf null gesetzt wird, um die Komplexität des Versuchens zu vermeiden, diese miteinander verbundenen Attribute aus verschiedenen Quellen zusammenzuführen. Wenn die Struktur nicht vollständig auf Null gesetzt ist, überprüft das Betriebssystem, dass Felder, die nicht wie oben erwähnt null sein dürfen, nicht 0 sind.

Die Farbpunkte werden über eine einfache Integritätsprüfung hinaus überprüft (jeder Wert muss zwischen 1 und 1023 liegen), um vernünftige Werte sicherzustellen, indem die Koordinaten jedes Punkts mit den Standardpunkten verglichen und sichergestellt wird, dass keiner zu weit vom Standard entfernt ist.

Wenn das Betriebssystem DxgkDdiSetTargetAdjustedColorimetry aufruft, werden die FormatBitDepths und StandardColorimetryFlags auf Null gesetzt, da es sich hierbei um Funktionsfelder handelt, die nur in Abfragen gültig sind.

Anforderungen

Anforderung	Wert
Header	d3dkmddi.h