KSPROPERTY_CAMERACONTROL_EXTENDED_OIS

KSPROPERTY_CAMERACONTROL_EXTENDED_OIS 是一个属性 ID,用于控制驱动程序上的 OIS) (光学图像防抖动。

使用情况摘要表

范围 控制 类型

版本 1

筛选器

同步

以下标志可以放在 KSCAMERA_EXTENDEDPROP_HEADER中。用于 控制光学图像防抖动的标志字段。 如果支持 AUTO,则默认值应为 AUTO;否则,默认值应为 ON。

#define KSCAMERA_EXTENDEDPROP_OIS_OFF   0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_OIS_ON    0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_OIS_AUTO  0x0000000000000002 

如果驱动程序支持此控件,它必须支持OIS_ON和OIS_OFF。

如果驱动程序不支持光学图像防抖动,则驱动程序不应实现此控制。

当视频或照片图钉处于KSSTATE_RUN状态时,此控件的 SET 调用不起作用。 如果视频或照片引脚处于运行状态并返回STATUS_INVALID_DEVICE_STATE,驱动程序应拒绝收到的 SET 呼叫。 在 GET 调用中,驱动程序应在“标志”字段中返回当前设置。

下表描述了标志功能。

标志 描述

KSCAMERA_EXTENDEDPROP_OIS_OFF

这是一项必需的功能。 指定后,驱动程序中将禁用光学图像防抖动。

KSCAMERA_EXTENDEDPROP_OIS_ON

这是一项必需的功能。 指定后,驱动程序中会启用光学图像防抖动。 此标志与 OIS_AUTO 和 OIS_OFF 标志互斥。

KSCAMERA_EXTENDEDPROP_OIS_AUTO

此功能是可选的。 指定后,支持此类功能的驱动程序将确定是应打开还是关闭光学图像防抖动。 此标志与 OIS_ON 和 OIS_OFF 标志互斥。

下表包含使用 控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的说明和要求。

成员 说明

版本

此值必须为 1。

PinId

这必须KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。

大小

这必须是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。

结果

指示上次 SET 操作的错误结果。 如果未执行 SET 操作,则必须为 0。

功能

必须是上面定义的受支持KSCAMERA_EXTENDEDPROP_OIS_* 标志的按位 OR。

Flags

这是一个读/写字段。 这可以是上面定义的任意一个KSCAMERA_EXTENDEDPROP_OIS_* 标志。

要求

标头

Ksmedia.h