/*
* Copyright (c) 2002-2007 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:  Basic class for personalitites
*
*/


#ifndef CUSBPERSONALITY_H
#define CUSBPERSONALITY_H

#include <bldvariant.hrh>
#include <e32base.h>
#include <usbman.h>
#include <usbuinotif.h>
#include <cusbpersonalitynotifier.h>

class RUsb;
class TUsbPersonalityParams;

/**
*  Abstract interface to personality handler objects.
*
*  @lib -
*  @since Series 60 3.0
*/
class CUsbPersonality : public CActive
    {
    public: // New functions
    
        /**
        * Destructor.
        */
        
        virtual ~CUsbPersonality();

        /**
        * DEPRICATED
        */
        IMPORT_C virtual void ShowUsbConnectionNote();
        
        virtual void ConfirmPersonalityUnload(TRequestStatus& aStatus) = 0;
                
        /**
        * Called by personality handler when personality start needs to be
        * prepared
        * @since Series 60 3.0
        */
        virtual void PreparePersonalityStart(TRequestStatus& aStatus) = 0;
        
        /**
        * Called by personality handler when personality start needs to be 
        * finished
        * @since Series 60 3.0
        */
        virtual void FinishPersonalityStart(TRequestStatus& aStatus) = 0; 

        /**
        * Called by personality handler when personality stop needs to be 
        * prepared
        * @since Series 60 3.0
        */
        virtual void PreparePersonalityStop(TRequestStatus& aStatus) = 0; 
                
        /**
        * Called by personality handler when personality stop needs to be 
        * finished
        * @since Series 60 3.0
        */
        virtual void FinishPersonalityStop(TRequestStatus& aStatus) = 0; 
                
        /**
        * State change notify
        * @since Series 60 3.0
        * @param aState state of the device
        */
        virtual void StateChangeNotify( TUsbDeviceState aState ) = 0;

protected:
        
        /**
        * Constructor
        * @since S60 3.2
        * @param aPersonalityParams Used to deliver information for personality
        */
        IMPORT_C CUsbPersonality(TUsbPersonalityParams& aPersonalityParams);
        

        /**
         * This class contains information what might be needed by the personality
         */
        TUsbPersonalityParams& iPersonalityParams;

        /**
         * Member variable used by connection notifier
         */
        TUSBConnectionNotifierParamsPckg iPckg;
        
        /**
         * Member variable used by connection notifier
         */
        TBuf8<1> iNoResult;
    };

#endif   // CUSBPERSONALITY_H

// End of File