RTEMS 4.9.0 On-Line Library

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

RTEMS C User's Guide

15.4.4: PORT_EXTERNAL_TO_INTERNAL - Convert external to internal address

CALLING SEQUENCE:

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

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