KSPROPERTY_CAMERACONTROL_EXTENDED_OIS

  • [アーティクル]

KSPROPERTY_CAMERACONTROL_EXTENDED_OIS は、ドライバーの光学式手ぶれ補正 (OIS) を制御するために使用されるプロパティ ID です。

用法の要点

範囲 コントロール Type

Version 1

Assert

同期

KSCAMERA_EXTENDEDPROP_HEADER.Flags フィールドに以下のフラグを配置することにより、光学式手ぶれ補正を制御できます。 AUTO がサポートされている場合は既定値は AUTO、それ以外の場合は ON にする必要があります。

#define KSCAMERA_EXTENDEDPROP_OIS_OFF   0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_OIS_ON    0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_OIS_AUTO  0x0000000000000002

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

ドライバーが光学式手ぶれ補正をサポートしていない場合は、このコントロールを実装しないでください。

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

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

フラグ 説明

KSCAMERA_EXTENDEDPROP_OIS_OFF

これは必須の機能です。 指定すると、ドライバーで光学式手ぶれ補正が無効になります。

KSCAMERA_EXTENDEDPROP_OIS_ON

これは必須の機能です。 指定すると、ドライバーで光学式手ぶれ補正が有効になります。 このフラグは、OIS_AUTO フラグと OIS_OFF フラグと相互に排他的です。

KSCAMERA_EXTENDEDPROP_OIS_AUTO

この機能は任意です。 指定すると、このような機能をサポートするドライバーが光学式手ぶれ補正をオンにするかオフにするかを決定します。 このフラグは、OIS_ON フラグおよび OIS_OFF フラグと相互に排他的です。

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

メンバー 説明

Version

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

PinId

これは KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) にする必要があります。

Size

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

結果

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

機能

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

Flags

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

要件

ヘッダー

 Ksmedia.h