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

 // source\mmf\server\baseclasses\mmfdatabuffer.cpp

 // 

 //

 #include <mmf/server/mmfdatabuffer.h>

 /**

 Method to instantiate a CMMFDataBuffer defaults to a CMMFDescriptorBuffer

 to maintain buffer compatiblity with MFAD ie. instantiating a CMMFDataBuffer defaults to creating 

 a CMMFDescriptorBuffer. This NewL creates a CMMFDescriptorBuffer with a default size of 32 bytes.

 @return	A pointer to a new CMMFDescriptorBuffer.

 */

 EXPORT_C CMMFDataBuffer* CMMFDataBuffer::NewL()

 	{

 	return CMMFDescriptorBuffer::NewL();

 	}

 /**

 Method to instantiate a CMMFDataBuffer defaults to a CMMFDescriptorBuffer by default

 to maintain buffer compatiblity with MFAD ie. instantiating a CMMFDataBuffer defaults to

 creating a CMMFDescriptorBuffer. This NewL creates a CMMFDescriptorBuffer with a size of 

 aMaxBufferSize bytes.

 @param  aMaxBufferSize

         The size in bytes of the descriptor buffer to be created.

 @return A pointer to a new CMMFDescriptorBuffer.

 */

 EXPORT_C CMMFDataBuffer* CMMFDataBuffer::NewL(TInt aMaxBufferSize)

 	{

 	return CMMFDescriptorBuffer::NewL(aMaxBufferSize);

 	}

 /**

 Method to instantiate a CMMFDescriptorBuffer.

 Defaults to a CMMFDescriptorBuffer automatically. This NewL creates a CMMFDescriptorBuffer with a 

 default size of 32 bytes.

 @return A pointer to a new CMMFDescriptorBuffer.

 */

 EXPORT_C CMMFDescriptorBuffer* CMMFDescriptorBuffer::NewL()

 	{

 	CMMFDescriptorBuffer* self = new(ELeave) CMMFDescriptorBuffer;

 	CleanupStack::PushL(self);

 	self->ConstructL(KMMFDataBufferDefaultBufferSize);

 	CleanupStack::Pop(); // self

 	return self;

 	}

 /**

 Method to instantiate a CMMFDescriptorBuffer.

 This NewL creates a CMMFDescriptorBuffer with a size of aMaxBufferSize bytes.

 @param  aMaxBufferSize

         The size in bytes of the descriptor buffer to be created.

 @return A pointer to a new CMMFDescriptorBuffer.

 */

 EXPORT_C CMMFDescriptorBuffer* CMMFDescriptorBuffer::NewL(TInt aMaxBufferSize)

 	{

 	CMMFDescriptorBuffer* self = new(ELeave) CMMFDescriptorBuffer;

 	CleanupStack::PushL(self);

 	self->ConstructL(aMaxBufferSize);

 	CleanupStack::Pop(); // self

 	return self;

 	}

 /**

 @internalTechnology

 Internal.

 @param  aMaxBufferSize

         The size in bytes of the descriptor buffer to be created.

 */

 void CMMFDescriptorBuffer::ConstructL(TInt aMaxBufferSize)

 	{

 	iData = new(ELeave) TUint8[aMaxBufferSize];

 	iPtr.Set(iData, 0, aMaxBufferSize);

 	}

 /**

 Destructor.

 Destructor also deletes the buffer contained in the CMMFDescriptorBuffer.

 */

 EXPORT_C CMMFDescriptorBuffer::~CMMFDescriptorBuffer()

 	{

 	delete[] iData;

 	}

 /**

 Reallocates the max size in bytes of a CMMFDescriptorBuffer.

 @param  aMaxBufferSize

         The new size in bytes of the descriptor buffer.

 */

 EXPORT_C void CMMFDescriptorBuffer::ReAllocBufferL(TInt aMaxBufferSize)

 	{

 	TUint8* tmp = new(ELeave) TUint8[aMaxBufferSize];

 	delete[] iData;

 	iData = tmp;

 	iPtr.Set(iData, 0, aMaxBufferSize);

 	}

 /**

 Returns a descriptor to the data contained in the CMMFDescriptorBuffer.

 @return A reference to a TPtr containing the CMMFDescriptorBuffer data.

 */

 TDes8& CMMFDescriptorBuffer::Data()

 	{

 	return iPtr;

 	}

 /**

 Returns a descriptor to the data contained in the CMMFDescriptorBuffer.

 @return A const reference to a TPtr containing the CMMFDescriptorBuffer data.

 */

 const TDesC8& CMMFDescriptorBuffer::Data() const

 	{

 	return iPtr;	

 	}

 /**

 Returns the actual data size (ie. not the maximum length) of the

 data contained in the CMMFDescriptorBuffer.

 @return	The size in bytes of the data contained in the CMMFDescriptorBuffer.

 */

 TUint CMMFDescriptorBuffer::BufferSize() const

 	{

 	return iPtr.Length();

 	}

 /**

 Sets the position.

 This method is used by components (eg codecs) which read data from a buffer

 and wish to store a read position marker for further reads.

 Note: The position cannot exceed the size of the actual data not the max length.

 @param  aPosition

         The position.

 */

 void CMMFDescriptorBuffer::SetPosition (TUint aPosition)

 	{//used for repositioning

 	if (aPosition <= (TUint)iPtr.Length()) 

 		iPosition = aPosition;

 	else 

 		iPosition = (TUint)iPtr.Length();//tried to position beyond end of data

 	}

 /**

 Sets the request size.

 This function is used in cases where a component (eg a data source) may not be able

 or be desirable to write to the entire max length of the buffer (eg variable bit rate codecs).

 In which case the SetRequestSizeL() can be set which can be read by the RequestSize()

 function in the component so that it knows to only write data upto the request size

 and not fill the buffer up to its max length.

 @param  aSize

         The request size.

 */

 void CMMFDescriptorBuffer::SetRequestSizeL(TInt aSize)

 	{

 	if (aSize < 0)

 		User::Leave(KErrUnderflow);

 	else if (aSize > iPtr.MaxLength())

 		User::Leave(KErrOverflow);

 	else

 		iRequestSize = aSize;

 	}

 /**

 Overriden method to set the status and resets the data size to 0 when the buffer becomes available.

 @param  aStatus

         The buffer status. See TBufferStatus for possible options.

 */

 void CMMFDescriptorBuffer::SetStatus(TBufferStatus aStatus)

 	{

 	CMMFBuffer::SetStatus(aStatus);

 	if ((iStatus == EAvailable)&&iData)

 		{//need to set size to 0

 		iPtr.Zero();

 		}

 	}

 /**

 This function is not supported under EKA2.

 Method to instantiate a CMMFTransferBuffer. This NewL creates a CMMFTransferBuffer.

 @param  aTransferWindow

         This is a valid RTransferWindow that has an RTransferBuffer mapped in.

 @param  aDataLength

         This parameter sets the length of the actual data present in the transferbuffer.

         This is because the length of actual data may be less than the length of the mapped in

         transfer buffer.

 @return A pointer to a new CMMFTransferBuffer.

 */

 EXPORT_C CMMFTransferBuffer* CMMFTransferBuffer::NewL(RTransferWindow& aTransferWindow, TUint aDataLength)

 	{

 //this method is not supported under EKA2

 	User::Panic(_L("Not supported!"), KErrNotSupported);

 	aTransferWindow = aTransferWindow;	//suppressed unused argument warnings

 	aDataLength =  aDataLength;			//suppressed unused argument warnings

 	return NULL;			//can't construct anything useful

 	}

 /**

 @internalTechnology

 This method is not supported under EKA2.

 Internal ConstructL.

 Note this method checks if a transfer buffer has been mapped in and

 will leave with KErrNotReady if the RTransferWindow does not have a mapped

 in RTransferBuffer.

 @param  aTransferWindow

         This is a reference to a valid RTransferWindow that has an RTransferBuffer mapped in.

 @param  aDataLength

         The length of the data.

 */

 void CMMFTransferBuffer::ConstructL(RTransferWindow& aTransferWindow, TUint aDataLength)

 	{

 //this method is not supported under EKA2

 	aTransferWindow = aTransferWindow;	//suppressed unused argument warnings

 	aDataLength =  aDataLength;			//suppressed unused argument warnings

 	}

 /**

 CMMFTransferBuffer destructor

 Destructor maps out RTransferBuffer and closes RTransferWindow.

 */

 EXPORT_C CMMFTransferBuffer::~CMMFTransferBuffer()

 	{

 	}

 /**

 Returns a descriptor to the data contained in the CMMFTransferBuffer.

 @return	A reference to a TPtr containing the CMMFTransferBuffer data.

 */

 TDes8& CMMFTransferBuffer::Data()

 	{

 	return iPtr;

 	}

 /**

 Returns a descriptor to the data contained in the CMMFTransferBuffer.

 @return	A const reference to a TPtr containing the CMMFTransferBuffer data.

 */

 const TDesC8& CMMFTransferBuffer::Data() const

 	{

 	return iPtr;

 	}

 /**

 Returns the actual data size (ie. not the max length) of the

 data contained in the CMMFTransferBuffer.

 @return	The size in bytes of the data contained in the CMMFTransferBuffer.

 */

 TUint CMMFTransferBuffer::BufferSize() const

 	{

 	return iPtr.Length();

 	}

 /**

 Sets the position.

 This method is used by components (eg codecs) which read data from a buffer

 and wish to store a read position marker for further reads.

 Note: The position cannot exceed the size of the actual data not the max length.

 @param  aPosition

         The position.

 */

 void CMMFTransferBuffer::SetPosition (TUint aPosition)

 	{//used for repositioning

 	aPosition = aPosition; //suppress compiler warning

 	}

 /**

 Sets the request size.

 This function is used in cases where a component (eg. a data source) may not be able

 or be desirable to write to the entire max length of the buffer (eg. variable bit rate codecs).

 In this case, the SetRequestSizeL can be set which can be read by the RequestSize()

 function in the component so that it knows to only write data upto the request size

 and not fill the buffer up to its max length.

 @param  aSize

         The request size.

 */

 void CMMFTransferBuffer::SetRequestSizeL(TInt aSize)

 	{

 	aSize = aSize; //suppress compiler warning

 	}

 /**

 This function is not supported under EKA2.

 Returns a reference to the transfer window currently used

 by the CMMFtransferBuffer.

 @return	A reference to the current RTransferWindow.

 */

 EXPORT_C RTransferWindow& CMMFTransferBuffer::TransferWindow()

 	{

 	return iTransferWindow;

 	}

 /**

 This method is not supported under EKA2.

 Modifies the CMMFTransferBuffer by updating the RTransferWindow.

 This method is used if the same CMMFTransferBuffer is used throughout

 eg. if a single CMMFTransferBuffer is created upfront but a different

 transfer window (or the same transfer window with a different buffer mapped in

 is used). That is the same CMMFTransferBuffer but the actrual buffer may be different.

 Note: If the updated RTransferWindow is new, then the old buffer must

 be mapped out first by a call to CMMFTransferBuffer::MapOutBuffer() and the

 RtransferWindow handle closed outside the CMMFTransferBuffer.

 @param  aTransferWindow

         The RTransferWindow to update - can be a new RTransferWindow

         or the same RTransferWindow with a new RTransferBuffer mapped in.

 @param  aDataLength

         The length of the data.

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

         another of the system-wide error codes.

 */

 EXPORT_C TInt CMMFTransferBuffer::UpdateTransferWindow(RTransferWindow& aTransferWindow, TUint aDataLength)

 	{

 //this method is not supported under EKA2

 	aTransferWindow = aTransferWindow;	//suppressed unused argument warnings

 	aDataLength =  aDataLength;			//suppressed unused argument warnings

 	return KErrNotSupported;

 	}

 /**

 Maps the buffer out of the transfer window.

 This method should be called in preference to

 calling MapOutBuffer directly on the RtransferWindow

 so that the CMMFTransferBuffer knows that it is no longer

 available.

 */

 EXPORT_C void CMMFTransferBuffer::MapOutBuffer()

 	{

 	}

 /**

 Function to instantiate a CMMFPtrBuffer.

 This NewL creates an unititalised CMMFPtrBuffer.

 @return A pointer to a new CMMFPtrBuffer.

 */

 EXPORT_C CMMFPtrBuffer* CMMFPtrBuffer::NewL()

 	{

 	CMMFPtrBuffer* self = new(ELeave) CMMFPtrBuffer;

 	return self;

 	}

 /**

 Function to instantiate a CMMFPtrBuffer.

 This NewL creates a CMMFPtrBuffer which owns a TPtr8.

 @param  aPtr

         A reference to a TPtr containing the CMMFPtrBuffer data.

 @return A pointer to a new CMMFPtrBuffer.

 */

 EXPORT_C CMMFPtrBuffer* CMMFPtrBuffer::NewL(const TPtr8& aPtr)

 	{

 	CMMFPtrBuffer* self = new(ELeave) CMMFPtrBuffer;

 	CleanupStack::PushL(self);

 	self->ConstructL(aPtr);

 	CleanupStack::Pop(self); // self

 	return self;

 	}

 /**

  * ConstructL

  *

  * Internal ConstructL

  * @internalTechnology

  * @param	"aPtr"

  *			Reference to a TPtr containing the CMMFPtrBuffer data

  */

 void CMMFPtrBuffer::ConstructL(const TPtr8& aPtr)

 	{

 	iPtr.Set(aPtr);

 	}

 /**

 Destructor.

 Destructor does no deletion, as this buffer class does not own the memory.

 */

 EXPORT_C CMMFPtrBuffer::~CMMFPtrBuffer()

 	{

 	}

 /**

 Returns a descriptor to the data contained in the CMMFPtrBuffer.

 @return	A reference to a TPtr containing the CMMFPtrBuffer data.

 */

 TDes8& CMMFPtrBuffer::Data()

 	{

 	return iPtr;	

 	}

 /**

 Returns a descriptor to the data contained in the CMMFPtrBuffer.

 @return	A const reference to a TPtr containing the CMMFPtrBuffer data.

 */

 const TDesC8& CMMFPtrBuffer::Data() const

 	{

 	return iPtr;	

 	}

 /**

 Returns the actual data size (ie. not the max length) of the

 data contained in the CMMFPtrBuffer.

 @return	The size in bytes of the data contained in the CMMFPtrBuffer.

 */

 TUint CMMFPtrBuffer::BufferSize() const

 	{

 	return iPtr.Length();

 	}

 /**

 Sets the position.

 This function is used by components (eg. codecs) which read data from a buffer

 and wish to store a read position marker for further reads.

 Note: The position cannot exceed the size of the actual data not the maximum length.

 @param  aPosition

         The position.

 */

 void CMMFPtrBuffer::SetPosition (TUint aPosition)

 	{//used for repositioning

 	if (aPosition <= (TUint)iPtr.Length()) 

 		iPosition = aPosition;

 	else 

 		iPosition = (TUint)iPtr.Length();//tried to position beyond end of data

 	}

 /**

 Sets the request size.

 This method is used in cases where a component (eg. a data source) may not be able

 or be desirable to write to the entire max length of the buffer (eg. variable bit rate codecs).

 In this case, the SetRequestSizeL() can be set which can be read by the RequestSize()

 function in the component so that it knows to only write data upto the requested size

 and not fill the buffer up to its maximum length.

 @param  aSize

         The request size.

 */

 void CMMFPtrBuffer::SetRequestSizeL(TInt aSize)

 	{

 	if (aSize < 0)

 		User::Leave(KErrUnderflow);

 	else if (aSize > iPtr.MaxLength())

 		User::Leave(KErrOverflow);

 	else

 		iRequestSize = aSize;

 	}

 /**

 Overriden method to set the status.

 Resets the data size to 0 when the buffer becomes available.

 @param  aStatus

         The buffer status. See enum TBufferStatus.

 */

 void CMMFPtrBuffer::SetStatus(TBufferStatus aStatus)

 	{

 	CMMFBuffer::SetStatus(aStatus);

 	if (iStatus == EAvailable)

 		{//need to set size to 0

 		iPtr.Zero();

 		}

 	}

 /** 

 Takes a TPtr8 to pre-allocated memory.

 @param  aPtr

 		The pointer refernce.

 */

 EXPORT_C void CMMFPtrBuffer::SetPtr(const TPtr8& aPtr)

 	{

 	iPtr.Set(aPtr);

 	}

 //This functions needs updating

 //should more CMMFDataBuffers be supported in future

 /**

 Static method which returns ETrue if the buffer UID is a supported

 CMMFDataBuffer type.

 Note:

 If the buffer is not a CMMFDataBuffer this method should

 return EFalse.

 @param  aUid

         The UID of the CMMFBuffer to be checked for support.

 @return The buffer size.

 */

 EXPORT_C TBool CMMFBuffer::IsSupportedDataBuffer(TUid aUid)

 	{ 

 	return((aUid == KUidMmfDescriptorBuffer)

 		|| (aUid == KUidMmfTransferBuffer)

 		|| (aUid == KUidMmfPtrBuffer));

 	}

 /**

 Static method which returns ETrue if the buffer UID is a buffer

 that is safe to be used with the file server.  If the buffer type

 is not safe to be used with the file server, then the client would

 need to copy the contents of the buffer, prior to passing it onto

 the file server.

 This implementation assumes the CMMFPtrBuffer is safe for file server copy. If this is not the case 

 then remove the PtrBuffer set to ETrue.

 @param  aUid

         The UID of the CMMFBuffer to be checked for support.

 @return The buffer size.

 */

 EXPORT_C TBool CMMFBuffer::IsFileServerSafe(TUid aUid)

 	{

 	TBool isFileServerSafe = EFalse;

 	if (aUid == KUidMmfDescriptorBuffer)

 		isFileServerSafe = ETrue;

 	if (aUid == KUidMmfPtrBuffer) //remove this if target CMMFPtrBuffers

 		isFileServerSafe = ETrue; //are not safe for file server copy

 	return isFileServerSafe;

 	}