структура 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

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

MaxLuminance

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

MaxFullFrameLuminance

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

FormatBitDepths

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

StandardColorimetryFlags

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

Комментарии

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

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

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

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

Требования

Требование	Значение
Заголовок	d3dkmddi.h