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 в качестве Заблокированногоcontrol. Это приведет к тому, что элемент управления FIELDOFVIEW2 не поддерживается вообще, если профиль, блокирующий его использование.
Сводная таблица использования
| Область действия | Получить | Установить | Контроль | Тип |
|---|---|---|---|---|
| Версия 1 | Да | Нет | Фильтр | Синхронный |
поля структуры KSCAMERA_EXTENDEDPROP_HEADER
В следующей таблице содержатся требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления.
| Член | Описание |
|---|---|
| Версия | Должно быть 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 (включая Ksmedia.h)