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 CSPEtelDtmfMonitor

    15 *

    16 */

    17 

    18 

    19 #ifndef CSPETELDTMFMONITOR_H

    20 #define CSPETELDTMFMONITOR_H

    21 

    22 #include <e32base.h>

    23 #include <etelmm.h>

    24 #include <rmmcustomapi.h>

    25 

    26 

    27 class CSPCall;

    28 class CSPDTMFProvider;

    29 

    30 

    31 

    32 /**

    33 * Monitors ETel for DTMF events.

    34 *

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

    36 *  line capabilites are not monitored.

    37 *

    38 *  @lib csplugin.dll

    39 *  @since S60 v3.2

    40 */

    41 class CSPEtelDtmfMonitor: public CActive

    42     {

    43     

    44     public: //Constructors and descructor

    45     

    46     

    47         /**

    48         * Two-phased constructing for the monitor.

    49         *

    50         * @param aObserver the observer for getting notification

    51         * @param aMmCustom Custom API handle

    52         */

    53         static CSPEtelDtmfMonitor* NewL( 

    54                 CSPDTMFProvider& aObserver,

    55                 RMmCustomAPI& aMmCustom );

    56 

    57         /**

    58         * C++ default destructor

    59         */

    60         virtual ~CSPEtelDtmfMonitor( );

    61 

    62         /**

    63         * Start monitoring call events

    64         * @since S60 3.2

    65         */

    66         void StartMonitoring();

    67     

    68     protected: // From CActive

    69         /**

    70         * From CActive

    71         * RunL

    72         * @since S60 3.2

    73         */

    74         void RunL();

    75         

    76         /**

    77         * From CActive

    78         * Cancels the monitor

    79         * @since S60 3.2

    80         */

    81         void DoCancel();

    82 

    83     private:

    84         /**

    85         * C++ default constructor

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

    87         * @param aMmCustom Custom API handle

    88         */

    89         CSPEtelDtmfMonitor( CSPDTMFProvider& aObserver,

    90                             RMmCustomAPI& aMmCustom );

    91                                           

    92     private: // data

    93         /**

    94         * Forwards events.

    95         */

    96         CSPDTMFProvider& iObserver;

    97        

    98         /**

    99         * Event data. Updated when event occurs.

   100         */

   101         RMmCustomAPI::TDtmfInfo      iEventData;

   102         

   103         /**

   104         * Custom API reference.

   105         */

   106         RMmCustomAPI& iMmCustom;

   107         

   108     };

   109     

   110 #endif // CSPETELDTMFMONITOR_H