KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE
當相機處於相片順序模式時,此屬性會提供相機的最大擷取幀速率。
使用量摘要表格
Get | Set | 目標 | 屬性描述元類型 | 屬性值類型 |
---|---|---|---|---|
Yes |
Yes |
Pin |
) 作業數據 (屬性值包含 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) |