KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY

KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY プロパティ ID は、フォーカス優先度を構成するために KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY リストで定義されています。 フォーカス優先度を設定すると、撮影する写真よりもフォーカスが優先され、常にピントが合った状態で撮影されます。 それ以外の場合は、画像がフォーカスされているかどうかに関係なく、すぐに画像が撮影されます。 失敗したフォーカスを処理する場合の動作とタイムアウトが必要かどうかはドライバーの内部で決まり、OEM が決定します。

用法の要点

フォーカスの優先度を構成するには、KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY プロパティ ID を使用する必要があります。 フォーカス優先度を設定すると、撮影する写真よりもフォーカスが優先され、常にピントが合った状態で撮影されます。 フォーカス優先度が設定されていない場合、画像がフォーカスされていたかどうかに関係なく、画像が直ちに撮影されます。 失敗したフォーカスを処理する際の動作は失敗し、タイムアウトは OEM によって決定され、ドライバーの内部で決まります。

KSCAMERA_EXTENDEDPROP_HEADER では、次のフラグが値として定義されます。 Get 呼び出しでは、カメラ ドライバーは、これらのフラグのいずれかを使用して、現在のフォーカス優先の構成を返します。 設定された呼び出しでは、カメラ ドライバーは、これらのフラグのいずれかを使用して、新しいフォーカス優先度の構成を設定します。

#define KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_OFF     0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_ON      0x0000000000000001

注: これは同期コントロールであり、このコントロールには機能が定義されていません。

次の表は、このフォーカス優先度コントロールを使用する場合の KSCAMERA_EXTENDEDPROP_HEADER 構造体フィールドの説明と要件を示します。

要件