扩展的相机控件属性

从Windows 8开始,扩展的相机控制界面用于在图像捕获期间控制相机功能。 驱动程序可以控制以下相机功能:

  • 相机的闪光灯
  • 图像引脚和记录引脚是否互斥
  • 图像中感兴趣的区域
  • 视频防抖动

驱动程序还可以选择异步执行相机控制操作,这意味着在完成第一个请求之前,将拒绝操作的所有请求。 如果驱动程序已成功执行异步相机控制操作,则应触发 KSEVENTSETID_CameraAsyncControl 事件。 有关详细信息 ,请参阅KSPROPERTY_CAMERACONTROL_S_EX

UWP 应用可以访问这些属性来配置相机:

属性

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
用于打开或关闭相机的闪光灯,或将闪光灯置于自动模式。

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
用于确定相机的图像插针和记录插针是否互斥。

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
用于获取或设置相机感兴趣区域的特征。

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
用于获取或设置相机的视频防抖动特征。

以下属性从 Windows 8.1 开始可用。

术语 说明

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE

用于获取或设置相机的普通静止或照片序列模式。

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE

用于在相机的照片模式为序列模式时获取当前照片捕获帧速率。

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

用于获取或设置相机处于照片序列模式时的最大捕获帧速率。

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME

用于获取或设置相机驱动程序的触发时间。

KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART

用于获取或设置热启动 (相机就绪) 状态。

KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES

用于获取或设置特定分辨率的视频捕获引脚上可能的最大帧速率。

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL

用于获取或设置相机的缩略图功能。

KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE

用于获取或设置驱动程序定义的模式,该模式表示预设控件的集合。

KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE

用于获取或设置相机的闪光灯在低光条件下使用的方法。

KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE

用于获取或设置相机正常模式和序列照片模式的闪光模式操作。

KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT

用于获取或设置是针对白平衡还是针对手动温度值进行自动处理。

KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE

用于获取或设置相机是否针对照片或视频操作进行优化。

KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE

用于获取或设置是针对曝光进行自动处理还是使用手动时间值。

KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE

用于获取或设置相机的自动、手动和预设对焦模式。

KSPROPERTY_CAMERACONTROL_EXTENDED_ISO

用于获取或设置相机的预设或自动 ISO 设置。

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW

用于获取相机位置的视野和俯仰角。

KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION

用于获取或设置曝光控件调整设置。

KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET

用于获取相机位置的俯仰角和偏航角。

这些结构和枚举支持扩展的相机控制接口:

结构

枚举

如何实现扩展相机控件属性中提供了实现此接口的示例驱动程序代码。