remotecontrol/remotecontrolfw/client/extapi1/public/remcontrackinfotarget.h
changeset 51 20ac952a623c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/remotecontrol/remotecontrolfw/client/extapi1/public/remcontrackinfotarget.h	Wed Oct 13 16:20:29 2010 +0300
@@ -0,0 +1,138 @@
+// 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
+ @publishedAll
+ @released
+*/
+
+#ifndef REMCONTRACKINFOTARGET_H
+#define REMCONTRACKINFOTARGET_H
+
+#include <e32base.h>
+#include <remcon/remconinterfacebase.h>
+#include <remcon/remconinterfaceif.h>
+
+class MRemConTrackInfoTargetObserver;
+class CRemConInterfaceSelector;
+
+/**
+Client-instantiable type supporting sending TrackInfo API responses.
+*/
+NONSHARABLE_CLASS(CRemConTrackInfoTarget) : public CRemConInterfaceBase, 
+								            public MRemConInterfaceIf
+	{
+public:
+	/**
+	Factory function.
+	@param aInterfaceSelector The interface selector. The client must have 
+	created one of these first.
+	@param aObserver The observer of this interface.
+	@return A new CRemConTrackInfoTarget, owned by the interface selector.
+	*/
+	IMPORT_C static CRemConTrackInfoTarget* NewL(CRemConInterfaceSelector& aInterfaceSelector, 
+		MRemConTrackInfoTargetObserver& aObserver);
+	
+	/** Destructor. */
+	IMPORT_C ~CRemConTrackInfoTarget();
+
+public:
+	/**
+	Sends a response to a 'get track name' command.
+	Only one response per target session can be outstanding at any one time.
+	@param aStatus Used by RemCon to indicate completion of the send request.
+	@param aTrackName The track name.
+	@param aError The response error.
+	@panic USER 23, if the length of aTrackName is greater than 58 Characters. 
+	*/
+	IMPORT_C void GetTrackNameResponse(TRequestStatus& aStatus, 
+		const TDesC& aTrackName, 
+		TInt aError);
+
+	/**
+	Sends a response to a 'get artist' command.
+	Only one response per target session can be outstanding at any one time.
+	@param aStatus Used by RemCon to indicate completion of the send request.
+	@param aArtist The artist.
+	@param aError The response error.
+	@panic USER 23, if the length of aArtist is greater than 58 Characters. 
+	*/
+	IMPORT_C void GetArtistResponse(TRequestStatus& aStatus, 
+		const TDesC& aArtist, 
+		TInt aError);
+
+	/**
+	Sends a response to a 'get track duration' command.
+	Only one response per target session can be outstanding at any one time.
+	@param aStatus Used by RemCon to indicate completion of the send request.
+	@param aDuration The duration.
+	@param aError The response error.
+	*/
+	IMPORT_C void GetTrackDurationResponse(TRequestStatus& aStatus, 
+		const TTime& aDuration, 
+		TInt aError);
+
+/**
+The following section of code is included to allow internal back to back 
+testing of this component within Symbian Software Ltd. It will only be 
+compiled in specially configured test builds. It will never be available 
+in any release and so should never be used outside of Symbian owned test 
+code.
+*/
+#ifdef SYMBIAN_ENABLE_TRACKINFO_BACKTOBACK_TEST_FUNCT
+	/**
+	This method is only available in specially configured test builds and will 
+	not be found in any released code.
+	*/
+	IMPORT_C void SetTrackNameResponse(TRequestStatus& aStatus,
+		TInt aError);
+
+private:
+	/**
+	This method is only available in specially configured test builds and will 
+	not be found in any released code.
+	*/
+	void HandleSetTrackName(const TDesC8& aData);		
+#endif //SYMBIAN_ENABLE_TRACKINFO_BACKTOBACK_TEST_FUNCT
+
+private:
+	/** 
+	Constructor.
+	@param aInterfaceSelector The interface selector.
+	@param aObserver The observer of this interface.
+	*/
+	CRemConTrackInfoTarget(CRemConInterfaceSelector& aInterfaceSelector, 
+		MRemConTrackInfoTargetObserver& aObserver);
+
+private: // from CRemConInterfaceBase
+	TAny* GetInterfaceIf(TUid aUid);
+
+private: // from MRemConInterfaceIf
+	void MrcibNewMessage(TUint aOperationId, const TDesC8& aData);
+
+private: // unowned
+	MRemConTrackInfoTargetObserver& iObserver;
+
+private: // owned
+	// For operation-specific data.
+	TBuf8<KMaxName> iOutData;
+	
+	// not used by this class, but required for calling RRemCon::Send ...
+	TUint iNumRemotes;
+
+	};
+
+#endif // REMCONTRACKINFOTARGET_H