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.
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 |