XDspActivate

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

구문

HRESULT XDspActivate(  
         XDspClientHandle clientHandle,  
         XDspActivationParameters* params,  
         XDspStatus** status,  
         XDspStreamHandle* streamHandle  
)  

매개 변수

clientHandle   _In_
형식: XDspClientHandle XDspConnect 호출에서 얻은 유효한 XDSP 클라이언트 핸들입니다. params   _In_
형식: XDspActivationParameters* XDspActivationParameters 구조체에 대한 포인터입니다. status   _Outptr_
형식: XDspStatus** XDspStatus 구조체에 대한 포인터입니다. 자세한 내용은 설명 섹션을 참조하세요. streamHandle   _Outptr_
형식: XDspStreamHandle* 호출이 성공하면 유효한 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가 제공된 경우 발생할 수 있습니다.

설명

이 호출은 리소스를 할당하는 대신 풀에서 획득하므로 빠릅니다. 호출자는 XDSP 스트림이 수행할 XDspProcessType을 지정해야 합니다. XDSP 스트림 인스턴스는 수명 동안 하나의 처리 유형만 사용할 수 있습니다. 두 개 이상의 다른 처리 유형을 수행하려면 두 개 이상의 XDSP 스트림 인스턴스를 인스턴스화해야 합니다. XDspActivationParameters 구조체 내에서 호출자는 다음을 지정해야 합니다.

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

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

요구 사항

헤더: XDspAudio.h 라이브러리: Chad.lib 지원 플랫폼: XBOX Series X|S

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XDspActivate

XDspActivate

구문

매개 변수

반환 값

설명

요구 사항

개념 설명서

관련 항목

​XDspActivate

​구문

​매개 변수

​반환 값

​설명

​요구 사항

​개념 설명서

​관련 항목

XDspActivate

구문

매개 변수

반환 값

설명

요구 사항

개념 설명서

관련 항목