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