IMFPMediaPlayer：：SetRate 方法 (mfplay.h)

重要廢棄。此 API 可能會從未來的 Windows 版本中移除。應用程式應該使用媒體會話播放。

設定播放速率。

語法

HRESULT SetRate(
  [in] float flRate
);

[in] flRate

播放速率。播放速率會以目前速率與一般速率的比例表示。例如， 1.0 表示正常播放速度， 0.5 表示半速， 而 2.0 表示兩次速度。正值表示正向播放，負值表示反向播放。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

這個方法會以異步方式完成。當作業完成時，會叫用應用程式的 IMFPMediaPlayerCallback：：OnMediaPlayerEvent 回呼方法。事件類型 MFP_EVENT_TYPE_RATE_SET。

方法會設定最接近支援的速率，視基礎媒體來源而定。例如，如果 flRate 為 50，且來源的最大速率為 8×一般速率，則方法會將速率設定為 8.0。 MFP_EVENT_TYPE_RATE_SET 事件的事件 數據中會指出實際速率。

若要尋找支援費率的範圍，請呼叫 IMFPMediaPlayer：：GetSupportedRates。

這個方法不支援零的播放速率，雖然媒體基礎在一些其他內容中定義了零速率的意義。

新的費率僅適用於目前的媒體專案。設定新的媒體專案會將播放速率重設為 1.0。