XApuDecodeConvertActivateCommand
디코딩 또는 디코딩-변환 활성화 매개 변수를 정의합니다.구문
멤버
id형식: XApuCommandId 처리를 위해 하드웨어에 전송할 기본 명령 매개 변수를 지정합니다. 동일한 XApuCommandId가 XApuResult::id에 설정됩니다. channelCount
형식: uint32_t 스트림 채널 수를 지정합니다. 모노와 스테레오에 각각 1과 2만 지원됩니다. initializeDataLength
형식: uint32_t 사용되지 않으며 0으로 설정해야 합니다. initializeData
형식: void* 사용되지 않으며 NULL로 설정해야 합니다. startPitch
형식: float 변환기가 활성 상태인 경우 시작 피치입니다. 디코딩 전용의 경우 이 값은 무시됩니다. processingBufferLength
형식: uint32_t XApuDecodeConvertActivateCommand::processingBuffer의 길이(바이트)입니다. 길이는 16의 배수여야 합니다. processingBuffer
형식: void* XApuProcessType::DecodeConvertOpus 및 XApuProcessType::ConvertPCM 유형에 대해 압축 해제된 PCM float(32비트) 데이터를 저장하기 위한 중간 버퍼입니다. 처리 버퍼는 XApuConnectOutputParameters::baseData에서 잘라내어 XApuDecodeConvertActivateCommand::processingBuffer 및 XApuDecodeConvertActivateCommand::processingBufferLength 인수를 사용하여 XApuCommandType::Activate 명령을 통해 XAPU에 전달됩니다. 처리 버퍼는 XApuProcessType::DecodeConvertOpus 케이스에서 아직 변환되지 않은 디코더의 중간 PCM float(32비트) 데이터를 저장하는 데 필요합니다. XApuProcessType::ConvertPCM 케이스에서는 아직 변환되지 않은 호출자로부터의 PCM float 데이터를 저장합니다. 이 버퍼는 16바이트 정렬이어야 합니다. 또한 XApuProcessType::DecodeConvertOpus 및 XApuProcessType::ConvertPCM 유형 모두에 대해 아직 출력될 준비가 되지 않은 변환된 데이터를 저장합니다. XAPU는 내부적으로 처리 버퍼를 두 세그먼트, 즉 변환되지 않은 입력 PCM 데이터를 위한 입력 세그먼트와 변환된 출력 PCM 데이터를 위한 출력 세그먼트로 나눕니다. 입력 세그먼트의 길이는 항상 Opus 패킷 지속 시간의 두 배여야 합니다. 즉, (2 x 960 x ChannelCount x sizeof(float))입니다. 출력 세그먼트는 변환된 데이터가 512 XApuConnectInputParameters::maxFrameCountPerOutput보다 적을 때 저장하는 데 사용됩니다. XApuCommandOptions::Flush가 설정된 경우 XAPU가 XApuConnectInputParameters::maxFrameCountPerOutput 프레임보다 적더라도 데이터를 출력하기 때문에 출력 세그먼트는 사용되지 않습니다. 출력 세그먼트의 길이는 XApuConnectInputParameters::maxFrameCountPerOutput x ChannelCount x sizeof(float)입니다. XApuDecodeConvertActivateCommand::processingBufferLength는 스트림당 상수이며 1/8부터 8/1까지의 모든 피치 값에서 작동하며 다음과 같이 설정해야 합니다. ProcessingBufferLength = (2 x 960 x ChannelCount x sizeof(float)) + (XApuConnectInputParameters::maxFrameCountPerOutput x ChannelCount x sizeof(float))
ChannelCount = 1 또는 2 XApuConnectInputParameters::maxFrameCountPerOutput = 256, 480, 512, 960 또는 1024입니다.
설명
XApuDecodeConvertActivateCommand는 디코딩 및 변환 활성화 매개 변수에 사용됩니다. XApuCommandId 멤버에 대한 자세한 내용은 XApuCommandId를 참조하세요. XApuProcessType 상수에 대한 자세한 내용은 XApuProcessType를 참조하세요.
요구 사항
헤더: xapu.h 지원 플랫폼: XBOX Series X|S관련 항목
XApuEnqueueCommandXAPU