/*

* Copyright (c) 2004 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:    MCC EventHandler

*

*/

#ifndef __MCC_EVENT_H__

#define __MCC_EVENT_H__

// INCLUDES

#include <e32base.h>

#include <mmf/common/mmfcontroller.h>

#include "mccdef.h"

#include "mmccevents.h"

#include "mccinternaldef.h"

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class MMccCtrlObserver;

// CLASS DECLARATION

/**

*  CMccEvent receives event notifications from the controller plugin and forwards 

*  them to the client by calling corresponding callback functions of the 

*  MMCCCtrlObserver.

*

*  @lib MCCInterface.lib

*  @since Series 60 3.0

*/

#ifdef EKA2

NONSHARABLE_CLASS( CMccEvent ) : public CActive

#else

class CMccEvent : public CActive

#endif

    {

    #ifdef TEST_EUNIT 

        friend class UT_CMCCInterface;

    #endif

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CMccEvent* NewL( RMMFController& aController, 

                                MMccCtrlObserver& aObserver );

        /**

        * Destructor.

        */

        virtual ~CMccEvent();

    public: // New functions

        /**

        * Requests for event from Controller plugin and starts event listening loop.

        * @since    Series 60 3.0

        * @return   void

        */

        void RequestEventNotification();

    protected: // From CActive

        /**

        * From CActive Handles an active object’s request completion event.

        * @since Series 60 3.0

        * @return None

        */

        void RunL();

        /**

        * From CActive

        */

        TInt RunError( TInt aError );

        /**

        * From CActive Implements cancellation of an outstanding request.

        * @since Series 60 3.0

        * @return None

        */

        void DoCancel();

    private: // New functions

        /**

        * Handles an media event

        * @since Series 60 3.0

        * @param aEvent Media event

        * @return void

        */

        void HandleMccMediaEvent( const TMccEvent& aEvent );

        /**

        * Handles state change

        * @since Series 60 3.0

        * @param aEvent Statechange event

        * @return void

        */

        void HandleMccStateChangeEvent( const TMccEvent& aEvent );

        /**

        * Handles error event

        * @since Series 60 3.0

        * @param aEvent Error event

        * @return void

        */

        void HandleMccErrorEvent( const TMccEvent& aEvent );

        /**

        * Handles inactivity event

        * @since Series 60 3.0

        * @param aEvent Error event

        * @return void

        */

        void HandleMccInactivityEvent( const TMccEvent& aEvent );

        /**

        * Handles activity event

        * @since Series 60 3.0

        * @param aEvent Error event

        * @return void

        */

        void HandleMccActivityEvent( const TMccEvent& aEvent );

        /**

         * Handles unknown media event

         *

         * @since Series 60 3.0

         * @param aEvent Event

         * @return void

         */

        void HandleMccUnknownMediaEvent( const TMccEvent& aEvent );

    private:

        /**

        * C++ default constructor.

        */

        CMccEvent( RMMFController& aController, 

                   MMccCtrlObserver& aCallback );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

    private:    // Data

        // Handle to the controller plugin for sending custom commands

        RMMFController& iController;

        // Callback object to inform client about events

        MMccCtrlObserver& iEventCallBack;

        // Destination of the custom command

        TMMFMessageDestinationPckg iMessageDest; 

        // Contains information about event after completion of 

        // notification request issued to the controller

        TMccEventPackage iPackage;

    private:

        #ifdef TEST_EUNIT

        friend class UT_CMccInterface;

        #endif   

    };

#endif /* __MCC_EVENT_H__ */

// End of File