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-16218C7E-B927-5729-9A05-680A3D0D8BDE" xml:lang="en"><title>File Data

    13 Provider Configuration Parameters</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>The File Data Provider plug-in can be configured using the <codeph>MTP_FILEDP_CONFIG</codeph> resource. <codeph>MTP_FILEDP_CONFIG</codeph> is

    15 then used as the <codeph>opaque_resource</codeph> within an <codeph>MTP_DATA_PROVIDER</codeph> resource.

    16 These resources are defined in <filepath>mtpfiledp_config.rss</filepath> as

    17 shown below. The file is compiled and exported as <filepath>z:/resource/mtp/102827B0.rsc</filepath>  </p>

    18 <section><title>Syntax</title><p>The configurable parameters are: </p><ul>

    19 <li id="GUID-A72A150C-4297-5FEF-8E74-C4B398028699"><p> <b>Object Enumeration

    20 Iteration Length</b>: This parameter configures object store enumeration by

    21 specifying the maximum number of data objects to be enumerated on each iteration

    22 of the process. Its purpose is to ensure that reasonable active scheduler

    23 RunL durations are maintained. </p> </li>

    24 <li id="GUID-32798FE7-C471-510E-99EA-5ADFD23B778C"><p> <b> File Format Exclusion

    25 List</b>: This parameter specifies the set of Symbian file system file formats

    26 which are excluded from the object enumeration process. </p> </li>

    27 <li id="GUID-35441470-D26D-59EB-9E13-334E0361A88F"><p> <b>Extension Map</b>:

    28 This parameter specifies the set of the mapping file extensions for the file

    29 codes in the <codeph>format_exclusion_list</codeph>. </p> </li>

    30 </ul> </section>

    31 <example><codeblock xml:space="preserve">#include &lt;ecom/registryinfo.rh&gt;

    32 #include <mtp/mtpdpinfo.rh>

    33 #include "mtpfiledp_config.rh"

    34 

    35 RESOURCE MTP_DATA_PROVIDER dpConfig

    36     {

    37     type = EMtpDataTypeEcom;

    38     major_version = 1;

    39     object_enumeration_persistent = 0;

    40     supported_modes = KMtpModeMTP;  

    41     server_name = "";

    42     server_image_name = "";

    43     opaque_resource = fileConfig;

    44     }

    45 

    46 RESOURCE MTP_FILEDP_CONFIG fileConfig

    47     {

    48     enumeration_iteration_length = 32;

    49     format_exclusion_list = {

    50         // Association 

    51         0x3009  //mp3 code added to exclusion list, handled by Music Data Provider.

    52         };

    53 

    54     extension_map = {

    55    

    56    MTP_FILEDP_EXTENSION_MAP // mp3 added to extension map, handled by Music Data Provider.

    57    {

    58    file_extension = "mp3";

    59    mtp_object_format = 0x3009;

    60    },

    61    ...

    62         };

    63     }

    64 ...</codeblock></example>

    65 </conbody></concept>