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)