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
- 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
| Header | ril.h |
| Library | Ril.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |