Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <Tuner.h>
This item is not part of the S60 5th Edition SDK

Class MMMTunerObserver

class MMMTunerObserver;

Description

The Tuner Observer mixin class defines asynchronous event completion function callbacks

Members

Defined in MMMTunerObserver:


Member functions


MToTuneComplete(TInt)

virtual void MToTuneComplete(TInt aError)=0;

Description

Tune complete event. This event is asynchronous and is received after a call to the Tune method.

Parameters

TInt aError

A standard system error


MToTunerEvent(TEventType,TInt,TAny *)

virtual void MToTunerEvent(TEventType aType, TInt aError, TAny *aAdditionalInfo)=0;

Description

Passes an asychronous event to the tuner client.

Parameters

MMMTunerObserver::TEventType aType

The type of event. See enumeration MMMTunerObserver::TEventType for more information about when the event types mean.

TInt aError

An error code associated with the event.

TAny *aAdditionalInfo

Any additional information associated with the event, or NULL if no such additional information exists.

[Top]


Member enumerations


Enum TEventType

TEventType

Description

The TEvent enumeration is used to indicate which type of event is being sent to the client. Each event will be associated with an error code and potentially some addition information, and will be passed to the client via method MMMTunerObserver::MToTunerEvent(TEventType,TInt,TAny *).

ETunerEvent

An event relating to the tuner itself. Any error other than KErrNone associated with this event type may indicate that the tuner cannot be used anymore.

No additional information is associated with this type of event.

EControlEvent

An event arising from the tuner policy. An error of KErrNone associated with this event type indicates that control of the tuner has been granted to the client, and an error of KErrAccessDenied indicates that control has been denied or revoked from the client.

Once control of the tuner has been granted via an event of this type, subsequent calls to Tune will succeed. To request an such event, a client should call NotifyTunerControl.

Control of the tuner is retained until is is released, or pre-empted by a higher priority client. If this client no longer needs control of the tuner, it must be released to allow other clients access.

No additional information is associated with this type of event.