RTEMS 4.5.1-pre3 On-Line Library

Interrupt Manager INTERRUPT_CATCH - Establish an ISR

RTEMS Ada User's Guide

6.4.1: INTERRUPT_CATCH - Establish an ISR

CALLING SEQUENCE:

procedure Interrupt_Catch (
   New_ISR_handler : in     RTEMS.Address;
   Vector          : in     RTEMS.Vector_Number;
   Old_ISR_Handler :    out RTEMS.Address;
   Result          :    out RTEMS.Status_Codes
);

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - ISR established successfully
RTEMS.INVALID_NUMBER - illegal vector number
RTEMS.INVALID_ADDRESS - illegal ISR entry point or invalid old_isr_handler

DESCRIPTION:

This directive establishes an interrupt service routine (ISR) for the specified interrupt vector number. The new_isr_handler parameter specifies the entry point of the ISR. The entry point of the previous ISR for the specified vector is returned in old_isr_handler.

To release an interrupt vector, pass the old handler's address obtained when the vector was first capture.

NOTES:

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

RTEMS Ada User's Guide