RTEMS 4.6.2 On-Line Library

Timer Manager TIMER_IDENT - Get ID of a timer

RTEMS Ada User's Guide

8.4.2: TIMER_IDENT - Get ID of a timer

CALLING SEQUENCE:

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

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - timer identified successfully
RTEMS.INVALID_ADDRESS - id is NULL
RTEMS.INVALID_NAME - timer name not found

DESCRIPTION:

This directive obtains the timer id associated with the timer name to be acquired. If the timer name is not unique, then the timer id will match one of the timers with that name. However, this timer id is not guaranteed to correspond to the desired timer. The timer id is used to access this timer in other timer related directives.

NOTES:

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

RTEMS Ada User's Guide