/*
* 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:  Playlist plugin observer
*
*/


#ifndef MMPXPLAYLISTPLUGINOBSERVER_H
#define MMPXPLAYLISTPLUGINOBSERVER_H


#include <mpxmedia.h>

/**
*  This interface is not visible to the playlist
*  engine client. This observer interface is used internally by a plugin for request
*  completion notification.
*
*  CMPXPlaylistEngine implements this interface. When a plugin completes a
*  InternalizePlaylistL or ExternalizePlaylistL request, the appropriate
*  HandlePlaylistL is called by the plugin to notify CMPXPlaylistEngine.
*
*  @lib mpxplaylistengine.lib
*/
NONSHARABLE_CLASS(MMPXPlaylistPluginObserver) 
    {
    public:

        /**
        *  Callback for InternalizePlaylistL.
        *
        *  @since S60 3.2.3
        *  @param aPlaylist a list of media parsed from the playlist file. NULL
        *         if there is an error. client takes ownership of this object.
        *  @param aError error code    
        *  @param aCompleted a flag that indicates if internalize playlist command has
        *         been fully processed. EFalse if not. In this case, there will be
        *         subsequent calls to HandlePlaylistL for the same playlist with the
        *         segmented results.ETrue if there are no more results to be sent to
        *         the observer.        
        */
        virtual void HandlePlaylistL(CMPXMedia* aPlaylist,
                                     const TInt aError,
                                     const TBool aCompleted) = 0;

        /**
        *  Callback for ExternalizePlaylistL.
        *
        *  @since S60 3.2.3
        *  @param aPlaylistUri URI for the playlist which has been externalized
        *  @param aError error code    
        */
        virtual void HandlePlaylistL(const TDesC& aPlaylistUri,
                                     const TInt aError) = 0;        
    };

#endif      // MMPXPLAYLISTPLUGINOBSERVER_H