KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE

火炬模式确定相机的闪光灯在弱光条件下的使用方式。 闪光灯持续提供较低强度的光源，以便为自动对焦等操作提供足够的光线。

使用情况摘要表

Get	Set	目标	属性描述符类型	属性值类型
是	是	筛选器	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

操作数据 (属性值) 包含 KSCAMERA_EXTENDEDPROP_HEADER 结构和 KSCAMERA_EXTENDEDPROP_VALUE 结构。

属性数据的总大小为 size 为 (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 KSCAMERA_EXTENDEDPROP_HEADER 的 Size 成员设置为此总属性数据大小。

KSCAMERA_EXTENDEDPROP_HEADER 的 Capability 成员包含驱动程序支持的以下一个或多个火炬模式的按位 OR 组合。

火炬模式	说明
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF	火炬灯已关闭。
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON	Torchlight 处于默认强度级别。
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER	火炬灯处于特定功率级别。

KSCAMERA_EXTENDEDPROP_HEADER 的 Flags 成员包含当前为相机设置的火炬模式。 相机的默认火炬模式是KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF驱动程序必须支持此火炬模式。

此属性控件是同步的，不可取消。

注解

获取 属性

响应KSPROPERTY_TYPE_GET请求时，驱动程序会将 KSCAMERA_EXTENDEDPROP_HEADER 的成员设置为以下内容。

成员	Value
版本	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。
大小	sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE)
结果	0
功能	支持的火炬模式值。
Flags	当前火炬模式值设置仅 (一个值) 。

当火炬模式KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER时，KSCAMERA_EXTENDEDPROP_VALUE 的 Value.ull 成员包含介于 0 - 100 之间的强度级别值。 强度为 0 表示最低级别，强度为 100 表示最大强度级别。

如果以前未设置场景模式，则将 “标志 ”设置为KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF (默认) 。

设置 属性

设置 属性时，KSPROPERTY_TYPE_SET请求，KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成员将包含要设置的火炬模式。 如果标志KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER，KSCAMERA_EXTENDEDPROP_VALUE的 Value.ull 成员将包含要设置的强度级别。

要求

版本	从Windows 8.1开始可用。
标头	Ksmedia.h (包括 Ksmedia.h)

另请参阅

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE