RTEMS 4.6.99.3 On-Line Library

Region Manager REGION_EXTEND - Add memory to a region

RTEMS Ada User's Guide

14.4.4: REGION_EXTEND - Add memory to a region

CALLING SEQUENCE:

procedure Region_Extend (
   ID               : in     RTEMS.ID;
   Starting_Address : in     RTEMS.Address;
   Length           : in     RTEMS.Unsigned32;
   Result           :    out RTEMS.Status_Codes
);

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - region extended successfully
RTEMS.INVALID_ADDRESS - starting_address is NULL
RTEMS.INVALID_ID - invalid region id
RTEMS.INVALID_ADDRESS - invalid address of area to add

DESCRIPTION:

This directive adds the memory which starts at starting_address for length bytes to the region specified by id.

NOTES:

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

The calling task does not have to be the task that created the region. Any local task that knows the region id can extend the region.

RTEMS Ada User's Guide