Поделиться через


KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

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.

Требования

Минимальный поддерживаемый клиент: Windows 11

Заголовок: ksmedia.h (включая Ksmedia.h)

См. также раздел

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_CONFIGCAPSHEADER

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

KSCAMERA_METADATA_DIGITALWINDOW