RTEMS 4.6.1 On-Line Library

Timer Manager TIMER_CREATE - Create a timer

RTEMS Ada User's Guide

8.4.1: TIMER_CREATE - Create a timer

CALLING SEQUENCE:

procedure Timer_Create (
   Name   : in     RTEMS.Name;
   ID     :    out RTEMS.ID;
   Result :    out RTEMS.Status_Codes
);

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - timer created successfully
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 Ada User's Guide