MMdaAudioPlayerCallback Class Reference

#include <mdaaudiosampleplayer.h>

class MMdaAudioPlayerCallback

Public Member Functions
pure virtual void	MapcInitComplete(TInt, const TTimeIntervalMicroSeconds &)
pure virtual void	MapcPlayComplete(TInt)

Detailed Description

An interface to a set of audio player callback functions.

The class is a mixin and is intended to be inherited by the client class which is observing the audio playing operation. The functions encapsulated by this class are called when specific events occur in the process of initialising and playing an audio sample. A reference to this object is passed as a parameter when constructing an audio player utility object.

Since: 5.0

Member Function Documentation

MapcInitComplete ( TInt, const TTimeIntervalMicroSeconds & )

void	MapcInitComplete	(	TInt	aError,
			const TTimeIntervalMicroSeconds &	aDuration
		)	[pure virtual]

Defines required client behaviour when an attempt to open and initialise an audio sample has completed, successfully or otherwise.

Parameters
aError	The status of the audio sample after initialisation. The following values have the same specific meaning across all EPOC platforms: KErrNone the sample is ready to play. KErrNotSupported the audio format or particular encoding type is not recognised or not supported. KErrNotFound the audio sample cannot be found. KErrNoMemory there is insufficient memory to play this audio sample. Other values are possible indicating a problem opening the audio sample. These values are dependent on the EPOC platform.
aDuration	The duration of the audio sample.

Parameters

aError

The status of the audio sample after initialisation. The following values have the same specific meaning across all EPOC platforms: KErrNone the sample is ready to play. KErrNotSupported the audio format or particular encoding type is not recognised or not supported. KErrNotFound the audio sample cannot be found. KErrNoMemory there is insufficient memory to play this audio sample. Other values are possible indicating a problem opening the audio sample. These values are dependent on the EPOC platform.

aDuration

The duration of the audio sample.

MapcPlayComplete ( TInt )

void

MapcPlayComplete

(

TInt

aError

)

[pure virtual]

Defines required client behaviour when an attempt to playback an audio sample has completed, successfully or otherwise.

Parameters
aError	The status of playback. The following values have the same specific meaning across all EPOC platforms: KErrNone playing of the audio sample is complete. KErrCorrupt the sample data is corrupt. KErrInUse the sound device is in use by another higher priority client. This can happen during playback. KErrNoMemory there is insufficient memory to play this audio sample Other values are possible indicating a problem opening the audio sample. These values are dependent on the EPOC platform.

Parameters

aError

The status of playback. The following values have the same specific meaning across all EPOC platforms: KErrNone playing of the audio sample is complete. KErrCorrupt the sample data is corrupt. KErrInUse the sound device is in use by another higher priority client. This can happen during playback. KErrNoMemory there is insufficient memory to play this audio sample Other values are possible indicating a problem opening the audio sample. These values are dependent on the EPOC platform.