// 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