> ## 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/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md) 처리에만 사용됩니다.

*endScale*\
형식: float

기본값은 1.0입니다. 이 매개 변수는 [XDspProcessType::Convolution](https://docs.xbox.com/ko/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/ko/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)에 전달될 [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspactivationparameters.md)의 하나의 입력 프레임 블록을 담을 입력 버퍼입니다. 이 버퍼는 [XDspConnect](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspconnect.md)에서 등록된 메모리의 일부여야 합니다. 또한 16바이트 정렬이어야 합니다.

*outputBlockBuffer*\
형식: float\*

처리 엔진이 기록할 [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspactivationparameters.md)의 하나의 출력 프레임 블록을 담을 출력 버퍼입니다. 이 버퍼는 [XDspConnect](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspconnect.md)에서 등록된 메모리의 일부여야 합니다. 또한 16바이트 정렬이어야 합니다.

*blockBufferMultiplier*\
형식: float\*

[XDspSubmitCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)에 전달될 [XDspActivationParameters::blockFrameCount](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspactivationparameters.md) 프레임의 하나의 블록을 담을 버퍼입니다. 이 매개 변수가 NULL이 아니면 이 버퍼의 프레임은 *inputBlockBuffer*의 해당 프레임과 곱해집니다. 이 매개 변수는 [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)에서만 사용해야 합니다. 이 버퍼는 [XDspConnect](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspconnect.md)에서 등록된 메모리의 일부여야 합니다. 또한 16바이트 정렬이어야 합니다.

## 요구 사항

**헤더:** XDspAudio.h

**지원 플랫폼:** XBOX Series X|S

## 개념 설명서

* [XDSP API를 사용한 엔벨로프 포함 단일 스트림 컨볼루션 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
* [XDSP API를 사용한 단일 스트림 컨볼루션 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)

## 관련 항목

[XDSP](https://docs.xbox.com/ko/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspProcessType](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)\
[XDspActivationParameters](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspactivationparameters.md)\
[XDspSubmitCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)\
[XDspConnect](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspconnect.md)\
[XDSP API를 사용한 단일 스트림 컨볼루션 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[XDSP API를 사용한 단일 스트림 FFT/IFFT 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)


## Related topics

- [XDspSubmitCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)
- [XDspActivationOptions](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspSubmitCommandWithEnvelope](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [XDSP API를 사용한 엔벨로프가 있는 싱글 스트림 컨볼루션](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
- [XDSP API를 사용한 싱글 스트림 컨볼루션 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)