/** @file

* Copyright (c) 2005-2009 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:  Control point with some basic AV services

*

*/

#ifndef C_CUPNPAVCONTROLPOINT_H

#define C_CUPNPAVCONTROLPOINT_H

//  INCLUDES

#include "upnpcontrolpoint.h"

// FORWARD DECLARATIONS

class MUpnpAVControlPointObserver;

// CLASS DECLARATION

/**

* Control point services.

* This class inherits control point base class and provides just a little

* added value on top of that. Some default construction has been taken

* care of, and some low level messaging is taken care of. Everything else

* is up to the client.

* 

* @lib - 

* @since S60 5.2

*/

NONSHARABLE_CLASS ( CUpnpAVControlPoint ): public CUpnpControlPoint

    {

public:  // Constructors and destructor

    /** static constructor. */

    static CUpnpAVControlPoint* NewL(

        MUpnpAVControlPointObserver& aAVControlPointObserver            

        );

    /** Destructor. */

    virtual ~CUpnpAVControlPoint();

private: // private construction part

    /** constructor */

    CUpnpAVControlPoint(MUpnpAVControlPointObserver& aAVControlPointObserver);

    /** 2nd phase constructor */

    void ConstructL();

public: // services

    /**

    * Returns the internally cached service for given device and 

    * service type.

    * 

    * @since S60 5.2

    * @param aDevice the device for which service is requested for.

    * @param aServiceType the upnp service required, for instance CDS.

    * @return Cached service.

    */

    CUpnpService* Service( 

            const CUpnpDevice* aDevice, 

            const TDesC8& aServiceType );

    /**

    * Helper method to create new action with given action name.

    * 

    * New action is created by internally cached service. The service is

    * identified with given device and service type.

    * 

    * @since S60 5.2

    * @param aDevice the device for which service is requested for

    * @param aServiceType the upnp service required, for instance CDS

    * @param aActionName Name of the action.

    * @return New action object

    * @leave KErrUnknown if internally cached service could not be found.

    *        KErrGeneral if service doesn't support action.

    *        Systemwide error code otherwise.

    */

    CUpnpAction* CreateActionLC( 

            const CUpnpDevice* aDevice, 

            const TDesC8& aServiceType,

            const TDesC8& aActionName );

    /**

     * Starts up the av control point by creating SSDP search.

     * 

     * @param None.

     * @return None.

     */

    void StartUpL();

private:  // Virtual method overrides from base classes

    /**

    * From CUpnpControlPoint Device discovery handler.

    */

    void DeviceDiscoveredL( CUpnpDevice* aDevice );

    /**

    * From CUpnpControlPoint Device dissappear handler.

    */

    void DeviceDisappearedL( CUpnpDevice* aDevice );

    /**

    * From CUpnpControlPoint Action response handler function.

    */

    void ActionResponseReceivedL( CUpnpAction* aAction );

    /**

    * From CUpnpControlPoint State update handler.

    */

    void StateUpdatedL( CUpnpService* aService );

    /**

    * From CUpnpControlPoint HTTP message handler function.

    */

    void HttpResponseReceivedL( CUpnpHttpMessage* aMessage );

    /**

    * This function will be invoke if some network event will occure

    * for example IP Address of UPnP changes

    */

    void NetworkEvent( CUpnpNetworkEventBase* aEvent );

private:    // Data

    //AV control point observer (engine)

    MUpnpAVControlPointObserver& iAVControlPointObserver;

    };

#endif      // C_CUPNPAVCONTROLPOINT_H

// End of File