> ## 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 ativação do XDSP.

## Sintaxe

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

### Membros

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

Para cada ativação, há apenas um tipo de processamento válido. Por exemplo, se forem necessárias FFT direta e inversa, dois fluxos XDSP devem ser ativados, um para cada tipo.

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

Opções de ativação.

*blockFrameCount*\
Tipo: uint32\_t

Número de quadros por bloco de dados de entrada e saída que seria passado ao XDSP por meio de [XDspSubmitCommand](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand.md). Esse valor deve ser uma potência de dois. 512 e 1024 são os valores com suporte para [XDspProcessType::Convolution](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md). 512, 1024 e 2048 são os valores com suporte para [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md) e [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md).

*channelCount*\
Tipo: uint32\_t

1 para fluxo de entrada mono ou 2 para fluxo de entrada estéreo para [XDspProcessType::Convolution](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md). Deve sempre ser definido como 1 para [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md) e [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md).

*impulseResponseLengthInFloats*\
Tipo: uint32\_t

Comprimento da resposta ao impulso que será usado durante o processamento de [XDspProcessType::Convolution](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md), em unidades de floats. Por exemplo, se a resposta ao impulso contiver `N` amostras de pares de valores float complexos, esse valor deverá ser definido como `N * 2`, pois cada par de valores float complexos é representado usando dois floats. Para [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md) e [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md), esse parâmetro deve ser zero.

*impulseResponse*\
Tipo: float\*

Buffer com comprimento de (`impulseResponseLengthInFloats * sizeof(float)`) bytes que contém a resposta ao impulso como uma série de valores float complexos (par de valores real e imaginário). Isso significa que o buffer terá (`impulseResponseLengthInFloats / 2`) pares de valores float complexos. O comprimento do buffer deverá ser de (`impulseResponseLengthInFloats * sizeof(float) * channelCount`) bytes se [XDspActivationOptions::StereoImpulseResponse](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspactivationoptions.md) estiver definido e [XDspActivationParameters::channelCount](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters.md) for igual a 2. Para [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md) e [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md), esse parâmetro deve ser definido como nullptr. Esse buffer não precisa vir do *baseBuffer* registrado por [XDspConnect](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspconnect.md).

## Requisitos

**Cabeçalho:** XDspAudio.h

**Plataformas compatíveis:** XBOX Series X|S

## Documentação conceitual

* [Visão geral da redução de resposta ao impulso do XDSP](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xdsp-overview-ir-reduction.md)
* [Visão geral de uma convolução de fluxo único com envelope usando a API do XDSP](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
* [Visão geral de uma convolução de fluxo único usando a API do XDSP](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)

## Confira também

[XDSP](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspProcessType](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md)\
[XDspActivationOptions](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspactivationoptions.md)\
[XDspSubmitCommand](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)\
[XDspActivationParameters](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters.md)\
[XDspConnect](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspconnect.md)\
[Visão geral de uma convolução de fluxo único usando a API do XDSP](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[Visão geral de uma FFT/IFFT de fluxo único usando a API do XDSP](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)


## Related topics

- [XDspActivationOptions](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspActivate](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspCommand](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspProcessType](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md)
- [Visão geral da redução de resposta ao impulso do XDSP](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xdsp-overview-ir-reduction.md)
