KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY

KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY 枚举中定义的KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY属性 ID 用于配置焦点优先级。 设置焦点优先级时，焦点优先于拍摄的照片，以确保拍摄的图片始终处于焦点中。 否则，无论图片是否在焦点 中，都将立即拍摄图片。 处理失败的焦点以及是否需要超时的行为是驱动程序内部的，并且由 OEM 决定。

使用情况摘要表

范围	控制	类型
版本 1	筛选器	同步

若要配置焦点优先级，必须使用 KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY 属性 ID。 设置焦点优先级后，对焦将优先于拍摄的照片，以确保拍摄的照片始终处于焦点中。 如果未设置焦点优先级，将立即拍摄图片，而不考虑图片是否处于焦点中。 处理失败的焦点和超时的行为由 OEM 确定，并且是驱动程序内部的。

对于 KSCAMERA_EXTENDEDPROP_HEADER，以下标志定义为值。 在 get 调用中，相机驱动程序使用以下标志之一返回其当前焦点优先级配置。 在集调用中，相机驱动程序使用这些标志之一设置新的焦点优先级配置。

#define KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_OFF     0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_ON      0x0000000000000001

注意 这是一个同步控件，没有为此控件定义任何功能。

下表包含使用焦点优先级控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的说明和要求。

成员	说明
版本	这必须是 1，
PinId	这必须KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) ，
大小	这必须是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) +sizeof (KSCAMERA_EXTENDEDPROP_VALUE) ，
结果	这表示错误结果，
功能	此值必须为 0，
Flags	这是一个读/写字段。 这可以是上面定义的任意一个KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_Xxx标志。

要求

标头

Ksmedia.h