CTelephonyFunctions Class Reference
class CTelephonyFunctions : public CBase
|
Class which uses Etel.DLL on behalf of
CTelephony
objects.
Public Member Functions
|
|
~CTelephonyFunctions
()
|
TInt
|
AnswerIncomingCallL
(
TRequestStatus
&,
CTelephony::TCallId
&, const
CTelephony::TPhoneLine
)
|
RMobileCall
*
|
Call
()
|
RMobileCall
*
|
Call
(const
CTelephony::TCallId
)
|
TInt
|
CancelAsync
(
CTelephony::TCancellationRequest
)
|
void
|
CleanUp
()
|
void
|
CloseAndReset
(const
CTelephony::TCallId
)
|
void
|
CompleteRequest
(
TOperations
,
TInt
)
|
void
|
CopyTelAddress
(const
RMobilePhone::TMobileAddress
&,
CTelephony::TTelAddress
&)
|
TInt
|
DialNewCallL
(
TRequestStatus
&,
TDes8
&, const
CTelephony::TTelNumber
&,
CTelephony::TCallId
&, const
CTelephony::TPhoneLine
)
|
TInt
|
GetBatteryInfoL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
GetCBSupplementaryServiceStatusL
(
TRequestStatus
&, const
CTelephony::TCallBarringCondition
,
TDes8
&, const
CTelephony::TServiceGroup
)
|
TInt
|
GetCFSupplementaryServiceStatusL
(
TRequestStatus
&, const
CTelephony::TCallForwardingCondition
,
TDes8
&, const
CTelephony::TServiceGroup
)
|
TInt
|
GetCWSupplementaryServiceStatusL
(
TRequestStatus
&,
TDes8
&, const
CTelephony::TServiceGroup
)
|
TInt
|
GetCallDynamicCaps
(const
CTelephony::TCallId
&,
TDes8
&)
|
TInt
|
GetCallInfoL
(
TDes8
&,
TDes8
&,
TDes8
&)
|
void
|
GetCallStatus
(const
RMobileCall::TMobileCallStatus
,
CTelephony::TCallStatus
&)
|
TInt
|
GetCallStatusL
(const
CTelephony::TCallId
&,
TDes8
&)
|
TInt
|
GetCurrentNetworkInfoL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
GetCurrentNetworkNameL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
GetFlightMode
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
GetISVCall
(
CTelephony::TCallId
&)
|
TInt
|
GetIdentityServiceStatusL
(
TRequestStatus
&, const
CTelephony::TIdentityService
&,
TDes8
&)
|
TInt
|
GetIndicatorL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
GetLineStatus
(const
CTelephony::TPhoneLine
&,
TDes8
&)
|
TInt
|
GetLockInfoL
(
TRequestStatus
&, const
CTelephony::TIccLock
&,
TDes8
&)
|
TInt
|
GetNetworkRegistrationStatusL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
GetOperatorNameL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
GetPhoneIdL
(
TRequestStatus
&,
TDes8
&)
|
TRequestStatus
**
|
GetRequestStatus
(
CTelephonyFunctions::TOperations
)
|
TInt
|
GetSignalStrengthL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
GetSubscriberIdL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
HangupL
(
TRequestStatus
&, const
CTelephony::TCallId
&)
|
TInt
|
HoldL
(
TRequestStatus
&, const
CTelephony::TCallId
&)
|
TBool
|
IsRequestPending
(
CTelephonyFunctions::TOperations
)
|
RMobileLine
*
|
Line
(const
CTelephony::TPhoneLine
)
|
CTelephonyFunctions
*
|
NewL
()
|
CTelephonyFunctions
*
|
NewLC
()
|
TInt
|
NotifyChangeL
(
TRequestStatus
&, const
CTelephony::TNotificationEvent
&,
TDes8
&)
|
RMobilePhone
*
|
Phone
()
|
RProperty
*
|
PhonePowerProperty
()
|
TRequestStatus
**
|
RequestStatus
()
|
void
|
ResetPendingNotifyRequest
(
CTelephony::TNotificationEvent
)
|
TInt
|
ResumeL
(
TRequestStatus
&, const
CTelephony::TCallId
&)
|
TInt
|
SendDTMFTonesL
(
TRequestStatus
&, const
TDesC
&)
|
void
|
SetAsyncRequestOutstandingFalse
()
|
void
|
SetRequestPending
(
CTelephonyFunctions::TOperations
,
TBool
)
|
TInt
|
SwapL
(
TRequestStatus
&, const
CTelephony::TCallId
&, const
CTelephony::TCallId
&)
|
Private Member Functions
|
|
CTelephonyFunctions
()
|
void
|
ConstructL
()
|
void
|
GetCommDbTSYnameL
(
TDes
&)
|
void
|
InitialisePhoneL
()
|
TBool
|
IsFlightModeOn
()
|
TInt
|
NotifyBatteryInfoL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyCurrentNetworkInfoL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyFlightModeL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyIndicatorL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyNetworkRegistrationStatusL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyOwnedCall1RemotePartyInfoL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyOwnedCall1StatusL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyOwnedCall2RemotePartyInfoL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyOwnedCall2StatusL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyPinLockInfoL
(
TRequestStatus
&, const
CTelephony::TNotificationEvent
&,
TDes8
&)
|
TInt
|
NotifySignalStrengthL
(
TRequestStatus
&,
TDes8
&)
|
TInt
|
NotifyVoiceLineStatusL
(
TRequestStatus
&,
TDes8
&)
|
Public Member Enumerations
|
enum
|
TCallPoolOperation
{
EUnset
,
EAnswer
,
EDial
}
|
enum
|
TOperations
{
EGetPhoneId
,
EGetSubscriberId
,
EGetFlightMode
,
EGetIndicator
,
EGetBatteryInfo
,
EGetSignalStrength
,
EGetIccLockInfo
,
ESendDTMFTones
,
EDialNewCall
,
EGetCallDynamicCaps
,
EGetCallStatus
,
EHold
,
EResume
,
ESwap
,
EHangup
,
EAnswerIncomingCall
,
ENotifyIncomingCall
,
EGetNetworkRegistrationStatus
,
EGetCurrentNetworkInfo
,
EGetCurrentNetworkName
,
EGetOperatorName
,
EGetCFSupplServicesStatus
,
EGetCBSupplServicesStatus
,
EGetCWSupplServicesStatus
,
EGetIdentityServiceStatus
,
EFlightModeChange
,
ENotifyIndicator
,
ENotifyBatteryInfo
,
ENotifySignalStrength
,
ENotifyPin1LockInfo
,
ENotifyPin2LockInfo
,
ENotifyNetworkRegistrationStatus
,
ENotifyCurrentNetworkInfo
,
ENotifyOwnedCall1Status
,
ENotifyOwnedCall2Status
,
ENotifyOwnedCall1RemoteInfo
,
ENotifyOwnedCall2RemoteInfo
,
ENotifyVoiceLineStatus
,
EMaxNumberOperations
}
|
enum
|
TState
{
EIdle
,
EDialling
,
EAnswering
,
EEstablishingDataChannel
,
EDataChannelInUse
,
ECleaningUp
}
|
Constructor & Destructor Documentation
CTelephonyFunctions()
CTelephonyFunctions
|
(
|
)
|
[private]
|
First-phase constructor
private function which cannot Leave().
Member Functions Documentation
AnswerIncomingCallL(TRequestStatus &, CTelephony::TCallId &, const CTelephony::TPhoneLine)
Attempt to answer an incoming call.
This can only be done with a voice line.
Call(const CTelephony::TCallId)
CancelAsync(CTelephony::TCancellationRequest)
Cancel the outstanding async request.
CleanUp()
Cleans up any outstanding "Open" objects.
CloseAndReset(const CTelephony::TCallId)
Closes the open call object and resets its pool status back to Unset
CompleteRequest(TOperations, TInt)
Completes the request back to the client that requested it.
Parameters
TOperations
aOPeration
|
The operation that has been completed.
|
TInt
aCompleteCode
|
The error code to be returned to the client.
|
ConstructL()
void
|
ConstructL
|
(
|
)
|
[private]
|
CopyTelAddress(const RMobilePhone::TMobileAddress &, CTelephony::TTelAddress &)
DialNewCallL(TRequestStatus &, TDes8 &, const CTelephony::TTelNumber &, CTelephony::TCallId &, const CTelephony::TPhoneLine)
GetBatteryInfoL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the battery information.
GetCBSupplementaryServiceStatusL(TRequestStatus &, const CTelephony::TCallBarringCondition, TDes8 &, const CTelephony::TServiceGroup)
Initiate async request to interrogate the call barring status for a specified service group and condition.
GetCFSupplementaryServiceStatusL(TRequestStatus &, const CTelephony::TCallForwardingCondition, TDes8 &, const CTelephony::TServiceGroup)
Initiate async request to interrogate the call forwarding status for a specified service group and condition.
GetCWSupplementaryServiceStatusL(TRequestStatus &, TDes8 &, const CTelephony::TServiceGroup)
Initiate async request to interrogate the call waiting status for a specified service group.
GetCallDynamicCaps(const CTelephony::TCallId &, TDes8 &)
Retrieve the calls dynamic capabilities.
GetCallInfoL(TDes8 &, TDes8 &, TDes8 &)
Get the current call information.
GetCallStatus(const RMobileCall::TMobileCallStatus, CTelephony::TCallStatus &)
GetCallStatusL(const CTelephony::TCallId &, TDes8 &)
Retrieve the current call status.
GetCommDbTSYnameL(TDes &)
void
|
GetCommDbTSYnameL
|
(
|
TDes
&
|
aTableName
|
)
|
[private]
|
GetCurrentNetworkInfoL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve current network information.
GetCurrentNetworkNameL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the ICC-stored current network name.
This functionality is not available when the phone is in "flight" mode.
Parameters
TRequestStatus
& aReqStatus
|
Returns the result code after the asynchronous call completes. KErrAccessDenied will be returned if the phone is in flight mode.
|
TDes8
& aNetworkName
|
Contains a CTelephony::TNetworkNameV1Pckg, a packaged version of the CTelephony::TNetworkNameV1 class which is filled on completion.
|
GetFlightMode(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the current flight mode status.
GetISVCall(CTelephony::TCallId &)
Return an available call ID. Also, continue looping though other call objects for opportunity to close them if they have become idle.
GetIdentityServiceStatusL(TRequestStatus &, const CTelephony::TIdentityService &, TDes8 &)
Initiate async request to retrieve the identity service status.
GetIndicatorL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the phones indicators.
GetLineStatus(const CTelephony::TPhoneLine &, TDes8 &)
Get the current line status.
GetLockInfoL(TRequestStatus &, const CTelephony::TIccLock &, TDes8 &)
Initiate async request to retrieve the ICC lock information.
GetNetworkRegistrationStatusL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the network registration status.
GetOperatorNameL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the operator name.
This functionality is not available when the phone is in "flight" mode.
Note: This information is only available on GSM/WCDMA networks.
Parameters
TRequestStatus
& aReqStatus
|
Returns the result code after the asynchronous call completes. KErrAccessDenied will be returned if the phone is in flight mode.
|
TDes8
& aOperator
|
Contains a CTelephony::TOperatorNameV1Pckg, a packaged version of the CTelephony::TOperatorNameV1 class which is filled on completion.
|
GetPhoneIdL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the phone identifier.
GetRequestStatus(CTelephonyFunctions::TOperations)
GetSignalStrengthL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the signal strength.
GetSubscriberIdL(TRequestStatus &, TDes8 &)
Initiate async request to retrieve the subscriber Id.
HangupL(TRequestStatus &, const CTelephony::TCallId &)
Attempt to hangup a call.
HoldL(TRequestStatus &, const CTelephony::TCallId &)
Attempt to place a call on hold.
InitialisePhoneL()
void
|
InitialisePhoneL
|
(
|
)
|
[private]
|
Finds the first data-Line and Open()'s the Phone and Line.
-
leave
-
Leaves if underlying ETEL.DLL returns error, or if we can't find a suitable Phone/Line or can't open it.
IsFlightModeOn()
TBool
|
IsFlightModeOn
|
(
|
)
|
[private]
|
IsRequestPending(CTelephonyFunctions::TOperations)
Line(const CTelephony::TPhoneLine)
Active Objects will use this function to get the required line handle.
NewL()
Constructs a
CTelephonyFunctions
object.
-
leave
-
Leaves if no memory, or underlying Etel DLL returns error.
NewLC()
Constructs a
CTelephonyFunctions
object.
A pointer to this object is left on the
CleanupStack
.
-
leave
-
Leaves if no memory, or underlying Etel DLL returns error.
NotifyBatteryInfoL(TRequestStatus &, TDes8 &)
Post a battery info change notification request
NotifyChangeL(TRequestStatus &, const CTelephony::TNotificationEvent &, TDes8 &)
Send a notification request.
Parameters
TRequestStatus
& aReqStatus
|
The request status to be returned when an event occurs for client notification.
|
const
CTelephony::TNotificationEvent
& aEvent
|
The notification event the caller is requesting.
|
TDes8
& aDes
|
Packaged data returned by the TSY when an event for notification occurs.
|
NotifyCurrentNetworkInfoL(TRequestStatus &, TDes8 &)
Post a current network info change notification request
NotifyFlightModeL(TRequestStatus &, TDes8 &)
Post a Flight mode notification request
NotifyIndicatorL(TRequestStatus &, TDes8 &)
Post a indicator notification request
NotifyNetworkRegistrationStatusL(TRequestStatus &, TDes8 &)
Post a network registration change notification request
NotifyOwnedCall1RemotePartyInfoL(TRequestStatus &, TDes8 &)
Post a remote party info call 1 notification request
NotifyOwnedCall1StatusL(TRequestStatus &, TDes8 &)
Post a call 1 status change notification request
NotifyOwnedCall2RemotePartyInfoL(TRequestStatus &, TDes8 &)
Post aremote party info call 2 notification request
NotifyOwnedCall2StatusL(TRequestStatus &, TDes8 &)
Post a call 2 status change notification request
NotifyPinLockInfoL(TRequestStatus &, const CTelephony::TNotificationEvent &, TDes8 &)
Post a pin lock change notification request
NotifySignalStrengthL(TRequestStatus &, TDes8 &)
Post a signal strength change notification request
NotifyVoiceLineStatusL(TRequestStatus &, TDes8 &)
Post a voice line status notification request.
Parameters
TRequestStatus
& aRequestStatus
|
The request status.
|
TDes8
& aDes
|
Package containing TCallStatus which will store the resulting line status.
|
Phone()
RMobilePhone
*
|
Phone
|
(
|
)
|
[inline]
|
ResetPendingNotifyRequest(CTelephony::TNotificationEvent)
Reset the pending notify request flag
ResumeL(TRequestStatus &, const CTelephony::TCallId &)
Attempt to Resume a previously held call
SendDTMFTonesL(TRequestStatus &, const TDesC &)
Initiate async request to transmit DTMF tones.
SetAsyncRequestOutstandingFalse()
void
|
SetAsyncRequestOutstandingFalse
|
(
|
)
|
[inline]
|
SetRequestPending(CTelephonyFunctions::TOperations, TBool)
SwapL(TRequestStatus &, const CTelephony::TCallId &, const CTelephony::TCallId &)
Attempt to swap the currently held and active calls.
Member Enumerations Documentation
Enum TOperations
Enumerators
EGetPhoneId
|
|
EGetSubscriberId
|
|
EGetFlightMode
|
|
EGetIndicator
|
|
EGetBatteryInfo
|
|
EGetSignalStrength
|
|
EGetIccLockInfo
|
|
ESendDTMFTones
|
|
EDialNewCall
|
|
EGetCallDynamicCaps
|
|
EGetCallStatus
|
|
EHold
|
|
EResume
|
|
ESwap
|
|
EHangup
|
|
EAnswerIncomingCall
|
|
ENotifyIncomingCall
|
|
EGetNetworkRegistrationStatus
|
|
EGetCurrentNetworkInfo
|
|
EGetCurrentNetworkName
|
|
EGetOperatorName
|
|
EGetCFSupplServicesStatus
|
|
EGetCBSupplServicesStatus
|
|
EGetCWSupplServicesStatus
|
|
EGetIdentityServiceStatus
|
|
EFlightModeChange
|
|
ENotifyIndicator
|
|
ENotifyBatteryInfo
|
|
ENotifySignalStrength
|
|
ENotifyPin1LockInfo
|
|
ENotifyPin2LockInfo
|
|
ENotifyNetworkRegistrationStatus
|
|
ENotifyCurrentNetworkInfo
|
|
ENotifyOwnedCall1Status
|
|
ENotifyOwnedCall2Status
|
|
ENotifyOwnedCall1RemoteInfo
|
|
ENotifyOwnedCall2RemoteInfo
|
|
ENotifyVoiceLineStatus
|
|
EMaxNumberOperations
|
|
Enum TState
Enumerators
EIdle
|
|
EDialling
|
|
EAnswering
|
|
EEstablishingDataChannel
|
|
EDataChannelInUse
|
|
ECleaningUp
|
|
Member Data Documentation
CAnswerIncomingCallAct * iAnswerIncomingCall
TBool
iAsyncRequestOutstanding
TBool
|
iAsyncRequestOutstanding
|
[private]
|
TBool
iCallIsOpen
TBool
|
iCallIsOpen
|
[private]
|
TName
iCallName
TName
|
iCallName
|
[private]
|
RArray< RMobileCall > iCallPool
RArray< TCallPoolOperation > iCallPoolStatus
CDialNewCallAct * iDialNewCall
CFlightModeChangeAct * iFlightModeChange
CGetBatteryInfoAct * iGetBatteryInfo
CGetSupplementaryServiceStatusAct * iGetCBSupplementaryServiceStatus
CGetSupplementaryServiceStatusAct * iGetCFSupplementaryServiceStatus
CGetSupplementaryServiceStatusAct * iGetCWSupplementaryServiceStatus
CGetCurrentNetworkInfoAct * iGetCurrentNetworkInfo
CGetCurrentNetworkNameAct * iGetCurrentNetworkName
CGetIccLockInfoAct * iGetIccLockInfo
CGetIdentityServiceStatusAct * iGetIdentityServiceStatus
CGetIndicatorAct * iGetIndicator
CGetNetworkRegistrationStatusAct * iGetNetworkRegistrationStatus
CGetOperatorNameAct * iGetOperatorName
CGetPhoneIdAct * iGetPhoneId
CGetSignalStrengthAct * iGetSignalStrength
CGetSubscriberIdAct * iGetSubscriberId
RMobileCall
iIncomingCall
CNotifyIncomingCallAct * iInternalNotifyIncomingCall
CNotifyLineStatusAct * iInternalNotifyVoiceLineStatus
TBool
iLineIsDataOpen
TBool
|
iLineIsDataOpen
|
[private]
|
TBool
iLineIsFaxOpen
TBool
|
iLineIsFaxOpen
|
[private]
|
TBool
iLineIsVoiceOpen
TBool
|
iLineIsVoiceOpen
|
[private]
|
TName
iLineVoiceName
TName
|
iLineVoiceName
|
[private]
|
CNotifyBatteryInfoAct * iNotifyBatteryInfo
CNotifyCurrentNetworkInfoAct * iNotifyCurrentNetworkInfo
CNotifyIccLockInfoAct * iNotifyIccLockInfo
CNotifyIndicatorAct * iNotifyIndicator
CNotifyNetworkRegistrationStatusAct * iNotifyNetworkRegStatus
CNotifyRemotePartyInfoAct * iNotifyOwnedCall1RemoteInfo
CNotifyCallStatusAct * iNotifyOwnedCall1Status
CNotifyRemotePartyInfoAct * iNotifyOwnedCall2RemoteInfo
CNotifyCallStatusAct * iNotifyOwnedCall2Status
CNotifySignalStrengthAct * iNotifySignalStrength
RMobilePhone
iPhone
RMobilePhone
|
iPhone
|
[private]
|
TBool
iPhoneIsOpen
TBool
|
iPhoneIsOpen
|
[private]
|
RProperty
iPhonePowerProperty
RArray< TBool > iReqPendingTable
RPointerArray< TRequestStatus > iReqStatusTable
TRequestStatus * iRequestStatus
CSendDTMFTonesAct * iSendDTMFTones
TBool
iTelServerIsOpen
TBool
|
iTelServerIsOpen
|
[private]
|
TInt
iTsyVersion
TInt
|
iTsyVersion
|
[private]
|
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.