// 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 the License "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:

// e32\e32test\demandpaging\d_pagingexample.h

// Examples for demand paging device driver migration

// This header defines the interface to four drivers:

// d_pagingexample_1_pre		DLogicalChannel-dervied driver, pre-migration

// d_pagingexample_1_post		DLogicalChannel-dervied driver, post-migration

// d_pagingexample_2_pre		DLogicalChannelBase-dervied driver, pre-migration

// d_pagingexample_2_post		DLogicalChannelBase-dervied driver, post-migration

// 

//

#ifndef __D_PAGINGEXAMPLE_H__

#define __D_PAGINGEXAMPLE_H__

#include <e32cmn.h>

#ifndef __KERNEL_MODE__

#include <e32std.h>

#endif

_LIT(KPagingExample1PreLdd,"D_PAGINGEXAMPLE_1_PRE");

_LIT(KPagingExample1PostLdd,"D_PAGINGEXAMPLE_1_POST");

_LIT(KPagingExample2PreLdd,"D_PAGINGEXAMPLE_2_PRE");

_LIT(KPagingExample2PostLdd,"D_PAGINGEXAMPLE_2_POST");

const TInt KMaxTransferSize = 256;

const TInt KAsyncDelay = 100;   // simulated async operations take 100ms

// Common interface to all versions of the example driver

class RPagingExample : public RBusLogicalChannel

	{

public:

	enum TControl

		{

		ESetRealtimeState,

		EGetConfig,

		ESetConfig,

		};

	enum TRequest

		{

		ERequestRead,

		ERequestReadDes,

		ERequestWrite,

		ERequestWriteDes,

		ERequestNotify,

		ERequestAsyncGetValue,

		ERequestAsyncGetValue2,

		ERequestCancel,

		};

	struct TConfigData

		{

		TInt iParam1;

		TInt iParam2;

		TInt iParam3;

		TInt iParam4;

		};

	struct TValueStruct

		{

		TInt     iValue1;

		TBuf8<4> iValue2;

		};

#ifndef __KERNEL_MODE__

public:

	inline TInt Open(const TDesC& aLddName)

		{ return DoCreate(aLddName, TVersion(), KNullUnit, NULL, NULL, EOwnerThread, EFalse); }

	inline TInt SetDfcThreadRealtimeState(TBool aRealtime)  // only supported on "1_pre" driver

		{ return DoControl(ESetRealtimeState, (TAny*)aRealtime); }

	inline TInt GetConfig(TConfigData& aConfigOut)

		{ return DoControl(EGetConfig, (TAny*)&aConfigOut); }

	inline TInt SetConfig(const TConfigData& aConfigIn)

		{ return DoControl(ESetConfig, (TAny*)&aConfigIn); }

	inline void Notify(TRequestStatus& aStatus)

		{ DoRequest(ERequestNotify, aStatus); }

	inline void AsyncGetValue(TRequestStatus& aStatus, TValueStruct& aValueOut)

		{ DoRequest(ERequestAsyncGetValue, aStatus, (TAny*)&aValueOut); }

	inline void AsyncGetValue2(TRequestStatus& aStatus, TInt& aValueOut1, TInt& aValueOut2)

		{ DoRequest(ERequestAsyncGetValue2, aStatus, (TAny*)&aValueOut1, (TAny*)&aValueOut2); }

	inline void Read(TRequestStatus& aStatus, TUint8* aBuffer, TInt aLength)

		{ DoRequest(ERequestRead, aStatus, aBuffer, (TAny*)aLength); }

	inline void ReadDes(TRequestStatus& aStatus, TDes8& aDesOut)

		{ DoRequest(ERequestReadDes, aStatus, &aDesOut); }

	inline void Write(TRequestStatus& aStatus, const TUint8* aBuffer, TInt aLength)

		{ DoRequest(ERequestWrite, aStatus, (TAny*)aBuffer, (TAny*)aLength); }

	inline void WriteDes(TRequestStatus& aStatus, const TDesC8& aDesIn)

		{ DoRequest(ERequestWriteDes, aStatus, (TAny*)&aDesIn); }

	inline void Cancel()

		{ DoCancel(ERequestCancel); }

#endif

	};

#endif