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

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