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 構造体のすべてのメンバーが 0 の場合、デバイスはイメージの中心にフォーカスする必要があり、この構造体の残りのメンバーは無視できます。
四角形の座標は、プレビュー ビデオの解像度に関します。
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 |
| Header | ksmedia.h (Ksmedia.h を含む) |