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

另請參閱

IXAudio2Voice