IXAudio2Voice::SetOutputVoices, méthode (xaudio2.h)

Désigne un nouvel ensemble de voix de sous-mixage ou de mastering pour recevoir la sortie de la voix.

Syntaxe

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

Paramètres

[in] pSendList

Tableau de pointeurs de structure XAUDIO2_VOICE_SENDS vers les voix de destination. Si pSendList a la valeur NULL, la voix envoie sa sortie à la voix de mastering actuelle. Pour que la voix n’envoie sa sortie nulle part, définissez le membre OutputCount de XAUDIO2_VOICE_SENDS sur 0. Toutes les voix d’une liste d’envoi doivent avoir le même taux d’échantillonnage d’entrée. Pour plus d’informations, consultez Conversions de taux d’échantillonnage XAudio2 .

Valeur retournée

Retourne S_OK en cas de réussite, un code d’erreur dans le cas contraire. Consultez Codes d’erreur XAudio2 pour obtenir une description des codes d’erreur spécifiques à XAudio2.

Remarques

Cette méthode n’est valide que pour les voix source et de sous-mixage. Le mastering des voix ne peut pas envoyer l’audio à une autre voix.

Après avoir appelé SetOutputVoices, les niveaux d’envoi actuels d’une voix sont remplacés par une matrice d’envoi par défaut. La méthode IXAudio2Voice::SetOutputMatrix doit être appelée pour définir une matrice personnalisée pour la nouvelle sendlist.

Il n’est pas valide d’appeler SetOutputVoices à partir d’un rappel (autrement dit, IXAudio2EngineCallback ou IXAudio2VoiceCallback). Si SetOutputVoices est appelé dans un rappel, il retourne XAUDIO2_E_INVALID_CALL.

Note L’appel de SetOutputVoices invalide toutes les matrices d’envoi précédemment définies avec IXAudio2Voice::SetOutputMatrix.

 

Configuration requise pour la plateforme

Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Spécifications

Plateforme cible	Windows
En-tête	xaudio2.h

Voir aussi

IXAudio2Voice