RTEMS 4.9.2 On-Line Library

Timer Manager TIMER_FIRE_WHEN - Fire timer when specified

RTEMS C User's Guide

8.4.6: TIMER_FIRE_WHEN - Fire timer when specified

CALLING SEQUENCE:

rtems_status_code rtems_timer_fire_when(
  rtems_id                           id,
  rtems_time_of_day                 *wall_time,
  rtems_timer_service_routine_entry  routine,
  void                              *user_data
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - timer initiated successfully
RTEMS_INVALID_ADDRESS - routine is NULL
RTEMS_INVALID_ADDRESS - wall_time is NULL
RTEMS_INVALID_ID - invalid timer id
RTEMS_NOT_DEFINED - system date and time is not set
RTEMS_INVALID_CLOCK - invalid time of day

DESCRIPTION:

This directive initiates the timer specified by id. If the timer is running, it is automatically canceled before being initiated. The timer is scheduled to fire at the time of day specified by wall_time. When the timer fires, the timer service routine routine will be invoked with the argument user_data.

NOTES:

This directive will not cause the running task to be preempted.

RTEMS C User's Guide