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
Library Mfuuid.lib

関連項目

サポートされている料金を確認する方法

IMFRateSupport