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.
Rubriques connexes