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

# 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](/reference/audio/xdspaudio/enums/xdspprocesstype)

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

*options*\
형식: [XDspActivationOptions](/reference/audio/xdspaudio/enums/xdspactivationoptions)

활성화 옵션입니다.

*blockFrameCount*\
형식: uint32\_t

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

*channelCount*\
형식: uint32\_t

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

*impulseResponseLengthInFloats*\
형식: uint32\_t

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

*impulseResponse*\
형식: float\*

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

## 요구 사항

**헤더:** XDspAudio.h

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

## 개념 설명서

* [XDSP 임펄스 응답 축소 개요](/build/console-features/audio/overviews/xdsp-overview-ir-reduction)
* [XDSP API를 사용한 엔벨로프 포함 단일 스트림 컨볼루션 개요](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [XDSP API를 사용한 단일 스트림 컨볼루션 개요](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)

## 관련 항목

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


## Related topics

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