/*

* Copyright (c) 2006 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:  Loads MPEngine.dll dynamically.

*

*/

#ifndef C_COMMONUIMPENGINEAPILOADER

#define C_COMMONUIMPENGINEAPILOADER

#include <e32base.h>

#include <f32file.h>

class MDesCArray;

class CStreamingLinkModel;

/**

*  Interface class for creating a new RAM file.

*  

*  @lib CommonUiMPEngineApiLoader.lib

*  @since Series 60 3.1

*/

class MCommonUiMPEngineApiLoader

    {

    public:

        /**

        * Pure virtual method for creating a new RAM file.

        * @param aNewRamFileName, New RAM file.

        * @param aLinkArray, Array which contains links which are 

            saved to RAM file.

        * @param aOverWrite, Overwrite existing file or not.

        * @return KErrNone or one of the system wide error codes. 

        * @since Series 60 3.1

        */

        virtual TInt CreateNewLinkFileL(

            const TDesC& aFileName, 

            MDesCArray* aLinkArray, 

            TBool aOverWrite ) = 0;

    };

/**

*  This class is for dynamically loading commonuimpengineapiloader.dll that 

*  enables creating a new RAM file.

*

*  @lib commonuimpengineapiloader.lib

*  @since Series 60 3.1

*/

class CCommonUiMPEngineApiLoader : public CBase, public MCommonUiMPEngineApiLoader

    {

public:

    /**

    * Two-phased constructor.

    * @return new instance of CCommonUiMPEngineApiLoader.

    */

    static CCommonUiMPEngineApiLoader* NewL();

    /**

    * Destructor.

    */

    virtual ~CCommonUiMPEngineApiLoader();

    /**

    * Create a new RAM file.

    * @param aNewRamFileName, New RAM file.

    * @param aLinkArray, Array which contains links which are 

        saved to RAM file.

    * @param aOverWrite, Overwrite existing file or not.

    * @return KErrNone or one of the system wide error codes. 

    */

    TInt CreateNewLinkFileL(

        const TDesC& aFileName, 

        MDesCArray* aLinkArray, 

        TBool aOverWrite );

private:

    /**

    * C++ default constructor.

    */

    CCommonUiMPEngineApiLoader();

    /**

    * By default Symbian 2nd phase constructor is private.

    */

    void ConstructL();

private: // data

    CStreamingLinkModel* iMPlayerModel;

    };

// Environment gate function

IMPORT_C TAny* GateFunction();

#endif // C_COMMONUIMPENGINEAPILOADER

// End of File