KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

  • Статья

Это расширенное управление свойствами используется клиентом для управления уровнем мощности и циклом работы инфракрасной камеры IR камеры. Он отправляется драйверу вместе со стандартной структурой KSCAMERA_EXTENDEDPROP_HEADER , за которой следует структура KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

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

Get Set целевого объекта Тип дескриптора свойства Тип значения свойства
Да Да Фильтр KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

Комментарии

Запрос свойства содержит структуру KSCAMERA_EXTENDEDPROP_HEADER и структуру KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

Общий размер данных свойства равен sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Элементу SizeKSCAMERA_EXTENDEDPROP_HEADER присваивается этот общий размер данных свойства.

Ниже приведены флаги, которые можно поместить в KSCAMERA_EXTENDEDPROP_HEADER. Флаги и KSCAMERA_EXTENDEDPROP_HEADER. Поля возможностей . Они определяют режимы работы горелки IR.

Режим факела Описание
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF Выключено
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON Always On
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION Включено для каждого другого кадра

KSCAMERA_EXTENDEDPROP_IRTORCHMODE всегда является синхронным элементом управления. Элемент управления не имеет определенного поведения, если камера не выполняет потоковую передачу.

Для запроса GET драйвер задает следующие поля:

  • KSCAMERA_EXTENDEDPROP_HEADER. Возможность с битовой маской указанных выше флагов KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX, представляющих режимы работы, поддерживаемые камерой.
  • KSCAMERA_EXTENDEDPROP_HEADER. Помечает один из указанных выше KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ флаговXX, чтобы указать текущий режим работы.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Режим до 0.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Минимальное значение до минимального доступного уровня питания.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Максимум до максимального доступного уровня питания.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Шаг к минимальному приращению между уровнями питания.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul для текущего уровня питания. По умолчанию для этого значения должен использоваться тот же уровень питания, который обычно используется элементом управления проверкой подлинности для распознавания лиц.

Для запроса SET драйвер использует следующие поля:

  • KSCAMERA_EXTENDEDPROP_HEADER. Флаги для установки режима работы.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul для установки уровня питания. Это значение не влияет на KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF.

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

Член Описание

Версия

Значение должно быть 1.

PinId

KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Размер

Это должно быть значение sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)),

Результат

Это значение не учитывается для синхронных элементов управления.

Функция

Может быть любым сочетанием KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON или KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION. В этом поле должна быть по крайней мере одна возможность. Поле должно сообщать либо KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON, либо KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION, либо и то, и другое. Значение KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF является необязательным.

Флаги

Должен быть одним из флагов, указанных в функции. Значением по умолчанию должно быть KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON или KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION.

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

Член Описание

Режим

Не используется. Должно быть равно 0.

Min/Max/Step

Минимальное значение, максимальное значение или шаг содержит минимальное, максимальное значение или увеличение параметров питания ir. Драйвер должен возвращать их для операций GET. (Max – Min) должен быть равномерно делим по шагам. Шаг может быть не равен нулю (0).

VideoProc

Для операций SET videoProc.Value.ul должен указывать уровень питания в диапазоне, описанном параметром Min/Max/Step. Для операций GET драйвер должен возвращать текущий уровень питания.

Зарезервировано

Не используется. Должен быть проигнорирован драйвером.

Требования

Заголовок

 Ksmedia.h