videofeeds/utils/inc/CIptvDriveMonitor.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 12 Mar 2010 15:43:00 +0200
branchRCL_3
changeset 8 ce5ada96ab30
parent 0 96612d01cf9f
permissions -rw-r--r--
Revision: 201007 Kit: 201008

/*
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:    Helper class for Video Center for drive operations/monitoring.*
*/





#ifndef CIPTVDRIVEMONITOR_H
#define CIPTVDRIVEMONITOR_H

//  INCLUDES
#include <e32base.h>
#include <f32file.h>
#include "TIptvDriveInfo.h"
#include "TIptvDriveMonitorEvent.h"
#include "MIptvDriveMonitorObserver.h"
#include "IptvDebug.h"

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

// CLASS DECLARATION

/**
 * Helper class for Video Center for drive operations/monitoring.
 * User can get available drives (through iAvailableDrives public member)
 * and be notified when drives change (through MIptvDriveMonitorObserver interface).
 */
class CIptvDriveMonitor : public CActive
    {                
    public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        */
        IMPORT_C static CIptvDriveMonitor* NewL();

        /**
        * Two-phased constructor. Use this is owner object already has a file session open.
        *
        * @param aFileSession file session.
        */
        IMPORT_C static CIptvDriveMonitor* NewL( const RFs& aFileSession );
        
        /**
        * Destructor.
        */
        IMPORT_C virtual ~CIptvDriveMonitor();
        
    public:
        
        /**
        * Registers observer for drive events.
        * iAvailableDrives is updated automatically if there are any
        * observers registered, ie there is no need to call RefreshAvailableDrivesL
        * when observing.
        * Don't keep observers around if they do not need events. Observing should be used
        * when user needs to know immedetially about memory card insertion/removed events,
        * or drive locked/unlocked events.
        *
        * @param aObserver observer, ownership does not move.
        */
        IMPORT_C void RegisterObserverL( MIptvDriveMonitorObserver* aObserver );
        
        /**
        * Removes observer, ownership does not move.
        * @param aObserver observer to be removed from observers list.
        */ 
        IMPORT_C void RemoveObserverL( MIptvDriveMonitorObserver* aObserver );

        /**
        * Updates iAvailableDrives member variable from File server.
        * This is called in ConstructL() also.
        */ 
        IMPORT_C void RefreshAvailableDrivesL();

        /**
        * Returns the position index of aDrive in iAvailableDrives.
        *
        * @param aDrive drive to search.
        * @return Position index of aDrive in iAvailableDrives. If not found,
        *         KErrNotFound is returned.
        */        
        IMPORT_C TInt ArrayPos( TInt aDrive );

        /**
        * Returns the position index of aDrive in iAvailableDrives. If not
        * found, leaves with KErrNotFound code.
        *
        * @param aDrive drive to search.
        * @return Position index of aDrive in iAvailableDrives.
        */        
        IMPORT_C TInt ArrayPosL( TInt aDrive );

        /**
        * Returns the default removable drive (= memory card drive) from iAvailableDrives
        * array. Leaves with KErrNotFound if not found.
        */        
        IMPORT_C TInt MemoryCardDriveL();

        /**
        * Returns the default removable drive (= memory card drive) from iAvailableDrives
        * array. Returns KErrNotFound if not found.
        *
        * @return drive number, or KErrNotFound if not found.
        */        
        IMPORT_C TInt MemoryCardDrive();

        /**
        * Returns the default mass memory drive if found from iAvailableDrives.
        * Mass storege drive means the drive which is preferred for storing large
        * files in the device, the drive itself can be anything, usually not c though.
        * Leaves with KErrNotFound if not found.
        *
        * @return Drive number.
        */
        IMPORT_C TInt MassStorageDriveL();

        /**
        * Returns the default mass memory drive if found from iAvailableDrives.
        * Mass storege drive means the drive which is preferred for storing large
        * files in the device, the drive itself can be anything except c-drive.
        * Returns KErrNotFound if not found.
        *
        * @return Drive number, or KErrNotFound if not found.
        */
        IMPORT_C TInt MassStorageDrive();

        /**
        * Returns the phone memory drive from iAvailableDrives array.
        * Leaves with KErrNotFound if not found.
        *
        * @return Drive number.
        */
        IMPORT_C TInt PhoneMemoryDriveL();

        /**
        * Returns the PhoneMemory drive from iAvailableDrives array.
        * Returns KErrNotFound if not found.
        *
        * @return Drive number, or KErrNotFound if not found.
        */
        IMPORT_C TInt PhoneMemoryDrive();

        /**
        * Returns the first fixed (= non removable) drive from iAvailableDrives array.
        * Leaves with KErrNotFound if not found.
        *
        * @param aExcludeCDrive If ETrue, then C-drive is excluded.
        * @return Drive number.
        */
        IMPORT_C TInt FixedDriveL( TBool aExcludeCDrive );

        /**
        * Returns the first fixed (= non removable) drive from iAvailableDrives array.
        * Returns KErrNotFound if not found.
        *
        * @param aExcludeCDrive If ETrue, then C-drive is excluded.
        * @return Drive number, or KErrNotFound if not found.
        */
        IMPORT_C TInt FixedDrive( TBool aExcludeCDrive );

        /**
        * @return ETrue if aDrive is the preferred mass storage drive for the large files.
        */
        IMPORT_C TBool IsMassStorageDriveL( TInt aDrive );

        /**
        * @return ETrue if aDrive is memory card type.
        */
        IMPORT_C TBool IsMemoryCardDriveL( TInt aDrive );

        /**
        * @return ETrue media is present in the drive. (Memory card is inserted and drive is not locked).
        */
        IMPORT_C TBool IsPresentL( TInt aDrive );

        /**
        * @return The system drive. Might not be in iAvailableDrives.
        */
        IMPORT_C TInt SystemDrive();
        
        /**
        * Finds out if memory card is inserted and not locked.
        *
        * @return Returns ETrue is memory card is inserted and usable (not locked), EFalse otherwise.
        */
        IMPORT_C TBool IsMmcInserted();
        
        /**
        * Gets the used memory from cenrep. If cenrep contains invalid drive or value is not found,
        * chooses the preferred drive in the following order: 1. mass storage 2. memory card
        * 3. EDriveC. If cenrep value was not usable, the chosen drive is written to cenrep.
        * Leaves with system-wide error code if wasn't able to get the used memory.
        *
        * @param aUsedMemory The used memory drive is written here.
        */        
        IMPORT_C void GetUsedMemoryL( TInt& aUsedMemory );


    protected: // Functions from base classes

        /**
        * From CActive, RunL.
        * Called when operation completes.
        */
        IMPORT_C void RunL();

        /**
        * From CActive, cancels request.
        */
        void DoCancel();

        /**
        * From CActive, handles leaves from RunL.
        */
        TInt RunError( TInt aError );
         
    private:

        /**
        * C++ default constructor.
        */
        CIptvDriveMonitor();

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

        /**
        * By default Symbian 2nd phase constructor is private.
        *
        * @param aFileSession
        */
        void ConstructL( const RFs& aFileSession );

        /**
        * Sends event to observers.
        *
        * @param aEvent event to send.
        * @param aDrive drive which caused the event.
        */
        void SendEvent( TIptvDriveMonitorEvent::TEvent aEvent, TInt aDrive );

        /**
        * Compares iPreviousAvailableDrives and iAvailableDrives arrays and
        * sends appropriate events if they differ.
        */
        void CompareOldAndNewAvailableDrives();
        
        /**
        * Returns drive type as a descriptor. For debugging only.
        * @param aType Drive type, see valid values from e32const.h TMediaType enum.
        */
        const TDesC& DriveTypeDes( TInt aType );

        /**
        * Prints available drives. For debugging only.
        */
        void PrintAvailableDrives();

    public:
    
        /**
        * Array of currently available drives. These are updated
        * with RefreshAvailableDrivesL -method or from file
        * server event. RefreshAvailableDrivesL is also called upon creation
        * of this object.
        * iAvailableDrives array contains drives which are available for mass
        * storaging videos. If there is hard disk and memory card
        * available(both e and f-drives), then c-drive is excluded from the array.
        */
        RArray<TIptvDriveInfo> iAvailableDrives;

        
    private:

        /**
        * Used to detect if refresh had any effect.
        */
        RArray<TIptvDriveInfo> iPreviousAvailableDrives;

        /**
        * Array of observers. Pointers not owned.
        */
        RArray<MIptvDriveMonitorObserver*> iObservers;
        
        /**
        * Session to file server.
        */
        RFs iFs;
        
        /**
        * ETrue if iFs is provided by the user of this class.
        */
        TBool iIfsIsProvidedByUser;
        
        /**
        * Default memory for storing large files.
        */
        TInt iDefaultMassStorageDrive;
        
        /**
        * Default memory card.
        */
        TInt iDefaultMemoryCardDrive;
        
        /**
        * System drive.
        */
        TInt iSystemDrive;

    };

#endif      // CIPTVDRIVEMONITOR_H   
            
// End of File