IXAudio2Voice::GetChannelVolumes

チャンネルごとのボイスのボリューム レベルを返します。

void 
GetChannelVolumes(
  UINT32 Channels,
  float *pVolumes
);

パラメータ

• Channels
  ボイスのチャンネル数を確認します。
• pVolumes
  ボイス内の各チャンネルの現在のボリューム レベルを返します。この配列には、少なくとも Channels 要素が必要です。ボリューム レベルの詳細については、「備考」を参照してください。

戻り値

なし。

解説　

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

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

注    IXAudio2Voice::SetChannelVolume の呼び出しによってチャンネル ボリュームを変更した直後に IXAudio2Voice::GetChannelVolumes を呼び出すと、新しい値が返されますが、次にオーディオ エンジンを実行するまで変更が反映されない場合があります。これは、パラメーターが非同期的に設定されるためです。

要件

ヘッダー: XAudio2.h 宣言

関連項目

IXAudio2Voice