KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE

曝光控制属性指定是自动处理曝光,还是使用手动时间值。

使用情况摘要表

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

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

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

KSCAMERA_EXTENDEDPROP_HEADER 中的 Capability 成员包含以下一个或多个视频处理选项的按位 OR 组合。

处理模式 说明
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 结合使用,作为一个按位 OR 值。

在不结合自动模式的情况下,摄像头驱动程序应将已锁定的控件视为无操作。 结合“自动”模式锁定一个已经锁定的控制器应该会触发新的收敛。

此标志不得与 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL 结合使用。

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL

“手动”表示为该视频处理提供了具体数值。 具体数值会被提供给驱动程序。

此标志不得与 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 或 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 结合使用。

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK

锁定选项标志表示当前视频处理被锁定为当前编程的任何值。 例如,在确定特定曝光之前,应用程序可能会要求使用自动模式。 此时,应用程序将决定拍摄一系列曝光度相同的照片。 在这种情况下,应用程序可以指定 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 标志。

此标志不得与 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL 结合使用。

获取属性

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

成员
版本 1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)
Result 0
功能 KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL 按位或(支持的视频处理模式)
标记 当前视频处理模式

如果之前未设置曝光模式,则驱动程序会将 Flags 设置为 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO(默认值)。 KSCAMERA_EXTENDEDPROP_HEADER 后面的 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 结构的成员根据处理模式的要求进行设置。

当模式为 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 时,VideoProp.Value.ull 值必须包含当前曝光设置。

设置属性

当通过 KSPROPERTY_TYPE_SET 请求设置该属性时,KSCAMERA_EXTENDEDPROP_HEADERFlags 成员将包含要设置的曝光模式。 当 Flags 包含 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 模式标志时,必须忽略 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTINGVideoProc.Value 成员。

要求

版本:从 Windows 8.1 开始提供

头文件:ksmedia.h(包括 Ksmedia.h)

另请参阅

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING