ril.h

RIL资料

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Class | Notification classes
//
// @comm None
//
// -----------------------------------------------------------------------------
#define RIL_NCLASS_FUNCRESULT                       (0x00000000)      // @constdefine API call results
#define RIL_NCLASS_CALLCTRL                         (0x00010000)      // @constdefine Call control notifications
#define RIL_NCLASS_MESSAGE                          (0x00020000)      // @constdefine Messaging notifications
#define RIL_NCLASS_NETWORK                          (0x00040000)      // @constdefine Network-related notifications
#define RIL_NCLASS_SUPSERVICE                       (0x00080000)      // @constdefine Supplementary service notifications
#define RIL_NCLASS_PHONEBOOK                        (0x00100000)      // @constdefine Phonebook notifications
#define RIL_NCLASS_SIMTOOLKIT                       (0x00200000)      // @constdefine SIM Toolkit notifications
#define RIL_NCLASS_MISC                             (0x00400000)      // @constdefine Miscellaneous notifications
#define RIL_NCLASS_RADIOSTATE                       (0x00800000)      // @constdefine Notifications Pertaining to changes in Radio State
#define RIL_NCLASS_NDIS                             (0x40000000) // @constdefine Nofitifcations that won't be picked up by all.
#define RIL_NCLASS_DEVSPECIFIC                      (0x80000000)      // @constdefine Reserved for device specific notifications
#define RIL_NCLASS_ALL                              (0x00ff0000)      // @constdefine All notification classes (except DevSpecifc)

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants API Result | API call results (RIL_NCLASS_FUNCRESULT)
//
// @comm None
//
// -----------------------------------------------------------------------------
#define RIL_RESULT_OK                               (0x00000001 | RIL_NCLASS_FUNCRESULT)  // @constdefine RIL API call succeded; lpData is NULL
#define RIL_RESULT_NOCARRIER                        (0x00000002 | RIL_NCLASS_FUNCRESULT)  // @constdefine RIL API failed because no carrier was detected; lpData is NULL
#define RIL_RESULT_ERROR                            (0x00000003 | RIL_NCLASS_FUNCRESULT)  // @constdefine RIL API failed; lpData points to RIL_E_* constant
#define RIL_RESULT_NODIALTONE                       (0x00000004 | RIL_NCLASS_FUNCRESULT)  // @constdefine RIL API failed because no dialtone was detected; lpData is NULL
#define RIL_RESULT_BUSY                             (0x00000005 | RIL_NCLASS_FUNCRESULT)  // @constdefine RIL API failed because the line was busy; lpData is NULL
#define RIL_RESULT_NOANSWER                         (0x00000006 | RIL_NCLASS_FUNCRESULT)  // @constdefine RIL API failed because of the lack of answer; lpData is NULL
#define RIL_RESULT_CALLABORTED                      (0x00000007 | RIL_NCLASS_FUNCRESULT)  // @constdefine RIL API failed because it was cancelled prior to completion; lpData is NULL
#define RIL_RESULT_CALLDROPPED                      (0x00000008 | RIL_NCLASS_FUNCRESULT)  // @constdefine RIL API failed because the network dropped the call; lpData is NULL

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Call Control | Call control notifications (RIL_NCLASS_CALLCTRL)
//
// @comm None
//
// -----------------------------------------------------------------------------
#define RIL_NOTIFY_RING                             (0x00000001 | RIL_NCLASS_CALLCTRL)  // @constdefine Incoming call; lpData points to RILRINGINFO
#define RIL_NOTIFY_CONNECT                          (0x00000002 | RIL_NCLASS_CALLCTRL)  // @constdefine Data/voice connection has been established; lpData points to RILCONNECTINFO
#define RIL_NOTIFY_DISCONNECT                       (0x00000003 | RIL_NCLASS_CALLCTRL)  // @constdefine Data/voice connection has been terminated; lpData points to RIL_DISCINIT_* constant
#define RIL_NOTIFY_DATASVCNEGOTIATED                (0x00000004 | RIL_NCLASS_CALLCTRL)  // @constdefine Data connection service has been negotiated; lpData points to RILSERVICEINFO
#define RIL_NOTIFY_CALLSTATECHANGED                 (0x00000005 | RIL_NCLASS_CALLCTRL)  // @constdefine RIL has performed an operation that may have changed state of existing calls; lpData is NULL
#define RIL_NOTIFY_EMERGENCYMODEENTERED             (0x00000006 | RIL_NCLASS_CALLCTRL)  // @constdefine RIL has enetered emergency mode; lpData is NULL
#define RIL_NOTIFY_EMERGENCYMODEEXITED              (0x00000007 | RIL_NCLASS_CALLCTRL)  // @constdefine RIL has exited emergency mode; lpData is NULL
#define RIL_NOTIFY_EMERGENCYHANGUP                  (0x00000008 | RIL_NCLASS_CALLCTRL)  // @constdefine Existsing calls (if any) were hung up in RIL emergency mode; lpData is NULL
#define RIL_NOTIFY_HSCSDPARAMSNEGOTIATED            (0x00000009 | RIL_NCLASS_CALLCTRL)  // @constdefine HSCSD parameters for a call has been negotiated; lpData points to RILCALLHSCSDINFO
#define RIL_NOTIFY_DIAL                             (0x0000000A | RIL_NCLASS_CALLCTRL)  // @constdefine Outgoing call; lpData points to RILDIALINFO
#define RIL_NOTIFY_CALLPROGRESSINFO                 (0x0000000B | RIL_NCLASS_CALLCTRL)  // @constdefine CPI notification; lpData points to RILCALLINFO
#define RIL_NOTIFY_CURRENTLINECHANGED               (0x0000000C | RIL_NCLASS_CALLCTRL)  // @constdefine Current line has changed notification; lpData points to DWORD with new current address id
#define RIL_NOTIFY_GPRS_DISCONNECT                       (0x0000000D | RIL_NCLASS_CALLCTRL)  // @constdefine GPRS connection has been terminated; lpData points to RILGPRSCONTEXTACTIVATED sturct

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Messaging | Messaging notifications (RIL_MCLASS_MESSAGE)
//
// @comm None
//
// -----------------------------------------------------------------------------
#define RIL_NOTIFY_MESSAGE                          (0x00000001 | RIL_NCLASS_MESSAGE)  // @constdefine Incoming message; lpData points to RILMESSAGE
#define RIL_NOTIFY_BCMESSAGE                        (0x00000002 | RIL_NCLASS_MESSAGE)  // @constdefine Incoming broadcast message; lpData points to RILMESSAGE
#define RIL_NOTIFY_STATUSMESSAGE                    (0x00000003 | RIL_NCLASS_MESSAGE)  // @constdefine Incoming status-report message; lpData points to RILMESSAGE
#define RIL_NOTIFY_MSGSTORED                        (0x00000004 | RIL_NCLASS_MESSAGE)  // @constdefine A message has been added to storage; lpData points to the storage index assigned to the new message
#define RIL_NOTIFY_MSGDELETED                       (0x00000005 | RIL_NCLASS_MESSAGE)  // @constdefine A message has been deleted from storage; lpData points to the storage index occupied by the deleted message
#define RIL_NOTIFY_MSGSTORAGECHANGED                (0x00000006 | RIL_NCLASS_MESSAGE)  // @constdefine One of the message storage locations has been changed; lpData points to RILMSGSTORAGEINFO
#define RIL_NOTIFY_MESSAGE_IN_SIM                   (0x00000007 | RIL_NCLASS_MESSAGE)  // @constdefine Incoming message stored to SIM; lpData points to the storage RILMESSAGE_IN_SIM
#define RIL_NOTIFY_BCMESSAGE_IN_SIM                 (0x00000008 | RIL_NCLASS_MESSAGE)  // @constdefine Incoming broadcast message stored to SIM; lpData points to RILMESSAGE_IN_SIM
#define RIL_NOTIFY_STATUSMESSAGE_IN_SIM             (0x00000009 | RIL_NCLASS_MESSAGE)  // @constdefine Incoming status-report message stored to SIM; lpData points to RILMESSAGE_IN_SIM

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Network | Network-related notifications (RIL_NCLASS_NETWORK)
//
// @comm None
//
// -----------------------------------------------------------------------------
#define RIL_NOTIFY_REGSTATUSCHANGED                 (0x00000001 | RIL_NCLASS_NETWORK)  // @constdefine Network registration status has changed; lpData points to the new status (RIL_REGSTAT_* constant)
#define RIL_NOTIFY_CALLMETER                        (0x00000002 | RIL_NCLASS_NETWORK)  // @constdefine Call meter has changed; lpData points to a DWORD containing new current call meter value
#define RIL_NOTIFY_CALLMETERMAXREACHED              (0x00000003 | RIL_NCLASS_NETWORK)  // @constdefine Call meter maximum has been reached; lpData is NULL
#define RIL_NOTIFY_GPRSREGSTATUSCHANGED             (0x00000004 | RIL_NCLASS_NETWORK)  // @constdefine Network registration status has changed; lpData points to the new status (RIL_REGSTAT_* constant)
#define RIL_NOTIFY_SYSTEMCHANGED                    (0x00000005 | RIL_NCLASS_NETWORK)  // @constdefine This indicates that the type of coverage which is available has changed.  Typically one would expect IS-95A or 1xRTT, however CDMA does allow overlay systems; lpData is <t DWORD> of type RIL_SYSTEMTYPE_ flags
#define RIL_NOTIFY_GPRSCONNECTIONSTATUS             (0x00000006 | RIL_NCLASS_NETWORK)  // @constdefine This indicates the pdp context state has changed. lpData points to RILGPRSCONTEXTACTIVATED
#define RIL_NOTIFY_SYSTEMCAPSCHANGED                (0x00000007 | RIL_NCLASS_NETWORK)  // @constdefine This indicates the system capability has changed. lpData points to the new system capability (RIL_SYSTEMCAPS_* constant)

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Supplementary Service | Supplementary service notifications (RIL_NCLASS_SUPSERVICE)
//
// @comm None
//
// -----------------------------------------------------------------------------
#define RIL_NOTIFY_CALLERID                         (0x00000001 | RIL_NCLASS_SUPSERVICE)  // @constdefine Incoming call CallerID information; lpData points to RILREMOTEPARTYINFO
#define RIL_NOTIFY_DIALEDID                         (0x00000002 | RIL_NCLASS_SUPSERVICE)  // @constdefine Initiated call DialedID information; lpData points to RILREMOTEPARTYINFO
#define RIL_NOTIFY_CALLWAITING                      (0x00000003 | RIL_NCLASS_SUPSERVICE)  // @constdefine Call Waiting information; lpData points to RILCALLWAITINGINFO
#define RIL_NOTIFY_SUPSERVICEDATA                   (0x00000004 | RIL_NCLASS_SUPSERVICE)  // @constdefine Ustructured supplementary service data; lpData points to RILSUPSERVICEDATA
#define RIL_NOTIFY_INTERMEDIATESS                   (0x00000005 | RIL_NCLASS_SUPSERVICE)  // @constdefine Ustructured supplementary service data; lpData points to RILINTERMEDIATESSINFO
#define RIL_NOTIFY_UNSOLICITEDSS                    (0x00000006 | RIL_NCLASS_SUPSERVICE)  // @constdefine Ustructured supplementary service data; lpData points to RILUNSOLICITEDSSINFO

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Phonebook | Phonebook notifications (RIL_NCLASS_PHONEBOOK)
//
// @comm None
//
// -----------------------------------------------------------------------------
#define RIL_NOTIFY_PHONEBOOKENTRYSTORED             (0x00000001 | RIL_NCLASS_PHONEBOOK)  // @constdefine A phonebook entry has been added to storage; lpData points to the storage
                                                                                         // index assigned to the new entry (ifdwIndex is RIL_PBINDEX_FIRSTAVAILABLE, the new entry was stored in the first available location)
#define RIL_NOTIFY_PHONEBOOKENTRYDELETED            (0x00000002 | RIL_NCLASS_PHONEBOOK)  // @constdefine A phonebook entry has been deleted from storage; lpData points to the storage index occupied by the deleted entry
#define RIL_NOTIFY_PHONEBOOKSTORAGECHANGED          (0x00000003 | RIL_NCLASS_PHONEBOOK)  // @constdefine Phonebook storage location has been changed; lpData points to RIL_PBLOC_* constant

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Toolkit | SIM Toolkit notifications (RIL_NCLASS_SIMTOOLKIT)
//
// @comm None
//
// -----------------------------------------------------------------------------
#define RIL_NOTIFY_SIMTOOLKITCMD                    (0x00000001 | RIL_NCLASS_SIMTOOLKIT)  // @constdefine A SIM Toolkit command was not handled by the radio; lpData points to array of bytes containing the command
#define RIL_NOTIFY_SIMTOOLKITCALLSETUP              (0x00000002 | RIL_NCLASS_SIMTOOLKIT)  // @constdefine SIM Toolkit is trying to set up a call and call conditions were successfully checked by the radio;
                                                                                          // lpData points to a DWORD containing the redial timeout for the call (in milliseconds)
#define RIL_NOTIFY_SIMTOOLKITEVENT                  (0x00000003 | RIL_NCLASS_SIMTOOLKIT)  // @constdefine A SIM Toolkit command was handled by the radio or the radio sent a SIm Toolkit command response to the SIM;
                                                                                          // lpData points to array of bytes containing the command or response sent
#define RIL_NOTIFY_SIMTOOLKITSESSIONEND             (0x00000004 | RIL_NCLASS_SIMTOOLKIT)  // @constdefine A SIM Toolkit command session is ending

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Radio State Change | Radio State Change notifications (RIL_NCLASS_RADIOSTATE)
//
// @comm None
//
// -----------------------------------------------------------------------------

#define RIL_NOTIFY_RADIOEQUIPMENTSTATECHANGED      (0x00000001 | RIL_NCLASS_RADIOSTATE)  // @constdefine Carries a STRUCT (RILEQUIPMENTSTATE) stating The Radio equiptmentstate has changed, also notifies a driver defined Radio ON or OFF state
#define RIL_NOTIFY_RADIOPRESENCECHANGED            (0x00000002 | RIL_NCLASS_RADIOSTATE)  // @constdefine Carries a dword (RIL_RADIOPRESENCE_*) stating that a Radio Module/Driver has been changed (removed, inserted, etc)
#define RIL_NOTIFY_RADIORESET                      (0x00000003 | RIL_NCLASS_RADIOSTATE)  // @constdefine The driver has detected that the radio reset itself. lpData points to NULL

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @constants Notification Misc | Miscellaneous notifications (RIL_NCLASS_MISC)
//
// @comm None
//
// -----------------------------------------------------------------------------

#define RIL_NOTIFY_SIMNOTACCESSIBLE                 (0x00000001 | RIL_NCLASS_MISC)  // @constdefine SIM card has been removed or has failed to respond; lpData is NULL
#define RIL_NOTIFY_DTMFSIGNAL                       (0x00000002 | RIL_NCLASS_MISC)  // @constdefine A DTMF signal has been detected; lpData points to char
#define RIL_NOTIFY_GPRSCLASS_NETWORKCHANGED         (0x00000003 | RIL_NCLASS_MISC)  // @constdefine Network has indicated a change in GPRS class
	                                                                                    // lpData points to a DWORD containing the new RIL_GPRSCLASS_* value
#define RIL_NOTIFY_GPRSCLASS_RADIOCHANGED           (0x00000004 | RIL_NCLASS_MISC)  // @constdefine The radio has indicated a change in GPRS class
	                                                                                    // lpData points to a DWORD containing the new RIL_GPRSCLASS_* value
#define RIL_NOTIFY_SIGNALQUALITY                    (0x00000005 | RIL_NCLASS_MISC)  // @constdefine Signal Quality Notification
	                                                                                    // lpData points to a RILSIGNALQUALITY structure
#define RIL_NOTIFY_MAINTREQUIRED                    (0x00000006 | RIL_NCLASS_MISC)  // @constdefine BS notification that MS requires servicing; lpdata is NULL
#define RIL_NOTIFY_PRIVACYCHANGED                   (0x00000007 | RIL_NCLASS_MISC)  // @constdefine Call Privacy Status; lpData points to DWORD of value RIL_CALLPRIVACY_*
#define RIL_NOTIFY_SIM_DATACHANGE                   (0x00000008 | RIL_NCLASS_MISC)  // @constdefine data change notification; lpData points to DWORD of value RIL_SIMDATACHANGE_*
#define RIL_NOTIFY_ATLOGGING                        (0x00000009 | RIL_NCLASS_MISC)  // @constdefine at command log data present