描述 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
指出裝置和驅動程式是否支援自動或手動設定感興趣的區域。 這個成員是這些可能值的位 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） |