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

KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE

  • Статья

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

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

Получить 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_FRAMERATE_THROTTLE_OFF Регулирование кадра отключено.
KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON Режим регулирования кадров включен.

Элемент флагов KSCAMERA_EXTENDEDPROP_HEADER содержит флаг, установленный в настоящее время для камеры. KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF должно быть значением по умолчанию.

Этот элемент управления свойством синхронен и не может быть отменен.

Этот элемент управления применяется только во время активной потоковой передачи камеры. Для активной потоковой передачи означает, что предварительный просмотр или закрепление записей должно находиться в KSSTATE_RUN, готовых и способных доставлять кадры. Если поток не активен, этот элемент управления должен возвращать STATUS_INVALID_DEVICE_STATE. Даже если это элемент управления "Фильтр область", это не должно влиять на фото-закрепление или потоки без RGB, такие как IR/глубина.

Замечания

Получение свойства

При реагировании на запрос KSPROPERTY_TYPE_GET драйвер задает членам KSCAMERA_EXTENDEDPROP_HEADER следующее.

Элемент Значение
Версия 1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Размер Должен быть sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)
Результат Должно быть равно 0. Это поле используется для возврата результата последней операции SET.
Возможность KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON или 0x1
Флаги Это может быть KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON или KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF.

Если ранее флаг регулирования не установлен, драйвер устанавливает флаги для KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF. Члены структуры KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING, которая соответствует KSCAMERA_EXTENDEDPROP_HEADER, задаются в соответствии с требованиями режима регулирования кадров.

Установка свойства

Если свойство задано, запрос KSPROPERTY_TYPE_SET элемент Flags KSCAMERA_EXTENDEDPROP_HEADER содержит режим регулирования кадров для задания. Элемент VideoProc.Value KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING должен игнорироваться, если флаги содержат флаг KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF.

Структура полезных данных

В следующей таблице содержатся описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING для DDI частоты кадров. Эта структура определена в ksmedia.h.

Элемент Description
Режим Это неиспользуемое и должно быть 0.
Min/Max/Step Максимальное значение должно быть 100, указывающее, что скорость кадров не изменяется. Шаг должен быть коэффициентом 100, таким образом, чтобы max % Step == 0. Минимальное значение должно быть равно по крайней мере одному размеру шага или крату размера шага. Мин не может быть 0.
VideoProc VideoProc.Value.ul должен указать процент коэффициента масштабирования для этого элемента управления. Это значение должно находиться в диапазоне min и Max, и оно должно быть задано на несколько значений шага.
Задав это значение соответствующим образом, приложение может убедиться, что новая частота кадров никогда не превышает исходное значение, а также не переходит к нулю. Например, если задать значение 80, частота кадров составляет 80 % от исходной частоты кадров.
Зарезервировано Это не используется. Это должно игнорироваться драйвером.

Требования

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

Заголовок: ksmedia.h (include Ksmedia.h)

См. также

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING