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. |
RIL functions can be asynchronous or synchronous. Most of the RIL functions are asynchronous. For both asynchronous and synchronous RIL functions, an immediate asynchronous returned result, HRESULT, indicates success or failure of the function call.
For asynchronous functions, positive HRESULTvalues indicate success and are used as command identifications for matching the asynchronous callback. The asynchronous result callback returns the final result in a buffer. Valid command identifications are in the range 0x00000001 to 0x7fffffff. Zero is not a valid return value for asynchronous calls. Negative HRESULTvalues indicate an error. HRESULTerror values of E_XXX are defined in winerror.h file. HRESULTerror values of RIL_E_XXX are defined in Ril.h.
For synchronous functions, an HRESULTvalue of S_OK indicates success. An asynchronous result callback is not called. If a synchronous RIL function needs a final result, a pointer to a data structure is passed in the RIL function and the final result is put in the data structure. For synchronous functions, HRESULTvalues of E_XXX indicate an error. Errors are defined in winerror.h file.
The following table shows the RIL functions with a description of the purpose of each.
Function | Description | ||
---|---|---|---|
This function adds a call forwarding rule. |
|||
This function adds a specified operator to the list of preferred operators. |
|||
This function is implemented by a RIL driver. It is responsible for answering the currently offering call. |
|||
This function cancels the current supplementary service session. |
|||
This function changes the password for the specified type of call barring. |
|||
|
|
||
This function changes the locking password for the specified facility. |
|||
This function clears the registration for a completion of the call to busy subscriber (CCBS) index. |
|||
|
|
||
This function deinitializes RIL. This function is synchronous. |
|||
This function deletes a particular GPRS context. |
|||
This function deletes the minimum quality of service profile for a context. |
|||
This function deletes a message from the current storage location. |
|||
This function deletes a phonebook entry from the current storage location. |
|||
This function deletes the requested quality of service profile for a context. |
|||
This function is used by an OEM to provide custom calls into the RIL driver. |
|||
This function is responsible for dialing voice and data calls. |
|||
This function disables classes of notifications for a client. This function is synchronous. |
|||
This function enables additional classes of notifications for a client. This function is synchronous. |
|||
This function enters into a GPRS data state. |
|||
This function fetches a SIM Toolkit command from the SIM. |
|||
This function retrieves the built-in list of all known operators. |
|||
This function gets the Answer To Reset (ATR) string from the SIM. |
|||
This function retrieves the current transmit and receive audio devices. |
|||
This function retrieves audio gain information. |
|||
This function is implemented by a RIL driver. It is responsible for querying the mute status of the radio. |
|||
This function retrieves the current data bearer service options. |
|||
This function retrieves the status of the specified type of call barring. |
|||
This function retrieves the current caller ID settings. |
|||
This function retrieves current call forwarding rules. |
|||
|
|
||
This function retrieves information classes that call waiting is currently enabled for. |
|||
This function retrieves the status for a Completion of Call to Busy Subscriber (CCBS) index. |
|||
This function retrieves the cell broadcast messaging configuration. |
|||
This function retrieves information about the cell tower currently used by the phone. |
|||
This function retrieves the current closed user group settings. |
|||
This function retrieves the current or default address identification for devices that support multiple device addresses. |
|||
This function retrieves the operator the device is currently registered with. |
|||
This function retrieves the current voice privacy status. |
|||
This function retrieves the current roaming status. |
|||
This function retrieves the current system types. |
|||
This function retrieves data compression options. |
|||
This function is responsible for retrieving specific device capabilities. |
|||
This function retrieves the current settings for the dialed ID. |
|||
This function retrieves the driver version information. This function is synchronous. |
|||
This function retrieves manufacturer equipment information. |
|||
This function retrieves the current equipment state. |
|||
This function retrieves error correction options. |
|||
This function gets the PDP address for a particular context. |
|||
This function gets the GPRS attach state. |
|||
This function retrieves the current GPRS class. |
|||
This function gets the GPRS activation state for all contexts. |
|||
This function retrieves a list of GPRS contexts. |
|||
This function retrieves the current phone GPRS registration status. |
|||
This function retrieves the current settings for the Hide Connected ID option. |
|||
This function retrieves the current settings for the Hide ID option. |
|||
This function retrieves High Speed Circuit Switched Data options. |
|||
This function retrieves High Speed Circuit Switched Data (HSCSD) options. |
|||
|
|
||
This function retrieves locking status for the specified facility. |
|||
This function gets the minimum quality of service profile for all contexts. |
|||
This function retrieves the preferred Short Message Serve (SMS) service option for mobile-originated messages. |
|||
This function gets the current messaging configuration. |
|||
This function gets the current messaging service options. |
|||
This function retrieves the list of available operators. |
|||
This function retrieves the cumulative count of data bytes transferred by the radio. |
|||
This function retrieves the current phonebook options. |
|||
This function retrieves the current locked state of the phone. |
|||
This function retrieves the list of preferred operators. |
|||
This function determines if the radio is present. This function is synchronous. |
|||
This function retrieves the current phone registration status. |
|||
This function gets the requested quality of service profile for all contexts. |
|||
This function retrieves the current radio link protocol options. |
|||
This function retrieves the CDMA roaming mode. |
|||
This function retrieves a serial port handle to be used for data communications. This function is synchronous. |
|||
This function retrieves a serial port handle from the PDP context to be used for data communications. This function is synchronous. |
|||
This function retrieves a serial port handle statistics. This function is synchronous. |
|||
This function retrieves information about the received signal quality. |
|||
This function retrieves the status of the Subscriber Identity Module (SIM) record. |
|||
This function retrieves the SIM Toolkit terminal profile. |
|||
|
|
||
This function retrieves information about all subscriber lines available for use. |
|||
This function retrieves the system time from the network. |
|||
This function retrieves the International Mobile Subscriber Identity (IMSI) of the phone user. |
|||
This function answers an incoming GPRS activation request. |
|||
This function is responsible for hanging up all calls. |
|||
Initializes RIL for use by an emergency call module. This function is synchronous.
|
|||
This function initializes RIL for use by a client. This function is synchronous. |
|||
This function sends a string to the radio for logging purposes. |
|||
This function modifies the state of active, held, and waiting calls. |
|||
This function informs the RIL driver that the miniport is done with the RILNDISPACKETstructure and its associated buffers, and that the RIL driver is free to release the associated memory. This function is synchronous. |
|||
This function is used by the WWAN miniport to call the RIL driver to send a packet through the radio interface. This function is synchronous. |
|||
This function sets the GPRS activation state for a context for an NDIS connection. |
|||
This function reads a message from the current storage location. |
|||
This function reads phonebook entries from the specified range of indices of the current storage location. |
|||
|
|
||
This function registers a device on a wireless network. |
|||
This function removes a call forwarding rule. |
|||
This function removes a specified operator from the list of preferred operators. |
|||
This function resets the cumulative count of data bytes transferred by the radio. |
|||
This function sends the user string to the device for authentication key (AKey) verification. |
|||
This function sends Dual-Tone Multifrequency (DTMF) tones across an established voice call. |
|||
This function sends a flash message. |
|||
This function sends a message acknowledgement. |
|||
This function sends a message. |
|||
This function sends a specified restricted command to the SIM. |
|||
This function sends a specified command to the SIM. |
|||
This function sends a response to an executed SIM Toolkit command. |
|||
This function sends a SIM Toolkit envelope command. |
|||
This function sends a requested event to the SIM. |
|||
This function sends a message from the current storage location. |
|||
This function sends supplementary service (USSD) data. |
|||
This function is implemented by a RIL driver. It is responsible for setting the devices to be used for transmitting and receiving audio from the radio. |
|||
This function sets audio gain information. |
|||
This function mutes or un-mutes the input audio device. |
|||
This function sets options related to the data connection bearer service. |
|||
This function enables or disables the specified type of call barring. |
|||
This function sets the current caller ID status. |
|||
This function enables or disables the specified call forwarding rule. |
|||
This function enables or disables call waiting for the specified information class. |
|||
This function sets the cell broadcast message configuration. |
|||
This function sets the closed user group settings. |
|||
This function sets advice-of-charge settings. |
|||
This function sets the current or default address identification for devices that support multiple device addresses. |
|||
This function sets data compression options. |
|||
This function sets the current status of the dialed ID. |
|||
This function detects DTMF tones from an established voice call. |
|||
This function sets the radio equipment state. |
|||
This function sets error correction options. |
|||
This function sets the GPRS attach state. |
|||
This function sets the current GPRS class. |
|||
This function sets the GPRS activation state for a context. |
|||
This function sets a particular GPRS context. |
|||
This function sets the current status for the Hide Connected ID option. |
|||
This function enables or disables Hide ID option. |
|||
This function sets High Speed Circuit Switched Data (HSCSD) options. |
|||
This function enables or disables locking status for the specified facility. |
|||
This function sets the minimum quality of service profile for a context. |
|||
This function sets the preferred Short Message Service (SMS) service option for mobile-originated messages. |
|||
This function sets messaging configuration. |
|||
This function sets messaging service options. |
|||
This function sets phonebook options. |
|||
This function sets the requested quality of service profile for a context. |
|||
This function sets Radio Link Protocol (RLP) options. |
|||
This function sets the CDMA roaming mode. |
|||
This function sets SIM Toolkit terminal profile. |
|||
This function terminates the SIM Toolkit session. |
|||
This function transfers incoming alerting call to the specified number. |
|||
This function removes the current lock applied to the phone. |
|||
This function unregisters the device from the network. |
|||
This function writes a message to the current storage location. |
|||
This function writes a phone book entry to the current storage location. |
|||
|
|
||
This callback function determines if an incoming call is a push-to-talk call. |
|||
This callback function is called when a packet is received by the RIL driver. |
|||
This callback function is called when a NDIS packet status change occurred in the RIL driver. |
|||
This callback function is called when a packet is sent by the RIL driver. |
|||
This callback function is called when the radio sends an unsolicited notification. |
|||
This callback function is called to send a return value after an asynchronous RIL function call. |