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

#define __MDRIVEROBSERVER_H__

#include <e32std.h>

/**	@class		MDriverObserver

	The MDriverObserver class is the observer for the driver objects. It allows

	the drivers to notify the observer of when a test starts, an error occurs 

	and when a test completes. Also provides a logging mechanism.

	@componentInternal

	@see		CDriverBase

*/

class MDriverObserver

	{

public:	// methods

/**	@fn			NotifyError(TInt aError) =0

	Notifies the observer that an error has occured.

	@componentInternal

	@param		aError	The error code that has occured.

*/

	virtual void NotifyError(TInt aError) =0;

/**	@fn			NotifyStart() =0

	Notifies the observer that the test has started.

	@componentInternal

*/

	virtual void NotifyStart() =0;

/**	@fn			NotifyComplete() =0

	Notifies the observer that the test has completed.

	@componentInternal

*/

	virtual void NotifyComplete() =0;

/** @fn			Log(const TDesC& aComment) =0

	Logs comment to log file, but not the summary file.

	@componentInternal

	@param		aComment	The comment to be logged.

*/

	virtual void Log(const TDesC& aComment) =0;

/**	@fn			Dump(const TDesC8& aData) =0

	Dumps binary data to log file, but not the summary file.

	@componentInternal

	@param		aData	The data to be dumped.

*/

	virtual void Dump(const TDesC8& aData) =0;

	};

#endif	// __MDRIVEROBSERVER_H__