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

  • [アーティクル]

音声の最終的な出力の各チャネルのボリューム レベルを取得します。 これらのチャネルは、指定された宛先音声の入力チャネルにマップされます。

構文

\\ void GetOutputMatrix(
  [in]  IXAudio2Voice *pDestinationVoice,
  [in]  UINT32        SourceChannels,
  [in]  UINT32        DestinationChannels,
  [out] float         *pLevelMatrix
);

パラメーター

[in] pDestinationVoice

出力マトリックスを取得する宛先 IXAudio2Voice を指定するポインター。

メモ 音声が 1 つのターゲット音声に送信される場合、NULL を指定すると 、GetOutputMatrix がそのターゲット音声に対して動作します。
 

[in] SourceChannels

音声の出力チャネル数を確認します。 これは、チェーン内の最後の効果によって生成されるチャネルの数です。

[in] DestinationChannels

宛先音声の入力チャネル数を確認します。

[out] pLevelMatrix

宛先音声に送信される [SourceChannels * DestinationChannels] ボリューム レベルの配列。 ソース チャネル S から宛先チャネル D に送信されたレベルは、 pLevelMatrix[DestinationChannels × S + D] の形式で返されます。 ボリューム レベルの詳細については、「解説」を参照してください。

戻り値

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

解説

このメソッドは、マスター音声がマトリックス 混合なしでデバイスに直接書き込まれるため、ソースとサブミックスの音声にのみ適用されます。

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

標準チャネルの順序については 、「WAVEFORMATEXTENSIBLE 」を参照してください。

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

プラットフォームの要件

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

要件

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

こちらもご覧ください

IXAudio2Voice