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)

另請參閱

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

矩形