KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

當相機處於相片順序模式時，此屬性會提供相機的最大擷取幀速率。

使用量摘要表格

Get	Set	目標	屬性描述元類型	屬性值類型
Yes	Yes	Pin	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

) 作業數據 (屬性值包含 KSCAMERA_EXTENDEDPROP_HEADER 結構和 KSCAMERA_EXTENDEDPROP_VALUE 結構。 每秒畫面的最大相片幀速率會設定或傳回 KSCAMERA_EXTENDEDPROP_VALUE的值。

此屬性的Flags 成員中沒有設定旗標KSCAMERA_EXTENDEDPROP_HEADER。

屬性數據大小總計為 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成員會設定為這個屬性數據大小總計。

這個屬性控件是異步且不可取消的。

備註

回應KSPROPERTY_TYPE_GET要求時，驅動程式會將 KSCAMERA_EXTENDEDPROP_HEADER 的成員設定為下列專案。

成員	值
版本	1
PinId	相片釘選的釘選標識碼。
大小	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 個畫面格。

設定時，即使相機可以快速擷取畫面，驅動程式也必須使用所提供的幀速率，然後才要求速率。 如有必要，驅動程式可以卸除額外的畫面格，以容納要求的速率。

將 HighPart 的最大幀速率值設定為 0 (0，而 HighPart 的 LowPart 為 0 ，) 會 清除驅動程式中的最大幀速率設定，而且效果與要求驅動程式儘快提供畫面相同。 一旦幀速率設定為0，任何後續查詢都會傳回相機驅動程式可能的最大幀速率值。

規格需求

版本	從 Windows 8.1 開始提供。
標頭	Ksmedia.h (包含 Ksmedia.h)