KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE
Torch モードは、カメラのフラッシュを低光条件下で使用する方法を決定します。 より低い強度の光源は、オートフォーカスなどの操作に十分な光を可能にするために、フラッシュによって継続的に提供されます。
用法の要点テーブル
| Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
はい |
Yes |
Assert |
プロパティ値 (操作データ) には、KSCAMERA_EXTENDEDPROP_HEADER 構造体と KSCAMERA_EXTENDEDPROP_VALUE 構造体が含まれています。
プロパティ データの合計サイズは、sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) です。 KSCAMERA_EXTENDEDPROP_HEADER の Size メンバーは、このプロパティ データの合計サイズに設定されます。
KSCAMERA_EXTENDEDPROP_HEADER の Capability メンバーには、ドライバーでサポートされている次の 1 つ以上の Torch モードのビット論理和の組み合わせが含まれています。
| Torch モード | 説明 |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF | トーチライトはオフです。 |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON | トーチライトは既定の強度レベルでオンになっています。 |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER | トーチライトは特定の電力レベルでオンになっています。 |
KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーには、カメラ用に現在設定されている Torch モードが含まれています。 カメラの既定の Torch モードは KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF であり、ドライバーはこの Torch モードをサポートする必要があります。
このプロパティ コントロールは同期的であり、取り消し可能ではありません。
解説
プロパティの取得
KSPROPERTY_TYPE_GET 要求に応答する際、ドライバーは KSCAMERA_EXTENDEDPROP_HEADER のメンバーを次のように設定します。
| メンバー | 値 |
|---|---|
| バージョン | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)。 |
| サイズ | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| 結果 | 0 |
| 機能 | Torch モードの値がサポートされています。 |
| Flags | 現在の Torch モードの値の設定 (値は 1 つだけ)。 |
Torch モードが KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER の場合、KSCAMERA_EXTENDEDPROP_VALUEValue.ull メンバーには、0 ～ 100 の強度レベル値が含まれます。 強度 0 は最小レベルを示し、強度 100 は最大強度レベルを示します。
シーン モードがまだ設定されていない場合、Flags は KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF (既定) に設定されます。
プロパティの設定
プロパティが設定されている場合、KSPROPERTY_TYPE_SET 要求、KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーには、設定する Torch モードが含まれます。 Flags が KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER に設定されて場合、KSCAMERA_EXTENDEDPROP_VALUE の Value.ull メンバーには、設定する強度レベルが含まれます。
要件
バージョン |
Windows 8.1 以降で使用できます。 |
ヘッダー |
ksmedia.h (Ksmedia.h をインクルード) |