| M E M _ S E T D A T A J T S L O T ( )
| | | | | SOURCE: qdev_autodocs.txt 1.163 (12/09/2014) English AMIGA - MEM_#?
----------------------------------------------------------------------------
NAME
mem_setdatajtslot() - Sets userdata/base pointer to be
loaded in A6 reg. before func.
call as per slot.
SYNOPSIS
oldud = mem_setdatajtslot(jtab, ud, slot);
void *mem_setdatajtslot(
struct Library **, void *, LONG);
FUNCTION
This LBS companion function allows programmer to have
custom pointer in A6 register while the program jumps
to one of the local jump table routines.
INPUTS
jtab - Local jump table pointer.
ud - User data pointer or real library base. Stuff
NULL to switch to jump table default data ptr.
Stuff -1 to only get the existing data ptr.
slot - Slot number to affect. Counting from 1. If you
want to use offsets then include priv. header:
'a-mem_xxxjumptable.h' and use macros.
RETURNS
Returns old/existing userdata or NULL if not attached
or jtab is incompatible.
BASES
SysBase
NOTES
Warning! No arbitration is performed when altering the
slot!
Normally this function will call 'CacheClearU()' after
new 'ud' has been set! It is possible to disable that.
SEE ALSO
mem_allocjumptable(), mem_freejumptable(),
mem_swapjumptable(), mem_importjumptable(),
mem_filljumptable(), mem_setaddrjtslot(),
mem_addrfrombase()
EXAMPLE
None.
BUGS
None known.
----------------------------------------------------------------------------
| |
| |