1 /*

     2 * Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:    Engine observer to get event notifications.*

    15 */

    16 

    17 

    18 #ifndef MCRENGINEOBSERVER_H

    19 #define MCRENGINEOBSERVER_H

    20 

    21 // INCLUDES

    22 #include <e32def.h>

    23 

    24 // CONSTANTS

    25 // None

    26 

    27 // MACROS

    28 // None.

    29 

    30 // DATA TYPES

    31 /**

    32 * Different messages that DVR engine may send via client lib callback

    33 */

    34 enum TCRObserverInfo

    35     {

    36     ECRAuthenticationNeeded, /**< CR needs new username and password for authentication */

    37     ECRAttachCompleted,      /**< Connection attach is completed and is ready to be used */

    38     ECRConnectionError,      /**< Unable to open connection in RTP engine & CR engine */

    39     ECRNotEnoughBandwidth,   /**< Stream bitrate higher than (estimated) available connection bandwidth */

    40     ECRNormalEndOfStream,    /**< Used to communicate end of streaming */

    41     ECRSwitchingToTcp,       /**< Switch to tcp, client needs to initiate possible player */   

    42     ECRStreamIsLiveStream,   /**< We have a stream that cannot be paused */

    43     ECRRealNetworksStream,   /**< RealMedia stream format, cannot support */

    44     ECRTestSinkData,         /**< Placeholder for TestSink (NullSink) feedback information to test client */

    45     ECRSdpAvailable,         /**< Used to communicate availability of SDP */            

    46     ECRReadyToSeek,          /**< Used to communicate seeking posibility */

    47     ECRRecordingStarted,     /**< Used to communicate recording state */

    48     ECRRecordingPaused,      /**< Used to communicate recording state */

    49     ECRRecordingEnded        /**< Used to communicate recording state */

    50     };

    51 

    52 /**

    53 * This structure is sent over message queue where

    54 * api sits listening

    55 */

    56 struct SCRObserverMsg

    57     {

    58     TCRObserverInfo iMsg;    /**< Identifies the message */

    59     TInt            iErr;    /**< Can be used to pass error value related to message */

    60     };

    61 

    62 // FORWARD DECLARATIONS

    63 // None

    64 

    65 // CLASS DECLARATION

    66 

    67 /**

    68 *  Engine observer to get event notifications.

    69 *

    70 *  @lib CommonRecordingEngineClient.lib

    71 *  @since Series 60 3.0

    72 */

    73 class MCREngineObserver 

    74     {

    75 

    76 public: // New methods

    77 

    78     /**

    79     * Notify call back for statuses.

    80     * @since Series 60 3.0

    81     * @param aInfo a notify info.

    82     * @return none.

    83     */

    84     virtual void NotifyL( const SCRObserverMsg& aInfo ) = 0;

    85     

    86     };

    87     

    88 #endif MCRENGINEOBSERVER_H

    89 

    90 // End of file.