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