#include <SwiStructsCm.h>
Public Attributes | |
U32 | sizeStruct |
SWI_STRUCT_AirServer | AirServer |
SWI_TYPE_LockServ | eService |
bool | bLocked |
When an air server becomes locked, any pending requests will be canceled with a return code of SWI_RCODE_CANCEL. Any modem commands made after this event will fail with a SWI_RCODE_DEVICE_LOCKED return code.
Locking of the air server is done by high priority tasks where exclusive access to the air server is crucial in order to prevent errors. An example of such a task is a firmware upgrade process. Client applications will be notified with a SWI_NOTIFY_LockAirServer notification when these high priority tasks complete and the air server is once again available for use. Note that SwiSelectAirServer DOES NOT have to be called to re-bind to the air server. Client applications should not tamper with (remove power or reset, etc) the air server while the air server is in a locked state.
The SDK will automatically unlock an air server if the application, which has previously locked the air server for exclusive use, loses communication with the SDK (perhaps due to the application crashing).
Multiple client access is exclusively handled by the SDK. The modem themselves are not designed for simultaneous access by multiple clients. Therefore, interfacing with the modem outside of the SDK (AT commands) is not recommended (especially when the air server is locked).
This object supports both GSM and CDMA technologies for PC cards, embedded devices, and MP line of products.
A structure of type SWI_STRUCT_AirServer containing information about the air server of interest.
True is returned if the service of interest is locked for exclusive use by another application. A value of false indicates the air server is no longer locked and is available for use.
SWI_TYPE_LockServ SWI_STRUCT_LockAirServer::eService |
A SWI_TYPE_LockServ enumeration of the feature/service of interest
The size, in bytes, of this structure.