KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (应用程序性能策略)
相机驱动程序可以根据应用程序提供的提示优化其捕获操作。 此属性通知驱动程序根据可能最常使用的操作设置其性能策略。 例如,在针对照片进行优化时,相机驱动程序可能会对传感器进行编程,以优化传感器曝光速度和分辨率,以降低从照片捕获触发器到图像捕获的延迟。 同样,在针对视频进行优化时,相机驱动程序可能会将传感器编程为更高的帧速率,但分辨率较低。
使用情况摘要表
Get | Set | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 | 是 | 筛选器 | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
操作数据) (属性值包含 KSCAMERA_EXTENDEDPROP_HEADER 结构和 KSCAMERA_EXTENDEDPROP_VALUE 结构。
总属性数据大小为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成员设置为此总属性数据大小。
KSCAMERA_EXTENDEDPROP_HEADER 的 Capability 成员包含以下一个或多个优化提示的按位 OR 组合。
优化提示 | 说明 |
---|---|
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO | 相机操作已针对照片进行优化 |
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO | 相机操作已针对视频进行优化 |
KSCAMERA_EXTENDEDPROP_HEADER 的 Flags 成员包含当前为相机设置的优化, (一个值) 。
默认优化类型为KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO。 如果相机驱动程序支持此属性,则必须支持这两种优化类型。
此属性控件是同步的,不可取消。
注解
优化模式
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO
所有相机驱动程序都必须处于此模式,直到明确通知使用KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO模式。 此模式的目的是优化照片操作的相机硬件。 在此模式下,视频操作必须仍然有效。
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO
此模式指示相机可能用于视频操作。 相机驱动程序应针对此模式的视频操作优化硬件。 照片操作必须正常运行,但资源使用优先级适用于视频操作。
获取 属性
响应KSPROPERTY_TYPE_GET请求时,驱动程序会将 KSCAMERA_EXTENDEDPROP_HEADER 的成员设置为以下内容。
成员 | Value |
---|---|
版本 | 1 |
PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
大小 | sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) |
结果 | 0 |
功能 | 支持的优化值 |
Flags | 当前优化值设置 |
如果以前未设置优化模式,驱动程序会将 Flags 设置为KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (默认) 。
设置属性
设置 属性时,KSPROPERTY_TYPE_SET请求,KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成员将包含要设置的优化模式。
要求
版本:从Windows 8.1开始可用
头: Ksmedia.h (包括 Ksmedia.h)