次の方法で共有


KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE (通常とシーケンス)

フラッシュ プロパティ コントロールは、カメラの通常モードとシーケンス写真モードの両方のフラッシュ モード動作を設定します。

用法の要点

Yammer の入手 設定 移行先 プロパティ記述子の種類 プロパティ値の種類
はい Yes Assert KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

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

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

KSCAMERA_EXTENDEDPROP_HEADERCapability メンバーには、ドライバーでサポートされている次の 1 つ以上のフラッシュ モードのビット論理和の組み合わせが含まれています。

フラッシュ モード 説明
KSCAMERA_EXTENDEDPROP_FLASH_OFF フラッシュがオフです。
KSCAMERA_EXTENDEDPROP_FLASH_ON フラッシュは既定の強度レベルでオンになっています。
KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER フラッシュは特定の電力レベルでオンになっています。
KSCAMERA_EXTENDEDPROP_FLASH_AUTO フラッシュは、照明条件に基づいて自動的に行われます。
KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER フラッシュは、特定の電力レベルでの照明条件に基づいて自動的に行われます。

次の機能フラグは、KSCAMERA_EXTENDEDPROP_FLASH_OFF を除き、前のフラッシュ設定と組み合わせることができます。

フラッシュ機能 説明
KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION 赤目補正機能を有効にします。 このフラグは、他の設定と組み合わせることができます。
KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH 1 つのトリガーにのみフラッシュを設定します。 カメラが写真シーケンス モードでない場合、この機能は無視されます。
KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED すべてのシーケンス フレームでトリガーするフラッシュを設定します。 カメラが写真シーケンス モードでない場合、この機能は無視されます。

KSCAMERA_EXTENDEDPROP_HEADERFlags メンバーには、カメラ用に現在設定されている フラッシュ モードが含まれています。

カメラの既定のフラッシュ モードは KSCAMERA_EXTENDEDPROP_FLASH_OFF です。 カメラがフラッシュ、KSCAMERA_EXTENDEDPROP_FLASH_OFF、KSCAMERA_EXTENDEDPROP_FLASH_ON、KSCAMERA_EXTENDEDPROP_FLASH_AUTO をサポートしている場合は、必要なモードです。 KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER と KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER モードは省略可能です。

カメラで写真シーケンス モードがサポートされている場合は、KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH をサポートするためにフラッシュ コントロール プロパティが必要です。

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

解説

プロパティの取得

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

メンバー
バージョン 1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
サイズ sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
結果 0
機能 フラッシュ モードの値がサポートされています
Flags (現在のフラッシュ モード値の設定) | (フラッシュ機能フラグ)

Torch モードが、KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER または KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER の場合、KSCAMERA_EXTENDEDPROP_VALUEValue.ull メンバーには、0 ~ 100 の間の強度レベル値が含まれます。 強度 0 は最小レベルを示し、強度 100 は最大強度レベルを示します。 調整可能な POWER フラグが設定されていない場合は、正規化された強度設定の値が Value.ull に返されます。

フラッシュ モードがまだ設定されていない場合、Flags は KSCAMERA_EXTENDEDPROP_FLASH_OFF (既定) に設定されます。

プロパティの設定

プロパティが設定されている場合、KSPROPERTY_TYPE_SET 要求、KSCAMERA_EXTENDEDPROP_HEADERFlags メンバーには、設定する Torch モードが含まれます。 KSCAMERA_EXTENDEDPROP_VALUEValue.ull メンバーには、Flags が KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER または KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER の場合に設定する強度レベルが含まれます。

要件

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

Header: Ksmedia.h (Ksmedia.h を含む)

関連項目

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE