KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE
Режим факела определяет, как используется вспышка камеры в условиях низкой освещенности. Источник света с меньшей интенсивностью постоянно предоставляется вспышкой, чтобы обеспечить достаточно света для таких операций, как автофокус.
Сводная таблица использования
| Get | Set | целевого объекта | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Да |
Фильтр |
Значение свойства (данные операции) содержит структуру KSCAMERA_EXTENDEDPROP_HEADER и структуру KSCAMERA_EXTENDEDPROP_VALUE .
Общий размер данных свойства равен sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Элементу SizeKSCAMERA_EXTENDEDPROP_HEADER присвоен общий размер данных свойства.
Элемент CapabilityKSCAMERA_EXTENDEDPROP_HEADER содержит побитовое или сочетание одного или нескольких следующих режимов факела, поддерживаемых драйвером.
| Режим факела | Описание |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF | Факел выключен. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON | Факел включен на уровне интенсивности по умолчанию. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER | Факел свет включен на определенном уровне мощности. |
Элемент FlagsKSCAMERA_EXTENDEDPROP_HEADER содержит режим факела, установленный в настоящее время для камеры. Режим факела по умолчанию для камеры — KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF и драйвер должен поддерживать этот режим.
Этот элемент управления свойством является синхронным и не может быть отменен.
Комментарии
Получение свойства
При ответе на запрос KSPROPERTY_TYPE_GET драйвер задает для членов KSCAMERA_EXTENDEDPROP_HEADER следующие значения.
| Член | Значение |
|---|---|
| Версия | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF). |
| Размер | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Результат | 0 |
| Функция | Поддерживаются значения режима факела. |
| Флаги | Текущее значение режима факела (только одно значение). |
Если режим факела KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER, элемент Value.ullKSCAMERA_EXTENDEDPROP_VALUE содержит значение уровня интенсивности в диапазоне от 0 до 100. Интенсивность 0 означает минимальный уровень, а интенсивность 100 — максимальный уровень интенсивности.
Если ранее не был задан режим сцены, для флагов устанавливается значение KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF (по умолчанию).
Задание свойства
Если свойство задано, запрос KSPROPERTY_TYPE_SET, элемент FlagsKSCAMERA_EXTENDEDPROP_HEADER будет содержать режим факела для установки. Элемент Value.ullKSCAMERA_EXTENDEDPROP_VALUE будет содержать уровень интенсивности, который необходимо задать, если флаги KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER.
Требования
Версия |
Доступно, начиная с Windows 8.1. |
Заголовок |
Ksmedia.h (включая Ksmedia.h) |