Previous
Index
Next
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