介绍 PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST 相机控制属性集中感兴趣的区域（ROI）控件属性。 感兴趣的区域是图像中用于聚焦相机的矩形。 此结构指定在对相机驱动程序的请求中使用的属性值。
语法
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
指示设备和驱动程序是否支持自动或手动设置感兴趣的区域。 此成员按位 或 这些可能的值：
| 价值 | 意义 |
|---|---|
| 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） |