1 /*

     2 * Copyright (c) 2005-2006 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:  Monitor the status of the call.

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef MUSCALLCONFERENCEMONITOR_H

    21 #define MUSCALLCONFERENCEMONITOR_H

    22 

    23 #include "musunittesting.h"

    24 #include "mussesseioninformationapi.h"

    25 #include "muscallmonitor.h"

    26 

    27 #include <etelmm.h>

    28 #include <e32base.h>

    29 

    30 class CMusCallConferenceEventMonitor;

    31 

    32 /**

    33  * Monitors the event of call and set the state to property. 

    34  *

    35  * @lib musaoplugin.dll

    36  */

    37 class CMusCallConferenceMonitor : public CActive

    38     {

    39 

    40     public: 

    41         /**

    42          * Two-phased constructor. Leaves on failure.

    43          * aCall is not owned.

    44          * @return CMusCallConferenceMonitor object.

    45          */

    46         static CMusCallConferenceMonitor* NewL(

    47                                RMobilePhone& aPhone, RMobileLine& aLine,

    48                                RPointerArray<CMusCallMonitor>& aCallMonitorArray);

    49                                 

    50         /**

    51          * Destructor.

    52          */

    53         ~CMusCallConferenceMonitor();     

    54 

    55          /**

    56           * Checks the Conference Status and 

    57           * sets the multimediasharing propery key value          

    58           */

    59         void SetStateL();  

    60 

    61     private:

    62 

    63         /**

    64          * C++ constructor.

    65          */

    66         CMusCallConferenceMonitor(

    67                              RMobileLine& aLine,

    68                              RPointerArray<CMusCallMonitor>& aCallMonitorArray );

    69 

    70         /**

    71          * Symbian 2nd-phase constructor.

    72          */

    73         void ConstructL(RMobilePhone& aPhone);       

    74 

    75         /**

    76           * Sets the multimediasharing propery key value

    77           * if the value is same before then dont report it.

    78           */

    79         void SetStateL(NMusSessionInformationApi::TMusCallEvent aVal);

    80 

    81         /**

    82           * Add / Remove Call Monitors based on Mus criteria          

    83           */

    84         void MonitorCallL();

    85 

    86     private:

    87 

    88         /**

    89          * Handles an active object's request completion event.

    90          */

    91         void RunL();

    92         

    93         /**

    94          * cancels of an outstanding request

    95          */        

    96         void DoCancel();

    97 

    98          /*

    99          * Handles a leave occurring in the request completion 

   100          * event handler RunL().

   101          * Always return KErrNone since it must handle this error

   102          * if it comes to this place.

   103          */

   104         TInt RunError( TInt aError );

   105 

   106 

   107     private: 

   108 

   109         /**

   110          * Reference of RMobileLine.Not Owned.

   111          */

   112         

   113         RMobileLine& iLine;

   114        

   115         /**

   116          * Reference of RMobileConferenceCall.

   117          */

   118         RMobileConferenceCall iConfCall;

   119 

   120         /**

   121          * Conference Event.

   122          */

   123         RMobileConferenceCall::TMobileConferenceStatus iConfStatus;

   124 

   125          /**

   126          * Array of Call Monitors.Not Owned

   127          */

   128         RPointerArray<CMusCallMonitor>& iCallMonitorArray;

   129 

   130         /**

   131          * Monitors the conference call events. For example a particular call

   132          * which is in conference dropped will be reported as part of

   133          * conference event.

   134          */

   135         CMusCallConferenceEventMonitor* iConfCallEvent;

   136       

   137         MUS_UNITTEST( UT_CMusCallConferenceMonitor )        

   138         

   139     };

   140 

   141 #endif // MUSCALLCONFERENCEMONITOR_H