KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE (法线和序列)
闪光灯属性控件为相机的普通和序列照片模式设置闪光模式操作。
使用情况摘要表
| Get | Set | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
| 是 | 是 | 筛选器 | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
操作数据) (属性值包含 KSCAMERA_EXTENDEDPROP_HEADER 结构和 KSCAMERA_EXTENDEDPROP_VALUE 结构。
总属性数据大小为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成员设置为此总属性数据大小。
KSCAMERA_EXTENDEDPROP_HEADER 的 Capability 成员包含驱动程序支持的以下一个或多个闪存模式的按位 OR 组合。
| 闪存模式 | 说明 |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_OFF | 闪光灯已关闭。 |
| KSCAMERA_EXTENDEDPROP_FLASH_ON | 闪存处于默认强度级别。 |
| KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER | 闪存处于特定功率级别。 |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO | 根据照明条件自动闪烁。 |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER | 根据特定功率级别的照明条件自动闪烁。 |
以下功能标志可以与以前的闪存设置结合使用，但KSCAMERA_EXTENDEDPROP_FLASH_OFF除外。
| 闪存功能 | 说明 |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION | 启用重眼减少功能。 此标志可以与任何其他设置结合使用。 |
| KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH | 仅为一个触发器设置闪存。 当相机不处于照片序列模式时，将忽略此功能。 |
| KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED | 将 flash 设置为在每个序列帧上触发。 当相机不处于照片序列模式时，将忽略此功能。 |
KSCAMERA_EXTENDEDPROP_HEADER 的 Flags 成员包含当前为相机设置的闪光灯模式。
相机的默认闪光灯模式为KSCAMERA_EXTENDEDPROP_FLASH_OFF。 如果相机支持闪光灯、KSCAMERA_EXTENDEDPROP_FLASH_OFF、KSCAMERA_EXTENDEDPROP_FLASH_ON和KSCAMERA_EXTENDEDPROP_FLASH_AUTO是必需模式。 KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER和KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER模式是可选的。
如果相机支持照片序列模式，则需要具有支持KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH的闪光灯控制属性。
此属性控件是同步的，不可取消。
注解
获取 属性
响应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_FLASH_ON_ADJUSTABLEPOWER或KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER时，KSCAMERA_EXTENDEDPROP_VALUE 的 Value.ull 成员包含介于 0 - 100 之间的强度级别值。 强度为 0 表示最小级别，强度为 100 表示最大强度级别。 如果未设置可调整的电源标志，则 Value.ull 中返回规范化强度设置的值。
如果以前未设置闪存模式，则 Flags 设置为KSCAMERA_EXTENDEDPROP_FLASH_OFF (默认) 。
设置属性
设置 属性时，KSPROPERTY_TYPE_SET请求，KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成员将包含要设置的火炬模式。 KSCAMERA_EXTENDEDPROP_VALUE 的 Value.ull 成员将包含标志KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER或KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER时要设置的强度级别。
要求
版本：从Windows 8.1开始可用
头： Ksmedia.h (包括 Ksmedia.h)