diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/remcontrackinfotarget.h --- 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 +#include +#include + +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 iOutData; + + // not used by this class, but required for calling RRemCon::Send ... + TUint iNumRemotes; + + }; + +#endif // REMCONTRACKINFOTARGET_H