devicesrv_plat/remote_control_extension_api/inc/RemConCallHandlingTarget.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Wed, 09 Jun 2010 11:04:22 +0300
branchRCL_3
changeset 15 b2f9f823b5fb
parent 0 4e1aa6a622a0
permissions -rw-r--r--
Revision: 201021 Kit: 2010123

/*
* 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 <RemConExtensionApi.h>
#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