次の方法で共有

IXAudio2Voice::GetOutputMatrix

  • [アーティクル]

ボイスの最終出力の各チャンネルのボリューム レベルを取得します。これらのチャンネルは、指定されたデスティネーション ボイスの入力チャンネルにマップされます。

void 
GetOutputMatrix(
  IXAudio2Voice *pDestinationVoice,
  UINT32 SourceChannels,
  UINT32 DestinationChannels,
  float *pLevelMatrix
);

パラメータ

  • pDestinationVoice
    ボリューム レベルを取得するデスティネーション IXAudio2Voice へのポインターです。 注    ボイス (ソースまたはサブミックス) を既定のマスター ボイスに送信する場合、マスター ボイスは NULL pSendList で作成されているので、pDestinationVoice を NULL に設定すると、既定の送信処理で動作します。
  • SourceChannels
    ボイスの出力チャンネル数を確認します。これは、チェーン内の最後のエフェクトによって生成されるチャンネルの数です。
  • DestinationChannels
    デスティネーション ボイスの入力チャンネル数を確認します。
  • pLevelMatrix
    デスティネーション ボイスに送信される [SourceChannels * DestinationChannels] ボリューム レベルの配列。ソース チャンネル S からデスティネーション チャンネル D に送信されるレベルは、pLevelMatrix[DestinationChannels×S+D] の形式で返されます。ボリューム レベルの詳細については、「備考」を参照してください。

戻り値

なし。

解説　

マスター ボイスは、マトリックス ミックスなしでデバイスに直接書き込むため、このメソッドは、ソース ボイスおよびサブミックス ボイスにのみ適用されます。

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

注    IXAudio2Voice::SetOutputMatrix の呼び出しによって出力マトリックスを変更した直後に IXAudio2Voice::GetOutputMatrix を呼び出すと、新しい値が返されますが、次にオーディオ エンジンを実行するまで変更が反映されない場合があります。これは、パラメーターが非同期的に設定されるためです。

要件

ヘッダー: XAudio2.h 宣言

関連項目

IXAudio2Voice