/*

* Copyright (c) 2002-2007 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:  Resolves different media types' drive letters

*

*/

#ifndef CGFLMDRIVERESOLVER_H

#define CGFLMDRIVERESOLVER_H

//  INCLUDES

#include <f32file.h>

#include "GFLM.hrh"

// CONSTANTS

const TInt KGflmReadBufferLen = 256;

// FORWARD DECLARATIONS

class CGflmDriveItem;

class MGflmItemFilter;

// CLASS DECLARATION

/**

*  Resolves different media types' drive letters

*

*  @lib GFLM.lib

*  @since 2.0

*/

NONSHARABLE_CLASS(CGflmDriveResolver) : public CBase

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CGflmDriveResolver* NewL( RFs& aFs );

        /**

        * Destructor.

        */

        virtual ~CGflmDriveResolver();

    public: // New functions

        /**

        * Refreshes drive information

        * @param aFs Reference to file system handle

        * @param aFilter Pointer to filter

        * @return System wide error code.

        * @since 3.2

        */

        TInt RefreshDrives( MGflmItemFilter* aFilter );

        /**

        * Gets number of drives

        * @since 3.1

        * @return A number of drives

        */

        TInt DriveCount() const;

        /**

        * Gets drive item at position

        * @since 3.1

        * @param aIndex Given position

        * @return A pointer to drive item (not owned).

        */

        CGflmDriveItem* DriveAt( const TInt aIndex ) const;

        /**

        * Gets drive item from given path

        * @since 3.1

        * @param aPath Given path

        * @return A pointer to drive item (not owned)

        *         or NULL if drive not found.

        */

        CGflmDriveItem* DriveFromPath( const TDesC& aPath ) const;

        /**

        * Clears drive information

        * @since 3.1

        */

        void ClearDrives();

		/**

        * Checks if path is drive root path

        * @since 3.1

        */

        TBool IsRootPath( const TDesC& aPath ) const;

		/**

        * Checks if path is on remote drive

        * @since 3.1

        */

        TBool IsRemoteDrive( const TDesC& aPath ) const;

        /**

        * Gets drive item from given id

        * @since 3.2

        * @param aDrive Given drive id

        * @return A pointer to drive item (not owned)

        *         or NULL if drive not found.

        */

        CGflmDriveItem* DriveFromId( const TInt aDrive ) const;

     private:

        /**

        * C++ default constructor.

        */

        CGflmDriveResolver( RFs& aFs );

        void ConstructL();

        void AppendDriveL(

            const TInt aDrive, MGflmItemFilter* aFilter );

        void RefreshDrivesL( MGflmItemFilter* aFilter );

    private:    // Data

        // Shareable file server session.

        RFs& iFs;

        // List of drives. Owned.

        RPointerArray< CGflmDriveItem > iDrives;

        TBool iRefreshed;

        RCriticalSection iCs;

        TBuf< KGflmReadBufferLen > iReadBuffer;

    };

#endif      // CGFLMDRIVERESOLVER_H

// End of File