dmACCreate(3dm)                                                dmACCreate(3dm)



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

SYNOPSIS
     #include <dmedia/dmaudio.h>
     #include <dmedia/dmaudioutil.h>

     DMstatus dmACCreate(DMaudioconverter* converter)

     DMstatus dmACDestroy(DMaudioconverter converter)

RETURNED VALUE
     Returns DMSUCCESS if the operation succeeds.  If DMFAILURE 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