HEAACDECExecute

Syntax

#include <cafe/aacdec.h>

s32 HEAACDECExecute( void *memPtr,
                     u8 *inputBitstream,
                     u16 inputBitstreamLength,
                     s16 **decodedPcm,
                     u16 *PcmLength,
                     u16 *outputFreqIndex);

Parameters

memPtr Working memory address (Input).
inputBitstream The bitstream memory starting address (Input).
inputBitstreamLength Number of bytes in 1 frame from the bitstream (Input).
decodedPcm Pointer to the starting address for the location where the decoded data from the audio data memory will be stored (Output).
PcmLength Pointer to the number of bytes of audio data (Output).
outputFreqIndex Pointer to the audio data frequency (definition value) (Output).

Return Values

A return value of HEAACDEC_RET_OK indicates success and any other return value indicates failure.

For more information about errors, see Error Codes.

Description

Decodes 1 frame of the bitstream. The frequency for the decoding result is output with a definition value rather than a direct value. For more information, see Decoding Conditions.

For information about restrictions on the working memory and audio data memory, see Memory.

The details of the starting address of the location where the decoded data from the audio data memory in the fourth argument are shown in the table below.

Starting Address for Location Where Decoded Data From Audio Data Memory Will Be Stored

Member Name Target 1CH 2CH 5.1CH
decodedPcm[0] Starting address of the area where the channel 1 audio data is stored. C L L
decodedPcm[1] Starting address of the area where the channel 2 audio data is stored. --- R R
decodedPcm[2] Starting address of the area where the channel 3 audio data is stored. --- --- C
decodedPcm[3] Starting address of the area where the channel 4 audio data is stored. --- --- LFE
decodedPcm[4] Starting address of the area where the channel 5 audio data is stored. --- --- LS
decodedPcm[5] Starting address of the area where the channel 6 audio data is stored. --- --- RS

C: Center front / L: Left front / R: Right front / LS: Left surround / RS: Right surround / LFE: Low frequency emphasis

Do Not Call From

Background Do not call this function from the background.
Multiple threads This function is not thread-safe.

See Also

HEAACDECOpen
HEAACDECBegin
HEAACDECEnd
HEAACDECClose
HEAACDECRestart
HEAACDECMemoryRequirement

Revision History

2014/07/14 Initial version.


CONFIDENTIAL