dmFS1016DecoderGetParams(3dm) dmFS1016DecoderGetParams(3dm)
NAME
dmFS1016DecoderGetParams - get FS1016 decoder parameter values
SYNOPSIS
#include <dmedia/dmaudioutil.h>
#include <dmedia/dmaudio.h>
#include <dmedia/dmparams.h>
DMstatus dmFS1016DecoderGetParams(DMFS1016decoder handle,
DMparams *params)
PARAMETER
handle DMFS1016decoder structure, created by
dmFS1016DecoderCreate(3dm).
params List of parameters for query.
RETURNED VALUE
Returns DMSUCCESS or DMFAILURE.
DESCRIPTION
dmFS1016DecoderGetParams(3dm) gets state of FS1016 decoder with params.
The set of parameters of params for query are, defined in
dmedia/dm_audioutil.h and dmedia/dm_audio.h:
DMAUDIOBITRATE
DMAUDIOCODECMAXBYTESPERBLOCK
DMAUDIOCODECFRAMESPERBLOCK
DMAUDIOCODECFILTERDELAY
DMFS1016POSTFILTERINGFLAG
DMFS1016HIGHPASSFLAG
The value for DMAUDIOBITRATE can be
DMFS10164800BITS
DMFS10167200BITS
DMFS10169600BITS
The value for DMFS1016POSTFILTERINGFLAG can be
DMFS1016POSTFILTERINGYES
DMFS1016POSTFILTERINGNO
Page 1
dmFS1016DecoderGetParams(3dm) dmFS1016DecoderGetParams(3dm)
The value for DMFS1016HIGHPASSFLAG can be
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 4800 bits/s,
DMFS1016POSTFILTERINGYES, and DMFS1016HIGHPASSNO.
NOTE
SEE ALSO
dmFS1016DecoderCreate(3dm), dmFS1016Decode(3dm),
dmFS1016DecoderSetParams(3dm).
Page 2