RTEMS 4.6.0pre5 On-Line Library

Timer Manager TIMER_SERVER_FIRE_AFTER - Fire task-based timer after interval

RTEMS C User's Guide

8.4.8: TIMER_SERVER_FIRE_AFTER - Fire task-based timer after interval

CALLING SEQUENCE:

rtems_status_code rtems_timer_server_fire_after(
  rtems_id                           id,
  rtems_interval                     ticks,
  rtems_timer_service_routine_entry  routine,
  void                              *user_data
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - timer initiated successfully
RTEMS_INVALID_ID - invalid timer id
RTEMS_INVALID_NUMBER - invalid interval
RTEMS_INCORRECT_STATE - Timer Server not initiated

DESCRIPTION:

This directive initiates the timer specified by id and specifies that when it fires it will be executed by the Timer Server.

If the timer is running, it is automatically canceled before being initiated. The timer is scheduled to fire after an interval ticks clock ticks has passed. 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