ARCHITECTURE
set_event_bit()
E355/E265 USER AND BEST PRACTICES GUIDE 23
set_event_bit()
Allows the application to select one of the event bits that would otherwise be
unused, and assigns it to a communication port.
By default, the communication ports do not generate events. This function allows
the communication ports to generate events when data is received. This
mechanism is provided when almost all the bits in the event mask have already
been allocated. However, in a specific terminal installation, many of the predefined
event bits are not used.
Prototype int set_event_bit(int handle, long bitmask);
Parameters
Return Values Returns 0 if successful. If an error occurs this function returns -1.
Only one event bit may be selected for a given device. The following event bits
must not be assigned: EVT_USER, EVT_SHUTDOWN and EVT_SYSTEM.
Any attempt to violate these rules will result in set_event_bit() returning -1
and errno being set to EINVAL. If the command fails, the event bit setting will not
be changed.
get_event_bit()
Allows the application to find out what event, if any, will be generated by the given
device. The mask returned will have one bit set that corresponds to the event bit
generated by the device.
Prototype long get_event_bit(int handle);
Parameters
Return Values Returns 0 if no event is to be generated or a mask with one bit set, if an event is to
be generated. -1 if the device does not support soft events.
handle The handle returned for the device by the open() call.
bitmask A mask with 1 or 0 bits set corresponding to the event bit.
handle The handle returned for the device by the open() call.
bitmask A mask with 1 or 0 bits set corresponding to the event bit.
To Next Page
Loading...
Need help?
General
