CMidiClientUtility Class Reference

class CMidiClientUtility : public CBase

Utility class to provide a standard client interface to a MIDI controller.

Inherits from

Nested Classes and Structures

Public Member Functions
~CMidiClientUtility()
IMPORT_C TReal32ChannelVolumeL(TInt)
IMPORT_C TIntChannelsSupportedL()
IMPORT_C voidClose()
IMPORT_C TBoolCustomBankLoadedL(TInt)
IMPORT_C voidCustomCommandAsync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TDes8 &, TRequestStatus &)
IMPORT_C voidCustomCommandAsync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TRequestStatus &)
IMPORT_C voidCustomCommandSyncL(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TDes8 &)
IMPORT_C voidCustomCommandSyncL(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &)
IMPORT_C TInt64DurationMicroBeatsL()
IMPORT_C TTimeIntervalMicroSecondsDurationMicroSecondsL()
IMPORT_C TIntGetBalanceL()
IMPORT_C TIntGetBankIdL(TBool, TInt)
IMPORT_C MMMFDRMCustomCommand *GetDRMCustomCommand()
IMPORT_C TIntGetInstrumentIdL(TInt, TBool, TInt)
IMPORT_C voidGetInstrumentL(TInt, TInt &, TInt &)
IMPORT_C CMMFMetaDataEntry *GetMetaDataEntryL(TInt)
IMPORT_C TIntGetRepeats()
IMPORT_C HBufC *InstrumentNameL(TInt, TBool, TInt)
IMPORT_C TBoolIsChannelMuteL(TInt)
IMPORT_C TBoolIsTrackMuteL(TInt)
IMPORT_C voidLoadCustomBankDataL(const TDesC8 &, TInt &)
IMPORT_C voidLoadCustomBankL(const TDesC &, TInt &)
IMPORT_C voidLoadCustomInstrumentDataL(const TDesC8 &, TInt, TInt, TInt, TInt)
IMPORT_C voidLoadCustomInstrumentL(const TDesC &, TInt, TInt, TInt, TInt)
IMPORT_C TReal32MaxChannelVolumeL()
IMPORT_C TIntMaxPlaybackRateL()
IMPORT_C TIntMaxPolyphonyL()
IMPORT_C TIntMaxVolumeL()
IMPORT_C const TDesC8 &MimeTypeL()
IMPORT_C TIntMinPlaybackRateL()
IMPORT_C CMidiClientUtility *NewL(MMidiClientUtilityObserver &, TInt, TInt)
IMPORT_C CMidiClientUtility *NewL(MMidiClientUtilityObserver &, TInt, TInt, TBool)
IMPORT_C voidNoteOffL(TInt, TInt, TInt)
IMPORT_C voidNoteOnL(TInt, TInt, TInt)
IMPORT_C TIntNumTracksL()
IMPORT_C TIntNumberOfBanksL(TBool)
IMPORT_C TIntNumberOfInstrumentsL(TInt, TBool)
IMPORT_C TIntNumberOfMetaDataEntriesL()
IMPORT_C voidOpenDes(const TDesC8 &)
IMPORT_C voidOpenFile(const TDesC &)
IMPORT_C voidOpenFile(const RFile &)
IMPORT_C voidOpenFile(const TMMSource &)
IMPORT_C voidOpenUrl(const TDesC &, TInt, const TDesC8 &)
IMPORT_C HBufC *PercussionKeyNameL(TInt, TInt, TBool, TInt)
IMPORT_C TIntPitchTranspositionCentsL()
IMPORT_C voidPlay()
IMPORT_C voidPlayNoteL(TInt, TInt, const TTimeIntervalMicroSeconds &, TInt, TInt)
IMPORT_C voidPlayNoteL(TInt, TInt, const TTimeIntervalMicroSeconds &, const TTimeIntervalMicroSeconds &, TInt, TInt)
IMPORT_C TIntPlaybackRateL()
IMPORT_C TIntPolyphonyL()
IMPORT_C TInt64PositionMicroBeatsL()
IMPORT_C TTimeIntervalMicroSecondsPositionMicroSecondsL()
IMPORT_C TIntSendMessageL(const TDesC8 &)
IMPORT_C TIntSendMessageL(const TDesC8 &, const TTimeIntervalMicroSeconds &)
IMPORT_C voidSendMipMessageL(const RArray< TMipMessageEntry > &)
IMPORT_C voidSetBalanceL(TInt)
IMPORT_C voidSetBankL(TBool)
IMPORT_C voidSetChannelMuteL(TInt, TBool)
IMPORT_C voidSetChannelVolumeL(TInt, TReal32)
IMPORT_C voidSetInstrumentL(TInt, TInt, TInt)
IMPORT_C voidSetMaxPolyphonyL(TInt)
IMPORT_C TIntSetPitchTranspositionL(TInt)
IMPORT_C voidSetPlaybackRateL(TInt)
IMPORT_C voidSetPositionMicroBeatsL(TInt64)
IMPORT_C voidSetPositionMicroSecondsL(const TTimeIntervalMicroSeconds &)
IMPORT_C voidSetPriorityL(TInt, TInt)
IMPORT_C voidSetRepeatsL(TInt, const TTimeIntervalMicroSeconds &)
IMPORT_C voidSetStopTimeL(const TTimeIntervalMicroSeconds &)
IMPORT_C voidSetSyncUpdateCallbackIntervalL(const TTimeIntervalMicroSeconds &, TInt64)
IMPORT_C voidSetTempoL(TInt)
IMPORT_C voidSetTrackMuteL(TInt, TBool)
IMPORT_C voidSetVolumeL(TInt)
IMPORT_C voidSetVolumeRampL(const TTimeIntervalMicroSeconds &)
IMPORT_C TMidiStateState()
IMPORT_C voidStop(const TTimeIntervalMicroSeconds &)
IMPORT_C voidStopNotes(TInt)
IMPORT_C voidStopTimeL(TTimeIntervalMicroSeconds &)
IMPORT_C TIntTempoMicroBeatsPerMinuteL()
IMPORT_C voidUnloadAllCustomBanksL()
IMPORT_C voidUnloadCustomBankL(TInt)
IMPORT_C voidUnloadCustomInstrumentL(TInt, TInt)
IMPORT_C TIntVolumeL()
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Private Attributes
CBody *iBody

Constructor & Destructor Documentation

~CMidiClientUtility()

~CMidiClientUtility()[virtual]

Destructor

Member Functions Documentation

ChannelVolumeL(TInt)

IMPORT_C TReal32ChannelVolumeL(TIntaChannel)const

Get the current volume setting of a logical channel

Parameters

TInt aChannelLogical channel to query. 0 <= aChannel <= 15.

ChannelsSupportedL()

IMPORT_C TIntChannelsSupportedL()const

Gets the maximum number of logical channels supported by the MIDI engine.

Close()

IMPORT_C voidClose()

Asynchronous function which closes any currently open resources, such as files, descriptors or URLs in use. Does nothing if there is nothing currently open.

CustomBankLoadedL(TInt)

IMPORT_C TBoolCustomBankLoadedL(TIntaBankCollectionIndex)const

Query if a bank has been loaded to the memory

Parameters

TInt aBankCollectionIndexIdentifier of the custom sound bank to check if it's in memory or not

CustomCommandAsync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TDes8 &, TRequestStatus &)

IMPORT_C voidCustomCommandAsync(const TMMFMessageDestinationPckg &aDestination,
TIntaFunction,
const TDesC8 &aDataTo1,
const TDesC8 &aDataTo2,
TDes8 &aDataFrom,
TRequestStatus &aStatus
)

Asynchronously pass implementation-specific commands to the MIDI engine and receive a response

Parameters

const TMMFMessageDestinationPckg & aDestinationaDestination Recipient of the message. Should be initialised with KUidInterfaceMIDI and a TInt describing the server-side object to which the command should be delivered. The TInt will usually be KMMFObjectHandleController, to deliver the message to the controller plugin, which is the default value.
TInt aFunctionIndex of the function to perform
const TDesC8 & aDataTo1First command data buffer to send, eg command parameters
const TDesC8 & aDataTo2Second command data buffer to send, eg data parameters
TDes8 & aDataFromBuffer to receive data in response to the command. The user must ensure that it is large enough to hold all the data returned.
TRequestStatus & aStatusStatus flag belonging to an active object that will have it's RunL() called when this request complete

CustomCommandAsync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TRequestStatus &)

IMPORT_C voidCustomCommandAsync(const TMMFMessageDestinationPckg &aDestination,
TIntaFunction,
const TDesC8 &aDataTo1,
const TDesC8 &aDataTo2,
TRequestStatus &aStatus
)

Asynchronously pass implementation-specific commands to the MIDI engine

Parameters

const TMMFMessageDestinationPckg & aDestinationaDestination Recipient of the message. Should be initialised with KUidInterfaceMIDI and a TInt describing the server-side object to which the command should be delivered. The TInt will usually be KMMFObjectHandleController, to deliver the message to the controller plugin, which is the default value.
TInt aFunctionIndex of the function to perform
const TDesC8 & aDataTo1First command data buffer to send, eg command parameters
const TDesC8 & aDataTo2Second command data buffer to send, eg data parameters
TRequestStatus & aStatusStatus flag belonging to an active object that will have it's RunL() called when this request complete

CustomCommandSyncL(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TDes8 &)

IMPORT_C voidCustomCommandSyncL(const TMMFMessageDestinationPckg &aDestination,
TIntaFunction,
const TDesC8 &aDataTo1,
const TDesC8 &aDataTo2,
TDes8 &aDataFrom
)

Synchronously pass implementation-specific commands to the MIDI engine and receive a response

Parameters

const TMMFMessageDestinationPckg & aDestinationRecipient of the message. Should be initialised with KUidInterfaceMIDI and a TInt describing the server-side object to which the command should be delivered. The TInt will usually be KMMFObjectHandleController, to deliver the message to the controller plugin, which is the default value.
TInt aFunctionIndex of the function to perform
const TDesC8 & aDataTo1First command data buffer to send, eg command parameters
const TDesC8 & aDataTo2Second command data buffer to send, eg data parameters
TDes8 & aDataFromBuffer to receive data in response to the command. The user must ensure that it is large enough to hold all the data returned.

CustomCommandSyncL(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &)

IMPORT_C voidCustomCommandSyncL(const TMMFMessageDestinationPckg &aDestination,
TIntaFunction,
const TDesC8 &aDataTo1,
const TDesC8 &aDataTo2
)

Synchronously pass implementation-specific commands to the MIDI engine.

Parameters

const TMMFMessageDestinationPckg & aDestinationRecipient of the message. Should be initialised with KUidInterfaceMIDI and a TInt describing the server-side object to which the command should be delivered. The TInt will usually be KMMFObjectHandleController, to deliver the message to the controller plugin, which is the default value.
TInt aFunctionIndex of the function to perform
const TDesC8 & aDataTo1First command data buffer to send, eg command parameters
const TDesC8 & aDataTo2Second command data buffer to send, eg data parameters

DurationMicroBeatsL()

IMPORT_C TInt64DurationMicroBeatsL()const

Gets the length of the currently open MIDI resource in micro-beats

DurationMicroSecondsL()

IMPORT_C TTimeIntervalMicroSecondsDurationMicroSecondsL()const

Gets the length of the currently open MIDI resource in micro-seconds

GetBalanceL()

IMPORT_C TIntGetBalanceL()const

Get the current stereo balance value

GetBankIdL(TBool, TInt)

IMPORT_C TIntGetBankIdL(TBoolaCustom,
TIntaBankIndex
)const

Gets the identifier of a sound bank. Bank identifier (aka bank number) is a 14-bit value consisting of MIDI bank MSB and LSB values

Parameters

TBool aCustomSpecifies whether to reference a custom or standard sound bank
TInt aBankIndexIndex of sound bank where 0 <= aBankIndex < NumberOfBanksL( )

GetDRMCustomCommand()

IMPORT_C MMMFDRMCustomCommand *GetDRMCustomCommand()

Gets a controller's DRM custom command implementation.

GetInstrumentIdL(TInt, TBool, TInt)

IMPORT_C TIntGetInstrumentIdL(TIntaBankId,
TBoolaCustom,
TIntaInstrumentIndex
)const

Gets the identifier of an instrument.

Parameters

TInt aBankIdIdentifier of the sound bank to reference, occupying no more than 14 bits.
TBool aCustomSpecifies whether to reference a custom or standard sound bank.
TInt aInstrumentIndexIndex of the instrument to reference where 0 <= aInstrumentIndex < NumberOfInstrumentsL().

GetInstrumentL(TInt, TInt &, TInt &)

IMPORT_C voidGetInstrumentL(TIntaChannel,
TInt &aInstrumentId,
TInt &aBankId
)

Gets the instrument assigned to a specified channel

Parameters

TInt aChannelLogical channel, 0 <= aChannel <= 15.
TInt & aInstrumentIdIdentifier of the instrument assigned to aChannel. 0 <= iInstrumentId <= 127
TInt & aBankIdIdentifier of the bank that the instrument belongs to, occupying no more than 14 bits

GetMetaDataEntryL(TInt)

IMPORT_C CMMFMetaDataEntry *GetMetaDataEntryL(TIntaMetaDataIndex)const

Retrieve the specified XMF,SMF meta data entry.

Parameters

TInt aMetaDataIndexIndex of the meta data entry to retrieve

GetRepeats()

IMPORT_C TIntGetRepeats()const

Gets the number of times the current opened resources has to be repeated

InstrumentNameL(TInt, TBool, TInt)

IMPORT_C HBufC *InstrumentNameL(TIntaBankId,
TBoolaCustom,
TIntaInstrumentId
)const

Gets the name of the given instrument.

Parameters

TInt aBankIdIdentifier of the bank that the instrument belongs to, occupying no more than 14 bits
TBool aCustomSpecifies whether to reference a custom or standard sound bank
TInt aInstrumentIdIdentifier of the instrument under scrutiny. 0 <= iInstrumentId <= 127.

IsChannelMuteL(TInt)

IMPORT_C TBoolIsChannelMuteL(TIntaChannel)const

Gets the muting status of a specific channel

Parameters

TInt aChannelThe channel to query

IsTrackMuteL(TInt)

IMPORT_C TBoolIsTrackMuteL(TIntaTrack)const

Gets the muting status of a specific track

Parameters

TInt aTrackThe track to query

LoadCustomBankDataL(const TDesC8 &, TInt &)

IMPORT_C voidLoadCustomBankDataL(const TDesC8 &aBankData,
TInt &aBankCollectionIndex
)

Loads one or more custom sound banks from a descriptor into memory for use. If several banks are loaded with consequent LoadCustomBanksL() function calls, the banks are combined if the bank sets have colliding bank numbers

Parameters

const TDesC8 & aBankDataDescriptor containing the custom sound bank
TInt & aBankCollectionIndexIdentifier of the custom sound bank loaded, occupying no more than 14 bits.

LoadCustomBankL(const TDesC &, TInt &)

IMPORT_C voidLoadCustomBankL(const TDesC &aFileName,
TInt &aBankCollectionIndex
)

Loads one or more custom sound banks from a file into memory for use. If several banks are loaded with consequent LoadCustomBanksL() function calls, the banks are combined if the bank sets have colliding bank numbers

Parameters

const TDesC & aFileNameName of the file containing the custom sound bank
TInt & aBankCollectionIndexIdentifier of the custom sound bank loaded, occupying no more than 14 bits

LoadCustomInstrumentDataL(const TDesC8 &, TInt, TInt, TInt, TInt)

IMPORT_C voidLoadCustomInstrumentDataL(const TDesC8 &aInstrumentData,
TIntaBankDataId,
TIntaInstrumentDataId,
TIntaMemoryBankId,
TIntaMemoryInstrumentId
)

Loads an individual instrument from descriptor into custom sound bank memory for use. The bank and instrument ids given in the descriptor can be mapped into different bank and instrument ids in memory

Parameters

const TDesC8 & aInstrumentDataDescriptor containing the instrument
TInt aBankDataIdIdentifier of the bank in the descriptor from which to load the instrument, occupying no more than 14 bits
TInt aInstrumentDataIdIdentifier of the instrument to load. 0 <= aInstrumentId <= 127
TInt aMemoryBankIdIdentifier of the custom bank in memory to load the instrument into, occupying no more than 14 bits
TInt aMemoryInstrumentIdIdentifier of the instrument in memory to load the new instrument into. 0 <= aInstrumentId <= 127.

LoadCustomInstrumentL(const TDesC &, TInt, TInt, TInt, TInt)

IMPORT_C voidLoadCustomInstrumentL(const TDesC &aFileName,
TIntaFileBankId,
TIntaFileInstrumentId,
TIntaMemoryBankId,
TIntaMemoryInstrumentId
)

Loads an individual instrument from file into custom sound bank memory for use. The bank and instrument ids given in the file can be mapped into different bank and instrument ids in memory

Parameters

const TDesC & aFileNameName of the file containing the instrument
TInt aFileBankIdIdentifier of the bank in the file from which to load the instrument, occupying no more than 14 bits
TInt aFileInstrumentIdIdentifier of the instrument to load. 0 <= aInstrumentId <= 127
TInt aMemoryBankIdIdentifier of the custom bank in memory to load the instrument into, occupying no more than 14 bits.
TInt aMemoryInstrumentIdIdentifier of the instrument in memory to load the new instrument into. 0 <= aInstrumentId <= 127.

MaxChannelVolumeL()

IMPORT_C TReal32MaxChannelVolumeL()const

Gets the Maximum volume setting that may be applied to a logical channel

MaxPlaybackRateL()

IMPORT_C TIntMaxPlaybackRateL()const

Gets the maximum playback rate in milli-percentage from the MIDI engine. SetPlaybackRate() for milli-percentage details

MaxPolyphonyL()

IMPORT_C TIntMaxPolyphonyL()const

Get the maximum polyphony level that the engine can handle

MaxVolumeL()

IMPORT_C TIntMaxVolumeL()const

Maximum volume setting that may be applied overall.

MimeTypeL()

IMPORT_C const TDesC8 &MimeTypeL()

Gets the MIME type of the MIDI resource currently open

MinPlaybackRateL()

IMPORT_C TIntMinPlaybackRateL()const

Gets the minimum playback rate in milli-percentage from the MIDI engine. SetPlaybackRate() for milli-percentage details.

NewL(MMidiClientUtilityObserver &, TInt, TInt)

IMPORT_C CMidiClientUtility *NewL(MMidiClientUtilityObserver &aObserver,
TIntaPriority = EMdaPriorityNormal,
TIntaPref = EMdaPriorityPreferenceTimeAndQuality
)[static]

Static factory function for creating a MIDI client utility object. This function is synchronous, unlike the other factory functions, because it doesn't need to perform any MIDI resource initialisation The underlying controller that is created will be given its own heap.

Note: The Priority Value and Priority Preference are used primarily when deciding what to do when several audio clients attempt to play or record simultaneously. In addition to the Priority Value and Preference, the adaptation may consider other parameters such as the SecureId and Capabilities of the client process. Whatever, the decision as to what to do in such situations is up to the audio adaptation, and may vary between different phones. Portable applications are advised not to assume any specific behaviour.

Parameters

MMidiClientUtilityObserver & aObserverReference to an object to receive callbacks on completion of asynchronous functions.
TInt aPriority = EMdaPriorityNormalThe Priority Value - this client's relative priority. This is a value between EMdaPriorityMin and EMdaPriorityMax and represents a relative priority. A higher value indicates a more important request.
TInt aPref = EMdaPriorityPreferenceTimeAndQualityThe Priority Preference - an additional audio policy parameter. The suggested default is EMdaPriorityPreferenceNone. Further values are given by TMdaPriorityPreference, and additional values may be supported by given phones and/or platforms, but should not be depended upon by portable code.

NewL(MMidiClientUtilityObserver &, TInt, TInt, TBool)

IMPORT_C CMidiClientUtility *NewL(MMidiClientUtilityObserver &aObserver,
TIntaPriority,
TIntaPref,
TBoolaUseSharedHeap
)[static]

Static factory function for creating a MIDI client utility object. This function is synchronous, unlike the other factory functions, because it doesn't need to perform any MIDI resource initialisation.

Note: The Priority Value and Priority Preference are used primarily when deciding what to do when several audio clients attempt to play or record simultaneously. In addition to the Priority Value and Preference, the adaptation may consider other parameters such as the SecureId and Capabilities of the client process. Whatever, the decision as to what to do in such situations is up to the audio adaptation, and may vary between different phones. Portable applications are advised not to assume any specific behaviour.

Parameters

MMidiClientUtilityObserver & aObserverReference to an object to receive callbacks on completion of asynchronous functions.
TInt aPriorityThe Priority Value - this client's relative priority. This is a value between EMdaPriorityMin and EMdaPriorityMax and represents a relative priority. A higher value indicates a more important request.
TInt aPrefThe Priority Preference - an additional audio policy parameter. The suggested default is EMdaPriorityPreferenceNone. Further values are given by TMdaPriorityPreference, and additional values may be supported by given phones and/or platforms, but should not be depended upon by portable code.
TBool aUseSharedHeapSelect if the underlying controller will have its own heap or share a single heap with other controller instances. The default behaviour, or if this value is EFalse, is that each controller is created with its own heap. The alternative, if the value is ETrue, is that controllers share a special heap with other controllers created the same way. Each heap uses a chunk, so this avoids situations where the number of chunks per process is limited. The default behaviour is generally to be preferred, and should give lower overall memory usage. However, if many controllers are to be created for a particular thread, then ETrue should be provided to prevent running out of heaps or chunks.

NoteOffL(TInt, TInt, TInt)

IMPORT_C voidNoteOffL(TIntaChannel,
TIntaNote,
TIntaVelocity
)

Synchronous function to terminate playback of a note. If no corresponding note is found then no error is raised.

Parameters

TInt aChannelLogical channel on which the note is playing. 0 <= aChannel <= 15.
TInt aNoteNote to terminate. 0 <= aNote <= 127.
TInt aVelocityVelocity with which to stop the note. 0 <= aVelocity <= 127. There is no standard behaviour corresponding with note off velocity.

NoteOnL(TInt, TInt, TInt)

IMPORT_C voidNoteOnL(TIntaChannel,
TIntaNote,
TIntaVelocity
)

Synchronous function to commence playback of a note. Multiple calls to this function will be accommodated as far as the MIDI engine can manage

Parameters

TInt aChannelLogical channel to play note on. 0 <= aChannel <= 15
TInt aNoteNote to play. 0 <= aNote <= 127
TInt aVelocityVelocity with which to start the note. The legal integer range is 0 <= aVelocity <= 127, but the value zero actually causes the message to be interpreted as a Note Off message instead of a Note On.

NumTracksL()

IMPORT_C TIntNumTracksL()const

Gets the number of tracks present in the currently open MIDI resource

NumberOfBanksL(TBool)

IMPORT_C TIntNumberOfBanksL(TBoolaCustom)const

Gets the number of standard or custom sound banks currently available

Parameters

TBool aCustomSpecifies whether to reference a custom or standard sound bank

NumberOfInstrumentsL(TInt, TBool)

IMPORT_C TIntNumberOfInstrumentsL(TIntaBankId,
TBoolaCustom
)const

Gets the number of instruments available in a given sound bank

Parameters

TInt aBankIdIdentifier of sound bank to reference, occupying no more than 14 bits
TBool aCustomSpecifies whether to reference a custom or standard sound bank

NumberOfMetaDataEntriesL()

IMPORT_C TIntNumberOfMetaDataEntriesL()const

Get the number of meta data entries currently known about in the currently open resource. XMF,SMF meta data are part of the XMF,SMF file header and can thus be examined before playback. If there is no XMF,SMF resource open, will return zero. Standard MIDI file meta data entries encountered during playback will be passed back via MMIDIClientUtilityObserver::MmcuoMetaDataEntryFound()

OpenDes(const TDesC8 &)

IMPORT_C voidOpenDes(const TDesC8 &aDescriptor)

Asynchronous function to open a descriptor containing MIDI data and perform initialisation ready for playback

Parameters

const TDesC8 & aDescriptordescriptor containing MIDI data

OpenFile(const TDesC &)

IMPORT_C voidOpenFile(const TDesC &aFileName)

Asynchronous function to open a file containing MIDI data and perform initialisation ready for playback

Parameters

const TDesC & aFileNameName of the MIDI file to open

OpenFile(const RFile &)

IMPORT_C voidOpenFile(const RFile &aFile)

Asynchronous function to open a file containing MIDI data and perform initialisation ready for playback

Parameters

const RFile & aFileOpen shared protected session handle to the midi file to read

OpenFile(const TMMSource &)

IMPORT_C voidOpenFile(const TMMSource &aSource)

Asynchronous function to open a file containing MIDI data and perform initialisation ready for playback

Parameters

const TMMSource & aSource

OpenUrl(const TDesC &, TInt, const TDesC8 &)

IMPORT_C voidOpenUrl(const TDesC &aUrl,
TIntaIapId =  KUseDefaultIap ,
const TDesC8 &aMimeType =  KNullDesC8
)

Asynchronous function to open a URL containing MIDI data and perform initialisation ready for playback

Parameters

const TDesC & aUrlUniform Resource Locator for a MIDI data stream
TInt aIapId =  KUseDefaultIap Identifier of the Internet Access Point to use - available from CommDB, the comms connections database. Defaults to using the default access point, as defined by CommDB
const TDesC8 & aMimeType =  KNullDesC8 Mime type of the MIDI data stream to be played. Defaults to nothing in which case the an attempt will be made to recognise the type of the MIDI data automatically.

PercussionKeyNameL(TInt, TInt, TBool, TInt)

IMPORT_C HBufC *PercussionKeyNameL(TIntaNote,
TIntaBankId,
TBoolaCustom,
TIntaInstrumentId
)const

Gets the name of a particular percussion key corresponding to a given note.

Parameters

TInt aNoteNote to query. 0 <= aNote <= 127
TInt aBankIdIdentifier of the bank that the instrument belongs to, occupying no more than 14 bits. The bank ID is a concatenation of MIDI bank MSB and LSB values.
TBool aCustomSpecifies whether to reference a custom or standard sound bank
TInt aInstrumentIdIdentifier of an instrument

PitchTranspositionCentsL()

IMPORT_C TIntPitchTranspositionCentsL()const

Gets the pitch shift in use for the currently open MIDI resource

Play()

IMPORT_C voidPlay()

Asynchronous function to initiate or resume playback of a previously opened resource. Also used to start an internal timer to establish a zero-time for the media stream time relative to which commands with timestamps are timed against

PlayNoteL(TInt, TInt, const TTimeIntervalMicroSeconds &, TInt, TInt)

IMPORT_C voidPlayNoteL(TIntaChannel,
TIntaNote,
const TTimeIntervalMicroSeconds &aDuration,
TIntaNoteOnVelocity,
TIntaNoteOffVelocity
)

Synchronous function to play a single note. Multiple calls to this function will be accommodated as far as the MIDI engine can manage. The same functionality could be implemented using the SendMessage function

Parameters

TInt aChannelLogical channel to play note on. 0 <= aChannel <= 15.
TInt aNoteNote to play. 0 <= aNote <= 127
const TTimeIntervalMicroSeconds & aDurationLength of time to play note for.
TInt aNoteOnVelocityVelocity with which to start the note. 0 <= aNoteOnVelocity <= 127.
TInt aNoteOffVelocityVelocity with which to stop the note. 0 <= aNoteOffVelocity <= 127.

PlayNoteL(TInt, TInt, const TTimeIntervalMicroSeconds &, const TTimeIntervalMicroSeconds &, TInt, TInt)

IMPORT_C voidPlayNoteL(TIntaChannel,
TIntaNote,
const TTimeIntervalMicroSeconds &aStartTime,
const TTimeIntervalMicroSeconds &aDuration,
TIntaNoteOnVelocity,
TIntaNoteOffVelocity
)

Synchronous function to play a single note at a specified time. Multiple calls to this function will be accommodated as far as the MIDI engine can manage. The same functionality could be implemented using the SendMessage function

Parameters

TInt aChannelLogical channel to play note on. 0 <= aChannel <= 15.
TInt aNoteNote to play. 0 <= aNote <= 127
const TTimeIntervalMicroSeconds & aStartTimespecifies the time at which to start playing the note, relative to the MIDI resource playing time or the time elapsed since Play() was called if no resource is present
const TTimeIntervalMicroSeconds & aDurationLength of time to play note for.
TInt aNoteOnVelocityVelocity with which to start the note. 0 <= aNoteOnVelocity <= 127.
TInt aNoteOffVelocityVelocity with which to stop the note. 0 <= aNoteOffVelocity <= 127.

PlaybackRateL()

IMPORT_C TIntPlaybackRateL()const

Gets the current playback rate factor of the currently open MIDI resource. The playback rate is independent from tempo, i.e., it can be used to give an overall speed factor for playback

PolyphonyL()

IMPORT_C TIntPolyphonyL()const

Gets the number of currently active voices.

PositionMicroBeatsL()

IMPORT_C TInt64PositionMicroBeatsL()const

Gets the current metrical position of the MIDI resource being played

PositionMicroSecondsL()

IMPORT_C TTimeIntervalMicroSecondsPositionMicroSecondsL()const

Gets the current temporal position of the MIDI resource being played.

SendMessageL(const TDesC8 &)

IMPORT_C TIntSendMessageL(const TDesC8 &aMidiMessage)

Sends a single MIDI message to the MIDI engine

Parameters

const TDesC8 & aMidiMessageDescriptor containing the MIDI message data. If there are several MIDI messages in the buffer, only the first one is processed

SendMessageL(const TDesC8 &, const TTimeIntervalMicroSeconds &)

IMPORT_C TIntSendMessageL(const TDesC8 &aMidiMessage,
const TTimeIntervalMicroSeconds &aTime
)

Sends a single MIDI message, with time stamp, to the MIDI engine

Parameters

const TDesC8 & aMidiMessageDescriptor containing the MIDI message data. If there are several MIDI messages in the buffer, only the first one is processed
const TTimeIntervalMicroSeconds & aTimeThe time at which to execute the message, relative to the MIDI resource playing time or the time elapsed since Play() was called if no resource is present

SendMipMessageL(const RArray< TMipMessageEntry > &)

IMPORT_C voidSendMipMessageL(const RArray< TMipMessageEntry > &aEntry)

Sends a mip message to the MIDI engine. This is a convenience function, because the same functionality could be achieved with the SendMessage() function

Parameters

const RArray< TMipMessageEntry > & aEntryArray of logical {channel, MIP} value pairs to send, highest priority first

SetBalanceL(TInt)

IMPORT_C voidSetBalanceL(TIntaBalance =  KMMFBalanceCenter )

Set the current stereo balance value

Parameters

TInt aBalance =  KMMFBalanceCenter Balance value to set. Defaults to KMMFBalanceCenter to restore equal left-right balance

SetBankL(TBool)

IMPORT_C voidSetBankL(TBoolaCustom)

SetBankL is deprecated due to Mobile XMF specification requirement that user instruments (custom instruments) override standard instruments.

Tell the MIDI engine to use a custom bank or a standard bank

Parameters

TBool aCustomIf Etrue the custom bank in memory is used otherwise the standard bank is used leaving the custom bank in memory

SetChannelMuteL(TInt, TBool)

IMPORT_C voidSetChannelMuteL(TIntaChannel,
TBoolaMuted
)

Set the muting state of a channel without changing its volume setting. When unmuted the channel goes back to its previous volume setting

Parameters

TInt aChannelLogical channel to set the mute state of. 0 <= aChannel <= 15.
TBool aMutedETrue to mute the channel, EFalse to unmute it.

SetChannelVolumeL(TInt, TReal32)

IMPORT_C voidSetChannelVolumeL(TIntaChannel,
TReal32aVolumeInDecibels
)

Set the volume of a channel.

Parameters

TInt aChannelLogical channel to set the volume on. 0 <= aChannel <= 15
TReal32 aVolumeInDecibelsVolume currently set on the specified channel in decibels. The minimum channel volume supported value is -infinity dB, which is the smallest possible value that TReal32 supports. The maximum channel volume can be set via MaxChannelVolumeL()

SetInstrumentL(TInt, TInt, TInt)

IMPORT_C voidSetInstrumentL(TIntaChannel,
TIntaBankId,
TIntaInstrumentId
)

Sets a logical channel to use the given instrument.

Parameters

TInt aChannelLogical channel to set the instrument for. 0 <= aChannel <= 15
TInt aBankIdIdentifier of the bank that the instrument belongs to, occupying no more than 14 bits. The bank ID is a concatenation of MIDI bank MSB and LSB values
TInt aInstrumentIdIdentifier of the instrument under scrutiny. 0 <= iInstrumentId <= 127.

SetMaxPolyphonyL(TInt)

IMPORT_C voidSetMaxPolyphonyL(TIntaMaxNotes)

Set the max polyphony the engine can handle

Parameters

TInt aMaxNotesMax polyphony level, 0 <= PolyphonyL() <= aMaxNotes

SetPitchTranspositionL(TInt)

IMPORT_C TIntSetPitchTranspositionL(TIntaCents)

Sets the pitch shift to apply to the currently open MIDI resource. May be called during playback aCents parameter is not checked - if the value is out of range, it is expected KErrArgument is return by MIDI engine.

Parameters

TInt aCentsPitch shift in cents, i.e. semitones * 100. One octave equals 1200 cents

SetPlaybackRateL(TInt)

IMPORT_C voidSetPlaybackRateL(TIntaRate)

Sets the playback rate for the playback of the current MIDI resource. The playback rate is independent from tempo, i.e., it can be used to give an overall speed factor for playback. May be called whether playback is in progress or not.

Parameters

TInt aRatePlayback rate in percent times 1000, i.e., 100000 means original playback speed, 200000 means double speed, and 50000 means half speed playback

SetPositionMicroBeatsL(TInt64)

IMPORT_C voidSetPositionMicroBeatsL(TInt64aMicroBeats)

Change the position of the currently playing MIDI resource to the given position. May be called whenever a MIDI resource is open.

Parameters

TInt64 aMicroBeatsMetrical position to move to. Clamped to (0, DurationMicroBeatsL()).

SetPositionMicroSecondsL(const TTimeIntervalMicroSeconds &)

IMPORT_C voidSetPositionMicroSecondsL(const TTimeIntervalMicroSeconds &aPosition)

Change the position of the currently playing MIDI resource to the given position. May be called whenever a MIDI resource is open

Parameters

const TTimeIntervalMicroSeconds & aPositionTemporal position to move to. Clamped to (0, DurationMicroSecondsL()).

SetPriorityL(TInt, TInt)

IMPORT_C voidSetPriorityL(TIntaPriority,
TIntaPref
)

Set the priority with which this client plays MIDI data

CMidiClientUtility::NewL()

Parameters

TInt aPriorityThe Priority Value.
TInt aPrefThe Priority Preference.

SetRepeatsL(TInt, const TTimeIntervalMicroSeconds &)

IMPORT_C voidSetRepeatsL(TIntaRepeatNumberOfTimes,
const TTimeIntervalMicroSeconds &aTrailingSilence
)

Set the number of times to repeat the current MIDI resource. After Stop() has been called, repeat number of times and the trailing silence are reset

Parameters

TInt aRepeatNumberOfTimesNumber of time to repeat the resource during playback. This includes the first playing
const TTimeIntervalMicroSeconds & aTrailingSilenceTime in microseconds to pause between repeats

SetStopTimeL(const TTimeIntervalMicroSeconds &)

IMPORT_C voidSetStopTimeL(const TTimeIntervalMicroSeconds &aStopTime)

Sets the stop time to use for the currently open MIDI resource

Parameters

const TTimeIntervalMicroSeconds & aStopTimeTime at which playback will stop, relative to the start of the resource. Clamped to 0 and the duration of the resource

SetSyncUpdateCallbackIntervalL(const TTimeIntervalMicroSeconds &, TInt64)

IMPORT_C voidSetSyncUpdateCallbackIntervalL(const TTimeIntervalMicroSeconds &aMicroSeconds,
TInt64aMicroBeats = 0
)

Sets the frequency at which MMIDIClientUtilityObserver::MmcuoSyncUpdateL( ) is called to allow other components to synchronise with playback of this MIDI resource

Parameters

const TTimeIntervalMicroSeconds & aMicroSecondsTemporal interval to callback at. Used in preference to aMicroBeats if both are set
TInt64 aMicroBeats = 0Metrical interval to callback at. Set both parameters to zero to cancel.

SetTempoL(TInt)

IMPORT_C voidSetTempoL(TIntaMicroBeatsPerMinute)

Sets the tempo at which the current MIDI resource should be played. May be called whether playback is in progress or not. The tempo is independent from the playback rate, i.e., the resulting playback speed will be affected by both

Parameters

TInt aMicroBeatsPerMinuteTempo in microbeats per minute (BPM*1000000) to set

SetTrackMuteL(TInt, TBool)

IMPORT_C voidSetTrackMuteL(TIntaTrack,
TBoolaMuted
)const

Mutes or unmutes a particular track

Parameters

TInt aTrackIndex of the track to mute - 0 <= aTrack < NumTracksL().
TBool aMutedETrue to mute the track, EFalse to unmute it.

SetVolumeL(TInt)

IMPORT_C voidSetVolumeL(TIntaVolume)

Set the overall volume of the MIDI client. This setting scales all channel volumes respectively so the actual volume that a channel is played at is (overall volume * channel volume / max volume).

Parameters

TInt aVolumeOverall volume setting to use

SetVolumeRampL(const TTimeIntervalMicroSeconds &)

IMPORT_C voidSetVolumeRampL(const TTimeIntervalMicroSeconds &aRampDuration)

Length of time over which the volume is faded up from zero to the current settings when playback is started.

Parameters

const TTimeIntervalMicroSeconds & aRampDurationDuration of the ramping period.

State()

IMPORT_C TMidiStateState()const

Gets the current state of the MIDI client utility with regard to MIDI resources

Stop(const TTimeIntervalMicroSeconds &)

IMPORT_C voidStop(const TTimeIntervalMicroSeconds &aFadeOutDuration)

Stops playback of a resource but does not change the current position or release any resources. Pauses the internal timer if no resource is open

Parameters

const TTimeIntervalMicroSeconds & aFadeOutDurationLength of time over which the volume is faded out from the current settings to zero.

StopNotes(TInt)

IMPORT_C voidStopNotes(TIntaChannel)

Stops the playback of all notes on the given channel, by means of an All Notes Off MIDI message

Parameters

TInt aChannelLogical channel to stop notes on. 0 <= aChannel <= 15

StopTimeL(TTimeIntervalMicroSeconds &)

IMPORT_C voidStopTimeL(TTimeIntervalMicroSeconds &aStopTime)const

Get the stop time currently set for the MIDI resource

Parameters

TTimeIntervalMicroSeconds & aStopTimeTime at which playback will stop, relative to the start of the resource

TempoMicroBeatsPerMinuteL()

IMPORT_C TIntTempoMicroBeatsPerMinuteL()const

Gets the current tempo of the currently open MIDI resource. The tempo is independent from the playback rate, i.e., the resulting playback speed will be affected by both.

UnloadAllCustomBanksL()

IMPORT_C voidUnloadAllCustomBanksL()

Removes all custom sound banks from memory.

UnloadCustomBankL(TInt)

IMPORT_C voidUnloadCustomBankL(TIntaBankCollectionIndex)

Removes a custom sound bank from memory. Only valid for sound banks previously loaded from file. Once unloaded the custom sound bank is no longer available for use.

Parameters

TInt aBankCollectionIndexIdentifier of the custom sound bank to unload, occupying no more than 14 bits

UnloadCustomInstrumentL(TInt, TInt)

IMPORT_C voidUnloadCustomInstrumentL(TIntaCustomBankId,
TIntaInstrumentId
)

Removes an instrument from custom sound bank memory. Only valid for instruments previously loaded from file. Once unloaded the instrument is no longer available for use

Parameters

TInt aCustomBankIdIdentifier of the custom sound bank containing the instrument to unload, occupying no more than 14 bits.
TInt aInstrumentIdIdentifier of the instrument to unload. 0 <= aInstrumentId <= 127

VolumeL()

IMPORT_C TIntVolumeL()const

Gets the overall volume of the MIDI client.

Member Data Documentation

CBody * iBody

CBody *iBody[private]

a pointer to the implementation.