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

// Interface class for the TraceCoreOstLdd component. 

// 

#ifndef __TraceCoreOstLddIf_H__

#define __TraceCoreOstLddIf_H__

// Include files

#include <kernel/kernel.h>

#include "TraceCoreMediaIf.h"

#include "TraceCoreOstConnectionIf.h"

/**

 * ETraceCoreOstLddIfGetSet function to choosed in DTraceCoreOstLddI::GetSet.

 */

enum TTraceCoreOstLddIfGetSet

    {

    EGetDfc = 0, // Return type TDfc*

    EGetBuf = 1,     // Return type TDes8*

    ESetWriter = 2,   // Return type 0

    ERegister  // Return type 0

    };

/**

 * Interface class for XTI

 */

class DTraceCoreOstLddIf : public DTraceCoreMediaIf

    {

public:

    /**

     * Constructor

     */

    DTraceCoreOstLddIf();

    /**

     * Destructor

     */

    ~DTraceCoreOstLddIf();

    /**

     * Initializes this interface

     * 

     * @param aCallback Callback interface which is notified when a message is received from the XTI driver

     */

	TInt Init( MTraceCoreMediaIfCallback& aCallback );

	/**

	 * Sends a message

	 *

	 * @param aMessage The message to be sent

	 */

	TInt Send( TTraceMessage &aMessage );

	/**

	 * 

	 * @param aFunc Function choosed (@see ETraceCoreOstLddIfGetSet)

	 * @return TDfc* if aFunc is EGetDfc, TDes8* EGetBuf and 0 with ESetWriter.

	 */

	IMPORT_C static TUint32 GetSet(TTraceCoreOstLddIfGetSet aFunc, TUint32 aParam);

private:

    /**

     * DFC function for incoming data from XTI driver

     */

    static void ReceiveDfc( TAny* aPtr );

    /**

     * Called from the static DFC function to process incoming data

     */

    void ReceiveDfc();

    /**

     * Forwards incoming message to callback

     */

    void NotifyCallback();

    /**

     * Sends message to XTI

     * 

     * @param aMsg Message to be sent.

     * @return KErrNone if send successful

     */

    void SendData( TTraceMessage& aMsg );

    /**

    * Similar to send, except does not generate traces, since they would loop back to this function

    * 

    * @param aMsg Message to be sent.

    * @return KErrNone if send successful

    */

    TInt SendTrace( const TDesC8& aMsg );

private:

    /**

     * DFC which is used for incoming ISI-messages

     */

    TDfc iReceiveDfc;

    /**

     * ISA Kernel IF Initialisation status

     */

    TInt iStatus;

    /** 

     * Length variable for ISA Kernel interface usage

     */

    TUint16 iNeededLength;

    TBool iTraceCoreOstConnectionRegistered;

     /**

     * Buffer for sending data

     **/

    TBuf8< 8204 > iSendBuffer;

    /**

     * Buffer for incoming data

     **/

    TBuf8< 8204 > iReceiveBuffer;

    /**

     * Pointer to TraceCoreOstConnectionIf

     **/

    MTraceCoreOstConnectionIf *iTraceCoreOstConnection;

    };

#endif // __TraceCoreOstLddIf_H__

// End of File