RIL_GetCallList

4/8/2010

This function is implemented by a RIL driver. It is responsible for querying the list and status of calls currently in progress.

Syntax

HRESULT RIL_GetCallList(
  HRIL hRil
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

Return Value

Positive HRESULT values indicate success and are used as command identifications for matching the asynchronous call result. Negative HRESULT values indicate an error. Errors are defined in the Ril.h file.

An asynchronous value of RIL_RESULT_OK indicates success. The lpData notification parameter points to an array of RILCALLINFO structures.

Remarks

This function is called during voice and data call scenarios to determine the current state of all calls in progress. The RIL proxy translates the RIL_GetCallList function into IOCTL_RIL_GetCallList when the RIL proxy calls RIL_IOControl.

In Global Systems for Mobile Communications (GSM), detailed call information about each call should be returned. This information is typically queried using the AT+CLCC command.

Because Code Division Multiple Access (CDMA) does not have the capability to track the status of multiple calls, it is appropriate for CDMA to return only a single RILCALLINFO structure even in conference or call waiting scenarios. The only scenario in CDMA that must result in two RILCALLINFO structures is a voice call with a simultaneous suspended data connection. Suspend and Resume can occur when a voice call is received after the user activates a data call. The voice call is active while the data call is connected but cannot send or receive data. When the voice call ends the data call resumes. Both GSM and CDMA support Suspend and Resume.

For more details on Suspend and Resume connections, refer to Radio Interface Layer Changes for Suspend and Resume and Making Suspend and Resume Connections During Voice Calls.

Requirements

See Also

Reference

RIL_Initialize
RILCALLINFO