dmFS1016DecoderSetParams(3dm)                    dmFS1016DecoderSetParams(3dm)



NAME
     dmFS1016DecoderSetParams - set FS1016 decoder parameter values.


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

     DMstatus dmFS1016DecoderSetParams(DMFS1016decoder handle,
                                   DMparams *params)


PARAMETER
     handle   DMFS1016decoder structure, created by
              dmFS1016DecoderCreate(3dm).


     params   List of parameters for specification.  Null (0) value is
              acceptable.


RETURNED VALUE
     Returns DMSUCCESS or DMFAILURE.


DESCRIPTION
     dmFS1016DecoderSetParams(3dm) sets state of FS1016 decoder with params.
     Unrecognized parameters are ignored.


     The parameters of params for FS1016 decoder specification are, defined in
     dmedia/dm_audio.h and dmedia/dm_audioutil.h:

     DMAUDIOBITRATE
     DMFS1016POSTFILTERINGFLAG
     DMFS1016HIGHPASSFLAG


     The value for DMAUDIOBITRATE can be

     DMFS10164800BITS
     DMFS10167200BITS
     DMFS10169600BITS


     The value for DMFS1016POSTFILTERINGFLAG can be

     DMFS1016POSTFILTERINGYES
     DMFS1016POSTFILTERINGNO

     The value for DMFS1016HIGHPASSFLAG can be



                                                                        Page 1

dmFS1016DecoderSetParams(3dm)                    dmFS1016DecoderSetParams(3dm)



     DMFS1016HIGHPASSYES
     DMFS1016HIGHPASSNO



     The above values select a decoder with desired bitrate and with or
     without postfiltering and highpass filtering.  Cautious application of
     postfiltering at the decoder's output is recommended.  The human ear's
     masking properties are exploited to trade off speech distortion vs.
     quantizing noise.  In tandem coding scenarios, only one stage of
     postfiltering is recommended and multiple stages should be avoided.  The
     bitrate and decode mode are set by a call to
     dmFS1016DecoderSetParams(3dm). Without calling
     dmFS1016DecoderSetParams(3dm), decoder sets defaults to
     DMFS10164800BITS, DMFS1016POSTFILTERINGYES, and
     DMFS1016HIGHPASSNO.


NOTE
SEE ALSO
     dmFS1016DecoderCreate(3dm), dmFS1016Decode(3dm),
     dmFS1016DecoderGetParams(3dm).

































                                                                        Page 2