[Contents] [Index] [Help] [Retrace] [browse <] [Browse >]


NAME
    HookEntry -- call-back stub vector (LANGUAGE SPECIFIC LINK ROUTINE)

SYNOPSIS
    This function is never called directly by the client.

FUNCTION
    HookEntry's purpose is to do language-specific setup and conversion
    of parameters passed from a library to a client call-back routine.
    Under Kickstart 2.0, a standard for call-backs has been established.
    The registers will contain the following items:

            A0:     pointer to hook that enabled us to get here.
            A2:     pointer to "object."
            A1:     pointer to "message packet."

    In iffparse, the "object" will vary from routine to routine.  The
    "message packet" is also specific to the operation involved (RTFM!).

    THIS ROUTINE IS NOT PART OF IFFPARSE.  It, or something similar, is
    part of the compiler vendor's link library.  (If it's not there,
    cobbling up your own isn't too hard.)

SEE ALSO
    entryhandler(), exithandler(), initiff(), setlocalitempurge(),
    utility/hooks.h (a must-read;  lots of details in there)