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 |