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) |