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

# XApuConnectInputParameters

> XApuConnectInputParameters

# XApuConnectInputParameters

리소스를 할당하기 위해 [XApuConnect](/reference/audio/xapu/functions/xapuconnect)에 전달되는 매개 변수입니다.

## 구문

```cpp theme={null}
typedef struct XApuConnectInputParameters {  
    XApuProcessType processType;  
    uint32_t maxStreamCount;  
    uint32_t maxQueuedCommandsPerStream;  
    uint32_t baseDataLength;  
    uint32_t maxFrameCountPerOutput;  
    XApuConnectOptions options;  
} XApuConnectInputParameters  
```

### 멤버

*processType*\
형식: [XApuProcessType](/reference/audio/xapu/enums/xapuprocesstype)

XAPU 클라이언트가 처리하는 모든 스트림에 대해 수행되는 프로세스 유형입니다. 단일 클라이언트는 두 개 이상의 프로세스 유형을 수행할 수 없습니다.

*maxStreamCount*\
형식: uint32\_t

XAPU 클라이언트에 대해 동시에 활성화될 것으로 예상되는 최대 스트림 수입니다. 최소값은 1, 최대값은 500입니다.

*maxQueuedCommandsPerStream*\
형식: uint32\_t

한 스트림의 명령 큐 크기입니다. 최소값은 1, 최대값은 16입니다. XAPU 클라이언트의 총 명령 큐 크기는 *maxStreamCount* \* *maxQueuedCommandsPerStream*입니다.

*baseDataLength*\
형식: uint32\_t

*maxStreamCount* 스트림을 처리하는 데 필요한 바이트 단위 메모리 할당량이며, 입력, 출력 및 처리 버퍼를 포함합니다.
예를 들어 20밀리초 패킷(960프레임)을 갖는 하나의 스테레오 Opus 스트림에 대한 DecodeOpus의 *baseDataLength*는
예상되는 최대 입력 패킷 길이(바이트)에 출력 프레임 수 × 채널 수 × float 변수 크기를 더한 값이 될 수 있습니다.

XApuProcessType::DecodeOpus의 일반 공식은 다음과 같습니다.

baseDataLength = maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float))
여기서 *MaxFrameCountPerPacket*은 16의 배수여야 합니다.

[XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype)의 일반 공식은 다음과 같습니다.
baseDataLength = (maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float)))

* (maxStreamCount x XApuDecodeConvertActivateCommand::processingBufferLength)
  여기서 *MaxFrameCountPerPacket*은 16의 배수여야 합니다.

*maxFrameCountPerOutput*\
형식: uint32\_t

이 매개 변수는 XAPU가 [XApuProcessType::ConvertPCM](/reference/audio/xapu/enums/xapuprocesstype) 또는 [XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype) 유형으로 실행 중일 때 프레임 수 단위의 출력 지속 시간을 정의합니다.
[XApuProcessType::ConvertPCM](/reference/audio/xapu/enums/xapuprocesstype) 또는 [XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype)의 경우, 이 매개 변수는 256, 480, 512, 960, 1024 중 하나의 값으로 설정해야 합니다.
[XApuProcessType::DecodeOpus](/reference/audio/xapu/enums/xapuprocesstype)의 경우 이 매개 변수는 0으로 설정해야 합니다.

*options*\
형식: [XApuConnectOptions](/reference/audio/xapu/enums/xapuconnectoptions)

연결 옵션입니다.

## 설명

`XApuConnectInputParameters`는 `XApuConnect`에 매개 변수를 전달하는 데 사용됩니다. `XApuConnect`는 오디오 처리 장치(XAPU)에 필요한 리소스를 할당합니다. `XApuCommandId`는 XAPU에 전송하고 XAPU로부터 수신할 기본 명령 매개 변수를 정의합니다.

## 요구 사항

**헤더:** xapu.h

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

## 관련 항목

[XApuCommandId](/reference/audio/xapu/structs/xapucommandid)\
[XApuConnect](/reference/audio/xapu/functions/xapuconnect)\
[XApuDecodeConvertCommand](/reference/audio/xapu/structs/xapudecodeconvertcommand)\
[XAPU](/reference/audio/xapu/xapu_members)


## Related topics

- [XApuConnectOptions](/ko/reference/audio/xapu/enums/xapuconnectoptions.md)
- [XApuConnect](/ko/reference/audio/xapu/functions/xapuconnect.md)
- [XApuProcessType](/ko/reference/audio/xapu/enums/xapuprocesstype.md)
- [XApuDecodeConvertActivateCommand](/ko/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md)
- [XApuDecodeConvertCommand](/ko/reference/audio/xapu/structs/xapudecodeconvertcommand.md)