/*
* Copyright (c) 2002-2007 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: Streams data from Java to controller
*
*/
#ifndef CMMASTREAMHANDLER_H
#define CMMASTREAMHANDLER_H
// INCLUDES
#include <mmf/common/mmfcontroller.h>
#include "CMMAStreamRequest.h"
#include "MMMAStreamRequestListener.h"
#include "MMMAStreamHandlerListener.h"
// CONSTANTS
const TInt KMMAStreamHandlerBufferCount = 2;
class CMMADataSourceStream;
// CLASS DECLARATION
/**
* This class read data from CMMADataSourceStream and writes it to
* controller.
*/
NONSHARABLE_CLASS(CMMAStreamHandler): public CBase,
public MMMAStreamRequestListener
{
private:
// Streams internal state
enum TMMAStreamState
{
EMMAStreamPrepare = 0,
EMMAStreamPaused,
EMMAStreamStart,
EMMAStreamStarted,
EMMAStreamEof
};
public: // Construction
/**
* Creates new player.
*/
static CMMAStreamHandler* NewL(
MMMAStreamHandlerListener& aListener,
RMMFController& aController);
// Destructor
~CMMAStreamHandler();
protected:
// C++ constructor
CMMAStreamHandler(MMMAStreamHandlerListener& aResolver,
RMMFController& aController);
void ConstructL();
protected: // New methods
public: // New methods
/**
* Prepares stream to play.
*/
void PrepareL();
/**
* Stops handling requests. After this call data received from source
* stream will be buffered until StartL is called.
*/
void Pause();
/**
* Starts handling requests
*/
void StartL();
/**
* Data sink destination must be written to this reference
* before stream can be started.
* @return data sink destination reference
*/
TMMFMessageDestination& MessageDestination();
/**
* Sets source stream to read
*/
void SetSourceStream(CMMADataSourceStream* aSourceStream);
public: // From MMMAStreamRequestListener
void WriteComplete(CMMAStreamRequest* aRequest);
void ReadComplete(CMMAStreamRequest* aRequest);
void HandleError(CMMAStreamRequest* aRequest,
TInt aError);
private:
/**
* Writes request to controller
*/
void WriteRequest(CMMAStreamRequest* aRequest);
private: // data
// Owned write requests
RPointerArray< CMMAStreamRequest > iRequests;
// not owned source stream
CMMADataSourceStream* iSourceStream;
// Controller to write stream
RMMFController& iController;
// added data source
TMMFMessageDestination iDataSourceHandle;
// not owned listener
MMMAStreamHandlerListener& iListener;
// Stream's state
TMMAStreamState iState;
};
#endif // CMMASTREAMHANDLER_H