// Copyright (c) 2001-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
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//

#ifndef __MMFCLIP_H_
#define __MMFCLIP_H_

#include <mmf/server/mmfdatasource.h>
#include <mmf/server/mmfdatasink.h>
#include <mmf/server/mmfbuffer.h>
#include <mmf/common/mmfutilities.h>

/**
@publishedAll
@released

Abstract class to represent a source or sink that contains a multimedia clip (i.e. not a stream or hardware device).

Typical examples are a file or an area of memory (descriptor).
*/
class CMMFClip : public CBase, public MDataSource, public MDataSink
	{
public :
	//asynchronous Read/WriteBufferLs

	/**
	Reads aLength number of bytes of data from the offset, aPosition into the buffer, aBuffer.
	Intended for asynchronous usage.

	This is a virtual function that each derived class must implement.

	@param  aLength
	        The number of bytes to read.
	@param  aBuffer
	        The buffer to read the data into.
	@param  aPosition
	        The offset from which to start reading.
	@param  aConsumer
	        The sink of tha data read from the clip. Will be informed of read if not NULL.
	*/
	virtual void ReadBufferL( TInt aLength, CMMFBuffer* aBuffer, TInt aPosition, MDataSink* aConsumer) = 0 ;

	/**
	Writes aLength number of bytes of data from the offset, aPosition from the buffer, aBuffer.
	Intended for asynchronous usage.

	This is a virtual function that each derived class must implement.

	@param  aLength
	        The number of bytes to write.
	@param  aBuffer
	        The buffer to write the data into.
	@param  aPosition
	        The offset from which to start writing.
	@param  aSupplier
	        The source of the data writen to the clip. Will be informed of write if not NULL.
	*/
	virtual void WriteBufferL( TInt aLength, CMMFBuffer* aBuffer, TInt aPosition, MDataSource* aSupplier) = 0 ;

	/**
	Reads the maximum number of bytes of data from the offset, aPosition into the buffer, aBuffer.
	Intended for asynchronous usage.

	This is a virtual function that each derived class must implement.

	@param  aBuffer
	        The buffer to read the data into.
	@param  aPosition
	        The offset from which to start reading.
	@param  aConsumer
	        The sink of tha data read from the clip. Will be informed of read if not NULL.
	*/
	virtual void ReadBufferL( CMMFBuffer* aBuffer, TInt aPosition, MDataSink* aConsumer) = 0 ;

	/**
	Writes the maximum number of bytes of data from the offset, aPosition from the buffer, aBuffer.
	Intended for asynchronous usage.

	This is a virtual function that each derived class must implement.

	@param  aBuffer
	        The buffer to write the data into.
	@param  aPosition
	        The offset from which to start writing.
	@param  aSupplier
	        The source of the data writen to the clip. Will be informed of write if not NULL.
	*/
	virtual void WriteBufferL( CMMFBuffer* aBuffer, TInt aPosition, MDataSource* aSupplier) = 0 ;

	//synchronous Read/WriteBufferLs

	/**
	Reads the maximum number of bytes of data from the offset, aPosition into the buffer, aBuffer.
	Intended for synchronous usage.

	This is a virtual function that each derived class must implement.

	@param  aBuffer
	        The buffer to read the data into.
	@param  aPosition
	        The offset from which to start reading.
	*/
	virtual void ReadBufferL( CMMFBuffer* aBuffer, TInt aPosition) = 0 ;

	/**
	Writes the maximum number of bytes of data from the offset, aPosition from the buffer, aBuffer.
	Intended for synchronous usage.

	This is a virtual function that each derived class must implement.

	@param  aBuffer
	        The buffer to write the data into.
	@param  aPosition
	        The offset from which to start writing.
	*/
	virtual void WriteBufferL( CMMFBuffer* aBuffer, TInt aPosition) = 0 ;

	/**
	Returns the amount of space available for the clip.

	This is a virtual function that each derived class must implement.

	@return The amount of space available.
	*/
	virtual TInt64 BytesFree() = 0 ;

	/**
	Returns the size of the clip in bytes.

	This is a virtual function that each derived class must implement.

	@return	The size of the clip.
	*/
	virtual TInt Size() = 0 ;

	/**
	Deletes the clip. 

	This should be overriden in the derived	classes, the default version returns KErrNotSupported.

	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
	        another of the system-wide error codes.
	*/
	virtual TInt Delete()	{return KErrNotSupported;}

	/**
	Sets the size of the clip. This should be overriden in the derived
	classes, the default version returns KErrNotSupported.

	@param  aSize
	        The size of the clip.

	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
	        another of the system-wide error codes.
	*/
	inline virtual TInt SetSize(TInt aSize);

protected :
	/**
	Protected constructor.

	@param  aSourceType
	        The source type.
	@param  aSinkType
	        The sink type.
	*/
	CMMFClip( TUid aSourceType, TUid aSinkType ) : MDataSource( aSourceType ), MDataSink( aSinkType ) {}
	} ;

inline TInt CMMFClip::SetSize(TInt /*aSize*/)
{
	return KErrNotSupported;
}


#endif