Symbian3/PDK/Source/GUID-79735B25-B4E9-5166-B87A-054080DF9122.dita
changeset 5 f345bda72bc4
child 14 578be2adaf3e
equal deleted inserted replaced
4:4816d766a08a 5:f345bda72bc4
       
     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-79735B25-B4E9-5166-B87A-054080DF9122" xml:lang="en"><title>Patchable
       
    13 Constants: KDiscoveryDisabledDriveList</title><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    14 <codeblock id="GUID-11409345-54FC-5483-BED6-6C3AFFC19B91" xml:space="preserve"># define ECOM_PATCHDATA_KDISCOVERYDISABLEDDRIVELIST 0x0
       
    15 </codeblock>
       
    16 <table id="GUID-761B3924-D3BE-5568-AEFA-C1D4B4D73AF3">
       
    17 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
       
    18 <tbody>
       
    19 <row>
       
    20 <entry><p>Defined in: </p> </entry>
       
    21 <entry><p> <filepath>                 .../os/ossrv/lowlevellibsandfws/pluginfw/framework/frame/ecompatchdataconstantv2.cpp</filepath> </p> </entry>
       
    22 </row>
       
    23 <row>
       
    24 <entry><p>Purpose: </p> </entry>
       
    25 <entry><p>This constant lets device creators specify which drives they do
       
    26 not want ECom to scan, perhaps because of a platform decision not to support
       
    27 plugins (or any kind of executable binary) on certain drives e.g. MMC cards.
       
    28 Note that the Read Only Internal <filepath>Z:</filepath> drive cannot be disabled. </p> <p> <codeph> KDiscoveryDisabledDriveList</codeph> is
       
    29 a 32-bit integer with each bit representing a drive to disable, e.g. <codeph>0x1</codeph> disables
       
    30 drive A, <codeph>0x2</codeph> disables drive B etc. Only 25 drives can be
       
    31 specified (<filepath>Z:</filepath> is not allowed) therefore the 7 most significant
       
    32 bits are ignored. If you want to disable scanning on drives <filepath>E:</filepath> and <filepath>K:</filepath>,
       
    33 the patched value is: </p> <codeblock id="GUID-14A08DB9-FFB8-5E1C-8952-9713086A166F" xml:space="preserve">1 &lt;&lt; EDriveE | 1 &lt;&lt; EDriveK = 0x00000410.
       
    34 </codeblock> <p>See <filepath>f32file.h</filepath> for the enum <codeph>TDriveNumber</codeph>. </p> </entry>
       
    35 </row>
       
    36 </tbody>
       
    37 </tgroup>
       
    38 </table>
       
    39 <p>ECom uses a customized scheme to handle patchable constants. Device creators
       
    40 should follow the scheme described below to set patch values: </p>
       
    41 <ul>
       
    42 <li id="GUID-CACEB241-0ADE-5BC1-89E9-D84E68A4A6E7"><p>Each patchable constant
       
    43 is represented by a macro listed in <filepath>\epoc32\rom\include\ecompatchconstants.hby</filepath>.
       
    44 The macros in the HBY file are all commented out. </p> </li>
       
    45 <li id="GUID-C170972B-B993-58F5-98A3-78E92A855ABC"><p>To activate a patch
       
    46 macro, uncomment the line and change the example value in the line to your
       
    47 custom value. </p> </li>
       
    48 </ul>
       
    49 </conbody></concept>