IMFRateSupport：：GetFastestRate 方法 (mfidl.h)

  • 發行項

取得 物件支援的最快播放速率。

語法

HRESULT GetFastestRate(
  [in]  MFRATE_DIRECTION eDirection,
  [in]  BOOL             fThin,
  [out] float            *pflRate
);

參數

[in] eDirection

指定是否要查詢最快速的向前播放速率或反向播放速率。 值是 MFRATE_DIRECTION 列舉的成員。

[in] fThin

如果 為 TRUE，此方法會擷取最快的精簡播放速率。 否則，方法會擷取最快的非精簡播放速率。 如需精簡的詳細資訊，請參閱 關於速率控制。

[out] pflRate

接收物件支援的最快播放速率。

傳回值

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

傳回碼 描述
S_OK
 此方法已成功。
MF_E_REVERSE_UNSUPPORTED
 物件不支援反向播放。
MF_E_THINNING_UNSUPPORTED
 物件不支援精簡。

備註

對於某些格式 (例如 ASF) ，精簡表示卸載不是 I 框架的所有畫面。 如果元件產生串流資料，例如媒體來源或解構器，它應該注意 fThin 參數，並在無法精簡資料流程時傳回MF_E_THINNING_UNSUPPORTED。

如果元件處理或接收資料流程 (大部分的轉換或媒體接收) ，如果它不小心資料流程是否已精簡，它可能會忽略此參數。 在媒體會話的速率支援實作中，如果轉換未明確支援反向播放，媒體會話會嘗試以精簡來反向播放，但不需要精簡。 因此，大部分的應用程式會在使用媒體會話進行反向播放時，將 fThin 設定為 TRUE 。

如果 eDirection MFRATE_REVERSE，此方法會擷取最快的反向播放速率。 這是負值，假設物件支援反向播放。

需求

   
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mfuuid.lib

另請參閱

如何判斷支援的速率

IMFRateSupport