/*
* Copyright (c) 2005 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:    See class definition below.
*
*/



#ifndef __CTcMCEEventAPIObserver_H__
#define __CTcMCEEventAPIObserver_H__


// INCLUDES
#include <MCEEventObserver.h>
#include <MceInEventObserver.h>
#include <MCEReferObserver.h>
#include <MceInReferObserver.h>
#include "CTcMCEReceiveQueue.h"


// FORWARD DECLARATIONS
class CTcMCEContext;
class CMceEvent;
class CMceInEvent;
class CMceRefer;
class CMceInRefer;
class TMceTransactionDataContainer;
	

// CLASS DEFINITION
/**
 * CTcMCEEventAPIObserver observes all events defined in 
 * multimedia API.
 */

class CTcMCEEventAPIObserver
	: public CBase,
	  public MMceEventObserver,
	  public MMceInEventObserver,
	  public MMceReferObserver,
	  public MMceInReferObserver	  
	{
	
	public:	// Constructors and destructor

		/**
		 * Static constructor.
		 *
		 * @param aContext Reference to test context object.
		 * @return An initialized instance of this class.
		 */
		static CTcMCEEventAPIObserver* NewL( CTcMCEContext& aContext );

		/// Destructor
		~CTcMCEEventAPIObserver();

	private:

		/**
		 * Constructor.
		 *
		 * @param aContext Reference to test context object.
		 */
		CTcMCEEventAPIObserver( CTcMCEContext& aContext );

		/// Default constructor. Not implemented.
		CTcMCEEventAPIObserver();

		/// 2nd phase constructor
		void ConstructL();

	public: // new functions

		/**
		 * Returns the first item off the Event receive queue (FIFO). 
		 * If no items are present, the function will wait for aTimeout seconds
		 * and then try fetching again.
		 *
		 * @param aTimeOut Time in seconds waited for items to arrive.
		 */
		CTcMCEReceived& ReceivedEventItemL( TInt aTimeout );

    public: // from MMceEventObserver

        void EventStateChanged(
        			CMceEvent& aEvent,
    				TMceTransactionDataContainer* aContainer );

		void NotifyReceived(
					CMceEvent& aEvent,
    				TMceTransactionDataContainer* aContainer );	
    

        void EventConnectionStateChanged(
	                CMceEvent& aEvent,
	                TBool aActive );

        void Failed( CMceEvent& aEvent, TInt aError );

    public: // from MMceInEventObserver

        void IncomingEvent(
					CMceInEvent* aEvent,
    				TMceTransactionDataContainer* aContainer );
		
    public: // from MMceReferObserver
    
        void ReferStateChanged(
        			CMceRefer& aRefer,
    				TMceTransactionDataContainer* aContainer );

        void ReferConnectionStateChanged(
	                CMceRefer& aRefer,
	                TBool aActive );

        void Failed( CMceRefer& aRefer, TInt aError );
    
    public: // from MMceInReferObserver
       
    	void IncomingRefer(
					CMceInRefer* aRefer,
					const TDesC8& aReferTo,
    				TMceTransactionDataContainer* aContainer );
        

	private: // owned data
	
		CTcMCEReceiveQueue* iEventQueue;

	private: // data

		/// Reference to the test context.
		CTcMCEContext& iContext;	    

	};

#endif // __CTcMCEEventAPIObserver_H__