home *** CD-ROM | disk | FTP | other *** search
/ For Beginners & Professional Hackers / cd.iso / docum / inter42.doc / interrup.g < prev    next >
Encoding:
Text File  |  1994-08-07  |  340.9 KB  |  9,386 lines

  1. Interrupt List, part 7 of 12
  2. This compilation is Copyright (c) 1989,1990,1991,1992,1993,1994 Ralf Brown
  3. --------D-2D---------------------------------
  4. INT 2D - DOS 2+ - RESERVED
  5. Note:    this vector is not used in DOS versions <= 6.00, and points at an IRET
  6. --------t-2D---------------------------------
  7. INT 2D - ALTERNATE MULTIPLEX INTERRUPT SPECIFICATION (AMIS) [v3.5.1]
  8.     AH = multiplex number
  9.     AL = function
  10.         00h installation check
  11.         Return: AL = 00h if free
  12.             AL = FFh if multiplex number in use
  13.                 CX = binary version number (CH = major, CL = minor)
  14.                 DX:DI -> signature string (see #1240) identifying
  15.                     the program using the multiplex number
  16.         01h get entry point
  17.         Return: AL = 00h if all API calls via INT 2D
  18.             AL = FFh if entry point supported
  19.                 DX:BX -> entry point for bypassing interrupt chain
  20.         02h uninstall
  21.         DX:BX = return address for successful uninstall (may be
  22.             ignored by TSR)
  23.         Return: AL = status
  24.                 00h not implemented
  25.                 01h unsuccessful
  26.                 02h can not uninstall yet, will do so when able
  27.                 03h safe to remove, but no resident uninstaller
  28.                 (TSR still enabled)
  29.                 BX = segment of memory block with resident code
  30.                 04h safe to remove, but no resident uninstaller
  31.                 (TSR now disabled)
  32.                 BX = segment of memory block with resident code
  33.                 05h not safe to remove now, try again later
  34.                 FFh successful
  35.             return at DX:BX with AX destroyed if successful and
  36.               TSR honors specific return address
  37.         03h request pop-up
  38.         Return: AL = status
  39.                 00h not implemented or TSR is not a pop-up
  40.                 01h can not pop up at this time, try again later
  41.                 02h can not pop up yet, will do so when able
  42.                 03h already popped up
  43.                 04h unable to pop up, user intervention required
  44.                 BX = standard reason code
  45.                     0000h unknown failure
  46.                     0001h interrupt chain passes through memory
  47.                       which must be swapped out to pop up
  48.                     0002h swap-in failed
  49.                 CX = application's reason code if nonzero
  50.                 FFh TSR popped up and was exited by user
  51.                 BX = return value
  52.                     0000h no return value
  53.                     0001h TSR unloaded
  54.                     0002h-00FFh reserved
  55.                     0100h-FFFFh application-dependent
  56.         04h determine chained interrupts
  57.         BL = interrupt number (except 2Dh)
  58.         Return: AL = status
  59.                 00h not implemented
  60.                 01h (obsolete) unable to determine
  61.                 02h (obsolete) interrupt hooked
  62.                 03h (obsolete) interrupt hooked, address returned
  63.                 DX:BX -> TSR's interrupt BL handler
  64.                 04h list of hooked interrupts returned
  65.                 DX:BX -> interrupt hook list (see #1241)
  66.                 FFh interrupt not hooked
  67.         Notes:    since INT 2D is known to be hooked, the resident code
  68.               need not test for BL=2Dh (to minimize its size), and
  69.               the return value is therefore undefined in that case.
  70.             BL is ignored if the TSR returns AL=04h; in that case,
  71.               the caller needs to scan the return list rather than
  72.               making additional calls to this function.  If the
  73.               return is not 00h or 04h, then the caller must cycle
  74.               through the remaining interrupt numbers it wishes to
  75.               check.
  76.             return values 01h thru 03h are disparaged and will be
  77.               removed from the next version of this specification;
  78.               they are included for compatibility with version 3.3,
  79.               though they were probably never used in any
  80.               implementation
  81.         05h get hotkeys
  82.         Return: AL = status
  83.                 00h not implemented
  84.                 FFh supported
  85.                 DX:BX -> hotkey list (see #1242)
  86.         06h-0Fh reserved for future enhancements
  87.         Return: AL = 00h (not implemented)
  88.         other  application-dependent
  89. Notes:    programs should not use fixed multiplex numbers; rather, a program
  90.       should scan all multiplex numbers from 00h to FFh, remembering the
  91.       first unused multiplex in case the program is not yet installed.
  92.       For multiplex numbers which are in use, the program should compare
  93.       the first 16 bytes of the signature string to determine whether it
  94.       is already installed on that multiplex number.  If not previously
  95.       installed, it should use the first free multiplex number.
  96.     functions other than 00h are not valid unless a program is installed
  97.       on the selected multiplex number
  98.     to be considered fully compliant with version 3.5 of the specification,
  99.       programs must implement at least functions 00h, 02h (no resident
  100.       uninstall code required), and 04h (return value 04h).     TSRs that
  101.       provide hotkeys with which the user can activate them must also
  102.       implement function 05h.  The absolute minimum fully-compliant
  103.       implementation has an overhead of 64 bytes (80 bytes with function
  104.       05h) plus 22 bytes per hooked interrupt (for the interrupt sharing
  105.       protocol header and hook list entry).
  106.     the signature string and description may be used by memory mappers
  107.       to display the installed programs
  108.     users of this proposal should adhere to the IBM interrupt sharing
  109.       protocol (see #1246), which will permit removal of TSRs in
  110.       arbitrary order and interrupt handler reordering.  All TSRs
  111.       following this proposal should be removable, though they need not
  112.       keep the code for removing themselves resident; it is acceptable
  113.       for a separate program to perform the removal.
  114.     A sample implementation including example TSRs and utility programs
  115.       may be found in a separate package distributed as AMISLnnn.ZIP
  116.       (AMISL091.ZIP as of this writing).
  117.     Please let me know if you choose to follow this proposal.  The
  118.       signature and a list of the private API calls you use would be
  119.       appreciated, as well.
  120. SeeAlso: INT 2F
  121. Index:    installation check;Alternate Multiplex Interrupt Specification
  122. Index:    installation check;AMIS|installation check;FASTMOUS
  123. Index:    installation check;SPELLER|installation check;Monitor
  124. Index:    installation check;NOLPT|installation check;NOTE
  125. Index:    installation check;RBkeyswp|installation check;SWITCHAR
  126. Index:    installation check;VGABLANK|installation check;EATMEM
  127. Index:    installation check;RECALL|installation check;XPTR2
  128. Index:    uninstall;Alternate Multiplex Interrupt Specification|uninstall;AMIS
  129. Index:    entry point;Alternate Multiplex Interrupt|entry point;AMIS
  130.  
  131. Format of AMIS signature string:
  132. Offset    Size    Description    (Table 1240)
  133.  00h  8 BYTEs    blank-padded manufacturer's name (possibly abbreviated)
  134.  08h  8 BYTEs    blank-padded product name
  135.  10h 64 BYTEs    ASCIZ product description (optional, may be a single 00h)
  136. Note:    it is not necessary to reserve a full 64 bytes for the description,
  137.       just enough to store the actual ASCIZ string
  138.  
  139. Format of AMIS interrupt hook list [array]:
  140. Offset    Size    Description    (Table 1241)
  141.  00h    BYTE    interrupt number (last entry in array is 2Dh)
  142.  01h    WORD    offset within hook list's segment of the interrupt handler
  143.         this will point at the initial short jump of the interrupt
  144.           sharing protocol header (see #1246)
  145.  
  146. Format of AMIS hotkey list:
  147. Offset    Size    Description    (Table 1242)
  148.  00h    BYTE    type of hotkey checking (see #1243)
  149.  01h    BYTE    number of hotkeys (may be zero if TSR can disable hotkeys)
  150.  02h 6N BYTEs    array of hotkey definitions
  151.         (one per hotkey, first should be primary hotkey)
  152.         Offset    Size    Description
  153.          00h    BYTE    hotkey scan code (00h/80h if shift states only)
  154.                 hotkey triggers on release if bit 7 set
  155.          01h    WORD    required shift states (see #1244)
  156.          03h    WORD    disallowed shift states (see #1244)
  157.          05h    BYTE    hotkey flags (see #1245)
  158. Notes:    except for bit 7, the shift states correspond exactly to the return
  159.       values from INT 16/AH=12h.  A set bit in the required states word
  160.       indicates that the corresponding shift state must be active when the
  161.       hotkey's scan code is received for the hotkey to be recognized; a
  162.       clear bit means that the corresponding state may be ignored.    A set
  163.       bit in the disallowed shift states word indicates that the
  164.       corresponding shift state must be inactive.
  165.     for the disallowed-states word, if one of the "either" bits is set,
  166.       then both the corresponding left bit and right bit must be set
  167.     examples:
  168.         Ctrl-Alt-Del monitoring: 53h 000Ch 0003h 06h
  169.         Alt-key tap (DESQview):     B8h 0000h 0007h 08h
  170.         Shf-Shf-N (NOTE.COM):     31h 0003h 000Ch 00h
  171. Index:    hotkeys;AMIS
  172.  
  173. Bitfields for type of AMIS hotkey checking:
  174. Bit(s)    Description    (Table 1243)
  175.  0    checks before chaining INT 09
  176.  1    checks after chaining INT 09
  177.  2    checks before chaining INT 15/AH=4Fh
  178.  3    checks after chaining INT 15/AH=4Fh
  179.  4    checks on INT 16/AH=00h,01h,02h
  180.  5    checks on INT 16/AH=10h,11h,12h
  181.  6    checks on INT 16/AH=20h,21h,22h
  182.  7    reserved (0)
  183.  
  184. Bitfields for AMIS shift states:
  185. Bit(s)    Description    (Table 1244)
  186.  0    right shift pressed
  187.  1    left shift pressed
  188.  2    either control key pressed
  189.  3    either Alt key pressed
  190.  4    ScrollLock active
  191.  5    NumLock active
  192.  6    CapsLock active
  193.  7    either shift key pressed
  194.  8    left control key pressed
  195.  9    left Alt key pressed
  196.  10    right control key pressed
  197.  11    right Alt key pressed
  198.  12    ScrollLock pressed
  199.  13    NumLock pressed
  200.  14    CapsLock pressed
  201.  15    SysReq key pressed
  202. Notes:    if bit 2 is set, either control key may be pressed for the hotkey; if
  203.       bits 8 and 10 are both set, then both control keys must be pressed.
  204.       Similarly for bits 3 and 9/11, as well as 7 and 0/1.
  205.     the SysReq key is often labeled SysRq
  206.  
  207. Bitfields for AMIS hotkey flags:
  208. Bit(s)    Description    (Table 1245)
  209.  0    hotkey chained before processing
  210.  1    hotkey chained after processing
  211.  2    others should pass through this hotkey so that it can be monitored
  212.  3    hotkey will not activate if other keys pressed/released before hotkey
  213.       press is completed
  214.  4    this key is remapped into some other key
  215.  5-7    reserved (0)
  216.  
  217. Format of interrupt sharing protocol interrupt handler entry point:
  218. Offset    Size    Description    (Table 1246)
  219.  00h  2 BYTEs    short jump to actual start of interrupt handler, immediately
  220.           following this data block (EBh 10h)
  221.  02h    DWORD    address of next handler in chain
  222.  06h    WORD    signature 424Bh
  223.  08h    BYTE    EOI flag
  224.         00h software interrupt or secondary hardware interrupt handler
  225.         80h primary hardware interrupt handler (will issue EOI)
  226.  09h  2 BYTEs    short jump to hardware reset routine
  227.         must point at a valid FAR procedure (may be just RETF)
  228.  0Bh  7 BYTEs    reserved (0)
  229.  
  230. (Table 1247)
  231. Values of AMIS signatures known to be in use:
  232.  'Byrial J' 'EKLAVO  '    permits keyboard entry of Esperanto accented letters
  233.  'CoveSoft' 'Burnout+'    shareware screen saver Burnout Plus
  234.  'Crynwr  ' 'SPELLER '    TSR spelling-checker
  235.  'CSJewell' 'Modula3L'    Curtis Jewell's Modula-3 compiler (non-TSR)
  236.  'DAISYCHA' 'INDRIVER'    Advanced Parallel Port daisy chain driver (vendor name
  237.               in product description field, if desired)
  238.             (see also INT 2D/AL=DCh)
  239.  'ECLIPSE ' 'PLUMP   '    Eclipse Software's printer and plotter spooler
  240.  'GraySoft' 'GIPC    '    GraySoft's Inter-Process Communications driver
  241.  'heathh  ' 'Monitor '
  242.  'Helge O '        TSRs by Helge Olav Helgesen
  243.  'J. Berry' 'RATSR   '    RemoteAccess Network Manager workstation module
  244.  'JWB      ' 'RAMLIGHT'    James Birdsall's on-screen RAMdisk activity indicator
  245.  'Nildram ' 'ST         '    Screen Thief graphics screen grabber
  246.  'R-Ware  ' 'dLite   '    run-time data decompression TSR
  247.  'Ralf B  ' 'FASTMOUS'    example TSR included with sample AMIS library code
  248.  'Ralf B  ' 'NOLPT n '    example TSR -- turn LPTn into bit-bucket
  249.  'Ralf B  ' 'NOTE    '    example TSR -- popup note-taker
  250.  'Ralf B  ' 'RBkeyswp'    RBkeyswap v3.0+ -- swap Esc/~ and LCtrl/CapsLock keys
  251.  'Ralf B  ' 'SWITCHAR'    example TSR -- add switchar() support removed from DOS5
  252.  'Ralf B  ' 'VGABLANK'    example TSR -- VGA-only screen blanker
  253.  'Sally IS' 'Mdisk   '    removeable, resizeable RAMdisk
  254.  'Sally IS' 'Scr2Tex '    screen dumper with output in (La)Tex format
  255.  'Thaco      ' 'NEST    '    Eirik Pedersen's programmer's delimiter matcher
  256.  'TifaWARE' 'EATMEM  '    George A. Theall's public domain memory restrictor for
  257.             testing programs (v1.1+)
  258.  'TifaWARE' 'RECALL  '    public domain commandline editor and history (v1.2+)
  259.  'Todd      ' 'XPTR2   '    PC-to-Transputer interface by Todd Radel
  260. --------N-2D--10-----------------------------
  261. INT 2D - RATSR 2.0+ - GET STATUS
  262.     AL = 10h
  263.     AH = AMIS multiplex number for RATSR
  264. Return: AL = status
  265.         01h listening (no connection)
  266.         02h receiving          \
  267.         03h sending               > station being monitored
  268.         04h initializing receive  /
  269.     AH = keyboard lock status (00h unlocked, 01h locked)
  270. Program: RATSR is a utility by James Berry provided with
  271.       RemoteAccess/Professional, a commercial bulletin board system, that
  272.       allows remote control of a station over a network
  273. SeeAlso: INT 2D"AMIS"
  274. --------d-2D--10-----------------------------
  275. INT 2D - dLite 1.0+ - GET PARAMETER BLOCK ADDRESS
  276.     AL = 10h
  277.     AH = AMIS multiplex number for dLite
  278. Return: CF clear if successful
  279.         ES:BX -> parameter block (see #1248)
  280.     CF set on error
  281. Program: dLite is a shareware TSR by Rainer Schuetze which transparently
  282.       expands compressed files when they are read
  283. SeeAlso: AL=11h"dLite",AL=12h"dLite",INT 21/AX=FEDCh"PCMANAGE"
  284.  
  285. Format of dLite parameter block:
  286. Offset    Size    Description    (Table 1248)
  287.  00h    BYTE    TSR flags (see #1249)
  288.  01h    WORD    maximum number of programs needing original filesize
  289.  03h    WORD    current number of programs needing original filesize
  290.  05h    WORD    maximum number of files that can be handled by dLite (should
  291.           be the same as FILES= in CONFIG.SYS)
  292.  07h    WORD    offset (in the same segment as the parameter block) of the
  293.           table of programs needing the original filesize (8 bytes
  294.           each,    without path or extension, uppercase, and zero \
  295.           terminated if    shorter than 8 bytes)
  296.  
  297. Bitfields for dLite TSR flags:
  298. Bit(s)    Description    (Table 1249)
  299.  0    deny FCB access
  300.  1    dLite sleeping rather than activated
  301.  2    always indicate original filesize when reading directory entries,
  302.       rather than only for specified programs
  303.  3-7    reserved
  304. --------V-2D--10-----------------------------
  305. INT 2D - Burnout Plus v3.00 - GET STATE/CONTROL INFORMATION
  306.     AL = 10h
  307.     AH = AMIS multiplex number for Burnout Plus
  308. Return: AL = 01h
  309.     BX = Burnout Plus status (see #1250)
  310.     CX = record of features loaded (see #1251)
  311.     ES:DI -> Burnout Plus control structure (see #1252)
  312. Program: Burnout Plus is a DOS screen saver from Cove Software
  313. SeeAlso: INT 14/AX=AA01h,INT 2D"AMIS"
  314. Index:    screen saver;Burnout Plus
  315.  
  316. Bitfields for Burnout Plus status:
  317. Bit(s)    Description    (Table 1250)
  318.  0    screen is blanked
  319.  1    MS Windows is active (Burnout Plus deactivated)
  320.  2-15    reserved
  321.  
  322. Bitfields for Burnout Plus features loaded/features enabled:
  323. Bit(s)    Description    (Table 1251)
  324.  0    mouse activity monitor
  325.  1    passkey support
  326.  2    password support
  327.  3    continuous clear
  328.  4    software blanking
  329.  5    video activity monitor
  330.  6    disk activity monitor
  331.  7    activating keystroke suppression
  332.  
  333. Format of Burnout Plus control structure:
  334. Offset    Size    Description    (Table 1252)
  335.  00h    BYTE    size of structure in bytes
  336.  01h    WORD    Burnout Plus version
  337.  03h    WORD    screen blanking reset count in clock ticks
  338.  05h    WORD    current countdown value in clock ticks
  339.  07h    BYTE    type of timeout specification
  340.  08h    BYTE    instant-blank hotkey
  341.  09h    WORD    extended status information (see #1253)
  342.         the bits for password, passkey, and software blanking are
  343.           ignored and cannot be enabled or disabled externally
  344.  0Bh    WORD    features enabled (see #1251)
  345. Note:    all fields except the first two may be modified by external programs
  346.       to affect the operation of Burnout Plus
  347. Index:    hotkeys;Burnout Plus
  348.  
  349. Bitfields for extended Burnout Plus status information:
  350. Bit(s)    Description    (Table 1253)
  351.  0    Burnout Plus disabled
  352.  1    force screen to blank on next clock tick
  353.  2    restore screen if currently blanked
  354.  3-15    reserved
  355. Note:    1 and 2 are automatically cleared by Burnout Plus after blanking
  356.       or restoring the screen
  357. --------V-2D--10-----------------------------
  358. INT 2D U - Screen Thief v1.00 - FREE HIGH MEMORY BUFFERS
  359.     AL = 10h
  360.     AH = AMIS multiplex number for Screen Thief
  361. Return: nothing
  362. Program: Screen Thief is a graphics screen grabber
  363. Note:    releases any code and data stored in EMS, DOS UMBs, or XMS UMBs, but
  364.       does not release the low-memory stub; this may be used to effect a
  365.       partial uninstall if INT 2D/AL=02h fails
  366. SeeAlso: INT D8"Screen Thief"
  367. --------i-2D--10-----------------------------
  368. INT 2D U - RAMLIGHT v1.0 - GET MONITORING INFORMATION
  369.     AL = 10h
  370.     AH = AMIS multiplex number for RAMLIGHT
  371. Return: ES:BX -> array of fake device driver headers used in monitoring
  372.     CX = number of drives being monitored???
  373. --------d-2D--11-----------------------------
  374. INT 2D - dLite 1.0+ - CHECK FOR dPressed FILE AND GET ORIGINAL SIZE
  375.     AL = 11h
  376.     AH = AMIS multiplex number for dLite
  377.     BX = file handle
  378. Return: CF clear if successful
  379.         DX:AX = size of uncompressed file
  380.     CF set on error (not dPressed file)
  381. SeeAlso: AL=10h"dLite",AL=12h"dLite"
  382. --------d-2D--12-----------------------------
  383. INT 2D - dLite 1.0+ - CHECK FOR dPressed FILE AND GET COMPRESSED SIZE
  384.     AL = 12h
  385.     AH = AMIS multiplex number for dLite
  386.     BX = file handle
  387. Return: CF clear if successful
  388.         DX:AX = size of compressed file
  389.     CF set on error (not dPressed file)
  390. SeeAlso: AL=10h"dLite",AL=11h"dLite"
  391. --------b-2D--DC-----------------------------
  392. INT 2D C - DAISY.SYS - BROADCAST: CHAIN RESCANNED
  393.     AL = DCh
  394.     AH = AMIS multiplex number for signature 'DAISYCHA' 'INDRIVER'
  395.     DL = LPT Port Rescanned
  396. Program: DAISY.SYS is a daisy chain manager for parallel port peripherals
  397.       conforming to the Advanced Parallel Port Committee's daisy chain
  398.       specification.
  399. Desc:    This Broadcast is sent whenever daisy chain IDs are reassigned to
  400.       warn parallel port device drivers that their daisy chain ID may
  401.       have been changed.
  402. Note:    This function is a callout from DAISY.SYS, NOT a call into DAISY.SYS
  403. SeeAlso: INT 17/AX=0200h"Advanced Parallel Port"
  404. --------l-2E---------------------------------
  405. INT 2E U - DOS 2+ - PASS COMMAND TO COMMAND INTERPRETER FOR EXECUTION
  406.     DS:SI -> commandline to execute (see #1254)
  407. Return: all registers except CS:IP destroyed
  408.     AX = status (4DOS v4.0)
  409.        0000h successful
  410.        FFFFh error before processing command (not enough memory, etc)
  411.        other error number returned by command
  412. Notes:    this call allows execution of arbitrary commands (including COMMAND.COM
  413.       internal commands) without loading another copy of COMMAND.COM
  414.     if COMMAND.COM is the user's command interpreter, the primary copy
  415.       executes the command; this allows the master environment to be
  416.       modified by issuing a "SET" command, but changes in the master
  417.       environment will not become effective until all programs descended
  418.       from the primary COMMAND.COM terminate
  419.     since COMMAND.COM processes the string as if typed from the keyboard,
  420.       the transient portion needs to be present, and the calling program
  421.       must ensure that sufficient memory to load the transient portion can
  422.       be allocated by DOS if necessary
  423.     results are unpredictable if invoked by a program run from a batch file
  424.       because this call is not reentrant and COMMAND.COM uses the same
  425.       internal variables when processing a batch file
  426.     hooked but ignored by 4DOS v3.0 COMMAND.COM replacement unless SHELL2E
  427.       has been loaded
  428.     the MS-DOS 5 Programmer's Reference calls this "Reload Transient"
  429.  
  430. Format of DOS commandline:
  431. Offset    Size    Description    (Table 1254)
  432.  00h    BYTE    length of command string, not counting trailing CR
  433.  01h    var    command string
  434.   N    BYTE    0Dh (CR)
  435. --------O-2E---------------------------------
  436. INT 2E UP - Windows NT - NATIVE API
  437.     EAX = function number
  438.     EDX = address of parameter block
  439. Return: ???
  440. --------l-2E----BXE22E-----------------------
  441. INT 2E - 4DOS v2.x-3.03 SHELL2E.COM - UNINSTALL
  442.     BX = E22Eh
  443.     DS:SI -> zero byte
  444. Return: if successful, SHELL2E terminates itself with INT 21/AH=4Ch
  445. ----------2F---------------------------------
  446. INT 2F - Multiplex - NOTES
  447.     AH = identifier of program which is to handle the interrupt
  448.        00h-7Fh reserved for DOS
  449.        B8h-BFh reserved for networks
  450.        C0h-FFh reserved for applications
  451.     AL is the function code
  452.    This is a general mechanism for verifying the presence of a TSR and
  453.    communicating with it.  When searching for a free identifier code for AH
  454.    using the installation check (AL=00h), the calling program should set
  455.    BX/CX/DX to 0000h and must not depend on any registers other than CS:IP
  456.    and SS:SP to be valid on return, since numerous programs now use additional
  457.    registers on input and/or output for the installation check.
  458. Notes:    Since the multiplex chain is growing so long, and beginning to
  459.       experience multiplex number collisions, I am proposing an alternate
  460.       multiplex interrupt on INT 2D.  If you decide to use the alternate
  461.       multiplex, please let me know.
  462.     DOS and some other programs return values in the flags register, so
  463.       any TSR which chains by calling the previous handler rather than
  464.       jumping to it should ensure that the returned flags are preserved
  465.       and passed back to the original caller
  466. SeeAlso: INT 2D
  467. --------t-2F---------------------------------
  468. INT 2F - BMB Compuscience Canada Utilities Interface - INSTALLATION CHECK
  469.     AH = xx (dynamically assigned based upon a search for a multiplex
  470.          number which doesn't answer installed)
  471.     AL = 00h installation check
  472.     ES:DI = EBEBh:BEBEh
  473. Return: AL = 00h not installed
  474.          01h not installed, not OK to install
  475.          FFh installed; if ES:DI was EBEBh:BEBEh on entry, ES:DI will point
  476.          to a string of the form 'MMMMPPPPPPPPvNNNN' where MMMM is a
  477.          short form of the manufacturer's name, PPPPPPPP is a product
  478.          name and NNNN is the product's version number
  479. --------t-2F---------------------------------
  480. INT 2F - Ross Wentworth's Turbo Pascal POPUP LIBRARY
  481.     AH = programmer-selected multiplex number
  482.     AL = function
  483.         00h installation check
  484.         Return: AL = FFh if installed
  485.         01h get TSR interrupt vectors
  486.         Return: DX:AX -> vector table (see #1255)
  487.         02h get TSR code segment
  488.         Return: AX = code segment for all interrupt handlers
  489.         03h call user exit routine and release TSR's memory
  490.         04h get signature string
  491.         Return: DX:AX -> counted string containing signature
  492.         05h get TSR's INT 2F handler
  493.         Return: DX:AX -> INT 2F handler
  494.         06h enable/disable TSR
  495.         BL = new state (00h disabled, 01h enabled)
  496.         07h activate TSR (popup if not disabled)
  497.         08h get hotkeys
  498.         BL = which hotkey (00h = hotkey 1, 01h = hotkey 2)
  499.         Return: AX = hotkey (AH = keyflags, AL = scancode)
  500.         09h set hotkey
  501.         BL = which hotkey (00h = hotkey 1, 01h = hotkey 2)
  502.         CX = new hotkey (CH = keyflags, CL = scancode)
  503.         0Ah-1Fh reserved
  504. Index:    installation check;Ross Wentworth POPUP library
  505. Index:    hotkeys;Ross Wentworth POPUP library
  506.  
  507. Format of POPUP vector table entry:
  508. Offset    Size    Description    (Table 1255)
  509.  00h    BYTE    vector number (00h = end of table)
  510.  01h    DWORD    original vector
  511.  05h    WORD    offset of interrupt handler in TSR's code segment
  512. --------t-2F---------------------------------
  513. INT 2F - CiriSOFT Spanish University of Valladolid TSR's Interface
  514.     AH = xx (dynamically assigned based upon a search for a multiplex
  515.          number from C0h to FFh which doesn't answer installed)
  516.     AL = 00h installation check
  517.     ES:DI = 1492h:1992h
  518. Return: AL = 00h not installed
  519.          01h not installed, not OK to install
  520.          FFh installed; and if ES:DI was 1492h:1992h on entry, ES:DI will
  521.          point to author_name_ver table (see #1256)
  522.     AH = FFh
  523. Note:    this interface permits advanced communication with TSRs: it is possible
  524.       to make a generic uninstall utility, advanced TSR relocator programs
  525.       in order to fit fragmented memory areas, etc.
  526. See also: INT 2D"AMIS",INT 2F"Compuscience"
  527. Index:    installation check;CiriSOFT TSR interface
  528. Index:    uninstall;CiriSOFT TSR interface
  529.  
  530. Format of CiriSOFT author_name_ver table:
  531. Offset    Size    Description    (Table 1256)
  532.  -16    WORD    segment of the start of the resident TSR code (CS in programs
  533.           with PSP, XMS upper memory segment if installed as UMB...)
  534.  -14    WORD    offset of the start of the resident TSR code (frequently 100h
  535.           in *.COM programs and 0 in upper memory TSR's).
  536.  -12    WORD    memory used by TSR (in paragraphs). Knowing the memory area
  537.           used by TSR is possible to determine if hooked vectors are
  538.           still pointing it (and if it is safe to uninstall).
  539.  -10    BYTE    characteristics byte (see #1257)
  540.  -9    BYTE    number of multiplex entry used (redefinition available). Note
  541.           that the TSR must use THIS variable in it's INT 2Fh handler.
  542.  -8    WORD    offset to vector_area table (see #1258)
  543.  -6    WORD    offset to extra_area table (see bit 7 in offset -10 and below)
  544.  -4   4 BYTEs    signature string "*##*"
  545.  00h    var    "AUTHOR:PROGRAM_NAME:VERSION",0     (variable length, this area
  546.           is used in order to determine if the TSR is already resident
  547.           and it's version code; the ':' char is used as delimiter)
  548.  
  549. Bitfields for CiriSOFT characteristics byte:
  550. Bit(s)    Description    (Table 1257)
  551.  0-2    type
  552.     000 normal program (with PSP)
  553.     001 upper XMS memory block (needed HIMEM.SYS function to free memory
  554.           when uninstalling)
  555.     010 device driver (*.SYS)
  556.     011 device driver in EXE format
  557.     1xx others (reserved)
  558.  3-6    reserved
  559.  7    set if extra_table defined and supported
  560.  
  561. Format of CiriSOFT vector_area table:
  562. Offset    Size    Description    (Table 1258)
  563.  -1    BYTE    number of vectors intercepted by TSR
  564.  00h    BYTE    first vector number
  565.  01h    DWORD    first vector pointer before installing the TSR
  566.  05h    BYTE    second vector number
  567.  06h    DWORD    second vector pointer before installing the TSR
  568.  0Ah    ...    (and so on)
  569. Note:    the TSR must use these variables to invoke the previous interrupt
  570.       handler routines
  571.  
  572. Format of extra_area table (needed only to improve relocation feature):
  573. Offset    Size    Description    (Table 1259)
  574.  00h    WORD    offset to external_ctrl table (0 if not supported)
  575.  02h    WORD    reserved for future use (0)
  576.  
  577. Format of CiriSOFT external_ctrl table:
  578. Offset    Size    Description    (Table 1260)
  579.  00h    BYTE    bit 0: TSR is relocatable (no absolute segment references)
  580.  01h    WORD    offset to a variable which can activate/inhibit the TSR
  581.  ---And if bit 0 in offset 00h is off:
  582.  03h    DWORD    pointer to ASCIZ pathname for executable file which supports
  583.           /SR parameter (silent installation & inhibit)
  584.  07h    DWORD    pointer to first variable to initialize on the copy reloaded
  585.           from the previous TSR still resident
  586.  0Bh    DWORD    pointer to last variable (all variables packed in one block)
  587. --------c-2F00-------------------------------
  588. INT 2F U - DOS 2.x only PRINT.COM - ???
  589.     AH = 00h
  590.     ???
  591. Return: ???
  592. Notes:    DOS 2.x PRINT.COM does not chain to previous INT 2F handler
  593.     values in AH other than 00h or 01h cause PRINT to return the number of
  594.       files in the queue in AH
  595. SeeAlso: AH=01h
  596. --------P-2F00-------------------------------
  597. INT 2F U - PSPRINT - PRINT JOB CONTROL
  598.     AH = 00h
  599.     ???
  600. Return: ???
  601. --------c-2F0080-----------------------------
  602. INT 2F - DOS 3.1+ PRINT - GIVE PRINT A TIME SLICE
  603.     AX = 0080h
  604. Return: after PRINT executes
  605. Notes:    PRINT returns AL=01h if AH=00h but AL is not 80h on entry
  606.     this function is not supported by the Novell DOS 7 PRINT.COM
  607. --------N-2F00D8-----------------------------
  608. INT 2F - Personal NetWare - VLM - ???
  609.     AX = 00D8h
  610.     ???
  611. Return: ???
  612. Note:    hooked by one of the .VLMs loaded by VLM.EXE v1.10, but apparently a
  613.       NOP
  614. --------c-2F01-------------------------------
  615. INT 2F U - DOS 2.x only PRINT.COM - ???
  616.     AH = 01h
  617.     ???
  618. Return: ???
  619. Notes:    DOS 2.x PRINT.COM does not chain to previous INT 2F handler
  620.     values in AH other than 00h or 01h cause PRINT to return the number of
  621.       files in the queue in AH
  622. SeeAlso: AH=00h
  623. --------c-2F0100-----------------------------
  624. INT 2F - DOS 3+ PRINT - INSTALLATION CHECK
  625.     AX = 0100h
  626. Return: AL = status
  627.         00h not installed
  628.         01h not installed, but not OK to install
  629.         FFh installed
  630.         AH = 00h (Novell DOS 7)
  631. SeeAlso: AX=0101h
  632. --------c-2F0100SI20D6-----------------------
  633. INT 2F U - PrintCache 3.1 PRINT.COM - INSTALLATION CHECK
  634.     AX = 0100h
  635.     SI = 20D6h
  636.     DI = 8761h
  637. Return: AX = 00FFh if installed
  638.     DI = 0001h if PrintCache's PRINT.COM installed and magic values match
  639.         SI = resident code segment
  640. Program: PrintCache PRINT.COM is a DOS PRINT replacement included in
  641.       LaserTools' PrintCache memory/disk-based print spooler package
  642. Note:    if either of SI or DI differ from the indicated magic values, only AX
  643.       will be modified on return, for compatibility with DOS PRINT
  644. SeeAlso: AX=0101h/SI=20D6h,AX=C000h"PCACHE"
  645. --------c-2F0101-----------------------------
  646. INT 2F - DOS 3+ PRINT - SUBMIT FILE FOR PRINTING
  647.     AX = 0101h
  648.     DS:DX -> submit packet (see #1261)
  649. Return: CF clear if successful
  650.         AL = status
  651.         01h added to queue
  652.         9Eh now printing
  653.     CF set on error
  654.         AX = error code (see #1262,#0789 at INT 21/AH=59h)
  655. SeeAlso: AX=0102h
  656.  
  657. Format of PRINT submit packet:
  658. Offset    Size    Description    (Table 1261)
  659.  00h    BYTE    level (must be 00h)
  660.  01h    DWORD    pointer to ASCIZ filename (no wildcards)
  661.  
  662. (Table 1262)
  663. Values for PRINT error code:
  664.  0001h    invalid function
  665.  0002h    file not found
  666.  0003h    path not found
  667.  0004h    out of file handles
  668.  0005h    access denied
  669.  0008h    print queue full
  670.  0009h    spooler busy
  671.  000Ch    name too long
  672.  000Fh    invalid drive
  673. --------c-2F0101SI20D6-----------------------
  674. INT 2F U - PrintCache v3.1 PRINT.COM - SUBMIT FILE FOR PRINTING
  675.     AX = 0101h
  676.     SI = 20D6h
  677.     DI = 8761h
  678.     DS:DX -> submit packet (see #1261)
  679.     CL = print options
  680.         bit 4: use default options
  681. Return: CF clear if successful
  682.         AL = status
  683.         01h added to queue
  684.         9Eh now printing
  685.     CF set on error
  686.         AX = error code (see #1262)
  687. Program: PrintCache PRINT.COM is a DOS PRINT replacement included in
  688.       LaserTools' PrintCache memory/disk-based print spooler package
  689. Note:    if either SI or DI differs from the indicated magic values on entry,
  690.       PrintCache will use the default print options for the file for
  691.       compatibility with DOS PRINT
  692. SeeAlso: AX=0100h/SI=20D6h,AX=0101h,AX=0107h"PrintCache"
  693. --------c-2F0102-----------------------------
  694. INT 2F - DOS 3+ PRINT - REMOVE FILE FROM PRINT QUEUE
  695.     AX = 0102h
  696.     DS:DX -> ASCIZ filename (wildcards allowed)
  697. Return: CF clear if successful
  698.     CF set on error
  699.         AX = error code (see #1262)
  700. SeeAlso: AX=0101h,AX=0103h
  701. --------c-2F0103-----------------------------
  702. INT 2F - DOS 3+ PRINT - CANCEL ALL FILES IN PRINT QUEUE
  703.     AX = 0103h
  704. Return: CF clear if successful
  705.     CF set on error
  706.         AX = error code (see #1262)
  707. SeeAlso: AX=0102h
  708. --------c-2F0104-----------------------------
  709. INT 2F - DOS 3+ PRINT - FREEZE PRINT QUEUE TO READ JOB STATUS
  710.     AX = 0104h
  711. Return: CF clear if successful
  712.         DX = error count since status last read
  713.         DS:SI -> print queue
  714.     CF set on error
  715.         AX = error code (see #1262)
  716. Desc:    get the list of print jobs, temporarily suspending PRINT's activities
  717.       to avoid changing the list while it is being examined
  718. Notes:    the print queue is an array of 64-byte ASCIZ filenames terminated by
  719.       an empty filename; the first name is the file currently being printed
  720.     printing is stopped until AX=0105h is called to prevent the queue
  721.       from changing while the filenames are being read
  722. SeeAlso: AX=0101h,AX=0105h
  723. --------c-2F0105-----------------------------
  724. INT 2F - DOS 3+ PRINT - RESTART PRINT QUEUE AFTER STATUS READ
  725.     AX = 0105h
  726. Return: CF clear if successful
  727.     CF set on error
  728.         AX = error code (see #1262)
  729. Desc:    restart PRINT's activities once an application finishes examining the
  730.       print queue
  731. SeeAlso: AX=0104h
  732. --------c-2F0106-----------------------------
  733. INT 2F - DOS 3.3+ PRINT - GET PRINTER DEVICE
  734.     AX = 0106h
  735. Return: CF set if files in print queue
  736.         AX = error code 0008h (queue full)
  737.         DS:SI -> device driver header
  738.     CF clear if print queue empty
  739.         AX = 0000h
  740. Desc:    determine which device, if any, PRINT is currently using for output
  741. Notes:    undocumented prior to the release of MS-DOS 5.0
  742.     this function can be used to allow a program to avoid printing to the
  743.       printer on which PRINT is currently performing output
  744. SeeAlso: AX=0104h
  745. --------c-2F0107-----------------------------
  746. INT 2F U - PrintCache v3.1 PRINT.COM - SET TRAILING FORM FEEDS
  747.     AX = 0107h
  748.     CL bit 0: output form feed between print jobs
  749. Return: AL destroyed
  750. SeeAlso: AX=0100h/SI=20D6h,AX=0101h/SI=20D6h
  751. --------N-2F0200-----------------------------
  752. INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - INSTALLATION CHECK
  753.     AX = 0200h
  754. Return: AL = FFh if installed
  755. Desc:    determine whether the PC LAN Program redirector is installed
  756. SeeAlso: AX=0201h,AX=0203h
  757. --------N-2F0201-----------------------------
  758. INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???
  759.     AX = 0201h
  760. Return: nothing???
  761. Notes:    this function is called by the DOS 3.3+ PRINT.COM
  762.     AX=0202h appears to be the opposite function
  763.     these functions are supposedly used to signal opening and closing of
  764.       printers
  765. SeeAlso: AX=0202h
  766. --------N-2F0202-----------------------------
  767. INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???
  768.     AX = 0202h
  769.     ???
  770. Return: nothing???
  771. Notes:    this function is called by the DOS 3.3+ PRINT.COM
  772.     these functions are supposedly used to signal opening and closing of
  773.       printers
  774. SeeAlso: AX=0201h
  775. --------N-2F0203-----------------------------
  776. INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???
  777.     AX = 0203h
  778. Return: nothing???
  779. Notes:    this function is called by the DOS 3.3+ PRINT.COM
  780.     AX=0204h appears to be the opposite function
  781.     these functions are supposedly used to signal opening and closing of
  782.       printers
  783. SeeAlso: AX=0200h,AX=0204h
  784. --------N-2F0204-----------------------------
  785. INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???
  786.     AX = 0204h
  787.     ???
  788. Return: nothing???
  789. Notes:    this function is called by the DOS 3.3+ PRINT.COM
  790.     AX=0203h appears to be the opposite function
  791.     these functions are supposedly used to signal opening and closing of
  792.       printers
  793. SeeAlso: AX=0200h,AX=0203h
  794. --------N-2F---------------------------------
  795. INT 2F U - PC LAN PROGRAM REDIR/REDIRIFS internal - ???
  796.     AX = 02xxh
  797.     ???
  798. Return: ???
  799. --------l-2F0500-----------------------------
  800. INT 2F U - DOS 3+ CRITICAL ERROR HANDLER - INSTALLATION CHECK
  801.     AX = 0500h
  802. Return: AL = 00h not installed, OK to install
  803.          01h not installed, can't install
  804.          FFh installed
  805. Desc:    determine whether a critical error message override is installed
  806. Note:    this set of functions allows a user program to partially or completely
  807.       override the default critical error handler's message in COMMAND.COM
  808. SeeAlso: AH=05h,INT 24
  809. --------l-2F05-------------------------------
  810. INT 2F CU - DOS 3+ CRITICAL ERROR HANDLER - EXPAND ERROR INTO STRING
  811.     AH = 05h
  812. ---DOS 3.x---
  813.     AL = extended error code (not zero)
  814. ---DOS 4+ ---
  815.     AL = error type
  816.         01h DOS extended error code
  817.         02h parameter error
  818.     BX = error code
  819. Return: CF clear if successful
  820.         ES:DI -> ASCIZ error message (read-only)
  821.         AL = completion state
  822.         00h message requires completion with device name, drive, etc.
  823.         01h message is complete as returned
  824.     CF set if error code can't be converted to string
  825.         AX,DI,ES destroyed
  826.     other flags corrupted
  827. Notes:    called at start of COMMAND.COM's default critical error handler if
  828.       installed by a user program, allowing partial or complete overriding
  829.       of the default error messages
  830.     subfunction 02h is called by many DOS 4 external programs
  831.     DR-DOS's COMMAND.COM appends additional info ("0 files copied") to the
  832.       returned string
  833. SeeAlso: AX=0500h,AX=122Eh,INT 24
  834. --------U-2F0600-----------------------------
  835. INT 2F - DOS 3+ ASSIGN - INSTALLATION CHECK
  836.     AX = 0600h
  837. Return: AL = status
  838.         00h not installed
  839.         01h not installed, but not OK to install
  840.         FFh installed
  841. Notes:    ASSIGN is not a TSR in DR-DOS 5.0; it is internally replaced by SUBST
  842.       (see INT 21/AH=52h)
  843.     undocumented prior to the release of DOS 5.0
  844. SeeAlso: AX=0601h,INT 21/AH=52h
  845. --------U-2F0601-----------------------------
  846. INT 2F U - DOS 3+ ASSIGN - GET DRIVE ASSIGNMENT TABLE
  847.     AX = 0601h
  848. Return: ES = segment of ASSIGN work area and assignment table
  849. Note:    under DOS 3+, the 26 bytes starting at ES:0103h specify which drive
  850.       each of A: to Z: is mapped to.  Initially set to 01h 02h 03h....
  851. SeeAlso: AX=0600h
  852. --------D-2F0800-----------------------------
  853. INT 2F U - DRIVER.SYS support - INSTALLATION CHECK
  854.     AX = 0800h
  855. Return: AL = status
  856.         00h not installed, OK to install
  857.         01h not installed, not OK to install
  858.         FFh installed
  859. Desc:    determine whether the internal support code used by DRIVER.SYS is
  860.       present; it is always present in DOS 3.2+
  861. Note:    supported by DR-DOS 5.0
  862. --------D-2F0801-----------------------------
  863. INT 2F U - DRIVER.SYS support - ADD NEW BLOCK DEVICE
  864.     AX = 0801h
  865.     DS:DI -> drive data table (see #1269,#1270,#1271)
  866. Return: AX,BX,SI,ES destroyed
  867. Notes:    moves down internal list of drive data tables, copying and modifying
  868.       the drive description flags word for tables referencing same physical
  869.       drive
  870.     the data table is appended to the chain of tables
  871.     supported by DR-DOS 5.0
  872. SeeAlso: AX=0803h
  873. --------D-2F0802-----------------------------
  874. INT 2F U - DRIVER.SYS support - EXECUTE DEVICE DRIVER REQUEST
  875.     AX = 0802h
  876.     ES:BX -> device driver request header (see #1265)
  877. Return: request header updated as per requested operation
  878. Notes:    supported by DR-DOS 5.0
  879.     DOS 3.2 executes this function on any AL value from 02h through F7h;
  880.       DOS 4+ executes this function on AL=02h and AL=04h-F7h
  881.     the command codes and structures described below apply to all drivers
  882.       which support the appropriate commands; this call is just one of a
  883.       number of ways in which a device driver request may be invoked
  884. SeeAlso: AX=0800h,AX=0801h,AX=0803h,INT 21/AH=52h,INT 21/AH=99h,INT 21/AH=9Ah
  885.  
  886. (Table 1263)
  887. Values for device driver command code:
  888.  00h    INIT
  889.  01h    MEDIA CHECK (block devices)
  890.  02h    BUILD BPB (block devices)
  891.  03h    IOCTL INPUT
  892.  04h    INPUT
  893.  05h    NONDESTRUCTIVE INPUT, NO WAIT (character devices)
  894.  06h    INPUT STATUS (character devices)
  895.  07h    INPUT FLUSH (character devices)
  896.  08h    OUTPUT
  897.  09h    OUTPUT WITH VERIFY
  898.  0Ah    OUTPUT STATUS (character devices)
  899.  0Bh    OUTPUT FLUSH (character devices)
  900.  0Ch    IOCTL OUTPUT
  901.  0Dh    (DOS 3+) DEVICE OPEN
  902.  0Eh    (DOS 3+) DEVICE CLOSE
  903.  0Fh    (DOS 3+) REMOVABLE MEDIA (block devices)
  904.  10h    (DOS 3+) OUTPUT UNTIL BUSY (character devices)
  905.  11h    (European MS-DOS 4.0) STOP OUTPUT (console screen drivers only)
  906.  12h    (European MS-DOS 4.0) RESTART OUTPUT (console screen drivers only)
  907.  13h    (DOS 3.2+) GENERIC IOCTL
  908.  14h    unused
  909.  15h    (European MS-DOS 4.0) RESET UNCERTAIN MEDIA FLAG
  910.  16h    unused
  911.  17h    (DOS 3.2+) GET LOGICAL DEVICE
  912.  18h    (DOS 3.2+) SET LOGICAL DEVICE
  913.  19h    (DOS 5+) CHECK GENERIC IOCTL SUPPORT
  914.  80h    (CD-ROM) READ LONG
  915.  81h    (CD-ROM) reserved
  916.  82h    (CD-ROM) READ LONG PREFETCH
  917.  83h    (CD-ROM) SEEK
  918.  84h    (CD-ROM) PLAY AUDIO
  919.  85h    (CD-ROM) STOP AUDIO
  920.  86h    (CD-ROM) WRITE LONG
  921.  87h    (CD-ROM) WRITE LONG VERIFY
  922.  88h    (CD-ROM) RESUME AUDIO
  923.  
  924. Bitfields for device request status:
  925. Bit(s)    Description    (Table 1264)
  926.  15    error
  927.  14-11    reserved
  928.  10    ??? set by DOS kernel on entry to some driver calls
  929.  9    busy
  930.  8    done (may be clear on return under European MS-DOS 4.0)
  931.  7-0    error code if bit 15 set (see #1266)
  932.  
  933. Format of device driver request header:
  934. Offset    Size    Description    (Table 1265)
  935.  00h    BYTE    length of request header
  936.  01h    BYTE    subunit within device driver
  937.  02h    BYTE    command code (see #1263)
  938.  03h    WORD    status (filled in by device driver) (see #1264)
  939. ---DOS---
  940.  05h  4 BYTEs    reserved (unused in DOS 2.x and 3.x)
  941.  09h    DWORD    (European MS-DOS 4.0 only) pointer to next request header in
  942.               device's request queue
  943.         (other versions) reserved (unused in DOS 2.x and 3.x)
  944. ---STARLITE architecture---
  945.  05h    DWORD    pointer to next request header
  946.  09h  4 BYTEs    reserved
  947. ---command code 00h---
  948.  0Dh    BYTE    (return) number of units
  949.  0Eh    DWORD    (call) pointer to DOS device helper function (see #1267)
  950.               (European MS-DOS 4.0 only)
  951.         (call) pointer past end of memory available to driver (DOS 5+)
  952.         (return) address of first free byte following driver
  953.  12h    DWORD    (call) pointer to commandline arguments
  954.         (return) pointer to BPB array (block drivers) or
  955.               0000h:0000h (character drivers)
  956.  16h    BYTE    (DOS 3+) drive number for first unit of block driver (0=A)
  957.    ---European MS-DOS 4.0---
  958.  17h    DWORD    pointer to function to save registers on stack
  959.    ---DOS 5+ ---
  960.  17h    WORD    (return) error-message flag
  961.         0001h MS-DOS should display error msg on init failure
  962. ---command code 01h---
  963.  0Dh    BYTE    media descriptor
  964.  0Eh    BYTE    (return) media status
  965.         00h don't know
  966.         01h media has not changed
  967.         FFh media has been changed
  968.  0Fh    DWORD    (return, DOS 3+) pointer to previous volume ID if OPEN/CLOSE/RM
  969.           bit in device header is set and disk changed
  970. ---command code 02h---
  971.  0Dh    BYTE    media descriptor
  972.  0Eh    DWORD    transfer address
  973.         -> scratch sector if NON-IBM FORMAT bit in device header set
  974.         -> first FAT sector otherwise
  975.  12h    DWORD    pointer to BPB (set by driver) (see INT 21/AH=53h)
  976. ---command codes 03h,0Ch--- (see also INT 21/AX=4402h,INT 21/AX=4403h)
  977.  0Dh    BYTE    media descriptor (block devices only)
  978.  0Eh    DWORD    transfer address
  979.  12h    WORD    (call) number of bytes to read/write
  980.         (return) actual number of bytes read or written
  981. ---command codes 04h,08h,09h---
  982.  0Dh    BYTE    media descriptor (block devices only)
  983.  0Eh    DWORD    transfer address
  984.  12h    WORD    byte count (character devices) or sector count (block devices)
  985.  14h    WORD    starting sector number (block devices only)
  986.  16h    DWORD    (DOS 3+) pointer to volume ID if error 0Fh returned
  987.  1Ah    DWORD    (DOS 4+) 32-bit starting sector number (block devices with
  988.           device attribute word bit 1 set only) if starting sector
  989.           number above is FFFFh (see INT 21/AH=52h)
  990. ---command code 05h---
  991.  0Dh    BYTE    byte read from device if BUSY bit clear on return
  992. ---command codes 06h,07h,0Ah,0Bh,0Dh,0Eh,0Fh---
  993.  no further fields
  994. ---command code 10h---
  995.  0Dh    BYTE    unused
  996.  0Eh    DWORD    transfer address
  997.  12h    WORD    (call) number of bytes to write
  998.         (return) actual number of bytes written
  999. ---command codes 11h,12h---
  1000.  0Dh    BYTE    reserved
  1001. ---command code 15h---
  1002.  no further fields
  1003. ---command codes 13h,19h---
  1004.  0Dh    BYTE    category code
  1005.         00h unknown
  1006.         01h COMn:
  1007.         03h CON
  1008.         05h LPTn:
  1009.         07h mouse (European MS-DOS 4.0)
  1010.         08h disk
  1011.         9Eh (STARLITE) Media Access Control driver
  1012.  0Eh    BYTE    function code
  1013.         00h (STARLITE) MAC Bind request
  1014.  0Fh    WORD    copy of DS at time of IOCTL call (apparently unused in DOS 3.3)
  1015.         SI contents (European MS-DOS 4.0)
  1016.  11h    WORD    offset of device driver header
  1017.         DI contents (European MS-DOS 4.0)
  1018.  13h    DWORD    pointer to parameter block from INT 21/AX=440Ch or AX=440Dh
  1019. ---command codes 80h,82h---
  1020.  0Dh    BYTE    addressing mode
  1021.         00h HSG (default)
  1022.         01h Phillips/Sony Red Book
  1023.  0Eh    DWORD    transfer address (ignored for command 82h)
  1024.  12h    WORD    number of sectors to read
  1025.         (if 0 for command 82h, request is an advisory seek)
  1026.  14h    DWORD    starting sector number
  1027.         logical sector number in HSG mode
  1028.         frame/second/minute/unused in Red Book mode
  1029.         (HSG sector = minute * 4500 + second * 75 + frame - 150)
  1030.  18h    BYTE    data read mode
  1031.         00h cooked (2048 bytes per frame)
  1032.         01h raw (2352 bytes per frame, including EDC/ECC)
  1033.  19h    BYTE    interleave size (number of sectors stored consecutively)
  1034.  1Ah    BYTE    interleave skip factor
  1035.         (number of sectors between consecutive portions)
  1036. ---command code 83h---
  1037.  0Dh    BYTE    addressing mode (see above)
  1038.  0Eh    DWORD    transfer address (ignored)
  1039.  12h    WORD    number of sectors to read (ignored)
  1040.  14h    DWORD    starting sector number (see also above)
  1041. ---command code 84h---
  1042.  0Dh    BYTE    addressing mode (see above)
  1043.  0Eh    DWORD    starting sector number (see also above)
  1044.  12h    DWORD    number of sectors to play
  1045. ---command codes 85h,88h---
  1046.  no further fields
  1047. ---command codes 86h,87h---
  1048.  0Dh    BYTE    addressing mode (see above)
  1049.  0Eh    DWORD    transfer address (ignored in write mode 0)
  1050.  12h    WORD    number of sectors to write
  1051.  14h    DWORD    starting sector number (see also above)
  1052.  18h    BYTE    write mode
  1053.         00h mode 0 (write all zeros)
  1054.         01h mode 1 (default) (2048 bytes per sector)
  1055.         02h mode 2 form 1 (2048 bytes per sector)
  1056.         03h mode 2 form 2 (2336 bytes per sector)
  1057.  19h    BYTE    interleave size (number of sectors stored consecutively)
  1058.  1Ah    BYTE    interleave skip factor
  1059.         (number of sectors between consecutive portions)
  1060.  
  1061. (Table 1266)
  1062. Values for device driver error code:
  1063.  00h    write-protect violation
  1064.  01h    unknown unit
  1065.  02h    drive not ready
  1066.  03h    unknown command
  1067.  04h    CRC error
  1068.  05h    bad drive request structure length
  1069.  06h    seek error
  1070.  07h    unknown media
  1071.  08h    sector not found
  1072.  09h    printer out of paper
  1073.  0Ah    write fault
  1074.  0Bh    read fault
  1075.  0Ch    general failure
  1076.  0Dh    reserved
  1077.  0Eh    (CD-ROM) media unavailable
  1078.  0Fh    invalid disk change
  1079.  
  1080. (Table 1267)
  1081. Call European MS-DOS 4.0 device helper function with:
  1082.     DL = function
  1083.         00h "SchedClock" called on each timer tick
  1084.         AL = tick interval in milliseconds
  1085.         01h "DevDone" device I/O complete
  1086.         ES:BX -> request header
  1087.         Note:    must update status word first; may be called from
  1088.               an interrupt handler
  1089.         02h "PullRequest" pull next request from queue
  1090.         DS:SI -> DWORD pointer to start of device's request queue
  1091.         Return: ZF clear if pending request
  1092.                 ES:BX -> request header
  1093.             ZF set if no more requests
  1094.         03h "PullParticular" remove specific request from queue
  1095.         DS:SI -> DWORD pointer to start of device's request queue
  1096.         ES:BX -> request header
  1097.         Return: ZF set if request header not found
  1098.         04h "PushRequest" push the request onto the queue
  1099.         DS:SI -> DWORD pointer to start of device's request queue
  1100.         ES:BX -> request header
  1101.         interrupts disabled
  1102.         05h "ConsInputFilter" keyboard input check
  1103.         AX = character (high byte 00h if PC ASCII character)
  1104.         Return: ZF set if character should be discarded
  1105.             ZF clear if character should be handled normally
  1106.         Note:    called by keyboard interrupt handler so DOS can scan
  1107.               for special input characters
  1108.         06h "SortRequest" push request in sorted order by starting sector
  1109.         DS:SI -> DWORD pointer to start of device's request queue
  1110.         ES:BX -> request header
  1111.         interrupts disabled
  1112.         07h "SigEvent" send signal on keyboard event
  1113.         AH = event identifier
  1114.         Return: AL,FLAGS destroyed
  1115.         09h "ProcBlock" block on event
  1116.         AX:BX = event identifier (typically a pointer)
  1117.         CX = timeout in ms or 0000h for never
  1118.         DH = interruptable flag (nonzero if pause may be interrupted)
  1119.         interrupts disabled
  1120.         Return: after corresponding ProcRun call
  1121.             CF clear if event wakeup, set if unusual wakeup
  1122.             ZF set if timeout wakeup, clear if interrupted
  1123.             AL = wakeup code, nonzero if unusual wakeup
  1124.             interrupts enabled
  1125.             BX,CX,DX destroyed
  1126.         Note:    block process and schedules another to run
  1127.         0Ah "ProcRun" unblock process
  1128.         AX:BX = event identifier (typically a pointer)
  1129.         Return: AX = number of processes awakened
  1130.             ZF set if no processes awakened
  1131.             BX,CX,DX destroyed
  1132.         0Bh "QueueInit" initialize/clear character queue
  1133.         DS:BX -> character queue structure (see #1268)
  1134.         Note:    the queue size field must be set before calling
  1135.         0Dh "QueueWrite" put a character in the queue
  1136.         DS:BX -> character queue (see #1268)
  1137.         AL = character to append to end of queue
  1138.         Return: ZF set if queue is full
  1139.             ZF clear if character stored
  1140.         0Eh "QueueRead" get a character from the queue
  1141.         DS:BX -> character queue (see #1268)
  1142.         Return: ZF set if queue is empty
  1143.             ZF clear if characters in queue
  1144.                 AL = first character in queue
  1145.         10h "GetDOSVar" return pointer to DOS variable
  1146.         AL = index of variable
  1147.             03h current process ID
  1148.         BX = index into variable if AL specifies an array
  1149.         CX = expected length of variable
  1150.         Return: CF clear if successful
  1151.                 DX:AX -> variable
  1152.             CF set on error
  1153.                 AX,DX destroyed
  1154.             BX,CX destroyed
  1155.         Note:    the variables may not be modified
  1156.         14h "Yield" yield CPU if higher-priority task ready to run
  1157.         Return: FLAGS destroyed
  1158.         1Bh "CritEnter" begin system critical section
  1159.         DS:BX -> semaphore (6 BYTEs, initialized to zero)
  1160.         Return: AX,BX,CX,DX destroyed
  1161.         1Ch "CritLeave" end system critical section
  1162.         DS:BX -> semaphore (6 BYTEs, initialized to zero)
  1163.         Return: AX,BX,CX,DX destroyed
  1164.         Note:    must be called in the context of the process which
  1165.               called CritEnter on the semaphore
  1166. Note:    the DWORD pointing at the request queue must be allocated by the driver
  1167.       and initialized to 0000h:0000h.  It always points at the next request
  1168.       to be executed
  1169.  
  1170. Format of European MS-DOS 4.0 character queue:
  1171. Offset    Size    Description    (Table 1268)
  1172.  00h    WORD    size of queue in bytes
  1173.  02h    WORD    index of next character out
  1174.  04h    WORD    count of characters in the queue
  1175.  06h  N BYTEs    queue buffer
  1176. --------D-2F0803-----------------------------
  1177. INT 2F U - DOS 4+ DRIVER.SYS support - GET DRIVE DATA TABLE LIST
  1178.     AX = 0803h
  1179. Return: DS:DI -> first drive data table in list
  1180. Note:    not available under DR-DOS 5.0
  1181. SeeAlso: AX=0801h
  1182.  
  1183. Format of DOS 3.30 drive data table:
  1184. Offset    Size    Description    (Table 1269)
  1185.  00h    DWORD    pointer to next table (offset FFFFh if last table)
  1186.  04h    BYTE    physical unit number (for INT 13)
  1187.  05h    BYTE    logical drive number (0=A:)
  1188.  06h 19 BYTEs    BIOS Parameter Block (see also INT 21/AH=53h)
  1189.         Offset    Size    Description
  1190.          00h    WORD    bytes per sector
  1191.          02h    BYTE    sectors per cluster, FFh if unknown
  1192.          03h    WORD    number of reserved sectors
  1193.          05h    BYTE    number of FATs
  1194.          06h    WORD    number of root dir entries
  1195.          08h    WORD    total sectors
  1196.          0Ah    BYTE    media descriptor, 00h if unknown
  1197.          0Bh    WORD    sectors per FAT
  1198.          0Dh    WORD    sectors per track
  1199.          0Fh    WORD    number of heads
  1200.          11h    WORD    number of hidden sectors
  1201.  19h    BYTE    flags
  1202.         bit 6: 16-bit FAT instead of 12-bit FAT
  1203.  1Ah    WORD    number of DEVICE OPEN calls without corresponding DEVICE CLOSE
  1204.  1Ch 11 BYTEs    volume label or "NO NAME    " if none (always "NO NAME" for
  1205.           fixed media)
  1206.  27h    BYTE    terminating null for volume label???
  1207.  28h    BYTE    device type (see INT 21/AX=440Dh)
  1208.  29h    WORD    bit flags describing drive (see #1272)
  1209.  2Bh    WORD    number of cylinders
  1210.  2Dh 19 BYTEs    BIOS Parameter Block for highest capacity supported
  1211.  40h  3 BYTEs    ???
  1212.  43h  9 BYTEs    filesystem type???, default = "NO NAME    "
  1213.         (apparently only MS-DOS 3.30 fixed media, nulls for removable
  1214.           media and PC-DOS 3.30)
  1215.  4Ch    BYTE    least-significant byte of last-accessed cylinder number
  1216. ---removable media---
  1217.  4Dh    DWORD    time of last access in clock ticks (FFFFFFFFh if never)
  1218. ---fixed media---
  1219.  4Dh    WORD    partition (FFFFh = primary, 0001h = extended)
  1220.  4Fh    WORD    absolute cylinder number of partition's start on physical
  1221.           drive (always FFFFh if primary partition)
  1222.  
  1223. Format of COMPAQ DOS 3.31 drive data table:
  1224. Offset    Size    Description    (Table 1270)
  1225.  00h    DWORD    pointer to next table (offset FFFFh if last table)
  1226.  04h    BYTE    physical unit number (for INT 13)
  1227.  05h    BYTE    logical drive number (0=A:)
  1228.  06h 25 BYTEs    BIOS Parameter Block (see DOS 4.0-6.0 drive data table below)
  1229.  1Fh  6 BYTEs    reserved fields from BPB above???
  1230.  25h    BYTE    flags
  1231.         bit 6: 16-bit FAT instead of 12-bit FAT
  1232.         bit 5: large volume???
  1233.  26h    WORD    device-open count???
  1234.  28h 11 BYTEs    volume label or "NO NAME    " if none (always "NO NAME" for
  1235.           fixed media)
  1236.  33h    BYTE    terminating null for volume label
  1237.  34h    BYTE    device type (see INT 21/AX=440Dh)
  1238.  35h    WORD    bit flags describing drive (see #1272)
  1239.  37h    WORD    number of cylinders
  1240.  39h 25 BYTEs    BIOS parameter block for highest capacity drive supports
  1241.  52h  6 BYTEs    ??? apparently always zeros
  1242.  58h    BYTE    least-significant byte of last-accessed cylinder number
  1243. ---removable media---
  1244.  59h    DWORD    time of last access in clock ticks (FFFFFFFFh if never)
  1245. ---fixed media---
  1246.  59h    WORD    partition (FFFFh = primary, 0001h = extended)
  1247.  5Bh    WORD    absolute cylinder number of partition's start on physical
  1248.           drive (always FFFFh if primary partition)
  1249.  
  1250. Format of DOS 4.0-6.0 drive data table:
  1251. Offset    Size    Description    (Table 1271)
  1252.  00h    DWORD    pointer to next table (offset FFFFh if last table)
  1253.  04h    BYTE    physical unit number (for INT 13)
  1254.  05h    BYTE    logical drive number (0=A:)
  1255.  06h 25 BYTEs    BIOS Parameter Block (see also INT 21/AH=53h)
  1256.         Offset    Size    Description
  1257.          00h    WORD    bytes per sector
  1258.          02h    BYTE    sectors per cluster, FFh if unknown
  1259.          03h    WORD    number of reserved sectors
  1260.          05h    BYTE    number of FATs
  1261.          06h    WORD    number of root dir entries
  1262.          08h    WORD    total sectors (see offset 15h if zero)
  1263.          0Ah    BYTE    media descriptor, 00h if unknown
  1264.          0Bh    WORD    sectors per FAT
  1265.          0Dh    WORD    sectors per track
  1266.          0Fh    WORD    number of heads
  1267.          11h    DWORD    number of hidden sectors
  1268.          15h    DWORD    total sectors if WORD at 08h is zero
  1269.  1Fh    BYTE    flags
  1270.         bit 6: 16-bit FAT instead of 12-bit
  1271.         bit 7: unsupportable disk (all accesses will return Not Ready)
  1272.  20h    WORD    device-open count
  1273.  22h    BYTE    device type (see INT 21/AX=440Dh)
  1274.  23h    WORD    bit flags describing drive (see #1272)
  1275.  25h    WORD    number of cylinders (for partition only, if hard disk)
  1276.  27h 25 BYTEs    BIOS Parameter Block for default (highest) capacity supported
  1277.  40h  6 BYTEs    reserved (part of BPB above)
  1278.  46h    BYTE    last track accessed
  1279. ---removable media---
  1280.  47h    DWORD    time of last access in clock ticks (FFFFFFFFh if never)
  1281. ---fixed media---
  1282.  47h    WORD    partition (FFFFh = primary, 0001h = extended)
  1283.         always 0001h for DOS 5+
  1284.  49h    WORD    absolute cylinder number of partition's start on physical drive
  1285.         (FFFFh if primary partition in DOS 4.x)
  1286. ------
  1287.  4Bh 11 BYTEs    volume label or "NO NAME    " if none (apparently taken from
  1288.           extended boot record rather than root directory)
  1289.  56h    BYTE    terminating null for volume label
  1290.  57h    DWORD    serial number
  1291.  5Bh  8 BYTEs    filesystem type ("FAT12      " or "FAT16    ")
  1292.  63h    BYTE    terminating null for filesystem type
  1293.  
  1294. Bitfields for flags describing drive:
  1295. Bit(s)    Description    (Table 1272)
  1296.  0    fixed media
  1297.  1    door lock ("changeline") supported
  1298.  2    current BPB locked
  1299.  3    all sectors in a track are the same size
  1300.  4    physical drive has multiple logical units
  1301.  5    current logical drive for shared physical drive
  1302.  6    disk change detected
  1303.  7    set DASD before formatting
  1304.  8    disk reformatted
  1305.  9    unformatted (fixed media only, disables reads and writes)
  1306. --------f-2F1000-----------------------------
  1307. INT 2F - SHARE - INSTALLATION CHECK
  1308.     AX = 1000h
  1309. Return: AL = status
  1310.         00h not installed, OK to install
  1311.         01h not installed, not OK to install
  1312.         FFh installed
  1313. BUGS:    values of AL other than 00h put DOS 3.x SHARE into an infinite loop
  1314.       (08E9: OR  AL,AL
  1315.        08EB: JNZ 08EB) <- the buggy instruction (DOS 3.3)
  1316.     values of AL other than described here put PC-DOS 4.00 into the same
  1317.       loop (the buggy instructions are the same)
  1318. Notes:    supported by OS/2 v1.3+ compatibility box, which always returns AL=FFh
  1319.     if DOS 4.01 SHARE was automatically loaded, file sharing is in an
  1320.       inactive state (due to the undocumented /NC flag used by the autoload
  1321.       code) until this call is made
  1322.     DOS 5+ chains to the previous handler if AL <> 00h on entry
  1323.     Windows Enhanced mode hooks this call and reports that SHARE is
  1324.       installed even when it is not
  1325. SeeAlso: AX=1080h,INT 21/AH=52h
  1326. --------d-2F1001-----------------------------
  1327. INT 2F U - DR-DOS 6.0 SHARE internal - SET ???
  1328.     AX = 1001h
  1329.     DX:BX -> ???function
  1330. Notes:    this function is also supported by SuperStor, a disk-compression
  1331.       program by Addstor which is bundled with DR-DOS 6.0, and the
  1332.       Novell DOS 7 DELWATCH.EXE
  1333.     the default handler for the pointer set by this call under DELWATCH
  1334.       simply returns with CF set
  1335. SeeAlso: AX=1000h,X=F800h
  1336. --------f-2F1040-----------------------------
  1337. INT 2F U - DOS 4 only SHARE internal - ???
  1338.     AX = 1040h
  1339.     ???
  1340. Return: AL = FFh???
  1341. SeeAlso: AX=1000h
  1342. --------f-2F1080-----------------------------
  1343. INT 2F U - DOS 4 only SHARE internal - TURN ON FILE SHARING CHECKS
  1344.     AX = 1080h
  1345. Return: AL = status
  1346.         F0h successful
  1347.         FFh checking was already on
  1348. Note:    DOS 4.x SHARE has dual functions: FCB support for large (>32M) media
  1349.       and file sharing checks.  The undocumented commandline flag /NC can
  1350.       be used to disable the sharing code.
  1351. SeeAlso: AX=1000h,AX=1081h
  1352. --------f-2F1081-----------------------------
  1353. INT 2F U - DOS 4 only SHARE internal - TURN OFF FILE SHARING CHECKS
  1354.     AX = 1081h
  1355. Return: AL = status
  1356.         F0h successful
  1357.         FFh checking was already off
  1358. Note:    (see AX=1080h)
  1359. SeeAlso: AX=1000h,AX=1080h
  1360. ----------2F10FE-----------------------------
  1361. INT 2F U - Novell DOS 7 DELWATCH.EXE - INSTALLATION CHECK
  1362.     AX = 10FEh
  1363. Return: AX = 20FFh if installed and active
  1364.         DX:BX -> private entry point
  1365.  
  1366. (Table 1273)
  1367. Call DELWATCH private entry point with:
  1368.     AH = function
  1369.         00h NOP???
  1370.         Return: AX = 0000h
  1371.             CX = 0004h (unsupported function)
  1372.         01h disable DELWATCH on drive
  1373.         AL = drive number (00h = A:)
  1374.         Return: AX = status (0000h if failed, FFFFh if successful)
  1375.         02h ???
  1376.         AL = drive number (00h = A:)
  1377.         ???
  1378.         Return: ???
  1379.         03h    ???
  1380.         AL = drive number (00h = A:)
  1381.         CX = ??? (0000h/0001h)
  1382.         ???
  1383.         Return: ???
  1384.         04h ???
  1385.         AL = drive number (00h = A:)
  1386.         ???
  1387.         Return: ???
  1388.         05h ???
  1389.         AL = drive number (00h = A:)
  1390.         ???
  1391.         Return: ???
  1392.         06h enable DELWATCH on drive
  1393.         AL = drive number with bit 7 set (80h = A:, etc.)
  1394.         BX = maximum files of same name in one directory to save
  1395.         CX = maximum files to save on this disk
  1396.         ???
  1397.         Return: AX = status
  1398.                 0000h failed
  1399.                 FFFFh successful
  1400.             CX = error code on failure
  1401.                 (0004h if AL < 80h on entry)
  1402.         07h ???
  1403.         08h set file extensions list
  1404.         AL = sense (00h exclude named extensions, 01h only named ext.)
  1405.         DS:BX -> 31-byte ASCIZ extension list (three blank-padded bytes
  1406.               per extension)
  1407.         Return: AX = FFFFh (successful)
  1408.         09h    ???
  1409.         AL = drive number (00h = A:)
  1410.         ???
  1411.         Return: ???
  1412.         0Ah ???
  1413.         AL = drive number (00h = A:)
  1414.         ???
  1415.         Return: ???
  1416.         0Bh reset ???
  1417.         Return: AX = FFFFh (successful)
  1418.         see also function 0Dh
  1419.         0Ch check if drive enabled
  1420.         AL = drive number with bit 7 set (80h = A:, etc.)
  1421.         Return: AX = state
  1422.                 0000h disabled or error (check CX)
  1423.                 0001h drive enabled
  1424.             CX = error code (0004h invalid drive number)
  1425.         0Dh set ???
  1426.         BX = ???
  1427.         Return: AX = FFFFh (successful)
  1428.         see also function 0Bh
  1429.         0Eh ???
  1430.         AL = drive number (00h = A:)
  1431.         ???
  1432.         Return: ???
  1433. Return: AX = 0000h, CX = 0001h if DELWATCH busy
  1434.     registers unchanged if AH >= 0Fh on entry
  1435. --------O-2F10FF-----------------------------
  1436. INT 2F U - Multiplex - DR-DOS 5.0 - ???
  1437.     AX = 10FFh
  1438.     ES:BX -> ???
  1439. Note:    sets pointer in kernel
  1440. --------N-2F1100-----------------------------
  1441. INT 2F C - NETWORK REDIRECTOR - INSTALLATION CHECK
  1442.     AX = 1100h
  1443. Return: AL = status
  1444.         00h not installed, OK to install
  1445.         01h not installed, not OK to install
  1446.         FFh installed
  1447.         AH = product identifier (ad hoc by various manufacturers)
  1448.             00h if PC Tools v8 DRIVEMAP
  1449.             42h ('B') for Beame&Whiteside BWNFS v3.0a
  1450.             6Eh ('n') for NetWare Lite v1.1 CLIENT
  1451. Notes:    this function is called by the DOS 3.1+ kernel
  1452.     in DOS 4.x only, the 11xx calls are all in IFSFUNC.EXE, not in the
  1453.       PC LAN Program redirector; DOS 5+ moves the calls back into the
  1454.       redirector
  1455.     the PC Network 1.00 redirector (renamed to PC LAN Program in 1.1-1.3)
  1456.       only supports AL=00h-27h
  1457. --------d-2F1100SFDADA-----------------------
  1458. INT 2F - MSCDEX (MS CD-ROM Extensions) - INSTALLATION CHECK
  1459.     AX = 1100h subfn DADAh
  1460.     STACK: WORD DADAh
  1461. Return: AL = status
  1462.         00h not installed, OK to install
  1463.         STACK unchanged
  1464.         01h not installed, not OK to install
  1465.         STACK unchanged
  1466.         FFh installed
  1467.         STACK: WORD    ADADh if MSCDEX installed
  1468.                 DADBh if Lotus CD/Networker installed
  1469. Note:    although MSCDEX sets the stack word to ADADh on return, any value other
  1470.       than DADAh is considered to mean that MSCDEX is already installed;
  1471.       Lotus CD/Networker v4+ uses this feature to fool MSCDEX into
  1472.       thinking it is already installed when it is in fact CD/Networker
  1473.       that is installed
  1474. Index:    installation check;Lotus CD/Networker
  1475. Index:    Lotus CD/Networker;installation check
  1476. --------N-2F1101-----------------------------
  1477. INT 2F CU - NETWORK REDIRECTOR - REMOVE REMOTE DIRECTORY
  1478.     AX = 1101h
  1479.     SS = DOS DS
  1480.     SDA first filename pointer -> fully-qualified directory name
  1481.     SDA CDS pointer -> current directory structure for drive with dir
  1482. Return: CF set on error
  1483.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1484.     CF clear if successful
  1485. Note:    this function is called by the DOS 3.1+ kernel
  1486. SeeAlso: AX=1103h,AX=1105h,INT 21/AH=3Ah,INT 21/AH=60h
  1487. --------N-2F1102-----------------------------
  1488. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - REMOVE REMOTE DIRECTORY
  1489.     AX = 1102h
  1490.     SS = DOS DS
  1491.     SDA first filename pointer -> fully-qualified directory name
  1492.     SDA CDS pointer -> current directory structure for drive with dir
  1493. Return: CF set on error
  1494.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1495.     CF clear if successful
  1496. Note:    appears to be identical to AX=1101h; MS internal documentation calls
  1497.       this function "SEQ_RMDIR"
  1498. SeeAlso: AX=1101h
  1499. --------N-2F1103-----------------------------
  1500. INT 2F CU - NETWORK REDIRECTOR - MAKE REMOTE DIRECTORY
  1501.     AX = 1103h
  1502.     SS = DOS DS
  1503.     SDA first filename pointer -> fully-qualified directory name
  1504.     SDA CDS pointer -> current directory structure for drive with dir
  1505. Return: CF set on error
  1506.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1507.     CF clear if successful
  1508. Note:    this function is called by the DOS 3.1+ kernel
  1509. SeeAlso: AX=1101h,AX=1105h,INT 21/AH=39h,INT 21/AH=60h
  1510. --------N-2F1104-----------------------------
  1511. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - MAKE REMOTE DIRECTORY
  1512.     AX = 1104h
  1513.     SS = DOS DS
  1514.     SDA first filename pointer -> fully-qualified directory name
  1515.     SDA CDS pointer -> current directory structure for drive with dir
  1516. Return: CF set on error
  1517.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1518.     CF clear if successful
  1519. Note:    appears to be identical to AX=1103h
  1520. SeeAlso: AX=1103h
  1521. --------N-2F1105-----------------------------
  1522. INT 2F CU - NETWORK REDIRECTOR - CHDIR
  1523.     AX = 1105h
  1524.     SS = DOS DS
  1525.     SDA first filename pointer -> fully-qualified directory name
  1526.     SDA CDS pointer -> current directory structure for drive with dir
  1527. Return: CF set on error
  1528.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1529.     CF clear if successful
  1530.         CDS updated with new path
  1531. Notes:    this function is called by the DOS 3.1+ kernel
  1532.     directory string in CDS should not have a terminating backslash unless
  1533.       the current directory is the root
  1534. SeeAlso: AX=1101h,AX=1103h,INT 21/AH=3Bh,INT 21/AH=60h
  1535. --------N-2F1106-----------------------------
  1536. INT 2F CU - NETWORK REDIRECTOR - CLOSE REMOTE FILE
  1537.     AX = 1106h
  1538.     BX = device info word from SFT
  1539.     ES:DI -> SFT
  1540.         SFT DPB field -> DPB of drive containing file
  1541. Return: CF set on error
  1542.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1543.     CF clear if successful
  1544.         SFT updated (redirector must decrement open count, which may be
  1545.           done with INT 2F/AX=1208h)
  1546. Note:    this function is called by the DOS 3.1+ kernel
  1547. SeeAlso: AX=1116h,AX=1201h,AX=1208h,AX=1227h,INT 21/AH=3Eh
  1548. --------N-2F1107-----------------------------
  1549. INT 2F CU - NETWORK REDIRECTOR - COMMIT REMOTE FILE
  1550.     AX = 1107h
  1551.     ES:DI -> SFT
  1552.         SFT DPB field -> DPB of drive containing file
  1553. Return: CF set on error
  1554.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1555.     CF clear if successful
  1556.         all buffers for file flushed
  1557.         directory entry updated
  1558. Note:    this function is called by the DOS 3.1+ kernel
  1559. SeeAlso: INT 21/AH=68h,INT 21/AX=5D01h
  1560. --------N-2F1108-----------------------------
  1561. INT 2F CU - NETWORK REDIRECTOR - READ FROM REMOTE FILE
  1562.     AX = 1108h
  1563.     ES:DI -> SFT
  1564.         SFT DPB field -> DPB of drive containing file
  1565.     CX = number of bytes
  1566.     SS = DOS DS
  1567.     SDA DTA field -> user buffer
  1568. Return: CF set on error
  1569.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1570.     CF clear if successful
  1571.         CX = number of bytes read (0000h = end of file)
  1572.         SFT updated
  1573. Note:    this function is called by the DOS 3.1+ kernel
  1574. SeeAlso: AX=1109h,AX=1229h,INT 21/AH=3Fh,INT 21/AX=5D06h
  1575. --------N-2F1109-----------------------------
  1576. INT 2F CU - NETWORK REDIRECTOR - WRITE TO REMOTE FILE
  1577.     AX = 1109h
  1578.     ES:DI -> SFT
  1579.         SFT DPB field -> DPB of drive containing file
  1580.     CX = number of bytes
  1581.     SS = DOS DS
  1582.     SDA DTA field -> user buffer
  1583. Return: CF set on error
  1584.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1585.     CF clear if successful
  1586.         CX = number of bytes written
  1587.         SFT updated
  1588. Notes:    this function is called by the DOS 3.1+ kernel
  1589.     PrintCache v3.1 PCACHE.EXE intercepts this function for SFTs where
  1590.       the Device Driver Header field points at PCACHE, but does not
  1591.       intercept any other network redirector functions
  1592. SeeAlso: AX=1107h,AX=1108h,INT 21/AH=40h,INT 21/AX=5D06h
  1593. --------N-2F110A-----------------------------
  1594. INT 2F CU - NETWORK REDIRECTOR (DOS 3.x only) - LOCK REGION OF FILE
  1595.     AX = 110Ah
  1596.     BX = file handle
  1597.     CX:DX = starting offset
  1598.     SI = high word of size
  1599.     STACK: WORD low word of size
  1600.     ES:DI -> SFT
  1601.         SFT DPB field -> DPB of drive containing file
  1602.     SS = DOS DS
  1603. Return: CF set on error
  1604.        AL = DOS error code (see #0789 at INT 21/AH=59h)
  1605.     STACK unchanged
  1606. Notes:    this function is called by the DOS 3.10-3.31 kernel
  1607.     the redirector is expected to resolve lock conflicts
  1608. SeeAlso: AX=110Bh,INT 21/AH=5Ch
  1609. --------N-2F110A-----------------------------
  1610. INT 2F CU - NETWORK REDIRECTOR (DOS 4+) - LOCK/UNLOCK REGION OF FILE
  1611.     AX = 110Ah
  1612.     BL = function
  1613.         00h lock
  1614.         01h unlock
  1615.     CX = number of lock/unlock parameters (0001h for DOS 4.0-6.1)
  1616.     DS:DX -> parameter block (see #1274)
  1617.     ES:DI -> SFT
  1618.         SFT DPB field -> DPB of drive containing file
  1619.     SS = DOS DS
  1620. Return: CF set on error
  1621.        AL = DOS error code (see #0789 at INT 21/AH=59h)
  1622. Notes:    this function is called by the DOS 4.0+ kernel
  1623.     the redirector is expected to resolve lock conflicts
  1624. SeeAlso: AX=110Bh,INT 21/AH=5Ch
  1625.  
  1626. Format of parameter block entry [array, but currently limited to single entry]:
  1627. Offset    Size    Description    (Table 1274)
  1628.  00h    DWORD    start offset
  1629.  04h    DWORD    size of region
  1630. --------N-2F110B-----------------------------
  1631. INT 2F CU - NETWORK REDIRECTOR (DOS 3.x only) - UNLOCK REGION OF FILE
  1632.     AX = 110Bh
  1633.     BX = file handle
  1634.     CX:DX = starting offset
  1635.     SI = high word of size
  1636.     STACK: WORD low word of size
  1637.     ES:DI -> SFT for file
  1638.         SFT DPB field -> DPB of drive containing file
  1639. Return: CF set on error
  1640.        AL = DOS error code (see #0789 at INT 21/AH=59h)
  1641.     STACK unchanged
  1642. Note:    this function is called by the DOS 3.1-3.31 kernel; DOS 4.0+ calls AX=110Ah instead
  1643. SeeAlso: AX=110Ah,INT 21/AH=5Ch
  1644. --------N-2F110C-----------------------------
  1645. INT 2F CU - NETWORK REDIRECTOR - GET DISK INFORMATION
  1646.     AX = 110Ch
  1647.     ES:DI -> current directory structure for desired drive
  1648. Return: CF clear if data valid
  1649.         AL = sectors per cluster
  1650.         AH = media ID byte
  1651.         BX = total clusters
  1652.         CX = bytes per sector
  1653.         DX = number of available clusters
  1654.     CF set if data invalid
  1655. Note:    this function is called by the DOS 3.1+ kernel
  1656. SeeAlso: INT 21/AH=36h
  1657. --------N-2F110D-----------------------------
  1658. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - SET REMOTE FILE'S ATTRIBUTES
  1659.     AX = 110Dh
  1660.     SDA first filename pointer -> name of file
  1661.     ???
  1662. Return: ???
  1663. Note:    similar to AX=110Eh
  1664. SeeAlso: AX=110Eh
  1665. --------N-2F110E-----------------------------
  1666. INT 2F CU - NETWORK REDIRECTOR - SET REMOTE FILE'S ATTRIBUTES
  1667.     AX = 110Eh
  1668.     SS = DOS DS
  1669.     SDA first filename pointer -> fully-qualified name of file
  1670.     SDA CDS pointer -> current directory structure for drive with file
  1671.     STACK: WORD new file attributes
  1672. Return: CF set on error
  1673.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1674.     CF clear if successful
  1675.     STACK unchanged
  1676. Note:    this function is called by the DOS 3.1+ kernel
  1677. SeeAlso: AX=110Dh,AX=110Fh,INT 21/AX=4301h,INT 21/AH=60h
  1678. --------N-2F110F-----------------------------
  1679. INT 2F CU - NETWORK REDIRECTOR - GET REMOTE FILE'S ATTRIBUTES AND SIZE
  1680.     AX = 110Fh
  1681.     SS = DOS DS
  1682.     SDA first filename pointer -> fully-qualified name of file
  1683.     SDA CDS pointer -> current directory structure for drive with file
  1684. Return: CF set on error
  1685.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1686.     CF clear if successful
  1687.         AX = file attributes
  1688.         BX:DI = file size
  1689. Note:    this function is called by the DOS 3.1+ kernel
  1690. SeeAlso: AX=110Eh,INT 21/AX=4300h,INT 21/AH=60h
  1691. --------N-2F1110-----------------------------
  1692. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - GET REMOTE FILE'S ATTRIBUTES AND SIZE
  1693.     AX = 1110h
  1694.     SDA first filename pointer -> name of file
  1695.     ???
  1696. Return: ???
  1697. Note:    appears to be similar to AX=110Fh
  1698. SeeAlso: AX=110Eh
  1699. --------N-2F1111-----------------------------
  1700. INT 2F CU - NETWORK REDIRECTOR - RENAME REMOTE FILE
  1701.     AX = 1111h
  1702.     SS = DS = DOS DS
  1703.     SDA first filename pointer = offset of fully-qualified old name
  1704.     SDA second filename pointer = offset of fully-qualified new name
  1705.     SDA CDS pointer -> current directory structure for drive with file
  1706. Return: CF set on error
  1707.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1708.     CF clear if successful
  1709. Note:    this function is called by the DOS 3.1+ kernel
  1710. SeeAlso: AX=1112h,INT 21/AH=56h,INT 21/AH=60h
  1711. --------N-2F1112-----------------------------
  1712. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - RENAME REMOTE FILE
  1713.     AX = 1112h
  1714.     SS = DS = DOS DS
  1715.     SDA first filename pointer -> name of file
  1716.     ???
  1717. Return: ???
  1718. Note:    similar to AX=1111h
  1719. SeeAlso: AX=1111h
  1720. --------N-2F1113-----------------------------
  1721. INT 2F CU - NETWORK REDIRECTOR - DELETE REMOTE FILE
  1722.     AX = 1113h
  1723.     SS = DS = DOS DS
  1724.     SDA first filename pointer -> fully-qualified filename in DOS DS
  1725.     SDA CDS pointer -> current directory structure for drive with file
  1726. Return: CF set on error
  1727.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1728.     CF clear if successful
  1729. Notes:    this function is called by the DOS 3.1+ kernel
  1730.     the filespec may contain wildcards
  1731. SeeAlso: AX=1114h,INT 21/AH=41h,INT 21/AH=60h
  1732. --------N-2F1114-----------------------------
  1733. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - DELETE REMOTE FILE
  1734.     AX = 1114h
  1735.     SDA first filename pointer -> name of file
  1736.     ???
  1737. Return: ???
  1738. Note:    similar to AX=1113h
  1739. SeeAlso: AX=1113h
  1740. --------N-2F1115-----------------------------
  1741. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - OPEN REMOTE FILE
  1742.     AX = 1115h
  1743.     SS = DOS DS
  1744.     ES:DI -> SFT ???
  1745.     ???
  1746. Return: ???
  1747. Note:    similar to AX=1116h
  1748. SeeAlso: AX=1116h,AX=112Eh
  1749. --------N-2F1116-----------------------------
  1750. INT 2F CU - NETWORK REDIRECTOR - OPEN EXISTING REMOTE FILE
  1751.     AX = 1116h
  1752.     ES:DI -> uninitialized SFT
  1753.     SS = DOS DS
  1754.     SDA first filename pointer -> fully-qualified name of file to open
  1755.     STACK: WORD file access and sharing modes (see INT 21/AH=3Dh)
  1756. Return: CF set on error
  1757.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1758.     CF clear if successful
  1759.         SFT filled (except handle count, which DOS manages itself)
  1760.     STACK unchanged
  1761. Note:    this function is called by the DOS 3.1+ kernel
  1762. SeeAlso: AX=1106h,AX=1115h,AX=1117h,AX=1118h,AX=112Eh,INT 21/AH=3Dh
  1763. SeeAlso: INT 21/AH=60h
  1764. --------N-2F1117-----------------------------
  1765. INT 2F CU - NETWORK REDIRECTOR - CREATE/TRUNCATE REMOTE FILE
  1766.     AX = 1117h
  1767.     ES:DI -> uninitialized SFT
  1768.     SS = DOS DS
  1769.     SDA first filename pointer -> fully-qualified name of file to open
  1770.     SDA CDS pointer -> current directory structure for drive with file
  1771.     STACK: WORD file creation mode
  1772.             low byte = file attributes (see INT 21/AH=3Ch)
  1773.             high byte = 00h normal create, 01h create new file
  1774. Return: CF set on error
  1775.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1776.     CF clear if successful
  1777.         SFT filled (except handle count, which DOS manages itself)
  1778.     STACK unchanged
  1779. Note:    this function is called by the DOS 3.1+ kernel
  1780. SeeAlso: AX=1106h,AX=1116h,AX=1118h,AX=112Eh,INT 21/AH=3Ch,INT 21/AH=60h
  1781. --------N-2F1118-----------------------------
  1782. INT 2F CU - NETWORK REDIRECTOR - CREATE/TRUNCATE FILE WITHOUT CDS
  1783.     AX = 1118h
  1784.     ES:DI -> uninitialized SFT
  1785.     SS = DOS DS
  1786.     SDA first filename pointer -> fully-qualified name of file
  1787.     STACK: WORD file creation mode
  1788.             low byte = file attributes
  1789.             high byte = 00h normal create, 01h create new file
  1790. Return: ???
  1791.     STACK unchanged
  1792. Note:    this function is called by the DOS 3.1+ kernel when creating a file
  1793.       on a drive for which the SDA CDS pointer has offset FFFFh
  1794. SeeAlso: AX=1106h,AX=1116h,AX=1117h,AX=112Eh,INT 21/AH=60h
  1795. --------N-2F1119-----------------------------
  1796. INT 2F CU - NETWORK REDIRECTOR - FIND FIRST FILE WITHOUT CDS
  1797.     AX = 1119h
  1798.     SS = DS = DOS DS
  1799.     [DTA] = uninitialized 21-byte findfirst search data (see INT 21/AH=4Eh)
  1800.     SDA first filename pointer -> fully-qualified search template
  1801.     SDA search attribute = attribute mask for search
  1802. Return: CF set on error
  1803.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1804.     CF clear if successful
  1805.         [DTA] = updated findfirst search data
  1806.             (bit 7 of first byte must be set)
  1807.         [DTA+15h] = standard directory entry for file
  1808. Notes:    this function is called by the DOS 3.1+ kernel
  1809.     DOS 4.x IFSFUNC returns CF set, AX=0003h
  1810. SeeAlso: AX=111Ah,AX=111Bh
  1811. --------N-2F111A-----------------------------
  1812. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - FIND NEXT FILE WITHOUT CDS
  1813.     AX = 111Ah
  1814.     ???
  1815. Return: CF set
  1816.         AX = error code (03h for DOS 4.01 IFSFUNC)
  1817. Note:    use AX=111Ch for DOS 5+
  1818. SeeAlso: AX=1119h,AX=111Ch
  1819. --------N-2F111B-----------------------------
  1820. INT 2F CU - NETWORK REDIRECTOR - FINDFIRST
  1821.     AX = 111Bh
  1822.     SS = DS = DOS DS
  1823.     [DTA] = uninitialized 21-byte findfirst search data (see INT 21/AH=4Eh)
  1824.     SDA first filename pointer -> fully-qualified search template
  1825.     SDA CDS pointer -> current directory structure for drive with file
  1826.     SDA search attribute = attribute mask for search
  1827. Return: CF set on error
  1828.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1829.     CF clear if successful
  1830.         [DTA] = updated findfirst search data
  1831.             (bit 7 of first byte must be set)
  1832.         [DTA+15h] = standard directory entry for file
  1833. Note:    this function is called by the DOS 3.1+ kernel
  1834. SeeAlso: AX=1119h,AX=111Ch,INT 21/AH=4Eh,INT 21/AH=60h
  1835. --------N-2F111C-----------------------------
  1836. INT 2F CU - NETWORK REDIRECTOR - FINDNEXT
  1837.     AX = 111Ch
  1838.     SS = DS = DOS DS
  1839.     ES:DI -> CDS
  1840.     [DTA] = 21-byte findfirst search data (see INT 21/AH=4Eh)
  1841. Return: CF set on error
  1842.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  1843.     CF clear if successful
  1844.         [DTA] = updated findfirst search data
  1845.             (bit 7 of first byte must be set)
  1846.         [DTA+15h] = standard directory entry for file
  1847. Note:    this function is called by the DOS 3.1+ kernel
  1848. SeeAlso: AX=1119h,AX=111Bh,INT 21/AH=4Fh
  1849. --------N-2F111D-----------------------------
  1850. INT 2F CU - NETWORK REDIRECTOR - CLOSE ALL REMOTE FILES FOR PROCESS (ABORT)
  1851.     AX = 111Dh
  1852.     SS = DOS DS
  1853.     SDA PSP segment field = PSP of terminating process
  1854. Return: nothing
  1855. Notes:    used when a process is aborted; the process being terminated is
  1856.       indicated by the "sharing PSP" field in the SDA (offset 1Ah/1Ch)
  1857.     this function is called by the DOS 3.1+ kernel
  1858.     closes all FCBs opened by process
  1859. SeeAlso: INT 21/AX=5D04h
  1860. --------N-2F111E-----------------------------
  1861. INT 2F CU - NETWORK REDIRECTOR - DO REDIRECTION
  1862.     AX = 111Eh
  1863.     SS = DOS DS
  1864.     STACK: WORD function to execute
  1865.         5F00h  get redirection mode
  1866.             BL = type (03h printer, 04h disk)
  1867.             Return: BH = state (00h off, 01h on)
  1868.         5F01h  set redirection mode
  1869.             BL = type (03h printer, 04h disk)
  1870.             BH = state (00h off, 01h on)
  1871.         5F02h  get redirection list entry
  1872.             BX = redirection list index
  1873.             DS:SI -> 16-byte local device name buffer
  1874.             ES:DI -> 128-byte network name buffer
  1875.             Return: must set user's BX to device type and CX to
  1876.                 stored parameter value, using AX=1218h to get
  1877.                 stack frame address
  1878.         5F03h  redirect device
  1879.             BL = device type (see INT 21/AX=5F03h)
  1880.             CX = stored parameter value
  1881.             DS:SI -> ASCIZ source device name
  1882.             ES:DI -> destination ASCIZ network path + ASCIZ passwd
  1883.         5F04h  cancel redirection
  1884.             DS:SI -> ASCIZ device name or network path
  1885.         5F05h  get redirection list extended entry
  1886.             BX = redirection list index
  1887.             DS:SI -> buffer for ASCIZ source device name
  1888.             ES:DI -> buffer for destination ASCIZ network path
  1889.             Return: BH = status flag
  1890.                 BL = type (03h printer, 04h disk)
  1891.                 CX = stored parameter value
  1892.                 BP = NETBIOS local session number
  1893.         5F06h  similar to 5F05h???
  1894. Return: CF set on error
  1895.         AX = error code (see #0789 at INT 21/AH=59h)
  1896.     STACK unchanged
  1897. Notes:    this function is called by the DOS 3.1+ kernel on INT 21/AH=5Fh
  1898.       (including LAN Manager calls)
  1899.     the PC Network 1.00 redirector does not support function 5F06h
  1900. SeeAlso: INT 21/AX=5F00h,INT 21/AX=5F01h,INT 21/AX=5F02h,INT 21/AX=5F03h
  1901. SeeAlso: INT 21/AX=5F04h,INT 21/AX=5F05h,INT 21/AX=5F06h
  1902. --------N-2F111F-----------------------------
  1903. INT 2F CU - NETWORK REDIRECTOR - PRINTER SETUP
  1904.     AX = 111Fh
  1905.     STACK: WORD function
  1906.         5E02h  set printer setup
  1907.         5E03h  get printer setup
  1908.         5E04h  set printer mode
  1909.         5E05h  get printer mode
  1910. Return: CF set on error
  1911.         AX = error code (see #0789 at INT 21/AH=59h)
  1912.     STACK unchanged
  1913. Note:    this function is called by the DOS 3.1+ kernel
  1914. SeeAlso: INT 21/AX=5E02h,INT 21/AX=5E03h,INT 21/AX=5E04h,INT 21/AX=5E05h
  1915. --------N-2F1120-----------------------------
  1916. INT 2F CU - NETWORK REDIRECTOR - FLUSH ALL DISK BUFFERS
  1917.     AX = 1120h
  1918.     DS = DOS DS
  1919.     ???
  1920. Return: CF clear (successful)
  1921. Notes:    this function is called by the DOS 3.1+ kernel
  1922.     uses CDS array pointer and LASTDRIVE= entries in DOS list of lists
  1923. SeeAlso: INT 21/AH=0Dh,INT 21/AX=5D01h
  1924. --------N-2F1121-----------------------------
  1925. INT 2F CU - NETWORK REDIRECTOR - SEEK FROM END OF REMOTE FILE
  1926.     AX = 1121h
  1927.     CX:DX = offset (in bytes) from end
  1928.     ES:DI -> SFT
  1929.         SFT DPB field -> DPB of drive with file
  1930.     SS = DOS DS
  1931. Return: CF set on error
  1932.         AL = DOS error code (see #0789 at INT 21/AH=59h)
  1933.     CF clear if successful
  1934.         DX:AX = new file position
  1935. Note:    this function is called by the DOS 3.1+ kernel, but only when seeking
  1936.       from the end of a file opened with sharing modes set in such a
  1937.       manner that another process is able to change the size of the file
  1938.       while it is already open
  1939. SeeAlso: AX=1228h,INT 21/AH=42h
  1940. --------N-2F1122-----------------------------
  1941. INT 2F CU - NETWORK REDIRECTOR - PROCESS TERMINATION HOOK
  1942.     AX = 1122h
  1943.     SS = DOS DS
  1944.     DS = PSP of process about to terminate
  1945. Return: ???
  1946. Notes:    this function is called by the DOS 3.1+ kernel
  1947.     after calling this function, the kernel calls INT 2F/AX=111Dh
  1948. SeeAlso: AX=111Dh,INT 21/AH=4Ch,INT 60/DI=0601h
  1949. --------N-2F1123-----------------------------
  1950. INT 2F CU - NETWORK REDIRECTOR - QUALIFY REMOTE FILENAME
  1951.     AX = 1123h
  1952.     DS:SI -> ASCIZ filename to canonicalize
  1953.     ES:DI -> 128-byte buffer for qualified name
  1954. Return: CF set if not resolved
  1955. Notes:    called by MS-DOS 3.1+ kernel, but not called by DR-DOS 5.0 unless the
  1956.       filename matches the name of a character device
  1957.     called first when DOS attempts to resolve a filename (unless inside an
  1958.       AX=5D00h server call); if this fails, DOS resolves the name locally
  1959. SeeAlso: AX=1221h,INT 21/AH=60h
  1960. --------N-2F1124-----------------------------
  1961. INT 2F CU - NETWORK REDIRECTOR - TURN OFF REMOTE PRINTER
  1962.     AX = 1124h
  1963.     ES:DI -> SFT
  1964.     SS = DOS DS
  1965.     ???
  1966. Return: CX = ???
  1967. Note:    this function is called by the DOS 3.1+ kernel if AX=1126h returns CF set
  1968. SeeAlso: AX=1126h
  1969. --------N-2F1125-----------------------------
  1970. INT 2F CU - NETWORK REDIRECTOR - REDIRECTED PRINTER MODE
  1971.     AX = 1125h
  1972.     STACK: WORD subfunction
  1973.         5D07h get print stream state
  1974.             Return: DL = current state
  1975.         5D08h set print stream state
  1976.             DL = new state
  1977.         5D09h finish print job
  1978. Return: CF set on error
  1979.         AX = error code (see #0789 at INT 21/AH=59h)
  1980.     STACK unchanged
  1981. Note:    this function is called by the DOS 3.1+ kernel
  1982. SeeAlso: INT 21/AX=5D07h,INT 21/AX=5D08h,INT 21/AX=5D09h
  1983. --------N-2F1126-----------------------------
  1984. INT 2F CU - NETWORK REDIRECTOR - REMOTE PRINTER ECHO ON/OFF
  1985.     AX = 1126h
  1986.     ES:DI -> SFT for file handle 4???
  1987.     SS = DOS DS???
  1988.     ???
  1989. Return: CF set on error
  1990. Notes:    this function is called by the DOS 3.1+ kernel
  1991.     called when print echoing (^P, ^PrtSc) changes state and STDPRN has
  1992.       bit 11 of the device information word in the SFT set
  1993. SeeAlso: AX=1124h
  1994. --------N-2F1127-----------------------------
  1995. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - UNUSED
  1996.     AX = 1127h
  1997. Return: CF set
  1998.         AX = 0001h (invalid function) (see #0789 at INT 21/AH=59h)
  1999. --------N-2F1128-----------------------------
  2000. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - UNUSED
  2001.     AX = 1128h
  2002. Return: CF set
  2003.         AX = 0001h (invalid function) (see #0789 at INT 21/AH=59h)
  2004. --------N-2F1129-----------------------------
  2005. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - UNUSED
  2006.     AX = 1129h
  2007. Return: CF set
  2008.         AX = 0001h (invalid function) (see #0789 at INT 21/AH=59h)
  2009. --------N-2F112A-----------------------------
  2010. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - CLOSE ALL FILES FOR PROCESS
  2011.     AX = 112Ah
  2012.     DS = DOS DS
  2013.     ???
  2014. Return: ???
  2015. Note:    does something to each IFS driver
  2016. --------N-2F112B-----------------------------
  2017. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - GENERIC IOCTL
  2018.     AX = 112Bh
  2019.     SS = DOS DS
  2020.     CX = function/category
  2021.     DS:DX -> parameter block
  2022.     STACK: WORD value of AX on entry to INT 21 (440Ch or 440Dh)
  2023.     ???
  2024. Return: CF set on error
  2025.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  2026.     CF clear if successful
  2027. Note:    this function is called by the DOS 4.0 kernel
  2028. --------N-2F112C-----------------------------
  2029. INT 2F CU - NETWORK REDIRECTOR (DOS 4+) - "UPDATE_CB" - ???
  2030.     AX = 112Ch
  2031.     SS = DOS DS
  2032.     SDA current SFT pointer -> SFT for file
  2033.     ???
  2034. Return: CF set on error
  2035. Note:    called by SHARE in DOS 5.0-6.0
  2036. --------N-2F112D-----------------------------
  2037. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - EXTENDED ATTRIBUTES
  2038.     AX = 112Dh
  2039.     BL = subfunction (value of AL on INT 21)
  2040.         02h get extended attributes
  2041.         03h get extended attribute properties
  2042.         04h set extended attributes
  2043.         Return: CF clear
  2044.         else ???
  2045.         Return: CX = ??? (00h or 02h for DOS 4.01)
  2046.     ES:DI -> SFT for file
  2047.     SS = DOS DS
  2048. Return: DS = DOS DS
  2049. Note:    this function is called by the DOS 4.0 kernel on INT 21/AX=5702h,
  2050.       INT 21/AX=5703h, and INT 21/AX=5704h
  2051. SeeAlso: INT 21/AX=5702h,INT 21/AX=5703h,INT 21/AX=5704h,INT 21/AH=6Eh
  2052. --------N-2F112E-----------------------------
  2053. INT 2F CU - NETWORK REDIRECTOR (DOS 4+) - EXTENDED OPEN/CREATE FILE
  2054.     AX = 112Eh
  2055.     SS = DS = DOS DS
  2056.     ES:DI -> uninitialized SFT for file
  2057.     STACK: WORD file attribute for created/truncated file
  2058.             low byte = file attributes
  2059.             high byte = 00h normal create/open, 01h create new file
  2060.     SDA first filename pointer -> fully-qualified filename
  2061.     SDA extended file open action = action code (see INT 21/AX=6C00h)
  2062.     SDA extended file open mode = open mode for file (see INT 21/AX=6C00h)
  2063. Return: CF set on error
  2064.         AX = error code
  2065.     CF clear if successful
  2066.         CX = result code
  2067.         01h file opened
  2068.         02h file created
  2069.         03h file replaced (truncated)
  2070.         SFT initialized (except handle count, which DOS manages itself)
  2071. Note:    this function is called by the DOS 4+ kernel
  2072. BUG:    this function is not called correctly under some DOS versions
  2073.       (at least 5.0 and 6.2):
  2074.         the file attribute on the stack is not correct if the action 
  2075.           code is 11h,
  2076.         the result code in CX is not passed back to the application.
  2077. SeeAlso: AX=1115h,AX=1116h,AX=1117h,INT 21/AX=6C00h
  2078. --------N-2F112F-----------------------------
  2079. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - IFS IOCTL
  2080.     AX = 112Fh
  2081.     SS = DOS DS
  2082.     STACK: WORD function in low byte
  2083.         00h ???
  2084.             DS:SI -> Current Directory Structure???
  2085.             CL = drive (1=A:)
  2086.         01h ???
  2087.             DS:SI -> ???
  2088.             CL = file handle???
  2089.         02h ???
  2090.             DS:SI -> Current Directory Structure???
  2091.             DI = ???
  2092.             CX = drive (1=A:)
  2093.     ???
  2094. Return: CF set on error
  2095.         AX = DOS error code (see #0789 at INT 21/AH=59h)
  2096.     CF clear if successful
  2097. Note:    this function is called by the DOS 4.0 kernel
  2098. SeeAlso: INT 21/AH=6Bh
  2099. --------N-2F1130-----------------------------
  2100. INT 2F CU - IFSFUNC.EXE (DOS 4.x only) - GET IFSFUNC SEGMENT
  2101.     AX = 1130h
  2102. Return: ES = CS of resident IFSFUNC
  2103. --------N-2F1180-----------------------------
  2104. INT 2F - LAN Manager Enhanced DOS Services - ???
  2105.     AX = 1180h
  2106.     ???
  2107. Return: ???
  2108. --------N-2F1182-----------------------------
  2109. INT 2F - LAN Manager Enhanced DOS Services - INSTALL SERVICE
  2110.     AX = 1182h
  2111.     ???
  2112. Return: ???
  2113. --------N-2F1184-----------------------------
  2114. INT 2F - LAN Manager Enhanced DOS - ???
  2115.     AX = 1184h
  2116.     ???
  2117. Return: ???
  2118. --------N-2F1186-----------------------------
  2119. INT 2F - LAN Manager Enhanced DOS - DosReadAsynchNmPipe
  2120.     AX = 1186h
  2121.     DS:SI -> stack frame (see #1275)
  2122. Return: CF clear if successful
  2123.     CF set if error
  2124.         AX = error code
  2125. Note:    LAN Manager enhance mode adds features beyond the standard redirector
  2126.       file/printer services
  2127. SeeAlso: AX=118Fh,AX=1190h,AX=1191h,INT 21/AX=5F39h
  2128.  
  2129. Format of LAN Manager DosReadAsynchNmPipe stack frame:
  2130. Offset    Size    Description    (Table 1275)
  2131.  00h    DWORD    -> number of bytes read
  2132.  04h    WORD    size of buffer
  2133.  06h    DWORD    -> buffer
  2134.  0Ah    DWORD    -> return code
  2135.  0Eh    DWORD    function to call on completion as function( char far *buffer )
  2136.  12h    WORD    handle
  2137. --------N-2F118A-----------------------------
  2138. INT 2F - LAN Manager 2.0+ DOS Enhanced ENCRYPT.EXE - STREAM ENCRYPTION SERVICE
  2139.     AX = 118Ah
  2140.     BX = function (0000h or 0001h)
  2141. Return: CF clear if successful
  2142.         AX = 1100h success
  2143.     CF set if error
  2144.         AX = 0001h, etc.
  2145. SeeAlso: AX=1186h,AH=41h,AH=42h,AH=4Bh
  2146. --------N-2F118B-----------------------------
  2147. INT 2F - LAN Manager Enhanced DOS - ???
  2148.     AX = 118Bh
  2149.     ???
  2150. Return: ???
  2151. --------N-2F118C-----------------------------
  2152. INT 2F - LAN Manager Enhanced DOS - ???
  2153.     AX = 118Ch
  2154.     ???
  2155. Return: ???
  2156. --------N-2F118E-----------------------------
  2157. INT 2F - LAN Manager Enhanced DOS - ???
  2158.     AX = 118Eh
  2159.     ???
  2160. Return: ???
  2161. --------N-2F118F-----------------------------
  2162. INT 2F - LAN Manager Enhanced DOS - DosWriteAsynchNmPipe
  2163.     AX = 118Fh
  2164.     DS:SI -> stack frame (see #1276)
  2165. Return: CF clear if successful
  2166.     CF set if error
  2167.         AX = error code
  2168. SeeAlso: AX=1186h,AX=1191h,INT 21/AX=5F3Ah
  2169.  
  2170. Format of LAN Manager DosReadAsynchNmPipe stack frame:
  2171. Offset    Size    Description    (Table 1276)
  2172.  00h    DWORD    -> number of bytes read
  2173.  04h    WORD    Size of buffer
  2174.  06h    DWORD    -> buffer
  2175.  0Ah    DWORD    -> return code
  2176.  0Eh    DWORD    function to call on completion as function( char far *buffer )
  2177.  12h    WORD    handle
  2178. --------N-2F1190-----------------------------
  2179. INT 2F - LAN Manager Enhanced DOS - DosReadAsynchNmPipe2
  2180.     AX = 1190h
  2181.     DS:SI -> stack frame (see #1277)
  2182. Return: CF clear if successful
  2183.     CF set if error
  2184.         AX = error code
  2185. SeeAlso: AX=1186h,AX=1191h
  2186.  
  2187. Format of LAN Manager DosReadAsynchNmPipe2 stack frame:
  2188. Offset    Size    Description    (Table 1277)
  2189.  00h    DWORD    -> number of bytes read
  2190.  04h    WORD    size of buffer
  2191.  06h    DWORD    -> buffer
  2192.  0Ah    DWORD    -> return code
  2193.  0Eh    DWORD    function to call on completion as function( char far *buffer )
  2194.  12h    WORD    handle
  2195.  14h    DWORD    ???
  2196. --------N-2F1191-----------------------------
  2197. INT 2F - LAN Manager Enhanced DOS - DosWriteAsynchNmPipe2
  2198.     AX = 1191h
  2199.     DS:SI -> stack frame (see #1278)
  2200. Return: CF clear if successful
  2201.     CF set if error
  2202.         AX = error code
  2203. SeeAlso: AX=118Fh,AX=1190h,INT 21/AX=5F3Ah
  2204.  
  2205. Format of LAN Manager DosReadAsynchNmPipe2 stack frame:
  2206. Offset    Size    Description    (Table 1278)
  2207.  00h    DWORD    -> number of bytes read
  2208.  04h    WORD    size of buffer
  2209.  06h    DWORD    -> buffer
  2210.  0Ah    DWORD    -> return code
  2211.  0Eh    DWORD    function to call on completion as function( char far *buffer )
  2212.  12h    WORD    handle
  2213.  14h    DWORD    ???
  2214. --------D-2F1200-----------------------------
  2215. INT 2F U - DOS 3+ internal - INSTALLATION CHECK
  2216.     AX = 1200h
  2217. Return: AL = FFh (for compatibility with other INT 2F functions)
  2218. --------D-2F1201-----------------------------
  2219. INT 2F U - DOS 3+ internal - CLOSE CURRENT FILE
  2220.     AX = 1201h
  2221.     SS = DOS DS (must be using a DOS internal stack)
  2222.     SDA current SFT pointer -> SFT of file to close
  2223. Return: CF set on error
  2224.     BX???
  2225.     CX new reference count of SFT
  2226.     ES:DI -> SFT for file
  2227. SeeAlso: AX=1106h,AX=1227h,INT 21/AH=3Eh
  2228. --------D-2F1202-----------------------------
  2229. INT 2F U - DOS 3+ internal - GET INTERRUPT ADDRESS
  2230.     AX = 1202h
  2231.     STACK: WORD vector number
  2232. Return: ES:BX -> interrupt vector
  2233.     STACK unchanged
  2234. --------D-2F1203-----------------------------
  2235. INT 2F U - DOS 3+ internal - GET DOS DATA SEGMENT
  2236.     AX = 1203h
  2237. Return: DS = data segment of IBMDOS.COM/MSDOS.SYS
  2238. Note:    for DOS prior to version 5.0, the data segment is the same as the code
  2239.       segment
  2240. --------D-2F1204-----------------------------
  2241. INT 2F U - DOS 3+ internal - NORMALIZE PATH SEPARATOR
  2242.     AX = 1204h
  2243.     STACK: WORD character to normalize
  2244. Return: AL = normalized character (forward slash turned to backslash, all
  2245.           others unchanged)
  2246.     ZF set if path separator
  2247.     STACK unchanged
  2248. --------D-2F1205-----------------------------
  2249. INT 2F U - DOS 3+ internal - OUTPUT CHARACTER TO STANDARD OUTPUT
  2250.     AX = 1205h
  2251.     STACK: WORD character to output
  2252. Return: STACK unchanged
  2253. Note:    can be called only from within DOS
  2254. --------D-2F1206-----------------------------
  2255. INT 2F U - DOS 3+ internal - INVOKE CRITICAL ERROR
  2256.     AX = 1206h
  2257.     DI = error code
  2258.     BP:SI -> device driver header
  2259.     SS = DOS DS (must be using a DOS internal stack)
  2260.     STACK: WORD value to be passed to INT 24 in AX
  2261. Return: AL = 0-3 for Abort, Retry, Ignore, Fail
  2262.     STACK unchanged
  2263. SeeAlso: INT 24
  2264. --------D-2F1207-----------------------------
  2265. INT 2F U - DOS 3+ internal - MAKE DISK BUFFER MOST-RECENTLY USED
  2266.     AX = 1207h
  2267.     DS:DI -> disk buffer
  2268. Return: nothing
  2269. Desc:    move the indicated buffer to the end of the disk buffer chain (least-
  2270.       recently used is first); under DOS 3.3, the buffer is then moved to
  2271.       the start of the disk buffer chain if it was marked unused
  2272. Notes:    can be called only from within DOS
  2273.     this function is nearly the same as AX=120Fh
  2274. SeeAlso: AX=120Fh
  2275. --------D-2F1208-----------------------------
  2276. INT 2F U - DOS 3+ internal - DECREMENT SFT REFERENCE COUNT
  2277.     AX = 1208h
  2278.     ES:DI -> SFT
  2279. Return: AX = original value of reference count
  2280. Notes:    if the reference count was 1, it is set to FFFFh (since 0 indicates
  2281.       that the SFT is not in use).    It is the caller's responsibility to
  2282.       set the reference count to zero after cleaning up.
  2283.     used by network redirectors such as MSCDEX
  2284. SeeAlso: AX=1106h
  2285. --------D-2F1209-----------------------------
  2286. INT 2F U - DOS 3+ internal - FLUSH AND FREE DISK BUFFER
  2287.     AX = 1209h
  2288.     DS:DI -> disk buffer
  2289. Return: disk buffer marked unused, contents written to disk if buffer dirty
  2290. Note:    can be called only from within DOS
  2291. SeeAlso: AX=120Eh,AX=1215h
  2292. --------D-2F120A-----------------------------
  2293. INT 2F U - DOS 3+ internal - PERFORM CRITICAL ERROR INTERRUPT
  2294.     AX = 120Ah
  2295.     DS = SS = DOS DS (must be using a DOS internal stack)
  2296.     STACK: WORD extended error code
  2297. Return: AL = user response (0=ignore, 1=retry, 2=abort, 3=fail)
  2298.     CF clear if retry, set otherwise
  2299.     STACK unchanged
  2300. Notes:    can only be called during a DOS function call, as it uses various
  2301.       fields in the SDA to set up the registers for the INT 24
  2302.     reportedly sets current DPB's first root directory sector to 1
  2303. SeeAlso: INT 24
  2304. --------D-2F120B-----------------------------
  2305. INT 2F U - DOS 3+ internal - SIGNAL SHARING VIOLATION TO USER
  2306.     AX = 120Bh
  2307.     ES:DI -> system file table entry for previous open of file
  2308.     STACK: WORD extended error code (should be 20h--sharing violation)
  2309. Return: CF clear if operation should be retried
  2310.     CF set if operation should not be retried
  2311.         AX = error code (20h) (see #0789 at INT 21/AH=59h)
  2312.     STACK unchanged
  2313. Notes:    can only be called during a DOS function call
  2314.     should only be called if an attempt was made to open an already-open
  2315.       file contrary to the sharing rules
  2316.     invokes INT 24 if SFT file opened via FCB or in compatibility mode with
  2317.       inheritance allowed
  2318. --------D-2F120C-----------------------------
  2319. INT 2F U - DOS 3+ internal - OPEN DEVICE AND SET SFT OWNER/MODE
  2320.     AX = 120Ch
  2321.     SDA current SFT pointer -> SFT for file
  2322.     DS = DOS DS
  2323.     SS = DOS DS (must be using a DOS internal stack)
  2324. Return: ES, DI, AX destroyed
  2325. Notes:    invokes "device open" call on device driver for SFT
  2326.     changes owner of last-accessed SFT to calling process if it was opened
  2327.       via FCB
  2328.     called by network redirectors such as MSCDEX
  2329. --------D-2F120D-----------------------------
  2330. INT 2F U - DOS 3+ internal - GET DATE AND TIME
  2331.     AX = 120Dh
  2332.     SS = DOS DS (must be using a DOS internal stack)
  2333. Return: AX = current date in packed format (see #0781 at INT 21/AX=5700h)
  2334.     DX = current time in packed format (see #0780 at INT 21/AX=5700h)
  2335. SeeAlso: INT 21/AH=2Ah,INT 21/AH=2Ch
  2336. --------D-2F120E-----------------------------
  2337. INT 2F U - DOS 3+ internal - MARK ALL DISK BUFFERS UNREFERENCED
  2338.     AX = 120Eh
  2339.     SS = DOS DS (must be using a DOS internal stack)
  2340. Return: DS:DI -> first disk buffer
  2341. Notes:    clears "referenced" flag on all disk buffers
  2342.     in DOS 5+, this has become essentially a NOP, invoking the same code
  2343.       used by AX=1224h (SHARING DELAY)
  2344. SeeAlso: AX=1209h,AX=1210h,INT 21/AH=0Dh
  2345. --------D-2F120F-----------------------------
  2346. INT 2F U - DOS 3+ internal - MAKE BUFFER MOST RECENTLY USED
  2347.     AX = 120Fh
  2348.     DS:DI -> disk buffer
  2349.     SS = DOS DS (must be using a DOS internal stack)
  2350. Return: DS:DI -> next buffer in buffer list
  2351. Desc:    move the indicated buffer to the end of the disk buffer chain (least-
  2352.       recently used is first); under DOS 3.3, the buffer is then moved to
  2353.       the start of the disk buffer chain if it was marked unused
  2354. Note:    this function is the same as AX=1207h except that it returns a
  2355.       pointer to the buffer following the specified buffer in the buffer
  2356.       chain
  2357. SeeAlso: AX=1207h
  2358. --------D-2F1210-----------------------------
  2359. INT 2F U - DOS 3+ internal - FIND UNREFERENCED DISK BUFFER
  2360.     AX = 1210h
  2361.     DS:DI -> first disk buffer to check
  2362. Return: ZF clear if found
  2363.         DS:DI -> first unreferenced disk buffer
  2364.     ZF set if not found
  2365. Note:    in DOS 5+, this has become essentially a NOP, invoking the same code
  2366.       used by AX=1224h (SHARING DELAY)
  2367. SeeAlso: AX=120Eh
  2368. --------D-2F1211-----------------------------
  2369. INT 2F U - DOS 3+ internal - NORMALIZE ASCIZ FILENAME
  2370.     AX = 1211h
  2371.     DS:SI -> ASCIZ filename to normalize
  2372.     ES:DI -> buffer for normalized filename
  2373. Return: destination buffer filled with uppercase filename, with slashes turned
  2374.     to backslashes
  2375. SeeAlso: AX=121Eh,AX=1221h
  2376. --------D-2F1212-----------------------------
  2377. INT 2F U - DOS 3+ internal - GET LENGTH OF ASCIZ STRING
  2378.     AX = 1212h
  2379.     ES:DI -> ASCIZ string
  2380. Return: CX = length of string
  2381. SeeAlso: AX=1225h
  2382. --------D-2F1213-----------------------------
  2383. INT 2F U - DOS 3+ internal - UPPERCASE CHARACTER
  2384.     AX = 1213h
  2385.     STACK: WORD character to convert to uppercase
  2386. Return: AL = uppercase character
  2387.     STACK unchanged
  2388. --------D-2F1214-----------------------------
  2389. INT 2F U - DOS 3+ internal - COMPARE FAR POINTERS
  2390.     AX = 1214h
  2391.     DS:SI = first pointer
  2392.     ES:DI = second pointer
  2393. Return: ZF set if pointers are equal, ZF clear if not equal
  2394. --------D-2F1215-----------------------------
  2395. INT 2F U - DOS 3+ internal - FLUSH BUFFER
  2396.     AX = 1215h
  2397.     DS:DI -> disk buffer
  2398.     SS = DOS DS (must be using a DOS internal stack)
  2399.     STACK: WORD drives for which to skip buffer
  2400.         ignore buffer if drive same as high byte, or bytes differ and
  2401.           the buffer is for a drive OTHER than that given in low byte
  2402. Return: STACK unchanged
  2403. Note:    can be called only from within DOS
  2404. SeeAlso: AX=1209h
  2405. --------D-2F1216-----------------------------
  2406. INT 2F U - DOS 3+ internal - GET ADDRESS OF SYSTEM FILE TABLE ENTRY
  2407.     AX = 1216h
  2408.     BX = system file table entry number
  2409. Return: CF clear if successful
  2410.         ES:DI -> system file table entry
  2411.     CF set if BX greater than FILES=
  2412. Note:    supported by DR-DOS 5+
  2413. SeeAlso: AX=1220h
  2414. --------D-2F1217-----------------------------
  2415. INT 2F U - DOS 3+ internal - GET CURRENT DIRECTORY STRUCTURE FOR DRIVE
  2416.     AX = 1217h
  2417.     SS = DOS DS (must be using a DOS internal stack)
  2418.     STACK: WORD drive (0 = A:, 1 = B:, etc)
  2419. Return: CF set on error
  2420.         (drive > LASTDRIVE)
  2421.     CF clear if successful
  2422.         DS:SI -> current directory structure for specified drive
  2423.     STACK unchanged
  2424. SeeAlso: AX=1219h
  2425. --------D-2F1218-----------------------------
  2426. INT 2F U - DOS 3+ internal - GET CALLER'S REGISTERS
  2427.     AX = 1218h
  2428. Return: DS:SI -> saved caller's AX,BX,CX,DX,SI,DI,BP,DS,ES (on stack)
  2429. Note:    only valid while within DOS
  2430. --------D-2F1219-----------------------------
  2431. INT 2F U - DOS 3+ internal - SET DRIVE???
  2432.     AX = 1219h
  2433.     SS = DOS DS (must be using a DOS internal stack)
  2434.     STACK: WORD drive (0 = default, 1 = A:, etc)
  2435. Return: ???
  2436.     STACK unchanged
  2437. Notes:    calls AX=1217h
  2438.     builds a current directory structure if inside server call
  2439.       (INT 21/AX=5D00h)
  2440. SeeAlso: AX=1217h,AX=121Fh
  2441. --------D-2F121A-----------------------------
  2442. INT 2F U - DOS 3+ internal - GET FILE'S DRIVE
  2443.     AX = 121Ah
  2444.     DS:SI -> filename
  2445. Return: AL = drive (0 = default, 1 = A:, etc, FFh = invalid)
  2446.     DS:SI -> filename without leading X: (if present)
  2447. SeeAlso: INT 21/AH=19h,INT 21/AH=60h
  2448. --------D-2F121B-----------------------------
  2449. INT 2F U - DOS 3+ internal - SET YEAR/LENGTH OF FEBRUARY
  2450.     AX = 121Bh
  2451.     CL = year - 1980
  2452. Return: AL = number of days in February
  2453. Note:    requires DS to be set to the DOS data segment
  2454. SeeAlso: INT 21/AH=2Bh
  2455. --------D-2F121C-----------------------------
  2456. INT 2F U - DOS 3+ internal - CHECKSUM MEMORY
  2457.     AX = 121Ch
  2458.     DS:SI -> start of memory to checksum
  2459.     CX = number of bytes
  2460.     DX = initial checksum
  2461.     SS = DOS DS (must be using a DOS internal stack)
  2462. Return: AX, CX destroyed
  2463.     DX = checksum
  2464.     DS:SI -> first byte after checksummed range
  2465. Notes:    used by DOS to determine day count since 1/1/80 given a date
  2466.     supported by DR-DOS 5.0+
  2467. SeeAlso: AX=121Dh
  2468. --------D-2F121D-----------------------------
  2469. INT 2F U - DOS 3+ internal - SUM MEMORY
  2470.     AX = 121Dh
  2471.     DS:SI -> memory to add up
  2472.     CX = 0000h
  2473.     DX = limit
  2474. Return: AL = byte which exceeded limit
  2475.     CX = number of bytes before limit exceeded
  2476.     DX = remainder after adding first CX bytes
  2477.     DS:SI -> byte beyond the one which exceeded the limit
  2478. Notes:    used by DOS to determine year or month given day count since 1/1/80
  2479.     supported by DR-DOS 5.0+
  2480. SeeAlso: AX=121Ch
  2481. --------D-2F121E-----------------------------
  2482. INT 2F U - DOS 3+ internal - COMPARE FILENAMES
  2483.     AX = 121Eh
  2484.     DS:SI -> first ASCIZ filename
  2485.     ES:DI -> second ASCIZ filename
  2486. Return: ZF set if filenames equivalent, ZF clear if not
  2487. Note:    supported by DR-DOS 5.0+
  2488. SeeAlso: AX=1211h,AX=1221h
  2489. --------D-2F121F-----------------------------
  2490. INT 2F U - DOS 3+ internal - BUILD CURRENT DIRECTORY STRUCTURE
  2491.     AX = 121Fh
  2492.     SS = DOS DS (must be using a DOS internal stack)
  2493.     STACK: WORD drive letter
  2494. Return: ES:DI -> current directory structure (will be overwritten by next call)
  2495.     STACK unchanged
  2496. --------D-2F1220-----------------------------
  2497. INT 2F U - DOS 3+ internal - GET JOB FILE TABLE ENTRY
  2498.     AX = 1220h
  2499.     BX = file handle
  2500. Return: CF set on error
  2501.         AL = 6 (invalid file handle)
  2502.     CF clear if successful
  2503.         ES:DI -> JFT entry for file handle in current process
  2504. Notes:    the byte pointed at by ES:DI contains the number of the SFT for the
  2505.       file handle, or FFh if the handle is not open
  2506.     supported by DR-DOS 5.0+
  2507. SeeAlso: AX=1216h,AX=1229h
  2508. --------D-2F1221-----------------------------
  2509. INT 2F U - DOS 3+ internal - CANONICALIZE FILE NAME
  2510.     AX = 1221h
  2511.     DS:SI -> file name to be fully qualified
  2512.     ES:DI -> 128-byte buffer for resulting canonical file name
  2513.     SS = DOS DS (must be using a DOS internal stack)
  2514. Return: (see INT 21/AH=60h)
  2515. Note:    identical to INT 21/AH=60h
  2516. SeeAlso: AX=1123h,INT 21/AH=60h
  2517. --------D-2F1222-----------------------------
  2518. INT 2F U - DOS 3+ internal - SET EXTENDED ERROR INFO
  2519.     AX = 1222h
  2520.     SS = DOS data segment
  2521.     SS:SI -> 4-byte records
  2522.         BYTE    error code, FFh = last record
  2523.         BYTE    error class, FFh = don't change
  2524.         BYTE    suggested action, FFh = don't change
  2525.         BYTE    error locus, FFh = don't change
  2526.     SDA error code set
  2527. Return: SI destroyed
  2528.     SDA error class, error locus, and suggested action fields set
  2529. Note:    can be called only from within DOS
  2530. SeeAlso: AX=122Dh,INT 21/AH=59h,INT 21/AX=5D0Ah
  2531. --------D-2F1223-----------------------------
  2532. INT 2F U - DOS 3+ internal - CHECK IF CHARACTER DEVICE
  2533.     AX = 1223h
  2534.     DS = DOS DS
  2535.     SS = DOS DS (must be using a DOS internal stack)
  2536.     SDA+218h (DOS 3.10-3.30) = eight-character blank-padded name
  2537.     SDA+22Bh (DOS 4.0-6.0) = eight-character blank-padded name
  2538. Return: CF set if no character device by that name found
  2539.     CF clear if found
  2540.         BH = low byte of device attribute word
  2541. Note:    can only be called from within DOS
  2542. SeeAlso: INT 21/AX=5D06h,INT 21/AX=5D0Bh
  2543. --------D-2F1224-----------------------------
  2544. INT 2F U - DOS 3+ internal - SHARING RETRY DELAY
  2545.     AX = 1224h
  2546.     SS = DOS DS (must be using a DOS internal stack)
  2547. Return: after delay set by INT 21/AX=440Bh, unless in server call
  2548.       (INT 21/AX=5D00h)
  2549. Note:    delay is dependent on the processor speed, and is skipped entirely if
  2550.       inside a server call
  2551. SeeAlso: INT 21/AX=440Bh,INT 21/AH=52h,INT 62/AX=0097h
  2552. --------D-2F1225-----------------------------
  2553. INT 2F U - DOS 3+ internal - GET LENGTH OF ASCIZ STRING
  2554.     AX = 1225h
  2555.     DS:SI -> ASCIZ string
  2556. Return: CX = length of string
  2557. Note:    supported by DR-DOS 5.0+
  2558. SeeAlso: AX=1212h
  2559. --------D-2F1226-----------------------------
  2560. INT 2F U - DOS 3.3+ internal - OPEN FILE
  2561.     AX = 1226h
  2562.     CL = access mode
  2563.     DS:DX -> ASCIZ filename
  2564.     SS = DOS DS (must be using a DOS internal stack)
  2565. Return: CF set on error
  2566.         AL = error code (see #0789 at INT 21/AH=59h)
  2567.     CF clear if successful
  2568.         AX = file handle
  2569. Notes:    can only be called from within DOS
  2570.     equivalent to INT 21/AH=3Dh
  2571.     used by NLSFUNC to access COUNTRY.SYS when invoked by the DOS kernel
  2572. SeeAlso: AX=1227h,INT 21/AH=3Dh
  2573. --------D-2F1227-----------------------------
  2574. INT 2F U - DOS 3.3+ internal - CLOSE FILE
  2575.     AX = 1227h
  2576.     BX = file handle
  2577.     SS = DOS DS (must be using a DOS internal stack)
  2578. Return: CF set on error
  2579.         AL = 06h invalid file handle
  2580.     CF clear if successful
  2581. Notes:    can only be called from within DOS
  2582.     equivalent to INT 21/AH=3Eh
  2583.     used by NLSFUNC to access COUNTRY.SYS when invoked by the DOS kernel
  2584. SeeAlso: AX=1106h,AX=1201h,AX=1226h,INT 21/AH=3Eh
  2585. --------D-2F1228BP4200-----------------------
  2586. INT 2F U - DOS 3.3+ internal - MOVE FILE POINTER
  2587.     AX = 1228h
  2588.     BP = 4200h, 4201h, 4202h (see INT 21/AH=42h)
  2589.     BX = file handle
  2590.     CX:DX = offset in bytes
  2591.     SS = DOS DS (must be using a DOS internal stack)
  2592. Return: as for INT 21/AH=42h
  2593. Notes:    equivalent to INT 21/AH=42h, but may only be called from inside a DOS
  2594.       function call
  2595.     sets user stack frame pointer to dummy buffer, moves BP to AX, performs
  2596.       LSEEK, and restores frame pointer
  2597.     used by NLSFUNC to access COUNTRY.SYS when invoked by the DOS kernel
  2598. SeeAlso: INT 21/AH=42h
  2599. --------D-2F1229-----------------------------
  2600. INT 2F U - DOS 3.3+ internal - READ FROM FILE
  2601.     AX = 1229h
  2602.     BX = file handle
  2603.     CX = number of bytes to read
  2604.     DS:DX -> buffer
  2605.     SS = DOS DS (must be using a DOS internal stack)
  2606. Return: as for INT 21/AH=3Fh
  2607. Notes:    equivalent to INT 21/AH=3Fh, but may only be called when already inside
  2608.       a DOS function call
  2609.     used by NLSFUNC to access COUNTRY.SYS when invoked by the DOS kernel
  2610. SeeAlso: AX=1226h,INT 21/AH=3Fh
  2611. --------D-2F122A-----------------------------
  2612. INT 2F U - DOS 3.3+ internal - SET FASTOPEN ENTRY POINT
  2613.     AX = 122Ah
  2614.     BX = entry point to set (0001h or 0002h)
  2615.     DS:SI -> FASTOPEN entry point
  2616.         (entry point not set if SI = FFFFh for DOS 4+)
  2617. Return: CF set if specified entry point already set
  2618. Notes:    entry point in BX is ignored under DOS 3.30
  2619.     both entry points set to same handler by DOS 4.01
  2620.     DOS 5.0 and 6.0 only set entry point 1
  2621.  
  2622. (Table 1279)
  2623. Values DOS 3.30+ FASTOPEN is called with:
  2624.     AL = 01h  Lookup
  2625.         CX = ??? seems to be offset
  2626.         DI = ??? seems to be offset
  2627.         SI = offset in DOS DS of filename
  2628.     AL = 02h  insert file into FASTOPEN cache
  2629.     AL = 03h  delete file from FASTOPEN cache
  2630.         SI = offset in DOS DS of filename
  2631.     AL = 04h  purge FASTOPEN cache
  2632.         AH = subfunction (00h,01h,02h)
  2633.         ES:DI -> ???
  2634.         CX = ??? (subfunctions 01h and 02h only)
  2635. Returns: CF set on error or not installed
  2636. Note: function 03h calls function 01h first
  2637.  
  2638. (Table 1280)
  2639. Values PC-DOS 4.01 FASTOPEN is additionally called with:
  2640.     AL = 04h ???
  2641.         AH = 03h
  2642.         ???
  2643.     AL = 05h ???
  2644.     AL = 0Bh ???
  2645.     AL = 0Ch ???
  2646.     AL = 0Dh ???
  2647.     AL = 0Eh ???
  2648.     AL = 0Fh ???
  2649.     AL = 10h ???
  2650.  
  2651. (Table 1281)
  2652. Values MS-DOS 5.0-6.0 FASTOPEN is additionally called with:
  2653.     AL = 04h  purge FASTOPEN cache
  2654.         AH = 03h
  2655.         ???
  2656.     AL = 05h ???
  2657.         DL = drive (00h = A:)
  2658.         ???
  2659.     AL = 06h ???
  2660.         ???
  2661. --------D-2F122B-----------------------------
  2662. INT 2F U - DOS 3.3+ internal - IOCTL
  2663.     AX = 122Bh
  2664.     BP = 44xxh
  2665.     SS = DOS DS (must be using a DOS internal stack)
  2666.     additional registers as appropriate for INT 21/AX=44xxh
  2667. Return: as for INT 21/AH=44h
  2668. Notes:    equivalent to INT 21/AH=44h, but may only be called when already inside
  2669.       a DOS function call
  2670.     sets user stack frame pointer to dummy buffer, moves BP to AX, performs
  2671.       IOCTL, and restores frame pointer
  2672.     used by NLSFUNC in accessing COUNTRY.SYS when invoked by the DOS kernel
  2673. SeeAlso: INT 21/AH=44h
  2674. --------D-2F122C-----------------------------
  2675. INT 2F U - DOS 3.3+ internal - GET DEVICE CHAIN
  2676.     AX = 122Ch
  2677. Return: BX:AX -> header of second device driver (NUL is first) in driver chain
  2678. Note:    although this function exists in DR-DOS 5.0, it returns 0000h:0000h
  2679. SeeAlso: INT 21/AH=52h
  2680. --------D-2F122D-----------------------------
  2681. INT 2F U - DOS 3.3+ internal - GET EXTENDED ERROR CODE
  2682.     AX = 122Dh
  2683. Return: AX = current extended error code
  2684. SeeAlso: AX=1222h,INT 21/AH=59h
  2685. --------D-2F122E-----------------------------
  2686. INT 2F U - DOS 4+ internal - GET OR SET ERROR TABLE ADDRESSES
  2687.     AX = 122Eh
  2688.     DL = subfunction
  2689.         00h get standard DOS error table (see #1282)
  2690.         Return: ES:DI -> error table
  2691.                  (DOS 4: errors 00h-12h,50h-5Bh)
  2692.                  (DOS 5: errors 00h-26h,4Fh,51h-59h)
  2693.         01h set standard DOS error table
  2694.         ES:DI -> error table
  2695.         02h get parameter error table (errors 00h-0Ah)
  2696.         Return: ES:DI -> error table
  2697.         03h set parameter error table
  2698.         ES:DI -> error table
  2699.         04h get critical/SHARE error table (errors 13h-2Bh)
  2700.         Return: ES:DI -> error table
  2701.         05h set critical/SHARE error table
  2702.         ES:DI -> error table
  2703.         06h get ??? error table
  2704.         Return: ES:DI -> error table or 0000h:0000h
  2705.         07h set ??? error table
  2706.         ES:DI -> error table
  2707.         08h get error message retriever (see #1283)
  2708.         Return: ES:DI -> FAR procedure to fetch error message
  2709.         09h set ??? error table
  2710.         ES:DI -> error table
  2711. Notes:    if the returned segment on a "get" is 0001h, then the offset specifies
  2712.       the offset of the error message table within COMMAND.COM, and the
  2713.       procedure returned by DL=08h should be called
  2714.     DOS 5+ COMMAND.COM does not allow setting any of the addresses (calls
  2715.       with DL odd are ignored); they are always returned with segment 0001h
  2716.     for DOS 5.0, the standard and critical/SHARE error tables are combined
  2717.       into a single error table
  2718. SeeAlso: AX=0500h,INT 21/AH=59h
  2719.  
  2720. Format of DOS 4.x error table:
  2721. Offset    Size    Description    (Table 1282)
  2722.  00h    BYTE    FFh
  2723.  01h  2 BYTEs    04h,00h (DOS version???)
  2724.  03h    BYTE    number of error headers following
  2725.  04h 2N WORDs    table of all error headers for table
  2726.         Offset    Size    Description
  2727.          00h    WORD    error message number
  2728.          02h    WORD    offset of error message from start of header
  2729.                 error messages are count byte followed by msg
  2730. Note:    DOS 5 error tables consist of one word per error number; each word
  2731.       contains either the offset of a counted string or 0000h
  2732.  
  2733. (Table 1283)
  2734. Call error retrieval function with:
  2735.     AX = error number
  2736.     DI = offset of error table
  2737. Return: ES:DI -> error message (counted string)
  2738. Notes:    this function needs to access COMMAND.COM if the messages were not
  2739.       loaded into memory permanently with /MSG; the caller should assume
  2740.       that the returned message will be overwritten by the next call of
  2741.       the function
  2742.     supported by DR-DOS 5.0
  2743.  
  2744. (Table 1284)
  2745. Values for parameter errors:
  2746.  01h    Too many parameters
  2747.  02h    Required Parameter missing
  2748.  03h    Invalid switch
  2749.  04h    Invalid keyword
  2750.  06h    Parameter value not in allowed range
  2751.  07h    Parameter value not allowed
  2752.  08h    Parameter value not allowed
  2753.  09h    Parameter format not correct
  2754.  0Ah    Invalid parameter
  2755.  0Bh    Invalid parameter combination
  2756. --------D-2F122F-----------------------------
  2757. INT 2F U - DOS 4.x internal - SET DOS VERSION NUMBER TO RETURN
  2758.     AX = 122Fh
  2759.     DX = DOS version number (0000h = return true DOS version)
  2760. Note:    not available under DR-DOS 5.0 or 6.0
  2761. SeeAlso: INT 21/AH=30h,INT 21/AX=3306h
  2762. --------m-2F12FFBX0006-----------------------
  2763. INT 2F U - DR-DOS 6, Novell DOS 7 - EMM386.EXE - VIDEO MEMORY SPACE CONTROL
  2764.     AX = 12FFh
  2765.     BX = 0006h
  2766.     DX = 0000h
  2767.     CX = function
  2768.         0000h get status of video memory space (MEMMAX /V)
  2769.         0001h map memory into video memory space (MEMMAX +V)
  2770.         0002h unmap memory from video memory space (MEMMAX -V)
  2771. Return: CF clear if successful
  2772.         AX = 0000h (successful)
  2773.         BX = segment of reserved video RAM
  2774.         CX = segment of used video RAM
  2775.         DX = segment of first upper MCB
  2776. Notes:    this functionality is provided by EMM386, and partially supported by
  2777.       HIDOS.SYS
  2778.     BL specifies which program handles the call, BH is the function number
  2779. SeeAlso: AX=D201h/BX=4849h
  2780. --------O-2F12FFBX0007-----------------------
  2781. INT 2F U - Novell DOS 7 - SCRIPT.EXE - GET ???
  2782.     AX = 12FFh
  2783.     BX = 0007h
  2784.     CX = 0000h
  2785. Return: CF clear if installed
  2786.         AX = 0000h
  2787.         BX = ??? (4426h)
  2788.         CX = ??? (0068h)
  2789.         DX = PSP segment of resident code???
  2790.         SI = ??? (4AFAh)
  2791.         ES = resident code segment
  2792. --------m-2F12FFBX0106-----------------------
  2793. INT 2F U - Novell DOS 7 - EMM386.EXE - GET VERSION???
  2794.     AX = 12FFh
  2795.     BX = 0106h
  2796. Return:    CF clear if successful
  2797.         AX = 0000h (successful)
  2798.         BX = EDC0h (signature)
  2799.         CL = memory manager variant (02h,03h)
  2800.         (02h when DPMI/VCPI disabled, 03h when DPMI/VCPI loaded)
  2801.         CH = ??? (00h)
  2802.         DX = version??? (0300h for v3.0)
  2803.         ES = segment of EMM386 low-memory stub
  2804. Notes:    BL specifies which program handles the call, BH is the function number
  2805.     if the word at ES:0012h is nonzero, if contains the offset within
  2806.       segment ES of the CEMM-compatible entry point (see #1285)
  2807.     if no other program has hooked INT 67, an alternate installation
  2808.       check is to test for the string
  2809.       "NOVELL EXPANDED MEMORY MANAGER 386" at offset 14h in the INT 67
  2810.       handler's segment; the word immediately preceding this string
  2811.       contains the offset of the API entry point if it is nonzero
  2812. Index:    entry point;Novell EMM386
  2813.  
  2814. (Table 1285)
  2815. Call Novell EMM386.EXE entry point with:
  2816.     AH = 00h get memory manager's status???
  2817.         ???
  2818.     AH = 01h set memory manager's status???
  2819.         ???
  2820.     AH = 02h Weitek coprocessor support???
  2821.         AL = subfunction???
  2822.     more functions???
  2823. SeeAlso: #0640 at INT 21/AX=4402h/SF=02h,#1950 at INT 67/AX=FFA5h
  2824. --------m-2F12FFBL06-------------------------
  2825. INT 2F U - Novell DOS 7 - EMM386.EXE - ???
  2826.     AX = 12FFh
  2827.     BL = 06h
  2828.     BH = function (02h-09h)
  2829.     ???
  2830. Return: ???
  2831. --------O-2F12FFBX0EDC-----------------------
  2832. INT 2F U - Novell DOS 7 - EMM386.EXE - CHECK IF MULTITASKING SUPPORT LOADED???
  2833.     AX = 12FFh
  2834.     BX = 0EDCh
  2835. Return: AX = 0000h if ??? loaded
  2836.         CF clear
  2837.         BX = 0000h
  2838. Notes:    called by Novell DOS 7 TaskMgr
  2839.     if this function returns with AX=0000h, then the code necessary to
  2840.       support the API on INT 2F/AX=2780h is loaded and that API becomes
  2841.       available for use
  2842.     because the request is handled on the initial trap to the memory
  2843.       manager caused by INT instructions, this function must be invoked
  2844.       with an actual INT 2F instruction instead of some simulation such
  2845.       as a far call to the address in the interrupt vector table
  2846. SeeAlso: AX=2780h/CL=01h,AX=2780h/CL=02h,AX=2780h/CL=03h,AX=2780h/CL=04h
  2847. --------D-2F13-------------------------------
  2848. INT 2F U - DOS 3.2+ - SET DISK INTERRUPT HANDLER
  2849.     AH = 13h
  2850.     DS:DX -> interrupt handler disk driver calls on read/write
  2851.     ES:BX = address to restore INT 13 to on system halt (exit from root
  2852.          shell) or warm boot (INT 19)
  2853. Return: DS:DX set by previous invocation of this function
  2854.     ES:BX set by previous invocation of this function
  2855. Notes:    IO.SYS hooks INT 13 and inserts one or more filters ahead of the
  2856.       original INT 13 handler.  The first is for disk change detection
  2857.       on floppy drives, the second is for tracking formatting calls and
  2858.       correcting DMA boundary errors, the third is for working around
  2859.       problems in a particular version of IBM's ROM BIOS
  2860.     before the first call, ES:BX points at the original BIOS INT 13; DS:DX
  2861.       also points there unless IO.SYS has installed a special filter for
  2862.       hard disk reads (on systems with model byte FCh and BIOS date
  2863.       "01/10/84" only), in which case it points at the special filter
  2864.     most DOS 3.2+ disk access is via the vector in DS:DX, although a few
  2865.       functions are still invoked via an INT 13 instruction
  2866.     this is a dangerous security loophole for any virus-monitoring software
  2867.       which does not trap this call ("INT13", "Nomenklatura", and many
  2868.       Bulgarian viruses are known to use it to get the original ROM entry
  2869.       point)
  2870. SeeAlso: INT 13/AH=01h,INT 19,INT 9D"VIRUS"
  2871. --------N-2F13-------------------------------
  2872. INT 2F U - MS-NET - ???
  2873.     AH = 13h
  2874.     ???
  2875. Return: ???
  2876. Note:    supposedly used to move (or control the movement of) NCBs
  2877. --------U-2F1400-----------------------------
  2878. INT 2F C - NLSFUNC.COM - INSTALLATION CHECK
  2879.     AX = 1400h
  2880. Return: AL = 00h not installed, OK to install
  2881.          01h not installed, not OK
  2882.          FFh installed
  2883. Notes:    this function is called by the DOS v3.3+ kernel
  2884.     supported by OS/2 v1.3+ compatibility box, which always returns AL=FFh
  2885.     supported by DR-DOS 5.0
  2886.     documented for MS-DOS 5+, but undocumented in prior versions
  2887. SeeAlso: AX=1401h"NLSFUNC",AX=1402h"NLSFUNC"
  2888. --------D-2F1400-----------------------------
  2889. INT 2F - European MS-DOS 4.0 POPUP - "CheckPu" - INSTALLATION CHECK
  2890.     AX = 1400h
  2891. Return: AX = FFFFh if installed
  2892.         BX = maximum memory required to save screen and keyboard info
  2893.     CF clear if successful
  2894.     CF set on error
  2895.         AX = error code
  2896.         0002h invalid function
  2897.         0004h unknown error
  2898. Note:    the POPUP interface is used by background programs (see INT 21/AH=80h)
  2899.       to communicate with the user
  2900. SeeAlso: AX=1401h"POPUP",AX=1402h"POPUP",AX=1403h"POPUP"
  2901. --------U-2F1401-----------------------------
  2902. INT 2F CU - NLSFUNC.COM - CHANGE CODE PAGE
  2903.     AX = 1401h
  2904.     DS:SI -> internal code page structure (see #1286)
  2905.     BX = new code page (see INT 21/AX=6602h)
  2906.     DX = country code???
  2907. Return: AL = status
  2908.          00h successful
  2909.          else DOS error code
  2910. Note:    this function is called by the DOS v3.3+ kernel
  2911. SeeAlso: AX=1400h"NLSFUNC",AX=1402h"NLSFUNC",INT 21/AH=66h
  2912.  
  2913. Format of DOS 3.30 internal code page structure:
  2914. Offset    Size    Description    (Table 1286)
  2915.  00h  8 BYTEs    ???
  2916.  08h 64 BYTEs    name of country information file
  2917.  48h    WORD    system code page
  2918.  4Ah    WORD    number of supported subfunctions
  2919.  4Ch  5 BYTEs    data to return for INT 21/AX=6502h
  2920.  51h  5 BYTEs    data to return for INT 21/AX=6504h
  2921.  56h  5 BYTEs    data to return for INT 21/AX=6505h
  2922.  5Bh  5 BYTEs    data to return for INT 21/AX=6506h
  2923.  60h 41 BYTEs    data to return for INT 21/AX=6501h
  2924. --------D-2F1401-----------------------------
  2925. INT 2F - European MS-DOS 4.0 POPUP - "PostPu" - OPEN/CLOSE POPUP SCREEN
  2926.     AX = 1401h
  2927.     DL = function (00h open, 01h close)
  2928.     DH = wait flag
  2929.         00h block until screen opens
  2930.         01h return error if screen is not available
  2931.         02h urgent--always open screen immediately
  2932. Return: CF clear if successful
  2933.         BX = amount of memory needed to save screen and keyboard info,
  2934.         0000h if default save location can be used (only if DH was 02h)
  2935.     CF set on error
  2936. Note:    the application using the screen is frozen until the popup screen is
  2937.       closed
  2938. SeeAlso: AX=1400h"POPUP",AX=1402h"POPUP",AX=1403h"POPUP"
  2939. --------U-2F1402-----------------------------
  2940. INT 2F CU - NLSFUNC.COM - GET EXTENDED COUNTRY INFO
  2941.     AX = 1402h
  2942.     BP = subfunction (same as AL for INT 21/AH=65h)
  2943.     BX = code page (see INT 21/AX=6602h)
  2944.     DX = country code (see INT 21/AH=38h)
  2945.     DS:SI -> internal code page structure (see #1286)
  2946.     ES:DI -> user buffer
  2947.     CX = size of user buffer
  2948. Return: AL = status
  2949.         00h successful
  2950.         else DOS error code
  2951. Notes:    this function is called by the DOS v3.3+ kernel on INT 21/AH=65h
  2952.     code page structure apparently only needed for COUNTRY.SYS pathname
  2953. SeeAlso: AX=1401h"NLSFUNC",AX=1403h"NLSFUNC",AX=1404h,INT 21/AH=65h
  2954. --------D-2F1402-----------------------------
  2955. INT 2F - European MS-DOS 4.0 POPUP - "SavePu" - SAVE POPUP SCREEN
  2956.     AX = 1402h
  2957.     ES:DI -> save buffer (0000h:0000h for default buffer in POPUP)
  2958. Return: CF clear if successful
  2959.     CF set on error
  2960.         AX = error code (see #1287)
  2961. SeeAlso: AX=1400h"POPUP",AX=1401h"POPUP",AX=1403h"POPUP"
  2962.  
  2963. (Table 1287)
  2964. Values for POPUP error code:
  2965.  0001h    process does not own screen
  2966.  0004h    unknown error
  2967.  0005h    invalid pointer
  2968. --------U-2F1403-----------------------------
  2969. INT 2F CU - NLSFUNC.COM - SET CODE PAGE
  2970.     AX = 1403h
  2971.     DS:SI -> internal code page structure (see #1286)
  2972.     BX = code page (see INT 21/AX=6602h)
  2973.     DX = country code (see INT 21/AH=38h)
  2974. Return: AL = status
  2975.          ???
  2976. Note:    this function is called by the DOS v3.3+ kernel on INT 21/AH=38h
  2977. SeeAlso: AX=1402h"NLSFUNC",AX=1404h,INT 21/AH=38h"SET"
  2978. --------D-2F1403-----------------------------
  2979. INT 2F - European MS-DOS 4.0 POPUP - "RestorePu" - RESTORE SCREEN
  2980.     AX = 1403h
  2981.     ES:DI -> buffer containing saved screen
  2982.         (0000h:0000h for default buffer in POPUP)
  2983. Return: CF clear if successful
  2984.     CF set on error
  2985.         AX = error code (see #1287)
  2986. SeeAlso: AX=1400h"POPUP",AX=1401h"POPUP",AX=1402h"POPUP"
  2987. --------U-2F1404-----------------------------
  2988. INT 2F CU - NLSFUNC.COM - GET COUNTRY INFO
  2989.     AX = 1404h
  2990.     BX = code page (see INT 21/AX=6602h)
  2991.     DX = country code (see INT 21/AH=38h)
  2992.     DS:SI -> internal code page structure (see #1286)
  2993.     ES:DI -> user buffer
  2994. Return: AL = status
  2995.          ???
  2996. Notes:    this function is called by the DOS v3.3+ kernel on INT 21/AH=38h
  2997.     code page structure apparently only needed for COUNTRY.SYS pathname
  2998. SeeAlso: AX=1402h,AX=1403h,INT 21/AH=38h"GET"
  2999. --------U-2F14FE-----------------------------
  3000. INT 2F U - DR-DOS 5.0 NLSFUNC - GET EXTENDED COUNTRY INFORMATION
  3001.     AX = 14FEh
  3002.     BX = code page (FFFFh=global code page) (see INT 21/AX=6602h)
  3003.     DX = country ID (FFFFh=current country) (see INT 21/AH=38h)
  3004.     ES:DI -> country information buffer
  3005.     CL = info ID
  3006.         01h get general internationalization info
  3007.         02h get pointer to uppercase table
  3008.         04h get pointer to filename uppercase table
  3009.         05h get pointer to filename terminator table
  3010.         06h get pointer to collating sequence table
  3011.         07h get pointer to Double-Byte Character Set table
  3012.     CF set (used to return error if not installed)
  3013. Return: CF clear if successful
  3014.         DS:SI -> requested information
  3015.     CF set on error
  3016. Notes:    DR-DOS 5.0 NLSFUNC returns CF set and AX=0001h if AL was not 00h, FEh,
  3017.       or FFh on entry.
  3018.     the DR-DOS kernel calls this function on INT 21/AX=6501h
  3019.     the value in CL is not range-checked by the DR-DOS 5.0 NLSFUNC
  3020. SeeAlso: AX=14FFh,INT 21/AH=65h
  3021.  
  3022. Format of DR-DOS COUNTRY.SYS file:
  3023. Offset    Size    Description    (Table 1288)
  3024.  00h 126 BYTEs    copyright notice (terminated with Ctrl-Z, padded with NULs)
  3025.  7Eh    WORD    signature EDC1h
  3026.  80h    var    country pointer records
  3027.     Offset    Size    Description
  3028.      00h    WORD    country code (0000h if end of array)
  3029.      02h    WORD    code page
  3030.      04h    WORD    ??? (0000h)
  3031.      06h  7 WORDs    offsets in file for data tables for subfunctions
  3032.               01h-07h
  3033.  var    var    country information
  3034. --------U-2F14FF-----------------------------
  3035. INT 2F U - DR-DOS 5.0 NLSFUNC - PREPARE CODE PAGE
  3036.     AX = 14FFh
  3037.     BX = code page
  3038. Return: AX = ???
  3039.     ZF set if AX=0000h
  3040. Notes:    DR-DOS 5.0 NLSFUNC returns CF set and AX=0001h if AL was not 00h, FEh,
  3041.       or FFh on entry.
  3042.     passes codepage preparation request to each character device supporting
  3043.       the generic IOCTL call
  3044. SeeAlso: AX=14FEh,INT 21/AX=440Ch,INT 21/AX=6602h
  3045. --------U-2F1500-----------------------------
  3046. INT 2F - DOS 4.00 GRAPHICS.COM - INSTALLATION CHECK
  3047.     AX = 1500h
  3048. Return: AX = FFFFh
  3049.     ES:DI -> ??? (graphics data?)
  3050. Note:    this installation check conflicts with the CD-ROM Extensions
  3051.       installation check; moved to AX=AC00h in later versions
  3052. SeeAlso: AX=AC00h
  3053. --------d-2F1500BX0000-----------------------
  3054. INT 2F - CD-ROM - INSTALLATION CHECK
  3055.     AX = 1500h
  3056.     BX = 0000h
  3057. Return: BX = number of CD-ROM drive letters used
  3058.     CX = starting drive letter (0=A:)
  3059. Notes:    this installation check DOES NOT follow the format used by other
  3060.       software
  3061.     this installation check conflicts with the DOS 4.00 GRAPHICS.COM
  3062.       installation check
  3063. SeeAlso: INT 2F/AX=D000h/BX=4D44h"Lotus"
  3064. --------d-2F1501-----------------------------
  3065. INT 2F - CD-ROM - GET DRIVE DEVICE LIST
  3066.     AX = 1501h
  3067.     ES:BX -> buffer to hold drive letter list (5 bytes per drive letter)
  3068. Return: buffer filled, for each drive letter
  3069.       BYTE    subunit number in driver
  3070.       DWORD address of device driver header
  3071. --------d-2F1502-----------------------------
  3072. INT 2F - CD-ROM - GET COPYRIGHT FILE NAME
  3073.     AX = 1502h
  3074.     ES:BX -> 38-byte buffer for name of copyright file
  3075.     CX = drive number (0=A:)
  3076. Return: CF set if drive is not a CD-ROM drive
  3077.         AX = 000Fh (invalid drive)
  3078.     CF clear if successful
  3079. SeeAlso: AX=1503h
  3080. --------d-2F1503-----------------------------
  3081. INT 2F - CD-ROM - GET ABSTRACT FILE NAME
  3082.     AX = 1503h
  3083.     ES:BX -> 38-byte buffer for name of abstract file
  3084.     CX = drive number (0=A:)
  3085. Return: CF set if drive is not a CD-ROM drive
  3086.         AX = 000Fh (invalid drive)
  3087.     CF clear if successful
  3088. SeeAlso: AX=1502h,AX=1504h
  3089. --------d-2F1504-----------------------------
  3090. INT 2F - CD-ROM - GET BIBLIOGRAPHIC DOC FILE NAME
  3091.     AX = 1504h
  3092.     ES:BX -> 38-byte buffer for name of bibliographic documentation file
  3093.     CX = drive number (0=A:)
  3094. Return: CF set if drive is not a CD-ROM drive
  3095.         AX = 000Fh (invalid drive)
  3096.     CF clear if successful
  3097. SeeAlso: AX=1502h,AX=1503h
  3098. --------d-2F1505-----------------------------
  3099. INT 2F - CD-ROM - READ VTOC
  3100.     AX = 1505h
  3101.     ES:BX -> 2048-byte buffer
  3102.     CX = drive number (0=A:)
  3103.     DX = sector index (0=first volume descriptor,1=second,...)
  3104. Return: CF set on error
  3105.         AX = error code (15=invalid drive,21=not ready)
  3106.     CF clear if successful
  3107.         AX = volume descriptor type (1=standard,FFh=terminator,0=other)
  3108. --------d-2F1506-----------------------------
  3109. INT 2F - CD-ROM - TURN DEBUGGING ON
  3110.     AX = 1506h
  3111.     BX = debugging function to enable
  3112. Note:    reserved for development
  3113. SeeAlso: AX=1507h
  3114. --------d-2F1507-----------------------------
  3115. INT 2F - CD-ROM - TURN DEBUGGING OFF
  3116.     AX = 1507h
  3117.     BX = debugging function to disable
  3118. Note:    reserved for development
  3119. SeeAlso: AX=1506h
  3120. --------d-2F1508-----------------------------
  3121. INT 2F - CD-ROM - ABSOLUTE DISK READ
  3122.     AX = 1508h
  3123.     ES:BX -> buffer
  3124.     CX = drive number (0=A:)
  3125.     SI:DI = starting sector number
  3126.     DX = number of sectors to read
  3127. Return: CF set on error
  3128.         AL = error code (15=invalid drive,21=not ready)
  3129.     CF clear if successful
  3130. SeeAlso: AX=1509h
  3131. --------d-2F1509-----------------------------
  3132. INT 2F - CD-ROM - ABSOLUTE DISK WRITE
  3133.     AX = 1509h
  3134.     ES:BX -> buffer
  3135.     CX = drive number (0=A:)
  3136.     SI:DI = starting sector number
  3137.     DX = number of sectors to write
  3138. Note:    corresponds to INT 26h and is currently reserved and nonfunctional
  3139. SeeAlso: AX=1508h
  3140. --------d-2F150A-----------------------------
  3141. INT 2F - CD-ROM - RESERVED
  3142.     AX = 150Ah
  3143. --------d-2F150B-----------------------------
  3144. INT 2F - CD-ROM v2.00+ - DRIVE CHECK
  3145.     AX = 150Bh
  3146.     CX = drive number (0=A:)
  3147. Return: BX = ADADh if MSCDEX.EXE installed
  3148.         AX = support status
  3149.         0000h if drive not supported
  3150.         nonzero if supported
  3151. SeeAlso: AX=150Dh
  3152. --------d-2F150C-----------------------------
  3153. INT 2F - CD-ROM v2.00+ - GET MSCDEX.EXE VERSION
  3154.     AX = 150Ch
  3155. Return: BH = major version
  3156.     BL = minor version
  3157. Note:    MSCDEX.EXE versions prior to 2.00 return BX=0
  3158. --------d-2F150D-----------------------------
  3159. INT 2F - CD-ROM v2.00+ - GET CD-ROM DRIVE LETTERS
  3160.     AX = 150Dh
  3161.     ES:BX -> buffer for drive letter list (1 byte per drive)
  3162. Return: buffer filled with drive numbers (0=A:).  Each byte corresponds
  3163.     to the drive in the same position for function 1501h
  3164. SeeAlso: AX=150Bh
  3165. --------d-2F150E-----------------------------
  3166. INT 2F - CD-ROM v2.00+ - GET/SET VOLUME DESCRIPTOR PREFERENCE
  3167.     AX = 150Eh
  3168.     BX = subfunction
  3169.         00h get preference
  3170.         DX = 0000h
  3171.         Return: DX = preference settings
  3172.         01h set preference
  3173.         DH = volume descriptor preference
  3174.             01h = primary volume descriptor
  3175.             02h = supplementary volume descriptor
  3176.         DL = supplementary volume descriptor preference
  3177.             01h = shift-Kanji
  3178.     CX = drive number (0=A:)
  3179. Return: CF set on error
  3180.         AX = error code (15=invalid drive,1=invalid function)
  3181.     CF clear if successful
  3182. --------d-2F150F-----------------------------
  3183. INT 2F - CD-ROM v2.00+ - GET DIRECTORY ENTRY
  3184.     AX = 150Fh
  3185.     CL = drive number (0=A:)
  3186.     CH bit 0 = copy flag
  3187.         clear if direct copy
  3188.         set if copy to structure which removes ISO/High Sierra diffs
  3189.     ES:BX -> ASCIZ path name
  3190.     SI:DI -> buffer for directory entry (see #1289)
  3191.          minimum 255 bytes for direct copy
  3192. Return: CF set on error
  3193.         AX = error code
  3194.     CF clear if successful
  3195.         AX = disk format (0=High Sierra,1=ISO 9660)
  3196.  
  3197. Format of CD-ROM directory entry (direct copy):
  3198. Offset    Size    Description    (Table 1289)
  3199.  00h    BYTE  length of directory entry
  3200.  01h    BYTE  length of XAR in Logical Block Numbers
  3201.  02h    DWORD LBN of data, Intel (little-endian) format
  3202.  06h    DWORD LBN of data, Motorola (big-endian) format
  3203.  0Ah    DWORD length of file, Intel format
  3204.  0Eh    DWORD length of file, Motorola format
  3205. ---High Sierra---
  3206.  12h  6 BYTEs date and time
  3207.  18h    BYTE  bit flags
  3208.  19h    BYTE  reserved
  3209. ---ISO 9660---
  3210.  12h  7 BYTEs date and time
  3211.  19h    BYTE  bit flags
  3212. ---both formats---
  3213.  1Ah    BYTE  interleave size
  3214.  1Bh    BYTE  interleave skip factor
  3215.  1Ch    WORD  volume set sequence number, Intel format
  3216.  1Eh    WORD  volume set sequence number, Motorola format
  3217.  20h    BYTE  length of file name
  3218.  21h  N BYTEs file name
  3219.     BYTE (optional) padding if filename is odd length
  3220.       N BYTEs system data
  3221.  
  3222. Format of CD-ROM directory entry (canonicalized):
  3223. Offset    Size    Description    (Table 1290)
  3224.  00h    BYTE    length of XAR in Logical Block Numbers
  3225.  01h    DWORD    Logical Block Number of file start
  3226.  05h    WORD    size of disk in logical blocks
  3227.  07h    DWORD    file length in bytes
  3228.  0Bh  7 BYTEs    date and time
  3229.  12h    BYTE    bit flags
  3230.  13h    BYTE    interleave size
  3231.  14h    BYTE    interleave skip factor
  3232.  15h    WORD    volume set sequence number
  3233.  17h    BYTE    length of file name
  3234.  18h 38 BYTEs    ASCIZ filename
  3235.  3Eh    WORD    file version number
  3236.  40h    BYTE    number of bytes of system use data
  3237.  41h 220 BYTEs    system use data
  3238. --------d-2F1510-----------------------------
  3239. INT 2F - CD-ROM v2.10+ - SEND DEVICE DRIVER REQUEST
  3240.     AX = 1510h
  3241.     CX = CD-ROM drive letter (0 = A, 1 = B, etc)
  3242.     ES:BX -> CD-ROM device driver request header (see #1265 at AX=0802h)
  3243. --------W-2F1600-----------------------------
  3244. INT 2F - MS Windows - WINDOWS ENHANCED MODE INSTALLATION CHECK
  3245.     AX = 1600h
  3246. Return: AL = status
  3247.         00h neither Windows 3.x enhanced mode nor Windows/386 2.x running
  3248.         01h Windows/386 2.x running
  3249.         80h XMS version 1 driver installed (neither Windows 3.x enhanced
  3250.           mode nor Windows/386 2.x running) (obsolete--see note)
  3251.         FFh Windows/386 2.x running
  3252.     AL = anything else
  3253.         AL = Windows major version number >= 3
  3254.         AH = Windows minor version number
  3255. Notes:    INT 2F/AH=16h comprises an API for non-Windows programs (DOS device
  3256.       drivers, TSRs, and applications) to cooperate with multitasking
  3257.       Windows/386 2.x and Windows 3.x and higher enhanced mode.
  3258.     certain calls are also supported in the Microsoft 80286 DOS extender in
  3259.       Windows standard mode
  3260.     this function served as the installation check and AX=1610h served to
  3261.       get the driver entry point for XMS version 1, which is now obsolete.
  3262.       Use AX=4300h and AX=4310h instead
  3263. SeeAlso: AX=160Ah,AX=1610h,AX=4300h,AX=4680h
  3264. Index:    installation check;XMS version 1
  3265. --------W-2F1602-----------------------------
  3266. INT 2F - MS Windows/386 2.x - GET API ENTRY POINT
  3267.     AX = 1602h
  3268. Return: ES:DI -> Windows/386 2.x API procedure entry point
  3269. Notes:    this interface is supported in Windows 3.x only for 2.x compatibility
  3270.     to get the current virtual machine (VM) ID in Windows/386 2.x:
  3271.         AX = 0000h
  3272.         ES:DI -> return address
  3273.         JUMP to address returned from INT 2F/AX=1602h
  3274.     After JUMP, at return address:
  3275.         BX = current VM ID.
  3276. SeeAlso: AX=C020h
  3277. --------W-2F1603-----------------------------
  3278. INT 2F - MS Windows/386 - GET INSTANCE DATA
  3279.     AX = 1603h
  3280. Return: AX = 5248h ('RH') if supported
  3281.         DS:SI -> Windows/386 instance data (see #1291)
  3282. Notes:    reportedly supported by RM Nimbus MS-DOS 3.3 kernel
  3283.     this function is called by DOSMGR when AX=1607h/BX=0015h is not
  3284.       supported, as is the case in DOS versions prior to 5.0
  3285.     see Geoff Chappell's book _DOS_Internals_ for additional discussions of
  3286.       this function, DOSMGR's behavior, and instancing in general
  3287. SeeAlso: AX=1607h/BX=0015h
  3288.  
  3289. Format of Windows/386 instance data:
  3290. Offset    Size    Description    (Table 1291)
  3291.  00h    WORD    segment of IO.SYS (0000h = default 0070h)
  3292.  02h    WORD    offset in IO.SYS of STACKS data structure (DOS 3.2x)
  3293.         0000h if not applicable
  3294.  04h    WORD    number of instance data entries (max 32)
  3295.  06h    Array of instance data entries
  3296.     Offset    Size    Description
  3297.      00h    WORD    segment (0002h = DOS kernel)
  3298.      02h    WORD    offset
  3299.      04h    WORD    size
  3300. --------W-2F1605-----------------------------
  3301. INT 2F - MS Windows - WINDOWS ENHANCED MODE & 286 DOSX INIT BROADCAST
  3302.     AX = 1605h
  3303.     ES:BX = 0000h:0000h
  3304.     DS:SI = 0000h:0000h
  3305.     CX = 0000h
  3306.     DX = flags
  3307.         bit 0 = 0 if Windows enhanced-mode initialization
  3308.         bit 0 = 1 if Microsoft 286 DOS extender initialization
  3309.         bits 1-15 reserved (undefined)
  3310.     DI = version number (major in upper byte, minor in lower)
  3311. Return: CX = 0000h if okay for Windows to load
  3312.     CX = FFFFh (other registers unchanged) if Windows 3.0 in standard mode
  3313.     CX <> 0 if Windows should not load
  3314.     ES:BX -> startup info structure (see #1292)
  3315.     DS:SI -> virtual86 mode enable/disable callback or 0000h:0000h
  3316. Notes:    the Windows enhanced mode loader and Microsoft 286 DOS extender will
  3317.       broadcast an INT 2F/AX=1605h call when initializing.    Any DOS device
  3318.       driver or TSR can watch for this broadcast and return the appropriate
  3319.       values.  If the driver or TSR returns CX <> 0, it is also its
  3320.       responsibility to display an error message.
  3321.     each handler must first chain to the prior INT 2F handler with
  3322.       registers unchanged before processing the call
  3323.     if the handler requires local data on a per-VM basis, it must store the
  3324.       returned ES:BX in the "next" field of a startup info structure and
  3325.       return a pointer to that structure in ES:BX
  3326.     a single TSR may set the V86 mode enable/disable callback; if DS:SI is
  3327.       already nonzero, the TSR must fail the initialization by setting CX
  3328.       nonzero
  3329.     MSD checks for Windows 3.0 running in standard mode by testing whether
  3330.       CX=FFFFh and other registers are unchanged on return
  3331. SeeAlso: AX=1606h,AX=1608h,AX=4B05h
  3332.  
  3333. Format of Windows Startup Information Structure:
  3334. Offset    Size    Description    (Table 1292)
  3335.  00h  2 BYTEs    major, minor version of info structure
  3336.  02h    DWORD    pointer to next startup info structure or 0000h:0000h
  3337.  06h    DWORD    pointer to ASCIZ name of virtual device file or 0000h:0000h
  3338.  0Ah    DWORD    virtual device reference data (see #1294)
  3339.         (only used if above nonzero)
  3340.  0Eh    DWORD    pointer to instance data records (see #1293) or 0000h:0000h
  3341.  
  3342. Format of one Instance Item in array:
  3343. Offset    Size    Description    (Table 1293)
  3344.  00h    DWORD    address of instance data (end of array if 0000h:0000h)
  3345.  04h    WORD    size of instance data
  3346.  
  3347. Format of Virtual Device Reference Data:
  3348. Offset    Size    Description    (Table 1294)
  3349.  00h    DWORD    physical address of ??? or 00000000h
  3350.  04h    DWORD    physical address of ??? table
  3351.  08h    DWORD    "DEST_PAGE" address to which pages must be mapped
  3352.  0Ch  N DWORDs    "SRC_PAGE" physical addresses of the pages
  3353.         00000000h = end of table
  3354. Note:    EMM386.EXE sets the first pointer to the start of the device driver
  3355.       chain, the second pointer to a field of 40h bytes followed by a
  3356.       16-bit offset to the end of the SRC_PAGE table, and DEST_PAGE to
  3357.       the start segment of the UMB area
  3358.  
  3359. (Table 1295)
  3360. Values Windows virtual mode enable/disable procedure is called with:
  3361.     AX = 0000h disable V86 mode
  3362.     AX = 0001h enable V86 mode
  3363.     interrupts disabled
  3364. Return: CF set on error
  3365.     CF clear if successful
  3366.     interrupts disabled
  3367. --------W-2F1606-----------------------------
  3368. INT 2F - MS Windows - WINDOWS ENHANCED MODE & 286 DOSX EXIT BROADCAST
  3369.     AX = 1606h
  3370.     DX = flags
  3371.         bit 0 = 0 if Windows enhanced-mode exit
  3372.         bit 0 = 1 if Microsoft 286 DOS extender exit
  3373.         bits 1-15 reserved (undefined)
  3374. Notes:    if the init broadcast fails (AX=1605h returned CX <> 0), then this
  3375.       broadcast will be issued immediately.
  3376.     this call will be issued in real mode
  3377. SeeAlso: AX=1605h,AX=1609h
  3378. --------W-2F1607-----------------------------
  3379. INT 2F - MS Windows - VIRTUAL DEVICE CALL OUT API
  3380.     AX = 1607h
  3381.     BX = virtual device ID (see INT 2F/AX=1684h)
  3382.     CX = (usually) callout subfunction
  3383. Return: (usually) AX,BX,CX,DX,ES contain results
  3384. Notes:    more of a convention than an API, this call specifies a standard
  3385.       mechanism for Windows enhanced-mode virtual devices (VxD's) to talk
  3386.       to DOS device drivers and TSRs
  3387.     see below for details on several virtual devices
  3388. SeeAlso: AX=1605h,AX=1607h/BX=000Ch,AX=1607h/BX=0014h,AX=1607h/BX=0015h
  3389. SeeAlso: AX=1684h,AX=C020h
  3390. --------W-2F1607BX0006-----------------------
  3391. INT 2F - MS Windows - "V86MMGR" VIRTUAL DEVICE API
  3392.     AX = 1607h
  3393.     BX = 0006h (VxD identifier of "V86MMGR")
  3394.     CX = 0000h
  3395. Return: AX = status
  3396.         0000h if local A20 state changed
  3397.         1607h if A20 unchanged
  3398.         other if global A20 state changed
  3399. --------W-2F1607BX000C-----------------------
  3400. INT 2F - MS Windows - "VMD" VIRTUAL MOUSE DEVICE API
  3401.     AX = 1607h
  3402.     BX = 000Ch (VxD identifier of "VMD")
  3403. Return: CX = nonzero if mouse driver already virtualized
  3404. Note:    VMD (Virtual Mouse Driver) calls this and then checks whether CX is
  3405.       nonzero; if yes, it will not automatically virtualize the mouse
  3406.       driver.  This would be used if MOUSE.COM already virtualizes
  3407.       itself using the Windows API.
  3408. SeeAlso: AX=1607h/BX=0014h,AX=1607h/BX=0015h
  3409. ----------2F1607BX0010-----------------------
  3410. INT 2F C - MS Windows 3.1 - "BLOCKDEV" VIRTUAL HARD DISK DEVICE API
  3411.     AX = 1607h
  3412.     BX = 0010h (VxD identifier of "BLOCKDEV")
  3413.     CX = function
  3414.         0001h starting FastDisk compatibility tests
  3415.         0002h ending FastDisk compatibility tests
  3416.         0003h check if FastDisk installation allowed
  3417.         Return: CX = 0000h if allowed
  3418. Note:    this interface is called by the Windows FastDisk driver (such as
  3419.       WDCTRL) when it thinks that the INT 13h handler immediately below
  3420.       IO.SYS's INT 13h code is not in ROM; it should be supported by any
  3421.       program which hooks itself underneath IO.SYS's INT 13h code with
  3422.       INT 2F/AH=13h
  3423. SeeAlso: AX=1607h/BX=0014h,INT 2F/AH=13h
  3424. --------W-2F1607BX0014-----------------------
  3425. INT 2F - MS Windows - "VNETBIOS" VIRTUAL DEVICE API
  3426.     AX = 1607h
  3427.     BX = 0014h (VxD identifier of "VNETBIOS")
  3428. Return: ES:DI -> 128-byte table specifying VNETBIOS actions for each NetBIOS
  3429.         command code (see #1296)
  3430. Note:    VNETBIOS (Virtual NetBIOS) calls this function to determine whether
  3431.       the NetBIOS has an extensions Windows should know about
  3432. SeeAlso: AX=1607h/BX=000Ch,AX=1607h/BX=0010h,AX=1607h/BX=0015h
  3433.  
  3434. (Table 1296)
  3435. Values for VNETBIOS action code:
  3436.  00h    "VN_Unknown" unknown command
  3437.  04h    "VN_No_Map"  no memory mapping necessary
  3438.  08h    "VN_Map_In"  input buffer is quickly used, so no global mapping needed
  3439.  0Ch    "VN_Map_In"  output buffer is quickly used, so no global mapping needed
  3440.  10h    "VN_Map_In_Out"     buffer is quickly used, so no global mapping needed
  3441.  14h    "VN_Chain_Send"     the chain-send command
  3442.  18h    "VN_Cancel"    special case for cancel command
  3443.  1Ch    "VN_Buffer_In"    buffer is incoming
  3444.  20h    "VN_Buffer_Out" buffer is outgoing
  3445.  24h    "VN_Buffer_In_Out" buffer used for both incoming and outgoing data
  3446. --------D-2F1607BX0015-----------------------
  3447. INT 2F C - MS Windows - "DOSMGR" VIRTUAL DEVICE API
  3448.     AX = 1607h
  3449.     BX = 0015h (VxD identifier of "DOSMGR")
  3450.     CX = function
  3451.         0000h query instance processing
  3452.         DX = 0000h
  3453.         Return: CX = state
  3454.                 0000h not instanced
  3455.                 other instanced (DOS 5+ kernel returns 0001h)
  3456.                 DX = segment of DOS drivers or 0000h for
  3457.                     default of 0070h
  3458.                 ES:BX -> patch table (see #1298)
  3459.         0001h set patches in DOS
  3460.         DX = bit mask of patch requests (see #1297)
  3461.         Return: AX = B97Ch
  3462.             BX = bit mask of patches applied (see #1297)
  3463.             DX = A2ABh
  3464.         0002h remove patches in DOS (ignored by DOS 5.0 kernel)
  3465.         DX = bit mask of patch requests (see function 0001h)
  3466.         Return: CX = 0000h (DOS 5-6)
  3467.         Note:    return values are ignored by DOSMGR in Windows 3.1
  3468.         0003h get size of DOS data structures
  3469.         DX = bit mask of request (only one bit can be set)
  3470.             bit 0: Current Directory Structure size
  3471.         Return: if supported request:
  3472.                 AX = B97Ch
  3473.                 CX = size in bytes of requested structure
  3474.                 DX = A2ABh
  3475.             else:
  3476.                 CX = 0000h
  3477.                 all other registers preserved
  3478.         0004h determine instanced data structures
  3479.         Return: AX = B97Ch if supported
  3480.             DX = A2ABh if supported (DOS 5+ kernel returns 0000h)
  3481.             BX = bit mask of instanced items
  3482.                 bit 0: CDS
  3483.                 bit 1: SFT
  3484.                 bit 2: device list
  3485.                 bit 3: DOS swappable data area
  3486.         0005h get device driver size
  3487.         ES = segment of device driver
  3488.         Return: DX:AX = 0000h:0000h on error (not dev. driver segment)
  3489.             DX:AX = A2ABh:B97Ch if successful
  3490.                 BX:CX = size of device driver in bytes
  3491. Notes:    DOSMGR (DOS Manager) will check whether the OEM DOS/BIOS data has
  3492.       been instanced via this API and will not perform its own default
  3493.       instancing of the normal DOS/BIOS data if so; if this API is not
  3494.       supported, DOSMGR will also try to access instancing data through
  3495.       INT 2F/AX=1603h
  3496.     these functions are supported by the DOS 5+ kernel; DOSMGR contains
  3497.       tables of instancing information for earlier versions of DOS
  3498.     see Geoff Chappell's book _DOS_Internals_ for additional discussions of
  3499.       DOSMGR's behavior and instancing in general
  3500. SeeAlso: AX=1603h,AX=1605h,AX=1607h/BX=000Ch,AX=1607h/BX=0014h,AX=1684h
  3501.  
  3502. Bitfields for DOSMGR patch requests:
  3503. Bit(s)    Description    (Table 1297)
  3504.  0    enable critical sections
  3505.  1    NOP setting/checking user ID
  3506.  2    turn INT 21/AH=3Fh on STDIN into polling loop
  3507.  3    trap stack fault in "SYSINIT" to WIN386
  3508.  4    BIOS patch to trap "Insert disk X:" to WIN386
  3509.  
  3510. Format of DOSMGR patch table:
  3511. Offset    Size    Description    (Table 1298)
  3512.  00h  2 BYTEs    DOS version (major, minor)
  3513.  02h    WORD    offset in DOS data segment of "SAVEDS"
  3514.  04h    WORD    offset in DOS data segment of "SAVEBX"
  3515.  06h    WORD    offset in DOS data segment of InDOS flag
  3516.  08h    WORD    offset in DOS data segment of User ID word
  3517.  0Ah    WORD    offset in DOS data segment of "CritPatch" table to enable
  3518.           critical section calls (see INT 2A/AH=80h)
  3519.  0Ch    WORD    (DOS 5+ only) offset in DOS data segment of "UMB_HEAD",
  3520.           containing segment of last MCB in conventional memory
  3521. --------E-2F1607BX22C0-----------------------
  3522. INT 2F - Rational Systems DOS/4GW - ???
  3523.     AX = 1607h
  3524.     BX = 22C0h
  3525.     ???
  3526. Return: ???
  3527. SeeAlso: INT 15/AX=BF02h,INT 15/AX=BF04h
  3528. --------W-2F1608-----------------------------
  3529. INT 2F C - MS Windows - WINDOWS ENHANCED MODE INIT COMPLETE BROADCAST
  3530.     AX = 1608h
  3531. Notes:    called after all installable devices have been initialized
  3532.     real-mode software may be called between the Windows enhanced-mode init
  3533.       call (AX=1605h) and this call; the software must detect this
  3534.       situation
  3535. SeeAlso: AX=1605h,AX=1609h
  3536. --------W-2F1609-----------------------------
  3537. INT 2F C - MS Windows - WINDOWS ENHANCED MODE BEGIN EXIT BROADCAST
  3538.     AX = 1609h
  3539. Note:    called at the beginning of a normal exit sequence; not made in the
  3540.       event of a fatal system crash
  3541. SeeAlso: AX=1606h,AX=1608h
  3542. --------W-2F160A-----------------------------
  3543. INT 2F - MS Windows 3.1 - IDENTIFY WINDOWS VERSION AND TYPE
  3544.     AX = 160Ah
  3545. Return: AX = 0000h if call supported
  3546.         BX = version (BH=major, BL=minor)
  3547.         CX = mode (0002h = standard, 0003h = enhanced)
  3548. SeeAlso: AX=1600h,AX=4680h
  3549. --------W-2F160B-----------------------------
  3550. INT 2F - MS Windows 3.1 - IDENTIFY TSRs
  3551.     AX = 160Bh
  3552.     ES:DI -> communication structure (see #1299) or 0000h:0000h
  3553. Return: ES:DI -> communication structure
  3554. Desc:    this call allows Windows-aware TSRs to make themselves known to
  3555.       Windows.
  3556. Note:    the TSR should allocate a communication structure, place the given
  3557.       ES:DI pointer in the first field, and return a pointer to the new
  3558.       structure
  3559. SeeAlso: AX=1605h,AX=160Ch,AX=4B01h,AX=4B05h
  3560.  
  3561. Format of TSR-to-Windows communication structure:
  3562. Offset    Size    Description    (Table 1299)
  3563.  00h    DWORD    pointer to next structure
  3564.  04h    WORD    PSP segment
  3565.  06h    WORD    API version ID (0100h)
  3566.  08h    WORD    EXEC flags
  3567.         bit 0: "WINEXEC"
  3568.         bit 1: "LOADLIBRARY"
  3569.         bit 2: "OPENDRIVER"
  3570.  0Ah    WORD    "exec_cmd_show"
  3571.  0Ch    DWORD    "exec_cmd"
  3572.  10h  4 BYTEs    reserved (0)
  3573.  14h    DWORD    pointer to TSR ID block (see #1300)
  3574.  18h    DWORD    pointer to TSR data block or 0000h:0000h
  3575.  
  3576. Format of Norton Utilities 6.0 TSR ID block:
  3577. Offset    Size    Description    (Table 1300)
  3578.  00h    WORD    length of name string
  3579.  02h  N BYTEs    name of TSR's executable
  3580. --------W-2F160C-----------------------------
  3581. INT 2F - MS Windows 3.1 - DETECT ROMs
  3582.     AX = 160Ch
  3583.     ???
  3584. Return: ???
  3585. Note:    used by ROM Windows
  3586. SeeAlso: AX=160Bh
  3587. --------m-2F1610-----------------------------
  3588. INT 2F - XMS v1.x only - GET DRIVER ADDRESS
  3589.     AX = 1610h
  3590.     details unavailable
  3591. Note:    this function and AX=1600h were only used in XMS version 1 and are now
  3592.       obsolete.  Use AX=4300h and AX=4310h instead
  3593. SeeAlso: AX=1600h,AX=4310h
  3594. --------W-2F1680-----------------------------
  3595. INT 2F - MS Windows, DPMI, various - RELEASE CURRENT VIRTUAL MACHINE TIME-SLICE
  3596.     AX = 1680h
  3597. Return: AL = status
  3598.         00h if the call is supported
  3599.         80h (unchanged) if the call is not supported
  3600. Notes:    programs can use this function in idle loops to enhance performance
  3601.       under multitaskers; this call is supported by MS Windows 3.0, DOS 5+,
  3602.       DPMI 1.0+, and will be supported in OS/2 2.0 for multitasking DOS
  3603.       applications
  3604.     does not block the program; it just gives up the remainder of the time
  3605.       slice
  3606.     should not be used by Windows-specific programs
  3607.     when called very often without intermediate screen output under WIN 3+,
  3608.       the VM will go into an idle-state and will not receive the next slice
  3609.       before 8 seconds. This time can be changed in SYSTEM.INI through
  3610.       "IdleVMWakeUpTime=<seconds>". Setting to zero results in a long wait.
  3611. SeeAlso: INT 15/AX=1000h,INT 15/AX=5305h,INT 21/AH=89h,INT 7A/BX=000Ah
  3612. --------W-2F1681-----------------------------
  3613. INT 2F - MS Windows 3+ - BEGIN CRITICAL SECTION
  3614.     AX = 1681h
  3615. Notes:    used to prevent a task switch from occurring
  3616.     should be followed by an INT 2F/AX=1682h call as soon as possible
  3617.     nested calls are allowed, and must be followed by an appropriate number
  3618.       of "end critical section" calls
  3619.     not supported in Windows/386 2.x. Get INDOS flag with INT 21/AH=34h and
  3620.       increment by hand.
  3621. SeeAlso: AX=1682h,INT 15/AX=101Bh,INT 21/AH=34h
  3622. --------W-2F1682-----------------------------
  3623. INT 2F - MS Windows 3+ - END CRITICAL SECTION
  3624.     AX = 1682h
  3625. Notes:    not supported in Windows/386 2.x.  Get InDOS flag with INT 21/AH=34h
  3626.       and decrement by hand, taking care not to decrement InDOS flag
  3627.       through zero
  3628. SeeAlso: AX=1681h,INT 15/AX=101Ch,INT 21/AH=34h
  3629. --------W-2F1683-----------------------------
  3630. INT 2F - MS Windows 3+ - GET CURRENT VIRTUAL MACHINE ID
  3631.     AX = 1683h
  3632. Return: BX = current virtual machine (VM) ID
  3633. Notes:    Windows itself currently runs in VM 1, but this can't be relied upon
  3634.     VM IDs are reused when VMs are destroyed
  3635.     an ID of 0 will never be returned
  3636. SeeAlso: AX=1684h,AX=1685h,AX=168Bh
  3637. --------W-2F1684-----------------------------
  3638. INT 2F - MS Windows - GET DEVICE API ENTRY POINT
  3639.     AX = 1684h
  3640.     BX = virtual device (VxD) ID (see #1301)
  3641.     ES:DI = 0000h:0000h
  3642. Return: ES:DI -> VxD API entry point, or 0:0 if the VxD does not support an API
  3643. Note:    some Windows enhanced-mode virtual devices provide services that
  3644.       applications can access.  For example, the Virtual Display Device
  3645.       (VDD) provides an API used in turn by WINOLDAP.
  3646. SeeAlso: AX=1683h
  3647.  
  3648. (Table 1301)
  3649. Values for MS Windows VxD ID:
  3650. Value    Name   CallOut V86 PM    Description
  3651.  0000h    LPT        N    N  N    DOS386 LPT Device (Windows for Workgroups 3.11)
  3652.  0000h    MSODISUP    N    N  N    MS ODI Support (Windows for Workgroups 3.11)
  3653.  0000h    NWNBLINK    N    N  N    Netware NetBIOS (Windows for Workgroups 3.11)
  3654.  0000h    SERIAL        N    N  N    DOS386 Serial Device (Windows for Workgrp 3.11)
  3655.  0001h    VMM        N  N    Virtual Machine Manager
  3656.  0002h    Debug
  3657.  0003h    VPICD        Y  Y    Virtual Prog. Interrupt Controller (PIC) Device
  3658.  0004h    VDMAD        N  N    Virtual Direct Memory Access (DMA) Device
  3659.  0005h    VTD        Y  Y    Virtual Timer Device
  3660.  0006h    V86MMGR        Y    N  N    Virtual 8086 Mode Device
  3661.  0007h    PageSwap    N  N    Paging Device
  3662.  0008h    Parity        N  N    Parity-check trapper
  3663.  0009h    Reboot        N  Y    Ctrl-Alt-Del handler
  3664.  000Ah    VDD        N  Y    Virtual Display Device (GRABBER)
  3665.  000Bh    VSD        N  N    Virtual Sound Device
  3666.  000Ch    VMD        Y    Y  Y    Virtual Mouse Device
  3667.  000Dh    VKD        N  Y    Virtual Keyboard Device
  3668.  000Eh    VCD        N  Y    Virtual COMM Device
  3669.  000Fh    VPD            Virtual Printer Device
  3670.  0010h    VHD            Virtual Hard Disk Device (Windows 3.0)
  3671.  0010h    BLOCKDEV    N  N    Virtual Hard Disk Device (Windows 3.1)
  3672.  0010h    IOS        N    N  N    DOS386 IOS Device (Windows for Workgroups 3.11)
  3673.  0010h    IOS        N  Y    (Chicago)
  3674.  0011h    VMCPD        Y  Y    Virtual Math CoProcessor Device
  3675.  0012h    EBIOS        N  N    Reserve EBIOS page (e.g., on PS/2)
  3676.  0013h    BIOSXLAT    N  N    Map ROM BIOS API between prot & V86 mode
  3677.  0014h    VNETBIOS    Y    N  N    Virtual NetBIOS Device
  3678.  0015h    DOSMGR        Y    Y  N    DOS data instancing
  3679.  0016h    WINLOAD
  3680.  0017h    SHELL        N  Y
  3681.  0018h    VMPOLL        N  N
  3682.  0019h    VPROD
  3683.  001Ah    DOSNET        N  N    assures network integrity across VMs
  3684.  001Ah    VNETWARE    Y  Y    Novell NetWare DOSNET replacement
  3685.  001Bh    VFD        N  N    Virtual Floppy Device
  3686.  001Ch    VDD2            Secondary display adapter
  3687.  001Ch    LoadHi        N  N    Netroom LoadHi Device (RMLODHI.VXD)
  3688.  001Ch    LoadHi        N  N    386MAX LoadHi Device (386MAX.VXD)
  3689.  001Ch    LoadHi        N  N    Win386 LoadHi Device (EMM386.EXE)
  3690.  001Dh    WINDEBUG    N  Y
  3691.  001Dh    TDDebug        N  Y
  3692.  001Eh    TSRLoad            TSR instance utility
  3693.  001Fh    BiosHook        BIOS interrupt hooker VxD
  3694.  0020h    Int13        N    N  N
  3695.  0021h    PageFile    N  Y    Paging File device
  3696.  0022h    SCSI
  3697.  0023h    MCA_POS
  3698.  0024h    SCSIFD            SCSI FastDisk device
  3699.  0025h    VPEND            Pen device
  3700.  0026h    APM            Advanced Power Management
  3701.  0027h    VXDLDR         N    Y  Y    VXDLDR (Windows for Workgroups 3.11)
  3702.  0028h    NDIS         N    Y  Y    Network Driver Interface Specification
  3703.                   (Windows for Workgroups 3.11)
  3704.  002Ah    VWIN32        N  Y    (Chicago)
  3705.  002Bh    VCOMM         N    Y  Y    DOS386 VCOMM Device (Windows for Workgrps 3.11)
  3706.  0030h    MACH32        N  Y    ATI Mach32 video card
  3707.  0030h    MACH32         N    N  Y    ATI MACH32
  3708.  0031h    NETBEUI         N    N  N    NETBEUI (Windows for Workgroups 3.11)
  3709.  0032h    SERVER         N    Y  Y    Int21 File Server (Windows for Workgroups 3.11)
  3710.  0033h    CONFIGMG    Y  Y    (Chicago)
  3711.  0033h    EDOS        N  N    Windows DOS Box Enhancer by Mom's Software
  3712.  0036h    VFBACKUP    Y  Y    (Chicago)
  3713.  0038h    VCOND        Y  Y    (Chicago)
  3714.  003Ah    VPMTD         N    N  Y    IFAX Scheduler Device (Windows for Workgr 3.11)
  3715.  0051h    ISAPNP        N  N
  3716.  008Dh    ESDI_506    N  N    (Chicago)
  3717.  0090h    voltrack    N  N
  3718.  00FDh    FAKEIDE        N  N    (Chicago)
  3719.  0102h    CV1        N  N    Microsoft C/C++ 7.00+ CodeView for Windows
  3720.  0200h    VIPX        Y  Y    NetWare Virtual IPX Driver
  3721.  0200h    VIPX        Y  Y    Netware VIPX
  3722.  0201h    VNWLSERV    N  N    NetWare Lite 1.1 Server (SERVER.EXE)
  3723.  0202h    WINICE        Y  Y    SoftICE/W
  3724.  0203h    VCLIENT        N  Y    NetWare Lite 1.1+ Client
  3725.  0205h    VCAFT        N  N    Novell Virtual CAFT Driver (LANalyzer for Win)
  3726.  0206h    VTXRX        N  N    Novell Virtual TXRX Driver (LANalyzer for Win)
  3727.  0234h    VCOMMUTE    Y  Y    PC Tools Commute
  3728.  0442h    VTDAPI        N  Y    MMSys Win386 VTAPI Device
  3729.  0444h    VADMAD            Autoinitialize DMA (Windows 3.0)
  3730.  0445h    VSBD        Y  Y    WinResKit: Sound Blaster Device
  3731.  0460h    UNIMODEM    N  Y
  3732.  0480h    VNetSup         N    Y  Y    Virtual Net Support (Windows for Workgrps 3.11)
  3733.  0481h    VRedir         N    N  N    Redirector File System Driver
  3734.                   (Windows for Workgroups 3.11)
  3735.  0483h    VSHARE        N  N    Windows for Workgroups Virtual SHARE
  3736.  0484h    IFSMgr         Y    Y  N    Installable File System Manager
  3737.                   (Windows for Workgroups 3.11)
  3738.  0486h    VFAT         N    Y  Y    Win386 HPFS Driver (Windows for Workgrps 3.11)
  3739.  048Bh    VCache         N    Y  Y    Virtual File Cache (Windows for Workgrps 3.11)
  3740.  048Bh    VCACHE        Y  Y
  3741.  1021h    VMB        Y  Y    Microsoft C/C++ 7.00 WXSRVR
  3742.  1022h    Vpfd        Y  Y    Microsoft C/C++ 7.00
  3743.  1025h    MMD        Y  Y    Microsoft C/C++ 8.00, Visual C/C++ 1.00
  3744.  21EAh    VADLIBWD    N  Y    Adlib Waveform Driver by John Ridges
  3745.  2200h    VFINTD        Y  Y    Norton VFINTD (Norton Desktop)
  3746.  22C0h    ???        Y        Rational Systems DOS/4GW ??? 
  3747.  2402h    ZMAX        N  N    Qualitas 386MAX v7 DOSMAX handler
  3748.  24A0h    VNSS        N  Y    Norton Screen Saver (Norton Desktop)
  3749.  24A1h    VNDWD        Y  Y    Norton VNDWD Device (Norton Desktop)
  3750.  2640h    VASBID        N  Y    WinResKit: Artisoft Sounding Board Device
  3751.  2860h    COMMTASK    N    N  Y    Windows 386-mode preemptive tasker by James
  3752.                   A. Kenemuth of Interabang Computing
  3753.  28C0h    VXD        N    Y  Y    Generic VxD for real and protected mode by
  3754.                   Andrew Schulman in MSJ February 1993
  3755.  2925h    EDOS        Y  Y    Enhanced DOS by Firefly Software
  3756.  292Dh    VSBPD        Y  Y    Sound Blaster Pro
  3757.  3098h    VstlthD        N    N  N    for QEMM Stealth ROM mode
  3758.  310Eh    WPS        N  N    MS DevNet CD-ROM: Windows Process Status
  3759.  7FE0h    VWFD        N    Y  Y    ??? by Neil Sandlin of Microsoft
  3760.  7FE1h    VWATCHD        N    Y  Y    basic driver w/ no functionality except tracing
  3761.                   by Keith Jin of Microsoft PSS
  3762.  7FE5h    VFINTD        N    Y  Y    Virtual Floppy Interrupt trapper by Neil
  3763.                   Sandlin of Microsoft
  3764.  7FE7h    VMPAGES        N    Y  Y    demonstration of exporting VxD services, by
  3765.                   Neil Sandlin of Microsoft
  3766.  7FE9h    VIdleD        N    N  N    demonstration of Call_When_Idle function, by
  3767.                   Bernie McIlroy of Microsoft
  3768.  7FEBh    VMIOD        N    N  N    Virtual Monitor I/O Traffic Device, by Neil
  3769.                   Sandlin of Microsoft
  3770.  7FEDh    VMIRQD        N    N  N    Virtual Monitor IRQ Traffic Device, by Neil
  3771.                   Sandlin of Microsoft
  3772.  8888h    VbillD            Bill Potvin II's for reversing Compaq LTE video
  3773. Note:    The high bit of the VxD ID is reserved for future use. The
  3774.     next 10 bits are the OEM number which is assigned by Microsoft. The
  3775.     low 5 bits are the device number.  Naturally, this scheme has not
  3776.     been adhered to since there are now more than 32 different VxDs.
  3777.  
  3778. (Table 1302)
  3779. Call VTD.386 entry point with:
  3780.     AX = 0000h get VTD version number
  3781.         Return: AH = major version
  3782.             AL = minor version
  3783.     AX = 0100h get current clock tick time
  3784.         Return: EDX:EAX = clock tick time in 840ns units since Windows was
  3785.                 started
  3786.     AX = 0101h get current system time in milliseconds
  3787.         Return: EAX = time in milliseconds that Windows has been running
  3788.     AX = 0102h get current virtual machine time
  3789.         Return: EAX = cumulative amount of time the virtual machine has
  3790.             been active, in milliseconds
  3791. Note:    should only be called directly when TOOLHELP.DLL TimerCount() cannot
  3792.       be called
  3793.  
  3794. (Table 1303)
  3795. Call DOSMGR entry point with:
  3796.     AX = 0000h get DOSMGR version
  3797.         Return: CF clear
  3798.             AX = version (AH = major, AL = minor)
  3799.     AX = 0001h set critical focus
  3800.         Return: CF clear
  3801.     AX = 0002h crash current virtual machine
  3802.         Return: never
  3803.         Note:   displays message box stating that "application has been
  3804.               stopped by the DOSMGR device"
  3805.     AX = 0003h enter critical section
  3806.         Note:   this function assumes that the code for INT 2A/AX=8001h
  3807.               and INT 2A/AX=8002h have been modified for Windows
  3808.     AX = 0004h get VM ID byte
  3809.         Return: CF clear if successful
  3810.             ES:DI -> VM ID byte
  3811.             CF set on error
  3812.         Note:   this function fails if the INT 2A modifications have not
  3813.               yet been applied
  3814.     AX = 0005h inform Windows of possible media change
  3815.         BL = drive number (00h=A:)
  3816.         Return: CF clear if successful
  3817.             CF set on error
  3818.  
  3819. (Table 1304)
  3820. Call VADMAD entry point with:
  3821.     DX = operation
  3822.         0000h set VADMAD mode
  3823.         AX = desired mode
  3824.         0001h set VADMAD channel
  3825.         AX = desired channel
  3826. Note:    after setting mode/channel, start the DMA operation with an OUT to
  3827.       I/O port 0Bh (channels 0-3) or D6h (channels 4-7)
  3828.  
  3829. (Table 1305)
  3830. Call VbillD entry point with:
  3831.     AX = function
  3832.         0001h set reverse video
  3833.         0002h set normal video
  3834. Return: ???
  3835. --------W-2F1685-----------------------------
  3836. INT 2F - MS Windows - SWITCH VMs AND CALLBACK
  3837.     AX = 1685h
  3838.     BX = VM ID of virtual machine to switch to
  3839.     CX = flags (see #1306)
  3840.     DX:SI = priority boost (see VMM.INC)
  3841.     ES:DI -> FAR procedure to callback
  3842. Return: CF set on error
  3843.         AX = error code
  3844.         01h invalid VM ID
  3845.         02h invalid priority boost
  3846.         03h invalid flags
  3847.     CF clear if successful
  3848.         event will be or has been called
  3849. Notes:    some DOS devices, such as networks, need to call functions in a
  3850.       specific VM. This call forces the appropriate VM to be installed.
  3851.     the callback procedure must preserve all registers and return with IRET
  3852. SeeAlso: AX=1683h,INT 15/AX=1117h
  3853.  
  3854. Bitfields for VM switching flags:
  3855. Bit(s)    Description    (Table 1306)
  3856.  0    wait until interrupts enabled
  3857.  1    wait until critical section unowned
  3858.  2-15    reserved (zero)
  3859. --------E-2F1686-----------------------------
  3860. INT 2F - DOS Protected-Mode Interface - DETECT MODE
  3861.     AX = 1686h
  3862. Return: AX = 0000h if operating in protected mode under DPMI (INT 31 available)
  3863.     AX nonzero if in real/V86 mode or no DPMI (INT 31 not available)
  3864. SeeAlso: AX=1687h
  3865. --------E-2F1687-----------------------------
  3866. INT 2F - DOS Protected-Mode Interface - INSTALLATION CHECK
  3867.     AX = 1687h
  3868. Return: AX = 0000h if installed
  3869.         BX = flags
  3870.         bit 0: 32-bit programs supported
  3871.         CL = processor type (02h=80286, 03h=80386, 04h=80486)
  3872.         DH = DPMI major version
  3873.         DL = two-digit DPMI minor version (binary)
  3874.         SI = number of paragraphs of DOS extender private data
  3875.         ES:DI -> DPMI mode-switch entry point
  3876.     AX nonzero if not installed
  3877. SeeAlso: AX=1686h,AX=43E0h,AX=DE01h/BX=4450h,AX=FB42h/BX=0001h
  3878. SeeAlso: INT 31/AX=0400h,INT 31/AX=5702h,INT 38/AH=10h
  3879.  
  3880. (Table 1307)
  3881. Call DPMI mode switch entry point with:
  3882.     AX = flags
  3883.         bit 0: set if 32-bit program
  3884.     ES = real mode segment of buffer for DPMI private data (ignored if
  3885.         SI was zero)
  3886. Return: CF set on error
  3887.         program still in real mode
  3888.         AX = error code (DPMI 1.0+)
  3889.            8011h unable to allocate all necessary descriptors
  3890.            8021h 32-bit program specified, but 16-bit DPMI host
  3891.     CF clear if successful
  3892.         CS = 16-bit selector corresponding to real-mode CS
  3893.         SS = selector corresponding to real-mode SS (64K limit)
  3894.         DS = selector corresponding to real-mode DS (64K limit)
  3895.         ES = selector to program's PSP (100h byte limit)
  3896.         FS = GS = 0
  3897.         high word of ESP = 0 if 32-bit program
  3898.         program now in protected mode
  3899. Note:    this entry point is only called for the initial switch to protected
  3900.       mode
  3901. --------W-2F1688-----------------------------
  3902. INT 2F U - MS Windows 3.0, 386MAX v6.01 - GET SELECTOR TO LDT
  3903.     AX = 1688h
  3904. Return: AX = status??? (0000h for 386MAX)
  3905.     BX = selector for LDT???
  3906. --------W-2F1689-----------------------------
  3907. INT 2F U - MS Windows 3.0+ - KERNEL IDLE CALL
  3908.     AX = 1689h
  3909.     ???
  3910. Return: ???
  3911. SeeAlso: AX=1680h,INT 15/AX=1000h,INT 28
  3912. --------E-2F168A-----------------------------
  3913. INT 2F - DPMI 0.9+ - GET VENDOR-SPECIFIC API ENTRY POINT
  3914.     AX = 168Ah
  3915.     DS:(E)SI = selector:offset of ASCIZ vendor name
  3916. Return: AL = status
  3917.         00h successful
  3918.            ES:(E)DI -> extended API entry point
  3919.         8Ah unsuccessful
  3920. Notes:    the vendor name is used to determine which entry point to return; it is
  3921.       case-sensitive
  3922.     available in protected mode only
  3923.     32-bit applications use ESI and EDI, 16-bit applications use SI and DI
  3924.     this call is present but not documented for DPMI 0.9
  3925.     the Borland C++ 3.1 DPMILOAD does not handle requests for entry points
  3926.       other than the MS-DOS one gracefully, producing an unhandled
  3927.       exception report; this has been fixed in the Borland Pascal 7 version
  3928. SeeAlso: INT 31/AX=0A00h,INT 31/AH=57h
  3929.  
  3930. (Table 1308)
  3931. Values for DPMI vendor-specific API names:
  3932.  "MS-DOS"    ??? and 386MAX v6.00+
  3933.  "386MAX"    386MAX v6.00+
  3934.  "HELIX_DPMI"    Helix Netroom's DPMI server
  3935.  "Phar Lap"    Phar Lap 286|DOS-Extender RUN286
  3936.  
  3937. (Table 1309)
  3938. Call Phar Lap RUN286 entry point with:
  3939.     AX = 0000h (function "load MSW")
  3940.     BX = new value for MSW register (low word of CR0)
  3941. Return: ???
  3942. --------W-2F168B-----------------------------
  3943. INT 2F - MS Windows 3.1 - SET FOCUS TO SPECIFIED VIRTUAL MACHINE
  3944.     AX = 168Bh
  3945.     BX = virtual machine ID (see AX=1683h), 0000h for current DOS box
  3946. Return: AL = 00h if focus set to specified VM
  3947. Notes:    documented on the Microsoft Developer's Network CD-ROM
  3948.     if the VM is a windowed DOS box, it will be set to full screen
  3949. SeeAlso: AX=1683h
  3950. --------W-2F168C-----------------------------
  3951. INT 2F - MS Windows 3.1 - RESTART COMMAND
  3952.     AX = 168Ch
  3953.     ???
  3954. Return: ???
  3955. Note:    WIN.COM executes specified application
  3956. --------W-2F1700-----------------------------
  3957. INT 2F - MS Windows "WINOLDAP" - IDENTIFY WinOldAp VERSION
  3958.     AX = 1700h
  3959. Return: AX = 1700h if this version of WINOLDAP doesn't support clipboard
  3960.     AX <> 1700h
  3961.         AL = WINOLDAP major version
  3962.         AH = WINOLDAP minor version
  3963. Program: WinOldAp (WINOLDAP.MOD) is a Microsoft Windows extension supporting
  3964.       "old" (character-mode) application access to Dynamic Data Exchange,
  3965.       menus, and the Windows clipboard.
  3966. Note:    this installation check DOES NOT follow the format used by other
  3967.       software of returning AL=FFh
  3968. SeeAlso: AX=1701h,AX=4601h
  3969. Index:    installation check;WINOLDAP
  3970. --------W-2F1701-----------------------------
  3971. INT 2F - MS Windows "WINOLDAP" - OPEN CLIPBOARD
  3972.     AX = 1701h
  3973. Return: AX = status
  3974.         nonzero success
  3975.         0000h   clipboard is already open
  3976. SeeAlso: AX=1700h,AX=1702h,AX=1703h,AX=1704h
  3977. --------W-2F1702-----------------------------
  3978. INT 2F - MS Windows "WINOLDAP" - EMPTY CLIPBOARD
  3979.     AX = 1702h
  3980. Return: AX = status
  3981.         nonzero clipboard has been emptied
  3982.         0000h   failure
  3983. SeeAlso: AX=1700h,AX=1701h,AX=1703h,AX=1704h
  3984. --------W-2F1703-----------------------------
  3985. INT 2F - MS Windows "WINOLDAP" - SET CLIPBOARD DATA
  3986.     AX = 1703h
  3987.     DX = clipboard format supported by WinOldAp (see #1310)
  3988.     ES:BX -> data (see #1311,#1312)
  3989.     SI:CX = size of data
  3990. Return: AX = status
  3991.         nonzero data copied into the Clipboard
  3992.         0000h   failure
  3993.  
  3994. (Table 1310)
  3995. Values for WinOldAp clipboard format:
  3996.  01h    text
  3997.  02h    bitmap
  3998.  03h    metafile picture
  3999.  04h    SYLK
  4000.  05h    DIF
  4001.  06h    TIFF
  4002.  07h    OEM text
  4003.  81h    DSP text
  4004.  82h    DSP bitmap
  4005.  
  4006. Format of Windows Clipboard bitmap:
  4007. Offset    Size    Description    (Table 1311)
  4008.  00h    WORD    type (0000h)
  4009.  02h    WORD    width of bitmap in pixels
  4010.  04h    WORD    height of bitmap in pixels
  4011.  06h    WORD    bytes per line
  4012.  08h    BYTE    number of color planes
  4013.  09h    BYTE    number of adjacent color bits in pixel
  4014.  0Ah    DWORD    pointer to start of data
  4015.  0Eh    WORD    width in 0.1mm units
  4016.  10h    WORD    height in 0.1mm units
  4017.  12h  N BYTEs    bitmap data
  4018.  
  4019. Format of Windows metafile picture:
  4020. Offset    Size    Description    (Table 1312)
  4021.  00h    WORD    mapping mode
  4022.  02h    WORD    X extent
  4023.  04h    WORD    Y extent
  4024.  06h    WORD    picture data
  4025. --------W-2F1704-----------------------------
  4026. INT 2F - MS Windows "WINOLDAP" - GET CLIPBOARD DATA SIZE
  4027.     AX = 1704h
  4028.     DX = clipboard format supported by WinOldAp (see #1310)
  4029. Return:    DX:AX = size of data in bytes, including any headers
  4030.         0000h:0000h if no data in this format in the Clipboard
  4031. Note:    Windows reportedly rounds up the size of the data to a multiple of 32
  4032.       bytes
  4033. --------W-2F1705-----------------------------
  4034. INT 2F - MS Windows "WINOLDAP" - GET CLIPBOARD DATA
  4035.     AX = 1705h
  4036.     DX = clipboard format supported by WinOldAp (see #1310)
  4037.     ES:BX -> buffer
  4038. Return: AX = status
  4039.         nonzero success
  4040.         0000h   error, or no data in this format in Clipboard
  4041. --------W-2F1708-----------------------------
  4042. INT 2F - MS Windows "WINOLDAP" - CloseClipboard
  4043.     AX = 1708h
  4044. Return: AX = status
  4045.         0000h failure
  4046.         nonzero success
  4047. --------W-2F1709-----------------------------
  4048. INT 2F - MS Windows "WINOLDAP" - COMPACT CLIPBOARD
  4049.     AX = 1709h
  4050.     SI:CX = desired size in bytes
  4051. Return: DX:AX = number of bytes in largest block of free memory
  4052. Note:    WinOldAp is responsible for including the size of any headers
  4053. --------W-2F170A-----------------------------
  4054. INT 2F - MS Windows "WINOLDAP" - GET DEVICE CAPABILITIES
  4055.     AX = 170Ah
  4056.     DX = GDI information index (see #1313)
  4057. Return: AX = integer value of the desired item
  4058.           (see #1314,#1315,#1316,#1317,#1318,#1319,#1320)
  4059. Note:    This function returns the device-capability bits for the given display
  4060.  
  4061. (Table 1313)
  4062. Values for GDI information index:
  4063.  00h    device driver version
  4064.  02h    device classification
  4065.  04h    width in mm
  4066.  06h    height in mm
  4067.  08h    width in pixels
  4068.  0Ah    height in pixels
  4069.  0Ch    bits per pixel
  4070.  0Eh    number of bit planes
  4071.  10h    number of brushes supported by device
  4072.  12h    number of pens supported by device
  4073.  14h    number of markers supported by device
  4074.  16h    number of fonts supported by device
  4075.  18h    number of colors
  4076.  1Ah    size required for device descriptor
  4077.  1Ch    curve capabilities
  4078.  1Eh    line capabilities
  4079.  20h    polygon capabilities
  4080.  22h    text capabilities
  4081.  24h    clipping capabilities
  4082.  26h    bitblt capabilities
  4083.  28h    X aspect
  4084.  2Ah    Y aspect
  4085.  2Ch    length of hypotenuse of aspect
  4086.  58h    logical pixels per inch of width
  4087.  5Ah    logical pixels per inch of height
  4088. SeeAlso: #1314,#1315,#1316,#1317,#1318,#1319,#1320
  4089.  
  4090. (Table 1314)
  4091. Values for device classification:
  4092.  00h    vector plotter
  4093.  01h    raster display
  4094.  02h    raster printer
  4095.  03h    raster camera
  4096.  04h    character-stream, PLP
  4097.  05h    Metafile, VDM
  4098.  06h    display-file
  4099. SeeAlso: #1313,#1315,#1316,#1317,#1318,#1319,#1320
  4100.  
  4101. Bitfields for curve capabilities:
  4102. Bit(s)    Description    (Table 1315)
  4103.  0    circles
  4104.  1    pie wedges
  4105.  2    chord arcs
  4106.  3    ellipses
  4107.  4    wide lines
  4108.  5    styled lines
  4109.  6    wide styled lines
  4110.  7    interiors
  4111. SeeAlso: #1313,#1314,#1316,#1317,#1318,#1319,#1320
  4112.  
  4113. Bitfields for line capabilities:
  4114. Bit(s)    Description    (Table 1316)
  4115.  1    polylines
  4116.  2    markers
  4117.  3    polymarkers
  4118.  4    wide lines
  4119.  5    styled lines
  4120.  6    wide styled lines
  4121.  7    interiors
  4122. SeeAlso: #1313,#1314,#1315,#1317,#1318,#1319,#1320
  4123.  
  4124. Bitfields for polygon capabilities:
  4125. Bit(s)    Description    (Table 1317)
  4126.  0    polygons
  4127.  1    rectangles
  4128.  2    trapezoids
  4129.  3    scanlines
  4130.  4    wide borders
  4131.  5    styled borders
  4132.  6    wide styled borders
  4133.  7    interiors
  4134. SeeAlso: #1313,#1314,#1315,#1316,#1318,#1319,#1320
  4135.  
  4136. Bitfields for text capabilities:
  4137. Bit(s)    Description    (Table 1318)
  4138.  0    output precision character
  4139.  1    output precision stroke
  4140.  2    clippping precision stroke
  4141.  3    90-degree character rotation
  4142.  4    arbitrary character rotation
  4143.  5    independent X and Y scaling
  4144.  6    double-size
  4145.  7    integer scaling
  4146.  8    continuous scaling
  4147.  9    bold
  4148.  10    italic
  4149.  11    underline
  4150.  12    strikeout
  4151.  13    raster fonts
  4152.  14    vector fonts
  4153.  15    reserved
  4154. SeeAlso: #1313,#1314,#1315,#1316,#1317,#1319,#1320
  4155.  
  4156. (Table 1319)
  4157. Values for clipping capabilities:
  4158.  00h    none
  4159.  01h    clipping to rectangles
  4160. SeeAlso: #1313,#1314,#1315,#1316,#1317,#1318,#1320
  4161.  
  4162. Bitfields for raster capabilities:
  4163. Bit(s)    Description    (Table 1320)
  4164.  0    simple bitBLT
  4165.  1    device requires banding support
  4166.  2    device requires scaling support
  4167.  3    supports >64K bitmap
  4168. SeeAlso: #1313,#1314,#1315,#1316,#1317,#1318,#1319
  4169. ----------2F18-------------------------------
  4170. INT 2F U - MS-Manager
  4171.     AH = 18h
  4172.     ???
  4173. Return: ???
  4174. --------l-2F1900-----------------------------
  4175. INT 2F U - DOS 4.x only SHELLB.COM - INSTALLATION CHECK
  4176.     AX = 1900h
  4177. Return: AL = status
  4178.         00h not installed
  4179.         FFh installed
  4180. --------l-2F1901-----------------------------
  4181. INT 2F U - DOS 4.x only SHELLB.COM - SHELLC.EXE INTERFACE
  4182.     AX = 1901h
  4183.     BL = SHELLC type
  4184.         00h transient
  4185.         01h resident
  4186.     DS:DX -> far call entry point for resident SHELLC.EXE
  4187. Return: ES:DI -> SHELLC.EXE workspace within SHELLB.COM
  4188. Note:    SHELLB.COM and SHELLC.EXE are parts of the DOS 4.x shell
  4189. --------l-2F1902-----------------------------
  4190. INT 2F U - DOS 4.x only SHELLB.COM - COMMAND.COM INTERFACE
  4191.     AX = 1902h
  4192.     ES:DI -> ASCIZ full filename of current batch file, with at least the
  4193.           final filename element uppercased
  4194.     DS:DX -> buffer for results
  4195. Return: AL = 00h  failed, either
  4196.         (a) final filename element quoted at ES:DI does not match
  4197.               identity of shell batch file quoted as parameter of most
  4198.               recent call of SHELLB command, or
  4199.         (b) no more Program Start Commands available.
  4200.     AL= FFh     success, then:
  4201.         memory at DS:[DX+1] onwards filled as:
  4202.         DX+1:    BYTE    count of bytes of PSC
  4203.         DX+2: N BYTEs    Program Start Command text
  4204.             BYTE    0Dh terminator
  4205. Desc:    COMMAND.COM executes the result of this call in preference to
  4206.       reading a command from a batch file.    Thus the batch file does not
  4207.       advance in execution for so long as SHELLB provides PSCs from its
  4208.       workspace.
  4209. Note:    The PSCs are planted in SHELLB workspace by SHELLC, the user
  4210.       menu interface.  The final PSC of a sequence is finished with a
  4211.       GOTO COMMON, which causes a loop back in the batch file which called
  4212.       SHELLC so as to execute SHELLC again.     The check on batch file name
  4213.       permits PSCs to CALL nested batch files while PSCs are still stacked
  4214.       up for subsequent execution.
  4215. --------l-2F1903-----------------------------
  4216. INT 2F U - DOS 4.x only SHELLB.COM - COMMAND.COM interface
  4217.     AX = 1903h
  4218.     ES:DI -> ASCIZ batch file name as for AX=1902h
  4219. Return: AL = status
  4220.         FFh quoted batch file name matches last SHELLB parameter
  4221.         00h it does not
  4222. --------l-2F1904-----------------------------
  4223. INT 2F U - DOS 4.x only SHELLB.COM - SHELLB transient to TSR intrface
  4224.     AX = 1904h
  4225. Return: ES:DI -> name of current shell batch file:
  4226.         WORD    number of bytes of name following
  4227.         BYTEs    (8 max) uppercase name of shell batch file
  4228. --------V-2F1A00-----------------------------
  4229. INT 2F - DOS 4+ ANSI.SYS - INSTALLATION CHECK
  4230.     AX = 1A00h
  4231. Return: AL = FFh if installed
  4232. Notes:    AVATAR.SYS also responds to this call
  4233.     documented for DOS 5+, but undocumented for DOS 4.x
  4234. --------V-2F1A00BX414E-----------------------
  4235. INT 2F - ANSIPLUS.SYS - INSTALLATION CHECK
  4236.     AX = 1A00h
  4237.     BX = 414Eh ('AN')
  4238.     CX = 5349h ('SI')
  4239.     DX = 2B2Bh ('++')
  4240. Return: AL = FFh if installed
  4241.         CF clear
  4242.         ES:BX -> INT 29 entry point
  4243. Program: ANSIPLUS.SYS is a CON device driver by Kristofer Sweger which
  4244.       replaces the normal ANSI.SYS is a more powerful version with many
  4245.       additional features
  4246. Note:    ANSIPLUS also identifies itself as ANSI.SYS if BX,CX, or DX differ
  4247.       from the magic values above
  4248. --------V-2F1A00BX4156-----------------------
  4249. INT 2F - AVATAR.SYS - INSTALLATION CHECK
  4250.     AX = 1A00h
  4251.     BX = 4156h ('AV')
  4252.     CX = 4154h ('AT')
  4253.     DX = 4152h ('AR')
  4254. Return: AL = FFh if installed
  4255.         CF clear
  4256.         BX = AVATAR protocol level supported
  4257.         CX = driver type
  4258.         0000h AVATAR.SYS
  4259.         4456h DVAVATAR.COM inside DESQview window
  4260.         DX = 0016h
  4261. Program: AVATAR.SYS is a CON replacement by George Adam Stanislav which
  4262.       interprets AVATAR command codes in the same way that ANSI interprets
  4263.       ANSI command codes
  4264. Notes:    AVATAR also identifies itself as ANSI.SYS if BX, CX, or DX differ from
  4265.       the magic values
  4266. --------V-2F1A01-----------------------------
  4267. INT 2F U - DOS 4+ ANSI.SYS internal - GET/SET DISPLAY INFORMATION
  4268.     AX = 1A01h
  4269.     CL = function
  4270.         7Fh for GET
  4271.         5Fh for SET
  4272.     DS:DX -> parm block as for INT 21,AX=440Ch,CX=037Fh/035Fh respectively
  4273. Return: CF set on error
  4274.         AX = error code (many non-standard)
  4275.     CF clear if successful
  4276.         AX destroyed
  4277. Note:    presumably this is the DOS IOCTL interface to ANSI.SYS
  4278. SeeAlso: AX=1A02h,INT 21/AX=440Ch
  4279. --------V-2F1A02-----------------------------
  4280. INT 2F U - DOS 4+ ANSI.SYS internal - MISCELLANEOUS REQUESTS
  4281.     AX = 1A02h
  4282.     DS:DX -> parameter block (see #1321)
  4283. Note:    DOS 5+ chains to previous handler if AL > 02h on call
  4284. SeeAlso: AX=1A01h
  4285.  
  4286. Format of ANSI.SYS parameter block:
  4287. Offset    Size    Description    (Table 1321)
  4288.  00h    BYTE    subfunction
  4289.         00h set/reset interlock
  4290.         01h get /L flag
  4291.  01h    BYTE    interlock state
  4292.         00h=reset, 01h=set
  4293.           This interlock prevents some of the ANSI.SYS post-processing
  4294.           in its hook onto INT 10, AH=00h mode set
  4295.  02h    BYTE    (returned)
  4296.         00h if /L not in effect
  4297.         01h if /L in effect
  4298. --------V-2F1A21-----------------------------
  4299. INT 2F - AVATAR.SYS - SET DRIVER STATE
  4300.     AX = 1A21h (AL='!')
  4301.     DS:SI -> command string with one or more state characters (see #1322)
  4302.     CX = length of command string
  4303. Return: CF set on error (invalid subfunction)
  4304.     CF clear if successful
  4305. Note:    the characters in the state string are interpreted left to right, and
  4306.       need not be in any particular order
  4307. SeeAlso: AX=1A3Fh
  4308.  
  4309. (Table 1322)
  4310. Values for AVATAR.SYS state characters:
  4311.  'a'    activate driver
  4312.  'd'    disable driver
  4313.  'f'    use fast screen output
  4314.  'g'    always convert gray keys (+ and -) to function keys
  4315.  'G'    never convert gray keys
  4316.  'l'    convert gray keys only when ScrollLock active
  4317.  's'    use slow screen output
  4318.  't'    Tandy 1000 keyboard (not yet implemented)
  4319. --------V-2F1A3C-----------------------------
  4320. INT 2F U - AVATAR.SYS v0.11 - ???
  4321.     AX = 1A3Ch
  4322.     ???
  4323. Return: CX = 0000h
  4324. --------V-2F1A3E-----------------------------
  4325. INT 2F U - AVATAR.SYS v0.11 - ???
  4326.     AX = 1A3Eh
  4327.     CL = ???
  4328.     CH = ???
  4329.     DL = ???
  4330.     DH = ???
  4331. Return: CL = ???
  4332.     CH = ???
  4333.     DL = ???
  4334.     DH = ???
  4335. --------V-2F1A3F-----------------------------
  4336. INT 2F - AVATAR.SYS - QUERY DRIVER STATE
  4337.     AX = 1A3Fh (AL='?')
  4338.     ES:DI -> buffer
  4339.     CX = length of buffer in bytes
  4340. Return: CF clear
  4341.     CX = actual size of returned info
  4342. Note:    the returned information consists of multiple letters whose meanings
  4343.       are described under AX=1A21h
  4344. SeeAlso: AX=1A21h
  4345. --------S-2F1A42BX4156-----------------------
  4346. INT 2F - AVATAR Serial Dispatcher - INSTALL IRQ3 HANDLER
  4347.     AX = 1A42h
  4348.     BX = 4156h ('AV')
  4349.     ES:DI -> FAR handler for serial port using IRQ3
  4350.     DS = data segment needed by handler
  4351. Return: AX = status/return value
  4352.         0000h if no more room
  4353.         1A42h if ASD not installed
  4354.         else handle to use when uninstalling
  4355. Notes:    the handler need not save/restore registers or signal EOI to the
  4356.       interrupt controller
  4357.     the handler should return AX=0000h if the interrupt was meant for it,
  4358.       and either leave AX unchanged or return a non-zero value otherwise
  4359.     the most recently installed handler will be called first, continuing
  4360.       to earlier handlers until one returns AX=0000h
  4361. SeeAlso: AX=1A43h,AX=1A62h
  4362. --------S-2F1A43BX4156-----------------------
  4363. INT 2F - AVATAR Serial Dispatcher - INSTALL IRQ4 HANDLER
  4364.     AX = 1A43h
  4365.     BX = 4156h ('AV')
  4366.     ES:DI -> FAR handler for serial port using IRQ4
  4367.     DS = data segment needed by handler
  4368. Return: AX = status/return value
  4369.         0000h if no more room
  4370.         1A43h if ASD not installed
  4371.         else handle to use when uninstalling
  4372. Notes:    (see AX=1A42h)
  4373. SeeAlso: AX=1A42h,AX=1A63h
  4374. --------V-2F1A44BX4156-----------------------
  4375. INT 2F - AVATAR.SYS v0.11+ - GET DATA SEGMENT
  4376.     AX = 1A44h
  4377.     BX = 4156h ('AV')
  4378. Return: AX = 0000h
  4379.     DS = data segment
  4380.     CX = size of data segment
  4381. Note:    AVATAR.SYS calls this function whenever it is invoked.    If each
  4382.       process under a multitasker hooks this function and provides a
  4383.       separate data segment, AVATAR.SYS becomes fully reentrant.
  4384. SeeAlso: AX=1A21h,AX=1A3Fh
  4385. --------V-2F1A52-----------------------------
  4386. INT 2F U - AVATAR.SYS v0.11 - GET ???
  4387.     AX = 1A52h
  4388.     CX = size of buffer
  4389.     ES:DI -> buffer
  4390. Return: ??? copied into user buffer
  4391. Note:    the maximum size of the data which may be copied is returned by
  4392.       AX=1A72h
  4393. SeeAlso: AX=1A72h
  4394. --------V-2F1A53-----------------------------
  4395. INT 2F U - AVATAR.SYS v0.11 - ???
  4396.     AX = 1A53h
  4397.     CL = ??? (00h-05h)
  4398.     ???
  4399. Return: ???
  4400. --------S-2F1A62BX4156-----------------------
  4401. INT 2F - AVATAR Serial Dispatcher - UNINSTALL IRQ3 HANDLER
  4402.     AX = 1A62h
  4403.     BX = 4156h ('AV')
  4404.     CX = handle for IRQ routine returned by AX=1A42h
  4405. SeeAlso: AX=1A42h,AX=1A63h
  4406. --------S-2F1A63BX4156-----------------------
  4407. INT 2F - AVATAR Serial Dispatcher - UNINSTALL IRQ4 HANDLER
  4408.     AX = 1A63h
  4409.     BX = 4156h ('AV')
  4410.     CX = handle for IRQ routine returned by AX=1A43h
  4411. SeeAlso: AX=1A43h,AX=1A62h
  4412. --------V-2F1A72-----------------------------
  4413. INT 2F U - AVATAR.SYS v0.11 - GET ??? SIZE
  4414.     AX = 1A72h
  4415. Return: CX = maximum size of ???
  4416. SeeAlso: AX=1A52h
  4417. --------V-2F1A7B-----------------------------
  4418. INT 2F U - AVATAR.SYS v0.11 - ???
  4419.     AX = 1A7Bh
  4420. Return: AX = 0000h
  4421.     CX = 0000h
  4422. --------V-2F1A7D-----------------------------
  4423. INT 2F U - AVATAR.SYS v0.11 - ???
  4424.     AX = 1A7Dh
  4425. Return: AX = ???
  4426. --------V-2F1AADDX0000-----------------------
  4427. INT 2F U - AVATAR.SYS v0.11 - ???
  4428.     AX = 1AADh
  4429.     DX = 0000h
  4430.     CX = subfunction (00h-0Ch)
  4431.     ???
  4432. Return: AX = 0000h if DX was nonzero
  4433.     ???
  4434. --------m-2F1B00-----------------------------
  4435. INT 2F U - DOS 4+ XMA2EMS.SYS extension internal - INSTALLATION CHECK
  4436.     AX = 1B00h
  4437. Return: AL = FFh if installed
  4438. Note:    XMA2EMS.SYS extension is only installed if DOS has page frames to hide.
  4439.     This extension hooks onto INT 67/AH=58h and returns from that call data
  4440.       which excludes the physical pages being used by DOS.
  4441. SeeAlso: AH=1Bh"FRAME INFO"
  4442. --------m-2F1B-------------------------------
  4443. INT 2F U - DOS 4+ XMA2EMS.SYS extension internal - GET HIDDEN FRAME INFORMATION
  4444.     AH = 1Bh
  4445.     AL <> 00h
  4446.     DI = hidden physical page number
  4447. Return: AX = FFFFh if failed (no such hidden page)
  4448.     AX = 0000h if OK, then
  4449.         ES = segment of page frame
  4450.         DI = physical page number
  4451. Notes:    this corresponds to the data edited out of the INT 67/AH=58h call
  4452.     FASTOPEN makes this call with AL = FFh
  4453. SeeAlso: AX=1B00h
  4454. --------V-2F2300-----------------------------
  4455. INT 2F - DR-DOS 5.0 GRAFTABL - INSTALLATION CHECK
  4456.     AX = 2300h
  4457. Return: AH = FFh
  4458. Note:    this installation check does not follow the usual format
  4459. SeeAlso: AH=23h,AX=2E00h
  4460. --------V-2F23-------------------------------
  4461. INT 2F - DR-DOS 5.0 GRAFTABL - GET GRAPHICS DATA
  4462.     AH = 23h
  4463.     AL nonzero
  4464. Return: AH = FFh
  4465.     ES:BX -> graphics data (8 bytes for each character from 80h to FFh)
  4466. SeeAlso: AX=2300h,AX=2E00h
  4467. --------T-2F2700-----------------------------
  4468. INT 2F - DR-DOS 6.0 TaskMAX - INSTALLATION CHECK
  4469.     AX = 2700h
  4470. Return: AL = status
  4471.         00h not installed
  4472.         FFh installed
  4473. --------T-2F2701-----------------------------
  4474. INT 2F - DR-DOS 6.0 TaskMAX - GET STATUS
  4475.     AX = 2701h
  4476. Return: AX = maximum simultaneous tasks
  4477.     BX = index into TASK_IDS of current foreground task
  4478.     CX = currently-active tasks
  4479.     DX = version number (DL = major, DH = minor)
  4480.         (DR-DOS 6.0 = 0001h, Novell DOS 7 = 0002h)
  4481.     ES:SI -> TASK_IDS
  4482.     ES:DI -> name table (array of 8-byte names, NUL-terminated if <8 chars)
  4483. Notes:    do not attempt to create a new task if CX == AX
  4484.     the task's index is its position on the task menu, while its ID is the
  4485.       position within the internal task name table
  4486. SeeAlso: AX=2714h,AX=2716h
  4487. --------T-2F2702-----------------------------
  4488. INT 2F - DR-DOS 6.0 TaskMAX - GET PER-TASK EMS LIMIT
  4489.     AX = 2702h
  4490. Return: DX = maximum pages INT 67/AH=42h will report available
  4491. Note:    TaskMAX does not limit EMS allocations other than by limiting the
  4492.       amount which is reported as being available at a given time
  4493. SeeAlso: AX=2703h,INT 67/AH=42h
  4494. --------T-2F2703-----------------------------
  4495. INT 2F - DR-DOS 6.0 TaskMAX - SET PER-TASK EMS LIMIT
  4496.     AX = 2703h
  4497.     DX = maximum pages INT 67/AH=42h should report available
  4498. Return: DX = new maximum for reporting
  4499. SeeAlso: AX=2702h,INT 67/AH=42h
  4500. --------T-2F2704-----------------------------
  4501. INT 2F - DR-DOS 6.0 TaskMAX - REGISTER/UNREGISTER TASK MANAGER
  4502.     AX = 2704h
  4503.     DL = subfunction
  4504.         00h unregister task manager
  4505.         01h register task manager
  4506. Return: DL = status
  4507.         00h registered
  4508.         01h unregistered
  4509. Notes:    a task manager replaces TaskMAX's menu system with its own user
  4510.       interface; while one is registered, the TaskMAX hotkeys and
  4511.       Ctrl-Alt-Del invoke the manager rather than the built-in menu system
  4512.     unregister the task manager before terminating it
  4513. SeeAlso: AX=2705h
  4514. Index:    hotkeys;TaskMAX
  4515. --------T-2F2705-----------------------------
  4516. INT 2F - DR-DOS 6.0 TaskMAX - ENABLE/DISABLE DIRECT SWITCHING
  4517.     AX = 2705h
  4518.     DL = subfunction
  4519.         00h disable keystrokes for switching to next/prev/specified task
  4520.         01h enable
  4521. Return: nothing
  4522. Note:    should only be called by a registered task manager (see AX=2704h)
  4523. SeeAlso: AX=2704h,AX=2706h
  4524. --------T-2F2706-----------------------------
  4525. INT 2F - DR-DOS 6.0 TaskMAX - SWITCH TO SPECIFIED TASK
  4526.     AX = 2706h
  4527.     DX = task index (see AX=2701h) of task to be activated
  4528. Return: DX = task index of previously-active task
  4529. SeeAlso: AX=2705h,AX=2707h,AX=2715h
  4530. --------T-2F2707-----------------------------
  4531. INT 2F - DR-DOS 6.0 TaskMAX - CREATE NEW TASK
  4532.     AX = 2707h
  4533.     DS:DX -> ASCIZ pathname of executable
  4534.     ES:BX -> parameter block (see #1323)
  4535.     CX = number of ticks before automatic return to task manager
  4536.         (0000h = run until termination or explicitly switched)
  4537. Return: DX = new task's task index (FFFFh if task terminated)
  4538. SeeAlso: AX=2706h,AX=2708h
  4539.  
  4540. Format of TaskMAX parameter block:
  4541. Offset    Size    Description    (Table 1323)
  4542.  00h    WORD    reserved, should be 0000h
  4543.  02h    DWORD    pointer to command tail to be copied into child's PSP
  4544.  06h    DWORD    pointer to first FCB to be copied into child's PSP
  4545.  0Ah    DWORD    pointer to second FCB to be copied into child's PSP
  4546. --------T-2F2708-----------------------------
  4547. INT 2F - DR-DOS 6.0 TaskMAX - DELETE TASK
  4548.     AX = 2708h
  4549.     DX = task index
  4550. Return: DX = FFFFh (task deleted)
  4551. Notes:    this call should only be used for abnormal task termination, after
  4552.       first checking for open files with AX=270Ch; should not be used
  4553.       with programs that allocate EMS or XMS memory
  4554.     switches to specified task first
  4555. SeeAlso: AX=2707h
  4556. --------T-2F2709-----------------------------
  4557. INT 2F - DR-DOS 6.0 TaskMAX - NAME TASK
  4558.     AX = 2709h
  4559.     DX = task index
  4560.     DS:SI -> 8-byte name (8 NULs = remove name)
  4561. Return: AL = task flags
  4562.         00h ID unused or task terminated
  4563.         01h ID in use, task name table entry valid
  4564.         81h ID in use, task name fixed
  4565.     BX = task ID
  4566.     ES:DI -> name in task name table (see AX=2701h)
  4567. Note:    the task retains the given name until it terminates or the name is
  4568.       removed by specifying a name of 8 NULs.
  4569. SeeAlso: AX=2701h,AX=2707h
  4570. --------T-2F270A-----------------------------
  4571. INT 2F - DR-DOS 6.0 TaskMAX - CONVERT TASK INDEX TO TASK ID
  4572.     AX = 270Ah
  4573.     DX = task index
  4574. Return: DX = task ID (FFFFh if index invalid)
  4575. Note:    task IDs stay constant, while indexes can change when other tasks are
  4576.       deleted
  4577. SeeAlso: AX=2701h,AX=270Bh
  4578. --------T-2F270B-----------------------------
  4579. INT 2F - DR-DOS 6.0 TaskMAX - CONVERT TASK ID TO TASK INDEX
  4580.     AX = 270Bh
  4581.     DX = task ID
  4582. Return: DX = task index (FFFFh if task not active)
  4583. SeeAlso: AX=270Ah
  4584. --------T-2F270C-----------------------------
  4585. INT 2F - DR-DOS 6.0 TaskMAX - CHECK OPEN FILES
  4586.     AX = 270Ch
  4587.     DX = task index
  4588. Return: AX = number of files currently open for specified task
  4589. SeeAlso: AX=2708h
  4590. --------T-2F270D-----------------------------
  4591. INT 2F - DR-DOS 6.0 TaskMAX - CHECK IF TASK RUNNING PRIMARY COMMAND INTERPRETER
  4592.     AX = 270Dh
  4593.     DX = task index
  4594. Return: DX = status
  4595.         0000h if primary command interpreter (COMMAND.COM, etc.) running
  4596.         0001h if not in root shell for task
  4597. Note:    TaskMAX will return 0001h if the specified task has spawned another
  4598.       command interpreter with AX=2707h
  4599. SeeAlso: AX=2707h,AX=270Ch
  4600. --------T-2F270E-----------------------------
  4601. INT 2F - DR-DOS 6.0 TaskMAX - GET/SET TEXT PASTE LEAD-IN
  4602.     AX = 270Eh
  4603.     CX = length of string (max 15 keystrokes, 0000h to get current string)
  4604.     DS:SI -> pasting lead-in string (character/scan-code pairs)
  4605. Return: ES:DI -> current lead-in string
  4606. Note:    the specified sequence of keystrokes is sent to the application before
  4607.       every line of a text-mode spreadsheet paste
  4608. SeeAlso: AX=270Fh,AX=2710h,AX=2713h
  4609. --------T-2F270F-----------------------------
  4610. INT 2F - DR-DOS 6.0 TaskMAX - GET/SET NUMERIC PASTE LEAD-IN
  4611.     AX = 270Fh
  4612.     CX = length of string (max 15 keystrokes, 0000h to get current string)
  4613.     DS:SI -> pasting lead-in string (character/scan-code pairs)
  4614. Return: ES:DI -> current lead-in string
  4615. Note:    the specified sequence of keystrokes is sent to the application before
  4616.       every number in a numeric-mode spreadsheet paste
  4617. SeeAlso: AX=270Eh,AX=2710h,AX=2711h,AX=2713h
  4618. --------T-2F2710-----------------------------
  4619. INT 2F - DR-DOS 6.0 TaskMAX - GET/SET PASTE LINE TERMINATOR STRING
  4620.     AX = 2710h
  4621.     CX = length of string (max 15 keystrokes, 0000h to get current string)
  4622.     DS:SI -> pasting terminator string (character/scan-code pairs)
  4623. Return: ES:DI -> current terminator string
  4624. Note:    the specified sequence of keystrokes is sent to the application after
  4625.       every line of a spreadsheet paste operation
  4626. SeeAlso: AX=270Eh,AX=270Fh,AX=2713h
  4627. --------T-2F2711-----------------------------
  4628. INT 2F - DR-DOS 6.0 TaskMAX - GET/SET NUMERIC PASTE DECIMAL POINT
  4629.     AX = 2711h
  4630.     DX = ASCII code for separator (FFFFh to get current)
  4631. Return: DL = current separator character
  4632. SeeAlso: AX=270Fh
  4633. --------T-2F2712-----------------------------
  4634. INT 2F - DR-DOS 6.0 TaskMAX - INITIATE EXPORTING TASK DATA
  4635.     AX = 2712h
  4636.     DX = task index
  4637. --------T-2F2713-----------------------------
  4638. INT 2F - DR-DOS 6.0 TaskMAX - INITIATE PASTE OPERATION
  4639.     AX = 2713h
  4640.     DX = task index
  4641.     CX = paste mode
  4642.         0000h alphanumeric
  4643.         0001h numeric
  4644.         0002h text
  4645. SeeAlso: AX=270Eh,AX=270Fh,AX=2710h,AX=2711h
  4646. --------T-2F2714-----------------------------
  4647. INT 2F - DR-DOS 6.0 TaskMAX - GET SWAP SPACE INFO
  4648.     AX = 2714h
  4649. Return: CX = total KB of swap space
  4650.     DX = available KB of swap space
  4651. SeeAlso: AX=2701h
  4652. --------T-2F2715-----------------------------
  4653. INT 2F - DR-DOS 6.0 TaskMAX - SWITCH TO TASK MANAGER
  4654.     AX = 2715h
  4655. Return: only after calling task is again selected
  4656. SeeAlso: AX=2706h
  4657. --------T-2F2716-----------------------------
  4658. INT 2F - DR-DOS 6.0 TaskMAX - GET PASTE BUFFER STATUS
  4659.     AX = 2716h
  4660. Return: AX = 0000h if AX=2716h,AX=2717h,AX=2718h supported
  4661.         CX = bytes in paste buffer
  4662.         DX = current generation number (updated after every copy operation)
  4663. SeeAlso: AX=2701h,AX=2713h,AX=2714h,AX=2717h,AX=2718h
  4664. --------T-2F2717-----------------------------
  4665. INT 2F - DR-DOS 6.0 TaskMAX - PASTE DATA DIRECTLY TO APPLICATION BUFFER
  4666.     AX = 2717h
  4667.     CX = bytes in destination buffer
  4668.     ES:DI -> destination buffer
  4669. Return: AX = 0000h if function supported
  4670.         CX = bytes actually copied (FFFFh if buffer too small)
  4671.         DX = current generation number for paste buffer
  4672. Note:    the destination buffer may be too small if another task adds more data
  4673.       to the paste buffer after the AX=2716h call but before this call
  4674. SeeAlso: AX=2713h,AX=2716h,AX=2718h
  4675. --------T-2F2718-----------------------------
  4676. INT 2F - DR-DOS 6.0 TaskMAX - COPY DATA DIRECTLY INTO PASTE BUFFER
  4677.     AX = 2718h
  4678.     CX = bytes in source buffer
  4679.     DS:SI -> source buffer (plain ASCII, lines terminated with CR LF)
  4680. Return: AX = 0000h if function supported
  4681.         CX = bytes actually copied
  4682.         DX = current generation number for paste buffer
  4683. SeeAlso: AX=2712h,AX=2716h,AX=2717h
  4684. --------T-2F2719-----------------------------
  4685. INT 2F - Novell DOS 7 TaskMGR - NOP
  4686.     AX = 2719h to 271Bh
  4687. --------T-2F271C-----------------------------
  4688. INT 2F U - Novell DOS 7 TaskMGR - ???
  4689.     AX = 271Ch
  4690.     DX = ???
  4691.         bit 0: ???
  4692. Return: ???
  4693.     ---if DX bit 0 set---
  4694.     AX = 0031h
  4695.     CX = 0000h
  4696. BUG:    if the task switcher is running, and DX bit 0 is set on call, this
  4697.       function will crash because its exit code attempts to pop several
  4698.       registers which are not pushed when DX bit 0 is set
  4699. --------m-2F2780CL01-------------------------
  4700. INT 2F U - Novell DOS 7 - EMM386.EXE - MULTITASKING API
  4701.     AX = 2780h
  4702.     CL = 01h (function number)
  4703.     CH = subfunction
  4704.         00h unused
  4705.         Return: CX = status (0002h) (see #1324)
  4706.         01h unused
  4707.         Return: CX = status (0002h) (see #1324)
  4708.         02h ???
  4709.         BX = ??? (0005h-000Fh)
  4710.         Return: CX = status (0000h,0030h) (see #1324)
  4711.         03h allocate ???
  4712.         DX = ???
  4713.         Return: CX = status (0000h,0003h) (see #1324)
  4714.         04h get ???
  4715.         Return: CX = 0000h (successful)
  4716.             BX = selector for EMM386 data segment
  4717.             EBX high word cleared
  4718.         05h ???
  4719.         EDX = ???
  4720.         Return: ???
  4721.         06h return to real mode via triple fault
  4722.         07h debugger break
  4723.         Note:    calls INT 03, then INT 21/AH=02h to output a question
  4724.               mark
  4725.         08h get ???
  4726.         Return: CX = 0000h (successful)
  4727.             EBX = ??? (0 or 2)
  4728.         09h ???
  4729.         0Ah ???
  4730.         0Bh unused
  4731.         Return: CX = status (0002h) (see #1324)
  4732.         0Ch ??? manipulates DOS memory chain
  4733.         0Dh ???
  4734.         EBX = ???
  4735.         EDX = ???
  4736.         Return: ???
  4737.         0Eh ???
  4738.         Return: CX = 0000h (successful)
  4739.             BL = ???     \ or BX = 0000h
  4740.             BH = ???     /
  4741.         0Fh get ???
  4742.         Return: CX = 0000h (successful)
  4743.             EBX = ???
  4744.         10h get and set ???
  4745.         EDX = ???
  4746.         Return: CX = 0000h (successful)
  4747.             EBX = old value of ???
  4748.         11h get ???
  4749.         Return: CX = 0000h (successful)
  4750.             EBX = ??? (0100h)
  4751.         12h get and set ???
  4752.         DX = ???
  4753.         Return: CX = 0000h (successful)
  4754.             AX = old value of ???
  4755.         13h ???
  4756.         Return: CX = status (0000h,003Fh) (see #1324)
  4757.             AX = ???
  4758.         14h ???
  4759.         EDX = ???
  4760.         Return: CX = status (0000h,003Fh) (see #1324)
  4761.         15h ???
  4762.         BX = segment of ???
  4763.         Return: CX = 0000h (successful)
  4764.             BX = segment of ???
  4765.         16h ???
  4766.         17h ???
  4767.         EBX = subfunction (0-2)
  4768.         Return: CX = status (0002h if EBX>2) (see #1324)
  4769.             ???
  4770.         18h unused
  4771.         Return: CX = status (0002h) (see #1324)
  4772. Return: CX = status (most subfunctions)
  4773.     (E)AX and/or (E)BX contain return values, depending on function
  4774. Notes:    called by DPMS.EXE and EMM386.EXE
  4775.     this API is only available if AX=12FFh/BX=0EDCh returns successfully;
  4776.       because the request is handled on the initial trap to the memory
  4777.       manager caused by INT instructions, this API must be invoked with
  4778.       an actual INT 2F instruction instead of some simulation such as a
  4779.       far call to the address in the interrupt vector table
  4780. SeeAlso: AX=12FF/BX=0EDCh,AX=2780h/CL=02h,AX=2780h/CL=03h,AX=2780h/CL=04h
  4781.  
  4782. (Table 1324)
  4783. Values for Novell DOS 7 EMM386 function status:
  4784.  0000h    successful
  4785.  0001h    invalid function???
  4786.  0002h    invalid subfunction
  4787.  0003h    ???
  4788.  0004h    invalid ??? index
  4789.  0005h    ???
  4790.  0006h    ???
  4791.  0007h    ???
  4792.  0009h    ???
  4793.  000Ah    ???
  4794.  000Bh    invalid ??? handle
  4795.  000Ch    ???
  4796.  000Dh    ???
  4797.  000Eh    ???
  4798.  000Fh    ???
  4799.  0014h    ???
  4800.  0023h    ???
  4801.  0030h    ???
  4802.  003Fh    ???
  4803. --------m-2F2780CL02-------------------------
  4804. INT 2F U - Novell DOS 7 - EMM386.EXE - MULTITASKING API
  4805.     AX = 2780h
  4806.     CL = 02h (function number)
  4807.     CH = subfunction
  4808.         00h ???
  4809.         ???
  4810.         Return: CX = status (0000h,0023h, others???) (see #1324)
  4811.             BX = ??? (0000h if CX=0000h, FFFFh if CX=0023h)
  4812.         Note:    calls func 04h/sf 03h, func 04h/sf 1Eh,func 02h/sf 43h,
  4813.               func 02h/sf 0Bh, and func 04h/sf 01h
  4814.         01h get and clear ???
  4815.         DX = ??? handle or 0000h for default
  4816.         Return: CX = status (0000h,000Bh) (see #1324)
  4817.             EBX = old value of ??? if successful
  4818.             EDX destroyed
  4819.         02h ???
  4820.         DX = index of ???
  4821.         Return: CX = status (0000h,0004h,0005h) (see #1324)
  4822.             EBX = 0000FFFFh on error, 00000000h if successful
  4823.         03h ???
  4824.         DX = index of ???
  4825.         Return: CX = status (0000h,0004h,0006h) (see #1324)
  4826.             BX = FFFFh on error, 0000h if successful
  4827.         04h ???
  4828.         Return: CX = status (0000h,0007h,000Ah) (see #1324)
  4829.         05h ???
  4830.         EDX -> ??? data (first 8 bytes seem to be name)
  4831.         Return: CX = status (0000h,0009h,000Dh) (see #1324)
  4832.         06h ???
  4833.         Note:    calls fn 02h/subfn 05h, then fn 02h/subfn 40h
  4834.         07h ???
  4835.         EDX = ???
  4836.         Return: CX = status (0000h,0009h,000Eh) (see #1324)
  4837.         08h ???
  4838.         EDX = ???
  4839.         Return: CX = status (0000h,0009h,000Eh) (see #1324)
  4840.         09h ???
  4841.         EDX = ???
  4842.         Return: CX = status (0000h,0009h,000Fh) (see #1324)
  4843.         0Ah ???
  4844.         EDX = ???
  4845.         Return: CX = status (0000h,0009h,000Fh) (see #1324)
  4846.         0Bh ???
  4847.         DX = ???
  4848.         Return: CX = 0000h (successful)
  4849.         0Ch ???
  4850.         Return: CX = 0000h (successful)
  4851.         0Dh ???
  4852.         Return: CX = status (0000h,0023h) (see #1324)
  4853.             BX = FFFFh on error, 0000h if successful
  4854.         Note:    calls fn 04h/subfn 03h, fn 04h/subfn 1Eh,
  4855.               fn 02h/subfn 43h, fn 02h/subfn 0Bh, fn 04h/sub 01h
  4856.         0Eh ???
  4857.         ???
  4858.         Return: CX = status (0000h,000Ch) (see #1324)
  4859.             EBX = ??? if successful
  4860.         0Fh ???
  4861.         BX = ???
  4862.         DX = ??? handle or 0000h for default
  4863.         Return: CX = status (0000h,000Bh) (see #1324)
  4864.         10h get ??? handle
  4865.         Return: CX = 0000h (successful)
  4866.             BX = handle of default ???
  4867.             EBX high word cleared
  4868.         11h ???
  4869.         DX = ??? handle or 0000h for default
  4870.         BX = ??? (handle???)
  4871.         Return:    CX = status (0000h,000Bh,0014h) (see #1324)
  4872.         12h ???
  4873.         BX = ???
  4874.         DX = ???
  4875.         Return: CX = 0000h (successful)
  4876.         13h ???
  4877.         DX = ???
  4878.         Return: CX = status (see #1324)
  4879.         14h ???
  4880.         BX = ???
  4881.         DX = ???
  4882.         Return: CX = status (0000h,0014h) (see #1324)
  4883.             BX = FFFFh on error, ??? if successful
  4884.         15h set ??? flags
  4885.         BX = ??? (low two bits only)
  4886.         DX = ??? handle or 0000h for default
  4887.         Return: CX = status (0000h,000Bh) (see #1324)
  4888.             BX = new value of ??? flags (entire word)
  4889.             EBX high register cleared
  4890.         16h clear ??? flag for default ???
  4891.         Return: CX = 0000h (successful)
  4892.         17h ???
  4893.         18h ???
  4894.         19h ???
  4895.         1Ah ???
  4896.         1Bh ???
  4897.         1Ch ???
  4898.         1Dh ???
  4899.         1Eh ???
  4900.         1Fh ???
  4901.         20h ???
  4902.         21h ???
  4903.         22h ???
  4904.         23h ???
  4905.         24h ???
  4906.         25h ???
  4907.         26h ???
  4908.         27h ???
  4909.         28h ???
  4910.         29h ???
  4911.         2Ah ???
  4912.         2Bh ???
  4913.         2Ch ???
  4914.         2Dh ???
  4915.         2Eh ???
  4916.         2Fh ???
  4917.         30h ???
  4918.         31h ???
  4919.         32h ???
  4920.         33h ???
  4921.         34h ???
  4922.         35h ???
  4923.         36h ???
  4924.         37h ???
  4925.         38h ???
  4926.         39h ???
  4927.         3Ah ???
  4928.         3Bh ???
  4929.         3Ch ???
  4930.         3Eh ???
  4931.         3Fh ???
  4932.         40h ???
  4933.         41h ???
  4934.         42h ???
  4935.         43h ???
  4936.         44h ???
  4937.         45h ???
  4938.         46h ???
  4939.         47h ???
  4940. Return: CX = status (most subfunctions)
  4941.     (E)AX and/or (E)BX contain return values, depending on function
  4942. Notes:    called by DPMS.EXE and EMM386.EXE
  4943.     this API is only available if AX=12FFh/BX=0EDCh returns successfully;
  4944.       because the request is handled on the initial trap to the memory
  4945.       manager caused by INT instructions, this API must be invoked with
  4946.       an actual INT 2F instruction instead of some simulation such as a
  4947.       far call to the address in the interrupt vector table
  4948. SeeAlso: AX=12FF/BX=0EDCh,AX=2780h/CL=01h,AX=2780h/CL=03h,AX=2780h/CL=04h
  4949. --------m-2F2780CL03-------------------------
  4950. INT 2F U - Novell DOS 7 - EMM386.EXE - MULTITASKING API
  4951.     AX = 2780h
  4952.     CL = 03h (function number)
  4953.     CH = subfunction
  4954.         00h ???    
  4955.         01h ???
  4956.         02h ???
  4957.         03h ???
  4958.         04h ???
  4959.         05h ???
  4960.         06h ???
  4961.         07h ???
  4962.         08h ???
  4963.         09h ???
  4964.         0Ah ???
  4965.         0Bh ???
  4966.         0Ch ???
  4967.         0Dh ???
  4968.         0Eh ???
  4969.         0Fh ???
  4970.         10h ???
  4971.         11h ???
  4972.         12h ???
  4973.         13h ???
  4974.         14h ???
  4975.         15h ???
  4976.         16h ???
  4977.         17h ???
  4978.         18h ???
  4979.         19h ???
  4980.         1Ah ???
  4981.         1Bh ???
  4982.         1Ch ???
  4983.         1Dh ???
  4984.         1Eh ???
  4985.         1Fh ???
  4986.         20h ???
  4987.         21h ???
  4988.         22h ???
  4989.         23h ???
  4990.         24h ???
  4991.         25h ???
  4992.         26h ???
  4993.         27h ???
  4994.         28h ???
  4995.         29h ???
  4996.         2Ah ???
  4997.         2Bh ???
  4998.         2Ch ???
  4999.         2Dh ???
  5000.         2Eh ???
  5001.         2Fh ???
  5002.         30h ???
  5003.         31h ???
  5004.         32h ???
  5005.         33h ???
  5006.         34h ???
  5007.         35h ???
  5008.         36h ???
  5009.         37h ???
  5010. Return: CX = status (most subfunctions)
  5011.     (E)AX and/or (E)BX contain return values, depending on function
  5012. Notes:    called by DPMS.EXE and EMM386.EXE
  5013.     this API is only available if AX=12FFh/BX=0EDCh returns successfully;
  5014.       because the request is handled on the initial trap to the memory
  5015.       manager caused by INT instructions, this API must be invoked with
  5016.       an actual INT 2F instruction instead of some simulation such as a
  5017.       far call to the address in the interrupt vector table
  5018. SeeAlso: AX=12FF/BX=0EDCh,AX=2780h/CL=01h,AX=2780h/CL=02h,AX=2780h/CL=04h
  5019. --------m-2F2780CL04-------------------------
  5020. INT 2F U - Novell DOS 7 - EMM386.EXE - MULTITASKING API
  5021.     AX = 2780h
  5022.     CL = 04h (function number)
  5023.     CH = subfunction
  5024.         00h ???    
  5025.         01h ???
  5026.         02h ???
  5027.         03h ???
  5028.         04h ???
  5029.         05h ???
  5030.         06h ???
  5031.         07h ???
  5032.         08h ???
  5033.         09h ???
  5034.         0Ah ???
  5035.         0Bh ???
  5036.         0Ch ???
  5037.         0Dh ???
  5038.         0Eh ???
  5039.         0Fh ???
  5040.         10h ???
  5041.         11h ???
  5042.         12h ???
  5043.         13h ???
  5044.         14h ???
  5045.         15h ???
  5046.         16h ???
  5047.         17h ???
  5048.         18h ???
  5049.         19h ???
  5050.         1Ah ???
  5051.         1Bh ???
  5052.         1Ch ???
  5053.         1Dh ???
  5054.         1Eh ???
  5055.         1Fh ???
  5056.         20h ???
  5057.         21h ???
  5058.         22h ???
  5059.         23h ???
  5060.         24h ???
  5061.         25h ???
  5062.         26h ???
  5063.         27h ???
  5064.         28h ???
  5065.         29h ???
  5066.         2Ah ???
  5067.         2Bh ???
  5068.         2Ch ???
  5069.         2Dh ???
  5070.         2Eh ???
  5071.         2Fh ???
  5072.         30h ???
  5073.         31h ???
  5074.         32h ???
  5075. Return: CX = status (most subfunctions)
  5076.     (E)AX and/or (E)BX contain return values, depending on function
  5077. Notes:    called by DPMS.EXE and EMM386.EXE
  5078.     this API is only available if AX=12FFh/BX=0EDCh returns successfully;
  5079.       because the request is handled on the initial trap to the memory
  5080.       manager caused by INT instructions, this API must be invoked with
  5081.       an actual INT 2F instruction instead of some simulation such as a
  5082.       far call to the address in the interrupt vector table
  5083. SeeAlso: AX=12FF/BX=0EDCh,AX=2780h/CL=01h,AX=2780h/CL=02h,AX=2780h/CL=03h
  5084. --------m-2F2780CL05-------------------------
  5085. INT 2F U - Novell DOS 7 - EMM386.EXE - MULTITASKING API
  5086.     AX = 2780h
  5087.     CL = 05h
  5088.     ???
  5089. Return: ???
  5090. Notes:    called by DPMS.EXE and EMM386.EXE
  5091.     the handler for this function may be set by one of the subfunctions
  5092.       of AX=2780h/CL=01h; the default handler returns AX=BX=FFFFh and
  5093.       CX=0001h (see #1324)
  5094.     this API is only available if AX=12FFh/BX=0EDCh returns successfully;
  5095.       because the request is handled on the initial trap to the memory
  5096.       manager caused by INT instructions, this API must be invoked with
  5097.       an actual INT 2F instruction instead of some simulation such as a
  5098.       far call to the address in the interrupt vector table
  5099. SeeAlso: AX=12FF/BX=0EDCh,AX=2780h/CL=01h,AX=2780h/CL=02h,AX=2780h/CL=03h
  5100. --------m-2F2780CL06-------------------------
  5101. INT 2F U - Novell DOS 7 - EMM386.EXE - MULTITASKING API
  5102.     AX = 2780h
  5103.     CL = 06h
  5104.     ???
  5105. Return: ???
  5106. Notes:    called by DPMS.EXE and EMM386.EXE
  5107.     the handler for this function may be set by one of the subfunctions
  5108.       of AX=2780h/CL=01h; the default handler returns AX=BX=FFFFh and
  5109.       CX=0001h (see #1324)
  5110.     this API is only available if AX=12FFh/BX=0EDCh returns successfully;
  5111.       because the request is handled on the initial trap to the memory
  5112.       manager caused by INT instructions, this API must be invoked with
  5113.       an actual INT 2F instruction instead of some simulation such as a
  5114.       far call to the address in the interrupt vector table
  5115. SeeAlso: AX=12FF/BX=0EDCh,AX=2780h/CL=01h,AX=2780h/CL=02h,AX=2780h/CL=03h
  5116. --------m-2F2780-----------------------------
  5117. INT 2F U - Novell DOS 7 - EMM386.EXE - MULTITASKING API
  5118.     AX = 2780h
  5119.     CL = function (07h-0Fh)
  5120.     ???
  5121. Return: ???
  5122. Notes:    called by DPMS.EXE and EMM386.EXE
  5123.     the handlers for each of these functions may be set individually by
  5124.       one of the subfunctions of AX=2780h/CL=01h; the default handlers
  5125.       return with all registers unchanged
  5126.     this API is only available if AX=12FFh/BX=0EDCh returns successfully;
  5127.       because the request is handled on the initial trap to the memory
  5128.       manager caused by INT instructions, this API must be invoked with
  5129.       an actual INT 2F instruction instead of some simulation such as a
  5130.       far call to the address in the interrupt vector table
  5131. SeeAlso: AX=12FF/BX=0EDCh,AX=2780h/CL=01h,AX=2780h/CL=02h,AX=2780h/CL=03h
  5132. --------T-2F2781-----------------------------
  5133. INT 2F U - Novell DOS 7 TaskMGR - BEGIN CRITICAL SECTION???
  5134.     AX = 2781h
  5135. Return: ???
  5136. SeeAlso: AX=2782h
  5137. --------T-2F2782-----------------------------
  5138. INT 2F U - Novell DOS 7 TaskMGR - END CRITICAL SECTION???
  5139.     AX = 2782h
  5140. Return: ???
  5141. SeeAlso: AX=2781h
  5142. --------m-2F2783-----------------------------
  5143. INT 2F U - Novell DOS 7 - EMM386.EXE - GET ???
  5144.     AX = 2783h
  5145. Return: AX = ???
  5146.     BX = ???
  5147. --------T-2F278F-----------------------------
  5148. INT 2F U - Novell DOS 7 TaskMGR - ??? API
  5149.     AX = 278Fh
  5150.     as for INT 2F/AX=2780h
  5151. Return: as for INT 2F/AX=2780h
  5152. Note:    Novell DOS 7 TaskMGR passes this call through to INT 2F/AX=2780h
  5153.       without changing any other registers
  5154. SeeAlso: AX=2780h,AX=2782h
  5155. --------F-2F2A-------------------------------
  5156. INT 2F - Gammafax DOS Dispatcher INTERFACE
  5157.     AH = 2Ah
  5158. Note:    details not available at this time
  5159. SeeAlso: AX=8000h"FaxBIOS",AX=C000h/BX=444Bh,AX=CB00h,AX=CBDDh,INT 66"BitFax"
  5160. --------V-2F2E00-----------------------------
  5161. INT 2F U - Novell DOS 7 - GRAFTABL - INSTALLATION CHECK
  5162.     AX = 2E00h
  5163. Return: AH = FFh if installed
  5164. Note:    this installation check does not follow the usual format of setting
  5165.       AL to FFh
  5166. SeeAlso: AX=2300h,AH=2Eh"GRAFTABL"
  5167. --------V-2F2E-------------------------------
  5168. INT 2F U - Novell DOS 7 - GRAFTABL - GET FONT TABLE
  5169.     AH = 2Eh
  5170.     AL nonzero
  5171. Return: AH = FFh if installed
  5172.         ES:BX -> graphics data (8 bytes per character from 80h to FFh)
  5173. SeeAlso: AX=2E00h,AH=23h"GRAFTABL"
  5174. --------t-2F3900-----------------------------
  5175. INT 2F - Kingswood TSR INTERFACE - COMPATIBILITY MODE
  5176.     AX = 3900h
  5177. Return: AL = status
  5178.         00h not installed
  5179.         FFh one or more TSRs using this interface is installed
  5180.         DX may be destroyed
  5181. Note:    this function is provided to that the multiplex number will appear used
  5182.       to other programs
  5183. SeeAlso: AH=39h/BL=00h
  5184. --------t-2F39--BL00-------------------------
  5185. INT 2F - Kingswood TSR INTERFACE - INSTALLATION CHECK
  5186.     AH = 39h
  5187.     BL = 00h
  5188.     AL = TSR ID number (01h-FFh, currently only 01h-1Bh used) (see #1325)
  5189. Return: AL = status
  5190.         00h not installed
  5191.         FFh installed
  5192.         DX = segment address of resident module
  5193. Note:    All of Kingswood Software's TSRs use this interface.  Usually the
  5194.       resident module is installed by allocating a block of upper memory,
  5195.       setting its owner ID to 000Ah (used by DOS), and filling the MCB name
  5196.       field with the TSR's name.
  5197. SeeAlso: AX=3900h,AH=39h/BL=01h
  5198.  
  5199. (Table 1325)
  5200. Values for Kingswood TSR ID number:
  5201.  01h    TSR Windows
  5202.  02h    NOBUSY
  5203.  03h    CD STACK
  5204.  04h    DISK WATCH
  5205.  05h    PUSHBP
  5206.  06h    ALIAS
  5207.  07h    KEYMACRO
  5208.  08h    SLOWDOWN
  5209.  09h    ANSIGRAB
  5210.  0Ah    TEE
  5211.  0Bh    FASTMOUS
  5212.  0Ch    EXTWILD
  5213.  0Dh    BREAKOUT
  5214.  0Eh    STOPDISK
  5215.  0Fh    MEMINIT
  5216.  10h    JANUSEXT
  5217.  11h    CAPS
  5218.  12h    ANSI
  5219.  13h    TRAPPER
  5220.  14h    EATMEM
  5221.  15h    WPJOKE
  5222.  16h    SHOWDOS
  5223.  17h    LOGINTS
  5224.  18h    BLANKVGA
  5225.  19h    SWAPEXEC
  5226.  1Ah    SHELL
  5227.  1Bh    TSRGAMES
  5228.  
  5229. Format of Kingswood TSR modules:
  5230. Offset    Size    Description    (Table 1326)
  5231.  00h  4 BYTEs    signature "FTSR"
  5232.  04h    WORD    segment address of this module (used to check validity)
  5233.  06h    WORD    number of words to skip (usually 0000h if no PSP present)
  5234.  08h  N WORDs    module-defined data that must be at a fixed segment offset
  5235.         (usually only a PSP if file access is required)
  5236.      5N BYTEs    interrupt list (see #1327)
  5237.     BYTE    FFh terminator
  5238.  
  5239. Format of Kingswood TSR interrupt list entry:
  5240. Offset    Size    Description    (Table 1327)
  5241.  00h    BYTE    interrupt number (00h-FEh)
  5242.  01h    WORD    offset within segment of DWORD pointer to previous interrupt
  5243.  03h    WORD    offset within segment of begin of interrupt handler code
  5244. --------t-2F39--BL01-------------------------
  5245. INT 2F - Kingswood TSR INTERFACE - REMOVAL CHECK
  5246.     AH = 39h
  5247.     BL = 01h
  5248.     AL = TSR ID number (01h-FFh) (see #1325)
  5249. Return: AL = status
  5250.         00h not ready to be removed
  5251.         FFh resident module may be removed by deassigning the interrupts
  5252.           hooked by the TSR and deallocating the TSR's memory block
  5253.     AH,BX,CX,DX,ES may be destroyed
  5254. SeeAlso: AX=3900h,AH=39h/BL=00h
  5255. --------t-2F39-------------------------------
  5256. INT 2F - Kingswood TSR INTERFACE - APPLICATION-SPECIFIC FUNCTION CALLS
  5257.     AH = 39h
  5258.     BL = function number (02h-FFh)
  5259.     AL = TSR ID number (01h-FFh) (see #1325)
  5260.     CX,DX,SI,DI,DS,ES may contain parameters
  5261.     BH reserved for use by the function dispatcher
  5262. Return: as appropriate for the called function
  5263. SeeAlso: AX=3900h,AH=39h/BL=00h,AX=3901h/BL=02h
  5264. --------r-2F3901BL02-------------------------
  5265. INT 2F - Kingswood TSR Windows - OPEN WINDOW
  5266.     AX = 3901h
  5267.     BL = 02h
  5268. Return: AX = error code (0000h if successful)
  5269.     SI,DI,DS,ES preserved
  5270. Notes:    opens the next TSR window on top of any others.     Only three
  5271.       TSR windows can be opened at any one time.  The three windows
  5272.       are all 40x11 characters, partly overlapping.
  5273. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=03h,AX=3901h/BL=05h,AX=3901h/BL=06h
  5274. --------r-2F3901BL03-------------------------
  5275. INT 2F - Kingswood TSR Windows - HIDE WINDOWS
  5276.     AX = 3901h
  5277.     BL = 03h
  5278. Return: AX = error code (0000h if successful)
  5279.     SI,DI,DS,ES preserved
  5280. Notes:    Hide any visible TSR windows from view.
  5281. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h,AX=3901h/BL=05h
  5282. --------r-2F3901BL04-------------------------
  5283. INT 2F - Kingswood TSR Windows - SHOW WINDOWS
  5284.     AX = 3901h
  5285.     BL = 04h
  5286. Return: AX = error code (0000h if successful)
  5287.     SI,DI,DS,ES preserved
  5288. Notes:    Re-display all TSR windows after a HIDE WINDOWS call.
  5289. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h,AX=3901h/BL=03h
  5290. --------r-2F3901BL05-------------------------
  5291. INT 2F - Kingswood TSR Windows - CLOSE WINDOW
  5292.     AX = 3901h
  5293.     BL = 05h
  5294. Return: AX = error code (0000h if successful)
  5295.     SI,DI,DS,ES preserved
  5296. Notes:    Close the last opened TSR window.
  5297. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h
  5298. --------r-2F3901BL06-------------------------
  5299. INT 2F - Kingswood TSR Windows - SET WINDOW TITLE
  5300.     AX = 3901h
  5301.     BL = 06h
  5302.     DS:SI -> title string
  5303. Return: AX = error code (0000h if successful)
  5304.     SI,DI,DS,ES preserved
  5305. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h
  5306. --------r-2F3901BL07-------------------------
  5307. INT 2F - Kingswood TSR Windows - POSITION CURSOR
  5308.     AX = 3901h
  5309.     BL = 07h
  5310.     CH = Y coordinate (0-10)
  5311.     CL = X coordinate (0-39)
  5312. Return: AX = error code (0000h if successful)
  5313.     SI,DI,DS,ES preserved
  5314. Note:    the hardware cursor is always disabled when a TSR window is opened;
  5315.       this call only sets a text position
  5316. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=08h,AX=3901h/BL=09h
  5317. --------r-2F3901BL08-------------------------
  5318. INT 2F - Kingswood TSR Windows - DISPLAY STRING
  5319.     AX = 3901h
  5320.     BL = 08h
  5321.     DS:SI -> string
  5322. Return: AX = error code (0000h if successful)
  5323.     SI,DI,DS,ES preserved
  5324. Notes:    The text is not clipped.
  5325.     This routine understands Tab, NewLine and Carriage Return
  5326. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=07h
  5327. --------r-2F3901BL09-------------------------
  5328. INT 2F - Kingswood TSR Windows - SCROLL WINDOW
  5329.     AX = 3901h
  5330.     BL = 09h
  5331.     CL = scroll direction: 01h up, FFh down, 00h clear window
  5332. Return: AX = error code (0000h if successful)
  5333.     SI,DI,DS,ES preserved
  5334. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=07h
  5335. --------r-2F3901BL0A-------------------------
  5336. INT 2F - Kingswood TSR Windows - SOUND BEEPER
  5337.     AX = 3901h
  5338.     BL = 0Ah
  5339.     DX = sound divisor, or 0 for silence.
  5340.          (divide 1843200 by required frequency to get value for DX)
  5341.     CL = sound length in 18.2 Hz clock ticks
  5342. Return: AX = error code (0000h if successful)
  5343.     SI,DI,DS,ES preserved
  5344. SeeAlso: AH=39h/BL=00h
  5345. --------r-2F3901BL0B-------------------------
  5346. INT 2F - Kingswood TSR Windows - ADD OR REMOVE USER
  5347.     AX = 3901h
  5348.     BL = 0Bh
  5349.     CL = number of users increment: +1 if adding a new user
  5350.                     -1 if removing a user
  5351. Return: AX = error code (0000h if successful)
  5352.     SI,DI,DS,ES preserved
  5353. Note:    the TSR windows resident module may only be removed when the internal
  5354.       user count is zero
  5355. SeeAlso: AH=39h/BL=00h,AX=3901h/BL=02h
  5356. --------V-2F3912BL03-------------------------
  5357. INT 2F - Kingswood ANSI display driver - SET COMPATIBILITY MODE
  5358.     AX = 3912h
  5359.     BL = 03h
  5360.     CL = new mode (00h fast, FFh BIOS)
  5361. Return: AL = old compatibility mode
  5362.     SI,DI,DS,ES preserved
  5363. SeeAlso: AX=3900h,AX=3912h/BL=04h
  5364. --------V-2F3912BL04-------------------------
  5365. INT 2F - Kingswood ANSI display driver - SET FLAGS
  5366.     AX = 3912h
  5367.     BL = 04h
  5368.     CL = new flags (see #1328)
  5369. Return: AL = old flags
  5370.     SI,DI,DS,ES preserved
  5371. SeeAlso: AX=3900h,AX=3912h/BL=03h
  5372.  
  5373. Bitfields for Kingswood ANSI flags:
  5374. Bit(s)    Description    (Table 1328)
  5375.  0    do not wrap at end of line
  5376.  1    wait for beeps to end before displaying next character
  5377.  2    do not use graphics cursor
  5378. --------W-2F4000-----------------------------
  5379. INT 2F - Windows 3.x (OS/2 2.x???) - GET VIRTUAL DEVICE DRIVER (VDD) CAPABLTIES
  5380.     AX = 4000h
  5381. Return: AL = video virtualization (see #1329)
  5382. Note:    this function is used by display drivers to find out what capabilities
  5383.       exist for the VDD driver and also trigger the VDD driver to call
  5384.       functions 4005h and 4006h.  This function also gives the Video Driver
  5385.       hardware access to the video registers.
  5386.  
  5387. (Table 1329)
  5388. Values for Windows video virtualization:
  5389.  01h    does not virtualize video access
  5390.  02h    virtualizes the video when in text mode
  5391.  03h    virtualizes the video when in text mode or single plane graphics modes
  5392.  04h    virtualizes the video when in text mode, single plane graphics modes,
  5393.       and VGA multiplane modes
  5394.  FFh    virtualizes the video fully
  5395. --------O-2F4001-----------------------------
  5396. INT 2F C - OS/2 compatibility box - SWITCHING DOS TO BACKGROUND
  5397.     AX = 4001h
  5398. Note:    called by OS/2 when the DOS box is about to be placed in the background
  5399.       and the video driver should save any necessary state
  5400. SeeAlso: AX=4002h,AX=4005h
  5401. --------O-2F4002-----------------------------
  5402. INT 2F C - OS/2 compatibility box - SWITCHING DOS TO FOREGROUND
  5403.     AX = 4002h
  5404. Note:    called by OS/2 when the DOS box is about to be placed in the foreground
  5405.       and the video driver should restore the previously-saved state
  5406. SeeAlso: AX=4001h,AX=4006h
  5407. --------W-2F4003-----------------------------
  5408. INT 2F - Windows 3.x - ENTERING VIDEO DRIVER CRITICAL SECTION
  5409.     AX = 4003h
  5410. Note:    This critical section must be exited within 1 second.
  5411. SeeAlso: AX=4004h
  5412. --------W-2F4004-----------------------------
  5413. INT 2F - Windows 3.x - EXITING VIDEO DRIVER CRITICAL SECTION
  5414.     AX = 4004h
  5415. SeeAlso: AX=4003h
  5416. --------W-2F4005-----------------------------
  5417. INT 2F C - Windows 3.x - SWITCHING DOS TO BACKGROUND
  5418.     AX = 4005h
  5419. Note:    called by Windows when the DOS box is about to be placed in the
  5420.       background and the video driver should save any necessary state
  5421.       information (this may be called only in Standard mode)
  5422. SeeAlso: AX=4001h,AX=4006h
  5423. --------W-2F4006-----------------------------
  5424. INT 2F C - Windows 3.x - SWITCHING DOS TO FOREGROUND
  5425.     AX = 4006h
  5426. Note:    called by Windows when the DOS box is about to be placed in the
  5427.       foreground and the video driver should restore any necessary state
  5428.       information (this may be called only in Standard mode)
  5429. SeeAlso: AX=4002h,AX=4005h
  5430. --------W-2F4007-----------------------------
  5431. INT 2F - Windows 3.x - ENABLE VDD TRAPPING OF VIDEO REGISTERS
  5432.     AX = 4007h
  5433. Note:    used by Windows Standard mode
  5434. --------E-2F4040-----------------------------
  5435. INT 2F - PharLap 286|DOS-Extender Lite v2.5 - ???
  5436.     AX = 4040h
  5437. Return: BX:CX -> ???
  5438. --------N-2F4100-----------------------------
  5439. INT 2F - DOS Enhanced LAN Manager 2.0+ MINIPOP/NETPOPUP - INSTALLATION CHECK
  5440.     AX = 4100h
  5441. Return: CF clear if successful
  5442.         AL = FFh
  5443.     CF set on error
  5444.         AX = ???
  5445. Notes:    MINIPOP and NETPOPUP provide a network message popup service
  5446.     LAN Manager enhanced mode adds features beyond the standard redirector
  5447.       file/printer services
  5448. SeeAlso: AX=118Ah,AX=4103h,AX=4104h,AH=42h,AH=4Bh
  5449. --------N-2F4103-----------------------------
  5450. INT 2F - DOS Enhanced LAN Manager 2.0+ MINIPOP/NETPOPUP - ???
  5451.     AX = 4103h
  5452. Return: ???
  5453. SeeAlso: AX=4100h,AX=4104h
  5454. --------N-2F4104-----------------------------
  5455. INT 2F - DOS Enhanced LAN Manager 2.0+ MINIPOP/NETPOPUP - ???
  5456.     AX = 4104h
  5457. Return: ???
  5458. SeeAlso: AX=4100h,AX=4103h
  5459. --------N-2F42-------------------------------
  5460. INT 2F - LAN Manager 2.0 DOS Enhanced MSRV.EXE - MESSENGER SERVICE
  5461.     AH = 42h
  5462.     ???
  5463. Return: ???
  5464. Note:    LAN Manager enhanced mode adds features beyond the standard redirector
  5465.       file/printer services
  5466. SeeAlso: AX=118Ah,AX=4100h,AH=4Bh
  5467. --------m-2F4300-----------------------------
  5468. INT 2F - EXTENDED MEMORY SPECIFICATION (XMS) v2+ - INSTALLATION CHECK
  5469.     AX = 4300h
  5470. Return: AL = 80h XMS driver installed
  5471.     AL <> 80h no driver
  5472. Notes:    XMS gives access to extended memory and noncontiguous/nonEMS memory
  5473.       above 640K
  5474.     this installation check DOES NOT follow the format used by other
  5475.       software
  5476. SeeAlso: AX=4310h
  5477. Index:    installation check;XMS version 2+
  5478. --------m-2F4308-----------------------------
  5479. INT 2F U - HIMEM.SYS v2.77+ - GET A20 HANDLER NUMBER
  5480.     AX = 4308h
  5481. Return: AL = 43h if supported
  5482.         BL = A20 handler number (value of /MACHINE:nn switch)
  5483.         BH = AT A20 switch time (00h medium, 01h fast, 02h slow)
  5484. Note:    if the A20 handler number returned in BL is 00h, an external handler
  5485.       is being used (see AX=4330h)
  5486. SeeAlso: AX=4309h,AX=4330h
  5487. --------m-2F4309-----------------------------
  5488. INT 2F U - HIMEM.SYS v3.09+ - GET XMS HANDLE TABLE
  5489.     AX = 4309h
  5490. Return: AL = 43h if function supported
  5491.         ES:BX -> XMS handle table (see #1330)
  5492. Note:    HIMEM.SYS v3.09 is part of MS-DOS 6.0.
  5493. SeeAlso: AX=4308h
  5494.  
  5495. Format of XMS handle table:
  5496. Offset    Size    Description    (Table 1330)
  5497.  00h    BYTE    ??? (01h in HIMEM.SYS v3.09)
  5498.  01h    BYTE    size of one handle descriptor
  5499.  02h    WORD    number of handles (default = 20h)
  5500.  04h    DWORD    pointer to XMS handle array (see #1331)
  5501. SeeAlso: #1364
  5502.  
  5503. Format of XMS handle descriptor [array]:
  5504. Offset    Size    Description    (Table 1331)
  5505.  00h    BYTE    flag
  5506.         01h=free, 02h=used, 04h=in pool but not associated with any EMB
  5507.  01h    BYTE    lock count (00h=unlocked)
  5508.  02h    DWORD    address of XMS block in KB (shift left by 10 for abs. address)
  5509.  06h    DWORD    size of XMS block in KB
  5510. --------m-2F4310-----------------------------
  5511. INT 2F - EXTENDED MEMORY SPECIFICATION (XMS) v2+ - GET DRIVER ADDRESS
  5512.     AX = 4310h
  5513. Return: ES:BX -> driver entry point (see #1332,#1333,#1343,#1361)
  5514. Notes:    HIMEM.SYS v2.77 chains to previous handler if AH is not 00h or 10h
  5515.     HIMEM.SYS requires at least 256 bytes free stack space when calling
  5516.       the driver entry point
  5517. SeeAlso: AX=4300h,AX=4310h"Cloaking"
  5518.  
  5519. Format of XMS driver entry point:
  5520. Offset    Size    Description    (Table 1332)
  5521.  00h  5 BYTEs    jump to actual handler
  5522.         either short jump (EBh XXh) followed by three NOPs or
  5523.           far jump (EAh XXXX:XXXX) to a program which has hooked itself
  5524.           into the XMS driver chain
  5525. Note:    to hook into the XMS driver chain, a program should follow the chain of
  5526.       far jumps until it reaches the short jump of the driver at the end
  5527.       of the chain; this short jump is to be replaced with a far jump to
  5528.       the new handler's entry point, which should contain a short jump
  5529.       followed by three NOPs.  The new handler must return to the address
  5530.       pointed at by the short jump which was overwritten.  Using this
  5531.       method, the new handler becomes the first to see every XMS request.
  5532.  
  5533. (Table 1333)
  5534. Call the XMS driver "Get XMS version number" function with:
  5535.     AH = 00h
  5536. Return: AX = XMS version (in BCD, AH=major, AL=minor)
  5537.     BX = internal revision number (in BCD for HIMEM.SYS)
  5538.     DX = High Memory Area (HMA) state
  5539.         0001h HMA (1M to 1M + 64K) exists
  5540.         0000h HMA does not exist
  5541.  
  5542. (Table 1334)
  5543. Call the XMS driver "Request High Memory Area" function with:
  5544.     AH = 01h
  5545.     DX = memory in bytes (for TSR or device drivers)
  5546.         FFFFh if application program
  5547. Return: AX = status
  5548.         0001h success
  5549.         0000h failure
  5550.         BL = error code (80h,81h,90h,91h,92h) (see #1362)
  5551. Note:    HIMEM.SYS will fail function 01h with error code 91h if AL=40h and
  5552.       DX=KB free extended memory returned by last call of function 08h
  5553.  
  5554. (Table 1335)
  5555. Call the XMS driver "Release High Memory Area" function with:
  5556.     AH = 02h
  5557. Return: AX = status
  5558.         0001h success
  5559.         0000h failure
  5560.         BL = error code (80h,81h,90h,93h) (see #1362)
  5561.  
  5562. (Table 1336)
  5563. Call the XMS driver "Global enable A20, for using the HMA" function with:
  5564.     AH = 03h
  5565. Return: AX = status
  5566.         0001h success
  5567.         0000h failure
  5568.         BL = error code (80h,81h,82h) (see #1362)
  5569.  
  5570. (Table 1337)
  5571. Call the XMS driver "Global disable A20" function with:
  5572.     AH = 04h
  5573. Return: AX = status
  5574.         0001h success
  5575.         0000h failure
  5576.         BL = error code (80h,81h,82h,94h) (see #1362)
  5577.  
  5578. (Table 1338)
  5579. Call the XMS driver "Local enable A20" function with:
  5580.     AH = 05h
  5581. Return: AX = status
  5582.         0001h success
  5583.         0000h failure
  5584.         BL = error code (80h,81h,82h) (see #1362)
  5585. Note:    this function is used for direct access to extended memory
  5586.  
  5587. (Table 1339)
  5588. Call the XMS driver "Local disable A20" function with:
  5589.     AH = 06h
  5590. Return: AX = status
  5591.         0001h success
  5592.         0000h failure
  5593.         BL = error code (80h,81h,82h,94h) (see #1362)
  5594.  
  5595. (Table 1340)
  5596. Call the XMS driver "Query A20 state" function with:
  5597.     AH = 07h
  5598. Return: AX = status
  5599.         0001h enabled
  5600.         0000h disabled
  5601.         BL = error code (00h,80h,81h) (see #1362)
  5602.  
  5603. (Table 1341)
  5604. Call the XMS driver "Query free extended memory" function with:
  5605.     AH = 08h
  5606.     BL = 00h (some implementations leave BL unchanged on success)
  5607. Return: AX = size of largest extended memory block in KB
  5608.     DX = total extended memory in KB
  5609.     BL = error code (00h,80h,81h,A0h) (see #1362)
  5610. Note:    this function does not include the HMA in the returned memory sizes
  5611.  
  5612. (Table 1342)
  5613. Call the XMS driver "Allocate extended memory block" function with:
  5614.     AH = 09h
  5615.     DX = Kbytes needed
  5616. Return: AX = status
  5617.         0001h success
  5618.         DX = handle for memory block
  5619.         0000h failure
  5620.         BL = error code (80h,81h,A0h) (see #1362)
  5621. SeeAlso: #1359
  5622.  
  5623. (Table 1343)
  5624. Call the XMS driver "Free extended memory block" function with:
  5625.     AH = 0Ah
  5626.     DX = handle of block to free
  5627. Return: AX = status
  5628.         0001h success
  5629.         0000h failure
  5630.         BL = error code (80h,81h,A2h,ABh) (see #1362)
  5631. SeeAlso: #1342,#1359
  5632.  
  5633. (Table 1344)
  5634. Call the XMS driver "Move extended memory block" function with:
  5635.     AH = 0Bh
  5636.     DS:SI -> EMM structure (see #1363)
  5637. Return: AX = status
  5638.         0001h success
  5639.         0000h failure
  5640.         BL = error code (80h-82h,A3h-A9h) (see #1362)
  5641. Note:    if either handle in the EMM structure is 0000h, the corresponding
  5642.       offset is considered to be an absolute segment:offset address in
  5643.       directly addressable memory
  5644.  
  5645. (Table 1345)
  5646. Call the XMS driver "Lock extended memory block" function with:
  5647.     AH = 0Ch
  5648.     DX = handle of block to lock
  5649. Return: AX = status
  5650.         0001h success
  5651.         DX:BX = 32-bit linear address of locked block
  5652.         0000h failure
  5653.         BL = error code (80h,81h,A2h,ACh,ADh) (see #1362)
  5654. Note:    MS Windows 3.x rejects this function for handles allocated after
  5655.       Windows started
  5656.  
  5657. (Table 1346)
  5658. Call the XMS driver "Unlock extended memory block" function with:
  5659.     AH = 0Dh
  5660.     DX = handle of block to unlock
  5661. Return: AX = status
  5662.         0001h success
  5663.         0000h failure
  5664.         BL = error code (80h,81h,A2h,AAh) (see #1362)
  5665.  
  5666. (Table 1347)
  5667. Call the XMS driver "Get handle information" function with:
  5668.     AH = 0Eh
  5669.     DX = handle for which to get info
  5670. Return: AX = status
  5671.         0001h success
  5672.         BH = block's lock count
  5673.         BL = number of free handles left
  5674.         DX = block size in KB
  5675.         0000h failure
  5676.         BL = error code (80h,81h,A2h) (see #1362)
  5677. BUG:    MS Windows 3.10 acts as though unallocated handles are in use
  5678. Note:    MS Windows 3.00 has problems with this call
  5679.  
  5680. (Table 1348)
  5681. Call the XMS driver "Reallocate extended memory block" function with:
  5682.     AH = 0Fh
  5683.     DX = handle of block
  5684.     BX = new size of block in KB
  5685. Return: AX = status
  5686.         0001h success
  5687.         0000h failure
  5688.         BL = error code (80h,81h,A0h-A2h,ABh) (see #1362)
  5689.  
  5690. (Table 1349)
  5691. Call the XMS driver "Request upper memory block" function with:
  5692.     AH = 10h
  5693.     DX = size of block in paragraphs
  5694. Return: AX = status
  5695.         0001h success
  5696.         BX = segment address of UMB
  5697.         DX = actual size of block
  5698.         0000h failure
  5699.         BL = error code (80h,B0h,B1h) (see #1362)
  5700.         DX = largest available block
  5701. Notes:    Upper Memory consists of non-EMS memory between 640K and 1024K
  5702.     the XMS driver need not implement functions 10h through 12h to be
  5703.       considered compliant with the standard
  5704.  
  5705. (Table 1350)
  5706. Call the XMS driver "Release upper memory block" function with:
  5707.     AH = 11h
  5708.     DX = segment address of UMB to release
  5709. Return: AX = status
  5710.         0001h success
  5711.         0000h failure
  5712.         BL = error code (80h,B2h) (see #1362)
  5713. Note:    the XMS driver need not implement functions 10h through 12h to be
  5714.       considered compliant with the standard
  5715.  
  5716. (Table 1351)
  5717. Call the XMS v3.0+ driver "Reallocate upper memory block" function with:
  5718.     AH = 12h
  5719.     DX = segment address of UMB to resize
  5720.     BX = new size of block in paragraphs
  5721. Return: AX = status
  5722.         0001h success
  5723.         0000h failure
  5724.         BL = error code (80h,B0h,B2h) (see #1362)
  5725.         DX = maximum available size (RM386)
  5726. Note:    the XMS driver need not implement functions 10h through 12h to be
  5727.       considered compliant with the standard
  5728.  
  5729. (Table 1352)
  5730. Call the QEMM v5.11 "???" function with:
  5731.     AH = 34h  (QEMM 5.11 only, undocumented)
  5732.     ???
  5733. Return: ???
  5734.  
  5735. (Table 1353)
  5736. Call the QEMM v5.11 "???" function with:
  5737.     AH = 44h  (QEMM 5.11 only, undocumented)
  5738.     ???
  5739. Return: ???
  5740.  
  5741. (Table 1354)
  5742. Call the Netroom RM386 v6.00 "Reallocate upper memory block" function with:
  5743.     AH = 80h
  5744.     DX = segment address of UMB to resize
  5745.     BX = new size of block in paragraphs
  5746. Return: AX = status
  5747.         0001h success
  5748.         0000h failure
  5749.         BL = error code (80h,B0h,B2h) (see #1362)
  5750.         DX = maximum available size
  5751. Note:    this function is identical to function 12h
  5752.  
  5753. (Table 1355)
  5754. Call the Netroom RM386 v6.00 "re-enable HMA allocation" function with:
  5755.     AH = 81h
  5756. Return: AX = 0001h (success)
  5757.  
  5758. (Table 1356)
  5759. Call the Netroom RM386 v6.00 "Create new UMB entry" function with:
  5760.     AH = 83h
  5761.     BX = segment of high-memory block
  5762.     DX = first page of start of block
  5763.     CX = number of consecutive pages in block
  5764.     DI = start of UMB in block
  5765. Return: AX = 0001h (success)
  5766.     DI = segment of first high-DOS block
  5767. Note:    the new UMB is not linked into the high-memory chain
  5768.  
  5769. (Table 1357)
  5770. Call the Netroom RM386 v6.00 "Get all XMS handles info" function with:
  5771.     AH = 84h
  5772.     CX = size of buffer for handle info
  5773.     ES:DI -> buffer for handle info (see #1364)
  5774. Return: AX = 0001h (success)
  5775.     DX = current number of allocated XMS handles
  5776.  
  5777. (Table 1358)
  5778. Call the XMS v3.0 driver "Query free extended memory" function with:
  5779.     AH = 88h
  5780. Return: EAX = largest block of extended memory, in KB
  5781.     BL = status (00h,80h,81h,A0h) (see #1362)
  5782.     ECX = physical address of highest byte of memory
  5783.         (valid even on error codes 81h and A0h)
  5784.     EDX = total Kbytes of extended memory (0 if status A0h)
  5785. BUG:    HIMEM v3.03-3.07 crash on an 80286 machine if any of the 8Xh functions
  5786.       are called
  5787. SeeAlso: #1341,#1359
  5788.  
  5789. (Table 1359)
  5790. Call the XMS v3.0 driver "Allocate any extended memory" function with:
  5791.     AH = 89h
  5792.     EDX = Kbytes needed
  5793. Return: AX = status
  5794.         0001h success
  5795.         DX = handle for allocated block (free with AH=0Ah) (see #1343)
  5796.         0000h failure
  5797.         BL = status (80h,81h,A0h,A1h,A2h) (see #1362)
  5798. SeeAlso: #1342,#1358
  5799.  
  5800. (Table 1360)
  5801. Call the XMS v3.0 driver "Get extended EMB handle information" function with:
  5802.     AH = 8Eh
  5803.     DX = handle
  5804. Return: AX = status
  5805.         0001h success
  5806.         BH = block's lock count
  5807.         CX = number of free handles left
  5808.         EDX = block size in KB
  5809.         0000h failure
  5810.         BL = status (80h,81h,A2h) (see #1362)
  5811. BUG:    MS-DOS 6.0 HIMEM.SYS leaves CX unchanged
  5812.  
  5813. (Table 1361)
  5814. Call the XMS v3.0 driver "Reallocate any extended memory block" function with:
  5815.     AH = 8Fh
  5816.     DX = unlocked handle
  5817.     EBX = new size in KB
  5818. Return: AX = status
  5819.         0001h success
  5820.         0000h failure
  5821.         BL = status (80h,81h,A0h-A2h,ABh) (see #1362)
  5822. BUG:    HIMEM v3.03-3.07 crash on an 80286 machine if any of the 8Xh functions
  5823.       are called
  5824.  
  5825. (Table 1362)
  5826. Values for XMS error code returned in BL:
  5827.  00h    successful
  5828.  80h    function not implemented
  5829.  81h    Vdisk was detected
  5830.  82h    an A20 error occurred
  5831.  8Eh    a general driver error
  5832.  8Fh    unrecoverable driver error
  5833.  90h    HMA does not exist or is not managed by XMS provider
  5834.  91h    HMA is already in use
  5835.  92h    DX is less than the /HMAMIN= parameter
  5836.  93h    HMA is not allocated
  5837.  94h    A20 line still enabled
  5838.  A0h    all extended memory is allocated
  5839.  A1h    all available extended memory handles are allocated
  5840.  A2h    invalid handle
  5841.  A3h    source handle is invalid
  5842.  A4h    source offset is invalid
  5843.  A5h    destination handle is invalid
  5844.  A6h    destination offset is invalid
  5845.  A7h    length is invalid
  5846.  A8h    move has an invalid overlap
  5847.  A9h    parity error occurred
  5848.  AAh    block is not locked
  5849.  ABh    block is locked
  5850.  ACh    block lock count overflowed
  5851.  ADh    lock failed
  5852.  B0h    only a smaller UMB is available
  5853.  B1h    no UMB's are available
  5854.  B2h    UMB segment number is invalid
  5855.  
  5856. Format of EMM structure:
  5857. Offset    Size    Description    (Table 1363)
  5858.  00h    DWORD    number of bytes to move (must be even)
  5859.  04h    WORD    source handle
  5860.  06h    DWORD    offset into source block
  5861.  0Ah    WORD    destination handle
  5862.  0Ch    DWORD    offset into destination block
  5863. Notes:    if source and destination overlap, only forward moves (source base
  5864.       less than destination base) are guaranteed to work properly
  5865.     if either handle is zero, the corresponding offset is interpreted
  5866.       as a real-mode address referring to memory directly addressable
  5867.       by the processor
  5868.  
  5869. Format of XMS handle info [array]:
  5870. Offset    Size    Description    (Table 1364)
  5871.  00h    BYTE    handle
  5872.  01h    BYTE    lock count
  5873.  02h    DWORD    handle size
  5874.  06h    DWORD    handle physical address (only valid if lock count nonzero)
  5875. SeeAlso: #1330
  5876. --------m-2F4310-----------------------------
  5877. INT 2F - Cloaking - REAL-MODE API
  5878.     AX = 4310h
  5879. Return: ES:BX -> driver entry point (see #1332,#1365,#1366,#1367,#1368)
  5880. SeeAlso: AX=4310h"XMS"
  5881.  
  5882. (Table 1365)
  5883. Call the Cloaking v1.01 "Client Registration" function with:
  5884.     AH = 7Eh
  5885.     BX = subfunction
  5886.         0000h get client registration count
  5887.         0001h get client registration structures
  5888.         ES:DI -> buffer for registration structures
  5889. Return: AX = status
  5890.         0000h failed
  5891.         0001h successful
  5892.             ---subfunction 00h---
  5893.         BX = size of client structure in bytes
  5894.         CX = number of clients installed
  5895.         ---subfunction 01h---
  5896.         ES:DI buffer filled
  5897. SeeAlso: #1366,#1368,INT 2C/AX=0033h
  5898.  
  5899. (Table 1366)
  5900. Call the Cloaking v1.01 "Verify Cloaking Host" function with:
  5901.     AH = 7Fh
  5902. Return: AX = status
  5903.         0000h failed
  5904.         0001h (successful) if installed
  5905.         BX = version (0101h for v1.01)
  5906.         CX = flags
  5907.             bit 0: host is VCPI-based
  5908.         DS:DX -> ASCIZ Cloaking host signature
  5909.             "CLOAKING.EXE"0, followed by a far-call entry point to
  5910.               uninstall host (see #1367) in Helix's CLOAKING.EXE
  5911. SeeAlso: #1365,#1368
  5912. Index:    installation check;Cloaking host|installation check;CLOAKING.EXE
  5913.  
  5914. (Table 1367)
  5915. Call the CLOAKING.EXE "Uninstall Host" function with:
  5916. Return:    AX = 4F4Bh ('OK') if successfully uninstalled protected-mode code
  5917.  
  5918. (Table 1368)
  5919. Call the Cloaking "Start Protected-Mode Client" function with:
  5920.     AH = 82h
  5921.     DX = XMS handle of locked block containing protected-mode code
  5922.     CL = code size (00h 16-bit, else 32-bit)
  5923.     ESI, EDI = parameters to pass to protected-mode code
  5924. Return: AX = status
  5925.         nonzero success
  5926.         0000h failed
  5927.         BL = error code (A2h,B0h) (see #1362)
  5928. Notes:    this function calls a user initialization function at offset 0 in
  5929.       the XMS memory block (see #1369)
  5930.     supported by Helix's RM386 v6.00 and Helix's CLOAKING.EXE
  5931. SeeAlso: #1365,#1366
  5932.  
  5933. (Table 1369)
  5934. Values user initialization function is called with:
  5935.     EBX = physical address of block's start
  5936.     ESI = user data from function 82h call
  5937.     EDI = user data from function 82h call
  5938.     CS = code selector for XMS block at EBX (16-bit or 32-bit)    
  5939.     DS = data selector for XMS block, starting at EBX
  5940.     ES = selector for V86 memory access to full real-mode 1088K
  5941.     GS = selector for full 4G flat address space
  5942.     SS:ESP -> stack provided by host
  5943. Return: via 32-bit FAR return
  5944. Note:    the initialization function may call any protected-mode Cloaking
  5945.       service; it should store the values of DS, ES, and GS for future
  5946.       reference
  5947. --------m-2F4320-----------------------------
  5948. INT 2F U - HIMEM.SYS - Mach 20 SUPPORT
  5949.     AX = 4320h
  5950.     ???
  5951. Return: ???
  5952. --------m-2F4330-----------------------------
  5953. INT 2F CU - HIMEM.SYS v2.77+ - GET EXTERNAL A20 HANDLER ADDRESS
  5954.     AX = 4330h
  5955. Return: AL = 80h if external A20 handler provided
  5956.         ES:BX -> external A20 handler (see #1370)
  5957.         CL = A20 detection support
  5958.         00h handler is unable to report A20 state
  5959.         01h handler supports function 0002h to report A20 state
  5960. Note:    HIMEM.SYS calls this function to allow an external program to provide
  5961.       an A20 handler (i.e. to support a machine not supported by HIMEM
  5962.       itself)
  5963. SeeAlso: AX=4308h,AX=4310h
  5964.  
  5965. (Table 1370)
  5966. Call parameters for external A20 handler are:
  5967.     AX = function
  5968.         0000h disable A20
  5969.         0001h enable A20
  5970.         0002h get A20 state
  5971. Return: AX = status (functions 0000h and 0001h)
  5972.         0000h failure
  5973.         0001h successful
  5974.     AX = A20 state (function 0002h)
  5975.         0000h disabled
  5976.         0001h enabled
  5977. Note:    HIMEM.SYS only calls function 0002h if the returned CL indicated that
  5978.       the handler supports the call
  5979. --------E-2F43E0BX0000-----------------------
  5980. INT 2F - DOS Protected Mode Services (DPMS) v1.0 - INSTALLATION CHECK
  5981.     AX = 43E0h
  5982.     BX = 0000h
  5983.     CX = 4450h ('DP')
  5984.     DX = 4D53h ('MS')
  5985. Return: AX = 0000h if installed
  5986.         CF clear
  5987.         ES:DI -> server structure (see #1371)
  5988.         ES:BX -> registration structure (pre-NWDOS 7 beta spec) (see #1373)
  5989. Note:    the DPMS 1.0 server included with the original release of Novell DOS
  5990.       7.0 supports both the beta and 1.0 specification, setting ES:BX even
  5991.       if CX and DX are not as specified on entry (since the beta
  5992.       specification did not use those registers).  However, the DPMS 1.1
  5993.       server included with the March 1994 update does not support the beta
  5994.       specification
  5995. SeeAlso: AX=43E1h,AX=43E2h,AX=43E3h,INT 2F/AX=1687h
  5996. Index:    signature strings;DPMS
  5997.  
  5998. Format of DPMS 1.0 server structure:
  5999. Offset    Size    Description    (Table 1371)
  6000.  00h  4 BYTEs    signature string "DPMS"
  6001.  04h  2 BYTEs    DPMS version (major,minor)
  6002.  06h  8 BYTEs    blank-padded server OEM name
  6003.  0Eh  2 BYTEs    OEM server version (major,minor)
  6004.  10h    WORD    DPMS flags (see #1372)
  6005.  12h    BYTE    CPU type
  6006.         (02h = 286, 03h = 386 or higher, higher values allowed)
  6007.  
  6008. Bitfields for DPMS flags:
  6009. Bit(s)    Description    (Table 1372)
  6010.  0    fast processor reset available (286 only)
  6011.  1    DPMS server is enabled
  6012.  2    memory is remapped
  6013.  3-15    reserved (undefined)
  6014.  
  6015. Format of beta DPMS registration structure:
  6016. Offset    Size    Description    (Table 1373)
  6017.  00h    DWORD    real-mode API entry point (see #1375)
  6018.  04h    DWORD    16-bit protected-mode API entry point (see #1375)
  6019.  08h  8 BYTEs    reserved (0)
  6020.  10h  8 BYTEs    blank-padded server OEM name
  6021.  18h    WORD    flags
  6022.         bit 0: fast processor reset available (286 only)
  6023.         bits 1-15 reserved (undefined)
  6024.  1Ah  2 BYTEs    DPMS version (major,minor)
  6025.  1Ch    BYTE    CPU type (02h = 286, 03h = 386 or higher)
  6026. ----------2F43E1-----------------------------
  6027. INT 2F - DOS Protected Mode Services (DPMS) v1.0 - REGISTER CLIENT
  6028.     AX = 43E1h
  6029.     CX = required protected-mode stack size in bytes
  6030.     ES:DI -> DPMS client interface structure (see #1374)
  6031. Return: AX = 0000h if supported
  6032.        CF clear
  6033.        ES:DI buffer filled with API entry point code from offset 0Ah
  6034. Note:    the client is allowed to copy the returned API code to any location in
  6035.       memory, and need not keep the three code fields together
  6036. SeeAlso: AX=43E0h,AX=43E2h,AX=43E3h
  6037.  
  6038. Format of DPMS client interface structure:
  6039. Offset    Size    Description    (Table 1374)
  6040.  00h    WORD    0000h (structure version / flags)
  6041.  02h  8 BYTEs    blank-padded client name
  6042.  0Ah  7 BYTEs    real/virtual-86 mode API code (see #1375)
  6043.  11h    BYTE    space for return instruction
  6044.         set to C3h for near return, CBh for far return
  6045.  12h  7 BYTEs    16-bit protected-mode API code (see #1375)
  6046.  19h    BYTE    space for return instruction
  6047.         set to C3h for near return, CBh for far return
  6048.  1Ah  9 BYTEs    32-bit protected-mode API code (see #1375)
  6049.  23h    BYTE    space for return instruction
  6050.         set to C3h for near return, CBh for far return
  6051. Note:    the DPMS server fills the return opcode bytes with zeros and DPMS
  6052.       requests will thus crash the system unless the application
  6053.       explicitly sets them (some early versions set them to C3h by
  6054.       default, but one should not rely on that)
  6055.  
  6056. (Table 1375)
  6057. Call DPMS entry point with:
  6058.     AX = 0000h unregister client from server
  6059.  ---control transfer functions---
  6060.     AX = 0100h call protected-mode procedure
  6061.         CX = number of words of stack to copy
  6062.         ES:(E)DI -> callup/down register structure (see #1377)
  6063.         Return: CF clear if successful
  6064.             CF set on error
  6065.                 AX = error code (see #1376)
  6066.     AX = 0101h call real-mode procedure (RETF return)
  6067.         CX = number of words of stack to copy
  6068.         ES:(E)DI -> callup/down register structure (see #1377)
  6069.         Return: CF clear if successful
  6070.             CF set on error
  6071.                 AX = error code (see #1376)
  6072.     AX = 0102h call real-mode procedure (IRET return)
  6073.         CX = number of words of stack to copy
  6074.         ES:(E)DI -> callup/down register structure (see #1377)
  6075.         Return: CF clear if successful
  6076.             CF set on error
  6077.                 AX = error code (see #1376)
  6078.     AX = 0103h call real-mode interrupt handler
  6079.         BL = interrupt number
  6080.         CX = number of words of stack to copy
  6081.         ES:(E)DI -> callup/down register structure (see #1377)
  6082.         Return: CF clear if successful
  6083.             CF set on error
  6084.                 AX = error code (see #1376)
  6085.     AX = 0104h register default protected mode procedure
  6086.         ES:(E)DI -> default register structure (see #1378)
  6087.         Return: CF clear if successful
  6088.             CF set on error
  6089.                 AX = error code (see #1376)
  6090.     AX = 0105h register default real-mode procedure (RETF return)
  6091.         ES:(E)DI -> default register structure (see #1378)
  6092.         Return: CF clear if successful
  6093.             CF set on error
  6094.                 AX = error code (see #1376)
  6095.         Note:    the procedure will be called from 16-bit prot. mode
  6096.     AX = 0106h register default real-mode procedure (IRET return)
  6097.         ES:(E)DI -> default register structure (see #1378)
  6098.         Return: CF clear if successful
  6099.             CF set on error
  6100.                 AX = error code (see #1376)
  6101.         Note:    the procedure will be called from 16-bit prot. mode
  6102.     AX = 0107h register default real-mode interrupt handler
  6103.         BL = interrupt number
  6104.         ES:(E)DI -> default register structure (see #1378)
  6105.         Return: CF clear if successful
  6106.             CF set on error
  6107.                 AX = error code (see #1376)
  6108.         Note:    the handler will be called from 16-bit protected mode
  6109.     AX = 0108h register default real-mode procedure (RETF return)
  6110.         ES:(E)DI -> default register structure (see #1378)
  6111.         Return: CF clear if successful
  6112.             CF set on error
  6113.                 AX = error code (see #1376)
  6114.         Note:    the procedure will be called from 32-bit prot. mode
  6115.     AX = 0109h register default real-mode procedure (IRET return)
  6116.         ES:(E)DI -> default register structure (see #1378)
  6117.         Return: CF clear if successful
  6118.             CF set on error
  6119.                 AX = error code (see #1376)
  6120.         Note:    the procedure will be called from 32-bit prot. mode
  6121.     AX = 010Ah register default real-mode interrupt handler
  6122.         BL = interrupt number
  6123.         ES:(E)DI -> default register structure (see #1378)
  6124.         Return: CF clear if successful
  6125.             CF set on error
  6126.                 AX = error code (see #1376)
  6127.         Note:    the handler will be called from 32-bit protected mode
  6128.  ---descriptor management---
  6129.     AX = 0200h allocate descriptors
  6130.         CX = number of descriptors to allocate
  6131.         Return: CF clear if successful
  6132.                 AX = selector for first descriptor allocated
  6133.             CF set on error
  6134.                 AX = error code (see #1376)
  6135.     AX = 0201h free a descriptor
  6136.         BX = selector for descriptor
  6137.         Return: CF clear if successful
  6138.             CF set on error
  6139.                 AX = error code (see #1376)
  6140.     AX = 0202h create alias descriptor
  6141.         BX = selector for descriptor to be aliased
  6142.         Return: CF clear if successful
  6143.                 AX = alias descriptor
  6144.             CF set on error
  6145.                 AX = error code (see #1376)
  6146.     AX = 0203h build alias to real-mode segment
  6147.         BX = descriptor
  6148.         CX = real-mode segment
  6149.         Return: CF clear if successful
  6150.             CF set on error
  6151.                 AX = error code (see #1376)
  6152.     AX = 0204h set descriptor base
  6153.         BX = descriptor
  6154.         CX:DX = base address
  6155.         Return: CF clear if successful
  6156.             CF set on error
  6157.                 AX = error code (see #1376)
  6158.     AX = 0205h set descriptor limit
  6159.         BX = descriptor
  6160.         CX = limit
  6161.         Return: CF clear if successful
  6162.             CF set on error
  6163.                 AX = error code (see #1376)
  6164.     AX = 0206h set descriptor type/attribute
  6165.         BX = descriptor
  6166.         CL = type
  6167.         CH = attribute
  6168.         Return: CF clear if successful
  6169.             CF set on error
  6170.                 AX = error code (see #1376)
  6171.     AX = 0207h get descriptor base
  6172.         BX = descriptor
  6173.         Return: CF clear if successful
  6174.                 CX:DX = base address
  6175.             CF set on error
  6176.                 AX = error code (see #1376)
  6177.  ---linear memory functions---
  6178.     AX = 0300h get size of largest free block of memory
  6179.         Return: CF clear if successful
  6180.                 BX:CX = size
  6181.             CF set on error
  6182.                 AX = error code (see #1376)
  6183.     AX = 0301h allocate block of extended memory
  6184.         BX:CX = required size
  6185.         Return: CF clear if successful
  6186.                 BX:CX = base address
  6187.                 SI:DI = handle
  6188.             CF set on error
  6189.                 AX = error code (see #1376)
  6190.     AX = 0302h free block of extended memory
  6191.         SI:DI = handle
  6192.         Return: CF clear if successful
  6193.             CF set on error
  6194.                 AX = error code (see #1376)
  6195.     AX = 0303h map linear memory
  6196.         ES:(E)DI -> DDS (see #1379)
  6197.         Return: CF clear if successful
  6198.                 BX:CX = base address
  6199.                 SI:DI = handle
  6200.             CF set on error
  6201.                 AX = error code (see #1376)
  6202.     AX = 0304h unmap linear memory
  6203.         SI:DI = handle
  6204.         Return: CF clear if successful
  6205.             CF set on error
  6206.                 AX = error code (see #1376)
  6207.     AX = 0305h get page table entries
  6208.         ESI = linear address
  6209.         (E)CX = count
  6210.         ES:(E)DI -> buffer for page table entries
  6211.         Return: CF clear if successful
  6212.                 ES:(E)DI buffer filled
  6213.             CF set on error
  6214.                 AX = error code (see #1376)
  6215.     AX = 0306h set page table entries
  6216.         EBX = linear memory handle
  6217.         ESI = linear address
  6218.         (E)CX = count
  6219.         ES:(E)DI -> buffer containing page table entries
  6220.         Return: CF clear if successful
  6221.             CF set on error
  6222.                 AX = error code (see #1376)
  6223.     AX = 0307h get largest mappable block size
  6224.         Return: CF clear if successful
  6225.                 BX:CX = size
  6226.             CF set on error
  6227.                 AX = error code (see #1376)
  6228.  ---miscellaneous---
  6229.     AX = 0400h relocate segment to extended memory
  6230.         ES:SI = base address
  6231.         CX = limit
  6232.         BL = type
  6233.         BH = attribute
  6234.         DX = selector or 0000h
  6235.         Return: CF clear if successful
  6236.                 AX = selector
  6237.                 BX:CX = new base address
  6238.                 SI:DI = handle
  6239.             CF set on error
  6240.                 AX = error code (see #1376)
  6241. Note:    the beta DPMS specification, which is still supported by the Novell
  6242.       DOS 7.0 DPMS host, only supported functions 0100h-0103h, 0200h-0207h,
  6243.       0300h-0304h, and 0400h
  6244.  
  6245. (Table 1376)
  6246. Values for DPMS error code:
  6247.  8000h    general error
  6248.  8001h    unsupported function
  6249.  8002h    unable to switch to protected mode
  6250.  8004h    no default stack defined
  6251.  8005h    unknown client
  6252.  8010h    resource unavailable
  6253.  8011h    descriptor unavailable
  6254.  8012h    linear memory unavailable
  6255.  8013h    physical memory unavailable
  6256.  8021h    invalid value
  6257.  8022h    invalid selector
  6258.  8023h    invalid handle
  6259.  8025h    invalid linear address
  6260.  
  6261. Format of DPMS callup/down register structure:
  6262. Offset    Size    Description    (Table 1377)
  6263.  00h    DWORD    EDI
  6264.  04h    DWORD    ESI
  6265.  08h    DWORD    EBP
  6266.  0Ch  4 BYTEs    reserved (0) (ESP, may be used by DPMS server)
  6267.  10h    DWORD    EBX
  6268.  14h    DWORD    EDX
  6269.  18h    DWORD    ECX
  6270.  20h    DWORD    EAX
  6271.  24h    DWORD    EIP
  6272.  28h    WORD    CS
  6273.  2Ah  2 BYTEs    reserved (0)
  6274.  2Ch    DWORD    EFLAGS
  6275.  30h    DWORD    ESP
  6276.  34h    WORD    SS
  6277.  36h  2 BYTEs    reserved (0)
  6278.  38h    WORD    ES
  6279.  3Ah  2 BYTEs    reserved (0)
  6280.  3Ch    WORD    DS
  6281.  3Eh  2 BYTEs    reserved (0)
  6282.  40h    WORD    FS
  6283.  42h  2 BYTEs    reserved (0)
  6284.  44h    WORD    GS
  6285.  46h  2 BYTEs    reserved (0)
  6286.  
  6287. Format of DPMS default register structure:
  6288. Offset    Size    Description    (Table 1378)
  6289.  00h    DWORD    EIP
  6290.  04h    WORD    CS
  6291.  06h  2 BYTEs    reserved (0)
  6292.  08h    WORD    number of words to copy from stack to stack
  6293.  0Ah    BYTE    (call) 00h
  6294.         (return) nonzero if call could not be made
  6295.  0Bh    BYTE    reserved (may be used by some servers)
  6296.  0Ch    DWORD    ESP
  6297.  10h    WORD    SS
  6298.  12h  2 BYTEs    reserved (0)
  6299.  14h    WORD    ES
  6300.  16h  2 BYTEs    reserved (0)
  6301.  18h    WORD    DS
  6302.  1Ah  2 BYTEs    reserved (0)
  6303.  1Ch    WORD    FS
  6304.  1Eh  2 BYTEs    reserved (0)
  6305.  20h    WORD    GS
  6306.  22h  2 BYTEs    reserved (0)
  6307.  24h  9 BYTEs    API entry code (filled in by server)
  6308.  
  6309. Format of DPMS lock DDS:
  6310. Offset    Size    Description    (Table 1379)
  6311.  00h    DWORD    total size in bytes
  6312.  04h    DWORD    offset
  6313.  08h    WORD    segment or selector
  6314.  0Ah    WORD    reserved
  6315.  0Ch    WORD    maximum number of physical blocks structure has space for
  6316.  0Eh    WORD    number of physical blocks listed
  6317.  10h    DWORD    physical address of first block
  6318.  14h    DWORD    size in bytes of first block
  6319.     ...
  6320. ----------2F43E2-----------------------------
  6321. INT 2F - DOS Protected Mode Services (DPMS) v1.0 - ENABLE/DISABLE DPMS
  6322.     AX = 43E2h
  6323.     BX = new state (0000h disable, 0001h enable)
  6324. Return: AX = 0000h if supported
  6325. Note:    this function should normally be called only by system software
  6326. SeeAlso: AX=43E0h,AX=43E1h,AX=43E3h
  6327. ----------2F43E3BX0000-----------------------
  6328. INT 2F - DOS Protected Mode Services (DPMS) v1.0 - DPMS STARTUP BROADCAST
  6329.     AX = 43E3h
  6330.     BX = 0000h
  6331.     CX = 4450h ('DP')
  6332.     DX = 4D53h ('MS')
  6333. SeeAlso: AX=43E0h,AX=43E4h 
  6334. ----------2F43E4BX0000-----------------------
  6335. INT 2F - DOS Protected Mode Services (DPMS) v1.0 - DPMS EXIT BROADCAST
  6336.     AX = 43E4h
  6337.     BX = 0000h
  6338.     CX = 4450h ('DP')
  6339.     DX = 4D53h ('MS')
  6340. SeeAlso: AX=43E0h,AX=43E3h 
  6341. --------E-2F44-------------------------------
  6342. INT 2F U - DOS Extender support???
  6343.     AH = 44h
  6344.     AL = function (at least 0Bh, 15h, 17h)
  6345.     ???
  6346. Return: ???
  6347. Note:    called by Codeview for Windows
  6348. SeeAlso: AH=86h
  6349. --------G-2F4500-----------------------------
  6350. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - INSTALLATION CHECK
  6351.     AX = 4500h
  6352. Return: AL = installation status
  6353.         01h if PROF.COM installed
  6354.         02h if VPROD.386 installed
  6355. SeeAlso: AX=4501h,AX=4502h
  6356. --------G-2F4501-----------------------------
  6357. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - SETUP PROFILER
  6358.     AX = 4501h
  6359.     BX = CSIPS buffer size in KB (first parameter for ProfSetup)
  6360.     CX = output limit in KB (second parameter for ProfSetup)
  6361. Note:    this call is not supported by PROF.COM
  6362. SeeAlso: AX=4502h,AX=4503h
  6363. --------G-2F4502-----------------------------
  6364. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - SET SAMPLING RATE
  6365.     AX = 4502h
  6366.     BL = sampling rate for PROF.COM (0 < BL <= 13)
  6367.         (01h = 8192/s, 04h = 1024/s, 08h = 32/s, 0Dh = 1/s)
  6368.     CX = sampling rate for VPROD.386
  6369. Note:    for PROF.COM, this programs the CMOS clock by setting BL+2 as the
  6370.       low four bits of CMOS register 0Ah.  The interruption rate is
  6371.       1 SHL (15 - BL) per second.
  6372. SeeAlso: AX=4501h,AX=4503h
  6373. --------G-2F4503-----------------------------
  6374. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - START PROFILING
  6375.     AX = 4503h
  6376. Notes:    Profiling is also turned on by the key combinations
  6377.       LeftShift + RightShift + Alt and LeftShift + RightShift + Ctrl
  6378.     for PROF.COM, this call programs the CMOS clock by reading register
  6379.       0Ch, and setting bit 6 of register 0Bh.  It then makes sure that IRQ8
  6380.       is unmasked
  6381. SeeAlso: AX=4504h
  6382. --------G-2F4504-----------------------------
  6383. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - STOP PROFILING
  6384.     AX = 4504h
  6385. Notes:    profiling is also turned off by the key combination
  6386.       LeftShift + RightShift
  6387.     for PROF.COM, this programs the CMOS clock by reading register 0Ch
  6388.       and clearing bit 6 of register 0Bh.  It then masks IRQ8.
  6389. SeeAlso: AX=4503h,AX=4505h,AX=4506h,AX=4507h
  6390. --------G-2F4505-----------------------------
  6391. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - CLEAR PROFILING DATA
  6392.     AX = 4505h
  6393. SeeAlso: AX=4503h,AX=4504h,AX=4506h
  6394. --------G-2F4506-----------------------------
  6395. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - "ProfFlush"
  6396.     AX = 4506h
  6397. SeeAlso: AX=4505h,AX=4507h
  6398. --------G-2F4507-----------------------------
  6399. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - "ProfFinish"
  6400.     AX = 4507h
  6401. Note:    this call is essentially a "ProfStop" (AX=4504h) followed by
  6402.       "ProfFlush" (AX=4506h)
  6403. SeeAlso: AX=4504h,AX=4505h,AX=4506h
  6404. --------G-2F4508-----------------------------
  6405. INT 2F U - Microsoft Profiler (PROF.COM/VPROD.386) - ALTERNATE SEGDEBUG IFACE
  6406.     AX = 4508h
  6407.     BX = ordinal (or 0000h)
  6408.     CX = segment
  6409.     DX = instance (or 0000h)
  6410.     SI = type (or 0000h)
  6411.     ES:DI -> ASCIZ module name
  6412. Notes:    this call is an alternate entry to the profiler's SEGDEBUG
  6413.       interface, but only to function 0, for notifying the profiler of
  6414.       each new segment loaded.  The SHOWHITS utility then examines the
  6415.       profiler's output files (CSIPS.DAT and SEGENTRY.DAT) in conjunction
  6416.       with symbol files to provide information in a useful form.
  6417.     this call does not have a corresponding Windows function
  6418. SeeAlso: AX=4500h
  6419. --------D-2F4601-----------------------------
  6420. INT 2F CU - MS Windows WINOLDAP - SWITCHING ???
  6421.     AX = 4601h
  6422. Return: ???
  6423. Note:    the DOS 5+ kernel intercepts this function and copies the MCB
  6424.        following the caller's PSP memory block into the DOS data segment;
  6425.        in conjunction with AX=4602h, this intercept is used by DOS to
  6426.        avoid corruption of the Windows real-mode heap's end sentinel
  6427. SeeAlso: AX=1700h,AX=4602h
  6428. --------D-2F4602-----------------------------
  6429. INT 2F CU - MS Windows WINOLDAP - SWITCHING ???
  6430.     AX = 4602h
  6431. Return: ???
  6432. Note:    the DOS 5+ kernel intercepts this function and copies the
  6433.       previously-saved MCB from the DOS data segment into the MCB following
  6434.       the caller's PSP memory block; in conjunction with AX=4601h, this
  6435.       intercept is used by DOS to avoid corruption of the Windows real-mode
  6436.       heap's end sentinel
  6437. SeeAlso: AX=1700h,AX=4601h
  6438. --------E-2F46-------------------------------
  6439. INT 2F U - Windows/286 DOS Extender
  6440.     AH = 46h
  6441.     AL = subfunction (03h,04h)
  6442. Return: ???
  6443. Note:    these two subfunctions are called by MS Windows 3.0
  6444. --------v-2F4653CX0002-----------------------
  6445. INT 2F - F-PROT v1.x only - F-LOCK.EXE - API
  6446.     AX = 4653h
  6447.     CX = 0002h
  6448.     BX = subfunction
  6449.         0000h  installation check
  6450.         Return: AX = FFFFh
  6451.         0001h  uninstall
  6452.         Return: AX,BX,ES destroyed
  6453.         0002h  disable (v1.08 and below only)
  6454.         0003h  enable (v1.08 and below only)
  6455. Program: F-LOCK is part of the shareware F-PROT virus/trojan protection
  6456.       package by Fridrik Skulason
  6457. SeeAlso: AX=4653h/CX=0003h,AX=CA00h,INT 21/AX=4BEEh
  6458. Index:    installation check;F-LOCK|uninstall;F-LOCK
  6459. --------v-2F4653CX0003-----------------------
  6460. INT 2F - F-PROT v1.x only - F-XCHK.EXE - API
  6461.     AX = 4653h
  6462.     CX = 0003h
  6463.     BX = subfunction
  6464.         0000h  installation check
  6465.         Return: AX = FFFFh
  6466.         0001h  uninstall
  6467.         Return: AX,BX,ES destroyed
  6468. Program: F-XCHK is part of the shareware F-PROT virus/trojan protection
  6469.       package by Fridrik Skulason
  6470. SeeAlso: AX=4653h/CX=0002h,AX=4653h/CX=0004h,AX=CA00h
  6471. Index:    installation check;F-XCHK|uninstall;F-XCHK
  6472. --------v-2F4653CX0004-----------------------
  6473. INT 2F - F-PROT v1.x only - F-POPUP.EXE - API
  6474.     AX = 4653h
  6475.     CX = 0004h
  6476.     BX = subfunction
  6477.         0000h  installation check
  6478.         Return: AX = FFFFh
  6479.         0001h  uninstall
  6480.         Return: AX,BX,ES destroyed
  6481.         0002h  disable (v1.08 and below only)
  6482.            display message (v1.14+)
  6483.             other registers: ???
  6484.         0003h  enable (v1.08 and below only)
  6485.            display message (v1.14+)
  6486.             other registers: ???
  6487.             Return: AX = key pressed by user
  6488. Program: F-POPUP is part of the shareware F-PROT virus/trojan protection
  6489.       package by Fridrik Skulason
  6490. SeeAlso: AX=4653h/CX=0003h,AX=4653h/CX=0005h,AX=CA00h
  6491. Index:    installation check;F-POPUP|uninstall;F-POPUP
  6492. --------v-2F4653CX0005-----------------------
  6493. INT 2F - F-PROT v1.x only - F-DLOCK.EXE - API
  6494.     AX = 4653h
  6495.     CX = 0005h
  6496.     BX = subfunction
  6497.         0000h installation check
  6498.         Return: AX = FFFFh
  6499.         0001h uninstall
  6500.         Return: AX,BX,ES destroyed
  6501. Program: F-DLOCK is part of the shareware F-PROT virus/trojan protection
  6502.       package by Fridrik Skulason
  6503. SeeAlso: AX=4653h/CX=0004h,AX=CA00h
  6504. Index:    installation check;F-DLOCK|uninstall;F-DLOCK
  6505. --------W-2F4680-----------------------------
  6506. INT 2F U - MS Windows v3.0 - INSTALLATION CHECK
  6507.     AX = 4680h
  6508. Return: AX = result
  6509.         0000h MS Windows 3.0 running in real (/R) or standard (/S) mode,
  6510.           or DOS 5 DOSSHELL active
  6511.         nonzero  no Windows, Windows prior to 3.0, or Windows3 in enhanced
  6512.           mode
  6513. Note:    Windows 3.1 finally provides an installation check which works in all
  6514.       modes (see AX=160Ah)
  6515. SeeAlso: AX=1600h,AX=160Ah
  6516. ----------2F47-------------------------------
  6517. INT 2F U - ???
  6518.     AH = 47h
  6519.     ???
  6520. Return: ???
  6521. Note:    reportedly called by Microsoft BASIC Compiler v7.0
  6522. --------K-2F4800-----------------------------
  6523. INT 2F - DOS 5+ DOSKEY - INSTALLATION CHECK
  6524.     AX = 4800h
  6525. Return: AL = nonzero if installed (DOS 5.0 and 6.0 return AX=AA02h)
  6526.         ES = segment of DOSKEY resident portion
  6527. Note:    DOSKEY chains if AL is not 00h or 10h on entry
  6528. SeeAlso: AX=4800h"PCED",AX=4810h
  6529. --------K-2F4800-----------------------------
  6530. INT 2F - PCED v2.1 - INSTALLATION CHECK
  6531.     AX = 4800h
  6532. Return: AX = AACDh if installed
  6533.         ES = segment of PCED kernel (PCED has multiple code segments)
  6534. Program: PCED v2.1 is a command line editor/history/macro facility by
  6535.       Cove Software.  It is the commercial version of the freeware CED.
  6536. Notes:    DOSKEY also responds to this call if installed, returning AX=AA02h.
  6537.     unlike DOSKEY, PCED does *not* chain if AL contains an
  6538.       unsupported function code.  It IRETs with all registers intact.
  6539. --------K-2F4810-----------------------------
  6540. INT 2F - DOS 5+ DOSKEY, PCED v2.1 - READ INPUT LINE FROM CONSOLE
  6541.     AX = 4810h
  6542.     DS:DX -> line buffer (see INT 21/AH=0Ah)
  6543. Return: AX = 0000h if successful
  6544. Notes:    the first byte (length) of the buffer MUST be 80h, or DOSKEY chains to
  6545.       the previous handler; PCED allows sizes other than 80h
  6546.     if the user's input is a macro name, no text is placed in the buffer
  6547.       even though AX=0000h on return; the program must immediately issue
  6548.       this call again to retrieve the expansion of the macro.  Similarly,
  6549.       if the user enters a special parameter such as $*, this call must
  6550.       be repeated to retrieve the expansion; on the second call, DOSKEY
  6551.       overwrites the macro name on the screen with its expansion.
  6552.     unlike DOSKEY, PCED expands all macros on the first call, so it is
  6553.       not necessary to make two calls; since the buffer is not empty on
  6554.       return, DOSKEY-aware programs will not make the second call
  6555.     DOSKEY chains if AL is not 00h or 10h on entry
  6556. SeeAlso: AX=4800h,INT 21/AH=0Ah
  6557. --------K-2F48C0-----------------------------
  6558. INT 2F - PCED v2.1 - PCED API
  6559.     AX = 48C0h
  6560.     DX = API function code
  6561.     other registers as required by the specified function
  6562. Return: CF clear if successful
  6563.     CF set on error
  6564.         AX = PCED error code
  6565.     other registers as appropriate for API function
  6566. Program: PCED v2.1 is a command line editor/history/macro facility by
  6567.       Cove Software.  It is the commercial version of the freeware CED.
  6568. Note:    the full API information is available from Cove Software
  6569. SeeAlso: AX=4800h"PCED",AX=48C1h,AX=48C2h,AX=48C3h
  6570. ----------2F48C1BL00-------------------------
  6571. INT 2F - PCED/VSTACK - INSTALLATION CHECK
  6572.     AX = 48C1h
  6573.     BL = 00h
  6574. Return: AX = 0000h if installed
  6575.         BX = VSTACK resident segment
  6576. Program: VSTACK is a resident backscroll utility included as part of the PCED
  6577.       package by Cove Software
  6578. Note:    chains if BL <> 00h on entry
  6579. SeeAlso: AX=48C0h,AX=48C2h
  6580. ----------2F48C2BL00-------------------------
  6581. INT 2F - PCED/ATTRIB - INSTALLATION CHECK
  6582.     AX = 48C2h
  6583.     BL = 00h
  6584. Return: AX = 0000h if installed
  6585.         BX = ATTRIB resident segment
  6586. Program: ATTRIB is a resident file attribute changer included as part of the
  6587.       PCED package by Cove Software
  6588. Note:    chains if BL <> 00h on entry
  6589. SeeAlso: AX=48C0h,AX=48C1h,AX=48C3h
  6590. --------K-2F48C3BL00-------------------------
  6591. INT 2F - PCED/KEYDEF - INSTALLATION CHECK
  6592.     AX = 48C3h
  6593.     BL = 00h
  6594. Return: AX = 0000h if installed
  6595.         BX = KEYDEF resident segment
  6596. Program: KEYDEF is a resident keyboard redefinition utility included as part
  6597.       of the PCED package by Cove Software
  6598. Note:    chains if BL <> 00h on entry
  6599. SeeAlso: AX=48C0h,AX=48C2h,AX=48C4h
  6600. ----------2F48C4BL00-------------------------
  6601. INT 2F - PCED/FLIST - INSTALLATION CHECK
  6602.     AX = 48C4h
  6603.     BL = 00h
  6604. Return: AX = 0000h if installed
  6605.         BX = FLIST resident segment
  6606. Program: FLIST is a resident filelist processor included as part of the PCED
  6607.       package by Cove Software
  6608. Note:    chains if BL <> 00h on entry
  6609. SeeAlso: AX=48C0h,AX=48C3h,AX=48C5h
  6610. ----------2F48C4BL00-------------------------
  6611. INT 2F - PCED/ASSOC - INSTALLATION CHECK
  6612.     AX = 48C4h
  6613.     BL = 00h
  6614. Return: AX = 0000h if installed
  6615.         BX = ASSOC resident segment
  6616. Program: ASSOC is a resident utility included as part of the PCED package which
  6617.       associated files with executable programs based on their extensions
  6618. Note:    chains if BL > 02h on entry
  6619. SeeAlso: AX=48C0h,AX=48C4h,AX=48C5h/BL=01h,AX=48C5h/BL=02h
  6620. ----------2F48C5BL01-------------------------
  6621. INT 2F - PCED/ASSOC - VERSION CHECK
  6622.     AX = 48C5h
  6623.     BL = 01h
  6624. Return: AX = 0000h if installed
  6625.         BX = binary ASSOC version (BL = major, BH = minor)
  6626. Note:    chains if BL > 02h on entry
  6627. SeeAlso: AX=48C0h,AX=48C5h/BL=00h,AX=48C5h/BL=02h
  6628. ----------2F48C5BL02-------------------------
  6629. INT 2F - PCED/ASSOC - ASSOCIATION TEST
  6630.     AX = 48C5h
  6631.     BL = 02h
  6632.     DS:SI -> ASCIZ filename
  6633. Return: AX = status
  6634.         0000h if filename is unknown
  6635.         0001h if there is an association defined for the file
  6636.     BX destroyed
  6637. Program: ASSOC is a resident utility included as part of the PCED package which
  6638.       associated files with executable programs based on their extensions
  6639. Note:    chains if BL > 02h on entry
  6640. SeeAlso: AX=48C0h,AX=48C5h/BL=00h,AX=48C5h/BL=01h
  6641. ----------2F49-------------------------------
  6642. INT 2F U - ???
  6643.     AH = 49h
  6644.     ???
  6645. Return: ???
  6646. Note:    reportedly called by DOS 5.0 installation
  6647. --------D-2F4A00CX0000-----------------------
  6648. INT 2F CU - DOS 5+ - FLOPPY-DISK LOGICAL DRIVE CHANGE NOTIFICATION
  6649.     AX = 4A00h
  6650.     CX = 0000h
  6651.     DH = new drive number
  6652.     DL = current drive number
  6653. Return: CX = FFFFh to skip "Insert diskette for drive X:" message
  6654. Note:    called by MS-DOS 5.0+ IO.SYS just before displaying the message
  6655.       "Insert diskette for drive X:" on single-floppy systems
  6656. --------D-2F4A01-----------------------------
  6657. INT 2F - DOS 5+ - QUERY FREE HMA SPACE
  6658.     AX = 4A01h
  6659. Return: BX = number of bytes available in HMA (0000h if DOS not using HMA)
  6660.     ES:DI -> start of available HMA area (FFFFh:FFFFh if not using HMA)
  6661. Note:    called by Windows 3.1 DOSX.EXE
  6662. SeeAlso: AX=4310h,AX=4A02h
  6663. --------D-2F4A02-----------------------------
  6664. INT 2F - DOS 5+ - ALLOCATE HMA SPACE
  6665.     AX = 4A02h
  6666.     BX = number of bytes
  6667. Return: ES:DI -> start of allocated HMA block or FFFFh:FFFFh
  6668.     BX = number of bytes actually allocated (rounded up to next paragraph
  6669.           for DOS 5.0 and 6.0)
  6670. Notes:    this call is not valid unless DOS is loaded in the HMA (DOS=HIGH)
  6671.     called by Windows 3.1 DOSX.EXE
  6672. SeeAlso: AX=4A01h
  6673. --------T-2F4A05-----------------------------
  6674. INT 2F U - DOS 5+ DOSSHELL - TASK SWITCHING API???
  6675.     AX = 4A05h
  6676.     SI = function
  6677.         0000h reset???
  6678.         0001h ???
  6679.         ES:BP -> 80-byte buffer containing ???
  6680.         0002h ???
  6681.         0003h ???
  6682.         0004h ???
  6683.         BL = ???
  6684.         0005h ???
  6685.         0006h get ???
  6686.         Return: ES:SI -> ???
  6687.         0007h get ???
  6688.         Return: AX = ???
  6689.         0008h get ???
  6690.         Return: DX:AX -> ??? (internal control data of some kind)
  6691.         0009h get ???
  6692.         Return: ES:SI -> ??? (apparently identical to function 0006h)
  6693.         000Ah ???
  6694.         BL = length of buffer
  6695.         ES:BP -> buffer containing ???
  6696.         000Bh get ???
  6697.         Return: AX = ???
  6698.         000Ch ???
  6699.         BL = ???
  6700.         Return: if BL nonzero on entry
  6701.                 DX:AX -> ???
  6702.             if BL = 00h on entry
  6703.                 ES:SI -> ???
  6704. Notes:    DOSSHELL chains to the previous handler if SI is not one of the values
  6705.       listed above
  6706.     the DOSSWAP.EXE module calls functions 03h,04h,05h,07h,08h,09h,0Ch
  6707.     the Windows 3.1 DSWAP.EXE and WSWAP.EXE task switchers use these calls
  6708. SeeAlso: AX=4B01h
  6709. --------D-2F4A06-----------------------------
  6710. INT 2F CU - DOS 5+ - DOS SUPERVISOR "REBOOT PANEL" - ADJUST MEMORY SIZE
  6711.     AX = 4A06h
  6712.     DX = segment following last byte of conventional memory
  6713. Return: DX = segment following last byte of memory available for use by DOS
  6714. Desc:    used to override the default memory size when booting diskless
  6715.       workstations
  6716. Notes:    called by MS-DOS 5+ IO.SYS startup code if the signature "RPL" is
  6717.       present three bytes beyond the INT 2F handler; this call overrides
  6718.       the value returned by INT 12
  6719.     hooked by RPL code at the top of memory to protect itself from being
  6720.       overwritten; DOS builds a memory block with owner = 0008h and name
  6721.       "RPL" which must be freed by the RPL code when it is done
  6722. SeeAlso: INT 12,INT 18
  6723. --------N-2F4A07-----------------------------
  6724. INT 2F U - RESERVED FOR PROTMAN SUPPORT
  6725.     AX = 4A07h
  6726.     ???
  6727. Return: ???
  6728. --------c-2F4A10BX0000-----------------------
  6729. INT 2F - SMARTDRV v4.00+ - INSTALLATION CHECK AND HIT RATIOS
  6730.     AX = 4A10h
  6731.     BX = 0000h
  6732.     CX = EBABh (v4.1+; see Note)
  6733. Return: AX = BABEh if installed
  6734.         DX:BX = cache hits
  6735.         DI:SI = cache misses
  6736.         CX = number of dirty cache elements
  6737.         BP = version in BCD (4.10 = 0410h)
  6738. Notes:    most of the SMARTDRV API, including this call, is supported by
  6739.       PC-Cache v8.0 and recent versions of the Norton Caches
  6740.     if DBLSPACE.BIN is installed but SMARTDRV has not yet been installed,
  6741.       then calls of this function with CX<>EBABh on entry cause
  6742.       DBLSPACE.BIN to display the error message
  6743.       "Cannot run SMARTDrive 4.0 with DoubleSpace" and abort the caller
  6744.       with INT 21/AX=4C00h
  6745.     SMARTDRV v3.x had a completely different API using IOCTL calls, which
  6746.       was also supported by the Norton Caches
  6747. SeeAlso: AX=4A10h/BX=0001h,AX=4A10h/BX=0004h,AX=4A10h/BX=0005h
  6748. SeeAlso: AX=4A10h/BX=0007h,AX=4A10h/BX=1234h,AX=4A11h/BX=0000h
  6749. SeeAlso: INT 21/AX=4402h"SMARTDRV",INT 21/AX=4403h"SMARTDRV"
  6750. ----------2F4A10BX0000-----------------------
  6751. INT 2F U - Novell NWCACHE - ???
  6752.     AX = 4A10h
  6753.     BX = 0000h
  6754.     CX = 0EDCh
  6755. Return: ???
  6756. SeeAlso: AX=4A10h/BX=0001h"NWCACHE"
  6757. --------c-2F4A10BX0001-----------------------
  6758. INT 2F - SMARTDRV v4.00+ - FLUSH BUFFERS (COMMIT CACHE)
  6759.     AX = 4A10h
  6760.     BX = 0001h
  6761. Note:    this function is also supported by PC-Cache v8.0.
  6762. SeeAlso: AX=4A10h/BX=0000h,AX=4A10h/BX=0002h
  6763. ----------2F4A10BX0001-----------------------
  6764. INT 2F U - Novell NWCACHE - ???
  6765.     AX = 4A10h
  6766.     BX = 0001h
  6767.     CX = 0EDCh
  6768. Return: ???
  6769. SeeAlso: AX=4A10h/BX=0000h"NWCACHE"
  6770. --------c-2F4A10BX0002-----------------------
  6771. INT 2F - SMARTDRV v4.00+ - RESET CACHE
  6772.     AX = 4A10h
  6773.     BX = 0002h
  6774. Note:    this function is also supported by PC-Cache v8.0.
  6775. SeeAlso: AX=4A10h/BX=0000h,AX=4A10h/BX=0001h
  6776. --------c-2F4A10BX0003-----------------------
  6777. INT 2F - SMARTDRV v4.00+ - STATUS
  6778.     AX = 4A10h
  6779.     BX = 0003h
  6780.     BP = drive number (0=A, 1=B, etc.)
  6781.     DL = subfunction
  6782.         00h only get information
  6783.         01h turn on read cache
  6784.         02h turn off read cache
  6785.         03h turn on write cache
  6786.         04h turn off write cache
  6787. Return: AX = BABEh if OK
  6788.     DL = status (see #1380)
  6789.     DL = FFh if drive does not exist
  6790. Notes:    If the read cache is off, reads will not be cached, but writes will
  6791.       continue to be cached if the write-cache is enabled.
  6792.     this function is also supported by PC-Cache v8.0.
  6793. SeeAlso: AX=4A10h/BX=0000h
  6794.  
  6795. Bitfields for SMARTDRV status:
  6796. Bit(s)    Description    (Table 1380)
  6797.  7    not cached
  6798.  6    write-through (not write-cached)
  6799.  0-5    real drive number (0=A, 1=B...)
  6800. --------c-2F4A10BX0004-----------------------
  6801. INT 2F - SMARTDRV v4.00+ - GET CACHE SIZE
  6802.     AX = 4A10h
  6803.     BX = 0004h
  6804. Return: AX = size in elements of full-sized cache
  6805.     BX = current size in elements
  6806.     CX = size of one element in bytes
  6807.     DX = number of elements under Windows
  6808. Note:    this function is also supported by PC-Cache v8.0.
  6809. SeeAlso: AX=4A10h/BX=0000h,AX=4A10h/BX=0003h,AX=4A10h/BX=0005h
  6810. --------c-2F4A10BX0005-----------------------
  6811. INT 2F - SMARTDRV v4.00+ - GET DOUBLE-BUFFER STATUS
  6812.     AX = 4A10h
  6813.     BX = 0005h
  6814.     BP = drive number (0=A, 1=B...)
  6815. Return: AX = BABEh if double-buffered
  6816.         ES:DI -> 16-byte array of status bytes for fixed disks (see #1381)
  6817. SeeAlso: AX=4A10h/BX=0000h,AX=4A10h/BX=0003h,AX=4A10h/BX=0006h
  6818.  
  6819. (Table 1381)
  6820. Values for SMARTDRV status byte:
  6821.  00h    state unknown
  6822.  FFh    drive double-buffered
  6823.  else    not double-buffered
  6824. --------c-2F4A10BX0006-----------------------
  6825. INT 2F CU - SMARTDRV v4.00+ - CHECK IF DRIVE CACHEABLE
  6826.     AX = 4A10h
  6827.     BX = 0006h
  6828.     CL = drive number (01h = A:)
  6829. Return: AX = 0006h if drive should not be cached by SMARTDRV
  6830. Note:    called by SMARTDRV at startup to determine whether it should cache
  6831.       a particular drive
  6832. SeeAlso: AX=4A10h/BX=0000h
  6833. --------c-2F4A10BX0007-----------------------
  6834. INT 2F - SMARTDRV v4.00+ - GET DEVICE DRIVER FOR DRIVE
  6835.     AX = 4A10h
  6836.     BX = 0007h
  6837.     BP = drive number (00h=A:)
  6838. Return: DL = unit number within device driver
  6839.     ES:DI -> device driver header for drive
  6840. Note:    this function is also supported by PC-Cache v8.0.
  6841.     this call is reported to always return the driver header of the
  6842.       standard block driver (A:-C:+) for SmartDrive v5.00 from MS-DOS 6.2
  6843. SeeAlso: AX=4A10h/BX=0000h,AX=4A11h/BX=0003h,AX=4A11h/BX=0004h
  6844. --------c-2F4A10BX0008-----------------------
  6845. INT 2F - SMARTDRV v4.20+ - GET/SET FLUSH BEFORE PROMPT, CD-ROM SUPPORT
  6846.     AX = 4A10h
  6847.     BX = 0008h
  6848.     DL = subfunction
  6849.         00h set
  6850.         DH = new states
  6851.             bit 0: flush before prompt
  6852.             bits 1-7 reserved (0)
  6853.         01h get
  6854.         Return: DH = status flags
  6855.                 bit 0: (v4.2+) flush before prompt
  6856.                 bit 1: (v5.0+) CD-ROM caching support installed
  6857. Note:    v4.2 was an interim release to fix problems in the SMARTDRV included
  6858.       with MS-DOS 6.00; v5.00 is included with MS-DOS 6.2
  6859. --------c-2F4A10BX000A-----------------------
  6860. INT 2F - SMARTDRV v4.00+ - GET ELEMENT STATUS TABLE
  6861.     AX = 4A10h
  6862.     BX = 000Ah
  6863. Return: ES:BX -> information pointer table (see #1382)
  6864. Note:    this function is also supported by PC-Cache v8.0.
  6865. SeeAlso: AX=4A10h/BX=0000h
  6866.  
  6867. Format of SMARTDRV information pointer table:
  6868. Offset    Size    Description    (Table 1382)
  6869.  00h    WORD    offset of ??? byte/word array (byte if elements < 2000h bytes)
  6870.  02h    WORD    offset of dirty flag byte/word array (byte if elts < 2000h)
  6871.         each byte/word is a bit string of the dirty sectors in element
  6872.  04h    WORD    offset of word array containing low halves of unique
  6873.           identifiers for the corresponding element's contents
  6874.  06h    WORD    offset of word array containing high halves of unique
  6875.           identifiers for the corresponding element's contents
  6876.  08h    WORD    offset of WORD containing current number of elements in cache
  6877. --------c-2F4A10BX1234-----------------------
  6878. INT 2F - SMARTDRV v4.00+ - SIGNAL SERIOUS ERROR
  6879.     AX = 4A10h
  6880.     BX = 1234h
  6881. Desc:    this function pops up a message box saying that a serious error
  6882.       occurred and to hit R to retry, then waits for the keypress
  6883. Note:    this function is also supported by PC-Cache v8.0.
  6884. SeeAlso: AX=4A10h/BX=0000h
  6885. --------k-2F4A11BX0000-----------------------
  6886. INT 2F - DBLSPACE.BIN - "GetVersion" - INSTALLATION CHECK
  6887.     AX = 4A11h
  6888.     BX = 0000h
  6889. Return: AX = 0000h (successful)
  6890.     BX = 444Dh ("DM")
  6891.     CL = first drive letter used by DBLSPACE (41h ['A'] = A:)
  6892.     CH = number of drive letters used by DBLSPACE
  6893.     DX = internal DBLSPACE.BIN version number (bits 14-0)
  6894.         bit 15 set if DBLSPACE.BIN has not yet been relocated to final
  6895.           position in memory (i.e. DBLSPACE.SYS /MOVE)
  6896. Program: DBLSPACE.BIN is the resident driver for DoubleSpace, the
  6897.       disk-compression software bundled with MS-DOS 6.0
  6898. SeeAlso: AX=4A11h/BX=0001h,AX=4A11h/BX=0002h,AX=4A11h/BX=0003h
  6899. SeeAlso: AX=4A11h/BX=0005h,AX=4A11h/BX=0007h,AX=4A11h/BX=FFFFh
  6900. SeeAlso: INT 21/AX=4404h"DBLSPACE"
  6901. --------k-2F4A11BX0001-----------------------
  6902. INT 2F - DBLSPACE.BIN - "GetDriveMapping" - GET DRIVE MAPPING
  6903.     AX = 4A11h
  6904.     BX = 0001h
  6905.     DL = drive number (0=A:)
  6906. Return: AX = status (see also #1383)
  6907.         0000h successful
  6908.         if DL was compressed drive,
  6909.             BL = host drive (bit 7 set if drive is compressed)
  6910.         else if DL was host drive,
  6911.             BL = compressed drive
  6912.         else
  6913.             BL = specified drive (if available for DoubleSpace)
  6914.         BH = DoubleSpace sequence number
  6915.         other error code (0101h) (see #1383)
  6916.         apparently never returned for the MS-DOS 6.2 DoubleSpace
  6917. Note:    the compressed volume file for the specified compressed drive is
  6918.       host:\DBLSPACE.sequence
  6919. SeeAlso: AX=4A11h/BX=0000h
  6920.  
  6921. (Table 1383)
  6922. Values for DBLSPACE function status:
  6923.  0000h    successful
  6924.  0100h    bad function
  6925.  0101h    invalid drive
  6926.  0102h    not a compressed drive
  6927.  0103h    drive already swapped
  6928.  0104h    drive not swapped
  6929. --------k-2F4A11BX0002-----------------------
  6930. INT 2F - DBLSPACE.BIN - "Swap Drive" - SWAP DRIVE LETTERS OF CVF AND HOST DRIVE
  6931.     AX = 4A11h
  6932.     BX = 0002h
  6933.     DL = drive number (0=A:) of compressed drive to swap with its host
  6934. Return: AX = status (0000h,0101h,0102h,0103h) (see #1383)
  6935. Note:    this function is intended for use by DBLSPACE.EXE only
  6936. SeeAlso: AX=4A11h/BX=0000h
  6937. --------k-2F4A11BX0003-----------------------
  6938. INT 2F - DBLSPACE.BIN - "DSGetEntryPoints" - GET DEVICE DRIVER ENTRY POINTS
  6939.     AX = 4A11h
  6940.     BX = 0003h
  6941.     CL = drive number (0=A:) of compressed drive
  6942. Return: CL = FFh on error (not compressed drive)
  6943.     CL <> FFh driver unit number of host drive
  6944.         ES:SI -> device driver's strategy routine
  6945.         ES:DI -> device driver's interrupt routine
  6946.     BX destroyed
  6947. Note:    in conjunction with subfunction 0004h, this call allows disk caches
  6948.       like SMARTDRV to apply a device driver wrapper to DoubleSpaced
  6949.       drives just like SMARTDRV applies to regular block devices
  6950. SeeAlso: AX=4A10h/BX=0007h,AX=4A11h/BX=0000h,AX=4A11h/BX=0004h
  6951. --------k-2F4A11BX0004-----------------------
  6952. INT 2F - DBLSPACE.BIN - "DSSetEntryPoints" - SET DEVICE DRIVER ENTRY POINTS
  6953.     AX = 4A11h
  6954.     BX = 0004h
  6955.     CL = drive number (0=A:) of compressed drive
  6956.     DL = unit number for new driver entry points
  6957.     DH = 00h
  6958.     ES:SI -> device driver strategy routine to call for drive
  6959.     ES:DI -> device driver interrupt routine to call for drive
  6960. Return: CL = FFh on error (not a compressed drive)
  6961.     BX destroyed
  6962. Program: DBLSPACE.BIN is the resident driver for DoubleSpace, the
  6963.       disk-compression software bundled with MS-DOS 6.0
  6964. Note:    in conjunction with subfunction 0003h, this call allows disk caches
  6965.       like SMARTDRV to apply a device driver wrapper to DoubleSpaced
  6966.       drives just like SMARTDRV applies to regular block devices
  6967. SeeAlso: AX=4A10h/BX=0007h,AX=4A11h/BX=0000h,AX=4A11h/BX=0003h
  6968. --------k-2F4A11BX0005-----------------------
  6969. INT 2F - DBLSPACE.BIN - "ActivateDrive" - MOUNT COMPRESSED DRIVE
  6970.     AX = 4A11h
  6971.     BX = 0005h
  6972.     DL = drive number (0=A:) to assign to new drive
  6973.     ES:SI -> activation record (see #1384)
  6974. Return: status returned in activation record (see #1385)
  6975. SeeAlso: AX=4A11h/BX=0000h,AX=4A11h/BX=0006h
  6976.  
  6977. Format of DBLSPACE activation record:
  6978. Offset    Size    Description    (Table 1384)
  6979.  00h  2 BYTEs    signature "MD" (4Dh 44h)
  6980.  02h    BYTE    4Dh ('M') mount command
  6981.  03h    BYTE    error code (set to FFh before calling) (see #1385)
  6982.  04h    BYTE    host drive number (0=A:)
  6983.  05h    ???    DISK_UNIT structure (not documented)
  6984.  
  6985. (Table 1385)
  6986. Values for DBLSPACE Mount error code:
  6987.  00h    successful
  6988.  01h    drive letter not available for DoubleSpace
  6989.  02h    drive letter already in use
  6990.  03h    no more disk units (increase MaxRemovableDrives in .INI)
  6991.  09h    CVF too fragmented
  6992. --------k-2F4A11BX0006-----------------------
  6993. INT 2F - DBLSPACE.BIN - "DeactivateDrive" - UNMOUNT COMPRESSED DRIVE
  6994.     AX = 4A11h
  6995.     BX = 0006h
  6996.     DL = drive number (0=A:) to unmount
  6997. Return: AX = status (0000h,0102h) (see #1383)
  6998. SeeAlso: AX=4A11h/BX=0000h,AX=4A11h/BX=0005h
  6999. --------k-2F4A11BX0007-----------------------
  7000. INT 2F - DBLSPACE.BIN - "GetDriveSpace" - GET SPACE AVAIL ON COMPRESSED DRIVE
  7001.     AX = 4A11h
  7002.     BX = 0007h
  7003.     DL = compressed drive number (0=A:)
  7004. Return: AX = status (0000h,0102h) (see also #1383)
  7005.         0000h successful
  7006.         DS:SI -> free space record (see #1386)
  7007. Program: DBLSPACE.BIN is the resident driver for DoubleSpace, the
  7008.       disk-compression software bundled with MS-DOS 6.0
  7009. SeeAlso: AX=4A11h/BX=0000h,AX=4A11h/BX=0008h
  7010.  
  7011. Format of DBLSPACE free space record:
  7012. Offset    Size    Description    (Table 1386)
  7013.  00h    DWORD    total number of sectors in drive's sector heap
  7014.  04h    DWORD    number of free sectors in drive's sector heap
  7015. --------k-2F4A11BX0008-----------------------
  7016. INT 2F - DBLSPACE.BIN - "GetFileFragmentSpace" - GET SIZE OF FRAGMENT HEAP
  7017.     AX = 4A11h
  7018.     BX = 0008h
  7019.     DL = compressed drive number (0=A:)
  7020. Return: AX = status (0000h,0102h) (see also #1383)
  7021.         0000h successful
  7022.         BX = maximum entries in File Fragment heap
  7023.         CX = available entries in File Fragment heap
  7024. SeeAlso: AX=4A11h/BX=0000h,AX=4A11h/BX=0007h,AX=4A11h/BX=0009h
  7025. --------k-2F4A11BX0009-----------------------
  7026. INT 2F - DBLSPACE.BIN - "GetExtraInfo" - DETERMINE NUMBER OF DISK_UNIT STRUCTS
  7027.     AX = 4A11h
  7028.     BX = 0009h
  7029.     DL = compressed drive number (0=A:)
  7030. Return: AX = status (see also #1383)
  7031.         0000h successful
  7032.         CL = number of DISK_UNIT structures allocated
  7033.               (see AX=4A11h/BX=0005h)
  7034.         CH = DoubleGuard enabled-checks bitflags in bits 6-0 (DOS 6.2)
  7035. Note:    the DoubleGuard checks are enabled or disabled as a block by the
  7036.       DoubleGuard= line in DBLSPACE.INI; they may be individually set with
  7037.       the CheckSum= line.
  7038. SeeAlso: AX=4A11h/BX=0000h,AX=4A11h/BX=0008h
  7039. --------k-2F4A11BX000A-----------------------
  7040. INT 2F - DBLSPACE.BIN v6.2 - SET AUTOMOUNT DRIVES
  7041.     AX = 4A11h
  7042.     BX = 000Ah
  7043.     CX:DX = bitmask of drives on which to enable AutoMount
  7044.         (DX bit 0 = A:, CX bit 0 = P:, etc.)
  7045. Return: AX = 0000h if supported
  7046.         CX:DX = old mask or 0000h:0000h on error
  7047.     BX destroyed
  7048. SeeAlso: AX=4A11h/BX=000Bh
  7049. --------k-2F4A11BX000B-----------------------
  7050. INT 2F - DBLSPACE.BIN v6.2 - GET AUTOMOUNT DRIVES
  7051.     AX = 4A11h
  7052.     BX = 000Bh
  7053. Return: AX = 0000h if supported
  7054.         CX:DX = mask of drives with AutoMount enabled
  7055.         0000h:0000h on error
  7056.     BX destroyed
  7057. SeeAlso: AX=4A11h/BX=000Ah
  7058. --------k-2F4A11BXFFFE-----------------------
  7059. INT 2F U - DBLSPACE.BIN - RELOCATE
  7060.     AX = 4A11h
  7061.     BX = FFFEh
  7062.     ES = segment to which to relocate DBLSPACE.BIN
  7063. Return: ???
  7064. Notes:    called by DBLSPACE.SYS to relocate DBLSPACE.BIN to its final position
  7065.       in memory
  7066.     this function also unhooks and discards the code providing this
  7067.       function and AX=4A11h/BX=FFFFh
  7068. SeeAlso: AX=4A11h/BX=FFFFh
  7069. --------k-2F4A11BXFFFF-----------------------
  7070. INT 2F U - DBLSPACE.BIN - GET RELOCATION SIZE
  7071.     AX = 4A11h
  7072.     BX = FFFFh
  7073. Return: AX = number of paragraphs needed by DBLSPACE.BIN
  7074. Note:    used by DBLSPACE.SYS to relocate the DBLSPACE driver to its final
  7075.       position in memory
  7076. SeeAlso: AX=4A11h/BX=0000h,AX=4A11h/BX=FFFEh
  7077. --------k-2F4A12CX4D52-----------------------
  7078. INT 2F - Microsoft Realtime Compression Interface (MRCI) - RAM-BASED SERVER
  7079.     AX = 4A12h
  7080.     CX = 4D52h ("MR")
  7081.     DX = 4349h ("CI")
  7082. Return: CX = 4943h ("IC") if installed
  7083.     DX = 524Dh ("RM") if installed
  7084.         ES:DI -> MRCINFO structure (see INT 1A/AX=B001h)
  7085. Note:    this call is functionally identical to INT 1A/AX=B001h, but should be
  7086.       called first, as the latter call is used for the first, ROM-based
  7087.       MRCI server, while this call is used for RAM-based servers which
  7088.       may be partially or entirely replacing a prior server
  7089. SeeAlso: INT 1A/AX=B001h
  7090. --------k-2F4A13-----------------------------
  7091. INT 2F U - DBLSPACE.BIN - GET ??? ENTRY POINTS
  7092.     AX = 4A13h
  7093. Return: AX = 134Ah if supported
  7094.         ES:BX -> entry point record (see #1387)
  7095. SeeAlso: AX=4A11h/BX=0000h
  7096.  
  7097. Format of DBLSPACE entry point record:
  7098. Offset    Size    Description    (Table 1387)
  7099.  00h    DWORD    pointer to FAR function for ???
  7100.  04h  5 BYTEs    FAR JUMP instruction to ???
  7101. --------N-2F4B-------------------------------
  7102. INT 2F - LAN Manager 2.0 DOS Enh NETWKSTA.EXE - NETWORK WORKSTATION REDIRECTOR
  7103.     AH = 4Bh
  7104.     ???
  7105. Return: ???
  7106. Note:    LAN Manager enhanced mode adds features beyond the standard redirector
  7107.       file/printer services
  7108. SeeAlso: AX=118Ah,AX=4100h,AH=42h
  7109. --------T-2F4B01-----------------------------
  7110. INT 2F C - DOS 5+ TASK SWITCHER - BUILD CALLOUT CHAIN
  7111.     AX = 4B01h
  7112.     CX:DX -> task switcher entry point (see #1390)
  7113.     ES:BX = 0000h:0000h
  7114. Return: ES:BX -> callback info structure (see #1388) or 0000h:0000h
  7115. Notes:    called by the task switcher
  7116.     this function is hooked by clients which require notification of task
  7117.       switcher activities; the call must first be passed on to the prior
  7118.       handler with registers unchanged using a simulated interrupt.     On
  7119.       return, the client must build a callback info structure and store
  7120.       the returned ES:BX in the "next" field, then return the address of
  7121.       its own callback info structure.
  7122.     a client program must add itself to the notification chain if it
  7123.       provides services to other programs; before terminating, it must
  7124.       remove itself from the chain by calling the task switcher's entry
  7125.       point with AX=0005h (see #1390)
  7126.     the task switcher entry point should not be saved, as it is subject to
  7127.       change and will be provided on any notification call
  7128.     the Windows 3.1 Standard Mode supports this API
  7129. SeeAlso: AX=160Bh,AX=4B02h
  7130.  
  7131. Format of task switcher callback info structure:
  7132. Offset    Size    Description    (Table 1388)
  7133.  00h    DWORD    pointer to next callback info structure
  7134.  04h    DWORD    pointer to notification function (see #1389)
  7135.  08h    DWORD    reserved
  7136.  0Ch    DWORD    address of zero-terminated list of API info structures
  7137.         (see #1392)
  7138.  
  7139. (Table 1389)
  7140. Values task switcher notification function is called with:
  7141.     AX = function
  7142.         0000h switcher initialization
  7143.         Return: AX = status
  7144.                 0000h if OK to load
  7145.                 nonzero to abort task switcher
  7146.         0001h query suspend
  7147.         BX = session ID
  7148.         Return: AX = status
  7149.                 0000h if OK to switch session
  7150.                 0001h if not
  7151.         0002h suspend session
  7152.         BX = session ID
  7153.         interrupts disabled
  7154.         Return: AX = 0000h if OK to switch session
  7155.                = 0001h if not
  7156.         0003h activate session
  7157.         BX = session ID
  7158.         CX = session status flags
  7159.             bit 0: set if first activation of session
  7160.             bits 1-15: reserved (0)
  7161.         interrupts disabled
  7162.         Return: AX = 0000h
  7163.         0004h session active
  7164.         BX = session ID
  7165.         CX = session status flags
  7166.             bit 0: set if first activation of session
  7167.             bits 1-15: reserved (0)
  7168.         Return: AX = 0000h
  7169.         0005h create session
  7170.         BX = session ID
  7171.         Return: AX = 0000h if OK to create session
  7172.                = 0001h if not
  7173.         0006h destroy session
  7174.         BX = session ID
  7175.         Return: AX = 0000h
  7176.         0007h switcher termination
  7177.         BX = flags
  7178.             bit 0: set if calling switcher is only switcher loaded
  7179.             bits 1-15: reserved (0)
  7180.         Return: AX = 0000h
  7181.     ES:DI -> task switcher entry point (see #1390)
  7182. Notes:    function 0000h is generally called by the program which controls or
  7183.       invokes the task switcher, rather than by the task switcher itself;
  7184.       the entry point supplied to this function is not necessarily the
  7185.       entry point to the task switcher itself, and may be 0000h:0000h.  If
  7186.       any client indicates that loading is not possible, all clients will
  7187.       be called with function 0007h; thus it is possible for a client to
  7188.       receive a termination notice without a corresponding initialization
  7189.       notice.
  7190.     except for functions 0002h and 0003h, the notification handler is
  7191.       called with interrupts enabled and may make any INT 21h function
  7192.       call; interrupts must not be enabled in functions 0002h and 0003h
  7193.     function 0007h may be called with ES:DI = 0000h:0000h if the entry
  7194.       point is no longer valid
  7195. --------T-2F4B02BX0000-----------------------
  7196. INT 2F - DOS 5+ TASK SWITCHER - INSTALLATION CHECK
  7197.     AX = 4B02h
  7198.     BX = 0000h
  7199.     ES:DI = 0000h:0000h
  7200. Return: ES:DI = 0000h:0000h if task switcher not loaded
  7201.     ES:DI -> task switcher entry point (see #1390) if loaded
  7202.         AX = 0000h
  7203. Notes:    the returned entry point is that for the most-recently loaded task
  7204.       switcher; the entry points for prior task switchers may be determined
  7205.       with the "get version" call (see #1390)
  7206.     this function is supported by PC Tools v8+ CPTASK
  7207. SeeAlso: AX=4A05h,AX=4B03h
  7208.  
  7209. (Table 1390)
  7210. Call task switcher entry point with:
  7211.     AX = 0000h get version
  7212.         Return: CF clear if successful
  7213.                 AX = 0000h
  7214.                 ES:BX -> task switcher version struct (see #1391)
  7215.             CF set if unsupported function
  7216.     AX = 0001h test memory region
  7217.         ES:DI -> first byte to be tested
  7218.         CX = size of region to test
  7219.         Return: CF clear if successful
  7220.                 AX = memory type of tested region
  7221.                 0000h global
  7222.                 0001h global and local
  7223.                 0002h local (replaced on session switch)
  7224.             CF set if unsupported function
  7225.     AX = 0002h suspend switcher
  7226.         ES:DI -> new task switcher's entry point
  7227.         Return: CF clear if successful
  7228.                 AX = state
  7229.                 0000h switcher has been suspended
  7230.                 0001h switcher not suspended, new switcher must
  7231.                     abort
  7232.                 0002h switcher not suspended, but new switcher
  7233.                     may run anyway
  7234.             CF set if unsupported function
  7235.     AX = 0003h resume switcher
  7236.         ES:DI -> new task switcher's entry point
  7237.         Return: CF clear if successful
  7238.                 AX = 0000h
  7239.             CF set if unsupported function
  7240.     AX = 0004h hook notification chain
  7241.         ES:DI -> callback info structure to be added to chain
  7242.               (see #1388)
  7243.         Return: CF clear if successful
  7244.                 AX = 0000h
  7245.             CF set if unsupported function
  7246.     AX = 0005h unhook notification chain
  7247.         ES:DI -> callback info structure to be removed from chain
  7248.               (see #1388)
  7249.         Return: CF clear if successful
  7250.                 AX = 0000h
  7251.             CF set if unsupported function
  7252.     AX = 0006h query API support
  7253.         BX = asynchronous API identifier
  7254.         Return: CF clear if successful
  7255.                 AX = 0000h
  7256.                 ES:BX -> API info structure (see #1392) for the
  7257.                       client which provides the highest
  7258.                       level of API support
  7259.             CF set if unsupported function
  7260.  
  7261. Format of task switcher version structure:
  7262. Offset    Size    Description    (Table 1391)
  7263.  00h    WORD    major version of supported protocol  (current protocol is 1.0)
  7264.  02h    WORD    minor version of supported protocol
  7265.  04h    WORD    major version of task switcher
  7266.  06h    WORD    minor version of task switcher
  7267.  08h    WORD    task switcher ID (see AX=4B03h)
  7268.  0Ah    WORD    operation flags
  7269.         bit 0: set if task switcher disabled
  7270.         bits 1-15: reserved (0)
  7271.  0Ch    DWORD    pointer to ASCIZ task switcher name
  7272.         ("MS-DOS Shell Task Switcher" for DOSSHELL task switcher)
  7273.  10h    DWORD    pointer to previous task switcher's entry point or 0000h:0000h
  7274.  
  7275. Format of API info structure:
  7276. Offset    Size    Description    (Table 1392)
  7277.  00h    WORD    size of structure in bytes (000Ah)
  7278.  02h    WORD    API identifier
  7279.         0001h NetBIOS
  7280.         0002h 802.2
  7281.         0003h TCP/IP
  7282.         0004h LAN Manager named pipes
  7283.         0005h Novell NetWare IPX
  7284.  04h    WORD    major version \ of highest version of API for which the support
  7285.  06h    WORD    minor version / level specified in the next field is provided
  7286.  08h    WORD    support level
  7287.         0001h minimal support
  7288.         0002h API-level support
  7289.         0003h switcher compatibility
  7290.         0004h seamless compatibility
  7291. --------T-2F4B03-----------------------------
  7292. INT 2F - DOS 5+ TASK SWITCHER - ALLOCATE SWITCHER ID
  7293.     AX = 4B03h
  7294.     ES:DI -> task switcher entry point (see #1390)
  7295. Return: AX = 0000h
  7296.     BX = switcher ID (0001h-000Fh), or 0000h if no more available
  7297. Notes:    if a task switcher has determined that it is the first to be loaded, it
  7298.       must allocate an identifier for itself and provide this function to
  7299.       all subsequent task switchers; if it is not the first to be loaded,
  7300.       it must call this function to allocate an ID.     The switcher ID is
  7301.       used as the high four bits of all session identifiers to ensure
  7302.       unique session IDs.
  7303.     if no more switcher IDs are available, the new task switcher making the
  7304.       call must terminate or disable itself
  7305.     the task switcher providing the identifiers may call the new task
  7306.       switcher's entry point as needed
  7307.     this call is available from within DOSSHELL even if the task switcher
  7308.       is not installed
  7309.     this function is supported by PC Tools v8+ CPTASK, but appears to
  7310.       always return an ID of 0000h
  7311. SeeAlso: AX=4B02h,AX=4B04h
  7312. --------T-2F4B04-----------------------------
  7313. INT 2F - DOS 5+ TASK SWITCHER - FREE SWITCHER ID
  7314.     AX = 4B04h
  7315.     BX = switcher ID
  7316.     ES:DI -> task switcher entry point (see #1390)
  7317. Return: AX = 0000h
  7318.     BX = status
  7319.         0000h successful
  7320.         other error (invalid ID or ID not allocated)
  7321. Notes:    called by a task switcher when it exits, unless it was the first loaded
  7322.       and is providing the support for AX=4B03h and AX=4B04h
  7323.     the task switcher providing the identifiers may call the terminating
  7324.       task switcher's entry point as needed
  7325.     this call is available from within DOSSHELL even if the task switcher
  7326.       is not installed
  7327.     this call is supported by PC Tools v8+ CPTASK, but appears to return
  7328.       sucessfully no matter which ID is given
  7329. SeeAlso: AX=4B02h,AX=4B03h
  7330. --------T-2F4B05-----------------------------
  7331. INT 2F C - DOS 5+ TASK SWITCHER - IDENTIFY INSTANCE DATA
  7332.     AX = 4B05h
  7333.     ES:BX = 0000h:0000h
  7334.     CX:DX -> task switcher entry point (see #1390)
  7335. Return: ES:BX -> startup info structure (see #1393) or 0000h:0000h
  7336. Notes:    called by task switcher
  7337.     clients with instance data should hook this call, pass it through to
  7338.       the previous handler with unchanged registers using a simulated
  7339.       interrupt.  On return, the client should create a startup info
  7340.       structure (see #1393), store the returned ES:BX in the "next"
  7341.       field, and return the address of the created structure in ES:BX
  7342.     all MS-DOS function calls are available from within this call
  7343. SeeAlso: AX=1605h,AX=160Bh,AX=4B02h
  7344.  
  7345. Format of task switcher startup info structure:
  7346. Offset    Size    Description    (Table 1393)
  7347.  00h  2 BYTEs    major, minor version of info structure (03h,00h)
  7348.  02h    DWORD    pointer to next startup info structure or 0000h:0000h
  7349.  06h    DWORD    0000h:0000h (ignored)
  7350.  0Ah    DWORD    ignored
  7351.  0Eh    DWORD    pointer to instance data records (see #1394)
  7352.  
  7353. Format of one instance data record in array:
  7354. Offset    Size    Description    (Table 1394)
  7355.  00h    DWORD    address of instance data (end of array if 0000h:0000h)
  7356.  04h    WORD    size of instance data
  7357. --------W-2F4B20-----------------------------
  7358. INT 2F - MS Windows 3 - WIN.COM - SET PROGRAM TO EXECUTE ON EXIT
  7359.     AX = 4B20h
  7360. Return: AX = 0000h if successful
  7361.         DX:CX -> 256-byte buffer for pathname and commandline (see #1395)
  7362. Note:    when the Windows function ExitWindows is called with an exit code of
  7363.       44h, WIN.COM executes the program specified in the returned buffer
  7364.       and then restarts Windows
  7365.  
  7366. Format of WIN.COM buffer:
  7367. Offset    Size    Description    (Table 1395)
  7368.  00h 128 BYTEs    ASCIZ pathname of program to execute
  7369.  80h 128 BYTEs    commandline for program
  7370. --------p-2F4C-------------------------------
  7371. INT 2F U - Advanced Power Management
  7372.     AH = 4Ch
  7373.     AL = function
  7374.         00h version check
  7375.         01h suspend system requested
  7376.         FFh suspend/resume battery notification
  7377.     ???
  7378. Return: ???
  7379. ----------2F4D-------------------------------
  7380. INT 2F U - ???
  7381.     AH = 4Dh
  7382.     ???
  7383. Return: ???
  7384. Note:    reportedly called by Kana Kanji Converter and MSKK
  7385. --------N-2F4E53BL00-------------------------
  7386. INT 2F - SilverNET v2+ - INSTALLATION CHECK
  7387.     AX = 4E53h ("NS")
  7388.     BL = 00h (function "installation check")
  7389.     BH = module ID (see #1396)
  7390. Return: AX = 0000h if specified module installed
  7391.     BX = 4E53h if installed
  7392. Program: SilverNET is an SMB-compatible peer-to-peer NOS for DOS or
  7393.       Windows systems, by Net-Source, Inc. of Santa Clara, CA.
  7394. SeeAlso: AX=4E53h/BL=01h,AX=4E53h/BL=02h,AX=B800h,AX=B809h
  7395.  
  7396. (Table 1396)
  7397. Values for SilverNET module ID:
  7398.  01h    SilverCACHE
  7399.  02h    Workstation
  7400.  03h    NetBIOS
  7401.  04h    Peer
  7402.  20h    NS Share
  7403.  80h    NetWare help TSR
  7404. --------N-2F4E53BL01-------------------------
  7405. INT 2F - SilverNET - GET RUNTIME PARAMETER
  7406.     AX = 4E53h ("NS")
  7407.     BL = 01h (function "get runtime parameter")
  7408.     BH = module ID (see #1396)
  7409.     CX = parameter index (see #1397,#1399,#1400)
  7410. Return: AX = WORD value at specified index (see #1398)
  7411. Desc:    retrieve a word of data from the specified SilverNET module
  7412.  
  7413. (Table 1397)
  7414. Values for SilverNET Peer parameter index (* = read-only):
  7415.  00h *    maximum outstanding SMB buffers
  7416.  02h *    maximum logged-in nodes
  7417.  04h *    number of shareable resources
  7418.  06h *    number of characters to print per time slice
  7419.  08h *    number of printers that can be shared
  7420.  0Ah *    number of nodes logged in
  7421.  0Ch *    number of files to allow opened
  7422.  0Eh    how fast to despool (/PSLICE)
  7423.  10h    audit flag
  7424.  24h *    far pointer to resource table (each resource is 96 bytes in length)
  7425.  32h *    far pointer to SFT (internal if SilverNET files > CONFIG.SYS files,
  7426.     else DOS SFT)
  7427.  36h    spool flags (see #1398)
  7428.  
  7429. Bitfields for spool flags:
  7430. Bit(s)    Description    (Table 1398)
  7431.  0    LPT1 needs despooling
  7432.  1    LPT2 needs despooling
  7433.  2    LPT2 needs despooling
  7434.  4    COM1 needs despooling
  7435.  5    COM2 needs despooling
  7436.  6    COM3 needs despooling
  7437.  
  7438. (Table 1399)
  7439. Values for NS Share parameter index (* = read-only):
  7440.  00h    version number (high byte = minor, low byte = major)
  7441.  10h *    segment of first lock record (other records in consecutive paragraphs)
  7442.     (if PSP field = 0000h, lock record is free)
  7443.  12h *    maximum possible number of lock records
  7444.  14h *    starting segment of sharing buffer
  7445.     (NS Share's sharing records are identical to DOS SHARE except that
  7446.       fields which are normally offsets into SHARE are segment numbers)
  7447.  18h *    size of sharing buffer in paragraphs
  7448.  1Ah *    total free paragraphs in sharing buffer
  7449.  1Ch *    current number of shared files
  7450.  1Eh *    current number of locked records
  7451.  
  7452. (Table 1400)
  7453. Values for Workstation parameter index (* = read-only):
  7454.  00h    version number (high byte = minor, low byte = major)
  7455.  02h *    size of each network buffer for file operations
  7456.  04h *    number of redirector file buffers
  7457.  06h *    size of each print cache buffer
  7458.  08h *    number of network LPT printers
  7459.  0Ch    flush time in ticks (idle time on network printer before flushing)
  7460.  0Eh    (16 WORDs) last active time for each printer
  7461.  2Eh *    stub segment if program split into two parts
  7462.  60h    receive name number for datagram listens
  7463.  62h *    18-byte machine name
  7464.  74h *    LASTDRIVE (01h = A:, etc.)
  7465.  7Ch    row number of message box on screen
  7466.  7Eh    message time in clock ticks
  7467.  82h *    number of network adapters in use
  7468.  84h    station ID broadcast flag (never set on redirectors)
  7469.  96h *    NetBIOS names left
  7470.  98h *    NCBs left
  7471.  9Ah *    sessions left
  7472.  A2h *    total number of network printers (LPT+COM)
  7473.  A4h *    number of serial network printers
  7474.  A8h *    segment containing file cache buffers
  7475.  AAh *    segment containing print cache buffers
  7476.  ACh *    bytes remaining free in HMA before program loaded
  7477.  AEh *    start of free memory in HMA
  7478.  B2h *    flag: using HMA
  7479. --------N-2F4E53BL02-------------------------
  7480. INT 2F - SilverNET - SET RUNTIME PARAMETERS
  7481.     AX = 4E53h ("NS")
  7482.     BL = 02h (function "set runtime parameters")
  7483.     BH = module ID (see #1396)
  7484.     CX = parameter index (see #1399,#1400)
  7485.     DX = new value for specified parameter
  7486. Desc:    set a WORD value in the specified SilverNET module
  7487. Note:    not all indexed parameters are writable; modifying a read-only
  7488.       parameter can result in system crashes
  7489. SeeAlso: AX=4E53h/BL=00h,AX=4E53h/BL=01h
  7490. --------N-2F5100-----------------------------
  7491. INT 2F U - ODIHLP.EXE - INSTALLATION CHECK
  7492.     AX = 5100h
  7493. Return: AL = FFh if installed
  7494.         BX = 0000h
  7495.         DX:SI -> signature string "ODI$HLP$"
  7496. Program: ODIHLP is a real-mode helper allowing the Windows for Workgroups 3.11
  7497.       protected-mode NDIS3 protocol to work with real-mode ODI drivers
  7498.       and LSL.COM
  7499. Note:    the returned signature string might be the first field of a structure
  7500. SeeAlso: AX=C000h"LSL.COM"
  7501. --------k-2F5200-----------------------------
  7502. INT 2F - JAM.SYS v1.10 - "GetVersion" - INSTALLATION CHECK
  7503.     AX = 5200h
  7504. Return: AH = 80h (successful)
  7505.     BX = internal JAM.SYS version number
  7506.     CX = size of JAMINFO structure (see #1401)
  7507.     DX = JAM.SYS segment address
  7508. Program: JAM.SYS is a main component of the JAM Real-Time Data Compression
  7509.       Utilities by George A. Reznik and friends (JAM Software).
  7510. SeeAlso: AX=5201h
  7511.  
  7512. Format of JAMINFO structure:
  7513. Offset    Size    Description    (Table 1401)
  7514.  00h 25 BYTEs    extended BIOS parameter block (BPB)
  7515.  25h    DWORD    total number of sectors in JAM archive file
  7516.         (size of compressed data area)
  7517.  29h    BYTE    flags
  7518.         bit 7: full undelete-compatible allocation strategy
  7519.         bit 6: no write-behind caching
  7520.         bit 5: read-only mode
  7521.         bit 4: enable direct write requests
  7522.                (Int 26h, non-DOS requests, etc.)
  7523.         bits 3..0 are reserved for internal use
  7524.  2Ah 127 BYTEs    full JAM archive file name
  7525.  A9h    WORD    the number of fragments in archive file
  7526.  ABh 96 BYTEs    archive file fragmentation list -
  7527.         array of 16 FRAGMENT structures:
  7528.         Offset    Size    Description
  7529.          00h    WORD    starting sector (low word)
  7530.          02h    BYTE    starting sector (high byte)
  7531.          03h    WORD    size of fragment (low word)
  7532.          05h    BYTE    size of fragment (high byte)
  7533. 10Bh    DWORD    address of the host-drive DPB (Drive Parameter Block)
  7534. 10Fh    DWORD    number of free sectors in JAM archive file
  7535. 113h    WORD    device status word (see #1402)
  7536.  
  7537. (Table 1402)
  7538. Values for JAM.SYS status (high byte):
  7539.  00h    successful
  7540.  01h    drive is not a JAM drive
  7541.  02h    drive is already attached
  7542.  03h    archive file cluster size value is larger than driver's one
  7543.  04h    drive is not attached
  7544.  05h    drive is locked
  7545.  06h    drive is not locked
  7546.  07h    bad physical-level request
  7547.  08h    host drive reading/writing error
  7548.  09h    bad entries in JAM descriptor table
  7549.  0Ah    compressed data integrity error
  7550.  0Bh    archive file overflow
  7551.  0Ch    bad DOS request
  7552.  0Dh    incorrect parameters in JAMINFO structure
  7553. Note:    the low byte of the status is the DOS error code for the Host drive
  7554. SeeAlso: #1266 at INT 2F/AX=0802h
  7555. --------k-2F5201-----------------------------
  7556. INT 2F - JAM.SYS v1.10 - "GetInfo" - GET COMPRESSED DRIVE INFORMATION
  7557.     AX = 5201h
  7558.     DL = compressed drive number (0-default, 1-A:, etc.)
  7559.     DS:BX -> buffer for JAMINFO structure (see #1401)
  7560. Return: AH = status (00h,01h) (see #1402)
  7561. SeeAlso: AX=5200h
  7562. --------k-2F5202-----------------------------
  7563. INT 2F - JAM.SYS v1.10 - "Attach" - MOUNT COMPRESSED DRIVE
  7564.     AH = 52h
  7565.     AL = 02h
  7566.     DL = drive number (0-default, 1-A:, etc.) to attach to the JAM
  7567.           archive file
  7568.     DS:BX -> pointer to JAMINFO structure (see #1401), which
  7569.           contains parameters of the JAM file to mount, and pointer
  7570.           to the host drive DPB (i.e. DPB of the drive on which the
  7571.           JAM file is located)
  7572. Return: AH = status (00h,02h,03h,08h,09h,0Dh) (see also #1402)
  7573.         03h archive file cluster size value is larger than driver's - not
  7574.           mounted
  7575.         09h bad entries in JAM descriptor table - file mounted read-only
  7576.     AL = host drive error code (see #1266 at INT 2F/AX=0802h)
  7577. SeeAlso: AX=5203h
  7578. --------k-2F5203-----------------------------
  7579. INT 2F - JAM.SYS v1.10 - "Detach" - UNMOUNT COMPRESSED DRIVE
  7580.     AX = 5203h
  7581.     DL = drive number (0-default, 1-A:, etc.) to detach
  7582. Return: AH = status (00h,01h,04h,05h,08h,09h,0Bh,0Dh) (see #1402)
  7583.     AL = host drive error code (see #1266 at INT 2F/AX=0802h)
  7584. SeeAlso: AX=5202h
  7585. --------k-2F5204-----------------------------
  7586. INT 2F - JAM.SYS v1.10 - "Lock" - LOCK COMPRESSED DRIVE
  7587.     AX = 5204h
  7588.     DL = drive number (0-default, 1-A:, etc.) to lock
  7589. Return: AH = status (00h,01h,04h,05h,08h,09h,0Bh,0Dh) (see #1402)
  7590.     AL = host drive error code (see #1266 at INT 2F/AX=0802h)
  7591. SeeAlso: AX=5205h, AX=5206h, AX=5207h
  7592. --------k-2F5205-----------------------------
  7593. INT 2F - JAM.SYS v1.10 - "UnLock" - UNLOCK COMPRESSED DRIVE
  7594.     AX = 5205h
  7595.     DL = drive number (0-default, 1-A:, etc.) to unlock
  7596. Return: AH = status (00h,01h,04h,06h,08h,09h,0Dh) (see #1402)
  7597.     AL = host drive error code (see #1266 at INT 2F/AX=0802h)
  7598. SeeAlso: AX=5204h, AX=5206h, AX=5207h
  7599. Note:    Lock and UnLock functions were added to the JAM API to prevent
  7600.       asynchronous physical-level access (see AX=5206h,AX=5207h) to
  7601.       compressed data on JAM drives. In other words, two or more programs
  7602.       which use JAM API (say, JMAX optimizer and JCHKDSK - disk checker)
  7603.       cannot be run on the same JAM drive simultaneously.
  7604. --------k-2F5206-----------------------------
  7605. INT 2F - JAM.SYS v1.10 - "Read" - PHYSICAL READ DATA FROM JAM ARCHIVE
  7606.     AX = 5206h
  7607.     DL = drive number (0-default, 1-A:, etc.)
  7608.     DS:BX -> disk transfer packet (see #1403)
  7609. Return: AH = status (00h,01h,04h,06h,07h,08h,0Dh) (see #1402)
  7610.     AL = host drive error code (see #1266 at INT 2F/AX=0802h)
  7611. Program: JAM.SYS is a main component of the JAM Real-Time Data Compression
  7612.       Utilities by George A. Reznik and friends (JAM Software).
  7613. SeeAlso: AX=5207h
  7614.  
  7615. Format of disk transfer packet:
  7616. Offset    Size    Description    (Table 1403)
  7617.  00h    DWORD    sector number
  7618.  04h    WORD    number of sectors to read(write)
  7619.  06h    DWORD    transfer address
  7620. --------k-2F5207-----------------------------
  7621. INT 2F - JAM.SYS v1.10 - "Write" - PHYSICAL WRITE DATA TO JAM ARCHIVE
  7622.     AX = 5207h
  7623.     DL = drive number (0-default, 1-A:, etc.)
  7624.     DS:BX -> disk transfer packet (see #1403)
  7625. Return: AH = status (00h,01h,04h,06h,07h,08h,0Dh) (see #1402)
  7626.     AL = host drive error code (see #1266 at INT 2F/AX=0802h)
  7627. SeeAlso: AX=5206h
  7628. --------p-2F53-------------------------------
  7629. INT 2F U - POWER.EXE - APM event broadcasting???
  7630.     AH = 53h
  7631.     AL = event???
  7632.         05h CPU idle
  7633.         0Bh PM event broadcast API
  7634. Return: ???
  7635. Note:    called by MS Windows 3.1 POWER.DRV; hooked by MS Mouse driver v8.20+
  7636.       and PC-Cache v8.0
  7637. SeeAlso: AX=530Bh,AH=54h,INT 33/AX=002Fh
  7638. --------p-2F530B-----------------------------
  7639. INT 2F U - ??? (MOUSEPWR.COM, others) - ???
  7640.     AX = 530Bh
  7641.     BX = subfunction
  7642.         0003h ???
  7643.         0004h ???
  7644.     ???
  7645. Return: ???
  7646. Note:    it appears that subfunction 0003h reads or restores the current mouse
  7647.       settings (the MS Mouse driver hooks AX=530Bh), and 0004h might be
  7648.       the converse
  7649. --------p-2F5400-----------------------------
  7650. INT 2F U - POWER.EXE - INSTALLATION CHECK
  7651.     AX = 5400h
  7652. Return: AX = POWER.EXE version (AH = major, AL = minor) if installed
  7653.     BX = 504Dh ("PM")
  7654.     CF clear
  7655. Note:    called by MS Windows 3.1 POWER.DRV
  7656. SeeAlso: AH=53h,AX=5401h,AX=5402h,AX=5481h,AX=5482h
  7657. --------p-2F5401-----------------------------
  7658. INT 2F U - POWER.EXE - GET/SET POWER STATUS
  7659.     AX = 5401h
  7660.     BH = function
  7661.         00h get status
  7662.         Return: BL = current power management status (see #1404)
  7663.         01h set status
  7664.         BL = new power managment status (see #1404)
  7665. Return: AX = function status (see #1405)
  7666. Note:    called by MS Windows 3.1 POWER.DRV
  7667. SeeAlso: AH=53h,AX=5400h,AX=5402h,AX=5403h
  7668.  
  7669. Bitfields for power management status:
  7670. Bit(s)    Description    (Table 1404)
  7671.  0    POWER.EXE power management enabled
  7672.  1    APM firmware power management enabled
  7673.  2-7    reserved (0)
  7674. Notes:    bit 1 is ignored if there is no APM firmware
  7675.     bits 1-0: 00 = POWER OFF, 10 = POWER STD, 11 = POWER ADV
  7676.  
  7677. (Table 1405)
  7678. Values for POWER.EXE function status:
  7679.  0000h    successful
  7680.  0002h    "ERROR_PM_ALREADY_CONNECTED"
  7681.  0003h    "ERROR_PM_NOT_CONNECTED"
  7682.  0087h    "ERROR_PM_INVALID_PARAMETER"
  7683. --------p-2F5402-----------------------------
  7684. INT 2F U - POWER.EXE - GET/SET IDLE DETECTION STRATEGY
  7685.     AX = 5402h
  7686.     BH = subfunction
  7687.         00h get
  7688.         other set
  7689.         BL = detection strategy (00h-0Fh or FFh)
  7690. Return: BX = current/new detection strategy
  7691. SeeAlso: AH=53h,AX=5400h,AX=5401h,AX=5481h,AX=5482h
  7692. --------p-2F5403-----------------------------
  7693. INT 2F U - POWER.EXE - GET/SET ADVANCED POWER MANAGEMENT SETTING
  7694.     AX = 5403h
  7695.     BX = new power management setting or 0000h to get current setting
  7696. Return: AX = status
  7697.         0000h successful
  7698.         BX = power management setting (see #1406)
  7699.         other error code
  7700. SeeAlso: AX=5401h,AX=5480h
  7701.  
  7702. (Table 1406)
  7703. Values for power management setting:
  7704.  0001h-0005h "min"
  7705.  0006h         "reg"
  7706.  0007h-0008h "max"
  7707. --------t-2F5453-----------------------------
  7708. INT 2F - TesSeRact RAM-RESIDENT PROGRAM INTERFACE
  7709.     AX = 5453h
  7710.     BX = subfunction
  7711.         00h installation check
  7712.         CX = 0000h
  7713.         DS:SI -> 8-char blank-padded name
  7714.         Return: AX = FFFFh installed
  7715.                 CX = ID number of already-installed copy
  7716.             AX = anything else, not installed
  7717.                 CX = ID number for TSR when installed
  7718.         01h get user parameters
  7719.         CX = TSR ID number
  7720.         Return: AX = status
  7721.                 0000h successful
  7722.                 ES:BX -> user parameter block (see #1407)
  7723.                 nonzero failed
  7724.         02h check if hotkey in use
  7725.         CL = scan code of hot key
  7726.         Return: AX = FFFFh hot key conflicts with another TSR
  7727.                  otherwise safe to use the hotkey
  7728.         03h replace default critical error handler
  7729.         CX = TSR ID number
  7730.         DS:SI -> new routine for INT 24h
  7731.         Return: AX = nonzero, unable to install new handler
  7732.         04h get internal data area
  7733.         CX = TSR ID number
  7734.         Return: AX = status
  7735.                 0000h successful
  7736.                 ES:BX -> TSR's internal data area (see #1409)
  7737.                 nonzero, TSR not found
  7738.         05h set multiple hot keys
  7739.         CX = TSR ID number
  7740.         DL = number of additional hot keys to allocate
  7741.         DS:SI -> table of hot keys
  7742.             BYTE  hotkey scan code
  7743.             BYTE  hotkey shift state
  7744.             BYTE  flag value to pass to TSR (nonzero)
  7745.         Return: AX = nonzero, unable to install hot keys
  7746.         06h - 0Fh reserved
  7747.         10h enable TSR
  7748.         CX = TSR ID number
  7749.         Return: AX = nonzero, unable to enable
  7750.         11h disable TSR
  7751.         CX = TSR ID number
  7752.         Return: AX = nonzero, unable to disable
  7753.         12h unload TSR
  7754.         CX = TSR ID number
  7755.         Return: AX = nonzero, invalid TSR number
  7756.         Note: if any interrupts used by TSR have been grabbed by
  7757.             another TSR, the TesSeRact routines will wait until
  7758.             it is safe to remove the indicated TSR from memory
  7759.         13h restart TSR
  7760.         CX = TSR ID number of TSR which was unloaded but is still in
  7761.              memory
  7762.         Return: AX = nonzero, unable to restart TSR
  7763.         14h get status word
  7764.         CX = TSR ID number
  7765.         Return: AX = FFFFh invalid ID number
  7766.                = other, successful
  7767.                 BX = bit flags
  7768.         15h set status word
  7769.         CX = TSR ID number
  7770.         DX = new bit flags
  7771.         Return: AX = nonzero, unable to set status word
  7772.         16h get INDOS state at popup
  7773.         CX = TSR ID number
  7774.         Return: AX = 0000h successful
  7775.                 BX = value of INDOS flag
  7776.         17h - 1Fh reserved
  7777.         20h call user procedure
  7778.         CX = TSR ID number
  7779.         ES:DI -> user-defined data
  7780.         Return: AX = 0000h successful
  7781.         21h stuff keystrokes into keyboard buffer
  7782.         CX = TSR ID number
  7783.         DL = speed
  7784.             00h stuff keystrokes only when buffer is empty
  7785.             01h stuff up to four keystrokes per clock tick
  7786.             02h stuff up to 15 keystrokes per clock tick
  7787.         DH = scan code flag
  7788.             if zero, buffer contains alternating ASCII and scan codes
  7789.             if nonzero, buffer contains only ASCII codes
  7790.         SI = number of keystrokes
  7791.         ES:DI -> buffer to stuff
  7792.         Return: AX = 0000h success
  7793.                  F0F0h user aborted with ^C or ^Break
  7794.                  other unable to stuff keystrokes
  7795.         22h (v1.10) trigger popup
  7796.         CX = TSR ID number
  7797.         Return: AX = 0000h success, TSR will either pop up or beep to
  7798.                    indicate that it is unable to pop up
  7799.                  nonzero invalid ID number
  7800.         23h (v1.10) invoke TSR's background function
  7801.         CX = TSR ID number
  7802.         Return: AX = 0000h success
  7803.                  FFFFh not safe to call background function
  7804.                  nonzero invalid ID number
  7805.         24h - 2Fh reserved
  7806. Notes:    Borland's THELP.COM popup help system for Turbo Pascal and Turbo C
  7807.       (versions 1.x and 2.x only) fully supports the TesSeRact API, as
  7808.       do the SWAP?? programs by Innovative Data Concepts.
  7809.     AVATAR.SYS supports functions 00h and 01h (only the first three fields
  7810.       of the user parameter block) using the name "AVATAR  "
  7811. SeeAlso: AX=CAFEh,INT 16/AX=55FFh,INT 2D"AMIS"
  7812. Index:    installation check;TesSeRact TSR interface|uninstall;TesSeRact
  7813.  
  7814. (Table 1407)
  7815. Values for TesSeRact names:
  7816.  "AVATAR  "    AVATAR.SYS
  7817.  "QeditTSR"    TSR version of SemWare's Qedit editor
  7818.  "SCRNBLNK"    Trusted Access screen blanker
  7819.  
  7820. Format of TesSeRact User Parameter Block:
  7821. Offset    Size    Description    (Table 1408)
  7822.  00h  8 BYTEs    blank-padded TSR name
  7823.  08h    WORD    TSR ID number
  7824.  0Ah    DWORD    bitmap of supported functions
  7825.  0Eh    BYTE    scan code of primary hotkey
  7826.         00h = pop up when shift states match
  7827.         FFh = no popup (if shift state also FFh)
  7828.  0Fh    BYTE    shift state of primary hotkey
  7829.         FFh = no popup (if scan code also FFh)
  7830.  10h    BYTE    number of secondary hotkeys
  7831.  11h    DWORD    pointer to extra hotkeys set by func 05h
  7832.  15h    WORD    current TSR status flags
  7833.  17h    WORD    PSP segment of TSR
  7834.  19h    DWORD    DTA for TSR
  7835.  1Dh    WORD    default DS for TSR
  7836.  1Fh    DWORD    stack at popup
  7837.  23h    DWORD    stack at background invocation
  7838. Index:    hotkeys;TesSeRact TSR interface
  7839.  
  7840. Format of TSR internal data area:
  7841. Offset    Size    Description    (Table 1409)
  7842.  00h    BYTE    revision level of TesSeRact library
  7843.  01h    BYTE    type of popup in effect
  7844.  02h    BYTE    INT 08 occurred since last invocation
  7845.  03h    BYTE    INT 13 occurred since last invocation
  7846.  04h    BYTE    active interrupts
  7847.  05h    BYTE    active soft interrupts
  7848.  06h    BYTE    DOS major version
  7849.  07h    BYTE    how long to wait before popping up
  7850.  08h    DWORD    pointer to INDOS flag
  7851.  0CH    DWORD    pointer to DOS critical error flag
  7852.  10h    WORD    PSP segment of interrupted program
  7853.  12h    WORD    PSP segment of prog interrupted by INT 28
  7854.  14h    DWORD    DTA of interrupted program
  7855.  18h    DWORD    DTA of program interrupted by INT 28
  7856.  1Ch    WORD    SS of interrupted program
  7857.  1Eh    WORD    SP of interrupted program
  7858.  20h    WORD    SS of program interrupted by INT 28
  7859.  22h    WORD    SP of program interrupted by INT 28
  7860.  24h    DWORD    INT 24 of interrupted program
  7861.  28h  3 WORDs    DOS 3+ extended error info
  7862.  2Eh    BYTE    old BREAK setting
  7863.  2Fh    BYTE    old VERIFY setting
  7864.  30h    BYTE    were running MS WORD 4.0 before popup
  7865.  31h    BYTE    MS WORD 4.0 special popup flag
  7866.  32h    BYTE    enhanced keyboard call in use
  7867.  33h    BYTE    delay for MS WORD 4.0
  7868. 11 times (for INTs 08h,09h,13h,16h,1Ch,21h,28h,2Fh,1Bh,23h, and 24h):
  7869.     DWORD    old interrupt vector
  7870.     BYTE    interrupt number
  7871.     WORD    offset in TesSeRact code segment of new interrupt handler
  7872. --------p-2F5480-----------------------------
  7873. INT 2F U - POWER.EXE - GET/SET ???
  7874.     AX = 5480h
  7875.     BX = direction
  7876.         0000h get
  7877.         other set
  7878.     CX = size of buffer (at least 0010h)
  7879.     DS:SI -> buffer
  7880. Return: AX = status
  7881.         0000h successful
  7882.         other error code
  7883. SeeAlso: AX=5400h,AX=5481h,AX=548Fh
  7884. --------p-2F5481-----------------------------
  7885. INT 2F U - POWER.EXE - GET STATISTICS
  7886.     AX = 5481h
  7887.     BX = which statistics
  7888.         0000h idle detection
  7889.         0001h APM statistics
  7890.     CX = length of buffer in bytes
  7891.     DS:SI -> buffer for statistics (see #1410,#1411)
  7892. Return: AX = status
  7893.         0000h successful
  7894.         0071h "ERROR_PM_BUFFER_TOO_SMALL"
  7895.         0087h "ERROR_PM_INVALID_PARAMETER"
  7896. SeeAlso: AH=53h,AX=5400h,AX=5480h,AX=5402h,AX=5482h
  7897.  
  7898. Format of POWER.EXE idle detection statistics:
  7899. Offset    Size    Description    (Table 1410)
  7900.  00h    DWORD    "CPU_ON_TIME" total time CPU is active with POWER.EXE idle
  7901.           detection enabled, in timer ticks
  7902.  04h    DWORD    "CPU_IDLE_TIME" timer ticks during which CPU was idle
  7903.         (divide by previous to get idle    rate)
  7904.  08h    DWORD    total idle calls
  7905.  0Ch    DWORD    "TOTAL_APP_IDLE" total INT 2Fh idle calls
  7906.  10h    DWORD    "TOTAL_DOS_YIELD" total INT 28h idle calls
  7907.  14h    DWORD    "TOTAL_KEY_IDLE" total INT 16h idle calls
  7908.  18h    DWORD    "TOTAL_DOS_IDLE" total INT 2Ah idle calls
  7909.  
  7910. Format of APM statistics:
  7911. Offset    Size    Description    (Table 1411)
  7912.  00h    DWORD    "RESUME_COUNT" total number of resumes since last APM_ENABLE
  7913. --------p-2F5482-----------------------------
  7914. INT 2F U - POWER.EXE - GET/SET APM POLLING FREQUENCY
  7915.     AX = 5482h
  7916.     BX = new polling frequency or 0000h to get current frequency
  7917. Return: AX = 0000h (successful)
  7918.     BX = current frequency if BX=0000h on entry
  7919. SeeAlso: AH=53h,AX=5400h,AX=5401h,AX=5480h,AX=5481h,AX=548Fh
  7920. --------p-2F548F-----------------------------
  7921. INT 2F U - POWER.EXE - GET/SET ???
  7922.     AX = 548Fh
  7923.     BX = ??? or 0000h to get current ???
  7924. Return: AX = 0000h (successful)
  7925.     BX = current ???
  7926.     CX = ???
  7927. SeeAlso: AX=5400h,AX=5480h,AX=5482h
  7928. --------l-2F5500-----------------------------
  7929. INT 2F U - DOS 5+ - COMMAND.COM INTERFACE
  7930.     AX = 5500h
  7931. Return: AX = 0000h if an instance of COMMAND.COM is already running
  7932.     DS:SI -> entry point table
  7933. Notes:    used to access the shareable portion of COMMAND.COM, which may have
  7934.       been moved into the HMA; only the primary COMMAND.COM retains this
  7935.       portion
  7936.     procedures called from a dispatcher in COMMAND's resident portion;
  7937.       most assume that the segment address of the resident portion is on
  7938.       the stack and are thus not of general use
  7939. SeeAlso: AX=5501h
  7940. --------l-2F5501-----------------------------
  7941. INT 2F U - DOS 5+ - ROM COMMAND.COM INTERFACE
  7942.     AX = 5501h
  7943. Return: ???
  7944. Note:    used to determine whether the caller is the first instance of ROM
  7945.       COMMAND.COM
  7946. SeeAlso: AX=5500h
  7947. --------R-2F5600DXFFFF-----------------------
  7948. INT 2F - INTERLNK - INSTALLATION CHECK
  7949.     AX = 5600h
  7950.     DX = FFFFh
  7951.     BL = instance number (00h = any, 01h = first loaded, etc.)
  7952. Return: AL = FFh if installed
  7953.         BL = instance number
  7954.         CX = ???
  7955.         DX = resident CS
  7956. SeeAlso: AX=5601h,AX=5602h
  7957. --------R-2F5601DXFFFF-----------------------
  7958. INT 2F - INTERLNK - CHECK IF REDIRECTED DRIVE
  7959.     AX = 5601h
  7960.     DX = FFFFh
  7961.     BH = drive number (0=A:)
  7962.     BL = 00h
  7963. Return: (as for AL=00h if redirected drive)
  7964. SeeAlso: AX=5600h
  7965. --------R-2F5602DXFFFF-----------------------
  7966. INT 2F - INTERLNK - GET ???
  7967.     AX = 5602h
  7968.     DX = FFFFh
  7969. Return: CX = ???
  7970. SeeAlso: AX=5600h
  7971. ----------2F57-------------------------------
  7972. INT 2F U - ???
  7973.     AH = 57h
  7974.     ???
  7975. Return: ???
  7976. Note:    reportedly used by Iomega Corp.
  7977. --------c-2F5758BX4858-----------------------
  7978. INT 2F U - Helix Multimedia Cloaking - CACHECLK - INSTALLATION CHECK
  7979.     AX = 5758h
  7980.     BX = 4858h ('HX')
  7981.     DX = 4443h ('DC')
  7982.     CX <> 5758h
  7983. Return: BX = 6878h if installed
  7984.     DX = 6463h if installed
  7985.        CX = version (CH=major,CL=minor)
  7986. Program: CACHECLK is a 'Cloaked' disk cache by Helix Software
  7987. Note:    returns with registers unchanged if CX=5758h on entry
  7988. SeeAlso: INT 16/AX=5758h/BX=4858h,INT 2F/AX=4310h"Cloaking"
  7989. --------X-2F5D00-----------------------------
  7990. INT 2F U - PCMCIA - AWARD PCDISK - GET INFO FROM DRIVER ???
  7991.     AX = 5D00h
  7992. Return: ES:BX -> ???
  7993. Note:    supported by Ventura Micro / Award PCDISK.EXE v1.02c PCMCIA/ATA driver
  7994. SeeAlso: AX=5D01h,INT 21/AX=440Dh
  7995. --------X-2F5D01-----------------------------
  7996. INT 2F U - PCMCIA - AWARD PCDISK - PUT INFO INTO DRIVER ???
  7997.     AX = 5D01h
  7998.     ES:BX -> ???
  7999. Return: nothing
  8000. Note:    supported by Ventura Micro / Award PCDISK.EXE v1.02c PCMCIA/ATA driver
  8001. SeeAlso: AX=5D00h,INT 21/AX=440Dh
  8002. --------s-2F60FFDL00-------------------------
  8003. INT 2F U - IPLAY v1.00b - INSTALLATION CHECK
  8004.     AX = 60FFh
  8005.     DL = 00h (function number)
  8006.     BX = 5344h ('SD')
  8007.     CX = 4D50h ('MP')
  8008. Return: AX = 4F4Bh ('OK') if installed
  8009. Program: IPLAY is the Inertia Player by Prime and Excalibur for .MODules
  8010.       (digitized music files)
  8011. Note:    in version 1.00b, any value for DL except 01h invokes this function
  8012. SeeAlso: AX=60FFh/DL=01h
  8013. --------s-2F60FFDL00-------------------------
  8014. INT 2F U - IPLAY v1.00b - GET DATA SEGMENT
  8015.     AX = 60FFh
  8016.     DL = 01h (function number)
  8017.     BX = 5344h ('SD')
  8018.     CX = 4D50h ('MP')
  8019. Return: AX = data segment
  8020. Program: IPLAY is the Inertia Player by Prime and Excalibur for .MODules
  8021.       (digitized music files)
  8022. SeeAlso: AX=60FFh/DL=00h
  8023. --------v-2F6282-----------------------------
  8024. INT 2F U - PC Tools v7.0+ VDEFEND, VSAFE, VWATCH, DATAMON - SET ??? ADDRESS
  8025.     AX = 6282h
  8026.     CX:DX -> ??? or 0000h:0000h
  8027.     DI = segment of ??? record (see #1412) or 0000h/FFFFh to ignore
  8028. Return: BX = 0062h
  8029. Note:    if CX:DX = 0000h:0000h on entry, the ??? address is not changed
  8030.       (DATAMON only)
  8031. SeeAlso: INT 13/AH=FAh"VSAFE",INT 21/AH=FAh"VDEFEND"
  8032.  
  8033. Format of VSAFE/VWATCH record:
  8034. Offset    Size    Description    (Table 1412)
  8035.  00h    DWORD    ???
  8036.  04h    WORD    offset of ??? in record's segment
  8037.         VSAFE 2.0 sets byte at +01h to 56h or 58h
  8038.         VWATCH 2.1 sets byte at +02h to 56h or 58h
  8039.  06h  2 BYTEs    ???
  8040.  08h    BYTE    ??? (01h/other)
  8041. --------v-2F6284BX0000-----------------------
  8042. INT 2F U - PC Tools v7-8 DATAMON, v9+ DPROTECT    - INSTALLATION CHECK
  8043.     AX = 6284h
  8044.     BX = 0000h
  8045.     CX = 0000h
  8046. Return: AX = segment of resident code
  8047.     BX = 5555h
  8048.     CX = 5555h
  8049. Note:    also supported by DOS 6 UNDELETE which is licensed from PC Tools
  8050. SeeAlso: AX=6284h/BX=0001h,INT 16/AX=FFA3h
  8051. --------v-2F6284BX0001-----------------------
  8052. INT 2F U - PC Tools v7-8 DATAMON, v9+ DPROTECT - GET ???
  8053.     AX = 6284h
  8054.     BX = 0001h
  8055.     CX = 0001h
  8056. Return: AX:BX -> ??? data (see #1413)
  8057.     CX = BX
  8058. SeeAlso: AX=6284h/BX=0000h
  8059.  
  8060. Format of DPROTECT data for v9.0:
  8061. Offset    Size    Description    (Table 1413)
  8062.  00h  5 BYTEs    ???
  8063.  05h    WORD    resident code segment (may be segment of DWORD at +03h)
  8064.  07h    DWORD    -> FAR function to sound alert tone
  8065.     ???
  8066. --------v-2F6284BX0002-----------------------
  8067. INT 2F U - PC Tools v7-8 DATAMON, v9+ DPROTECT - GET OPTIONS
  8068.     AX = 6284h
  8069.     BX = 0002h
  8070.     CX = 0002h
  8071. Return: AX = options (see #1414)
  8072.     BX = ??? (0000h for v9)
  8073.     CX = AX
  8074.     DX = BX
  8075. Note:    also supported by DOS 6 UNDELETE which is licensed from PC Tools
  8076. SeeAlso: AX=6284h/BX=0000h,AX=6284h/BX=0003h
  8077.  
  8078. Bitfields for DATAMON/DPROTECT options:
  8079. Bit(s)    Description    (Table 1414)
  8080.  1    ???
  8081.  12    disabled
  8082.  13    using Delete Sentry
  8083.  14    using Delete Tracker
  8084. --------v-2F6284BX0003-----------------------
  8085. INT 2F U - PC Tools v7-8 DATAMON, v9+ DPROTECT - SET OPTION??? FLAGS
  8086.     AX = 6284h
  8087.     BX = 0003h
  8088.     CX = flags (see #1415)
  8089.     DX = flags
  8090.         bit 15: ???
  8091. Note:    v9 DPROTECT only checks bit 12 of CX, and ignores DX entirely
  8092. SeeAlso: AX=6284h/BX=0002h
  8093.  
  8094. Bitfields for DATAMON/DPROTECT CX flags:
  8095. Bit(s)    Description    (Table 1415)
  8096.  3    ???
  8097.  5    ???
  8098.  10    ???
  8099.  12    disable DATAMON/DPROTECT
  8100. --------v-2F6284BX0004-----------------------
  8101. INT 2F U - PC Tools v8 DATAMON, v9+ DPROTECT - ???
  8102.     AX = 6284h
  8103.     BX = 0004h
  8104.     CX = 0004h
  8105. Return: AX = 5555h
  8106.     BX = ??? (0800h)
  8107.     CX = ??? (FCCCh for v8, FCCBh for v9)
  8108. --------V-2F6400-----------------------------
  8109. INT 2F - SCRNSAV2.COM - INSTALLATION CHECK
  8110.     AX = 6400h
  8111. Return: AL = installation state
  8112.         00h not installed
  8113.         FFh installed
  8114. Program: SCRNSAV2.COM is a screen saver for PS/2s with VGA by Alan Ballard
  8115. SeeAlso: INT 10/AX=5555h,INT 14/AX=AA01h
  8116. Index:    screen saver;SCRNSAV2
  8117. --------N-2F7000-----------------------------
  8118. INT 2F - License Service API - INSTALLATION CHECK
  8119.     AX = 7000h
  8120.     CX = license server index (0000h to 001Fh)
  8121. Return: AL = status
  8122.         00h not installed
  8123.         FFh installed
  8124. Notes:    The License Service API is being maintained by Microsoft but is being
  8125.       supported by a large number of companies including Apple, Banyan,
  8126.       DEC, HP, Lotus, Microsoft, Novell, Software Publishers Association,
  8127.       and Wordperfect (not a complete list!)
  8128.     Each license service provider must search for the next free index
  8129.       slot to use
  8130. SeeAlso: AX=7001h,AX=7003h,AX=7004h,AX=7005h
  8131. --------N-2F7001-----------------------------
  8132. INT 2F - License Service API - REQUEST LICENSE
  8133.     AX = 7001h
  8134.     CX = license server index (0000h to 001Fh)
  8135.     DS:DX -> SLSREQUEST structure (see #1416)
  8136. Return: AX = status
  8137.         0000h success
  8138.         else  provider error code
  8139.     ES:BX = provider specific handle for the license context
  8140. SeeAlso: AX=7002h,AX=7004h,AX=7005h
  8141.  
  8142. Format of License Service SLSREQUEST structure:
  8143. Offset    Size    Description    (Table 1416)
  8144.  00h    DWORD    (return) status code
  8145.  04h    DWORD    (return) handle identifying context
  8146.  08h    DWORD    (call) address of Publisher string
  8147.  0Ch    DWORD    (call) address of Product string
  8148.  10h    DWORD    (call) address of Version string
  8149.  14h    DWORD    units required
  8150.  18h    DWORD    address of comment string
  8151.  1Ch    DWORD    address of SLSCHALLENGE structure (see #1417)
  8152.  
  8153. Format of License Service SLSCHALLENGE structure:
  8154. Offset    Size    Description    (Table 1417)
  8155.  00h    DWORD    algorithm (currently always 1)
  8156.  04h    DWORD    secret to be challenged (1-255)
  8157.  08h    DWORD    size of challenge in bytes (1-255)
  8158.  0Ch  N BYTEs    challenge data
  8159. --------N-2F7002-----------------------------
  8160. INT 2F - License Service API - RELEASE LICENSE
  8161.     AX = 7002h
  8162.     CX = license server index (0000h to 001Fh)
  8163.     DS:DX -> SLSRELEASE structure (see #1418)
  8164.     ES:BX = provider specific handle for the license context
  8165. Return: AL = status
  8166.         00h not installed
  8167.         FFh installed
  8168. SeeAlso: AX=7001h,AX=7005h
  8169.  
  8170. Format of License Service SLSRELEASE structure:
  8171. Offset    Size    Description    (Table 1418)
  8172.  00h    DWORD    handle indentifying license context
  8173.  04h    DWORD    total units consumed
  8174.  08h    DWORD    address of comment string
  8175. --------N-2F7003-----------------------------
  8176. INT 2F - License Service API - UPDATE
  8177.     AX = 7003h
  8178.     CX = license server index (0000h to 001Fh)
  8179.     DS:DX -> SLSUPDATE structure (see #1419)
  8180.     ES:BX = provider specific handle for the license context
  8181. Return: AL = status
  8182.         00h not installed
  8183.         FFh installed
  8184. SeeAlso: AX=7004h,AX=7005h
  8185.  
  8186. Format of License Service SLSUPDATE structure:
  8187. Offset    Size    Description    (Table 1419)
  8188.  00h    DWORD    (return) status code
  8189.  04h    DWORD    (call) handle identifying license context
  8190.  08h    DWORD    (call) total units consumed
  8191.  0Ch    DWORD    additional units required
  8192.  10h    DWORD    address of comment string
  8193.  14h    DWORD    address of SLSCHALLENGE structure (see #1417)
  8194. --------N-2F7004-----------------------------
  8195. INT 2F - License Service API - GET ERROR
  8196.     AX = 7004h
  8197.     CX = license server index (0000h to 001Fh)
  8198.     DS:DX -> SLSGETERROR structure (see #1420)
  8199.     ES:BX = provider specific handle for the license context
  8200. Return: AL = status
  8201.         00h not installed
  8202.         FFh installed
  8203. SeeAlso: AX=7000h,AX=7001h
  8204.  
  8205. Format of License Service SLSGETERROR structure:
  8206. Offset    Size    Description    (Table 1420)
  8207.  00h    DWORD    (return) status code
  8208.  04h    DWORD    handle identifying license context
  8209.  08h    DWORD    error code
  8210.  0Ch    DWORD    buffer size in bytes
  8211.  10h  N BYTEs    data buffer
  8212. --------N-2F7005-----------------------------
  8213. INT 2F - License Service API - QUERY LICENSE
  8214.     AX = 7005h
  8215.     CX = license server index (0000h to 001Fh)
  8216.     DS:DX -> SLSQUERY structure (see #1421)
  8217.     ES:BX = provider specific handle for the license context
  8218. Return: AL = status
  8219.         00h not installed
  8220.         FFh installed
  8221. SeeAlso: AX=7001h,AX=7002h
  8222.  
  8223. Format of License Service SLSQUERY structure:
  8224. Offset    Size    Description    (Table 1421)
  8225.  00h    DWORD    (return) status code
  8226.  04h    DWORD    handle identifying license context
  8227.  08h    DWORD    information index
  8228.  0Ch    DWORD    buffer size in bytes
  8229.  10h  N BYTEs    data buffer
  8230. --------d-2F7200-----------------------------
  8231. INT 2F - SRDISK v1.30 - INSTALLATION CHECK
  8232.     AX = 7200h
  8233. Return: AL = FFh if installed
  8234.         ES = segment of device driver header (see #1422)
  8235. Program: SRDISK is a freeware resizeable RAMdisk by Marko Kohtala
  8236.  
  8237. Format of SRDISK device driver header:
  8238. Offset    Size    Description    (Table 1422)
  8239.  00h 10 BYTEs    same as standard device driver header (see INT 21/AH=52h)
  8240.  0Ah    BYTE    number of subunits (drives) supported by driver
  8241.  0Bh  3 BYTEs    signature "SRD"
  8242.  0Eh  4 BYTEs    memory type string (currently only "XMS ")
  8243.  12h  4 BYTEs    ASCII driver version string "N.NN"
  8244.  16h    BYTE    00h
  8245.  17h    BYTE    configuration format version (currently 00h)
  8246.  18h    WORD    offset of drive configuration data
  8247. --------N-2F7A00-----------------------------
  8248. INT 2F - Novell NetWare - LOW-LEVEL API (IPX) INSTALLATION CHECK
  8249.     AX = 7A00h
  8250. Return: AL = status
  8251.         00h not installed
  8252.         FFh installed
  8253.         ES:DI -> FAR entry point for routines accessed exclusively
  8254.               through INT 7A in NetWare versions through 2.0a.
  8255.               Call with same values as INT 7A
  8256.         ES:BX -> two bytes containing IPX major/minor version
  8257.             (IPXODI v2.12; BX unchanged by older IPX drivers)
  8258. SeeAlso: AX=7AFFh/BX=0000h,AX=D800h,INT 64"Novell",INT 7A"Novell"
  8259. --------N-2F7A10-----------------------------
  8260. INT 2F U - Novell NetWare - TBMI v1.1+ - GET TBMI STATUS
  8261.     AX = 7A10h
  8262. Return: DH = major TBMI version number
  8263.     DL = minor TBMI version number (01h for v1.1)
  8264.     CX = segment address of TBMI resident part
  8265.     BX = status word of TBMI (see #1423)
  8266. Note:    TBMI is the Task-Switched Buffer Manager Interface
  8267. SeeAlso: AX=7A11h,AX=7A12h,AX=7A13h,AX=7A14h
  8268.  
  8269. Bitfields for NetWare TBMI status word:
  8270. Bit(s)    Description    (Table 1423)
  8271.  0    INT2F intercepted by TBMI
  8272.  1    INT7A intercepted by TBMI
  8273.  2    INT64 intercepted by TBMI
  8274.  3-14    reserved or unused ???
  8275.  15    outstanding task ID was detected
  8276. --------N-2F7A11-----------------------------
  8277. INT 2F U - Novell NetWare - TBMI v1.1+ - GET INT2F HANDLERS
  8278.     AX = 7A11h
  8279. Return: ES:BX -> old INT 2F handler
  8280.     DS:DX -> TBMI INT 2F handler
  8281. SeeAlso: AX=7A10h,AX=7A12h,AX=7A13h,AX=7A1Ah
  8282. --------N-2F7A12-----------------------------
  8283. INT 2F U - Novell NetWare - TBMI v1.1+ - GET INT64 HANDLERS
  8284.     AX = 7A12h
  8285. Return: ES:BX -> old INT 64 handler
  8286.     DS:DX -> TBMI INT 64 handler
  8287. SeeAlso: AX=7A10h,AX=7A11h,AX=7A13h
  8288. --------N-2F7A13-----------------------------
  8289. INT 2F U - Novell NetWare - TBMI v1.1+ - GET INT7A HANDLERS
  8290.     AX = 7A13h
  8291. Return: ES:BX -> old INT 7A handler
  8292.     DS:DX -> TBMI INT 7A handler
  8293. SeeAlso: AX=7A10h,AX=7A11h,AX=7A12h
  8294. --------N-2F7A14-----------------------------
  8295. INT 2F U - Novell NetWare - TBMI v1.1+ - GET STATISTICS
  8296.     AX = 7A14h
  8297.     CX = statistic to retrieve
  8298.         0000h available diagnostic functions???
  8299.         Return: CX = maximum available function??? (000Ch for v2.0)
  8300.         0001h buffers in use
  8301.         Return: CX = TBMI buffers currently in use
  8302.         0002h maximum buffers used
  8303.         Return: CX = maximum number of buffers ever in use
  8304.         0003h unavailable buffers
  8305.         Return: CX = count of unavailable TBMI buffers
  8306.         0004h old interrupt usage
  8307.         Return: CX = TBMI accesses to intercepted old vectors INT 2F,
  8308.                   INT 64, and INT 7A
  8309.         0005h far call usage
  8310.         Return: CX = TBMI accesses to IPX/SPX far call handler (not
  8311.                   including internal accesses)
  8312.         0006h task buffering
  8313.         Return: CX = TBMI task buffering status (enabled/disabled or
  8314.                   disable/enable switch count???)
  8315.         0007h current task ID
  8316.         Return: CX = TBMI current task ID number (0000h if ???)
  8317.         0008h outstanding ID count
  8318.         Return: CX = number of outstanding TBMI IDs
  8319.         0009h configured ECBs
  8320.         Return: CX = number of TBMI Event Control Blocks configured
  8321.         000Ah configured data ECBs
  8322.         Return: CX = number of TBMI data ECBs configured
  8323.         000Bh configured sockets
  8324.         Return: CX = number of TBMI sockets configured (from NETCFG)
  8325.         000Ch current sockets
  8326.         Return: CX = number of TBMI sockets currently in use
  8327. Return: BX = maximum supported subfunction (000Ch)
  8328. SeeAlso: AX=7A10h
  8329. --------N-2F7A15-----------------------------
  8330. INT 2F OU - Novell NetWare - TBMI v1.1 only - RESET ???
  8331.     AX = 7A15h
  8332. Return: BX = new value of ???
  8333. Desc:    set ??? to its default value
  8334. Note:    this call is a NOP under TBMI v2.0 (TBMI2)
  8335. SeeAlso: AX=7A17h
  8336. --------N-2F7A16-----------------------------
  8337. INT 2F OU - Novell NetWare - TBMI v1.1 only - ???
  8338.     AX = 7A16h
  8339.     CX = ???
  8340.     ???
  8341. Return: ???
  8342. Note:    this call is a NOP under TBMI v2.0 (TBMI2)
  8343. --------N-2F7A17-----------------------------
  8344. INT 2F OU - Novell NetWare - TBMI v1.1 only - ???
  8345.     AX = 7A17h
  8346.     ???
  8347. Return: BX = old value of ???
  8348.     CX = new value of ???
  8349. Note:    this call is a NOP under TBMI v2.0 (TBMI2)
  8350. SeeAlso: AX=7A15h
  8351. --------N-2F7A18-----------------------------
  8352. INT 2F U - Novell NetWare - TASKID v1.0 - INSTALLATION CHECK
  8353.     AX = 7A18h
  8354. Return: AL = FFh if installed
  8355.         BX = configuration flags (see #1424)
  8356.         CX = resident code segment
  8357. SeeAlso: AX=7A10h
  8358.  
  8359. Bitfields for NetWare TASKID configuration flags:
  8360. Bit(s)    Description    (Table 1424)
  8361.  0    INT 2F hooked
  8362.  3    INT 08 hooked
  8363.  other    unused
  8364. --------N-2F7A19-----------------------------
  8365. INT 2F U - Novell NetWare - TASKID v1.0 - GET INT 08 HANDLERS
  8366.     AX = 7A19h
  8367. Return: AL = FFh
  8368.     DS:DX -> TASKID INT 08 handler
  8369.     ES:BX -> original INT 08 handler
  8370. --------N-2F7A1A-----------------------------
  8371. INT 2F U - Novell NetWare - TASKID v1.0 - GET INT 2F HANDLERS
  8372.     AX = 7A1Ah
  8373. Return: AL = FFh
  8374.     DX:DX -> TASKID INT 2F handler
  8375.     ES:BX -> original INT 2F handler
  8376. SeeAlso: AX=7A11h,AX=7A19h
  8377. --------N-2F7A1B-----------------------------
  8378. INT 2F U - Novell NetWare - TASKID v1.0 - GET DIAGNOSTICS INFORMATION
  8379.     AX = 7A1Bh
  8380.     CX = desired information
  8381.         0000h supported functions
  8382.         0001h TASKID ID number
  8383.         Return: CX = ID number
  8384.         0002h set-ID count
  8385.         Return: CX = ID set count
  8386. Return: AL = FFh
  8387.     BX = highest supported subfunction number (0002h)
  8388. SeeAlso: AX=7A14h,AX=7A18h
  8389. --------N-2F7A1C-----------------------------
  8390. INT 2F U - Novell NetWare - TBMI v1.1+ - ???
  8391.     AX = 7A1Ch
  8392.     BP = ???
  8393.     CX:DX = ???
  8394. Return: AX = 70FFh
  8395. --------N-2F7A1D-----------------------------
  8396. INT 2F U - Novell NetWare - TBMI v1.1+ - ???
  8397.     AX = 7A1Dh
  8398.     ???
  8399. Return: ES = ???
  8400.     ???
  8401.     SI destroyed
  8402. --------N-2F7A1E-----------------------------
  8403. INT 2F U - Novell NetWare - TBMI v1.1+ - ???
  8404.     AX = 7A1Eh
  8405.     ES:SI -> ???
  8406.     ???
  8407. Return: ???
  8408. --------N-2F7A20BX0000-----------------------
  8409. INT 2F - Novell NetWare - Adv NetWare 4.0 DOS Requester - GET VLM CALL ADDRESS
  8410.     AX = 7A20h
  8411.     BX = 0000h
  8412. Return: AX = 0000h on success (installed)
  8413.         ES:BX -> far call address for DOS Requester (see #1425)
  8414. Notes:    the DOS Requester replaces the NetWare Shell (ANETx, NETx) on
  8415.       NetWare LAN's as of the release of Advanced NetWare 4.0 (1993).  It
  8416.       is backward compatible with NetWare 2.1x through 3.11 servers as
  8417.       well.     Note that there was a NetWare 4.0 in the early 1980's, which
  8418.       can cause confusion.
  8419.     this call is used as the installation check by VLM.EXE, which is the
  8420.       loader for all the modules of the DOS Requester
  8421.     .VLMs are standard old .EXE format executables whose normal entry point
  8422.       merely terminates to prevent loading from the command line.  The
  8423.       real entry point is found by looking at the VLM header at the
  8424.       beginning of the load image (see #1428)
  8425. Index:    installation check;NetWare 4.0 DOS Requester
  8426.  
  8427. (Table 1425)
  8428. Call DOS Requester entry point with:
  8429.     STACK:    WORD    destination function
  8430.         WORD    destination VLM ID
  8431.         WORD    source VLM ID (0000h = application program)
  8432.     registers as appropriate for function
  8433. Return: AX = status code (0000h,8811h,8846h,8848h,8853h) (see #1426)
  8434.     other registers as appropriate for function
  8435.     STACK popped
  8436.  
  8437. (Table 1426)
  8438. Values for VLM status code:
  8439.  0000h    successful
  8440.  88xxh    error generated by requester
  8441.  8801h    invalid or non-attached connection handle
  8442.  8803h    cannot add CDS
  8443.  8804h    bad path
  8444.  8811h    nonexistent function called
  8445.  8836h    attempted function with invalid parameter
  8446.  8846h    ???
  8447.  8848h    non-loaded or nonexistent VLM called
  8448.  884Dh    no more SFT entries (too many handles)
  8449.  8850h    too many reply fragments
  8450.  8853h    ???
  8451.  89xxh    error generated by server, low byte = return code from server
  8452.  
  8453. (Table 1427)
  8454. Values for VLM identifier:
  8455.  0001h    VLM.EXE        Virtual Loadable Modules manager (see also #1429)
  8456.  0010h    CONN.VLM    connection table manager (see also #1430)
  8457.  0020h    TRAN.VLM    transport protocol multiplexor (see also #1431)
  8458.  0021h    IPXNCP.VLM    transport protocol implementation using IPX (see #1433)
  8459.  0022h    reserved for TCPNCP.VLM
  8460.  0030h    NWP.VLM        NetWare protocol multiplexor (see also #1434)
  8461.  0031h    BIND.VLM
  8462.  0032h    NDS.VLM        NetWare Directory Services (see also #1435)
  8463.  0033h    PNW.VLM        Personal NetWare
  8464.  0034h    RSA.VLM        RSA encryption for directory services re-authentication
  8465.  0040h    REDIR.VLM    DOS redirector (see also #1436)
  8466.  0041h    FIO.VLM        file I/O (see also #1438)
  8467.  0042h    PRINT.VLM    printer redirector (see also #1439)
  8468.  0043h    GENERAL.VLM    misc functions for NETx and REDIR (see also #1440)
  8469.  0050h    NETX.VLM    NetWare shell compatibility (see also #1441)
  8470.  0060h    AUTO.VLM    auto-reconnect/auto-retry
  8471.  0061h    SECURITY.VLM    enhanced security module
  8472.  0100h    NMR.VLM        NetWare management responder
  8473.  
  8474. Format of VLM header:
  8475. Offset    Size    Description    (Table 1428)
  8476.  00h    DWORD    -> initialization entry point
  8477.  04h    DWORD    -> VLM API entry point
  8478.  08h    DWORD    -> ??? entry point
  8479.  0Ch    DWORD    -> ??? entry point
  8480.  10h    DWORD    -> ??? entry point
  8481.     ...
  8482.  var    DWORD    00000000h (end of entry point list)
  8483.       4 BYTEs    signature "NVlm"
  8484.     WORD    VLM identifier
  8485. Note:    the number of entry points in the header is reported as "Func" in the
  8486.       VLM /D display.
  8487.  
  8488. (Table 1429)
  8489. Call VLM Manager (VLM.EXE, ID 0001h) with:
  8490. Func    Description/Registers
  8491.  01h    VLM Statistics
  8492.  
  8493. (Table 1430)
  8494. Call Connection Manager (CONN.VLM, ID 0010h) with:
  8495. Func    Description/Registers
  8496.  01h    Conn Get Version
  8497.  03h    Conn Statistics
  8498.  04h    Conn Alloc Handle
  8499.  05h    Conn Validate Handle
  8500.  06h    Conn Free Handle
  8501.  07h    Conn Get Entry Field
  8502.  08h    Conn Set Entry Field
  8503.  09h    Conn Reset Entry Field
  8504.  0Ah    Conn Lookup Handle
  8505.  0Dh    Conn Name Lookup
  8506.  0Eh    Conn Name To Handle
  8507.     DS:SI -> uppercased server name
  8508.     CX = length of server name, 0000h if ASCIZ name
  8509.     Return: AX = error code or 0000h if successful
  8510.             CX = connection handle if successful
  8511.  0Fh    Conn Get Num Connections
  8512.  
  8513. (Table 1431)
  8514. Call TRAN.VLM (VLM ID 0020h) with:
  8515. Func    Description/Registers
  8516.  01h    Tran Get Version
  8517.  03h    Tran Statistics
  8518.  06h    Tran Request Reply (see INT 21/AH=F2h)
  8519.     AL = request code (see #1169 at INT 21/AH=F2h)
  8520.     BH = error handler flag
  8521.         00h default error handler
  8522.         01h return network errors to caller
  8523.         02h handle network errors in requester
  8524.     BL = request list length (max 5 fragments) (see #1432)
  8525.     CX = connection handle
  8526.     DH = 00h (reserved)
  8527.     DL = reply list length (max 5 fragments) (see #1432)
  8528.     DS:SI -> address list
  8529.     ES:DI -> address list
  8530.     Return: AX = error code, 0000h if successful
  8531.         BX,DX destroyed
  8532.         reply buffer updated if successful
  8533.  08h    Tran Schedule/Cancel Event
  8534.  09h    Tran Get Max Size
  8535.  0Ah    Tran Broadcast Mux
  8536.  
  8537. Format of TRAN.VLM request/reply fragment descriptor (array):
  8538. Offset    Size    Description    (Table 1432)
  8539.  00h    DWORD    address of buffer
  8540.  04h    WORD    length of buffer
  8541.  
  8542. (Table 1433)
  8543. Call IPXNCP.VLM (VLM ID 0021h) with:
  8544. Func    Description/Registers
  8545.  01h    IPX Get Version
  8546.  03h    IPX Statistics
  8547.  06h    IPXNCP Request Reply???
  8548.     functionally equivalent to Tran Request Reply???
  8549.  
  8550. (Table 1434)
  8551. Call NWP.VLM (VLM ID 0030h) with:
  8552. Func    Description/Registers
  8553.  01h    NWP Get Version
  8554.  03h    NWP Statistics
  8555.  04h    NWP Connect
  8556.  05h    NWP Disconnect
  8557.  06h    NWP Attach
  8558.  08h    NWP Login
  8559.  09h    NWP Logout
  8560.  0Ah    NWP Get Bindery Object/Get Message Handler
  8561.  0Eh    NWP Ordered Send To All
  8562.  0Fh    NWP Preferred Handler
  8563.  10h    NWP ???
  8564.     AL = subfunction
  8565.         01h get security flags (see also INT 21/AX=B301h)
  8566.         Return: BX:CX indicates signature level
  8567.                 = 0100h:0000h if signature level=0
  8568.                 = 0300h:0000h if signature level=1
  8569.                 = 0302h:0000h if signature level=2
  8570.                 = 0302h:0202h if signature level=3
  8571.         04h set security flags (see also INT 21/AX=B304h)
  8572.         BL:CL = new flags
  8573.  
  8574. (Table 1435)
  8575. Call NDS.VLM (VLM ID 0032h) with:
  8576. Func    Description/Registers
  8577.  01h    NDS Get Version
  8578.  03h    NDS Statistics
  8579.  08h    NDS Fragment Request
  8580.  0Ch    NDS ???
  8581.     BX = subfunction
  8582.         0002h read from TDS
  8583.         CX = reply buffer length
  8584.         DX = 0110h ???
  8585.         SI = offset in TDS
  8586.         ES:DI -> reply buffer
  8587.         0003h write to TDS
  8588.         0005h "NWDSChangeResourceConnection/Lock Connection"
  8589.         0007h "NWDSSetMonitoredConnection"
  8590.  
  8591. (Table 1436)
  8592. Call REDIR.VLM (VLM ID 0040h) with:
  8593. Func    Description/Registers
  8594.  01h    Redir Get Version
  8595.  03h    Redir Statistics
  8596.  04h    Redir Build SFT (see INT 21/AH=B4h"NetWare")
  8597.     CX = connection handle
  8598.     ES:DI -> SFT build request (see #1437)
  8599.     Return: AX = 0000h if successful
  8600.             BX = DOS file handle
  8601.  05h    Redir DOS To NW Handle
  8602.  08h    Redir Specific
  8603.     BX = 0000h get item
  8604.         DS:SI -> ASCIZ string "LPTx" (x='1'-'9') or drive spec ("d:")
  8605.         ES:DI -> reply buffer for "\\server\resource",00h,"path",00h
  8606.  
  8607. Format of NetWare SFT build request:
  8608. Offset    Size    Description    (Table 1437)
  8609.  00h  6 BYTEs    NetWare handle
  8610.  06h 18 BYTEs    ???
  8611.  18h    LONG    file size
  8612.  1Ch  8 BYTEs    ???
  8613.  
  8614. (Table 1438)
  8615. Call File I/O FIO.VLM (VLM ID 0041h) with:
  8616. Func    Description/Registers
  8617.  01h    FIO Get Version
  8618.  03h    FIO Statistics
  8619.  04h    FIO Remote Copy
  8620.  
  8621. (Table 1439)
  8622. Call PRINT.VLM (VLM ID 0042h) with:
  8623. Func    Description/Registers
  8624.  01h    Print Get Version
  8625.  03h    Print Statistics
  8626.  04h    Print Get/Set Data
  8627.  05h    Print Open Capture File
  8628.  07h    Print Get Num Of Printers
  8629.  08h    Print Redirection
  8630.     CX = connection handle
  8631.     DX = printer (0=LPT1)
  8632.     BX = destination
  8633.         0000h redirect device to queue
  8634.         AX = length of queue name, 0000h to use queue ID
  8635.         DS:SI -> uppercased ASCIZ queue name
  8636.         ES:DI -> queue ID, 0000h:0000h to use queue name
  8637.         0003h redirect device to file
  8638.         AX = 0000h or 4E57h ('NW')
  8639.         ES:DI -> ASCIZ path of file
  8640.     Return: AX = 0000h if successful
  8641.  09h    Print Flush And Close Job
  8642.  0Ch    Print Get/Set Banner Name
  8643.  
  8644. (Table 1440)
  8645. Call GENERAL.VLM (VLM ID 0043h) with:
  8646. Func    Description/Registers
  8647.  01h    Gen Get Version
  8648.  03h    Gen Statistics
  8649.  04h    Gen Get/Set Primary
  8650.  09h    Gen Return Drive Info
  8651.  
  8652. (Table 1441)
  8653. Call NETX.VLM (VLM ID 0050h) with:
  8654. Func    Description/Registers
  8655.  01h    NetX Get Version
  8656.  03h    NetX Statistics
  8657. --------N-2F7A20BX0001-----------------------
  8658. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET VLM CallA ADDRESS
  8659.     AX = 7A20h
  8660.     BX = 0001h
  8661. Return: AX = 0000h if request was handled
  8662.         ES:BX -> CallA entry point (see #1442)
  8663.  
  8664. (Table 1442)
  8665. Call VLM CallA entry point with:
  8666.     AX = function
  8667.         0000h submit
  8668.         0001h cancel (not implemented)
  8669.     ES:DI -> Overlay Asynchronous Control Block structure (see #1443)
  8670.  
  8671. Format of Overlay Asynchronous Control Block (OACB):
  8672. Offset    Size    Description    (Table 1443)
  8673.  00h    DWORD    link to next OACB, 0000h:0000h if last
  8674.  04h    DWORD    callback address or 0000h:0000h
  8675.  08h    BYTE    InUse flag (00h if complete)
  8676.  09h    BYTE    flag, reserved for VLM use
  8677.  0Ah    WORD    destination VLM
  8678.  0Ch    WORD    destination function
  8679.  0Eh    WORD    temporary storage for VLM.EXE
  8680.  10h  6 BYTEs    reserved
  8681.  16h  6 DWORDs    EAX,EBX,ECX,EDX,ESI,EDI
  8682.  2Eh  4 WORDs    DS,ES,FS,GS (FS and GS not used)
  8683. --------N-2F7A20BX0002-----------------------
  8684. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET VLM MULTIPLEX ADDRESS
  8685.     AX = 7A20h
  8686.     BX = 0002h
  8687. Return: AX = 0000h
  8688.     ES:BX -> VLM multiplex entry point (see #1444)
  8689. Note:    for v1.10, this function is only available while VLM.EXE is loading
  8690.       the .VLM modules, because ES is destroyed on return
  8691.  
  8692. (Table 1444)
  8693. Call DOS Requester entry point with:
  8694.     BX = function???
  8695.         0000h
  8696.         DX = ???
  8697.         DI = ???
  8698.         BP = ???
  8699.         0002h
  8700.         CX = ???
  8701.         0003h
  8702.         DX = ???
  8703.         BP = ???
  8704.         0006h
  8705.         AH = subfunction???
  8706.         AL = ???
  8707.         STACK: variable (0, 4, 10, 14 bytes seen)
  8708. --------N-2F7A20BX0003-----------------------
  8709. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET VLM PARSE API ADDRESS
  8710.     AX = 7A20h
  8711.     BX = 0003h
  8712. Return: AX = 0000h if request was handled
  8713.         ES:BX -> VLM parse API entry point
  8714. --------N-2F7A20BX0004-----------------------
  8715. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET VLM MULTICAST CALLOUT
  8716.     AX = 7A20h
  8717.     BX = 0004h
  8718. Return: AX = 0000h if request was handled
  8719.         ES:BX -> VLM multicast data (see #1445)
  8720.  
  8721. Format of DOS Requester data:
  8722. Offset    Size    Description    (Table 1445)
  8723.  00h    DWORD    pointer to ??? (code)
  8724.  04h  4 BYTEs    ???
  8725.  08h    DWORD    pointer to ??? (code) (see #1446)
  8726.     ???
  8727.  
  8728. (Table 1446)
  8729. Call offset 08h function with:
  8730.     AL = function (00h-07h)
  8731.     ???
  8732. Return: ???
  8733. --------N-2F7A20BX0005-----------------------
  8734. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET VLM INT 24 ADDRESS
  8735.     AX = 7A20h
  8736.     BX = 0005h
  8737. Return: AX = 0000h if request was handled
  8738.         ES:BX -> VLM INT 24 handler
  8739. --------N-2F7A20BX0006-----------------------
  8740. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET ??? ENTRY POINT
  8741.     AX = 7A20h
  8742.     BX = 0006h
  8743. Return: AX = 0000h if request was handled
  8744.         ES:BX -> ??? entry point (RETF in v1.03 and v1.10)
  8745. --------N-2F7A20BX0007-----------------------
  8746. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET ??? ENTRY POINT
  8747.     AX = 7A20h
  8748.     BX = 0007h
  8749. Return: AX = 0000h
  8750.     ES:BX -> ??? entry point (RETF in v1.03 and v1.10)
  8751. --------N-2F7A20BX0008-----------------------
  8752. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET ??? ENTRY POINT
  8753.     AX = 7A20h
  8754.     BX = 0008h
  8755. Return: AX = 0000h
  8756.     ES:BX -> ??? entry point (RETF in v1.03 and v1.10)
  8757. --------N-2F7A20BX0080-----------------------
  8758. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET ??? ENTRY POINT
  8759.     AX = 7A20h
  8760.     BX = 0080h
  8761. Return: AX = 0000h
  8762.     ES:BX -> ??? entry point (RETF in v1.03 and v1.10)
  8763. Note:    this function is identical to AX=7A20h/BX=0006h in v1.03 and v1.10
  8764. --------N-2F7A20BX0081-----------------------
  8765. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET ??? ENTRY POINT
  8766.     AX = 7A20h
  8767.     BX = 0081h
  8768. Return: AX = 0000h
  8769.     ES:BX -> ??? entry point (RETF in v1.03 and v1.10)
  8770. Note:    this function is identical to AX=7A20h/BX=0007h in v1.03 and v1.10
  8771. --------N-2F7A20BX0082-----------------------
  8772. INT 2F - Novell NetWare - DOS Requester v1.03+ - GET ??? ENTRY POINT
  8773.     AX = 7A20h
  8774.     BX = 0082h
  8775. Return: AX = 0000h
  8776.     ES:BX -> ??? entry point (RETF in v1.03 and v1.10)
  8777. Note:    this function is identical to AX=7A20h/BX=0008h in v1.03 and v1.10
  8778. --------N-2F7A21-----------------------------
  8779. INT 2F C - Novell NetWare - DOS Requester - BROADCAST CALLBACK
  8780.     AX = 7A21h
  8781.     CX = server connection
  8782. Return: CX = 0000h if broadcast handled
  8783. SeeAlso: AX=7A22h,AX=7A85h
  8784. --------N-2F7A22-----------------------------
  8785. INT 2F C - Novell NetWare - DOS Requester - BROADCAST/SFT3 INFORM
  8786.     AX = 7A22h
  8787.     DL = function
  8788.         21h ('!') broadcast
  8789.         40h ('@') SFT3 inform
  8790. Return: AX = 0000h if event handled
  8791. SeeAlso: AX=7A21h
  8792. --------N-2F7A2F-----------------------------
  8793. INT 2F U - Novell NetWare - IPXODI v2.12 - GET ???
  8794.     AX = 7A2Fh
  8795. Return: AX = 0000h if supported and active
  8796.         BX = version??? (0001h)
  8797.         ES:DI -> entry point (see #1447)
  8798. Note:    IPXODI v2.12 is distributed as part of the Personal NetWare system
  8799.       bundled with Novell DOS 7
  8800. SeeAlso: INT 7A/BX=001Fh
  8801.  
  8802. (Table 1447)
  8803. Call IPXODI entry point with:
  8804.     BX = function
  8805.         0000h ???
  8806.         ES:SI -> ??? data
  8807.         0001h ???
  8808.         AX = ???
  8809.         Return: ES:SI -> ??? data
  8810.         0002h get ??? address
  8811.         Return: ES:SI -> ??? buffer
  8812.         0003h send SPX packet???
  8813.         AL = ???
  8814.         CX = ???
  8815.         DX = ???
  8816.         SI = ???
  8817.         Return: ??? (registers from a call to INT 7A/BX=0016h)
  8818. Return: BX corrupted
  8819. --------N-2F7A2FBX0EDC-----------------------
  8820. INT 2F U - Personal NetWare - HRMIB - UNINSTALL
  8821.     AX = 7A2Fh
  8822.     BX = 0EDCh
  8823. Return: ???
  8824. SeeAlso: AX=7AA0h
  8825. --------N-2F7A40-----------------------------
  8826. INT 2F U - Novell NetWare - TCP/IP Protocol Stack - INSTALLATION CHECK
  8827.     AX = 7A40h
  8828. Return: AX = 7AFFh if installed
  8829.         BX = ??? bit flags (see #1448)
  8830.         CX = version (CH=major, CL=minor)
  8831.         DX = 0000h
  8832.         ES:DI -> entry point for TCP/IP stack (see #1449)
  8833. Notes:    Novell's LAN Workplace for DOS TCPIP.EXE also supports this interface
  8834.     this function is also supported by the Beame&Whiteside BWLWP40 shim,
  8835.       but it only returns AL and ES:DI, and does not support AX=7A41h
  8836. SeeAlso: AX=7A41h,INT 15/AX=DE2Eh,INT 60"Excelan"
  8837.  
  8838. Bitfields for returned BX:
  8839. Bit(s)    Description    (Table 1448)
  8840.  0    ???
  8841.  1    ???
  8842.  15-2    reserved???
  8843.  
  8844. (Table 1449)
  8845. Call NetWare TCP/IP entry point with:
  8846.     ES:SI -> parameter block (see #1450)
  8847. Return: ES:SI parameter block updated
  8848.  
  8849. Format of NetWare TCP/IP parameter block:
  8850. Offset    Size    Description    (Table 1450)
  8851.  00h  4 BYTEs    ???
  8852.  04h    WORD    (return) ???
  8853.  06h    WORD    (return) ???
  8854.  08h    DWORD    -> FAR routine called if bit 7 of function code set
  8855.  0Ch    BYTE    flags???
  8856.  0Dh  7 BYTEs    ???
  8857.  14h    BYTE    (return) ???
  8858.  15h    BYTE    (call) function code (bit 7 set if ???) (see #1451)
  8859.  16h    BYTE    socket number
  8860.  17h    BYTE    (return) result or error code
  8861.  18h  4 WORDs    parameter words 0 to 3 (see #1451 for usage)
  8862.  20h    WORD    length of packet sent/received
  8863.  22h    WORD    number of pointer/length pairs following
  8864.  24h 6N BYTEs    buffer descriptors, each
  8865.         Offset    Size    Description
  8866.          00h    DWORD    pointer to buffer
  8867.          04h    WORD    length of buffer
  8868.  
  8869. (Table 1451)
  8870. Values for NetWare TCP/IP function code:
  8871.  01h    "accept"
  8872.  02h    "bind"
  8873.  03h    close socket
  8874.     Call:    socket number field set
  8875.  04h    "connect"
  8876.  05h    get IP address
  8877.     Call:    socket number field set to 0000h
  8878.     Return:    parameter words 1 and 2 contain caller's IP address
  8879.  06h    get hardware address
  8880.  07h    "getpeername"
  8881.  08h    get socket name
  8882.  0Ah    get netmask
  8883.  0Bh    "ioctl"
  8884.  0Ch    "listen"
  8885.  0Dh    "select"
  8886.  10h    "shutdown"
  8887.  11h    open socket
  8888.     Call:    socket number field set to 0000h
  8889.         parameter word 0 = desired protocol (6 = TCP, 17 = UDP)
  8890.     Return: socket number set
  8891.  12h    "read"
  8892.  13h    "recvfrom"
  8893.     Call:    socket number set
  8894.         packet length and buffer descriptors set
  8895.     Return:    packet length and receive buffers updated
  8896.         parameter word 1 = source port number
  8897.         parameter words 2 and 3 = source IP address
  8898.  14h    "write"
  8899.  15h    "sendto"
  8900.     Call:    socket number set
  8901.         flags field = ???
  8902.         parameter word 0 = 0000h
  8903.         parameter word 1 = destination port number
  8904.         parameter words 2 and 3 = destination IP address
  8905.         packet length and buffer descriptors set
  8906.  16h    get BOOTP data
  8907. Note:    these functions are based on the Unix socket interface
  8908. --------N-2F7A41-----------------------------
  8909. INT 2F - Novell NetWare - TCP/IP Protocol Stack - WINDOWS SUPPORT???
  8910.     AX = 7A41h
  8911.     ES:DI -> FAR entry point for ??? (will be called with BX=1,2,3,4)
  8912. Return: AX = 7AFFh if supported
  8913.         BX = ??? (see #1448)
  8914.         CX = version (CH=major, CL=minor)
  8915.         DX = 0000h
  8916.         ES:SI -> DWORD containing passed value of ES:DI
  8917.         ES:DI -> entry point for TCP/IP stack
  8918. Notes:    Novell's LAN Workplace for DOS TCPIP.EXE also supports this interface
  8919.     the pointer which is set to ES:DI is cleared to 0000h:0000h when
  8920.       a Windows exit broadcast is received
  8921. SeeAlso: AX=7A40h
  8922. --------N-2F7A42-----------------------------
  8923. INT 2F - Novell NetWare - TCPIP.EXE v4.1 - GET ??? ENTRY POINT
  8924.     AX = 7A42h
  8925. Return: AX = 7AFFh if supported
  8926.         ES:DI -> ??? entry point (see #1425)
  8927.  
  8928. (Table 1452)
  8929. Call NetWare TCPIP.EXE entry point with:
  8930.     DX = ???
  8931.     ES:DI -> ??? (see #1453)
  8932. Return: AX = 0000h
  8933.     other registers destroyed
  8934.  
  8935. Format of data buffer:
  8936. Offset    Size    Description    (Table 1453)
  8937.  00h    WORD    offset of WORD ??? or 0000h
  8938.  02h    WORD    offset of DWORD ??? or 0000h
  8939.  04h    WORD    offset of DWORD ??? or 0000h
  8940. --------N-2F7A43-----------------------------
  8941. INT 2F - Novell NetWare - TCPIP.EXE v4.1 - GET ???
  8942.     AX = 7A43h
  8943. Return: AX = 7AFFh if supported
  8944.         DX = offset of ???
  8945. SeeAlso: AX=7A44h
  8946. --------N-2F7A44-----------------------------
  8947. INT 2F - Novell NetWare - TCPIP.EXE v4.1 - SET ???
  8948.     AX = 7A44h
  8949.     DX = offset of ??? (see AX=7A43h)
  8950. Return: AX = 7AFFh if supported
  8951. SeeAlso: AX=7A43h
  8952. --------N-2F7A4C-----------------------------
  8953. INT 2F - Novell NetWare - TCPIP.EXE v4.1 - GET ???
  8954.     AX = 7A4Ch
  8955. Return: AX = 7AFFh if supported
  8956.         BX = ??? (0037h)
  8957.         CX = ??? (001Ch)
  8958. --------N-2F7A4DBX0001-----------------------
  8959. INT 2F - Novell NetWare - ???
  8960.     AX = 7A4Dh
  8961.     BX = 0001h
  8962.     ES:DI -> ???
  8963. Return: AL = FFh if ???
  8964.         ES:DI -> ???
  8965. Note:    called by NETBIOS.EXE v3.01
  8966. --------N-2F7A4FBX0001-----------------------
  8967. INT 2F - Novell NetWare - SNMP.EXE - INSTALLATION CHECK
  8968.     AX = 7A4Fh
  8969.     BX = 0001h
  8970. Return: AX = 7AFFh if installed
  8971. --------N-2F7A4FBX0002-----------------------
  8972. INT 2F - Novell NetWare - SNMP.EXE - ???
  8973.     AX = 7A4Fh
  8974.     BX = 0002h
  8975. Return: AL = status
  8976.         4Fh if failed
  8977.         FFh if successful
  8978. --------N-2F7A80-----------------------------
  8979. INT 2F C - Novell NetWare - SHELL 3.01d BROADCAST - ABNORMAL EXIT
  8980.     AX = 7A80h
  8981. Return: nothing
  8982. Notes:    called on abnormal exit of the NetWare shell to notify other Novell
  8983.       TSRs that it is unsafe to call the shell in the future.
  8984.     must be passed through so that all interested programs see the exit
  8985.     on receiving this call, IPXODI clears an internal pointer to a
  8986.       default value; Novell's NETBIOS.EXE clears its INT 21h pointer to
  8987.       0000h:0000h and stops calling it
  8988. SeeAlso: AX=7A81h
  8989. --------N-2F7A81-----------------------------
  8990. INT 2F C - Novell NetWare - SHELL 3.01d BROADCAST - SET SHELL INT 21 HANDLER
  8991.     AX = 7A81h
  8992.     CX:DX -> shell's INT 21h entry point
  8993. Return: nothing
  8994. Notes:    the shell calls this function as it loads to allow interested TSRs
  8995.       and drivers to make a local copy of the shell's entry point
  8996.     must be passed through so that all interested programs see it
  8997. --------N-2F7A85-----------------------------
  8998. INT 2F C - Novell NetWare - shell 3.01 - BROADCAST INFORM
  8999.     AX = 7A85h
  9000.     CX = broadcast server number
  9001. Return: CX = 0000h if broadcast message handled by another program
  9002.     CX unchanged if broadcast not handled
  9003. SeeAlso: AX=7A21h
  9004. --------N-2F7A90-----------------------------
  9005. INT 2F U - Novell NetWare - NETBIOS.EXE 3+ - INSTALLATION CHECK
  9006.     AX = 7A90h
  9007. Return: AL = 00h if present
  9008.         BX = ???
  9009.         CX = PSP segment of NETBIOS resident code
  9010. SeeAlso: AX=7AFEh
  9011. --------N-2F7AA0-----------------------------
  9012. INT 2F U - Personal NetWare - HRMIB - ???
  9013.     AX = 7AA0h
  9014.     BX = function
  9015.         0000h ???
  9016.         0001h ???
  9017. Return: ???
  9018. SeeAlso: AX=7A2Fh/BX=0EDCh
  9019. --------N-2F7AC1-----------------------------
  9020. INT 2F - LAN HiJack - LHR - DISABLE???
  9021.     AX = 7AC1h
  9022. Program: LAN HiJack is a NetWare utility by KDS Software which allows a user
  9023.       to take over control of a workstation remotely; LHR is the program
  9024.       run on the slave workstation
  9025. SeeAlso: AX=7AC8h,AX=7AC9h,AX=7ACFh
  9026. --------N-2F7AC2-----------------------------
  9027. INT 2F - LAN HiJack - LHR - SYNCHRONIZE SHIFT STATES???
  9028.     AX = 7AC2h
  9029. Note:    sets BIOS keyboard status byte to an internal variable
  9030. SeeAlso: AX=7AC3h,AX=7ACFh
  9031. --------N-2F7AC3-----------------------------
  9032. INT 2F - LAN HiJack - LHR - CLEAR ??? FLAG
  9033.     AX = 7AC3h
  9034. SeeAlso: AX=7AC2h,AX=7ACFh
  9035. --------N-2F7AC8-----------------------------
  9036. INT 2F - LAN HiJack - LHR - ENABLE FUNCTIONS
  9037.     AX = 7AC8h
  9038.     BL = function(s) to enable (see #1454)
  9039. SeeAlso: AX=7AC1h,AX=7AC9h,AX=7ACFh
  9040.  
  9041. Bitfields for LAN HiJack function(s) to enable/disable:
  9042. Bit(s)    Description    (Table 1454)
  9043.  0    ???
  9044.  1    remote keyboard enabled
  9045.  2    support remote's mouse
  9046.  3-7    unused
  9047. --------N-2F7AC9-----------------------------
  9048. INT 2F - LAN HiJack - LHR - DISABLE FUNCTIONS
  9049.     AX = 7AC9h
  9050.     BL = function(s) to disable (see #1454)
  9051. SeeAlso: AX=7AC1h,AX=7AC8h
  9052. --------N-2F7ACA-----------------------------
  9053. INT 2F - LAN HiJack - LHJ - ???
  9054.     AX = 7ACAh
  9055.     BL = ???
  9056. Return: ???
  9057. Program: LAN HiJack is a NetWare utility by KDS Software which allows a user
  9058.       to take over control of a workstation remotely; LHJ is the program
  9059.       run on the controlling workstation
  9060. --------N-2F7ACB-----------------------------
  9061. INT 2F - LAN HiJack - LHJ - ???
  9062.     AX = 7ACBh
  9063.     BX = ???
  9064. Return: ???
  9065. Note:    this function appears to be related to the keyboard
  9066. SeeAlso: AX=7ACCh
  9067. --------N-2F7ACC-----------------------------
  9068. INT 2F - LAN HiJack - LHJ - ???
  9069.     AX = 7ACCh
  9070.     BX = ???
  9071. Return: ???
  9072. Note:    this function appears to be related to the mouse
  9073. SeeAlso: AX=7ACBh
  9074. --------N-2F7ACFBX0000-----------------------
  9075. INT 2F - LAN HiJack - LHR - INSTALLATION CHECK
  9076.     AX = 7ACFh
  9077.     BX = 0000h
  9078. Return: BX = segment of resident code if installed
  9079. Program: LAN HiJack is a NetWare utility by KDS Software which allows a user
  9080.       to take over control of a workstation remotely; LHR is the program
  9081.       run on the slave workstation
  9082. --------N-2F7AF0-----------------------------
  9083. INT 2F - Novell NetWare - DOSNP.EXE v1.30G - INSTALLATION CHECK
  9084.     AX = 7AF0h
  9085. Return: AL = FFh if present
  9086.         ES = 7AF0h
  9087.         CX = PSP segment of resident code
  9088. --------N-2F7AF1-----------------------------
  9089. INT 2F - Novell NetWare - Access Server Driver - INSTALLATION CHECK
  9090.     AX = 7AF1h
  9091.     BL = sequence number (01h first driver, 02h second, 00h no driver)
  9092. Return: AX <> 7AF1h if present
  9093.         BH = total number of drivers
  9094.         ---if BL nonzero on entry---
  9095.         AL = number of ports provided by specified driver
  9096.         ES:DI -> driver entry point
  9097.               (see #1455,#1456,#1457,#1458,#1459,#1460,#1461,#1462)
  9098.         ES:DX -> ID string
  9099. SeeAlso: INT 7A/AX=001Ch
  9100.  
  9101. (Table 1455)
  9102. Call Access Server driver "initialize port" function with:
  9103.     AH = 01h
  9104.     AL = port number (00h-0Fh)
  9105.     ES:BX -> configuration parameter block (see #1468)
  9106.     interrupts disabled
  9107. Return: CF clear if successful
  9108.     CF set on error
  9109.  
  9110. (Table 1456)
  9111. Call Access Server driver "get port status" function with:
  9112.     AH = 02h
  9113.     AL = port number (00h-0Fh)
  9114.     interrupts disabled
  9115. Return: CF clear if successful
  9116.         BL = transmitter status (see #1465)
  9117.         BH = receiver status (see #1466)
  9118.         DL = external status signals (see #1467)
  9119.     CF set on error
  9120.     interrupts disabled
  9121.  
  9122. (Table 1457)
  9123. Call Access Server driver "get input from port" function with:
  9124.     AH = 03h
  9125.     AL = port number (00h-0Fh)
  9126.     CX = size of data buffer
  9127.     ES:BX -> buffer for data
  9128.     interrupts disabled
  9129. Return: CF clear if successful
  9130.     CF set on error
  9131.     interrupts disabled
  9132.     CX = number of bytes read
  9133. Note:    the driver will add a NUL to the buffer when a break signal is detected
  9134.  
  9135. (Table 1458)
  9136. Call driver "send output data to port" function with:
  9137.     AH = 04h
  9138.     AL = port number (00h-0Fh)
  9139.     CX = number of bytes to send
  9140.     ES:BX -> buffer containing data
  9141.     interrupts disabled
  9142. Return: CF clear if successful
  9143.     CF set on error
  9144.     interrupts disabled
  9145.     CX = number of bytes actually written
  9146.  
  9147. (Table 1459)
  9148. Call driver "get I/O character counts" function with:
  9149.     AH = 05h
  9150.     AL = port number (00h-0Fh)
  9151.     interrupts disabled
  9152. Return: CF clear if successful
  9153.         BX = number of bytes pending transmission
  9154.         CX = number of bytes available for reading
  9155.     CF set on error
  9156.     interrupts disabled
  9157.  
  9158. (Table 1460)
  9159. Call driver "control XON/XOFF" function with:
  9160.     AH = 06h
  9161.     AL = port number (00h-0Fh)
  9162.     DL = new state
  9163.         (00h software flow control disabled, else enabled)
  9164.     interrupts disabled
  9165. Return: CF clear if successful
  9166.     CF set on error
  9167.     interrupts disabled
  9168.  
  9169. (Table 1461)
  9170. Call driver "get error counts and statistics" function with:
  9171.     AH = 07h
  9172.     AL = port number (00h-0Fh)
  9173.     ES:BX -> buffer for statistics (see #1469)
  9174.     interrupts disabled
  9175. Return: CF clear if successful
  9176.         ES:BX buffer filled
  9177.     CF set on error
  9178.     interrupts disabled
  9179.  
  9180. (Table 1462)
  9181. Call driver "general request" function with:
  9182.     AH = 08h
  9183.     AL = port number (00h-0Fh)
  9184.     DX = requested operations
  9185.         bit 0: flush transmit buffers
  9186.         bit 1: flush receive buffers
  9187.         bit 4: define XON/XOFF characters
  9188.     ES:BX -> XON/XOFF characters (see #1470) if DX bit 4 set
  9189.     interrupts disabled
  9190. Return: CF clear if successful
  9191.     CF set on error
  9192.     interrupts disabled
  9193.  
  9194. (Table 1463)
  9195. Call driver "deadman timer management" function with:
  9196.     AH = 09h
  9197.     AL = port number (00h-0Fh)
  9198.     BX = next time interval in seconds (0000h to disable timer)
  9199.     interrupts disabled
  9200. Return: CF clear
  9201.     interrupts disabled
  9202.  
  9203. (Table 1464)
  9204. Call driver "get buffer sizes" function with:
  9205.     AH = 0Ah
  9206.     AL = port number (00h-0Fh)
  9207.     interrupts disabled
  9208. Return: CF clear if successful
  9209.        BX = size of transmit buffer
  9210.        CX = size of receive buffer
  9211.     CF set on error
  9212.     interrupts disabled
  9213.  
  9214. (Table 1465)
  9215. Values for Access Server transmitter status:
  9216.  00h    uninitialized
  9217.  01h    ready, not transmitting
  9218.  02h    transmitting
  9219.  03h    XOFF received
  9220.  04h    transmitting, buffer full
  9221.  05h    XOFF received and buffer full
  9222.  
  9223. (Table 1466)
  9224. Values for Access Server receiver status:
  9225.  00h    uninitialized
  9226.  01h    ready
  9227.  02h    receive buffer full, data may have been lost
  9228.  
  9229. Bitfields for external status signals:
  9230. Bit(s)    Description    (Table 1467)
  9231.  7,6    undefined
  9232.  5    CTS active
  9233.  4    DSR active
  9234.  3    DCD active
  9235.  2,1    undefined
  9236.  0    ring indicator
  9237.  
  9238. Format of Access Server configuration parameter block:
  9239. Offset    Size    Description    (Table 1468)
  9240.  00h    BYTE    receive baud rate index
  9241.         00h 50 bps, 01h 75 bps, 02h 110 bps, 03h 134.5 bps,
  9242.         04h 150 bps, 05h 300 bps, 06h 600 bps, 07h 1200 bps,
  9243.         08h 1800 bps, 09h 2000 bps, 0Ah 2400 bps, 0Bh 3600 bps,
  9244.         0Ch 4800 bps, 0Dh 7200 bps, 0Eh 9600 bps, 0Fh 19200 bps,
  9245.         10h 38400 bps, 11h 57600 bps, 12h 115200 bps
  9246.  01h    BYTE    receive bits per character (0=5 bits..3=8 bits)
  9247.  02h    BYTE    receive stop bits
  9248.  03h    BYTE    receive parity
  9249.         00h none, 01h odd, 02h even, 03h mark, 04h space
  9250.  04h    BYTE    transmit baud rate index (same as receive baud rate)
  9251.  05h    BYTE    transmit bits per character (0=5 bits..3=8 bits)
  9252.  06h    BYTE    transmit stop bits
  9253.  07h    BYTE    transmit parity (same as receive parity)
  9254.  08h    BYTE    DTR state (00h off, 01h on)
  9255.  09h    BYTE    RTS state (00h off, 01h on)
  9256.  0Ah    BYTE    flow control (00h none, 01h XON/XOFF, 02h RTS/CTS, 03h both)
  9257.  0Bh    BYTE    break control (00h off, 01h on)
  9258.  
  9259. Format of Access Server statistics:
  9260. Offset    Size    Description    (Table 1469)
  9261.  00h    BYTE    port number
  9262.  01h    BYTE    external status signals (see #1467)
  9263.  02h    BYTE    transmitter status (see #1465)
  9264.  03h    BYTE    receiver status (see #1466)
  9265.  04h    DWORD    number of characters received
  9266.  08h    DWORD    number of characters transmitted
  9267.  0Ch    WORD    input parity errors
  9268.  0Eh    WORD    input framing errors
  9269.  10h    WORD    lost characters due to hardware overrun
  9270.  12h    WORD    lost characters due to data buffer overrun
  9271. Note:    the counts are not allowed to wrap around; once a count reaches FFFFh
  9272.       or FFFFFFFFh, it is no longer incremented
  9273.  
  9274. Format of Access Server XON/XOFF characters:
  9275. Offset    Size    Description    (Table 1470)
  9276.  00h    BYTE    04h (number of bytes following)
  9277.  01h    BYTE    transmit XON character
  9278.  02h    BYTE    transmit XOFF character
  9279.  03h    BYTE    receive XON character
  9280.  04h    BYTE    receive XOFF character
  9281. --------N-2F7AFE-----------------------------
  9282. INT 2F - Novell NetWare - DOSNP.EXE - INSTALLATION CHECK
  9283.     AX = 7AFEh
  9284. Return: AL = FFh if present
  9285.         ES = (data???) segment of DOSNP
  9286. Program: DOSNP.EXE provides "named pipes" support for DOS workstations running
  9287.        NetWare
  9288. Note:    the NetWare shell calls this function and refuses to load if DOSNP is
  9289.       present
  9290. SeeAlso: AX=7A90h
  9291. --------N-2F7AFFBX0000-----------------------
  9292. INT 2F - Novell NetWare - TBMI v1.1+ - INSTALLATION CHECK / Windows SUPPORT
  9293.     AX = 7AFFh
  9294.     BX = 0000h
  9295.     CX = 4E65h ("Ne")
  9296.     DX = 7457h ("tW")
  9297.     ES:DI -> Windows support procedure (see #1471)
  9298. Return: AL = FFh if installed
  9299.         CX = configured sockets (14h)
  9300.         DS:SI -> data table ???
  9301.         ES:DI -> IPX far call handler
  9302. Notes:    for IPX/SPX this call reportedly returns DS:SI pointing to the table
  9303.       of pointers to service events queue head and tail
  9304.     this function is also supported by IPXODI; v2.12 does not change DS,
  9305.       but does set SI to an internal address
  9306. SeeAlso: AX=7AFFh/BX=0001h
  9307.  
  9308. (Table 1471)
  9309. Values Windows support procedure called with:
  9310.     BP = function
  9311.         0001h Get ECB
  9312.         BX = socket number
  9313.         Return: ES:SI -> ECB or 0000h:0000h if none available
  9314.         0002h Count Listen ECBs
  9315.         AX = BX = socket
  9316.         Return: CX = number of listen ECBs for socket
  9317.                 (must be >= 2 for SPX to work)
  9318.         0003h ???
  9319.         0004h Inform task switcher of ECB locations
  9320.         Note:    registers other than those listed above are equal
  9321.               to the values when IPX was called
  9322. Note:    the support function will not be called if IPX is called with BX
  9323.       bit 15 set
  9324. --------N-2F7AFFBX0001-----------------------
  9325. INT 2F - Novell NetWare - TBMI v1.1+, shell v3.01d - INSTALLATION CHECK???
  9326.     AX = 7AFFh
  9327.     BX = 0001h
  9328.     CX = 4E65h ("Ne")
  9329.     DX = 7457h ("tW")
  9330. Return: AL = FFh if installed
  9331.         CX = ???  (8000h)
  9332.         SI = ??? (or -> ???) (0002h and 0007h seen)
  9333.         ES:DI -> IPX far call handler
  9334.         ES:DX -> 6-byte data area ???
  9335. Note:    this function is also supported by IPXODI, but IPXODI v2.12 does not
  9336.       return ES:DX
  9337. SeeAlso: AX=7AFFh/BX=0000h
  9338. --------d-2F7F00-----------------------------
  9339. INT 2F - Jim Harper's CD-ROM redirector SCSI driver - INSTALLATION CHECK
  9340.     AX = 7F00h
  9341. Return: AL = FFh if installed
  9342. SeeAlso: AX=7F01h,AX=7F02h,AX=7F03h
  9343. --------d-2F7F01-----------------------------
  9344. INT 2F - Jim Harper's CD-ROM redirector SCSI driver - DO COMMAND
  9345.     AX = 7F01h
  9346.     DS:DX -> command record (see #1472)
  9347. Return: AL = status
  9348.         00h successful
  9349.         else error code
  9350. SeeAlso: AX=7F00h,AX=7F02h,INT 11/AH=FFh"SDLP",INT 21/AX=4402h"ASPI"
  9351. SeeAlso: INT 4F/AX=8100h
  9352.  
  9353. Format of CD-ROM redirector command record:
  9354. Offset    Size    Description    (Table 1472)
  9355.  00h    BYTE    ID
  9356.  01h 10 BYTEs    CDB (Command Descriptor Block) for operation
  9357.  0Bh    WORD    segment of buffer
  9358.  0Dh    WORD    offset of buffer
  9359.  0Fh    BYTE    status
  9360.  10h    BYTE    sense
  9361.  12h    WORD    count
  9362. --------d-2F7F02-----------------------------
  9363. INT 2F - Jim Harper's CD-ROM redirector SCSI driver - DO RESET
  9364.     AX = 7F02h
  9365. SeeAlso: AX=7F00h,AX=7F01h
  9366. --------d-2F7F03-----------------------------
  9367. INT 2F - Jim Harper's CD-ROM redirector SCSI driver - UNINSTALL
  9368.     AX = 7F03h
  9369. Return: AL = status
  9370.         00h successful
  9371.         01h unable to uninstall
  9372. SeeAlso: AX=7F00h
  9373. ----------2F7F24-----------------------------
  9374. INT 2F - Multiplex - ???
  9375.     AX = 7F24h
  9376.     ???
  9377. Return: ???
  9378. Note:    called by PC/370, an IBM 370 emulator by Donald S. Higgins
  9379. ----------2F7F26-----------------------------
  9380. INT 2F - Multiplex - ???
  9381.     AX = 7F26h
  9382.     ???
  9383. Return: ???
  9384. Note:    called by PC/370, an IBM 370 emulator by Donald S. Higgins
  9385. --------!---Section--------------------------
  9386.