KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO

  • [アーティクル]

KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO は、ドライバーにおける写真 HDR、フラッシュなしフラッシュ、超低光フュージョンを制御するときに使用します。 これは、写真ピン専用のピン レベル コントロールです。

使用状況概要表

範囲 コントロール タイプ

バージョン 1

ピン

同期

ドライバーの写真 HDR、フラッシュなしフラッシュ、超低光フュージョンを制御するために KSCAMERA_EXTENDEDPROP_HEADER.Flags フィールドに配置できるフラグを次に示します。 既定値は KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF である必要があります。

#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO            0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR             0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF             0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT   0x0000000000000008

ドライバーがこのコントロールをサポートしている場合は、KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFFを サポートする必要があります。

ドライバーが高度な写真キャプチャをサポートしていない場合は、ドライバーにこのコントロールを実装しないでください。

このコントロールの SET 呼び出しは、写真ピンが KSSTATE_RUN 状態にある場合は機能しません。 ドライバーは、写真ピンが実行中の状態で、STATUS_INVALID_DEVICE_STATE を返す場合に、受け取った SET 呼び出しを拒否する必要があります。 GET 呼び出しでは、ドライバーが Flags フィールドの現在の設定を返す必要があります。

以下の表では、フラグの機能について説明します。

フラグ 説明

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF

これは必須の機能です。 指定した場合、ドライバーで高度な写真を実行する必要はありません。

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO

この機能は任意です。 単独で指定された場合、このような機能をサポートするドライバーは、シーン分析に基づいて写真 HDR、フラッシュなしフラッシュ、または超低光フュージョンを実行する必要があるかどうかを判断します。 このフラグは OFF フラグと同時に指定することはできませんが、他のフラグと共に使用できます。

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR

この機能は任意です。 単独で指定された場合、このような機能をサポートするドライバーは写真 HDR を実行します。 このフラグは、AUTO 以外の他のフラグと同時に指定することはできません。 AUTO と共に指定した場合、ドライバーはシーン分析に基づいて写真 HDR を実行する必要があるかどうかを判断します。

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF

この機能は任意です。 単独で指定された場合、このような機能をサポートするドライバーはフラッシュをフラッシュなしで実行します。 このフラグは、AUTO 以外の他のフラグと同時に指定することはできません。 AUTO と共に指定した場合、ドライバーはシーン分析に基づいてフラッシュをフラッシュなしで実行する必要があるかどうかを判断します。

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT

この機能は任意です。 単独で指定された場合、このような機能をサポートするドライバーは超低光フュージョンを実行します。 このフラグは、AUTO 以外の他のフラグと同時に指定することはできません。 AUTO と共に指定した場合、ドライバーはシーン分析に基づいて超低光フュージョンを実行する必要があるかどうかを判断します。

次の表は、KSCAMERA_EXTENDEDPROP_HEADER 構造体について、このコントロールを使用する場合のフィールドの説明と要件を示します。

メンバー 説明

バージョン

これは 1 である必要があります。

PinId

写真ピンに関連付けられているピン ID である必要があります。

サイズ

これは sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_値) にする必要があります。

結果

最後の SET 操作のエラー結果を示します。 SET 操作が実行されていない場合は、0 にする必要があります。

機能

上記で定義した、サポートされている KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* フラグのビット論理和にする必要があります。

Flags

これは読み取り/書き込みフィールドです。 これは、上記で定義した KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* フラグのいずれかになります。

要件

ヘッダー

 Ksmedia.h