// 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:
//

#ifndef DEVVIDEOSURFACEHANDLECUSTOMINTERFACE_H
#define DEVVIDEOSURFACEHANDLECUSTOMINTERFACE_H

#include <graphics/surface.h>
#include <mmf/common/mmfvideo.h>

/** 
DevVideo SurfaceHandle Custom Interface UID.

@publishedPartner
@prototype
*/
const TUid KUidMMFVideoSurfaceHandleControl = { 0x10286486 };

/**
Video play surface handle custom interface.
This interface can be used by a H/W device which creates a surface to pass
information about the surface (such as the surface handle) to another H/W device.
This is typically implemented by a post processor and used by a decoder.

@publishedPartner
@prototype
*/
class MMmfVideoSurfaceHandleControl
	{
	public:

	/**
	Set the handle for the surface

	@param aSurfaceHandle Surface handle for the new surface.
	*/
	virtual void MmvshcSetSurfaceHandle(const TSurfaceId& aSurfaceHandle) = 0;

	/**
	Pass a buffer to redraw on the surface.
	One situation here this might be used is where resources for a decoder are
	temporarily removed. The decoder can call this routine in order to pass the
	last picture to a postprocessor for redrawing.

	@param  aRedrawBuffer Buffer containing picture to redraw. The memory for
	this buffer is owned by the caller and ownership of the memory is not
	transferred as part of this call. The memory may not be valid	after the
	call completes.
	*/
	virtual void MmvshcRedrawBufferToSurface(TPtrC8& /*aRedrawBuffer*/) {};
	};

#endif // DEVVIDEOSURFACEHANDLECUSTOMINTERFACE_H