// 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
 @internalComponent
*/

#ifndef CMTPTYPEDEVICEINFO_H
#define CMTPTYPEDEVICEINFO_H

#include <e32std.h>
#include <mtp/cmtptypecompoundbase.h>

class CMTPTypeArray;
class CMTPTypeString;

//

/** 
Defines the MTP DeviceInfo dataset. The DeviceInfo dataset provides a 
description of the MTP device and is generated in response to a GetDeviceInfo
operation request.
@internalComponent
*/ 
class CMTPTypeDeviceInfo : public CMTPTypeCompoundBase
    {
public:

    /**
    MTP DeviceInfo dataset element identifiers.
    */
    enum TMTPDeviceInfoElement
        {
        /**
        Standard Version.
        */
        EStandardVersion,
        
        /**
        MTP Vendor Extension ID.
        */
        EMTPVendorExtensionID,
        
        /**
        MTP Version.
        */
        EMTPVersion,
        
        /**
        MTP Extensions.
        */
        EMTPExtensions, 
        
        /**
        Functional Mode.
        */
        EFunctionalMode,
        
        /**
        Operations Supported.
        */
        EOperationsSupported,
        
        /**
        Events Supported.
        */
        EEventsSupported,
        
        /**
        Device Properties Supported.
        */
        EDevicePropertiesSupported,
        
        /**
        Capture Formats.
        */
        ECaptureFormats,
        
        /**
        Playback Formats.
        */
        EPlaybackFormats,
        
        /**
        Manufacturer.
        */
        EManufacturer,
        
        /**
        Model.
        */
        EModel,  
        
        /**
        Device Version.
        */
        EDeviceVersion,
        
        /**
        Serial Number.
        */
        ESerialNumber,
        
        /**
        The number of dataset elements.
        */
        ENumElements,
        };

public:
    
    static CMTPTypeDeviceInfo* NewL();
    static CMTPTypeDeviceInfo* NewLC();
    
    virtual ~CMTPTypeDeviceInfo();   
     
public: // From MMTPType

    TUint Type() const;
        
private: // From CMTPTypeCompoundBase
    
    const TElementInfo& ElementInfo(TInt aElementId) const;

private:

    CMTPTypeDeviceInfo();
    void ConstructL();

    MMTPType* NewArrayChunkL(const TElementInfo& aElementInfo);
    MMTPType* NewFlatChunkL(const TElementInfo& aElementInfo);
    MMTPType* NewStringChunkL(const TElementInfo& aElementInfo);
    MMTPType* NewUInt16Chunk(const TElementInfo& aElementInfo);

private:
        
    /**
    Data chunk identifiers.
    */
    enum TChunkIds
        {
        /**
        The flat data chunk ID.
        */
        EIdFlatChunk,
        
        /**
        The EMTPExtensions element data chunk ID.
        */
        EIdMTPExtensionsChunk,
        
        /**
        The EFunctionalMode element data chunk ID.
        */
        EIdFunctionalModeChunk,
        
        /**
        The EOperationsSupported element data chunk ID.
        */
        EIdOperationsSupportedChunk,
        
        /**
        The EEventsSupported element data chunk ID.
        */
        EIdEventsSupportedChunk,
        
        /**
        The EDevicePropertiesSupported element data chunk ID.
        */
        EIdDevicePropertiesSupportedChunk,
        
        /**
        The ECaptureFormats element data chunk ID.
        */
        EIdCaptureFormatsChunk,
        
        /**
        The EPlaybackFormats element data chunk ID.
        */
        EIdPlaybackFormatsChunk,
        
        /**
        The EPlaybackFormats element data chunk ID.
        */
        EIdManufacturerChunk,
        
        /**
        The EModel element data chunk ID.
        */
        EIdModelChunk,
        
        /**
        The EDeviceVersion element data chunk ID.
        */
        EIdDeviceVersionChunk,
        
        /**
        The ESerialNumber element data chunk ID.
        */
        EIdSerialNumberChunk,
        
        /**
        The number of data chunks.
        */
        EIdNumChunks
        };
    
    /**
    The dataset element metadata table content.
    */
    static const CMTPTypeCompoundBase::TElementInfo iElementMetaData[];
    
    /**
    The dataset element metadata table.
    */
    const TFixedArray<TElementInfo, ENumElements>   iElementInfo;
    
    /**
    The flat data chunk comprising elements EStandardVersion to EMTPVersion.
    */
    RMTPTypeCompoundFlatChunk                       iChunkFlat;
    
    /**
    The EFunctionalMode data chunk.
    */
    TMTPTypeUint16                                  iChunkFunctionalMode;
    
    /**
    The MTP array type data chunks (EOperationsSupported, EEventsSupported, 
    EDevicePropertiesSupported, ECaptureFormats, and EPlaybackFormats). 
    */
    RPointerArray<CMTPTypeArray>                    iArrayChunks;
    
    /**
    The MTP string type data chunks (EManufacturer, EModel, EDeviceVersion, and 
    ESerialNumber).
    */
    RPointerArray<CMTPTypeString>                   iStringChunks;
    };
    
#endif // CMTPTYPEDEVICEINFO_H