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)

另请参阅

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE