Legacy Document

Inside Macintosh: Memory /

Chapter 4 - Memory Management Utilities / Memory Management Utilities Reference

Routines / Manipulating Memory Addresses

Translate24To32

You can use the Translate24To32 function to map 24-bit addresses into the 32-bit address space.

FUNCTION Translate24To32 (addr24: UNIV Ptr): Ptr;

addr24

An address that is meaningful to the 24-bit Memory Manager.

DESCRIPTION

The Translate24To32 function translates the address specified by the addr24 parameter from 24-bit into 32-bit addressing mode and returns that address. If addr24 is already a 32-bit address, the function returns it unchanged.

Unlike the StripAddress function, Translate24To32 does not necessarily return an address that can be used in 24-bit mode. Also, you cannot meaningfully call Translate24To32 on the result of a previous translation.

SPECIAL CONSIDERATIONS

You need to call Translate24To32 only if you use 24-bit addresses while communicating with external hardware in 32-bit mode and virtual memory is enabled. See "Translating Memory Addresses" on page 4-23 for details.

ASSEMBLY-LANGUAGE INFORMATION

The registers on entry and exit for Translate24To32 are

Registers on entry
D0	A 24-bit addressing mode address

Registers on exit
D0	The translated address