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

# XDspActivationParameters

> XDspActivationParameters

# XDspActivationParameters

Parámetros de activación de XDSP.

## Sintaxis

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

### Miembros

*type*\
Tipo: [XDspProcessType](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md)

Para cada activación, solo hay un tipo de procesamiento válido. Por ejemplo, si se requiere la FFT directa e inversa, deben activarse dos secuencias de XDSP, una para cada tipo.

*options*\
Tipo: [XDspActivationOptions](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspactivationoptions.md)

Opciones de activación.

*blockFrameCount*\
Tipo: uint32\_t

Número de fotogramas por bloque de datos de entrada y salida que se pasaría a XDSP mediante [XDspSubmitCommand](https://docs.xbox.com/es/reference/audio/xdspaudio/functions/xdspsubmitcommand.md). Este valor debe ser una potencia de dos. 512 y 1024 son los valores admitidos para [XDspProcessType::Convolution](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md). 512, 1024 y 2048 son los valores admitidos para [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md) y [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md).

*channelCount*\
Tipo: uint32\_t

1 para una secuencia de entrada mono, o 2 para una secuencia de entrada estéreo para [XDspProcessType::Convolution](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md). Siempre debe establecerse en 1 para [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md) y [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md).

*impulseResponseLengthInFloats*\
Tipo: uint32\_t

Longitud de la respuesta al impulso que se usará durante el procesamiento de [XDspProcessType::Convolution](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md), en unidades de valores float. Por ejemplo, si la respuesta al impulso contiene `N` muestras de pares de valores float complejos, este valor debe establecerse en `N * 2`, ya que cada par de valores float complejos se representa mediante dos valores float. Para [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md) y [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md), este parámetro debe ser cero.

*impulseResponse*\
Tipo: float\*

Búfer de longitud (`impulseResponseLengthInFloats * sizeof(float)`) bytes que contiene la respuesta al impulso como una serie de valores float complejos (par de valores real e imaginario). Esto significa que el búfer tendrá (`impulseResponseLengthInFloats / 2`) pares de valores float complejos. La longitud del búfer debe ser (`impulseResponseLengthInFloats * sizeof(float) * channelCount`) bytes, si se establece [XDspActivationOptions::StereoImpulseResponse](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspactivationoptions.md) y [XDspActivationParameters::channelCount](https://docs.xbox.com/es/reference/audio/xdspaudio/structs/xdspactivationparameters.md) es igual a 2. Para [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md) y [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md), este parámetro debe establecerse en nullptr. Este búfer no tiene que proceder del *baseBuffer* registrado por [XDspConnect](https://docs.xbox.com/es/reference/audio/xdspaudio/functions/xdspconnect.md).

## Requisitos

**Encabezado:** XDspAudio.h

**Plataformas compatibles:** XBOX Series X|S

## Documentación conceptual

* [Información general de la reducción de la respuesta al impulso de XDSP](https://docs.xbox.com/es/build/console-features/audio/overviews/xdsp-overview-ir-reduction.md)
* [Información general de una convolución de secuencia única con envolvente mediante la API de XDSP](https://docs.xbox.com/es/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
* [Información general de una convolución de secuencia única mediante la API de XDSP](https://docs.xbox.com/es/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)

## Consulte también

[XDSP](https://docs.xbox.com/es/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspProcessType](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md)\
[XDspActivationOptions](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspactivationoptions.md)\
[XDspSubmitCommand](https://docs.xbox.com/es/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)\
[XDspActivationParameters](https://docs.xbox.com/es/reference/audio/xdspaudio/structs/xdspactivationparameters.md)\
[XDspConnect](https://docs.xbox.com/es/reference/audio/xdspaudio/functions/xdspconnect.md)\
[Información general de una convolución de secuencia única mediante la API de XDSP](https://docs.xbox.com/es/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[Información general de una FFT/IFFT de secuencia única mediante la API de XDSP](https://docs.xbox.com/es/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)


## Related topics

- [XDspActivationOptions](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspActivate](https://docs.xbox.com/es/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspCommand](https://docs.xbox.com/es/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspProcessType](https://docs.xbox.com/es/reference/audio/xdspaudio/enums/xdspprocesstype.md)
- [Información general sobre la reducción de la respuesta al impulso de XDSP](https://docs.xbox.com/es/build/console-features/audio/overviews/xdsp-overview-ir-reduction.md)
