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. |
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] |
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
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.