<?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 xml:lang="en" id="GUID-C6EA2CFE-EA35-5B05-8103-B06A87BE1828"><title>MTP Data Types Overview</title><shortdesc>The MTP Data Types library implements the MTP data types. The implemented data types closely represent the raw MTP data streaming encoding and are optimized for the streaming performance. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody><section><title>MTP Data Types library details</title> <p>The DLL that provides the functionality and the library to which your code must link is identified below. </p> <table id="GUID-D6364FB8-5982-5DA0-AF63-31F6F526B716"><tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><thead><row><entry>DLL</entry> <entry>LIB</entry> <entry>Short description</entry> </row> </thead> <tbody><row><entry><p> <filepath>mtpdatatypes.dll</filepath>  </p> </entry> <entry><p> <filepath>mtpdatatypes.lib</filepath>  </p> </entry> <entry><p>This file is used to represent the MTP data types or provide a common interface for writing new data types. </p> </entry> </row> </tbody> </tgroup> </table> </section> <section><title>Description</title> <p>There are two kinds of MTP data defined in the MTP specification: </p> <ul><li id="GUID-2E3EBB0D-22AB-57CE-9CFD-A1488FEC8D01"><p> <b>Data</b> used in MTP operations, responses or events. It can be data passed as a parameter to an MTP operation, response or event, or dataset transferred for an operation request. For example, if a host PC sends the <codeph>GetServiceInfo</codeph> operation request to a device, the host PC expects the <codeph>ServiceInfo</codeph> dataset from the device. </p> </li> <li id="GUID-9FA2573C-09C6-588E-9CE7-44334D7A3156"><p> <b>Media data file</b> transferred between an initiator and a responder. The MTP specification refers it to as binary object data or object data. The <codeph>GetObject</codeph> operation and <codeph>SendObject</codeph> operations transfer the object binary data. </p> </li> </ul> <p>The MTP Data Types library supports the above kinds of MTP data. When the Symbian MTP Framework receives a request (from a host PC or a device) for MTP data, it loads the corresponding <xref href="GUID-EA9D7B60-C4EA-5D29-9296-3E4C8B973F59.dita">data providers</xref>. The data providers process the dataset or binary data file using the Data Types library and pass it to the Framework. The Framework can then transfer the data to the host PC, or use it as a parameter in an operation, response or event. </p> <p>The Data Types library provides four types of data: Simple, Flat, Complex and Compound. Simple data type implements MTP integer data types while Flat, Complex and Compound data types implement <xref href="GUID-FD2BCFE4-27DC-3E6E-96E3-5E5EE7B9EDBD.dita"><apiname>MMTPType</apiname></xref> interface. </p> <p> <b>Note</b>: Binary object data is represented by <xref href="GUID-E9359E92-6521-3438-B32B-0285B4863A61.dita"><apiname>CMTPTypeFile</apiname></xref> which is a complex data type. </p> </section> <section><title>APIs</title> <p> <b> Simple data type</b> –a single integer value. </p> <table id="GUID-9E407A3E-8A6C-5E89-90FB-E6764AE485EB"><tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/><thead><row><entry>API</entry> <entry>Description</entry> </row> </thead> <tbody><row><entry><p> <xref href="GUID-5775EA1E-364F-31E0-9E90-5F872D345DD1.dita"><apiname>TMTPTypeInt8</apiname></xref>, </p> <p> <xref href="GUID-B703DB95-CEB8-32D2-B096-A4F435E44D9A.dita"><apiname>TMTPTypeInt16</apiname></xref>, </p> <p> <xref href="GUID-D09E696D-CCCC-35BB-AB41-22B49935B07C.dita"><apiname>TMTPTypeInt32</apiname></xref>, </p> <p> <xref href="GUID-AF1326F6-F908-3E96-BAF0-741149C6CA61.dita"><apiname>TMTPTypeInt64</apiname></xref>, </p> <p> <xref href="GUID-CDB84775-DA1D-3B04-ABD3-2E3F07CF545B.dita"><apiname>TMTPTypeInt128</apiname></xref>  </p> </entry> <entry><p>Implements the MTP signed 8, 16, 32, 64, and 128-bit integer data types respectively. </p> </entry> </row> <row><entry><p> <xref href="GUID-74FAE9F6-F485-3BFC-A2A4-5D1B2E364547.dita"><apiname>TMTPTypeUint8</apiname></xref>, </p> <p> <xref href="GUID-459E3806-39BF-3670-906F-3DC1E6B52532.dita"><apiname>TMTPTypeUint16</apiname></xref>, </p> <p> <xref href="GUID-E9C7ADF5-1024-3AB1-AA49-ED2F871377B1.dita"><apiname>TMTPTypeUint32</apiname></xref>, </p> <p> <xref href="GUID-97111086-198D-3602-B8EE-793A46FDD63E.dita"><apiname>TMTPTypeUint64</apiname></xref>, </p> <p> <xref href="GUID-BC423A03-5D06-3A24-938E-8E2659F73A79.dita"><apiname>TMTPTypeUint128</apiname></xref>  </p> </entry> <entry><p>Implements the MTP unsigned 8, 16, 32, 64, and 128-bit integer data types respectively. </p> </entry> </row> </tbody> </tgroup> </table> <p> <b> Flat data type</b> –a fixed-length collection of simple descrete data values. For example,<xref href="GUID-22FA2C54-7FC1-3973-AE71-A43386D44D9A.dita"><apiname>TMTPTypeEvent</apiname></xref> consists of seven elements. Each is a simple data type which can be different. </p> <codeblock id="GUID-F76A42BF-7542-5CA0-B0DA-A4FC566336B3" xml:space="preserve">class TMTPTypeEvent : public TMTPTypeFlatBase

    {    

public: 

    /**

    MTP event dataset element identifiers.

    */

    enum TElements

        {        

        /**

        Event Code, 

        */

        EEventCode,  //TMTPTypeUint32 

        /**

        SessionID.

        */

        EEventSessionID,  //TMTPTypeUint32

        /**

        TransactionID  

        */

        EEventTransactionID,  //TMTPTypeUint32

        /**

        Parameter 1.

        */

        EEventParameter1,  //TMTPTypeUint32

        /**

        Parameter 2.

        */

        EEventParameter2,  //TMTPTypeUint32

        /**

        Parameter 3.

        */

        EEventParameter3,  //TMTPTypeUint32

        /**

        The number of dataset elements.

        */

        ENumElements,  //TMTPTypeUint32

        };

</codeblock> <p>The following diagram shows the flat classes and their relationships. </p> <fig id="GUID-1FB1AF83-3A53-564E-9997-5C4AC4AFB4EA"><title>

             Flat data type 

             Complex data type 

             Compound data type-base classes