INT 2D - AMIS v3.0+ - DETERMINE CHAINED INTERRUPTS
AL = 04h
AH = multiplex number for program
BL = interrupt number (except 2Dh)
Return: AL = status
00h not implemented (makes TSR non-compliant with specification)
01h (obsolete) unable to determine
02h (obsolete) interrupt hooked
03h (obsolete) interrupt hooked, address returned
DX:BX -> TSR's interrupt BL handler
04h list of hooked interrupts returned
DX:BX -> interrupt hook list (see #02571)
FFh interrupt not hooked
Notes: BL is ignored if the TSR returns AL=04h; in that case, the caller
needs to scan the return list rather than making additional calls
to this function. If the return is not 00h or 04h, then the caller
must cycle through the remaining interrupt numbers it wishes to
check.
return values 01h through 03h may not be used by AMIS v3.6-compliant
programs; they are included here solely for compatibility with
version 3.3, though they were probably never used in any
implementation
for return values 01h through 03h, since INT 2D is known to be hooked,
the resident code need not test for BL=2Dh (to minimize its size),
and the return value is therefore undefined in that case.
this function is not valid unless a program is installed on the
specified multiplex number; use INT 2D/AL=00h to check
lDebug may change its interrupt hook list dynamically when installing
or uninstalling certain handlers, such as the INT 08 handler, the
INT 2F handler (lDebugX only), serial IRQ handler, and int 0Ch and
int 0Dh fault handlers. the trail of the list is static, but the
start address and the contents of the leading entries may change.
lCDebug and lDDebug (debuggable builds of lDebug) may point to
interrupt handlers not currently installed. they usually will
contain FFFFh:FFFFh in their downlinks.
lDOS kernel only lists its INT 2D hook, as the other interrupt
handlers aren't hooks in the same way (and do not use IISP headers).
the lDOS kernel's interrupt hook list and its INT 2D handler are
addressed using segment 26h or segment 60h.
SeeAlso: INT 2D/AL=00h,INT 2D/AL=01h,INT 2D/AL=02h,INT 2D/AL=03h,INT 2D/AL=05h
SeeAlso: INT 2D/AL=06h
Format of AMIS interrupt hook list [array]:
Offset Size Description (Table 02571)
00h BYTE interrupt number (last entry in array is 2Dh)
01h WORD offset within hook list's segment of the interrupt handler
this will point at the initial short jump of the interrupt
sharing protocol header (see #02568)
Notes: the specification doesn't forbid the same interrupt number occur
repeatedly with different handlers, except for the INT 2D entry
as it terminates the list. lDOS KEEPHOOK depends on this.
lDOS RENUMBER detects an overflow if about 4096 entries are looped
through without finding the INT 2D entry. a comment on this check
states that at 18 bytes per IISP header, 4096 unique handlers
would already overflow a 64 KiB segment.
SeeAlso: #02572