IXAudio2Voice::GetChannelVolumes メソッド
チャンネルごとのボイスのボリューム レベルを返します。
構文
void GetChannelVolumes( UINT32 Channels, float *pVolumes)
パラメーター
- Channels
[in] ボイスのチャンネル数を確認します。 - pVolumes
[out] ボイス内の各チャンネルの現在のボリューム レベルを返します。この配列には、少なくとも Channels 要素が必要です。ボリューム レベルの詳細については、「備考」を参照してください。
戻り値
なし。
解説
これらの設定は、エフェクト チェーンの適用後に反映されます。マスター ボイスでは、チャンネルごとにボリュームを指定しないため、このメソッドは、ソース ボイスおよびサブミックス ボイスに対してのみ有効です。
ボリューム レベルは、-224 ～ 224 の浮動小数点振幅逓倍として表現され、最大ゲインは 144.5 dB です。1 のボリュームは、減衰またはゲインがないことを意味します。0 のボリュームは無音を意味します。負のレベルは、オーディオのフェーズを反転させるために使用できます。ボリューム コントロールの詳細については、「XAudio2 のボリュームおよびピッチ コントロール」を参照してください。
注意
GetChannelVolumes は、常に、IXAudio2Voice::SetChannelVolumes によって最後に設定されたボリューム レベルを返します。ただし、これらの値は実際にはまだ適用されていない可能性があります。これらの値は、IXAudio2Voice::SetChannelVolumes 呼び出しの後 (または、IXAudio2Voice::SetChannelVolumes が遅延操作 ID を使用して呼び出された場合は、対応する IXAudio2::CommitChanges 呼び出しの後)、次にオーディオ エンジンが実行されたときに初めて適用されます。
要件
ヘッダー: XAudio2.h で宣言されています。