--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-0CFC2113-37F9-58B5-AF27-125C23C3087F.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,156 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 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 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: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept xml:lang="en" id="GUID-0CFC2113-37F9-58B5-AF27-125C23C3087F"><title>driver1_dev.h</title><prolog><metadata><keywords/></metadata></prolog><conbody><codeblock id="GUID-56EACFFA-3694-5DEE-8EC1-0DD3BC665F76" xml:space="preserve">// driver1_dev.h
+//
+// Copyright (c) 2009 Nokia Ltd. All rights reserved.
+//
+
+/**
+Kernel side interfaces to example Logical and Physical Device Drivers
+*/
+
+#ifndef __DRIVER1_DEV_H__
+#define __DRIVER1_DEV_H__
+
+/**
+  Physical Device (factory class) for 'Driver1'
+*/
+class DDevice1PddFactory : public DPhysicalDevice
+    {
+public:
+    DDevice1PddFactory();
+    ~DDevice1PddFactory();
+    // Inherited from DPhysicalDevice
+    virtual TInt Install();
+    virtual void GetCaps(TDes8&amp; aDes) const;
+    virtual TInt Create(DBase*&amp; aChannel, TInt aUnit, const TDesC8* aInfo, const TVersion&amp; aVer);
+    virtual TInt Validate(TInt aUnit, const TDesC8* aInfo, const TVersion&amp; aVer);
+public:
+    TInt iHardwareInUse;
+private:
+    enum TMinimumLDDVersion
+        {
+        EMinimumLddMajorVersion=1,
+        EMinimumLddMinorVersion=0,
+        EMinimumLddBuild=0 //Not used
+        };
+public:
+    TDynamicDfcQue* iDfcQ;
+    };
+
+
+/**
+  Logical Device (factory class) for 'Driver1'
+*/
+class DDriver1Factory : public DLogicalDevice
+    {
+public:    
+    DDriver1Factory();
+    ~DDriver1Factory();
+    //    Inherited from DLogicalDevice
+    virtual TInt Install();
+    virtual void GetCaps(TDes8&amp; aDes) const;
+    virtual TInt Create(DLogicalChannelBase*&amp; aChannel);
+    };
+
+class DDriver1;
+
+/**
+  Logical Channel class for 'Driver1'
+*/
+class DDriver1Channel : public DLogicalChannel
+    {
+public:
+    DDriver1Channel();
+    virtual ~DDriver1Channel();
+    // Inherited from DObject
+    virtual TInt RequestUserHandle(DThread* aThread, TOwnerType aType);
+    // Inherited from DLogicalChannelBase
+    virtual TInt DoCreate(TInt aUnit, const TDesC8* anInfo, const TVersion&amp; aVer);
+    // Inherited from DLogicalChannel
+    virtual void HandleMsg(TMessageBase* aMsg);
+private:
+    // Panic reasons
+    enum TPanic
+        {
+        ERequestAlreadyPending = 1
+        };
+    // Implementation for the differnt kinds of requests send through RBusLogicalChannel
+    TInt DoControl(TInt aFunction, TAny* a1, TAny* a2);
+    TInt DoRequest(TInt aReqNo, TRequestStatus* aStatus, TAny* a1, TAny* a2);
+    void DoCancel(TUint aMask);
+    // Accessor for the PDD
+    inline DDriver1* Pdd();
+    // Methods for configuration
+    TInt GetConfig(TDes8* aConfigBuf);
+    TInt SetConfig(const TDesC8* aConfigBuf);
+    void CurrentConfig(RDriver1::TConfig&amp; aConfig);
+    // Methods for processing a SendData request
+    TInt SendData(TRequestStatus* aStatus,const TDesC8* aData);
+    void SendDataCancel();
+    void DoSendDataComplete();
+    static void SendDataDfc(TAny* aPtr);
+    // Methods for processing a ReceiveData request
+    TInt ReceiveData(TRequestStatus* aStatus,TDes8* aBuffer);
+    void ReceiveDataCancel();
+    void DoReceiveDataComplete();
+    static void ReceiveDataDfc(TAny* aPtr);
+public:
+    // Interface methods for use by PDD
+    virtual void SendDataComplete(TInt aResult);
+    virtual void ReceiveDataComplete(TInt aResult);
+private:
+    DThread* iClient;
+    // Members used for processing a SendData request
+    TRequestStatus* iSendDataStatus;
+    TDfc iSendDataDfc;
+    TInt iSendDataResult;
+    TBuf8&lt;256&gt; iSendDataBuffer;
+    // Members used for processing a ReceiveData request
+    TDes8* iReceiveDataDescriptor;
+    TRequestStatus* iReceiveDataStatus;
+    TDfc iReceiveDataDfc;
+    TInt iReceiveDataResult;
+    TBuf8&lt;256&gt; iReceiveDataBuffer;
+    };
+
+inline DDriver1* DDriver1Channel::Pdd()
+    { return (DDriver1*)iPdd; }
+
+/**
+  Interface to 'Driver1' physical device
+*/
+class DDriver1 : public DBase
+    {
+public:
+    /**
+    Structure for holding PDD capabilities information
+    */
+    class TCaps
+        {
+    public:
+        TVersion iVersion;
+        };
+public:
+    virtual TInt BufferSize() const =0;
+    virtual TInt Speed() const =0;
+    virtual TInt SetSpeed(TInt aSpeed) =0;
+    virtual TInt SendData(const TDesC8&amp; aData) =0;
+    virtual void SendDataCancel() =0;
+    virtual TInt ReceiveData(TDes8&amp; aBuffer) =0;
+    virtual void ReceiveDataCancel() =0;
+public:
+    DDriver1Channel* iLdd;
+    };
+
+#endif
+</codeblock> </conbody></concept>
\ No newline at end of file