/*
* Copyright (c) 2006 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:  Header file for CUsbActiveBasicHandler
*
*/


#ifndef C_CUSBACTIVEBASICHANDLER_H
#define C_CUSBACTIVEBASICHANDLER_H

#include "cusbpersonalityplugin.h"

class RUsb;

/**
*  Class to handle basic personalities.
*
*  @lib euser.lib
*  @since Series 60 3.0
*/
class CUsbActiveBasicHandler : public CUsbPersonalityPlugin
    {
public:  // Constructors and destructor
        
    /**
     * Two-phased constructor.
     * @param aPersonalityParams Reference to the container class.
     * @return pointer to created object
     */
    static CUsbActiveBasicHandler* NewL(TUsbPersonalityParams& aPersonalityParams);
        
    /**
     * Destructor.
     */
    virtual ~CUsbActiveBasicHandler();

public: // from base class CUsbPersonality        
        
    /**
     * From CUsbPersonality
     * Called when personality will be changed. In this personality 
     * no actions is taken.
     *
     * @since Series 60 3.0
     * @param aStatus Status of the ended operation.
     */        
    virtual void ConfirmPersonalityUnload(TRequestStatus& aStatus);

    /**
     * From CUsbPersonality
     * Called by personality handler when personality start needs to be 
     * prepared. Nothing is done in this personality.
     *
     * @since Series 60 3.0
     * @param aStatus Status of the ended operation.
     */
    virtual void PreparePersonalityStart(TRequestStatus& aStatus);

    /**
     * From CUsbPersonality
     * Called by personality handler when personality start needs to be 
     * finished. For this personality: Show infonote to user.
     *
     * @since Series 60 3.0
     * @param aStatus Status of the ended operation.
     */
    virtual void FinishPersonalityStart(TRequestStatus& aStatus);
                
    /**
     * From CUsbPersonality
     * Called by personality handler when personality stop needs to be 
     * prepared. For this personality: Do nothing.
     *
     * @since Series 60 3.0
     * @param aStatus Status of the ended operation.
     */
    virtual void PreparePersonalityStop(TRequestStatus& aStatus);

    /**
     * From CUsbPersonality
     * Called by personality handler when personality stop needs to be 
     * finished. For this personality: Do nothing.
     *
     * @since Series 60 3.0
     * @param aStatus Status of the ended operation.
     */
    virtual void FinishPersonalityStop(TRequestStatus& aStatus);
        
    /**
     * From CUsbPersonality
     * State change notify
     *
     * @since Series 60 3.0
     * @param aState state of the device
     */
    virtual void StateChangeNotify( TUsbDeviceState aState );

public: // from base class CActive

    /**
     * From CActive.
     * Left empty in this implementation.
     *
     * @since Series 60 3.0
     */
    void RunL();

    /**
     * From CActive.
     * Left empty in this implementation.
     *
     * @since Series 60 3.0
     * @param aError the error returned
     * @return error
     */
    TInt RunError( TInt /*aError*/ );

    /**
     * From CActive
     * Left empty in this implementation.
     *
     * @since Series 60 3.0        
     */
    void DoCancel();

protected:

    /**
     * C++ default constructor (no implementation provided).
     */
    CUsbActiveBasicHandler(TUsbPersonalityParams& aPersonalityParams);

    /**
     * By default Symbian 2nd phase constructor is private.
     */
    void ConstructL();

    // Prohibit copy constructor when not deriving from CBase.
    CUsbActiveBasicHandler( const CUsbActiveBasicHandler& );
    // Prohibit assigment operator when not deriving from CBase.
    CUsbActiveBasicHandler& operator=( const CUsbActiveBasicHandler& );

private:    // Data
    /**
     * Request to completed later
     */
    TRequestStatus* iRequestStatus;
    };

#endif   // USBACTIVECDCHANDLER_H

// End of File