sl@0: // Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: //
sl@0: 
sl@0: #include <mmf/server/sounddevice.h>
sl@0: #include "SoundDeviceBody.h"
sl@0: 
sl@0: /*
sl@0:  *
sl@0:  *	Default Constructor.
sl@0:  *
sl@0:  *
sl@0:  */
sl@0: CMMFDevSound::CMMFDevSound()
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Destructor.
sl@0:  *
sl@0:  *	Deletes all objects and releases all resource owned by this
sl@0:  *	instance.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C CMMFDevSound::~CMMFDevSound()
sl@0: 	{
sl@0: 	delete iBody;
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Constructs, and returns a pointer to, a new CMMFDevSound object.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C CMMFDevSound* CMMFDevSound::NewL()
sl@0: 	{
sl@0: 	CMMFDevSound* self = new (ELeave) CMMFDevSound;
sl@0: 	CleanupStack::PushL(self);
sl@0: 	self->ConstructL();
sl@0: 	CleanupStack::Pop();
sl@0: 	return self;
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Second phase constructor.
sl@0:  *
sl@0:  */
sl@0: void CMMFDevSound::ConstructL()
sl@0: 	{
sl@0: 	iBody = CBody::NewL();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes CMMFDevSound object to play and record PCM16 raw audio data
sl@0:  *	with sampling rate of 8 KHz.
sl@0:  *
sl@0:  *	On completion of Initialization, calls InitializeComplete() on
sl@0:  *	aDevSoundObserver.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"aDevSoundObserver"
sl@0:  *			A reference to DevSound Observer instance.
sl@0:  *
sl@0:  *	@param	"aMode"
sl@0:  *			Mode for which this object will be used.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::InitializeL(MDevSoundObserver& aDevSoundObserver, TMMFState aMode)
sl@0: 
sl@0: 	{
sl@0: 	iBody->InitializeL(aDevSoundObserver,aMode);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes DevSound object for the mode aMode for processing audio data
sl@0:  *	with hardware device aHWDev.
sl@0:  *
sl@0:  *	On completion of Initialization, the observer will be notified via call back
sl@0:  *	InitializeComplete().
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"aDevSoundObserver"
sl@0:  *			A reference to DevSound Observer instance.
sl@0:  *
sl@0:  *	@param	"aHWDev"
sl@0:  *			CMMFHwDevice implementation identifier.
sl@0:  *
sl@0:  *	@param	"aMode"
sl@0:  *			Mode for which this object will be used.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::InitializeL(MDevSoundObserver& aDevSoundObserver, TUid aHWDev, TMMFState aMode)
sl@0: 	{
sl@0: 	iBody->InitializeL(aDevSoundObserver, aHWDev, aMode);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes DevSound object for the mode aMode for processing audio data
sl@0:  *	with hardware device supporting FourCC aDesiredFourCC.
sl@0:  *
sl@0:  *	On completion of Initialization, the observer will be notified via call back
sl@0:  *	InitializeComplete().
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"aDevSoundObserver"
sl@0:  *			A reference to DevSound Observer instance.
sl@0:  *
sl@0:  *	@param	"aDesiredFourCC"
sl@0:  *			CMMFHwDevice implementation FourCC.
sl@0:  *
sl@0:  *	@param	"aMode"
sl@0:  *			Mode for which this object will be used.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::InitializeL(MDevSoundObserver& aDevSoundObserver, 
sl@0: 										  TFourCC aDesiredFourCC, TMMFState aMode)
sl@0: 	{
sl@0: 	iBody->InitializeL(aDevSoundObserver, aDesiredFourCC, aMode);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns the supported Audio settings.
sl@0:  *
sl@0:  *	@return	"TMMFCapabilities"
sl@0:  *			Device settings.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TMMFCapabilities CMMFDevSound::Capabilities()
sl@0: 	{
sl@0: 	return iBody->Capabilities();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns the current audio settings.
sl@0:  *
sl@0:  *	@return	"TMMFCapabilities"
sl@0:  *			Device settings.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TMMFCapabilities CMMFDevSound::Config() const
sl@0: 	{
sl@0: 	return iBody->Config();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Configure CMMFDevSound object for the settings in aConfig.
sl@0:  *
sl@0:  *	Use this to set sampling rate, Encoding and Mono/Stereo.
sl@0:  *
sl@0:  *	@param	"aConfig"
sl@0:  *			Attribute values to which CMMFDevSound object will be configured to.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetConfigL(const TMMFCapabilities& aConfig)
sl@0: 	{
sl@0: 	iBody->SetConfigL(aConfig);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns an integer representing the maximum volume.
sl@0:  *
sl@0:  *	This is the maximum value which can be passed to CMMFDevSound::SetVolume.
sl@0:  *
sl@0:  *	@return	"TInt"
sl@0:  *			The maximum volume. This value is platform dependent but is always
sl@0:  *			greater than or equal to one.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TInt CMMFDevSound::MaxVolume()
sl@0: 	{
sl@0: 	return iBody->MaxVolume();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns an integer representing the current volume.
sl@0:  *
sl@0:  *	@return	"TInt"
sl@0:  *			The current volume level.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TInt CMMFDevSound::Volume()
sl@0: 	{
sl@0: 	return iBody->Volume();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Changes the current playback volume to a specified value.
sl@0:  *
sl@0:  *	The volume can be changed before or during playback and is effective
sl@0:  *	immediately.
sl@0:  *
sl@0:  *	@param	"aVolume"
sl@0:  *			The volume setting. This can be any value from zero to the value
sl@0:  *			returned by a call to CMMFDevSound::MaxVolume(). If the
sl@0:  *			volume is not within this range, the volume is automatically set to
sl@0:  *			minimum or maximum value based on the value that is being passed.
sl@0:  *			Setting a zero value mutes the sound. Setting the maximum value
sl@0:  *			results in the loudest possible sound.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetVolume(TInt aVolume)
sl@0: 	{
sl@0: 	iBody->SetVolume(aVolume);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns an integer representing the maximum gain.
sl@0:  *
sl@0:  *	This is the maximum value which can be passed to CMMFDevSound::SetGain.
sl@0:  *
sl@0:  *	@return	"TInt"
sl@0:  *			The maximum gain. This value is platform dependent but is always
sl@0:  *			greater than or equal to one.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TInt CMMFDevSound::MaxGain()
sl@0: 	{
sl@0: 	return iBody->MaxGain();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns an integer representing the current gain.
sl@0:  *
sl@0:  *	@return	"TInt"
sl@0:  *			The current gain level.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TInt CMMFDevSound::Gain()
sl@0: 	{
sl@0: 	return iBody->Gain();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Changes the current recording gain to a specified value.
sl@0:  *
sl@0:  *	The gain can be changed before or during recording and is effective
sl@0:  *	immediately.
sl@0:  *
sl@0:  *	@param	"TInt aGain"
sl@0:  *			The gain setting. This can be any value from zero to the value
sl@0:  *			returned by a call to CMMFDevSound::MaxGain(). If the
sl@0:  *			volume is not within this range, the gain is automatically set to
sl@0:  *			minimum or maximum value based on the value that is being passed.
sl@0:  *			Setting a zero value mutes the sound. Setting the maximum value
sl@0:  *			results in the loudest possible sound.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetGain(TInt aGain)
sl@0: 	{
sl@0: 	iBody->SetGain(aGain);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns the speaker balance set for playing.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"aLeftPrecentage"
sl@0:  *			On return contains the left speaker volume percentage.
sl@0:  *
sl@0:  *	@param	"aRightPercentage"
sl@0:  *			On return contains the right speaker volume percentage.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::GetPlayBalanceL(TInt& aLeftPercentage, TInt& aRightPercentage)
sl@0: 	{
sl@0: 	iBody->GetPlayBalanceL(aLeftPercentage, aRightPercentage);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Sets the speaker balance for playing.
sl@0:  *
sl@0:  *	The speaker balance can be changed before or during playback and is
sl@0:  *	effective immediately.
sl@0:  *
sl@0:  *	@param	"aLeftPercentage"
sl@0:  *			On return contains left speaker volume perecentage. This can be any
sl@0:  *			value from zero to 100. Setting a zero value mutes the sound on left
sl@0:  *			speaker.
sl@0:  *
sl@0:  *	@param	"aRightPercentage"
sl@0:  *			On return contains right speaker volume perecentage. This can be any
sl@0:  *			value from zero to 100. Setting a zero value mutes the sound on
sl@0:  *			right speaker.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetPlayBalanceL(TInt aLeftPercentage, TInt aRightPercentage)
sl@0: 	{
sl@0: 	iBody->SetPlayBalanceL(aLeftPercentage, aRightPercentage);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns the microphone gain balance set for recording.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"aLeftPercentage"
sl@0:  *			On return contains the left microphone gain percentage.
sl@0:  *
sl@0:  *	@param	"aRightPercentage"
sl@0:  *			On return contains the right microphone gain percentage.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::GetRecordBalanceL(TInt& aLeftPercentage, TInt& aRightPercentage)
sl@0: 	{
sl@0: 	iBody->GetRecordBalanceL(aLeftPercentage, aRightPercentage);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Sets the microphone gain balance for recording.
sl@0:  *
sl@0:  *	The microphone gain balance can be changed before or during recording and
sl@0:  *	is effective immediately.
sl@0:  *
sl@0:  *	@param	"aLeftPercentage"
sl@0:  *			Left microphone gain precentage. This can be any value from zero to
sl@0:  *			100. Setting a zero value mutes the gain on left microphone.
sl@0:  *
sl@0:  *	@param	"aRightPercentage"
sl@0:  *			Right microphone gain precentage. This can be any value from zero to
sl@0:  *			100. Setting a zero value mutes the gain on right microphone.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetRecordBalanceL(TInt aLeftPercentage, TInt aRightPercentage)
sl@0: 	{
sl@0: 	iBody->SetRecordBalanceL(aLeftPercentage, aRightPercentage);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes audio device and start play process. This method queries and
sl@0:  *	acquires the audio policy before initializing audio device. If there was an
sl@0:  *	error during policy initialization, PlayError() method will be called on
sl@0:  *	the observer with error code KErrAccessDenied, otherwise BufferToBeFilled()
sl@0:  *	method will be called with a buffer reference. After reading data into the
sl@0:  *	buffer reference passed, the client should call PlayData() to play data.
sl@0:  *
sl@0:  *	The amount of data that can be played is specified in
sl@0:  *	CMMFBuffer::RequestSize(). Any data that is read into buffer beyond this
sl@0:  *	size will be ignored.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::PlayInitL()
sl@0: 	{
sl@0: 	iBody->PlayInitL();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes audio device and start record process. This method queries and
sl@0:  *	acquires the audio policy before initializing audio device. If there was an
sl@0:  *	error during policy initialization, RecordError() method will be called on
sl@0:  *	the observer with error code KErrAccessDenied, otherwise BufferToBeEmptied()
sl@0:  *	method will be called with a buffer reference. This buffer contains recorded
sl@0:  *	or encoded data. After processing data in the buffer reference passed, the
sl@0:  *	client should call RecordData() to continue recording process.
sl@0:  *
sl@0:  *	The amount of data that is available is specified in
sl@0:  *	CMMFBuffer::RequestSize().
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::RecordInitL()
sl@0: 	{
sl@0: 	iBody->RecordInitL();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Plays data in the buffer at the current volume. The client should fill
sl@0:  *	the buffer with audio data before calling this method. The Observer gets
sl@0:  *	reference to buffer along with callback BufferToBeFilled(). When playing of
sl@0:  *	the audio sample is complete, successfully or otherwise, the method
sl@0:  *	PlayError() on observer is called.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::PlayData()
sl@0: 	{
sl@0: 	iBody->PlayData();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Contine the process of recording. Once the buffer is filled with recorded
sl@0:  *	data, the Observer gets reference to buffer along with callback
sl@0:  *	BufferToBeEmptied(). After processing the buffer (copying over to a
sl@0:  *	different buffer or writing to file) the client should call this
sl@0:  *	method to continue recording process.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::RecordData()
sl@0: 	{
sl@0: 	iBody->RecordData();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Stops the ongoing operation (Play, Record, TonePlay, Convert)
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::Stop()
sl@0: 	{
sl@0: 	iBody->Stop();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Temporarily Stops the ongoing operation (Play, Record, TonePlay, Convert)
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::Pause()
sl@0: 	{
sl@0: 	iBody->Pause();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns the sample recorded so far.
sl@0:  *
sl@0:  *	@return "TInt"
sl@0:  *			Returns the samples recorded.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TInt CMMFDevSound::SamplesRecorded()
sl@0: 	{ 
sl@0: 	return iBody->SamplesRecorded();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns the sample played so far.
sl@0:  *
sl@0:  *	@return "TInt"
sl@0:  *			Returns the samples recorded.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TInt CMMFDevSound::SamplesPlayed()
sl@0: 	{ 
sl@0: 	return iBody->SamplesPlayed();
sl@0: 	}
sl@0: 
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes audio device and start playing tone. Tone is played with
sl@0:  *	frequency and for duration specified.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"aFrequency"
sl@0:  *			Frequency at with the tone will be played.
sl@0:  *
sl@0:  *	@param	"aDuration"
sl@0:  *			The period over which the tone will be played. A zero value causes
sl@0:  *			the no tone to be played (Verify this with test app).
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::PlayToneL(TInt aFrequency, const TTimeIntervalMicroSeconds& aDuration)
sl@0: 	{
sl@0: 	iBody->PlayToneL(aFrequency, aDuration);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes audio device and start playing a dual tone. 
sl@0:  *  The tone consists of two sine waves of different frequencies summed together
sl@0:  *  Dual Tone is played with specified frequencies and for specified duration.
sl@0:  *
sl@0:  *	@param	"aFrequencyOne"
sl@0:  *			First frequency of dual tone
sl@0:  *
sl@0:  *	@param	"aFrequencyTwo"
sl@0:  *			Second frequency of dual tone
sl@0:  *
sl@0:  *	@param	"aDuration"
sl@0:  *			The period over which the tone will be played. A zero value causes
sl@0:  *			the no tone to be played (Verify this with test app).
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::PlayDualToneL(TInt aFrequencyOne, TInt aFrequencyTwo, const TTimeIntervalMicroSeconds& aDuration)
sl@0: 	{
sl@0: 	iBody->PlayDualToneL(aFrequencyOne, aFrequencyTwo, aDuration);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes audio device and start playing DTMF string aDTMFString.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"aDTMFString"
sl@0:  *			DTMF sequence in a descriptor.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::PlayDTMFStringL(const TDesC& aDTMFString)
sl@0: 	{
sl@0: 	iBody->PlayDTMFStringL(aDTMFString);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes audio device and start playing tone sequence.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"TDesC8& aData"
sl@0:  *			Tone sequence in a descriptor.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::PlayToneSequenceL(const TDesC8& aData)
sl@0: 	{
sl@0: 	iBody->PlayToneSequenceL(aData);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Initializes audio device and start playing the specified pre-defined tone
sl@0:  *	sequence.
sl@0:  *
sl@0:  *	Leaves on failure.
sl@0:  *
sl@0:  *	@param	"aSequenceNumber"
sl@0:  *			The index identifying the specific pre-defined tone sequence. Index
sl@0:  *			values are relative to zero.
sl@0:  *			This can be any value from zero to the value returned by a call to
sl@0:  *			FixedSequenceCount() - 1.
sl@0:  *			The function raises a panic if sequence number is not within this
sl@0:  *			range.
sl@0:  *	@see	FixedSequenceCount()
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::PlayFixedSequenceL(TInt aSequenceNumber)
sl@0: 	{
sl@0: 	iBody->PlayFixedSequenceL(aSequenceNumber);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Defines the number of times the audio is to be repeated during the tone
sl@0:  *	playback operation.
sl@0:  *
sl@0:  *	A period of silence can follow each playing of tone. The tone playing can
sl@0:  *	be repeated indefinitely.
sl@0:  *
sl@0:  *	@param	" aRepeatCount"
sl@0:  *			The number of times the tone, together with the trailing silence,
sl@0:  *			is to be repeated. If this is set to KMdaRepeatForever, then the
sl@0:  *			tone, together with the trailing silence, is repeated indefinitely
sl@0:  *			or until Stop() is called. If this is set to zero, then the tone is
sl@0:  *			not repeated.
sl@0:  *
sl@0:  *			Supported only during tone playing.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetToneRepeats(TInt aRepeatCount,
sl@0: 				const TTimeIntervalMicroSeconds& aRepeatTrailingSilence)
sl@0: 	{
sl@0: 	iBody->SetToneRepeats(aRepeatCount, aRepeatTrailingSilence);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Defines the duration of tone on, tone off and tone pause to be used during the
sl@0:  *	DTMF tone playback operation.
sl@0:  *
sl@0:  *	Supported only during tone playing.
sl@0:  *
sl@0:  *	@param	"aToneOnLength"
sl@0:  *			The period over which the tone will be played. If this is set to
sl@0:  *			zero, then the tone is not played.
sl@0:  *
sl@0:  *	@param	"aToneOffLength"
sl@0:  *			The period over which the no tone will be played.
sl@0:  *
sl@0:  *	@param	"aPauseLength"
sl@0:  *			The period over which the tone playing will be paused.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetDTMFLengths(TTimeIntervalMicroSeconds32& aToneOnLength,
sl@0: 								TTimeIntervalMicroSeconds32& aToneOffLength,
sl@0: 								TTimeIntervalMicroSeconds32& aPauseLength) 
sl@0: 	{
sl@0: 	iBody->SetDTMFLengths(aToneOnLength, aToneOffLength, aPauseLength);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Defines the period over which the volume level is to rise smoothly from
sl@0:  *	nothing to the normal volume level.
sl@0:  *
sl@0:  *	@param	"aRampDuration"
sl@0:  *			The period over which the volume is to rise. A zero value causes 
sl@0:  *			the tone sample to be played at the normal level for the full
sl@0:  *			duration of the playback. A value, which is longer than the duration
sl@0:  *			of the tone sample, that the sample never reaches its normal
sl@0:  *			volume level.
sl@0:  *
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetVolumeRamp(const TTimeIntervalMicroSeconds& aRampDuration)
sl@0: 	{	
sl@0: 	iBody->SetVolumeRamp(aRampDuration);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Defines the priority settings that should be used for this instance.
sl@0:  *
sl@0:  *	@param	"aPrioritySettings"
sl@0:  *			An class type representing the client's priority, priority 
sl@0:  *			preference and state.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::SetPrioritySettings(const TMMFPrioritySettings& aPrioritySettings)
sl@0: 	{
sl@0: 	iBody->SetPrioritySettings(aPrioritySettings);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TAny* CMMFDevSound::CustomInterface(TUid aInterface)
sl@0: 	{
sl@0: 	return iBody->CustomInterface(aInterface);
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns the number of available pre-defined tone sequences.
sl@0:  *
sl@0:  *	This is the number of fixed sequence supported by DevSound by default.
sl@0:  *
sl@0:  *	@return	"TInt"
sl@0:  *			The fixed sequence count. This value is implementation dependent
sl@0:  *			but is always greater than or equal to zero.
sl@0:  *
sl@0:  */
sl@0: EXPORT_C TInt CMMFDevSound::FixedSequenceCount()
sl@0: 	{
sl@0: 	return iBody->FixedSequenceCount();
sl@0: 	}
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments moved to header-
sl@0:  *
sl@0:  *	Returns the name assigned to a specific pre-defined tone sequence.
sl@0:  *
sl@0:  *	This is the number of fixed sequence supported by DevSound by default.
sl@0:  *
sl@0:  *	The function raises a panic if sequence number specified invalid.
sl@0:  *
sl@0:  *	@return	"TDesC&"
sl@0:  *			A reference to a Descriptor containing the fixed sequence
sl@0:  *			name indexed by aSequenceNumber.
sl@0:  *
sl@0:  *	@param	"aSequenceNumber"
sl@0:  *			The index identifying the specific pre-defined tone sequence. Index
sl@0:  *			values are relative to zero.
sl@0:  *			This can be any value from zero to the value returned by a call to
sl@0:  *			FixedSequenceCount() - 1.
sl@0:  *			The function raises a panic if sequence number is not within this
sl@0:  *			range.
sl@0:  *
sl@0:  *	@see	FixedSequenceCount()
sl@0:  *
sl@0:  */
sl@0: EXPORT_C const TDesC& CMMFDevSound::FixedSequenceName(TInt aSequenceNumber)
sl@0: 	{
sl@0: 	return iBody->FixedSequenceName(aSequenceNumber);
sl@0: 	}
sl@0: 
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments in header-
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::GetSupportedInputDataTypesL(RArray<TFourCC>& aSupportedDataTypes,const TMMFPrioritySettings& aPrioritySettings) const
sl@0: 	{
sl@0: 	iBody->GetSupportedInputDataTypesL(aSupportedDataTypes, aPrioritySettings);
sl@0: 	}
sl@0: 
sl@0: 
sl@0: /*
sl@0:  *  -doxygen comments in header-
sl@0:  */
sl@0: EXPORT_C void CMMFDevSound::GetSupportedOutputDataTypesL(RArray<TFourCC>& aSupportedDataTypes, const TMMFPrioritySettings& aPrioritySettings) const
sl@0: 	{
sl@0: 	iBody->GetSupportedOutputDataTypesL(aSupportedDataTypes, aPrioritySettings);
sl@0: 	}
sl@0: 
sl@0: 
sl@0: /********************************************************************************
sl@0:  *				Non Exported public functions ends here							*
sl@0:  ********************************************************************************/
sl@0: 
sl@0: /******************************************************************************
sl@0:  *	Function Name:	E32Dll
sl@0:  *	
sl@0:  *	Description:	Entry point for applications.
sl@0:  *
sl@0:  ******************************************************************************/
sl@0: 
sl@0: enum TDllReason {};
sl@0: EXPORT_C TInt E32Dll(TDllReason /*aReason*/)
sl@0: 	{
sl@0: 	return KErrNone;
sl@0: 	}
sl@0: 
sl@0: // CMMFDevSoundEventHandler::NewL() has been declared in export table
sl@0: // but since it is the only class method to be so, and .h is in source
sl@0: // it is not actually usable. Just declare the following to keep linker happy
sl@0: 
sl@0: // Need dummy abstract type - this is not the real class
sl@0: class RMMFAudioPolicyProxy;
sl@0: 
sl@0: class CMMFDevSoundEventHandler : public CActive
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C static CMMFDevSoundEventHandler* NewL(RMMFAudioPolicyProxy*);
sl@0: private:
sl@0: 	CMMFDevSoundEventHandler();
sl@0: 	};
sl@0: 	
sl@0: EXPORT_C CMMFDevSoundEventHandler* CMMFDevSoundEventHandler::NewL(RMMFAudioPolicyProxy*)
sl@0: 	{
sl@0: 	_LIT(KModule, "DevSound");
sl@0: 	User::Panic(KModule, 1000);
sl@0: 	return NULL;
sl@0: 	}
sl@0: 
sl@0: // default constructor - keep compilers happy
sl@0: CMMFDevSoundEventHandler::CMMFDevSoundEventHandler():
sl@0: 	CActive(0)
sl@0: 	{
sl@0: 	}