Inside Macintosh: Operating System Utilities /

Chapter 8 - Trap Manager / Trap Manager Reference

Routines / Installing Patch Addresses Into the Trap Dispatch Tables

SetToolboxTrapAddress

You can use the SetToolboxTrapAddress procedure to install a Toolbox patch address into the Toolbox trap dispatch table. The SetToolboxTrapAddress procedure is also available as the SetToolTrapAddress procedure.

PROCEDURE SetToolboxTrapAddress (trapAddr: LongInt;
                                  trapNum: Integer);

trapAddr

The Toolbox patch address.

trapNum

Toolbox A-line instruction or a trap number. If you specify a Toolbox A-line instruction, the function extracts the trap number (located in bits 0-9) for you.

DESCRIPTION

The SetToolboxTrapAddress procedure places the Toolbox patch address specified by the trapAddr parameter into the Toolbox trap dispatch table. The trapNum parameter specifies the location of the Toolbox patch address in the Toolbox trap dispatch table. The SetToolboxTrapAddress(trapAddr, trapNum) procedure performs the same operation as a NSetTrapAddress(trapAddr, trapNum, ToolTrap) procedure call.

Note

If the system software routine that is being patched has any come-from patches, the SetToolboxTrapAddress procedure installs the address of the patch into the exit JMP instruction of the last come-from patch in the chain rather than into the trap dispatch table.

SEE ALSO

For information about the Unimplemented procedure, see page 8-29. The NSetTrapAddress function is described next.