/*

* Copyright (c) 2006-2007 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:    Class definition for the MCC QoS Event Monitor

*

*/

#ifndef MCCQOSEVENTMONITOR_H

#define MCCQOSEVENTMONITOR_H

// INCLUDES

#include <e32base.h>

#include <es_sock.h>

// FORWARD DECLARATIONS

class MMccQosEventObserver;

// CLASS DECLARATION

/**

 *  CMccQosEventMonitor for handling events from RSubConnection

 *

 *  CMccQosEventMonitor receives subconnection(Qos) events from RSubConnection

 *  class. Events are delivered to MCC subcontroller as callbacks.

 *

 *  @lib mccqosplugin.lib

 *  @since S60 3.1

 */

NONSHARABLE_CLASS( CMccQosEventMonitor ) : public CActive

    {

#ifdef TEST_EUNIT

    friend class UT_CMccQosEventMonitor;

#endif

public:

    /**

     * Create a CMccQosEventMonitor object using two phase construction,

     * and return a pointer to the created object.

     *

     * @since S60 3.1

     * @param aObserver observer to asynchronous completion

     * @param handle to RSubConnection object

     * @return  Instance of class interface

     */

    static CMccQosEventMonitor* NewL( MMccQosEventObserver& aObserver, 

        RSubConnection& aSubConnection );

    /**

     * Create a CMccQosEventMonitor object using two phase construction,

     * and return a pointer to the created object.

     *

     * @since S60 3.1

     * @param aObserver observer to asynchronous completion

     * @param handle to RSubConnection object

     * @return  Instance of class interface

     */

    static CMccQosEventMonitor* NewLC( MMccQosEventObserver& aObserver, 

        RSubConnection& aSubConnection );

    /**

     * Destructor

     *

     * @return void

     */

    virtual ~CMccQosEventMonitor();

protected: // from CActive

    /**

     * Callback function. Invoked to handle responses from the server.

     *

     * @return void

     */

    void RunL();

    /**

     * Cancel any outstanding operation.

     *

     * @return void

     */

    void DoCancel();

    /**

     * RunL error handling

     *

     * @return TInt System-wide error code

     */

    TInt RunError( TInt aError );

private:

    /**

     * Perform the first phase of two phase construction.

     *

     * @since S60 3.1

     * @param aObserver observer to asynchronous completion

     * @param handle to RSubConnection object

     * @return void

     */

    CMccQosEventMonitor( MMccQosEventObserver& aObserver, 

        RSubConnection& aSubConnection );

    /**

     * By default Symbian 2nd phase constructor is private.

     *

     * @since S60 v3.1

     * @return void

     */

    void ConstructL();

    /**

     * Set active object active and start listening for QoS events

     * from RSubConnection.

     *

     * @since S60 3.1

     * @return void

     */

    void StartListenL();

private: // data

    /**

     * Observer to report QoS status/error information

     */

    MMccQosEventObserver& iEventObserver;

    /**

     * Buffer for QoS events

     */

    TNotificationEventBuf iQoSNotifBuffer;

    /**

     * Reference to current subconnection Handle

     */

    RSubConnection& iSubConnection;

    /**

     * Last error reported from RSubConnection channel

     */

    TInt iLastError;

    };

#endif      // MCCQOSEVENTMONITOR_H

// End of File