Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



How to play a tone sequence

To play a tone sequence defined in a descriptor do the following:


Constructing and initializing

Use the CMMFDevSound::NewL() method to construct a new instance of DevSound.

After construction, use an CMMFDevSound::InitializeL() method to initialize DevSound to play tones. This method requires that you specify the DevSound observer class to handle callbacks.

Once initialization has completed, successfully or otherwise, DevSound calls the MDevSoundObserver::InitializeComplete() function.

[Top]


Configuring

The following settings can be configured before or during tone play:

[Top]


Playing

To start playing a tone sequence, use the CMMFDevSound::PlayToneSequenceL() method:

IMPORT_C void PlayToneSequenceL(const TDesC8 &aData);

This method has one parameter, &aData, the tone sequence that is to be played.

When an attempt to play a tone sequence has completed, successfully or otherwise, DevSound calls the MDevSoundObserver::ToneFinished() function. If a tone sequence is not valid, MDevSoundObserver::ToneFinished() returns with an error of KErrCorrupt.

Note: Further calls to CMMFDevSound::PlayToneSequenceL() can be made both before and after the MDevSoundObserver::ToneFinished() callback is received.