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 MUSCALLCONFERENCEEVENTMONITOR_H

    21 #define MUSCALLCONFERENCEEVENTMONITOR_H

    22 

    23 #include "musunittesting.h"

    24 #include "mussesseioninformationapi.h"

    25 #include <etelmm.h>

    26 #include <e32base.h>

    27 

    28 #include "muscallmonitor.h"

    29 

    30 /**

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

    32  *

    33  * @lib musaoplugin.dll

    34  */

    35 class CMusCallConferenceEventMonitor : public CActive

    36     {

    37 

    38     public: 

    39         /**

    40          * Two-phased constructor. Leaves on failure.

    41          * aCall is not owned.

    42          * @return CMusCallConferenceEventMonitor object.

    43          */

    44         static CMusCallConferenceEventMonitor* NewL(

    45                                RMobilePhone& aPhone, RMobileLine& aLine,

    46                                RPointerArray<CMusCallMonitor>& aCallMonitorArray);

    47                                 

    48         /**

    49          * Destructor.

    50          */

    51         ~CMusCallConferenceEventMonitor();             

    52 

    53     private:

    54 

    55         /**

    56          * C++ constructor.

    57          */

    58         CMusCallConferenceEventMonitor(

    59                              RMobileLine& aLine,

    60                              RPointerArray<CMusCallMonitor>& aCallMonitorArray );

    61 

    62         /**

    63          * Symbian 2nd-phase constructor.

    64          */

    65         void ConstructL(RMobilePhone& aPhone);       

    66 

    67         /**

    68           * Sets the multimediasharing propery key value

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

    70           */

    71         void SetStateL(NMusSessionInformationApi::TMusCallEvent aVal);

    72 

    73         /**

    74           * Add / Remove Call Monitors based on Mus criteria          

    75           */

    76         void MonitorCallL();

    77 

    78     private:

    79 

    80         /**

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

    82          */

    83         void RunL();

    84         

    85         /**

    86          * cancels of an outstanding request

    87          */        

    88         void DoCancel();

    89 

    90          /*

    91          * Handles a leave occurring in the request completion 

    92          * event handler RunL().

    93          * Always return KErrNone since it must handle this error

    94          * if it comes to this place.

    95          */

    96         TInt RunError( TInt aError );

    97 

    98 

    99     private: 

   100 

   101         /**

   102          * Reference of RMobileLine.Not Owned.

   103          */

   104         

   105         RMobileLine& iLine;

   106        

   107         /**

   108          * Reference of RMobileConferenceCall.

   109          */

   110         RMobileConferenceCall iConfCall;

   111 

   112         /**

   113          * Conference Event.

   114          */

   115         RMobileConferenceCall::TMobileConferenceEvent iConfEvent;

   116 

   117          /**

   118          * Array of Call Monitors.Not Owned

   119          */

   120         RPointerArray<CMusCallMonitor>& iCallMonitorArray;  

   121 

   122         /**

   123          * Name of the call affected by this event

   124          */

   125         TName iCallName;      

   126       

   127         MUS_UNITTEST( UT_CMusCallConferenceEventMonitor )        

   128         

   129     };

   130 

   131 #endif // MUSCALLCONFERENCEEVENTMONITOR_H