# DSP_DecodeG711

## Syntax

    void DSP_DecodeG711(void *dst, const void *src, u32 len, DSPAudioCodecMode mode);

## Arguments

dst | Buffer that stores converted 16-bit PCM data. The specified buffer has the same restrictions as a 16-bit DMA transfer. See Note below for more details.
src | Buffer that holds 8-bit A-law or 8-bit µ-law source data to convert. The specified buffer has the same restrictions as a 16-bit DMA transfer. See Note below for more details.
len | Number of samples to convert.
mode | Encoding to be converted. Select either `DSP_AUDIO_CODEC_MODE_G711_ALAW` or `DSP_AUDIO_CODEC_MODE_G711_ULAW`.

## Return Values

None.

## Description

Decodes G.711-encoded PCM samples. You can use either the `DSP_WaitForG711` or `DSP_TryWaitForG711` function to confirm that processing is complete.

## Note

- You must use the `DSP_LoadG711` function to load the G.711 component before using this function.
- The buffers specified for the transfer source and destination must all satisfy the same conditions as 16-bit DMA transfers.
  - Addresses must be 16-bit aligned.
  - Buffers holding the pre-conversion source data to be processed by the DSP must be cached in advance.
  - Before the post-conversion buffer obtained from the DSP is accessed, the cache must be invalidated.

## See Also

`DSPAudioCodecMode`
`DSP_LoadG711`
`DSP_EncodeG711`
`DSP_WaitForG711`
`DSP_TryWaitForG711`

## Revision History

2008/02/21 Initial version.

CONFIDENTIAL