/*
* 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:  Media agent base class
*
*/



#ifndef CMPXDRMMEDIAAGENT_H
#define CMPXDRMMEDIAAGENT_H

#include "mpxdrmmediautility.h"


// DATA TYPES

// FORWARD DECLARATIONS
class CMPXMedia;

/**
* CMPXDrmMediaAgent class declaration
* 
* @lib mpxcommon.lib
* @since S60 3.1
*/
NONSHARABLE_CLASS(CMPXDrmMediaAgent) : public CBase
    {
public:     // New Functions
    /**
    *  Initialize using a filename
    *
    *  @param aFileName file name
    */
    virtual void InitL(const TDesC& aFileName) = 0;

    /**
    *  Initialize using a file handle
    *
    *  @param aFile file handle
    */
    virtual void InitL(RFile& aFile) = 0;

    /**
    *  Gets media object
    *
    *  @param aAttributes attributes to retreive
    *  @return CMPXMedia object with the specified attributes
    */
    virtual const CMPXMedia& GetMediaL(TUint aAttributes) = 0;

    /**
    *  Consumes the rights for the current media according
    *  to the specified consume type
    *
    *  @param aType Type of consumption to execute
    */
    virtual void ConsumeL(TDrmConsumeType aType) = 0;
    
    /**
    *  Closes and uninitializes the agent and cleans up member variables
    *
    *  @return void
    */
    virtual void Close();

protected:    // New methods
    /**
    * Creates a new media object
    */
    virtual void CreateMediaL();

    /**
    * Gets the protected attribute if not already obtained
    */
    virtual void GetProtectedL();

protected:    // Data
    CMPXMedia* iMedia;  // owned
    CData* iData;   // owned
    };

#endif // CMPXDRMMEDIAAGENT_H