共用方式為


IXAudio2Voice::SetOutputVoices 方法 (xaudio2.h)

指定一組新的副混音或主音,以接收語音的輸出。

語法

\\HRESULT SetOutputVoices(
  [in] const XAUDIO2_VOICE_SENDS *pSendList
);

參數

[in] pSendList

目的地語音 的XAUDIO2_VOICE_SENDS 結構指標陣列。 如果 pSendList 為 Null,語音會將其輸出傳送至目前的主控語音。 若要將語音設定為不要在任何地方傳送其輸出,請將XAUDIO2_VOICE_SENDSOutputCount成員設定為 0。 傳送清單中的所有語音都必須具有相同的輸入取樣率,如需詳細資訊,請參閱 XAudio2 取樣率轉換

傳回值

如果成功,則傳回S_OK,否則傳回錯誤碼。 如需 XAudio2 特定錯誤碼的描述,請參閱 XAudio2 錯誤 碼。

備註

這個方法只適用于來源和副混音。 主控語音無法將音訊傳送至另一個語音。

呼叫 SetOutputVoices 之後,語音目前的傳送層級將會由預設傳送矩陣取代。 必須呼叫 IXAudio2Voice::SetOutputMatrix 方法,才能為新的 sendlist 設定自訂矩陣。

從回呼 (呼叫 SetOutputVoices 無效,也就是 IXAudio2EngineCallbackIXAudio2VoiceCallback) 。 如果在回呼內呼叫 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