DXGK_COLORIMETRY Struktur (d3dkmddi.h)

Beschreibt die Farbmetrie und eng verwandte Felder, die verwendet werden, um Außerkraftsetzungen vom 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;

Angehörige

RedPoint

Außerkraftsetzung für die Anzeige des roten Punkts. Beachten Sie, dass jede Dimension ein 10-Bit-Wert ist, der in den am wenigsten signifikanten Bits gespeichert ist. Null gibt keine Außerkraftsetzung an.

GreenPoint

Außerkraftsetzung 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

Außerkraftsetzung für den blauen Anzeigepunkt. Beachten Sie, dass jede Dimension ein 10-Bit-Wert ist, der in den am wenigsten signifikanten Bits gespeichert ist.

WhitePoint

Außerkraftsetzung für die Anzeige eines weißen Punkts. 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 unterstützt wird, die in einem zehntausendstel Nissen gemessen wird. Nur gültig, wenn MaxLuminance ungleich Null ist. Null ist ein gültiger Wert.

MaxLuminance

Überschreiben Sie den maximalen Leuchtdichtewert, der von der Anzeige unterstützt wird, die in einem zehntausendstel Nissen gemessen wird. Diese Leuchtdichte wird voraussichtlich nur für einen relativ kleinen Bereich in einem bestimmten Frame unterstützt.
Null gibt keine Außerkraftsetzung von MaxLuminance, MaxFullFrameLuminance oder MinLuminance an.

MaxFullFrameLuminance

Überschreibung für den maximalen Vollbild-Leuchtdichtewert, der von der Anzeige unterstützt wird, gemessen in einem zehntausendstel Nissen. Diese Leuchtdichtestufe muss für jedes Pixel im Frame gleichzeitig unterstützt werden, um eine Schätzung des durchschnittlichen Leuchtdichtewerts bereitzustellen, der von der Anzeige über einen Frame hinweg unterstützt werden kann. Nur gültig, wenn MaxLuminance ungleich Null 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 Drahtformate angegeben sind. Mindestens ein Bit muss festgelegt werden, wobei das Feld "Einstellung" ausgeschlossen wird, das reserviert ist und null sein muss.

StandardColorimetryFlags

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

Bemerkungen

Diese Struktur wird sowohl zum Abfragen von Außerkraftsetzungen vom Treiber verwendet, als auch für das Betriebssystem, das den endgültigen Satz von Werten meldet, die er ausgewählt hat. Außerkraftsetzungen werden für integrierte Displays mithilfe dieser Struktur unterstützt, die in die DXGK_QUERYINTEGRATEDDISPLAYOUT Struktur eingebettet ist, und für externe Displays, 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 ausgefüllt werden, oder der Puffer bleibt null, um die Komplexität des Zusammenführens dieser miteinander verbundenen Attribute aus verschiedenen Quellen zu vermeiden. Wenn die Struktur nicht vollständig null ist, überprüft das Betriebssystem, dass Felder, die nicht null sein dürfen, wie oben erwähnt, keine Null sind.

Die Farbpunkte werden über eine einfache Sanity-Prüfung hinaus überprüft (jeder Wert muss zwischen 1 und 1023 liegen), um angemessene Werte sicherzustellen, indem die Koordinaten der einzelnen Punkte mit den Standardpunkten verglichen und sichergestellt werden, dass keiner zu weit vom Standard entfernt ist.

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

Anforderungen

Anforderung	Wert
Header-	d3dkmddi.h