Свойства расширенного элемента управления камеры

Расширенный интерфейс управления камерой, доступный начиная с Windows 8, используется для управления функциями камеры во время захвата изображения. Драйвер может управлять следующими функциями камеры:

• вспышка камеры
• являются ли закрепление изображения и закрепление записи взаимоисключающими
• интересующая область изображения
• стабилизация видео

Драйвер также может асинхронно выполнять операцию управления камерой, то есть все запросы для операции отклоняются до завершения первого запроса. Если драйвер успешно выполнил асинхронные операции управления камерой, он должен активировать событие KSEVENTSETID_CameraAsyncControl . Дополнительные сведения см. в разделе KSPROPERTY_CAMERACONTROL_S_EX .

Приложения UWP могут получить доступ к следующим свойствам для настройки камеры:

Свойства

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
Используется для включения или выключения вспышки камеры или для перехода вспышки в автоматический режим.

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
Используется для определения того, являются ли закрепление изображения и закрепление записи камеры взаимоисключающими.

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
Используется для получения или задания характеристики интересующей области камеры.

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
Используется для получения или задания характеристик стабилизации видео камеры.

Начиная с Windows 8.1 доступны следующие свойства.

Термин	Описание
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE	Используется для получения или установки обычного режима камеры или режима последовательности фотографий.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE	Используется для получения текущей частоты кадров фотосъемки, когда для камеры используется режим последовательности.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE	Используется для получения или установки максимальной частоты кадров захвата для камеры, когда она находится в режиме последовательности фотографий.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME	Используется для получения или задания времени триггера для драйвера камеры.
KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART	Используется для получения или задания состояния горячего запуска (готовности камеры).
KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES	Используется для получения или установки максимально возможной частоты кадров в контактах захвата видео в определенном разрешении.
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL	Используется для получения или задания возможности эскиза для камеры.
KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE	Используется для получения или задания режима, определенного драйвером, который представляет коллекцию предустановленных элементов управления.
KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE	Используется для получения или задания метода, который вспышка камеры используется в условиях низкой освещенности.
KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE	Используется для получения или задания режима вспышки для обычного и последовательного фоторежимов камеры.
KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT	Используется для получения или задания того, выполняется ли автоматическая обработка для баланса белого или для значения температуры вручную.
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE	Используется для получения или задания того, оптимизирована ли камера для работы с фотографиями или видео.
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE	Используется для получения или задания того, выполняется ли автоматическая обработка для раскрытия или используется значение времени вручную.
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE	Используется для получения или настройки автоматического, ручного и предустановленного режимов фокусировки камеры.
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO	Используется для получения или задания предустановленного или автоматического параметра ISO для камеры.
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW	Используется для получения поля зрения и угла наклона позиции камеры.
KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION	Используется для получения или настройки настройки управления экспозицией.
KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET	Используется для получения угла наклона и наклона камеры.

Эти структуры и перечисления поддерживают расширенный интерфейс управления камерой:

Структуры

• KSPROPERTY_CAMERACONTROL_S_EX
• KSPROPERTY_CAMERACONTROL_FLASH_S
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_S
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S
• KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S
• KSCAMERA_EXTENDEDPROP_HEADER
• KSCAMERA_EXTENDEDPROP_VALUE
• KSCAMERA_EXTENDEDPROP_PHOTOMODE
• KSCAMERA_MAXVIDEOFPS_FORPHOTORES
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING
• KSCAMERA_EXTENDEDPROP_FIELDOFVIEW

Перечисления

• KS_CameraControlAsyncOperation
• KSEVENT_CAMERACONTROL
• KSPROPERTY_CAMERACONTROL_FLASH
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST
• KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE

Пример кода драйвера, реализующего этот интерфейс, приведен в разделе Реализация расширенных свойств элемента управления камерой.