KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE
此属性提供相机在照片序列模式下的最大捕获帧速率。
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
是 |
是 |
Pin |
操作数据 (属性值) 包含KSCAMERA_EXTENDEDPROP_HEADER结构KSCAMERA_EXTENDEDPROP_VALUE结构。 以每秒帧数表示的最大照片帧速率设置为或以值KSCAMERA_EXTENDEDPROP_VALUE。
此属性的 Flags 成员中未设置KSCAMERA_EXTENDEDPROP_HEADER标志。
总属性数据大小为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 属性的 Size 成员KSCAMERA_EXTENDEDPROP_HEADER设置为此总属性数据大小。
此属性控件是异步的，不可取消。
备注
响应请求KSPROPERTY_TYPE_GET，驱动程序将 KSCAMERA_EXTENDEDPROP_HEADER的成员设置 如下。
| 成员 | “值” |
|---|---|
| 版本 | 1 |
| PinId | 照片引脚的引脚 ID。 |
| 大小 | sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) |
| 结果 | 尝试读取最大帧速率后生成的错误值。 否则为 0。 |
| 功能 | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL |
| Flags | 0 |
帧速率值在帧速率的 Ratio 成员中 KSCAMERA_EXTENDEDPROP_VALUE。 Ratio.HighPart 包含帧速率的分子， Ratio.LowPart 包含帧速率的分母。
当驱动程序在照片序列模式下时，可能需要限制照片捕获的最大帧速率。 这是为了确保在配置的时间范围内包含具有一定数量的历史记录帧的"时刻"捕获方案。 例如，根据内存约束，如果应用程序希望捕获过去 1 秒的历史记录，则有必要限制捕获速率，以便只需要 N 个帧。
设置后，驱动程序必须使用提供的帧速率，即使相机可以比请求速率快速捕获帧。 如有必要，驱动程序可以丢弃额外的帧以适应请求的速率。
将 HighPart 的最大帧速率值设置为 0 (0，将 Ratio) 的 LowPart 设置为 0 会清除驱动程序中的最大帧速率设置，并且与要求驱动程序尽快提供帧具有相同的效果。 将帧速率设置为 0 后，任何后续查询都将返回相机驱动程序可能的最大帧速率值。
要求
版本 |
从开始Windows 8.1。 |
标头 |
Ksmedia.h (包括 Ksmedia.h) |