> ## 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-CA/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 requises, deux flux XDSP doivent être activés, un pour chaque type.

*options*\
Type : [XDspActivationOptions](/fr-CA/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 seraient transmises à XDSP au moyen de [XDspSubmitCommand](/fr-CA/reference/audio/xdspaudio/functions/xdspsubmitcommand). Cette valeur doit être une puissance de deux. Les valeurs prises en charge sont 512 et 1024 pour [XDspProcessType::Convolution](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype). Les valeurs prises en charge sont 512, 1024 et 2048 pour [XDspProcessType::ForwardFourierTransform](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype) et [XDspProcessType::InverseFourierTransform](/fr-CA/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-CA/reference/audio/xdspaudio/enums/xdspprocesstype). Cette valeur doit toujours être définie sur 1 pour [XDspProcessType::ForwardFourierTransform](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype) et [XDspProcessType::InverseFourierTransform](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype).

*impulseResponseLengthInFloats*\
Type : uint32\_t

Longueur de la réponse impulsionnelle qui sera utilisée pendant le traitement [XDspProcessType::Convolution](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype), en unités de nombres à virgule flottante. Par exemple, si la réponse impulsionnelle contient `N` échantillons de paires de valeurs complexes à virgule flottante, cette valeur doit être définie sur `N * 2`, puisque chaque paire de valeurs complexes est représentée à l'aide de deux nombres à virgule flottante. Pour [XDspProcessType::ForwardFourierTransform](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype) et [XDspProcessType::InverseFourierTransform](/fr-CA/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 complexes à virgule flottante (paires de valeurs réelles et imaginaires). Cela signifie que la mémoire tampon contiendra (`impulseResponseLengthInFloats / 2`) paires de valeurs complexes à virgule flottante. La longueur de la mémoire tampon doit être de (`impulseResponseLengthInFloats * sizeof(float) * channelCount`) octets si [XDspActivationOptions::StereoImpulseResponse](/fr-CA/reference/audio/xdspaudio/enums/xdspactivationoptions) est défini et que [XDspActivationParameters::channelCount](/fr-CA/reference/audio/xdspaudio/structs/xdspactivationparameters) est égal à 2. Pour [XDspProcessType::ForwardFourierTransform](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype) et [XDspProcessType::InverseFourierTransform](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype), ce paramètre doit être défini sur nullptr. Cette mémoire tampon n'a pas besoin de provenir du *baseBuffer* inscrit par [XDspConnect](/fr-CA/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-CA/build/console-features/audio/overviews/xdsp-overview-ir-reduction)
* [Vue d'ensemble d'une convolution à flux unique avec enveloppe à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [Vue d'ensemble d'une convolution à flux unique à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)

## Voir aussi

[XDSP](/fr-CA/reference/audio/xdspaudio/xdspaudio_members)\
[XDspProcessType](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype)\
[XDspActivationOptions](/fr-CA/reference/audio/xdspaudio/enums/xdspactivationoptions)\
[XDspSubmitCommand](/fr-CA/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[XDspActivationParameters](/fr-CA/reference/audio/xdspaudio/structs/xdspactivationparameters)\
[XDspConnect](/fr-CA/reference/audio/xdspaudio/functions/xdspconnect)\
[Vue d'ensemble d'une convolution à flux unique à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[Vue d'ensemble d'une FFT/IFFT à flux unique à l'aide de l'API XDSP](/fr-CA/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)
