1 /*

     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:

    15 *

    16 */

    17 

    18 #ifndef MRADIOENGINEOBSERVER_H

    19 #define MRADIOENGINEOBSERVER_H

    20 

    21 // User includes

    22 #include "radioenginedef.h"

    23 

    24 /**

    25 * Observer for radio state changes.

    26 */

    27 NONSHARABLE_CLASS( MRadioEngineObserver )

    28     {

    29     public:

    30 

    31     virtual void PowerEventL( TBool aPowerState, TInt aErrorCode ) = 0;

    32 

    33     /**

    34     * Notifies when frequency changes

    35     * @param aFrequency The new frequency

    36     * @param aReason reason why the frequency changed

    37     * @param aErrorCode code related to state change

    38     */

    39     virtual void FrequencyEventL( TUint32 aFrequency, RadioEngine::TRadioFrequencyEventReason aReason, TInt aErrorCode ) = 0;

    40     virtual void VolumeEventL( TInt aVolume, TInt aErrorCode ) = 0;

    41     virtual void MuteEventL( TBool aMuteState, TInt aErrorCode ) = 0;

    42     virtual void AudioModeEventL( TInt aAudioMode, TInt aErrorCode ) = 0;

    43     virtual void AntennaEventL( TBool aAntennaAttached, TInt aErrorCode ) = 0;

    44 

    45     /**

    46     * Notifies when audio routing changes

    47     * @param aAudioDestination The new output device

    48     * @param aErrorCode Error code related to state change

    49     */

    50     virtual void AudioRoutingEventL( TInt aAudioDestination, TInt aErrorCode ) = 0;

    51 

    52     /**

    53     * Notifies about seeking events

    54     * @param aSeekingState The seeking state

    55     * @param aErrorCode KErrNone for successful starting or completion of seeking

    56     */

    57     virtual void SeekingEventL( TInt aSeekingState, TInt aErrorCode ) = 0;

    58 

    59     /**

    60      * Notifies about region changes

    61      *

    62      * @param aRegion The ID of the new region

    63      * @param aErrorCode Region event error code

    64      */

    65     virtual void RegionEventL( TInt aRegion, TInt aErrorCode ) = 0;

    66 

    67     /**

    68      * Notifies about fm transmitter activating

    69      */

    70     virtual void FmTransmitterEventL( TBool aActive ) = 0;

    71 

    72     };

    73 

    74 #endif // MRADIOENGINEOBSERVER_H