// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

 // which accompanies this distribution, and is available

 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

 //

 // Initial Contributors:

 // Nokia Corporation - initial contribution.

 //

 // Contributors:

 //

 // Description:

 //

 #ifndef __MMF_DRM_CUSTOM_COMMANDS_H__

 #define __MMF_DRM_CUSTOM_COMMANDS_H__

 #include <e32base.h>

 #include <mmf/common/mmcaf.h>

 #include <mmf/common/mmfstandardcustomcommands.h>

 /**

 @publishedAll

 @released

 */

 const TUid KUidInterfaceMMFDRMControl = {0x101F7D8D};

 /**

 @internalComponent

 */

 enum TMMFDRMControlMessages

 	{

 	EMMFDRMControlEvaluateIntent,

 	EMMFDRMControlExecuteIntent,

 	EMMFDRMControlDisableAutomaticIntent,

 	EMMFDRMControlSetAgentProperty,

 	EMMFDRMControlIsSupported

 	};

 /**

 @publishedAll

 @released

 Mixin class to be derived from by controller plugins wishing to support the DRM Intent

 custom commands.

 */

 class MMMFDRMCustomCommandImplementor

 	{

 public:

 	/**

 	Disable the automatic (controller specified) execution of intent

 	@param  aIntent

 	        The intent to execute

 	*/

 	virtual TInt MdcDisableAutomaticIntent(TBool aDisableAutoIntent)=0;

 	/**

 	Executes a particular intent

 	@param  aIntent

 	        The intent to execute

 	*/

 	virtual TInt MdcExecuteIntent(ContentAccess::TIntent aIntent)=0;

 	/**

 	Evaluate a particular intent

 	@param  aIntent

 	        The intent to evaluate

 	*/

 	virtual TInt MdcEvaluateIntent(ContentAccess::TIntent aIntent)=0;

 	/**

 	*/

 	virtual TInt MdcSetAgentProperty(ContentAccess::TAgentProperty aProperty, TInt aValue)=0;

 	};

 class CMMFDRMCustomCommandParser : public CMMFCustomCommandParserBase

 	{

 public:

 	/**

 	Creates a new custom command parser capable of DRM Intent controller commands.

 	@param  aImplementor

 	        A reference to the controller plugin that owns this new object.

 	@return A pointer to the object created.

 	@since  7.0s

 	*/

 	IMPORT_C static CMMFDRMCustomCommandParser* NewL(MMMFDRMCustomCommandImplementor& aImplementor);

 	/**

 	Destructor.

 	@since  7.0s

 	*/

 	IMPORT_C ~CMMFDRMCustomCommandParser();

 	/**

 	Handles a request from the client. Called by the controller framework.

 	@param  aMessage

 	        The message to be handled.

 	@since  7.0s

 	*/

 	void HandleRequest(TMMFMessage& aMessage);

 private:

 	/**

 	Constructor.

 	@param  aImplementor

 	        A reference to the controller plugin that owns this new object.

 	@since  7.0s

 	*/

 	CMMFDRMCustomCommandParser(MMMFDRMCustomCommandImplementor& aImplementor);

 	// Internal request handling methods.

 	void DoHandleRequestL(TMMFMessage& aMessage);

 	void DoEvaluateIntentL(TMMFMessage& aMessage);

 	void DoExecuteIntentL(TMMFMessage& aMessage);

 	void DoDisableAutomaticIntentL(TMMFMessage& aMessage);

 	void DoSetAgentPropertyL(TMMFMessage& aMessage);

 private:

 	MMMFDRMCustomCommandImplementor& iImplementor;

 	};

 /**

 @publishedAll

 @released

 Generic Mixin class to be used by a client utility wishing to pass DRM Intent

 custom commands to a controller plugin.

 */

 class MMMFDRMCustomCommand

 	{

 public:

 	/**

 	Disable the automatic (controller specified) execution of intent

 	@param  aIntent

 	        The intent to execute

 	*/

 	virtual TInt DisableAutomaticIntent(TBool aDisableAutoIntent)=0;

 	/**

 	Executes a particular intent

 	@param  aIntent

 	        The intent to execute

 	*/

 	virtual TInt ExecuteIntent(ContentAccess::TIntent aIntent)=0;

 	/**

 	Evaluate a particular intent

 	@param  aIntent

 	        The intent to evaluate

 	*/

 	virtual TInt EvaluateIntent(ContentAccess::TIntent aIntent)=0;

 	/**

 	*/

 	virtual TInt SetAgentProperty(ContentAccess::TAgentProperty aProperty, TInt aValue)=0;

 	};

 class RMMFDRMCustomCommands : public RMMFCustomCommandsBase,

                               public MMMFDRMCustomCommand

 	{

 public:

 	/**

 	Constructor.

 	@param  aController

 	        The client side controller object to be used by this custom command interface.

 	*/

 	IMPORT_C RMMFDRMCustomCommands(RMMFController& aController);

 	/**

 	*/

 	IMPORT_C TInt DisableAutomaticIntent(TBool aBool);

 	/**

 	*/

 	IMPORT_C TInt EvaluateIntent(ContentAccess::TIntent aIntent);

 	/**

 	*/

 	IMPORT_C TInt ExecuteIntent(ContentAccess::TIntent aIntent);

 	/**

 	*/

 	IMPORT_C TInt SetAgentProperty(ContentAccess::TAgentProperty aProperty, TInt aValue);

 	/**

 	*/

 	IMPORT_C TBool IsSupported();

 	};

 #endif // __MMF_DRM_CUSTOM_COMMANDS_H__