Use the Device Communications Toolkit functions to manipulate event flags.
A CIMPLICITY software event flag is a bit within a predefined data structure. Applications can reserve some event flags to indicate some condition has occurred. Routines are provided to SET and CLEAR the event flag.
The enabler calls predefined (user-defined) functions when an event flag is SET. Ten (10) event flags are available to the enabler.
The following functions manipulate these flags:
USER_DEVICE_INFO |
|
USER_DEVICE_OKAY |
|
USER_INIT |
|
DCRP_CALL_ON_TIME |
|
DCRP_CLEAR_EF |
|
DCRP_GET_ANY_EF |
|
DCRP_GET_EF |
|
DCRP_RCV_UNSOLICITED_DATA |
|
DCRP_RCV_UNSOLICITED_DATA_STAMP |
|
DCRP_RELEASE_EF |
|
DCRP_SET_DEVICE_UP |
|
DCRP_SET_EF |
Note: Some operating systems provide primitives for defining and manipulating event flags. It is recommended that the CIMPLICITY software-provided routines be used instead to avoid conflict with CIMPLICITY software routines within the enabler.
The Device Communications Toolkit reserves 10 event flags for use with user-customized subroutines and provides functions for reserving and manipulating the event flags.
Event flags should be cleared within the user-defined function for processing the event flag.
Programming restrictions. |