phoneengine/engineinfo/inc/mpeengineinfo.h
changeset 0 5f000ab63145
child 19 544e34b3255a
child 21 92ab7f8d0eab
equal deleted inserted replaced
-1:000000000000 0:5f000ab63145
       
     1 /*
       
     2 * Copyright (c) 2007-2008 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:  Interface class for MPEEngineInfo of the PhoneEngine
       
    15 *
       
    16 */
       
    17 
       
    18 
       
    19 
       
    20 #ifndef MPEENGINEINFO_H
       
    21 #define MPEENGINEINFO_H
       
    22 
       
    23 //  INCLUDES
       
    24 #include <pevirtualengine.h>
       
    25 
       
    26 // CONSTANTS
       
    27 // None
       
    28 
       
    29 // FORWARD DECLARATIONS
       
    30 class MPEClientInformation;
       
    31 
       
    32 // DATA TYPES
       
    33 // None
       
    34 
       
    35 // CLASS DECLARATION
       
    36 
       
    37 /**
       
    38 *  Offers engine info interface to phone application
       
    39 *
       
    40 *  @lib phoneengine.lib
       
    41 *  @since Series 60 4.0
       
    42 */
       
    43 NONSHARABLE_CLASS( MPEEngineInfo )
       
    44     {
       
    45 
       
    46     public:
       
    47         /**
       
    48         * Gets active als line of the phone from TPEBasicInfo-structure
       
    49         * @return active als line of the phone
       
    50         */
       
    51         virtual const CCCECallParameters::TCCELineType& ALSLine() const = 0;
       
    52             
       
    53         /**
       
    54         * Gets ALS support of the phone from TPEBasicInfo-structure
       
    55         * @return ETrue if als is supported.
       
    56         */
       
    57         virtual const TBool& ALSLineSupport() const = 0;
       
    58 
       
    59         /**
       
    60         * Gets group ids which are active to play ring tone
       
    61         * @return contact group id
       
    62         */
       
    63         virtual const TArray< TContactItemId > AlertForGroup() const = 0;
       
    64     
       
    65         /**
       
    66         * Gets audio mute value
       
    67         * @return audio mute value
       
    68         */
       
    69         virtual const TBool& AudioMute() const = 0;
       
    70 
       
    71         /**
       
    72         * Gets audio volume value
       
    73         * @return audio volume value
       
    74         */
       
    75         virtual const TInt& AudioVolume() const = 0;
       
    76         
       
    77         /**
       
    78         * Gets current audio output path
       
    79         * @return audio output path
       
    80         */
       
    81         virtual const TPEAudioOutput& AudioOutput() const = 0;
       
    82         
       
    83         /**
       
    84         * Gets phone audio route parameters
       
    85         * @return phone audio route parameters. 
       
    86         */
       
    87         virtual const TPEPhoneAudioRouteParameters& RouteParameters() const = 0;  
       
    88   
       
    89         /**
       
    90         * Gets audio output path availability
       
    91         * @return audio output path availability status
       
    92         */
       
    93         virtual TBool AudioOutputAvailable( 
       
    94             const TPEAudioOutput aOutput ) const = 0;
       
    95 
       
    96         /**
       
    97         * Gets line information for the specified call
       
    98         * @param aCallId is the call identification number
       
    99         * @return line information for the specified call
       
   100         */
       
   101         virtual CCCECallParameters::TCCELineType CallALSLine( const TInt aCallId ) const = 0;
       
   102 
       
   103         /**
       
   104         * Gets phone client information of the specified call
       
   105         * @param aCallId is the call identification number
       
   106         * @return client information of the specified call
       
   107         */
       
   108         virtual const MPEClientInformation& CallClientInformation( const TInt aCallId ) const = 0;
       
   109 
       
   110         /**
       
   111         * Gets call direction of the specified call
       
   112         * @param aCallId is the call identification number
       
   113         * @return call direction of the specified call
       
   114         */
       
   115         virtual RMobileCall::TMobileCallDirection CallDirection( 
       
   116             const TInt aCallId ) const = 0;
       
   117 
       
   118         /**
       
   119         * Gets duration of the last call to go idle
       
   120         * @return call duration of the last active call
       
   121         */
       
   122         virtual const TInt& CallDuration() const = 0;
       
   123 
       
   124         /**
       
   125         * Gets call duration of the ongoing or last active call with specified id
       
   126         * @param aCallId is the call identification number
       
   127         * @return call duration of the ongoing or last active call
       
   128         */
       
   129         virtual TTimeIntervalSeconds CallDuration( const TInt aCallId ) const = 0;
       
   130 
       
   131         /**
       
   132         * Get caller image
       
   133         * @param aCallId is the call identification number.
       
   134         * @return caller image
       
   135         */
       
   136         virtual const TPtrC CallerImage( const TInt aCallId ) const = 0;
       
   137 
       
   138         /**
       
   139         * Get caller text
       
   140         * @param aCallId is the call identification number.
       
   141         * @return caller text
       
   142         */
       
   143         virtual const TPtrC CallerText( const TInt aCallId ) const = 0;
       
   144 
       
   145         /**
       
   146         * Get caller thumbnail
       
   147         * @param aCallId is the call identification number.
       
   148         * @return pointer to thumbnail data
       
   149         */
       
   150         virtual CFbsBitmap* CallerThumbnail(
       
   151             const TInt aCallId ) const = 0;
       
   152         
       
   153         /**
       
   154         * Get caller thumbnail status
       
   155         * @return ETrue if has thumbnail, otherwise EFalse.
       
   156         */
       
   157         virtual TBool HasCallerThumbnail( const TInt aCallId  ) const = 0;
       
   158 
       
   159         /**
       
   160         * Gets identification number of a call
       
   161         *
       
   162         * This value is used for determining the target for a command message
       
   163         * that requires such information
       
   164         * @return identification number of a call
       
   165         */
       
   166         virtual const TInt& CallId() const = 0;
       
   167 
       
   168         /**
       
   169         * Gets start time of the call
       
   170         * @param aCallTime is the start time of the call
       
   171         * @param aCallId is the call identification number
       
   172         * @return None.
       
   173         */
       
   174         virtual const TTime& CallStartTime( const TInt aCallId ) const = 0;
       
   175 
       
   176         /**
       
   177         * Gets call state of a specified call
       
   178         * @param aCallId is the call identification number
       
   179         * @return call state of a specified call
       
   180         */
       
   181         virtual TPEState CallState( const TInt aCallId ) const = 0;
       
   182 
       
   183         /**
       
   184         * Gets type of the specified call
       
   185         * @param aCallId is the call identification number.
       
   186         * @return call type of a specified call
       
   187         */
       
   188         virtual TPECallType CallType( const TInt aCallId ) const = 0;
       
   189 
       
   190         /**
       
   191         * Gets last set call type information
       
   192         * @return call type information
       
   193         */
       
   194         virtual const TPECallType& CallTypeCommand() const = 0;
       
   195 
       
   196         /**
       
   197         * Gets secure status from call info
       
   198         * @return TBool the secure status (on/off)
       
   199         */
       
   200         virtual TBool IsSecureCall( const TInt aCallId ) const = 0;
       
   201 
       
   202         /**
       
   203         * Gets call state of a conference call
       
   204         * @return call state
       
   205         */
       
   206         virtual TPEState ConferenceCallState() const = 0;
       
   207 
       
   208         /**
       
   209         * Get user group ids this contact is assigned to
       
   210         * @param aCallId is the call identification number.
       
   211         * @return array for group ids
       
   212         */
       
   213         virtual const TArray< TContactItemId > ContactGroups(
       
   214             const TInt aCallId ) const = 0;
       
   215 
       
   216         /**
       
   217         * Get remote contact link packet. See virtual phonebook API.
       
   218         * @param aCallId is the call identification number.
       
   219         * @return Virtual phonebook contact link packet.
       
   220         */
       
   221         virtual const TDesC8& ContactLink( const TInt aCallId ) const = 0;
       
   222         
       
   223         /**
       
   224         * Gets the name of data port currently on-loan.
       
   225         * Data port loaning is handled by CSPlugin and happens when a data
       
   226         * call goes into connected state. The dataport is released when VT components
       
   227         * indicate it can be released, i.e. video call hangup.
       
   228         * @return data port name
       
   229         */
       
   230         virtual const TName& DataPortName() const = 0;
       
   231 
       
   232         /**
       
   233         * Gets dtmf string
       
   234         * @return dtmf string
       
   235         */
       
   236         virtual const TPEDtmfString& DtmfString() const = 0;
       
   237 
       
   238         /**
       
   239         * Gets error code and cause values for the latest error
       
   240         * @return error code and cause values for the latest error
       
   241         */
       
   242         virtual const TPEErrorInfo& ErrorInfo() const = 0;
       
   243 
       
   244         /**
       
   245         * Gets key code of the last key press
       
   246         * @return key code of the last key press
       
   247         */
       
   248         virtual const TChar& KeyCode() const = 0;
       
   249 
       
   250         /**
       
   251         * Gets keypad volume value
       
   252         * @return keypad volume value
       
   253         */
       
   254         virtual const TInt& KeypadVolume() const = 0;
       
   255 
       
   256         /**
       
   257         * Gets lifetimer data
       
   258         * @return lifetime data (TDes8&)
       
   259         */
       
   260         virtual const TPELifeTimeData& LifeTimerData() const = 0;
       
   261 
       
   262         /**
       
   263         * Gets a logging indicator
       
   264         * @param aCallId, call identification number     
       
   265         * @return continuous logging indicator
       
   266         */
       
   267         virtual TBool LoggingIndicator( const TInt aCallId ) const = 0;
       
   268 
       
   269         /**
       
   270         * Get missed call indicator
       
   271         * @param aCallId, call identification number
       
   272         * @return missed call indicator
       
   273         */
       
   274         virtual TBool MissedCall( const TInt aCallId ) const = 0;
       
   275 
       
   276         /**
       
   277         * Gets network registration status
       
   278         * @return TNWNetworkRegistrationStatus Network registration status
       
   279         */
       
   280         virtual const TNWNetworkRegistrationStatus& NetworkRegistrationStatus() const = 0;
       
   281 
       
   282         /**
       
   283         * Get ringing tone
       
   284         * Returns a ringing tone defined for one of the user groups
       
   285         * if personal tone is not found
       
   286         * @param aCallId, call identification number
       
   287         * @return ringing tone file path
       
   288         */
       
   289         virtual const TPEContactFileName& PersonalRingingTone(
       
   290             const TInt aCallId ) const = 0;
       
   291 
       
   292         /**
       
   293         * Gets personal tone status
       
   294         * @return personal tone status
       
   295         */
       
   296         virtual const TBool& PersonalToneStatus() const = 0;
       
   297 
       
   298         /**
       
   299         * Gets phone identity parameters
       
   300         * @return phone identity parameters. 
       
   301         */
       
   302         virtual const TPEPhoneIdentityParameters& PhoneIdentityParameters() const = 0;
       
   303 
       
   304         /**
       
   305         * Gets phone number
       
   306         * @return Reference to TPEPhoneNumber, containing the phone number of the remote party.
       
   307         */
       
   308         virtual const TPEPhoneNumber& PhoneNumber() const = 0;
       
   309 
       
   310         /**
       
   311         * Gets phone number parsing result
       
   312         * @return ETrue if phone number is a service code
       
   313         */
       
   314         virtual const TBool& PhoneNumberIsServiceCode() const = 0;
       
   315 
       
   316         /**
       
   317         * Gets profile id
       
   318         * @return profile id
       
   319         */
       
   320         virtual const TInt& ProfileId() const = 0;
       
   321 
       
   322         /**
       
   323         * Gets profile name
       
   324         * @return profile name.  
       
   325         */
       
   326         virtual const TPEProfileName& ProfileName() const = 0;
       
   327 
       
   328         /**
       
   329         * Gets contact company name
       
   330         * @param aCallId, call identification number
       
   331         * @return company name
       
   332         */
       
   333         virtual const TPEContactCompany& RemoteCompanyName(
       
   334             const TInt aCallId ) const = 0;
       
   335 
       
   336         /**
       
   337         * Gets remote party identity 
       
   338         * @param aCallId is the Call identification number
       
   339         * @return remote party identity
       
   340         */
       
   341         virtual RMobileCall::TMobileCallRemoteIdentityStatus RemoteIdentity ( 
       
   342             const TInt aCallId ) const = 0;
       
   343 
       
   344         /**
       
   345         * Gets contact name
       
   346         * Depending on user selected language may be in order:
       
   347         * first + last name OR last + first name
       
   348         * @param aCallId, call identification number
       
   349         * @return contact name
       
   350         */
       
   351         virtual const TPEContactName& RemoteName( const TInt aCallId ) const = 0;
       
   352 
       
   353         /**
       
   354         * Gets remote end phone number
       
   355         * @param aCallId, call identification number
       
   356         * @return phone number
       
   357         */
       
   358         virtual const TPEPhoneNumber& RemotePhoneNumber(
       
   359             const TInt aCallId ) const = 0;
       
   360 
       
   361         /**
       
   362         * Gets remote end phone number type
       
   363         * @param aCallId, call identification number
       
   364         * @return phone number type
       
   365         */
       
   366         virtual const TPEPhoneNumberIdType& RemotePhoneNumberType(
       
   367             const TInt aCallId ) const = 0;
       
   368 
       
   369         /**
       
   370         * Gets text to speech text for this contact. Used in
       
   371         * text to speech ringing tone.
       
   372         * @param aCallId, call identification number
       
   373         * @return descriptor, ownership passed.
       
   374         */
       
   375         virtual const TPtrC RemoteTextToSpeechText(
       
   376             const TInt aCallId ) const = 0;
       
   377 
       
   378         /**
       
   379         * Gets remote predefined dtmf strings
       
   380         * @param aCallId, call identification number
       
   381         * @return reference to string array
       
   382         */
       
   383         virtual const CDesCArray&  RemotePredefinedDtmfStrings(
       
   384             const TInt aCallId ) const = 0;                 
       
   385  
       
   386         /**
       
   387         * Gets ringing type
       
   388         * @return ringing type
       
   389         */
       
   390         virtual const TProfileRingingType& RingingType() const = 0; 
       
   391 
       
   392         /**
       
   393         * Gets ringing tone name
       
   394         * @param aCallId, call identification number 
       
   395         * @return name of the current ringing tone
       
   396         */
       
   397         virtual const TPEContactFileName& RingingTone( const TInt& aCallId ) const = 0;
       
   398         
       
   399         /**
       
   400         * Gets current ringing volume
       
   401         * @return the current ringing volume
       
   402         */
       
   403         virtual const TInt& RingingVolume() const = 0;       
       
   404 
       
   405         /**
       
   406         * Gets text-to-speech preference setting value
       
   407         * @return text-to-speech status (EFalse/ETrue)
       
   408         */
       
   409         virtual const TBool& TextToSpeech() const = 0;
       
   410 
       
   411         /**
       
   412         * Gets VoiceMailBoxNumber for Line 1 information from TPEBasicInfo-structure
       
   413         * @return line 1 VoiceMailBoxNumber information
       
   414         */
       
   415         virtual const TPEPhoneNumber& VoiceMailBoxNumberLine1() const = 0;
       
   416 
       
   417         /**
       
   418         * Gets VoiceMailBoxNumber for Line 2 information from TPEBasicInfo-structure
       
   419         * @return line 2 VoiceMailBoxNumber information
       
   420         */
       
   421         virtual const TPEPhoneNumber& VoiceMailBoxNumberLine2() const = 0;
       
   422 
       
   423         /**
       
   424         * Sets audio mute command to TPEBasicInfo-structure
       
   425         * @param aAudioMute is audio mute
       
   426         * @return None.
       
   427         */
       
   428         virtual void SetAudioMuteCommand( const TInt& aAudioMute ) = 0;
       
   429         
       
   430         /**
       
   431         * Sets audio output command to TPEBasicInfo-structure
       
   432         * @param aOutput is audio output path
       
   433         * @param aShowNote is audio note value
       
   434         * @return None.
       
   435         */
       
   436         virtual void SetAudioOutputCommand( 
       
   437             const TPEAudioOutput& aOutput,
       
   438             const TBool aShowNote  ) = 0;
       
   439 
       
   440         /**
       
   441         * Sets audio volume command to TPEBasicInfo-structure
       
   442         * @param aAudioVolume is audio volume
       
   443         * @return None.
       
   444         */
       
   445         virtual void SetAudioVolumeCommand( const TInt& aAudioVolume ) = 0;
       
   446         
       
   447         /**
       
   448         * Sets CallId value to TPECallCommandInfo-structure
       
   449         * @param aCallId is the call id number.
       
   450         * @return None.
       
   451         */
       
   452         virtual void SetCallId( const TInt& aCallId ) = 0;
       
   453 
       
   454         /**
       
   455         * Sets call type information for following command message
       
   456         * Used for specifying the call type of the next attempted call
       
   457         * @param aCallType is the call type of the next attempted call
       
   458         */
       
   459         virtual void SetCallTypeCommand( const TPECallType& aCallType ) =  0;
       
   460 
       
   461         /**
       
   462         * Sets dtmf string value to TPEBasicInfo-structure
       
   463         * @param aDtmfString is the dtmf string to be sent. 
       
   464         * @return None.
       
   465         */
       
   466         virtual void SetDtmfStringCommand( const TPEDtmfString& aDtmfString ) = 0;
       
   467 
       
   468         /**
       
   469         * Sets key code value to TPEBasicInfo-structure
       
   470         * @param aKeyCode is the key code value.
       
   471         * @return None.
       
   472         */
       
   473         virtual void SetKeyCode( const TChar& aKeyCode ) = 0; 
       
   474 
       
   475         /**
       
   476         * Sets phone number to TPECallCommandInfo-structure
       
   477         * @param aPhoneNumber is the phone number
       
   478         * @return None.
       
   479         */
       
   480         virtual void SetPhoneNumber( const TPEPhoneNumber& aPhoneNumber ) = 0;
       
   481 
       
   482         /**
       
   483         * Gets two digit support status value
       
   484         * @return two digit support status (EFalse/ETrue)
       
   485         */
       
   486         virtual const TBool& TwoDigitSupportStatus() const = 0;
       
   487      
       
   488         /**
       
   489         * Returns the service-id used for the command.
       
   490         * @return TUint32 ServiceId
       
   491         */
       
   492         virtual TUint32 ServiceIdCommand() const = 0;
       
   493         
       
   494         /**
       
   495         * SetServiceIdCommand
       
   496         * @return None
       
   497         */
       
   498         virtual void SetServiceIdCommand( TUint32 aServiceId ) = 0;
       
   499         
       
   500         /**
       
   501         * Gets ServiceId
       
   502         * @return ServiceId
       
   503         */
       
   504         virtual TUint32 ServiceId( const TInt aCallId ) const = 0;
       
   505 
       
   506         /**
       
   507         * Gets active forwarding information from TPEBasicInfo-structure
       
   508         * @return deflect information
       
   509         */
       
   510         virtual const TPEActiveForwardInfo& ActiveForwardingInfo() const = 0;
       
   511 
       
   512         /**
       
   513         * Gets barring information from TPEBasicInfo-structure
       
   514         * @return barring information
       
   515         */
       
   516         virtual const TPEBarringInfo& BarringInfo() const = 0;
       
   517 
       
   518         /**
       
   519         * Gets conference value from TPECallInfo-structure
       
   520         * @param aCallId is the call identification number
       
   521         * @return call conference value
       
   522         */
       
   523         virtual TInt CallConference( const TInt aCallId ) const = 0;
       
   524 
       
   525         /**
       
   526         * Gets call control caps from the TPECallInfo-structure
       
   527         * @param aCallId is the call identification number
       
   528         * @return call control capabilities
       
   529         */
       
   530         virtual TPECallControlCaps CallControlCaps( const TInt aCallId ) const = 0;
       
   531 
       
   532         /**
       
   533         * Gets forwarded value from TPECallInfo-structure
       
   534         * @param aCallId is the call identification number
       
   535         * @return is call forwarded or not
       
   536         */
       
   537         virtual TBool CallForwarded( const TInt aCallId ) const = 0;
       
   538 
       
   539         /**
       
   540         * Gets Service information from TPECallInfo-structure
       
   541         * @param aCallId is the call identification number.
       
   542         * @return mobile call service type
       
   543         */
       
   544         virtual RMobilePhone::TMobileService CallService( const TInt aCallId ) const = 0;
       
   545 
       
   546         /**
       
   547         * Gets Conference call capabilities
       
   548         * @param aCallId is the call identification number
       
   549         * @return conference call capabilities
       
   550         */
       
   551         virtual TUint32 ConferenceCallCaps( const TInt aCallId ) const = 0;
       
   552 
       
   553         /**
       
   554         * Gets Conference call capabilities
       
   555         * @param aCallId is the call identification number
       
   556         * @return conference call member name
       
   557         */
       
   558         virtual const TName& ConferenceMemberName( const TInt aCallId ) const = 0;
       
   559 
       
   560         /**
       
   561         * Gets Conference call capabilities
       
   562         * @param aCallId is the call identification number
       
   563         * @return conference call member id
       
   564         */
       
   565         virtual TInt IsConferenceMemberId( const TInt aCallId ) const = 0;
       
   566 
       
   567         /**
       
   568         * Gets emergency number to be checked for validity
       
   569         * @return emergency number to be checked for validity
       
   570         */
       
   571         virtual const TPEPhoneNumber& EmergencyNumber() const = 0;
       
   572 
       
   573         /**
       
   574         * Gets number of the conference members
       
   575         * @param aCallId is the call identification number
       
   576         * @return number of conference members
       
   577         */
       
   578         virtual TInt NumberOfConferenceMembers( const TInt aCallId ) const = 0;
       
   579 
       
   580         /**
       
   581         * Get remote end connected phone number
       
   582         * @param aCallId, call identification number
       
   583         * @return phone number
       
   584         */
       
   585         virtual const TPEPhoneNumber& RemoteColpNumber(
       
   586             const TInt aCallId ) const = 0;
       
   587 
       
   588         /**
       
   589         * Gets Sim state
       
   590         * @return current Sim state
       
   591         */
       
   592         virtual const TPESimState& SimState() const = 0;
       
   593 
       
   594         /**
       
   595          * Gets secure specified status
       
   596          * @return ETrue if secure specified
       
   597          */
       
   598         virtual TBool SecureSpecified( ) const = 0;        
       
   599         
       
   600         /**
       
   601         * Gets the last suplementary services string command information
       
   602         * @return Suplementary Services command information.  
       
   603         */
       
   604         virtual const TPESSCommandInfo& SSCommandInfo() const = 0;
       
   605     
       
   606         /**
       
   607         * Sets emergency numbers of the phone to TPEBasicInfo-structure
       
   608         * @param aEmergencyNumber for emergency number checking.
       
   609         * @return None.
       
   610         */
       
   611         virtual void SetEmergencyNumber( const TPEPhoneNumber& aEmergencyNumbers ) = 0;
       
   612         
       
   613         /**
       
   614          * Gets remote party name. Contains possible recieved CNAP name or 
       
   615          *  received skype identification
       
   616          * @param aCallId, Call identification number.
       
   617          * @return Name of the remote party detemined by network.
       
   618          */
       
   619         virtual const TPEContactName& RemotePartyName( const TInt aCallId ) const = 0;
       
   620         
       
   621         /**
       
   622          * Returns transfer target from the last received unattended transfer 
       
   623          * request or KNullDesC if transfer target is not available.
       
   624          * 
       
   625          * @return  Transfer target.
       
   626          */
       
   627         virtual const TPEPhoneNumber& UnattendedTransferTarget( 
       
   628             TInt aCallId ) const = 0;
       
   629         
       
   630         /**
       
   631          * Sets transfer target from the last received unattended transfer request.
       
   632          *
       
   633          * @param   aTarget     Transfer target to set.
       
   634          * @param   aCallId     Call identification number.
       
   635          */
       
   636         virtual void SetUnattendedTransferTarget( 
       
   637             const TPEPhoneNumber& aTarget, TInt aCallId ) = 0;
       
   638 
       
   639         /**
       
   640          * Returns address choices from received call forward request 
       
   641          * or NULL if addresses are not available.
       
   642          * 
       
   643 		 * @param   aCallId     Call identification number.
       
   644          * @return  Address array.
       
   645          */
       
   646         virtual const CDesC8Array* ForwardAddressChoices( TInt aCallId ) const = 0;
       
   647         
       
   648         /**
       
   649          * Sets address choices from received call forward request.
       
   650          *
       
   651          * @param   aArray      Address array.
       
   652          * @param   aCallId     Call identification number.
       
   653          */
       
   654         virtual void SetForwardAddressChoices( const CDesC8Array* aArray,
       
   655             TInt aCallId ) = 0;
       
   656             
       
   657         /**
       
   658          * Sets array index for user selected address.
       
   659          *
       
   660          * @param   aIndex     Array index for selected address.
       
   661          */
       
   662         virtual void SetForwardAddressIndex( TInt aIndex ) = 0;
       
   663         
       
   664         /**
       
   665          * Returns array index for user selected address.
       
   666          * Address is used for call forwarding.
       
   667          *
       
   668          * @return Array index for selected address.
       
   669          */
       
   670         virtual TInt ForwardAddressIndex() = 0;
       
   671 
       
   672         /**
       
   673          * Sets transfer target address for unattended transfer
       
   674          * @param aTransferTarget Target address for unattended transfer
       
   675          */
       
   676         virtual void SetTransferTargetCommand( const TPEPhoneNumber& aTransferTarget ) = 0;
       
   677 
       
   678         /**
       
   679         * Returns transfer target address
       
   680         * @return Transfer target address set with SetTransferTargetCommand
       
   681         */
       
   682         virtual const TPEPhoneNumber& TransferTargetCommand() const = 0;
       
   683         
       
   684         /**
       
   685         * Returns switch to operation status.
       
   686         */
       
   687         virtual TBool IsSwitchToOperationOngoing() const = 0;
       
   688         
       
   689 		/**
       
   690         * Checks if given state can be found.
       
   691 		* @param aCallState state to be checked.
       
   692         */
       
   693         virtual TBool CheckIfCallStateExists( const TPEState& aCallState )= 0;
       
   694         
       
   695         /**
       
   696          * Returns call origin for the call
       
   697          * @param aOrigin indicates if the call is phone, client or SAT originated
       
   698          */
       
   699         virtual TPECallOrigin CallOrigin( const TInt aCallId ) const = 0;
       
   700         
       
   701     }; // MPEEngineInfo
       
   702     
       
   703 #endif      //MPEENGINEINFO_H
       
   704     
       
   705 // End of File
       
   706