dmMPEG1AudioEncoderCreate(3dm)

NAME
     dmMPEG1AudioEncoderCreate - allocate new DMMPEG1audioencoder structure.


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


     DMstatus dmMPEG1AudioEncoderCreate(DMMPEG1audioencoder *encoder)


PARAMETER
     encoder  DMMPEG1audioencoder structure to be allocated.


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


DESCRIPTION
     dmMPEG1AudioEncoderCreate(3dm) allocates and initializes a
     DMMPEG1audioencoder structure.  This structure is then used for
     dmMPEG1AudioEncoderSetParmas(3dm), dmMPEG1AudioEncoderReset(3dm),
     dmMPEG1AudioEncoderGetParmas(3dm), dmMPEG1AudioFilterStateSave(3dm),
     dmMPEG1AudioFilterStateRestore(3dm), and dmMPEG1AudioEncode(3dm) rutines.
     dmMPEG1AudioEncoderCreate(3dm) will set encoder 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 dmMPEG1AudioEncoderSetParmas(3dm) after a call to
     dmMPEG1AudioEncoderCreate(3dm) in order to do additional initialization
     before using dmMPEG1AudioEncode(3dm).


SEE ALSO
     dmMPEG1AudioEncoderSetParmas, dmMPEG1AudioEncode(3dm),
     dmMPEG1AudioEncoderDestroy(3dm).