/*
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:    Engine observer to get event notifications.*
*/


#ifndef MCRENGINEOBSERVER_H
#define MCRENGINEOBSERVER_H

// INCLUDES
#include <e32def.h>

// CONSTANTS
// None

// MACROS
// None.

// DATA TYPES
/**
* Different messages that DVR engine may send via client lib callback
*/
enum TCRObserverInfo
    {
    ECRAuthenticationNeeded, /**< CR needs new username and password for authentication */
    ECRAttachCompleted,      /**< Connection attach is completed and is ready to be used */
    ECRConnectionError,      /**< Unable to open connection in RTP engine & CR engine */
    ECRNotEnoughBandwidth,   /**< Stream bitrate higher than (estimated) available connection bandwidth */
    ECRNormalEndOfStream,    /**< Used to communicate end of streaming */
    ECRSwitchingToTcp,       /**< Switch to tcp, client needs to initiate possible player */   
    ECRStreamIsLiveStream,   /**< We have a stream that cannot be paused */
    ECRRealNetworksStream,   /**< RealMedia stream format, cannot support */
    ECRTestSinkData,         /**< Placeholder for TestSink (NullSink) feedback information to test client */
    ECRSdpAvailable,         /**< Used to communicate availability of SDP */            
    ECRReadyToSeek,          /**< Used to communicate seeking posibility */
    ECRRecordingStarted,     /**< Used to communicate recording state */
    ECRRecordingPaused,      /**< Used to communicate recording state */
    ECRRecordingEnded        /**< Used to communicate recording state */
    };

/**
* This structure is sent over message queue where
* api sits listening
*/
struct SCRObserverMsg
    {
    TCRObserverInfo iMsg;    /**< Identifies the message */
    TInt            iErr;    /**< Can be used to pass error value related to message */
    };

// FORWARD DECLARATIONS
// None

// CLASS DECLARATION

/**
*  Engine observer to get event notifications.
*
*  @lib CommonRecordingEngineClient.lib
*  @since Series 60 3.0
*/
class MCREngineObserver 
    {

public: // New methods

    /**
    * Notify call back for statuses.
    * @since Series 60 3.0
    * @param aInfo a notify info.
    * @return none.
    */
    virtual void NotifyL( const SCRObserverMsg& aInfo ) = 0;
    
    };
    
#endif MCRENGINEOBSERVER_H

// End of file.