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

# XDspCommand

> XDspCommand

# XDspCommand

Comando do XDSP.

## Sintaxe

```cpp theme={null}
typedef struct XDspCommand {  
    float beginScale;  
    float endScale;  
    float* inputBlockBuffer;  
    float* outputBlockBuffer;  
    float* blockBufferMultiplier;  
} XDspCommand  
```

### Membros

*beginScale*\
Tipo: float

O valor padrão é 1.0. Esse parâmetro só é usado para processamento de [XDspProcessType::Convolution](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md).

*endScale*\
Tipo: float

O valor padrão é 1.0. Esse parâmetro só é usado para processamento de [XDspProcessType::Convolution](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md). Se nem *beginScale* nem *endScale* forem 1.0, todos os quadros de entrada ou saída serão dimensionados de acordo com a seguinte fórmula:\

`outputBlockBuffer[i] = outputBlockBuffer[i] * (XDspCommand::beginScale + (i * step))`
em que `step = (XDspCommand::endScale - XDspCommand::beginScale) / XDspActivationParameters::blockFrameCount`

Confira os exemplos no portal de download do GDK [https://aka.ms/gdkdl](https://aka.ms/gdkdl) para ver um exemplo de uso desses parâmetros para aumentar/diminuir gradualmente.

*inputBlockBuffer*\
Tipo: float\*

Buffer de entrada para conter um bloco de entrada de quadros de [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters.md) que será passado para [XDspSubmitCommand](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand.md). Esse buffer deve fazer parte da memória registrada por [XDspConnect](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspconnect.md). Ele também deve estar alinhado em 16 bytes.

*outputBlockBuffer*\
Tipo: float\*

Buffer de saída para conter um bloco de saída de quadros de [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters.md) que o mecanismo de processamento gravará; esse buffer deve fazer parte da memória registrada por [XDspConnect](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspconnect.md). Ele também deve estar alinhado em 16 bytes.

*blockBufferMultiplier*\
Tipo: float\*

Um buffer para conter um bloco de [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters.md) quadros que será passado para [XDspSubmitCommand](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand.md). Se esse parâmetro não for NULL, cada quadro desse buffer será multiplicado pelo quadro correspondente em *inputBlockBuffer*. Esse parâmetro deve ser usado somente com [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype.md). Esse buffer deve fazer parte da memória registrada por [XDspConnect](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspconnect.md). Ele também deve estar alinhado em 16 bytes.

## Requisitos

**Cabeçalho:** XDspAudio.h

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

## Documentação conceitual

* [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)\
[XDspActivationParameters](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters.md)\
[XDspSubmitCommand](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand.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

- [XDspSubmitCommand](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)
- [XDspSubmitCommandWithEnvelope](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [XDspActivationOptions](https://docs.xbox.com/pt-BR/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [Convolução de fluxo único com envelope usando a API 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 XDSP](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)