/*
* Copyright (c) 2006-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 MAUDIODATASUPPLIER_H
#define MAUDIODATASUPPLIER_H

#include <a3f/a3fbase.h>

class MMMFBufferSource;
class CMMFBuffer;

/**
 * An interface to a set of callback functions that a buffer source client must implement.
 */
class MMMFAudioDataSupplier
	{
	public:
	/**
	 * Request a buffer to be filled with audio data.
	 *
	 * After filling the buufer, the client must call MBufferSource::BufferFilled() passing the filled buffer as a parameter.
	 * 
	 * @param aSource a pointer to the source requesting the buffer.
	 * @param aBuffer a pointer to the buffer to fill.
	 */
	virtual void BufferToBeFilled(MMMFBufferSource* aSource, CMMFBuffer* aBuffer)=0;

	/**
	 * Indicates that all buffers originating from this source have been removed from the audio path.
	 * Also, all pending buffers previously requested by this source have become invalid and must not be used.
	 *
	 * @param aSource the source whose previous buffer requests should be ignored.
	 */
	virtual void DiscardBuffers(MMMFBufferSource* aSource)=0;
	};

#endif // MAUDIODATASUPPLIER_H