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

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

*endScale*\
Tipo: float

O valor padrão é 1.0. Esse parâmetro só é usado para processamento de [XDspProcessType::Convolution](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype). 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:<br />
`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](/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters) que será passado para [XDspSubmitCommand](/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand). Esse buffer deve fazer parte da memória registrada por [XDspConnect](/pt-BR/reference/audio/xdspaudio/functions/xdspconnect). 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](/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters) que o mecanismo de processamento gravará; esse buffer deve fazer parte da memória registrada por [XDspConnect](/pt-BR/reference/audio/xdspaudio/functions/xdspconnect). Ele também deve estar alinhado em 16 bytes.

*blockBufferMultiplier*\
Tipo: float\*

Um buffer para conter um bloco de [XDspActivationParameters::blockFrameCount](/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters) quadros que será passado para [XDspSubmitCommand](/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand). 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](/pt-BR/reference/audio/xdspaudio/enums/xdspprocesstype). Esse buffer deve fazer parte da memória registrada por [XDspConnect](/pt-BR/reference/audio/xdspaudio/functions/xdspconnect). 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](/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)\
[XDspActivationParameters](/pt-BR/reference/audio/xdspaudio/structs/xdspactivationparameters)\
[XDspSubmitCommand](/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[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

- [XDspCommand](/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)