williamr@2: // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@2: // 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
williamr@2: // which accompanies this distribution, and is available
williamr@2: // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: //
williamr@2: // Initial Contributors:
williamr@2: // Nokia Corporation - initial contribution.
williamr@2: //
williamr@2: // Contributors:
williamr@2: //
williamr@2: // Description:
williamr@2: // Mda\Client\Utility.h
williamr@2: // maintained for backwards compatibility
williamr@2: // 
williamr@2: //
williamr@2: 
williamr@2: 
williamr@2: #ifndef __MDA_CLIENT_UTILITY_H__
williamr@2: #define __MDA_CLIENT_UTILITY_H__
williamr@2: 
williamr@2: // Standard EPOC32 includes
williamr@2: #include <e32base.h>
williamr@2: #include <mda/common/base.h>
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @removed
williamr@2: */
williamr@2: enum {
williamr@2: 	KDummyMdaServerNotImplemented
williamr@2: 	};
williamr@2: 
williamr@2: // Maintained for backwards compatibility
williamr@2: // Some code such as CONE uses constucts such as CMdaServer* iServer = CMdaServer::NewL();
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @deprecated
williamr@2: 
williamr@2: This class has been deprecated in 7.0s.
williamr@2: */
williamr@2: class MMdaObjectEventListener
williamr@2: 	{
williamr@2: public:
williamr@2: 
williamr@2: 	/**
williamr@2:     Handles an event that occurred in the media server. Called by the CMdaServer object that the listener has been added to.
williamr@2: 
williamr@2: 	@param  aEvent
williamr@2: 	        A single event that occurred in the media server.
williamr@2: 	
williamr@2: 	@see CMdaServer::AddListenerL()
williamr@2: 	*/
williamr@2: 	virtual void MoelEvent(const TMdaEvent& aEvent) =0;
williamr@2: 
williamr@2: 	/**
williamr@2:     This function, rather than MoelEvent() is called if the event's ID is EMdaEventMissed. Events are stored when they are 
williamr@2: 	received and a missed event occurs when there are no spare slots.
williamr@2: 	*/
williamr@2: 	virtual void MoelEventMissed() =0;
williamr@2: 	friend class CMdaServer;
williamr@2: 	};
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @deprecated
williamr@2: 
williamr@2: This class has been deprecated in 7.0s.
williamr@2: */
williamr@2: class CMdaServer : public CBase
williamr@2: 	{
williamr@2: public:
williamr@2: 	IMPORT_C static CMdaServer* NewL();
williamr@2: 	IMPORT_C ~CMdaServer();
williamr@2: 	IMPORT_C void AddListenerL(MMdaObjectEventListener& aListener);
williamr@2: 	IMPORT_C void RemoveListener(MMdaObjectEventListener& aListener);
williamr@2: 	};
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @released
williamr@2: 
williamr@2: An interface class for handling the change of state of an audio data sample object.
williamr@2: 
williamr@2: The class is a mixin and is intended to be inherited by the client class which is observing the audio recording or the 
williamr@2: audio conversion operation. The class defines a single function which must be implemented by the inheriting client class.
williamr@2: 
williamr@2: This class is maintained for binary compatibility with versions prior to 7.0s.
williamr@2: 
williamr@2: Defined in MMdaObjectStateChangeObserver:
williamr@2: MoscoStateChangeEvent()
williamr@2: */
williamr@2: class MMdaObjectStateChangeObserver
williamr@2: 	{
williamr@2: public:
williamr@2: 	/**
williamr@2: 	This method is used to receive the updated state of an audio data sample object.  This method must be implemented 
williamr@2: 	by the inheriting client class.
williamr@2: 
williamr@2: 	@param aObject
williamr@2: 		   The audio data sample object whose state has changed.
williamr@2: 
williamr@2: 	@param aPreviousState
williamr@2: 		   This is the previous state of the audio data sample object before it went into the current state.  
williamr@2: 		   It is expected to be one of the enum values defined in CMdaAudioClipUtility::TState, which defines 
williamr@2: 		   the possible states of an audio data sample.
williamr@2: 
williamr@2: 	@param aCurrentState
williamr@2: 		   This is the current state of the audio data sample object.  It is expected to be one of the enum values defined 
williamr@2: 		   in CMdaAudioClipUtility::TState, which defines the possible states of an audio data sample.
williamr@2: 			
williamr@2: 	@param aErrorCode
williamr@2: 		   A system wide error code, KErrNone for sucessful completion.  KErrInUse, KErrDied or KErrAccessDenied 
williamr@2: 		   may be returned to indicate that the sound device is in use  by another higher priority client.
williamr@2: 	 */
williamr@2: 	virtual void MoscoStateChangeEvent(CBase* aObject, TInt aPreviousState, TInt aCurrentState, TInt aErrorCode)=0;
williamr@2: 	};
williamr@2: 
williamr@2: #endif