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 "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 CSPEtelConferenceEventMonitor

    15 *

    16 */

    17 

    18 

    19 #ifndef CSPETELCONFERENCEEVENTMONITOR_H

    20 #define CSPETELCONFERENCEEVENTMONITOR_H

    21 

    22 #include <e32base.h>

    23 #include <etelmm.h>

    24 

    25 

    26 class CSPCall;

    27 class CSPConferenceCall;

    28 

    29 

    30 /**

    31 * Monitors single ETel RMobileConferenceCall for conference call events.

    32 *

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

    34 *  line capabilites are not monitored.

    35 *

    36 *  @lib csplugin.dll

    37 *  @since S60 v3.2

    38 */

    39 class CSPEtelConferenceEventMonitor: public CActive

    40     {

    41     

    42     public: //Constructors and descructor

    43     

    44     

    45         /**

    46         * Two-phased constructing for the monitor.

    47         *

    48         * @param aOwner the observer for getting notification

    49         * @param aPhone the line to monitor

    50         */

    51         static CSPEtelConferenceEventMonitor* NewL( 

    52                 CSPConferenceCall& aOwner,

    53                 RMobileConferenceCall& aPhone );

    54 

    55         /**

    56         * C++ default destructor

    57         */

    58         virtual ~CSPEtelConferenceEventMonitor( );

    59 

    60         /**

    61         * Start monitoring call events

    62         * @since S60 3.2

    63         */

    64         void StartMonitoring();

    65     

    66     protected: // From CActive

    67         /**

    68         * From CActive

    69         * RunL

    70         * @since S60 3.2

    71         */

    72         void RunL();

    73         

    74         /**

    75         * From CActive

    76         * Cancels the monitor

    77         * @since S60 3.2

    78         */

    79         void DoCancel();

    80 

    81     private:

    82         /**

    83         * C++ default constructor

    84         * @param aOwner the observer for status change (incoming call)

    85         * @param aPhone the line associated with the call

    86         */

    87         CSPEtelConferenceEventMonitor( CSPConferenceCall& aOwner,

    88                             RMobileConferenceCall& aPhone );

    89                                           

    90         /**

    91         * Constructs the monitor in the second phase.

    92         */

    93         void ConstructL();

    94 

    95         

    96     private: // data

    97         /**

    98         * Forwards events.

    99         */

   100         CSPConferenceCall& iOwner;

   101        

   102         /**

   103         * Phone that is being observed for incoming call.

   104         */

   105         RMobileConferenceCall& iCall;

   106         

   107         /**

   108         * Event received.

   109         */ 

   110         RMobileConferenceCall::TMobileConferenceEvent iEvent;

   111         

   112         /**

   113         * The call name related to the event.

   114         */

   115         TName iCallName;

   116         

   117         /**

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

   119         * during observer-call sequence.

   120         */

   121         TBool* iDestrPtr;

   122         

   123     };

   124 

   125 #endif // CSPETELCONFERENCEEVENTMONITOR_H