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


NAME
    HookEntry -- Assembler to HLL conversion stub for hook entry.  (V36)

SYNOPSIS
    result = HookEntry( struct Hook *, Object *, APTR )
    D0                  A0             A2        A1

FUNCTION
    By definition, a standard hook entry-point must receive the
    hook in A0, the object in A2, and the message in A1.  If your
    hook entry-point is written in a high-level language and is
    expecting its parameters on the stack, then HookEntry() will
    put the three parameters on the stack and invoke the function
    stored in the hook h_SubEntry field.

    This function is only useful to hook implementers, and is
    never called from C.

INPUTS
    hook - pointer to hook being invoked
    object - pointer to hook-specific data
    msg - pointer to hook-specific message

RESULT
    result - a hook-specific result.

NOTES
    While this function requires V36 or higher intuition.library,
    it first appeared in V37 amiga.lib.

EXAMPLE
    If your hook dispatcher is this:

    dispatch( struct Hook *hookPtr, Object *obj, APTR msg )
    {
        ...
    }

    Then when you initialize your hook, you would say:

    myhook.h_Entry = HookEntry;     /* amiga.lib stub */
    myhook.h_SubEntry = dispatch;   /* HLL entry */

SEE ALSO
    CallHook(), CallHookA(), <utility/hooks.h>