--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/remotecontrol/remotecontrolfw/converterplugin/public/remconconverterinterface.h Wed Oct 13 16:20:29 2010 +0300
@@ -0,0 +1,89 @@
+// 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 REMCONCONVERTERINTERFACE_H
+#define REMCONCONVERTERINTERFACE_H
+
+#include <e32base.h>
+#include <remcon/messagetype.h>
+
+/**
+The UID of the converter API. If the converter API ever has to change, a new
+UID and associated M class will be created. New implementations of
+CRemConConverterPlugin may implement the new API. Old (non-updated) converters
+will still work as long as RemCon supports the old API.
+*/
+const TInt KRemConConverterInterface1 = 0x1020D40A;
+
+/**
+Mixin for the converter API.
+*/
+class MRemConConverterInterface
+ {
+public:
+ /**
+ Called by the server to get the converter to convert from the interface
+ (API) format to the bearer-specific format.
+ @param aInterfaceUid The interface UID.
+ @param aOperationId Operation ID.
+ @param aData Data associated with the operation.
+ @param aMsgType The type of the message.
+ @param aBearerData Converted output.
+ */
+ virtual TInt InterfaceToBearer(TUid aInterfaceUid,
+ TUint aOperationId,
+ const TDesC8& aData,
+ TRemConMessageType aMsgType,
+ TDes8& aBearerData) const = 0;
+
+ /**
+ Called by the server to get the converter to convert from the bearer-
+ specific format to the interface (API) format.
+ @param aBearerData Bearer input.
+ @param aInterfaceUid The interface UID.
+ @param aOperationId Operation ID.
+ @param aMsgType The type of the message.
+ @param aData Data associated with the operation.
+ */
+ virtual TInt BearerToInterface(const TDesC8& aBearerData,
+ TUid& aInterfaceUid,
+ TUint& aOperationId,
+ TRemConMessageType& aMsgType,
+ TDes8& aData) const = 0;
+
+ /**
+ Called by the server to find out if this converter converts between the formats
+ of this interface and bearer.
+ @param aInterfaceUid The interface UID.
+ @param aBearerUid The bearer UID.
+ */
+ virtual TBool SupportedUids(const TUid& aInterfaceUid, const TUid& aBearerUid) const = 0;
+
+ /**
+ Called by the server to find out if this converter converts between the formats
+ of this bearer interface and RemCon interface.
+ @param aInterfaceData The identifier of this interface in a bearer defined format.
+ @param aBearerUid The bearer UID.
+ */
+ virtual TBool SupportedInterface(const TDesC8& aInterfaceData, const TUid& aBearerUid) const = 0;
+ };
+
+#endif // REMCONCONVERTERINTERFACE_H