IAMVideoCompression：：get_KeyFrameRate 方法 (strmif.h)
[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。
方法 get_KeyFrameRate 會擷取目前的主要畫面格速率。
語法
HRESULT get_KeyFrameRate(
[out] long *pKeyFrameRate
);
參數
[out] pKeyFrameRate
接收目前主要幀速率之變數的指標。 如果值為負數，篩選條件會使用預設的主要畫面格速率。 如果值為零，則只有第一個畫面是主要畫面格。
傳回值
傳回 HRESULT 值。
備註
主要畫面格速率是每個主要畫面格的畫面數。 例如，如果速率為 15，則每 15 個畫面就會發生主要畫面格。
若要判斷篩選是否支援此方法，請呼叫 IAMVideoCompression：：GetInfo 方法，並檢查 pCapabilities 參數中的 CompressionCaps_CanKeyFrame 旗標。 GetInfo 方法也會傳回預設的主要畫面格速率。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |