Share via

RIL_GetDevCaps (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function is responsible for retrieving specific device capabilities.

Syntax

HRESULT RIL_GetDevCaps(
  HRIL hRil,
  DWORD dwCapsType
);

Parameters

  • 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

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

See Also

Reference

RIL Functions
RIL_Initialize
RIL_ManageCalls
Caps Type Constants