// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "Eclipse Public License v1.0"

// which accompanies this distribution, and is available

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

//

#ifndef MDASOUNDADAPTER_H

#define MDASOUNDADAPTER_H

#include <e32std.h>

#include <e32ver.h>

#define MDADEVSOUNDNAME _L8("RMdaDevSound")

 Adapter class which routes the calls on RMdaDevSound(old sound driver interface) to RSoundSc(new sound driver interface). 

 The purpose of this class is to use the new sound driver in MDF without changing the calling code. This class

 does not support any new functionalities supported by the shared chunk sound driver but supports the functionality of the 

 of the old driver with the new driver.

 */

class RMdaDevSound

	{

	class CBody;

public:

	enum for major, minor and build version of sound device driver.

	*/

	enum TVer {EMajorVersionNumber=1,EMinorVersionNumber=0,EBuildVersionNumber=KE32BuildVersionNumber};

	enum for sound media device play/record request.

	*/

	enum TMdaRequest

		{

		EMdaRequestPlayData,

		EMdaRequestPlayErrorNotification,

		EMdaRequestRecordData,

		EMdaRequestRecordErrorNotification

		};

	enum TMdaControl

		{

		EMdaControlPlayFormatsSupported,

		EMdaControlGetPlayFormat,

		EMdaControlSetPlayFormat,

		EMdaControlGetPlayVolume,

		EMdaControlSetPlayVolume,

		EMdaControlRecordFormatsSupported,

		EMdaControlGetRecordFormat,

		EMdaControlSetRecordFormat,

		EMdaControlGetRecordLevel,

		EMdaControlSetRecordLevel,

		EMdaControlFlushPlayBuffer,

		EMdaControlFlushRecordBuffer,

		EMdaControlBytesPlayed,

		EMdaControlResetBytesPlayed,

		EMdaControlIsMdaSound,

		EMdaControlPausePlayBuffer,

		EMdaControlResumePlaying

		};

    This enum corresponds to supported sound encoding schemes

    */

	enum TMdaSoundEncoding

		{

		EMdaSoundEncoding8BitPCM		= 0x00000001,

		EMdaSoundEncoding16BitPCM		= 0x00000002,

		EMdaSoundEncoding8BitALaw		= 0x00000004,

		EMdaSoundEncoding8BitMuLaw		= 0x00000008,

		};

    This class corresponds to a supported sound format.

	The format describes the supported audio device's min/max sampling rate, encoding, channels and buffer size of play/record and volume.

    */

	class TSoundFormatsSupported

		{

	public:

    This corresponds to minimum sample rate supported. This depends on the physical sound device used(example: 8000 hertz). 

    */

		TInt iMinRate;

    This corresponds to maximum sample rate supported. This depends on the physical sound device used(example: 48000 hertz).

    */

		TInt iMaxRate;

    This corresponds to encoding format supported.  

	@see  TMdaSoundEncoding

    */		

		TUint32 iEncodings;

    This corresponds to the number of sound channels supported. Possible values are EMono for a single channel and EStereo for two channel sound.

	Also this depends on the physical device used.

    */

		TInt iChannels;

    This corresponds to minimum buffer size. This depends on the physical device used and sampling rate adapted.

	@see KSoundMinBufferSize

    */

		TInt iMinBufferSize;

    This corresponds to maximum buffer size.This depends on the physical device used and sampling rate adapted. 

	@see KSoundPlayBufferSize

    @see KSoundRecordBufferSize

    */

		TInt iMaxBufferSize;

    This corresponds to minimum play/record volume. 

    */	

		TInt iMinVolume;

    This corresponds to maximum play/record volume. 

    */

		TInt iMaxVolume;

		};

	typedef TPckgBuf<TSoundFormatsSupported> TSoundFormatsSupportedBuf;

    This class corresponds to current supported sound format. 

	The format describes the supported audio device's sampling rate, encoding, channels and buffer size of play/record.

    */

	class TCurrentSoundFormat

		{

	public:

    This corresponds to sound sampling rate like (44000 Hertz, 8000 Hertz). The possible values depends on the physical device used.

    */

		TInt iRate;

    @see TMdaSoundEncoding

    */

		TMdaSoundEncoding iEncoding;

    This corresponds to the number of sound channels supported. Possible values are EMono for a single channel and EStereo for two channel sound.

	Also this depends on the physical device used.

    */

		TInt iChannels;

    Play or Record buffer size. The possible value depends on the physical device used. 

    */

		TInt iBufferSize;

		};

	typedef TPckgBuf<TCurrentSoundFormat> TCurrentSoundFormatBuf;

public:

	IMPORT_C RMdaDevSound();

	IMPORT_C TInt Open(TInt aUnit=KNullUnit);

	IMPORT_C TVersion VersionRequired() const;

	IMPORT_C TInt IsMdaSound();

	IMPORT_C void PlayFormatsSupported(TSoundFormatsSupportedBuf& aFormatsSupported);

	IMPORT_C void GetPlayFormat(TCurrentSoundFormatBuf& aFormat);

	IMPORT_C TInt SetPlayFormat(const TCurrentSoundFormatBuf& aFormat);

	IMPORT_C TInt PlayVolume();

	IMPORT_C void SetVolume(TInt aLogarithmicVolume);

	IMPORT_C void PlayData(TRequestStatus& aStatus,const TDesC8& aData);

	IMPORT_C void CancelPlayData();

	IMPORT_C void NotifyPlayError(TRequestStatus& aStatus);

	IMPORT_C void CancelNotifyPlayError();

	IMPORT_C void RecordFormatsSupported(TSoundFormatsSupportedBuf& aFormatsSupported);

	IMPORT_C void GetRecordFormat(TCurrentSoundFormatBuf& aFormat);

	IMPORT_C TInt SetRecordFormat(const TCurrentSoundFormatBuf& aFormat);

	IMPORT_C TInt RecordLevel();

	IMPORT_C void SetRecordLevel(TInt aLevel);

	IMPORT_C void RecordData(TRequestStatus& aStatus,TDes8& aData);

	IMPORT_C void CancelRecordData();

	IMPORT_C void NotifyRecordError(TRequestStatus& aStatus);

	IMPORT_C void CancelNotifyRecordError();

	IMPORT_C void FlushPlayBuffer();

	IMPORT_C void FlushRecordBuffer();

	IMPORT_C TInt BytesPlayed();

	IMPORT_C void ResetBytesPlayed();

	IMPORT_C void PausePlayBuffer();

	IMPORT_C void ResumePlaying();

	IMPORT_C void ResumePlaying(TRequestStatus&);

	IMPORT_C void Close();

	IMPORT_C TInt Handle();

	IMPORT_C void PauseRecordBuffer();

	IMPORT_C void ResumeRecording();

	IMPORT_C TInt GetTimePlayed(TTimeIntervalMicroSeconds& aTimePlayed);

private:

	CBody* iBody;

	};

#endif