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 CSPEtelCallCapsMonitor

    15 *

    16 */

    17 

    18 

    19 #ifndef CSPETELCALLCAPSMONITOR_H

    20 #define CSPETELCALLCAPSMONITOR_H

    21 

    22 #include <e32base.h>

    23 #include <etelmm.h>

    24 

    25 

    26 class MCSPCallObserver;

    27 

    28 

    29 /**

    30 * Monitors single ETel RMobileCall for call capss.

    31 *

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

    33 *  line capabilites are not monitored.

    34 *

    35 *  @lib csplugin.dll

    36 *  @since S60 v3.2

    37 */

    38 class CSPEtelCallCapsMonitor: public CActive

    39     {

    40     

    41     public: //Constructors and descructor

    42     

    43     

    44         /**

    45         * Two-phased constructing for the monitor.

    46         *

    47         * @param aObserver the observer for getting notification

    48         * @param aCall the line to monitor

    49         */

    50         static CSPEtelCallCapsMonitor* NewL( 

    51                 MCSPCallObserver& aObserver,

    52                 RMobileCall& aCall );

    53 

    54         /**

    55         * C++ default destructor

    56         */

    57         virtual ~CSPEtelCallCapsMonitor( );

    58 

    59         /**

    60         * Start monitoring call capss

    61         * @since S60 3.2

    62         */

    63         void StartMonitoring();

    64         

    65         /**

    66          * Fetches call control caps.

    67          * @return call control caps flags.

    68          */

    69         TUint32 FetchCallControlCapsL();

    70     

    71     protected: // From CActive

    72         /**

    73         * From CActive

    74         * RunL

    75         * @since S60 3.2

    76         */

    77         void RunL();

    78         

    79         /**

    80         * From CActive

    81         * Cancels the monitor

    82         * @since S60 3.2

    83         */

    84         void DoCancel();

    85 

    86     private:

    87         /**

    88         * C++ default constructor

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

    90         * @param aCall the line associated with the call

    91         */

    92         CSPEtelCallCapsMonitor( MCSPCallObserver& aObserver,

    93                             RMobileCall& aCall );

    94                                           

    95         /**

    96         * Constructs the monitor in the second phase.

    97         */

    98         void ConstructL();

    99 

   100         

   101     private: // data

   102         /**

   103         * Forwards caps change.

   104         */

   105         MCSPCallObserver& iObserver;

   106        

   107         /**

   108         * Call that is being observed.

   109         */

   110         RMobileCall& iCall;

   111         

   112         /**

   113         * Call capabilities.

   114         */

   115         RMobileCall::TMobileCallCapsV1 iCaps;

   116         RMobileCall::TMobileCallCapsV1Pckg iCapsPckg;

   117       

   118 

   119         

   120     };

   121 

   122 #endif // CSPETELCALLCAPSMONITOR_H