API_REF/Public_API: comparison epoc32/include/mmf/common/mmfcontrollerpluginresolver.h

equal deleted inserted replaced

-:e1b950c65cb4
+:837f303aceeb
 // Copyright (c) 2002-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
+// under the terms of "Eclipse Public License v1.0"
 // which accompanies this distribution, and is available
-// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
 //
 // Initial Contributors:
 // Nokia Corporation - initial contribution.
 //
 // Contributors:
 Array of CMMFControllerImplementationInformation
 */
 typedef RPointerArray<CMMFControllerImplementationInformation> RMMFControllerImplInfoArray;
-/**
+class CMatchData;
-@internalComponent
+class CDesC8Array;
+/**
+@publishedAll
+Abstract class that contains basic information about ECom Multimedia plugins.
+@released
+@since 7.0s
+*/
+class CMMFPluginImplementationInformation : public CBase
+	{
+public:
+	/**
+	Returns the uid of this particular plugin implementation.
+	This is the UID used to instantiate this multimedia plugin.
+	@return The implementation uid.
+	@since  7.0s
+	*/
+	IMPORT_C TUid Uid() const;
+	/**
+	Returns the display name of this plugin implementation.
+	@return The display name.
+	@since  7.0s
+	*/
+	IMPORT_C const TDesC& DisplayName() const;
+	/**
+	Returns the name of the supplier of this plugin implementation, e.g. "Symbian".
+	@return The plugin supplier.
+	@since  7.0s
+	*/
+	IMPORT_C const TDesC& Supplier() const;
+	/**
+	Returns the version number of this plugin.
+	@return The version number.
+	@since 7.0s
+	*/
+	IMPORT_C TInt Version() const;
+	/**
+	Returns the array of media IDs supported by this plugin.
+	The media ID can be used by clients to determine whether the plugin supports audio or
+	video data (or both). A UID is used for the media ID to provide future extensibility.
+	@return The array of media IDs.
+	@since  7.0s
+	*/
+	IMPORT_C const RArray<TUid>& SupportedMediaIds() const;
+	/**
+	Tests whether this plugin was supplied by aSupplier.
+	@param  aSupplier
+	        The required supplier.
+	@return A boolean indicating if this plugin was supplied by aSupplier. ETrue if this plugin was supplied
+	        by aSupplier, EFalse if not.
+	@since 7.0s
+	*/
+	IMPORT_C TBool SupportsSupplier(const TDesC& aSupplier) const;
+	/**
+	Tests whether this plugin supports aMediaId.
+	@param  aMediaId
+	        The required media id.
+	@return A boolean indicating if the plugin supports aMediaId. ETrue if this plugin supports aMediaId, EFalse if not.
+	@since 7.0s
+	*/
+	IMPORT_C TBool SupportsMediaId(TUid aMediaId) const;
+	/**
+	Destructor.
+	*/
+	virtual ~CMMFPluginImplementationInformation();
+protected:
+	/**
+	Constructor.
+	*/
+	CMMFPluginImplementationInformation();
+	/**
+	Sets the supplier. Takes a copy of aData.
+	*/
+	void SetSupplierL(const TDesC8& aData);
+	/**
+	Adds a media id. aData is parsed to find the uid of the media id to be added.
+	*/
+	void AddMediaIdL(const TDesC8& aData);
+protected:
+	/**
+	The UID of this plugin.
+	*/
+	TUid iUid;
+	/**
+	The display name of this plugin.
+	*/
+	HBufC* iDisplayName;
+	/**
+	The supplier of this plugin.
+	*/
+	HBufC* iSupplier;
+	/**
+	The version number of this plugin.
+	*/
+	TInt iVersion;
+	/**
+	The media ids supported by this plugin.
+	*/
+	RArray<TUid> iMediaIds;
+	};
+#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS
+#include <mmf/common/taggeddataparser.h>
+#endif
+/**
+@publishedAll
 Interface to be implemented by customers of the class TaggedDataParser.
 */
 class MTaggedDataParserClient
 	{
 public:
 	virtual void ProcessTaggedDataL(const TDesC8& aTag, const TDesC8& aData) = 0;
-	};
-/**
-@internalComponent
-Utility class used to parse data separated by xml-style tags.
-*/
-class TaggedDataParser
-	{
-public:
-	/**
-	Splits aData into xml-style tags and values, and gets aClient to process each tag/value pair.
-	*/
-	static void ParseTaggedDataL(const TDesC8& aData, MTaggedDataParserClient& aClient);
-	/**
-	Converts a string to a uid. If the string begin with "0x" it will be parsed as Hex, else Decimal.
-	*/
-	static void ConvertTextToUidL(const TDesC8& aData, TUid& aUid);
-	/**
-	Converts a string to a TUint. The string must begin with "0x" and be 10 characters long,
-	otherwise it is considered corrupt.
-	*/
-	static void ConvertTextToTUintL(const TDesC8& aData, TUint& aUid);
-	};
-class CMatchData;
-class CDesC8Array;
-/**
-@publishedAll
-Abstract class that contains basic information about ECom Multimedia plugins.
-@released
-@since 7.0s
-*/
-class CMMFPluginImplementationInformation : public CBase
-	{
-public:
-	/**
-	Returns the uid of this particular plugin implementation.
-	This is the UID used to instantiate this multimedia plugin.
-	@return The implementation uid.
-	@since  7.0s
-	*/
-	IMPORT_C TUid Uid() const;
-	/**
-	Returns the display name of this plugin implementation.
-	@return The display name.
-	@since  7.0s
-	*/
-	IMPORT_C const TDesC& DisplayName() const;
-	/**
-	Returns the name of the supplier of this plugin implementation, e.g. "Symbian".
-	@return The plugin supplier.
-	@since  7.0s
-	*/
-	IMPORT_C const TDesC& Supplier() const;
-	/**
-	Returns the version number of this plugin.
-	@return The version number.
-	@since 7.0s
-	*/
-	IMPORT_C TInt Version() const;
-	/**
-	Returns the array of media IDs supported by this plugin.
-	The media ID can be used by clients to determine whether the plugin supports audio or
-	video data (or both). A UID is used for the media ID to provide future extensibility.
-	@return The array of media IDs.
-	@since  7.0s
-	*/
-	IMPORT_C const RArray<TUid>& SupportedMediaIds() const;
-	/**
-	Tests whether this plugin was supplied by aSupplier.
-	@param  aSupplier
-	        The required supplier.
-	@return A boolean indicating if this plugin was supplied by aSupplier. ETrue if this plugin was supplied
-	        by aSupplier, EFalse if not.
-	@since 7.0s
-	*/
-	IMPORT_C TBool SupportsSupplier(const TDesC& aSupplier) const;
-	/**
-	Tests whether this plugin supports aMediaId.
-	@param  aMediaId
-	        The required media id.
-	@return A boolean indicating if the plugin supports aMediaId. ETrue if this plugin supports aMediaId, EFalse if not.
-	@since 7.0s
-	*/
-	IMPORT_C TBool SupportsMediaId(TUid aMediaId) const;
-	/**
-	Destructor.
-	*/
-	virtual ~CMMFPluginImplementationInformation();
-protected:
-	/**
-	Constructor.
-	*/
-	CMMFPluginImplementationInformation();
-	/**
-	Sets the supplier. Takes a copy of aData.
-	*/
-	void SetSupplierL(const TDesC8& aData);
-	/**
-	Adds a media id. aData is parsed to find the uid of the media id to be added.
-	*/
-	void AddMediaIdL(const TDesC8& aData);
-protected:
-	/**
-	The UID of this plugin.
-	*/
-	TUid iUid;
-	/**
-	The display name of this plugin.
-	*/
-	HBufC* iDisplayName;
-	/**
-	The supplier of this plugin.
-	*/
-	HBufC* iSupplier;
-	/**
-	The version number of this plugin.
-	*/
-	TInt iVersion;
-	/**
-	The media ids supported by this plugin.
-	*/
-	RArray<TUid> iMediaIds;
 	};
 /**
 @publishedAll
 @released
 	@return The heap space required.
 	@since  7.0s
 	*/
 	IMPORT_C TUint HeapSpaceRequired() const;
 	/**
 	Queries the ECom registry for the play formats supported.
 	@internalTechnology
 	*/
 	ETrue for secure DRM process mode supporting controller, EFalse if not.
 	@internalTechnology
 	*/
 	IMPORT_C TBool SupportsSecureDRMProcessMode() const;
+	/**
+	Returns the stack space required by this controller.
+	@return The stack space required.
+	@internalTechnology
+	*/
+	IMPORT_C TUint StackSize() const;
 protected:
 	/**
 	Constructor.
 	@internalTechnology
 	*/
 	void SetNetworkCapabilityL(const TDesC8& aNetworkCapable);
+	/**
+	Parses aData to get the size of the stack the controller requires.
+	@internalTechnology
+	*/
+	void SetStackSizeL(const TDesC8& aData);
 private:
 	/**
 	The play formats supported by this controller.
 	*/
 	/**
 	The heap space required by this controller
 	*/
 	TUint iHeapSpaceRequired;
 	/**
 	The Uri scheme supported by this plugin
 	*/
 	CDesC8Array* iUriSchemes;
 	/**
 	Secure DRM process model supported by this controller
 	*/
 	TBool  iSupportsSecureDRMProcessMode;
+	/**
+	The stack space required by this controller
+	*/
+	TUint iStackSize;
 	};
 /**
 @publishedAll
 	*/
 	EMatchHeaderData,
 	/**
 	@publishedPartner
-	@prototype
+	@released
 	The match will be based on Uri details.
 	*/
 	EMatchUri
 	};
 	*/
 	IMPORT_C void SetMatchToUriL(const TDesC& aUri);
 	/**
 	@publishedPartner
-	@prototype
+	@released
 	Sets this object to match to uri scheme and file extension specified by a URI.
 	The Uri scheme and extension are saved in iMatchReqData. Further,iMatchData contains uri extension,
 	iMatchUriScheme contains uri scheme.
 	*/
 	IMPORT_C const TDesC8& MatchData() const;
 	/**
 	@publishedPartner
-	@prototype
+	@released
 	Returns the uri scheme used to perform the plugin match.
 	@return The uri scheme.
 	*/
 	virtual ~CMMFControllerSecureDrmPluginSelectionParameters() {};
 protected:
 	CMMFControllerSecureDrmPluginSelectionParameters();
 	};
-class CMmfRecognizerUtil; // declared here.
-/**
-@internalAll
-MMF utility class used by MMF recognizer
-Maintains an array of CMMFControllerImplementationInformation objects
-so that data headers can be speedily matched against.
-Updates the array when notified by ECOM of a change to the global
-interface implementation registration data.
-*/
-NONSHARABLE_CLASS( CMmfRecognizerUtil ): public CBase
-	{
-public:
-	enum TMatchLevel
-		{
-		EMatchNone, //no match
-		EMatchData, //data match only
-		EMatchName  //suffix and data match
-		};
-public:
-	IMPORT_C static void GetMimeTypesL(CDesC8Array* aMimeTypes);
-	IMPORT_C static CMmfRecognizerUtil* NewL();
-	~CMmfRecognizerUtil();
-	IMPORT_C TMatchLevel GetMimeTypeL(const TDesC& aFileName, const TDesC8& aImageData, TDes8& aMimeType);
-private:
-	CMmfRecognizerUtil();
-	void ConstructL();
-private:
-	class CBody;
-	CBody* iBody;
-	};
 /**
 @publishedAll
 @released

branch	Symbian3
changeset 4	837f303aceeb
parent 2	2fe1408b6811