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

#include "es_commsbuf_internal.h"
#include <comms-infras/commsbufasyncrequest.h>
#include "commsbufpondintf.h"

EXPORT_C RCommsBufPond::RCommsBufPond()
:iPondImpl(NULL)
/**
The constructor
*/
	{
		
		
	}

EXPORT_C RCommsBuf* RCommsBufPond::Alloc(TInt aSize, TInt aMinBufSize, TInt aMaxBufSize)
/**
Allocates memory for a RCommsBuf object. More than one buffer may be allocated and linked, 
if the requested buffer size doesn't directly satisfy with the configured buffer sizes

@param 	aSize 		The requested total size
@param 	aMinBufSize The size that the allocated buffer must atleast have
@param 	aMinBufSize The size that the allocated buffer can have

@return Allocated RCommsBuf pointer on success otherwise NULL
*/
	{
	return iPondImpl->Alloc(aSize, aMinBufSize, aMaxBufSize);	
	}

EXPORT_C TInt RCommsBufPond::BytesAvailable() const
/**
Returns the total bytes available in the available pools
*/
	{
	return iPondImpl->BytesAvailable();
	}
	
EXPORT_C TInt RCommsBufPond::BytesAvailable(TInt aSize) const
/**
Returns the total bytes available in a pool with a given size.
*/
	{
	return iPondImpl->BytesAvailable(aSize);	
	}
	
EXPORT_C TInt RCommsBufPond::NextBufSize(TInt aSize) const
/**
Returns the buffer size that is greater than the given size.
*/
	{
	return iPondImpl->NextBufSize(aSize);		
	}
	
EXPORT_C TInt RCommsBufPond::LargestBufSize() const
/**
Larget buffer size available in the available pools
*/
	{
	return iPondImpl->LargestBufSize();	
	}

EXPORT_C TCommsBufAllocator RCommsBufPond::Allocator()
/**
Returns a handle to the allocator
*/
	{
	return TCommsBufAllocator(*this);		
	}

EXPORT_C void RCommsBufPond::StartRequest(RCommsBufAsyncRequest& aRequest)
/**
Issue an asynchronous request to create a RCommsBufChain

@param aRequest	A new request
*/
	{
	iPondImpl->StartRequest(*(aRequest.iAsyncReqImpl));		
	}

EXPORT_C void RCommsBufPond::CancelRequest(RCommsBufAsyncRequest& aRequest)
/**
Cancel the issued request

@param aRequest	A  request
*/
	{
	iPondImpl->CancelRequest(*(aRequest.iAsyncReqImpl));				
	}


EXPORT_C RCommsBuf* RCommsBufPond::FromHandle(TInt aHandle)
/**
Constructs the RCommsBuf from the supplied handle

TInt aHandle RShBuf handle
*/
	{
	return iPondImpl->FromHandle(aHandle);
	}


/**
@purpose Writes flattened pond structure to a descriptor for transfer to a commsbufs aware driver
@param aStore Descriptor in to which the pond structure will be flattened
*/
EXPORT_C TInt RCommsBufPond::Store(TPondTransferBuf& aStore) const
	{
	// Just forward to the implementation of the pond
	return iPondImpl->Store(aStore);
	}