RTEMS 4.7.1 On-Line Library

Interrupt Manager INTERRUPT_CATCH - Establish an ISR

RTEMS C User's Guide

6.4.1: INTERRUPT_CATCH - Establish an ISR

CALLING SEQUENCE:

rtems_status_code rtems_interrupt_catch(
  rtems_isr_entry      new_isr_handler,
  rtems_vector_number  vector,
  rtems_isr_entry     *old_isr_handler
);

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 C User's Guide