RIL_GetDevCaps

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function is responsible for retrieving specific device capabilities.

Syntax

HRESULT RIL_GetDevCaps(
  HRIL hRil,
  DWORD dwCapsType
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• dwCapsType
  Specifies the capability to be queried. The following table shows the possible values.

  Value	Description
  RIL_CAPSTYPE_DIAL	Unused. Dialing types supported by the radio. On return, lpData points to a RILRANGE structure.
  RIL_CAPSTYPE_DTMFDURATIONRANGE	Unused. Range of DTMF duration supported by the radio. On return, lpData points to a RILRANGE structure.
  RIL_CAPSTYPE_CALLMGTCMDS	Unused. Commands supported by the RIL_ManageCalls function on a device. On return, lpData points to any combination of the following values: RIL_CAPS_CALLCMD_RELEASEHELD RIL_CAPS_CALLCMD_RELEASEACTIVE_ACCEPTHELD RIL_CAPS_CALLCMD_RELEASECALL RIL_CAPS_CALLCMD_HOLDACTIVE_ACCEPTHELD RIL_CAPS_CALLCMD_HOLDALLBUTONE RIL_CAPS_CALLCMD_ADDHELDTOCONF RIL_CAPS_CALLCMD_ADDHELDTOCONF_DISCONNECT RIL_CAPS_CALLCMD_INVOKECCBS
  RIL_CAPSTYPE_BEARERSERVICE	Unused. The bearer service supported by the device. On return, lpData points to a RILCAPSBEARERSVC structure.
  RIL_CAPSTYPE_RLP	Unused. The radio link protocol supported by the device. On return, lpData points to a RILCAPSRLP structure.
  RIL_CAPSTYPE_EQUIPMENTSTATES	Unused. Supported device equipment states. On return, lpData points to any combination of the following values: RIL_CAPS_EQSTATE_MINIMUM RIL_CAPS_EQSTATE_FULL RIL_CAPS_EQSTATE_DISABLETX RIL_CAPS_EQSTATE_DISABLERX RIL_CAPS_EQSTATE_DISABLETXANDRX
  RIL_CAPSTYPE_PBSTORELOCATIONS	GSM only. Supported SIM phonebook storage locations. On return, lpData points to any combination of the following values: RIL_CAPS_PBLOC_SIMEMERGENCY RIL_CAPS_PBLOC_SIMFIXDIALING RIL_CAPS_PBLOC_SIMLASTDIALING RIL_CAPS_PBLOC_OWNNUMBERS RIL_CAPS_PBLOC_SIMPHONEBOOK
  RIL_CAPSTYPE_PBINDEXRANGE	GSM only. Range of valid locations for the current storage location. On return, lpData points to a RILRANGE structure.
  RIL_CAPSTYPE_PBENTRYLENGTH	GSM only. Maximum length of phonebook number entries. On return, lpData points to a RILCAPSPBENTRYLENGTH structure.
  RIL_CAPSTYPE_MSGSERVICETYPES	Unused. GSM only. Supported message service types. On return, lpData points to any combination of the following values: RIL_CAPS_MSGSVCTYPE_PHASE2 RIL_CAPS_MSGSVCTYPE_PHASE2PLUS
  RIL_CAPSTYPE_MSGMEMORYLOCATIONS	GSM only. Supported Short Message Service (SMS) message storage locations. On return, lpData points to a RILCAPSMSGMEMORYLOCATIONS structure.
  RIL_CAPSTYPE_BROADCASTMSGLANGS	Unused. GSM only. Supported broadcast message languages. On return, lpData points to any combination of RIL_CAPS_DCSLANG_* values.
  RIL_CAPSTYPE_MSGCONFIGINDEXRANGE	Unused. GSM only.
  RIL_CAPSTYPE_MSGSTATUSVALUES	Unused. GSM only. All message status values supported by the device. On return, lpData points to any combination of the following values: RIL_CAPS_MSGSTATUS_RECUNREAD RIL_CAPS_MSGSTATUS_RECREAD RIL_CAPS_MSGSTATUS_STOUNSENT RIL_CAPS_MSGSTATUS_STOSENT
  RIL_CAPSTYPE_PREFOPINDEXRANGE	Unused. GSM only. Index range of preferred operators supported by the SIM. On return, lpData points to a RILRANGE structure.
  RIL_CAPSTYPE_LOCKFACILITIES	Locking facilities supported by the device. CDMA should point to zero (0). On return, lpData points to any combination of the following values: RIL_CAPS_LOCKFACILITY_CNTRL RIL_CAPS_LOCKFACILITY_PH_SIM RIL_CAPS_LOCKFACILITY_PH_FSIM RIL_CAPS_LOCKFACILITY_SIM RIL_CAPS_LOCKFACILITY_SIM_PIN2 RIL_CAPS_LOCKFACILITY_SIM_FIXEDIALING RIL_CAPS_LOCKFACILITY_NETWORKPERS RIL_CAPS_LOCKFACILITY_SERVICEPROVPERS RIL_CAPS_LOCKFACILITY_CORPPERS
  RIL_CAPSTYPE_LOCKINGPWDLENGTHS	Maximum lengths for the various locking passwords. On return, lpData points to an array of RILCAPSLOCKINGPWDLENGTH structures.
  RIL_CAPSTYPE_BARRTYPES	Barring types supported by the device. CDMA should point to zero (0). On return, lpData points to any combination of the following values: RIL_CAPS_BARRTYPE_ALLOUTGOING RIL_CAPS_BARRTYPE_OUTGOINGINT RIL_CAPS_BARRTYPE_OUTGOINGINTEXTOHOME RIL_CAPS_BARRTYPE_ALLINCOMING RIL_CAPS_BARRTYPE_INCOMINGROAMING RIL_CAPS_BARRTYPE_INCOMINGNOTINSIM RIL_CAPS_BARRTYPE_ALLBARRING RIL_CAPS_BARRTYPE_ALLOUTGOINGBARRING RIL_CAPS_BARRTYPE_ALLINCOMINGBARRING
  RIL_CAPSTYPE_BARRINGPWDLENGTHS	Maximum lengths for the various barring passwords. On return, lpData points to an array of RILCAPSBARRINGPWDLENGTH structures.
  RIL_CAPSTYPE_FORWARDINGREASONS	Call forwarding reasons supported. On return, lpData points to any combination of the following values: RIL_CAPS_FWDREASON_UNCONDITIONAL RIL_CAPS_FWDREASON_MOBILEBUSY RIL_CAPS_FWDREASON_NOREPLY RIL_CAPS_FWDREASON_UNREACHABLE RIL_CAPS_FWDREASON_ALLFORWARDING RIL_CAPS_FWDREASON_ALLCONDITIONAL
  RIL_CAPSTYPE_INFOCLASSES	Unused. This capability should be ignored.
  RIL_CAPSTYPE_HSCSD	GSM only. High-speed circuit switched data capability. On return, lpData points to a RILCAPSHSCSD structure.
  RIL_CAPSTYPE_SIMTOOLKITNOTIFICATIONS	GSM only. Support for SIM toolkit notifications. On return, lpData points to a RILSIMTOOLKITNOTIFYCAPS structure.
  RIL_CAPSTYPE_GPRSCLASS	Unused. GPRS only. Queries the GPRS class capabilities of the device. On return, lpData points to one of the following values: RIL_GPRSCLASS_GSMANDGPRS RIL_GPRSCLASS_GSMORGPRS RIL_GPRSCLASS_GSMORGPRS_EXCLUSIVE RIL_GPRSCLASS_GPRSONLY RIL_GPRSCLASS_GSMONLY
  RIL_CAPSTYPE_GPRSCONTEXT	Unused. GPRS only. Support for GPRS contexts. On return, lpData points to an array of RILGPRSCONTEXTCAPS structures.
  RIL_CAPSTYPE_GPRSQOS	Unused. GPRS only. List of supported values for GPRS quality of service. On return, lpData points to an array of RILGPRSQOSPROFILECAPS structures.
  RIL_CAPSTYPE_GPRSQOSMIN	Unused. GPRS only. List of supported values for GPRS minimum quality of service. On return, lpData points to an array of RILGPRSQOSPROFILECAPS structures.
  RIL_CAPSTYPE_GPRSMOSMS	Unused. GSM only. Currently available services for mobile originated Short Message Service (SMS). On return, lpData points to any combination of the following values: RIL_MOSMSSERVICE_CIRCUIT RIL_MOSMSSERVICE_GPRS RIL_MOSMSSERVICE_CIRCUITPREFERRED RIL_MOSMSSERVICE_GPRSPREFERRED
  RIL_CAPSTYPE_DATACOMPROESSION	Unused. GSM only. Supported data compression modes. On return, lpData points to a RILCAPSDATACOMPRESSION structure.
  RIL_CAPSTYPE_ERRORCORRECTION	Unused. GSM only. Supported error correction modes. On return, lpData points to a RILCAPSERRORCORRECTION structure.
  RIL_CAPSTYPE_SIGNALQUALITYIMPLEMENTATION	Implementation of signal quality reporting. On return, lpData points to any combination of the following values: RIL_CAPS_SIGNALQUALITY_NOTIFICATION RIL_CAPS_SIGNALQUALITY_POLLING
  RIL_CAPSTYPE_SIMSUPPORT	Device support for SIM functionality. On return lpData points to the following values: RIL_CAPS_SIM_NONE RIL_CAPS_SIM_BASIC RIL_CAPS_SIM_PBEX
  RIL_CAPSTYPE_NITZNOTIFICATION	Device support for receiving Network Identity and Time Zone (NITZ) information. On return, lpData points to one of the following values: RIL_CAPS_NITZ_ENABLED RIL_CAPS_NITZ_DISABLED

Return Value

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

An asynchronous result of RIL_RESULT_OK indicates success. The lpData notification parameter points to a capability structure specific to the caps type constants queried.

Remarks

This function is implemented by a RIL driver and is called to retrieve various capabilities of the device.

The RIL proxy translates the RIL_GetDevCaps function into IOCTL_RIL_GetDevCaps when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize
RIL_ManageCalls
Caps Type Constants