Outils pour utilisateurs

Outils du site


Action unknown: copypageplugin__copy
back2root:ibm-pc-ms-dos:interrupts:old:ms_interrupt_list-22-30

MSDOS - Interrupt List 22h-30h

———-22——————————— INT 22 - DOS 1+ - PROGRAM TERMINATION ADDRESS

 specifies the address of the routine which is to be given control after
 a program is terminated; should never be called directly, since it does not
 point at an interrupt handler

Notes: this vector is restored from the DWORD at offset 0Ah in the PSP during

  termination, and then a FAR JMP is performed to the address in INT 22
normally points at the instruction immediately following INT 21/AH=4Bh
  call which loaded the current program

SeeAlso: INT 20,INT 21/AH=00h,INT 21/AH=31h,INT 21/AH=4Ch ———-23——————————— INT 23 - DOS 1+ - CONTROL-C/CONTROL-BREAK HANDLER

 invoked whenever DOS detects a ^C or ^Break; should never be called directly

—DOS 1.x— Return: AH = 00h abort program

if all registers preserved, restart DOS call

—DOS 2+— Return: all registers preserved

return via RETF or RETF 2 with CF set
    DOS will abort program with errorlevel 0
else (RETF/RETF 2 with CF clear or IRET)
    interrupted DOS call is restarted

Notes: MSDOS 1.25 also invokes INT 23 on a divide overflow (INT 00)

any DOS call may safely be made within the INT 23 handler, although
  the handler must to check for a recursive invocation if it does
  call DOS

SeeAlso: INT 1B ———-24——————————— INT 24 - DOS 1+ - CRITICAL ERROR HANDLER

 invoked when a critical (usually hardware) error is encountered; should
 never be called directly

Critical error handler is invoked with:

AH = type and processing flags
    bit 7 clear = disk I/O error
	  set	= -- if block device, bad FAT image in memory
		  -- if char device, error code in DI
    bit 6  unused
    bit 5 = 1 if Ignore allowed, 0 if not (DOS 3+)
    bit 4 = 1 if Retry allowed, 0 if not (DOS 3+)
    bit 3 = 1 if Fail allowed, 0 if not (DOS 3+)
    bit 2 \ disk area of error	00 = DOS area  01 = FAT
    bit 1 /			10 = root dir  11 = data area
    bit 0 = 1 if write, 0 if read
AL = drive number if AH bit 7 clear
BP:SI -> device driver header (BP:[SI+4] bit 15 set if char device)
DI low byte contains error code if AH bit 7 set
   00h write-protection violation attempted
   01h unknown unit for driver
   02h drive not ready
   03h unknown command given to driver
   04h data error (bad CRC)
   05h bad device driver request structure length
   06h seek error
   07h unknown media type
   08h sector not found
   09h printer out of paper
   0Ah write fault
   0Bh read fault
   0Ch general failure
   0Dh (DOS 3+) sharing violation
   0Eh (DOS 3+) lock violation
   0Fh invalid disk change
   10h (DOS 3+) FCB unavailable
   11h (DOS 3+) sharing buffer overflow
   12h (DOS 4+) code page mismatch
   13h (DOS 4+) out of input
   14h (DOS 4+) insufficient disk space
STACK:	DWORD	return address for INT 24 call
	WORD	flags pushed by INT 24
	WORD	original AX on entry to INT 21
	WORD	BX
	WORD	CX
	WORD	DX
	WORD	SI
	WORD	DI
	WORD	BP
	WORD	DS
	WORD	ES
	DWORD	return address for INT 21 call
	WORD	flags pushed by INT 21

Handler must return:

AL = action code
    00h ignore error and continue processing request
    01h retry operation
    02h terminate program through the equivalent of INT 21/AH=4Ch
		(INT 20h for DOS 1.x)
    03h fail system call in progress
SS,SP,DS,ES,BX,CX,DX preserved

Notes: the only DOS calls the handler may make are INT 21/AH=01h-0Ch,30h,59h

if the handler returns to the application by popping the stack, DOS
  will be in an unstable state until the first call with AH > 0Ch
for DOS 3.1+, IGNORE (AL=00h) is turned into FAIL (AL=03h) on network
  critical errors
if IGNORE specified but not allowed, it is turned into FAIL
if RETRY specified but not allowed, it is turned into FAIL
if FAIL specified but not allowed, it is turned into ABORT
(DOS 3+) if a critical error occurs inside the critical error handler,
  the DOS call is automatically failed

———-25——————————— INT 25 - DOS 1+ - ABSOLUTE DISK READ (except partitions > 32M)

AL = drive number (00h = A:, 01h = B:, etc)
CX = number of sectors to read
DX = starting logical sector number (0000h - highest sector on drive) 
DS:BX -> buffer for data

Return: CF clear if successful

CF set on error
    AH = status
	 80h device failed to respond (timeout)
	 40h seek operation failed
	 20h controller failed
	 10h data error (bad CRC)
	 08h DMA failure
	 04h requested sector not found
	 03h write-protected disk (INT 26 only)
	 02h bad address mark
	 01h bad command
    AL = error code (same as passed to INT 24 in DI)
may destroy all other registers except segment registers

Notes: original flags are left on stack, and must be popped by caller

this call bypasses the DOS filesystem

BUG: DOS 3.1 through 3.3 set the word at ES:[BP+1Eh] to FFFFh if AL is an

invalid drive number

SeeAlso: INT 13/AH=02h,INT 26 ———-25——————————— INT 25 - DOS 3.31+ - ABSOLUTE DISK READ (>32M hard-disk partition)

AL = drive number (0=A, 1=B, etc)
CX = FFFFh
DS:BX -> disk read packet (see below)

Return: same as above Notes: partition is potentially >32M (and requires this form of the call) if

  bit 1 of device attribute word in device driver is set
original flags are left on stack, and must be removed by caller
this call bypasses the DOS filesystem

SeeAlso: INT 13/AH=02h,INT 26

Format of disk read packet: Offset Size Description 00h DWORD sector number 04h WORD number of sectors to read 06h DWORD transfer address ———-25CDCD—————————– INT 25 - Stacker - GET DEVICE DRIVER ADDRESS

AX = CDCDh
DS:BX -> buffer for address (see below)
CX = 0001h
DX = 0000h

Return: AX = CDCDh if Stacker installed

    DS:BX buffer filled

Format of driver address buffer: Offset Size Description 00h WORD signature CDCDh 02h WORD ??? 0001h 04h DWORD pointer to start of Stacker device driver

Format of device driver: Offset Size Description 00h WORD signature A55Ah 02h WORD Stacker version * 64h 04h WORD offset of volume-specific information offset table

	(list of WORDs, one per drive, containing offsets to various
	information)

06h 56 BYTEs n/a 3Eh BYTE volume number, set after INT 21/AX=4404h

	(use to index into volume-specific info offset table)

3Fh 19 BYTEs n/a 52h 4 BYTEs ASCII string “SWAP” 56h 26 BYTEs drive mapping table (one byte for each drive A: through Z:)

Format of Stacker boot record: Offset Size Description 1F0h 8 BYTEs Stacker signature (first byte is CDh) 1F8h DWORD pointer to start of Stacker device driver 1FCh WORD Stacker volume number 1FEh WORD ??? ———-25—-ALFF————————- INT 25 - PC-CACHE.SYS - INSTALLATION CHECK

AL = FFh
SI = 4358h

Return: SI = 6378h if installed

    CX = segment of device driver PC-CACHE.SYS
    DX = version (major in DH, minor in DL)

Note: PC-CACHE.SYS is a small device driver used by PC-Cache v5.x to obtain

  access to certain disk drivers for devices such as Bernoulli drives

SeeAlso: INT 13/AH=A0h ———-26——————————— INT 26 - DOS 1+ - ABSOLUTE DISK WRITE (except partitions > 32M)

AL = drive number (00h = A:, 01h = B:, etc)
CX = number of sectors to write
DX = starting logical sector number (0000h - highest sector on drive) 
DS:BX -> data to write

Return: CF clear if successful

CF set on error
    AH = status
	 80h device failed to respond (timeout)
	 40h seek operation failed
	 20h controller failed
	 10h data error (bad CRC)
	 08h DMA failure
	 04h requested sector not found
	 03h write-protected disk (INT 26 only)
	 02h bad address mark
	 01h bad command
    AL = error code (same as passed to INT 24 in DI)
may destroy all other registers except segment registers

Notes: original flags are left on stack, and must be popped by caller

this call bypasses the DOS filesystem

BUG: DOS 3.1 through 3.3 set the word at ES:[BP+1Eh] to FFFFh if AL is an

invalid drive number

SeeAlso: INT 13/AH=03h,INT 25 ———-26——————————— INT 26 - DOS 3.31+ - ABSOLUTE DISK WRITE (>32M hard-disk partition)

AL = drive number (0=A, 1=B, etc)
CX = FFFFh
DS:BX -> disk write packet (see below)

Return: same as above Notes: partition is potentially >32M (and requires this form of the call) if

  bit 1 of device attribute word in device driver is set
original flags are left on stack, and must be removed by caller
this call bypasses the DOS filesystem

SeeAlso: INT 13/AH=03h,INT 25

Format of disk write packet: Offset Size Description 00h DWORD sector number 04h WORD number of sectors to read 06h DWORD transfer address ———-27——————————— INT 27 - DOS 1+ - TERMINATE AND STAY RESIDENT

DX = number of bytes to keep resident (max FFF0h)
CS = segment of PSP

Return: never Notes: this is an obsolete call

INT 22, INT 23, and INT 24 are restored from the PSP
does not close any open files
the minimum number of bytes which will remain resident is 110h for
  DOS 2.x and 60h for DOS 3+; there is no minimum for DOS 1.x, which
  implements this service in COMMAND.COM rather than the DOS kernel

SeeAlso: INT 21/AH=31h ———-28——————————— INT 28 - DOS 2+ - DOS IDLE INTERRUPT

 Invoked each time one of the DOS character input functions loops while
 waiting for input.  Since a DOS call is in progress even though DOS is
 actually idle during such input waits, hooking this function is necessary
 to allow a TSR to perform DOS calls while the foreground program is
 waiting for user input.  The INT 28h handler may invoke any INT 21 function
 except functions 00h through 0Ch.  Under DOS 2.x, the critical error flag
 (the byte immediately after the InDOS flag) must be set in order to call
 DOS functions 50h/51h without destroying the DOS stacks.

Notes: calls to INT 21/AH=3Fh,40h may not use a handle which refers to CON

at the time of the call, the InDOS flag (see INT 21/AH=34h) is normally
  set to 01h; if larger, DOS is truly busy and should not be reentered
the default handler is an IRET instruction
supported in OS/2 compatibility box

SeeAlso: INT 21/AH=34h,INT 2A/AH=84h ———-29——————————— INT 29 - DOS 2+ - FAST CONSOLE OUTPUT

AL = character to display

Return: nothing Notes: automatically called when writing to a device with bit 4 of its device

  driver header set (see also INT 21/AH=52h)
COMMAND.COM v3.2 and v3.3 compare the INT 29 vector against the INT 20
  vector and assume that ANSI.SYS is installed if the segment is larger
the default handler under DOS 2.x and 3.x simply calls INT 10/AH=0Eh
the default handler under DESQview 2.2 understands the <Esc>[2J
  screen-clearing sequence, calls INT 10/AH=0Eh for all others

SeeAlso: INT 79 ———-2A00——————————- INT 2A - NETWORK (Microsoft, LANtastic) - INSTALLATION CHECK

AH = 00h

Return: AH <> 00h if installed SeeAlso: INT 5C ———-2A0000—————————– INT 2A - AT&T Starlan Extended NetBIOS (var length names) - INSTALLATION CHECK

AX = 0000h

Return: AH = DDh SeeAlso: INT 5B ———-2A01——————————- INT 2A - NETWORK (Microsoft,LANtastic) - EXECUTE NETBIOS REQUEST,NO ERROR RETRY

AH = 01h
ES:BX -> NCB (see INT 5C)

Return: AL = NetBIOS error code

AH = 00h if no error
   = 01h on error

SeeAlso: AH=04h,AX=0500h,INT 5B,INT 5C“NetBIOS” ———-2A02——————————- INT 2A - NETWORK (Microsoft) - SET NET PRINTER MODE

AH = 02h
???

Return: ??? ———-2A0300—————————– INT 2A - NETWORK (Microsoft,LANtastic) - CHECK DIRECT I/O

AX = 0300h
DS:SI -> ASCIZ device name (may be full path or only drive specifier--
	must include the colon)

Return: CF clear if direct physical addressing (INT 13,INT 25) permissible

CF set if access via files only

Notes: do not use direct disk accesses if this function returns CF set or the

  device is redirected (INT 21/AX=5F02h)
may take some time to execute
called by DOS kernel on INT 25 and INT 26

SeeAlso: INT 13,INT 25,INT 26,INT 21/AX=5F02h ———-2A04——————————- INT 2A - NETWORK (Microsoft,LANtastic) - EXECUTE NetBIOS REQUEST

AH = 04h
AL = error retry
    00h automatically retry request on errors 09h, 12h, and 21h
    01h no retry
ES:BX -> Network Control Block (see INT 5C"NetBIOS")

Return: AX = 0000h if successful

AH = 01h on error
    AL = error code

Note: invokes either INT 5B or INT 5C as appropriate SeeAlso: AH=01h,AX=0500h,INT 5B,INT 5C“NetBIOS” ———-2A0500—————————– INT 2A - NETWORK (Microsoft,LANtastic) - GET NETWORK RESOURCE AVAILABILITY

AX = 0500h

Return: AX reserved

BX = number of network names available
CX = number of network control blocks available
DX = number of network sessions available

SeeAlso: AH=01h,AH=04h,INT 5C“NetBIOS” ———-2A06——————————- INT 2A - NETBIOS, LANtastic - NETWORK PRINT-STREAM CONTROL

AH = 06h
AL = 01h set concatenation mode (all printer output put in one job)
     02h set truncation mode (default)
	 printer open/close starts new print job
     03h flush printer output and start new print job

Return: CF set on error

    AX = error code
CF clear if successful

Notes: subfunction 03h is equivalent to Ctrl/Alt/keypad-*

LANtastic v4.x no longer supports this call

SeeAlso: INT 21/AX=5D08h,INT 21/AX=5D09h,INT 2F/AX=1125h ———-2A2001—————————– INT 2A - MS Networks or NETBIOS - ???

AX = 2001h
???

Return: ??? Note: intercepted by DESQview 2.x ———-2A2002—————————– INT 2A - NETWORK - ???

AX = 2002h
???

Return: ??? Note: called by MSDOS 3.30-5.00 APPEND ———-2A2003—————————– INT 2A - NETWORK - ???

AX = 2003h
???

Return: ??? Note: called by MSDOS 3.30-5.00 APPEND ———-2A7802—————————– INT 2A - NETWORK - PC LAN PROG v1.31+ - GET LOGGED ON USER NAME

AX = 7802h
ES:DI -> 8-byte buffer to be filled

Return: AL = 00h if no user logged on to Extended Services

AL <> 00h if user logged on to Extended Services
    buffer at ES:DI filled with name, padded to 8 chars with blanks.

———-2A80——————————- INT 2A - NETWORK - BEGIN DOS CRITICAL SECTION

AH = 80h
AL = critical section number (00h-0Fh)
    01h DOS kernel, SHARE.EXE
	apparently for maintaining the integrity of DOS/SHARE/NET
	  data structures
    02h DOS kernel
	ensures that no multitasking occurs while DOS is calling an
	  installable device driver
    05h DOS 4.x only IFSFUNC
    06h DOS 4.x only IFSFUNC
    08h ASSIGN.COM
    0Ah MSCDEX

Notes: normally hooked to avoid interrupting a critical section, rather than

  called
the handler should ensure that none of the critical sections are
  reentered, usually by suspending a task which attempts to reenter
  an active critical section
the DOS kernel does not invoke critical sections 01h and 02h unless it
  is patched.  DOS 3.1 through 3.31 contain a zero-terminated list of
  words beginning at offset 02C3h in the IBMDOS segment; each word
  contains the offset within the IBMDOS segment of a byte which must
  be changed from C3h to 50h to enable use of critical sections.

SeeAlso: AH=81h,AH=82h,AH=87h,INT 21/AX=5D06h,INT 21/AX=5D0Bh ———-2A81——————————- INT 2A - NETWORK - END DOS CRITICAL SECTION

AH = 81h
AL = critical section number (00h-0Fh) (see AH=80h)

Notes: normally hooked rather than called

the handler should reawaken any tasks which were suspended due to an
  attempt to enter the specified critical section

SeeAlso: AH=80h,AH=82h,AH=87h ———-2A82——————————- INT 2A - NETWORK - END DOS CRITICAL SECTIONS 0 THROUGH 7

AH = 82h

Notes: called by the INT 21h function dispatcher for function 0 and functions

  greater than 0Ch except 59h, and on process termination
the handler should reawaken any tasks which were suspended due to an
  attempt to enter one of the critical sections 0 through 7

SeeAlso: AH=81h ———-2A84——————————- INT 2A - Microsoft Networks - KEYBOARD BUSY LOOP

AH = 84h

Note: similar to DOS's INT 28h, called from inside the DOS keyboard input

  loop to allow network to process requests

SeeAlso: INT 28 ———-2A87——————————- INT 2A - PRINT??? - CRITICAL SECTION

AH = 87h
AL = start/end
    00h start
    01h end

Note: called by PRINT.COM SeeAlso: AH=80h,AH=81h ———-2A89——————————- INT 2A - Network - ???

AH = 89h
AL = ???  (ASSIGN uses 08h)
???

Return: ??? ———-2A90——————————- INT 2A - IBM PC 3270 EMULATION PROGRAM - ???

AH = 90h
???

Return: ??? Note: the LANtastic redirector and SERVER.EXE use this function with AL=01h,

  03h-07h,0Ch-11h

———-2AC2——————————- INT 2A - Network - ???

AH = C2h
AL = subfunction
    07h ???
    08h ???
BX = 0001h
???

Return: ??? Note: called by DOS 3.30-5.00 APPEND ———-2AFF90—————————– INT 2A - PC/TCP PREDIR.EXE - ???

AX = FF90h

Return: AX = ??? Note: PREDIR.EXE is the network printer redirector included as part of the

  PC/TCP system by FTP Software, Inc.

———-2AFF91—————————– INT 2A - PC/TCP PREDIR.EXE - ???

AX = FF91h
BX = ???

Return: AX = status??? ———-2AFF92—————————– INT 2A - PC/TCP PREDIR.EXE - INSTALLATION CHECK

AX = FF92h

Return: AX = 0000h if installed

   BX = redirected printer port (FFFFh if no printers redirected)
   CX = version (CH = major, CL = minor)

Note: PREDIR.EXE is the network printer redirector included as part of the

  PC/TCP system by FTP Software, Inc.

———-2AFF93—————————– INT 2A - PC/TCP PREDIR.EXE - ???

AX = FF93h

Return: AX = ??? ———-2AFF94—————————– INT 2A - PC/TCP PREDIR.EXE - ???

AX = FF94h
BX = ???
CX = ???
DX = ???

Return: AX = ??? Note: PREDIR.EXE is the network printer redirector included as part of the

  PC/TCP system by FTP Software, Inc.

———-2AFF95—————————– INT 2A - PC/TCP PREDIR.EXE - GET CONFIGURATION STRINGS

AX = FF95h
CX = what to get
    0000h ??? (returned pointer to "C:\COMMAND.COM")
    0001h spooling program
    0002h ???
    0003h spool file name
    0004h swap file name

Return: AX = status

    0000h successful
BX:DX -> ASCIZ configuration string

———-2AFF96—————————– INT 2A - PC/TCP PREDIR.EXE - SET PRINT JOB TERMINATION CONFIGURATION

AX = FF96h
CX = what to set
    0000h ???
    0001h print-on-hotkey state
    0002h print-on-exit state
    0003h print job timeout in clock ticks
    0004h print-on-EOF state
BX = new value (0000h disabled, 0001h enabled except for timeout)

Return: AX = ??? SeeAlso: AX=FF97h Note: PREDIR.EXE is the network printer redirector included as part of the

  PC/TCP system by FTP Software, Inc.

———-2AFF97—————————– INT 2A - PC/TCP PREDIR.EXE - GET PRINT JOB TERMINATION CONFIGURATION

AX = FF97h
CX = what to get
    0000h ???
    0001h print-on-hotkey state
    0002h print-on-exit state
    0003h print job timeout in clock ticks
    0004h print-on-EOF state

Return: AX = status

    0000h successful
BX = old value (0000h disabled, 0001 enabled except for timeout)

SeeAlso: AX=FF96h ———-2B——————————— INT 2B - DOS 2+ - RESERVED Note: this vector is not used in DOS versions ⇐ 5.00, and points at an IRET ———-2C——————————— INT 2C - DOS 2+ - RESERVED Note: this vector is not used in DOS versions ⇐ 5.00, and points at an IRET ———-2C——————————— INT 2C - STARLITE architecture - KERNEL API Note: STARLITE is an architecture by General Software for a series of MS-DOS

  compatible operating systems (OEM DOS, NETWORK DOS, and SMP DOS) to
  be released in 1991.	The interrupt number is subject to change
  before the actual release.

———-2D——————————— INT 2D - DOS 2+ - RESERVED Note: this vector is not used in DOS versions ⇐ 5.00, and points at an IRET ———-2D——————————— INT 2D - ALTERNATE MULTIPLEX INTERRUPT SPECIFICATION (AMIS) [proposal v3.4]

AH = multiplex number
AL = function
    00h installation check
	Return: AL = FFh if multiplex number in use
		    CX = version number (CH = major, CL = minor)
		    DX:DI -> signature string (see below) identifying
			    the program using the multiplex number
		AL = 00h if free
    01h get entry point
	Return: AL = FFh if entry point supported
		    DX:BX -> entry point for bypassing interrupt chain
		AL = 00h if all API calls via INT 2D
    02h uninstall
    	DX:BX = return address for successful uninstall (may be
		ignored by TSR)
	Return: AL = status
		    00h not implemented
		    01h unsuccessful
		    02h can not uninstall yet, will do so when able
		    03h safe to remove, but no resident uninstaller
		    	(TSR still enabled)
		    	BX = segment of memory block with resident code
		    04h safe to remove, but no resident uninstaller
		    	(TSR now disabled)
		    	BX = segment of memory block with resident code
		    05h not safe to remove now, try again later
		    FFh successful
		return at DX:BX with AX destroyed if successful and
		  TSR honors specific return address
    03h request pop-up
	Return: AL = status
		    00h not implemented or TSR is not a pop-up
		    01h can not pop up at this time, try again later
		    02h can not pop up yet, will do so when able
		    03h already popped up
		    04h unable to pop up, user intervention required
		    	BX = standard reason code
			    0000h unknown failure 
			    0001h interrupt chain passes through memory
			    	  which must be swapped out to pop up
			    0002h swap-in failed
			CX = application's reason code if nonzero
		    FFh TSR popped up and was exited by user
			BX = return value
			    0000h no return value
			    0001h TSR unloaded
			    0002h-00FFh reserved
			    0100h-FFFFh application-dependent
    04h determine chained interrupts
    	BL = interrupt number (except 2Dh)
	Return: AL = status
		    00h not implemented
		    01h unable to determine
		    02h interrupt hooked
		    03h interrupt hooked, address returned
		    	DX:BX -> TSR's interrupt BL handler
		    04h list of hooked interrupts returned
		    	DX:BX -> interrupt hook list (see below)
		    FFh interrupt not hooked
	Notes:	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.
		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 thru 03h are disparaged and may be
		  removed from future versions of the specification;
		  they are included for compatibility with version 3.3
    05h-0Fh reserved for future enhancements
	Return: AL = 00h (not implemented)
    other  application-dependent

Notes: programs should not use fixed multiplex numbers; rather, a program

  should scan all multiplex numbers from 00h to FFh, remembering the
  first unused multiplex in case the program is not yet installed.
  For multiplex numbers which are in use, the program should compare
  the first 16 bytes of the signature string to determine whether it
  is already installed on that multiplex number.  If not previously
  installed, it should use the first free multiplex number.
functions other than 00h are not valid unless a program is installed
  on the selected multiplex number
to be considered fully compliant with version 3.4 of the specification,
  programs must implement at least functions 00h, 02h (no resident
  uninstall code required), and 04h (return value 04h).  The absolute
  minimum implementation has an overhead of 64 bytes plus 22 bytes per
  hooked interrupt (for the interrupt sharing protocol header and hook
  list entry).
the signature string and description may be used by memory mappers
  to display the installed programs
users of this proposal should adhere to the IBM interrupt sharing
  protocol (see below), which will permit removal of TSRs in
  arbitrary order and interrupt handler reordering.  All TSRs
  following this proposal should be removable, though they need not
  keep the code for removing themselves resident; it is acceptable
  for a separate program to perform the removal.
A sample implementation including example TSRs and utility programs
  may be found in a separate package distributed as AMISLnnn.ZIP
  (AMISL081.ZIP as of this writing).
Please let me know if you choose to follow this proposal.  A list of
  the private API calls you use would be appreciated, as well.

SeeAlso: INT 2F

Format of signature string: Offset Size Description 00h 8 BYTEs blank-padded manufacturer's name (possibly abbreviated) 08h 8 BYTEs blank-padded product name 10h 64 BYTEs ASCIZ product description (optional, may be a single 00h) Note: it is not necessary to reserve a full 64 bytes for the description,

  just enough to store the actual ASCIZ string

Format of interrupt hook list [array]: Offset Size Description 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 below)

Format of interrupt sharing protocol interrupt handler entry point: Offset Size Description 00h 2 BYTEs short jump to actual start of interrupt handler, immediately

	following this data block (EBh 10h)

02h DWORD address of next handler in chain 06h WORD signature 424Bh 08h BYTE EOI flag

	00h software interrupt or secondary hardware interrupt handler
	80h primary hardware interrupt handler (will issue EOI)

09h 2 BYTEs short jump to hardware reset routine

	must point at a valid FAR procedure (may be just RETF)

0Bh 7 BYTEs reserved (0)

Signatures known to be in use: 'Crynwr ' 'SPELLER ' TSR spelling-checker 'heathh ' 'Monitor ' 'Ralf B ' 'FASTMOUS' example TSR included with sample AMIS library code 'Ralf B ' 'NOLPT n ' example TSR – turn LPTn into bit-bucket 'Ralf B ' 'NOTE ' example TSR – popup note-taker 'Ralf B ' 'SWITCHAR' example TSR – add switchar() support removed from DOS5 'Ralf B ' 'VGABLANK' example TSR – VGA-only screen blanker 'TifaWARE' 'EATMEM ' George A. Theall's public domain memory restrictor for testing programs (v1.1+)

    'RECALL  '	public domain commandline editor and history (v1.2+)

———-2E——————————— INT 2E - DOS 2+ - PASS COMMAND TO COMMAND INTERPRETER FOR EXECUTION

DS:SI -> commandline to execute (see below)

Return: all registers except CS:IP destroyed

AX = status (4DOS v4.0)
   0000h successful
   FFFFh error before processing command (not enough memory, etc)
   other error number returned by command

Notes: this call allows execution of arbitrary commands (including COMMAND.COM

  internal commands) without loading another copy of COMMAND.COM
if COMMAND.COM is the user's command interpreter, the primary copy
  executes the command; this allows the master environment to be
  modified by issuing a "SET" command, but changes in the master
  environment will not become effective until all programs descended
  from the primary COMMAND.COM terminate
since COMMAND.COM processes the string as if typed from the keyboard,
  the transient portion needs to be present, and the calling program
  must ensure that sufficient memory to load the transient portion can
  be allocated by DOS if necessary
results are unpredictable if invoked by a program run from a batch file
  because this call is not reentrant and COMMAND.COM uses the same
  internal variables when processing a batch file
hooked but ignored by 4DOS v3.0 COMMAND.COM replacement unless SHELL2E
  has been loaded

Format of commandline: Offset Size Description 00h BYTE length of command string, not counting trailing CR 01h var command string

N	BYTE	0Dh (CR)

———-2E—-BXE22E———————– INT 2E - 4DOS v2.x-3.03 SHELL2E.COM - UNINSTALL

BX = E22Eh
DS:SI -> zero byte

Return: if successful, SHELL2E terminates itself with INT 21/AH=4Ch ———-2F——————————— INT 2F - Multiplex - NOTES

AH = identifier of program which is to handle the interrupt
   00h-7Fh reserved for DOS
   C0h-FFh reserved for applications
AL is the function code
 This is a general mechanism for verifying the presence of a TSR and 
 communicating with it.  When searching for a free identifier code for AH
 using the installation check (AL=00h), the calling program should set
 BX/CX/DX to 0000h and must not depend on any registers other than CS:IP
 and SS:SP to be valid on return, since numerous programs now use additional
 registers on input and/or output for the installation check.

Note: Since the multiplex chain is growing so long, and beginning to

  experience multiplex number collisions, I am proposing an alternate
  multiplex interrupt on INT 2D.  If you decide to use the alternate
  multiplex, please let me know.

SeeAlso: INT 2D ———-2F——————————— INT 2F - BMB Compuscience Canada Utilities Interface

AH = xx (dynamically assigned based upon a search for a multiplex
	 number which doesn't answer installed)
AL = 00h installation check
ES:DI = EBEBh:BEBEh

Return: AL = 00h not installed

     01h not installed, not OK to install
     FFh installed; if ES:DI was EBEBh:BEBEh on entry, ES:DI will point
	 to a string of the form 'MMMMPPPPPPPPvNNNN' where MMMM is a
	 short form of the manufacturer's name, PPPPPPPP is a product
	 name and NNNN is the product's version number

———-2F——————————— INT 2F - Ross Wentworth's Turbo Pascal POPUP LIBRARY

AH = programmer-selected multiplex number
AL = function
    00h installation check
	Return: AL = FFh if installed
    01h get TSR interrupt vectors
	Return: DX:AX -> vector table (see below)
    02h get TSR code segment
	Return: AX = code segment for all interrupt handlers
    03h call user exit routine and release TSR's memory
    04h get signature string
	Return: DX:AX -> counted string containing signature
    05h get TSR's INT 2F handler
	Return: DX:AX -> INT 2F handler
    06h enable/disable TSR
	BL = new state (00h disabled, 01h enabled)
    07h activate TSR (popup if not disabled)
    08h get hotkeys
	BL = which hotkey (00h = hotkey 1, 01h = hotkey 2)
	Return: AX = hotkey (AH = keyflags, AL = scancode)
    09h set hotkey
	BL = which hotkey (00h = hotkey 1, 01h = hotkey 2)
	CX = new hotkey (CH = keyflags, CL = scancode)
    0Ah-1Fh reserved

Format of vector table entry: Offset Size Description 00h BYTE vector number (00h = end of table) 01h DWORD original vector 05h WORD offset of interrupt handler in TSR's code segment ———-2F——————————— INT 2F - CiriSOFT Spanish University of Valladolid TSR's Interface

AH = xx (dynamically assigned based upon a search for a multiplex
	 number from C0h to FFh which doesn't answer installed)
AL = 00h installation check
ES:DI = 1492h:1992h

Return: AL = 00h not installed

     01h not installed, not OK to install
     FFh installed; and if ES:DI was 1492h:1992h on entry, ES:DI will
	 point to author_name_ver table (see below)
AH = FFh

Note: this interface permits advanced communication with TSRs: it is possible

  to make a generic unistall utility, advanced TSR relocator programs
  in order to fit fragmented memory areas, etc.

See also: INT 2D“AMIS”,INT 2F“Compuscience”

Format of author_name_ver table: Offset Size Description -16 WORD segment in which really begins the TSR code (CS in programs

	with PSP, XMS upper memory segment if installed as UMB...)

-14 WORD offset in which really begins the TSR code (frecuently 100h

	in *.COM programs and 0 in upper memory TSR's).

-12 WORD memory used by TSR (in paragraphs). Knowing the memory area

	used by TSR is possible to determine if hooked vectors are
	still pointing it (and if it is safe the unistall process).

-10 BYTE characteristics byte

	bits 0-2: 000 normal program (with PSP)
		  001 upper XMS memory block (needed HIMEM.SYS function
		      to free memory when unistalling)
		  010 device driver (*.SYS)
		  011 device driver in EXE format
		  1xx others (reserved)
	bits 3-6 reserved
	bit 7 set if extra_table defined and supported

-9 BYTE number of multiplex entry used (redefinition available). Note

	that the TSR must be use THIS variable in it's INT 2Fh handler.

-8 WORD offset to vector_area table (see bellow) -6 WORD offset to extra_area table (see bit 7 in offset -10 and bellow) -4 4 BYTEs “*##*” (to insure that the TSR verify this agreement) 00h var “AUTHOR:PROGRAM_NAME:VERSION”,0 (variable length, this area

	is used in order to determine if the TSR is already resident
	and it's version code; the ':' char is used as delimiter)

Format of vector_area table: Offset Size Description -1 BYTE number of vectors intercepted by TSR 00h BYTE first vector number 01h DWORD first vector pointer before installing the TSR 05h BYTE second vector number 06h DWORD second vector pointer before installing the TSR

.	  .	(and so on) Note that the TSR must be use THIS variables to
	invoke previous interrupt handler routines.

Format of extra_area table (needed only to improve relocation feature): Offset Size Description 00h WORD offset to external_ctrl table (0 if not supported) 02h WORD reserved for future use (0)

Format of external_ctrl table: Offset Size Description 00h BYTE bit 0: TSR is relocatable (no absolute segment references) 01h WORD offset to a variable which can activate/inhibit the TSR —And if bit 0 in offset 00h is off: 03h DWORD pointer to ASCIIZ with pathname to executable file which

	supports /SR parameter (silent installation & inhibit)

07h DWORD pointer to first variable to initialize on the copy reloaded

	from the previous TSR still resident

0Bh DWORD pointer to last variable (all variables packed in one block) ———-2F00——————————- INT 2F U - DOS 2.x PRINT.COM - ???

AH = 00h
???

Return: ??? Notes: DOS 2.x PRINT.COM does not chain to previous INT 2F handler

values in AH other than 00h or 01h cause PRINT to return the number of
  files in the queue in AH

SeeAlso: AH=01h ———-2F0080—————————– INT 2F - DOS 3.1+ PRINT.COM - GIVE PRINT A TIME SLICE

AX = 0080h

Return: after PRINT executes ———-2F01——————————- INT 2F U - DOS 2.x PRINT.COM - ???

AH = 01h
???

Return: ??? Notes: DOS 2.x PRINT.COM does not chain to previous INT 2F handler

values in AH other than 00h or 01h cause PRINT to return the number of
  files in the queue in AH

SeeAlso: AH=00h ———-2F0100—————————– INT 2F - DOS 3+ PRINT.COM - INSTALLATION CHECK

AX = 0100h

Return: AL = status

    00h not installed
    01h not installed, but not OK to install
    FFh installed

SeeAlso: AX=0101h ———-2F0101—————————– INT 2F - DOS 3+ PRINT.COM - SUBMIT FILE FOR PRINTING

AX = 0101h
DS:DX -> submit packet (see below)

Return: CF clear if successful

    AL = 01h added to queue
	 9Eh now printing
CF set on error
    AX = error code (see also INT 21/AH=59h)
	01h invalid function
	02h file not found
	03h path not found
	04h out of file handles
	05h access denied
	08h print queue full
	09h spooler busy
	0Ch name too long
	0Fh invalid drive

SeeAlso: AX=0102h

Format of submit packet: Offset Size Description 00h BYTE level (must be 00h) 01h DWORD pointer to ASCIZ filename (no wildcards) ———-2F0102—————————– INT 2F - DOS 3+ PRINT.COM - REMOVE FILE FROM PRINT QUEUE

AX = 0102h
DS:DX -> ASCIZ filename (wildcards allowed)

Return: CF clear if successful

CF set on error
    AX = error code (see AX=0101h)

SeeAlso: AX=0101h,AX=0103h ———-2F0103—————————– INT 2F - DOS 3+ PRINT.COM - CANCEL ALL FILES IN PRINT QUEUE

AX = 0103h

Return: CF clear if successful

CF set on error
    AX = error code (see AX=0101h)

SeeAlso: AX=0102h ———-2F0104—————————– INT 2F - DOS 3+ PRINT.COM - FREEZE PRINT QUEUE TO READ JOB STATUS

AX = 0104h

Return: CF clear if successful

    DX = error count
    DS:SI -> print queue
CF set on error
    AX = error code (see AX=0101h)

Notes: the print queue is an array of 64-byte ASCIZ filenames terminated by

  an empty filename; the first name is the file currently being printed
printing is stopped until AX=0105h is called to prevent the queue
  from changing while the filenames are being read

SeeAlso: AX=0101h,AX=0105h ———-2F0105—————————– INT 2F - DOS 3+ PRINT.COM - RESTART PRINT QUEUE AFTER STATUS READ

AX = 0105h

Return: CF clear if successful

CF set on error
    AX = error code (see AX=0101h)

SeeAlso: AX=0104h ———-2F0106—————————– INT 2F - DOS 3.3+ PRINT.COM - GET PRINTER DEVICE

AX = 0106h

Return: CF set if files in print queue

    AX = error code 0008h (queue full)
    DS:SI -> device driver header
CF clear if print queue empty
    AX = 0000h

Note: documented for DOS 5+, but not documented for prior versions SeeAlso: AX=0104h ———-2F0200—————————– INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - INSTALLATION CHECK

AX = 0200h

Return: AL = FFh if installed ———-2F0201—————————– INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???

AX = 0201h

Return: nothing??? Notes: called by DOS 3.3+ PRINT.COM

AX=0202h appears to be the opposite function

SeeAlso: AX=0202h ———-2F0202—————————– INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???

AX = 0202h
???

Return: nothing??? Note: called by DOS 3.3+ PRINT.COM SeeAlso: AX=0201h ———-2F0203—————————– INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???

AX = 0203h

Return: nothing??? Notes: called by DOS 3.3+ PRINT.COM

AX=0204h appears to be the opposite function

SeeAlso: AX=0204h ———-2F0204—————————– INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???

AX = 0204h
???

Return: nothing??? Note: called by DOS 3.3 PRINT.COM ———-2F——————————— INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???

AX = 02xxh
???

Return: ??? ———-2F0500—————————– INT 2F U - DOS 3+ CRITICAL ERROR HANDLER - INSTALLATION CHECK

AX = 0500h

Return: AL = 00h not installed, OK to install

     01h not installed, can't install
     FFh installed

Note: this set of functions allows a user program to partially or completely

  override the default critical error handler's message in COMMAND.COM

SeeAlso: AH=05h,INT 24 ———-2F05——————————- INT 2F U - DOS 3+ CRITICAL ERROR HANDLER - EXPAND ERROR INTO STRING

AH = 05h

—DOS 3.x—

AL = extended error code (not zero)

—DOS 4+ —

AL = error type
    01h DOS extended error code
    02h parameter error
BX = error code

Return: CF clear if successful

    ES:DI -> ASCIZ error message (read-only)
    AL = ???
CF set if error code can't be converted to string

Notes: called at start of COMMAND.COM's default critical error handler if

  installed by a user program, allowing partial or complete overriding
  of the default error message
subfunction 02h called by many DOS 4 external programs

SeeAlso: AX=122Eh,INT 24 ———-2F0600—————————– INT 2F - DOS v3.0+ ASSIGN - INSTALLATION CHECK

AX = 0600h

Return: AL = status

    00h not installed
    01h not installed, but not OK to install
    FFh installed

Note: ASSIGN is not a TSR in DR-DOS 5.0; it is internally replaced by SUBST

  (see INT 21/AX=2152h)

SeeAlso: AX=0601h,INT 21/AX=2152h ———-2F0601—————————– INT 2F U - DOS v3.0+ ASSIGN - GET DRIVE ASSIGNMENT TABLE

AX = 0601h

Return: ES = segment of ASSIGN work area and assignment table Note: under DOS 3+, the 26 bytes starting at ES:0103h specify which drive

  each of A: to Z: is mapped to.  Initially set to 01h 02h 03h....

SeeAlso: AX=0600h ———-2F0800—————————– INT 2F U - DRIVER.SYS support - INSTALLATION CHECK

AX = 0800h

Return: AL = 00h not installed, OK to install

     01h not installed, not OK to install
     FFh installed

Note: supported by DR-DOS 5.0 ———-2F0801—————————– INT 2F U - DRIVER.SYS support - ADD NEW BLOCK DEVICE

AX = 0801h
DS:DI -> drive data table (see AX=0803h)

Notes: moves down internal list of drive data tables, copying and modifying

  the drive description flags word for tables referencing same physical
  drive
data table appended to chain of tables
supported by DR-DOS 5.0

SeeAlso: AX=0803h ———-2F0802—————————– INT 2F U - DRIVER.SYS support - EXECUTE DEVICE DRIVER REQUEST

AX = 0802h
ES:BX -> device driver request header (see below)

Return: request header updated as per requested operation Notes: supported by DR-DOS 5.0

DOS 3.2 executes this function on any AL value from 02h through F7h

Format of device driver request header: Offset Size Description 00h BYTE length of request header 01h BYTE subunit within device driver 02h BYTE command code (see below) 03h WORD status (filled in by device driver)

	bit 15: error
	bits 14-11: reserved
	bit 10: ??? set by DOS kernel on entry to some driver calls
	bit 9: busy
	bit 8: done
	bits 7-0: error code if bit 15 set (see below)

—DOS— 05h 8 BYTEs reserved (unused in DOS 2.x and 3.x) —STARLITE architecture— 05h DWORD pointer to next request header 09h 4 BYTEs reserved —command code 00h— 0Dh BYTE number of units (set by driver) 0Eh DWORD address of first free byte following driver (set by driver) 12h DWORD pointer to BPB array (set by block drivers only) 16h BYTE (DOS 3+) drive number for first unit of block driver (0=A) —command code 01h— 0Dh BYTE media descriptor 0Eh BYTE returned status

	00h don't know
	01h media has not changed
	FFh media has been changed

0Fh DWORD (DOS 3+) pointer to previous volume ID if OPEN/CLOSE/RM bit in

	  device header set and disk changed (set by driver)

—command code 02h— 0Dh BYTE media descriptor 0Eh DWORD transfer address

  1. > scratch sector if NON-IBM FORMAT bit in device header set
  2. > first FAT sector otherwise

12h DWORD pointer to BPB (set by driver) —command codes 03h,0Ch— (see also INT 21/AX=4402h,INT 21/AX=4403h) 0Dh BYTE media descriptor (block devices only) 0Eh DWORD transfer address 12h WORD byte count (character devices) or sector count (block devices) 14h WORD starting sector number (block devices only) 16h DWORD (DOS 3+) pointer to volume label if error 0Fh (set by driver) —command codes 04h,08h,09h— 0Dh BYTE media descriptor (block devices only) 0Eh DWORD transfer address 12h WORD byte count (character devices) or sector count (block devices) 14h WORD starting sector number (block devices only) 16h DWORD (DOS 3+) pointer to volume ID if error 0Fh returned 1Ah DWORD (DOS 4+) 32-bit starting sector number (block devices with

	device attribute word bit 1 set only) (see INT 21/AH=52h)

—command code 05h— 0Dh BYTE byte read from device if BUSY bit clear on return —command codes 06h,07h,0Ah,0Bh,0Dh,0Eh,0Fh,85h,88h— no further fields —command code 10h— 0Dh BYTE unused 0Eh DWORD transfer address 12h WORD byte count —command codes 13h,19h— 0Dh BYTE category code

	00h unknown
	01h COMn:
	03h CON
	05h LPTn:
	08h disk
	9Eh (STARLITE) Media Access Control driver

0Eh BYTE function code

	00h (STARLITE) MAC Bind request

0Fh WORD copy of DS at time of IOCTL call (apparently unused in DOS 3.3) 11h WORD offset of device driver header 13h DWORD pointer to parameter block from INT 21/AX=440Ch or AX=440Dh —command codes 80h,82h— 0Dh BYTE addressing mode

	00h HSG (default)
	01h Phillips/Sony Red Book

0Eh DWORD transfer address (ignored for command 82h) 12h WORD number of sectors to read

	(if 0 for command 82h, request is an advisory seek)

14h DWORD starting sector number

	logical sector number in HSG mode
	frame/second/minute/unused in Red Book mode
	(HSG sector = minute * 4500 + second * 75 + frame - 150)

18h BYTE data read mode

	00h cooked (2048 bytes per frame)
	01h raw (2352 bytes per frame, including EDC/ECC)

19h BYTE interleave size (number of sectors stored consecutively) 1Ah BYTE interleave skip factor (# sectors between consec portions) —command code 83h— 0Dh BYTE addressing mode (see above) 0Eh DWORD transfer address (ignored) 12h WORD number of sectors to read (ignored) 14h DWORD starting sector number (see also above) —command code 84h— 0Dh BYTE addressing mode (see above) 0Eh DWORD starting sector number (see also above) 12h DWORD number of sectors to play —command codes 86h,87h— 0Dh BYTE addressing mode (see above) 0Eh DWORD transfer address (ignored in write mode 0) 12h WORD number of sectors to write 14h DWORD starting sector number (see also above) 18h BYTE write mode

	00h mode 0 (write all zeros)
	01h mode 1 (default) (2048 bytes per sector)
	02h mode 2 form 1 (2048 bytes per sector)
	03h mode 2 form 2 (2336 bytes per sector)

19h BYTE interleave size (number of sectors stored consecutively) 1Ah BYTE interleave skip factor (# sectors between consec portions)

Values for command code:

00h INIT
01h MEDIA CHECK (block devices)
02h BUILD BPB (block devices)
03h IOCTL INPUT
04h INPUT
05h NONDESTRUCTIVE INPUT, NO WAIT (character devices)
06h INPUT STATUS (character devices)
07h INPUT FLUSH (character devices)
08h OUTPUT
09h OUTPUT WITH VERIFY
0Ah OUTPUT STATUS (character devices)
0Bh OUTPUT FLUSH (character devices)
0Ch IOCTL OUTPUT
0Dh (DOS 3+) DEVICE OPEN
0Eh (DOS 3+) DEVICE CLOSE
0Fh (DOS 3+) REMOVABLE MEDIA (block devices)
10h (DOS 3+) OUTPUT UNTIL BUSY (character devices)
11h unused
12h unused
13h (DOS 3.2+) GENERIC IOCTL
14h unused
15h unused
16h unused
17h (DOS 3.2+) GET LOGICAL DEVICE
18h (DOS 3.2+) SET LOGICAL DEVICE
19h (DOS 5.0+) CHECK GENERIC IOCTL SUPPORT
80h (CD-ROM) READ LONG
81h (CD-ROM) reserved
82h (CD-ROM) READ LONG PREFETCH
83h (CD-ROM) SEEK
84h (CD-ROM) PLAY AUDIO
85h (CD-ROM) STOP AUDIO
86h (CD-ROM) WRITE LONG
87h (CD-ROM) WRITE LONG VERIFY
88h (CD-ROM) RESUME AUDIO

Values for error code:

00h write-protect violation
01h unknown unit
02h drive not ready
03h unknown command
04h CRC error
05h bad drive request structure length
06h seek error
07h unknown media
08h sector not found
09h printer out of paper
0Ah write fault
0Bh read fault
0Ch general failure
0Dh reserved
0Eh (CD-ROM) media unavailable
0Fh invalid disk change

———-2F0803—————————– INT 2F U - DOS 4+ DRIVER.SYS support - GET DRIVE DATA TABLE LIST

AX = 0803h

Return: DS:DI → first drive data table in list Note: not available under DR-DOS 5.0 SeeAlso: AX=0801h

Format of DOS 3.30 drive data table: Offset Size Description 00h DWORD pointer to next table 04h BYTE physical unit number (for INT 13) 05h BYTE logical drive number 06h 19 BYTEs BIOS Parameter Block (see also INT 21/AH=53h)

	Offset	Size	Description
	 00h	WORD	bytes per sector
	 02h	BYTE	sectors per cluster, FFh if unknown
	 03h	WORD	number of reserved sectors
	 05h	BYTE	number of FATs
	 06h	WORD	number of root dir entries
	 08h	WORD	total sectors
	 0Ah	BYTE	media descriptor, 00h if unknown
	 0Bh	WORD	sectors per FAT
	 0Dh	WORD	sectors per track
	 0Fh	WORD	number of heads
	 11h	WORD	number of hidden sectors

19h BYTE flags

	bit 6: 16-bit FAT instead of 12-bit FAT

1Ah WORD number of DEVICE OPEN calls without corresponding DEVICE CLOSE 1Ch 11 BYTEs volume label or “NO NAME ” if none (always “NO NAME” for

	fixed media)

27h BYTE terminating null for volume label??? 28h BYTE device type (see INT 21/AX=440Dh) 29h WORD bit flags describing drive

	bit 0: fixed media
	bit 1: door lock supported
	bit 2: ??? (used in determining BPB to set for INT 21/AX=440Dh)
	bit 3: all sectors in a track are the same size
	bit 4: physical drive has multiple logical units
	bit 5: current logical drive for physical drive
	bit 6: ???
	bit 7: ???
	bit 8: ??? (related to disk change detection)

2Bh WORD number of cylinders 2Dh 19 BYTEs BIOS Parameter Block for highest capacity supported 40h 3 BYTEs ??? 43h 9 BYTEs filesystem type???, default = “NO NAME ”

	(apparently only MSDOS 3.30 fixed media, nulls for removable
	media and PCDOS 3.30)

4Ch BYTE least-significant byte of last-accessed cylinder number —removable media— 4Dh DWORD time of last access in clock ticks (FFFFFFFFh if never) —fixed media— 4Dh WORD partition (FFFFh = primary, 0001h = extended) 4Fh WORD absolute cylinder number of partition's start on physical

	drive (always FFFFh if primary partition)

Format of COMPAQ DOS 3.31 drive data table: Offset Size Description 00h DWORD pointer to next table 04h BYTE physical unit number (for INT 13) 05h BYTE logical drive number 06h 25 BYTEs BIOS Parameter Block (see DOS 4.01 drive data table below) 1Fh 6 BYTEs ??? apparently always zeros 25h BYTE flags

	bit 6: 16-bit FAT instead of 12-bit FAT
	    5: large volume???

26h WORD device-open count??? 28h 11 BYTEs volume label or “NO NAME ” if none (always “NO NAME” for

	fixed media)

33h BYTE terminating null for volume label 34h BYTE device type (see INT 21/AX=440Dh) 35h WORD bit flags describing drive 37h WORD number of cylinders 39h 25 BYTEs BIOS parameter block for highest capacity drive supports 52h 6 BYTEs ??? apparently always zeros 58h BYTE least-significant byte of last-accessed cylinder number —removable media— 59h DWORD time of last access in clock ticks (FFFFFFFFh if never) —fixed media— 59h WORD partition (FFFFh = primary, 0001h = extended) 5Bh WORD absolute cylinder number of partition's start on physical

	drive (always FFFFh if primary partition)

Format of DOS 4.0-5.0 drive data table: Offset Size Description 00h DWORD pointer to next table 04h BYTE physical unit number (for INT 13) 05h BYTE logical drive number 06h 25 BYTEs BIOS Parameter Block (see also INT 21/AH=53h)

	Offset	Size	Description
	 00h	WORD	bytes per sector
	 02h	BYTE	sectors per cluster, FFh if unknown
	 03h	WORD	number of reserved sectors
	 05h	BYTE	number of FATs
	 06h	WORD	number of root dir entries
	 08h	WORD	total sectors (see offset 15h if zero)
	 0Ah	BYTE	media descriptor, 00h if unknown
	 0Bh	WORD	sectors per FAT
	 0Dh	WORD	sectors per track
	 0Fh	WORD	number of heads
	 11h	DWORD	number of hidden sectors
	 15h	DWORD	total sectors if WORD at 08h is zero

1Fh BYTE flags

	bit 6: 16-bit FAT instead of 12-bit

20h 2 BYTEs ??? 22h BYTE device type (see INT 21/AX=440Dh) 23h WORD bit flags describing drive

	bit 0: fixed media
	bit 1: door lock supported
	bit 2: ???
	bit 3: all sectors in a track are the same size
	bit 4: physical drive has multiple logical units
	bit 5: current logical drive for physical drive
	bit 6: ???
	bit 7: ???
	bit 8: ???

25h WORD number of cylinders 27h 25 BYTEs BIOS Parameter Block for highest capacity supported 40h 7 BYTEs ??? —removable media— 47h DWORD time of last access in clock ticks (FFFFFFFFh if never) —fixed media, DOS 4.x— 47h WORD partition (FFFFh = primary, 0001h = extended) 49h WORD absolute cylinder number of partition's start on phys drive

	(FFFFh if primary partition)

—fixed media, DOS 5.0— 47h WORD ??? apparently always 0001h 49h WORD absolute cylinder number of partition's start on phys drive


4Bh 11 BYTEs volume label or “NO NAME ” if none (apparently taken from

	extended boot record rather than root directory)

56h BYTE terminating null for volume label??? 57h DWORD serial number 5Bh 8 BYTEs filesystem type (“FAT12 ” or “FAT16 ”) 63h BYTE terminating null for filesystem type??? ———-2F0C00—————————– INT 2F - AD-DOS - INSTALLATION CHECK

AX = 0C00h

Return: AL = FF if installed

    BX = 4144H	('AD')
    CX = 2D44H	('-D')
    DX = 4F53H	('OS')

Notes: AD-DOS is the DOS version of the After Dark screen blanker for

  MS Windows
AH=0Ch is the default multiplex number

SeeAlso: AX=0C01h ———-2F0C01ES0000———————– INT 2F - AD-DOS - GET RESIDENT CODE SEGMENT

AX = 0C01h
ES = 0000h

Return: CF clear succesful

    ES = AD-DOS TSR Code Segment
CF set if failed

SeeAlso: AX=0C00h ———-2F0C02—————————– INT 2F - AD-DOS - CHECK FOR NEW INPUT

AX = 0C02h

Return: BX = status

    0000h no input since last check
    0001h new input available

Note: this call also resets the new-input flag ———-2F0C03—————————– INT 2F - AD-DOS - SET MINUTES TO WAIT

AX = 0C03h
BX = minutes to wait before blanking screen
CF set

Return: n/a??? Notes: AD-DOS is the DOS version of the After Dark screen blanker

AH=0Ch is the default multiplex number

SeeAlso: AX=0C04h ———-2F0C04—————————– INT 2F - AD-DOS - GET MINUTES TO WAIT

AX = 0C04h
CF set

Return: BX = minutes to wait before blanking screen

???

SeeAlso: AX=0C03h ———-2F0C05—————————– INT 2F - AD-DOS - SET ENABLE??? FLAG

AX = 0C05h
BX = new state (0000h or 0001h) (default 0001h)
CF set

Return: n/a??? SeeAlso: AX=0C06h ———-2F0C06—————————– INT 2F - AD-DOS - GET ENABLE??? FLAG

AX = 0C06h
Carry Set

Return: BX = current state of ??? flag (0000h or 0001h)

???

Notes: AD-DOS is the DOS version of the After Dark screen blanker

AH=0Ch is the default multiplex number

SeeAlso: AX=0C05h ———-2F0C07—————————– INT 2F - AD-DOS - SET HOT KEY

AX = 0C07h
BX = hot key
CL = hot key shift status
CF set

Return: n/a??? SeeAlso: AX=0C08h ———-2F0C08—————————– INT 2F - AD-DOS - GET CURRENT HOT KEY

AX = 0C08h
CF set

Return: AX = status

    0000h successful
	BX = Hot Key
	CL = Hot Key Shift Status
    0008h otherwise

SeeAlso: AX=0C07h ———-2F0C09—————————– INT 2F - AD-DOS - ???

AX = 0C09h
Carry Set

Return: AX = status

    0000h successful
	???
    0009h otherwise

Notes: AD-DOS is the DOS version of the After Dark screen blanker

AH=0Ch is the default multiplex number

———-2F0C0A—————————– INT 2F - AD-DOS - ???

AX = 0C0Ah
CF set

Return: AX = status

    0000h successful
	BH = ??
	BL = ??
    000Ah failed

———-2F0C0B—————————– INT 2F - AD-DOS - ???

AX = 0C0Bh
CF set

Return: AX = status

    0000h successful
    000Bh failed

———-2F0C0C—————————– INT 2F - AD-DOS - SET ??? INTERNAL FLAG TO 01h

AX = 0C0Ch
CF set

Return: AX = status

    0000h successful
    000Ch failed

Notes: AD-DOS is the DOS version of the After Dark screen blanker

AH=0Ch is the default multiplex number

———-2F0C20—————————– INT 2F - AD-DOS - GET AND RESET VxD API STATUS

AX = 0C20h
CF set

Return: AX = status

    0000h successful
	BX = VxD API Status
	    0000h no error
	    0001h error
	    0100h neither Windows 3.X enhanced mode nor
			Windows/386 2.x is running
	    0200h VM API entry point found
    0020h otherwise

Note: this call resets the VxD API Status to zero SeeAlso: AX=1602h,AX=1607h ———-2F1000—————————– INT 2F - SHARE - INSTALLATION CHECK

AX = 1000h

Return: AL = 00h not installed, OK to install

     01h  not installed, not OK to install
     FFh  installed

BUGS: values of AL other than 00h put DOS 3.x SHARE into an infinite loop

  (08E9: OR  AL,AL
   08EB: JNZ 08EB) <- the buggy instruction (DOS 3.3)
values of AL other than described here put PCDOS 4.00 into the same
  loop (the buggy instructions are the same)

Notes: supported by OS/2 v1.3+ compatibility box, which always returns AL=FFh

if DOS 4.01 SHARE was automatically loaded, file sharing is in an
  inactive state (due to the undocumented /NC flag used by the autoload
  code) until this call is made
DOS 5.0 chains to the previous handler if AL <> 00h on entry

SeeAlso: AX=1080h,INT 21/AH=52h ———-2F1040—————————– INT 2F U - DOS 4 only SHARE internal - ???

AX = 1040h
???

Return: AL = FFh??? SeeAlso: AX=1000h ———-2F1080—————————– INT 2F U - DOS 4 only SHARE internal - TURN ON FILE SHARING CHECKS

AX = 1080h

Return: AL = status

    F0h successful
    FFh checking was already on

Note: DOS 4.x SHARE has dual functions: FCB support for large (>32M) media

  and file sharing checks.  The undocumented commandline flag /NC can
  be used to disable the sharing code.

SeeAlso: AX=1000h,AX=1081h ———-2F1081—————————– INT 2F U - DOS 4 only SHARE internal - TURN OFF FILE SHARING CHECKS

AX = 1081h

Return: AL = status

    F0h successful
    FFh checking was already off

Note: (see AX=1080h) SeeAlso: AX=1000h,AX=1080h ———-2F10FF—————————– INT 2F U - Multiplex - DR-DOS 5.0 - ???

AX = 10FFh
ES:BX -> ???

Note: sets pointer in kernel ———-2F1100—————————– INT 2F - NETWORK REDIRECTOR - INSTALLATION CHECK

AX = 1100h

Return: AL = 00h not installed, OK to install

     01h  not installed, not OK to install
     FFh  installed

Notes: called by DOS 3.1+ kernel

In DOS 4.x only, the 11xx calls are all in IFSFUNC.EXE, not in the
  PC LAN Program redirector; DOS 5.0 moves the calls back into the
  redirector

———-2F1100—————————– INT 2F - MSCDEX (MS CD-ROM Extensions) - INSTALLATION CHECK

AX = 1100h
STACK: WORD DADAh

Return: AL = 00h not installed, OK to install

	STACK unchanged
   = 01h not installed, not OK to install
	STACK unchanged
   = FFh installed
	STACK: WORD ADADh

———-2F1101—————————– INT 2F U - NETWORK REDIRECTOR - REMOVE REMOTE DIRECTORY

AX = 1101h
SS = DOS DS
SDA first filename pointer -> fully-qualified directory name
SDA CDS pointer -> current directory structure for drive with dir

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful

Note: called by DOS 3.1+ kernel SeeAlso: AX=1103h,AX=1105h,INT 21/AH=3Ah,INT 21/AH=60h ———-2F1102—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - REMOVE REMOTE DIRECTORY

AX = 1102h
SS = DOS DS
SDA first filename pointer -> fully-qualified directory name
SDA CDS pointer -> current directory structure for drive with dir

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful

Note: appears to be identical to AX=1101h SeeAlso: AX=1101h ———-2F1103—————————– INT 2F U - NETWORK REDIRECTOR - MAKE REMOTE DIRECTORY

AX = 1103h
SS = DOS DS
SDA first filename pointer -> fully-qualified directory name
SDA CDS pointer -> current directory structure for drive with dir

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful

Note: called by DOS 3.1+ kernel SeeAlso: AX=1101h,AX=1105h,INT 21/AH=39h,INT 21/AH=60h ———-2F1104—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - MAKE REMOTE DIRECTORY

AX = 1104h
SS = DOS DS
SDA first filename pointer -> fully-qualified directory name
SDA CDS pointer -> current directory structure for drive with dir

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful

Note: appears to be identical to AX=1103h SeeAlso: AX=1103h ———-2F1105—————————– INT 2F U - NETWORK REDIRECTOR - CHDIR

AX = 1105h
SS = DOS DS
SDA first filename pointer -> fully-qualified directory name
SDA CDS pointer -> current directory structure for drive with dir

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    CDS updated with new path

Notes: called by DOS 3.1+ kernel

directory string in CDS should not have a terminating backslash unless
  the current directory is the root

SeeAlso: AX=1101h,AX=1103h,INT 21/AH=3Bh,INT 21/AH=60h ———-2F1106—————————– INT 2F U - NETWORK REDIRECTOR - CLOSE REMOTE FILE

AX = 1106h
ES:DI -> SFT
    SFT DPB field -> DPB of drive containing file

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    SFT updated (except handle count, which DOS manages itself)

Note: called by DOS 3.1+ kernel SeeAlso: AX=1201h,AX=1227h,INT 21/AH=3Eh ———-2F1107—————————– INT 2F U - NETWORK REDIRECTOR - COMMIT REMOTE FILE

AX = 1107h
ES:DI -> SFT
    SFT DPB field -> DPB of drive containing file

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    all buffers for file flushed
    directory entry updated

Note: called by DOS 3.1+ kernel SeeAlso: INT 21/AH=68h,INT 21/AX=5D01h ———-2F1108—————————– INT 2F U - NETWORK REDIRECTOR - READ FROM REMOTE FILE

AX = 1108h
ES:DI -> SFT
    SFT DPB field -> DPB of drive containing file
CX = number of bytes
SS = DOS DS
SDA DTA field -> user buffer

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    CX = number of bytes read (0000h = end of file)
    SFT updated

Note: called by DOS 3.1+ kernel SeeAlso: AX=1109h,AX=1229h,INT 21/AH=3Fh,INT 21/AX=5D06h ———-2F1109—————————– INT 2F U - NETWORK REDIRECTOR - WRITE TO REMOTE FILE

AX = 1109h
ES:DI -> SFT
    SFT DPB field -> DPB of drive containing file
CX = number of bytes
SS = DOS DS
SDA DTA field -> user buffer

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    CX = number of bytes written
    SFT updated

Note: called by DOS 3.1+ kernel SeeAlso: AX=1107h,AX=1108h,INT 21/AH=40h,INT 21/AX=5D06h ———-2F110A—————————– INT 2F U - NETWORK REDIRECTOR (DOS 3.x only) - LOCK REGION OF FILE

AX = 110Ah
BX = file handle
CX:DX = starting offset
SI = high word of size
STACK: WORD low word of size
ES:DI -> SFT
    SFT DPB field -> DPB of drive containing file
SS = DOS DS

Return: CF set on error

   AL = DOS error code (see INT 21/AH=59h)
STACK unchanged

Notes: called by DOS 3.10-3.31 kernel

the redirector is expected to resolve lock conflicts

SeeAlso: AX=110Bh,INT 21/AH=5Ch ———-2F110A—————————– INT 2F U - NETWORK REDIRECTOR (DOS 4+) - LOCK/UNLOCK REGION OF FILE

AX = 110Ah
BL = function
    00h lock
    01h unlock
DS:DX -> parameter block (see below)
ES:DI -> SFT
    SFT DPB field -> DPB of drive containing file
SS = DOS DS

Return: CF set on error

   AL = DOS error code (see INT 21/AH=59h)

Notes: called by DOS 4.0+ kernel

the redirector is expected to resolve lock conflicts

SeeAlso: AX=110Bh,INT 21/AH=5Ch

Format of parameter block: Offset Size Description 00h DWORD start offset 04h DWORD size of region ———-2F110B—————————– INT 2F U - NETWORK REDIRECTOR (DOS 3.x only) - UNLOCK REGION OF FILE

AX = 110Bh
BX = file handle
CX:DX = starting offset
SI = high word of size
STACK: WORD low word of size
ES:DI -> SFT for file
    SFT DPB field -> DPB of drive containing file

Return: CF set on error

   AL = DOS error code (see INT 21/AH=59h)
STACK unchanged

Note: called by DOS 3.1-3.31 kernel; DOS 4.0+ calls AX=110Ah instead SeeAlso: AX=110Ah,INT 21/AH=5Ch ———-2F110C—————————– INT 2F U - NETWORK REDIRECTOR - GET DISK SPACE

AX = 110Ch
ES:DI -> current directory structure for desired drive

Return: AL = sectors per cluster

AH = media ID byte
BX = total clusters
CX = bytes per sector
DX = number of available clusters

Note: called by DOS 3.1+ kernel SeeAlso: INT 21/AH=36h ———-2F110D—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 110Dh
SDA first filename pointer -> name of file
???

Return: ??? Note: appears to be similar to AX=110Fh SeeAlso: AX=110Fh ———-2F110E—————————– INT 2F U - NETWORK REDIRECTOR - SET REMOTE FILE'S ATTRIBUTES

AX = 110Eh
SS = DOS DS
SDA first filename pointer -> fully-qualified name of file
SDA CDS pointer -> current directory structure for drive with file
STACK: WORD new file attributes

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
STACK unchanged

Note: called by DOS 3.1+ kernel SeeAlso: AX=110Fh,INT 21/AX=4301h,INT 21/AH=60h ———-2F110F—————————– INT 2F U - NETWORK REDIRECTOR - GET REMOTE FILE'S ATTRIBUTES AND SIZE

AX = 110Fh
SS = DOS DS
SDA first filename pointer -> fully-qualified name of file
SDA CDS pointer -> current directory structure for drive with file

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    AX = file attributes
    BX:DI = file size

Note: called by DOS 3.1+ kernel SeeAlso: AX=110Eh,INT 21/AX=4300h,INT 21/AH=60h ———-2F1110—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 1110h
SDA first filename pointer -> name of file
???

Return: ??? Note: appears to be similar to AX=110Eh SeeAlso: AX=110Eh ———-2F1111—————————– INT 2F U - NETWORK REDIRECTOR - RENAME REMOTE FILE

AX = 1111h
SS = DS = DOS DS
SDA first filename pointer = offset of fully-qualified old name
SDA second filename pointer = offset of fully-qualified new name
SDA CDS pointer -> current directory structure for drive with file

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful

Note: called by DOS 3.1+ kernel SeeAlso: INT 21/AH=56h,INT 21/AH=60h ———-2F1112—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 1112h
SS = DS = DOS DS
SDA first filename pointer -> name of file
???

Return: ??? SeeAlso: AX=1111h ———-2F1113—————————– INT 2F U - NETWORK REDIRECTOR - DELETE REMOTE FILE

AX = 1113h
SS = DS = DOS DS
SDA first filename pointer -> fully-qualified filename in DOS DS
SDA CDS pointer -> current directory structure for drive with file

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful

Notes: called by DOS 3.1+ kernel

the filespec may contain wildcards

SeeAlso: INT 21/AH=41h,INT 21/AH=60h ———-2F1114—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 1114h
SDA first filename pointer -> name of file
???

Return: ??? SeeAlso: AX=1113h ———-2F1115—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 1115h
SS = DOS DS
ES:DI -> SFT ???
???

Return: ??? SeeAlso: AX=112Eh ———-2F1116—————————– INT 2F U - NETWORK REDIRECTOR - OPEN EXISTING REMOTE FILE

AX = 1116h
ES:DI -> uninitialized SFT
SS = DOS DS
SDA first filename pointer -> fully-qualified name of file to open
STACK: WORD file open mode (see INT 21/AH=3Dh)

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    SFT filled (except handle count, which DOS manages itself)
STACK unchanged

Note: called by DOS 3.1+ kernel SeeAlso: AX=1106h,AX=1117h,AX=1118h,AX=112Eh,INT 21/AH=3Dh,INT 21/AH=60h ———-2F1117—————————– INT 2F U - NETWORK REDIRECTOR - CREATE/TRUNCATE REMOTE FILE

AX = 1117h
ES:DI -> uninitialized SFT
SS = DOS DS
SDA first filename pointer -> fully-qualified name of file to open
SDA CDS pointer -> current directory structure for drive with file
STACK: WORD file creation mode
		low byte = file attributes
		high byte = 00h normal create, 01h create new file

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    SFT filled (except handle count, which DOS manages itself)
STACK unchanged

Note: called by DOS 3.1+ kernel SeeAlso: AX=1106h,AX=1116h,AX=1118h,AX=112Eh,INT 21/AH=3Ch,INT 21/AH=60h ———-2F1118—————————– INT 2F U - NETWORK REDIRECTOR - CREATE/TRUNCATE FILE WITHOUT CDS

AX = 1118h
ES:DI -> uninitialized SFT
SS = DOS DS
SDA first filename pointer -> fully-qualified name of file
STACK: WORD file creation mode
		low byte = file attributes
		high byte = 00h normal create, 01h create new file

Return: ???

STACK unchanged

Note: called by DOS 3.1+ kernel when creating a file on a drive for which the

  SDA CDS pointer has offset FFFFh

SeeAlso: AX=1106h,AX=1116h,AX=1117h,AX=112Eh,INT 21/AH=60h ———-2F1119—————————– INT 2F U - NETWORK REDIRECTOR - FIND FIRST FILE WITHOUT CDS

AX = 1119h
SS = DS = DOS DS
[DTA] = uninitialized 21-byte findfirst search data (see INT 21/AH=4Eh)
SDA first filename pointer -> fully-qualified search template
SDA search attribute = attribute mask for search

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    [DTA] = updated findfirst search data
	    (bit 7 of first byte must be set)
    [DTA+15h] = standard directory entry for file

Notes: called by DOS 3.1+ kernel

DOS 4.x IFSFUNC returns CF set, AX=0003h	

———-2F111A—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 111Ah
???

Return: CF set

    AX = error code (03h for DOS 4.01 IFSFUNC)

———-2F111B—————————– INT 2F U - NETWORK REDIRECTOR - FINDFIRST

AX = 111Bh
SS = DS = DOS DS
[DTA] = uninitialized 21-byte findfirst search data (see INT 21/AH=4Eh)
SDA first filename pointer -> fully-qualified search template
SDA CDS pointer -> current directory structure for drive with file
SDA search attribute = attribute mask for search

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    [DTA] = updated findfirst search data
	    (bit 7 of first byte must be set)
    [DTA+15h] = standard directory entry for file

Note: called by DOS 3.1+ kernel SeeAlso: AX=111Ch,INT 21/AH=4Eh,INT 21/AH=60h ———-2F111C—————————– INT 2F U - NETWORK REDIRECTOR - FINDNEXT

AX = 111Ch
SS = DS = DOS DS
[DTA] = 21-byte findfirst search data (see INT 21/AH=4Eh)

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful
    [DTA] = updated findfirst search data
	    (bit 7 of first byte must be set)
    [DTA+15h] = standard directory entry for file

Note: called by DOS 3.1+ kernel SeeAlso: AX=111Bh,INT 21/AH=4Fh ———-2F111D—————————– INT 2F U - NETWORK REDIRECTOR - CLOSE ALL REMOTE FILES FOR PROCESS

AX = 111Dh
DS???
SS = DOS DS

Return: ??? Notes: called by DOS 3.1+ kernel

closes all FCBs opened by process

———-2F111E—————————– INT 2F U - NETWORK REDIRECTOR - DO REDIRECTION

AX = 111Eh
SS = DOS DS
STACK: WORD function to execute
	5F00h  get redirection mode
		BL = type (03h printer, 04h disk)
		Return: BH = state (00h off, 01h on)
	5F01h  set redirection mode
		BL = type (03h printer, 04h disk)
		BH = state (00h off, 01h on)
	5F02h  get redirection list entry
		BX = redirection list index
		DS:SI -> 16-byte local device name buffer
		ES:DI -> 128-byte network name buffer
		Return: must set user's BX to device type and CX to
			stored parameter value, using AX=1218h to get
			stack frame address
	5F03h  redirect device
		BL = device type (see INT 21/AX=5F03h)
		CX = stored parameter value
		DS:SI -> ASCIZ source device name
		ES:DI -> destination ASCIZ network path + ASCIZ passwd
	5F04h  cancel redirection
		DS:SI -> ASCIZ device name or network path
	5F05h  get redirection list extended entry
		BX = redirection list index
		DS:SI -> buffer for ASCIZ source device name
		ES:DI -> buffer for destination ASCIZ network path
		Return: BH = status flag
			BL = type (03h printer, 04h disk)
			CX = stored parameter value
			BP = NETBIOS local session number
	5F06h  similar to 5F05h???

Return: CF set on error

    AX = error code (see INT 21/AH=59h)
STACK unchanged

Note: called by DOS 3.1+ kernel SeeAlso: INT 21/AX=5F00h,INT 21/AX=5F01h,INT 21/AX=5F02h,INT 21/AX=5F03h SeeAlso: INT 21/AX=5F04h,INT 21/AX=5F05h,INT 21/AX=5F06h ———-2F111F—————————– INT 2F U - NETWORK REDIRECTOR - PRINTER SETUP

AX = 111Fh
STACK: WORD function
	5E02h  set printer setup
	5E03h  get printer setup
	5E04h  set printer mode
	5E05h  get printer mode

Return: CF set on error

    AX = error code (see INT 21/AH=59h)
STACK unchanged

Note: called by DOS 3.1+ kernel SeeAlso: INT 21/AX=5E02h,INT 21/AX=5E03h,INT 21/AX=5E04h,INT 21/AX=5E05h ———-2F1120—————————– INT 2F U - NETWORK REDIRECTOR - FLUSH ALL DISK BUFFERS

AX = 1120h
DS = DOS DS
???

Return: CF clear (successful) Notes: called by DOS 3.1+ kernel

uses CDS array pointer and LASTDRIVE= entries in DOS list of lists

SeeAlso: INT 21/AH=0Dh,INT 21/AX=5D01h ———-2F1121—————————– INT 2F U - NETWORK REDIRECTOR - SEEK FROM END OF REMOTE FILE

AX = 1121h
CX:DX = offset (in bytes) from end
ES:DI -> SFT
    SFT DPB field -> DPB of drive with file
SS = DOS DS

Return: CF set on error

    AL = DOS error code (see INT 21/AH=59h)
CF clear if successful
    DX:AX = new file position

Note: called by DOS 3.1+ kernel SeeAlso: AX=1228h,INT 21/AH=42h ———-2F1122—————————– INT 2F U - NETWORK REDIRECTOR - PROCESS TERMINATION HOOK

AX = 1122h
SS = DOS DS
???

Return: ??? Note: called by DOS 3.1+ kernel ———-2F1123—————————– INT 2F U - NETWORK REDIRECTOR - QUALIFY REMOTE FILENAME

AX = 1123h
DS:SI -> ASCIZ filename to canonicalize
ES:DI -> 128-byte buffer for qualified name

Return: CF set if not resolved Notes: called by MSDOS 3.1+ kernel, but not called by DRDOS 5.0 unless the

  filename matches the name of a character device
called first when DOS attempts to resolve a filename (unless inside an
  AX=5D00h server call); if this fails, DOS resolves the name locally

SeeAlso: AX=1221h,INT 21/AH=60h ———-2F1124—————————– INT 2F U - NETWORK REDIRECTOR - PRINTER OFF???

AX = 1124h
ES:DI -> SFT
SS = DOS DS
???

Return: CX = ??? Note: called by DOS 3.1+ kernel if AX=1126h returns CF set SeeAlso: AX=1126h ———-2F1125—————————– INT 2F U - NETWORK REDIRECTOR - REDIRECTED PRINTER MODE

AX = 1125h
STACK: WORD subfunction
	5D07h get print stream state
		Return: DL = current state
	5D08h set print stream state
		DL = new state
	5D09h finish print job

Return: CF set on error

    AX = error code (see INT 21/AH=59h)
STACK unchanged

Note: called by DOS 3.1+ kernel SeeAlso: INT 21/AX=5D07h,INT 21/AX=5D08h,INT 21/AX=5D09h ———-2F1126—————————– INT 2F U - NETWORK REDIRECTOR - PRINTER ON/OFF???

AX = 1126h
ES:DI -> SFT for file handle 4???
SS = DOS DS???
???

Return: CF set on error Notes: called by DOS 3.1+ kernel

called when print echoing (^P, ^PrtSc) changes state and STDPRN has
  bit 11 of the device information word in the SFT set

SeeAlso: AX=1124h ———-2F1127—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - UNUSED

AX = 1127h

Return: CF set

    AX = 0001h (invalid function) (see INT 21/AH=59h)

———-2F1128—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - UNUSED

AX = 1128h

Return: CF set

    AX = 0001h (invalid function) (see INT 21/AH=59h)

———-2F1129—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - UNUSED

AX = 1129h

Return: CF set

    AX = 0001h (invalid function) (see INT 21/AH=59h)

———-2F112A—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 112Ah
DS = DOS DS
???

Return: ??? Note: does something to each IFS driver ———-2F112B—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - GENERIC IOCTL???

AX = 112Bh
SS = DOS DS
CX = function/category
DS:DX -> parameter block
STACK: WORD value of AX on entry to INT 21 (440Ch or 440Dh)
???

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful

Note: called by DOS 4.0 kernel ———-2F112C—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 112Ch
SS = DOS DS
SDA current SFT pointer -> SFT for file
???

Return: CF set on error ———-2F112D—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 112Dh
BL = subfunction (value of AL on INT 21)
    04h truncate open file to zero length
	ES:DI -> SFT for file
	Return: CF clear
    else ???
	Return: CX = ??? (00h or 02h for DOS 4.01)
ES:DI -> SFT
SS = DOS DS

Return: DS = DOS DS Note: called by DOS 4.0 kernel on INT 21/AX=5702h,INT 21/AX=5703h,

  INT 21/AX=5704h

———-2F112E—————————– INT 2F U - NETWORK REDIRECTOR (DOS 4+) - EXTENDED OPEN/CREATE FILE

AX = 112Eh
SS = DS = DOS DS
ES:DI -> uninitialized SFT for file
STACK: WORD file attribute for created/truncated file
		low byte = file attributes
		high byte = 00h normal create/open, 01h create new file
SDA first filename pointer -> fully-qualified filename
SDA extended file open action = action code (see INT 21/AX=6C00h)
SDA extended file open mode = open mode for file (see INT 21/AX=6C00h)

Return: CF set on error

    AX = error code
CF clear if successful
    CX = result code
	01h file opened
	02h file created
	03h file replaced (truncated)
    SFT initialized (except handle count, which DOS manages itself)

Note: called by DOS 4.0 kernel SeeAlso: AX=1115h,AX=1116h,AX=1117h,INT 21/AX=6C00h ———-2F112F—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - ???

AX = 112Fh
SS = DOS DS
STACK: WORD function in low byte
	00h ???
	    DS:SI -> Current Directory Structure???
	    CL = drive (1=A:)
	01h ???
	    DS:SI -> ???
	    CL = file handle???
	02h ???
	    DS:SI -> Current Directory Structure???
	    DI = ???
	    CX = drive (1=A:)
???

Return: CF set on error

    AX = DOS error code (see INT 21/AH=59h)
CF clear if successful

Note: called by DOS 4.0 kernel SeeAlso: INT 21/AH=6Bh ———-2F1130—————————– INT 2F U - IFSFUNC.EXE (DOS 4.x only) - GET IFSFUNC SEGMENT

AX = 1130h

Return: ES = CS of resident IFSFUNC ———-2F1186—————————– INT 2F - LAN Manager Enhanced DOS API - DosReadAsynchNmPipe

AX = 1186h
???

Return: ??? Note: LAN Manager enhance mode adds features beyond the standard redirector

  file/printer services

SeeAlso: AX=118Fh,INT 21/AX=5F39h ———-2F118A—————————– INT 2F - LAN Manager 2.0 DOS Enhanced ENCRYPT.EXE - STREAM ENCRYPTION SERVICE

AX = 118Ah
???

Return: ??? SeeAlso: AX=1186h,AH=41h,AH=42h,AH=4Bh ———-2F118F—————————– INT 2F - LAN Manager Enhanced DOS API - DosWriteAsynchNmPipe

AX = 118Fh
???

Return: ??? SeeAlso: AX=1186h,INT 21/AX=5F3Ah ———-2F1200—————————– INT 2F U - DOS 3+ internal - INSTALLATION CHECK

AX = 1200h

Return: AL = FFh (for compatibility with other INT 2F functions) ———-2F1201—————————– INT 2F U - DOS 3+ internal - CLOSE CURRENT FILE

AX = 1201h
SS = DOS DS
SDA current SFT pointer -> SFT of file to close

Return: CF set on error

BX???
CX new reference count of SFT
ES:DI -> SFT for file

SeeAlso: AX=1106h,AX=1227h,INT 21/AH=3Eh ———-2F1202—————————– INT 2F U - DOS 3+ internal - GET INTERRUPT ADDRESS

AX = 1202h
STACK: WORD vector number

Return: ES:BX → interrupt vector

STACK unchanged

———-2F1203—————————– INT 2F U - DOS 3+ internal - GET DOS DATA SEGMENT

AX = 1203h

Return: DS = segment of IBMDOS.COM/MSDOS.SYS ———-2F1204—————————– INT 2F U - DOS 3+ internal - NORMALIZE PATH SEPARATOR

AX = 1204h
STACK: WORD character to normalize

Return: AL = normalized character (forward slash turned to backslash, all

	others unchanged)
ZF set if path separator
STACK unchanged

———-2F1205—————————– INT 2F U - DOS 3+ internal - OUTPUT CHARACTER TO STANDARD OUTPUT

AX = 1205h
STACK: WORD character to output

Return: STACK unchanged Note: can be called only from within DOS ———-2F1206—————————– INT 2F U - DOS 3+ internal - INVOKE CRITICAL ERROR

AX = 1206h
DI = error code
BP:SI -> device driver header
SS = DOS DS
STACK: WORD value to be passed to INT 24 in AX

Return: AL = 0-3 for Abort, Retry, Ignore, Fail

STACK unchanged

SeeAlso: INT 24 ———-2F1207—————————– INT 2F U - DOS 3+ internal - MAKE DISK BUFFER MOST-RECENTLY USED

AX = 1207h
DS:DI -> disk buffer

Return: nothing Notes: can be called only from within DOS

buffer is moved to end of buffer list (least-recently used is first)

SeeAlso: AX=120Fh ———-2F1208—————————– INT 2F U - DOS 3+ internal - DECREMENT SFT REFERENCE COUNT

AX = 1208h
ES:DI -> SFT

Return: AX = original value of reference count Note: if the reference count was 1, it is set to FFFFh (since 0 indicates

  that the SFT is not in use).	It is the caller's responsibility to
  set the reference count to zero after cleaning up.

———-2F1209—————————– INT 2F U - DOS 3+ internal - FLUSH AND FREE DISK BUFFER

AX = 1209h
DS:DI -> disk buffer

Return: disk buffer marked unused, contents written to disk if buffer dirty Note: can be called only from within DOS SeeAlso: AX=120Eh,AX=1215h ———-2F120A—————————– INT 2F U - DOS 3+ internal - PERFORM CRITICAL ERROR INTERRUPT

AX = 120Ah
DS = SS = DOS DS
STACK: WORD extended error code

Return: AL = user response (0=ignore, 1=retry, 2=abort, 3=fail)

CF clear if retry, set otherwise
STACK unchanged

Notes: can only be called during a DOS function call, as it uses various

  fields in the SDA to set up the registers for the INT 24
reportedly sets current DPB's first root directory sector to 1

SeeAlso: INT 24 ———-2F120B—————————– INT 2F U - DOS 3+ internal - SIGNAL SHARING VIOLATION TO USER

AX = 120Bh
ES:DI -> system file table entry for previous open of file
STACK: WORD extended error code (should be 20h--sharing violation)

Return: CF clear if operation should be retried

CF set if operation should not be retried
    AX = error code (20h) (see INT 21/AH=59h)
STACK unchanged

Notes: can only be called during a DOS function call

should only be called if an attempt was made to open an already-open
  file contrary to the sharing rules
invokes INT 24 if SFT file opened via FCB or in compatibility mode with
  inheritance allowed

———-2F120C—————————– INT 2F U - DOS 3+ internal - OPEN DEVICE AND SET SFT OWNER???

AX = 120Ch
SDA current SFT pointer -> SFT for file
DS = SS = DOS DS

Return: ES, DI, AX destroyed Notes: invoked “device open” call on device driver for SFT

changes owner of last-accessed SFT to calling process if it was opened
  via FCB
called by network redirectors

———-2F120D—————————– INT 2F U - DOS 3+ internal - GET DATE AND TIME

AX = 120Dh
SS = DOS DS

Return: AX = current date in packed format (see INT 21/AX=5700h)

DX = current time in packed format (see INT 21/AX=5700h)

SeeAlso: INT 21/AH=2Ah,INT 21/AH=2Ch ———-2F120E—————————– INT 2F U - DOS 3+ internal - MARK ALL DISK BUFFERS UNREFERENCED

AX = 120Eh
SS = DOS DS

Return: DS:DI → first disk buffer Note: clears “referenced” flag on all disk buffers SeeAlso: AX=1209h,AX=1210h,INT 21/AH=0Dh ———-2F120F—————————– INT 2F U - DOS 3+ internal - MAKE BUFFER MOST RECENTLY USED

AX = 120Fh
DS:DI -> disk buffer
SS = DOS DS

Return: DS:DI → next buffer in buffer list Note: indicated buffer moved to end of chain SeeAlso: AX=1207h ———-2F1210—————————– INT 2F U - DOS 3+ internal - FIND UNREFERENCED DISK BUFFER

AX = 1210h
DS:DI -> first disk buffer to check

Return: ZF clear if found

    DS:DI -> first unreferenced disk buffer
ZF set if not found

SeeAlso: AX=120Eh ———-2F1211—————————– INT 2F U - DOS 3+ internal - NORMALIZE ASCIZ FILENAME

AX = 1211h
DS:SI -> ASCIZ filename to normalize
ES:DI -> buffer for normalized filename

Return: destination buffer filled with uppercase filename, with slashes turned

to backslashes

SeeAlso: AX=121Eh,AX=1221h ———-2F1212—————————– INT 2F U - DOS 3+ internal - GET LENGTH OF ASCIZ STRING

AX = 1212h
ES:DI -> ASCIZ string

Return: CX = length of string SeeAlso: AX=1225h ———-2F1213—————————– INT 2F U - DOS 3+ internal - UPPERCASE CHARACTER

AX = 1213h
STACK: WORD character to convert to uppercase

Return: AL = uppercase character

STACK unchanged

———-2F1214—————————– INT 2F U - DOS 3+ internal - COMPARE FAR POINTERS

AX = 1214h
DS:SI = first pointer
ES:DI = second pointer

Return: ZF set if pointers are equal, ZF clear if not equal ———-2F1215—————————– INT 2F U - DOS 3+ internal - FLUSH BUFFER

AX = 1215h
DS:DI -> disk buffer
SS = DOS DS
STACK: WORD drives for which to skip buffer
	ignore buffer if drive same as high byte, or bytes differ and
	the buffer is for a drive OTHER than that given in low byte

Return: STACK unchanged Note: can be called only from within DOS SeeAlso: AX=1209h ———-2F1216—————————– INT 2F U - DOS 3+ internal - GET ADDRESS OF SYSTEM FILE TABLE

AX = 1216h
BX = system file table entry number

Return: CF clear if successful

    ES:DI -> system file table entry
CF set if BX greater than FILES=

SeeAlso: AX=1220h ———-2F1217—————————– INT 2F U - DOS 3+ internal - GET CURRENT DIRECTORY STRUCTURE FOR DRIVE

AX = 1217h
SS = DOS DS
STACK: WORD drive (0 = A:, 1 = B:, etc)

Return: CF set on error

    (drive > LASTDRIVE)
CF clear if successful
    DS:SI -> current directory structure for specified drive
STACK unchanged

SeeAlso: AX=1219h ———-2F1218—————————– INT 2F U - DOS 3+ internal - GET CALLER'S REGISTERS

AX = 1218h

Return: DS:SI → saved caller's AX,BX,CX,DX,SI,DI,BP,DS,ES (on stack) Note: only valid while within DOS ———-2F1219—————————– INT 2F U - DOS 3+ internal - SET DRIVE???

AX = 1219h
SS = DOS DS
STACK: WORD drive (0 = default, 1 = A:, etc)

Return: ???

STACK unchanged

Notes: calls AX=1217h

builds a current directory structure if inside server call
  (INT 21/AX=5D00h)

SeeAlso: AX=1217h,AX=121Fh ———-2F121A—————————– INT 2F U - DOS 3+ internal - GET FILE'S DRIVE

AX = 121Ah
DS:SI -> filename

Return: AL = drive (0 = default, 1 = A:, etc, FFh = invalid)

DS:SI -> filename without leading X: (if present)

SeeAlso: INT 21/AH=19h,INT 21/AH=60h ———-2F121B—————————– INT 2F U - DOS 3+ internal - SET YEAR/LENGTH OF FEBRUARY

AX = 121Bh
CL = year - 1980

Return: AL = number of days in February Note: requires DS to be set to the DOS code segment SeeAlso: INT 21/AH=2Bh ———-2F121C—————————– INT 2F U - DOS 3+ internal - CHECKSUM MEMORY

AX = 121Ch
DS:SI -> start of memory to checksum
CX = number of bytes
DX = initial checksum
SS = DOS DS

Return: AX, CX destroyed

DX = checksum
DS:SI -> first byte after checksummed range

Note: used by DOS to determine day count since 1/1/80 given a date SeeAlso: AX=121Dh ———-2F121D—————————– INT 2F U - DOS 3+ internal - SUM MEMORY

AX = 121Dh
DS:SI -> memory to add up
CX = 0000h
DX = limit

Return: AL = byte which exceeded limit

CX = number of bytes before limit exceeded
DX = remainder after adding first CX bytes
DS:SI -> byte beyond the one which exceeded the limit

Note: used by DOS to determine year or month given day count since 1/1/80 SeeAlso: AX=121Ch ———-2F121E—————————– INT 2F U - DOS 3+ internal - COMPARE FILENAMES

AX = 121Eh
DS:SI -> first ASCIZ filename
ES:DI -> second ASCIZ filename

Return: ZF set if filenames equivalent, ZF clear if not SeeAlso: AX=1211h,AX=1221h ———-2F121F—————————– INT 2F U - DOS 3+ internal - BUILD CURRENT DIRECTORY STRUCTURE

AX = 121Fh
SS = DOS DS
STACK: WORD drive letter

Return: ES:DI → current directory structure (will be overwritten by next call)

STACK unchanged

———-2F1220—————————– INT 2F U - DOS 3+ internal - GET JOB FILE TABLE ENTRY

AX = 1220h
BX = file handle

Return: CF set on error

    AL = 6 (invalid file handle)
CF clear if successful
    ES:DI -> JFT entry for file handle in current process

Note: the byte pointed at by ES:DI contains the number of the SFT for the

  file handle, or FFh if the handle is not open

SeeAlso: AX=1216h,AX=1229h ———-2F1221—————————– INT 2F U - DOS 3+ internal - CANONICALIZE FILE NAME

AX = 1221h
DS:SI -> file name to be fully qualified
ES:DI -> 128-byte buffer for resulting canonical file name
SS = DOS DS

Return: (see INT 21/AH=60h) Note: identical to INT 21/AH=60h SeeAlso: AX=1123h,INT 21/AH=60h ———-2F1222—————————– INT 2F U - DOS 3+ internal - SET EXTENDED ERROR INFO

AX = 1222h
SS = DOS data segment
SS:SI -> 4-byte records
	BYTE	error code, FFh = last record
	BYTE	error class, FFh = don't change
	BYTE	suggested action, FFh = don't change
	BYTE	error locus, FFh = don't change
SDA error code set

Return: SI destroyed

SDA error class, error locus, and suggested action fields set

Note: can be called only from within DOS SeeAlso: AX=122Dh,INT 21/AH=59h ———-2F1223—————————– INT 2F U - DOS 3+ internal - CHECK IF CHARACTER DEVICE

AX = 1223h
SDA+218h (DOS 3.10-3.30) = eight-character blank-padded name
SDA+22Bh (DOS 4.0x) = eight-character blank-padded name

Return: CF set if no character device by that name found

CF clear if found
    BH = low byte of device attribute word

Note: can only be called from within DOS (assumes DS=SS=DOS DS) SeeAlso: INT 21/AX=5D06h,INT 21/AX=5D0Bh ———-2F1224—————————– INT 2F U - DOS 3+ internal - DELAY

AX = 1224h
SS = DOS DS

Return: after delay set by INT 21/AX=440Bh, unless in server call

  (INT 21/AX=5D00h)

Note: delay is dependent on the processor speed, and is skipped entirely if

  inside a server call

SeeAlso: INT 21/AX=440Bh,INT 21/AH=52h ———-2F1225—————————– INT 2F U - DOS 3+ internal - GET LENGTH OF ASCIZ STRING

AX = 1225h
DS:SI -> ASCIZ string

Return: CX = length of string SeeAlso: AX=1212h ———-2F1226—————————– INT 2F U - DOS 3.3+ internal - OPEN FILE

AX = 1226h
CL = access mode
DS:DX -> ASCIZ filename

Return: CF set on error

    AL = error code (see INT 21/AH=59h)
CF clear if successful
    AX = file handle

Notes: can only be called from within DOS (assumes SS=DOS DS)

equivalent to INT 21/AH=3Dh	

SeeAlso: AX=1227h,INT 21/AH=3Dh ———-2F1227—————————– INT 2F U - DOS 3.3+ internal - CLOSE FILE

AX = 1227h
BX = file handle

Return: CF set on error

    AL = 06h invalid file handle
CF clear if successful

Notes: can only be called from within DOS (assumes SS=DOS DS)

equivalent to INT 21/AH=3Eh

SeeAlso: AX=1106h,AX=1201h,AX=1226h,INT 21/AH=3Eh ———-2F1228BP4200———————– INT 2F U - DOS 3.3+ internal - MOVE FILE POINTER

AX = 1228h
BP = 4200h, 4201h, 4202h (see INT 21/AH=42h)
BX = file handle
CX:DX = offset in bytes
SS = DOS DS

Return: as for INT 21/AH=42h Notes: equivalent to INT 21/AH=42h, but may only be called from inside a DOS

  function call
sets user stack frame pointer to dummy buffer, moves BP to AX, performs
  LSEEK, and restores frame pointer

SeeAlso: INT 21/AH=42h ———-2F1229—————————– INT 2F U - DOS 3.3+ internal - READ FROM FILE

AX = 1229h
BX = file handle
CX = number of bytes to read
DS:DX -> buffer
SS = DOS DS

Return: as for INT 21/AH=3Fh Note: equivalent to INT 21/AH=3Fh, but may only be called when already inside

  a DOS function call

SeeAlso: AX=1226h,INT 21/AH=3Fh ———-2F122A—————————– INT 2F U - DOS 3.3+ internal - SET FASTOPEN ENTRY POINT

AX = 122Ah
BX = entry point to set (0001h or 0002h)
DS:SI -> FASTOPEN entry point
	(entry point not set if SI = FFFFh for DOS 4+)

Return: CF set if specified entry point already set Notes: entry point in BX is ignored under DOS 3.30

both entry points set to same handler by DOS 4.01

DOS 3.30+ FASTOPEN is called with:

AL = 01h  ???
    CX = ??? seems to be offset
    DI = ??? seems to be offset
    SI = offset in DOS DS of filename
AL = 02h  ???
AL = 03h  open file???
    SI = offset in DOS DS of filename
AL = 04h  ???
    AH = subfunction (00h,01h,02h)
    ES:DI -> ???
    CX = ??? (subfunctions 01h and 02h only)

Returns: CF set on error or not installed Note: function 03h calls function 01h first

PCDOS 4.01 FASTOPEN is additionally called with:

AL = 04h ???
    AH = 03h
    ???
AL = 05h ???
AL = 0Bh ???
AL = 0Ch ???
AL = 0Dh ???
AL = 0Eh ???
AL = 0Fh ???
AL = 10h ???

MSDOS 5.0 FASTOPEN is additionally called with:

AL = 04h ???
    AH = 03h
    ???
AL = 05h ???
    DL = drive (00h = A:)
    ???
AL = 06h ???

———-2F122B—————————– INT 2F U - DOS 3.3+ internal - IOCTL

AX = 122Bh
BP = 44xxh
SS = DOS DS
additional registers as appropriate for INT 21/AX=44xxh

Return: as for INT 21/AH=44h Notes: equivalent to INT 21/AH=44h, but may only be called when already inside

  a DOS function call
sets user stack frame pointer to dummy buffer, moves BP to AX, performs
  IOCTL, and restores frame pointer

SeeAlso: INT 21/AH=44h ———-2F122C—————————– INT 2F U - DOS 3.3+ internal - GET DEVICE CHAIN

AX = 122Ch

Return: BX:AX → header of second device driver (NUL is first) in driver chain SeeAlso: INT 21/AH=52h ———-2F122D—————————– INT 2F U - DOS 3.3+ internal - GET EXTENDED ERROR CODE

AX = 122Dh

Return: AX = current extended error code SeeAlso: AX=1222h,INT 21/AH=59h ———-2F122E—————————– INT 2F U - DOS 4+ internal - GET OR SET ERROR TABLE ADDRESSES

AX = 122Eh
DL = subfunction
    00h get standard DOS error table (errors 00h-12h,50h-5Bh)
	Return: ES:DI -> error table
    01h set standard DOS error table
	ES:DI -> error table
    02h get parameter error table (errors 00h-0Ah)
	Return: ES:DI -> error table
    03h set parameter error table
	ES:DI -> error table
    04h get critical/SHARE error table (errors 13h-2Bh)
	Return: ES:DI -> error table
    05h set critical/SHARE error table
	ES:DI -> error table
    06h get ??? error table
	Return: ES:DI -> error table or 0000h:0000h
    07h set ??? error table
	ES:DI -> error table
    08h get error message retriever (see below)
	Return: ES:DI -> FAR procedure to fetch error message 
    09h set ??? error table
	ES:DI -> error table

Notes: if the returned segment on a “get” is 0001h, then the offset specifies

  the offset of the error message table within COMMAND.COM, and the
  procedure returned by DL=08h should be called
DOS 5.0 COMMAND.COM does not allow setting any of the addresses; they
  are always returned with segment 0001h

SeeAlso: AX=0500h,INT 21/AH=59h

Format of DOS 4.x error table: Offset Size Description 00h BYTE FFh 01h 2 BYTEs 04h,00h (DOS version???) 03h BYTE number of error headers following 04h 2N WORDs table of all error headers for table

	Offset	Size	Description
	 00h	WORD	error message number
	 02h	WORD	offset of error message from start of header
			error messages are count byte followed by msg

Note: DOS 5 error tables consist of one word per error number; each word

  contains either the offset of a counted string or 0000h

Call error retrieval function with:

AX = error number
DI = offset of error table

Return: ES:DI → error message (counted string) Notes: this function needs to access COMMAND.COM if the messages were not

  loaded into memory permanently with /MSG; the caller should assume
  that the returned message will be overwritten by the next call of
  the function
supported by DR-DOS 5.0

———-2F122F—————————– INT 2F U - DOS 4+ internal - SET DOS VERSION NUMBER TO RETURN

AX = 122Fh
DX = DOS version number (0000h = return true DOS version)

Note: not available under DR-DOS 5.0 SeeAlso: INT 21/AH=30h ———-2F13——————————- INT 2F U - DOS 3.2+ - SET DISK INTERRUPT HANDLER

AH = 13h
DS:DX -> interrupt handler disk driver calls on read/write
ES:BX = address to restore INT 13 to on system halt (exit from root
	 shell) or warm boot (INT 19)

Return: DS:DX from previous invocation of this function

ES:BX from previous invocation of this function

Notes: IO.SYS hooks INT 13 and inserts one or more filters ahead of the

  original INT 13 handler.  The first is for disk change detection
  on floppy drives, the second is for tracking formatting calls and
  correcting DMA boundary errors, the third is for working around
  problems in a particular version of IBM's ROM BIOS
before the first call, ES:BX points at the original BIOS INT 13; DS:DX
  also points there unless IO.SYS has installed a special filter for
  hard disk reads (on systems with model byte FCh and BIOS date
  "01/10/84" only), in which case it points at the special filter
most DOS 3.3+ disk access is via the vector in DS:DX, although a few
  functions are still invoked via an INT 13 instruction
this is a dangerous security loophole for any virus-monitoring software
  which does not trap this call (many Bulgarian viruses are known to
  use it to get the original ROM entry point)

SeeAlso: INT 13/AH=01h,INT 19 ———-2F1400—————————– INT 2F - NLSFUNC.COM - INSTALLATION CHECK

AX = 1400h

Return: AL = 00h not installed, OK to install

     01h not installed, not OK
     FFh installed

Notes: called by DOS v3.3+ kernel

supported by OS/2 v1.3+ compatibility box, which always returns AL=FFh
supported by DR-DOS 5.0
documented for MS-DOS 5.0, but undocumented in prior versions

———-2F1401—————————– INT 2F U - NLSFUNC.COM - CHANGE CODE PAGE

AX = 1401h
DS:SI -> internal code page structure (see below)
BX = new code page
DX = country code???

Return: AL = status

     00h successful
     else DOS error code

Note: called by DOS v3.3+ kernel SeeAlso: INT 21/AH=66h

Format of DOS 3.30 internal code page structure: Offset Size Description 00h 8 BYTEs ??? 08h 64 BYTEs name of country information file 48h WORD system code page 4Ah WORD number of supported subfunctions 4Ch 5 BYTEs data to return for INT 21/AX=6502h 51h 5 BYTEs data to return for INT 21/AX=6504h 56h 5 BYTEs data to return for INT 21/AX=6505h 5Bh 5 BYTEs data to return for INT 21/AX=6506h 60h 41 BYTEs data to return for INT 21/AX=6501h ———-2F1402—————————– INT 2F U - NLSFUNC.COM - GET COUNTRY INFO

AX = 1402h
BP = subfunction (same as AL for INT 21/AH=65h)
BX = code page
DX = country code
DS:SI -> internal code page structure (see AX=1401h)
ES:DI -> user buffer
CX = size of user buffer

Return: AL = status

    00h successful
    else DOS error code

Notes: called by DOS v3.3+ kernel on INT 21/AH=65h

code page structure apparently only needed for COUNTRY.SYS pathname

SeeAlso: AX=1403h,AX=1404h,INT 21/AH=65h ———-2F1403—————————– INT 2F U - NLSFUNC.COM - SET COUNTRY INFO

AX = 1403h
DS:SI -> internal code page structure (see AX=1401h)
BX = code page
DX = country code

Return: AL = status

     ???

Note: called by DOS v3.3+ kernel on INT 21/AH=38h SeeAlso: AX=1402h,AX=1404h,INT 21/AH=38h“SET” ———-2F1404—————————– INT 2F U - NLSFUNC.COM - GET COUNTRY INFO

AX = 1404h
BX = code page
DX = country code
DS:SI -> internal code page structure (see AX=1401h)
ES:DI -> user buffer

Return: AL = status

     ???

Notes: called by DOS v3.3+ kernel on INT 21/AH=38h

code page structure apparently only needed for COUNTRY.SYS pathname

SeeAlso: AX=1402h,AX=1403h,INT 21/AH=38h“GET” ———-2F14FE—————————– INT 2F U - DR-DOS 5.0 NLSFUNC - ???

AX = 14FEh
DI = ???
???

Return: ??? Note: DR-DOS 5.0 NLSFUNC returns CF set and AX=0001h if AL was not 00h, FEh,

  or FFh on entry.

SeeAlso: AX=14FFh ———-2F14FF—————————– INT 2F U - DR-DOS 5.0 NLSFUNC - ???

AX = 14FFh
???

Return: ??? Note: DR-DOS 5.0 NLSFUNC returns CF set and AX=0001h if AL was not 00h, FEh,

  or FFh on entry.

SeeAlso: AX=14FEh ———-2F1500—————————– INT 2F - DOS 4.00 GRAPHICS.COM - INSTALLATION CHECK

AX = 1500h

Return: AX = FFFFh

ES:DI -> ??? (graphics data?)

Note: this installation check conflicts with the CD-ROM Extensions

  installation check; moved to AX=AC00h in later versions

SeeAlso: AX=AC00h ———-2F1500BX0000———————– INT 2F - CD-ROM - INSTALLATION CHECK

AX = 1500h
BX = 0000h

Return: BX = number of CD-ROM drive letters used

CX = starting drive letter (0=A:)

Notes: this installation check DOES NOT follow the format used by other

  software
this installation check conflicts with the DOS 4.00 GRAPHICS.COM
  installation check

SeeAlso: INT 2F/AX=D000h“Lotus” ———-2F1501—————————– INT 2F - CD-ROM - GET DRIVE DEVICE LIST

AX = 1501h
ES:BX -> buffer to hold drive letter list (5 bytes per drive letter)

Return: buffer filled, for each drive letter

  BYTE	subunit number in driver
  DWORD address of device driver header

———-2F1502—————————– INT 2F - CD-ROM - GET COPYRIGHT FILE NAME

AX = 1502h
ES:BX -> 38-byte buffer for name of copyright file
CX = drive number (0=A:)

Return: CF set if drive is not a CD-ROM drive

    AX = 15 (invalid drive)
CF clear if successful

SeeAlso: AX=1503h ———-2F1503—————————– INT 2F - CD-ROM - GET ABSTRACT FILE NAME

AX = 1503h
ES:BX -> 38-byte buffer for name of abstract file
CX = drive number (0=A:)

Return: CF set if drive is not a CD-ROM drive

    AX = 15 (invalid drive)
CF clear if successful

SeeAlso: AX=1502h ———-2F1504—————————– INT 2F - CD-ROM - GET BIBLIOGRAPHIC DOC FILE NAME

AX = 1504h
ES:BX -> 38-byte buffer for name of bibliographic documentation file
CX = drive number (0=A:)

Return: CF set if drive is not a CD-ROM drive

    AX = 15 (invalid drive)
CF clear if successful

———-2F1505—————————– INT 2F - CD-ROM - READ VTOC

AX = 1505h
ES:BX -> 2048-byte buffer
CX = drive number (0=A:)
DX = sector index (0=first volume descriptor,1=second,...)

Return: CF set on error

    AX = error code (15=invalid drive,21=not ready)
CF clear if successful
    AX = volume descriptor type (1=standard,FFh=terminator,0=other)

———-2F1506—————————– INT 2F - CD-ROM - TURN DEBUGGING ON

AX = 1506h
BX = debugging function to enable

Note: reserved for development SeeAlso: AX=1507h ———-2F1507—————————– INT 2F - CD-ROM - TURN DEBUGGING OFF

AX = 1507h
BX = debugging function to disable

Note: reserved for development SeeAlso: AX=1506h ———-2F1508—————————– INT 2F - CD-ROM - ABSOLUTE DISK READ

AX = 1508h
ES:BX -> buffer
CX = drive number (0=A:)
SI:DI = starting sector number
DX = number of sectors to read

Return: CF set on error

    AL = error code (15=invalid drive,21=not ready)
CF clear if successful

SeeAlso: AX=1509h

INT 2F - CD-ROM - ABSOLUTE DISK WRITE

AX = 1509h
ES:BX -> buffer
CX = drive number (0=A:)
SI:DI = starting sector number
DX = number of sectors to write

Note: corresponds to INT 26h and is currently reserved and nonfunctional SeeAlso: AX=1508h ———-2F150A—————————– INT 2F - CD-ROM - RESERVED

AX = 150Ah

———-2F150B—————————– INT 2F - CD-ROM v2.00+ - DRIVE CHECK

AX = 150Bh
CX = drive number (0=A:)

Return: BX = ADADh if MSCDEX.EXE installed

    AX = 0000h if drive not supported
	nonzero if supported

SeeAlso: AX=150Dh ———-2F150C—————————– INT 2F - CD-ROM v2.00+ - GET MSCDEX.EXE VERSION

AX = 150Ch

Return: BH = major version

BL = minor version

Note: MSCDEX.EXE versions prior to 2.00 return BX=0 ———-2F150D—————————– INT 2F - CD-ROM v2.00+ - GET CD-ROM DRIVE LETTERS

AX = 150Dh
ES:BX -> buffer for drive letter list (1 byte per drive)

Return: buffer filled with drive numbers (0=A:). Each byte corresponds

to the drive in the same position for function 1501h

SeeAlso: AX=150Bh ———-2F150E—————————– INT 2F - CD-ROM v2.00+ - GET/SET VOLUME DESCRIPTOR PREFERENCE

AX = 150Eh
BX = subfunction
    00h get preference
	DX = 0000h
	Return: DX = preference settings
    01h set preference
	DH = volume descriptor preference
	    01h = primary volume descriptor
	    02h = supplementary volume descriptor
	DL = supplementary volume descriptor preference
	    01h = shift-Kanji
CX = drive number (0=A:)

Return: CF set on error

    AX = error code (15=invalid drive,1=invalid function)
CF clear if successful

———-2F150F—————————– INT 2F - CD-ROM v2.00+ - GET DIRECTORY ENTRY

AX = 150Fh
CL = drive number (0=A:)
CH bit 0 = copy flag
	clear if direct copy
	set if copy to structure which removed ISO/High Sierra diffs
ES:BX -> ASCIZ path name
SI:DI -> buffer for directory entry (see below)
	 minimum 255 bytes for direct copy

Return: CF set on error

    AX = error code
CF clear if succesful
    AX = disk format (0=High Sierra,1=ISO 9660)

Format of directory entry (direct copy): Offset Size Description 00h BYTE length of directory entry 01h BYTE length of XAR in Logical Block Numbers 02h DWORD LBN of data, Intel (little-endian) format 06h DWORD LBN of data, Motorola (big-endian) format 0Ah DWORD length of file, Intel format 0Eh DWORD length of file, Motorola format —High Sierra— 12h 6 BYTEs date and time 18h BYTE bit flags 19h BYTE reserved —ISO 9660— 12h 7 BYTEs date and time 19h BYTE bit flags —both formats— 1Ah BYTE interleave size 1Bh BYTE interleave skip factor 1Ch WORD volume set sequence number, Intel format 1Eh WORD volume set sequence number, Motorola format 20h BYTE length of file name 21h N BYTEs file name

BYTE (optional) padding if filename is odd length
    N BYTEs system data

Format of directory entry (canonicalized): Offset Size Description 00h BYTE length of XAR in Logical Block Numbers 01h DWORD Logical Block Number of file start 05h WORD size of disk in logical blocks 07h DWORD file length in bytes 0Bh 7 BYTEs date and time 12h BYTE bit flags 13h BYTE interleave size 14h BYTE interleave skip factor 15h WORD volume set sequence number 17h BYTE length of file name 18h 38 BYTEs ASCIZ filename 3Eh WORD file version number 40h BYTE number of bytes of system use data 41h 220 BYTEs system use data ———-2F1510—————————– INT 2F - CD-ROM v2.10+ - SEND DEVICE DRIVER REQUEST

AX = 1510h
CX = CD-ROM drive letter (0 = A, 1 = B, etc)
ES:BX -> CD-ROM device driver request header (see AX=0802h)

———-2F1600—————————– INT 2F - MS WINDOWS - WINDOWS ENHANCED MODE INSTALLATION CHECK

AX = 1600h

Return: AL = 00h if Windows 3.x enhanced mode or Windows/386 2.x not running

AL = 80h if Windows 3.x enhanced mode or Windows/386 2.x not running
AL = 01h if Windows/386 2.x running
AL = FFh if Windows/386 2.x running
AL = anything else
    AL = Windows major version number >= 3
    AH = Windows minor version number

Note: INT 2F/AH=16h comprises an API for non-Windows programs (DOS device

  drivers, TSRs, and applications) to cooperate with multitasking
  Windows/386 2.x and Windows 3.x and higher enhanced mode.
certain calls are also supported in the Microsoft 80286 DOS extender in
  Windows standard mode

SeeAlso: AX=4680h ———-2F1602—————————– INT 2F - MS WINDOWS/386 2.x - GET API ENTRY POINT

AX = 1602h

Return: ES:DI → Windows/386 2.x API procedure entry point Notes: this interface is supported in Windows 3.x only for 2.x compatibility

to get the current virtual machine (VM) ID in Windows/386 2.x:
    AX = 0000h
    ES:DI -> return address
    JUMP to address returned from INT 2F/AX=1602h
After JUMP, at return address:
    BX = current VM ID.

SeeAlso: AX=0C20h ———-2F1603—————————– INT 2F - RM Nimbus MSDOS 3.3 - ???

AX = 1603h

Return: AX = 5248h ('RH')

DS:SI -> first byte after INT 2F handler in IBMBIO.COM

———-2F1605—————————– INT 2F - MS WINDOWS - WINDOWS ENH MODE & 286 DOSX INIT BROADCAST

AX = 1605h
ES:BX = 0000h:0000h
DS:SI = 0000h:0000h
CX = 0000h
DX = flags
    bit 0 = 0 if Windows enhanced-mode initialization
    bit 0 = 1 if Microsoft 286 DOS extender initialization
    bits 1-15 reserved (undefined)
DI = version number (major in upper byte, minor in lower)

Return: CX = 0000h if okay for Windows to load

CX <> 0 if Windows should not load
ES:BX -> startup info structure (see below)
DS:SI -> virtual86 mode enable/disable callback or 0000h:0000h

Notes: the Windows enhanced mode loader and Microsoft 286 DOS extender will

  broadcast an INT 2F/AX=1605h call when initializing.	Any DOS device
  driver or TSR can watch for this broadcast and return the appropriate
  values.  If the driver or TSR returns CX <> 0, it is also its
  responsibility to display an error message.
each handler must first chain to the prior INT 2F handler with
  registers unchanged before processing the call
if the handler requires local data on a per-VM basis, it must store the
  returned ES:BX in the "next" field of a startup info structure and
  return a pointer to that structure in ES:BX
a single TSR may set the V86 mode enable/disable callback; if DS:SI is
  already nonzero, the TSR must fail the initialization by setting CX
  nonzero

SeeAlso: AX=1606h,AX=1608h,AX=4B05h

Format of Startup Information Structure: Offset Size Description 00h 2 BYTEs major, minor version of info structure 02h DWORD pointer to next startup info structure or 0000h:0000h 06h DWORD pointer to ASCIZ name of virtual device file or 0000h:0000h 0Ah DWORD virtual device reference data (only used if above nonzero) 0Eh DWORD pointer to instance data records or 0000h:0000h

Format of one Instance Item in array: Offset Size Description 00h DWORD address of instance data (end of array if 0000h:0000h) 04h WORD size of instance data

Virtual mode enable/disable procedure called with:

AX = 0000h disable V86 mode
AX = 0001h enable V86 mode
interrupts disabled

Return: CF set on error

CF clear if successful
interrupts disabled

———-2F1606—————————– INT 2F - MS WINDOWS - WINDOWS ENH MODE & 286 DOSX EXIT BROADCAST

AX = 1606h
DX = flags
    bit 0 = 0 if Windows enhanced-mode exit
    bit 0 = 1 if Microsoft 286 DOS extender exit
    bits 1-15 reserved (undefined)

Notes: if the init broadcast fails (AX=1605h returned CX <> 0), then this

  broadcast will be issued immediately.
this call will be issued in real mode

SeeAlso: AX=1605h,AX=1609h ———-2F1607—————————– INT 2F - MS WINDOWS - VIRTUAL DEVICE CALL OUT API

AX = 1607h
BX = virtual device ID (see INT 2F/AX=1684h)

Notes: more of a convention than an API, this call specifies a standard

  mechanism for Windows enhanced-mode virtual devices (VxD's) to talk
  to DOS device drivers and TSRs
VNETBIOS calls this function and then checks ES:DI to determine whether
  the NetBIOS has any extensions Windows should know about
VMD (Virtual Mouse Driver) calls this and then checks whether CX is
  nonzero; if yes, it will not automatically virtualize the mouse
  driver.  This would be used if MOUSE.COM already virtualizes
  itself using the Windows API.

SeeAlso: AX=0C20h,AX=1605h,AX=1684h ———-2F1607BX0015———————– INT 2F - DOS 5.0 kernel - “DOSMGR” VIRTUAL DEVICE SUPPORT

AX = 1607h
BX = 0015h (VxD identifier of "DOSMGR")
CX = function
    0000h ???
    	Return: CX = 0001h
		ES:BX -> ??? data
    0001h ???
    	DX = ???
	Return: AX = B97Ch
		BX = value of DX on call
		DX = A2ABh
    0002h NOP
    0003h ???
    	DX = ??? (bit 0 significant)
	Return: if DX bit 0 set:
			AX = B97Ch
			CX = ??? (0058h)
			DX = A2ABh
		if DX bit 0 clear:
			all registers preserved
    0004h ???
    	Return: DX = 0000h
    0005h get device driver size
    	ES = segment of device driver
	Return: DX:AX = 0000h:0000h on error (not dev. driver segment)
		DX:AX = A2ABh:B97Ch if successful
		    BX:CX = size of device driver in bytes

———-2F1608—————————– INT 2F - MS WINDOWS - WINDOWS ENHANCED MODE INIT COMPLETE BROADCAST

AX = 1608h

Notes: called after all installable devices have been initialized

real-mode software may be called between the Windows enhanced-mode init
  call (AX=1605h) and this call; the software must detect this
  situation

SeeAlso: AX=1605h,AX=1609h ———-2F1609—————————– INT 2F - MS WINDOWS - WINDOWS ENHANCED MODE BEGIN EXIT BROADCAST

AX = 1609h

Note: called at the beginning of a normal exit sequence; not made in the

  event of a fatal system crash

SeeAlso: AX=1606h,AX=1608h ———-2F160A—————————– INT 2F - MS Windows 3.1 - IDENTIFY WINDOWS VERSION AND TYPE

AX = 160Ah
???

Return: ??? ———-2F160B—————————– INT 2F - MS Windows 3.1 - IDENTIFY TSRs

AX = 160Bh
???

Return: ???

Format of TSR-to-Windows communication structure: Offset Size Description 00h DWORD pointer to next structure 04h WORD PSP segment 06h WORD API version ID (0100h) 08h WORD EXEC flags bit 0: “WINEXEC”

	bit 1: "LOADLIBRARY"
	bit 2: "OPENDRIVER"

0Ah WORD “exec_cmd_show” 0Ch DWORD “exec_cmd” 10h 4 BYTEs reserved (0) 14h DWORD TSR ID block 18h DWORD TSR data block ———-2F160C—————————– INT 2F - MS Windows 3.1 - DETECT ROMs

AX = 160Ch
???

Return: ??? Note: used by ROM Windows ———-2F1680—————————– INT 2F - MS WINDOWS, DPMI, various - RELEASE CURRENT VIRTUAL MACHINE TIME-SLICE

AX = 1680h

Return: AL = 00h if the call is supported

AL = 80h (unchanged) if the call is not supported

Notes: programs can use this function in idle loops to enhance performance

  under multitaskers; this call is supported by MS Windows 3.0, DOS 5+,
  DPMI 1.0+, and will be supported in OS/2 2.0 for multitasking DOS
  applications
does not block the program; it just gives up the remainder of the time
  slice
should not be used by Windows-specific programs

SeeAlso: INT 15/AX=1000h ———-2F1681—————————– INT 2F - MS WINDOWS 3+ - BEGIN CRITICAL SECTION

AX = 1681h

Notes: used to prevent a task switch from occurring

should be followed by an INT 2F/AX=1682h call as soon as possible
nested calls are allowed, and must be followed by an appropriate number
  of "end critical section" calls
not supported in Windows/386 2.x. Get INDOS flag with INT 21/AH=34h and
  and increment by hand.

SeeAlso: AX=1682h,INT 15/AX=101Bh,INT 21/AH=34h ———-2F1682—————————– INT 2F - MS WINDOWS 3+ - END CRITICAL SECTION

AX = 1682h

Notes: not supported in Windows/386 2.x. Get InDOS flag with INT 21/AH=34h

  and decrement by hand, taking care not to decrement InDOS flag
  through zero

SeeAlso: AX=1681h,INT 15/AX=101Ch,INT 21/AH=34h ———-2F1683—————————– INT 2F - MS WINDOWS 3+ - GET CURRENT VIRTUAL MACHINE ID

AX = 1683h

Return: BX = current virtual machine (VM) ID Notes: Windows itself currently runs in VM 1, but this can't be relied upon

VM IDs are reused when VMs are destroyed
an ID of 0 will never be returned

SeeAlso: AX=1684h,AX=1685h,AX=168Bh ———-2F1684—————————– INT 2F - MS WINDOWS - GET DEVICE API ENTRY POINT

AX = 1684h
BX = virtual device (VxD) ID (see below)
ES:DI = 0000h:0000h

Return: ES:DI → VxD API entry point, or 0:0 if the VxD does not support an API Note: some Windows enhanced-mode virtual devices provide services that

  applications can access.  For example, the Virtual Display Device
  (VDD) provides an API used in turn by WINOLDAP.

SeeAlso: AX=1683h

Values for VxD ID: 01h VMM Virtual Machine Manager 02h Debug 03h VPICD Virtual Prog. Interrupt Controller (PIC) Device 04h VDMAD Virtual Direct Memory Access (DMA) Device 05h VTD Virtual Timer Device 06h V86MMGR Virtual 8086 Mode Device 07h PAGESWAP Paging Device 08h Parity 09h Reboot 0Ah VDD Virtual Display Device (GRABBER) 0Bh VSD Virtual Sound Device 0Ch VMD Virtual Mouse Device 0Dh VKD Virtual Keyboard Device 0Eh VCD Virtual COMM Device 0Fh VPD Virtual Printer Device 10h VHD Virtual Hard Disk Device 11h VMCPD 12h EBIOS Reserve EBIOS page (e.g., on PS/2) 13h BIOSXLAT Map ROM BIOS API between prot & V86 mode 14h VNETBIOS Virtual NetBIOS Device 15h DOSMGR 16h WINLOAD 17h SHELL 18h VMPoll 19h VPROD 1Ah DOSNET assures network integrity across VMs 1Bh VFD Virtual Floppy Device 1Ch VDD2 Secondary display adapter 1Dh WINDEBUG 1Eh TSRLoad TSR instance utility Note: The high bit of the VxD ID is reserved for future use. The

next 10 bits are the OEM # which is assigned by Microsoft. The
low 5 bits are the device number. 

Call VTD.386 entry point with:

AX = 0000h get VTD version number
    Return: AH = major version
    	    AL = minor version
AX = 0100h get current clock tick time
    Return: EDX:EAX = clock tick time in 840ns units since Windows was
    			started
AX = 0101h get current system time in milliseconds
    Return: EAX = time in milliseconds that Windows has been running
AX = 0102h get current virtual machine time
    Return: EAX = cumulative amount of time the virtual machine has
    		been active, in milliseconds

Note: should only be called directly when TOOLHELP.DLL TimerCount() cannot

  be called

———-2F1685—————————– INT 2F - MS WINDOWS - SWITCH VMs AND CALLBACK

AX = 1685h
BX = VM ID of virtual machine to switch to
CX = flags
	bit 0 wait until interrupts enabled
	bit 1 wait until critical section unowned
	bits 2-15 reserved (zero)
DX:SI = priority boost (see VMM.INC)
ES:DI -> FAR procedure to callback

Return: CF set on error

    AX = error code
	01h invalid VM ID
	02h invalid priority boost
	03h invalid flags
CF clear if successful
    event will be or has been called

Notes: some DOS devices, such as networks, need to call functions in a

  specific VM. This call forces the appropriate VM to be installed.
the callback procedure must preserve all registers and return with IRET

SeeAlso: AX=1683h,INT 15/AX=1117h ———-2F1686—————————– INT 2F - DOS Protected-Mode Interface - DETECT MODE

AX = 1686h

Return: AX = 0000h if operating in protected mode under DPMI (INT 31 available)

AX nonzero if in real/V86 mode or no DPMI (INT 31 not available)

SeeAlso: AX=1687h ———-2F1687—————————– INT 2F - DOS Protected-Mode Interface - INSTALLATION CHECK

AX = 1687h

Return: AX = 0000h if installed

    BX = flags
	bit 0: 32-bit programs supported
    CL = processor type (02h=80286, 03h=80386, 04h=80486)
    DH = DPMI major version
    DL = two-digit DPMI minor version
    SI = number of paragraphs of DOS extender private data
    ES:DI -> DPMI mode-switch entry point
AX nonzero if not installed

SeeAlso: AX=1686h

Call mode switch entry point with:

AX = flags
    bit 0: set if 32-bit program
ES = real mode segment of buffer for DPMI private data (ignored if
	SI was zero)

Return: CF set on error

    program still in real mode
    AX = error code (DPMI 1.0+)
       8011h unable to allocate all necessary descriptors
       8021h 32-bit program specified, but 16-bit DPMI host
CF clear if successful
    CS = 16-bit selector corresponding to real-mode CS
    SS = selector corresponding to real-mode SS (64K limit)
    DS = selector corresponding to real-mode DS (64K limit)
    ES = selector to program's PSP (100h byte limit)
    FS = GS = 0
    high word of ESP = 0 if 32-bit program
    program now in protected mode

Note: this entry point is only called for the initial switch to protected

  mode

———-2F1688—————————– INT 2F U - MS Windows 3.0, 386MAX v6.01 - GET SELECTOR TO LDT

AX = 1688h

Return: AX = status??? (0000h for 386MAX)

BX = selector for ???

———-2F1689—————————– INT 2F U - MS Windows 3.0+ - KERNEL IDLE CALL

AX = 1689h
???

Return: ??? ———-2F168A—————————– INT 2F - DPMI 0.9+ - GET VENDOR-SPECIFIC API ENTRY POINT

AX = 168Ah
DS:(E)SI = selector:offset of ASCIZ vendor name

Return: AL = status

    00h successful
       ES:(E)DI -> extended API entry point
    8Ah unsuccessful

Notes: the vendor name is used to determine which entry point to return; it is

  case-sensitive
available in protected mode only
32-bit applications use ESI and EDI, 16-bit applications use SI and DI
this call is present but not documented for DPMI 0.9

SeeAlso: INT 31/AX=0A00h

Vendor names: “MS-DOS” ??? and 386MAX v6.00+ “386MAX” 386MAX v6.00+ ———-2F168B—————————– INT 2F - MS Windows 3.1 - SET FOCUS TO SPECIFIED VIRTUAL MACHINE

AX = 168Bh
???

Return: ??? SeeAlso: AX=1683h ———-2F168C—————————– INT 2F - MS Windows 3.1 - RESTART COMMAND

AX = 168Ch
???

Return: ??? Note: WIN.COM executes specified application ———-2F1700—————————– INT 2F - MS WINDOWS “WINOLDAP” - IDENTIFY WinOldAp VERSION

AX = 1700h

Return: AX = 1700h if this version of WINOLDAP doesn't support clipboard

AX <> 1700h
	AL = WINOLDAP major version
	AH = WINOLDAP minor version

Notes: WinOldAp (WINOLDAP.MOD) is a Microsoft Windows extension supporting

  "old" (character-mode) application access to Dynamic Data Exchange,
  menus, and the Windows clipboard.
this installation check DOES NOT follow the format used by other
  software

———-2F1701—————————– INT 2F - MS WINDOWS “WINOLDAP” - OPEN CLIPBOARD

AX = 1701h

Return: AX <> 0 success

AX = 0	 clipboard is already open

———-2F1702—————————– INT 2F - MS WINDOWS “WINOLDAP” - EMPTY CLIPBOARD

AX = 1702h

Return: AX <> 0 clipboard has been emptied

AX = 0	 failure

———-2F1703—————————– INT 2F - MS WINDOWS “WINOLDAP” - SET CLIPBOARD DATA

AX = 1703h
DX = clipboard format supported by WinOldAp:
	01h text
	02h bitmap
	03h metafile picture
	04h SYLK
	05h DIF
	06h TIFF
	07h OEM text
ES:BX -> data (see below for formats)
SI:CX = size of data

Return: AX <> 0 data copied into the Clipboard

AX = 0 failure

Format of bitmap: Offset Size Description 00h WORD type (0000h) 02h WORD width of bitmap in pixels 04h WORD height of bitmap in pixels 06h WORD bytes per line 08h BYTE number of color planes 09h BYTE number of adjacent color bits in pixel 0Ah DWORD pointer to start of data 0Eh WORD width in 0.1mm units 10h WORD height in 0.1mm units 12h N BYTEs bitmap data

Format of metafile picture: Offset Size Description 00h WORD mapping mode 02h WORD X extent 04h WORD Y extent 06h WORD picture data ———-2F1704—————————– INT 2F - MS WINDOWS “WINOLDAP” - GET CLIPBOARD DATA SIZE

AX = 1704h
DX = clipboard format supported by WinOldAp (see AX=1703h)

Return: DX:AX = size of data in bytes, including any headers Failure: DX:AX = 0 no data in this format in the Clipboard ———-2F1705—————————– INT 2F - MS WINDOWS “WINOLDAP” - GET CLIPBOARD DATA

AX = 1705h
DX = clipboard format supported by WinOldAp (see AX=1703h)
ES:BX -> buffer

Return: AX <> 0 success

AX = 0	 error, or no data in this format in Clipboard

———-2F1708—————————– INT 2F - MS WINDOWS “WINOLDAP” - CloseClipboard

AX = 1708h

Return: AX <> 0 success

AX = 0 failure

———-2F1709—————————– INT 2F - MS WINDOWS “WINOLDAP” - COMPACT CLIPBOARD

AX = 1709h
SI:CX = desired size in bytes

Return: DX:AX = number of bytes in largest block of free memory Note: WinOldAp is responsible for including the size of any headers ———-2F170A—————————– INT 2F - MS WINDOWS “WINOLDAP” - GET DEVICE CAPABILITIES

AX = 170Ah
DX = GDI information index
    00h device driver version
    02h device classification
    04h width in mm
    06h height in mm
    08h width in pixels
    0Ah height in pixels
    0Ch bits per pixel
    0Eh number of bit planes
    10h number of brushes supported by device
    12h number of pens supported by device
    14h number of markers supported by device
    16h number of fonts supported by device
    18h number of colors
    1Ah size required for device descriptor
    1Ch curve capabilities
    1Eh line capabilities
    20h polygon capabilities
    22h text capabilities
    24h clipping capabilities
    26h bitblt capabilities
    28h X aspect
    2Ah Y aspect
    2Ch length of hypotenuse of aspect
    58h logical pixels per inch of width
    5Ah logical pixels per inch of height

Return: AX = integer value of the desired item

	device classification
	    00h vector plotter
	    01h raster display
	    02h raster printer
	    03h raster camera
	    04h character-stream, PLP
	    05h Metafile, VDM
	    06h display-file
	curve capabilities
	    bit 0  circles
	    bit 1  pie wedges
	    bit 2  chord arcs
	    bit 3  ellipses
	    bit 4  wide lines
	    bit 5  styled lines
	    bit 6  wide styled lines
	    bit 7  interiors
	line capabilities
	    bit 1  polylines
	    bit 2  markers
	    bit 3  polymarkers
	    bit 4  wide lines
	    bit 5  styled lines
	    bit 6  wide styled lines
	    bit 7  interiors
	polygon capabilities
	    bit 0  polygons
	    bit 1  rectangles
	    bit 2  trapezoids
	    bit 3  scanlines
	    bit 4  wide borders
	    bit 5  styled borders
	    bit 6  wide styled borders
	    bit 7  interiors
	text capabilities
	    bit 0  output precision character
	    bit 1  output precision stroke
	    bit 2  clippping precision stroke
	    bit 3  90-degree character rotation
	    bit 4  arbitrary character rotation
	    bit 5  independent X and Y scaling
	    bit 6  double-size
	    bit 7  integer scaling
	    bit 8  continuous scaling
	    bit 9  bold
	    bit 10 italic
	    bit 11 underline
	    bit 12 strikeout
	    bit 13 raster fonts
	    bit 14 vector fonts
	    bit 15 reserved
	clipping capabilities
	    00h none
	    01h clipping to rectangles
	raster capabilities
	    bit 0  simple bitBLT
	    bit 1  device requires banding support
	    bit 2  device requires scaling support
	    bit 3  supports >64K bitmap

Note: This function returns the device-capability bits for the given display ———-2F1900—————————– INT 2F U - DOS 4.x only SHELLB.COM - INSTALLATION CHECK

AX = 1900h

Return: AL = 00h not installed

     FFh  installed

———-2F1901BL00————————- INT 2F U - DOS 4.x only SHELLB.COM - SHELLC.EXE INTERFACE

AX = 1901h
BL = 00h if SHELLC transient
     01h if SHELLC resident
DS:DX -> far call entry point for resident SHELLC.EXE

Return: ES:DI → SHELLC.EXE workspace within SHELLB.COM Note: SHELLB.COM and SHELLC.EXE are parts of the DOS 4.x shell ———-2F1902—————————– INT 2F U - DOS 4.x only SHELLB.COM - COMMAND.COM INTERFACE

AX = 1902h
ES:DI -> ASCIZ full filename of current batch file, with at least the
	 final filename element uppercased
DS:DX -> buffer for results

Return: AL = 00h failed, either

	  (a) final filename element quoted at ES:DI does not match
	      identity of shell batch file quoted as parameter of most
	      recent call of SHELLB command, or
	  (b) no more Program Start Commands available.
AL= FFh	 success, then:
	memory at DS:[DX+1] onwards filled as:
	DX+1:	BYTE	count of bytes of PSC
	DX+2: N BYTEs	Program Start Command text
		BYTE	0Dh terminator 

Explanation: COMMAND.COM executes the result of this call in preference to

reading a command from a batch file. Thus the batch file does not
advance in execution for so long as SHELLB provides PSCs from its
workspace. The PSCs are planted in SHELLB workspace by SHELLC, the user
menu interface. The final PSC of a sequence is finished with a 
GOTO COMMON, which causes a loop back in the batch file which called
SHELLC so as to execute SHELLC again. The check on batch file name
permits PSCs to CALL nested batch files while PSCs are still stacked
up for subsequent execution.

———-2F1903—————————– INT 2F U - DOS 4.x only SHELLB.COM - COMMAND.COM interface

AX = 1903h
ES:DI -> ASCIZ batch file name as for AX=1902h

Return: AL = FFh if quoted batch file name matches last SHELLB parameter

AL = 00h if it does not

———-2F1904—————————– INT 2F U - DOS 4.x only SHELLB.COM - SHELLB transient to TSR intrface

AX = 1904h

Return: ES:DI → name of current shell batch file:

	WORD	number of bytes of name following
	BYTEs	(8 max) uppercase name of shell batch file

———-2F1A00—————————– INT 2F - DOS 4+ ANSI.SYS - INSTALLATION CHECK

AX = 1A00h

Return: AL = FFh if installed Notes: AVATAR.SYS also responds to this call

documented for DOS 5+, but undocumented for DOS 4.x

———-2F1A00BX4156———————– INT 2F - AVATAR.SYS - INSTALLATION CHECK

AX = 1A00h
BX = 4156h ('AV')
CX = 4154h ('AT')
DX = 4152h ('AR')

Return: AL = FFh if installed

    CF clear
    BX = AVATAR protocol level supported
    CX = driver type
	0000h AVATAR.SYS
	4456h DVAVATAR.COM inside DESQview window
    DX = 0016h

Notes: AVATAR also identifies itself as ANSI.SYS if BX, CX, or DX differ from

  the magic values
AVATAR.SYS is a CON replacement by George Adam Stanislav which
  interprets AVATAR command codes in the same way that ANSI interprets
  ANSI command codes

———-2F1A01—————————– INT 2F U - DOS 4+ ANSI.SYS internal - GET/SET DISPLAY INFORMATION

AX = 1A01h
CL = function
    7Fh for GET
    5Fh for SET
DS:DX -> parm block as for INT 21,AX=440Ch,CX=037Fh/035Fh respectively

Return: CF set on error

    AX = error code (many non-standard)
CF clear if successful
    AX destroyed

Note: presumably this is the DOS IOCTL interface to ANSI.SYS SeeAlso: AX=1A02h,INT 21/AX=440Ch ———-2F1A02—————————– INT 2F U - DOS 4+ ANSI.SYS internal - MISCELLANEOUS REQUESTS

AX = 1A02h
DS:DX -> parameter block (see below)

Note: DOS 5.0 chains to previous handler if AL > 02h on call SeeAlso: AX=1A01h

Format of parameter block: Offset Size Description 00h BYTE subfunction

	00h set/reset interlock
	01h get /L flag

01h BYTE interlock state

	00h=reset, 01h=set
	  This interlock prevents some of the ANSI.SYS post-processing
	  in its hook onto INT 10, AH=00h mode set

02h BYTE (returned)

	00h if /L not in effect
	01h if /L in effect

———-2F1A21—————————– INT 2F - AVATAR.SYS - SET DRIVER STATE

AX = 1A21h (AL='!')
DS:SI -> command string with one or more state characters
CX = length of command string

Return: CF set on error (invalid subfunction)

CF clear if successful

Note: the characters in the state string are interpreted left to right, and

  need not be in any particular order

SeeAlso: AX=1A3Fh

Values of state characters: 'a' activate driver 'd' disable driver 'f' use fast screen output 'g' always convert gray keys (+ and -) to function keys 'G' never convert gray keys 'l' convert gray keys only when ScrollLock active 's' use slow screen output 't' Tandy 1000 keyboard (not yet implemented) ———-2F1A3C—————————– INT 2F U - AVATAR.SYS v0.11 - ???

AX = 1A3Ch
???

Return: CX = 0000h ———-2F1A3E—————————– INT 2F U - AVATAR.SYS v0.11 - ???

AX = 1A3Eh
CL = ???
CH = ???
DL = ???
DH = ???

Return: CL = ???

CH = ???
DL = ???
DH = ???

———-2F1A3F—————————– INT 2F - AVATAR.SYS - QUERY DRIVER STATE

AX = 1A3Fh (AL='?')
ES:DI -> buffer
CX = length of buffer in bytes

Return: CF clear

CX = actual size of returned info

Note: the returned information consists of multiple letters whose meanings

  are described under AX=1A21h

SeeAlso: AX=1A21h ———-2F1A42BX4156———————– INT 2F - AVATAR Serial Dispatcher - INSTALL IRQ3 HANDLER

AX = 1A42h
BX = 4156h ('AV')
ES:DI -> FAR handler for serial port using IRQ3
DS = data segment needed by handler

Return: AX = 1A42h if ASD not installed

   = 0000h if no more room
   else handle to use when uninstalling

Notes: the handler need not save/restore registers or signal EOI to the

  interrupt controller
the handler should return AX=0000h if the interrupt was meant for it,
  and either leave AX unchanged or return a non-zero value otherwise
the most recently installed handler will be called first, continuing
  to earlier handlers until one returns AX=0000h

SeeAlso: AX=1A43h,AX=1A62h ———-2F1A43BX4156———————– INT 2F - AVATAR Serial Dispatcher - INSTALL IRQ4 HANDLER

AX = 1A43h
BX = 4156h ('AV')
ES:DI -> FAR handler for serial port using IRQ4
DS = data segment needed by handler

Return: AX = 1A43h if ASD not installed

   = 0000h if no more room
   else handle to use when uninstalling

Notes: (see AX=1A42h) SeeAlso: AX=1A42h,AX=1A63h ———-2F1A44BX4156———————– INT 2F - AVATAR.SYS v0.11+ - GET DATA SEGMENT

AX = 1A44h
BX = 4156h ('AV')

Return: AX = 0000h

DS = data segment
CX = size of data segment

Note: AVATAR.SYS calls this function whenever it is invoked. If each

  process under a multitasker hooks this function and provides a
  separate data segment, AVATAR.SYS becomes fully reentrant.

SeeAlso: AX=1A21h,AX=1A3Fh ———-2F1A52—————————– INT 2F U - AVATAR.SYS v0.11 - GET ???

AX = 1A52h
CX = size of buffer
ES:DI -> buffer

Return: ??? copied into user buffer Note: the maximum size of the data which may be copied is returned by

  AX=1A72h

SeeAlso: AX=1A72h ———-2F1A53—————————– INT 2F U - AVATAR.SYS v0.11 - ???

AX = 1A53h
CL = ??? (00h-05h)
???

Return: ??? ———-2F1A62BX4156———————– INT 2F - AVATAR Serial Dispatcher - UNINSTALL IRQ3 HANDLER

AX = 1A62h
BX = 4156h ('AV')
CX = handle for IRQ routine returned by AX=1A42h

SeeAlso: AX=1A42h,AX=1A63h ———-2F1A63BX4156———————– INT 2F - AVATAR Serial Dispatcher - UNINSTALL IRQ4 HANDLER

AX = 1A63h
BX = 4156h ('AV')
CX = handle for IRQ routine returned by AX=1A43h

SeeAlso: AX=1A43h,AX=1A62h ———-2F1A72—————————– INT 2F U - AVATAR.SYS v0.11 - GET ??? SIZE

AX = 1A72h

Return: CX = maximum size of ??? SeeAlso: AX=1A52h ———-2F1A7B—————————– INT 2F U - AVATAR.SYS v0.11 - ???

AX = 1A7Bh

Return: AX = 0000h

CX = 0000h

———-2F1A7D—————————– INT 2F U - AVATAR.SYS v0.11 - ???

AX = 1A7Dh

Return: AX = ??? ———-2F1AADDX0000———————– INT 2F U - AVATAR.SYS v0.11 - ???

AX = 1AADh
DX = 0000h
CX = subfunction (00h-0Ch)
???

Return: AX = 0000h if DX was nonzero

???

———-2F1B00—————————– INT 2F U - DOS 4+ XMA2EMS.SYS extension internal - INSTALLATION CHECK

AX = 1B00h

Return: AL = FFh if installed Note: XMA2EMS.SYS extension is only installed if DOS has page frames to hide.

This extension hooks onto INT 67/AH=58h and returns from that call data
  which excludes the physical pages being used by DOS.

SeeAlso: AH=1Bh“FRAME INFO” ———-2F1B——————————- INT 2F U - DOS 4+ XMA2EMS.SYS extension internal - GET HIDDEN FRAME INFORMATION

AH = 1Bh
AL <> 00h
DI = hidden physical page number

Return: AX = FFFFh if failed (no such hidden page)

AX = 0000h if OK, then
     ES = segment of page frame
     DI = physical page number

Notes: this corresponds to the data edited out of the INT 67/AH=58h call

FASTOPEN makes this call with AL = FFh

SeeAlso: AX=1B00h ———-2F2300—————————– INT 2F - DR-DOS 5.0 GRAFTABL - INSTALLATION CHECK

AX = 2300h

Return: AH = FFh Note: this installation check does not follow the usual format SeeAlso: AH=23h ———-2F23——————————- INT 2F - DR-DOS 5.0 GRAFTABL - GET GRAPHICS DATA

AH = 23h
AL nonzero

Return: AH = FFh

ES:BX -> graphics data

SeeAlso: AX=2300h ———-2F2700—————————– INT 2F - DR-DOS 6.0 TaskMAX - INSTALLATION CHECK

AX = 2700h

Return: AL = 00h not installed

   = FFh installed

———-2F2701—————————– INT 2F - DR-DOS 6.0 TaskMAX - GET STATUS

AX = 2701h

Return: AX = maximum simultaneous tasks

BX = index into TASK_IDS of current foreground task
CX = currently-active tasks
DX = version number (DR-DOS 6.0 = 0001h)
ES:SI -> TASK_IDS
ES:DI -> name table (array of 8-byte names, NUL-terminated if <8 chars)

Notes: do not attempt to create a new task if CX == AX

the task's index is its position on the task menu, while its ID is the
  position within the internal task name table

SeeAlso: AX=2714h,AX=2716h ———-2F2702—————————– INT 2F - DR-DOS 6.0 TaskMAX - GET PER-TASK EMS LIMIT

AX = 2702h

Return: DX = maximum pages INT 67/AH=42h will report available Note: TaskMAX does not limit EMS allocations other than by limiting the

  amount which is reported as being available at a given time

SeeAlso: AX=2703h,INT 67/AH=42h ———-2F2703—————————– INT 2F - DR-DOS 6.0 TaskMAX - SET PER-TASK EMS LIMIT

AX = 2703h
DX = maximum pages INT 67/AH=42h should report available

Return: DX = new maximum for reporting SeeAlso: AX=2702h,INT 67/AH=42h ———-2F2704—————————– INT 2F - DR-DOS 6.0 TaskMAX - REGISTER/UNREGISTER TASK MANAGER

AX = 2704h
DL = subfunction
    00h unregister task manager
    01h register task manager

Return: DL = status

    00h registered
    01h unregistered

Notes: a task manager replaces TaskMAX's menu system with its own user

  interface; while one is registered, the TaskMAX hotkeys and
  Ctrl-Alt-Del invoke the manager rather than the built-in menu system
unregister the task manager before terminating it

SeeAlso: AX=2705h ———-2F2705—————————– INT 2F - DR-DOS 6.0 TaskMAX - ENABLE/DISABLE DIRECT SWITCHING

AX = 2705h
DL = subfunction
    00h disable keystrokes for switching to next/prev/specified task
    01h enable

Return: nothing Note: should only be called by a registered task manager (see AX=2704h) SeeAlso: AX=2704h,AX=2706h ———-2F2706—————————– INT 2F - DR-DOS 6.0 TaskMAX - SWITCH TO SPECIFIED TASK

AX = 2706h
DX = task index (see AX=2701h) of task to be activated

Return: DX = task index of previously-active task SeeAlso: AX=2705h,AX=2707h,AX=2715h ———-2F2707—————————– INT 2F - DR-DOS 6.0 TaskMAX - CREATE NEW TASK

AX = 2707h
DS:DX -> ASCIZ pathname of executable
ES:BX -> parameter block (see below)
CX = number of ticks before automatic return to task manager
	(0000h = run until termination or explicitly switched)

Return: DX = new task's task index (FFFFh if task terminated) SeeAlso: AX=2706h,AX=2708h

Format of parameter block: Offset Size Description 00h WORD reserved, should be 0000h 02h DWORD pointer to command tail to be copied into child's PSP 06h DWORD pointer to first FCB to be copied into child's PSP 0Ah DWORD pointer to second FCB to be copied into child's PSP ———-2F2708—————————– INT 2F - DR-DOS 6.0 TaskMAX - DELETE TASK

AX = 2708h
DX = task index

Return: DX = FFFFh (task deleted) Notes: this call should only be used for abnormal task termination, after

  first checking for open files with AX=270Ch; should not be used
  with programs that allocate EMS or XMS memory
switches to specified task first

SeeAlso: AX=2707h ———-2F2709—————————– INT 2F - DR-DOS 6.0 TaskMAX - NAME TASK

AX = 2709h
DX = task index
DS:SI -> 8-byte name (8 NULs = remove name)

Return: AL = task flags

    00h ID unused or task terminated
    01h ID in use, task name table entry valid
    81h ID in use, task name fixed
BX = task ID
ES:DI -> name in task name table (see AX=2701h)

Note: the task retains the given name until it terminates or the name is

  removed by specifying a name of 8 NULs.

SeeAlso: AX=2701h,AX=2707h ———-2F270A—————————– INT 2F - DR-DOS 6.0 TaskMAX - CONVERT TASK INDEX TO TASK ID

AX = 270Ah
DX = task index

Return: DX = task ID (FFFFh if index invalid) Note: task IDs stay constant, while indexes can change when other tasks are

  deleted

SeeAlso: AX=2701h,AX=270Bh ———-2F270B—————————– INT 2F - DR-DOS 6.0 TaskMAX - CONVERT TASK ID TO TASK INDEX

AX = 270Bh
DX = task ID

Return: DX = task index (FFFFh if task not active) SeeAlso: AX=270Ah ———-2F270C—————————– INT 2F - DR-DOS 6.0 TaskMAX - CHECK OPEN FILES

AX = 270Ch
DX = task index

Return: AX = number of files currently open for specified task SeeAlso: AX=2708h ———-2F270D—————————– INT 2F - DR-DOS 6.0 TaskMAX - CHECK IF TASK RUNNING PRIMARY COMMAND INTERPRETER

AX = 270Dh
DX = task index

Return: DX = status

    0000h if primary command interpreter (COMMAND.COM, etc.) running
    0001h if not in root shell for task

Note: TaskMAX will return 0001h if the specified task has spawned another

  command interpreter with AX=2707h

SeeAlso: AX=2707h,AX=270Ch ———-2F270E—————————– INT 2F - DR-DOS 6.0 TaskMAX - GET/SET TEXT PASTE LEAD-IN

AX = 270Eh
CX = length of string (max 15 keystrokes, 0000h to get current string)
DS:SI -> pasting lead-in string (character/scan-code pairs)

Return: ES:DI → current lead-in string Note: the specified sequence of keystrokes is sent to the application before

  every line of a text-mode spreadsheet paste

SeeAlso: AX=270Fh,AX=2710h,AX=2713h ———-2F270F—————————– INT 2F - DR-DOS 6.0 TaskMAX - GET/SET NUMERIC PASTE LEAD-IN

AX = 270Fh
CX = length of string (max 15 keystrokes, 0000h to get current string)
DS:SI -> pasting lead-in string (character/scan-code pairs)

Return: ES:DI → current lead-in string Note: the specified sequence of keystrokes is sent to the application before

  every number in a numeric-mode spreadsheet paste

SeeAlso: AX=270Eh,AX=2710h,AX=2711h,AX=2713h ———-2F2710—————————– INT 2F - DR-DOS 6.0 TaskMAX - GET/SET PASTE LINE TERMINATOR STRING

AX = 2710h
CX = length of string (max 15 keystrokes, 0000h to get current string)
DS:SI -> pasting lead-in string (character/scan-code pairs)

Return: ES:DI → current lead-in string Note: the specified sequence of keystrokes is sent to the application after

  every line of a spreadsheet paste operation

SeeAlso: AX=270Eh,AX=270Fh,AX=2713h ———-2F2711—————————– INT 2F - DR-DOS 6.0 TaskMAX - GET/SET NUMERIC PASTE DECIMAL POINT

AX = 2711h
DX = ASCII code for separator (FFFFh to get current)

Return: DL = current separator character SeeAlso: AX=270Fh ———-2F2712—————————– INT 2F - DR-DOS 6.0 TaskMAX - INITIATE EXPORTING TASK DATA

AX = 2712h
DX = task index

———-2F2713—————————– INT 2F - DR-DOS 6.0 TaskMAX - INITIATE PASTE OPERATION

AX = 2713h
DX = task index
CX = past mode
    0000h alphanumeric
    0001h numeric
    0002h text

SeeAlso: AX=270Eh,AX=270Fh,AX=2710h,AX=2711h ———-2F2714—————————– INT 2F - DR-DOS 6.0 TaskMAX - GET SWAP SPACE INFO

AX = 2714h

Return: CX = total KB of swap space

DX = available KB of swap space

SeeAlso: AX=2701h ———-2F2715—————————– INT 2F - DR-DOS 6.0 TaskMAX - SWITCH TO TASK MANAGER

AX = 2715h

Return: only after calling task is again selected SeeAlso: AX=2706h ———-2F2716—————————– INT 2F - DR-DOS 6.0 TaskMAX - GET PASTE BUFFER STATUS

AX = 2716h

Return: AX = 0000h if AX=2716h,AX=2717h,AX=2718h supported

    CX = bytes in paste buffer
    DX = current generation number (updated after every copy operation)

SeeAlso: AX=2701h,AX=2713h,AX=2714h,AX=2717h,AX=2718h ———-2F2717—————————– INT 2F - DR-DOS 6.0 TaskMAX - PASTE DATA DIRECTLY TO APPLICATION BUFFER

AX = 2717h
CX = bytes in destination buffer
ES:DI -> destination buffer

Return: AX = 0000h if function supported

    CX = bytes actually copied (FFFFh if buffer too small)
    DX = current generation number for paste buffer

Note: the destination buffer may be too small if another task adds more data

  to the paste buffer after the AX=2716h call but before this call

SeeAlso: AX=2713h,AX=2716h,AX=2718h ———-2F2718—————————– INT 2F - DR-DOS 6.0 TaskMAX - COPY DATA DIRECTLY INTO PASTE BUFFER

AX = 2718h
CX = bytes in source buffer
DS:SI -> source buffer (plain ASCII, lines terminated with CR LF)

Return: AX = 0000h if function supported

    CX = bytes actually copied
    DX = current generation number for paste buffer

SeeAlso: AX=2712h,AX=2716h,AX=2717h ———-2F2A——————————- INT 2F - Gammafax DOS Dispatcher INTERFACE

AH = 2Ah

Note: details not available at this time SeeAlso: AX=8000h“FaxBIOS”,AX=CB00h,AX=CBDDh,INT 66“BitFax” ———-2F3900—————————– INT 2F - Kingswood TSR INTERFACE - COMPATIBILITY MODE

AX = 3900h

Return: AL = status

    00h not installed
    FFh one or more TSRs using this interface is installed

Note: this function is provided to that the multiplex number will appear used

  to other programs

SeeAlso: AH=39h/BL=00h ———-2F39–BL00————————- INT 2F - Kingswood TSR INTERFACE - INSTALLATION CHECK

AH = 39h
BL = 00h
AL = TSR ID number (01h-FFh, currently only 01h-0Eh used) (see below)

Return: AL = status

    00h not installed
    FFh installed
	DX = segment address of resident module

Note: All of Kingswood Software's TSRs use this interface. Usually the

  resident module is installed by allocating a block of upper memory,
  setting its owner ID to 0008h (DOS data), and filling the MCB name
  field with the TSR's name.

SeeAlso: AX=3900h,AH=39h/BL=01h

Values for TSR ID number: 01h TSR Windows 02h NOBUSY 03h CD STACK 04h DISK WATCH 05h PUSHBP 06h ALIAS 07h KEYMACRO 08h SLOWDOWN 09h ANSIGRAB 0Ah TEE 0Bh FASTMOUS 0Ch EXTWILD 0Dh BREAKOUT 0Eh STOPDISK

Format of TSR modules: Offset Size Description 00h 4 BYTEs signature “FTSR” 04h WORD segment address of this module 06h WORD number of words to skip (usually 0000h if no PSP present) 08h N WORDs module-defined data that must be at a fixed segment offset

	(usually only a PSP if file access is required)
   5N BYTEs	interrupt list (see below)
BYTE	FFh terminator

Format of interrupt list entry: Offset Size Description 00h BYTE interrupt number (00h-FEh) 01h WORD offset within segment of DWORD pointer to previous interrupt 03h WORD offset within segment of begin of interrupt handler code ———-2F39–BL01————————- INT 2F - Kingswood TSR INTERFACE - REMOVAL CHECK

AH = 39h
BL = 01h
AL = TSR ID number (01h-FFh) (see AH=39h/BL=00h)

Return: AL = status

    00h not ready to be removed
    FFh resident module may be removed by deassigning the interrupts
	hooked by the TSR and deallocating the TSR's memory block
AH,BX,CX,DX,ES may be destroyed

SeeAlso: AX=3900h,AH=39h/BL=00h ———-2F39——————————- INT 2F - Kingswood TSR INTERFACE - APPLICATION-SPECIFIC FUNCTION CALLS

AH = 39h
BL = function number (02h-FFh)
AL = TSR ID number (01h-FFh)
CX,DX,SI,DI,DS,ES may contain parameters

Return: as appropriate for the called function SeeAlso: AX=3900h,AH=39h/BL=00h,AX=3901h/BL=02h ———-2F3901BL02————————- INT 2F - Kingswood TSR Windows - OPEN WINDOW

AX = 3901h
BL = 02h

Return: AX = error code (0000h if successful) Notes: opens the next TSR window on top of any others. Only three

  TSR windows can be opened at any one time.  The three windows
  are all 40x11 characters, partly overlapping.

SeeAlso: AH=39h/BL=00h,AX=3901h/BL=03h,AX=3901h/BL=05h,AX=3901h/BL=06h ———-2F3901BL03————————- INT 2F - Kingswood TSR Windows - HIDE WINDOWS

AX = 3901h
BL = 03h

Return: AX = error code (0000h if successful) Notes: Hide any visible TSR windows from view. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h,AX=3901h/BL=05h ———-2F3901BL04————————- INT 2F - Kingswood TSR Windows - SHOW WINDOWS

AX = 3901h
BL = 04h

Return: AX = error code (0000h if successful) Notes: Re-display all TSR windows after a HIDE WINDOWS call. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h,AX=3901h/BL=03h ———-2F3901BL05————————- INT 2F - Kingswood TSR Windows - CLOSE WINDOW

AX = 3901h
BL = 05h

Return: AX = error code (0000h if successful) Notes: Close the last opened TSR window. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h ———-2F3901BL06————————- INT 2F - Kingswood TSR Windows - SET WINDOW TITLE

AX = 3901h
BL = 06h
DS:SI -> title string

Return: AX = error code (0000h if successful) SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h ———-2F3901BL07————————- INT 2F - Kingswood TSR Windows - POSITION CURSOR

AX = 3901h
BL = 07h
CH = Y coordinate (0-10)
CL = X coordinate (0-39)

Return: AX = error code (0000h if successful) Note: the hardware cursor is always disabled when a TSR window is opened;

  this call only sets a text position

SeeAlso: AH=39h/BL=00h,AX=3901h/BL=08h,AX=3901h/BL=09h ———-2F3901BL08————————- INT 2F - Kingswood TSR Windows - DISPLAY STRING

AX = 3901h
BL = 08h
DS:SI -> string

Return: AX = error code (0000h if successful) Notes: The text is not clipped.

This routine understands Tab, NewLine and Carriage Return

SeeAlso: AH=39h/BL=00h,AX=3901h/BL=07h ———-2F3901BL09————————- INT 2F - Kingswood TSR Windows - SCROLL WINDOW

AX = 3901h
BL = 09h
CL = scroll direction: 00h up, FFh down, 00h clear window

Return: AX = error code (0000h if successful) SeeAlso: AH=39h/BL=00h,AX=3901h/BL=07h ———-2F3901BL0A————————- INT 2F - Kingswood TSR Windows - SOUND BEEPER

AX = 3901h
BL = 0Ah
DX = sound divisor, or 0 for silence.
     (divide 1843200 by required frequency to get value for DX)
CL = sound length in 18.2 Hz clock ticks

Return: AX = error code (0000h if successful) SeeAlso: AH=39h/BL=00h ———-2F3901BL0B————————- INT 2F - Kingswood TSR Windows - ADD OR REMOVE USER

AX = 3901h
BL = 0Bh
CL = number of users increment: +1 if adding a new user
				-1 if removing a user

Return: AX = error code (0000h if successful) Note: the TSR windows resident module may only be removed when the internal

  user count is zero

SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h ———-2F4000—————————– INT 2F - Windows 3.x (OS/2 2.x???) - GET VIRTUAL DEVICE DRIVER (VDD) CAPABLTIES

AX = 4000h

Return: AL = 01h does not virtualize video access

     02h virtualizes the video when in text mode
     03h virtualizes the video when in text mode or single plane
	 graphics modes
     04h virtualizes the video when in text mode, single plane
	 graphics modes, and VGA multiplane modes
     FFh virtualizes the video fully

Note: this function is used by display drivers to find out what capabilities

  exist for the VDD driver and also trigger then VDD driver to call
  functions 4005h and 4006h.  This function also gives the Video Driver
  hardware access to the video registers.

———-2F4001—————————– INT 2F - OS/2 compatibility box - SWITCHING DOS TO BACKGROUND

AX = 4001h

Note: called by OS/2 when the DOS box is about to be placed in the background

  and the video driver should save any necessary state

SeeAlso: AX=4002h,AX=4005h ———-2F4002—————————– INT 2F - OS/2 compatibility box - SWITCHING DOS TO FOREGROUND

AX = 4002h

Note: called by OS/2 when the DOS box is about to be placed in the foreground

  and the video driver should restore the previously-saved state

SeeAlso: AX=4001h,AX=4006h ———-2F4003—————————– INT 2F - Windows 3.x - ENTERING VIDEO DRIVER CRITICAL SECTION

AX = 4003h

Note: This critical section must be exited within 1 second. SeeAlso: AX=4004h ———-2F4004—————————– INT 2F - Windows 3.x - EXITING VIDEO DRIVER CRITICAL SECTION

AX = 4004h

SeeAlso: AX=4003h ———-2F4005—————————– INT 2F - Windows 3.x - SWITCHING DOS TO BACKGROUND

AX = 4005h

Note: called by Windows when the DOS box is about to be placed in the

  background and the video driver should save any necessary state
  information

SeeAlso: AX=4001h,AX=4006h ———-2F4006—————————– INT 2F - Windows 3.x - SWITCHING DOS TO FOREGROUND

AX = 4006h

Note: called by Windows when the DOS box is about to be placed in the

  foreground and the video driver should restore any necessary state
  information

SeeAlso: AX=4002h,AX=4005h ———-2F4007—————————– INT 2F - Windows 3.x - ENABLE VDD TRAPPING OF VIDEO REGISTERS

AX = 4007h

———-2F41——————————- INT 2F - LAN Manager 2.0 DOS Enhanced NETPOPUP.EXE - NETWORK POP-UP SERVICE

AH = 41h
???

Return: ??? Note: LAN Manager enhanced mode adds features beyond the standard redirector

  file/printer services

SeeAlso: AX=118Ah,AH=42h,AH=4Bh ———-2F42——————————- INT 2F - LAN Manager 2.0 DOS Enhanced MSRV.EXE - MESSENGER SERVICE

AH = 42h
???

Return: ??? Note: LAN Manager enhanced mode adds features beyond the standard redirector

  file/printer services

SeeAlso: AX=118Ah,AH=41h,AH=4Bh ———-2F4300—————————– INT 2F - EXTENDED MEMORY SPECIFICATION (XMS) - INSTALLATION CHECK

AX = 4300h

Return: AL = 80h XMS driver installed

AL <> 80h no driver

Notes: XMS gives access to extended memory and noncontiguous/nonEMS memory

  above 640K
this installation check DOES NOT follow the format used by other
  software

SeeAlso: AX=4310h ———-2F4310—————————– INT 2F - EXTENDED MEMORY SPECIFICATION (XMS) - GET DRIVER ADDRESS

AX = 4310h

Return: ES:BX → driver entry point Note: HIMEM.SYS v2.77 chains to previous handler if AH is not 00h or 10h SeeAlso: AX=4300h

Perform a FAR call to the driver entry point with AH set to the function code

AH	function
00h  Get XMS version number
     Return: AX = XMS version (in BCD, AH=major, AL=minor)
	     BX = internal revision number
	     DX = 0001h if HMA (1M to 1M + 64K) exists
		  0000h if HMA does not exist
01h  Request High Memory Area (1M to 1M + 64K)
     DX = memory in bytes (for TSR or device drivers)
	  FFFFh if application program
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,90h,91h,92h) (see below)
02h  Release High Memory Area
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,90h,93h) (see below)
03h  Global enable A20, for using the HMA
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,82h) (see below)
04h  Global disable A20
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,82h,94h) (see below)
05h  Local enable A20, for direct access to extended memory
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,82h) (see below)
06h  Local disable A20
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,82h,94h) (see below)
07h  Query A20 state
     Return: AX = 0001h enabled
		= 0000h disabled
	     BL = error code (00h,80h,81h) (see below)
08h  Query free extended memory, not counting HMA
     BL = 00h (some implementations leave BL unchanged on success)
     Return: AX = size of largest extended memory block in K
	     DX = total extended memory in K
	     BL = error code (00h,80h,81h,A0h) (see below)
09h  Allocate extended memory block
     DX = Kbytes needed
     Return: AX = 0001h success
		   DX = handle for memory block
		= 0000h failure
		   BL = error code (80h,81h,A0h) (see below)
0Ah  Free extended memory block
     DX = handle of block to free
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,A2h,ABh) (see below)
0Bh  Move extended memory block
     DS:SI -> EMM structure (see below)
     Note: if either handle is 0000h, the corresponding offset is
	   considered to be an absolute segment:offset address in
	   directly addressable memory
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h-82h,A3h-A9h) (see below)
0Ch  Lock extended memory block
     DX = handle of block to lock
     Return: AX = 0001h success
		   DX:BX = 32-bit linear address of locked block
		= 0000h failure
		   BL = error code (80h,81h,A2h,ACh,ADh) (see below)
0Dh  Unlock extended memory block
     DX = handle of block to unlock
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,A2h,AAh) (see below)
0Eh  Get handle information
     DX = handle for which to get info
     Return: AX = 0001h success
		   BH = block's lock count
		   BL = number of free handles left
		   DX = block size in K
		= 0000h failure
		   BL = error code (80h,81h,A2h) (see below)
0Fh  Reallocate extended memory block
     DX = handle of block
     BX = new size of block in K
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,81h,A0h-A2h,ABh) (see below)
10h  Request upper memory block (nonEMS memory above 640K)
     DX = size of block in paragraphs
     Return: AX = 0001h success
		   BX = segment address of UMB
		   DX = actual size of block
		= 0000h failure
		   BL = error code (80h,B0h,B1h) (see below)
		   DX = largest available block
11h  Release upper memory block
     DX = segment address of UMB to release
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,B2h) (see below)
12h  (XMS v3.0) Reallocate upper memory block
     DX = segment address of UMB to resize
     BX = new size of block in paragraphs
     Return: AX = 0001h success
		= 0000h failure
		   BL = error code (80h,B0h,B2h) (see below)
34h  (QEMM 5.11 only, undocumented) ???
44h  (QEMM 5.11 only, undocumented) ???
88h  (XMS v3.0) Query free extended memory
     Return: EAX = largest block of extended memory, in K
	     BL = status
	         00h success
		 80h not implemented (i.e. on a 286 system)
		 81h VDISK detected
		 A0h all extended memory allocated
     	     ECX = physical address of highest byte of memory
	     		(valid even on error codes 81h and A0h)
	     EDX = total Kbytes of extended memory (0 if status A0h)
89h  (XMS v3.0) Allocate any extended memory
     EDX = Kbytes needed
     Return: AX = 0001h success
     		    DX = handle for allocated block (free with AH=0Ah)
		= 0000h failure
		    BL = status (80h,81h,A0h,A1h,A2h) (see below)
8Eh  (XMS v3.0) Get extended EMB handle information
     DX = handle
     Return: AX = 0001h success
     		    BH = block's lock count
		    CX = number of free handles left
		    EDX = block size in K
     		= 0000h failure
     		    BL = status (80h,81h,A2h) (see below)
8Fh  (XMS v3.0) Reallocate any extended memory block
     DX = unlocked handle
     EBX = new size in K
     Return: AX = 0001h success
     		= 0000h failure
		    BL = status (80h,81h,A0h-A2h,ABh) (see below)

Notes: HIMEM.SYS requires at least 256 bytes free stack space

the XMS driver need not implement functions 10h through 12h to be
  considered compliant with the standard

Format of EMM structure: Offset Size Description 00h DWORD number of bytes to move (must be even) 04h WORD source handle 06h DWORD offset into source block 0Ah WORD destination handle 0Ch DWORD offset into destination block Notes: if source and destination overlap, only forward moves (source base

  less than destination base) are guaranteed to work properly
if either handle is zero, the corresponding offset is interpreted
  as a real-mode address referring to memory directly addressable
  by the processor

Error codes returned in BL:

00h successful
80h function not implemented
81h Vdisk was detected
82h an A20 error occurred
8Eh a general driver error
8Fh unrecoverable driver error
90h HMA does not exist
91h HMA is already in use
92h DX is less than the /HMAMIN= parameter
93h HMA is not allocated
94h A20 line still enabled
A0h all extended memory is allocated
A1h all available extended memory handles are allocated
A2h invalid handle
A3h source handle is invalid
A4h source offset is invalid
A5h destination handle is invalid
A6h destination offset is invalid
A7h length is invalid
A8h move has an invalid overlap
A9h parity error occurred
AAh block is not locked
ABh block is locked
ACh block lock count overflowed
ADh lock failed
B0h only a smaller UMB is available
B1h no UMB's are available
B2h UMB segment number is invalid

———-2F44——————————- INT 2F U - ???

AH = 44h
AL = function (at least 0Bh, 15h, 17h)
???

Return: ??? Note: called by Codeview for Windows SeeAlso: AH=86h ———-2F4500—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - INSTALLATION CHECK

AX = 4500h

Return: AL = 01h if PROF.COM installed

AL = 02h if VPROD.386 installed

SeeAlso: AX=4501h,AX=4502h ———-2F4501—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - SETUP PROFILER

AX = 4501h
BX = CSIPS buffer size in KB (first parameter for ProfSetup)
CX = output limit in KB (second parameter for ProfSetup)

Note: this call is not supported by PROF.COM SeeAlso: AX=4502h,AX=4503h ———-2F4502—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - SET SAMPLING RATE

AX = 4502h
BL = sampling rate for PROF.COM (0 < BL <= 13)
    (01h = 8192/s, 04h = 1024/s, 08h = 32/s, 0Dh = 1/s)
CX = sampling rate for VPROD.386

Note: for PROF.COM, this programs the CMOS clock by setting BL+2 as the

  low four bits of CMOS register 0Ah.  The interruption rate is
  1 SHL (15 - BL) per second.

SeeAlso: AX=4501h,AX=4503h ———-2F4503—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - START PROFILING

AX = 4503h

Notes: Profiling is also turned on by the key combinations

  LeftShift + RightShift + Alt
  LeftShift + RightShift + Ctrl
for PROF.COM, this call programs the CMOS clock by reading register
  0Ch, and setting bit 6 of register 0Bh.  It then makes sure that IRQ8
  is unmasked

SeeAlso: AX=4504h ———-2F4504—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - STOP PROFILING

AX = 4504h

Notes: profiling is also turned off by the key combination

  LeftShift + RightShift
for PROF.COM, this programs the CMOS clock by reading register 0Ch
  and clearing bit 6 of register 0Bh.  It then masks IRQ8.

SeeAlso: AX=4503h,AX=4505h,AX=4506h,AX=4507h ———-2F4505—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - CLEAR PROFILING DATA

AX = 4505h

SeeAlso: AX=4503h,AX=4504h,AX=4506h ———-2F4506—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - “ProfFlush”

AX = 4506h

SeeAlso: AX=4505h,AX=4507h ———-2F4507—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - “ProfFinish”

AX = 4507h

Note: this call is essentially a “ProfStop” (AX=4504h) followed by

  "ProfFlush" (AX=4506h)

SeeAlso: AX=4504h,AX=4505h,AX=4506h ———-2F4508—————————– INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - ALTERNATE SEGDEBUG IFACE

AX = 4508h
BX = ordinal (or 0000h)
CX = segment
DX = instance (or 0000h)
SI = type (or 0000h)
ES:DI -> ASCIZ module name

Notes: this call is an alternate entry to the profiler's SEGDEBUG

  interface, but only to function 0, for notifying the profiler of
  each new segment loaded.  The SHOWHITS utility then examines the
  profiler's output files (CSIPS.DAT and SEGENTRY.DAT) in conjunction
  with symbol files to provide information in a useful form.
this call does not have a corresponding Windows function

SeeAlso: AX=4500h ———-2F4601—————————– INT 2F U - DOS 5.0 kernel - ???

AX = 4601h

Return: ??? Note: copies the MCB following the caller's PSP memory block into DOS data

  segment

SeeAlso: AX=4602h ———-2F4602—————————– INT 2F U - DOS 5.0 kernel - ???

AX = 4602h

Return: ??? Note: copies previously copied MCB from DOS data segment into MCB following

  caller's PSP memory block

SeeAlso: AX=4601h ———-2F46——————————- INT 2F U - ???

AH = 46h
AL = subfunction (03h,04h)

Return: ??? Note: these two subfunctions are called by MS Windows 3.0 ———-2F4653CX0002———————– INT 2F - F-PROT v1.x only - F-LOCK.EXE

AX = 4653h
CX = 0002h
BX = subfunction
    0000h  installation check
	Return: AX = FFFFh
    0001h  uninstall
	Return: AX,BX,ES destroyed
    0002h  disable (v1.08 and below only)
    0003h  enable (v1.08 and below only)

Note: F-LOCK is part of the F-PROT virus/trojan protection package by Fridrik

  Skulason

SeeAlso: AX=4653h/CX=0003h,AX=CA00h,INT 21/AX=4BEEh ———-2F4653CX0003———————– INT 2F - F-PROT v1.x only - F-XCHK.EXE

AX = 4653h
CX = 0003h
BX = subfunction
    0000h  installation check
	Return: AX = FFFFh
    0001h  uninstall
	Return: AX,BX,ES destroyed

Note: F-XCHK is part of the F-PROT virus/trojan protection package by Fridrik

  Skulason

SeeAlso: AX=4653h/CX=0002h,AX=4653h/CX=0004h,AX=CA00h ———-2F4653CX0004———————– INT 2F - F-PROT v1.x only - F-POPUP.EXE

AX = 4653h
CX = 0004h
BX = subfunction
    0000h  installation check
	Return: AX = FFFFh
    0001h  uninstall
	Return: AX,BX,ES destroyed
    0002h  disable (v1.08 and below only)
	   display message (v1.14+)
		other registers: ???
    0003h  enable (v1.08 and below only)
	   display message (v1.14+)
		other registers: ???
		Return: AX = key pressed by user

Note: F-POPUP is part of the F-PROT virus/trojan protection package by

  Fridrik Skulason

SeeAlso: AX=4653h/CX=0003h,AX=4653h/CX=0005h,AX=CA00h ———-2F4653CX0005———————– INT 2F - F-PROT v1.x only - F-DLOCK.EXE

AX = 4653h
CX = 0005h
BX = subfunction
    0000h installation check
	Return: AX = FFFFh
    0001h uninstall
	Return: AX,BX,ES destroyed

Note: F-DLOCK is part of the F-PROT virus/trojan protection package by

  Fridrik Skulason

SeeAlso: AX=4653h/CX=0004h,AX=CA00h ———-2F4680—————————– INT 2F - MS Windows v3.0 - INSTALLATION CHECK

AX = 4680h

Return: AX = 0000h MS Windows 3.0 running in real (/R) or standard (/S) mode,

	   or DOS 5 DOSSHELL active
   nonzero  no Windows, Windows prior to 3.0, or Windows3 in enhanced
	    mode

Note: not officially documented, but Microsoft has indicated that they

  intend to provide an installation check which works in all modes

SeeAlso: AX=1600h ———-2F4800—————————– INT 2F - DOS v5.0 DOSKEY - INSTALLATION CHECK

AX = 4800h

Return: AL = nonzero if installed SeeAlso: AX=4810h ———-2F4810—————————– INT 2F - DOS v5.0 DOSKEY - READ INPUT LINE FROM CONSOLE

AX = 4810h
DS:DX -> line buffer (see INT 21/AH=0Ah)

Return: AX = 0000h if successful Notes: the first byte (length) of the buffer MUST be 80h, or DOSKEY chains to

  the previous handler
if the user's input is a macro name, no text is placed in the buffer
  even though AX=0000h on return; the program must immediately issue
  this call again to retrieve the expansion of the macro.  Similarly,
  if the user enters a special parameter such as $*, this call must
  be repeated to retrieve the expansion; on the second call, DOSKEY
  overwrites the macro name on the screen with its expansion.

SeeAlso: AX=4800h,INT 21/AH=0Ah ———-2F4A00CX0000———————– INT 2F U - DOS v5.0 - SINGLE-FLOPPY LOGICAL DRIVE CHANGE NOTIFICATION

AX = 4A00h
CX = 0000h
DH = new drive number
DL = current drive number

Return: CX = FFFFh to skip “Insert diskette for drive X:” message Note: called by MSDOS 5.00 IO.SYS just before displaying the message

  "Insert diskette for drive X:" on single-floppy systems

———-2F4A01—————————– INT 2F - DOS v5.0 - QUERY FREE HMA SPACE

AX = 4A01h

Return: BX = number of bytes available in HMA (0000h if DOS not using HMA)

ES:DI -> start of available HMA area (FFFFh:FFFFh if not using HMA)

SeeAlso: AX=4310h,AX=4A02h ———-2F4A02—————————– INT 2F - DOS v5.0 - ALLOCATE HMA SPACE

AX = 4A02h
BX = number of bytes

Return: ES:DI → start of allocated HMA block or FFFFh:FFFFh

BX destroyed

Note: this call is not valid unless DOS is loaded in the HMA (DOS=HIGH) SeeAlso: AX=4A01h ———-2F4A05—————————– INT 2F U - DOS v5.0 DOSSHELL - ???

AX = 4A05h
SI = function
    0000h reset???
    0001h ???
    0002h ???
    0003h ???
    0004h ???
	BL = ???
    0005h ???
    0006h get ???
	Return: ES:DI -> ???
    0007h get ???
	Return: AX = ???
    0008h get ???
	Return: DX:AX -> ???
    0009h get ???
	Return: ES = ???
    000Ah ???
	BL = ???
	ES:DI -> ???
    000Bh get ???
	Return: AX = ???
    000Ch ???
	BL = ???
	Return: DX:AX -> ???

Notes: DOSSHELL chains to the previous handler if SI is not one of the values

  listed above
the DOSSWAP.EXE module calls functions 03h,04h,05h,07h,08h,09h,0Ch

SeeAlso: AX=4B01h ———-2F4A06—————————– INT 2F U - ??? - GET MEMORY SIZE

AX = 4A06h
DX = segment following last byte of conventional memory

Return: DX = segment following last byte of memory available for use by DOS Note: called by MSDOS 5.00 IO.SYS startup code if the signature “RPL” is

  present three bytes beyond the INT 2F handler; this call overrides
  the value returned by INT 12

SeeAlso: INT 12 ———-2F4A10—————————– INT 2F - SMARTDRV v4.00+ - API

      AX = 4A10h
      BX = command
          0000h installation check and hit ratios
              Return: AX = BABEh if installed
                          DX:BX = cache hits
                          DI:SI = cache misses
                          CX = ???
                          BP = version (4.00 = 0400h)
          0001h reset cache
          0002h flush buffers
          0003h status
              BP = drive # (0=A, 1=B, etc.)
              DL = subfunction
	    00h only get information
                  01h turn on read cache
	    02h turn off read cache
	    03h turn on write cache
	    04h turn off write cache
    	Return: AX = BABEh if OK
                     	DL = status
                          bit 7  not cached
		    bit 6  write-through
		    bit 5  ???
		    bits 0-4 drive # (0=A, 1=B...)
                      DL = FFh if drive does not exist
              Note:	If the read cache is off, reads will not be cached,
		  but writes will continue to be cached if the write-
		  cache is enabled.
          0004h cache size
              Return: AX = ???
                      BX = largest number of elements
                      CX = size of elements in bytes
                      DX = number of elements under Windows
          0005h double-buffer status
              BP = drive # (0=A, 1=B...)
              Return: AX = BABEh if double-buffered
          0007h ???
              Return: DI = random number???
          000Ah get table pointer???
              Return: ES:BX -> table of about 10 bytes or 5 words. Seems to
			be words pointing to memory addresses 
			containing info??? (see below)
          1234h signal serious error
              pops up a message box saying that a serious error occurred and
                to hit R to retry.

SeeAlso: INT 21/AX=4402h“SMARTDRV”,INT 21/AX=4403h“SMARTDRV”

Format of data table: Offset Size Description 00h 8 BYTEs ??? 08h WORD offset of WORD containing number of elements in cache ———-2F4B——————————- INT 2F - LAN Manager 2.0 DOS Enh NETWKSTA.EXE - NETWORK WORKSTATION REDIRECTOR

AH = 4Bh
???

Return: ??? Note: LAN Manager enhanced mode adds features beyond the standard redirector

  file/printer services

SeeAlso: AX=118Ah,AH=41h,AH=42h ———-2F4B01—————————– INT 2F - DOS v5.0 TASK SWITCHER - BUILD CALLOUT CHAIN

AX = 4B01h
CX:DX -> task switcher entry point (see AX=4B02h)
ES:BX = 0000h:0000h

Return: ES:BX → callback info structure (see below) or 0000h:0000h Notes: called by the task switcher

this function is hooked by clients which require notification of task
  switcher activities; the call must first be passed on to the prior
  handler with registers unchanged using a simulated interrupt.	 On
  return, the client must build a callback info structure and store
  the returned ES:BX in the "next" field, then return the address of
  its own callback info structure.
a client program must add itself to the notification chain if it
  provides services to other programs; before terminating, it must
  remove itself from the chain by calling the task switcher's entry
  point with AX=0005h (see AX=4B02h)
the task switcher entry point should not be saved, as it is subject to
  change and will be provided on any notification call
the Windows 3.1 Standard Mode supports this API

SeeAlso: AX=4B02h

Format of callback info structure: Offset Size Description 00h DWORD pointer to next callback info structure 04h DWORD pointer to notification function (see below) 08h DWORD reserved 0Ch DWORD address of zero-terminated list of API info structures

	(see AX=4B02h)

Notification function is called with:

AX = function
    0000h switcher initialization
	Return: AX = 0000h if OK to load
		   = nonzero to abort task switcher
    0001h query suspend
	BX = session ID
	Return: AX = 0000h if OK to switch session
		   = 0001h if not
    0002h suspend session
	BX = session ID
	interrupts disabled
	Return: AX = 0000h if OK to switch session
		   = 0001h if not
    0003h activate session
	BX = session ID
	CX = session status flags
		bit 0: set if first activation of session
		bits 1-15: reserved (0)
	interrupts disabled
	Return: AX = 0000h
    0004h session active
	BX = session ID
	CX = session status flags
		bit 0: set if first activation of session
		bits 1-15: reserved (0)
	Return: AX = 0000h
    0005h create session
	BX = session ID
	Return: AX = 0000h if OK to create session
		   = 0001h if not
    0006h destroy session
	BX = session ID
	Return: AX = 0000h
    0007h switcher termination
	BX = flags
	    bit 0: set if calling switcher is only switcher loaded
	    bits 1-15: reserved (0)
	Return: AX = 0000h
ES:DI -> task switcher entry point (see AX=4B02h)

Notes: function 0000h is generally called by the program which controls or

  invokes the task switcher, rather than by the task switcher itself;
  the entry point supplied to this function is not necessarily the
  entry point to the task switcher itself, and may be 0000h:0000h.  If
  any client indicates that loading is not possible, all clients will
  be called with function 0007h; thus it is possible for a client to
  receive a termination notice without a corresponding initialization
  notice.
except for functions 0002h and 0003h, the notification handler is
  called with interrupts enabled and may make any INT 21h function
  call; interrupts must not be enabled in functions 0002h and 0003h
function 0007h may be called with ES:DI = 0000h:0000h if the entry
  point is no longer valid

———-2F4B02BX0000———————– INT 2F - DOS v5.0 TASK SWITCHER - INSTALLATION CHECK

AX = 4B02h
BX = 0000h
ES:DI = 0000h:0000h

Return: ES:DI = 0000h:0000h if task switcher not loaded

ES:DI -> task switcher entry point (see below) if loaded
    AX = 0000h

Note: the returned entry point is that for the most-recently loaded task

  switcher; the entry points for prior task switchers may be determined
  with the "get version" call (see below)

SeeAlso: AX=4A05h,AX=4B03h

Call task switcher entry point with:

AX = 0000h get version
	Return: CF clear if successful
		    AX = 0000h
		    ES:BX -> task switcher version struct (see below)
		CF set if unsupported function
AX = 0001h test memory region
	ES:DI -> first byte to be tested
	CX = size of region to test
	Return: CF clear if successful
		    AX = memory type of tested region
			0000h global
			0001h global and local
			0002h local (replaced on session switch)
		CF set if unsupported function
AX = 0002h suspend switcher
	ES:DI -> new task switcher's entry point
	Return: CF clear if successful
		    AX = state
			0000h switcher has been suspended
			0001h switcher not suspended, new switcher must
				abort
			0002h switcher not suspended, but new switcher
				may run anyway
		CF set if unsupported function
AX = 0003h resume switcher
	ES:DI -> new task switcher's entry point
	Return: CF clear if successful
		    AX = 0000h
		CF set if unsupported function
AX = 0004h hook notification chain
	ES:DI -> callback info structure to be added to chain
		(see AX=4B01h)
	Return: CF clear if successful
		    AX = 0000h
		CF set if unsupported function
AX = 0005h unhook notification chain
	ES:DI -> callback info structure to be removed from chain
		(see AX=4B01h)
	Return: CF clear if successful
		    AX = 0000h
		CF set if unsupported function
AX = 0006h query API support
	BX = asynchronous API identifier
	Return: CF clear if successful
		    AX = 0000h
		    ES:BX -> API info structure (see below) for the
				client which provides the highest
				level of 
		CF set if unsupported function

Format of task switcher version structure: Offset Size Description 00h WORD major version of supported protocol (current protocol is 1.0) 02h WORD minor version of supported protocol 04h WORD major version of task switcher 06h WORD minor version of task switcher 08h WORD task switcher ID (see AX=4B03h) 0Ah WORD operation flags

	bit 0: set if task switcher disabled
	bits 1-15: reserved (0)

0Ch DWORD pointer to ASCIZ task switcher name

	("MS-DOS Shell Task Switcher" for DOSSHELL task switcher)

10h DWORD pointer to previous task switcher's entry point or 0000h:0000h

Format of API info structure: Offset Size Description 00h WORD size of structure in bytes (000Ah) 02h WORD API identifier

	0001h NetBIOS
	0002h 802.2
	0003h TCP/IP
	0004h LAN Manager named pipes
	0005h Novell NetWare IPX

04h WORD major version \ of highest version of API for which the support 06h WORD minor version / level specified in the next field is provided 08h WORD support level

	0001h minimal support
	0002h API-level support
	0003h switcher compatibility
	0004h seamless compatibility

———-2F4B03—————————– INT 2F - DOS v5.0 TASK SWITCHER - ALLOCATE SWITCHER ID

AX = 4B03h
ES:DI -> task switcher entry point (see AX=4B02h)

Return: AX = 0000h

BX = switcher ID (0001h-000Fh), or 0000h if no more available

Notes: if a task switcher has determined that it is the first to be loaded, it

  must allocate an identifier for itself and provide this function to
  all subsequent task switchers; if it is not the first to be loaded,
  it must call this function to allocate an ID.	 The switcher ID is
  used as the high four bits of all session identifiers to ensure
  unique session IDs.
if no more switcher IDs are available, the new task switcher making the
  call must terminate or disable itself
the task switcher providing the identifiers may call the new task
  switcher's entry point as needed
this call is available from within DOSSHELL even if the task switcher
  is not installed

SeeAlso: AX=4B02h,AX=4B04h ———-2F4B04—————————– INT 2F - DOS v5.0 TASK SWITCHER - FREE SWITCHER ID

AX = 4B04h
BX = switcher ID
ES:DI -> task switcher entry point (see AX=4B02h)

Return: AX = 0000h

BX = status
    0000h successful
    other error (invalid ID or ID not allocated)

Notes: called by a task switcher when it exits, unless it was the first loaded

  and is providing the support for AX=4B03h and AX=4B04h
the task switcher providing the identifiers may call the terminating
  task switcher's entry point as needed
this call is available from within DOSSHELL even if the task switcher
  is not installed

SeeAlso: AX=4B02h,AX=4B03h ———-2F4B05—————————– INT 2F - DOS v5.0 DOSSHELL TASK SWITCHER - IDENTIFY INSTANCE DATA

AX = 4B05h
ES:BX = 0000h:0000h
CX:DX -> task switcher entry point (see AX=4B02h)

Return: ES:BX → startup info structure (see below) or 0000h:0000h Notes: called by task switcher

clients with instance data should hook this call, pass it through to
  the previous handler with unchanged registers using a simulated
  interrupt.  On return, the client should create a startup info
  structure (see below), store the returned ES:BX in the "next"
  field, and return the address of the created structure in ES:BX
all MSDOS function calls are available from within this call

SeeAlso: AX=1605h,AX=4B02h

Format of startup info structure: Offset Size Description 00h 2 BYTEs major, minor version of info structure (03h,00h) 02h DWORD pointer to next startup info structure or 0000h:0000h 06h DWORD 0000h:0000h (ignored) 0Ah DWORD ignored 0Eh DWORD pointer to instance data records

Format of one instance data record in array: Offset Size Description 00h DWORD address of instance data (end of array if 0000h:0000h) 04h WORD size of instance data ———-2F53——————————- INT 2F U - ???

AH = 53h
AL = subfunction (0Bh, maybe others???)

Return: ??? Note: called by MS Windows 3.1 POWER.DRV; hooked by MS Mouse driver v8.20+ SeeAlso: AH=54h,INT 33/AX=002Fh ———-2F54——————————- INT 2F U - ???

AH = 54h
AL = subfunction (00h, 01h, maybe others???)

Return: ??? Note: called by MS Windows 3.1 POWER.DRV SeeAlso: AH=53h ———-2F5453—————————– INT 2F - TesSeRact RAM-RESIDENT PROGRAM INTERFACE

AX = 5453h
BX = subfunction
    00h installation check
	CX = 0000h
	DS:SI -> 8-char blank-padded name
	Return: AX = FFFFh installed
			CX = ID number of already-installed copy
		   = anything else, not installed
			CX = ID number for TSR when installed
    01h get user parameters
	CX = TSR ID number
	Return: AX = 0000h successful
		   ES:BX -> user parameter block (see below)
		   = nonzero failed
    02h check if hotkey in use
	CL = scan code of hot key
	Return: AX = FFFFh hot key conflicts with another TSR
		     otherwise safe to use the hotkey
    03h replace default critical error handler
	CX = TSR ID number
	DS:SI -> new routine for INT 24h
	Return: AX = nonzero, unable to install new handler
    04h get internal data area
	CX = TSR ID number
	Return: AX = 0000h
		    ES:BX -> TSR's internal data area (see below)
		   = nonzero, TSR not found
    05h set multiple hot keys
	CX = TSR ID number
	DL = number of additional hot keys to allocate
	DS:SI -> table of hot keys
		BYTE  hotkey scan code
		BYTE  hotkey shift state
		BYTE  flag value to pass to TSR (nonzero)
	Return: AX = nonzero, unable to install hot keys
    06h - 0Fh reserved
    10h enable TSR
	CX = TSR ID number
	Return: AX = nonzero, unable to enable
    11h disable TSR
	CX = TSR ID number
	Return: AX = nonzero, unable to disable
    12h unload TSR
	CX = TSR ID number
	Return: AX = nonzero, invalid TSR number
	Note: if any interrupts used by TSR have been grabbed by
		another TSR, the TesSeRact routines will wait until
		it is safe to remove the indicated TSR from memory
    13h restart TSR
	CX = TSR ID number of TSR which was unloaded but is still in
	     memory
	Return: AX = nonzero, unable to restart TSR
    14h get status word
	CX = TSR ID number
	Return: AX = FFFFh invalid ID number
		   = other, successful
			BX = bit flags
    15h set status word
	CX = TSR ID number
	DX = new bit flags
	Return: AX = nonzero, unable to set status word
    16h get INDOS state at popup
	CX = TSR ID number
	Return: AX = 0000h successful
		    BX = value of INDOS flag
    17h - 1Fh reserved
    20h call user procedure
	CX = TSR ID number
	ES:DI -> user-defined data
	Return: AX = 0000h successful
    21h stuff keystrokes into keyboard buffer
	CX = TSR ID number
	DL = speed
	    00h stuff keystrokes only when buffer is empty
	    01h stuff up to four keystrokes per clock tick
	    02h stuff up to 15 keystrokes per clock tick
	DH = scan code flag
	    if zero, buffer contains alternating ASCII and scan codes
	    if nonzero, buffer contains only ASCII codes
	SI = number of keystrokes
	ES:DI -> buffer to stuff
	Return: AX = 0000h success
		     F0F0h user aborted with ^C or ^Break
		     other unable to stuff keystrokes
    22h (v1.10) trigger popup
	CX = TSR ID number
	Return: AX = 0000h success, TSR will either pop up or beep to
			   indicate that it is unable to pop up
		     nonzero invalid ID number
    23h (v1.10) invoke TSR's background function
	CX = TSR ID number
	Return: AX = 0000h success
		     FFFFh not safe to call background function
		     nonzero invalid ID number
    24h - 2Fh reserved

Notes: Borland's THELP.COM popup help system for Turbo Pascal and Turbo C

  (versions 1.x and 2.x only) fully supports the TesSeRact API, as
  do the SWAP?? programs by Innovative Data Concepts.
AVATAR.SYS supports functions 00h and 01h (only the first three fields
  of the user parameter block) using the name "AVATAR  "

SeeAlso: AX=CAFEh

Format of User Parameter Block: Offset Size Description 00h 8 BYTEs blank-padded TSR name 08h WORD TSR ID number 0Ah DWORD bitmap of supported functions 0Eh BYTE scan code of primary hotkey

	    00h = pop up when shift states match
	    FFh = no popup (if shift state also FFh)

0Fh BYTE shift state of primary hotkey

	    FFh = no popup (if scan code also FFh)

10h BYTE number of secondary hotkeys 11h DWORD pointer to extra hotkeys set by func 05h 15h WORD current TSR status flags 17h WORD PSP segment of TSR 19h DWORD DTA for TSR 1Dh WORD default DS for TSR 1Fh DWORD stack at popup 23h DWORD stack at background invocation

Format of TSR internal data area: Offset Size Description 00h BYTE revision level of TesSeRact library 01h BYTE type of popup in effect 02h BYTE INT 08 occurred since last invocation 03h BYTE INT 13 occurred since last invocation 04h BYTE active interrupts 05h BYTE active soft interrupts 06h BYTE DOS major version 07h BYTE how long to wait before popping up 08h DWORD pointer to INDOS flag 0CH DWORD pointer to DOS critical error flag 10h WORD PSP segment of interrupted program 12h WORD PSP segment of prog interrupted by INT 28 14h DWORD DTA of interrupted program 18h DWORD DTA of program interrupted by INT 28 1Ch WORD SS of interrupted program 1Eh WORD SP of interrupted program 20h WORD SS of program interrupted by INT 28 22h WORD SP of program interrupted by INT 28 24h DWORD INT 24 of interrupted program 28h 3 WORDs DOS 3+ extended error info 2Eh BYTE old BREAK setting 2Fh BYTE old VERIFY setting 30h BYTE were running MS WORD 4.0 before popup 31h BYTE MS WORD 4.0 special popup flag 32h BYTE enhanced keyboard call in use 33h BYTE delay for MS WORD 4.0 11 times (for INTs 08h,09h,13h,16h,1Ch,21h,28h,2Fh,1Bh,23h, and 24h):

DWORD	old interrupt vector
BYTE	interrupt number
WORD	offset in TesSeRact code segment of new interrupt handler

———-2F5500—————————– INT 2F U - DOS v5.0 - COMMAND.COM INTERFACE

AX = 5500h

Return: AX = 0000h

DS:SI -> entry point table

Notes: used to access the shareable portion of COMMAND.COM, which may have

  been moved into the HMA; only the primary COMMAND.COM retains this
  portion
procedures called from a dispatcher in COMMAND's resident portion;
  most assume that the segment address of the resident portion is on
  the stack and are thus not of general use

———-2F6282—————————– INT 2F U - PC Tools v7.0+ VDEFEND, DATAMON - SET ??? ADDRESS

AX = 6282h
CX:DX -> ??? or 0000h:0000h
DI = 0000h ???
     FFFFh ???
     other segment of ???

Return: BX = 0062h Note: if CX:DX = 0000h:0000h on entry, the ??? address is not changed

  (DATAMON only)

SeeAlso: INT 21/AH=FAh“VDEFEND” ———-2F6284BX0000———————– INT 2F U - PC Tools v7.0+ DATAMON - INSTALLATION CHECK

AX = 6284h
BX = 0000h
CX = 0000h

Return: AX = segment of resident code

BX = 5555h
CX = 5555h

———-2F6284BX0001———————– INT 2F U - PC Tools v7.0+ DATAMON - GET ???

AX = 6284h
BX = 0001h
CX = 0001h

Return: AX:BX → ???

CX = BX

———-2F6284BX0002———————– INT 2F U - PC Tools v7.0+ DATAMON - GET ???

AX = 6284h
BX = 0002h
CX = 0002h

Return: AX = ???

BX = ???
CX = AX
DX = BX

———-2F6284BX0003———————– INT 2F U - PC Tools v7.0+ DATAMON - SET ??? FLAGS

AX = 6284h
BX = 0003h
CX = flags
    bit 12: ???
	10: ???
	 5: ???
	 3: ???
DX = flags
    bit 15: ???

———-2F6400—————————– INT 2F - SCRNSAV2.COM - INSTALLATION CHECK

AX = 6400h

Return: AL = 00h not installed

     FFh installed

Note: SCRNSAV2.COM is a screen saver for PS/2's with VGA by Alan Ballard SeeAlso: INT 10/AX=5555h ———-2F7200—————————– INT 2F - SRDISK v1.30 - INSTALLATION CHECK

AX = 7200h

Return: AL = FFh if installed

    ES = segment of device driver header (see below)

Note: SRDISK is a freeware resizeable RAMdisk by Marko Kohtala

Format of device driver header: Offset Size Description 00h 10 BYTEs same as standard device driver header (see INT 21/AH=52h) 0Ah BYTE number of subunits (drives) supported by driver 0Bh 3 BYTEs signature “SRD” 0Eh 4 BYTEs memory type string (currently only “XMS ”) 12h 4 BYTEs ASCII driver version string “N.NN” 16h BYTE 00h 17h BYTE configuration format version (currently 00h) 18h WORD offset of drive configuration data ———-2F7A00—————————– INT 2F - Novell NetWare - LOW-LEVEL API (IPX) INSTALLATION CHECK

AX = 7A00h

Return: AL = 00h not installed

   = FFh installed
	ES:DI -> FAR entry point for routines accessed exclusively
		through INT 7A in NetWare versions through 2.0a.  Call
		with same values as INT 7A

SeeAlso: AX=7AFFh/BX=0000h,AX=D800h,INT 64“Novell”,INT 7A“Novell” ———-2F7A10—————————– INT 2F - Novell NetWare - TBMI v2.0 - GET TBMI STATUS

AX = 7A10h

Return: DH = major TBMI version number

DL = minor TBMI version number
CX = segment address of TBMI resident part
BX = status word of TBMI
	bit 0: INT2F intercepted by TBMI
	bit 1: INT7A intercepted by TBMI
	bit 2: INT64 intercepted by TBMI
	bits 3-14: reserved or unused ???
	bit 15: outstanding task ID was detected

Note: TBMI is the Task-Switched Buffer Manager Interface SeeAlso: AX=7A11h,AX=7A12h,AX=7A13h,AX=7A14h ———-2F7A11—————————– INT 2F - Novell NetWare - TBMI v2.0 - GET INT2F HANDLERS

AX = 7A11h

Return: ES:BX → old INT 2F handler

DS:DX -> TBMI INT 2F handler

SeeAlso: AX=7A10h,AX=7A12h,AX=7A13h ———-2F7A12—————————– INT 2F - Novell NetWare - TBMI v2.0 - GET INT64 HANDLERS

AX = 7A12h

Return: ES:BX → old INT 64 handler

DS:DX -> TBMI INT 64 handler

SeeAlso: AX=7A10h,AX=7A11h,AX=7A13h ———-2F7A13—————————– INT 2F - Novell NetWare - TBMI v2.0 - GET INT7A HANDLERS

AX = 7A13h

Return: ES:BX = old INT 7A handler

DS:DX = TBMI INT 7A handler

SeeAlso: AX=7A10h,AX=7A11h,AX=7A12h ———-2F7A14—————————– INT 2F - Novell NetWare - TBMI v2.0 - GET STATISTICS

AX = 7A14h
CX = statistic to retrieve
    0000h available diagnostic functions???
	Return: CX = maximum available function??? (000Ch for v2.0)
    0001h buffers in use
	Return: CX = TBMI buffers currently in use
    0002h maximum buffers used
	Return: CX = maximum number of buffers ever in use
    0003h unavailable buffers
	Return: CX = count of unavailable TBMI buffers
    0004h old interrupt usage
	Return: CX = TBMI accesses to intercepted old vectors INT 2F,
			INT 64, and INT 7A
    0005h far call usage
	Return: CX = TBMI accesses to IPX/SPX far call handler (not
			including internal accesses)
    0006h task buffering
	Return: CX = TBMI task buffering status (enabled/disabled or
			disable/enable switch count???)
    0007h current task ID
	Return: CX = TBMI current task ID number (0000h if ???)
    0008h outstanding ID count
	Return: CX = number of outstanding TBMI IDs
    0009h configured ECBs
	Return: CX = number of TBMI Event Control Blocks configured
    000Ah configured data ECBs
	Return: CX = number of TBMI data ECBs configured
    000Bh configured sockets
	Return: CX = number of TBMI sockets configured (from NETCFG)
    000Ch current sockets
	Return: CX = number of TBMI sockets currently in use

SeeAlso: AX=7A10h ———-2F7A1B—————————– INT 2F - Novell NetWare - TBMI v2.0 - RESERVED???

AX = 7A1Bh

Note: this call merely performs an IRET ———-2F7A80—————————– INT 2F - Novell NetWare - shell 3.01d - ???

AX = 7A80h

Return: nothing Note: apparently called on abnormal exit of the shell ———-2F7A81—————————– INT 2F - Novell NetWare - shell 3.01d - ???

AX = 7A81h
CX:DX -> ??? in shell's CS (may be callback address or data structure)

Return: nothing??? ———-2F7A85—————————– INT 2F - Novell NetWare - shell 3.01 - BROADCAST INFORM

AX = 7A85h
CX = broadcast server number

Return: CX = 0000h if broadcast message handled by another program

CX unchanged if broadcast not handled

———-2F7AFE—————————– INT 2F - Novell NetWare - shell 3.01d - ???

AX = 7AFEh

Return: AL = FFh ???

     other ???

———-2F7AFFBX0000———————– INT 2F - Novell NetWare - TBMI v2.0 - INSTALLATION CHECK???

AX = 7AFFh
BX = 0000h
CX = 4E65h ("Ne")
DX = 7457h ("tW")
ES:DI -> IPX/SPX special handler (XMS/EMS ???)

Return: AL = FFh if installed

    CX = configured sockets (14h)
    DS:SI -> data table ???
    ES:DI -> IPX far call handler

Note: for IPX/SPX this call reportedly returns DS:DI pointing to the table

  of pointers to service events queue head and tail

SeeAlso: AX=7AFFh/BX=0001h ———-2F7AFFBX0001———————– INT 2F - Novell NetWare - TBMI v2.0, shell v3.01d - INSTALLATION CHECK???

AX = 7AFFh
BX = 0001h
CX = 4E65h ("Ne")
DX = 7457h ("tW")

Return: AL = FFh if installed

    CX = ???  (8000h)
    SI = ??? (or -> ???) (0002h)
    ES:DI -> IPX far call handler
    ES:DX -> 6-byte data area ???

SeeAlso: AX=7AFFh/BX=0000h ———-2F7F24—————————– INT 2F - Multiplex - ???

AX = 7F24h
???

Return: ??? Note: called by PC/370, an IBM 370 emulator by Donald S. Higgins ———-2F7F26—————————– INT 2F - Multiplex - ???

AX = 7F26h
???

Return: ??? Note: called by PC/370, an IBM 370 emulator by Donald S. Higgins


Interrupt List, part 5 of 7 This compilation is Copyright © 1989,1990,1991,1992 Ralf Brown ———-2F8000—————————– INT 2F - EASY-NET - INSTALLATION CHECK

AX = 8000h

Return: AL = 00h not installed

     FFh installed

Note: EASY-NET is a shareware two-machine serial-port network ———-2F8000—————————– INT 2F - Nanosoft, Inc. TurboNET server - INSTALLATION CHECK

AX = 8000h

Return: AL = FFh if installed

    BX = CS of resident code
    CX = ??? (03FCh)

Note: TurboNET is a NetBIOS-based file redirector and server; a demonstration

  version may be downloaded from Nanosoft's BBS

SeeAlso: AX=8100h ———-2F8000DX0000———————– INT 2F - FaxBIOS interface - INSTALLATION CHECK

AX = 8000h
DX = 0000h
DI = 0000h

Return: AL = FFh if installed

DX:DI -> signature "FaxBiosjpc"

Note: FaxBIOS may use any multiplex number from 80h through FFh; to determine

  whether it is installed, it is necessary to poll all multiplex
  numbers for one which returns the above signature

SeeAlso: AH=2Ah,AX=80FBh ———-2F8001—————————– INT 2F - Nanosoft, Inc. TurboNET server - ???

AX = 8001h
DS:SI -> 16-byte buffer for ???

Return: AH = status

    00h successful
    01h error

Note: makes NetBIOS calls ———-2F80FB—————————– INT 2F - FaxBIOS interface - COMMAND SUBMISSION

AX = 80FBh
BX = function number (see below)
DX:DI -> command buffer (see below)

Return: AL = FFh if submitted OK

CX = result code (see below)

Note: FaxBIOS may use any multiplex number from 80h through FFh SeeAlso: AX=8000h“FaxBIOS”,AX=CBDDh

Values for function number: 0001h SYS_LOGIN 0002h SYS_LOGOUT 0003h SYS_GET_FAXAPP_INFO 0004h STAT_IO_GET 0005h STAT_FAXBIOS_GET 0006h PDIR_OPEN 0007h PDIR_CLOSE 0008h PDIR_READ_PERSON 0009h PDIR_PARTIAL_READ 000Ah PDIR_READ_GROUP 000Bh PDIR_READ_MEMBER_LIST 000Ch PDIR_WRITE_PERSON 000Dh PDIR_WRITE_GROUP 000Eh PDIR_DELETE_PERSON 000Fh PDIR_DELETE_GROUP 0010h PDIR_READ_GROUP_LIST 0011h PDIR_IN_GROUP 0012h PDIR_OUT_GROUP 0013h SCHED_OPEN 0014h SCHED_ADD_DEST 0015h SCHED_ADD_FILE 0016h SCHED_SET_PARAMS 0017h SCHED_CANCEL 0018h SCHED_CLOSE 0019h SLOG_OPEN 001Ah SLOG_CLOSE 001Bh SLOG_SHORT_ENV_STAT 001Ch SLOG_LONG_ENV_STAT 001Dh SLOG_DEST_STAT 001Eh SLOG_FILE_STAT 001Fh SLOG_CANCEL_ENV 0020h RLOG_OPEN 0021h RLOG_CLOSE 0022h RLOG_READ 0023h GRAPH_GET_FILE_TYPE 0024h GRAPH_EXPORT_FILE 0025h GRAPH_GET_LAYOUT_INFO 0026h GRAPH_CREATE_FILE 0027h GRAPH_CLOSE_FILE 0028h GRAPH_CREATE_PAGE 0029h GRAPH_WRITE 002Ah GRAPH_END_PAGE 002Bh GRAPH_OPEN_FILE 002Ch GRAPH_GOTO_PAGE 002Dh GRAPH_READ 002Eh IOCTL_GET 002Fh IOCTL_SET 0030h IOCTL_ANSWER_FAX 0031h IOCTL_DIAL

Values for result code: 0000h successful 0001h not prepared or servicing another client (busy) 0002h call failed due to sharing (LOCKED) 0003h logged-in client limit reached (FULL) 0004h transport denied (TRANSPORT_DENIED) 0005h not implemented (NOT_IMPLEMENTED) 0006h aborted while in progress (ABORTED) 0007h permissions denied (PERMISSION_DENIED) 0008h requested data is no longer valid (NO_LONGER_VALID) 0080h unspecified system error occurred 0081h an internal file was not found 0082h an internal file could not be created 0083h an internal file could not be opened 0084h an internal file could not be closed 0085h error occurred writing to an internal file 0086h error occurred reading from an internal file 0087h bad or corrupted file encountered 0088h an access violation occurred 0089h an internal file is empty 008Ah insufficient memory to process request 008Bh FaxBIOS was unable to issue a handle 008Ch an error internal to FaxBIOS occurred 008Dh no room on disk 0100h unspecified error accessing client file 0101h file not found 0102h creation fault 0103h open fault 0104h close fault 0105h write fault 0106h read fault 0107h file corrupted 0108h access violation 0109h empty file 0200h unspecified argument error 0201h bad function 0202h bad option 0203h bad structure size 0204h bad buffer size 0205h bad client ID 0300h unspecified error with token 0301h cover sheet token was invalid 0302h logo token was invalid 0303h signature token was invalid 0304h font token was invalid 0305h phone directory token was invalid 0306h outbound route token was invalid 0307h priority token was invalid 0308h sort token was invalid 0309h billing token was invalid 0400h unspecified handle error 0401h bad Phone Directory handle 0402h bad scheduling handle 0403h bad read send log handle 0404h bad read receive log handle 0405h bad graphics handle 0500h data passed in structure was invalid 0501h name field given is invalid 0502h phone number given is invalid 0503h poll code submitted is invalid 0504h file type constant was invalid 0505h BFT constant not defined or supported 0506h resolution not defined or supported 0507h page length not defined or supported 0508h page width not defined or supported 0509h date & time requested are ridiculous 050Ah Subject text was not an ASCIIZ string 050Bh From text was not an ASCIIZ string 050Ch requested envelope ID was not found 050Dh requested envelope ID is not valid 050Eh envelope requested was not found 050Fh destination index is out of range 0510h file index is out of range 0511h index into receive log is out of range 0512h file name specified was incomplete or invalid 0513h page selected was out of range 0514h bit width more than byte width 0515h mode for open is not defined 0516h person index is out of range 0517h person ID is out of range 0518h group index out of range or invalid 0519h group ID out of range or invalid 051Ah range of indices to read is invalid 051Bh group name given is invalid 051Ch field_to_use is badly specified 051Dh predicate invalid for field specified 0600h unspecified client procedure error 0601h device of interest is not present 0602h device of interest has been removed 0603h device of interest is not responding 0604h device of interest is disabled 0605h could not dial because device was in use 0606h maximum destination limit exceeded 0607h maximum file limit exceeded 0608h scheduling closed with no destination 0609h scheduling closed with no files or poll 060Ah scheduling closed with no parameters specified 060Bh file type specified does not match file 060Ch file type specified is not supported 060Dh file submitted is not exportable 060Eh file type specified is not imageable 060Fh error converting file 0610h envelope could not be cancelled 0611h Phone Directory is full 0612h record is already in the Phone Directory 0613h selected group in Phone Directory is full 0614h person is already in the group 0615h person is not in the group & cannot be removed 0616h a graphics file to be created already exists 0617h a grphics file to be read is empty 0618h GRAPH_CREATE_PAGE called before GRAPH_END_PAGE 0619h graph read or write attempted without goto or create 061Ah graph page contains no data 061Bh Phone Directory is already open for this client 061Ch schedule log is already open for this client 061Dh receive log is aready open for this client 061Eh Phone Directory function requires write mode 0800h denied exclusive use of the API

Format of SYS_LOGIN command buffer: Offset Size Description 00h WORD structure size 02h WORD function number 04h WORD return code 06h WORD client ID 08h WORD API Major Version 0Ah WORD API Minor Version 0Ch DWORD reserved for manufacturer's use 10h 22 BYTEs manufacturer's ID 26h WORD highest possible device number 28h WORD maximum destinations per envelope 2Ah WORD maximum files per envelope 2Ch WORD FaxBIOS capabilities bitmap bit 0: transmit supported

	bit 1: receive supported
	bit 2: IOCTL supported
	bit 3: IOCTL_DIAL supported
	bit 4: IOCTL_ANSWER_FAX supported
	bit 5: manual transmit supported
	bit 6: optional phone services supported
	bit 7: canonical phone objects
	bit 8: seam with next supported

2Eh DWORD T.30 capabilities bitmap bit 0: low vertical resolution (minimum)

	bit 1:  high vertical resolution
	bit 2:  page width 107mm (4.21 in)
	bit 3:  page width 151mm (5.91 in)
	bit 4:  page width 215mm (8.46 in) (minimum)
	bit 5:  page width 255mm (10.04 in)
	bit 6:  page width 303mm (11.93 in)
	bit 7:  unused
	bit 8:  page length 297mm (11.69 in) (minimum)
	bit 9:  page length 364mm (14.33 in)
	bit 10: page length 279mm (11 in)
	bit 11: page length unlimited
	bit 12: Group 4 resolution 300x300
	bit 13: Group 4 resolution 400x400
	bit 14: able to respond to poll from remote
	bit 15: able to poll remote
	bit 16: binary file transfer supported

32h WORD IPC handle 34h DWORD amount of memory needed to load 38h WORD scope (00h for public, nonzero for private) 3Ah 6 BYTEs future expansion 40h WORD structure size

Format of SYS_LOGOUT command buffer: Offset Size Description 00h WORD structure size 02h WORD function number 04h WORD return code 06h WORD client ID 08h DWORD client tag (for client's internal use) 0Ch 6 BYTEs future expansion 12h WORD structure size

Format of SYS_GET_FAXAPP_INFO command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch 80 BYTEs FaxBIOS data 5Ch 80 BYTEs default cover ACh 80 BYTEs default logo FCh 80 BYTEs default signature 14Ch 80 BYTEs default font 10 19Ch 80 BYTEs default font 165 1ECh 80 BYTEs default user font 23Ch 80 BYTEs default Pdir 28Ch 80 BYTEs default sort 2DCh 10 BYTEs default bill 2E6h 10 BYTEs default route 2F0h 40 BYTEs default cover sheet form 318h 34 BYTEs valid dial characters 33Ah 6 BYTEs local country code 340h 6 BYTEs local city or area code 346h 6 BYTEs future expansion 34Ch WORD structure size

Format of STAT_IO_GET command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD device number 0Eh WORD current activity 10h WORD number of rings (if ringing) 12h WORD number of fascimiles transmitted 14h WORD number of fascimiles received 16h WORD status of last transmission 18h WORD envelope number of last transmission 1Ah WORD index of last destination in envelope 1Ch WORD status of last reception 1Eh WORD current page (if session in progress) 20h 80 BYTEs current file 70h104 BYTEs remote number D8h 20 BYTEs last name ECh 20 BYTEs first name 100h 32 BYTEs company name 120h 32 BYTEs notes 140h WORD current envelope ID (if sending) 142h WORD total pages in transmission (if sending) 144h 6 BYTEs future expansion 14h WORD structure size

Format of STAT_FAXBIOS_GET command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD status ID 0Eh WORD currenty FaxBIOS function number 10h WORD current Client ID being serviced 12h WORD number of things to do 14h WORD number of them done 16h WORD number of pages to do (if any) 18h WORD number of them done 1Ah WORD number of files to do 1Ch WORD number of them done 1Eh 80 BYTEs current File 6Eh WORD 0 if all devices are idle 70h WORD number of fascimiles transmitted 72h WORD number of fascimiles received 74h WORD status of last transmission in system 76h WORD envelope ID of last transmission 78h WORD index of last destination in envelope 7Ah WORD status of last reception in system 7Ch DWORD time of next transmission 80h 6 BYTEs future expansion 86h WORD structure size

Format of PDIR_OPEN command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch 80 BYTEs Phone Directory token 5Ch 80 BYTEs sort order token ACh WORD open Mode (0 = read, 1 = write) AEh WORD Phone Directory handle B0h WORD number of people B2h WORD number of groups B4h WORD bitmap of fields supported by partial read B6h 6 BYTEs future expansion BCh WORD structure size

Format of PDIR_CLOSE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD Phone Directory handle 0Eh 6 BYTEs future expansion 14h WORD structure size

Format of PDIR_READ_PERSON command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD Phone Directory handle 0Eh WORD retrieve by index 10h WORD person ID or index 12h WORD how many groups person is in 14h WORD person ID 16h 20 BYTEs last name 2Ah 20 BYTEs first name 3Eh 32 BYTEs company 5Eh 32 BYTEs notes 7Eh 6 BYTEs FAX country code 84h 6 BYTEs FAX city/area code 8Ah 14 BYTEs FAX local number 98h 14 BYTEs FAX extension A6h 24 BYTEs reserved BEh 6 BYTEs voice country code C4h 6 BYTEs voice city/area code CAh 14 BYTEs voice local number D8h 14 BYTEs voice extension E6h 24 BYTEs reserved FEh 10 BYTEs outbound routing information 108h 10 BYTEs billing information, credit card etc 112h DWORD remote FAX capabilities 116h 21 BYTEs T.30 poll code of FAX number 12Bh 15 BYTEs reserved 13Ah 6 BYTEs future expansion 140h WORD structure size

Format of SCHED_OPEN, SCHED_CANCEL command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD scheduler handle 0Eh 6 BYTEs future expansion 14h WORD structure size

Format of SCHED_ADD_DEST command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD schedule handle 0Eh WORD device number if manual send wanted 10h WORD non-zero if poll desired 12h WORD person ID 14h 20 BYTEs last name 28h 20 BYTEs first name 3Ch 32 BYTEs company 5Ch 32 BYTEs notes 7Ch 6 BYTEs FAX country code 82h 6 BYTEs FAX city/area code 88h 14 BYTEs FAX local number 96h 14 BYTEs FAX extension A4h 24 BYTEs reserved BCh 6 BYTEs voice country code C2h 6 BYTEs voice city/area code C8h 14 BYTEs voice local number D6h 14 BYTEs voice extension E4h 24 BYTEs reserved FCh 10 BYTEs outbound routing information 106h 10 BYTEs billing information, credit card etc 110h DWORD remote FAX capabilities 114h 21 BYTEs T.30 poll code of FAX number 129h 15 BYTEs reserved 138h 6 BYTEs future expansion 13Eh WORD structure size

Format of SCHED_ADD_FILE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD schedule handle 0Eh WORD file type

	0000h unidentified
	0001h native file format
	0002h ASCII
	0003h FaxBIOS Tiff Class F

10h 80 BYTEs file name 60h 80 BYTEs font token B0h WORD conversion options bitmap B2h WORD resolution

	0000h standard 98 lines per inch, 204 dpi
	0001h fine 196 lines per inch, 204 dpi
	0002h Group4 300 dpi
	0003h Group4 400 dpi

B4h WORD page length

	0000h 279 mm (11 in)
	0001h 297 mm (11.69 in)
	0002h 364 mm (14.33 in)
	0003h unlimited

B6h WORD page width

	0000h 215 mm (8.46 in)
	0001h 255 mm (10.04 in)
	0002h 303 mm (11.93 in)
	0003h 151 mm (5.91 in)
	0004h 107 mm (4.21 in)

B8h WORD binary file transfer specification

	0000h only as FAX
	0001h only as file (for non-faxable files)
	0002h as file when possible else FAX

BAh WORD seam flag (nonzero for seam with next) BCh WORD delete flag (nonzero to delete when done) BEh 6 BYTEs future expansion C4h WORD structure size

Format of SCHED_SET_PARAMS command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD scheduler handle 0Eh DWORD time to send 10h 10 BYTEs priority token 1Ch 80 BYTEs logo file token 6Ch 80 BYTEs signature file token BCh 80 BYTEs cover page token 10Ch 40 BYTEs Subject text 134h 40 BYTEs From text 15Ch WORD user ID 15Eh 6 BYTEs future expansion 164h WORD structure size

Format of SCHED_CLOSE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD scheduler handle 0Eh WORD envelope ID generated 10h 6 BYTEs future expansion 16h WORD structure size

Format of SLOG_OPEN, SLOG_CLOSE, RLOG_OPEN, RLOG_CLOSE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD log handle 0Eh WORD number of entries 10h 6 BYTEs future expansion 16h WORD structure size

Format of GRAPH_GET_FILE_TYPE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch 80 BYTEs filename 5Ch WORD file type

	0000h unidentified
	0001h native file format
	0002h ASCII
	0003h FaxBIOS Tiff Class F

5Eh WORD bitmap of supported capabilities 60h 6 BYTEs future expansion 66h WORD structure size

Format of GRAPH_CREATE_FILE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch 80 BYTEs filename 5Ch WORD graph handle 5Eh 6 BYTEs future expansion 64h WORD structure size

Format of GRAPH_CLOSE_FILE, GRAPH_END_PAGE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD graph handle 0Eh 6 BYTEs future expansion 14h WORD structure size

Format of GRAPH_CREATE_PAGE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD graph handle 0Eh WORD resolution 10h WORD page width 12h 6 BYTEs future expansion 18h WORD structure size

Format of GRAPH_WRITE_PAGE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD graph handle 0Eh DWORD pointer to storage for image 12h WORD band height in lines 14h WORD width of page image in bytes 16h WORD facsimile page width constant 18h WORD width of page image in bits 1Ah WORD number of bytes actually processed 1Ch 6 BYTEs future expansion 22h WORD structure size

Format of GRAPH_OPEN_FILE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch 80 BYTEs filename 5Ch WORD file type 5Eh WORD graph handle 60h WORD number of pages 62h 6 BYTEs future expansion 68h WORD structure size

Format of GRAPH_GOTO_PAGE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD graph handle 0Eh WORD page number 10h WORD vertical resolution 12h WORD page width 14h DWORD page length 18h 6 BYTEs future expansion 1Eh WORD structure size

Format of GRAPH_READ_PAGE command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD graph handle 0Eh DWORD pointer to storage for image 12h WORD band height in lines 14h WORD width of page image in bytes 16h WORD facsimile page width constant 18h WORD width of page image in bits 1Ah WORD number of bytes actually processed 1Ch 6 BYTEs future expansion 22h WORD structure size

Format of IOCTL_ANSWER_FAX command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD device number 0Eh 6 BYTEs future expansion 14h WORD structure size

Format of IOCTL_DIAL command buffer: Offset Size Description 00h 12 BYTEs common data (see SYS_LOGOUT above) 0Ch WORD device number 0Eh 6 BYTEs country code 14h 6 BYTEs city or area code 1Ah 14 BYTEs local number 28h 14 BYTEs extension 36h 14 BYTEs reserved 4Eh 6 BYTEs future expansion 54h WORD structure size ———-2F8100—————————– INT 2F U - Nanosoft, Inc. TurboNET redirector - INSTALLATION CHECK

AX = 8100h

Return: AL = FFh if installed Note: TurboNET is a NetBIOS-based file redirector and server; a demonstration

  version may be downloaded from Nanosoft's BBS

SeeAlso: AX=8000h“TurboNET” ———-2F8101—————————– INT 2F U - Nanosoft, Inc. TurboNET redirector - ???

AX = 8101h

Return: AL = ???

DL = ???

———-2F8102—————————– INT 2F U - Nanosoft, Inc. TurboNET redirector - ???

AX = 8102h

Return: AL = ???

DL = ???

———-2F8103—————————– INT 2F U - Nanosoft, Inc. TurboNET redirector - GET MACHINE NAME???

AX = 8103h
ES:DI -> 17-byte buffer

Return: buffer filled ———-2F8104—————————– INT 2F U - Nanosoft, Inc. TurboNET redirector - ???

AX = 8104h
BL = ???
BH = ???
CX = ???
DX = ???
DS:SI -> 16-byte buffer containing ???

Return: AL = 00h ??? ———-2F8105—————————– INT 2F U - Nanosoft, Inc. TurboNET redirector - ???

AX = 8105h
CX = ??? (don't change current value if 0000h)
DX = ??? (don't change current value if 0000h)

Return: AL = 00h successful ———-2F82——————————- INT 2F U - Nanosoft, Inc. TurboNET - ???

AH = 82h
???

Return: ??? Note: called by TNR.EXE, the TurboNET redirector configuration program SeeAlso: AX=8100h ———-2F8200—————————– INT 2F - RESPLAY - SAMPLE/PLAYBACK

AX = 8200h
DX:DI -> start of sample space
CX:BX = length in bytes

Return: AX = status

    1000h successful
    2000h not initialized (see AX=8210h)
    other RESPLAY not installed

Note: RESPLAY is a freeware sound sampling/playback utility by Mark J. Cox SeeAlso: AX=8201h,AX=8210h ———-2F8201—————————– INT 2F - RESPLAY - INSTALLATION CHECK

AX = 8201h

Return: AX = 7746h if installed SeeAlso: AX=8202h ———-2F8202—————————– INT 2F - RESPLAY - UNINSTALL

AX = 8202h

Return: AX = status

    1000h successful

SeeAlso: AX=8201h ———-2F8210—————————– INT 2F - RESPLAY - INITIALIZE

AX = 8210h
BL = sound device
    00h printer port LPT1
    01h printer port LPT2
    02h prototype board at I/O address 0300h
    03h printer port (alternative LPT1)
    04h internal speaker
BH = sample rate in multiples of 250 Hz (14h to A0h)
CL = direction
    00h playback
    01h sample

Return: AX = status

    1000h successful
    2000h parameter out of range
    other RESPLAY not installed

SeeAlso: AX=8200h ———-2F86——————————- INT 2F U - ???

AH = 86h
AL = function (at least 06h and 07h)
???

Return: ??? Note: called by Codeview for Windows SeeAlso: AH=44h ———-2F8900—————————– INT 2F - WHOA!.COM - INSTALLATION CHECK

AX = 8900h

Return: AL = 00h not installed

   = FFh installed

Note: WHOA!.COM is a system slow-down utility by Brad D Crandall SeeAlso: AX=8901h,AX=8902h ———-2F8901—————————– INT 2F - WHOA!.COM - UNINSTALL

AX = 8901h

Return: AL = FDh successful

   = FEh error

Note: WHOA!.COM is a system slow-down utility by Brad D Crandall SeeAlso: AX=8900h ———-2F8902—————————– INT 2F - WHOA!.COM - SET DELAY COUNT

AX = 8902h
BX = delay count (larger values slow system down more)

Return: AL = FDh successful

   = FEh error

Note: WHOA!.COM is a system slow-down utility by Brad D Crandall SeeAlso: AX=8900h ———-2F9000—————————– INT 2F U - RAID - INSTALLATION CHECK

AX = 9000h

Return: AL = FFh if installed Note: RAID (Resident AID) is a TSR utility program by Ross Neilson Wentworth

  that resides mostly in EMS

———-2F9001—————————– INT 2F U - RAID - GET ???

AX = 9001h

Return: DX:AX → ??? SeeAlso: AX=9000h ———-2F9002—————————– INT 2F U - RAID - GET RESIDENT SEGMENT

AX = 9002h

Return: AX = segment of resident (conventional memory) portion SeeAlso: AX=9000h ———-2F9003—————————– INT 2F U - RAID - UNINSTALL

AX = 9003h

Return: ??? SeeAlso: AX=9000h ———-2F9004—————————– INT 2F U - RAID - GET ???

AX = 9004h

Return: AX = first available paragraph past end of resident portion???

CX destroyed

SeeAlso: AX=9000h ———-2F92——————————- INT 2F - Couriers LAN E-Mail - API

AH = 92h
AL = function
    00h installation check
    01h uninstall
    02h pop down MICRO.EXE notification window
    03h ???
    04h ???
    05h ???

Return: ??? SeeAlso: AH=9Ch ———-2F93——————————- INT 2F - InnerMission v1.7+ - INSTALLATION CHECK

AH = 93h
BX = CX = AX

Return: AL = FFh if installed and BX=CX=AX on entry

    BX = segment of resident code
   = 01h if installed but BX or CX differ from AX

Note: InnerMission is a shareware graphical screen blanker by Kevin Stokes ———-2F9C——————————- INT 2F - Couriers LAN E-Mail OPERATOR.EXE - API

AH = 9Ch
AL = subfunction
    01h uninstall

Return: ??? SeeAlso: AH=92h ———-2FA1–BX0081———————– INT 2F - Ergo DOS extenders - INSTALLATION CHECK

AH = A1h
BX = 0081h
AL = which
    FEh OS/286,OS/386
    FFh HummingBoard DOS extender
ES:DI -> 16-byte buffer

Return: if installed, first four bytes of ES:DI buffer are “IABH” Note: since TKERNEL is a licensed version, it is likely that subfunctions

  BX=0082h and BX=0084h are present and function identically to the
  AX=FBA1h/BX=008xh calls

SeeAlso: AX=ED00h,AX=FBA1h,INT 15/AX=BF02h ———-2FA189—————————– INT 2F U - Biologic HRAMDEV.SYS - API

AX = A189h
BX = subfunction
    0000h set ???
    0001h remove ???
    0002h get status ???
    0003h enable ???
    0004h disable ???
    0005h set ??? flag
    0006h clear ??? flag
    0007h set ??? flag
    0008h clear ??? flag
    0009h set ???
ES:DI -> function-specific arguments
	if func 0000h: 20-byte buffer containing ???
	if func 0001h: 20-byte buffer for returned ???
	if func 0002h: 16-byte buffer for returned ???
	if func 0009h: WORD containing ???

Return: BX = A189h if installed

AH = status
    00h successful
    FFh failed or invalid function number

Notes: HRAMDEV.SYS is a part of the shareware package HRAM by Biologic which

  provides improved high memory access under MSDOS 5.0
functions 00h and 01h use a stack of four entries; function 01h always
  removes the values stored with the most recent function 00h call
  which has not yet been matched with a function 01h call.

———-2FA900—————————– INT 2F - METZTSR.COM - INSTALLATION CHECK

AX = A900h
CF set

Return: CF clear if resident

    AX = 97FFh
CF set if not present

Notes: METZTSR.COM prevents METZ applications (such as the MAGIC screen

  saver) inactivity timeout while running a DOSapp under MS Windows.
the default multiplex number is A9h, but may be set to any value from
  80h to FFh with a commandline switch

SeeAlso: AX=A901h,AX=A902h ———-2FA901—————————– INT 2F - METZTSR.COM - GET TIME OF LAST KEYBOARD ACTIVITY

AX = A901h
CF set

Return: CF clear if successful

    AX:DX = BIOS time at which INT 09 was last invoked
CF set if not present

SeeAlso: INT 09,INT 1A/AH=00h ———-2FA902—————————– INT 2F - METZTSR.COM - SET METZ Ctrl-Alt-Del FLAG

AX = A902h
BL = new value
    00h Ctrl-Alt-Del not allowed
    else Ctrl-Alt-Del allowed (startup default is 01h)
CF set

Return: CF clear if successful

    AX = 97FFh
CF set if not resident

SeeAlso: AX=A903h ———-2FA903—————————– INT 2F - METZTSR.COM - GET METZ Ctrl-Alt-Del FLAG

AX = A903h
CF set

Return: CF clear if successful

    AX = 97FFh if Ctrl-Alt-Del allowed
    AX = 0000h if Ctrl-Alt-Del not allowed
CF set if not resident

SeeAlso: AX=A902h ———-2FAA00—————————– INT 2F - VIDCLOCK.COM - INSTALLATION CHECK

AX = AA00h

Return: AL = 00h not installed

     FFh installed

Note: VIDCLOCK.COM is a memory-resident clock by Thomas G. Hanlin III ———-2FAB00—————————– INT 2F - Btrieve Multi-User - INSTALLATION CHECK

AX = AB00h

Return: AL = 4Dh if installed SeeAlso: AX=AB01h,AX=AB02h,INT 21/AX=3000h“Btrieve”,INT 7B“Btrieve” ———-2FAB01—————————– INT 2F - Btrieve Multi-User - EXECUTE Btrieve OPERATION

AX = AB01h
BX = process ID
DS:DX -> 38-byte parameter record (see INT 7B"Btrieve")

Return: AL = 00h OK

   = other retry after calling INT 7F/AX=0200h

SeeAlso: AX=AB00h,AX=AB02h,INT 7B“Btrieve”,INT 7F/AX=0200h ———-2FAB02—————————– INT 2F - Btrieve Multi-User - GET NEW PROCESS ID

AX = AB02h

Return: AL = 00h succesful

    BX = process ID
AL > 00h failed, retry after calling INT 7F/AX=0200h

SeeAlso: AX=AB00h,AX=AB01h,INT 7B“Btrieve”,INT 7F/AX=0200h ———-2FAC00—————————– INT 2F - DOS 4.01+ GRAPHICS.COM - INSTALLATION CHECK

AX = AC00h

Return: AX = FFFFh

ES:DI -> ??? (graphics data?) (not documented)

Note: this installation check was moved here to avoid the conflict with the

  CD-ROM extensions that occurred in DOS 4.00

SeeAlso: AX=1500h“GRAPHICS” ———-2FAD00—————————– INT 2F U - DOS 3.3+ DISPLAY.SYS internal - INSTALLATION CHECK

AX = AD00h

Return: AL = FFh if installed

    BX = ??? (0100h in MS-DOS 3.30, PCDOS 4.01)

Note: DOS 5.0 DISPLAY.SYS chains to previous handler if AL is not one of the

  subfunctions listed here

———-2FAD01—————————– INT 2F U - DOS 3.3+ DISPLAY.SYS internal - SET ???

AX = AD01h
BX = ???

Return: ???

CF set on error

———-2FAD02—————————– INT 2F U - DOS 3.3+ DISPLAY.SYS internal - GET ???

AX = AD02h

Return: BX = ??? (value set with AX=AD01h) ———-2FAD03—————————– INT 2F U - DOS 3.3+ DISPLAY.SYS internal - GET ???

AX = AD03h
ES:DI -> user buffer
CX = size of buffer

Return: CF set if buffer too small

CF clear if successful

———-2FAD04—————————– INT 2F U - DOS 4.x only DISPLAY.SYS internal - ???

AX = AD04h
???

Return: ??? ———-2FAD10—————————– INT 2F U - DOS 4+ DISPLAY.SYS internal - INSTALLATION CHECK???

AX = AD10h
???

Return: AX = FFFFh

BX = ??? (0100h in PCDOS 4.01)

———-2FAD40—————————– INT 2F - DOS 4.0 - ???

AX = AD40h
DX = ???
???

Return: ??? Note: called by PCDOS 4.01 PRINT.COM ———-2FAD80—————————– INT 2F - DOS 3.3+ KEYB.COM internal - INSTALLATION CHECK

AX = AD80h

Return: AL = FFh if installed

    BX = version number (BH = major, BL = minor)
    ES:DI -> internal data (see below)

Note: MSDOS 3.30, PCDOS 4.01, and MSDOS 5.00 all report version 1.00.

Format of KEYB internal data: Offset Size Description 00h DWORD original INT 09 04h DWORD original INT 2F 08h 6 BYTEs ??? 0Eh WORD flags 10h BYTE ??? 11h BYTE ??? 12h 4 BYTEs ??? 16h 2 BYTEs country ID letters 18h WORD current code page —DOS 3.3— 1Ah WORD pointer to first item in list of code page tables??? 1Ch WORD pointer to ??? item in list of code page tables 1Eh 2 BYTEs ??? 20h WORD pointer to key translation data 22h WORD pointer to last item in code page table list (see below) 24h 9 BYTEs ??? —DOS 4.01— 1Ah 2 BYTEs ??? 1Ch WORD pointer to first item in list of code page tables??? 1Eh WORD pointer to ??? item in list of code page tables 20h 2 BYTEs ??? 22h WORD pointer to key translation data 24h WORD pointer to last item in code page table list (see below) 26h 9 BYTEs ???

Format of code page table list entries: Offset Size Description 00h WORD pointer to next item, FFFFh = last 02h WORD code page 04h 2 BYTEs ???

Format of translation data: Offset Size Description 00h WORD size of data in bytes, including this word 02h N-2 BYTEs ??? ———-2FAD81—————————– INT 2F - DOS 3.3+ KEYB.COM - SET KEYBOARD CODE PAGE

AX = AD81h
BX = code page (see INT 21/AX=6601h)

Return: CF set on error

    AX = 0001h (code page not available)
CF clear if successful

Notes: called by DISPLAY.SYS

documented for DOS 5+, but undocumented for earlier versions

SeeAlso: AX=AD82h ———-2FAD82—————————– INT 2F - DOS 3.3+ KEYB.COM - SET KEYBOARD MAPPING

AX = AD82h
BL = new state
    00h US keyboard (Control-Alt-F1)
    FFh foreign keyboard (Control-Alt-F2)

Return: CF set on error (BL not 00h or FFh)

CF clear if successful

Note: documented for DOS 5+, but undocumented for earlier versions SeeAlso: AX=AD81h,AX=AD83h ———-2FAD83—————————– INT 2F - DOS 5.0 KEYB.COM - GET KEYBOARD MAPPING

AX = AD83h

Return: BL = current state

    00h US keyboard
    FFh foreign keyboard

SeeAlso: AX=AD82h ———-2FAE00DXFFFF———————– INT 2F U - DOS 3.3+ internal - INSTALLABLE COMMAND - INSTALLATION CHECK

AX = AE00h
DX = FFFFh
CH = FFh
CL = length of command line tail (4DOS v4.0)
DS:BX -> command line buffer (see below)
DS:SI -> command name buffer (see below)
DI = 0000h (4DOS v4.0)

Return: AL = FFh if this command is a TSR extension to COMMAND.COM

AL = 00h if the command should be executed as usual

Notes: This call provides a mechanism for TSRs to install permanent

  extensions to the command repertoire of COMMAND.COM.	It appears
  that COMMAND.COM makes this call before executing the current
  command line, and does not execute it itself if the return is FFh.
APPEND hooks this call, to allow subsequent APPEND commands to
  execute without re-running APPEND

Format of command line buffer: Offset Size Description 00h BYTE max length of command line, as in INT 21/AH=0Ah 01h BYTE count of bytes to follow, excluding terminating 0Dh

    N BYTEs	command line text, terminated by 0Dh

Format of command name buffer: Offset Size Description 00h BYTE length of command name 01h N BYTEs uppercased command name (blank-padded to 11 chars by 4DOS v4) ———-2FAE01DXFFFF———————– INT 2F U - DOS 3.3+ internal - INSTALLABLE COMMAND - EXECUTE

AX = AE01h
DX = FFFFh
CH = 00h
CL = length of command name (4DOS v4.0)
DS:SI -> command name buffer (see AX=AE00h)
DS:BX -> command line buffer (see AX=AE00h)

Return: DS:SI buffer updated

  if length byte is nonzero, the following bytes contain the uppercase
  internal command to execute and the command line buffer contains the
  command's parameters (the first DS:[SI] bytes are ignored)

Notes: this call requests execution of the command which a previous call to

  AX=AE00h indicated was resident
APPEND hooks this call

———-2FB000—————————– INT 2F - DOS 3.3+ GRAFTABL.COM - INSTALLATION CHECK

AX = B000h

Return: AL = 00h not installed, OK to install

   = 01h not installed, not OK to install
   = FFh installed

Notes: called by DISPLAY.SYS

documented for DOS 5.0, but undocumented in prior versions

SeeAlso: AX=B001h ———-2FB001—————————– INT 2F - DOS 3.3+ GRAFTABL.COM - GET GRAPHICS FONT TABLE

AX = B001h
DS:BX -> DWORD buffer for address of 8x8 font table

Return: buffer filled

AL = FFh

Note: PCDOS 3.30/4.01 set the font table offset to 0130h, MSDOS 3.30 to 0030h SeeAlso: AX=B000h ———-2FB400—————————– INT 2F - IBM PC3270 EMULATION PROG v3 - INSTALLATION CHECK

AX = B400h

Return: AL = FFh if installed ———-2FB401—————————– INT 2F - IBM PC3270 EMULATION PROG v3 - GET HOST BUFFER ADDRESS

AX = B401h

Return: ES → host screen buffer (PC ASCII format)

ES unchanged if communications not started

———-2FB402—————————– INT 2F - IBM PC3270 EMULATION PROG v3 - ???

AX = B402h
BX = ???

Return: ??? ———-2FB403—————————– INT 2F - IBM PC3270 EMULATION PROG v3 - ???

AX = B403h
???

Return: ??? ———-2FB404—————————– INT 2F - IBM PC3270 EMULATION PROG v3 - ???

AX = B404h
???

Return: ??? ———-2FB405—————————– INT 2F - IBM PC3270 EMULATION PROG v3 - ???

AX = B405h
???

Return: ??? ———-2FB700—————————– INT 2F - APPEND - INSTALLATION CHECK

AX = B700h

Return: AL = status

    00h not installed
    FFh installed

Note: MSDOS 3.30 APPEND refuses to install itself when run inside TopView or

  a TopView-compatible environment

———-2FB701—————————– INT 2F U - APPEND - ???

AX = B701h
???

Return: ??? Note: MSDOS 3.30 APPEND displays “Incorrect APPEND Version” and aborts caller ———-2FB702—————————– INT 2F - APPEND - VERSION CHECK

AX = B702h

Return: AX = FFFFh if not DOS 4.0 APPEND (also if DOS 5.0 APPEND)

AL = major version number
AH = minor version number, otherwise

SeeAlso: AX=B710h ———-2FB703—————————– INT 2F U - DOS 3.3, DOS 5.0 APPEND - HOOK INT 21

AX = B703h
ES:DI -> INT 21 handler APPEND should chain to

Return: ES:DI → APPEND's INT 21 handler Note: each invocation of this function toggles a flag which APPEND uses to

  determine whether to chain to the user handler or the original
  INT 21

———-2FB704—————————– INT 2F - DOS 3.3+ APPEND - GET APPEND PATH

AX = B704h

Return: ES:DI → active APPEND path (128 bytes max) ———-2FB706—————————– INT 2F - DOS 4+ APPEND - GET APPEND FUNCTION STATE

AX = B706h

Return: BX = APPEND state

    bit 0: set if APPEND enabled
    bits 1-11 reserved
    bit 12: (DOS 5.0) set if APPEND applies directory search even if a
		drive has been specified
    bit 13: set if /PATH flag active
    bit 14: set if /E flag active (environment var APPEND exists)
    bit 15: set if /X flag active

———-2FB707—————————– INT 2F - DOS 4+ APPEND - SET APPEND FUNCTION STATE

AX = B707h
BX = APPEND state bits (see AX=B706h)

———-2FB710—————————– INT 2F U - DOS 3.3+ APPEND - GET VERSION INFO

AX = B710h

Return: AX = current APPEND state (see AX=B706h)

BX = ??? (0000h in MSDOS 3.30 and 5.00)
CX = ??? (0000h in MSDOS 3.30 and 5.00)
DL = major version
DH = minor version

SeeAlso: AX=B702h ———-2FB711—————————– INT 2F - DOS 4+ APPEND - SET RETURN FOUND NAME STATE

AX = B711h

Note: if the next INT 21h call (and ONLY the next) is function 3Dh, 43h, or

6Ch (also 4B03h and 4Eh if /X active), the fully qualified filename is
written over top of the filename passed to the INT 21h call.  The
application must provide a sufficiently large buffer.  This state is
reset after the next INT 21h call processed by APPEND.

BUG: DOS 4.0 APPEND reportedly overwrites DS:DX instead of DS:SI for

  INT 21/AH=6Ch

SeeAlso: INT 21/AH=4Eh ———-2FB800—————————– INT 2F - network - INSTALLATION CHECK

AX = B800h

Return: AL = status

    00h	    not installed
    nonzero installed
      BX = installed component flags (test in this order!)
	   bit 6   server
	   bit 2   messenger
	   bit 7   receiver
	   bit 3   redirector

———-2FB803—————————– INT 2F - network - GET NETWORK EVENT POST HANDLER

AX = B803h

Return: ES:BX → event post handler (see AX=B804h) SeeAlso: AX=B804h,AX=B903h ———-2FB804—————————– INT 2F - network - SET NETWORK EVENT POST HANDLER

AX = B804h
ES:BX -> new event post handler

Notes: used in conjunction with AX=B803h to hook into the network event post

  routine
The specified handler is called on any network event.  Two events are
  defined: message received and critical network error.

SeeAlso: AX=B803h,AX=B904h

Values post routine is called with:

AX = 0000h single block message
    DS:SI -> ASCIZ originator name
    DS:DI -> ASCIZ destination name
    ES:BX -> text header (see below)
AX = 0001h start multiple message block
    CX = block group ID
    DS:SI -> ASCIZ originator name
    DS:DI -> ASCIZ destination name
AX = 0002h multiple block text
    CX = block group ID
    ES:BX -> text header (see below)
AX = 0003h end multiple block message
    CX = block group ID
AX = 0004h message aborted due to error
    CX = block group ID
AX = 0101h server received badly formatted network request
    Return: AX = FFFFh (PC LAN will process error)
AX = 0102h unexpected network error
    ES:BX -> NCB (see INT 5C)
AX = 0103h server received INT 24 error
    other registers as for INT 24, except AH is in BH
    Return: as below, but only 0000h and FFFFh allowed

Return: AX = response code

    0000h user post routine processed message
    0001h PC LAN will process message, but message window not displayed
    FFFFh PC LAN will process message

Format of text header: Offset Size Description 00h WORD length of text (maximum 512 bytes) 02h N BYTEs text of message Note: all CRLF sequences in message text are replaced by 14h ———-2FB807—————————– INT 2F - Network - GET NetBIOS NAME NUMBER OF MACHINE NAME

AX = B807h

Return: CH = NetBIOS name number of the machine name SeeAlso: INT 21/AX=5E00h ———-2FB808—————————– INT 2F U - Network - RELINK KEYBOARD HANDLER

AX = B908h
ES:BX -> INT 09 handler RECEIVER should call after it finishes INT 09

Notes: this call replaces the address to which RECEIVER.COM chains on an

  INT 09 without preserving the original value.	 This allows a prior
  handler to unlink, but does not allow a new handler to be added
  such that RECEIVER gets the INT 09 first unless it completely takes
  over INT 09 and never chains.
called by DOS 3.2 KEYBxx.COM

SeeAlso: AX=B908h ———-2FB809—————————– INT 2F - LANtastic Network, NetWare Lite - VERSION CHECK

AX = B809h

Return: AH = major version

AL = minor version (decimal)

———-2FB900—————————– INT 2F - PC Network RECEIVER.COM - INSTALLATION CHECK

AX = B900h

Return: AL = 00h if not installed

     FFh if installed

———-2FB901—————————– INT 2F - PC Network RECEIVER.COM - GET RECEIVER.COM INT 2F HANDLER ADDRESS

AX = B901h

Return: AL = ???

ES:BX -> RECEIVER.COM INT 2F handler

Note: allows more efficient execution by letting the caller bypass any other

  INT 2F handlers which have been added since RECEIVER.COM was
  installed

———-2FB903—————————– INT 2F - PC Network RECEIVER.COM - GET RECEIVER.COM POST ADDRESS

AX = B903h

Return: ES:BX → POST handler SeeAlso: AX=B803h,AX=B904h ———-2FB904—————————– INT 2F - PC Network RECEIVER.COM - SET RECEIVER.COM POST ADDRESS

AX = B904h
ES:BX -> new POST handler

SeeAlso: AX=B804h,AX=B903h ———-2FB905—————————– INT 2F - PC Network RECEIVER.COM - GET FILENAME

AX = B905h
DS:BX -> 128-byte buffer for filename 1
DS:DX -> 128-byte buffer for filename 2

Return: buffers filled from RECEIVER.COM internal buffers Note: use of filenames is unknown, but one appears to be for storing messages SeeAlso: AX=B906h ———-2FB906—————————– INT 2F - PC Network RECEIVER.COM - SET FILENAME

AX = B906h
DS:BX -> 128-byte buffer for filename 1
DS:DX -> 128-byte buffer for filename 2

Return: RECEIVER.COM internal buffers filled from user buffers Note: use of filenames is unknown, but one appears to be for storing messages SeeAlso: AX=B905h ———-2FB908—————————– INT 2F - PC Network RECEIVER.COM - UNLINK KEYBOARD HANDLER

AX = B908h
ES:BX -> INT 09 handler RECEIVER should call after it finishes INT 09

Note: this call replaces the address to which RECEIVER.COM chains on an

  INT 09 without preserving the original value.	 This allows a prior
  handler to unlink, but does not allow a new handler to be added
  such that RECEIVER gets the INT 09 first.

SeeAlso: AX=B808h ———-2FBC00—————————– INT 2F - Windows 3.0, DOS 5.0 EGA.SYS - INSTALLATION CHECK

AX = BC00h

Return: AL = 00h not installed, OK to install

   = 01h not installed, not OK to install
   = FFh installed
	BX = 5456h ("TV")

Note: AH=BCh is the default value, which may be changed by a command line

  parameter to any value between 80h and FFh

SeeAlso: AX=BC06h,INT 10/AH=FAh“EGA” ———-2FBC06—————————– INT 2F U - MS Windows 3.0, DOS 5.0 EGA.SYS - GET VERSION INFO

AX = BC06h

Return: BX = 5456h (“TV”)

CH = major version
CL = minor version
DL = revision

SeeAlso: AX=BC00h,INT 10/AH=FAh“EGA” ———-2FBE00—————————– INT 2F - REDVIEW - INSTALLATION CHECK

AX = BE00h

Return: AL = FFh if installed Note: REDVIEW is a public-domain TSR by Alexandr Novy and Petr Horak which

  copies data sent to standard output to standard error when the
  former has been redirected to a file, thus allowing the data to
  be seen on the screen at the same time it is captured in a file

———-2FBF00—————————– INT 2F - PC LAN PROGRAM REDIRIFS.EXE internal - INSTALLATION CHECK

AX = BF00h

Return: AL = FFh if installed ———-2FBF01—————————– INT 2F U - PC LAN PROGRAM REDIRIFS.EXE internal - ???

AX = BF01h
???

Return: ??? ———-2FBF80—————————– INT 2F - PC LAN PROG REDIR.SYS internal - SET REDIRIFS ENTRY POINT

AX = BF80h
ES:DI -> FAR entry point to IFS handler in REDIRIFS

Return: AL = FFh if installed

    ES:DI -> internal workspace

Note: all future IFS calls to REDIR.SYS are passed to the ES:DI entry point ———-2FC000—————————– INT 2F - Novell ODI Link Support Layer (LSL.COM) - INSTALLATION CHECK

AX = C000h

Return: AL = FFh

ES:BX -> call entry point
ES:SI -> signature string "LINKSUP$"

Note: LSL.COM may use any multiplex number between C0h and FFh; it searches

  for itself in that range, and installs using the first free multiplex
  number in the range if not already loaded.

———-2FC050—————————– INT 2F U - Explosiv 2.00 - INSTALLATION CHECK

AX = C050h

Return: AL = 51h if installed Notes: Explosiv is a shareware animated screen blanker for DOS and Windows 3

  by Reidar Gresseth and Chris Hook
AH=C0h is the default multiplex number, but may be reconfigured to
  any value from C0h to C9h

SeeAlso: AX=C051h ———-2FC052—————————– INT 2F U - Explosiv 2.00 - UNINSTALL

AX = C052h
DX:BX = address to return to on successful uninstall

Return: at specified address if successful

AL = 53h on error

Note: specified return address must have the segment of the caller's PSP SeeAlso: AX=C050h ———-2FC054—————————– INT 2F U - Explosiv 2.00 - GET ???

AX = C054h

Return: AL = ??? Note: returns value set by AX=C057h SeeAlso: AX=C057h ———-2FC055—————————– INT 2F U - Explosiv 2.00 - SET BLANKING INTERVAL

AX = C055h
BX = new interval in clock ticks

———-2FC056—————————– INT 2F U - Explosiv 2.00 - SET ???

AX = C056h
BL = ???

———-2FC057—————————– INT 2F U - Explosiv 2.00 - SET ???

AX = C057h
BL = ???

SeeAlso: AX=C054h ———-2FC058—————————– INT 2F U - Explosiv 2.00 - SET ???

AX = C058h
BL = ???

———-2FC059—————————– INT 2F U - Explosiv 2.00 - CLEAR ???

AX = C059h

Note: clears flag set by AX=C05Ah SeeAlso: AX=C05Ah ———-2FC05A—————————– INT 2F U - Explosiv 2.00 - SET ???

AX = C05Ah
BL = ???

Note: sets flag cleared by AX=C059h then stores BL SeeAlso: AX=C059h ———-2FC05B—————————– INT 2F U - Explosiv 2.00 - SET ???

AX = C05Bh
BL = ???

———-2FC05C—————————– INT 2F U - Explosiv 2.00 - SET ???

AX = C05Ch
BL = ???

———-2FC900BP0000———————– INT 2F U - ThunderByte??? - INSTALLATION CHECK

AX = C900h
BP = 0000h

Return: AL = FFh if installed

    BP >= 0014h

Note: called by TBSCANX SeeAlso: AX=C987h,AX=CA00h ———-2FC987—————————– INT 2F U - ThunderByte??? - DISINFECT FILE???

AX = C987h
BX:DX -> filename
BX:CX -> virus name

Return: AX = status

    0000h successful???

Note: called by TBSCANX SeeAlso: AX=CA00h ———-2FC9FF—————————– INT 2F - STACKMAN - INSTALLATION BROADCAST

AX = C9FFh
BL = BCD version number
CX = number of stacks
DX = stack size in bytes

Notes: called by STACKMAN when it goes resident to inform interested TSRs that

  its API is available
the installation check consists of testing for the string "STACKXXX" at
  offset 0Ah from the INT B4 handler

SeeAlso: INT B4“STACKMAN”,INT B5“STACKMAN” ———-2FCA00BX5442———————– INT 2F - TBSCANX - INSTALLATION CHECK

AX = CA00h
BX = 5442h ('TB')

Return: AL = 00h not installed

   = FFh installed
	BX = 7462h ('tb') if BX was 5442h on entry

Note: TBSCANX is a resident virus scanning module by Frans Veldman. Programs

  may perform virus checks on themselves, other program files, or their
  data files by invoking the TBSCANX API.

SeeAlso: AX=4653h,AX=C900h ———-2FCA01—————————– INT 2F - TBSCANX - GET STATUS

AX = CA01h

Return: AH = BCD version number (v2.2+)

   = CAh for versions before 2.2
AL = state (00h = disabled, 01h = enabled)
CX = number of signatures which will be searched

—v2.0—

BX = EMS handle, 0000h if not using EMS

—v2.3+—

BX = segment of swap area, 0000h if not swapped
DX = EMS or XMS handle (XMS handle if BX=0000h), FFFFh if not using EMS

SeeAlso: AX=CA02h ———-2FCA02—————————– INT 2F - TBSCANX - SET STATE

AX = CA02h
BL = new state (00h = disabled, 01h = enabled)

SeeAlso: AX=CA01h ———-2FCA03—————————– INT 2F - TBSCANX - SCAN BUFFER

AX = CA03h
CX = size of buffer
DS:DX -> buffer containing data to scan

Return: CF clear if no virus signatures found

    BX,ES destroyed
CF set if signature found
    ES:BX -> ASCIZ virus name (v2.3+)
    DS:DX -> ASCIZ virus name (v2.0)
AX,CX,DX destroyed (v2.3+)
all other registers except CS:IP and SS:SP destroyed (v2.0)

SeeAlso: AX=CA04h ———-2FCA04—————————– INT 2F - TBSCANX - SCAN FILE

AX = CA04h
DS:DX -> filename

Return: CF clear if no virus signatures found

    BX,ES destroyed
CF set if signature found
    ES:BX -> ASCIZ virus name
AX,CX,DX destroyed

Note: this function requires at least 4K free memory SeeAlso: AX=CA03h ———-2FCAFEBX0000———————– INT 2F U - THELP v3.0 - INSTALLATION CHECK

AX = CAFEh
BX = 0000h

Return: BX = segment of resident code if installed

   = 0000h if not installed

SeeAlso: AX=5453h ———-2FCB00—————————– INT 2F - Communicating Applications Specification - INSTALLATION CHECK

AX = CB00h

Return: AL = 00h not installed, OK to install

     01h not installed, not OK to install
     FFh installed

Note: AH = CBh is the default identifier, but may be reconfigured SeeAlso: AH=2Ah,AX=8000h“FaxBIOS”,AX=CB0Eh,AX=CBDCh ———-2FCB01—————————– INT 2F - Communicating Applications Specification - SUBMIT A TASK

AX = CB01h
DS:DX -> ASCIZ name of task control file

Return: AX >= 0: event handle

   < 0: error code

Note: files needed for an event must be kept until task is complete or error SeeAlso: AX=CB0Bh,AX=CB15h

Error codes (AH = class, AL = subcode, value passed back is 2's complement):

Class 00h	--- FAX warnings
Subcode 00h	no error
	02h	bad scanline count
	03h	page sent with errors, could not retransmit
	04h	received data lost
	05h	invalid or missing logo file
	06h	filename does not match nonstandard format (NSF) header
	07h	file size does not match NSF header
Class 01h	--- DOS warnings (data was sent)
Subcode 01h	invalid function
	05h	access denied
	06h	invalid handle
	others	see INT 21/AH=59h
Class 02h	--- fatal errors (data not sent)
Subcode	00h	multiplex handler failed
	01h	unknown command
	02h	bad event handle
	03h	FIND NEXT attempted before FIND FIRST
	04h	no more events
	07h	invalid queue type
	08h	bad control file
	09h	communication board busy
	0Ah	invalid command parameter
	0Bh	can't uninstall resident code
	0Ch	file exists
	80h	unknown task type
	81h	bad phone number
	82h	bad .PCX file header
	83h	unexpected EOF
	84h	unexpected disconnect
	85h	too many dialing retries
	86h	no file specified for send
	87h	communication board timeout
	88h	received too many pages (>1023) of data
	89h	manual connect initiated too long ago
	8Ah	hardware command set error
	8Bh	bad NonStandard Format (NSF) header file
Class 03h	--- fatal DOS errors
Subcode 02h	file not found
	03h	path not found
	others	see INT 21/AH=59h
Class 04h	--- FAX errors
Subcode 01h	remote unit not Group 3 compatible
	02h	remote unit did not send capabilities
	03h	other FAX machine incompatible
	04h	other FAX incapable of file transfers
	05h	exceeded retrain or FAX resend limit
	06h	line noise or failure to agree on bit rate
	07h	remote disconnected after receiving data
	08h	no response from remote after sending data
	09h	remote's capabilities incompatible
	0Ah	no dial tone (v1.2+)
	0Bh	invalid response from remote unit after sending data
	0Dh	phone line dead or remote unit disconnected
	0Eh	timeout while waiting for secondary dial tone (v1.2+)
	11h	invalid command from remote after receiving data
	15h	tried to receive from incompatible hardware
	5Ch	received data overflowed input buffer
	5Dh	remote unexpectedly stopped sending data
	5Eh	other FAX machine jammed (no data sent)
	5Fh	remote took too long to send fax scan line
	63h	can't get through to remote unit
	64h	user canceled event
Class 05h	--- application-specific (v1.2+)
---Intel FAXPOP.EXE
Subcode 00h	tried to send while in graphics mode
	01h	insufficient disk space
	02h	internal buffer overflow
Class 06h	--- CAS implementation-specific (v1.2+)

———-2FCB02—————————– INT 2F - Communicating Applications Specification - ABORT CURRENT EVENT

AX = CB02h

Return: AX >= 0: event handle of aborted event

   < 0: error code (see AX=CB01h)

Note: termination could take up to 30 seconds SeeAlso: AX=CB08h,AX=CB10h ———-2FCB05—————————– INT 2F - Communicating Applications Specification - FIND FIRST QUEUE ENTRY

AX = CB05h
CX = status of events to find
    0000h successful completion
    0001h waiting to be processed
    0002h number has been dialed
    0003h connection established, sending
    0004h connection established, receiving
    0005h event aborted
    FFFFh find any event, regardless of status
    other negative values, match error code
DH = direction
    00h chronological order, earliest to latest
    01h reverse chronological order, latest to earliest
DL = queue to search
    00h task queue
    01h receive queue
    02h log queue

Return: AX = 0000h successful

    BX = event handle for found event
   < 0	   error code (see AX=CB01h)

SeeAlso: AX=CB06h,AX=CB07h ———-2FCB06—————————– INT 2F - Communicating Applications Specification - FIND NEXT QUEUE ENTRY

AX = CB06h
DL = queue to search
    00h task queue
    01h receive queue
    02h log queue

Return: AX = 0000h successful

    BX = event handle for found event
   < 0	   error code (see AX=CB01h)

Note: direction of search is same as preceding FIND FIRST call SeeAlso: AX=CB05h ———-2FCB07—————————– INT 2F - Communicating Applications Specification - OPEN FILE

AX = CB07h
BX = event handle from find (AL=05h,06h) or submit task (AL=01h)
CX = receive file number (ignored for task queue and log queue)
    0000h  open receive control file
    N	   open Nth received data file
DL = queue
    00h task queue
    01h receive queue control file or received file, as given by CX
    02h log queue
    03h group file in task queue (v1.2+)
    04h group file in log queue (v1.2+)

Return: AX = 0000h successful

    BX = DOS file handle for requested file
   < 0	   error code (see AX=CB01h)

Note: the returned file handle has been opened in read-only mode and should

  be closed with INT 21/AH=3Eh after use

SeeAlso: AX=CB01h,AX=CB05h,AX=CB14h ———-2FCB08—————————– INT 2F - Communicating Applications Specification - DELETE FILE

AX = CB08h
BX = event handle
CX = receive file number
    0000h delete ALL received files and receive control file
    N	  delete Nth received file
DL = queue
    00h delete control file in task queue and corresponding group file
	if it exists
    01h delete file in receive queue, as given by CX
    02h delete control file in log queue (individual deletions not
	recommended, to maintain integrity of log) and corresponding
	group file if it exists

Return: AX = 0000h successful

   < 0	   error code (see AX=CB01h)\

SeeAlso: AX=CB02h,AX=CB09h ———-2FCB09—————————– INT 2F - Communicating Applications Specification - DELETE ALL FILES IN Q

AX = CB09h
DL = queue
    00h delete all control files in task queue, including all group
	files
    01h delete all files in receive queue
    02h delete all control files in log queue, including all group
	files

Return: AX = 0000h successful

   < 0	   error code (see AX=CB01h)

SeeAlso: AX=CB08h ———-2FCB0A—————————– INT 2F - Communicating Applications Specification - GET EVENT DATE

AX = CB0Ah
BX = event handle
DL = queue
    00h task queue
    01h receive queue
    02h log queue

Return: AX = 0000h successful

	CX = year
	DH = month
	DL = day
   < 0	   error code (see AX=CB01h)

SeeAlso: AX=CB0Bh,AX=CB0Ch ———-2FCB0B—————————– INT 2F - Communicating Applications Specification - SET TASK DATE

AX = CB0Bh
BX = event handle (task event only)
CX = year
DH = month
DL = day

Return: AX = 0000h successful

   < 0	   error code (see AX=CB01h)

Note: setting a task's date and time to before the current date and time

  causes it to execute immediately

SeeAlso: AX=CB01h,AX=CB0Ah,AX=CB0Dh ———-2FCB0C—————————– INT 2F - Communicating Applications Specification - GET EVENT TIME

AX = CB0Ch
BX = event handle
DL = queue
    00h task queue
    01h receive queue
    02h log queue

Return: AX = 0000h successful

	CH = hour
	CL = minute
	DH = second
	DL = 00h
   < 0	   error code (see AX=CB01h)

SeeAlso: AX=CB0Ah,AX=CB0Dh ———-2FCB0D—————————– INT 2F - Communicating Applications Specification - SET TASK TIME

AX = CB0Dh
BX = event handle (task events only)
CH = hour
CL = minute
DH = second
DL unused

Return: AX = 0000h successful

   < 0	   error code (see AX=CB01h)

Note: setting a task's date and time to before the current date and time

  causes it to execute immediately

SeeAlso: AX=CB0Bh,AX=CB0Ch,AX=CB10h ———-2FCB0E—————————– INT 2F - Communicating Applications Specification - GET EXTERNAL DATA BLOCK

AX = CB0Eh
DS:DX -> 256-byte buffer

Return: AX = 0000h successful

	buffer filled
   < 0	   error code (see AX=CB01h)

Format of external data block: Offset Size Description 00h BYTE CAS major version 01h BYTE CAS minor version 02h 68 BYTEs ASCIZ path to directory containing CAS software, ends in slash 46h 13 BYTEs ASCIZ name of current phonebook (in CAS directory) 53h 13 BYTEs ASCIZ name of current logo file (in CAS directory) 60h 32 BYTEs ASCIZ default sender name 80h 21 BYTEs ASCIZ CCITT identification of fax device 95h 107 BYTEs reserved ———-2FCB0F—————————– INT 2F - Communicating Applications Specification - GET/SET AUTORECEIVE

AX = CB0Fh
DL = subfunction
    00h get current autoreceive state
    01h set autoreceive state
	DH = number of rings before answer, 00h = never

Return: AX = 0000h autoreceive disabled

   = N	   number of rings before answer
   < 0	   error code (see AX=CB01h)

———-2FCB10—————————– INT 2F - Communicating Applications Specification - GET CURRENT EVENT STATUS

AX = CB10h
DS:DX -> 512-byte buffer

Return: AX = 0000h successful

	BX = event handle of current event or negative error code if
		no current event
	buffer filled
   < 0	   error code (see AX=CB01h)

SeeAlso: AX=CB02h,AX=CB0Dh

Format of status area: Offset Size Description 00h BYTE event type

	00h send
	01h receive
	02h polled send
	03h polled receive
	04h to 7Fh reserved
	FFh serious hardware error

01h BYTE transfer type

	00h 200x200 dpi, FAX mode
	01h 100x200 dpi, FAX mode
	02h file transfer mode
	03h to 7Fh reserved

02h WORD event status

	0000h completed successfully
	0001h waiting
	0002h number dialed
	0003h connected, sending
	0004h connected, receiving
	0005h aborted
	0006h to 007Fh reserved
	0080h to 7FFFh application-specific events
	8000h to FFFFh error codes

04h WORD event time (packed DOS time format, see INT 21/AX=5700h) 06h WORD event date (packed DOS date format, see INT 21/AX=5700h) 08h WORD number of files to transfer, max 7FFFh 0Ah WORD offset of file transfer record 0Ch 47 BYTEs ASCIZ phone number to call 3Bh 64 BYTEs ASCIZ application-specific tag string 7Bh BYTE reserved (00h) 7Ch BYTE connect time, seconds 7Dh BYTE connect time, minutes 7Eh BYTE connect time, hours 7Fh DWORD total number of pages in all files 83h DWORD pages already transmitted 87h WORD number of files already transmitted 89h BYTE cover page flag

	00h don't transmit cover page
	01h transmit cover page
	02h to 7Fh reserved

8Ah WORD total number of transmission errors 8Ch 78 BYTEs reserved (zeros) DAh 21 BYTEs ASCIZ remote FAX's CCITT identification EFH 32 BYTEs ASCIZ destination name 10Fh 32 BYTEs ASCIZ sender name 12Fh 80 BYTEs filename of PCX logo file (max 1780×800 pixels) 17Fh 128 BYTEs file transfer record for current event (see below)

Format of file transfer record: Offset Size Description 00h BYTE file type (ignored unless FAX)

	00h ASCII
	01h PCX
	02h DCX
	03h to 7Fh reserved

01h BYTE text size for ASCII FAX file

	00h = 80 columns by 66 lines (11 inches)
	01h = 132 columns by 88 lines (11 inches)
	02h to 7Fh reserved

02h BYTE status of file

	00h untouched
	01h opened
	02h moved
	03h deleted
	04h not yet received
	05h to 7Fh reserved

03h DWORD bytes already transmitted 07h DWORD file size in bytes 0Bh WORD pages alread transmitted 0Dh WORD number of pages in file 0Fh 80 BYTEs ASCIZ filename 5Fh BYTE 1/8 inch page length

	if page length below set to 01h through 7Fh, this value 
	specifies additional 1/8 inch increments to page length

60h BYTE page length

	00h = 11 inches
	01h to 7Fh = page length is this number of inches plus value of
		1/8 inch field above
	80h to FEh reserved
	FFh = ASCII pages ending with formfeed

61h 31 BYTEs reserved (zeros) ———-2FCB11—————————– INT 2F - Communicating Applications Specification - GET QUEUE STATUS

AX = CB11h
DL = queue to get status of
    00h task queue
    01h receive queue
    02h log queue
    03h send events (v1.2+)
    04h receive events (v1.2+)

Return: AX >= 0 total number of changes made to queue, modulo 32768

	BX = number of control files currently in queue
	CX = number of received files (zero for task and log queues)
AX < 0	error code (see AX=CB01h)

SeeAlso: AX=CB12h ———-2FCB11DL03————————- INT 2F - Communicating Applications Spec v1.2+ - GET NUMBER OF SEND EVENTS

AX = CB11h
DL = 03h

Return: AX = number of successful sends since resident manager started

BX = number of unsuccessful sends, including warnings

SeeAlso: AX=CB11h/DL=04h ———-2FCB11DL04————————- INT 2F - Communicating Applications Spec v1.2+ - GET NUMBER OF RECEIVE EVENTS

AX = CB11h
DL = 04h

Return: AX = number of received file events since resident manager started

BX = number of received FAX events

SeeAlso: AX=CB11h/DL=03h ———-2FCB12—————————– INT 2F - Communicating Applications Specification - GET HARDWARE STATUS

AX = CB12h
DS:DX -> 128-byte status buffer

Return: AX = 0000h successful

	buffer filled with hardware-dependent status information
   < 0	   error code (see AX=CB01h)

SeeAlso: AX=CB10h,AX=CB11h

Format of status buffer for Intel Connection CoProcessor: Offset Size Description 00h BYTE bit flags

	bit 7: hardware busy sending or receiving
	bit 6: last page of data
	bit 5: no data on current page
	bit 4: retransmit request for current page being transmitted
	bit 3: NSF mode active
	bits 2-0: reserved

01h BYTE number of kilobytes of free buffer space 02h BYTE page buffer status

	bit 7: Connection CoProcessor has documents to send
	bits 6-0: number of pages in buffer

03h BYTE number of retries left for dialing number 04h BYTE page number to retransmit 05h BYTE communications status

	bit 7: originating call
	bit 6: FAX message to be sent
	bit 5: on line
	bit 4: ring detected and receive enabled
	bit 3: buffer dumped on receive
	bits 2-0: hardware sequence state
		000 idle
		001 dial
		010 answer
		011 transmit
		100 receive
		101 pre-message
		110 post-message
		111 disconnect

06h BYTE baud rate

	bit 7: reserved
	bits 6-4: baud rate
		000 = 300 baud	(V.21 SDLC or HDLC mode)
		100 = 2400 baud (V.27 ter)
		101 = 4800 baud (V.27 ter)
		110 = 7200 baud (V.29)
		111 = 9600 baud (V.29)
	bits 3-0: reserved, should be 0110

07h 3 BYTEs reserved 0Ah BYTE hardware status

	bit 7: modem option installed
	bit 6: Connection CoProcessor has control of DAA (not latched)
	bit 5: on line (not latched)
	bit 4: ring detected (not latched)
	bit 3: data in command buffer (not latched)
	bit 2: set if using DMA channel 1, clear if using DMA channel 3
	bit 1: line length compensation bit 1 set (not latched)
	bit 0: line length compensation bit 0 set (not latched)

0Bh BYTE switch states

	bit 7: reserved
	bit 6: unused
	bit 5: spare switch open
	bit 4: FAX ADR1 switch open
	bit 3: FAX ADR0 switch open
	bit 2: alternate interrupt switch open
	bit 1: COM SEL 1 switch open
	bit 0: COM SEL 0 switch open
		Note: valid combinations of bits 0-2 are
			000  COM2 IRQ3 IObase 2F8h
			001  COM1 IRQ4 IObase 3F8h
			010  COM4 IRQ3 IObase 2E8h
			011  COM3 IRQ4 IObase 3E8h
			110  COM4 IRQ2 IObase 2E8h
			111  COM3 IRQ5 IObase 3E8h

0Ch BYTE bit flags

	bit 7: reserved
	bit 6: auxiliary relay forced ON
	bit 5: modem select relay forced ON
	bit 4: offhook relay forced ON
	bit 3: 9600 bps enabled
	bit 2: 7200 bps enabled
	bit 1: 4800 bps enabled
	bit 0: 2400 bps enabled

0Dh BYTE reserved 0Eh WORD error count (only valid while busy, reset when idle) 10h DWORD size of nonstandard format (NSF) file in bytes 14h BYTE 'A' if Connection CoProcessor board present 15h 9 BYTEs reserved 1Eh 21 BYTEs ASCIZ CCITT identification 33h 77 BYTEs reserved

Format of status buffer for Intel SatisFAXtion board: Offset Size Description 00h BYTE connection status flags

	bit 7: busy in T.30 CCITT fax protocol
	bit 6: data on current page/file (only used for block xfers)
	bit 5: retransmission of last page requested
	bit 4: in file transfer mode
	bit 3: data in buffer
	bit 2: data buffer dumped on receive
	bit 1: 200x100 dpi resolution instead of 200x200 dpi
	bit 0: data modem in use, FAX image modem not available

01h BYTE board state

	bit 7: reserved
	bit 6: handset jack active, data and FAX modems not available
	bits 5-3: current bit rate
	    000	 300 bps (V.21 HDLC)
	    100 2400 bps (V.27 ter)
	    101 4800 bps (V.27 ter)
	    110 7200 bps (V.29)
	    111 9600 bps (V.29)
	bits 2-0: T.30 CCITT protocol state
	    000 idle
	    001 dialing
	    010 answering
	    011 transmitting
	    100 receiving
	    101 pre-message
	    110 post-message
	    111 disconnect

02h BYTE number of KB free in buffer 03h BYTE number of pages or files in buffer 04h BYTE number of redials remaining on current number 05h BYTE FAX page number to retransmit 06h BYTE current page/file in block transfer 07h BYTE number of rings received (only if auto-answer enabled) 08h WORD error count 0Ah DWORD length of file being transferred 0Eh 6 BYTEs reserved 14h BYTE 'B' is SatisFAXtion board present 15h 13 BYTEs ASCIZ transfer agent name 22h 5 BYTEs ASCIZ transfer agent version number 27h 13 BYTEs ASCIZ resident loader name 34h 5 BYTEs ASCIZ resident loader version number 39h 21 BYTEs ASCIZ remote CSID 4Eh 13 BYTEs ASCIZ resident manager name 5Bh 5 BYTEs ASCIZ resident manager version number 60h 32 BYTEs reserved Note: the Intel Connection CoProcessor and SatisFAXtion may be distinguished

  by examining the byte at offset 14h

———-2FCB13DL00————————- INT 2F - Communicating Applications Specification - GET DIAGNOSTICS RESULTS

AX = CB13h
DL = 00h

Return: AX = 0040h in progress

   >= 0	   passed
   < 0	   hardware-dependent failure code (see below)

SeeAlso: AX=CB13h/DL=01h

Intel Connection CoProcessor failure codes:

bit 3: 9600 bps FAX modem module failed
bit 2: SDLC chip failed
bit 1: RAM failed
bit 0: ROM checksum failed

Intel SatisFAXtion failure codes:

bit 1: 2400 bps data modem failed
bit 0: 9600 bps FAX modem failed

———-2FCB13DL01————————- INT 2F - Communicating Applications Specification - START DIAGNOSTICS

AX = CB13h
DL = 01h

Return: AX = 0000h successfully started

   < 0	   error code (see AX=CB01h)

SeeAlso: AX=CB13h/DL=00h ———-2FCB14—————————– INT 2F - Communicating Applications Specification - MOVE RECEIVED FILE

AX = CB14h
BX = event handle
CX = receive file number
     0001h first received file
     N	   Nth received file
DS:DX -> ASCIZ string specifying new name for file (must not exist)

Return: AX = 0000h successful

   < 0	   error code (see AX=CB01h)

———-2FCB15—————————– INT 2F - Communicating Applications Specification - SUBMIT FILE TO SEND

AX = CB15h
DS:DX -> variable-length data area (see below)

Return: AX >= 0 event handle

   < 0	error code (see AX=CB01h)

SeeAlso: AX=CB01h

Format of data area: Offset Size Description 00h BYTE transfer type

	00h = 200x200 dpi, fax mode
	01h = 100x200 dpi, fax mode
	02h = file transfer mode
	03h to 7Fh reserved

01h BYTE text size

	00h = 80 columns
	01h = 132 columns
	02h to 7Fh reserved

02h WORD time to send (DOS packed time format, see INT 21/AX=5700h) 04h WORD date to send (DOS packed date format, see INT 21/AX=5700h) 06h 32 BYTEs ASCIZ destination name 26h 80 BYTEs ASCIZ name of file to send 76h 47 BYTEs ASCIZ phone number to dial A5h 64 BYTEs ASCIZ application-specific tag string E5h BYTE reserved (00h) E6h BYTE cover page

	00h don't send cover page
	01h send cover page
	02h to 7Fh reserved

E7h 23 BYTEs reserved (zeros) FEh variable ASCIZ string containing text of cover page (if cover page flag

	set to 01h)

———-2FCB16BX1234———————– INT 2F - Communicating Applications Spec v1.2+ - UNLOAD RESIDENT MANAGER

AX = CB16h
BX = 1234h
CX = 5678h
DX = 9ABCh

Return: AX = 0000h successful

   < 0	   error code

SeeAlso: AX=CB00h ———-2FCB17—————————– INT 2F - Communicating Applications Spec v1.2+ - SET COVER PAGE STATUS

AX = CB17h
BX = event handle
CL = cover page status
    00h not read
    01h read by user

Return: AX = 0000h successful

   < 0	   error code

———-2FCB80—————————– INT 2F - Intel SatisFAXtion CASMGR - ???

AX = CB80h
???

Return: ??? ———-2FCB81—————————– INT 2F - Intel SatisFAXtion CASMGR - ???

AX = CB81h
???

Return: ??? ———-2FCB82—————————– INT 2F - Intel SatisFAXtion CASMGR - ???

AX = CB82h
???

Return: ??? ———-2FCBDC—————————– INT 2F - Comwave Microfax Specification - GET STATUS ARRAY

AX = CBDCh
BL = 56h
BH = line number (starts with 1)
CX:DX -> 32-byte status buffer or 80 character string

Return: AX = number of cards installed, or FFFFh on error Program: Comwave manufacturers the Microfax line of fax cards which are a high-

  performance multi-card FAX solution for OEMs.

Note: defaults to AH=CBh but can be changed SeeAlso: AX=CBDDh,AX=DA00h ———-2FCBDD—————————– INT 2F - Comwave Microfax Specification - COMMAND SUBMISSION

AX = CBDDh
BL = 56h
BH = ?
CX:DX -> command to execute

Return: AX = status

    0000h success
    FFFFh on error

SeeAlso: AH=2Ah,AX=CBDCh,AX=80FBh ———-2FCC–SI5453———————– INT 2F U - Qualitas Qcach v4.00

AH = CCh
SI = 5453h or 7473h
AL = ???
DL = 00h or ???

Return: SI = 7473h

???

———-2FCD00—————————– INT 2F - Intel Image Processing Interface - INSTALLATION CHECK

AX = CD00h

Return: AL = 00h not installed, OK to install

     01h not installed, not OK to install
     FFh installed

SeeAlso: AX=CD02h“Image” ———-2FCD00—————————– INT 2F - SWELL.EXE - INSTALLATION CHECK

AX = CD00h

Return: AX = 00FFh installed

    BH = major version
    BL = minor version

Note: SWELL.EXE is a TSR which swaps programs to disk when they EXEC a child

  process with INT 21/AH=4Bh

———-2FCD01—————————– INT 2F - Intel Image Processing Interface - SET DEVICE NAME

AX = CD01h
CX:BX -> ASCIZ character device name ("LPTn", "COMn", "PRN")

Return: AL = 00h successful

	CX:BX -> internal character device name
   = 80h error

———-2FCD01—————————– INT 2F - SWELL.EXE - SUSPEND ONCE

AX = CD01h

Return: AX = 0000h SeeAlso: AX=CD02h“SWELL” ———-2FCD02—————————– INT 2F - Intel Image Processing Interface - GET VERSION NUMBER

AX = CD02h

Return: AL = 00h/01h successful

	BH = major version number (BCD)
	BL = minor version number (BCD)
   = 80h error

Note: if return AL = 01h, the IPI supports network redirection SeeAlso: AX=CD00h“Image” ———-2FCD02—————————– INT 2F - SWELL.EXE - SUSPEND

AX = CD02h

Return: AX = 0000h SeeAlso: AX=CD03h“SWELL” ———-2FCD03—————————– INT 2F - Intel Image Processing Interface - SELECT SCAN LINE

AX = CD03h
BX = scan line
CX = requested density in dots per inch (300, 600, or 1200)

Return: AL = 00h succesful

	CX = density at which scan line was mapped
	ES:DI -> start of scan line
AL = 80h unsuccessful
   = 81h scan line out of range
   = 82h unsupported scan line density
   = 83h out of memory

SeeAlso: AX=CD04h“Image” ———-2FCD03—————————– INT 2F - SWELL.EXE - ACTIVATE

AX = CD03h

Return: AX = 0000h SeeAlso: AX=CD02h“SWELL” ———-2FCD04—————————– INT 2F - Intel Image Processing Interface - MOVE BITMAP TO SCANLINE

AX = CD04h
CX:BX -> structure (see below)

Return: AL = 00h successful

   = 80h unsuccessful
   = 81h scan line out of range
   = 82h unsupported scan line density
   = 83h out of memory
   = 84h unrecognized source
   = 85h initialization error

SeeAlso: AX=CD03h“Image”

Format of structure: Offset Size Description 00h WORD image source (0 = conventional memory, 1 = expanded memory) 02h DWORD pointer to image data 06h WORD scan line on which to place 08h WORD bit offset from start of scan line at which to place 0Ah WORD density of bitmap data (300, 600, or 1200 dpi) 0Ch WORD width in bits of data 0Eh WORD source logical page number 10h WORD source handle (only if source in expanded memory) 12h WORD source offset (only if source in expanded memory) ———-2FCD04—————————– INT 2F - SWELL.EXE - TURN OFF VERBOSE MODE

AX = CD04h

Return: AX = 0000h SeeAlso: AX=CD05h“SWELL” ———-2FCD05—————————– INT 2F - Intel Image Processing Interface - PRINT PAGE

AX = CD05h

Return: AL = 00h successful

   = 80h unsuccessful

Note: page image is retained, so multiple calls will print multiple copies of

  the page

SeeAlso: AX=CD06h“Image” ———-2FCD05—————————– INT 2F - SWELL.EXE - TURN ON VERBOSE MODE

AX = CD05h

Return: AX = 0000h SeeAlso: AX=CD04h“SWELL” ———-2FCD06—————————– INT 2F - Intel Image Processing Interface - CLEAR PAGE

AX = CD06h

Return: AL = 00h successful

   = 80h unsuccessful

Note: palette is reset to default SeeAlso: AX=CD09h“Image” ———-2FCD06—————————– INT 2F - SWELL.EXE - UNINSTALL

AX = CD06h

Return: AX = 0000h uninstalled

   = 8002h programs still swapped, not uninstalled

———-2FCD07—————————– INT 2F - Intel Image Processing Interface - reserved

AX = CD07h

———-2FCD07—————————– INT 2F - SWELL.EXE - GET INFO

AX = CD07h
ES:BX -> 32-byte buffer for info

Return: AX = 0000h successful

    ES:BX buffer filled
   = 8001h buffer wrong size

Format of info buffer: Offset Size Description 00h WORD 20h (total size of buffer) 02h BYTE suspend-once mode active if nonzero 03h BYTE 00h active, 01h suspended 04h BYTE 00h quiet, 01h verbose 05h BYTE “Borland support” (allowing INT 21/AX=4B01h) on if nonzero 06h 26 BYTEs unused??? ———-2FCD08—————————– INT 2F - Intel Image Processing Interface - SCREEN IMAGE

AX = CD08h
CX:BX -> structure (see below)

Return: AL = 00h successful

   = 80h unsuccessful
   = 81h scan line out of range
   = 82h unsupported scan line density
   = 83h out of memory
   = 84h unrecognized source
   = 85h initialization error

SeeAlso: AX=CD05h“Image”,AX=CD09h“Image”

Format of structure: Offset Size Description 00h WORD image source (0 = conventional memory, 1 = expanded memory) 02h DWORD pointer to image data 06h WORD horizontal position on paper of left edge (in 1200 dpi units) 08h WORD vertical position on paper of top edge (in 1200 dpi units) 0Ah WORD left cropping (currently must be zero) 0Ch WORD top cropping (currently must be zero) 0Eh WORD width (currently must be 8000h) 10h WORD height (currently must be 8000h) 12h WORD horizontal size of image in 1200 dpi units 14h WORD vertical size of image in 1200 dpi units 16h WORD aspect ratio (currently reserved) 18h WORD initialization flag (if 01h, initialization is performed) 1Ah WORD pixels per line of source data 1Ch WORD number of scan lines in source data 1Eh WORD number of scan lines in packet 20h WORD bits per pixel (1,2,4,6, or 8) 22h WORD pixels per byte (1,2,4, or 8) 24h WORD compression type (currently only 00h [uncompressed] supported) 26h WORD source page number (if in expanded memory) 28h WORD source handle (if in expanded memory) 2Ah WORD source offset (if in expanded memory) ———-2FCD08—————————– INT 2F - SWELL.EXE - UNUSED

AX = CD08h

Return: AX = FFFFh (error) ———-2FCD09—————————– INT 2F - Intel Image Processing Interface - LOAD SCREEN

AX = CD09h
CX:BX -> structure (see below)

Return: AL = 00h successful

   = 80h unsuccessful

SeeAlso: AX=CD06h“Image Processing”,AX=CD0Ah“Image Processing”

Format of structure: Offset Size Description 00h BYTE style

	44h ('D') diamond style
	4Ch ('L') line style

01h BYTE reserved (00h) 02h WORD frequency in lines per inch [sic]

	currently, coerced to nearest of 50, 60, 68, 70, 75, 85, or 100

04h WORD screen angle in degrees (-360 to 360)

	currently coerced to nearest of -45, 0, 45, or 90

———-2FCD09—————————– INT 2F - SWELL.EXE - TURN OFF “BORLAND SUPPORT”

AX = CD09h

Return: AX = 0000h SeeAlso: AX=CD0Ah“SWELL” ———-2FCD0A—————————– INT 2F - Intel Image Processing Interface - LOAD PALETTE

AX = CD0Ah
CX:BX -> palette structure (see below)

Return: AL = 00h successful

   = 80h unsuccessful

SeeAlso: AX=CD09h“Image Processing”

Format of palette structure: Offset Size Description 00h BYTE bits per pixel for which palette is to be used (1,2,4,6, or 8) 01h 2**N palette translation values, one per possible pixel value ———-2FCD0A—————————– INT 2F - SWELL.EXE - TURN ON “BORLAND SUPPORT”

AX = CD0Ah

Return: AX = 0000h SeeAlso: AX=CD09h“SWELL” ———-2FD000—————————– INT 2F - MDEBUG display driver - GET DRIVER STATUS

AX = D000h

Return: CF set on error

    all other registers must be unchanged)
CF clear if successful
    AL = FFh
    AH = driver semaphor
	00h driver is not active
	01h driver is active
    BX = CS of the driver
    CX = driver version (CH = major, CL = minor, must be >= 013Ch)
    DL = buffer semaphor
	00h driver is not pending
	01h driver is pending between functions 02h and 03h
    DH = show semaphor
	00h driver is not pending
	01h driver is pending between functions 04h and 05h

Notes: MDEBUG is a shareware memory-resident debugging tool by Bernd Schemmer,

  including a memory monitor, an interpreter and a disassembler
MDEBUG can use any two consecutive multiplex numbers between C0h and
  FFh; the default is D0h for the display driver and D1h for the
  command driver (see INT 60/AH=00h"MDEBUG" for the actual multiplex
  numbers used)
this function MUST be reentrant, as MDEBUG calls it after every popup
  before any other actions.  The handler should not change any
  registers if the display is in an unsupported mode or in a mode
  MDEBUG supports itself, e.g. a normal text mode with at least 80x25
  characters (i.e. 80x43 or 132x44 (v1.60+)). In this case MDEBUG will
  not call any of the other functions for this popup session.
MDEBUG will not call the other functions if the returned version is
  less than the actual version of MDEBUG.
if the driver is reentrant, DL and DH should be 00h

SeeAlso: AX=D001h,AX=D002h,AX=D003h,AX=D004h,AX=D005h ———-2FD000—————————– INT 2F - ZWmous - INSTALLATION CHECK

AX = D000h

Return: AX = 5A57h (“ZW”) if installed

    BX = segment of resident code

Note: ZWmous is a shareware TSR by Zen Wu which permits the use of a mouse

  with many non-mouse applications by entering the letter under the
  mouse cursor on button presses

SeeAlso: INT 33/AX=0003h ———-2FD000—————————– INT 2F - Lotus CD/Networker - INSTALLATION CHECK

AX = D000h

Return: AL = FF if CD/Networker TSR is loaded

BX = 4D44h ("MD") signature
CX = Windows mode word (from INT 2F/AX=1600h) at time of TSR load
DX = bitmap identifying all loaded CD/Networker TSRs.

Notes: INT 2F/AH=D0h is used by CD/Networker to communicate between a

  resident redirector TSR and a transient program that controls the
  TSR's CD-ROM drive emulation (volume attachments, caching, etc).
At present there is only one CD/Networker TSR; the bitmap always = 4.

SeeAlso: AX=D002h“Lotus”,INT 2F/AX=1500h“CD-ROM” ———-2FD001—————————– INT 2F - MDEBUG display driver - INITIALIZE DRIVER

AX = D001h

Return: CF set on error

AL = driver semaphor
AH = buffer semaphor

Notes: MDEBUG calls this function after every succesful call of the function

  00h. The function should reset all internal data and the status of
  the driver. If this function returns an error, MDEBUG will not call
  the other functions in this popup session.
MDEBUG can use any two consecutive multiplex numbers between C0h and
  FFh; the default is D0h for the display driver and D1h for the
  command driver

SeeAlso: AX=D000h ———-2FD002—————————– INT 2F - MDEBUG display driver - SAVE GRAPHIC DATA

AX = D002h

Return: CF set on error

CF clear if successful
    display memory saved and display switched to one of the text modes
      02h, 03h or 07h.

Note: MDEBUG calls this function only once every popup session before

  displaying its windows.

SeeAlso: AX=D000h,AX=D003h ———-2FD002BX4D44———————– INT 2F - Multiplex - Lotus CD/Networker GET DATA AREA

AX = D002h
BX = 4D44h
DX = bitmap identifying one loaded CD/Networker TSR

Return: ES:DI → data area owned by TSR Note: the format of the data area changes with each minor revision, so it

  cannot be counted on

SeeAlso: AX=D000h“Lotus” ———-2FD003—————————– INT 2F - MDEBUG display driver - RESTORE GRAPHIC DATA

AX = D003h

Return: CF set on error

CF clear if successful
    display restored to the mode it was in before calling AX=D002h and
      the display memory is restored

Note: MDEBUG calls this function only once every popup session just before

 it exits to normal DOS.

SeeAlso: AX=D000h,AX=D002h ———-2FD004—————————– INT 2F - MDEBUG display driver - SHOW SAVED DATA

AX = D004h

Return: CF set on error

CF clear if successful
    display switched to mode it was in before calling AX=D002h and the
      display memory is restored

Note: This function needn't save the display memory before changing it. SeeAlso: AX=D000h,AX=D005h ———-2FD005—————————– INT 2F - MDEBUG display driver - SWITCH BACK TO TEXT SCREEN

AX = D005h

Return: CF set on error

CF clear if successful
    display restored to mode it was in before calling AX=D004h

Note: This function needn't save or change the display memory SeeAlso: AX=D000h,AX=D004h ———-2FD0——————————- INT 2F - MDEBUG display driver - RESERVED FUNCTION NUMBERS

AH = D0h
AL = 06h-7Fh

Note: these functions are reserved for future use ———-2FD0——————————- INT 2F - MDEBUG display driver - USER DEFINED FUNCTION NUMBERS

AH = D0h
AL = 80h-FFh

Note: these functions numbers are reserved for user defined features (e.g.

  communication between the transient und resident parts of the driver)

———-2FD100—————————– INT 2F - MDEBUG command driver - GET STATUS

AX = D100h
BX = version of MDEBUG (BH = major, BL = minor)
CX = command driver counter

—v1.60+—

DS:SI -> MDEBUG identification table (see below)
ES = segment of display memory used by MDEBUG
DI = size of video mode used by MDEBUG
    (high byte = lines, low byte = columns)

Return: DL = FFh

BX = version number of the driver if it is less than the version in BX,
     else unchanged
CX incremented

Notes: MDEBUG is a shareware memory-resident debugging tool by Bernd Schemmer,

  including a memory monitor, an interpreter, and a disassembler
called by MDEBUG at start of popup session; if the version number
  returned in BX is less than 1.52 (1.60 for MDEBUG v1.70), MDEBUG will
  not call any of the other functions during this popup session
MDEBUG can use any two consecutive multiplex numbers between C0h and
  FFh; the default is D0h for the display driver and D1h for the
  command driver (see INT 60/AH=00h"MDEBUG" for the multiplex numbers
  actually used)
this function must end with a far call to the old INT 2F handler after
  changing the registers
this function MUST be reentrant
command drivers must also declare the following data at the given
  offsets in the code segment
	100h  3 BYTEs	JMP-command in .COM-files
	103h	BYTE	NOP-command (90h)
	104h 26 BYTEs	signature "Kommandotreiber fr MDEBUG"
	11Eh 12 BYTEs	name of driver, e.g. "MDHISDRV.COM"
			each driver must have a unique name
MDEBUG will pass every key and command to the command driver(s) before
  checking for a valid internal command

SeeAlso: AX=D000h,AX=D101h

Format of MDEBUG identification table: Offset Size Description -2 WORD entry offset 00h WORD CS of MDEBUG 02h DWORD old INT 08h vector 06h DWORD old INT 09h vector 0Ah DWORD address INT 16h routine used by MDEBUG 0Eh BYTE length of version string 0Fh N BYTEs version string ———-2FD101—————————– INT 2F - MDEBUG command driver - INITIALIZE DRIVER

AX = D101h
CX = command driver counter

Return: DL = FFh if successful

	CX incremented
     else error: all registers unchanged

Note: this function must end with a far call to the old INT 2F handler after

  changing the registers
this function must be reentrant

———-2FD102—————————– INT 2F - MDEBUG command driver - EXECUTE INTERPRETER COMMAND

AX = D102h
BL = first character of the interpreter command
BH = last character of the interpreter command (or blank)
DS:SI -> parameter for the interpreter command as ASCIZ string
DS:DI -> MDEBUG data structure (see below)

Return: AL = FFh

CF set on error
    AH = error number
	01h syntax error
	02h first shell of the command.com is activ
	03h esc pressed
	04h break pressed
	05h DOS is busy
	06h command ended
	07h division by zero
	08h invalid display driver
	09h invalid command driver
	0Ah error 8 and 9
	0Bh unknown error
	0Ch new error
	    DS:SI -> ASCIZ error message (max 30 characters)
       else unknown error
CF clear if successful
    AH = return code
	00h continue processing the command line
	01h leave MDEBUG popup session
	02h leave MDEBUG popup session and automatically popup again
	    if the InDOS flag is zero
	03h not used (same as 00h)
	04h not used (same as 00h)
	05h put new command line into the input buffer,
	    DS:SI -> new command line (ASCIZ string, max 66 chars)
	06h process new command line
	    DS:SI -> new command line (ASCIZ string, max 66 chars)
       else unknown status, but continue processing commmand line

Note: this function must end with a far call to the old INT 2F handler (with

  registers unchanged) if the driver does not support the interpreter
  command in BX.  Otherwise, the driver must not chain to the old
  INT 2F.

Format of MDEBUG data structure: Offset Size Description 00h WORD register SE 02h WORD register OF 04h WORD register FS 06h WORD register FO 08h WORD register AX 0Ah WORD register BX 0Ch WORD register CX 0Eh WORD register DX 10h WORD register SI 12h WORD register DI 14h WORD register DS 16h WORD register ES 18h WORD register BP 1Ah WORD register SS 1Ch WORD register SP 1Eh WORD register FL (flags) 20h WORD register R0 22h WORD register R1 24h WORD register R2 26h WORD register R3 28h WORD register R4 2Ah WORD register R5 2Ch WORD register R6 2Eh WORD register R7 30h WORD register R8 32h WORD register CS, return-address 34h WORD register IP, return-address 36h DWORD saved pointer to data for key <F6> (v1.60) saved monitor address (v1.70) 3Ah 12 WORDs saved register values on last popup entry (for <F8> key)

	(original register values at popup entry of MDEBUG)
	AX, BX, CX, DX, SI, DI, DS, ES, BP, SS, SP, flags

52h 12 WORDs saved register values on last popup exit (for <SHIFT-F8> key)

	AX, BX, CX, DX, SI, DI, DS, ES, BP, SS, SP, flags

6Ah DWORD address of the DOS-invars-table 6Eh DWORD address of the InDOS flag 72h WORD offset of the register which is used for the segment of the

	first monitor window

74h WORD offset of the register which is used for the offset of the

	first monitor window

76h WORD name of the register which is used for the segment of the

	first monitor segment

78h WORD name of the register which is used for the offset of the first

	monitor window	 

7Ah WORD pseudo register 1 7Ch WORD pseudo register 2 ———-2FD103—————————– INT 2F - MDEBUG command driver - EXECUTE KEY IN THE MONITOR

AX = D103h
BX = key code (like result of an interrupt 16h call)
CX = 0 -> the cursor is in the ASCII column of the monitor
CX = 1 -> the cursor is in one of the hex fields of the monitor
DS:SI -> MDEBUG data structure (see AX=D102h)
ES:DI -> actual byte in the monitor

Return: AL = FFh

AH = return code
    00h key processed, read next key
    01h leave MDEBUG popup session
    02h leave MDEBUG popup session and automatically popup again if DOS
	is not busy
    03h signal an error (beep)
    04h driver has redefined the key, proceed with the new key
	BX = new key code
	MDEBUG will not pass the new key to the command driver(s)
   else treat like code 00h

Note: this function must end with a far call to the old INT 2F handler (with

  registers unchanged) if the driver does not support the key in BX.
  Otherwise, the driver must not chain to the old INT 2F.

SeeAlso: AX=D104h ———-2FD104—————————– INT 2F - MDEBUG command driver - EXECUTE KEY IN THE INTERPRETER

AX = D104h
DS:SI -> MDEBUG data structure (see AX=D102h)

Return: AL = FFh

AH = return code
    00h key processed, read next key
    01h leave MDEBUG popup session
    02h leave MDEBUG popup session and automactically popup again if
	DOS is not busy
    03h signal an error (beep)
    04h driver has redefined the key, proceed with the new key
	BX = new key code
	MDEBUG won't pass the new key to the command driver(s)
    05h put new command line into the input buffer
	DS:SI -> new command line (ASCIZ string, max 66 chars)
    06h process new command line
	DS:SI -> new command line (ASCIZ string, max 66 chars)
   else treat like code 00h

Note: this function must end with a far call to the old INT 2F handler if the

  driver does not support the key in BX.  Otherwise, the driver must
  not chain to the old INT 2F.

SeeAlso: AX=D103h ———-2FD1——————————- INT 2F - MDEBUG command driver - RESERVED FUNCTIONS

AH = D1h
AL = 05h-0Ah

Note: these functions are reserved for future use ———-2FD110—————————– INT 2F - MDEBUG command driver - GET ADDRESS OF THE OLD INT 2F

AX = D110h

Return: DL = FFh

ES:BX -> next program in the chain for INT 2F
CX = code segment of this driver
DI = offset of driver identification table (see below) (v1.60+)

Notes: only called by the transient part of the driver

must be reentrant and the driver must not chain this function to the
  old INT 2F

Format of the driver identification table: Offset Size Description 00h 26 BYTEs signature “Kommandotreiber fr MDEBUG”

                                           ^- Note: ASCII 129,German U-umlaut

27h 12 BYTEs name of driver, e.g. “MDHISDRV.COM”

	 each driver must have a unique name

———-2FD111—————————– INT 2F - MDEBUG command driver - START DRIVER

AX = D111h

Return: DL = FFh Notes: only called by the transient part of the driver to inform the resident

  part that it is installed
the function must be reentrant and the driver mustn't chain this
  function to the old INT 2F

SeeAlso: AX=D101h,AX=D112h ———-2FD112—————————– INT 2F - MDEBUG command driver - END DRIVER

AX = D112h

Return: DL = FFh Notes: only called by the transient part of the driver to inform the resident

  part that it will be released after this function
the function must be reentrant and the driver mustn't chain this
  function to the old INT 2F

SeeAlso: AX=D101h,AX=D111h ———-2FD1——————————- INT 2F - MDEBUG command driver - RESERVED FUNCTIONS

AH = D1h
AL = 13h-7Fh

Note: these functions are reserved for future use ———-2FD1——————————- INT 2F - MDEBUG command driver - USER DEFINED FUNCTIONS

AH = D1h
AL = 80h-FFh

Note: these functions are reserved for user defined features (e.g.

  communication between the transient und resident parts of the	driver)

———-2FD200BX5144———————– INT 2F U - Quarterdeck - QEMM/QRAM/VIDRAM/MANIFEST v5.0+ - INSTALLATION CHECK

AX = D200h
BX = 5144h ("QD")
CX = 4D45h ("ME")
DX = 4D30h ("M0")

Return: AL = FFh installed

if BX,CX,DX registers were as specified on entry:
    BX = 4D45h ("ME")
    CX = 4D44h ("MD")
    DX = 5652h ("VR")

Notes: QEMM/QRAM/VIDRAM/MANIFEST/etc will search for a free AH value from D2h

  through FFh, then C0h through D1h
for AL <> 0, if the BX/CX/DX values don't match a the identifier of a
  Quarterdeck product, it just chains to the previous INT 2F handler

———-2FD201BX4849———————– INT 2F U - Quarterdeck - GET QD HIMEM PRESENCE

AX = D201h
BX = 4849h ("HI")
CX = 4D45h ("ME")
DX = 4D51h ("MQ")

Return: BX = 4F4Bh (“OK”)

ES:DI -> HIMEM entry point

Notes: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h

  through FFh, then C0h through D1h

SeeAlso: AX=D201h/BX=5145h ———-2FD201BX4849———————– INT 2F U - Quarterdeck - QEMM/QRAM v5.0+ - GET HIRAM MEMORY CHAIN

AX = D201h
BX = 4849h ("HI")
CX = 5241h ("RA")
DX = 4D30h ("M0")

Return: BX = 4F4Bh (“OK”)

CX = segment of start of HIRAM chain
DX = QEMM/QRAM code segment

Notes: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h

  through FFh, then C0h through D1h
QEMM and QRAM both responded the same
the HIRAM memory chain has the same format as the regular DOS 4.0
  memory chain (see INT 21/AH=52h), except that XMS Upper Memory Blocks
  have the block header program name field set to "UMB"; blocks whose
  "owner" field is set to the QEMM/QRAM code segment returned in DX
  are locked out regions such as video memory and ROMs.

———-2FD201BX4D41———————– INT 2F U - Quarterdeck - MANIFEST v1.0+ - INSTALLATION CHECK

AX = D201h
BX = 4D41h ("MA")
CX = 4E49h ("NI")
DX = 4645h ("FE")

Return: BX = 5354h (“ST”) Note: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h

  through FFh, then C0h through D1h

———-2FD201BX4D45———————– INT 2F U - Quarterdeck - DVDOS4GX.DVR - ???

AX = D201h
BX = 4D45h ("ME")
CX = 5155h ("QU")
DX = 5044h ("PD")

Return: ??? Notes: AH=D2h is the default; use the Quarterdeck installation check described

  under AX=D200h
called by QEMM 6.03

———-2FD201BX5145———————– INT 2F U - Quarterdeck - QEMM v5.0+ - INSTALLATION CHECK

AX = D201h
BX = 5145h ("QE")
CX = 4D4Dh ("MM")
DX = 3432h ("42")

Return: BX = 4F4Bh (“OK”)

ES:DI -> QEMM API entry point (see INT 67/AH=3Fh)

Notes: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h

  through FFh, then C0h through D1h
this call is not available under QEMM v6.00 unless Windows3 support
  has been disabled with the NW3 switch to QEMM386.SYS

SeeAlso: AX=D201h/BX=4849h,INT 67/AH=3Fh ———-2FD201BX5649———————– INT 2F U - Quarterdeck - VIDRAM v5.0+ - INSTALLATION CHECK

AX = D201h
BX = 5649h ("VI")
CX = 4452h ("DR")
DX = 414dh ("AM")

Return: BX = 4F4Bh (“OK”)

ES:DI -> VIDRAM entry point

Note: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h

  through FFh, then C0h through D1h

Call VIDRAM entry point with:

AH = 00h get status
	Return: AL = VIDRAM state (see below)
		BL = bit 0: ???
		     bits 1-7 not used
		BH = flags???
		    bit 4: high RAM exists in video area???
		CL = current monitor (01h = mono, 80h = color)
		SI = current top of memory (paragraph)???
		DI = segment of ???
AH = 01h setup
	AL = VIDRAM state (00h off, 01h no EGA graphics, 02h no graph)
	BL = bit 0: ???
	     bits 1-7 not used
	BH = flags???
	CL = monitor (01h = monochrome, 80h = color)
	SI = new top of memory (paragraph)???
AH = 02h get ???
	Return: ES:DI -> ??? data

Return: CF set on error

CF clear if successful

———-2FD300BX4562———————– INT 2F U - TeleReplica - INSTALLATION CHECK

AX = D300h
BX = 4562h
CX = 2745h
DX = serial port I/O base address??? (03F8h for v3.9)

Return: SI = segment of resident code

AX = 251Dh
BX = DF21h
CX = F321h
DX = ???

———-2FD3CB—————————– INT 2F U - LapLink Quick Connect v6 - API

AX = D3CBh
CX = function
    0002h get ???
	Return: BX:AX -> ???
		CL = ???
		CH = ???
		DX = ???
		DI = COM1 I/O port???
		SI = COM2 I/O port???
    0003h initialization???
    0004h ???
    0005h initialization???
    0006h reset/clear ???
	Return: AX = 0000h
		ES:DI -> next byte after ??? cleared by this call
    0007h initialization???
    0008h uninstall
	Return: BX = status
		    0000h successful
		    FFFFh incomplete, stub remains in memory

Return: CX = 534Bh (except function 0002h) ———-2FD44D—————————– INT 2F - 4DOS.COM v2.1+ - API

AX = D44Dh
BH = function
    00h installation check
	Return: AX = 44DDh
		BL = minor version number
		BH = major version number
		CX = PSP segment address for current invocation
		DL = 4DOS shell number (0 for the first (root) shell,
		     updated each time a new copy is loaded)
    01h (internal, v2.1-3.03) terminate current copy of 4DOS
	Return: nothing
	(internal, v4.0) ???
	Return: ES:BX -> data area (see below)
    02h ???
	DX = ???
---v2.1-3.03 only---
    03h EXEC program
	CX:DX -> EXEC record
    FEh deallocate shell number (passed through to root shell)
	???
    FFh allocate shell number (passed through to root shell)

Note: bug in v3.00 will crash system if unrecognized value in BH SeeAlso: AX=D44Eh,AX=E44Dh,INT 21/AX=4403h

Format of EXEC record: Offset Size Description 00h WORD offset of ASCIZ program name in same segment as EXEC record 02h WORD offset of DOS commandline in same segment as EXEC record 04h WORD segment of environment for child process (see INT 21/AH=26h)

Format of 4DOS v4.0 data area: Offset Size Description 00h 2 BYTEs ??? 06h WORD XMS handle for swapping

???

———-2FD44E—————————– INT 2F - 4DOS v3.0+ - AWAITING USER INPUT

AX = D44Eh

—4DOS v3.01+—

BX = 0000h 4DOS is ready to display prompt
   = 0001h 4DOS has displayed the prompt, about to accept user input

Return: handler must preserve SI, DI, BP, SP, DS, ES, and SS Note: v3.00 only makes the call corresponding to BX=0001h, does not set BX SeeAlso: AX=D44Dh ———-2FD44FBX0000———————– INT 2F - 4DOS v4.0+ - KSTACK.COM - INSTALLATION CHECK

AX = D44Fh
BX = 0000h

Return: AX = 44DDh if installed SeeAlso: AX=D44Fh/BX=0001h ———-2FD44FBX0001———————– INT 2F - 4DOS v4.0+ - KSTACK.COM - PLACE KEYSTROKES INTO KEYSTACK

AX = D44Fh
BX = 0001h
CX = number of keystrokes (01h-FFh)
DS:DX -> keystroke list (one word per keystroke)

Return: AX = status

    0000h successful
    nonzero failed
BX,CX,DX destroyed

Notes: the keystrokes are the exact values to return from subsequent calls to

  INT 16 with AH=00h,01h,10h, or 11h, with the following exceptions:
	0000h causes subfunctions 01h and 11h to indicate an empty
		keyboard buffer
	FFFFh is followed by a word indicating the number of clock
		ticks to delay before the next faked keystroke
v4.00 KSTACK overwrites any unread keystrokes from the previous
  invocation, and does not range-check CX; it will overwrite memory
  following the resident portion if CX is greater than 100h.

SeeAlso: AX=D44Fh/BX=0000h,INT 16/AH=00h,INT 21/AX=4403h ———-2FD600—————————– INT 2F - HEART.COM - INSTALLATION CHECK

AX = D600h

Return: AX = 0303h (two hearts) if installed

    ES:DI -> buffer (see below)

Note: HEART.COM is a CPU lock-up/critical indicator utility by Mitch Davis.

Once the host program has identified the address of the data area, it
  can change this to indicate safe/critical, alternate colours, etc.
The entries for the color table are in char/attrib form.  Every two
  entries form a pair which is alternated between 68 times a minute.
  The first half of the table is for color videos, the second mono.
  Within each half, the first half is for the safe chars, and the
  second for the critical chars.

Format of buffer: Offset Size Description 00h 8 WORD Table of colors/attributes (see notes). 10h BYTE flags

	bit 0: program is in critical section, so flash double
		exclamation mark
	bit 1: program is in safe code, so flash the heart character

11h WORD position of heartbeat on screen, normally 009Eh (last column

	of second line)

———-2FD600—————————– INT 2F U - VEDIT VSWAP - INSTALLATION CHECK

AX = D600h

Return: AL = D6h if installed Note: VSWAP is the resident portion of VEDIT's “swapper” capability.

    	VEDIT is a programmer's text editor by Greenview Data.

SeeAlso: AX=D601h,AX=D602h ———-2FD601—————————– INT 2F U - VEDIT VSWAP - ???

AX = D601h
BL = subfunction number???

Return: BL = return code ???

ES = resident portion's data??? segment
DX = resident portion's code segment

SeeAlso: AX=D600h“VSWAP” ———-2FD602—————————– INT 2F U - VEDIT VSWAP - EXEC PROGRAM WITH SWAP

AX = D602h
other registers set as for INT 21/AX=4B00h

Return: CF set on error

    AL = error code
	82h = failure due to ???
CF clear on success

SeeAlso: AX=D600h“VSWAP”,INT 21/AX=4Bh“EXEC” ———-2FD701—————————– INT 2F - BANYAN VINES v4+ - GET BANV INTERRUPT NUMBER

AX = D701h

Return: AX = 0000h installed

    BX = interrupt number (60h to 66h)
   nonzero not present

Note: if AX is nonzero, VINES 3.x or earlier may be installed, thus it is

  necessary to examine the four bytes preceding the handlers for
  INT 60 through INT 66 for the string "BANV"

SeeAlso: AX=D702h,AX=D703h,AX=D704h ———-2FD702—————————– INT 2F U - BANYAN VINES v4+ - PCPRINT interface

      AX = D702h
      BX = function
      ???

Return: ??? SeeAlso: AX=D701h,AX=D703h,INT 61/AX=0005h“Banyan” ———-2FD703—————————– INT 2F U - BANYAN VINES v4+ - MAIL interface

      AX = D703h
      BX = function
      ???

Return: ??? SeeAlso: AX=D702h,AX=D704h ———-2FD704—————————– INT 2F U - BANYAN VINES v4+ - Streettalk Directory Assistance interface

      AX = D704h
      BX = function
      ???

Return: ??? SeeAlso: AX=D703h,INT 61/AX=0007h“Banyan” ———-2FD800—————————– INT 2F - Novell NetWare Lite - CLIENT.EXE - INSTALLATION CHECK

AX = D800h

Return: AL = FFh if installed

    DX = version number??? (0100h in 1.00)
    BX = data segment of resident copy???
    ES:DI = FAR entry point for API routines
	    Load BX = function number and call for various
	    functions.	Functions 00h - 10h supported in 1.00.

SeeAlso: AX=7A00h,AX=D880h ———-2FD880—————————– INT 2F - Novell NetWare Lite - SERVER.EXE - INSTALLATION CHECK

AX = D880h

Return: AL = FFh if installed

    DX = version number??? (0100h in 1.00)
    BX = Data segment of resident copy???
    CL = 01h if SERVER is active
       = 00h if SERVER is disabled

SeeAlso: AX=7A00h,AX=D800h ———-2FDA00—————————– INT 2F - ZyXEL ZFAX - INSTALLATION CHECK

AX = DA00h

Return: AH = enabled state (00h = enabled, 01h = disabled)

AL = 5Ah installed

Note: ZFAX is the bundled FAX software which comes with the ZyXEL model

  fax modems.

SeeAlso: AX=CBDCh,AX=DA01h,AX=DA02h,AX=DA03h ———-2FDA01—————————– INT 2F - ZyXEL ZFAX - UNINSTALL

AX = DA01h

Return: AL = 00h Success

     01h Failure

SeeAlso: AX=DA00h ———-2FDA02—————————– INT 2F - ZyXEL ZFAX - DISABLE

AX = DA02h

Return: AL = 00h SeeAlso: AX=DA03h ———-2FDA03—————————– INT 2F - ZyXEL ZFAX - ENABLE

AX = DA03h

Return: AL = 00h SeeAlso: AX=DA02h ———-2FDA55—————————– INT 2F U - TRAP.COM - INSTALLATION CHECK

AX = DA55h
DL = interrupt number
DH = ???

Return: if installed

    AH = interrupt number
    AL = ???
    ES:BX -> ???

Notes: TRAP is an interrupt call tracer by Patrick Phillipot/Udo Chrosziel

a separate copy of TRAP is loaded for each interrupt to be traced; thus
  the interrupt number is part of the installation check

———-2FDC00—————————– INT 2F - GOLD.COM - INSTALLATION CHECK

AX = DC00h

Return: AL = 00h not installed

   = FFh installed

Note: GOLD is a TSR by Bob Eager which makes the NumLock key return the code

  for F1; the purpose is to improve Kermit's VTxxx emulation

———-2FDC01—————————– INT 2F - GOLD.COM - GET STATE

AX = DC01h

Return: AL = status

    00h off
    01h on

SeeAlso: AX=DC00h,AX=DC02h ———-2FDC02—————————– INT 2F - GOLD.COM - SET STATE

AX = DC02h
DL = new state
    00h off
    01h on

Return: AL = 00h (OK) SeeAlso: AX=DC01h ———-2FDD——————————- INT 2F - SoftCom programs - API

AH = DDh
AL = FEh get info
    Return: ES:BX -> TSR info list (see below)
AL = program identifier
    BH = function
	FDh get version
	    Return: BX = version
	FFh installation check
	    Return: AL = FFh if installed
			BX = version
			ES = segment of resident code
	others vary by program

Return: AL = status

    bit 7 set on error
    AL = 81h unknown function

Format of TSR info list: Offset Size Description 00h 9 BYTEs blank-padded ASCIZ program name 09h BYTE program ID 0Ah WORD program's PSP segment 0Ch WORD program version (major in high byte) 0Eh DWORD pointer to next item in info list or 0000h:0000h 12h BYTE number of interrupts hooked 13h 5 BYTEs interrupt numbers hooked by program 18h 8 BYTEs reserved ———-2FDE00BX4445———————– INT 2F - DESQview v2.26+ External Device Interface - INSTALLATION CHECK

AX = DE00h
BX = 4445h ("DE")
CX = 5844h ("XD")
DX = 4931h ("I1")

Return: AL = FFh if installed (even if other registers do not match)

if BX,CX, and DX were as specified on entry,
    BX = 4845h ("HE")
    CX = 5245h ("RE")
    DX = 4456h ("DV")

Notes: AH=DEh is the default XDI multiplex number, but may range from C0h-FFh

programs should check for XDI starting at DEh to FFh, then C0h to DDh
the XDI handler should not issue any DOS or BIOS calls, nor should it
  issue DESQview API calls other than those allowed from hardware ints

———-2FDE01—————————– INT 2F - DESQview v2.26+ External Device Interface - DRIVER CUSTOM SUBFUNCTION

AX = DE01h
BX = driver ID
other registers as needed by driver

Notes: XDI drivers should pass this call through to previous handler if ID

  does not match
DESQview never calls this function

———-2FDE01BX5242———————– INT 2F - DESQview v2.26+ XDI - CUSTOM SUBFUNCTION, Ralf Brown's XDI drivers

AX = DE01h
BX = 5242h ("RB")
CX:DX = program identifier
	656F7000h ("eop",0) for DVeop

Return: AX = 5242h (“RB”) if installed

    ES:BX -> data or entry point
    CX = version number (CH = major, CL = minor)

Call DVeop entry point with:

ES:DI -> callback address or 0000h:0000h to remove callback

Return: AX = status

    0000h failed (callback table full or attempted to remove non-
		existent callback)
    0001h successful
	ES:DI -> chaining address
BX,CX,DX destroyed

Notes: the callback function is called with a simulated interrupt when the

  DESQview window containing it is closed; it should perform all
  necessary cleanup and then perform a FAR jump to the chaining address
  or an IRET if the chaining address is 0000h:0000h
if the program wishes to remove itself before the window is closed, it
  should call the DVeop entry point with the previously returned
  chaining address and ignore the returned chaining address.

———-2FDE01BX7474———————– INT 2F - DESQview v2.26+ XDI - CUSTOM SUBFUNCTION, DVTXDI.COM

AX = DE01h
BX = 7474h
CL = function
    00h installation check
	Return: AL = FFh
    01h get process handle
	DX = keys on Open Window menu (DL = first, DH = second)
	Return: AX = process handle or 0000h if not running
    02h (v1.3+) set TMAN handle
	DX = TMAN process handle
    03h (v1.3+) set open keys to ignore on next CL=01h call
	DX = keys on Open Window menu (DL = first, DH = second)

Return: BX = 4F4Bh (“OK”)

DL destroyed

Note: DVTXDI is distributed as part of the shareware products DVTree (DOS

 shell/DESQview process manager) and DVTMAN by Mike Weaver

———-2FDE01BX7575———————– INT 2F - DESQview v2.26+ XDI - CUSTOM SUBFUNCTION, DVSIXDI.COM

AX = DE01h
BX = 7575h
CX = function
    0000h installation check
	Return: AX = 00FFh if installed
    0001h turn on notification (currently unused)
	Return: AX = 0001h
    0002h turn off notification (currently unused)
	Return: AX = 0001h
    0003h get process information
	Return: AX = status
		    0000h failed
		    0001h successful
			BX = last instantaneous time slice
				in 1/100s (v1.10)
				in 1/18s (v1.11+)
			CX = number of processes
			DX = number of "(starting)" records (v2.00+)
			SI = number of records in process info array
			     (v2.00+) (always 15 for v1.x)
			ES:DI -> process info array (see below)
    0004h get version
	Return: AH = major version
		AL = minor version
    0005h (v1.10+) get time since DESQview started
	Return: DX:AX = 1/100s since DV start (v1.10)
		DX:AX = 1/18s since DV start (v1.11+)
    0006h (v1.10+) get number of task switches
	Return: DX:AX = total task switches
		CX = task switches in last instantaneous interval

Notes: DVSIXDI is part of the DVSI (DESQview System Information) package by

  Daniel J. Bodoh
for v1.00, function 0003h allocates common memory, which the caller
  must deallocate after reading the process information; only the
  currently used records are placed in the buffer
for v1.10+, function 0003h merely returns a pointer to the internal
  array of process information; the caller should make a copy of the
  array while inside a critical section (see INT 15/AX=101Bh).	Only
  those records with bit 7 of the first byte set are valid.

Format of information for one process (v1.00): Offset Size Description 00h BYTE flags

	bit 7: process slot is valid

01h WORD offset into DESQVIEW.DVO of program's record if started from Open Windows menu, else undefined 03h WORD Switch Windows window number 05h WORD segment of process handle 07h WORD number of tasks owned by process 09h WORD mapping context of process 0Bh DWORD hook for other programs

Format of information for one process (v1.10-v2.00): Offset Size Description 00h BYTE flags

	bit 7: valid record
	    6: (v2.00+) record is allocated; if bit 7 clear, process
	    	is "(starting)" and only offsets 01h and 09h are valid
	    5: (v2.00+) this app currently owns the CPU
	    4: reserved (0)
	    3: DESQview system task
	    2: reserved (0)
	    1: task has keyboard (currently unused)
	    0: task swapped out (currently unused)

01h WORD Open Window keys 03h WORD Switch Windows number 05h WORD segment of process handle 07h WORD number of tasks for process 09h WORD process mapping context 0Bh DWORD time process started (relative to start of DESQview) 0Fh DWORD time process last got CPU (relative to start of DESQview) 13h DWORD time process last gave up CPU (relative to start of DESQview) 17h DWORD total CPU time since process started 1Bh DWORD CPU time at start of current instantaneous interval 1Fh DWORD CPU time in current instantaneous interval 23h DWORD hook for other programs Note: all times are in 1/100s for v1.10, in 1/18s for v1.11+ ———-2FDE01BXFFFE———————– INT 2F U - DESQview v2.26+ XDI - DVXMS.DVR - ???

AX = DE01h
BX = FFFEh
CX = 4D47h ("MG")
DX = 0052h (0,"R")

Return: AL = FFh

DX = 584Dh

———-2FDE02—————————– INT 2F - DESQview v2.26+ External Device Interface - DV INITIALIZATION COMPLETE

AX = DE02h
BX = mapping context of DESQview
DX = handle of DESQview system task

SeeAlso: AX=DE03h Note: driver should pass this call to previous handler after doing its work ———-2FDE03—————————– INT 2F - DESQview v2.26+ External Device Interface - DV TERMINATION

AX = DE03h
BX = mapping context of DESQview
DX = handle of DESQview system task

SeeAlso: AX=DE02h Notes: driver should pass this call to previous handler before doing its work

DESQview makes this call when it is exiting, but before unhooking any
  interrupt vectors

———-2FDE04—————————– INT 2F - DESQview v2.26+ External Device Interface - ADD PROCESS

AX = DE04h
BX = mapping context of new process
DX = handle of process

Return: nothing Notes: XMS XDI handler (installed by default) allocates a 22-byte record

  (see below) from "common" memory to control access to XMS memory
all DOS, BIOS, and DV API calls are valid in handler
driver should pass this call to previous handler after processing it

SeeAlso: AX=DE05h

Format of XMS XDI structure: Offset Size Description 00h DWORD pointer to 10-byte record??? 04h DWORD pointer to next XMS XDI structure 08h WORD mapping context 0Ah BYTE ??? 0Bh 5 BYTEs XMS entry point to return for INT 2F/AX=4310h

	(FAR jump to next field)

10h 6 BYTEs FAR handler for XMS driver entry point

	(consists of a FAR CALL followed by RETF)

———-2FDE05—————————– INT 2F - DESQview v2.26+ External Device Interface - REMOVE PROCESS

AX = DE05h
BX = mapping context of process
DX = handle of last task in process

Return: nothing Notes: XMS XDI handler releases the structure allocated by AX=DE04h

driver should pass this call to previous handler before processing it
all DOS, BIOS, and DV API calls except those generating a task switch
  are valid in handler

SeeAlso: AX=DE04h ———-2FDE06—————————– INT 2F - DESQview v2.26+ External Device Interface - CREATE TASK

AX = DE06h
BX = mapping context of process containing task
DX = handle of new task

Notes: driver should pass this call to previous handler after processing it

all DOS, BIOS, and DV API calls are valid in handler

———-2FDE07—————————– INT 2F - DESQview v2.26+ External Device Interface - TERMINATE TASK

AX = DE07h
BX = mapping context of process containing task
DX = handle of task

Notes: driver should pass this call to previous handler before processing it

all DOS, BIOS, and DV API calls except those generating a task switch
  are valid in handler

———-2FDE08—————————– INT 2F - DESQview v2.26+ External Device Interface - SAVE STATE

AX = DE08h
BX = mapping context of task being switched from
DX = handle of task being switched from

Notes: invoked prior to task swap, interrupts, etc

driver should pass this call to previous handler after processing it

———-2FDE09—————————– INT 2F - DESQview v2.26+ External Device Interface - RESTORE STATE

AX = DE09h
BX = mapping context of task being switched to
DX = handle of task being switched to

Notes: state is restored except for interrupts

driver should pass this call to previous handler before processing it

———-2FDE0A—————————– INT 2F - DESQview v2.26+ External Device Interface - CHANGE KEYBOARD FOCUS

AX = DE0Ah
BX = mapping context of task receiving focus
DX = handle of running task

Notes: driver should pass this call to previous handler before processing it

this call often occurs inside a keyboard interrupt

———-2FDE0B—————————– INT 2F - DESQview v2.26+ External Device Interface - DVP PROCESSING COMPLETE

AX = DE0Bh
BX = mapping context of DESQview system task
CX = number of system memory paragraphs required for the use of all
	XDI drivers (DV will add this to system memory in DVP buffer)
DX = handle of DESQview system task
SI = mapping context of new process if it starts
ES:DI -> DVP buffer

Return: CX incremented as needed Notes: once DV invokes this function, the DVP buffer contents may be changed

driver should pass this call to previous handler before processing it

———-2FDE0C—————————– INT 2F - DESQview v2.26+ External Device Interface - SWAP OUT PROCESS

AX = DE0Ch
BX = mapping context of task being swapped out
DX = handle of DESQview system task

Note: driver should pass this call to previous handler after processing it ———-2FDE0D—————————– INT 2F - DESQview v2.26+ External Device Interface - SWAP IN PROCESS

AX = DE0Dh
BX = mapping context of process just swapped in
DX = handle of DESQview system task

Note: driver should pass this call to previous handler before processing it ———-2FDE0E—————————– INT 2F - DESQview v2.26+ External Device Interface - DVP START FAILED

AX = DE0Eh
BX = mapping context of DESQview system task
DX = handle of DESQview system task
SI = mapping context of failed process (same as for call to AX=DE0Bh)

Note: driver should pass this call to previous handler after processing it ———-2FDF–BX4448———————– INT 2F U - HyperDisk v4.20+ - INSTALLATION CHECK

AH = DFh
BX = 4448h ('DH')

Return: AL = FFh if installed

    CX = 5948h ('YH')
    BX:DX -> ??? in resident portion if BX=4448h on entry

Note: HyperDisk is a shareware disk cache by HyperWare (Roger Cross) SeeAlso: INT 13/AX=8EEDh ———-2FE300—————————– INT 2F - ANARKEY.COM - INSTALLATION CHECK

AX = E300h

Return: AL = 00h not installed

     FEh if installed but suspended (v3.0+)
     FFh installed

Notes: ANARKEY.COM is a commandline recall program by Steven Calwas

E3h is the default function number, but can be set to any value from
  C0h to FFh

SeeAlso: AX=E301h,AX=E302h,AX=E303h,AX=E304h,AX=E305h,AX=E306h,AX=E307h ———-2FE301—————————– INT 2F U - ANARKEY.COM v2+ - GET ???

AX = E301h

Return: DX:BX → ??? SeeAlso: AX=E300h

Format of returned data structure for ANARKEY v2.0: Offset Size Description -7 7 BYTEs signature ('ANARKEY') 00h WORD ??? (I see 0001h in v2.0) 02h WORD ??? (I see 0001h in v2.0) 04h WORD ??? (I see 0 in v2.0) 06h WORD PSP segment of next program loaded

Format of returned data structure for ANARKEY v3+: Offset Size Description -1 BYTE multiplex number 00h WORD ??? (I see 0001h in v3.0-4.0) 02h WORD ??? (I see 0001h in v3.0-4.0) 04h BYTE ??? (I see 0 in v3.0-4.0) 05h WORD PSP segment of next program loaded ———-2FE302—————————– INT 2F U - ANARKEY.COM v3+ - ???

AX = E302h
BL = ???

Return: ??? SeeAlso: AX=E300h ———-2FE303—————————– INT 2F U - ANARKEY.COM v3+ - ANARKMD API

AX = E303h
BL = function
    01h	toggle insert mode
    02h	display contents of history buffer
    03h	write history buffer to file
	ES:DX -> file name
    04h	clear history buffer
    05h	undefine all aliases
    06h	show aliases
    07h	list programs using Unix switchar
    08h	jump to bottom of history buffer	
    09h (v4.0) add string to history buffer
	ES:DX -> ASCIZ string
    0Ah (v4.0) ???
	ES:DX -> ???
    0Bh (v4.0) copy string to edit buffer for use as next input line
	ES:DX -> ASCIZ string
    0Ch (v4.0) ???
    0Dh (v4.0) copy ??? to ???
    0Eh (v4.0) ???
    0Fh (v4.0) ???
    10h (v4.0) set ??? flag
    11h (v4.0) display error message about running in EMS under Windows

Return: ??? SeeAlso: AX=E300h ———-2FE304—————————– INT 2F U - ANARKEY.COM v2+ - ???

AX = E304h
BL = ???

Return: ??? SeeAlso: AX=E300h ———-2FE305—————————– INT 2F U - ANARKEY.COM v3+ - ENABLE/SUSPEND ANARKEY

AX = E305h
BL = new state
    01h suspended
    00h enabled

SeeAlso: AX=E300h ———-2FE306—————————– INT 2F U - ANARKEY.COM v4.0 - GET ???

AX = E306h

Return: AX = ??? SeeAlso: AX=E300h ———-2FE307—————————– INT 2F U - ANARKEY.COM v4.0 - GET ???

AX = E307h

Return: AX = ???

BL = ???

SeeAlso: AX=E300h ———-2FE44D—————————– INT 2F - NDOS - API

AX = E44Dh

Note: as NDOS is a licensed version of 4DOS v3.03, the API is identical to

  that for 4DOS, except that AH=E4h instead of D4h and the installation
  check returns AX=44EEh instead of AX=44DDh

SeeAlso: AX=D44Dh,AX=E44Eh ———-2FE44EBX0000———————– INT 2F - NDOS - AWAITING USER INPUT

AX = E44Eh
BX = 0000h NDOS is ready to display prompt
   = 0001h NDOS has displayed the prompt, about to accept user input

Return: handler must preserve SI, DI, BP, SP, DS, ES, and SS SeeAlso: AX=E44Dh ———-2FED00—————————– INT 2F - Phar Lap DOS EXTENDERS - INSTALLATION CHECK

AX = ED00h
BL = DOS extender
    01h 286dosx v1.3+ (Software Development Kit)
    02h 286dosx v1.3+ (Run-Time Kit)
    03h 386dosx v4.0+ (SDK)
    04h 386dosx v4.0+ (RTK)

Return: AL = status

    00h not installed
    FFh installed
	SI = 5048h ("PH")
	DI = 4152h ("AR")
	CH = major version number
	CL = minor version number
	DX = flags
	    bit 0: running under DPMI
		1: running under Phar Lap VMM

SeeAlso: AH=A1h,AX=F100h,AX=FBA1h ———-2FEE00—————————– INT 2F - GRIDLOC.EXE - INSTALLATION CHECK

AX = EE00h

Return: AL = FFh if installed Note: GRIDLOC is a PC security program by Intelligent Security Systems, Inc. ———-2FF000—————————– INT 2F U - 4MAP - INSTALLATION CHECK

AX = F000h

Return: AX = 00FFh Notes: returns AX=00FFh for any value of AL not listed here

4MAP is a keybinding program for 4DOS (see AX=D44Dh) by Ho-Ping Tseng

———-2FF001—————————– INT 2F U - 4MAP - GET KEY MAPPINGS

AX = F001h

Return: ES:BX → key mappings SeeAlso: AX=F000h ———-2FF002—————————– INT 2F U - 4MAP - INSERT CHARACTER INTO ???

AX = F002h
BL = character to insert

Return: AX = status

    0000h successful
    0001h buffer full

SeeAlso: AX=F000h,AX=F003h ———-2FF003—————————– INT 2F U - 4MAP - INSERT CHARACTER INTO ???

AX = F003h
BL = character to insert

Return: AX = status

    0000h successful
    0001h buffer full

SeeAlso: AX=F000h,AX=F002h ———-2FF1——————————- INT 2F U - MIN-MEM v2.11 - INSTALLATION CHECK

AH = F1h
AL <> F1h

Return: AL = F1h if installed Note: MIN-MEM is a shareware TSR manager by Biologic which permits up to 24

  popup TSRs to be loaded but swapped out to disk, EMS, or XMS.	 One
  TSR at a time is brought back into memory at the user's request.

———-2FF100—————————– INT 2F - DOS EXTENDER INSTALLATION CHECK

AX = F100h

Return: AL = FFh if DOS extender present

    SI = 444Fh ("DO")
    DI = 5358h ("SX")

Note: supported or soon to be supported by Phar Lap, Rational, Ergo, and IGC SeeAlso: AH=A1h,AX=ED00h,AX=FBA1h/BX=0081h,INT 15/AX=BF02h ———-2FF700—————————– INT 2F - AUTOPARK.COM - INSTALLATION CHECK

AX = F700h

Return: AL = 00h not installed

     FFh installed

Note: AUTOPARK.COM is a resident hard disk parker by Alan D. Jones ———-2FF701—————————– INT 2F - AUTOPARK.COM - SET PARKING DELAY

AX = F701h
BX:CX = 32-bit count of 55ms timer ticks

———-2FFB——————————- INT 2F - Multiplex - RESERVED BY BORLAND INTERNATIONAL

AH = FBh

———-2FFB00—————————– INT 2F U - AutoBraille v1.1A - INSTALLATION CHECK

AX = FB00h

Return: AX = 00FFh if installed Note: AutoBraille is a shareware text-to-braille converter by KANSYS, Inc. SeeAlso: INT 10/AH=38h,INT 14/AX=F0F1h ———-2FFB00—————————– INT 2F U - Jot-It! v1.50 - INSTALLATION CHECK

AX = FB00h

Return: AX = FFFFh if installed

    BX = version (BCD, BH=major, BL=minor)

SeeAlso: AX=FB03h“Jot-It”,AX=FB01h“Jot-It” ———-2FFB01—————————– INT 2F U - AutoBraille v1.1A - ???

AX = FB01h
???

Return: ??? ———-2FFB01—————————– INT 2F U - Jot-It! v1.50 - GET USER NAME

AX = FB01h

Return: DX:BX → ASCIZ user name SeeAlso: AX=FB02h“Jot-It” ———-2FFB02—————————– INT 2F U - AutoBraille v1.1A - ???

AX = FB02h

Return: AH = ???

AL = ???

———-2FFB02—————————– INT 2F U - Jot-It! v1.50 - GET MESSAGE DIRECTORY

AX = FB02h

Return: DX:BX → ASCIZ name of directory in which messages are stored SeeAlso: AX=FB01h“Jot-It” ———-2FFB03—————————– INT 2F U - AutoBraille v1.1A - GET NEXT ???

AX = FB03h

Return: AX = ??? ———-2FFB03—————————– INT 2F U - Jot-It! v1.50 - UNINSTALL

AX = FB03h

Return: resident code removed from memory Note: CAUTION: NO checks are performed to ensure that the interrupt vectors

  being unhooked (08h,09h,28h,2Fh) actually point at the Jot-It! code

SeeAlso: AX=FB00h“Jot-It” ———-2FFB——————————- INT 2F U - AutoBraille v1.1A - SET ???

AH = FBh
AL = 04h-08h

Return: AX = 0000h ———-2FFB——————————- INT 2F U - AutoBraille v1.1A - SET ???

AH = FBh
AL = 09h-0Fh (???, 0Eh = COM1, 0Fh = COM2)

Return: ??? Note: AutoBraille is a shareware text-to-braille converter by KANSYS, Inc. ———-2FFB——————————- INT 2F U - AutoBraille v1.1A - SET ???

AH = FBh
AL = 10h-1Fh
???

Return: ??? ———-2FFB20—————————– INT 2F U - AutoBraille v1.1A - SET ??? FLAGS

AX = FB20h
BL = flags to set

SeeAlso: AX=FB21h“AutoBraille” ———-2FFB21—————————– INT 2F U - AutoBraille v1.1A - CLEAR ??? FLAGS

AX = FB21h
BL = flags to clear

SeeAlso: AX=FB20h“AutoBraille” ———-2FFB22—————————– INT 2F U - AutoBraille v1.1A - SET ???

AX = FB22h
BL = ???

Note: AutoBraille is a shareware text-to-braille converter by KANSYS, Inc. ———-2FFB28—————————– INT 2F U - AutoBraille v1.1A - ???

AX = FB28h
BX = ???
???

Return: ??? SeeAlso: AX=FB29h“AutoBraille” ———-2FFB29—————————– INT 2F U - AutoBraille v1.1A - ???

AX = FB29h
BX = ???
???

Return: ??? SeeAlso: AX=FB28h“AutoBraille” ———-2FFB——————————- INT 2F U - AutoBraille v1.1A - SET ???

AH = FBh
AL = 2Bh-34h
BX = ???

———-2FFB35—————————– INT 2F U - AutoBraille v1.1A - SET ???

AX = FB35h
BL = ???

———-2FFB36—————————– INT 2F U - AutoBraille v1.1A - SET ???

AX = FB36h
BL = ???

———-2FFB37—————————– INT 2F U - AutoBraille v1.1A - SET ???

AX = FB37h
BL = ???

Note: AutoBraille is a shareware text-to-braille converter by KANSYS, Inc. ———-2FFB42BX0001———————– INT 2F PU - Borland C++ DPMILOAD.EXE - INSTALLATION CHECK???

AX = FB42h
BX = 0001h

Return: AX = version number??? (AL=major, AH=minor)

CX = next-selector increment

—BC2.0—

ES:BX -> 80-byte buffer for ???
DX = DPMI version

—BC3.0—

BX = ??? (0000h)
DX = ???
ES:SI -> list of valid selectors ???

Notes: The version of DPMILOAD distributed with BC++ v2.0 identifies itself

  as version 1.000, while the version distributed with BC++ 3.0
  identifies itself as version 1.0; the former is 10864 bytes, the
  latter 22180 bytes.  The BC2.0 version is a DPMI loader, while
  the BC3.0 version also adds a DPMI host and DOS extender
the BC++ 2.0 version displays an error message if called with BX
  values other than 0001h-0008h

———-2FFB42BX0002———————– INT 2F PU - Borland C++ 2.0 DPMILOAD.EXE - ALLOCATE MEMORY

AX = FB42h
BX = 0002h
CX = size in bytes
DX = bit flags
    bit 2: set to allocate DOS memory, clear for DPMI memory
SI = selector of descriptor to be modified to access allocated memory
DI = selector of a second descriptor to be modified

Return: AX = ??? or 0000h on error

CX:DX = linear base address of DPMI memory block
SI:DI = handle for DPMI memory block or FFFFh:FFFFh
???

Note: two segment descriptors may be set if a code and an aliased data

  segment are required; if only one descriptor is needed, SI should
  equal DI on entry

BUG: when allocating DOS memory, the code computes the linear address by

  multiplying the segment number by 4 rather than shifting by 4

SeeAlso: AX=FB42h/BX=0003h,AX=FB42h/BX=0008h ———-2FFB42BX0002———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ALLOCATE MEMORY

AX = FB42h
BX = 0002h
ES:SI -> memory block info (see below)

Return: ??? Note: The version of DPMILOAD distributed with BC++ v2.0 identifies itself

  as version 1.000, while the version distributed with BC++ 3.0
  identifies itself as version 1.0; the former is 10864 bytes, the
  latter 22180 bytes.

SeeAlso: AX=FB42h/BX=0003h,AX=FB42h/BX=0008h

Format of memory block info: Offset Size Description 00h WORD flags

	bit 0: set if data segment rather than code segment
	bit 1: information valid
	bit 2: set if DOS memory block rather than DPMI memory block
	bit 4: ???
	bit 15: set if no LDT selectors for memory block???

02h DWORD block size in bytes —DPMI memory block— 06h DWORD DPMI memory block handle —DOS memory block— 06h WORD real-mode segment of memory block 08h WORD selector of memory block — 0Ah DWORD linear address of memory 0Eh WORD memory operation error code 0008h no more free LDT descriptors —if flags bit 0 clear— 10h WORD code segment selector for memory block or 0000h or FFFFh 12h WORD data alias selector for memory block or 0000h or FFFFh —if flags bit 0 set— 10h WORD data segment selector for memory block or 0000h or FFFFh 12h WORD unused??? ———-2FFB42BX0003———————– INT 2F PU - Borland C++ DPMILOAD.EXE - GET AVAILABLE MEMORY

AX = FB42h
BX = 0003h

Return: DX:AX = size of largest free block in paragraphs

	0000h:0000h on error (BC3.0 version only)

Note: AX and DX are destroyed on error, but no other error indicator is

  returned, under the BC++ 2.0 version of DPMILOAD

SeeAlso: AX=FB42h/BX=0002h ———-2FFB42BX0004———————– INT 2F PU - Borland C++ DPMILOAD.EXE - LOAD PROTECTED-MODE EXECUTABLE???

AX = FB42h
BX = 0004h
DS:DX -> ASCIZ filename of protected-mode executable

Return: CX = selector of ??? or 0000h —BC3.0—

DX = status (0000h,FFF4h,others???) (see below)

Note: the filename may also be terminated by a CR rather than a NUL under the

  BC++ 3.0 version of DPMILOAD

Values for status: 0000h successful 0001h ??? failure 0002h invalid selector 0004h unknown error 0008h no more LDT descriptors available??? FFDEh unable to set descriptor FFDFh unable to get segment base address FFE0h ??? FFF2h invalid parameter value FFF4h component of filename too long (name not in 8.3 format) FFF5h pathname too long (>79 chars) FFF6h ??? FFF8h ??? FFF9h index out of range FFFAh ??? FFFCh invalid access to code segment??? FFFEh ??? FFFFh general error ———-2FFB42BX0005———————– INT 2F PU - Borland C++ DPMILOAD.EXE - GET ADDRESS OF ??? BY NAME

AX = FB42h
BX = 0005h
CX = selector of DPMILOAD data (see below)
DS:DX -> ASCIZ or CR-terminated name of ??? (case ignored)

Return: DX = status (see AX=FB42h/BX=0004h)

    0000h successful
	AX:BX -> ??? FAR function (called with two words on top of stk)
    else
	BX destroyed

SeeAlso: AX=FB42h/BX=0006h,AX=FB42h/BX=000Eh

Format of DPMILOAD data: Offset Size Description 00h 12 BYTEs ??? 0Ch WORD ??? bit flags 0Eh 14 BYTEs ??? 1Ch WORD number of memory control records 1Eh 25 BYTEs ??? 37h BYTE ??? bit flags bit 4: data valid??? 38h 4 BYTEs ??? 3Ch WORD ??? 3Eh 12 BYTEs ??? 46h BYTE ??? counter 47h BYTE ??? 48h BYTE ??? 49h BYTE ??? 4Ah WORD ??? 4Ch 2 BYTEs ??? 4Eh WORD offset of array of 64-byte memory control records 52h WORD offset of name list (see below) 54h 4 BYTEs ??? 58h WORD offset of array of 6-byte objects 5Ah 8 BYTEs ??? 62h 9 BYTEs ASCIZ name for ??? 6Bh 9 BYTEs ASCIZ name for ??? ???

Format of name list entry [array]: Offset Size Description 00h BYTE length of name (00h if end of array) 01h N BYTEs name N+1 WORD 1-based index into array of unknown 6-byte objects

Format of 6-byte objects: Offset Size Description 00h BYTE ??? 01h BYTE ??? 02h BYTE ??? 03h BYTE 1-based index of memory control record 04h WORD ???

Format of memory control record: Offset Size Description 00h 20 BYTEs memory block info (see AX=FB42h/BX=0002h) 14h 6 BYTEs ??? 1Ah BYTE ??? 1Bh 2 BYTEs ??? 1Dh BYTE ??? bit flags 1Eh 14 BYTEs ??? 2Ch DWORD pointer to ??? memory control record or 0000h:0000h 30h DWORD pointer to ??? memory control record or 0000h:0000h 34h DWORD pointer to next??? memory control record or 0000h:0000h 38h DWORD pointer to prev??? memory control record or 0000h:0000h 3Ch 4 BYTEs ??? Note: the pointers at offsets 2Ch and 30h form a doubly-linked list, as do

  the pointers at offsets 34h and 38h

———-2FFB42BX0006———————– INT 2F PU - Borland C++ DPMILOAD.EXE - GET ADDRESS OF ??? BY NUMBER

AX = FB42h
BX = 0006h
CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h)
DX = 1-based index into array of ??? 6-byte objects

Return: DX = status (see AX=FB42h/BX=0004h)

    0000h successful
	AX:BX -> ??? FAR function (called with two words on top of stk)
    else
	BX destroyed

SeeAlso: AX=FB42h/BX=0005h,AX=FB42h/BX=000Eh ———-2FFB42BX0007———————– INT 2F PU - Borland C++ 2.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0007h
CX = selector of ???

Return: ??? Note: The version of DPMILOAD distributed with BC++ v2.0 identifies itself

  as version 1.000, while the version distributed with BC++ 3.0
  identifies itself as version 1.0; the former is 10864 bytes, the
  latter 22180 bytes.

———-2FFB42BX0007———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0007h
CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h)
???

Return: DX = status (see AX=FB42h/BX=0004h)

    0000h successful	
	AX = ???

———-2FFB42BX0008———————– INT 2F PU - Borland C++ 2.0 DPMILOAD.EXE - FREE MEMORY BLOCK

AX = FB42h
BX = 0008h
CX = bit flags
    bit 2: set if DPMI memory, clear if DOS memory
DX = selector of DOS memory block
SI:DI = handle of DPMI memory block

Return: DX = 0000h on error, unchanged if succcessful Note: The version of DPMILOAD distributed with BC++ v2.0 identifies itself

  as version 1.000, while the version distributed with BC++ 3.0
  identifies itself as version 1.0; the former is 10864 bytes, the
  latter 22180 bytes.

SeeAlso: AX=FB42h/BX=0002h ———-2FFB42BX0008———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - FREE MEMORY BLOCK

AX = FB42h
BX = 0008h
ES:SI -> memory block info (see AX=FB42h/BX=0002h"3.0")

Return: ??? SeeAlso: AX=FB42h/BX=0009h ———-2FFB42BX0009———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - RESIZE MEMORY BLOCK

AX = FB42h
BX = 0009h
ES:SI -> memory block info (see AX=FB42h/BX=0002h"3.0")
???

Return: ??? SeeAlso: AX=FB42h/BX=0008h“3.0” ———-2FFB42BX000A———————– INT 2F RU - Borland C++ 3.0 DPMILOAD.EXE - INIT DPMI HOST AND SPAWN SUBSHELL

AX = FB42h
BX = 000Ah
CX = 0001h
DX = ???
SI = ???

Return: after user exits subshell Notes: this call is used by DPMIRES; unlike most of the DPMILOAD calls, this

  function is not available in protected mode.
the BC2.0 version of DPMILOAD is purely a DPMI loader, while the BC3.0
  version also adds a DPMI host and DOS extender.

SeeAlso: AX=FB42h/BX=0004h,AX=FB42h/BX=0015h ———-2FFB42BX000B———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - UNUSED

AX = FB42h
BX = 000Bh

———-2FFB42BX000C———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - FREE DESCRIPTORS FOR MEMORY BLOCK???

AX = FB42h
BX = 000Ch ???
ES:SI -> memory block info ??? (see AX=FB42h/BX=0002h"3.0")

Return: DX = status??? SeeAlso: AX=FB42h/BX=000Fh ———-2FFB42BX000D———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - SIMULATE REAL MODE INTERRUPT

AX = FB42h
BX = 000Dh
CX = number of words to copy from protected-mode to real mode stack
DL = interrupt number
DH = flags
    bit 0: reset the interrupt controller and A20 line
ES:DI -> real-mode call structure (see INT 31/AX=0300h)

Return: CX = status

    0000h successful
    0001h failed

SeeAlso: INT 31/AX=0300h ———-2FFB42BX000E———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - GET ADDRESS OF ???

AX = FB42h
BX = 000Eh
DS:DX -> ASCIZ or CR-terminated name of ???

Return: CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h) corresponding to

	name, 0000h on error

SeeAlso: AX=FB42h/BX=0006h,AX=FB42h/BX=001Fh ———-2FFB42BX000F———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - REALLOCATE LDT DESCRPS TO MEMBLK???

AX = FB42h
BX = 000Fh
ES:SI -> memory block info (see AX=FB42h/BX=0002h"3.0")

Return: ??? SeeAlso: AX=FB42h/BX=000Ch ———-2FFB42BX0010———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - CONVERT SEGMENT TO SELECTOR

AX = FB42h
BX = 0010h
DX = segment number

Return: CX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	DX = selector number for descriptor
    0008h failed

SeeAlso: AX=FB42h/BX=0023h ———-2FFB42BX0011———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0011h
CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h)
???

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	AX:BX -> ??? name
    0002h invalid selector
    FFFEh ??? error

———-2FFB42BX0012———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0012h
CX = selector for ???

Return: CX = selector for ??? ———-2FFB42BX0013———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0013h
CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h)
DX = 1-based index of ???

Return: CX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	BX = ??? or 0000h
    0002h invalid selector
    FFF9h ??? error

———-2FFB42BX0014———————– INT 2F RU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0014h ???
	CX = 0001h
	Return: BX = 0000h

Note: unlike most of the DPMILOAD functions, this call is available only in

  real or V86 mode

SeeAlso: AX=FB42h/BX=000Ah ———-2FFB42BX0015———————– INT 2F RU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0015h uninstall
CX = 0001h

Return: ??? Note: unlike most of the DPMILOAD functions, this call is available only in

  real or V86 mode

SeeAlso: AX=FB42h/BX=000Ah ———-2FFB42BX0016———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - GET ???

AX = FB42h
BX = 0016h
CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h)

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	CX = ???

———-2FFB42BX0017———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0017h
CX = ???
DX = ???
???

Return: DX = status (0000h,0001h) (see below) ———-2FFB42BX0018———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - SET ???

AX = FB42h
BX = 0018h
CX = ???

———-2FFB42BX0019———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0019h
CX = selector for ???
???

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	CX = selector for ???

———-2FFB42BX001A———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 001Ah
CX = selector for ???
???

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
    0004h failed
CX:BX -> ???

———-2FFB42BX001B———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 001Bh
CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h)
DX = offset of ???

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	BX = selector for ???
	CX = selector for ???
    0002h invalid selector

———-2FFB42BX001C———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 001Ch
ES = selector for DPMILOAD data (see AX=FB42h/BX=0005h)
CX = 1-based index of ???
DX = 1-based index of ???

Return: DX = status (0000h,0002h,FFF9h) (see AX=FB42h/BX=0004h) ———-2FFB42BX001D———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - GET ???

AX = FB42h
BX = 001Dh

Return: CX:DX = ??? ———-2FFB42BX001E———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 001Eh
CX = ???
???

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
    FFF7h ??? error
CX:BX -> ???

———-2FFB42BX001F———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - GET ADDRESS OF ???

AX = FB42h
BX = 001Fh
DS:DX -> 8-character name of ???
???

Return: CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h) for ???

	0000h on error

SeeAlso: AX=FB42h/BX=000Eh ———-2FFB42BX0020———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - NULL FUNCTION???

AX = FB42h
BX = 0020h

Return: DX = ??? (always 0000h) ———-2FFB42BX0021———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - GET PROCESSOR EXCEPTION HANDLER VECT

AX = FB42h
BX = 0021h
CL = exception number (00h-1Fh)

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	AX:BX = selector:offset of handler
    FFF2h unable to get exception handler vector

SeeAlso: AX=FB42h/BX=0022h,AX=FB42h/BX=0024h,INT 31/AX=0202h ———-2FFB42BX0022———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - SET PROCESSOR EXCEPTION HANDLER VECT

AX = FB42h
BX = 0022h
CL = exception number (00h-1Fh)
SI:DX = selector:offset of new handler

Return: DX = status (0000h,0004h,FFF2h) (see AX=FB42h/BX=0004h) SeeAlso: AX=FB42h/BX=0021h,AX=FB42h/BX=0025h,INT 31/AX=0203h ———-2FFB42BX0023———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - CONVERT SELECTOR TO SEGMENT NUMBER

AX = FB42h
BX = 0023h
CX = selector

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	CX = real-mode segment number
    FFF2h descriptor has invalid base address for real-mode segment

SeeAlso: AX=FB42h/BX=0010h ———-2FFB42BX0024———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - GET PROTECTED-MODE INTERRUPT VECTOR

AX = FB42h
BX = 0024h
CL = interrupt number

Return: DX = status (0000h) (see also AX=FB42h/BX=0004h)

AX:BX = selector:offset of handler

SeeAlso: AX=FB42h/BX=0025h,INT 31/AX=0204h ———-2FFB42BX0025———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - SET PROTECTED-MODE INTERRUPT VECTOR

AX = FB42h
BX = 0025h
CL = interrupt number
SI:DX = selector:offset of new handler

Return: DX = status (0000h,0004h,FFF2h) (see AX=FB42h/BX=0004h) SeeAlso: AX=FB42h/BX=0024h,INT 31/AX=0205h ———-2FFB42BX0026———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - ???

AX = FB42h
BX = 0026h
CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h)
DX = 1-based index of ???
???

Return: DX = status (0000h,0002h,FFF9h) (see AX=FB42h/BX=0004h)

    0000h successful
    	BX = offset of ??? within data structure

———-2FFB42BX0027———————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - GET ???

AX = FB42h
BX = 0027h
CX = selector of DPMILOAD data (see AX=FB42h/BX=0005h)
DX = offset of ???

Return: DX = status (see also AX=FB42h/BX=0004h)

    0000h successful
	BX = ???

———-2FFB42BX0080———————– INT 2F U - ??? - CALLED BY Borland C++ 3.0 DPMILOAD.EXE

AX = FB42h
BX = 0080h
???

Return: AX = ???

???

———-2FFB42BX0081———————– INT 2F U - ??? - CALLED BY Borland C++ 3.0 DPMILOAD.EXE

AX = FB42h
BX = 0081h
???

Return: AX = ???

???

———-2FFB43—————————– INT 2F PU - Borland C++ 3.0 DPMILOAD.EXE - NULL FUNCTION

AX = FB43h
BX = subfunction (at least 0000h-000Eh)

Notes: this function is only present in protected mode; it does nothing but

  an immediate IRET
DPMILOAD.EXE itself calls various subfunctions:
    subfunction 0004h is called with CX=selector of ???, DI=selector
    	of DPMILOAD data
    subfunction 0008h is called with CX=selector of DPMILOAD data

———-2FFB64—————————– INT 2F U - AutoBraille v1.1A - GET ???

AX = FB64h

Return: AX = ??? (0006h seen) Note: AutoBraille is a shareware text-to-braille converter by KANSYS, Inc. ———-2FFBA1BX0081———————– INT 2F U - TKERNEL (Borland DOS extender) - INSTALLATION CHECK

AX = FBA1h
BX = 0081h
ES:DI -> 16-byte buffer

Return: if installed, first four bytes of ES:DI buffer are “IABH” Note: TKERNEL is a licensed version of AI Architects/Ergo's OS/x86. It was

  present only in Borland C++ 2.0; with version 3.0, the DOS extender
  was moved into DPMILOAD.

SeeAlso: AH=A1h,AX=F100h,AX=FBA1h/BX=0082h,AX=FBA1h/BX=0084h,INT 15/AX=BF02h SeeAlso: INT 21/AX=4403h“TKERNEL” ———-2FFBA1BX0082———————– INT 2F U - TKERNEL (Borland DOS extender) - GET ENTRY POINT

AX = FBA1h
BX = 0082h
ES:DI -> response buffer (see below)

Return: ES:DI buffer filled SeeAlso: AX=FBA1h/BX=0081h,AX=FBA1h/BX=0084h

Format of response buffer: Offset Size Description 00h 4 BYTEs signature “IABH” 04h DWORD pointer to FAR extender entry point

Call entry point with:

AX = function number
    0000h initialize???
    	STACK:  WORD  ???
	Return: AX = status???
		STACK unchanged
    0001h get version???
    	Return: AX = 0200h for v2.0.34
    0002h get ???
    	Return: AX = ??? (011Eh or 0182h seen)
    0003h load protected-mode executable
    	STACK:	DWORD -> ASCIZ filename of executable
		DWORD	???
		DWORD -> program arguments (counted string plus CR)
		DWORD -> environment for protected-mode executable
			(terminated with two consecutive NULs)
		DWORD -> WORD buffer for ???
	Return:	AX = status???
		STACK unchanged
    0004h get descriptor
        STACK:	WORD	selector for which to get descriptor
		WORD	segment number (when running in real mode)
		DWORD -> buffer for descriptor
	Return: CF clear if successful
		    buffer filled
		CF set on error
		    AX destroyed???
		STACK unchanged
    0005h ???
    	STACK:	WORD 	selector for ???
		WORD 	subfunction number???
			0000h run previously-loaded program???
			0001h ??? (similar to 0000h)
			0002h
			0003h
			0005h ??? (similar to 0000h and 0001h)
	Return: AX = status???
		STACK unchanged
    0006h ???
    	STACK:	WORD ???
		DWORD -> WORD (call) max iterations of ???
			      (return) remaining iterations
	Return: AX = ???
		STACK unchanged
    0007h unused
    	Return: AX = 0001h
    0008h unused
    	Return: AX = 0001h
    0009h copy protected-mode memory into conventional memory
    	STACK:  WORD 	selector for source segment
		WORD	segment of source if in real mode???
		DWORD	offset of source
		WORD 	number of bytes to copy
		DWORD -> low-memory destination
	Return: AX = status
		STACK unchanged
    000Ah copy conventional memory into protected-mode memory
    	STACK:  WORD	selector for destination segment
		WORD 	segment of destination if in real mode???
		DWORD	offset of destination
		WORD 	number of bytes to copy
		DWORD -> low-memory source
	Return: AX = status
		STACK unchanged
    000Bh get ??? pointers
    	STACK:	WORD desired pointer
			0000h get ???
			0002h get protected-mode CR3
			0003h get 4K page table buffer pointer
			else Return: DX:AX = FFFFh:FFFFh
	Return: DX:AX = requested pointer
		STACK unchanged
    000Ch set ??? pointers
    	STACK:	WORD desired pointer
			0000h set ???
			0002h set protected-mode CR3
			0003h set 4K page table buffer pointer
			else ignore
		DWORD new value for pointer
	Return: STACK unchanged
    000Dh get ??? pointers
    	STACK:	WORD desired pointer
			0000h get ???
			0001h get ???
			0002h get ???
			0003h get ???
			0004h get ???
			0005h get ???
			0006h get ???
			0007h get ???
			else Return: DX:AX = FFFFh:FFFFh
	Return: DX:AX = desired pointer
		STACK unchanged
 	    000Eh set ??? pointer
    	STACK:	WORD desired pointer
			0000h set ???
			0001h set ???
			0002h set ???
			0003h set ???
			0004h set ???
			0005h set ???
			0006h set ???
			0007h set ???
			else Return: DX:AX = FFFFh:FFFFh
	Return: STACK unchanged
    000Fh get ???
    	Return: AX = ??? (seen 0008h)
    0010h get ???
    	Return: AX = ???
    0011h determine whether selector is valid
    	STACK:	WORD	possible selector
	Return: AX = selector or 0000h if invalid
		STACK unchanged
    0012h get physical address
    	STACK:	WORD	selector for desired segment
		WORD	segment number if in real mode
		DWORD	offset within segment
	Return: DX:AX = 32-bit physical address or 00000000h on error
		BX destroyed
		STACK unchanged
    0013h ???
        Note:	normally jumps to code for function 0012h
    0014h copy protected-mode memory to conventional memory, with ???
    	STACK:  WORD	selector for source segment
		WORD	segment of source if in real mode???
		DWORD	offset of source
		WORD	number of bytes to copy
		DWORD -> low-memory destination
	Return: AX = status???
		STACK unchanged
    0015h copy conventional memory to protected-mode memory, with ???
    	STACK:  WORD	selector for destination segment
		WORD	segment of destination if in real mode???
		DWORD	offset of destination
		WORD	number of bytes to copy
		DWORD -> low-memory source
	Return: AX = status???
		STACK unchanged
    0016h set ??? pointer
    	STACK:	WORD	unused
		DWORD -> ??? or 0000h:0000h
	Return: AX = 0000h
		STACK unchanged
    0017h allocate real-mode procedure???
    	STACK:	DWORD	ASCIZ name of procedure
		DWORD ???
		DWORD	address of subroutine to invoke
	Return: AX = status
		    0032h procedure by that name exists
		    0033h no more real-mode procedures available
		DX destroyed
		STACK unchanged
    0018h unused
    	Return: AX = 0001h
    0019h get parameter block
    	Return: DX:AX -> parameter block (format unknown at this time,
			but 92h bytes)
			(preceded by signature "!!PARAM-BLOCK!!")
    001Ah get ???
    	Return: AX = ??? (0148h seen)
    001Bh free real-mode procedure???
    	STACK:	DWORD -> ASCIZ name of procedure
	Return: ???
		STACK unchanged
    001Ch check whether packets from protected mode task pending
    	Return: AX = 0001h if packets pending, 0000h if not
    001Dh set ???
    	STACK:	DWORD ??? or 0000h:0000h
	Return: AX,BX destroyed
		STACK unchanged
    001Eh ???
    	STACK:	WORD ??? (high byte ignored)
		DWORD -> data structure (see below)
	Return: AX,BX,CX,DX destroyed
		data structure updated
		STACK unchanged
	Format of data structure
	Offset	Size	Description
	 00h  2 BYTEs	unused
	 02h	WORD	???
	 04h	WORD	???
	 06h	WORD	???
	 08h  2 BYTEs	unused
	 0Ah	WORD	???
	 0Ch	WORD	(call) ???
	 		(return) offset of this data structure (BUG?)
    001Fh set ???
    	STACK:	WORD ??? (set to 0001h if zero)
	Return: AX destroyed
		STACK unchanged
    0020h ???
    	STACK:	DWORD -> ??? (8 bytes of data)
	Return: AX = ???
		STACK unchanged
    0021h ???
    	STACK:	DWORD -> ??? (8 bytes of data)
		WORD	???
		WORD	???
	Return: AX = ???
		STACK unchanged
    0022h ???
    	STACK:	DWORD -> ??? (8 bytes of data)
		DWORD -> 4-byte buffer for results
	Return: AX = ???
		STACK unchanged
    0023h ???
    	STACK:	DWORD -> ??? (8 bytes of data)
	Return: AX = ???
		STACK unchanged
    0024h set ???
    	STACK:	WORD ???
	Return: AX destroyed
		STACK unchanged
    0025h get ???
    	Return: AX = ??? (value set with func 0024h)
    0026h BUG: jumps to hyperspace due to fencepost error
    FFFFh set DOS memory management functions
	BX:SI -> FAR routine for allocating DOS memory
		(called with AH=48h,BX=number of paragraphs to alloc;
		 returns CF clear, AX=segment of allocated memory, or
		 	 CF set on error)
	CX:DI -> FAR routine for freeing DOS memory
		(called with AH=49h,ES=segment of block to free;
		 returns CF set on error,AX=error code)
	Note: each of these pointers normally points at INT 21/RETF
    other Return: AX = 0001h

Note: BX may be destroyed by any of the API calls ———-2FFBA1BX0084———————– INT 2F U - TKERNEL (Borland DOS extender) - UNINSTALL

AX = FBA1h
BX = 0084h
ES:DI -> response buffer (see below)

Return: ES:DI buffer filled SeeAlso: AX=FBA1h/BX=0081h,AX=FBA1h/BX=0084h

Format of response buffer: Offset Size Description 00h 4 BYTEs signature “IABH” 04h WORD success indicator

	0001h failed (INT 2F hooked by another program)
	unchanged if successful

06h WORD segment of ??? 08h WORD segment of ??? memory block to free if nonzero 0Ah WORD segment of ??? memory block to free if nonzero ———-2FFBFBES0000———————– INT 2F U - SoundBlaster speech driver - INSTALLATION CHECK

AX = FBFBh
ES = 0000h

Return: ES nonzero if installed

    ES:BX -> entry point data structure (see below)

SeeAlso: INT 80/BX=0000h,INT F3“SoundBlaster”

Format of entry point data structure: Offset Size Description 00h 3 BYTEs signature “FB ” 03h BYTE driver major version number??? 04h DWORD speech driver entry point 08h 24 BYTEs ??? 20h ? BYTEs data buffer for calling speech driver

Call driver entry point with:

AL = function
    07h speak a string
    	data buffer (see above) contains:
		BYTE  length of string
	      N BYTEs string to speak

———-2FFE00DI4E55———————– INT 2F U - NORTON UTILITIES 5.0+ TSRs - INSTALLATION CHECK/STATUS REPORT

AX = FE00h
DI = 4E55h ("NU")
SI = TSR identifier
    4346h ("CF") NCACHE-F (v5) / NCACHE (v6.0+)
    4353h ("CS") NCACHE-S (v5 only)
    4443h ("DC") DISKREET
    444Dh ("DM") DISKMON
    4653h ("FS") FILESAVE (v5) / EP (v6.0+)

Return: SI = TSR reply

    lowercase version of SI on entry (i.e. SI OR 2020h)
AH = status
    00h installed but disabled internally
    01h installed and enabled
AL = status
    00h	NCACHE-x or DISKREET installed
    01h FILESAVE / EP / DISKMON v6 installed
    45h	DISKMON v5 installed
BX = length of *.INI file (DISKMON and FILESAVE/EP only) (see below)
CX = segment of resident portion
    FFFFh if completely loaded high (NCACHE)

—FILESAVE/EP—

DL = ??? (apparently always 00h)

—DISKMON—

DX = ??? (apparently always 1AE6h [v5] / 1B86h [v6])

Note: the value returned in CX is incorrect for NCACHE 6.00 SeeAlso: AX=FE01h,AX=FE02h,AX=FE03h,AX=FE04h,AX=FE05h

Format of DISKMON.INI file: Offset Size Description -6Ch 108 BYTEs (in memory copy only)

	list of filenames which are always protected:
	  IBMBIO.COM/IBMDOS.COM, IO.SYS/MSDOS.SYS, TBIOS.SYS/TDOS.SYS,
	  MIO.SYS/IO.BIN, COMMAND.COM

00h BYTE ??? always 01h 01h BYTE disk light (00h off, 01h on) 02h BYTE disk protection (00h off, 01h on) 03h BYTE protected areas

	01h system area
	02h files
	03h system area and files
	04h entire disk

04h BYTE floppy access (00h not allowed, 01h allowed) 05h 27 BYTEs filename extension list (9 entries)

	(lowercase, blank padded or = 000000h)

20h 240 BYTEs filename list (20 entries)

	(lowercase, name and extension blank padded, with '.')

Note: CX:0508h → copy in installed TSR (v5)

CX:052Fh -> copy in installed TSR (v6)

Format of FILESAVE.INI / EP.INI file: Offset Size Description 00h 26 BITs drive list (bit set: file protection on, cleared: off): 00h BYTE drives A: - H: 01h BYTE drives I: - P: 02h BYTE drives Q: - X: 03h BYTE drives Y: - Z: 04h BYTE which files to protect

	00h all files
	01h all files with extension in list
	02h all files except those with extension in list

05h 27 BYTEs filename extension list (9 entries, uppercase, ASCIZ) 20h BYTE include files with archive bit clear (00h no, 01h yes) 21h WORD number of days after which files are purged (0 = never) 23h WORD max kilobytes of erased file space to hold (0 = all) Note: CX:03D2h → copy in installed TSR (v5.0)

CX:03F5h -> copy in installed TSR (v6.0)

———-2FFE01DI4E55———————– INT 2F U - NORTON UTILITIES 5.0+ TSRs - ENABLE

AX = FE01h
DI = 4E55h ("NU")
SI = TSR identifier (see AX=FE00h)

Return: SI = TSR reply (lowercase version of entry SI, i.e. SI OR 2020h)

AX = status
    0002h successful (DISKMON, FILESAVE, EP)
    FE00h successful (NCACHE-x, DISKREET)

Notes: if the enable/disable calls are used on DISKMON or NCACHE-x, the status

  report generated by the programs still indicates the previous state,
  and DISKMON.INI is not updated
apparently has no effect on DISKREET

SeeAlso: AX=FE00h,AX=FE02h ———-2FFE02DI4E55———————– INT 2F U - NORTON UTILITIES 5.0+ TSRs - DISABLE

AX = FE02h
DI = 4E55h ("NU")
SI = TSR identifier (see AX=FE00h)

Return: SI = TSR reply (lowercase version of entry SI, i.e. SI OR 2020h)

AX = status
    0004h successful (DISKMON, FILESAVE)
    FE00h successful (NCACHE-x, DISKREET)

Note: (see AX=FE01h) SeeAlso: AX=FE00h,AX=FE01h ———-2FFE03DI4E55———————– INT 2F U - NORTON UTILITIES 5.0+ TSRs - internal - ???

AX = FE03h
DI = 4E55h ("NU")
SI = TSR identifier (see AX=FE00h)

Return: SI = TSR reply (lowercase version of entry SI, i.e. SI OR 2020h)

AX = status
    0006h successful???

Notes: only supported by DISKMON, FILESAVE, and NCACHE-x

reportedly dangerous

SeeAlso: AX=FE00h ———-2FFE04DI4E55———————– INT 2F U - NORTON UTILITIES 5.0+ DISKMON, FILESAVE / EP - internal - ???

AX = FE04h
DI = 4E55h ("NU")
SI = TSR identifier (see AX=FE00h)

Return: SI = TSR reply (lowercase version of entry SI, i.e. SI or 2020h)

AX = status
    0008h successful???

SeeAlso: AX=FE00h ———-2FFE05DI4E55———————– INT 2F U - NORTON UTILITIES 5.0+ DISKMON, FILESAVE / EP - internal - ???

AX = FE05h
DI = 4E55h ("NU")
SI = TSR identifier (see AX=FE00h)

Return: SI = TSR reply (lowercase version of entry SI, i.e. SI or 2020h)

AX = status
    000Ah successful???

Note: reportedly dangerous SeeAlso: AX=FE00h ———-2FFF00—————————– INT 2F - Topware Network Operating System - INSTALLATION CHECK

AX = FF00h

Return: AL = 00h not installed, OK to install

   = 01h not installed, not OK to install
   = FFh installed

SeeAlso: AX=FF01h,INT 21/AH=FFh“Topware”,INT 7A“Topware” ———-2FFF01—————————– INT 2F - Topware Network Operating System - GET VERSION

AX = FF01h

Return: AX = version SeeAlso: AX=FF00h ———-30——————————— INT 30 - (NOT A VECTOR!) - DOS 1+ - FAR JMP instruction for CP/M-style calls

 the CALL 5 entry point does a FAR jump to here

Note: under DOS 2+, the instruction at PSP:0005 points two bytes too low in

  memory

SeeAlso: INT 21/AH=26h

back2root/ibm-pc-ms-dos/interrupts/old/ms_interrupt_list-22-30.txt · Dernière modification : 2023/01/05 04:01 de frater