MAudioContextObserver Class Reference

class MAudioContextObserver

KUidA3FContextCommitUpdate - Follows a Commit() call. Signals that Commit() has been successfully received by MMRC and that update callbacks are about to follow. Note will still be called if MMRC rejects the request for policy reasons in which case, the callbacks will show the original value. if aError is not KErrNone, then the implementation tried to apply the change but this failed so that the implementation is rolled-back to the previous. However, KErrAbort says that this roll-back failed, and streams have been placed in a Dead state.

KUidA3FContextPreEmptedCommit - Follows a Commit() call, but signals that that MMRC is doing a simultaneous pre-emption. Update callbacks are about to follow, but these relate to the pre-emption. The original request is lost. An error of KErrAbort says that the change MMRC requested failed, and typically streams are placed in a Dead mode.

KUidA3FContextPreEmption - Initial indication to the client that it is to be pre-empted. The client should treat the Context and its Components as locked see below.

KUidA3FContextPreEmptionUpdate - Will follow a KUidA3FContextPreEmption and indicates that callbacks are about to start to indicate the update. An error of KErrAbort says that the change MMRC requested failed, and typically streams are placed in a Dead mode.

KUidA3FContextUpdateComplete - Signals that all callbacks are complete Commit() can be called again, if required.

KUidA3FContextAbort - Error occurred due to the commit or pre-emption cycle itself that is something to do with the associated message passing mechanism etc. this terminates the whole cycle, whatever the current state. It should leave the context in a reasonable state usually the original state. aError gives the associated reason for this. Defines the interface for observing context states.

Public Member Functions
void ContextEvent ( TUid , TInt )

Member Functions Documentation

ContextEvent(TUid, TInt)

void ContextEvent ( TUid aEvent,
TInt aError
) [pure virtual]

Callback to context observer to show progression through Commit() and pre-emption cycles.

Parameters

TUid aEvent
TInt aError