KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

此属性提供相机处于照片序列模式时的最大捕获帧速率。

使用情况摘要表

Get	Set	目标	属性描述符类型	属性值类型
是	是	Pin	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

操作数据) (属性值包含 KSCAMERA_EXTENDEDPROP_HEADER 结构和 KSCAMERA_EXTENDEDPROP_VALUE 结构。 以每秒帧数为单位的最大照片帧速率以 KSCAMERA_EXTENDEDPROP_VALUE的值进行设置或返回。

此属性KSCAMERA_EXTENDEDPROP_HEADER的Flags 成员中没有设置任何标志。

总属性数据大小为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成员设置为此总属性数据大小。

此属性控件是异步的，不可取消。

注解

响应KSPROPERTY_TYPE_GET请求时，驱动程序会将 KSCAMERA_EXTENDEDPROP_HEADER 的成员设置为以下内容。

成员	Value
版本	1
PinId	照片大头针的 PIN ID。
大小	sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE)
结果	尝试读取最大帧速率时产生的错误值。 否则为 0。
功能	KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Flags	0

帧速率值在 KSCAMERA_EXTENDEDPROP_VALUE 的 Ratio 成员中设置。 Ratio.HighPart 包含帧速率的分子， Ratio.LowPart 包含帧速率的分母。

当驱动程序处于照片序列模式时，可能需要限制照片捕获的最大帧速率。 这是为了确保具有一定数量的历史记录帧的“时刻”捕获方案包含在配置的时间跨度内。 例如，根据内存约束，如果应用程序希望捕获 1 秒的过去历史记录，则需要限制捕获速率，以便只需要 N 个帧。

设置后，驱动程序必须使用提供的帧速率，即使相机可以捕获帧速度快于请求的帧速率。 如有必要，驱动程序可以删除额外的帧以适应请求的速率。

将 HighPart 的最大帧速率值设置为 0 (0，将 Ratio) 的 LowPart 设置为 0 可清除驱动程序中的最大帧速率设置，其效果与要求驱动程序尽快提供帧相同。 将帧速率设置为 0 后，任何后续查询都将返回相机驱动程序可能的最大帧速率值。

要求

版本	从Windows 8.1开始可用。
标头	Ksmedia.h (包括 Ksmedia.h)