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 |