dmMPEG1AudioDecoderCreate(3dm)

NAME
     dmMPEG1AudioDecoderCreate - allocate new DMMPEG1audiodecoder structure.


SYNOPSIS
     #include <dmedia/dmedia.h>
     #include <dmedia/dm_audioutil.h>


     DMstatus dmMPEG1AudioDecoderCreate(DMMPEG1audiodecoder *decoder)


PARAMETER
     decoder  DMMPEG1audiodecoder structure to be allocated.


RETURNED VALUE
     If successful, function returns a DM_SUCCESS. A DM_FAILURE return value
     indicates an error.


DESCRIPTION
     dmMPEG1AudioDecoderCreate(3dm) allocates and initializes a
     DMMPEG1audiodecoder structure.  This structure is then used for
     dmMPEG1AudioDecoderSetParmas(3dm), dmMPEG1AudioDecoderReset(3dm),
     dmMPEG1AudioDecoderGetParmas(3dm), dmMPEG1AudioFilterStateSave(3dm),
     dmMPEG1AudioFilterStateRestore(3dm), and dmMPEG1AudioDecode(3dm) rutines.
     dmMPEG1AudioDecoderCreate(3dm) will set decoder control, input, and
     output parameter values to predefined defaults and perform license check.
     If license check fails, it will return DM_FAILURE and report additional
     information for licensing.



NOTE
     User has to use dmMPEG1AudioDecoderSetParmas(3dm) after first call to
     dmMPEG1AudioDecoderCreate(3dm) in order to do additional initialization
     before using dmMPEG1AudioDecode(3dm).


SEE ALSO
     dmMPEG1AudioDecoderSetParmas, dmMPEG1AudioDecode(3dm),
     dmMPEG1AudioDecoderDestroy(3dm).