--- a/epoc32/include/remcontrackinfotarget.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/remcontrackinfotarget.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,141 @@
-remcontrackinfotarget.h
+// 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.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.
+ @internalTechnology
+ */
+ 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