> ## 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/ja-jp/reference/audio/xdspaudio/enums/xdspprocesstype.md) 処理でのみ使用されます。

*endScale*\
型: float

既定値は 1.0 です。このパラメーターは [XDspProcessType::Convolution](https://docs.xbox.com/ja-jp/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/ja-jp/reference/audio/xdspaudio/functions/xdspsubmitcommand.md) に渡される [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspactivationparameters.md) の 1 ブロック分の入力フレームを保持する入力バッファー。このバッファーは [XDspConnect](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspconnect.md) によって登録されたメモリの一部でなければなりません。また、16 バイト境界に整列している必要があります。

*outputBlockBuffer*\
型: float\*

処理エンジンが書き込む [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspactivationparameters.md) の 1 ブロック分の出力フレームを保持する出力バッファー。このバッファーは [XDspConnect](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspconnect.md) によって登録されたメモリの一部でなければなりません。また、16 バイト境界に整列している必要があります。

*blockBufferMultiplier*\
型: float\*

[XDspSubmitCommand](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspsubmitcommand.md) に渡される [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspactivationparameters.md) の 1 ブロック分のフレームを保持するバッファー。このパラメーターが NULL でない場合、このバッファー内のフレームは *inputBlockBuffer* 内の対応するフレームと乗算されます。このパラメーターは [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/enums/xdspprocesstype.md) でのみ使用する必要があります。このバッファーは [XDspConnect](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspconnect.md) によって登録されたメモリの一部でなければなりません。また、16 バイト境界に整列している必要があります。

## 要件

**ヘッダー:** XDspAudio.h

**サポートされるプラットフォーム:** XBOX Series X|S

## 概念ドキュメント

* [XDSP API を使用したエンベロープ付き単一ストリーム畳み込みの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
* [XDSP API を使用した単一ストリーム畳み込みの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)

## 関連項目

[XDSP](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspProcessType](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/enums/xdspprocesstype.md)\
[XDspActivationParameters](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspactivationparameters.md)\
[XDspSubmitCommand](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)\
[XDspConnect](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspconnect.md)\
[XDSP API を使用した単一ストリーム畳み込みの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[XDSP API を使用した単一ストリーム FFT/IFFT の概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)


## Related topics

- [XDspSubmitCommand](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)
- [XDspActivationOptions](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDSP API を使用したエンベロープ付きシングル ストリーム コンボリューション](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
- [XDSP API を使用したシングル ストリーム コンボリューションの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)
- [XDspSubmitCommandWithEnvelope](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)