KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S結構 (ksmedia.h)
描述 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) |