KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO
KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO用于控制驱动程序上的照片 HDR、无闪光灯和超低光融合。 这是仅适用于照片图钉的图钉级别控件。
使用情况摘要表
范围 | 控制 | 类型 |
---|---|---|
版本 1 |
Pin |
同步 |
下面是可以放置在KSCAMERA_EXTENDEDPROP_HEADER中的标志。用于控制照片 HDR、不闪烁和超低光融合的标志字段。 默认值应为KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF。
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR 0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF 0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT 0x0000000000000008
如果驱动程序支持此控件,它必须支持KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF。
如果驱动程序不支持任何高级照片捕获,则驱动程序不应实现此控件。
当照片引脚处于KSSTATE_RUN状态时,此控件的 SET 调用不起作用。 如果照片引脚处于运行状态并返回STATUS_INVALID_DEVICE_STATE,驱动程序应拒绝收到的 SET 调用。 在 GET 调用中,驱动程序应在“标志”字段中返回当前设置。
下表描述了标志功能。
标志 | 描述 |
---|---|
KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF |
这是一项必需的功能。 指定后,不应在驱动程序中执行任何高级照片。 |
KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO |
此功能是可选的。 单独指定时,支持此类功能的驱动程序将基于场景分析确定是应执行照片 HDR、无闪光灯还是超低光融合。 此标志与 OFF 标志互斥,可以与其他标志一起使用。 |
KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR |
此功能是可选的。 如果单独指定,支持此功能的驱动程序将执行照片 HDR。 此标志与其他标志(AUTO 除外)互斥。 与 AUTO 一起指定时,驱动程序将根据场景分析确定是否应执行照片 HDR。 |
KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF |
此功能是可选的。 如果单独指定,支持此功能的驱动程序将执行不闪烁。 此标志与其他标志(AUTO 除外)互斥。 与 AUTO 一起指定时,驱动程序将根据场景分析确定是否应执行不闪烁。 |
KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT |
此功能是可选的。 如果单独指定,支持此类功能的驱动程序将执行超低光融合。 此标志与其他标志(AUTO 除外)互斥。 与 AUTO 一起指定时,驱动程序将根据场景分析确定是否应执行超低光融合。 |
下表包含使用 控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的说明和要求。
成员 | 说明 |
---|---|
版本 |
此值必须为 1。 |
PinId |
必须是与照片图钉关联的固定 ID。 |
大小 |
这必须是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 |
结果 |
指示上次 SET 操作的错误结果。 如果未执行 SET 操作,则必须为 0。 |
功能 |
必须是上面定义的受支持KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* 标志的按位 OR。 |
Flags |
这是一个读/写字段。 这可以是上面定义的KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* 标志中的任何一个。 |
要求
标头 |
Ksmedia.h |