KSPROPERTY_CAMERACONTROL_S_EX结构（ksmedia.h）

项目
02/07/2025

指定相机控制作，包括设置闪存、图像引脚控件属性、图像感兴趣的区域或视频防抖动。此结构描述 PROPSETID_VIDCAP_CAMERACONTROL 属性集中的基于筛选器的属性。

从 Windows 8 开始支持。

语法

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

成员

Property

指定描述属性集、属性 ID 和请求类型的初始化 KSPROPERTY 结构。

Value

指定属性的值。此成员是可读/写的。

Flags

指示对于 Get 请求，从下面列出的值中指示指定属性的当前设置。指示对于 Set 请求，从下面列出的值中指示指定属性的所需设置。此成员可以是 Ksmedia.h中定义的以下值的按位 OR：

价值	描述
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	指示自动控制设置。如果驱动程序收到此值，则应将相机控件同步设置为自动模式，然后返回。
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	指示手动控制设置。如果驱动程序收到此值，则应将相机控件同步设置为手动模式，然后返回。
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	指示驱动程序是否应异步执行相机控制作，其中应用程序已发出命令，以便驱动程序在拍摄照片之前设置相机控件设置。仅当设置了 KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL 或 KSPROPERTY_CAMERACONTROL_FLAGS_AUTO 时，才必须设置此标志。如果同时设置了此标志值和 KSPROPERTY_CAMERACONTROL_FLAGS_AUTO 标志值，驱动程序应启动工作线程来启动一个请求的控制作，并应拒绝同一作的所有其他请求，直到它完成第一个作。作成功完成后，驱动程序应触发 KSEVENTSETID_CameraAsyncControl 事件。