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