// Copyright (c) 2009-2010 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:
//

/**
 @file
 @internalTechnology
*/

#ifndef MMFMEDIACLIENTEXTDISPLAYINTERFACE_H_
#define MMFMEDIACLIENTEXTDISPLAYINTERFACE_H_

#include <e32base.h>

#define MMF_MEDIA_CLIENT_EXT_DISPLAY_INTERFACE_V3

/**

Enumeration used to indicate external display current connection status

**/
enum TExtDisplayConnectionProviderConnType
    {
    EExtDisplayConnectionProviderConnTypeDisconnected,
    EExtDisplayConnectionProviderConnTypeHdmi,
    EExtDisplayConnectionProviderConnTypeAnalog
    };

/**

Mixin class capable of handling events from provider

*/
class MExtDisplayConnectionProviderCallback
    {
public:
    virtual void MedcpcExtDisplayNotifyConnected(TExtDisplayConnectionProviderConnType aExtDisplayConnType) = 0;
    };

/**

Mixin class for external display connection provider plugins.

*/
class CExtDisplayConnectionProviderInterface : public CBase
	{
public:

    /**
    Allocates and constructs a new provider plugin.

    Uses ECOM to instantiate a new provider plugin. Can leave with any of the system-wide error codes.

    @leave  KErrNotSupported There is no support for external displays.
    @return A pointer to the new provider plugin.

    */
    static CExtDisplayConnectionProviderInterface* NewL();

    /**
    Function to be implemented by connection provider that allows the callback to be set.
    
    @param  aCallback
        A reference to an object that can be used by the provider to send events back to the client.
    */
    virtual void SetExtDisplayConnectionProviderCallback(MExtDisplayConnectionProviderCallback& aCallback) = 0;

    /**
    Function to be implemented by connection provider that indicates the external display connection type 
    
    @return One of values defined in TExtDisplayConnectionProviderConnType
    */
    virtual TExtDisplayConnectionProviderConnType ExtDisplayConnType() = 0;
	
    /**
    Function to be implemented by connection provider that indicates the display id that should
    be used for the external display port.
    
    @return TInt the display id for the external display port
    */
    virtual TInt ExtDisplayId() = 0;

    /**
    Default destructor.
    */
    IMPORT_C virtual ~CExtDisplayConnectionProviderInterface();

protected:
    /**
    Constructor.
    */
    IMPORT_C CExtDisplayConnectionProviderInterface();
    
private:
    /**
    Required by ECOM.
    */
    TUid iInstanceKey;
	};

#endif /* MMFMEDIACLIENTEXTDISPLAYINTERFACE_H_ */