Home  /  Autodocs  /  amiga.lib

NAME

CallHookA
Invoke a hook given a pointer to a message.

SYNOPSIS

result = CallHookA(hookPtr, obj, message)

ULONG CallHook(struct Hook *, Object *, APTR);

FUNCTION

Invoke a hook on the supplied hook-specific data (an "object") and a parameter packet ("message"). This function is equivalent to utility.library/CallHookPkt().

INPUTS

hookPtr
A system-standard hook

obj
Hook-specific data object

message
The hook-specific message you wish to send

RESULT

result
a hook-specific result.

NOTES

This function first appeared in the V37 release of amiga.lib. However, it does not depend on any particular version of the OS, and works fine even in V34.

This function does not preserve the contents of register A4, which is the responsibility of the hook function being called. If your code depends upon the contents of register A4 to remain unchanged you may need to use your own CallHook/CallHookA implementation instead of the amiga.lib version.

SEE ALSO

CallHook(), utility.library/CallHookPkt(), <utility/hooks.h>