Partager via


Vue d’ensemble de XAPOFX

XAPOFX est une collection d’effets audio implémentant les interfaces XAPO à utiliser dans XAudio2. XAPOFX contient plusieurs effets et un mécanisme commun pour créer des instances d’effet.

Effets inclus

Le tableau suivant décrit les effets inclus dans XAPOFX.

Effet Description Structure des paramètres Constantes de paramètre Configuration requise
FXECHO Effet d’écho. FXECHO_PARAMETERS Constantes FXECHO Prend uniquement en charge les formats audio FLOAT32.
FXEQ Un égaliseur à quatre bandes. FXEQ_PARAMETERS Constantes FXEQ Prend uniquement en charge les formats audio FLOAT32. Le taux d’échantillonnage doit être compris entre 22 000 Hz et 48 000 Hz.
FXMasteringLimiter Limiteur de volume. FXMASTERINGLIMITER_PARAMETERS FXMASTERINGLIMIT, constantes Prend uniquement en charge les formats audio FLOAT32.
FXReverb Effet réverbération simple.
XAudio2 fournit également un effet implémentant Princeton Digital Reverb qui peut être instancié avec XAudio2CreateReverb.
FXREVERB_PARAMETERS Constantes FXREVERB Prend uniquement en charge les formats audio FLOAT32. En outre, il prend uniquement en charge l’entrée mono en sortie mono et l’entrée stéréo dans la sortie stéréo.

 

Création d’une instance d’un effet inclus dans XAPOFX

XAPOFX fournit la fonction CreateFX comme mécanisme commun de création d’instances d’effet. CreateFX prend le CLSID d’un effet et retourne un pointeur d’interface IUnknown vers une instance de l’effet.

Utilisation de XAPOFX dans XAudio2

Les effets instanciés avec CreateFX sont utilisés dans XAudio2 en les attachant à des voix. Chaque voix XAudio2 a une chaîne d’effets contenant zéro ou plusieurs effets audio. Les données audio envoyées à une voix sont transmises à chaque effet de la chaîne avant d’être envoyées aux cibles de sortie de la voix. La voix prend la sortie de chaque effet et la alimente dans l’effet suivant dans la chaîne jusqu’à ce qu’aucun effet ne soit laissé dans la chaîne. Pour attacher un effet XAPOFX à une voix XAudio2, remplissez une structure XAUDIO2_EFFECT_CHAIN avec les informations de l’effet et transmettez-la à IXAudio2Voice::SetEffectChain.

Pour plus d’informations sur les chaînes d’effets XAudio2, consultez Effets audio XAudio2.

Pour obtenir un exemple d’utilisation de XAPOFX dans XAudio2, consultez How to: Use XAPOFX in XAudio2.

Effets implicites XAudio2

En plus de la bibliothèque de XAPOs fournie par XAPOFX, XAudio2 a des effets audio intégrés de réverbération et de compteur de volume. Vous pouvez créer ces effets intégrés avec XAudio2CreateReverb et XAudio2CreateVolumeMeter. Découvrez comment : créer une chaîne d’effets pour obtenir un exemple d’utilisation de l’un de ces effets intégrés.

Effets audio