Skip to main content

​
XApuConnect

Audio Processing Unit(XAPU)에 대한 연결을 설정하고 필요한 리소스를 할당합니다.

​
Syntax

​
Parameters

params   _In_
Type: XApuConnectInputParameters* 리소스를 할당하기 위해 XApuConnect에 전달되는 매개 변수입니다. data   _Out_
Type: XApuConnectOutputParameters* XApuConnect에서 반환되는 매개 변수입니다. handle   _Outptr_
Type: XApuHandle* 반환된 XAPU 핸들에 대한 포인터입니다. 이 핸들은 다른 XAPU API를 호출할 때 조작할 XAPU 인스턴스를 나타내는 데 사용됩니다.

​
Return value

Type: HRESULT 성공 시 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

​
Remarks

호출자는 XAPU 클라이언트가 수행할 XApuProcessType을 지정해야 합니다. XAPU 인스턴스는 수명 동안 한 가지 유형의 프로세스로 작동할 수 있습니다. 두 개 이상의 서로 다른 프로세스를 수행하려면 두 개 이상의 XAPU 인스턴스를 인스턴스화해야 합니다. XApuConnectInputParameters 내에서 호출자는 다음을 지정해야 합니다.
  • XAPU가 동시에 처리할 것으로 예상되는 최대 스트림 수.
  • 각 스트림에 대한 최대 큐 명령 수.
  • 모든 명령 및 스트림에 대해 필요한 총 메모리 할당. 여기에는 최대 스트림 수 곱하기 스트림당 큐 명령 수에 걸친 입력, 출력 및 처리 데이터에 대한 총 할당이 포함됩니다.
호출이 성공한 경우 XApuConnectOutputParameters::baseData 매개 변수는 호출자가 스트림의 입력 데이터를 전달하고 출력 데이터를 검색하는 데 사용해야 하는 메모리 청크를 가리킵니다. 이 메모리 청크를 분할하고 재사용하는 것은 호출자의 몫입니다. 할당은 XApuDisconnect 호출 시 해제됩니다. XApuConnectOptions::EnableResultReadyEvent가 설정된 경우 XApuConnectOutputParameters::resultReadyEvent는 Win32 이벤트 핸들을 포함합니다. 이 핸들은 XApuDisconnect 호출 시 닫힙니다. 이 핸들은 XApuDisconnect 호출 시 닫힙니다. 스트림을 시작하고 중지하기 위해 XapuConnect 및 XApuDisconnect를 자주 호출하는 것은 권장되지 않습니다. 이러한 호출은 시간이 많이 걸리고 메모리 단편화로 인한 리소스 손실을 초래할 수도 있기 때문입니다. 대신 스트리밍 세션 초기화 시 XapuConnect를 한 번 호출한 다음, 스트리밍 중에 스트림을 시작하고 중지하기 위해 XApuCommandType::Activate 및 XApuCommandType::Deactivate를 사용해야 합니다. 스트리밍 세션이 끝나면 XApuDisconnect를 호출해야 합니다. 이는 모든 XAPU 클라이언트에 적용됩니다.

​
Requirements

Header: xapu.h Library: xapu.lib Supported platforms: XBOX Series X|S

​
Conceptual documentation

​
See also

XAPU
XApuDecodeConvertCommand
XApuDequeueResult
XApuEnqueueCommand
XApuGetResultCount
마지막 수정일 2026년 8월 24일

관련 항목

XApuConnectOptionsXApuConnectOutputParametersXApuConnectInputParametersXApuDisconnectXApuDequeueResult