扩展相机控制属性

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

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

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

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

属性

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

KSPROPERTY_摄像头控制_图像_PIN_能力_属性
用于确定相机的图像引脚和记录引脚是否互斥。

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY(相机控制的感兴趣区域属性)
用于获取或设置相机感兴趣的区域的特征。

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

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

术语 DESCRIPTION

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_摄像机控制_扩展_优化提示

用于获取或设置是否自动处理白平衡或设定手动温度值。

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

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

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

结构

枚举

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