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

# XDspActivationParameters

> XDspActivationParameters

# XDspActivationParameters

XDSP 활성화 매개 변수입니다.

## 구문

```cpp theme={null}
typedef struct XDspActivationParameters {  
    XDspProcessType type;  
    XDspActivationOptions options;  
    uint32_t blockFrameCount;  
    uint32_t channelCount;  
    uint32_t impulseResponseLengthInFloats;  
    float* impulseResponse;  
} XDspActivationParameters  
```

### 멤버

*type*\
형식: [XDspProcessType](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)

각 활성화에는 유효한 처리 유형이 하나만 있습니다. 예를 들어 정방향 및 역방향 FFT가 필요한 경우, 각 유형에 대해 하나씩 두 개의 XDSP 스트림을 활성화해야 합니다.

*options*\
형식: [XDspActivationOptions](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspactivationoptions.md)

활성화 옵션입니다.

*blockFrameCount*\
형식: uint32\_t

[XDspSubmitCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)를 통해 XDSP에 전달될 입력 및 출력 데이터 블록당 프레임 수입니다. 이 값은 2의 거듭제곱이어야 합니다. [XDspProcessType::Convolution](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)에 대해 지원되는 값은 512, 1024입니다. [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md) 및 [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)에 대해 지원되는 값은 512, 1024, 2048입니다.

*channelCount*\
형식: uint32\_t

[XDspProcessType::Convolution](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)의 경우 모노 입력 스트림에는 1을, 스테레오 입력 스트림에는 2를 사용합니다. [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md) 및 [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)의 경우 항상 1로 설정해야 합니다.

*impulseResponseLengthInFloats*\
형식: uint32\_t

[XDspProcessType::Convolution](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md) 처리 중에 사용될 임펄스 응답 길이이며 float 단위입니다. 예를 들어 임펄스 응답이 `N`개의 복소수 float 값 쌍 샘플을 포함한다면, 각 복소수 float 값 쌍은 두 개의 float를 사용하여 표현되므로 이 값은 `N * 2`로 설정해야 합니다. [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md) 및 [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)의 경우 이 매개 변수는 0이어야 합니다.

*impulseResponse*\
형식: float\*

임펄스 응답을 일련의 복소수 float 값(실수 및 허수 값 쌍)으로 담는 (`impulseResponseLengthInFloats * sizeof(float)`) 바이트 길이의 버퍼입니다. 즉, 버퍼는 (`impulseResponseLengthInFloats / 2`)개의 복소수 float 값 쌍을 갖습니다. [XDspActivationOptions::StereoImpulseResponse](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspactivationoptions.md)가 설정되어 있고 [XDspActivationParameters::channelCount](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspactivationparameters.md)가 2이면, 버퍼 길이는 (`impulseResponseLengthInFloats * sizeof(float) * channelCount`) 바이트여야 합니다. [XDspProcessType::ForwardFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md) 및 [XDspProcessType::InverseFourierTransform](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)의 경우 이 매개 변수는 nullptr로 설정해야 합니다. 이 버퍼는 [XDspConnect](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspconnect.md)에서 등록된 *baseBuffer*에서 가져올 필요가 없습니다.

## 요구 사항

**헤더:** XDspAudio.h

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

## 개념 설명서

* [XDSP 임펄스 응답 축소 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-ir-reduction.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)

## 관련 항목

[XDSP](https://docs.xbox.com/ko/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspProcessType](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)\
[XDspActivationOptions](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspactivationoptions.md)\
[XDspSubmitCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)\
[XDspActivationParameters](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspactivationparameters.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

- [XDspActivationOptions](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspActivate](https://docs.xbox.com/ko/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspProcessType](https://docs.xbox.com/ko/reference/audio/xdspaudio/enums/xdspprocesstype.md)
- [XDspCommand](https://docs.xbox.com/ko/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDSP 임펄스 응답 감소 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xdsp-overview-ir-reduction.md)