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

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

 

オーディオ ボリュームを設定します。

構文

HRESULT SetVolume(
  [in] float flVolume
);

パラメーター

[in] flVolume

ボリューム レベル。 ボリュームは減衰レベルとして表されます。0.0 は無音を示し、1.0 は完全なボリューム (減衰なし) を示します。

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
MF_E_OUT_OF_RANGE	flVolume パラメーターが無効です。

注釈

再生を開始する前にこのメソッドを呼び出すと、再生の開始後に設定が適用されます。

このメソッドは、プレーヤーのオーディオ セッションのマスター ボリューム レベルを変更しません。 代わりに、現在のメディア項目に属するオーディオ ストリームのチャネルごとのボリューム レベルを調整します。 オーディオ セッション内の他のストリームは影響を受けません。 詳細については、「 オーディオ セッションの管理」を参照してください。

要件

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

こちらもご覧ください

IMFPMediaPlayer

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