// Copyright (c) 2007-2010 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:
// Base class for activation classes
//

#ifndef __TRACECOREACTIVATIONBASE_H__
#define __TRACECOREACTIVATIONBASE_H__


// Include files
#include "TraceCoreSubscriber.h"
#include "TraceCoreActivation.h"

//forward declarations
class DMutex;

/**
 * Base class for activation objects. This extends the subscriber base class to receive activation updates
 */
NONSHARABLE_CLASS( DTraceCoreActivationBase ) : public DTraceCoreSubscriber, public MTraceCoreActivation
    {
public:

    /**
     * Constructor
     */
    DTraceCoreActivationBase();
    
    /**
     * Destructor
     */
    virtual ~DTraceCoreActivationBase();
    
    /**
     * Registers an activation notification interface
     * 
     * @param aNotification the notification interface
     */
    TInt RegisterActivationNotification( MTraceCoreActivationNotification& aNotification );
    
protected:

    /**
     * Subscribes to message ID and registers to activation interface list
     * 
     * @param aMessageID the message id to be subscribed
     */         
    TInt Init( TUint32 aMessageId );

    /**
     * Subscribes to message ID and registers to activation interface list
     * 
     * @param aMessageID the message id to be subscribed
     */
    TInt SubscribeMessage( TUint32 aMessageId, TMessageHeaderFormat aMsgFormat );

    /**
     * Sends notification to TraceCore internal activation notification interfaces
     * 
     * @param aFromSettings ETrue if activation was due to settings read, EFalse if from some other source
     * @param aComponentId Component ID of the activation
     */
    void NotifyInternalActivation( TBool aFromSettings, TUint32 aComponentId );
    
    /**
     * Send response
     * 
     * @param aMessage Response message
     */
    void SendResponse( TTraceMessage &aMessage );
    
    /**
     * Prevent read-check to internal structures (fast lock).
     */
    inline TInt ReadLock();
    
    /**
     * Restore read-access to internal structures.
     */
    inline void ReadUnlock(TInt aIrqLevel);
    
    
protected: //data
    
    /**
     * Lock used in 'critical path' where performance is very important.
     * It is used in those routines where structures are checked and not modified.
     */
#if defined(__SMP__)
    TSpinLock   iActivationReadLock;
#endif
    
    /**
     * Used to store Irq level between spin lock/unlock operation.
     */
    TInt iIrqLevel;
    
private:

    /**
     * Array of activation notification interfaces
     */
    RPointerArray< MTraceCoreActivationNotification > iActivationNotification;
    };


#include "TraceCoreActivationBase.inl"


#endif /* __TRACECOREACTIVATIONBASE_H__ */