Share via

KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE

  • [アーティクル]

Torch モードは、カメラのフラッシュを低光条件下で使用する方法を決定します。 より低い強度の光源は、オートフォーカスなどの操作に十分な光を可能にするために、フラッシュによって継続的に提供されます。

用法の要点テーブル

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

はい

Yes

Assert

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

プロパティ値 (操作データ) には、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 をインクルード)

関連項目

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE