KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE
曝光控件属性指定是自动处理曝光还是使用手动时间值。
使用情况摘要表
获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 | 是 | 筛选器 | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
属性值(操作数据)包含KSCAMERA_EXTENDEDPROP_HEADER结构和KSCAMERA_EXTENDEDPROP_VIDEOPROC标准版TTING 结构。
总属性数据大小为 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROC标准版TTING)。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成员设置为此总属性数据大小。
KSCAMERA_EXTENDEDPROP_HEADER的功能成员包含以下一个或多个视频处理选项的按位 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_VIDEOPROC标准版TTING 的 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_VIDEOPROC标准版TTING) |
Result | 0 |
功能 | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL位 OR(支持视频处理模式) |
标记 | 当前视频处理模式 |
如果未设置曝光模式,驱动程序 会将标志 设置为KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO(默认值)。 KSCAMERA_EXTENDEDPROP_HEADER后面的 KSCAMERA_EXTENDEDPROP_VIDEOPROC标准版TTING 结构的成员根据处理模式的要求进行设置。
当 模式KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO时,VideoProp.Value.ull 值必须包含当前曝光设置。
设置属性
设置属性时,KSPROPERTY_TYPE_标准版T 请求,KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成员将包含要设置的曝光模式。 当标志包含KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO模式标志时,必须忽略 KSCAMERA_EXTENDEDPROP_VIDEOPROC标准版TTING 的 VideoProc.Value 成员。
要求
版本: 从 Windows 8.1 开始可用
头文件:ksmedia.h(包括 Ksmedia.h)
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈