RTEMS 4.7.99.2 On-Line Library

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

RTEMS C User's Guide

15.4.5: PORT_INTERNAL_TO_EXTERNAL - Convert internal to external address

CALLING SEQUENCE:

rtems_status_code rtems_port_internal_to_external(
  rtems_id   id,
  void      *internal,
  void     **external
);

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