共用方式為

IXAudio2Voice：：GetOutputMatrix 方法 (xaudio2.h)

  • 發行項

取得語音最終輸出之每個通道的音量層級。 這些通道會對應至指定目的地語音的輸入通道。

語法

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

參數

[in] pDestinationVoice

指定要擷取輸出矩陣之目的地 IXAudio2Voice 的指標。

注意 如果語音傳送至單一目標語音，則指定 NULL 會導致 GetOutputMatrix 在該目標語音上運作。
 

[in] SourceChannels

確認語音的輸出通道計數。 這是鏈結中最後一個效果所產生的通道數目。

[in] DestinationChannels

確認目的地語音的輸入通道計數。

[out] pLevelMatrix

傳送至目的地語音的 [SourceChannels DestinationChannels * ] 音量層級陣列。 從來源通道 S 傳送至目的地通道 D 的層級會以 pLevelMatrix[DestinationChannels × S + D 格式傳回。 如需磁碟區層級的詳細資訊，請參閱。

傳回值

這個方法不會傳回值。

備註

這個方法只適用於來源和副混音，因為主控語音會直接寫入沒有矩陣混合的裝置。

磁碟區層級會以 -2¹⁴ 到 2⁴ 之間的浮點幅度乘數表示，最大增益為 144.5 dB。 音量層級為 1 表示沒有衰減或增益，而 0 表示無聲。 負數等級可用來反轉音訊的階段。 如需音量控制的其他資訊，請參閱 XAudio2 音量和音調控制 。

如需標準通道排序的資訊，請參閱 其為「」。 」

注意GetOutputMatrix 一律會傳回 最近由IXAudio2Voice：：SetOutputMatrix 設定的層級。 不過，它們可能實際上並未生效：只有在 IXAudio2Voice：：SetOutputMatrix 呼叫 (或對應的 IXAudio2：：CommitChanges 呼叫之後，如果 IXAudio2Voice：：SetOutputMatrix 是以延遲的作業標識符呼叫) ，則只會在下一次執行音訊引擎時生效。
 

平臺需求

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

規格需求

需求 值
目標平台 Windows
標頭 xaudio2.h

另請參閱

IXAudio2Voice