sl@0: /*
sl@0: * Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: * All rights reserved.
sl@0: * This component and the accompanying materials are made available
sl@0: * under the terms of "Eclipse Public License v1.0"
sl@0: * which accompanies this distribution, and is available
sl@0: * at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: *
sl@0: * Initial Contributors:
sl@0: * Nokia Corporation - initial contribution.
sl@0: *
sl@0: * Contributors:
sl@0: *
sl@0: * Description:
sl@0: *
sl@0: */
sl@0: 
sl@0: 
sl@0: 
sl@0: 
sl@0: /**
sl@0:  @file
sl@0:  @publishedPartner 
sl@0:  @released
sl@0: */
sl@0: 
sl@0: #ifndef MAUDIODATASUPPLIER_H
sl@0: #define MAUDIODATASUPPLIER_H
sl@0: 
sl@0: #include <a3f/a3fbase.h>
sl@0: 
sl@0: class MMMFBufferSource;
sl@0: class CMMFBuffer;
sl@0: 
sl@0: /**
sl@0:  * An interface to a set of callback functions that a buffer source client must implement.
sl@0:  */
sl@0: class MMMFAudioDataSupplier
sl@0: 	{
sl@0: 	public:
sl@0: 	/**
sl@0: 	 * Request a buffer to be filled with audio data.
sl@0: 	 *
sl@0: 	 * After filling the buufer, the client must call MBufferSource::BufferFilled() passing the filled buffer as a parameter.
sl@0: 	 * 
sl@0: 	 * @param aSource a pointer to the source requesting the buffer.
sl@0: 	 * @param aBuffer a pointer to the buffer to fill.
sl@0: 	 */
sl@0: 	virtual void BufferToBeFilled(MMMFBufferSource* aSource, CMMFBuffer* aBuffer)=0;
sl@0: 
sl@0: 	/**
sl@0: 	 * Indicates that all buffers originating from this source have been removed from the audio path.
sl@0: 	 * Also, all pending buffers previously requested by this source have become invalid and must not be used.
sl@0: 	 *
sl@0: 	 * @param aSource the source whose previous buffer requests should be ignored.
sl@0: 	 */
sl@0: 	virtual void DiscardBuffers(MMMFBufferSource* aSource)=0;
sl@0: 	};
sl@0: 
sl@0: #endif // MAUDIODATASUPPLIER_H