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

XDSP 命令。

## 语法

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

### 成员

*beginScale*\
类型：float

默认值为 1.0。此参数仅用于 [XDspProcessType::Convolution](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdspprocesstype.md) 处理。

*endScale*\
类型：float

默认值为 1.0。此参数仅用于 [XDspProcessType::Convolution](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdspprocesstype.md) 处理。如果 *beginScale* 或 *endScale* 都不为 1.0，则所有输入或输出帧将根据以下公式进行缩放：\

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

有关使用这些参数进行淡入/淡出的示例，请参阅 GDK 下载门户 [https://aka.ms/gdkdl](https://aka.ms/gdkdl) 中的示例。

*inputBlockBuffer*\
类型：float\*

输入缓冲区，用于存放要传递给 [XDspSubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommand.md) 的 [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/structs/xdspactivationparameters.md) 个帧的一个输入块。此缓冲区必须是 [XDspConnect](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspconnect.md) 注册的内存的一部分。它还必须为 16 字节对齐。

*outputBlockBuffer*\
类型：float\*

输出缓冲区，用于存放处理引擎将写入的 [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/structs/xdspactivationparameters.md) 个帧的一个输出块，此缓冲区必须是 [XDspConnect](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspconnect.md) 注册的内存的一部分。它还必须为 16 字节对齐。

*blockBufferMultiplier*\
类型：float\*

用于存放将传递给 [XDspSubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommand.md) 的 [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/structs/xdspactivationparameters.md) 个帧的一个块的缓冲区。如果此参数不为 NULL，则此缓冲区中的帧将与 *inputBlockBuffer* 中的相应帧相乘。此参数必须仅与 [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdspprocesstype.md) 一起使用。此缓冲区必须是 [XDspConnect](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspconnect.md) 注册的内存的一部分。它还必须为 16 字节对齐。

## 要求

**头文件：** XDspAudio.h

**支持的平台：** XBOX Series X|S

## 概念文档

* [使用 XDSP API 进行带包络的单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
* [使用 XDSP API 进行单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)

## 另请参阅

[XDSP](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspProcessType](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdspprocesstype.md)\
[XDspActivationParameters](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/structs/xdspactivationparameters.md)\
[XDspSubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)\
[XDspConnect](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspconnect.md)\
[使用 XDSP API 进行单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[使用 XDSP API 进行单流 FFT/IFFT 概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)


## Related topics

- [XDspSubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)
- [XDspActivationOptions](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspSubmitCommandWithEnvelope](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [使用 XDSP API 进行带包络的单流卷积](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
- [使用 XDSP API 进行单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)