KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

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

用法の要点テーブル

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
はい	はい	ピン留めする	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

プロパティ値 (操作データ) には、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 のメンバーを次のように設定します。

メンバー	値
バージョン	1
PinId	写真ピンのピン ID。
サイズ	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
結果	最大フレーム レートの読み取り試行に起因するエラー値。 それ以外の場合は、0 に設定されます。
機能	KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Flags	0

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

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

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

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

要件

バージョン	Windows 8.1 以降で使用できます。
ヘッダー	ksmedia.h (Ksmedia.h をインクルード)