/*
* 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