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

XDSP 命令。

## 语法

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

### 成员

*beginScale*\
类型：float

默认值为 1.0。此参数仅用于 [XDspProcessType::Convolution](/reference/audio/xdspaudio/enums/xdspprocesstype) 处理。

*endScale*\
类型：float

默认值为 1.0。此参数仅用于 [XDspProcessType::Convolution](/reference/audio/xdspaudio/enums/xdspprocesstype) 处理。如果 *beginScale* 或 *endScale* 都不为 1.0，则所有输入或输出帧将根据以下公式进行缩放：<br />
`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](/reference/audio/xdspaudio/functions/xdspsubmitcommand) 的 [XDspActivationParameters::blockFrameCount](/reference/audio/xdspaudio/structs/xdspactivationparameters) 个帧的一个输入块。此缓冲区必须是 [XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect) 注册的内存的一部分。它还必须为 16 字节对齐。

*outputBlockBuffer*\
类型：float\*

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

*blockBufferMultiplier*\
类型：float\*

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

## 要求

**头文件：** XDspAudio.h

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

## 概念文档

* [使用 XDSP API 进行带包络的单流卷积概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [使用 XDSP API 进行单流卷积概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)

## 另请参阅

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


## Related topics

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