IXAudio2Voice::SetOutputVoices 方法 (xaudio2.h)
指定一組新的副混音或主音,以接收語音的輸出。
語法
\\HRESULT SetOutputVoices(
[in] const XAUDIO2_VOICE_SENDS *pSendList
);
參數
[in] pSendList
目的地語音 的XAUDIO2_VOICE_SENDS 結構指標陣列。 如果 pSendList 為 Null,語音會將其輸出傳送至目前的主控語音。 若要將語音設定為不要在任何地方傳送其輸出,請將XAUDIO2_VOICE_SENDS的OutputCount成員設定為 0。 傳送清單中的所有語音都必須具有相同的輸入取樣率,如需詳細資訊,請參閱 XAudio2 取樣率轉換 。
傳回值
如果成功,則傳回S_OK,否則傳回錯誤碼。 如需 XAudio2 特定錯誤碼的描述,請參閱 XAudio2 錯誤 碼。
備註
這個方法只適用于來源和副混音。 主控語音無法將音訊傳送至另一個語音。
呼叫 SetOutputVoices 之後,語音目前的傳送層級將會由預設傳送矩陣取代。 必須呼叫 IXAudio2Voice::SetOutputMatrix 方法,才能為新的 sendlist 設定自訂矩陣。
從回呼 (呼叫 SetOutputVoices 無效,也就是 IXAudio2EngineCallback 或 IXAudio2VoiceCallback) 。 如果在回呼內呼叫 SetOutputVoices ,則會傳回XAUDIO2_E_INVALID_CALL。
注意 呼叫 SetOutputVoices 會使先前以 IXAudio2Voice::SetOutputMatrix設定的任何傳送矩陣失效。
平臺需求
Windows 8,Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)規格需求
目標平台 | Windows |
標頭 | xaudio2.h |