次の方法で共有


KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE

フォーカス モード プロパティは、カメラの自動、手動、およびプリセットのフォーカス モードを制御します。

用法の要点テーブル

Yammer の入手 設定 移行先 プロパティ記述子の種類 プロパティ値の種類

はい

Yes

Assert

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

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

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

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

処理モードとフォーカス モード 説明
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO カメラ ドライバーは、ビデオに独自の処理ロジックを使用します。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL カメラ ドライバーは、プリセットの処理方法または温度ベースのメソッドを使用します。
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK 現在のビデオ処理方法がロックされています。
KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS 収束焦点は設定されません。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO マクロ範囲の焦点収束。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL 通常の範囲の焦点収束。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE 全範囲の焦点収束。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY 無限範囲の焦点収束。
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL 過焦点範囲。

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

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

解説

処理モード

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO

このフラグは、完了イベントがトリガーされたときに自動フォーカス操作が収束したことを示します。 完了時に、このフラグが KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK と組み合わされていない場合、フォーカスが分岐し、カメラ ドライバーが収束を試み続ける可能性があります。 KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK フラグが含まれている場合、フォーカスは最初の収束にロックされ、新しいフォーカス コマンドが受信されるまで変更されません。

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

このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL フラグと KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS フラグと相互に排他的です。

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL

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

このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK、または KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS と組み合わせてはなりません。

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK

このフラグが対応する KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO フラグなしで設定されている場合、カメラ ドライバーは現在のフォーカス状態をロックし、フォーカスがロックされると完了イベントをトリガーすることが期待されます。 カメラ ドライバーは、新しいフォーカス コマンドを受け取るまでフォーカスの状態を変えてはなりません。 このフラグ KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO 組み合わせた場合、カメラ ドライバーは自動フォーカスに収束し、フォーカスをその収束ポイントにロックしてから、完了イベントをトリガーします。 このフラグは、KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS または KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL と組み合わせてはなりません。

このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO と組み合わされていない限り、フォーカス コントロールの範囲フラグと共に指定することはできません。 その場合、範囲フラグを使用してフォーカスが実行され、自動フォーカス スキャンを実行する場所が決定されます。 次に、収束すると、フォーカス設定がロックされ、完了イベントが発生します。

KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS

このフラグは、フォーカスが連続していることを示します。 この場合、フォーカス制御の収束ポイントは 1 つもありません。 ドライバーは、この要求を受け入れて、すぐに非同期操作を完了する必要があります。

このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK、または KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL と組み合わせてはなりません。

このモードはすべてのドライバーで必要になります。

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO

このフラグは、マクロ範囲に対してフォーカスの収束を実行する必要があることを示します。 正確な焦点範囲はドライバーによって決まります。 このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO および KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS と組み合わせることができます。

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL

このフラグは、通常範囲に対してフォーカスの収束を実行する必要があることを示します。 正確な焦点範囲はドライバーによって決まります。 このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO および KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS と組み合わせることができます。

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE

このフラグは、全範囲に対してフォーカスの収束を実行する必要があることを示します。 正確な焦点範囲はドライバーによって決まります。 このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO および KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS と組み合わせることができます。

このモードはすべてのドライバーで必要になります。

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY

このフラグは、無限範囲に対してフォーカスの収束を実行する必要があることを示します。 正確な焦点範囲はドライバーによって決まります。 このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO および KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS と組み合わせることができます。

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL

このフラグは、過焦点範囲に対してフォーカスの収束を実行する必要があることを示します。 正確な焦点範囲はドライバーによって決まります。 このフラグは、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO および KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS と組み合わせることができます。

プロパティの取得

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 | KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE |

(ビデオ処理とフォーカス モードがサポートされています)

Flags 現在のビデオ処理とフォーカス モード。

フォーカス範囲フラグが以前に設定されていない場合、ドライバーは Flags を KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (既定) と共に KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE に設定します。 KSCAMERA_EXTENDEDPROP_HEADER 構造体に続く KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 構造体のメンバーは、フォーカス モードの要件に従って設定されます。

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

プロパティの設定

プロパティが設定されている場合、KSPROPERTY_TYPE_SET 要求、KSCAMERA_EXTENDEDPROP_HEADERFlags メンバーには、設定するフォーカス モードが含まれます。 Flags に KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO、KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK、KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS が含まれている場合、KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTINGVideoProc.Value メンバーは無視する必要があります。

要件

バージョン

Windows 8.1 以降で使用できます。

ヘッダー

ksmedia.h (Ksmedia.h をインクルード)

関連項目

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING