KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE
曝光控制属性指定是自动处理曝光,还是使用手动时间值。
使用情况摘要表
获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 | 是 | 筛选器 | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
属性值(操作数据)包含 KSCAMERA_EXTENDEDPROP_HEADER 结构和 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 结构。
总属性数据大小为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)。 KSCAMERA_EXTENDEDPROP_HEADER 的 Size 成员被设置为此总属性数据大小。
KSCAMERA_EXTENDEDPROP_HEADER 中的 Capability 成员包含以下一个或多个视频处理选项的按位 OR 组合。
处理模式 | 说明 |
---|---|
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | 摄像头驱动程序使用自己的视频处理逻辑。 |
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | 摄像头驱动程序使用预设的处理方法。 |
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | 当前视频处理方法已被锁定。 |
KSCAMERA_EXTENDEDPROP_HEADER 的 Flags 成员包含当前为摄像头设置的视频处理标志。 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 设置可与 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 结合使用。
此属性控制是异步的且可取消。
注解
处理模式
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
这表示支持自动处理。 驱动程序将利用其内部逻辑来优化视频处理。 对于 KSPROPERTY_TYPE_GET 请求,KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 的 VideoProc 成员必须包含驱动程序为视频处理确定的当前值。
此标志可与 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_HEADER 的 Flags 成员将包含要设置的曝光模式。 当 Flags 包含 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 模式标志时,必须忽略 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 的 VideoProc.Value 成员。
要求
版本:从 Windows 8.1 开始提供
头文件:ksmedia.h(包括 Ksmedia.h)