Partager via


Fonction X3DAudioCalculate (x3daudio.h)

Calcule les paramètres DSP par rapport aux paramètres 3D.

Syntaxe

X3DAUDIO_API_(void) X3DAudioCalculate(
  [in]      const X3DAUDIO_HANDLE   Instance,
  [in]      const X3DAUDIO_LISTENER *pListener,
  [in]      const X3DAUDIO_EMITTER  *pEmitter,
  [in]      UINT32                  Flags,
  [in, out] X3DAUDIO_DSP_SETTINGS   *pDSPSettings
);

Paramètres

[in] Instance

Poignée de instance audio 3D. Appelez X3DAudioInitialize pour obtenir ce handle.

[in] pListener

Pointeur vers un X3DAUDIO_LISTENER représentant le point de réception.

[in] pEmitter

Pointeur vers un X3DAUDIO_EMITTER représentant la source du son.

[in] Flags

Valeur Description
X3DAUDIO_CALCULATE_MATRIX Active le calcul de la table de coefficients de matrice. 
X3DAUDIO_CALCULATE_DELAY Active le calcul d’un tableau de temps de retard (stéréo uniquement). 
X3DAUDIO_CALCULATE_LPF_DIRECT Active le calcul du coefficient de chemin direct du filtre de passage bas (LPF). 
X3DAUDIO_CALCULATE_LPF_REVERB Active le calcul du coefficient de réverbération LPF. 
X3DAUDIO_CALCULATE_REVERB Active le calcul du niveau d’envoi de réverbération. 
X3DAUDIO_CALCULATE_DOPPLER Active le calcul du facteur de décalage Doppler. 
X3DAUDIO_CALCULATE_EMITTER_ANGLE Active le calcul de l’angle intérieur de l’émetteur à l’écouteur. 
X3DAUDIO_CALCULATE_ZEROCENTER Remplit le canal central de silence. Cet indicateur vous permet de conserver une matrice à 6 canaux afin que vous n’ayez pas à remapper les canaux, mais le canal central sera silencieux. Cet indicateur n’est valide que si vous définissez également X3DAUDIO_CALCULATE_MATRIX. 
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE Applique une combinaison égale de tous les canaux sources à un canal de destination À effet faible (LFE). Elle s’applique uniquement aux calculs de matrice avec une source qui n’a pas de canal LFE et une destination qui a un canal LFE. Cet indicateur n’est valide que si vous définissez également X3DAUDIO_CALCULATE_MATRIX. 

[in, out] pDSPSettings

Pointeur vers une structure X3DAUDIO_DSP_SETTINGS qui reçoit les résultats du calcul.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

Vous appelez généralement X3DAudioCalculate une fois pour chaque paire d’objets et d’écouteurs émetteurs dans la scène. Après chaque appel, pour appliquer les effets 3D, l’application applique manuellement les résultats de calcul dans pDSPSettings au graphique XAUDIO2. Pour plus d’informations, consultez Guide pratique pour intégrer X3DAudio à XAudio2.

Important Les valeurs de l’écouteur et de l’émetteur doivent être valides. Les éléments spéciaux à virgule flottante (NaN, QNaN, +INF, -INF) peuvent rendre la sortie audio entière silencieuse si elles sont introduites dans un graphique audio en cours d’exécution.
 

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)

Windows Phone 8.1 : cette API est prise en charge.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête x3daudio.h
Bibliothèque Xaudio2.lib

Voir aussi

Fonctions