tracesrv/tracecore/btrace_handler/inc/TraceCoreNotifier.h
changeset 56 aa2539c91954
--- /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 <kernel/kernel.h>
+#include <opensystemtrace_types.h>
+
+// 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