/*
* Copyright (c) 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:  Header file for the CUpnpBrowseTask class.
*
*/


#ifndef UPNP_BROWSE_TASK_H
#define UPNP_BROWSE_TASK_H

// INCLUDES
#include <e32base.h>
#include "upnpavsessionobserverbase.h"
#include "upnpavbrowsingsessionobserver.h"
#include "upnpavdeviceobserver.h"
#include "upnptask.h"

// FORWARD DECLARATIONS
class CUpnpAVDevice;
class MUPnPAVController;
class MUPnPAVBrowsingSession;
class MUPnPAVSessionBase;

/**
* This class defines the CUpnpBrowseTask used in UpnpCommand component.
*
* @since S60 3.2
*/
class CUpnpBrowseTask : public CUpnpTask,
                        public MUPnPAVDeviceObserver
    {
    public: // Methods from CUpnpTask

        /**
         * Creates a new CUpnpBrowseTask object. Allocates Upnp Fw resources.
         * Resources will be released when the task is destroyed.
         *
         * @since S60 3.2
         * @return a new instance of CUpnpBrowseTask, casted to type CUpnpTask
         */
        static CUpnpTask* NewL();

        /**
         * Allocates the Upnp Fw resources.
         *
         * @since S60 3.2
         */
        void AllocateResourcesL();

        /**
         * Executes the task.
         *
         * @since S60 3.2
         */
        void ExecuteL();

    public: // Call back methods of MUPnPAVDeviceObserver

        /* Not used */
        void UPnPDeviceDiscovered( const CUpnpAVDevice& /*aDevice*/ ) {}
        void UPnPDeviceDisappeared( const CUpnpAVDevice& /*aDevice*/ ) {}

        /**
         * Notifies that the WLAN connection has been lost. All sessions
         * are now usable and must be closed.
         *
         * @since Series 60 3.1
         * @return None
         */
        void WLANConnectionLost();

    public: // Public destructor

        /**
         * Destructor.
         */
        virtual ~CUpnpBrowseTask();

    private: // Private construct/destruct methods

        /**
         * Perform the first phase of two phase construction.
         *
         * @since S60 3.2
         * @return a new instance of CUpnpShowTask, casted to type CUpnpTask
         */
        CUpnpBrowseTask();

        /**
         * Perform the second phase of two phase construction. Reserves the
         * Upnp Fw resources (they are released when the task is destroyed).
         */
        void ConstructL();

    private: // Data members

        /**
         * Pointer to the UpnpAvController instance. Owned.
         */
        MUPnPAVController* iAVController;

    };

#endif // UPNP_BROWSE_TASK_H

// End of File