--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/devsound/hwdevapi/inc/mmfhwdevicesetup.h	Tue Feb 02 01:56:55 2010 +0200
@@ -0,0 +1,181 @@
+// Copyright (c) 2001-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:
+//
+
+/**
+ @file
+ @publishedPartner 
+ @released
+*/
+
+#ifndef MMFHWDEVICESETUP_H
+#define MMFHWDEVICESETUP_H
+
+const TUid KUidHwDeviceSetupInterface = {0x102737A8};
+class TFourCC;
+	
+//Custom Interface Uid for these Hw Device implementations
+#define KMmfPlaySettingsCustomInterface		0x101F9FC1
+#define KMmfRecordSettingsCustomInterface	0x101F9FC2
+#define KSetVbrFlagCustomInterfaceTypeUid	0x10282647
+const TUid KTimePlayedCustomInterfaceTypeUid = {0x10285D17};
+const TUid KIgnoreUnderflowCustomInterfaceTypeUid = {0x10285E7D};
+/**
+Custom interface to pass the data types to a hardware device adapter
+*/
+class MMdfHwDeviceSetup
+	{
+public:
+	/**
+	Sets the data types into the hardware device adapter
+	@param aSrcType Source FourCC data type
+	@param aDestType Destination FourCC data type
+	*/
+	virtual void SetDataTypesL(TFourCC aSrcType, TFourCC aDestType) = 0;
+	};
+	
+/**
+Custom interface class for play functionality created by the
+CMMFSwCodecWrapper::CustomInterface() method. It provides
+access to miscellaneous functionality such as volume settings.
+Ports of the sw codec wrapper may do this differently eg. via EAP.
+Note Users should not use RMdaDevSound::TCurrentSoundFormatBuf to send
+across the sample rate and channels because 1) it would mean
+mmfswcodecwrapper.h would have to include mdasound.h 2)
+the buffer size and encoding members are not required and 3) 3rd party ports
+may not use RMdaDevSound.
+
+Note also that this interface is just a simple interface to get
+and set values. No checking is performed on the values sent (hence the
+Set methods do not return an error code).
+*/
+class MPlayCustomInterface
+	{
+public:
+	/**
+	Set the audio volume.
+	@param aVolume The specified audio volume.
+	*/
+	virtual void SetVolume(TUint aVolume) = 0;
+
+	/**
+	Get the audio volume.	
+	*/
+	virtual TUint Volume() = 0;
+
+	/**
+	Get the number of bytes played.	
+	*/
+	virtual TUint BytesPlayed() = 0;
+
+	/**
+	Set the period over which the volume level is to rise smoothly from nothing to the required volume level.
+	@param aRampDuration The period over which the volume is to rise.
+	*/
+	virtual void SetVolumeRamp(const TTimeIntervalMicroSeconds& aRampDuration) = 0;
+
+	/**
+	Get the period over which the volume level is to rise smoothly from nothing to the required volume level.
+	*/
+	virtual TTimeIntervalMicroSeconds& VolumeRamp() = 0;
+	};
+
+/**
+Custom interface class for record functionality created by the
+CMMFSwCodecWrapper::CustomInterface() method. It provides
+access to miscellaneous functionality such as volume settings.
+Ports of the sw codec wrapper may do this differently eg. via EAP.
+Note: Users should not use RMdaDevSound::TCurrentSoundFormatBuf so send
+across the sample rate and channels because 1) it would mean
+mmfswcodecwrapper.h would have to include mdasound.h 2)
+the buffer size and encoding members are not required and 3) 3rd party ports
+may not use RMdaDevSound.
+
+Note also that this interface is just a simple interface to get
+and set values. No checking is performed on the values sent (hence the
+Set methods do not return an error code).
+*/
+class MRecordCustomInterface
+	{
+public:
+	/**
+	Set the gain.
+	@param aGain The specified gain value.
+	*/
+	virtual void SetGain(TUint aGain) = 0;
+
+	/**
+	Get the gain value.
+	*/
+	virtual TUint Gain() = 0;
+
+	/**
+	Get the number of bytes recorded.
+	*/
+	virtual TUint BytesRecorded() = 0; 
+	};
+/**
+Custom interface class for emptying the play buffers before playing.
+*/
+class MEmptyBuffersCustomInterface
+	{
+public:
+	/**
+	Empties the play buffers.
+	@return An error code indicating if the function call was successful. KErrNone on success, KErrNotReady 
+			if the device is not ready, otherwise another of the system-wide error codes.
+	*/
+	virtual TInt EmptyBuffers() = 0;
+	};
+
+/**
+Custom interface class for setting VBR flag.
+*/
+class MSetVbrFlagCustomInterface
+	{
+public:
+	/**
+	Sets the VBR flag to ETrue.
+	*/
+	virtual void SetVbrFlag() = 0;
+	};
+
+/**
+Custom interface class for querying current play time from the audio renderer.
+*/
+class MTimePlayedCustomInterface
+	{
+public:
+	/**
+	Gets the current play time from the sound driver.
+	@param aTime A reference to TTimeIntervalMicroSeconds object which is filled with the current play time.
+	@return An error code indicating if the function call was successful. KErrNone on success
+	*/
+	virtual TInt GetTimePlayed(TTimeIntervalMicroSeconds& aTime) = 0;
+	};	
+
+/**
+Custom interface class for configuring hardware device to ignore all the underflow events from the sound driver 
+except for the last buffer.
+*/
+class MIgnoreUnderflowEventsCustomInterface
+	{
+public:
+	/**
+	Configures the hardware device such that it ignores all the underflow events from the sound driver.
+	However, it propagates the underflow error to devsound when the last buffer flag is set.
+	*/
+	virtual void IgnoreUnderflowEvents() = 0;
+	};
+#endif // MMFHWDEVICESETUP_H
\ No newline at end of file