--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/remotecontrol/remotecontrolfw/bearerplugin/public/remconbearerplugin.h Wed Oct 13 16:20:29 2010 +0300
@@ -0,0 +1,109 @@
+// Copyright (c) 2004-2009 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:
+//
+
+/**
+ @file
+ @publishedPartner
+ @released
+*/
+
+#ifndef REMCONBEARERPLUGIN_H
+#define REMCONBEARERPLUGIN_H
+
+#include <e32base.h>
+
+class MRemConBearerObserver;
+class TBearerParams;
+class TRemConAddress;
+
+/**
+The UID of the RemCon bearer interface. Implementors of new bearers are
+implementing this interface. The bearer interface is simply a means of
+supplying implementations of the 'bearer API' to RemCon. The bearer API may
+change over time, so this extension pattern is used.
+*/
+const TInt KRemConBearerInterfaceUid = 0x10204546;
+
+/**
+Base class for bearer plugins.
+*/
+class CRemConBearerPlugin : public CBase
+ {
+public: // used by RemCon to create and destroy bearer instances
+ /**
+ Constructor.
+ @param aParams Parameters from RemCon, used to initialise the
+ implementation.
+ @return Ownership of a new bearer plugin.
+ */
+ IMPORT_C static CRemConBearerPlugin* NewL(TBearerParams& aParams);
+
+ /** Destructor. */
+ IMPORT_C ~CRemConBearerPlugin();
+
+public:
+ /**
+ Called by RemCon server to get a pointer to an object which implements the
+ bearer API with UID aUid. This is a mechanism for allowing future change
+ to the bearer API without breaking BC in existing (non-updated) bearer
+ plugins.
+ @param aUid The UID of a bearer API
+ @return A pointer to an object which implements the interface identified
+ by aUid or NULL if the interface is not implemented.
+ */
+ virtual TAny* GetInterface(TUid aUid) = 0;
+
+ /**
+ Called by RemCon to query the bearer's implementation UID.
+ @return The bearer's implementation UID.
+ */
+ IMPORT_C TUid Uid() const;
+
+protected: // called by concrete bearer plugins
+ /**
+ Constructor
+ @param aParams Parameters from RemCon, used to initialise the
+ implementation.
+ */
+ IMPORT_C CRemConBearerPlugin(TBearerParams& aParams);
+
+ /**
+ Accessor for the observer.
+ @return The observer.
+ */
+ IMPORT_C MRemConBearerObserver& Observer();
+
+private: // unowned
+ MRemConBearerObserver& iObserver;
+
+private: // owned
+ /**
+ UID set by ECOM when the instance is created. Used when the instance is
+ destroyed.
+ */
+ TUid iInstanceId;
+
+ /**
+ Implementation UID of concrete instance.
+ */
+ const TUid iImplementationUid;
+
+ /**
+ Pad for BC-friendly future change.
+ */
+ TAny* iPad;
+ };
+
+#endif // REMCONBEARERPLUGIN_H