KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE
火炬模式确定相机的闪光灯在弱光条件下的使用方式。 闪光灯持续提供较低强度的光源，以便为自动对焦等操作提供足够的光线。
使用情况摘要表
| Get | Set | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
是 |
是 |
筛选器 |
操作数据 (属性值) 包含 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) |