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

Article
03/13/2024

Obtient le niveau de volume de chaque canal de la sortie finale pour la voix. Ces canaux sont mappés aux canaux d’entrée d’une voix de destination spécifiée.

Syntaxe

\\ void GetOutputMatrix(
  [in]  IXAudio2Voice *pDestinationVoice,
  [in]  UINT32        SourceChannels,
  [in]  UINT32        DestinationChannels,
  [out] float         *pLevelMatrix
);

Paramètres

[in] pDestinationVoice

Pointeur spécifiant la destination IXAudio2Voice pour laquelle récupérer la matrice de sortie.

Note Si la voix envoie à une seule voix cible, la spécification de NULL entraîne l’action de GetOutputMatrix sur cette voix cible.

[in] SourceChannels

Confirme le nombre de canaux de sortie de la voix. Il s’agit du nombre de canaux produits par le dernier effet de la chaîne.

[in] DestinationChannels

Confirme le nombre de canaux d’entrée de la voix de destination.

[out] pLevelMatrix

Tableau de niveaux de volume [SourceChannels * DestinationChannels] envoyés à la voix de destination. Le niveau envoyé du canal source S au canal de destination D est retourné sous la forme pLevelMatrix[DestinationChannels × S + D]. Pour plus d’informations sur les niveaux de volume, consultez Remarques.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Cette méthode s’applique uniquement aux voix sources et aux voix de sous-mixage, car le mastering des voix écrit directement sur l’appareil sans mélange de matrice.

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 niveau de volume de 1 signifie qu’il n’y a pas d’atténuation ou de gain et que 0 signifie silence. Les niveaux négatifs peuvent être utilisés pour inverser la phase audio. Pour plus d’informations sur le contrôle de volume, consultez Contrôle de volume et de tangage XAudio2 .

Pour plus d’informations sur le classement des canaux standard, consultez WAVEFORMATEXTENSIBLE .

RemarqueGetOutputMatrix retourne toujours les niveaux les plus récemment définis par IXAudio2Voice ::SetOutputMatrix. Toutefois, elles ne sont peut-être pas encore en vigueur : elles ne prennent effet que la prochaine fois que le moteur audio s’exécute après l’appel IXAudio2Voice ::SetOutputMatrix (ou après l’appel IXAudio2 ::CommitChanges correspondant, si IXAudio2Voice ::SetOutputMatrix 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