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

# XDspActivate

> XDspActivate

# XDspActivate

풀에서 사용 가능한 처리 리소스를 획득하여 XDSP 스트림을 활성화합니다. 각 XDSP 클라이언트는 256개의 스트림 활성화로 제한됩니다.

## 구문

```cpp theme={null}
HRESULT XDspActivate(  
         XDspClientHandle clientHandle,  
         XDspActivationParameters* params,  
         XDspStatus** status,  
         XDspStreamHandle* streamHandle  
)  
```

### 매개 변수

*clientHandle*   \_In\_\
형식: [XDspClientHandle](/reference/audio/xdspaudio/handles/xdspclienthandle)

XDspConnect 호출에서 얻은 유효한 XDSP 클라이언트 핸들입니다.

*params*   \_In\_\
형식: [XDspActivationParameters\*](/reference/audio/xdspaudio/structs/xdspactivationparameters)

[XDspActivationParameters](/reference/audio/xdspaudio/structs/xdspactivationparameters) 구조체에 대한 포인터입니다.

*status*   \_Outptr\_\
형식: [XDspStatus\*\*](/reference/audio/xdspaudio/structs/xdspstatus)

[XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus) 구조체에 대한 포인터입니다. 자세한 내용은 **설명** 섹션을 참조하세요.

*streamHandle*   \_Outptr\_\
형식: [XDspStreamHandle\*](/reference/audio/xdspaudio/handles/xdspstreamhandle)

호출이 성공하면 유효한 [XDspStreamHandle](/reference/audio/xdspaudio/handles/xdspstreamhandle)입니다. 자세한 내용은 **설명** 섹션을 참조하세요.

### 반환 값

형식: HRESULT

메서드가 성공하면 S\_OK를 반환합니다. 메서드가 실패하면 다음 코드 중 하나를 반환합니다(부분 목록).

| 반환 코드                                       | 설명                                                                                                                                                                                                     |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| E\_POINTER                                  | 유효하지 않은 포인터입니다.                                                                                                                                                                                        |
| E\_INVALIDARG                               | 하나 이상의 인수가 유효하지 않습니다.                                                                                                                                                                                  |
| XDSP\_E\_NO\_DEVICE\_RESOURCES              | 요청을 처리하는 데 사용할 수 있는 XDSP 디바이스 리소스가 없습니다.                                                                                                                                                               |
| XDSP\_E\_INVALID\_IMPULSE\_RESPONSE\_LENGTH | 제공된 임펄스 응답 길이가 유효하지 않습니다. 이 오류는 (`9 * blockSize * 2`)보다 작거나 16초(`16 * 48000 * 2`)보다 큰 [impulseResponseLengthInFloats](/reference/audio/xdspaudio/structs/xdspactivationparameters)가 제공된 경우 발생할 수 있습니다. |

## 설명

이 호출은 리소스를 할당하는 대신 풀에서 획득하므로 빠릅니다.

호출자는 XDSP 스트림이 수행할 [XDspProcessType](/reference/audio/xdspaudio/enums/xdspprocesstype)을 지정해야 합니다. XDSP 스트림 인스턴스는 수명 동안 하나의 처리 유형만 사용할 수 있습니다. 두 개 이상의 다른 처리 유형을 수행하려면 두 개 이상의 XDSP 스트림 인스턴스를 인스턴스화해야 합니다.

[XDspActivationParameters](/reference/audio/xdspaudio/structs/xdspactivationparameters) 구조체 내에서 호출자는 다음을 지정해야 합니다.

* 활성화 옵션.
* 각 명령에서 처리될 프레임 수, 즉 입력 및 출력 프레임 수.
* 스트림의 채널 수. 모노 및 스테레오 입력 스트림만 지원됩니다.
* [XDspProcessType::Convolution](/reference/audio/xdspaudio/enums/xdspprocesstype) 처리 유형의 경우, float 단위의 임펄스 응답 길이.
* [XDspProcessType::Convolution](/reference/audio/xdspaudio/enums/xdspprocesstype) 처리 유형의 경우, 주파수 도메인 값으로서의 임펄스 응답.

호출이 성공하면 이 스트림에 대한 다른 호출([XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand), [XDspSubmitCommandWithEnvelope](/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope), [XDspDeactivate](/reference/audio/xdspaudio/functions/xdspdeactivate))에 사용할 유효한 [XDspStreamHandle](/reference/audio/xdspaudio/handles/xdspstreamhandle)이 반환됩니다. 또한 이 호출이 성공하면 제출된 명령의 상태를 확인하는 데 사용할 수 있는 [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus)에 대한 포인터를 반환합니다.

이는 처리된 최신 명령이 무엇인지, 그리고 제출된 명령의 결과를 사용할 준비가 되었는지 여부를 확인하는 데 사용해야 합니다.
[XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus)에는 하드웨어에 제출된 마지막 명령의 시퀀스 번호와 해당 XDSP 스트림에 대해 처음 실패한 명령의 시퀀스 번호도 포함됩니다. 컨볼루션 처리의 경우 호출자는 이 호출이 반환된 후 임펄스 응답 메모리를 해제할 수 있습니다.

## 요구 사항

**헤더:** XDspAudio.h

**라이브러리:** Chad.lib

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

## 개념 설명서

* [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 개요](/build/console-features/audio/overviews/xdsp-overview)

## 관련 항목

[XDSP](/reference/audio/xdspaudio/xdspaudio_members)\
[XDSP 오류](/reference/audio/xdspaudio/enums/xdsperrors)\
[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)\
[XDSP API를 사용한 엔벨로프 포함 단일 스트림 컨볼루션 개요](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)


## Related topics

- [XDspDeactivate](/ko/reference/audio/xdspaudio/functions/xdspdeactivate.md)
- [XDSP 개요](/ko/build/console-features/audio/overviews/xdsp-overview.md)
- [XDSP API를 사용한 싱글 스트림 컨볼루션 개요](/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)
- [XDSP API를 사용한 엔벨로프가 있는 싱글 스트림 컨볼루션](/ko/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
- [XDSP audio](/ko/reference/audio/xdspaudio/xdspaudio_members.md)