epoc32/include/remconmediainformationtarget.h
branchSymbian2
changeset 2 2fe1408b6811
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/epoc32/include/remconmediainformationtarget.h	Tue Mar 16 16:12:26 2010 +0000
@@ -0,0 +1,128 @@
+// Copyright (c) 2007-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 REMCONMEDIAINFORMATIONTARGET_H
+#define REMCONMEDIAINFORMATIONTARGET_H
+
+#include <e32base.h>
+#include <remcon/remconinterfacebase.h>
+#include <remcon/remconinterfaceif.h>
+#include <remcon/mediainformation.h>
+#include <remconmediainformationtargetobserver.h>
+
+class CRemConInterfaceSelector;
+
+NONSHARABLE_CLASS(CRemConMediaInformationQueuedMessage): public CBase
+	{
+public:
+	static CRemConMediaInformationQueuedMessage* NewL(const TDesC8& aData);
+	~CRemConMediaInformationQueuedMessage();
+	
+	const TDesC8& Data();
+private:
+	CRemConMediaInformationQueuedMessage();
+	void ConstructL(const TDesC8& aData);
+public:
+	TSglQueLink iLink;
+private:
+	RBuf8 iData;
+	};
+
+/**
+Client-instantiable type supporting sending media information.
+*/
+NONSHARABLE_CLASS(CRemConMediaInformationTarget) : 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 CRemConMediaInformationTarget, owned by the interface selector.
+	*/
+	IMPORT_C static CRemConMediaInformationTarget* NewL(CRemConInterfaceSelector& aInterfaceSelector, 
+		MRemConMediaInformationTargetObserver& aObserver);
+	
+	/** Destructor */
+	IMPORT_C ~CRemConMediaInformationTarget();
+
+public:
+	/** Called by the client in response to a MrcmitoGetCurrentlyPlayingMetadata() call.
+	Each call provides one of the attribute values requested.
+	This is repeatedly called until all attributes requested have been supplied and then followed by Completed().
+	@param aAttribute The ID of the attribute supplied.
+	@param aValue A reference to a descriptor containing the attribute data.  
+	This must be valid until Completed() has been called. 
+	@see MRemConMediaInformationTargetObserver::MrcmitoGetCurrentlyPlayingMetadata()
+	@see CRemConMediaInformationTarget::Completed()
+	*/
+	IMPORT_C TInt AttributeValue( TMediaAttributeId aAttributeId, TDesC8& aAttributeData);
+	
+	/** Signal that all attributes requested by MrcmitoGetCurrentlyPlayingMetadata() have been supplied
+	using the AttributeValue() method.
+	@see MRemConMediaInformationTargetObserver::MrcmitoGetCurrentlyPlayingMetadata()
+	@see CRemConMediaInformationTarget::AttributeValue()
+	*/
+	IMPORT_C void Completed();
+	
+private:
+	/** 
+	Constructor.
+	@param aInterfaceSelector The interface selector.
+	@param aObserver The observer of this interface.
+	*/
+	CRemConMediaInformationTarget(CRemConInterfaceSelector& aInterfaceSelector, 
+		MRemConMediaInformationTargetObserver& aObserver);
+
+	void ConstructL();
+
+private: // from CRemConInterfaceBase
+	TAny* GetInterfaceIf(TUid aUid);
+
+private: // from MRemConInterfaceIf
+	void MrcibNewMessage(TUint aOperationId, const TDesC8& aData);
+
+private: // utility
+	void SendError(TInt aError);
+	void ProcessMessage(const TDesC8& aData);
+	
+	static int NextMessageCb(TAny* aThis);
+	void DoNextMessage();
+private: // unowned
+	MRemConMediaInformationTargetObserver& iObserver;
+
+private: // owned
+	RRemConGetElementAttributesResponse iResponse;
+
+	RArray<TMediaAttributeId>  	iMediaAttributeIDs;
+	TMediaAttributeIter 		iAttributeIterator;
+	TBool						iInProgress;
+	TSglQue<CRemConMediaInformationQueuedMessage> iMsgQueue;
+	
+	CAsyncCallBack* iNextMessageCallBack;
+	};
+
+#endif // REMCONMEDIAINFORMATIONTARGET_H