структура DXGK_COLORIMETRY (d3dkmddi.h)

Описывает цветометрию и тесно связанные поля, используемые для описания переопределений из дескриптора, полученного с устройства отображения.

Синтаксис

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;

Члены

RedPoint

Переопределение для отображения красной точки. Обратите внимание, что каждое измерение — это 10-разрядное значение, хранящееся в наименее значимых битах. Ноль указывает, что переопределение не переопределяется.

GreenPoint

Переопределение для отображения зеленой точки. Обратите внимание, что каждое измерение — это 10-разрядное значение, хранящееся в наименее значимых битах.

BluePoint

Переопределение для отображения синей точки. Обратите внимание, что каждое измерение — это 10-разрядное значение, хранящееся в наименее значимых битах.

WhitePoint

Переопределение для отображения белой точки. Обратите внимание, что каждое измерение — это 10-разрядное значение, хранящееся в наименее значимых битах.

MinLuminance

Переопределяется для минимального значения света, поддерживаемого дисплеем, измеряемым в 10 тысяче нит. Допустимо только в том случае, если MaxLuminance не равно нулю. Ноль является допустимым значением.

MaxLuminance

Переопределяется для максимального значения света, поддерживаемого дисплеем, измеряемым в 10 тысяче нит. Ожидается, что этот уровень яркости поддерживается только для относительно небольшой области в любом заданном кадре.
Ноль указывает на отсутствие переопределения MaxLuminance, MaxFullFrameLuminance или MinLuminance.

MaxFullFrameLuminance

Переопределяется для максимального значения яркости полного кадра, поддерживаемого дисплеем, измеряемым в 10 тысяче нит. Этот уровень света должен поддерживаться по каждому пикселю в кадре одновременно, чтобы обеспечить оценку среднего значения света, которое может поддерживаться отображением в кадре. Допустимо только в том случае, если MaxLuminance не равно нулю. Ноль не является допустимым переопределением.

FormatBitDepths

Переопределяет поддерживаемые биты на канал цвета в каждом из пяти кодировк цветов, указанных для проводных форматов. Необходимо задать по крайней мере один бит, за исключением поля предпочтения, зарезервированного и равно нулю.

StandardColorimetryFlags

Указывает поддержку определенных возможностей цветовой метрии и EOTF с помощью битовых полей.

Замечания

Эта структура используется как для запроса переопределения от драйвера, так и для ос, сообщающей окончательный набор значений, которые он выбрал. Переопределения поддерживаются для интегрированных дисплеев с помощью этой структуры, внедренной в структуру DXGK_QUERYINTEGRATEDDISPLAYOUT и внешних дисплеев, где эта структура используется в качестве выходного буфера для типа запроса адаптера DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES. Выбранные и скорректированные переопределения передаются драйверу с помощью DxgkDdiSetTargetAdjustedColorimetry.

При переопределении запросов ОС требуется, чтобы все поля заполнялись драйвером или буфер остается без нуля, чтобы избежать сложности объединения этих взаимосвязанных атрибутов из разных источников. Если структуру не полностью обнуляется, ОС проверяет, что поля, которые не должны быть нулевыми, как указано выше, не равны нулю.

Точки цвета также проверяются за пределами простой проверки санности (каждое значение должно быть от 1 до 1023) для обеспечения разумных значений, сравнивая координаты каждой точки со стандартными точками и гарантируя, что ни один из них не находится слишком далеко от стандарта.

Когда ОС вызывает DxgkDdiSetTargetAdjustedColorimetry, форматBitDepths и StandardColorimetryFlags ноль, так как это поля возможностей, поэтому допустимы только в запросах.

Требования

Требование	Ценность
заголовка	d3dkmddi.h