Set_Event_Bit(); Get_Event_Bit() - VeriFone e355 User And Best Practices Manual

set_event_bit()

Prototype
Parameters
Return Values

get_event_bit()

Prototype
Parameters
Return Values
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.
int set_event_bit(int handle, long bitmask);
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.
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.
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.
long get_event_bit(int handle);
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.
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.
355/ 265 U B P
E E SER AND EST
A
RCHITECTURE
set_event_bit()
23
G
RACTICES UIDE