RTEMS 4.9.2 On-Line Library

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

RTEMS Ada User's Guide

15.4.5: PORT_INTERNAL_TO_EXTERNAL - Convert internal to external address

CALLING SEQUENCE:

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

DIRECTIVE STATUS CODES:

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

DESCRIPTION:

This directive converts a dual-ported memory address from internal to external representation so that it can be passed to owner of the DPMA represented by the specified port. If the given internal address is an invalid dual-ported address, then the external address is set to the given internal 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