dmDVAudioDecoderGetParams(3dm)                  dmDVAudioDecoderGetParams(3dm)



NAME
     dmDVAudioDecoderGetParams - get DV audio decoder parameter values


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

     DMstatus dmDVAudioDecoderGetParams(DMDVaudiodecoder handle,
                                   DMparams *params)


PARAMETER
     handle   DMDVaudiodecoder structure, created by
              dmDVAudioDecoderCreate(3dm).


     params   Parameters returned from the query.


RETURNED VALUE
     Returns DMSUCCESS or DMFAILURE.


DESCRIPTION
     dmDVAudioDecoderGetParams(3dm) gets state of DV audio decoder with
     params.


     The set of parameters of params returned by the query are defined in
     dmedia/dm_audioutil.h and dmedia/dm_audio.h:

     DMDVAUDIOFORMAT - either DM_DVAUDIO_NTSC or DM_DVAUDIO_PAL
     DMDVAUDIOTYPE - either DM_DVAUDIO_DV or DM_DVAUDIO_DVCPRO
     DMAUDIOCODECMAXBYTESPERBLOCK - either 120000 for NTSC or 144000 for
     PAL
     DMAUDIOCHANNELS - number of channels of audio (1 or 2 or 4)
     DMAUDIOWIDTH - will always be 16
     DMDVAUDIOCHANNELMODE - either DM_DVAUDIO_SD_2CH or DM_DVAUDIO_SD_4CH
     DMDVAUDIOCHANNELPOLICY - integer 1-19, described in dm_audioutil.h,
     which specify exactly how the audio is layed out inside the DIF frame.
     DMMEDIUM - will always be DM_AUDIO
     DMAUDIOBYTEORDER - will always be DM_AUDIO_BIG_ENDIAN
     DMAUDIOFORMAT - will always be DM_AUDIO_TWOS_COMPLEMENT
     DMAUDIORATE - the sample rate in floating point (ex: 48000.0)
     DMAUDIOCODECFRAMESPERBLOCK - the maximum number of samples this DIF
     frame could possibly contain
     DMDVAUDIOMINFRAMESPERBLOCK - the miniumum number of frames this DIF
     frame could possibly contain
     DMAUDIOCODECFILTERDELAY - always zero
     DMDVAUDIOLOCKMODE - non-zero if audio is locked according to the DV



                                                                        Page 1

dmDVAudioDecoderGetParams(3dm)                  dmDVAudioDecoderGetParams(3dm)



     audio specification.  Zero if it is not locked.


SEE ALSO
     dmDVAudioDecoderCreate(3dm), dmDVAudioDecoderSetParams(3dm),
     dmDVAudioDecode(3dm).

















































                                                                        Page 2