/*

* Copyright (c) 2002-2008 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  This class deliveres call handling related operations from 

*				 accessories to client that listens to them. It also provides 

*				 methods for client to respond to call handling operations.

*

*/

#ifndef CREMCONCALLHANDLINGTARGET_H

#define CREMCONCALLHANDLINGTARGET_H

//  INCLUDES

#include <e32base.h>

#include <remcon/remconinterfacebase.h>

#include <remcon/remconinterfaceif.h>

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class MRemConCallHandlingTargetObserver;

class CRemConInterfaceSelector;

// CLASS DECLARATION

/**

*  Part of Remote Control Extension Api.

*  This class receives call handling related operations from accessories.

*

*  @lib RemConExtensionApi.dll

*  @since Series 60 3.0

*/

class CRemConCallHandlingTarget : public CRemConInterfaceBase, MRemConInterfaceIf3

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        @param aInterfaceSelector The interface selector.

		@param aObserver The observer of this interface.

		@return A new CRemConCallHandlingTarget, owned by the interface selector.

        */

        IMPORT_C static CRemConCallHandlingTarget* NewL(

        	CRemConInterfaceSelector& aInterfaceSelector, 

			MRemConCallHandlingTargetObserver& aObserver );

        /**

        * Destructor.

        */

        IMPORT_C virtual ~CRemConCallHandlingTarget();

    public: // New functions

        IMPORT_C void SendResponse( TRequestStatus& aStatus,

									TInt aOperationId, 

									TInt aError );	

        /**

        * Method to get the bearer source detail for the last command received

        * 

        * @since TB 9.2

        * @param aSource returns the bearer source as TRemConExtCmdSource

        * @return void

        */

        IMPORT_C void GetCommandSourceInfo( TRemConExtCmdSource& aSource );

    public: // Static functions

        /**

        * Method to get the bearer source detail

        *

        * @since TB9.2

        * @param aUid bearer UID

        * @param aSource returns the bearer source as TRemConExtCmdSource

        * @return void

        */

        static void GetUIDSource( TUint32 aUid, TRemConExtCmdSource& aSource );

    public: // Functions from base classes

    protected:  // New functions

    protected:  // Functions from base classes

    private:	// From CRemConInterfaceBase

    	// From CRemConInterfaceBase

    	TAny* GetInterfaceIf( TUid aUid );

        // From MRemConInterfaceIf3

    	void MrcibNewMessage(TUint aOperationId, const TDesC8& aData, TRemConMessageSubType aMessageSubType, const TRemConAddress& aRemoteAddr);

    private:

        /** 

		Constructor.

		@param aInterfaceSelector The interface selector.

		@param aObserver The observer of this interface.

		*/

		CRemConCallHandlingTarget( CRemConInterfaceSelector& aInterfaceSelector, 

			MRemConCallHandlingTargetObserver& aObserver );

		/**

        * Method that sends all reponses to accessory.

        */

        void SendAnyResponse(

			TRequestStatus& aStatus,

			TInt aOperationId,

			TInt aError );

    public:     // Data

    protected:  // Data

    private:    // Data

    	// Observer implemented by client of CRemConCallHandlingTarget

    	MRemConCallHandlingTargetObserver& iObserver;

		// Stores any parameters associated with operation sent to accessory.   

		TBuf8<KRemConExtParamMaxLength> iOutData;

		// Stores the number of remotes the message was sent to.	

		TUint iNumRemotes;

		// Stores the UID of the bearer from which the last command was received

		TUint32 iSourceUID;

    public:     // Friend classes

    protected:  // Friend classes

    private:    // Friend classes

    };

#endif // CREMCONCALLHANDLINGTARGET_H 

// End of File