> ## 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](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 處理。

*endScale*\
類型:float

預設值為 1.0。此參數僅用於 [XDspProcessType::Convolution](/zh-TW/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\*

用來保存 [XDspActivationParameters::blockFrameCount](/zh-TW/reference/audio/xdspaudio/structs/xdspactivationparameters) 個框架之一個輸入區塊的輸入緩衝區,將傳遞給 [XDspSubmitCommand](/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand)。此緩衝區必須是由 [XDspConnect](/zh-TW/reference/audio/xdspaudio/functions/xdspconnect) 所註冊記憶體的一部分。它也必須以 16 位元組對齊。

*outputBlockBuffer*\
類型:float\*

用來保存 [XDspActivationParameters::blockFrameCount](/zh-TW/reference/audio/xdspaudio/structs/xdspactivationparameters) 個框架之一個輸出區塊的輸出緩衝區,處理引擎會寫入此緩衝區。此緩衝區必須是由 [XDspConnect](/zh-TW/reference/audio/xdspaudio/functions/xdspconnect) 所註冊記憶體的一部分。它也必須以 16 位元組對齊。

*blockBufferMultiplier*\
類型:float\*

用來保存 [XDspActivationParameters::blockFrameCount](/zh-TW/reference/audio/xdspaudio/structs/xdspactivationparameters) 個框架之一個區塊的緩衝區,將傳遞給 [XDspSubmitCommand](/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand)。如果此參數不是 NULL,則此緩衝區中的框架會乘以 *inputBlockBuffer* 中對應的框架。此參數只能與 [XDspProcessType::ForwardFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 一起使用。此緩衝區必須是由 [XDspConnect](/zh-TW/reference/audio/xdspaudio/functions/xdspconnect) 所註冊記憶體的一部分。它也必須以 16 位元組對齊。

## 需求

**標頭:** XDspAudio.h

**支援的平台:** XBOX Series X|S

## 概念文件

* [使用 XDSP API 進行含 Envelope 的單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [使用 XDSP API 進行單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)

## 另請參閱

[XDSP](/zh-TW/reference/audio/xdspaudio/xdspaudio_members)\
[XDspProcessType](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype)\
[XDspActivationParameters](/zh-TW/reference/audio/xdspaudio/structs/xdspactivationparameters)\
[XDspSubmitCommand](/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[XDspConnect](/zh-TW/reference/audio/xdspaudio/functions/xdspconnect)\
[使用 XDSP API 進行單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[使用 XDSP API 進行單一串流 FFT/IFFT 的概觀](/zh-TW/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)