KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED — это расширенный элемент управления свойствами, который обеспечивает более глобальный контроль ISO с большей степенью детализации.
Сводная таблица использования
| Область | Control | Тип |
|---|---|---|
версия 1 |
Закрепление (фото) |
Асинхронный |
Новый флаг KSCAMERA_EXTENDEDPROP_ISO_MANUAL определен в ksmedia_phone.h следующим образом.
#define KSCAMERA_EXTENDEDPROP_ISO_MANUAL 0x0080000000000000
В следующей таблице приведены описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER для элемента управления KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED.
Windows 8.1 KS_CAMERACONTROL_EXTENDED_ISO остается неизменным без поддержки целочисленного ручного ISO. Драйвер должен поддерживать только новый элемент управления KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED. Если оба этих элемента управления поддерживаются, конвейер по умолчанию будет использовать элемент управления KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED.
Если элемент управления KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED поддерживается, драйвер может объявлять только следующие возможности.
KSCAMERA_EXTENDEDPROP_ISO_AUTO
KSCAMERA_EXTENDEDPROP_ISO_MANUAL
KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Если драйвер объявляет флаг возможности KSCAMERA_EXTENDEDPROP_ISO_MANUAL, он также должен объявлять поддерживаемые диапазоны ISO в значении Min/Max/Step свойства KSCAMERA_EXTENDED_PROP_VIDEOPROCSETTING. Если драйвер объявляет минимальное значение 0 и максимальное значение 0 или значение Шага меньше 1, элемент управления помечается как непригодный для использования и отклоняется конвейером.
Если драйвер поддерживает как KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED, так и KSPROPERTY_CAMERACONTROL_EXTENDED_ISO, драйвер должен объявлять KSCAMERA_EXTENDEDPROP_ISO_AUTO как для KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED, так и для KSPROPERTY_CAMERACONTROL_EXTENDED_ISO. В противном случае оба элемента управления ISO будут помечены как непригодные для использования и отклонены конвейером MF.
Если драйвер объявляет KSCAMERA_EXTENDEDPROP_ISO_MANUAL в KSPROPERTY_CAMERACONTROL_EXTENDED_ISO_ADVANCED и числовые значения KSCAMERA_EXTENDEDPROP_ISO_XXX в KSPROPERTY_CAMERACONTROL_EXTENDED_ISO, числовые значения KSCAMERA_EXTENDEDPROP_ISO_XXX, объявленные в KSPROPERTY_CAMERACONTROL_EXTENDED_ISO, должны находиться в поддерживаемых ручных диапазонах ISO, объявленных KSCAMERA_EXTENDEDPROP_ISO_MANUAL. Кроме того, все числовые значения KSCAMERA_EXTENDEDPROP_ISO_XXX в поддерживаемых диапазонах вручную должны объявляться KSPROPERTY_CAMERACONTROL_EXTENDED_ISO. В противном случае оба элемента управления ISO могут быть помечены как непригодные для использования и отклонены конвейером MF.
Например, возможности любого из следующих типов могут рассматриваться как катастрофический сбой, а управление может быть отклонено конвейером MF.
KSCAMERA_EXTENDEDPROP_ISO_MANUAL (min= 40, max = 240, step = 20), KSCAMERA_EXTENDEDPROP_ISO_50
KSCAMERA_EXTENDEDPROP_ISO_MANUAL (мин= 40, максимум = 240, шаг = 20), KSCAMERA_EXTENDEDPROP_ISO_80
KSCAMERA_EXTENDEDPROP_ISO_MANUAL (min= 40, max = 240, step = 20), KSCAMERA_EXTENDEDPROP_ISO_400
Конвейер MF принимает возможности любого из следующих компонентов.
KSCAMERA_EXTENDEDPROP_ISO_MANUAL (min= 40, max = 240, step = 20), KSCAMERA_EXTENDEDPROP_ISO_80, KSCAMERA_EXTENDEDPROP_ISO_100, KSCAMERA_EXTENDEDPROP_ISO_200
KSCAMERA_EXTENDEDPROP_ISO_MANUAL (мин= 40, максимум = 240, шаг = 20)
KSCAMERA_EXTENDEDPROP_ISO_80, KSCAMERA_EXTENDEDPROP_ISO_200
| Член | Описание |
|---|---|
Версия |
Значение должно быть 1, |
PinId |
Это должен быть идентификатор пин-кода, связанный с закреплением фотографии. |
Размер |
Это должно быть значение sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING), |
Результат |
Содержит результаты последней операции SET. Если операция SET не выполнена, это значение должно быть равным 0. |
Функция |
Это должно быть немного мудрое ИЛИ KSCAMERA_EXTENDEDPROP_ISO_AUTO и/или KSCAMERA_EXTENDEDPROP_ISO_MANUAL, а также флаг KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL. Этот элемент управления должен быть асинхронным. |
Флаги |
Это поле для чтения и записи. Это может быть любой из флагов KSCAMERA_EXTENDEDPROP_ISO_XXX, определенных выше. |
В следующей таблице приведены описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING для ISO DDI. Эта структура определена в ksmedia.h.
| Член | Описание |
|---|---|
Режим |
Этот параметр не используется и должен иметь значение 0. |
Min/Max/Step |
Min/Max/Step содержит минимальное, максимальное значение или приращение скорости ISO вручную, поддерживаемой драйвером камеры. Драйвер должен возвращать их для операций GET, если поддерживается ручной ISO. |
VideoProc |
Если в поле Флаги KSCAMERA_EXTENDEDPROP_HEADER указано MANUAL, в videoProc.Value.ul необходимо указать текущее значение скорости ISO в диапазоне, описанном параметром Min/Max/Step. Если указаны флаги, отличные от manual, для операций SET поле VideoProc игнорируется. Для операций GET драйвер должен всегда возвращать текущую скорость ISO, независимо от того. |
Зарезервировано |
Это не используется. Это должно игнорироваться драйвером. |
Вызов GET
Драйвер должен объявить свою возможность в KSCAMERA_EXTENDEDPROP_HEADER. Возможность и текущий флаг ISO в драйвере в KSCAMERA_EXTENDEDPROP_HEADER. Flags. Если до вызова Get не было выполнено ни один вызов SET, драйвер должен вернуть значение по умолчанию в KSCAMERA_EXTENDEDPROP_HEADER. Флаги.
Если флаг KSCAMERA_EXTENDEDPROP_ISO_MANUAL объявлен в поле Возможности, драйвер должен дополнительно объявить поддерживаемые диапазоны в KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. Min/Max/Step.
Драйвер также должен сообщить о текущей скорости ISO, используемой в KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.Value.ul. Если до вызова GET не было выполнено ни один вызов SET, драйвер должен вернуть текущую скорость ISO в KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.Value.ul.
Вызов SET
The KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.Value.ul содержит нужную целочисленную скорость ISO вручную, если KSCAMERA_EXTENDEDPROP_ISO_MANUAL указана в KSCAMERA_EXTENDEDPROP_HEADER. Флаги.
Если флаг KSCAMERA_EXTENDEDPROP_ISO_AUTO указан в KSCAMERA_EXTENDEDPROP_HEADER. Флаги, KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.Value.ul будет игнорироваться.
Требования
Заголовок |
Ksmedia.h |