// Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "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:

//

// Description:

//

/**

 @file

 @publishedPartner

 @released

*/

#ifndef MTPPROTOCOLCONSTANTS_H

#define MTPPROTOCOLCONSTANTS_H

#include <e32def.h>

/** 

Defines constant values specified by the MTP protocol.

@publishedPartner

@released 

*/

/**

The null MTP 32-bit value.

@publishedPartner

@released 

*/

const TUint32 KMTPNotSpecified32(0x00000000);

/**

The MTP ObjectFormatCode that indicates that an operation or event applies to 

all valid MTP ObjectFormatCodes.

@publishedPartner

@released 

*/

const TUint32 KMTPFormatsAll(0x00000000);

/**

The MTP parameter value that indicates that free space counted in number of 

objects on a storage is not supported.

@publishedPartner

@released 

*/

const TUint32 KMTPFreeSpaceUnsupported(0xFFFFFFFF);

/**

The MTP ObjectHandle that indicates that an operation or event applies to all 

valid ObjectHandles.

@publishedPartner

@released 

*/

const TUint32 KMTPHandleAll(0xFFFFFFFF);

/**

The MTP ObjectHandle that indicates that an operation or event applies to all 

valid root level ObjectHandles.

@publishedPartner

@released 

*/

const TUint32 KMTPHandleAllRootLevel(0x00000000);

/**

The null MTP ObjectHandle value.

@publishedPartner

@released 

*/

const TUint32 KMTPHandleNone(0x00000000);

/**

The MTP ObjectHandle that indicates that an data object does have an assigned 

parent data object.

@publishedPartner

@released 

*/

const TUint32 KMTPHandleNoParent(0xFFFFFFFF);

/**

The MTP ObjectPropCode value that indicates an operation or event applies to all 

all valid MTP ObjectPropCodeS.

@publishedPartner

@released 

*/

const TUint32 KMTPObjectPropCodeAll(0xFFFFFFFF);

/**

The MTP SessionID value that indicates an operation or event applies to all 

active MTP sessions.

@publishedPartner

@released 

*/

const TUint32 KMTPSessionAll(0xFFFFFFFF);

/**

The MTP SessionID value that indicates an operation or event occurs outside of

an active MTP sessions

@publishedPartner

@released 

*/

const TUint32 KMTPSessionNone(0x00000000);

/**

The MTP StorageID that indicates that an operation or event applies to all 

valid MTP StorageIDs.

@publishedPartner

@released 

*/

const TUint32 KMTPStorageAll(0xFFFFFFFF);

/**

The MTP StorageID that indicates that an operation or event applies to the 

default MTP StorageID.

@publishedPartner

@released 

*/

const TUint32 KMTPStorageDefault(0x00000000);

/**

The null MTP TransactionID value.

@publishedPartner

@released 

*/

const TUint32 KMTPTransactionIdNone(0x00000000);

/**

The first in the sequence of valid MTP TransactionIDs. TransactionIDs increment

sequentially from this value to KMTPTransactionIdLast and then wrap around to 

this value.

@publishedPartner

@released 

*/

const TUint32 KMTPTransactionIdFirst(0x00000001);

/**

The last in the sequence of valid MTP TransactionIDs. TransactionIDs increment 

sequentially from KMTPTransactionIdFirst to this value and then wrap around to 

KMTPTransactionIdFirst.

@publishedPartner

@released 

*/

const TUint32 KMTPTransactionIdLast(0xFFFFFFFF);

/**

The MTP DataProvider that indicates that an Data base searching operation is applied to objects

owned by any data providers.

@publishedPartner

@released 

*/

const TUint32 KMTPDataProviderAll(0xFFFFFFFF);

const TUint32 KMTPNewPicKey(0x2001FCAE);

const TUint32 KMTPServerUID(0x102827A2);

/**

The MTP functional modes. For a description of these modes, please refer to the 

"Media Transfer Protocol Enhanced" specification.

@publishedPartner

@released 

*/

enum TMTPFunctionalMode

    {

    EMTPFunctionalModeStandard              = 0x0000,

    EMTPFunctionalModeSleepState            = 0x0001,

    EMTPFunctionalModeReservedStart         = 0x0002,

    EMTPFunctionalModeReservedEnd           = 0x7FFF,

    EMTPFunctionalModeNonResponsivePlayback = 0xC001,

    EMTPFunctionalModeResponsivePlayback    = 0xC002,

    EMTPFunctionalModeVendorExtStart        = 0x8000,

    EMTPFunctionalModeVendorExtEnd          = 0xBFFF,

    EMTPFunctionalModeStandardStart         = 0xC000,

    EMTPFunctionalModeStandardEnd           = 0xFFFF

    };

/** 

The MTP Datacode Summary. For a description of these datacodes, please refer

to the "Media Transfer Protocol Enhanced" specification.

@publishedPartner

@released 

*/

enum TMTPDatacodeSummary

    {

    EMTPCodeUndefined1Start                 = 0x0000,

    EMTPCodeUndefined1End                   = 0x0FFF,

    EMTPCodePTPOperationCodeStart           = 0x1000,

    EMTPCodePTPOperationCodeEnd             = 0x1FFF,

    EMTPCodePTPResponseCodeStart            = 0x2000,

    EMTPCodePTPResponseCodeEnd              = 0x2FFF,

    EMTPCodePTPObjFormatCodeStart           = 0x3000,

    EMTPCodePTPObjFormatCodeEnd             = 0x3FFF,

    EMTPCodePTPEventCodeStart               = 0x4000,

    EMTPCodePTPEventCodeEnd                 = 0x4FFF,

    EMTPCodePTPDevicePropCodeStart          = 0x5000,

    EMTPCodePTPDevicePropCodeEnd            = 0x5FFF,

    EMTPCodePTPReserved1CodeStart           = 0x6000,

    EMTPCodePTPReserved1CodeEnd             = 0x6FFF,

    EMTPCodePTPReserved2CodeStart           = 0x7000,

    EMTPCodePTPReserved2CodeEnd             = 0x7FFF,

    EMTPCodeUndefined2CodeStart             = 0x8000,

    EMTPCodeUndefined2CodeEnd               = 0x8FFF,

    EMTPCodeVenderExtnOpCodeStart           = 0x9000,

    EMTPCodeVenderExtnOpCodeEnd             = 0x97FF,

    EMTPCodeMTPOperationCodeStart           = 0x9800,

    EMTPCodeMTPOperationCodeEnd             = 0x9FFF,

    EMTPCodeVenderExtnRespCodeStart         = 0xA000,

    EMTPCodeVenderExtnRespCodeEnd           = 0xA7FF,

    EMTPCodeMTPRespCodeStart                = 0xA800,

    EMTPCodeMTPRespCodeEnd                  = 0xAFFF,

    EMTPCodeVenderExtnObjFormatCodeStart    = 0xB000,

    EMTPCodeVenderExtnObjFormatCodeEnd      = 0xB7FF,

    EMTPCodeMTPObjFormatCodeStart           = 0xB800,

    EMTPCodeMTPObjFormatCodeEnd             = 0xBFFF,

    EMTPCodeVenderExtnEventCodeStart        = 0xC000,

    EMTPCodeVenderExtnEventCodeEnd          = 0xC7FF,

    EMTPCodeMTPEventCodeStart               = 0xC800,

    EMTPCodeMTPEventCodeEnd                 = 0xCFFF,

    EMTPCodeVenderExtnDevicePropCodeStart   = 0xD000,

    EMTPCodeVenderExtnDevicePropCodeEnd     = 0xD3FF,

    EMTPCodeMTPDevicePropCodeStart          = 0xD400,

    EMTPCodeMTPDevicePropCodeEnd            = 0xD7FF,

    EMTPCodeVenderExtnObjectPropCodeStart   = 0xD800,

    EMTPCodeVenderExtnObjectPropCodeEnd     = 0xDBFF,

    EMTPCodeMTPObjectPropCodeStart          = 0xDC00,

    EMTPCodeMTPObjectPropCodeEnd            = 0xDFFF,

    EMTPCodePTPReserved3CodeStart           = 0xE000,

    EMTPCodePTPReserved3CodeEnd             = 0xEFFF,

    EMTPCodePTPReserved4CodeStart           = 0xF000,

    EMTPCodePTPReserved4CodeEnd             = 0xFFFF,

    };

/**

The MTP operation datacodes. For a description of these datacodes, please refer

to the "Media Transfer Protocol Enhanced" specification.

@publishedPartner

@released 

*/

enum TMTPOperationCode

    {

    EMTPOpCodePTPStart                  = 0x1000,

    EMTPOpCodeGetDeviceInfo             = 0x1001,

    EMTPOpCodeOpenSession               = 0x1002,

    EMTPOpCodeCloseSession              = 0x1003,

    EMTPOpCodeGetStorageIDs             = 0x1004,

    EMTPOpCodeGetStorageInfo            = 0x1005,

    EMTPOpCodeGetNumObjects             = 0x1006,

    EMTPOpCodeGetObjectHandles          = 0x1007,

    EMTPOpCodeGetObjectInfo             = 0x1008,

    EMTPOpCodeGetObject                 = 0x1009,

    EMTPOpCodeGetThumb                  = 0x100A,

    EMTPOpCodeDeleteObject              = 0x100B,

    EMTPOpCodeSendObjectInfo            = 0x100C,

    EMTPOpCodeSendObject                = 0x100D,

    EMTPOpCodeInitiateCapture           = 0x100E,

    EMTPOpCodeFormatStore               = 0x100F,

    EMTPOpCodeResetDevice               = 0x1010,

    EMTPOpCodeSelfTest                  = 0x1011,

    EMTPOpCodeSetObjectProtection       = 0x1012,

    EMTPOpCodePowerDown                 = 0x1013,

    EMTPOpCodeGetDevicePropDesc         = 0x1014,

    EMTPOpCodeGetDevicePropValue        = 0x1015,

    EMTPOpCodeSetDevicePropValue        = 0x1016,

    EMTPOpCodeResetDevicePropValue      = 0x1017,

    EMTPOpCodeTerminateOpenCapture      = 0x1018,

    EMTPOpCodeMoveObject                = 0x1019,

    EMTPOpCodeCopyObject                = 0x101A,

    EMTPOpCodeGetPartialObject          = 0x101B,

    EMTPOpCodeInitiateOpenCapture       = 0x101C,

    EMTPOpCodePTPEnd                    = 0x1FFF,

    EMTPOpCodeVendorExtensionStart      = 0x9000,

    EMTPOpCodeGetServiceIDs             = 0x9301,

    EMTPOpCodeGetServiceInfo            = 0x9302,

    EMTPOpCodeGetServiceCapabilities    = 0x9303,

    EMTPOpCodeGetServicePropDesc        = 0x9304,

    EMTPOpCodeGetServicePropList        = 0x9305,

    EMTPOpCodeSetServicePropList        = 0x9306,

    EMTPOpCodeUpdateObjectPropList      = 0x9307,

    EMTPOpCodeDeleteObjectPropList      = 0x9308,

    EMTPOpCodeDeleteServicePropList     = 0x9309,

    EMTPOpCodeGetFormatCapabilities     = 0x930A,

    EMTPOpCodeVendorExtextensionEnd     = 0x97FF,

    EMTPOpCodeMTPStart                  = 0x9800,

    EMTPOpCodeGetObjectPropsSupported   = 0x9801,

    EMTPOpCodeGetObjectPropDesc         = 0x9802,

    EMTPOpCodeGetObjectPropValue        = 0x9803,

    EMTPOpCodeSetObjectPropValue        = 0x9804,

    EMTPOpCodeGetObjectReferences       = 0x9810,

    EMTPOpCodeSetObjectReferences       = 0x9811,

    EMTPOpCodeSkip                      = 0x9820,

    EMTPOpCodeGetObjectPropList         = 0x9805,

    EMTPOpCodeSetObjectPropList         = 0x9806,

    EMTPOpCodeGetInterdependentPropDesc = 0x9807,

    EMTPOpCodeSendObjectPropList        = 0x9808,

    EMTPOpCodeGetSanAlertInfo           = 0x93E8,

    EMTPOpCodeMTPEnd                    = 0x9FFF    

    };

/**

The MTP response datacodes. For a description of these datacodes, please refer 

to the "Media Transfer Protocol Enhanced" specification.

@publishedPartner

@released 

*/

enum TMTPResponseCode

    {   

    EMTPRespCodePTPStart                                = 0x2000,

    EMTPRespCodeUndefined                               = 0x2000,

    EMTPRespCodeOK                                      = 0x2001,

    EMTPRespCodeGeneralError                            = 0x2002,

    EMTPRespCodeSessionNotOpen                          = 0x2003,

    EMTPRespCodeInvalidTransactionID                    = 0x2004,

    EMTPRespCodeOperationNotSupported                   = 0x2005,

    EMTPRespCodeParameterNotSupported                   = 0x2006,

    EMTPRespCodeIncompleteTransfer                      = 0x2007,

    EMTPRespCodeInvalidStorageID                        = 0x2008,

    EMTPRespCodeInvalidObjectHandle                     = 0x2009,

    EMTPRespCodeDevicePropNotSupported                  = 0x200A,

    EMTPRespCodeInvalidObjectFormatCode                 = 0x200B,

    EMTPRespCodeStoreFull                               = 0x200C,

    EMTPRespCodeObjectWriteProtected                    = 0x200D,

    EMTPRespCodeStoreReadOnly                           = 0x200E,

    EMTPRespCodeAccessDenied                            = 0x200F,

    EMTPRespCodeNoThumbnailPresent                      = 0x2010,

    EMTPRespCodeSelfTestFailed                          = 0x2011,

    EMTPRespCodePartialDeletion                         = 0x2012,

    EMTPRespCodeStoreNotAvailable                       = 0x2013,

    EMTPRespCodeSpecificationByFormatUnsupported        = 0x2014,

    EMTPRespCodeNoValidObjectInfo                       = 0x2015,

    EMTPRespCodeInvalidCodeFormat                       = 0x2016,

    EMTPRespCodeUnknownVendorCode                       = 0x2017,

    EMTPRespCodeCaptureAlreadyTerminated                = 0x2018,

    EMTPRespCodeDeviceBusy                              = 0x2019,

    EMTPRespCodeInvalidParentObject                     = 0x201A,

    EMTPRespCodeInvalidDevicePropValue                  = 0x201C,

    EMTPRespCodeInvalidParameter                        = 0x201D,

    EMTPRespCodeSessionAlreadyOpen                      = 0x201E,

    EMTPRespCodeTransactionCancelled                    = 0x201F,

    EMTPRespCodeSpecificationOfDestinationUnsupported   = 0x2020,

    EMTPRespCodePTPEnd                                  = 0x2FFF,

    EMTPRespCodeVendorExtensionStart                    = 0xA000,

    EMTPRespCodeInvalidServiceID                        = 0xA301,

    EMTPRespCodeInvalidServicePropCode                  = 0xA302,

    EMTPRespCodeVendorExtensionEnd                      = 0xA7FF,

    EMTPRespCodeMTPStart                                = 0xA800,

    EMTPRespCodeInvalidObjectPropCode                   = 0xA801,

    EMTPRespCodeInvalidObjectPropFormat                 = 0xA802,

    EMTPRespCodeInvalidObjectPropValue                  = 0xA803,

    EMTPRespCodeInvalidObjectReference                  = 0xA804,

    EMTPRespCodeGroupNotSupported						= 0xA805,

    EMTPRespCodeInvalidDataset                          = 0xA806,

    EMTPRespCodeSpecificationByGroupUnsupported         = 0xA807,

    EMTPRespCodeSpecificationByDepthUnsupported         = 0xA808,

    EMTPRespCodeObjectTooLarge                          = 0xA809,

    EMTPRespCodeObjectPropNotSupported                  = 0xA80A,

    EMTPRespCodeSANStored                               = 0xA391,

    EMTPRespCodeUserRejectedSAN                         = 0xA392,

    EMTPRespCodeSANParseError                           = 0xA393,

    EMTPRespCodeProfileMissing                          = 0xA394,

    EMTPRespCodeMTPEnd                                  = 0xAFFF   

    };

/**

The MTP object format datacodes. For a description of these datacodes, please 

refer to the "Media Transfer Protocol Enhanced" specification.

@publishedPartner

@released 

*/

enum TMTPFormatCode

    {

    EMTPFormatCodePTPStart                          = 0x3000,

    EMTPFormatCodeUndefined                         = 0x3000,

    EMTPFormatCodeAssociation                       = 0x3001,

    EMTPFormatCodeScript                            = 0x3002,

    EMTPFormatCodeExecutable                        = 0x3003,

    EMTPFormatCodeText                              = 0x3004,

    EMTPFormatCodeHTML                              = 0x3005,

    EMTPFormatCodeDPOF                              = 0x3006,

    EMTPFormatCodeAIFF                              = 0x3007,

    EMTPFormatCodeWAV                               = 0x3008,

    EMTPFormatCodeMP3                               = 0x3009,

    EMTPFormatCodeAVI                               = 0x300A,

    EMTPFormatCodeMPEG                              = 0x300B, 

    EMTPFormatCodeASF                               = 0x300C,

    EMTPFormatCodeImageDefined                      = 0x3800,

    EMTPFormatCodeEXIFJPEG                          = 0x3801,

    EMTPFormatCodeTIFFEP                            = 0x3802,

    EMTPFormatCodeFlashPix                          = 0x3803,

    EMTPFormatCodeBMP                               = 0x3804,

    EMTPFormatCodeCIFF                              = 0x3805,

    EMTPFormatCodeImageUndefined1                   = 0x3806,

    EMTPFormatCodeGIF                               = 0x3807,

    EMTPFormatCodeJFIF                              = 0x3808,

    EMTPFormatCodeCD                                = 0x3809,

    EMTPFormatCodePICT                              = 0x380A,

    EMTPFormatCodePNG                               = 0x380B,

    EMTPFormatCodeImageUndefined2                   = 0x380C,

    EMTPFormatCodeTIFF                              = 0x380D,

    EMTPFormatCodeTIFFIT                            = 0x380E,

    EMTPFormatCodeJP2                               = 0x380F,

    EMTPFormatCodeJPX                               = 0x3810,

    EMTPFormatCodePTPEnd                            = 0x3FFF,

    EMTPFormatCodeVendorExtStart                    = 0xB000,

    EMTPFormatCodeVendorExtDynamicStart            = EMTPFormatCodeVendorExtStart,

    EMTPFormatCodeVendorExtEnd                      = 0xB7FF,

    EMTPFormatCodeVendorExtDynamicEnd              = EMTPFormatCodeVendorExtEnd,

    EMTPFormatCodeMTPStart                          = 0xB800,

    EMTPFormatCodeUndefinedFirmware                 = 0xB802,

    EMTPFormatCodeWindowsImageFormat                = 0xB881,

    EMTPFormatCodeUndefinedAudio                    = 0xB900,

    EMTPFormatCodeWMA                               = 0xB901,

    EMTPFormatCodeOGG                               = 0xB902,

    EMTPFormatCodeAAC                               = 0xB903,

    EMTPFormatCodeAudible                           = 0xB904,

    EMTPFormatCodeFLAC                              = 0xB906,

    EMTPFormatCodeUndefinedVideo                    = 0xB980,

    EMTPFormatCodeWMV                               = 0xB981,

    EMTPFormatCodeMP4Container                      = 0xB982,

    EMTPFormatCodeMP2                               = 0xB983,

    EMTPFormatCode3GPContainer                      = 0xB984,

    EMTPFormatCodeAVCHD								= 0xB985,

    EMTPFormatCodeUndefinedCollection               = 0xBA00,

    EMTPFormatCodeAbstractMultimediaAlbum           = 0xBA01,

    EMTPFormatCodeAbstractImageAlbum                = 0xBA02,

    EMTPFormatCodeAbstractAudioAlbum                = 0xBA03,

    EMTPFormatCodeAbstractVideoAlbum                = 0xBA04,

    EMTPFormatCodeAbstractAudioVideoPlaylist        = 0xBA05,

    EMTPFormatCodeAbstractContactGroup              = 0xBA06,

    EMTPFormatCodeAbstractMessageFolder             = 0xBA07,

    EMTPFormatCodeAbstractChapteredProduction       = 0xBA08,

    EMTPFormatCodeAbstractAudioPlaylist             = 0xBA09,

    EMTPFormatCodeAbstractVideoPlaylist             = 0xBA0A,

    EMTPFormatCodeWPLPlaylist                       = 0xBA10,

    EMTPFormatCodeM3UPlaylist                       = 0xBA11,

    EMTPFormatCodeMPLPlaylist                       = 0xBA12,

    EMTPFormatCodeASXPlaylist                       = 0xBA13,

    EMTPFormatCodePLSPlaylist                       = 0xBA14,

    EMTPFormatCodeUndefinedDocument                 = 0xBA80,

    EMTPFormatCodeAbstractDocument                  = 0xBA81,

    EMTPFormatCodeXMLDocument                       = 0xBA82,

    EMTPFormatCodeMicrosoftWordDocument             = 0xBA83,

    EMTPFormatCodeMHTCompiledHTMLDocument           = 0xBA84,

    EMTPFormatCodeMicrosoftExcelSpreadsheet         = 0xBA85,

    EMTPFormatCodeMicrosoftPowerpointPresentation   = 0xBA86,

    EMTPFormatCodeUndefinedMessage                  = 0xBB00,

    EMTPFormatCodeAbstractMessage                   = 0xBB01,

    EMTPFormatCodeUndefinedContact                  = 0xBB80,

    EMTPFormatCodeAbstractContact                   = 0xBB81,

    EMTPFormatCodeVCard2                            = 0xBB82,

    EMTPFormatCodeMTPEnd                            = 0xBFFF 

    };

/**

The MTP event datacodes. For a description of these datacodes, please refer to 

the "Media Transfer Protocol Enhanced" specification.

@publishedPartner

@released 

*/

enum TMTPEventCode

    {

    EMTPEventCodePTPStart                   = 0x4000,

    EMTPEventCodeUndefined                  = 0x4000,

    EMTPEventCodeCancelTransaction          = 0x4001,

    EMTPEventCodeObjectAdded                = 0x4002,

    EMTPEventCodeObjectRemoved              = 0x4003,

    EMTPEventCodeStoreAdded                 = 0x4004,

    EMTPEventCodeStoreRemoved               = 0x4005,

    EMTPEventCodeDevicePropChanged          = 0x4006,

    EMTPEventCodeObjectInfoChanged          = 0x4007,

    EMTPEventCodeDeviceInfoChanged          = 0x4008,

    EMTPEventCodeRequestObjectTransfer      = 0x4009,

    EMTPEventCodeStoreFull                  = 0x400A,

    EMTPEventCodeDeviceReset                = 0x400B,

    EMTPEventCodeStorageInfoChanged         = 0x400C,

    EMTPEventCodeCaptureComplete            = 0x400D,

    EMTPEventCodeUnreportedStatus           = 0x400E,

    EMTPEventCodePTPEnd                     = 0x4FFF,

    EMTPEventCodeVendorExtensionStart       = 0xC000,

    EMTPEventCodeServiceAdded               = 0xC301,

    EMTPEventCodeServiceRemoved             = 0xC302,

    EMTPEventCodeServicePropChanged         = 0xC303,

    EMTPEventCodeMethodComplete             = 0xC304,

    EMTPEventCodeVendorExtensionEnd         = 0xC7FF,

    EMTPEventCodeMTPStart                   = 0xC800,

    EMTPEventCodeObjectPropChanged          = 0xC801,

    EMTPEventCodeObjectPropDescChanged      = 0xC802,

    EMTPEventCodeObjectReferencesChanged    = 0xC803,