Symbian3/SDK/Source/GUID-204B4155-AE35-5C53-867B-299AF7E5D16A.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Thu, 21 Jan 2010 18:18:20 +0000
changeset 0 89d6a7a84779
permissions -rw-r--r--
Initial contribution of Documentation_content according to Feature bug 1266 bug 1268 bug 1269 bug 1270 bug 1372 bug 1374 bug 1375 bug 1379 bug 1380 bug 1381 bug 1382 bug 1383 bug 1385

<?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 id="GUID-204B4155-AE35-5C53-867B-299AF7E5D16A" xml:lang="en"><title>Device
driver services</title><shortdesc>Describes asynchronous services provided by device drivers.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>Some asynchronous services are provided directly by device drivers.</p>
<p>As with services provided by the client-server framework, device driver
provided services are presented to clients through a client API known as the
user-side device driver. This is typically an <codeph>R</codeph> class, derived
from <codeph>RLogicalChannel</codeph>. </p>
<p>When the <codeph>RLogicalChannel</codeph> is opened, the device driver
is initialised and the client’s thread id is noted. Request functions are
converted into a message which encapsulates all the parameters, and sent to
the Kernel-side driver. Completion of a request function usually corresponds
closely with completion of a device operation. On completion, the driver posts
the request status and signals the client thread’s request semaphore.</p>
<p>Device drivers often have limited capability. For instance, an inability
to be opened by multiple client threads simultaneously. Therefore, devices
are often handled by specially tailored server threads. These servers present
a client API with more sophistication, sharing and checking. </p>
<p>Usually, therefore, clients use the server-provided classes rather than
the user-side device driver directly.</p>
</conbody></concept>