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

# XApuDecodeConvertActivateCommand

> XApuDecodeConvertActivateCommand

# XApuDecodeConvertActivateCommand

디코딩 또는 디코딩-변환 활성화 매개 변수를 정의합니다.

## 구문

```cpp theme={null}
typedef struct XApuDecodeConvertActivateCommand {  
    XApuCommandId id;  
    uint32_t channelCount;  
    uint32_t initializeDataLength;  
    void* initializeData;  
    float startPitch;  
    uint32_t processingBufferLength;  
    void* processingBuffer;  
} XApuDecodeConvertActivateCommand  
```

### 멤버

*id*\
형식: [XApuCommandId](/reference/audio/xapu/structs/xapucommandid)

처리를 위해 하드웨어에 전송할 기본 명령 매개 변수를 지정합니다. 동일한 XApuCommandId가 [XApuResult::id](/reference/audio/xapu/structs/xapuresult)에 설정됩니다.

*channelCount*\
형식: uint32\_t

스트림 채널 수를 지정합니다. 모노와 스테레오에 각각 1과 2만 지원됩니다.

*initializeDataLength*\
형식: uint32\_t

사용되지 않으며 0으로 설정해야 합니다.

*initializeData*\
형식: void\*

사용되지 않으며 NULL로 설정해야 합니다.

*startPitch*\
형식: float

변환기가 활성 상태인 경우 시작 피치입니다. 디코딩 전용의 경우 이 값은 무시됩니다.

*processingBufferLength*\
형식: uint32\_t

[XApuDecodeConvertActivateCommand::processingBuffer](/reference/audio/xapu/structs/xapudecodeconvertactivatecommand)의 길이(바이트)입니다. 길이는 16의 배수여야 합니다.

*processingBuffer*\
형식: void\*

[XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype) 및 [XApuProcessType::ConvertPCM](/reference/audio/xapu/enums/xapuprocesstype) 유형에 대해 압축 해제된 PCM float(32비트) 데이터를 저장하기 위한 중간 버퍼입니다.
처리 버퍼는 [XApuConnectOutputParameters::baseData](/reference/audio/xapu/structs/xapuconnectoutputparameters)에서 잘라내어 [XApuDecodeConvertActivateCommand::processingBuffer](/reference/audio/xapu/structs/xapudecodeconvertactivatecommand) 및 [XApuDecodeConvertActivateCommand::processingBufferLength](/reference/audio/xapu/structs/xapudecodeconvertactivatecommand) 인수를 사용하여 [XApuCommandType::Activate](/reference/audio/xapu/enums/xapucommandtype) 명령을 통해 XAPU에 전달됩니다.

처리 버퍼는 [XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype) 케이스에서 아직 변환되지 않은 디코더의 중간 PCM float(32비트) 데이터를 저장하는 데 필요합니다. [XApuProcessType::ConvertPCM](/reference/audio/xapu/enums/xapuprocesstype) 케이스에서는 아직 변환되지 않은 호출자로부터의 PCM float 데이터를 저장합니다. 이 버퍼는 16바이트 정렬이어야 합니다.
또한 [XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype) 및 [XApuProcessType::ConvertPCM](/reference/audio/xapu/enums/xapuprocesstype) 유형 모두에 대해 아직 출력될 준비가 되지 않은 변환된 데이터를 저장합니다.

XAPU는 내부적으로 처리 버퍼를 두 세그먼트, 즉 변환되지 않은 입력 PCM 데이터를 위한 입력 세그먼트와 변환된 출력 PCM 데이터를 위한 출력 세그먼트로 나눕니다.

입력 세그먼트의 길이는 항상 Opus 패킷 지속 시간의 두 배여야 합니다. 즉, (2 x 960 x ChannelCount x sizeof(float))입니다.

출력 세그먼트는 변환된 데이터가 512 [XApuConnectInputParameters::maxFrameCountPerOutput](/reference/audio/xapu/structs/xapuconnectinputparameters)보다 적을 때 저장하는 데 사용됩니다.

[XApuCommandOptions::Flush](/reference/audio/xapu/enums/xapucommandoptions)가 설정된 경우 XAPU가 [XApuConnectInputParameters::maxFrameCountPerOutput](/reference/audio/xapu/structs/xapuconnectinputparameters) 프레임보다 적더라도 데이터를 출력하기 때문에 출력 세그먼트는 사용되지 않습니다.

출력 세그먼트의 길이는 [XApuConnectInputParameters::maxFrameCountPerOutput](/reference/audio/xapu/structs/xapuconnectinputparameters) x ChannelCount x sizeof(float)입니다.

[XApuDecodeConvertActivateCommand::processingBufferLength](/reference/audio/xapu/structs/xapudecodeconvertactivatecommand)는 스트림당 상수이며 1/8부터 8/1까지의 모든 피치 값에서 작동하며 다음과 같이 설정해야 합니다.

ProcessingBufferLength = (2 x 960 x ChannelCount x sizeof(float)) + ([XApuConnectInputParameters::maxFrameCountPerOutput](/reference/audio/xapu/structs/xapuconnectinputparameters) x ChannelCount x sizeof(float))\
ChannelCount = 1 또는 2

[XApuConnectInputParameters::maxFrameCountPerOutput](/reference/audio/xapu/structs/xapuconnectinputparameters) = 256, 480, 512, 960 또는 1024입니다.

## 설명

`XApuDecodeConvertActivateCommand`는 디코딩 및 변환 활성화 매개 변수에 사용됩니다. `XApuCommandId` 멤버에 대한 자세한 내용은 [XApuCommandId](/reference/audio/xapu/structs/xapucommandid)를 참조하세요. `XApuProcessType` 상수에 대한 자세한 내용은 [XApuProcessType](/reference/audio/xapu/enums/xapuprocesstype)를 참조하세요.

## 요구 사항

**헤더:** xapu.h

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

## 관련 항목

[XApuEnqueueCommand](/reference/audio/xapu/functions/xapuenqueuecommand)\
[XAPU](/reference/audio/xapu/xapu_members)


## Related topics

- [XApuCommandId](/ko/reference/audio/xapu/structs/xapucommandid.md)
- [XApuDecodeConvertCommand](/ko/reference/audio/xapu/structs/xapudecodeconvertcommand.md)
- [XAPU](/ko/reference/audio/xapu/xapu_members.md)
- [XApuEnqueueCommand](/ko/reference/audio/xapu/functions/xapuenqueuecommand.md)
- [XApuConnectInputParameters](/ko/reference/audio/xapu/structs/xapuconnectinputparameters.md)