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

Article
03/04/2024

Retourne les niveaux de volume pour la voix, par canal.

Syntaxe

\\ void GetChannelVolumes(
  [in]  UINT32 Channels,
  [out] float  *pVolumes
);

Paramètres

[in] Channels

Confirme le nombre de canaux de la voix.

[out] pVolumes

Retourne le niveau de volume actuel de chaque canal dans la voix. Le tableau doit avoir au moins des éléments Channels . Pour plus d’informations sur les niveaux de volume, consultez Remarques.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Ces paramètres sont appliqués après l’application de la chaîne d’effets. Cette méthode est valide uniquement pour les voix sources et les voix de sous-mixage, car le mastering des voix ne spécifie pas de volume par canal.

Les niveaux de volume sont exprimés sous forme de multiplicateurs d’amplitude à virgule flottante compris entre -2²⁴ et 2²⁴, avec un gain maximal de 144,5 dB. Un volume de 1 signifie qu’il n’y a pas d’atténuation ou de gain, 0 signifie silence, et des niveaux négatifs peuvent être utilisés pour inverser la phase de l’audio. Pour plus d’informations sur le contrôle de volume, consultez Contrôle de volume et de tangage XAudio2 .

RemarqueGetChannelVolumes retourne toujours les niveaux de volume les plus récemment définis par IXAudio2Voice ::SetChannelVolumes. Toutefois, ces valeurs peuvent ne pas encore être appliquées : elles ne prennent effet que la prochaine fois que le moteur audio s’exécute après l’appel IXAudio2Voice ::SetChannelVolumes (ou après l’appel IXAudio2 ::CommitChanges correspondant, si IXAudio2Voice ::SetChannelVolumes a été appelé avec un ID d’opération différé).

Configuration requise pour la plateforme

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	xaudio2.h

Voir aussi

IXAudio2Voice

Partager via