diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/remcontrackinfocontroller.h --- a/epoc32/include/remcontrackinfocontroller.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/remcontrackinfocontroller.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,137 @@ -remcontrackinfocontroller.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 REMCONTRACKINFOCONTROLLER_H +#define REMCONTRACKINFOCONTROLLER_H + +#include +#include +#include + +class MRemConTrackInfoControllerObserver; +class CRemConInterfaceSelector; + +/** +Client-instantiable type supporting sending TrackInfo API commands. +*/ +NONSHARABLE_CLASS(CRemConTrackInfoController) : 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 CRemConTrackInfoController, owned by the interface selector. + */ + IMPORT_C static CRemConTrackInfoController* NewL(CRemConInterfaceSelector& aInterfaceSelector, + MRemConTrackInfoControllerObserver& aObserver); + + /** Destructor. */ + IMPORT_C ~CRemConTrackInfoController(); + +public: + /** + Sends a 'set track name' command. + Only one command per controller 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 aNumRemotes On success, will contain the number of remotes the + command was sent to. + @panic USER 23, if the length of aTrackName is greater than 58 Characters. + */ + IMPORT_C void SetTrackName(TRequestStatus& aStatus, const TDesC& aTrackName, TUint& aNumRemotes); + +/** +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 GetTrackName(TRequestStatus& aStatus, TUint& aNumRemotes); + + /** + This method is only available in specially configured test builds and will + not be found in any released code. + @internalTechnology + */ + IMPORT_C void GetArtist(TRequestStatus& aStatus, TUint& aNumRemotes); + + /** + This method is only available in specially configured test builds and will + not be found in any released code. + @internalTechnology + */ + IMPORT_C void GetTrackDuration(TRequestStatus& aStatus, TUint& aNumRemotes); + +private: + /** + This method is only available in specially configured test builds and will + not be found in any released code. + */ + void HandleGetTrackNameResponse(TInt aError, const TDesC8& aData); + + /** + This method is only available in specially configured test builds and will + not be found in any released code. + */ + void HandleGetArtistResponse(TInt aError, const TDesC8& aData); + + /** + This method is only available in specially configured test builds and will + not be found in any released code. + */ + void HandleGetTrackDurationResponse(TInt aError, const TDesC8& aData); +#endif //SYMBIAN_ENABLE_TRACKINFO_BACKTOBACK_TEST_FUNCT + +private: + /** + Constructor. + @param aInterfaceSelector The interface selector. + @param aObserver The observer of this interface. + */ + CRemConTrackInfoController(CRemConInterfaceSelector& aInterfaceSelector, + MRemConTrackInfoControllerObserver& aObserver); + +private: // from CRemConInterfaceBase + TAny* GetInterfaceIf(TUid aUid); + +private: // from MRemConInterfaceIf + void MrcibNewMessage(TUint aOperationId, const TDesC8& aData); + +private: // unowned + MRemConTrackInfoControllerObserver& iObserver; + +private: // owned + TBuf8 iOutData; + }; + +#endif // REMCONTRACKINFOCONTROLLER_H