diff -r 22de2e391156 -r 20ac952a623c remotecontrol/remotecontrolfw/converterplugin/public/remconconverterplugin.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/remotecontrol/remotecontrolfw/converterplugin/public/remconconverterplugin.h Wed Oct 13 16:20:29 2010 +0300 @@ -0,0 +1,81 @@ +// 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 REMCONCONVERTERPLUGIN_H +#define REMCONCONVERTERPLUGIN_H + +#include +#include + +/** +The UID of the RemCon converter interface. Implementors of new converters are +implementing this interface. The converter interface is simply a means of +supplying implementations of the 'converter API' to RemCon. The converter API +may change over time, so this extension pattern is used. +*/ +const TInt KRemConConverterInterfaceUid = 0x10205C43; + +/** +Base class for RemCon converter plugins. +*/ +class CRemConConverterPlugin : public CBase + { +public: + /** + Constructor. + @param aImplementationUid The implemention UID. + @return Ownership of a new converter plugin. + */ + IMPORT_C static CRemConConverterPlugin* NewL(TUid aImplementationId); + + /** Destructor. */ + IMPORT_C ~CRemConConverterPlugin(); + +public: + /** + Called by RemCon server to get a pointer to an object which implements the + converter API with UID aUid. This is a mechanism for allowing future + change to the converter API without breaking BC in existing (non-updated) + converter plugins. + */ + virtual TAny* GetInterface(TUid aUid) = 0; + +protected: + /** Constructor + @param aObserver To be notified of the completion of requests. + @param aImplementationId Identifier of the concrete implementation. + */ + IMPORT_C CRemConConverterPlugin(); + +private: // owned + /** + UID set by ECOM when the instance is created. Used when the instance is + destroyed. + */ + TUid iInstanceId; + + /** + Pad for BC-friendly future change. + */ + TAny* iPad; + }; + +#endif // REMCONCONVERTERPLUGIN_H