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

*endScale*\
類型:float

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

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

*outputBlockBuffer*\
類型:float\*

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

*blockBufferMultiplier*\
類型:float\*

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

## 需求

**標頭:** XDspAudio.h

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

## 概念文件

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

## 另請參閱

[XDSP](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspProcessType](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype.md)\
[XDspActivationParameters](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/structs/xdspactivationparameters.md)\
[XDspSubmitCommand](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)\
[XDspConnect](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/functions/xdspconnect.md)\
[使用 XDSP API 進行單一串流 Convolution 的概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[使用 XDSP API 進行單一串流 FFT/IFFT 的概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)


## Related topics

- [XDspSubmitCommand](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)
- [XDspActivationOptions](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspSubmitCommandWithEnvelope](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [使用 XDSP API 進行含包絡的單一串流摺積](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
- [使用 XDSP API 進行單一串流摺積概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)