структура DXVAHDDDI_BLT_STATE_OUTPUT_COLOR_SPACE_DATA (d3dumddi.h)

Структура DXVAHDDDI_BLT_STATE_OUTPUT_COLOR_SPACE_DATA описывает данные, указывающие цветовое пространство выходных данных.

Синтаксис

typedef struct _DXVAHDDDI_BLT_STATE_OUTPUT_COLOR_SPACE_DATA {
  union {
    struct {
      UINT Usage : 1;
      UINT RGB_Range : 1;
      UINT YCbCr_Matrix : 1;
      UINT YCbCr_xvYCC : 1;
      UINT Nominal_Range : 2;
      UINT Reserved : 26;
    };
    [in] UINT Value;
  };
} DXVAHDDDI_BLT_STATE_OUTPUT_COLOR_SPACE_DATA;

Члены

[in] Usage

Значение UINT, указывающее, должно ли устройство декодирования выполнять воспроизведение видео (например, показ на экране) или обработку видео (например, редактирование или создание видео). Драйвер может выполнить оптимальное преобразование цвета на основе контекста устройства вывода. Значение по умолчанию равно нулю, что указывает на воспроизведение видео.

Задание этого элемента эквивалентно установке первого бита 32-разрядного элемента Value (0x00000001).

[in] RGB_Range

Значение UINT, указывающее, является ли вывод полным диапазоном RGB (то есть от 0 до 255) или rgb с ограниченным диапазоном (то есть от 16 до 235). Значение по умолчанию равно нулю, что указывает на полный диапазон RGB.

Задание этого элемента эквивалентно установке второго бита 32-разрядного элемента Value (0x00000002).

[in] YCbCr_Matrix

Значение UINT, указывающее, является ли выход BT.601 (для стандартного цифрового телевидения) или BT.709 (для телевидения высокой четкости). Значение по умолчанию равно нулю, что указывает на BT.601.

Задание этого элемента эквивалентно установке третьего бита 32-разрядного элемента Value (0x00000004).

[in] YCbCr_xvYCC

Значение UINT, указывающее, является ли выход обычным YCbCr или расширенным YCbCr (xvYCC). Значение по умолчанию равно нулю, что указывает на обычный YCbCr.

Задание этого элемента эквивалентно установке четвертого бита 32-разрядного элемента Value (0x00000008).

[in] Nominal_Range

Значение UINT, указывающее, что диапазон яркости данных YUV описывается перечислением DXVAHDDDI_NOMINAL_RANGE . Значение по умолчанию равно нулю, что указывает на диапазон яркости студии от 16 до 255 включительно [16, 235].

Дополнительные сведения о диапазоне яркости см. в разделе Диапазоны форматов YUV в Windows 8.1.

Задание этого элемента эквивалентно установке пятого и шестого битов 32-разрядного элемента Value (0x00000030).

Поддерживается начиная с Windows 8.1.

[in] Reserved

Зарезервировано. Должен равняться нулю.

Этот элемент эквивалентен оставшимся 26 битам (0xFFFFFFC0) 32-разрядного элемента Value .

[in] Value

32-разрядное значение, описывающее цветовое пространство выходных данных.

Комментарии

Если драйвер не задает значение DXVAHDDDI_DEVICE_CAPS_xvYCC в элементе DeviceCaps структуры DXVAHDDDI_VPDEVCAPS при вызове функции GetCaps драйвера с заданным значением D3DDDICAPS_DXVAHD_GETVPDEVCAPS, выходные данные игнорируют элемент YCbCr_xvYCC .

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

Приложение должно задать элемент Usage таким образом, чтобы драйвер смог выполнить оптимальное преобразование цвета. Если для параметра "Использование" задано воспроизведение видео (Usage=0), драйвер может использовать сложный алгоритм для максимальной эффективности презентации (например, для максимального увеличения динамического диапазона при сохранении супер белого цвета используется управление автоматическим получением или динамическое гамма-сопоставление). Если для параметра использования задана обработка видео (Usage=1), драйвер должен принять значения, заданные в других элементах DXVAHDDDI_BLT_STATE_OUTPUT_COLOR_SPACE_DATA, и выполнить преобразование точно так, как указано в других элементах.

Выходные данные RGB могут находиться вне диапазона [0,0, 1,0] ([0, 255] при использовании 8-разрядной презентации) в том случае, если выходной тип RGB имеет формат широкого диапазона (например, формат XR_BIAS, FP16 или FP32). Особенно если входной поток расширен YCbCr (xvYCC), диапазон выходных данных RGB становится шире цветового пространства sRGB.

Требования

Требование	Значение
Минимальная версия клиента	DXVAHDDDI_BLT_STATE_OUTPUT_COLOR_SPACE_DATA поддерживается начиная с операционной системы Windows 7.
Верхняя часть	d3dumddi.h (включая D3dumddi.h)

См. также раздел

DXVAHDDDI_NOMINAL_RANGE

DXVAHDDDI_VPDEVCAPS

GetCaps