Voice Line Status Tutorial

This tutorial describes how to get the voice line status with the telephony API for applications.

1. create a new instance of CTelephony
2. use CTelephony::GetLineStatus() to get the simple voice line status
3. use CTelephony::GetCallStatus() to get the status of any voice call owned by the client application
4. use CTelephony::GetCallInfo() to get the detailed call information about the call pass the following parameters for the required information

   Parameter	Function
   TCallStatus	To get the status of a call like idle, on-hold, dialling and ringing
   TDateTime	To get the data and time of a call
   TTimeIntervalSeconds	To get the duration of a call
   TTelAddress	To get the destination number
   TPhoneNetworkSecurity	To get the ciphering information from the network
   TCallRemoteIdentityStatus	To determine if the remote caller status is available
   TCallDirection	To determine the call direction

5. use GetCallDynamicCaps() to get the dynamic capability information about the call.

CTelephony* telephony = CTelephony::NewLC();

CTelephony::TCallInfoV1 callInfoV1;
CTelephony::TCallInfoV1Pckg callInfoV1Pckg( callInfoV1 );

CTelephony::TCallSelectionV1 callSelectionV1;
CTelephony::TCallSelectionV1Pckg callSelectionV1Pckg( callSelectionV1 );

CTelephony::TRemotePartyInfoV1 remotePartyInfoV1;
CTelephony::TRemotePartyInfoV1Pckg remotePartyInfoV1Pckg( remotePartyInfoV1  );

callSelectionV1.iLine = CTelephony::EVoiceLine;
callSelectionV1.iSelect = CTelephony::EActiveCall;

telephony->GetCallInfo( callSelectionV1Pckg, callInfoV1Pckg, remotePartyInfoV1Pckg );

CleanupStack::PopAndDestroy( telephony );

CTelephony::TCallCapsV1 callCapsV1;
CTelephony::TCallCapsV1Pckg callCapsV1Pckg( callCapsV1 );

telephony->GetCallDynamicCaps( callId, callCapsV1Pckg );
TUint32 caps = callCapsV1.iControlCaps;
if( caps & CTelephony::KCapsHold )
   {} // The call represented by 'callId' can be put on hold