MMTPFrameworkConfig Class Reference

class MMTPFrameworkConfig

Defines the framework configurability parameter interface.

The MTP framework implements a number of configurability parameters using a central repository. The initial set of configurability parameters are loaded from a compiled (binary) initialisation file. Read only access to the framework configurability data is available for reference purposes using this interface. Write access to these parameters is only available to the MTP framework.

Public Member Functions
voidGetValueL(TParameter, TDes &)
voidGetValueL(TParameter, TUint &)
voidGetValueL(TParameter, TBool &)
voidGetValueL(TParameter, RArray< TUint > &)
HBufC *ValueL(TParameter)
Public Member Enumerations
enumTParameter {
EDeviceFriendlyName = 0x00000000, ESynchronizationPartnerName = 0x00000001, ERamDriveMetadataStorageEnable = 0x00000002, ELogicalStorageIdsAllocationEnable = 0x00000003, EDefaultStorageDrive = 0x00000004, EDefaultObjectFormatCode = 0x00000005, EPackageStubUID = 0x00000006, ETransportHighPriorityUID = 0x00000007, ETransportSwitchEnabled = 0x00000008, EDeviceDefaultFuncationalID = 0x00000010, EDeviceCurrentFuncationalID = 0x00000011, EDeviceDefaultModelID = 0x00000012, EDeviceCurrentModelID = 0x00000013, EAbnormalDown = 0x00000014, EExcludedStorageDrives = 0x00010000
}

Member Functions Documentation

GetValueL(TParameter, TDes &)

voidGetValueL(TParameteraParam,
TDes &aValue
)const [pure virtual]
Provides the value of a descriptor configurability parameter. This should be used when the length of the parameter value is known not to exceed the capacity of the parameter value buffer. If the maximum parameter length is not known then the ValueL method should be used.
leave
One of the system wide error codes, if a processing failure occurs.

Parameters

TParameter aParamThe identifier of the parameter value to be retrieved
TDes & aValueThe parameter value buffer to be filled.

GetValueL(TParameter, TUint &)

voidGetValueL(TParameteraParam,
TUint &aValue
)const [pure virtual]
Provides the value of an unsigned integer configurability parameter.
leave
One of the system wide error codes, if a processing failure occurs.

Parameters

TParameter aParamThe identifier of the parameter value to be retrieved
TUint & aValueThe parameter value buffer to be filled.

GetValueL(TParameter, TBool &)

voidGetValueL(TParameteraParam,
TBool &aValue
)const [pure virtual]
Provides the value of a boolean configurability parameter.
leave
One of the system wide error codes, if a processing failure occurs.

Parameters

TParameter aParamThe identifier of the parameter value to be retrieved
TBool & aValueThe parameter value buffer to be filled.

GetValueL(TParameter, RArray< TUint > &)

voidGetValueL(TParameteraParam,
RArray< TUint > &aArray
)const [pure virtual]
Provides the value of an unsigned integer array configurabilitt parameter.
leave
One of the system wide error codes, if a processing failure occurs.

Parameters

TParameter aParamThe identifier of the parameter value to be retrieved
RArray< TUint > & aArray

ValueL(TParameter)

HBufC *ValueL(TParameteraParam)const [pure virtual]
Provides the value of a descriptor configurability parameter. This should be used when the maximum length of the parameter value is not known.
leave
One of the system wide error codes, if a processing failure occurs.

Parameters

TParameter aParamThe identifier of the parameter value to be retrieved.

Member Enumerations Documentation

Enum TParameter

Defines the framework configurability parameters.

Enumerators

EDeviceFriendlyName = 0x00000000

This parameter defines the Device Friendly Name MTP device property value. It is implemented as a string and has a maximum length of 254 characters. The parameter value specified in the initialisation file may be overwritten in the course of MTP operational processing, if an MTP SetDevicePropValue specifying the Device Friendly Name device property is received.

This parameter value can be retrieved as either TDes or HBufC values.

ESynchronizationPartnerName = 0x00000001

This parameter defines the Synchronization Partner MTP device property value. It is implemented as a string and has a maximum length of 254 characters. The parameter value specified in the initialisation file may be overwritten in the course of MTP operational processing, if an MTP SetDevicePropValue specifying the Synchronization Partner device property is received.

This parameter value can be retrieved as either TDes or HBufC values.

ERamDriveMetadataStorageEnable = 0x00000002

This parameter is reserved for future use.

ELogicalStorageIdsAllocationEnable = 0x00000003

This parameter indicates if the framework will allocate MTP logical storage IDs. If set to ETrue, then the framework will allocates a single logical storage ID on each of the available Symbian OS file system drives as they become available. If set to EFalse then the framework will not allocate any MTP logical storage IDs, in which case the active data providers are responsible for doing so using the MMTPStorageMgr interface.This parameter value can be retrieved as an TBool value.

EDefaultStorageDrive = 0x00000004

This parameter specifies the Symbian OS file system drive which acts as the default MTP storage ID (0x00000000). It is implemented as an integer value which represents the default drive using a zero based numbering scheme (i.e. 0 represents the A drive, 25 represents the Z drive etc.) or a MTP storage ID(assigned by the MTP framework).

This parameter value can be retrieved as an TUint value.

EDefaultObjectFormatCode = 0x00000005

This parameter specifies the device's default MTP Object Format Code. This format is used when processing MTP operation which specify a default (0x00000000) ObjectFormatCode parameter (e.g. InitiateCapture, InitiateOpenCapture).

This parameter value can be retrieved as an TUint value.

EPackageStubUID = 0x00000006

UID of the Stub SIS File This is used by the framework while loading the dataprovider. This parameter value can be retrieved as an TUint value.

ETransportHighPriorityUID = 0x00000007

Implimentation UID of transport PlugIn with high priority. This is used when ETransportSwitchEnabled is enabled.when MTP client try to start a transport protocol while another one already exist, if the new one is equal to this parameter value, the previous protocol plugin will be stopped and the new transport protocol plugin will be started.

This value can be retrieved as an value.

ETransportSwitchEnabled = 0x00000008

Transport protocol implementation switch enable flag. If set to ETrue, the switch is allowed;if set to EFalse, the switch is not allowed. Refer to ETransportHighPriorityUID for more details.

This value can be retrieved as an TBool value.

EDeviceDefaultFuncationalID = 0x00000010
EDeviceCurrentFuncationalID = 0x00000011
EDeviceDefaultModelID = 0x00000012
EDeviceCurrentModelID = 0x00000013
EAbnormalDown = 0x00000014
EExcludedStorageDrives = 0x00010000

This parameter specifies the Symbian OS file system drives which are excluded from the set of MTP storages which are managed by the MTP framework. Any drive which is identified in this set will not be assigned a corresponding MTP storage ID value by the MTP framework. This parameter is implemented as an array of integer values each of which represent an excluded drive using a zero based numbering scheme (i.e. 0 represents the A drive, 25 represents the Z drive etc.)

This parameter value can be retrieved as an RArray<TUint> value.