> ## 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

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](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype)

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](/pt-BR/reference/audio/xdspaudio/enums/xdspactivationoptions)

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](/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand). Esse valor deve ser uma potência de dois. 512 e 1024 são os valores com suporte para [XDspProcessType::Convolution](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype). 512, 1024 e 2048 são os valores com suporte para [XDspProcessType::ForwardFourierTransform](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype) e [XDspProcessType::InverseFourierTransform](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype).

*channelCount*\
Tipo: uint32\_t

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

*impulseResponseLengthInFloats*\
Tipo: uint32\_t

Comprimento da resposta ao impulso que será usado durante o processamento de [XDspProcessType::Convolution](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype), 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](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype) e [XDspProcessType::InverseFourierTransform](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype), 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](/pt-BR/reference/audio/xdspaudio/enums/xdspactivationoptions) estiver definido e [XDspActivationParameters::channelCount](/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters) for igual a 2. Para [XDspProcessType::ForwardFourierTransform](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype) e [XDspProcessType::InverseFourierTransform](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype), esse parâmetro deve ser definido como nullptr. Esse buffer não precisa vir do *baseBuffer* registrado por [XDspConnect](/pt-BR/reference/audio/xdspaudio/functions/xdspconnect).

## 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](/pt-BR/build/console-features/audio/overviews/xdsp-overview-ir-reduction)
* [Visão geral de uma convolução de fluxo único com envelope usando a API do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [Visão geral de uma convolução de fluxo único usando a API do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)

## Confira também

[XDSP](/pt-BR/reference/audio/xdspaudio/xdspaudio_members)\
[XDspProcessType](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype)\
[XDspActivationOptions](/pt-BR/reference/audio/xdspaudio/enums/xdspactivationoptions)\
[XDspSubmitCommand](/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[XDspActivationParameters](/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters)\
[XDspConnect](/pt-BR/reference/audio/xdspaudio/functions/xdspconnect)\
[Visão geral de uma convolução de fluxo único usando a API do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[Visão geral de uma FFT/IFFT de fluxo único usando a API do XDSP](/pt-BR/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)