拡張カメラ コントロールのプロパティ

Windows 8 以降で使用可能な拡張カメラ制御インターフェイスは、画像キャプチャ中にカメラの機能を制御するために使用されます。 ドライバーは、次のカメラ機能を制御できます。

• カメラのフラッシュ
• イメージ ピンとレコード ピンが互いに排他的かどうか
• 画像内の関心領域
• ビデ安定化

ドライバーは、カメラ制御操作を非同期で実行することもできます。つまり、最初の要求が完了するまで、操作のすべての要求が拒否されます。 ドライバーが正常に非同期のカメラ制御操作を実行した場合は、KSEVENTSETID_CameraAsyncControl イベントをトリガーする必要があります。 詳細については、「KSPROPERTY_CAMERACONTROL_S_EX」を参照してください。

UWP アプリは、次のプロパティにアクセスしてカメラを設定できます。

プロパティ

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
カメラのフラッシュをオンまたはオフにしたり、フラッシュを自動モードにしたりするために使用されます。

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
カメラの画像ピンと記録ピンが相互に排他的かどうかを識別するために使用されます。

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
カメラの関心領域の特性を取得または設定するために使用されます。

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
カメラのビデオ安定化の特性を取得または設定するために使用されます。

次のプロパティは、Windows 8.1 以降で使用可能です。

用語	説明
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE	カメラの通常の静止画または写真シーケンス モードを取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE	カメラの写真モードがシーケンス モードの場合に、現在の写真キャプチャのフレーム レートを取得するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE	カメラが写真シーケンス モードのときに、カメラの最大キャプチャ フレーム レートを取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME	カメラ ドライバーのトリガー時間を取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART	ウォーム スタート (カメラの準備完了) 状態を取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES	ビデオ キャプチャ ピンで可能な最大フレーム レートを特定の解像度で取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL	カメラのサムネイル機能を取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE	プリセット制御のコレクションを表すドライバー定義モードを取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE	低光条件下でカメラのフラッシュを使用する方法を取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE	カメラの通常の写真モードとシーケンス写真モードの両方のフラッシュ モード操作を取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT	自動処理がホワイト バランスまたは手動温度値対して行われるかどうかを取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE	カメラが写真操作またはビデオ操作に最適化されているかどうかを取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE	露光に自動処理が行われるか、手動時間値が使用されるかを取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE	カメラの自動、手動、プリセットのフォーカス モードを取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO	カメラのプリセットまたは自動 ISO 設定を取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW	カメラ位置の視野とピッチ角度を取得するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION	露光制御調整設定を取得または設定するために使用されます。
KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET	カメラ位置のピッチ角度とヨー角度を取得するために使用されます。

これらの構造体と列挙体は、拡張カメラ制御インターフェイスをサポートします。

構造体

• KSPROPERTY_CAMERACONTROL_S_EX
• KSPROPERTY_CAMERACONTROL_FLASH_S
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_S
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S
• KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S
• KSCAMERA_EXTENDEDPROP_HEADER
• KSCAMERA_EXTENDEDPROP_VALUE
• KSCAMERA_EXTENDEDPROP_PHOTOMODE
• KSCAMERA_MAXVIDEOFPS_FORPHOTORES
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING
• KSCAMERA_EXTENDEDPROP_FIELDOFVIEW

列挙

• KS_CameraControlAsyncOperation
• KSEVENT_CAMERACONTROL
• KSPROPERTY_CAMERACONTROL_FLASH
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST
• KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE

このインターフェイスを実装するドライバー コードの例については、「拡張カメラ制御プロパティを実装する方法」を参照してください。