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

 #define REMCONABSVOLCONTROLLER_H

 #include <e32base.h>

 #include <remcon/remconinterfacebase.h>

 #include <remcon/remconinterfaceif.h>

 class MRemConAbsVolControllerObserver;

 class CRemConInterfaceSelector;

 /**

 Client-instantiable type supporting sending AbsVol API responses.

 */

 NONSHARABLE_CLASS(CRemConAbsVolController) : 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 CRemConAbsVolController, owned by the interface selector.

 	*/

 	IMPORT_C static CRemConAbsVolController* NewL(CRemConInterfaceSelector& aInterfaceSelector, 

 		MRemConAbsVolControllerObserver& aObserver);

 	/** Destructor. */

 	IMPORT_C ~CRemConAbsVolController();

 public:

 	/**

 	Sends a 'get absolute volume' command. The absolute volume will be 

 	returned in response(s) via the observer interface.

 	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 aNumRemotes The number of remotes to which the command was sent.

 	*/

 	IMPORT_C void GetAbsoluteVolume(TRequestStatus& aStatus, TUint& aNumRemotes);

 	/**

 	Sends a 'set absolute volume' command. The volume is set to aAbsVol, on a 

 	range of zero to aMaxVol. Any responses will be returned via the observer 

 	interface.

 	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 aAbsVol The relative volume.

 	@param aMaxVol The maximum against which aAbsVol is relative.

 	@param aNumRemotes The number of remotes to which the command was sent.

 	*/

 	IMPORT_C void SetAbsoluteVolume(TRequestStatus& aStatus, TUint aAbsVol, TUint aMaxVol, TUint& aNumRemotes);

 private:

 	/** 

 	Constructor.

 	@param aInterfaceSelector The interface selector.

 	@param aObserver The observer of this interface.

 	*/

 	CRemConAbsVolController(CRemConInterfaceSelector& aInterfaceSelector, 

 		MRemConAbsVolControllerObserver& aObserver);

 private: // from CRemConInterfaceBase

 	TAny* GetInterfaceIf(TUid aUid);

 private: // from MRemConInterfaceIf

 	void MrcibNewMessage(TUint aOperationId, const TDesC8& aData);

 private: // unowned

 	MRemConAbsVolControllerObserver& iObserver;

 private: // owned

 	static const TUint KMaxOperationDataSize = 0x20;

 	TBuf8<KMaxOperationDataSize> iOutData;

 	};

 #endif // REMCONABSVOLCONTROLLER_H