KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE
此属性提供相机处于照片序列模式时的最大捕获帧速率。
使用情况摘要表
| Get | Set | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
是 |
是 |
Pin |
操作数据) (属性值包含 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) |