/*

* Copyright (c) 2010 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:  UPnP Renderer config container class

*

*/

#ifndef C_UPNPRENDERERCFG_H

#define C_UPNPRENDERERCFG_H

#include <e32base.h>

class CUpnpRendererCfg : public CBase

    {

public:

    /**

     * Static NewL

     *

     * @param aConfigFile Reference to config file descriptor

     * @param aModelName Reference to model name 8-bit descriptor

     * @param aSrcMimeType Reference to source mime type 8-bit descriptor

     * 

     * @return instance to CUpnpRendererCfg

     */

    IMPORT_C static CUpnpRendererCfg* NewL( const TDesC& aConfigFile, 

            const TDesC8& aModelName, const TDesC8& aSrcMimeType );

    /**

     * Static NewLC

     *

     * @param aConfigFile Reference to config file descriptor

     * @param aModelName Reference to model name 8-bit descriptor

     * @param aSrcMimeType Reference to source mime type 8-bit descriptor

     * 

     * @return instance to CUpnpRendererCfg

     */

    IMPORT_C static CUpnpRendererCfg* NewLC( const TDesC& aConfigFile, 

            const TDesC8& aModelName, const TDesC8& aSrcMimeType );

    IMPORT_C ~CUpnpRendererCfg();

private:

    /**

     * Destructor

     */

    CUpnpRendererCfg();

    /**

     * 2nd phrase Constructor

     */

    void ConstructL( const TDesC& aConfigFile, const TDesC8& aModelName,

            const TDesC8& aSrcMimeType );

public:

    /*

     * Return pipeline descriptor

     * 

     * @return Reference to pipeline descriptor if pipeline set, otherwise 

     *         KNullDesC8

     */

    IMPORT_C const TDesC8& Pipeline() const;

    /*

     * Return protocol info descriptor

     * 

     * @return Reference to protocol info descriptor if pipeline set, 

     *         otherwise KNullDesC8

     */

    IMPORT_C const TDesC8& ProtocolInfo() const;

    /*

     * Return protocol info descriptor

     * 

     * @return Size multiplier if set, otherwise KErrNotFound

     */    

    IMPORT_C TReal SizeMultiplier() const;

private:

    HBufC*  iConfigFile;  //owned

    HBufC8* iModelName;   //owned

    HBufC8* iSrcMimeType; //owned

    HBufC8* iPipeline;       //owned

    HBufC8* iProtocolInfo;   //owned

    TReal   iSizeMultiplier;

private:

    /*

     * CUpnpRendererCfgParser sets directly following private member 

     * variables, if found from renderer config xml:

     * - iPipeline

     * - iProtocolInfo

     * - iSizeMultiplier

     */

    friend class CUpnpRendererCfgParser;

    };

#endif // C_UPNPRENDERERCFG_H