williamr@2: // Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@2: // 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
williamr@2: // which accompanies this distribution, and is available
williamr@2: // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: //
williamr@2: // Initial Contributors:
williamr@2: // Nokia Corporation - initial contribution.
williamr@2: //
williamr@2: // Contributors:
williamr@2: //
williamr@2: // Description:
williamr@2: //
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2:  @file
williamr@2:  @publishedAll
williamr@2:  @released
williamr@2: */
williamr@2: 
williamr@2: #ifndef REMCONABSVOLCONTROLLER_H
williamr@2: #define REMCONABSVOLCONTROLLER_H
williamr@2: 
williamr@2: #include <e32base.h>
williamr@2: #include <remcon/remconinterfacebase.h>
williamr@2: #include <remcon/remconinterfaceif.h>
williamr@2: 
williamr@2: class MRemConAbsVolControllerObserver;
williamr@2: class CRemConInterfaceSelector;
williamr@2: 
williamr@2: /**
williamr@2: Client-instantiable type supporting sending AbsVol API responses.
williamr@2: */
williamr@2: NONSHARABLE_CLASS(CRemConAbsVolController) : public CRemConInterfaceBase, 
williamr@2: 								             public MRemConInterfaceIf
williamr@2: 	{
williamr@2: public:
williamr@2: 	/**
williamr@2: 	Factory function.
williamr@2: 	@param aInterfaceSelector The interface selector. The client must have 
williamr@2: 	created one of these first.
williamr@2: 	@param aObserver The observer of this interface.
williamr@2: 	@return A new CRemConAbsVolController, owned by the interface selector.
williamr@2: 	*/
williamr@2: 	IMPORT_C static CRemConAbsVolController* NewL(CRemConInterfaceSelector& aInterfaceSelector, 
williamr@2: 		MRemConAbsVolControllerObserver& aObserver);
williamr@2: 	
williamr@2: 	/** Destructor. */
williamr@2: 	IMPORT_C ~CRemConAbsVolController();
williamr@2: 
williamr@2: public:
williamr@2: 	/**
williamr@2: 	Sends a 'get absolute volume' command. The absolute volume will be 
williamr@2: 	returned in response(s) via the observer interface.
williamr@2: 	Only one command per controller session can be outstanding at any one time.
williamr@2: 	@param aStatus Used by RemCon to indicate completion of the send request. 
williamr@2: 	@param aNumRemotes The number of remotes to which the command was sent.
williamr@2: 	*/
williamr@2: 	IMPORT_C void GetAbsoluteVolume(TRequestStatus& aStatus, TUint& aNumRemotes);
williamr@2: 
williamr@2: 	/**
williamr@2: 	Sends a 'set absolute volume' command. The volume is set to aAbsVol, on a 
williamr@2: 	range of zero to aMaxVol. Any responses will be returned via the observer 
williamr@2: 	interface.
williamr@2: 	Only one command per controller session can be outstanding at any one time.
williamr@2: 	@param aStatus Used by RemCon to indicate completion of the send request.
williamr@2: 	@param aAbsVol The relative volume.
williamr@2: 	@param aMaxVol The maximum against which aAbsVol is relative.
williamr@2: 	@param aNumRemotes The number of remotes to which the command was sent.
williamr@2: 	*/
williamr@2: 	IMPORT_C void SetAbsoluteVolume(TRequestStatus& aStatus, TUint aAbsVol, TUint aMaxVol, TUint& aNumRemotes);
williamr@2: 
williamr@2: private:
williamr@2: 	/** 
williamr@2: 	Constructor.
williamr@2: 	@param aInterfaceSelector The interface selector.
williamr@2: 	@param aObserver The observer of this interface.
williamr@2: 	*/
williamr@2: 	CRemConAbsVolController(CRemConInterfaceSelector& aInterfaceSelector, 
williamr@2: 		MRemConAbsVolControllerObserver& aObserver);
williamr@2: 
williamr@2: private: // from CRemConInterfaceBase
williamr@2: 	TAny* GetInterfaceIf(TUid aUid);
williamr@2: 
williamr@2: private: // from MRemConInterfaceIf
williamr@2: 	void MrcibNewMessage(TUint aOperationId, const TDesC8& aData);
williamr@2: 
williamr@2: private: // unowned
williamr@2: 	MRemConAbsVolControllerObserver& iObserver;
williamr@2: 
williamr@2: private: // owned
williamr@2: 	static const TUint KMaxOperationDataSize = 0x20;
williamr@2: 	TBuf8<KMaxOperationDataSize> iOutData;
williamr@2: 	};
williamr@2: 
williamr@2: #endif // REMCONABSVOLCONTROLLER_H