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

チャネルごとの音声の音量レベルを返します。

構文

\\ void GetChannelVolumes(
  [in]  UINT32 Channels,
  [out] float  *pVolumes
);

パラメーター

[in] Channels

音声のチャネル数を確認します。

[out] pVolumes

音声内の各チャネルの現在の音量レベルを返します。 配列には、少なくとも Channels 要素が必要です。 ボリューム レベルの詳細については、「解説」を参照してください。

戻り値

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

解説

これらの設定は、エフェクト チェーンが適用された後に適用されます。 このメソッドは、マスタリング音声ではチャネルごとにボリュームが指定されないため、ソース音声とサブミックス音声に対してのみ有効です。

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

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

 

プラットフォームの要件

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

要件

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

こちらもご覧ください

IXAudio2Voice