Share via

IXAudio2Voice::GetVolume メソッド

  • [アーティクル]

ボイスの現在の全体のボリューム レベルを取得します。

構文

void GetVolume(         float *pVolume)

パラメーター

  • pVolume
    [out] ボイスの現在の全体のボリューム レベルを返します。ボリューム レベルの詳細については、「備考」を参照してください。

戻り値

なし。

解説　

ボリューム レベルは、-224 ～ 224 の浮動小数点振幅逓倍として表現され、最大ゲインは 144.5 dB です。ボリューム レベル 1 は減衰またはゲインがないことを意味し、0 は無音を意味します。負のレベルは、オーディオのフェーズを反転させるために使用できます。ボリューム コントロールの詳細については、「XAudio2 のボリュームおよびピッチ コントロール」を参照してください。

注意

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

要件

ヘッダー: xaudio2.h で宣言されています。

関連項目

IXAudio2Voice