/*
* Copyright (c) 2004-2005 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:  Accessory handler.
*
*/



#ifndef CVTENGACCHANDLER_H
#define CVTENGACCHANDLER_H

//  INCLUDES
#include    <e32base.h>
#include    <AccPolAccessoryMode.h>
#include    <AccessoryServer.h>
#include    <AccessoryMode.h>

// FORWARD DECLARATIONS
class MVtEngAccessoryObserver;

// CLASS DECLARATION

/**
*  Accessory mode listener for video telephony.
*
*  @lib videoteleng
*  @since 3.0
*/
NONSHARABLE_CLASS( CVtEngAccessoryHandler ) : public CActive
    {
    public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        ¨* @return instance of CVtEngAccessoryHandler
        */
        static CVtEngAccessoryHandler* NewL( );
        
        /**
        * Destructor.
        */
        virtual ~CVtEngAccessoryHandler();

    public: // From base classes.

        /**
        * Handles accessory mode changes.
        */
        void RunL();

        /**
        * Cancels accessory mode monitoring.
        */
        void DoCancel();

        /**
        * Handles exceptions in RunL.
        * @param aError error code.
        * @return error code.
        */
        TInt RunError( TInt aError );

    public: // New functions

        /**
        * Sets a new listener interested in accessory changes.
        * @param aObserver call back interface for notifications.
        */
        void RegisterObserverL( MVtEngAccessoryObserver* aObserver );

        /**
        * Unregisters a listener.
        * NOTE, do not call this from NotifyObserversL!
        * @param aObserver call back interface for notifications.
        */
        void RemoveObserver( MVtEngAccessoryObserver* aObserver );

        /**
        * Returns current accessory mode.
        * @param aAccessoryMode accessory mode in return
        * @return Symbian error code
        */
        TInt AccessoryMode( TAccPolAccessoryMode& aAccessoryMode ) const;

    private: // New functions.
    
        /**
        * Removes all observers
        */
        void RemoveAllObservers();

        /**
        * Sets object active and renews subscription.
        */
        void StartListening();

        /**
        * Notifies all registered listeners.
        */
        void NotifyObserversL();

    private: // Constructors.

        /**
        * C++ default constructor.
        */
        CVtEngAccessoryHandler();

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL( );
    
    private:    // Data
        // Current accessory mode.
        TAccPolAccessoryMode iCurrentAccessoryMode;

        // Owned array of accessory mode observers.
        RPointerArray< MVtEngAccessoryObserver > iAccessoryObservers;

        // Owned accessory server session.
        RAccessoryServer iAccessoryServer;

        // Owned accessory mode subsession.
        RAccessoryMode iAccessoryMode;

        // Accessory mode structure.
        TAccPolAccessoryMode iMode;

    };

#endif      // CVTENGACCHANDLER_H
// End of File