Metode IXAudio2Voice::SetOutputVoices (xaudio2.h)

Menunjuk sekumpulan submix baru atau suara yang menguasai untuk menerima output suara.

Sintaks

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

Parameter

[in] pSendList

Array XAUDIO2_VOICE_SENDS penunjuk struktur ke suara tujuan. Jika pSendList NULL, suara akan mengirim outputnya ke suara mastering saat ini. Untuk mengatur suara agar tidak mengirim outputnya di mana saja atur anggota OutputCountXAUDIO2_VOICE_SENDS ke 0. Semua suara dalam daftar kirim harus memiliki laju sampel input yang sama, lihat Konversi Laju Sampel XAudio2 untuk informasi tambahan.

Menampilkan nilai

Mengembalikan S_OK jika berhasil, kode kesalahan sebaliknya. Lihat Kode Kesalahan XAudio2 untuk deskripsi kode kesalahan spesifik XAudio2.

Keterangan

Metode ini hanya berlaku untuk suara sumber dan submix. Suara master tidak dapat mengirim audio ke suara lain.

Setelah memanggil SetOutputVoices , tingkat pengiriman suara saat ini akan digantikan oleh matriks kirim default. Metode IXAudio2Voice::SetOutputMatrix harus dipanggil untuk mengatur matriks kustom untuk daftar kirim baru.

Tidak valid untuk memanggil SetOutputVoices dari dalam panggilan balik (yaitu, IXAudio2EngineCallback atau IXAudio2VoiceCallback). Jika SetOutputVoices dipanggil dalam panggilan balik, setOutputVoices akan mengembalikan XAUDIO2_E_INVALID_CALL.

Catatan Memanggil SetOutputVoices membatalkan matriks pengiriman yang sebelumnya diatur dengan IXAudio2Voice::SetOutputMatrix.

 

Persyaratan Platform

Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Persyaratan

Target Platform	Windows
Header	xaudio2.h

Lihat juga

IXAudio2Voice