structure XAUDIO2_VOICE_SENDS (xaudio2.h)

Article
08/28/2023

Définit un ensemble de voix pour recevoir les données d’une seule voix de sortie.

Syntaxe

typedef struct XAUDIO2_VOICE_SENDS {
  UINT32                  SendCount;
  XAUDIO2_SEND_DESCRIPTOR *pSends;
} XAUDIO2_VOICE_SENDS;

Membres

SendCount

Nombre de voix pour recevoir la sortie de la voix. Une valeur OutputCount de 0 indique que la voix ne doit pas envoyer de sortie à des voix.

pSends

Tableau de structures XAUDIO2_SEND_DESCRIPTOR décrivant les voix de destination et les filtres à utiliser lors de l’envoi aux voix. Ce tableau doit contenir des éléments SendCount . Si SendCount est 0 pSends doit avoir la valeur NULL. Notez que pSends ne peut pas contenir la même voix plusieurs fois.

Remarques

Si pSends n’a pas la valeur NULL, tous ses éléments doivent être non NULL. Pour envoyer la sortie au mastering vocal par défaut, appelez IXAudio2Voice::SetOutputVoices avec l’argument pSendList défini sur NULL.

La définition de SendCount sur 0 est utile pour certains effets tels que les compteurs de volume ou les enregistreurs de fichiers qui ne génèrent aucune sortie audio à transmettre à une autre voix.

Si nécessaire, une voix effectue une conversion de taux d’échantillonnage unique, du taux d’échantillonnage d’entrée de la voix au taux d’échantillonnage d’entrée des voix de sortie de la voix. Étant donné qu’une seule conversion de taux d’échantillonnage est effectuée, toutes les voix de sortie de la voix doivent avoir le même taux d’échantillonnage d’entrée. Si les taux d’échantillonnage d’entrée de la voix et de ses voix de sortie sont les mêmes, aucune conversion de taux d’échantillonnage n’est effectuée.