diff -r a151135b0cf9 -r aa2539c91954 tracesrv/tracecore/btrace_handler/inc/TraceCoreNotifier.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/tracesrv/tracecore/btrace_handler/inc/TraceCoreNotifier.h Fri Oct 08 14:56:39 2010 +0300 @@ -0,0 +1,143 @@ +// 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: +// Registers / unregisters notification receivers and send notifications +// to them when needed. +// + +#ifndef __TRACECORENOTIFIER_H__ +#define __TRACECORENOTIFIER_H__ + + +// Include files +#include +#include + +// Forward declarations +class MTraceCoreNotificationReceiver; + +/** + * Notification receiver item + */ +NONSHARABLE_CLASS( TNotificationReceiverItem ) + { +public: + + /** + * Component ID + */ + TUint32 iComponentID; + + /** + * Group ID + */ + TUint32 iGroupID; + + /** + * The notification receiver associated with the component id and group id + */ + MTraceCoreNotificationReceiver* iReceiver; + }; + + +/** + * Notification receiver receives subscriptions and delegates messages to them + */ +NONSHARABLE_CLASS( DTraceCoreNotifier ) : public DBase + { +public: + + /** + * Constructor + */ + DTraceCoreNotifier(); + + /** + * Destructor + */ + ~DTraceCoreNotifier(); + + /** + * Register notification receiver + * + * @param aItem The properties of the notification receiver + */ + TInt RegisterNotificationReceiver( TNotificationReceiverItem& aItem ); + + /** + * Unregister notification receiver + * + * @param aItem The properties of the notification receiver + */ + void UnregisterNotificationReceiver( TNotificationReceiverItem& aItem ); + + /** + * Unregister all traces of given notification receiver + * + * @param aNotificationReceiver The notification receiver to be unregistered + */ + void UnregisterNotificationReceiver( MTraceCoreNotificationReceiver& aNotificationReceiver ); + + /** + * Get defined component's registered group IDs + * + * @param aComponentID The component id + * @param aGroupIDs Array for registered group IDs + */ + void GetComponentRegisteredGroupIDs( TUint32 aComponentID, RArray< TUint >& aGroupIDs ); + + /** + * Callback when trace is activated + * + * @param aComponentID The component id + * @param aGroupId The group id + */ + void TraceActivated( TUint32 aComponentId, TUint16 aGroupId ); + + /** + * Callback when trace is deactivated + * + * @param aComponentID The component id + * @param aGroupId The group id + */ + void TraceDeactivated( TUint32 aComponentId, TUint16 aGroupId ); + + /** + * Callback when there is a trace error + * + * @param aComponentId The component ID + * @param aGroupId The group ID + * @param aError The reason for error + */ + void TraceError( TUint32 aComponentId, TUint32 aGroupId, TInt aError ); + +private: + + /** + * Active subscriptions + */ + RArray< TNotificationReceiverItem > iNotificationReceiverItems; + + /** + * Notifies immediately if group was activated + * + * @param aComponentID The component id + * @param aGroupId The group id + */ + void NotifyImmediately( TUint32 aComponentId, TGroupId aGroupId ); + + }; + +#endif + +// End of File