共用方式為


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_HEADERSize 成員會設定為這個屬性數據大小總計。

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

備註

回應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)