IXAudio2Voice::GetVolume メソッド (xaudio2.h)

音声の現在の全体的な音量レベルを取得します。

構文

\\ void GetVolume(
  [out] float *pVolume
);

パラメーター

[out] pVolume

音声の現在の全体的な音量レベルを返します。 ボリューム レベルの詳細については、「解説」を参照してください。

戻り値

このメソッドは値を返しません。

解説

ボリューム レベルは-224 ~ 224 の浮動小数点振幅乗算器として表され、最大ゲインは 144.5 dB です。 ボリューム レベル 1 は、減衰またはゲインがないことを意味し、0 は無音を意味します。 負のレベルを使用して、オーディオの位相を反転できます。 ボリューム制御の詳細については、「 XAudio2 ボリュームとピッチコントロール 」を参照してください。

メモGetVolume は、 IXAudio2Voice::SetVolume によって最後に設定されたボリュームを常に返します。 ただし、実際には有効でない場合があります。これは、IXAudio2Voice::SetVolume 呼び出しの後 (または、IXAudio2Voice::SetVolume が遅延操作 ID で呼び出された場合は、対応する IXAudio2::CommitChanges 呼び出しの後) にオーディオ エンジンが次回実行されたときにのみ有効になります。

 

プラットフォームの要件

Windows 10 (XAudio2.9);Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)

要件

対象プラットフォーム	Windows
ヘッダー	xaudio2.h

関連項目

IXAudio2Voice