RTEMS 4.6.99.3 On-Line Library

Timer Manager TIMER_CREATE - Create a timer

RTEMS C User's Guide

8.4.1: TIMER_CREATE - Create a timer

CALLING SEQUENCE:

rtems_status_code rtems_timer_create(
  rtems_name  name,
  rtems_id   *id
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - timer created successfully
RTEMS_INVALID_ADDRESS - id is NULL
RTEMS_INVALID_NAME - invalid timer name
RTEMS_TOO_MANY - too many timers created

DESCRIPTION:

This directive creates a timer. The assigned timer id is returned in id. This id is used to access the timer with other timer manager directives. For control and maintenance of the timer, RTEMS allocates a TMCB from the local TMCB free pool and initializes it.

NOTES:

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

RTEMS C User's Guide