KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS — это идентификатор свойства, который позволяет драйверам камеры предлагать несколько фиксированных параметров представления (FoV), которые пользователи могут выбрать на странице Камера параметров или приложениях.
Поле значений представления, сообщаемых в массиве полезных данных KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS , должно быть отсортировано в порядке убывания, например, сначала наибольшее значение.
Все значения поля представления (FoV), сообщаемые KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS , должны поддерживаться во всех доступных типах носителей, которые драйвер выбирает для поддержки.
Драйверы могут выполнять масштабирование и (или) обрезку для достижения foV в определенных разрешениях.
Исключения можно сделать, поддерживая профили Камера и добавляя KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 в качестве BlockedControl. Это приведет к тому, что элемент управления FIELDOFVIEW2 не поддерживается вообще, если профиль, блокирующий его использование.
Сводная таблица использования
| Область | Получить | Set | Элемент управления | Тип |
|---|---|---|---|---|
| версия 1 | Да | Нет | Фильтр | Синхронная |
поля структуры KSCAMERA_EXTENDEDPROP_HEADER
В следующей таблице содержатся требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления.
| Элемент | Description |
|---|---|
| Версия | Должен иметь значение 1. |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Размер | Должен быть sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS) |
| Результат | Должен содержать 0. Это поле используется только для возврата результатов последней асинхронной операции SET. |
| Возможность | Должно быть равно 0. |
| Флаги | Должно быть равно 0. |
полезные данные KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS
Полезные данные после структуры заголовка являются обязательными KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS.
| Параметр | Описание |
|---|---|
| DefaultDiagonalFieldOfViewInDegrees | Поле представления (FoV) по умолчанию. Должно быть одним из значений, сообщаемых в массиве DiscreteFoVStops. |
| DiscreteFoVStopsCount | Количество допустимых записей в ДискретныхFovStops, не более 360, не менее 1. |
| ДискретныеFoVStops | Массив допустимых полей представления (FoV) останавливается, только ДискретНыеFoVStopsCount являются допустимыми элементами. |
| Зарезервировано | Присвойте параметру значение 0. |
Требования
Минимальный поддерживаемый клиент: Windows 11 версии 24H2
Заголовок: ksmedia.h (include Ksmedia.h)