/*
* 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:  observer for CUpnpImageRenderingEngine
*
*/


#ifndef UPNP_IMAGERENDERINGENGINEOBSERVER_H
#define UPNP_IMAGERENDERINGENGINEOBSERVER_H

// INCLUDES
#include <e32base.h>
#include "upnpavrenderingsessionobserver.h" // base class
#include "upnpitemresolverobserver.h" // base class

// FORWARD DECLARATIONS
class CUpnpAVDevice;
class MUPnPAVController;
class MUPnPAVRenderingSession;
class MUPnPAVSessionBase;
class MUPnPItemResolver;
class CUPnPCommonUI;

/**
* Observer interface for image rendering engine.
*
* @since S60 3.2
*/
class MUpnpImageRenderingEngineObserver
    {
    public:

        /**
         * Requests for media to be rendered.
         * this method is called soon after calling PlayL().
         * the client is expected to provide an item resolver prepared with
         * the media to be played back (but not resolved yet)
         * ownership is transferred in this transaction.
         * if client returns NULL playback will fail to KErrCancelled
         * 
         * @return the resolver representing media to be played
         */
        virtual MUPnPItemResolver* GetMedia() = 0;

        /**
         * Acknowledge for render request
         * @param aError any errors that occurred
         * @param aItem the actual item that is playing, trying to play, or
         *        NULL if such is not available for some error condition
        * @return response error code
        *         KErrNone if the engine should carry on working
        *         KErrDisconnected if engine should disconnect
         */
        virtual TInt RenderAck(
            TInt aError,
            const CUpnpItem* aItem ) = 0; 

        /**
         * Notifies that rendering engine will shut down due to
         * communication failure.
         * @param aError the error code (some kind of reason)
         */
        virtual void EngineShutdown(
            TInt aError ) = 0;
            
    };


#endif // UPNP_IMAGERENDERINGENGINEOBSERVER_H

// End of File