dmDVAudioDecoderGetParams(3dm)			dmDVAudioDecoderGetParams(3dm)

NAME    [Toc]    [Back]

     dmDVAudioDecoderGetParams - get DV	audio decoder parameter	values

SYNOPSIS    [Toc]    [Back]

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

     DMstatus dmDVAudioDecoderGetParams(DMDVaudiodecoder handle,
				   DMparams *params)

PARAMETER    [Toc]    [Back]

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


     params   Parameters returned from the query.

RETURNED VALUE    [Toc]    [Back]

     Returns DM_SUCCESS	or DM_FAILURE.

DESCRIPTION    [Toc]    [Back]

     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



									Page 1






dmDVAudioDecoderGetParams(3dm)			dmDVAudioDecoderGetParams(3dm)



     audio specification.  Zero	if it is not locked.

SEE ALSO    [Toc]    [Back]

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


									PPPPaaaaggggeeee 2222