cnet's Application Programming Interface

NAME

CNET_unused_timer_event - find a timer event, EV_TIMER*, that does not have an associated event handler.

SYNOPSIS

#include <cnet.h> CnetEvent CNET_unused_timer_event(void);

DESCRIPTION

CNET_unused_timer_event finds (at runtime) an unused timer event - one that does not have associated event handler. This enables independent source-code files in a large protocol to find and use a timer event without interfering with the actions of other source-code files.

If the function call is successful, the returned event is not 'reserved' by cnet. It is anticipated that a call to CNET_set_handler will next be made, passing the returned event as the first parameter.

RETURN VALUE

On success, one of the standard timer events, EV_TIMER0 to EV_TIMER9, will be returned. On failure, if there are no unused timer events, the value EV_NULL will be returned.

SEE ALSO

CNET_set_handler, CNET_start_timer, and CNET_timer_data.