> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XDspActivationParameters

> XDspActivationParameters

# XDspActivationParameters

Paramètres d'activation XDSP.

## Syntaxe

```cpp theme={null}
typedef struct XDspActivationParameters {  
    XDspProcessType type;  
    XDspActivationOptions options;  
    uint32_t blockFrameCount;  
    uint32_t channelCount;  
    uint32_t impulseResponseLengthInFloats;  
    float* impulseResponse;  
} XDspActivationParameters  
```

### Membres

*type*\
Type : [XDspProcessType](/fr/reference/audio/xdspaudio/enums/xdspprocesstype)

Pour chaque activation, il n'existe qu'un seul type de traitement valide. Par exemple, si une FFT directe et une FFT inverse sont nécessaires, deux flux XDSP doivent être activés, un pour chaque type.

*options*\
Type : [XDspActivationOptions](/fr/reference/audio/xdspaudio/enums/xdspactivationoptions)

Options d'activation.

*blockFrameCount*\
Type : uint32\_t

Nombre de trames par bloc de données d'entrée et de sortie qui seront transmis à XDSP via [XDspSubmitCommand](/fr/reference/audio/xdspaudio/functions/xdspsubmitcommand). Cette valeur doit être une puissance de deux. 512 et 1024 sont les valeurs prises en charge pour [XDspProcessType::Convolution](/fr/reference/audio/xdspaudio/enums/xdspprocesstype). 512, 1024 et 2048 sont les valeurs prises en charge pour [XDspProcessType::ForwardFourierTransform](/fr/reference/audio/xdspaudio/enums/xdspprocesstype) et [XDspProcessType::InverseFourierTransform](/fr/reference/audio/xdspaudio/enums/xdspprocesstype).

*channelCount*\
Type : uint32\_t

1 pour un flux d'entrée mono ou 2 pour un flux d'entrée stéréo pour [XDspProcessType::Convolution](/fr/reference/audio/xdspaudio/enums/xdspprocesstype). Cette valeur doit toujours être définie sur 1 pour [XDspProcessType::ForwardFourierTransform](/fr/reference/audio/xdspaudio/enums/xdspprocesstype) et [XDspProcessType::InverseFourierTransform](/fr/reference/audio/xdspaudio/enums/xdspprocesstype).

*impulseResponseLengthInFloats*\
Type : uint32\_t

Longueur de la réponse impulsionnelle qui sera utilisée lors du traitement [XDspProcessType::Convolution](/fr/reference/audio/xdspaudio/enums/xdspprocesstype), en unités de floats. Par exemple, si la réponse impulsionnelle contient `N` échantillons de paires de valeurs float complexes, cette valeur doit être définie sur `N * 2`, car chaque paire de valeurs float complexes est représentée par deux floats. Pour [XDspProcessType::ForwardFourierTransform](/fr/reference/audio/xdspaudio/enums/xdspprocesstype) et [XDspProcessType::InverseFourierTransform](/fr/reference/audio/xdspaudio/enums/xdspprocesstype), ce paramètre doit être égal à zéro.

*impulseResponse*\
Type : float\*

Mémoire tampon d'une longueur de (`impulseResponseLengthInFloats * sizeof(float)`) octets qui contient la réponse impulsionnelle sous forme d'une série de valeurs float complexes (paires de valeurs réelles et imaginaires). Cela signifie que la mémoire tampon contiendra (`impulseResponseLengthInFloats / 2`) paires de valeurs float complexes. La longueur de la mémoire tampon doit être de (`impulseResponseLengthInFloats * sizeof(float) * channelCount`) octets si [XDspActivationOptions::StereoImpulseResponse](/fr/reference/audio/xdspaudio/enums/xdspactivationoptions) est défini et que [XDspActivationParameters::channelCount](/fr/reference/audio/xdspaudio/structs/xdspactivationparameters) est égal à 2. Pour [XDspProcessType::ForwardFourierTransform](/fr/reference/audio/xdspaudio/enums/xdspprocesstype) et [XDspProcessType::InverseFourierTransform](/fr/reference/audio/xdspaudio/enums/xdspprocesstype), ce paramètre doit être défini sur nullptr. Cette mémoire tampon ne doit pas nécessairement provenir du *baseBuffer* inscrit par [XDspConnect](/fr/reference/audio/xdspaudio/functions/xdspconnect).

## Configuration requise

**En-tête :** XDspAudio.h

**Plateformes prises en charge :** XBOX Series X|S

## Documentation conceptuelle

* [Vue d'ensemble de la réduction de la réponse impulsionnelle XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-ir-reduction)
* [Vue d'ensemble d'une convolution avec enveloppe sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [Vue d'ensemble d'une convolution sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)

## Voir aussi

[XDSP](/fr/reference/audio/xdspaudio/xdspaudio_members)\
[XDspProcessType](/fr/reference/audio/xdspaudio/enums/xdspprocesstype)\
[XDspActivationOptions](/fr/reference/audio/xdspaudio/enums/xdspactivationoptions)\
[XDspSubmitCommand](/fr/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[XDspActivationParameters](/fr/reference/audio/xdspaudio/structs/xdspactivationparameters)\
[XDspConnect](/fr/reference/audio/xdspaudio/functions/xdspconnect)\
[Vue d'ensemble d'une convolution sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[Vue d'ensemble d'une FFT/IFFT sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)


## Related topics

- [XDspActivationParameters](/reference/audio/xdspaudio/structs/xdspactivationparameters.md)
- [XDspActivationOptions](/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate.md)
