1 /*

     2 * Copyright (c) 2007-2008 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 "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:  Declarations for class CSPEtelConferenceStatusMonitor

    15 *

    16 */

    17 

    18 

    19 #ifndef CSPETELCONFERENCECALLSTATUSMONITOR_H

    20 #define CSPETELCONFERENCECALLSTATUSMONITOR_H

    21 

    22 #include <e32base.h>

    23 #include <etelmm.h>

    24 

    25 

    26 class MCSPConferenceStatusObserver; 

    27 

    28 /**

    29 * Monitors single ETel RMobileConferenceCall for conference call statuss.

    30 *

    31 *  This monitor is applied only for listening incoming calls, i.e.

    32 *  line capabilites are not monitored.

    33 *

    34 *  @lib csplugin.dll

    35 *  @since S60 v3.2

    36 */

    37 NONSHARABLE_CLASS(CSPEtelConferenceStatusMonitor): public CActive

    38     {

    39     

    40     public: //Constructors and descructor

    41     

    42         /**

    43         * Two-phased constructing for the monitor.

    44         *

    45         * @param aObserver the observer for getting notification

    46         * @param aPhone the line to monitor

    47         */

    48         static CSPEtelConferenceStatusMonitor* NewL( 

    49                 MCSPConferenceStatusObserver& aObserver,

    50                 RMobileConferenceCall& aPhone );

    51 

    52         /**

    53         * C++ default destructor

    54         */

    55         virtual ~CSPEtelConferenceStatusMonitor( );

    56 

    57         /**

    58         * Start monitoring call statuss

    59         * @since S60 3.2

    60         */

    61         void StartMonitoring();

    62     

    63     protected: // From CActive

    64         /**

    65         * From CActive

    66         * RunL

    67         * @since S60 3.2

    68         */

    69         void RunL();

    70         

    71         /**

    72         * From CActive

    73         * Cancels the monitor

    74         * @since S60 3.2

    75         */

    76         void DoCancel();

    77 

    78     private:

    79         

    80         /**

    81         * C++ default constructor

    82         * @param aObserver the observer for status change (incoming call)

    83         * @param aPhone the line associated with the call

    84         */

    85         CSPEtelConferenceStatusMonitor( MCSPConferenceStatusObserver& aObserver,

    86                             RMobileConferenceCall& aPhone );

    87                                           

    88         /**

    89         * Constructs the monitor in the second phase.

    90         */

    91         void ConstructL();

    92 

    93         

    94     private: // data

    95         /**

    96         * Owner.

    97         */

    98         MCSPConferenceStatusObserver& iOwner;

    99        

   100         /**

   101         * Phone that is being observed for incoming call.

   102         */

   103         RMobileConferenceCall& iCall;

   104         

   105         /**

   106         * Status received.

   107         */ 

   108         RMobileConferenceCall::TMobileConferenceStatus iConferenceStatus;

   109                 

   110         /**

   111         * Pointer for recovering from a situation where CCE releases call 

   112         * during observer-call sequence.

   113         */

   114         TBool* iDestrPtr;

   115         

   116     };

   117 

   118 #endif // CSPETELCONFERENCECALLSTATUSMONITOR_H