--- a/epoc32/include/mmf/common/mmfbase.h	Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/mmf/common/mmfbase.h	Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,175 @@
-mmfbase.h
+// 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __MMFBASE_H__
+#define __MMFBASE_H__
+
+// Standard EPOC32 includes
+#include <e32base.h>
+
+
+/** 
+@publishedAll
+@released
+
+The priority for clients accessing a sound output device for audio playback or audio streaming.
+
+This is a value between EMdaPriorityMin and EMdaPriorityMax. The higher value indicates a more 
+important request. It is used to resolve conflicts when more than one client tries to access the
+same hardware resource simultaneously.
+
+One of these values is passed in the first parameter to CMdaAudioOutputStream::SetPriority().
+
+@see CMdaAudioOutputStream::SetPriority()
+*/
+enum TMdaPriority
+	{
+  	/**
+	The lowest priority (= – 100). This indicates that the client can be interrupted 
+	by any other client.
+	*/
+    EMdaPriorityMin = -100,
+	/**
+	Normal priority. This indicates that the client can be interrupted but only by higher priority clients.
+	*/
+    EMdaPriorityNormal = 0,
+	/**
+    The highest priority (= 100). This indicates that the client cannot be interrupted by other clients.
+	*/
+    EMdaPriorityMax = 100
+	};
+
+/**
+@publishedAll
+@released
+
+A set of priority values which define the behaviour to be adopted by an
+audio client if a higher priority client takes over the device.
+*/
+enum TMdaPriorityPreference
+	{
+	/**
+	No priority.
+	*/
+    EMdaPriorityPreferenceNone =	0x00000000,
+	/**
+	The audio data is time sensitive. The playback operation fails if it cannot happen when 
+	requested but degraded output such as mixing or muting is allowed.
+	*/
+    EMdaPriorityPreferenceTime =	0x00000001,
+	/**
+    The audio data must be played at the best possible quality (for example, it must not be degraded by 
+	muting or mixing). The playback operation is delayed until the sound device is available for exclusive use.
+	*/
+    EMdaPriorityPreferenceQuality = 0x00000002,
+	/**
+    The audio data is both time and quality sensitive. The playback operation fails if it cannot 
+	happen immediately at the highest quality.
+	*/
+    EMdaPriorityPreferenceTimeAndQuality = EMdaPriorityPreferenceTime|EMdaPriorityPreferenceQuality
+	};
+
+/**
+@publishedAll
+@released
+
+Holds the current state of DevSound.
+*/
+enum TMMFState
+{
+	/** Idle state.
+	*/
+	EMMFStateIdle,
+	/** The MMF is currently playing.
+	*/
+	EMMFStatePlaying,
+	/** The MMF is playing a tone.
+	*/
+	EMMFStateTonePlaying,
+	/** The MMF is currently recording.
+	*/
+	EMMFStateRecording,
+	/** The MMF is playing and recording.
+	*/
+	EMMFStatePlayingRecording,
+	/** The MMF is converting data.
+	*/
+	EMMFStateConverting
+};
+
+/**
+@publishedAll
+@released
+
+A class type representing the audio client's priority,
+priority preference and state settings.
+*/
+class TMMFPrioritySettings
+	{
+public:
+	TMMFPrioritySettings();
+	/**
+	Absolute priority of a client of the MMF Server.
+
+	Used by the policy server to determine which client should gain access to the sound device.
+
+	The priority which should be an integer in the range -100 to +100.
+	*/
+	TInt iPriority;
+
+	/**
+    The priority preference that expresses the nature of the priority that can be none, 
+	time (or speed), quality or both time and quality.
+
+	If this is set to EMdaPriorityPreferenceTime then the audio data is time sensitive. The playback 
+	operation fails if it cannot happen when requested but degraded output such as mixing or muting 
+	is allowed.
+
+	If this is set to EMdaPriorityPreferenceQuality then the audio data must be played at the best possible 
+	quality (for example, it must not be degraded by muting or mixing). The playback operation is delayed
+	until the sound device is available for exclusive use.
+
+	If this is set to EMdaPriorityPreferenceTimeAndQuality then the audio data is both time and quality 
+	sensitive. The playback operation fails if it cannot happen immediately at the highest quality.
+	*/
+	TMdaPriorityPreference iPref;
+
+	/**
+    The state of the MMF player such as idle, playing, recording and so on. See the TMMFState enum for possible states.
+	*/
+	TMMFState iState;
+private:
+	/**
+	This member is internal and not intended for use.
+	*/
+	TInt iReserved1;
+	};
+
+/**
+@publishedAll
+@released
+
+This is a TPckgBuf package of a TMMFPrioritySettings.
+*/
+typedef TPckgBuf<TMMFPrioritySettings> TMMFPrioritySettingsPckg;
+
+/**
+Initializes the object with arbitrary values.
+*/
+inline TMMFPrioritySettings::TMMFPrioritySettings() : iPriority(EMdaPriorityNormal), iPref(EMdaPriorityPreferenceNone), iState(EMMFStateIdle), iReserved1(0)
+	{
+	}
+
+#endif