KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

このプロパティは、カメラが写真シーケンス モードの場合の最大キャプチャ フレーム レートを提供します。

用法の要点テーブル

プロパティ値 (操作データ) には、KSCAMERA_EXTENDEDPROP_HEADER 構造体と KSCAMERA_EXTENDEDPROP_VALUE 構造体が含まれています。 1 秒あたりのフレーム数の最大写真フレーム レートは設定されるか、KSCAMERA_EXTENDEDPROP_VALUE に値として返されます。

このプロパティの KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーにフラグが設定されていません。

プロパティ データの合計サイズは、sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) です。 KSCAMERA_EXTENDEDPROP_HEADER の Size メンバーは、このプロパティ データの合計サイズに設定されます。

このプロパティ コントロールは非同期であり、取り消し可能ではありません。

解説

KSPROPERTY_TYPE_GET 要求に応答する際、ドライバーは KSCAMERA_EXTENDEDPROP_HEADER のメンバーを次のように設定します。

フレーム レートの値は、KSCAMERA_EXTENDEDPROP_VALUE の Ratio メンバーで設定されます。 Ratio.HighPart にはフレーム レートの分子が含まれており、 Ratio.LowPart にはフレーム レートの分母が含まれます。

ドライバーが写真シーケンス モードの場合は、写真キャプチャの最大フレーム レートを制限することが必要な場合があります。 これは、特定の数の履歴フレームを含む「特定の時点」のキャプチャ シナリオが、構成された期間内に確実に含まれるようにするためです。 たとえば、メモリの制約に基づいて、アプリケーションが過去の 1 秒分の履歴をキャプチャする場合は、キャプチャ レートを制限する必要があるため、N 個のフレームのみが必要です。

設定した場合、カメラがフレームを高速にキャプチャできる場合でも、ドライバーは指定されたフレーム レートを使用する必要があります。 必要に応じて、ドライバーは、要求されたレートに対応するために余分なフレームをドロップできます。

最大フレーム レート値を 0 (Ratio の HighPart の場合は 0、LowPart の場合は 0) に設定すると、ドライバーの最大フレーム レート設定がクリアされ、できるだけ速くフレームを提供するようにドライバーに求めるのと同じ効果があります。 フレーム レートを 0 に設定すると、後続のクエリでは、カメラ ドライバーで可能な最大フレーム レートの値が返されます。

要件