KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE

"白平衡模式" 属性指定是否对白平衡进行自动处理或改用手动温度值。

使用情况摘要表

获取 设置 目标 属性描述符类型 属性值类型
筛选器 KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

属性值 (操作数据) 包含 KSCAMERA_EXTENDEDPROP_HEADER 结构和 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 结构。

属性数据的总计大小为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) 。 KSCAMERA_EXTENDEDPROP_HEADERSize成员设置为此总属性数据大小。

KSCAMERA_EXTENDEDPROP_HEADER功能成员包含以下一个或多个视频处理选项的按位 "或" 组合。

处理模式 说明
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 照相机驱动程序使用其自己的视频处理逻辑。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL 照相机驱动程序使用预设处理方法或基于温度的方法。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 当前视频处理方法已锁定。

KSCAMERA_EXTENDEDPROP_HEADERFlags成员包含当前为相机设置的视频处理标志。 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 设置可能与 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 组合在一起。

此属性控件是异步的,不可取消。

备注

处理模式

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
这表示支持自动处理。 驱动程序将使用其内部逻辑来优化视频处理。 对于KSPROPERTY_TYPE_GET请求, KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTINGVideoProc成员必须包含当前驱动程序确定的视频处理值。 如果是白平衡,则必须包含当前的开氏温度。 自动操作将忽略 模式 成员。

此标志可能与 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 作为按位 "或" 值组合。 锁定后,照相机驱动程序的预期行为是聚合到白平衡上,并将白色余额值锁定为聚合值,而不是再次尝试自动余额,直到收到新的白平衡命令。

锁定,如果不结合使用自动模式,照相机驱动程序应将已锁定的控件视为不能操作。 锁定与 Auto 模式结合使用时,已锁定的控件应会触发新的聚合。

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
手动指示对于此视频处理,提供了特定的值。 在达到白平衡的情况下,如果KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING模式成员指示KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE,则VideoProc将包含温度值(开氏度)。

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 锁定选项标志指示当前视频处理锁定为当前编程的任何值。 例如,应用程序可能会请求 "自动" 模式,直到确定特定的白余额为止,此时应用程序会决定采用一系列具有相同白平衡设置的照片。 在这种情况下,应用程序可以指定 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 标志。 照相机驱动程序将确保白余额信息不会在不同照片上更改。

获取属性

响应 KSPROPERTY_TYPE_GET 请求时,驱动程序会将 KSCAMERA_EXTENDEDPROP_HEADER 的成员设置为以下项。

成员 “值”
版本 1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)
结果 0
功能 支持 (视频处理模式 KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL 或)
Flags 当前视频处理模式。

如果以前未设置白平衡模式,则驱动程序会将 标志 设置为 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (默认) 。 按照处理模式的要求设置KSCAMERA_EXTENDEDPROP_HEADER后面的KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING结构的成员。

设置属性

当属性设置为 KSPROPERTY_TYPE_SET 请求时, KSCAMERA_EXTENDEDPROP_HEADERFlags成员将包含要设置的白平衡模式。 当Flags包含 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 模式标志时,必须忽略KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTINGVideoProc成员。

要求

版本:可用开始 Windows 8。1

标头: ksmedia (包含 ksmedia)

另请参阅

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING

KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE