dmACReset(3dm)							dmACReset(3dm)

NAME    [Toc]    [Back]

     dmACReset - reset a DMaudioconverter handle to its	default	state

SYNOPSIS    [Toc]    [Back]

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

     DMstatus dmACReset(DMaudioconverter converter)    [Toc]    [Back]

PARAMETERS    [Toc]    [Back]

     converter	 is a DMaudioconverter handle created by a previous call to
		 the creation method dmACCreate(3dm).

RETURNED VALUE    [Toc]    [Back]

     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    [Toc]    [Back]

     The handle	passed to this routine is declared as follows:

     typedef struct _DMaudioconverter *DMaudioconverter;

     dmACReset(3dm) clears and zeros any internal buffered data	and resets all
     counters, essentially returning the converter to the state	it was in
     immediately following a call to dmACSetParams(3dm).  This might be
     desirable in a case where an existing stream of data were to be
     interrupted and replaced with a new stream, and the user wished to	be
     certain all of the	previously-processed data was cleared.

SEE ALSO    [Toc]    [Back]

     dmACCreate(3dm), dmACSetParams(3dm), dmACGetParams(3dm),
     dmACConvert(3dm), dmACDestroy(3dm)


									PPPPaaaaggggeeee 1111