Symbian3/PDK/Source/GUID-132349A6-9A5F-4866-A54D-F01B6F58ABDD.dita
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
--- a/Symbian3/PDK/Source/GUID-132349A6-9A5F-4866-A54D-F01B6F58ABDD.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-132349A6-9A5F-4866-A54D-F01B6F58ABDD.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -1,41 +1,41 @@
-<?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-132349A6-9A5F-4866-A54D-F01B6F58ABDD" xml:lang="en"><title>Shared
-Chunks</title><shortdesc>This document describes the use of shared chunks to share data.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
-<section id="GUID-DBFFE006-4E6C-4B4C-9E50-0A9FC9CB51FF">       <title> Shared
-chunks</title>       <p>Device drivers often need to share data between user
-space and kernel space threads. Though there are APIs for doing this, such
-as <xref href="GUID-C6946ECB-775F-3EC2-A56F-78F25B9FBE3D.dita#GUID-C6946ECB-775F-3EC2-A56F-78F25B9FBE3D/GUID-904A42A8-8077-3FC6-BEF2-29619F079842"><apiname>Kern::ThreadRawRead()</apiname></xref> and <xref href="GUID-C6946ECB-775F-3EC2-A56F-78F25B9FBE3D.dita#GUID-C6946ECB-775F-3EC2-A56F-78F25B9FBE3D/GUID-182C88F4-326C-376E-9FBE-889E3CB9B68A"><apiname>Kern::ThreadRawWrite()</apiname></xref>,
-these involve an overhead of a memory copy, which can be a problem when there
-is a large amount of data. </p> <p>To avoid unnecessary data transfer, Symbian
-platform provides shared chunks, which are similar to shared memory in other
-operating systems. Shared chunks can be created and used by both a driver
-and user-side code directly. An example application for shared chunks is for
-a camera driver. Without shared chunks, the image data would have to be copied
-from the camera driver to the user process, which would then copy it to the
-display driver. This would have a high memory copy overhead. Using shared
-chunks instead would improve the performance of the camera view finder. </p> <p>A
-shared chunk is created and controlled by the kernel side code, for example,
-the device driver, rather than the user code. This memory is safe to be used
-by ISRs and DMA. A shared chunk can be mapped into multiple user processes
-in sequence or at the same time. The memory object can be transferred between
-another process and another device driver. Multiple drivers and multiple user
-processes can have access to the same shared chunk. </p>     </section>
-<section id="GUID-8C27DA12-5396-4229-8723-480D5846604C"><title>Comparison
-between shared memory and shared I/O buffers</title><p>The EKA1 versions of
-Symbian platform had a mechanism called shared I/O buffers. These are now
-deprecated, and shared chunks should be used instead. The disadvantage of
-a shared I/O buffer is that only one user process can access the chunk at
-a time, and that it does not have a user handle: the user process is only
-supplied with the address and size of the buffer. Shared chunks solve these
-issues, and give more flexibility for users to do safe operations. </p></section>
+<?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-132349A6-9A5F-4866-A54D-F01B6F58ABDD" xml:lang="en"><title>Shared
+Chunks</title><shortdesc>This document describes the use of shared chunks to share data.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-DBFFE006-4E6C-4B4C-9E50-0A9FC9CB51FF">       <title> Shared
+chunks</title>       <p>Device drivers often need to share data between user
+space and kernel space threads. Though there are APIs for doing this, such
+as <xref href="GUID-C6946ECB-775F-3EC2-A56F-78F25B9FBE3D.dita#GUID-C6946ECB-775F-3EC2-A56F-78F25B9FBE3D/GUID-904A42A8-8077-3FC6-BEF2-29619F079842"><apiname>Kern::ThreadRawRead()</apiname></xref> and <xref href="GUID-C6946ECB-775F-3EC2-A56F-78F25B9FBE3D.dita#GUID-C6946ECB-775F-3EC2-A56F-78F25B9FBE3D/GUID-182C88F4-326C-376E-9FBE-889E3CB9B68A"><apiname>Kern::ThreadRawWrite()</apiname></xref>,
+these involve an overhead of a memory copy, which can be a problem when there
+is a large amount of data. </p> <p>To avoid unnecessary data transfer, Symbian
+platform provides shared chunks, which are similar to shared memory in other
+operating systems. Shared chunks can be created and used by both a driver
+and user-side code directly. An example application for shared chunks is for
+a camera driver. Without shared chunks, the image data would have to be copied
+from the camera driver to the user process, which would then copy it to the
+display driver. This would have a high memory copy overhead. Using shared
+chunks instead would improve the performance of the camera view finder. </p> <p>A
+shared chunk is created and controlled by the kernel side code, for example,
+the device driver, rather than the user code. This memory is safe to be used
+by ISRs and DMA. A shared chunk can be mapped into multiple user processes
+in sequence or at the same time. The memory object can be transferred between
+another process and another device driver. Multiple drivers and multiple user
+processes can have access to the same shared chunk. </p>     </section>
+<section id="GUID-8C27DA12-5396-4229-8723-480D5846604C"><title>Comparison
+between shared memory and shared I/O buffers</title><p>The EKA1 versions of
+Symbian platform had a mechanism called shared I/O buffers. These are now
+deprecated, and shared chunks should be used instead. The disadvantage of
+a shared I/O buffer is that only one user process can access the chunk at
+a time, and that it does not have a user handle: the user process is only
+supplied with the address and size of the buffer. Shared chunks solve these
+issues, and give more flexibility for users to do safe operations. </p></section>
 </conbody></concept>
\ No newline at end of file