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

 // ULogger output plug-in interface

 // 

 //

 /**

  @file

  @publishedPartner

  @prototype

 */

 #ifndef ULOGGEROUTPUTPLUGIN_H

 #define ULOGGEROUTPUTPLUGIN_H

 #include <e32base.h>

 #include "uloggerplugin.h"

 #include "uloggerdatatypes.h"

 namespace Ulogger

 {

 //! Abstract class for ULogger output plug-ins.

 /*!

 A ULogger output plug-in is responsible for writing Trace log data to some

 output medium. Examples for output media are files, serial ports or TCP sockets.

 Whenever ULogger needs to output Trace log data, it passes this to the currently

 selected output plug-in, which then handles the actual writing to an output

 medium.

 All output plug-ins must derive from this class in order to be compatible with

 ULogger. They must also derive from ULogger::CPlugin (whose header is already

 included by this header, for convenience) in order to be compatible with the

 ECom framework, which ULogger uses to load its output plug-ins.

 */

 class MOutputPlugin

 	{

 public:	 

 	/** 

 	Writes the given data to the output media that is represented by the

 	plug-in implementation. This method is called by ULogger whenever Trace log

 	data becomes available. How much data is passed to this function depends

 	on how ULogger is configured; the length of the given descriptor

 	indicates the size of the data packet. The intervals at which

 	this method is called depends on the amount of Trace data that is logged

 	from code in the currently running processes.

 	@param aData the Trace data to output, in BTrace format

 	@return KErrNone, if successful; otherwise one of the other system wide

 	                  error codes.

 	*/

 	virtual TInt Write(const TDesC8& aData) = 0; 

 	/**

 	Called by ULogger as first method after construction or after changes in

 	config file. This allows the output plug-in to initialize itself with its

 	private	settings.

 	@param aConfigs actual configurations valid for this instance

 	@return KErrNone, if successful; otherwise one of the other system wide

 	        error codes.

 	*/

 	virtual TInt ConfigureOutputPlugin(const RPointerArray<TPluginConfiguration>& aConfigs) = 0; 

 	/**

 	Called by ULogger to indicate that the output plug-in must flush all buffers

 	and	release any locked resources. Any resources may be locked only after any

 	other method is called.

 	*/

 	virtual void CloseOutputPlugin() = 0;

 	/** Virtual destructor. */

 	virtual ~MOutputPlugin(){}

 	/**

 	Output plug-in interface id. This is for ULogger to distinguish between the

 	different types of plug-ins (e.g. Output vs Input plug-ins).

 	*/

 	static const CPlugin::TPluginInterface iInterfaceId = CPlugin::EOutput;

 	};

 } //end of namespace

 #endif // ULOGGEROUTPUTPLUGIN_H