Creating an MTP Data Provider Plug-in

If the data provider is included in the ROM (z: drive), edit the configuration files directly as follows:

1. 
   Edit mtpfiledp_config.rss, the File Data Provider configuration resource file, using a text editor. Add the file format code to the format_exclusion_list section and add its mapping file extension to the extension_map section. For example a Music Data Provider is to be included in the ROM. The Music Data Provider supports .mp3, whose file format code is 0x3009. The mtpfiledp_config.rss file must be configured as follows:

   RESOURCE MTP_FILEDP_CONFIG fileConfig
   {
       enumeration_iteration_length = 32;
       format_exclusion_list = {
       //Association
       0x3001,
       0x3009 //mp3 code added to exclusion list, handled by Music Data Provider.
       };
       
       extension_map = 
       {
         ...
         MTP_FILEDP_EXTENSION_MAP // mp3 added to extension map, handled by Music Data Provider.
         {
         file_extension = "mp3";
         mtp_object_format = 0x3009;
         },
        
        ...
        };
   
   }

2. 
   Edit mtpdevicedp_config.rss, the Device Data Provider configuration resource file, using a text editor. Add the folder or drive to save the supported data to the folder_exclusion_list section, for example c:\media\music.

   RESOURCE MTP_DEVICEDP_CONFIG folderConfig
       {
       enumeration_iteration_length = 32;
       folder_exclusion_list = 
           {
           ...
   
           "c:\\media\\music\\",
           ...
   
           };
       }

Data provider installed via SIS file

If the data provider is installed via SIS file, MMTPDataProvider::Supported() and MMTPDataProvider::SupportedL() must be implemented for the folder and file exclusion lists.

For example after a phone is shipped, the Music Data Provider can be installed via SIS files to the phone. The Music Data Provider supports .mp3, whose file format code is 0x3009. MP3 files are saved under c:\media\music. The following snippet of code shows an implementation of the two methods.

/**
define all the operations that are supported by the music data provider
*/
static const TUint16 KMTPMusicDpSupportedFormats[] =
    {
    EMTPFormatCodeWMA,
    EMTPFormatCodeMP3
    };

...

void CMTPMusicDataProvider::Supported(TMTPSupportCategory aCategory, RArray<TUint>& aArray) const
    {
    switch (aCategory) 
        {      
    case EObjectCaptureFormats:
    case EObjectPlaybackFormats:
           {
           TInt count = sizeof(KMTPMusicDpSupportedFormats) / sizeof(TUint16);
           for(TInt i = 0; i < count; i++)
                {
                aArray.Append(KMTPMusicDpSupportedFormats[i]);
                }
        }
        break;
                     
    default:
        break;
        }
    }

void CMTPMusicDataProvider::SupportedL(TMTPSupportCategory aCategory, CDesCArray& aStrings) const
    {
    switch (aCategory) 
        {
    case EFolderExclusionSets:
         {
         //Hardcoded path, can be read from a resource file.
         _LIT(KMusicDPRootDir, "c:\\media\\music\\*");
         aStrings.AppendL(KMusicDPRootDir);
          }
          break;
    case EFormatExtensionSets:
         {
         _LIT(KFormatExtensionMP3, "0x3009:MP3");
         aStrings.AppendL(KFormatExtensionMP3);
         }
         break;
    
    default:
         break;
        }
    }
...