KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE
KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE是動態控件，可藉由原始幀速率的縮放比例來降低視訊的幀速率。
使用量摘要數據表
| 取得 Yammer | 設定 | Target | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
| Yes | .是 | 篩選器 | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
屬性值（作業數據）包含KSCAMERA_EXTENDEDPROP_HEADER結構和KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING結構。
屬性數據大小總計為 sizeof（KSCAMERA_EXTENDEDPROP_HEADER） + sizeof（KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING）。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成員會設定為這個屬性數據大小總計。
KSCAMERA_EXTENDEDPROP_HEADER的 Capability 成員包含下列其中一個值。
| 幀速率節流控制 | 描述 |
|---|---|
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF | 幀速率節流已停用。 |
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON | 已啟用幀速率節流。 |
KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員包含相機目前設定的旗標。 KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF應該是預設值。
這個屬性控制件是同步且無法取消的。
此控件僅適用於相機主動串流時。 若要主動串流，表示預覽或記錄釘選必須位於KSSTATE_RUN中，且能夠傳遞畫面。 如果數據流不在作用中，則此控件應該傳回STATUS_INVALID_DEVICE_STATE。 即使這是篩選範圍控件，這不應該影響相片釘選或非 RGB 串流，例如 IR/深度。
備註
取得屬性
回應KSPROPERTY_TYPE_GET要求時，驅動程式會將KSCAMERA_EXTENDEDPROP_HEADER的成員設定為下列專案。
| member | 值 |
|---|---|
| 版本 | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE （0xFFFFFFFF） |
| 大小 | 必須是 sizeof（KSCAMERA_EXTENDEDPROP_HEADER） + sizeof（KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING） |
| 結果 | 必須是 0。 此欄位是用來傳回最後一個 SET 作業的結果。 |
| 功能 | KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON或0x1 |
| 旗標 | 這可以是KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON或KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF。 |
如果先前未設定任何幀速率節流旗標，則驅動程式會將 Flags 設定為 KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF。 遵循KSCAMERA_EXTENDEDPROP_HEADER KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING結構的成員會根據幀速率節流模式的需求來設定。
設定屬性
設定屬性時，KSPROPERTY_TYPE_SET要求，KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成員會包含要設定的幀速率節流模式。 當 Flags 包含KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF旗標時，必須忽略KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING的 VideoProc.Value 成員。
承載結構
下表包含 Framerate Throttle DDI 之KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING結構欄位的描述和需求。 此結構定義於 ksmedia.h 中。
| member | 描述 |
|---|---|
| [模式] | 這是未使用的，而且必須是 0。 |
| 最小值/最大值/步驟 | Max 必須是 100，表示幀速率沒有變更。 步驟應該是 100 的因數，因此 Max % Step == 0。 最小值應至少等於一個步驟大小或步驟大小的倍數。 最小值不能是 0。 |
| VideoProc | VideoProc.Value.ul 必須為此控件指定縮放比例百分比。 此值應該在 Min 和 Max 的範圍內，而且應該設定為 Step 值的倍數。 藉由適當地設定此值，應用程式可以確定新的幀速率永遠不會超過原始值，也不會移至零。 例如，設定值為 80 會產生原始幀速率的 80%。 |
| 已保留 | 這是未使用的。 驅動程式必須忽略此專案。 |
需求
最低支援的用戶端： Windows 11 版本 24H2
標頭： ksmedia.h （包括 Ksmedia.h）