// 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_ */