ksmedia.h) (KSPROPERTY_CAMERACONTROL_S_EX 结构

项目
02/29/2024

指定相机控制操作，包括设置闪光灯、图像引脚控制属性、图像中感兴趣的区域或视频防抖动。此结构描述 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 事件。