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

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

構文

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

パラメーター

[out] pfLevel

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

戻り値

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

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

解説

外部イベントによってマスター ボリュームが変更された場合、オーディオ レンダラーは MEAudioSessionVolumeChanged イベントを送信し、メディア セッションがアプリケーションに転送します。

要件

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

関連項目

IMFSimpleAudioVolume

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