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)