// Copyright (c) 2003-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:

 // mmfswaudioinput.h

 // 

 //

 #ifndef SWAUDIOINPUT_H

 #define SWAUDIOINPUT_H

 #include <e32base.h>

 #include <d32soundsc.h>

 //TAudioInputParams 

 //- give sample rate and buffer size

 class TAudioInputParams

 	{

 public:

 	IMPORT_C TAudioInputParams();

 	TInt iSampleRate;

 		// The sample rate of the data past to the client. Ideally, but not

 		// necessarily that used on the device

 	TInt iNumChannels;

 		// Number of channels to use. 1 = mono. 2 = (interleaved) stereo.

 	TInt iNominalBufferSize;

 		// "Full buffers" are to be of this size. (Only the penultimate can be shorter)

 	TInt iInitialGain;

 		// Gain to use on start.

 	};

 // Observer class for MAudioInput

 class MAudioInputObserver

 	{

 public:

 	virtual void InputBufferAvailable(const TDesC8& aBuffer)=0;

 		// A buffer of data is available. Assume single buffering

 	virtual void InputFinished()=0;

 		// called following Pause() to say no more data left

 	virtual void InputError(TInt aError)=0;

 		// called on fatal(ish) error. Client should call Stop() and/or Close()

 	};

 // Interface to SwWrapper AudioInput

 class MAudioInput

 	{

 public:

 	IMPORT_C static MAudioInput* CreateL(MAudioInputObserver& aObserver);

 		// Create new object

 	virtual void Release()=0;

 		// destructor call

 	virtual TInt Initialize(const TAudioInputParams& aParams)=0;

 		// Initialize with given properties. synchronous call.

 	virtual void Close()=0;

 		// undo of Initialize() - return to created state. Implied Stop() if required.

 	virtual TInt Start()=0;

 		// Start to record and supply buffers. Only valid if initialized

 		// subsequently BufferToEmpty() will be called

 	virtual void BufferAck()=0;

 		// The buffer supplied by InputBufferAvailable has been read.

 		// Client must have stopped reading from the buffer

 	virtual TInt Pause()=0;

 		// pause (temporarily stop) recording. When all buffers have been passed

 		// InputFinished() is called.

 	virtual TInt Resume()=0;

 		// resume from paused mode. If InputFinished() has not been sent

 		// already it won't be

 	virtual TInt Flush()=0;

 		// throw away any partially recorded buffers than have not been

 		// received. Implied BufferAck(). Only legal when paused

 	virtual void Stop()=0;

 		// immediate stop, but does not close. Akin to Cancel() if we are running.

 	virtual TAny* Interface(TUid aInterfaceUid)=0;

 		// for standard extension pattern

 	};

 // Parameter access. Do as CI since API not so clear

 const TUid KUidAIParamInterface = {0x10287080};

 class MAIParamInterface

 	{

 public:

 	virtual TInt SetGain(TInt aGain)=0;

 		// set basic gain

 	virtual TInt GetBufferSizes(TInt& aMinSize, TInt& aMaxSize)=0;

 		// min and max buffer size supported (or at least recommended)	

 	virtual TInt GetSupportedSampleRates(RArray<TInt>& aSupportedSampleRates)=0;

 	};

 #endif // SWAUDIOINPUT_H