KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE
Свойство режима белого баланса указывает, выполняется ли автоматическая обработка для баланса белого цвета или используется ли вместо этого значение температуры вручную.
Сводная таблица использования
| Получить | Set | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
| Да | Да | Фильтр | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
Значение свойства (данные операции) содержит структуру KSCAMERA_EXTENDEDPROP_HEADER и структуру KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.
Общий размер данных свойств — sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Для элемента размера KSCAMERA_EXTENDEDPROP_HEADER задан общий размер данных свойств.
Элемент возможности KSCAMERA_EXTENDEDPROP_HEADER содержит побитовое сочетание ИЛИ одного или нескольких следующих вариантов обработки видео.
| Режим обработки | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | Камера драйвер использует собственную логику обработки видео. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | Камера драйвер использует предварительно настроенный метод обработки или метод на основе температуры. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | Текущий метод обработки видео заблокирован. |
Элемент Flags KSCAMERA_EXTENDEDPROP_HEADER содержит флаг обработки видео, установленный в настоящее время для камеры. Параметр KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO может сочетаться с KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
Этот элемент управления свойством является асинхронным и не может быть отменен.
Замечания
Режимы обработки
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
Это означает, что поддерживается автоматическая обработка. Драйвер будет использовать внутреннюю логику для оптимизации обработки видео. Для запроса KSPROPERTY_TYPE_GET элемент VideoProc KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING должен содержать текущее значение драйвера для обработки видео. В случае белого баланса он должен содержать текущую температуру в Келвине. Элемент Mode игнорируется для автоматической операции.
Этот флаг может сочетаться с KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK как побитовое значение OR. При блокировке ожидаемое поведение драйвера камеры заключается в конвергентном балансе и блокировке значения баланса в конвергентном значении, а не попытке повторного автосбаланса, пока не будет получена новая команда балансировки белого баланса.
Блокировка без объединения автоматического режима, уже заблокированный элемент управления должен рассматриваться как no-op драйвером камеры. Блокировка, в сочетании с автоматическим режимом, уже заблокированный элемент управления должен активировать новую конвергенцию.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Вручную указывает, что для этой обработки видео предоставляются определенные значения. Если элемент режима KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING указывает KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE, значение температуры VideoProc.Value.ul будет содержать значение температуры в градусах Кельвин.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK Флаг параметра блокировки указывает, что текущая обработка видео заблокирована для любого значения, запрограммированного в данный момент. Например, приложение может запрашивать автоматический режим до тех пор, пока не будет определен определенный баланс белого цвета, в этом случае приложение решит принять последовательность фотографий с одинаковым параметром балансировки белого баланса. В таком случае приложение может указать флаг KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK . Драйвер камеры гарантирует, что информация о балансе белого баланса не изменяется на разных фотографиях.
Получение свойства
При реагировании на запрос KSPROPERTY_TYPE_GET драйвер задает членам KSCAMERA_EXTENDEDPROP_HEADER следующее.
| Элемент | Значение |
|---|---|
| Версия | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Размер | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| Результат | 0 |
| Возможность | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL OR с (поддерживается режим обработки видео) |
| Флаги | Текущий режим обработки видео. |
Если ранее режим балансировки белого баланса не был установлен, драйвер устанавливает флаги для KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (по умолчанию). Члены структуры KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING, которая следует KSCAMERA_EXTENDEDPROP_HEADER, задаются в соответствии с требованиями режима обработки.
Задание свойства
Если свойство задано, запрос KSPROPERTY_TYPE_SET, член флагов KSCAMERA_EXTENDEDPROP_HEADER будет содержать режим балансировки белого баланса для задания. Элемент VideoProc.Value KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING должен игнорироваться, если флаги содержат флаг режима KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.
Требования
Версия: доступна начиная с Windows 8.1
Заголовок: ksmedia.h (include Ksmedia.h)