KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE

露出制御プロパティは、露出に対して自動処理を行うか、代わりに手動の時間値を使用するかを指定します。

使用状況概要表

取得	設定	対象	プロパティ記述子の種類	プロパティ値の種類
はい	はい	フィルター	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

プロパティ値 (操作データ) には、KSCAMERA_EXTENDEDPROP_HEADER 構造体と KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 構造体が含まれています。

プロパティ データの合計サイズは、sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) です。 KSCAMERA_EXTENDEDPROP_HEADER の Size メンバーは、このプロパティ データの合計サイズに設定されます。

KSCAMERA_EXTENDEDPROP_HEADER の Capability メンバーには、次のビデオ処理オプションの 1 つ以上のビット論理和の組み合わせが含まれています。

処理モード	説明
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO	カメラ ドライバーは、ビデオに独自の処理ロジックを使用します。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL	カメラ ドライバーは、あらかじめ設定されている処理方法を使用します。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK	現在のビデオ処理方法がロックされています。

KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーには、カメラに現在設定されているビデオ処理フラグが含まれています。 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO の設定は、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK と組み合わせることができます。

このプロパティ コントロールは非同期であり、取り消し可能です。

備考

処理モード

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO

これは、自動処理がサポートされていることを示します。 ドライバーは、内部ロジックを使用してビデオ処理を最適化します。 KSPROPERTY_TYPE_GET 要求の場合、KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING の VideoProc メンバーには、ビデオ処理用に現在のドライバーによって判断された値が含まれている必要があります。

このフラグは、ビット論理和の値として KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK と組み合わせることができます。

ロックを自動モードと組み合わせずに使用する場合、既にロックされているコントロールをカメラ ドライバーによる操作なしとして扱う必要があります。 ロックを自動モードと組み合わせて使用する場合、既にロックされているコントロールが新しい収束をトリガーする必要があります。

このフラグを KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL と組み合わせることはできません。

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL

手動は、このビデオ処理で、特定の値が提供されることを示します。 特定の値はドライバーに提供されます。

このフラグを、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO または KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK と組み合わせることはできません。

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK

lock オプション フラグは、現在のビデオ処理が現在プログラムされている値にロックされていることを示します。 たとえば、アプリケーションは、特定の露出が判断されるまで自動モードを要求できます。 その時点で、アプリケーションはすべて同じ露出で一連の写真を撮ることを決定します。 このような場合、アプリケーションで KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK フラグを指定できます。

このフラグを KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL と組み合わせることはできません。

プロパティの取得

KSPROPERTY_TYPE_GET 要求に応答する際、ドライバーは KSCAMERA_EXTENDEDPROP_HEADER のメンバーを次のように設定します。

メンバー	値
バージョン	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
サイズ	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)
結果	0
機能	KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL ビット論理和 (サポートされているビデオ処理モードで使用)
フラグ	現在のビデオ処理モード

露出モードが以前に設定されていない場合、ドライバーは Flags を KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (既定値) に設定します。 KSCAMERA_EXTENDEDPROP_HEADER 構造に続く KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 構造体のメンバーは、処理モードの要件に従って設定されます。

VideoProp.値.ull 値には、モードが KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO の場合の現在の露出設定が含まれている必要があります。

プロパティの設定

プロパティが設定されている場合、KSPROPERTY_TYPE_SET 要求、KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーには、設定する露出モードが含まれます。 Flags に KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO モード フラグが含まれている場合、KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING の VideoProc.値 メンバーは無視する必要があります。

要件

バージョン: Windows 8.1 以降で使用可能

ヘッダー: ksmedia.h (Ksmedia.h を含む)

関連項目

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING