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)

另请参阅

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE