See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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 HRESULTvalues indicate success and are command identifications for matching the asynchronous call result. Negative HRESULTvalues indicate an error. Errors are defined in the Ril.h file.
Asynchronous result RIL_RESULT_OKindicates success. The lpDatanotification 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_Dialis 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_Dialshould wait for the connection to be established before returning asynchronously. In either case, RIL_Dialmust also generate RIL_NOTIFY_CONNECT when the asynchronous result is returned.
The RIL proxy translates the RIL_Dialfunction into IOCTL_RIL_Dialwhen the RIL proxy calls RIL_IOControl.
Requirements
| Header | ril.h |
| Library | Ril.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |