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

#define MDFOUTPUTPORT_H

#include <e32base.h>

#include <mdf/mdfcommon.h>

class CMdfProcessingUnit;

class CMMFBuffer;

class MMdfOutputPort;

class MMdfInputPort;

class MMdfInputPortObserver;

class TPuConfig;

/**

Codec API Output Port observer class.

*/

class MMdfOutputPortObserver

	{

public:

	/**

	Called by the Codec API Output Port when MopReadData() has completed.

	@param  aOutputPort

	        The Output Port which sent the callback.

	@param  aBuffer

		  The buffer read by the Output Port.

	@param  aErrorCode

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

	 	  another of the system-wide error codes. 

	*/

	virtual void MopoReadDataComplete(const MMdfOutputPort* aOutputPort,

		CMMFBuffer* aBuffer, TInt aErrorCode) = 0;

	/**

	Called by the Codec API Output Port when MopDisconnectTunnel() has completed.

	@param  aOutputPort

		  The Output Port which sent the callback.

	@param  aErrorCode

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

	 	  another of the system-wide error codes. 

	*/

	virtual void MopoDisconnectTunnelComplete(const MMdfOutputPort* aOutputPort,

		TInt aErrorCode) = 0;

	/**

	Called by the Codec API Output Port when MopRestartTunnel() has completed.

	@param  aOutputPort

		  The Ouput Port which sent the callback.

	@param  aErrorCode

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

	 	  another of the system-wide error codes. 

	*/

	virtual void MopoRestartTunnelComplete(const MMdfOutputPort* aOutputPort,

		TInt aErrorCode) = 0;	

	};

/**

Codec API Output Port interface.

*/

class MMdfOutputPort

	{

public:

	/**

	Synchronous function used to configure the Output Port.

	@param  aConfiguration

		  Holds the configuration parameters for the Output Port.

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

	        another of the system-wide error codes.

	*/

	virtual TInt MopConfigure(const TPuConfig&  aConfiguration) = 0;

	/**

	Synchronous method which gets a configuration structure for the Output Port

	@param  aConfigurationSetup

		  The reference to the structure that is to contain the configuration information

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

	        another of the system-wide error codes.	

	*/

	virtual TInt MopGetConfig(TPuConfig& aConfigurationSetup) = 0;

	/**

	Synchronous function used to initialise the Output Port.

	*/

	virtual void MopInitialize() = 0;

	/**

	Synchronous function used to set the observer for the Output Port. 

	@param  aOutputPortObserver

		  The observer of the Output Port.

	*/

	virtual void MopSetObserver(const MMdfOutputPortObserver& aOutputPortObserver) = 0;

	/**

	Synchronous function used to instruct the Output Port to create a buffer. 

	@param  aBufferSize

		  The size of the buffer to be created.

	@return A pointer to the newly created buffer.

	*/

	virtual CMMFBuffer* MopCreateBuffer(TInt aBufferSize) = 0;

	/**

	Synchronous function used to instruct the Output Port to use the buffer 

	passed in the function's argument. 

	@param  aBuffer

		  The buffer to be used by the Output Port.

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

	        another of the system-wide error codes.

	*/

	virtual TInt MopUseBuffer(CMMFBuffer& aBuffer) = 0;

	/**

	Synchronous function used to instruct the Output Port to free the buffer

	passed in the function's argument. 

	@param  aBuffer

		  The buffer to be freed

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

	        another of the system-wide error codes.

	*/

	virtual TInt MopFreeBuffer(CMMFBuffer* aBuffer) = 0;

	/**

	Synchronous function used to request the set up of a tunnel between this Output Port

	and an Input Port.

	@param  aInputPortToBeConnectedTo

		  Reference to the Input Port to be connected to.

	@param  aTunnelFlags

		  Control flags for tunneling

	@param  aSupplierType

		  Specifies the supplier of the buffers for 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 MopTunnelRequest(const MMdfInputPort& aInputPortToBeConnectedTo,

		TTunnelFlags& aTunnelFlags, TSupplierType& aSupplierType) = 0;

	/**

	Asynchronous function used to read data from the Output Port.

	@param  aBuffer

		  Reference to the buffer containing data.

	*/

	virtual void MopReadData(CMMFBuffer& aBuffer) = 0;

	/**

	Asynchronous function used to disconnect a tunnelled port, and thus stop the data processing.

	*/

	virtual void MopDisconnectTunnel() = 0;

	/**

	Asynchronous function used to restart the data processing of a tunnelled port.

	*/

	virtual void MopRestartTunnel() = 0;

	/**

	Synchronous function used to find out if an Output Port is tunnelled or not.

	@return ETrue if the Input Port is tunnelled, EFalse otherwise.

	*/

	virtual TBool MopIsTunnelled() const = 0;

	/**

	Synchronous function used to get the Output Port index

	@return The Input Port index.

	*/

	virtual TInt MopIndex() const = 0;

	/**

	Synchronous function used to get the size of the buffer(s) used by the Output Port.

	@return The Output Port's buffer size.

	*/

	virtual TUint32 MopBufferSize() const = 0 ;

	/**

	Request extension feature. This is intended to provide additional features. 

	@param  aUid

	        Used to indicate which interface is required. 

	@return Standard error code. KErrNotSupported is used to indicate that the particular

	        plugin is used.

	*/

	virtual TInt MopCreateCustomInterface(TUid aUid) = 0;

	/**

	Return previously created extension.

	This returns a custom interface whose ownership is not transferred to the caller. This

	should only be used if CreateCustomInterface() has already been called for the same UID

	value. This means that any construction for that interface has already been called, 

	and thus this call cannot fail.

	@param aUid

	       Used to indicate which interface is required. 

	@return The requested interface, or NULL if not known.

	@see MopCreateCustomInterface()

	*/

	virtual TAny* MopCustomInterface(TUid aUid) = 0;

	};

#endif // MDFOUTPUTPORT_H