RIL_Dial

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function is responsible for dialing voice and data calls.

Syntax

HRESULT RIL_Dial(
  HRIL hRil,
  LPCSTR lpszAddress,
  DWORD dwType,
  DWORD dwOptions
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• lpszAddress
  Address to dial. This value can be no longer than MAXLENGTH_ADDRESS characters.

• dwType
  Specifies the type of the call to establish. The following table shows the possible values.

  Value	Description
  RIL_CALLTYPE_VOICE	The call is a voice call.
  RIL_CALLTYPE_DATA	The call is a data call.
  RIL_CALLTYPE_FAX	The call is a fax call. This value is not supported.

• dwOptions
  Specifies the dialing options. The following table shows the possible values.

  Value	Description
  RIL_DIALOPT_RESTRICTID	Block caller ID.
  RIL_DIALOPT_PRESENTID	Present caller ID.
  RIL_DIALOPT_CLOSEDGROUP	Closed user group dialing. This value is not supported.

Return Value

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

Asynchronous result RIL_RESULT_OK indicates success. The lpData notification parameter is set to NULL.

Remarks

This function is called to establish a voice or data call. A RIL driver should ignore any non-dialable characters in lpszAddress.

For voice calls, when RIL_Dial is called, the radio should begin dialing the specified address. The asynchronous result should be returned as soon as the radio has dialed the number. The RIL should not wait for the remote party to answer. For data calls, RIL_Dial should wait for the connection to be established before returning asynchronously. In either case, RIL_Dial must also generate RIL_NOTIFY_CONNECT when the asynchronous result is returned.

The RIL proxy translates the RIL_Dial function into IOCTL_RIL_Dial when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize