Symaptic: os/mm/mmlibs/mmfw/inc/mmf/ControllerFramework/mmfdrmcustomcommands.h@bde4ae8d615e

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

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // under the terms of "Eclipse Public License v1.0"

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 //

    16 #ifndef __MMF_DRM_CUSTOM_COMMANDS_H__

    17 #define __MMF_DRM_CUSTOM_COMMANDS_H__

    20 #include <e32base.h>

    21 #include <mmf/common/mmcaf.h>

    22 #include <mmf/common/mmfstandardcustomcommands.h>

    24 #ifndef SYMBIAN_ENABLE_SPLIT_HEADERS

    25 #include <mmf/common/mmfdrmcustomcommandsenum.h>

    26 #endif

    28 /**

    29 @publishedAll

    30 @released

    31 */

    32 const TUid KUidInterfaceMMFDRMControl = {0x101F7D8D};

    34 /**

    35 @publishedAll

    36 @released

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

    39 custom commands.

    40 */

    41 class MMMFDRMCustomCommandImplementor

    42 	{

    43 public:

    45 	/**

    46 	Disable the automatic (controller specified) execution of intent

    48 	@param  aIntent

    49 	        The intent to execute

    51 	*/

    52 	virtual TInt MdcDisableAutomaticIntent(TBool aDisableAutoIntent)=0;

    55 	/**

    56 	Executes a particular intent

    58 	@param  aIntent

    59 	        The intent to execute

    61 	*/

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

    64 	/**

    65 	Evaluate a particular intent

    67 	@param  aIntent

    68 	        The intent to evaluate

    70 	*/

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

    73 	/**

    76 	*/

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

    78 	};

    80 class CMMFDRMCustomCommandParser : public CMMFCustomCommandParserBase

    81 	{

    82 public:

    84 	/**

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

    87 	@param  aImplementor

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

    90 	@return A pointer to the object created.

    92 	@since  7.0s

    93 	*/

    94 	IMPORT_C static CMMFDRMCustomCommandParser* NewL(MMMFDRMCustomCommandImplementor& aImplementor);

    96 	/**

    97 	Destructor.

    99 	@since  7.0s

   100 	*/

   101 	IMPORT_C ~CMMFDRMCustomCommandParser();

   103 	/**

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

   106 	@param  aMessage

   107 	        The message to be handled.

   109 	@since  7.0s

   110 	*/

   111 	void HandleRequest(TMMFMessage& aMessage);

   113 private:

   114 	/**

   115 	Constructor.

   117 	@param  aImplementor

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

   119 	@since  7.0s

   120 	*/

   121 	CMMFDRMCustomCommandParser(MMMFDRMCustomCommandImplementor& aImplementor);

   122 	// Internal request handling methods.

   124 	void DoHandleRequestL(TMMFMessage& aMessage);

   125 	void DoEvaluateIntentL(TMMFMessage& aMessage);

   126 	void DoExecuteIntentL(TMMFMessage& aMessage);

   127 	void DoDisableAutomaticIntentL(TMMFMessage& aMessage);

   128 	void DoSetAgentPropertyL(TMMFMessage& aMessage);

   130 private:

   131 	MMMFDRMCustomCommandImplementor& iImplementor;

   132 	};

   135 /**

   136 @publishedAll

   137 @released

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

   140 custom commands to a controller plugin.

   141 */

   142 class MMMFDRMCustomCommand

   143 	{

   144 public:

   146 	/**

   147 	Disable the automatic (controller specified) execution of intent

   149 	@param  aIntent

   150 	        The intent to execute

   152 	*/

   153 	virtual TInt DisableAutomaticIntent(TBool aDisableAutoIntent)=0;

   156 	/**

   157 	Executes a particular intent

   159 	@param  aIntent

   160 	        The intent to execute

   162 	*/

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

   165 	/**

   166 	Evaluate a particular intent

   168 	@param  aIntent

   169 	        The intent to evaluate

   171 	*/

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

   174 	/**

   177 	*/

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

   179 	};

   181 class RMMFDRMCustomCommands : public RMMFCustomCommandsBase,

   182                               public MMMFDRMCustomCommand

   183 	{

   184 public:

   186 	/**

   187 	Constructor.

   189 	@param  aController

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

   192 	*/

   193 	IMPORT_C RMMFDRMCustomCommands(RMMFController& aController);

   195 	/**

   196 	*/

   197 	IMPORT_C TInt DisableAutomaticIntent(TBool aBool);

   199 	/**

   200 	*/

   201 	IMPORT_C TInt EvaluateIntent(ContentAccess::TIntent aIntent);

   203 	/**

   204 	*/

   205 	IMPORT_C TInt ExecuteIntent(ContentAccess::TIntent aIntent);

   207 	/**

   208 	*/

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

   211 	/**

   212 	*/

   213 	IMPORT_C TBool IsSupported();

   215 	};

   218 #endif // __MMF_DRM_CUSTOM_COMMANDS_H__

author	sl@SLION-WIN7.fritz.box
	Fri, 15 Jun 2012 03:10:57 +0200
changeset 0	bde4ae8d615e
permissions	-rw-r--r--