IAMVideoControl：：GetMaxAvailableFrameRate 方法 (strmif.h)

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

方法 GetMaxAvailableFrameRate 會根據連線的匯流排頻寬使用量，擷取目前可用的最大畫面播放速率，例如 USB 和 IEEE 1394，其中最大畫面播放速率可能會受限於頻寬可用性。

語法

HRESULT GetMaxAvailableFrameRate(
  [in]  IPin     *pPin,
  [in]  long     iIndex,
  [in]  SIZE     Dimensions,
  [out] LONGLONG *MaxAvailableFrameRate
);

參數

[in] pPin

要從中擷取最大畫面播放速率的釘選指標。

[in] iIndex

要查詢最大畫面播放速率之格式的索引。 此索引會對應到 IAMStreamConfig：：GetStreamCaps列舉格式的順序。 此值必須介於零與IAMStreamConfig：：GetNumberOfCapabilities) 減一傳回的支援VIDEO_STREAM_CONFIG_CAPS結構數目之間。

[in] Dimensions

框架影像大小 (寬度和高度) 圖元。

[out] MaxAvailableFrameRate

最大可用畫面播放速率的指標。 畫面播放速率是以 100 奈秒單位的畫面持續時程表示。

傳回值

傳回取決於介面實作的 HRESULT 值。

規格需求

另請參閱

錯誤和成功碼

IAMVideoControl 介面

VIDEO_STREAM_CONFIG_CAPS 結構