ksmedia.h) (KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S 结构

  • 项目

描述感兴趣区域 (ROI) PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST 相机控件属性集中的控件属性。 感兴趣区域是图像中用于聚焦相机的矩形。 此结构指定在对相机驱动程序的请求中使用的属性值。

语法

typedef struct {
  RECT  FocusRect;
  BOOL  AutoFocusLock;
  BOOL  AutoExposureLock;
  BOOL  AutoWhitebalanceLock;
  union {
    ULONG Capabilities;
    ULONG Configuration;
  };
} KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S, *PKSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S;

成员

FocusRect

RECT 结构，指定设备应在其中设置焦点的矩形区域。 此结构仅适用于 Windows 应用。

如果 FocusRect 不是有效值，或者 RECT 结构的所有成员均为零，则设备应将焦点放在图像的中心，并且可以忽略此结构的其余成员。

矩形的坐标与预览视频分辨率有关。

AutoFocusLock

如果 为 TRUE，则设备应将焦点锁定到当前值。

如果 FocusRect 不是有效值，则应忽略此成员。

AutoExposureLock

如果 为 TRUE，则设备应锁定当前值的曝光。

如果 FocusRect 不是有效值，则应忽略此成员。

AutoWhitebalanceLock

如果 为 TRUE，设备应将白平衡设置锁定为当前值。

如果 FocusRect 不是有效值，则应忽略此成员。

Capabilities

指示设备和驱动程序是支持自动还是手动设置感兴趣的区域。 此成员为以下可能值的按位 OR ：

值 含义
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO 设备和驱动程序可以自动设置感兴趣的区域。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL 用户可以手动设置感兴趣的区域。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC ROI 控制功能以异步方式执行。 此功能从Windows 8.1开始可用。

Configuration

区域控制操作的配置标志。 这是以下值的按位 OR 组合。

此成员从 Windows 8.1 开始可用。

值 含义
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS 为区域设置自动焦点。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE 为区域设置自动公开。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB 为区域设置自动白平衡。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE 启用区域中对象的收敛。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
标头 ksmedia.h (包括 Ksmedia.h)

另请参阅

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

矩形