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)