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_HEADER の Size メンバーは、このプロパティ データの合計サイズに設定されます。
KSCAMERA_EXTENDEDPROP_HEADER の Capability メンバーには、ドライバーでサポートされている次の 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_HEADER の Flags メンバーには、カメラ用に現在設定されている フラッシュ モードが含まれています。
カメラの既定のフラッシュ モードは 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_VALUE の Value.ull メンバーには、0 ～ 100 の間の強度レベル値が含まれます。 強度 0 は最小レベルを示し、強度 100 は最大強度レベルを示します。 調整可能な POWER フラグが設定されていない場合は、正規化された強度設定の値が Value.ull に返されます。
フラッシュ モードがまだ設定されていない場合、Flags は KSCAMERA_EXTENDEDPROP_FLASH_OFF (既定) に設定されます。
プロパティの設定
プロパティが設定されている場合、KSPROPERTY_TYPE_SET 要求、KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーには、設定する Torch モードが含まれます。 KSCAMERA_EXTENDEDPROP_VALUE の Value.ull メンバーには、Flags が KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER または KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER の場合に設定する強度レベルが含まれます。
要件
バージョン: Windows 8.1 以降で使用可能
Header: Ksmedia.h (Ksmedia.h を含む)