次の方法で共有


RIL_Dial (Windows Embedded CE 6.0)

1/6/2010

This function is responsible for dialing voice and data calls.

Syntax

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

Parameters

  • 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

Header ril.h
Library Ril.lib
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

RIL Functions
RIL_Initialize