/*
* Copyright (c) 2008-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:    Media userinterface
*
*/




#ifndef __M_GLXMEDIAUSER_H__
#define __M_GLXMEDIAUSER_H__

#include <e32std.h>

#include <mpxattribute.h>

#include "glxmediaid.h"

class CGlxMedia;

/**
 * Interface for media object users
 * @author Aki Vanhatalo
 *
 * @internal reviewed 17/07/2007 by Kimmo Hoikka
 *
 * @ingroup mlm_media_list_manager_design
 */
class MGlxMediaUser
    {
public:
    /**
     * For a given item, get all the attributes that may be requested for it
     *
     * @param aIndex index in media list of item
     * @param aAttributes Ordered list of attributes (ordered by AttributeOrder)
     * @return aAttributes with any new attributes added
     */
    virtual void GetRequiredAttributesL( TInt aIndex, RArray< TMPXAttribute >& aAttributes ) = 0;
    
    /**
     * Called to notify the list that attributes for the item are available
     *
     * @param aIndex index in media list of item that has attributes available
     * @param aAttributes list of attributes available
     */
    virtual void HandleAttributesAvailableL( TInt aIndex, 
        const RArray< TMPXAttribute >& aAttributes ) = 0;
    
    /**
     * Called to notify that the callee should remove all references to the 
     * media object (as it is about to be deleted)
     * @param aIndex index in media list of item to which references should be removed
     */
    virtual void RemoveReference( TInt aIndex ) = 0;

    /**
     * Notify of error
     *
     * @param aError Error code
     */
    virtual void HandleError( TInt aError ) = 0;
    };
    
#endif // __M_GLXMEDIAUSER_H__