/*

* Copyright (c) 2006-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:  Monitors MMC insertions and removals.*

*/

#ifndef __MMCMONITORAO_H__

#define __MMCMONITORAO_H__

#include <e32base.h>

#include <f32file.h>

#include "mdscommoninternal.h"

enum TMMCEventType

    {

    EMounted,

    EDismounted,

    EFormatted

    };

class MMMCMonitorObserver

    {

    public:

        /**

        * A pure virtual method to notify about any MMC insertions and removals.

        *

        * @param aDriveChar  A drive char of MMC which was inserted or removed.

        * @param aEventType  EMounted if MMC is inserted, EDismounted if it is removed.

        */

        virtual void MountEvent( TChar aDriveChar,

        	TUint32 aMediaID, TMMCEventType aEventType ) = 0;

    };

class CMMCMonitorAO : public CActive

    {

    public:

        /**

        * Creates and constructs a new instance of CMMCMonitorAO.

        *

        * @return A pointer to the new instance of CMMCMonitorAO

        */

        static CMMCMonitorAO* NewL();

        /**

        * Destructor

        */

        virtual ~CMMCMonitorAO();

        /**

        * Starts monitoring the MMC insertions and removals.

        *

        * @param aObserver  Both events are notified via the aObserver.

        * @return ETrue if success, EFalse if not

        */

        TBool StartMonitoring( MMMCMonitorObserver& aObserver, RArray<TMdEMediaInfo>& aMedias );

        /**

        * Stops monitoring.

        *

        * @return ETrue if success, EFalse if not

        */

        TBool StopMonitoring();

        /**

        * Resumes paused monitoring.

        *

        * @return ETrue if success, EFalse if not

        */

        TBool Resume();

        /**

        * Pauses monitoring.

        *

        * @return ETrue if success, EFalse if not

        */

        TBool Pause();

        /**

        * Inherited from CActive. This method will be called on file server notifying.

        */

        void RunL();

        /**

        * Handles a leave occurring in the request completion event handler RunL().

        *

        * @param aError  An error code.

        * @return An error code.

        */

        TInt RunError( TInt aError );

        /**

        * Cancels file server notifying. Inherited from CActive.

        */

        void DoCancel();

    private:

        /**

        * C++ constructor - not exported;

        * implicitly called from NewL()

        */

        CMMCMonitorAO();

        /**

        * 2nd phase construction, called by NewL()

        */

        void ConstructL();

        /**

        * Starts file server to notify us about MMC insertions and removals.

        */

        void StartNotify();

        /**

        * Makes a list of all removable medias which is present.

        */

        void BuildDriveList();

        /**

        * Compares previous and present drive list. Notify an observer about any differences in lists.

        */

        void CompareDriveLists();

#ifdef _DEBUG

    	void PrintAllLists();

#endif

    private:

        /**

        * An observer.

        */

        MMMCMonitorObserver* iObserver;

        /**

        * A file server.

        */

        RFs iFs;

        /**

        * A present drive list.

        */

        TDriveList iDriveList;

        /**

        * A previous drive list.

        */

        TDriveList iPreviousDriveList;

        TUint32 iMediaIdList[KMaxDrives];

    };

#endif // __MMCMONITORAO_H__