KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

  • Статья

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

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

Get Set целевого объекта Тип дескриптора свойства Тип значения свойства

Да

Да

Pin

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

Значение свойства (данные операции) содержит структуру KSCAMERA_EXTENDEDPROP_HEADER и структуру KSCAMERA_EXTENDEDPROP_VALUE . Максимальная частота кадров в кадрах в секунду устанавливается или возвращается в качестве значения в KSCAMERA_EXTENDEDPROP_VALUE.

Для этого свойства в элементе Flags KSCAMERA_EXTENDEDPROP_HEADER не заданы флаги.

Общий размер данных свойства равен sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Элементу SizeKSCAMERA_EXTENDEDPROP_HEADER присваивается этот общий размер данных свойства.

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

Комментарии

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

Член Значение
Версия 1
PinId Идентификатор закрепления для закрепления фотографии.
Размер

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) +

sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Результат

Значение ошибки, возникающее при попытке считывания максимальной частоты кадров.

В противном случае флагу присваивается значение 0.
Функция KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Флаги 0

Значение частоты кадров задается в элементе RatioKSCAMERA_EXTENDEDPROP_VALUE. Ratio.HighPart содержит числитель частоты кадров, а Ratio.LowPart — знаменатель частоты кадров.

Если драйвер находится в режиме последовательности фотографий, может потребоваться ограничить максимальную частоту кадров для захвата. Это необходимо для того, чтобы сценарии записи "момент во времени" с определенным количеством кадров журнала содержали в пределах настроенного интервала времени. Например, в зависимости от ограничений памяти, если приложение хочет захватить 1 секунду прошлого журнала, необходимо ограничить частоту захвата, чтобы было необходимо только N кадров.

Если этот параметр задан, драйвер должен использовать частоту кадров, даже если камера может быстро захватывать кадры, а затем запрашиваемую скорость. При необходимости драйвер может удалить дополнительные кадры в соответствии с запрошенной скоростью.

Установка максимального значения частоты кадров равным 0 (0 для HighPart и 0 для LowPart коэффициента) очищает параметр максимальной частоты кадров в драйвере и имеет тот же эффект, что и предложение драйверу предоставить кадры как можно быстрее. После установки частоты кадров равным 0 любой последующий запрос вернет значение максимально возможной частоты кадров для драйвера камеры.

Требования

Версия

Доступно начиная с Windows 8.1.

Заголовок

 Ksmedia.h (включая Ksmedia.h)