1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-2559E3F7-314B-5DCC-A7FE-A08162A89721" xml:lang="en"><title>Local

    13 Media Subsystem Overview</title><shortdesc>Provides the logical device driver for the internal and removable

    14 storage media on a phone. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <section id="GUID-F7C4ED03-1A25-4F13-8B48-8A5463510422"><title>Purpose</title> <p>The local media sub-system allows the Symbian

    16 platform file system and other programs to communicate with local media devices. </p> </section>

    17 <section id="GUID-80F9C844-882C-4EA4-85C4-58D62C11685A"><title>Required background</title> <p>The local media sub-system

    18 requires an understanding of the Symbian platform file system and local media

    19 devices. </p> </section>

    20 <section id="GUID-E70E10E5-2676-4C0F-B28B-060F823DECCF"><title>Key concepts and terms</title> <dl>

    21 <dlentry>

    22 <dt>local drive</dt>

    23 <dd><p>A media drive mounted within the phone. </p> </dd>

    24 </dlentry>

    25 </dl> </section>

    26 <section id="GUID-08F96B25-71FA-4A62-A77B-5076F509AE23"><title>Architecture</title> <p>The <xref href="GUID-32659A02-6541-3D15-AB88-B70FBD7DF9B0.dita"><apiname>TBusLocalDrive</apiname></xref> class

    27 provides an interface to the local media sub-system. Each instance of this

    28 class represents a channel of communication with a local drive. To establish

    29 a channel a client connects an instance of the class to a specified drive.

    30 The file server contains 16 instances of <xref href="GUID-32659A02-6541-3D15-AB88-B70FBD7DF9B0.dita"><apiname>TBusLocalDrive</apiname></xref>,

    31 one for each local drive. Programs other than the file server may also create

    32 instances to access a local drive. Drives are abstracted by the <xref href="GUID-2E1AEAC0-CEDF-31A5-B36A-FC4749B979A5.dita"><apiname>TDrive</apiname></xref> class. </p> </section>

    33 <section id="GUID-3495E8DD-C6AA-47D3-A64F-4431C2A90850"><title>Local Media Sub-system Summary</title> <p>The local media

    34 subsystem provides the following: </p> <ul>

    35 <li id="GUID-79E68BE5-9713-5E24-B3C6-D0123CD13056"><p> <b>Local media LDD</b>  </p> <p> <filepath>elocd.ldd</filepath>  </p> <p>The

    36 kernel-side logical device driver which implements communication between physical

    37 devices and applications which use them. </p> </li>

    38 </ul> </section>

    39 <section id="GUID-74061F49-2659-47D1-9DB8-2FF3CB10B2E8"><title>Typical uses</title> <p>The <xref href="GUID-32659A02-6541-3D15-AB88-B70FBD7DF9B0.dita"><apiname>TBusLocalDrive</apiname></xref> class

    40 is used to connect to and disconnect from local drives, to read to and write

    41 from them, to provide information about the capabilities of the drives, to

    42 format them, and to mount and remount drives on specified media drivers. </p> <p>Local

    43 media subsystem: </p> <ul>

    44 <li id="GUID-1A411257-57A7-5206-AE12-811B5F71727A"><p>Manages device connections </p> </li>

    45 <li id="GUID-74C8A86A-D797-5473-8192-A4EA6DE1C8B0"><p>Manages data transfer </p> </li>

    46 <li id="GUID-5D62718F-3B7F-5D0E-9B95-BDA2C1FB77D3"><p>Handles notifications

    47 and device configuration. </p> </li>

    48 </ul> </section>

    49 </conbody><related-links>

    50 <link href="GUID-F3BD37EC-0CCB-5859-908F-215E22C9FC20.dita#GUID-F3BD37EC-0CCB-5859-908F-215E22C9FC20/GUID-143780ED-4A23-5E72-A923-F605172EC8B5">

    51 <linktext>File Server</linktext></link>

    52 <link href="GUID-6CF2F4EF-383F-5850-A522-F425A83AA89E.dita#GUID-6CF2F4EF-383F-5850-A522-F425A83AA89E/GUID-20E09BC9-35CA-594A-BA91-D8D0C928FD98">

    53 <linktext>File Systems</linktext></link>

    54 <link href="GUID-9540A82E-F83D-55F5-B441-868CF77468E9.dita#GUID-9540A82E-F83D-55F5-B441-868CF77468E9/GUID-CFED15B1-E768-534E-9043-7AADE45EE9AF">

    55 <linktext>Media Drivers</linktext></link>

    56 </related-links></concept>