KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (стратегия производительности приложений)
Драйверы камер могут оптимизировать свою операцию захвата на основе указаний, предоставляемых приложением. Это свойство сообщает драйверу, что нужно задать стратегию производительности в зависимости от того, какая операция, скорее всего, используется чаще всего. Например, при оптимизации для фотографии драйвер камеры может запрограммировать датчик для оптимизации скорости экспозиции и разрешения датчика для снижения задержки от триггера фотосъемки до захвата изображения. Аналогичным образом, при оптимизации для видео драйвер камеры может запрограммить датчик для более высокой частоты кадров, но с более низким разрешением.
Сводная таблица использования
| 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_OPTIMIZATION_PHOTO | Работа с камерой оптимизирована для фотографий |
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO | Работа с камерой оптимизирована для видео |
Элемент FlagsKSCAMERA_EXTENDEDPROP_HEADER содержит оптимизацию, заданную в данный момент для камеры (одно значение).
Тип оптимизации по умолчанию — KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO. Если это свойство поддерживается драйвером камеры, то должны поддерживаться оба типа оптимизации.
Этот элемент управления свойством является синхронным и не может быть отменен.
Комментарии
Режимы оптимизации
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO
Все драйверы камеры должны находиться в этом режиме до тех пор, пока явно не будет сообщено об использовании режима KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO. Этот режим предназначен для оптимизации оборудования камеры для операций с фотографиями. Операции с видео должны по-прежнему работать в этом режиме.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO
Этот режим указывает, что камера, скорее всего, будет использоваться для операций с видео. Драйвер камеры должен оптимизировать оборудование для работы с видео в этом режиме. Операции с фотографиями должны быть функциональными, но для операций с видео приоритетом является использование ресурсов.
Получение свойства
При ответе на запрос KSPROPERTY_TYPE_GET драйвер задает членам KSCAMERA_EXTENDEDPROP_HEADER следующее.
| Член | Значение |
|---|---|
| Версия | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Размер | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Результат | 0 |
| Функция | Поддерживаемые значения оптимизации |
| Флаги | Текущее значение оптимизации |
Если ранее не был задан режим оптимизации, драйвер устанавливает для параметра Флаги значение KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (по умолчанию).
Задание свойства
Если свойство задано, запрос KSPROPERTY_TYPE_SET элемент FlagsKSCAMERA_EXTENDEDPROP_HEADER будет содержать заданный режим оптимизации.
Требования
Версия: Доступно, начиная с Windows 8.1
Заголовка: Ksmedia.h (включая Ksmedia.h)