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

// Symbian notifications

// 

//

#ifdef __cplusplus

extern "C" {

#endif

/*!

 *  \brief Initialises the Symbian specific device data, including

 *  the SUS observers

 *

 *  \param source the source to be initialised

 *  \return OWF_TRUE id successfull

 */

OWF_API_CALL OWFboolean

owfSymDeviceInitialise(WFC_IMAGE_PROVIDER* source);

/*!

 *  \brief Destroys the Symbian specific device data, including

 *  the SUS observers

 *

 *  \param device the device to be destroyed

 *  \param source the source to be initialised

 *  \param position in the device list

 */

OWF_API_CALL void

owfSymDeviceDestroy(WFC_DEVICE* device, WFC_IMAGE_PROVIDER* source, WFCint position);

/*!

 *  \brief Notifies the stream associated with element that the read buffer has been aquired

 *

 *  Used to solve the initial availabilty request

 *

 *  \param context The context corresponding to the ongoing composition

 *  \param element The element that composition has just started for

 *

 *  \return OWF_TRUE id successfull

 */

OWF_API_CALL OWFboolean

owfSymElementNotifications(WFC_CONTEXT* context, WFC_ELEMENT* element);

/*!

 *  \brief Resets the visibility state associated with each source

 *

 *  Used after each commit

 *

 *  \param context The context

 */

OWF_API_CALL void

owfSymDeviceResetVisibilityState(WFC_CONTEXT* context);

/*!

 *  \brief Processes all notifications for a context immediately after the context has been composed 

 *

 *  \param context The context coresponding to the caller composer

 */

OWF_API_CALL WFCint

owfSymProcessAllNotifications(WFC_CONTEXT* context);

#ifdef __cplusplus

}

#endif