KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

Статья
06/15/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW — это идентификатор свойства, который указывает поле зрения и масштаб камеры во время потоковой передачи камеры.

Этот элемент управления может заменить сдвиг, наклон и масштабирование. Этот элемент управления применяется только во время активной потоковой передачи камеры. Для активной потоковой передачи означает, что предварительный просмотр или закрепление записей должно находиться в KSSTATE_RUN, быть готовым и способным доставлять кадры.

Если поток неактивен, в SET эти элементы управления возвращают STATUS_INVALID_DEVICE_STATE.

Примеры настройки элементов управления KSPROPERTY можно найти в примере драйвера камеры AVStream на сайте GitHub.

Сводная таблица использования

Область	Control	Тип
версия 1	Фильтр	Синхронная

Следующие битовые флаги управляют идентификатором свойства в драйвере:

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

Описание возможностей

В KSCAMERA_EXTENDEDPROP_HEADER можно разместить следующие флаги . Флаги и KSCAMERA_EXTENDEDPROP_HEADER. Поля возможностей .

Flag	Описание
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	Цифровое окно управляется приложением вручную.
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	Камера автоматически настраивает цифровое окно, чтобы фокусироваться на лице доминанты в поле зрения.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW всегда является синхронным элементом управления.

В следующей таблице приведены требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления метаданными.

Член	Описание
Версия	Должен иметь значение 1.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Размер	Должен иметь значение sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+ sizeof(KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING)
Результат	Должен содержать 0. Это поле используется только для возврата результата последней асинхронной операции SET.
Функция	Должен поддерживать KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL. При необходимости может поддерживать KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.
Флаги	Должен быть KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL или KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

Эти параметры доступны только для чтения, если KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING задано в поле Флаги. Если KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING задано во время операции SET, следующие параметры игнорируются.

Параметр	Описание
OriginX	Источник цифрового окна вдоль оси X в формате Q24. Значение по умолчанию должно иметь значение 0. OriginX не может быть меньше, чем PorchLeft и не больше, чем PorchRight — WindowSize.
OriginY	Источник цифрового окна вдоль оси X в формате Q24. Значение по умолчанию должно иметь значение 0. OriginX не может быть меньше, чем PorchLeft и не больше, чем PorchRight — WindowSize.
WindowSize	Размер цифрового окна вдоль обеих осей в формате Q24. Это доля полного представления, видимая вдоль оси X и Y. WindowSize по умолчанию должен 0x01000000 (1.0 в квартале 24). Значение WindowSize не может быть меньше MinWindowSize и не больше MaxWindowSize. Кроме того, WindowSize плюс OriginX не может быть больше, чем PorchRight; WindowsSize плюс OriginY не может быть больше PorchBottom.
Зарезервировано	Задайте значение 0.