dmACCreate(3dm)                                                dmACCreate(3dm)


NAME
     dmACCreate, dmACDestroy - create/destroy a DMaudioconverter handle used
     for audio format conversion.

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

     DMstatus dmACCreate(DMaudioconverter* converter)

     DMstatus dmACDestroy(DMaudioconverter converter)

RETURNED VALUE
     Returns DM_SUCCESS if the operation succeeds.  If DM_FAILURE is returned,
     the error number and/or message can be retrieved via dmGetError(3dm).

DESCRIPTION
     The handle passed to this routine is declared as follows:

     typedef struct _DMaudioconverter *DMaudioconverter;

     dmACCreate allocates and initializes an DMaudioconverter handle. This
     structure is then used as the basic argument for all Digital Media
     Library audio format conversion (dmAC) routines.  dmACDestroy frees all
     memory associated with the DMaudioconverter handle.  Any subsequent use
     of this handle is prohibited.

     Note that the creation routine takes a pointer to the typdef'd type, and
     the destroy routine does not.

SEE ALSO
     dmACSetParams(3dm), dmACGetParams(3dm), dmACConvert(3dm), dmACReset(3dm)


                                                                        Page 1