KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR используется для включения или отключения видео с высоким динамическим диапазоном (HDR) в драйвере. Это элемент управления уровня закрепления только для видео закрепления.

Сводная таблица использования

Получить	Присвойте параметру	Назначение	Тип дескриптора свойства
Да	Да	Pin	KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

В KSCAMERA_EXTENDEDPROP_HEADER можно поместить следующие флаги. Поле "Флаги" для управления видео в формате HDR. По умолчанию для драйвера должно быть задано значение VIDEOHDR_OFF.

#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON       0x0000000000000001 
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO     0x0000000000000002 

Если драйвер поддерживает этот элемент управления, он должен поддерживать VIDEOHDR_ON/VIDEOHDR_OFF.

Если драйвер не поддерживает видео HDR, драйвер не должен реализовывать этот элемент управления.

Этот элемент управления служит подсказкой для драйвера. Если задано значение VIDEOHDR_ON, драйвер должен выполнять видео в формате HDR как можно лучше.

Вызов SET этого элемента управления не оказывает влияния, когда видео закрепления KSSTATE_RUN состоянии. Драйвер должен отклонить полученный вызов SET, если видеоклип находится в состоянии выполнения и возвращает STATUS_INVALID_DEVICE_STATE. В вызове GET драйвер должен вернуть текущие параметры в поле Флаги.

В следующей таблице описаны возможности флагов.

Flag	Описание
KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF	Это обязательная возможность. Если этот параметр указан, видео HDR отключается в драйвере, и драйвер не должен выполнять видео HDR в видеопотоке.
KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON	Это обязательная возможность. Если этот параметр указан, видео HDR включается в драйвере, и драйвер должен выполнять видео HDR как можно лучше. Этот флаг является взаимоисключающим с флагами VIDEOHDR_AUTO и VIDEOHDR_OFF.
KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO	Эта возможность является необязательной. Если этот параметр указан, драйвер, поддерживающий такую возможность, определяет, следует ли выполнять видео в режиме HDR на основе анализа сцены. Этот флаг является взаимоисключающим с флагами VIDEOHDR_ON и VIDEOHDR_OFF.

В таблице ниже приведены описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления .

Член	Описание
Версия	Значение должно быть 1.
PinId	Должен быть идентификатором закрепления, связанным с закреплением видео.
Размер	Это должны быть значения sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).
Результат	Указывает результаты ошибки последней операции SET. Если операция SET не выполнена, это должно быть 0.
Функция	Должен быть битовой или для поддерживаемых флагов KSCAMERA_EXTENDEDPROP_VIDEOHDR_*, определенных выше.
Флаги	Это поле для чтения и записи. Это может быть любой из флагов KSCAMERA_EXTENDEDPROP_VIDEOHDR_*, определенных выше.

Требования

Минимальный поддерживаемый клиент: Windows 11

Заголовок: ksmedia.h (включая Ksmedia.h)

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

2.2.2.13. Элемент управления HDR для видео