IMFSimpleAudioVolume::SetMasterVolume メソッド (mfidl.h)

マスター ボリューム レベルを設定します。

構文

HRESULT SetMasterVolume(
  [in] float fLevel
);

パラメーター

[in] fLevel

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

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
MF_E_NOT_INITIALIZED	オーディオ レンダラーが初期化されていません。
MF_E_STREAMSINK_REMOVED	オーディオ レンダラーがパイプラインから削除されました。

解説

アプリケーションの外部のイベントは、マスター ボリューム レベルを変更できます。 たとえば、ユーザーはシステム ボリューム制御プログラム (SndVol) からボリュームを変更できます。 外部イベントによってマスター ボリュームが変更された場合、オーディオ レンダラーは MEAudioSessionVolumeChanged イベントを送信し、メディア セッションがアプリケーションに転送します。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mfuuid.lib

関連項目

IMFSimpleAudioVolume

ストリーミング オーディオ レンダラー