IMFPMediaPlayer::SetRate メソッド (mfplay.h)

大事な 廃止。 この API は、Windows の今後のリリースから削除される可能性があります。 アプリケーションでは、再生に メディア セッション を使用する必要があります。

 

再生速度を設定します。

構文

HRESULT SetRate(
  [in] float flRate
);

パラメーター

[in] flRate

再生速度。 再生レートは、現在のレートと通常のレートの比率で表されます。 たとえば、 1.0 は通常の再生速度を示し、 0.5 は半分の速度を示し、 2.0 は 2 倍の速度を示します。 正の値は前方再生を示し、負の値は逆再生を示します。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	メソッドが成功しました。
MF_E_OUT_OF_RANGE	flRate パラメーターは 0 です。
MF_E_SHUTDOWN	オブジェクトの Shutdown メソッドが呼び出されました。

注釈

このメソッドは非同期的に完了します。 操作が完了すると、アプリケーションの IMFPMediaPlayerCallback::OnMediaPlayerEvent コールバック メソッドが呼び出されます。 イベントの種類が MFP_EVENT_TYPE_RATE_SET。

メソッドは、サポートされている最も近いレートを設定します。これは、基になるメディア ソースによって異なります。 たとえば、 flRate が 50 で、ソースの最大レートが 8×通常のレートである場合、メソッドはレートを 8.0 に設定します。 実際のレートは、 MFP_EVENT_TYPE_RATE_SET イベントのイベント データに示されます。

サポートされているレートの範囲を見つけるには、 IMFPMediaPlayer::GetSupportedRates を呼び出します。

Media Foundation は他のコンテキストでゼロ レートの意味を定義しますが、このメソッドは 0 の再生レートをサポートしていません。

新しいレートは、現在のメディア項目にのみ適用されます。 新しいメディア項目を設定すると、再生速度が 1.0 にリセットされます。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfplay.h

こちらもご覧ください

IMFPMediaPlayer

オーディオ/ビデオ再生に MFPlay を使用する