/*

* Copyright (c) 2008 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:  Definition for CMSMemoryCardMonitor class

*

*/

#ifndef __MSMMCMONITOR_H__

#define __MSMMCMONITOR_H__

#include <e32base.h>

#include <f32file.h>

// Memory card events

enum TMemoryCardEvent

    {

    EMemoryCardInsert = 0, //Insert memorycard

    EMemoryCardRemove,     //Remove memorycard

    EMemoryCardOthers      //Other event such as write, read, etc. 

    };

/**

 * Observer class for memory slot events

 *

 *  @since S60 5.1

 */

class MMSMemoryCardObserver

    {

    public:

        /**

         * Implement this method to be notified when Memory Card status

         * changes.

         *

         * @since S60 5.1

         * @param aEvent, memory slot event

         * @return None;

         */

        virtual void MemoryCardChangedL( TMemoryCardEvent aEvent ) = 0;

    };

/**

 * Memory card monitor class

 *

 * @since S60 5.1

 */

NONSHARABLE_CLASS( CMSMemoryCardMonitor ) : public CActive

    {

    public:

        /**

         * two-phase constructor

         *

         * @since S60 5.1

         * @param aObserver, memorycard

         * @param aFs, file server session

         * @return pointer to CMSMemoryCardMonitor

         */

        static CMSMemoryCardMonitor* NewL( MMSMemoryCardObserver* aObserver, 

                                           RFs& aFs );

        /**

         * two-phase constructor

         *

         * @since S60 5.1

         * @param aObserver, memorycard

         * @param aFs, file server session

         * @return pointer to CMSMemoryCardMonitor

         */

        static CMSMemoryCardMonitor* NewLC( MMSMemoryCardObserver* aObserver, 

                                           RFs& aFs );                                           

        /**

         * Destructor

         */

        virtual ~CMSMemoryCardMonitor();

        /**

         * Start monitoring memory card slot

         *

         * @since S60 5.1

         * @param None

         * @return None

         */

        void StartMonitor();

    protected:

// From base class CActive

        /**

         * From CActive

         * See base class definition         

         */

        void RunL();

        /**

         * From CActive

         * See base class definition         

         */        

        void DoCancel();

        /**

         * From CActive

         * See base class definition         

         */

        TInt RunError( TInt aError );

    private:

        /**

         * Performs the first phase of two phase construction.

         *

         * @since S60 5.1

         * @param aObserver, memorycard

         * @param aFs, file server session

         * @return None;

         */

        CMSMemoryCardMonitor( MMSMemoryCardObserver* aObserver, RFs& aRfs );

        /**

         * Performs the second phase construction.

         *

         * @since S60 5.1

         * @param aObserver, memorycard

         * @param aFs, file server session

         * @return None         

         */         

        void ConstructL(); 

        /**

         * Checks if memory card is available

         *

         * @since S60 5.1

         * @return TBool, ETrue if found, EFalse otherwise         

         */ 

        TBool MemoryCardExist() const;

    private:

        /**

         * Memorycard observer class

         */

        MMSMemoryCardObserver* iObserver;                   // not owned

        /**

         * Reference to file server session

         */

        RFs&                   iFsSession;

        /**

         * Memorycard exist or not

         */

        TBool                  iMemoryCardExist;

    };

#endif // __MSMMCMONITOR_H__

// End of File