// Copyright (c) 2005-2009 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:

 //

 /**

  @file

  @publishedPartner

  @released

 */

 #ifndef MDFPULOADER_H

 #define MDFPULOADER_H

 #include <e32base.h>

 class MMdfInputPort;

 class MMdfOutputPort;

 class CMdfProcessingUnit;

 class MMdfProcessingUnitObserver;

 class TFourCC;

 /**

 Utility class used by the HwDevice to load Processing Units.

 */

 class CMdfPuLoader : public CBase

 	{

 public:

 	/**

 	Constructs an instance of the ECom plugin.

 	@param	aImplementationUid

 			ECom implementation UID.

 	@return	A pointer to the newly constructed object

 	*/

 	inline static CMdfPuLoader* NewL(TUid aImplementationUid);

 	/**

 	Loads a Processing Unit using a UID synchronously.

 	@param	aProcessingUnitObserver

 			The observer for the newly loaded Processing Unit.

 	@param	aImplementationUid

 			ECom implementation UID.

 	@return  A pointer to the newly loaded Processing Unit.

 	*/

 	virtual CMdfProcessingUnit* LoadProcessingUnitL(const MMdfProcessingUnitObserver& aProcessingUnitObserver, 

 		TUid aImplementationUid) = 0;

 	/**

 	Loads an audio Processing Unit synchronously.  The Processing Unit is

 	resolved according to the source and destination data types provided.

 	@param	aProcessingUnitObserver

 			The observer for the newly loaded Processing Unit.

 	@param	aSrcDataType

 			The source data type.

 	@param	aDestDataType

 			The destination data type.

 	@return	A pointer to the newly loaded Processing Unit.	   

 	*/

 	virtual CMdfProcessingUnit* LoadProcessingUnitL( const MMdfProcessingUnitObserver& aProcessingUnitObserver, 

 		TFourCC aSrcDataType, TFourCC aDestDataType) = 0;

 	/**

 	Loads a video Processing Unit synchronously.  The Processing Unit is

 	resolved according to the source and destination data types provided.

 	@param	aProcessingUnitObserver

 			The observer for the newly loaded Processing Unit.

 	@param	aSrcDataType

 			The source data type.

 	@param	aDestDataType

 			The destination data type.

 	@param	aImplementationType

 			The implementation type. Can be audio, video encoding or video decoding.

 	@return	A pointer to the newly loaded Processing Unit.	   

 	*/

 	virtual CMdfProcessingUnit* LoadProcessingUnitL( const MMdfProcessingUnitObserver& aProcessingUnitObserver, 

 		const TDesC8& aSrcDataType, const TDesC8& aDestDataType, const TUid& aImplementationType) = 0;

 	/**

 	Attempts to set-up a tunnel from a given output port to an input port.  

 	The data flow is from the output port to the input port.  This method is synchronous.

 	@param	aOutputPort

 			The output port of the tunnel.

 	@param	aInputPort

 			The input port of the tunnel.

 	@return	An error code indicating if the function call was successful. KErrNone on success, otherwise

 			another of the system-wide error codes.	  

 	*/

 	virtual TInt TunnelSetup(MMdfOutputPort& aOutputPort, MMdfInputPort& aInputPort) = 0;

 	/**

 	Unloads a Processing Unit synchronously.

 	@param	aPu

 			The pointer to the Processing Unit to be unloaded.

 	*/

 	virtual void UnloadProcessingUnit(CMdfProcessingUnit*& aPu) = 0;

 	/**

 	Standard destructor.

 	*/

 	virtual inline ~CMdfPuLoader();

 private:

 	TUid iDtor_ID_Key;

 	};

 #include <mdf/mdfpuloader.inl>

 #endif // MDFPULOADER_H