dmDVAudioDecoderGetParams(3dm)

NAME
     dmDVAudioDecoderGetParams - get DV audio decoder parameter values


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

     DMstatus dmDVAudioDecoderGetParams(DMDVaudiodecoder handle,
                                   DMparams *params)


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


     params   Parameters returned from the query.


RETURNED VALUE
     Returns DM_SUCCESS or DM_FAILURE.


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:

     DM_DVAUDIO_FORMAT - either DM_DVAUDIO_NTSC or DM_DVAUDIO_PAL
     DM_DVAUDIO_TYPE - either DM_DVAUDIO_DV or DM_DVAUDIO_DVCPRO
     DM_AUDIO_CODEC_MAX_BYTES_PER_BLOCK - either 120000 for NTSC or 144000 for
     PAL
     DM_AUDIO_CHANNELS - number of channels of audio (1 or 2 or 4)
     DM_AUDIO_WIDTH - will always be 16
     DM_DVAUDIO_CHANNEL_MODE - either DM_DVAUDIO_SD_2CH or DM_DVAUDIO_SD_4CH
     DM_DVAUDIO_CHANNEL_POLICY - integer 1-19, described in dm_audioutil.h,
     which specify exactly how the audio is layed out inside the DIF frame.
     DM_MEDIUM - will always be DM_AUDIO
     DM_AUDIO_BYTE_ORDER - will always be DM_AUDIO_BIG_ENDIAN
     DM_AUDIO_FORMAT - will always be DM_AUDIO_TWOS_COMPLEMENT
     DM_AUDIO_RATE - the sample rate in floating point (ex: 48000.0)
     DM_AUDIO_CODEC_FRAMES_PER_BLOCK - the maximum number of samples this DIF
     frame could possibly contain
     DM_DVAUDIO_MIN_FRAMES_PER_BLOCK - the miniumum number of frames this DIF
     frame could possibly contain
     DM_AUDIO_CODEC_FILTER_DELAY - always zero
     DM_DVAUDIO_LOCK_MODE - non-zero if audio is locked according to the DV
     audio specification.  Zero if it is not locked.


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