KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE
Свойство элемента управления экспозицией указывает, выполняется ли автоматическая обработка для воздействия или используется ли вместо этого значение времени вручную.
Сводная таблица использования
| Получить | Set | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
| Да | Да | Фильтр | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
Значение свойства (данные операции) содержит структуру KSCAMERA_EXTENDEDPROP_HEADER и структуру KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.
Общий размер данных свойств — sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Для элемента размера KSCAMERA_EXTENDEDPROP_HEADER задан общий размер данных свойств.
Элемент возможности KSCAMERA_EXTENDEDPROP_HEADER содержит побитовое сочетание ИЛИ одного или нескольких следующих вариантов обработки видео.
| Режим обработки | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | Камера драйвер использует собственную логику обработки видео. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | Камера драйвер использует предварительно настроенный метод обработки. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | Текущий метод обработки видео заблокирован. |
Элемент Flags KSCAMERA_EXTENDEDPROP_HEADER содержит флаг обработки видео, установленный в настоящее время для камеры. Параметр KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO может сочетаться с KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
Этот элемент управления свойством является асинхронным и отменяемым.
Замечания
Режимы обработки
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
Это означает, что поддерживается автоматическая обработка. Драйвер будет использовать внутреннюю логику для оптимизации обработки видео. Для запроса KSPROPERTY_TYPE_GET элемент VideoProc KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING должен содержать текущее значение драйвера для обработки видео.
Этот флаг может сочетаться с KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK как побитовое значение OR.
Блокировка без объединения автоматического режима, уже заблокированный элемент управления должен рассматриваться как no-op драйвером камеры. Блокировка, в сочетании с автоматическим режимом, уже заблокированный элемент управления должен активировать новую конвергенцию.
Этот флаг не должен сочетаться с KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Вручную указывает, что для этой обработки видео предоставляются определенные значения. Определенные значения предоставляются драйверу.
Этот флаг не должен сочетаться с KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO или KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK
Флаг параметра блокировки указывает, что текущая обработка видео заблокирована на любое значение, которое в настоящее время запрограммировано. Например, приложение может запрашивать автоматический режим до определения определенного воздействия. На этом этапе приложение решит принять последовательность фотографий с одинаковым воздействием. В таком случае приложение может указать флаг KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
Этот флаг не должен сочетаться с KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.
Получение свойства
При реагировании на запрос KSPROPERTY_TYPE_GET драйвер задает членам KSCAMERA_EXTENDEDPROP_HEADER следующее.
| Элемент | Значение |
|---|---|
| Версия | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Размер | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| Результат | 0 |
| Возможность | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL битовой или с (поддерживается режим обработки видео) |
| Флаги | Текущий режим обработки видео |
Если режим экспозиции ранее не был установлен, драйвер устанавливает флаги для KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (по умолчанию). Члены структуры KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING, которая следует KSCAMERA_EXTENDEDPROP_HEADER, задаются в соответствии с требованиями режима обработки.
Значение VideoProp.Value.ull должно содержать текущий параметр экспозиции, если режим KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.
Задание свойства
Если свойство задано, запрос KSPROPERTY_TYPE_SET элемент Flags KSCAMERA_EXTENDEDPROP_HEADER будет содержать заданный режим экспозиции. Элемент VideoProc.Value KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING должен игнорироваться, если флаги содержат флаг режима KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.
Требования
Версия: доступна начиная с Windows 8.1
Заголовок: ksmedia.h (include Ksmedia.h)