RTEMS 4.8.0 On-Line Library

Dual-Ported Memory Manager PORT_EXTERNAL_TO_INTERNAL - Convert external to internal address

RTEMS Ada User's Guide

15.4.4: PORT_EXTERNAL_TO_INTERNAL - Convert external to internal address

CALLING SEQUENCE:

procedure Port_External_To_Internal (
   ID       : in     RTEMS.ID;
   External : in     RTEMS.Address;
   Internal :    out RTEMS.Address;
   Result   :    out RTEMS.Status_Codes
);

DIRECTIVE STATUS CODES:

RTEMS.INVALID_ADDRESS - internal is NULL
RTEMS.SUCCESSFUL - successful conversion

DESCRIPTION:

This directive converts a dual-ported memory address from external to internal representation for the specified port. If the given external address is invalid for the specified port, then the internal address is set to the given external address.

NOTES:

This directive is callable from an ISR.

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

RTEMS Ada User's Guide