dmDVAudioDecode(3dm)

NAME
     dmDVAudioDecode - implements DV and DVCPRO audio decompression


SYNOPSIS
     #include <dmedia/dm_audioutil.h>

     DMstatus dmDVAudioDecode(DMDVaudiodecoder handle,
                          void *ibuf, void *obuf, int *nsamples)


PARAMETER
     handle    DMDVaudiodecoder structure, created by
               dmDVAudioDecoderCreate(3dm), specifies the states of the signal
               processing parameters.


     ibuf      pointer to input compressed data buffer, which is a complete
               DIF frame with embedded audio.  See dm_dv(3dm) for more
               information about DIF frames, DV, and DVCPRO. The DIF input
               buffer size must be either DM_DVAUDIO_NTSC_DIF_FRAMESIZE or
               DM_DVAUDIO_PAL_DIF_FRAMESIZE.


     obuf      pointer to output sample data buffer.  The data format is short
               (16-bit).  The samples are assumed to be two's complement.
               Sampling rate can be 32 kHz, 44.1 kHz, or 48 kHz.


     nsamples  number of samples to be processed.  This returns the number of
               samples actually processed.


RETURNED VALUE
     Returns DM_FAILURE or DM_SUCCESS.


DESCRIPTION
     dmDVAudioDecode(3dm) implements DV decompression.


SEE ALSO
     dmDVAudioDecoderCreate(3dm), dmDVAudioDecoderSetParams(3dm),
     dmDVAudioDecoderDestroy(3dm), dmDVAudioEncode(3dm)