FAR CALL Interface List Release 56 Last change 21dec97
Copyright (c) 1989,1990,1991,1992,1993,1994,1995,1996,1997 Ralf Brown
=============================================
>CALL 0000h:0000h - Sample Entry
>InstallCheck: how to determine CALL address if variable, whether it is
> available if address is fixed
>Program: description of the program(s) providing the API
>Note: any notes related to the API
>SeeAlso: related APIs, and interrupt entries for this API in INTERRUP.*
>
>Call entry point with:
> input registers
>Return: result registers
>
>Format of data:
>Offset Size Description
> 00h ... ...
=============================================
--------D-@00600000--------------------------
CALL 0060h:0000h - Eagle MS-DOS v1.25 IO.SYS - INITIALIZE
InstallCheck: MS-DOS v1.25 must be installed
Note: this function should only be called by MSDOS.SYS
SeeAlso: @0060h:0003h,@0060h:0039h
--------D-@00600003--------------------------
CALL 0060h:0003h - Eagle MS-DOS v1.25 IO.SYS - CHECK FOR KEYSTROKE
InstallCheck: MS-DOS v1.25 must be installed
Note: does not return extended keystrokes
SeeAlso: @0060h:0000h,@0060h:0006h,@0060h:0027h
(Table F001)
Call Eagle MS-DOS entry point 0003h with:
nothing
Return: ZF set if no key
ZF clear if keystroke available
AL = keystroke
--------D-@00600006--------------------------
CALL 0060h:0006h - Eagle MS-DOS v1.25 IO.SYS - WAIT FOR KEYSTROKE
InstallCheck: MS-DOS v1.25 must be installed
Notes: if an extended keystroke is available, only the low byte is returned,
and this function must be called again to get the high byte
the BIOS keycode 0000h (Ctrl-Break) is returned as 00h+FFh to avoid
the ambiguity that might be caused by returning the 00h high byte
SeeAlso: @0060h:0000h,@0060h:0003h,@0060h:0027h
(Table F002)
Call Eagle MS-DOS entry point 0006h with:
nothing
Return: AL = keystroke
flags modified
--------D-@00600009--------------------------
CALL 0060h:0009h - Eagle MS-DOS v1.25 IO.SYS - OUTPUT CHARACTER TO SCREEN
InstallCheck: MS-DOS v1.25 must be installed
Note: this entry point supports most of the ANSI.SYS control sequences,
plus several additional escape sequences
SeeAlso: @0060h:0000h,@0060h:0003h,@0060h:000Ch
(Table F003)
Call Eagle MS-DOS entry point 0009h with:
AL = character to output
Return: flags modified
--------D-@0060000C--------------------------
CALL 0060h:000Ch - Eagle MS-DOS v1.25 IO.SYS - OUTPUT CHARACTER TO PRINTER
InstallCheck: MS-DOS v1.25 must be installed
Note: this entry point is able, if set by configuration (see @0060h:0039h),
to strip linefeed characters following carriage returns
SeeAlso: @0060h:0000h,@0060h:0009h
(Table F004)
Call Eagle MS-DOS entry point 000Ch with:
AL = character to be printed
Return: flags modified
--------D-@0060000F--------------------------
CALL 0060h:000Fh - Eagle MS-DOS v1.25 IO.SYS - INPUT CHAR FROM AUX: DEVICE
InstallCheck: MS-DOS v1.25 must be installed
Note: if the configured AUX: device is a parallel port, this call always
returns a Ctrl-Z as the "read" character; Ctrl-Z is also returned
if the user presses Esc or Ctrl-Break while waiting for a character
to arrive on a serial port
SeeAlso: @0060h:0000h
(Table F005)
Call Eagle MS-DOS entry point 000Fh with:
nothing
Return: AL = received character
--------D-@00600012--------------------------
CALL 0060h:0012h - Eagle MS-DOS v1.25 IO.SYS - OUTPUT CHAR TO AUX: DEVICE
InstallCheck: MS-DOS v1.25 must be installed
Note: if the port is busy, this function waits until the port becomes
available or the user presses Esc or Ctrl-Break
SeeAlso: @0060h:0000h
(Table F006)
Call Eagle MS-DOS entry point 0012h with:
AL = character to output
Return: flags modified
--------D-@00600015--------------------------
CALL 0060h:0015h - Eagle MS-DOS v1.25 IO.SYS - READ ABSOLUTE SECTOR(S)
InstallCheck: MS-DOS v1.25 must be installed
SeeAlso: @0060h:0000h,@0060h:0018h,@0060h:001Bh
(Table F007)
Call Eagle MS-DOS entry point 0015h with:
AL = drive table number
ES:BX -> buffer
CX = number of sectors to read
DX = logical sector number of first sector
AH = verify flag
Return: CF clear if successful
CF set on error
AL = error code
0Ch drive table number out of range
Note: the drive number in AL is *not* the logical DOS drive number, but
the number of an internal data table; multiple data tables, each
describing a distinct disk format, may be shared by one logical
drive
--------D-@00600018--------------------------
CALL 0060h:0018h - Eagle MS-DOS v1.25 IO.SYS - WRITE ABSOLUTE SECTOR(S)
InstallCheck: MS-DOS v1.25 must be installed
SeeAlso: @0060h:0000h,@0060h:0015h,@0060h:001Bh
(Table F008)
Call Eagle MS-DOS entry point 0018h with:
AL = drive table number
ES:BX -> data to be written
CX = number of sectors to write
DX = logical sector number of first sector
AH = verify flag
Return: CF clear if successful
CF set on error
AL = error code
0Ch drive table number out of range
Note: the drive number in AL is *not* the logical DOS drive number, but
the number of an internal data table; multiple data tables, each
describing a distinct disk format, may be shared by one logical
drive
--------D-@0060001B--------------------------
CALL 0060h:001Bh - Eagle MS-DOS v1.25 IO.SYS - DETERMINE DISK FORMAT
InstallCheck: MS-DOS v1.25 must be installed
SeeAlso: @0060h:0000h,@0060h:0015h,@0060h:002Ah
(Table F009)
Call Eagle MS-DOS entry point 001Bh with:
AL = DOS drive number
Return: CF clear if successful
AL = drive table number
AH = ??? flag
00h ???
FFh ???
CF set on error
AL = error code
02h ???
0Ch unrecognized format
--------D-@0060001E--------------------------
CALL 0060h:001Eh - Eagle MS-DOS v1.25 IO.SYS - SET DAY COUNT
InstallCheck: MS-DOS v1.25 must be installed
SeeAlso: @0060h:0000h,@0060h:0021h,@0060h:0024h
(Table F010)
Call Eagle MS-DOS entry point 001Eh with:
AX = day count
Return: nothing
--------D-@00600021--------------------------
CALL 0060h:0021h - Eagle MS-DOS v1.25 IO.SYS - SET SYSTEM TIME
InstallCheck: MS-DOS v1.25 must be installed
SeeAlso: @0060h:0000h,@0060h:001Eh,@0060h:0024h
(Table F011)
Call Eagle MS-DOS entry point 0021h with:
CH = hours
CL = minutes
DH = seconds
DL = hundredths
Return: flags modified
--------D-@00600024--------------------------
CALL 0060h:0024h - Eagle MS-DOS v1.25 IO.SYS - READ SYSTEM TIME
InstallCheck: MS-DOS v1.25 must be installed
SeeAlso: @0060h:0000h,@0060h:001Eh,@0060h:0021h
(Table F012)
Call Eagle MS-DOS entry point 0024h with:
nothing
Return: AX = day count
CH = hours
CL = minutes
DH = seconds
DL = hundredths
--------D-@00600027--------------------------
CALL 0060h:0027h - Eagle MS-DOS v1.25 IO.SYS - CLEAR KEYBOARD BUFFER
InstallCheck: MS-DOS v1.25 must be installed
SeeAlso: @0060h:0000h,@0060h:0003h,@0060h:0006h
(Table F013)
Call Eagle MS-DOS entry point 0027h with:
nothing
Return: ZF set
--------D-@0060002A--------------------------
CALL 0060h:002Ah - Eagle MS-DOS v1.25 IO.SYS - SEARCH FOR NEXT DISK FORMAT
InstallCheck: MS-DOS v1.25 must be installed
SeeAlso: @0060h:0000h,@0060h:001Bh
(Table F014)
Call Eagle MS-DOS entry point 002Ah with:
AL = drive table number
Return: AL = next drive table number with matching disk sector size and media
ID byte
--------D-@00600039--------------------------
CALL 0060h:0039h - Eagle MS-DOS v1.25 IO.SYS - CONFIGURE FROM SYSINFO.SYS
InstallCheck: MS-DOS v1.25 must be installed
Note: reads the first 144 bytes of SYSINFO.SYS from the current drive into
an internal configuration buffer
SeeAlso: @0060h:0000h
--------V-@C0000003--------------------------
CALL C000h:0003h - VIDEO BIOS INITIALIZATION
InstallCheck: C000h:0000h must contain the word AA55h and the
512*BYTE[C000h:0002h] bytes must sum to 00h (mod 256)
Note: is normally called only by the System ROM BIOS initialization code
--------V-@C0000064--------------------------
CALL C000h:0064h U - ATI Mach32 VIDEO BIOS - ???
InstallCheck: ATI Mach32 video board must be installed
SeeAlso: @C000h:0068h"Mach32",@C000h:006Ch,@C000h:0070h
(Table F015)
Call ATI Mach32 entry point with:
AL = function
00h ???
01h,02h ???
11h,12h ???
21h,22h ???
41h,42h ???
81h,82h ???
Return: CF clear if successful
CF set on error
--------V-@C0000064--------------------------
CALL C000h:0064h U - ATI Mach64 VIDEO BIOS - ALTERNATE INT 10/AH=A0h (IRET)
InstallCheck: ATI Mach64 video board must be installed
SeeAlso: @C000h:0068h"Mach64",INT 10/AH=A0h"Mach64"
--------V-@C0000068--------------------------
CALL C000h:0068h U - ATI Mach32 VIDEO BIOS - ???
InstallCheck: ATI Mach32 video board must be installed
SeeAlso: @C000h:0064h"Mach32",@C000h:006Ch,@C000h:0070h
(Table F016)
Call ATI Mach32 entry point with:
AL = ??? (00h-02h)
???
Return: ???
--------V-@C0000068--------------------------
CALL C000h:0068h U - ATI Mach64 VIDEO BIOS - ALTERNATE INT 10/AH=A0h (RETF)
InstallCheck: ATI Mach64 video board must be installed
SeeAlso: @C000h:0064h"Mach64",INT 10/AH=A0h"Mach64"
--------V-@C000006C--------------------------
CALL C000h:006Ch - ATI Mach32 VIDEO BIOS -
InstallCheck: ATI Mach32 video board must be installed
SeeAlso: @C000h:0064h,@C000h:0068h,@C000h:0070h
(Table F017)
Call ATI Mach32 entry point with:
AL = function
00h get ???
Return: AX = ??? (019Eh)
01h get ??? information
ES:BX -> buffer for ??? information (see #F018)
Return: buffer filled
02h get ???
Return: AX = ??? (0250h)
BX = ??? (0A00h)
CX = ??? (0200h)
DX = ??? (0003h)
Return: CF clear if successful
CF set if invalid function
all other registers preserved
Note: officially (Programmer's Reference Guide), interrupts should be
disabled (CLI) during a function 01h call
Format of ATI Mach32 ??? information:
Offset Size Description (Table F018)
00h WORD number of bytes of data returned (0116h for tested BIOS)
02h 2 BYTEs ??? (00h 00h and 00h 05h seen)
04h WORD offset of video mode records??? (0028h)
06h BYTE length of one video mode record??? (22h)
07h BYTE ???
08h BYTE ??? (00h/01h, reflects bit 1 of port 36EEh)
09h BYTE ??? (01h)
0Ah BYTE ???
0Bh BYTE memory size
00h = 256K, 01h = 512K, 02h = 1024K, 03h = 2M, 04h = 4M
0Ch BYTE ???
0Dh BYTE ???
0Eh BYTE ???
0Fh BYTE ??? (bits 6-4 of port 42E8h)
10h BYTE ???
11h BYTE ???
12h BYTE ???
13h BYTE ???
14h WORD ???
16h BYTE ???
17h BYTE ???
18h BYTE ???
19h 14 BYTEs unused
27h BYTE scratch byte used by ROM code
28h 34N BYTEs ??? video mode records (see #F019)
SeeAlso: #F017
Format of ATI Mach32 ??? video mode record:
Offset Size Description (Table F019)
00h WORD horizontal resolution in pixels
02h WORD vertical resolution in pixels
04h 30 BYTEs ???
SeeAlso: #F018
--------V-@C0000070--------------------------
CALL C000h:0070h U - ATI Mach32 VIDEO BIOS - ???
InstallCheck: ATI Mach32 video board must be installed
SeeAlso: @C000h:0064h,@C000h:0068h,@C000h:006Ch
(Table F020)
Call ATI Mach32 entry point with:
AH = function
00h ???
01h ???
02h ???
AL = subfunction
00h ???
01h ???
03h ???
AL = ??? (00h/nonzero)
Return: CF clear if successful
CF set on error
--------B-@F000E739--------------------------
CALL F000h:E739h - ROM BIOS INT 14 HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------B-@F000E82E--------------------------
CALL F000h:E82Eh - ROM BIOS INT 16 HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------B-@F000EC59--------------------------
CALL F000h:EC59h - ROM BIOS INT 13 HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------B-@F000EFD2--------------------------
CALL F000h:EFD2h - ROM BIOS INT 17 HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------B-@F000F065--------------------------
CALL F000h:F065h - ROM BIOS INT 10 HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------B-@F000F841--------------------------
CALL F000h:F841h - ROM BIOS INT 12 HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------B-@F000F84D--------------------------
CALL F000h:F84Dh - ROM BIOS INT 11 HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------B-@F000F859--------------------------
CALL F000h:F859h - ROM BIOS INT 15 HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------B-@F000FE6E--------------------------
CALL F000h:FE6Eh - ROM BIOS INT 1A HANDLER
InstallCheck: present if BIOS is 100% compatible with original IBM PC
--------H-@F000FFF0--------------------------
CALL F000h:FFF0h - COLD-BOOT ADDRESS
InstallCheck: always present
SeeAlso: @FFFFh:0000h
--------H-@FFFF0000--------------------------
CALL FFFFh:0000h - COLD-BOOT ADDRESS
InstallCheck: always present
Note: this address is another way of expressing F000h:FFF0h
SeeAlso: @F000h:FFF0h
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - 10NET - 10MEMMGR.SYS
InstallCheck: see INT 21/AX=4402h"10MEMMGR"
SeeAlso: INT 21/AX=4402h"10MEMMGR"
--------t-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Alternate Multiplex Interrupt Specification TSRs
InstallCheck: see INT 2D"AMIS"
SeeAlso: INT 2D"AMIS"
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - AutoCAD Device Interface
InstallCheck: see INT 7A/AX=0001h
SeeAlso: INT 7A/AX=0001h
----------@xxxxxxxx---------------------------
CALL xxxxh:xxxxh - BIOS32 Service Directory
InstallCheck: scan paragraph boundaries E000h to FFFFh for signature string
"_32_", followed by a valid header structure (see #F021)
Notes: a 32-bit-code alternate PCI BIOS entry point may be found (if
supported) by requesting the entry point for the API with
identifier "$PCI"
an alternate entry point for INT 1A/AH=B4h may be found (if
supported) by requesting the entry point for the API with identifier
"$ACF"
SeeAlso: INT 1A/AX=B100h
Format of BIOS32 Service Directory header structure:
Offset Size Description (Table F021)
00h 4 BYTEs signature "_32_"
04h DWORD physical address of BSD entry point (see #F022)
08h BYTE header structure version number (currently 00h)
09h BYTE header structure length in paragraphs (currently 01h)
0Ah BYTE checksum (8-bit sum of all bytes in structure, including this
one, should equal zero)
0Bh 5 BYTEs reserved (0)
(Table F022)
Call BIOS32 Service Directory entry point with:
EBX = function
00000000h get service entry point
EAX = service identifier
49435024h ("ICP$") PCI BIOS
46434124h ("FCA$") Plug-and-Play Auto-Configuration
Return: AL = status
00h successful
EBX = base address of handler's code seg
ECX = size of code segment
EDX = offset of handler in code seg
80h unknown service identifier
else
Return: AL = 81h invalid function
Notes: the BSD handler assumes that it is running in a 32-bit code segment
the returned entry points for PCI BIOS and Auto-Config must be called
with the same registers as the real-mode INT 1Ah interface,
including the value B1h or B4h in AH (AMI BIOS v1.00.05.AX1 returns
the same entry point for both interfaces and uses AH to distinguish
which API is desired)
some references indicate that only BL is used for the function number,
though at least one implementation actually checks the entire EBX
register; for maximum compatibility, the upper 24 bits of EBX should
be cleared when calling the entry point
SeeAlso: #F021
--------E-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Borland TKERNEL
InstallCheck: see INT 2F/AX=FBA1h/BX=0082h
SeeAlso: INT 2F/AX=FBA1h/BX=0082h
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Buffit v3.0
InstallCheck: see INT 60"Buffit"
SeeAlso: INT 60"Buffit"
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - CEMM v5.10+ Private API
InstallCheck: see INT 21/AX=4402h/SF=00h
SeeAlso: INT 21/AX=4402h/SF=00h
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Cloaking - PROTECTED-MODE API
InstallCheck: see INT 2C/AX=001Dh
SeeAlso: INT 2C/AX=001Dh
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Cloaking - REAL-MODE API
InstallCheck: see INT 2F/AX=4310h"Cloaking"
SeeAlso: INT 2F/AX=4310h"Cloaking"
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - CTMMSYS.SYS - API
InstallCheck: see INT 21/AX=4402h"CTMMSYS"
Program: CTMMSYS.SYS is the Creative DOS Multimedia Architecture Integration
driver
SeeAlso: INT 21/AX=4402h"CTMMSYS"
--------Q-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DESQview XDI - Driver API
InstallCheck: see INT 2F/AX=DE01h
SeeAlso: INT 2F/AX=DE01h
--------D-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DOS Device Drivers
InstallCheck: see INT 21/AH=52h
SeeAlso: INT 21/AH=52h
--------E-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DOS Protected-Mode Interface - MODE SWITCH
InstallCheck: see INT 2F/AX=1687h
SeeAlso: INT 2F/AX=1687h
--------E-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DOS Protected-Mode Interface - Phar Lap RUN286
InstallCheck: see INT 2F/AX=168Ah
SeeAlso: INT 2F/AX=168Ah
--------E-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DOS Protected-Mode Interface - Vendor-Specific APIs
InstallCheck: see INT 31/AX=0A00h
SeeAlso: INT 31/AX=0A00h
--------E-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DOS Protected-Mode Interface - Windows Support
InstallCheck: see INT 2F/AX=168Ah
SeeAlso: INT 2F/AX=168Ah
--------E-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DOS Protected-Mode Services
InstallCheck: see INT 2F/AX=43E0h
SeeAlso: INT 2F/AX=43E1h
--------T-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DOS Task Switcher - Callout
InstallCheck: see INT 2F/AX=4B01h
SeeAlso: INT 2F/AX=4B01h
--------T-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - DOS Task Switcher
InstallCheck: see INT 2F/AX=4B02h
SeeAlso: INT 2F/AX=4B02h
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Enhanced Parallel Port (EPP) BIOS
InstallCheck: see INT 17/AX=0200h/BX=5050h
SeeAlso: INT 17/AX=0200h/BX=5050h
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Extended Memory Specification (XMS)
InstallCheck: see INT 2F/AX=4300h
SeeAlso: INT 2F/AX=4310h
--------c-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - FASTOPEN
InstallCheck: see INT 2F/AX=122Ah
SeeAlso: INT 2F/AX=122Ah
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - HIGHUMM.SYS
InstallCheck: see INT 21/AX=4402h"HIGHUMM"
SeeAlso: INT 21/AX=4402h"HIGHUMM"
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - HugeRealMode Driver
InstallCheck: see INT 78/AX=0000h,INT 78/AX=0001h
SeeAlso: INT 78/AX=0001h
--------V-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - IBM 8514/A Adapter Interface (HDILOAD)
InstallCheck: see INT 7F/AX=0105h
SeeAlso: INT 7F/AX=0105h
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - IBM 8516 Touch Screen Device Driver
InstallCheck: see INT 7F/AX=ABCDh
SeeAlso: INT 7F/AX=ABCDh
--------u-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - IBM System 36/38 Workstation Emulation
InstallCheck: see INT 0C"SYSTEM 36/38"
SeeAlso: INT 0C"SYSTEM 36/38"
--------D-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - IFS Drivers
InstallCheck: see INT 21/AH=52h
SeeAlso: INT 21/AH=52h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - IFSHLP.SYS
InstallCheck: see INT 21/AH=3Fh"IFSHLP"
SeeAlso: INT 21/AH=3Fh"IFSHLP"
--------b-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Intel BIOS Upgrade
InstallCheck: scan paragraph boundaries from 0F0000h to 0FFFFFh for signature
string "$IBU" (see #F023)
SeeAlso: INT 15/AX=D042h/BL=00h
!!! IAL\PROCESSR\PPROBIOS.PDF page 60
Format of Intel BIOS Upgrade header:
Offset Size Description (Table F023)
00h 4 BYTEs signature "$IBU"
04h BYTE IBU specification version (currently 01h = 1.0)
05h BYTE length of entire header structure in bytes (currently 17h)
06h BYTE checksum (forces 8-bit sum of all header bytes to 00h)
07h DWORD real-mode entry point address
0Bh WORD offset of 16-bit protected mode entry point
0Dh DWORD segment base address of 16-bit protected-mode entry point
11h WORD real-mode data segment address
13h DWORD segment base address of 16-bit protected-mode data segment
Notes: calls from 32-bit protected mode may be made to the 16-bit entry
point, but must ensure that any stack arguments are pushed as
16-bit values instead of 32-bit values
the entry point uses standard C calling conventions to implement
functions prototyped as
int far (*entrypoint)(int function, ...)
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Interrupt Sharing Protocol
InstallCheck: see INT 2D"AMIS"
SeeAlso: INT 2D"AMIS"
--------X-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Intel System Management Bus BIOS
InstallCheck: see INT 15/AX=53B0h/BH=01h,INT 15/AX=53B0h/BH=02h
SeeAlso: INT 15/AX=53B0h/BH=01h,INT 15/AX=53B0h/BH=05h
--------G-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - INTRSPY v1.0 only
InstallCheck: see INT 60"INTRSPY"
SeeAlso: INT 60"INTRSPY"
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Memory Managers
InstallCheck: see INT 21/AX=4402h/SF=00h
SeeAlso: INT 21/AX=4402h/SF=00h
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Microsoft EMM386.EXE
InstallCheck: see INT 67/AX=FFA5h
SeeAlso: INT 67/AX=FFA5h
--------M-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Microsoft Mouse Driver - Alternate Entry Point
InstallCheck: INT 33 must be non-NULL, and must not point at an IRET
instruction; the alternate entry point is located two bytes past
the INT 33 handler
Note: this alternate entry point accepts the same arguments as the
INT 33 interface, but is invoked with a FAR CALL instead of INT 33.
SeeAlso: INT 33/AX=0000h
--------k-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Microsoft Real-Time Compression Interface (MRCI)
InstallCheck: see INT 1A/AX=B001h
SeeAlso: INT 1A/AX=B001h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Microsoft Workgroup Connection - WORKGRP.SYS
InstallCheck: see INT 21/AH=3Fh"WORKGRP.SYS"
SeeAlso: INT 21/AX=4402h"WORKGRP.SYS"
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - DOSMGR Device
InstallCheck: see INT 2F/AX=1684h/BX=0015h
SeeAlso: INT 2F/AX=1684h/BX=0015h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - EDOS Device
InstallCheck: see INT 2F/AX=1684h/BX=2925h
SeeAlso: INT 2F/AX=1684h/BX=2925h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - POSTMSG Device
InstallCheck: see INT 2F/AX=1684h/BX=8888h
SeeAlso: INT 2F/AX=1684h/BX=8888h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - REBOOT Device
InstallCheck: see INT 2F/AX=1684h/BX=0009h
SeeAlso: INT 2F/AX=1684h/BX=0009h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - SHELL Device
InstallCheck: see INT 2F/AX=1684h/BX=0017h
SeeAlso: INT 2F/AX=1684h/BX=0017h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - VADMAD Device
InstallCheck: see INT 2F/AX=1684h/BX=0444h
SeeAlso: INT 2F/AX=1684h/BX=0444h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - VbillD Device
InstallCheck: see INT 2F/AX=1684h/BX=8888h
SeeAlso: INT 2F/AX=1684h/BX=8888h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - VSWITCHD Device
InstallCheck: see INT 2F/AX=1684h/BX=0750h
SeeAlso: INT 2F/AX=1684h/BX=0750h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - VTD Device
InstallCheck: see INT 2F/AX=1684h/BX=0005h
SeeAlso: INT 2F/AX=1684h/BX=0005h
--------W-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - MS Windows - WPS Device
InstallCheck: see INT 2F/AX=1684h/BX=310Eh
SeeAlso: INT 2F/AX=1684h/BX=310Eh
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Netroom RM386 v6.00
InstallCheck: see INT 2F/AX=4310h
SeeAlso: INT 2F/AX=4310h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell - ODI Link Support Layer
InstallCheck: see INT 2F/AX=C000h"LSL.COM"
SeeAlso: INT 2F/AX=C000h"LSL.COM"
--------O-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell DOS 7 DELWATCH.EXE
InstallCheck: see INT 2F/AX=10FEh
SeeAlso: INT 2F/AX=10FEh
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell DOS 7 EMM386.EXE
InstallCheck: see INT 2F/AX=12FFh/BX=0106h
SeeAlso: INT 2F/AX=12FFh/BX=0106h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - Access Server Driver
InstallCheck: see INT 2F/AX=7AF1h
SeeAlso: INT 2F/AX=7AF1h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - DOS Requester
InstallCheck: see INT 2F/AX=7A20h/BX=0000h
SeeAlso: INT 2F/AX=7A20h/BX=0000h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell Netware - Event Service Layer
InstallCheck: see INT 2F/AX=C000h"NESL"
SeeAlso: INT 2F/AX=C000h"NESL"
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - IPX
InstallCheck: see INT 2F/AX=7A00h
SeeAlso: INT 2F/AX=7A00h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - IPXODI
InstallCheck: see INT 2F/AX=7A2Fh
SeeAlso: INT 2F/AX=7A2Fh
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - TCP/IP Protocol Stack
InstallCheck: see INT 2F/AX=7A40h
SeeAlso: INT 2F/AX=7A40h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - VLM
InstallCheck: see INT 2F/AX=7A20h/BX=0000h
SeeAlso: INT 2F/AX=7A20h/BX=0000h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - VLM CallA
InstallCheck: see INT 2F/AX=7A20h/BX=0001h
SeeAlso: INT 2F/AX=7A20h/BX=0001h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - VLM Multicast
InstallCheck: see INT 2F/AX=7A20h/BX=0004h
SeeAlso: INT 2F/AX=7A20h/BX=0004h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - VLM Multiplex
InstallCheck: see INT 2F/AX=7A20h/BX=0002h
SeeAlso: INT 2F/AX=7A20h/BX=0002h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare - VLM Parse API
InstallCheck: see INT 2F/AX=7A20h/BX=0003h
SeeAlso: INT 2F/AX=7A20h/BX=0003h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare Lite - CLIENT
InstallCheck: see INT 2F/AX=D800h
SeeAlso: INT 2F/AX=D800h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare Lite - NLCACHE/NWCACHE
InstallCheck: see INT 2F/AX=D8C0h
SeeAlso: INT 2F/AX=D8C0h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Novell NetWare Lite - SERVER
InstallCheck: see INT 2F/AX=D880h
SeeAlso: INT 2F/AX=D880h
--------R-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - pcANYWHERE IV/LAN
InstallCheck: see INT 21/AX=2B44h/BX=4D41h
SeeAlso: INT 21/AX=2B44h/BX=4D41h
--------X-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - PCI BIOS v2.0c Protected-Mode API
InstallCheck: see INT 1A/AX=B101h
SeeAlso: INT 1A/AX=B101h
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - PenDOS PENDEV.SYS
InstallCheck: see INT 21/AX=4402h"PENDEV"
SeeAlso: INT 21/AX=4402h"PENDEV"
--------E-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Phar Lap 386/DOS-Extender v4.1
InstallCheck: see INT 2F/AX=ED03h
SeeAlso: INT 2F/AX=ED03h
--------X-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Plug-and-Play BIOS v1.0A
InstallCheck: scan paragraph boundaries F000h to FFFFh for signature string
"$PnP" followed by a valid Plug-and-Play header structure
(see #F024)
SeeAlso: @xxxxh:xxxxh"BIOS32 Service Directory",INT 1A/AH=B4h
Format of Plug-and-Play Installation Structure:
Offset Size Description (Table F024)
00h 4 BYTEs signature "$PnP"
04h BYTE Plug-and-Play version (major in high nybble, BCD minor in low)
10h for current specification
05h BYTE length of Installation Structure in bytes
06h WORD control field
bits 15-2 reserved
bits 1-0: event notification mechanism
00 not supported
01 polling
10 asynchronous (interrupt time)
08h BYTE checksum (8-bit sum of all bytes in structure, including this
one, should equal zero)
09h DWORD physical address of event notification flag if using polling
(bit 0 set when a system even occurs)
0Dh WORD real mode entry offset (see #F025)
0Fh WORD real mode code segment
11h WORD 16-bit protected mode entry point offset (see #F025)
13h DWORD 16-bit protected mode code segment base address
17h DWORD OEM device identifier
1Bh WORD real mode data segment
1Dh DWORD 16-bit protected mode data segment base address
(Table F025)
Call Plug-and-Play BIOS entry point with:
STACK: WORD function number
0000h Get Number of System Device Nodes (see #F026)
0001h Get System Device Node (see #F027)
0002h Set System Device Node (see #F028)
0003h Get Event (see #F029)
0004h Send Message (see #F031)
0005h Get Docking Station Information (see #F033)
0006h reserved for future versions
0007h Select Primary Boot Devices (see #F034)
0008h Get Primary Boot Devices (see #F035)
0009h Set Statically Allocated Resource Information
(see #F037)
000Ah Get Statically Allocated Resource Information
(see #F038)
000Bh Get APM ID Table (see #F039)
0040h Get Plug-and-Play ISA Configuration Structure
(see #F041)
0041h Get Extended System Configuration Data Info
(see #F043)
0042h Read Extended SYstem Configuration Data
(see #F044)
0043h Write Extended SYstem Configuration Data
(see #F045)
---Desktop Management Interface v2.0---
0050h Get DMI Information (see #F046)
0051h Get DMI structure (see #F047)
---BIOS Boot Specification---
0060h Get Version and Installation Check (see #F048)
0061h Get IPL Device Count (see #F049)
0062h Get Boot Priority and IPL Table (see #F050)
0063h Set Boot Priority (see #F051)
0064h Get IPL Device from Last Boot (see #F052)
0065h Get Boot First (see #F053)
0066h Set Boot First (see #F054)
0067h-006Fh reserved
var function arguments
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Notes: the caller must provide at least 1024 bytes of stack space for use by
the Plug-and-Play BIOS
this API is bi-modal; all calls are available in both real mode and
16-bit protected mode (if calling from 32-bit protected mode, care
must be taken to ensure proper alignment of the stack arguments)
SeeAlso: #F024
(Table F026)
Call Plug-and-Play BIOS function 00h with:
STACK: WORD 0000h (function "Get Number of System Device Nodes")
DWORD -> BYTE in which to return number of device nodes
DWORD -> WORD in which to return size of largest device node
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned char *, unsigned int *, unsigned int);
(Table F027)
Call Plug-and-Play BIOS function 01h with:
STACK: WORD 0001h (function "Get System Device Node")
DWORD -> BYTE containing node number or handle
DWORD -> buffer for device node
WORD control flag
bits 15-2 reserved (0)
bit 1: get static config (values for next boot)
bit 0: get current (dynamic) configuration
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Notes: the large-model C declaration is
int (*entry)(int, unsigned char *, DEV_NODE *, unsigned int,
unsigned int);
exactly one of the two defined bits in the control flag must be set
(Table F028)
Call Plug-and-Play BIOS function 02h with:
STACK: WORD 0002h (function "Set System Device Node")
DWORD -> BYTE containing node number or handle
DWORD -> buffer containing device node
WORD control flag
bits 15-2 reserved (0)
bit 1: set static config (values for next boot)
bit 0: set current (dynamic) configuration
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Notes: the large-model C declaration is
int (*entry)(int, unsigned char *, DEV_NODE *, unsigned int,
unsigned int);
exactly one of the two defined bits in the control flag must be set
(Table F029)
Call Plug-and-Play BIOS function 03h with:
STACK: WORD 0003h (function "Get Event")
DWORD -> WORD buffer for event message identifier (see #F030)
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned int *, unsigned int);
(Table F030)
Values for PnP Event Identifier:
0001h "ABOUT_TO_CHANGE_CONFIG" preliminary notification of changes, including
docking and undocking
0002h "DOCK_CHANGED" devices have been added to or removed from system
0003h "SYSTEM_DEVICE_CHANGED" removable system devices have been inserted
or removed
0004h "CONFIG_CHANGE_FAILED" error detected while atempting to add or remove
devices
8000h-FFFEh OEM-defined events
FFFFh "UNKNOWN_SYSTEM_EVENT"
(Table F031)
Call Plug-and-Play BIOS function 04h with:
STACK: WORD 0004h (function "Send Message")
WORD message identifier (see #F032)
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned int, unsigned int);
SeeAlso: #F031,#F033
(Table F032)
Values for PnP Message Identifier:
0000h "OK"
0001h "ABORT" action which caused an ABOUT_TO_X message
0002h-003Fh reserved for future Response Messages
0040h "UNDOCK_DEFAULT_ACTION"
0041h "POWER_OFF"
0042h "PNP_OS_ACTIVE"
0043h "PNP_OS_INACTIVE"
0044h-007Fh reserved for future Control Messages
8000h-FFFFh OEM-defined messages
(Table F033)
Call Plug-and-Play BIOS function 05h with:
STACK: WORD 0005h (function "Get Docking Station Information")
DWORD -> buffer for docking station info (see #F036)
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned char *, unsigned int);
SeeAlso: #F031,#F034
(Table F034)
Call Plug-and-Play BIOS function 07h with:
STACK: WORD 0007h (function "Select Primary Boot Devices")
WORD type of primary boot device
0000h primary input
0001h primary output
0002h primary IPL
DWORD Plug-and-Play 32-bit device ID or FFFFFFFFh for ISA
DWORD device serial number or FFFFFFFFh
DWORD 32-bit logical device ID or FFFFFFFFh for ISA device
WORD physical unit number
WORD control flag
bits 15-1 reserved (0)
bit 0: do not check for attached device during PnP POST
boot device selection
DWORD -> preferred resource allocation or -> END_TAG if none
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, int, unsigned long, unsigned long, unsigned long,
int, int, char *, unsigned int);
(Table F035)
Call Plug-and-Play BIOS function 08h with:
STACK: WORD 0008h (function "Get Primary Boot Devices")
WORD type of primary boot device
0000h primary input
0001h primary output
0002h primary IPL
DWORD -> DWORD buffer for Plug-and-Play 32-bit device ID
DWORD -> DWORD buffer for device serial number
DWORD -> DWORD buffer for logical device ID
DWORD -> WORD buffer for physical unit number
DWORD -> buffer for preferred resource allocation
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, int, unsigned long *, unsigned long *,
unsigned long *, unsigned int *, char *, unsigned int);
Format of Plug-and-Play Docking Station Information:
Offset Size Description (Table F036)
00h DWORD docking station location identifier (EISA device ID format)
FFFFFFFFh if unknown or no product identifier
04h DWORD serial number or 00000000h
08h WORD capabilities
bits 15-3 reserved (0)
bits 2-1: hot-pluggability
00 power-down required to dock/undock
01 must be in suspend mode ("warm" dock/undock)
10 system can be hot-docked
11 reserved
bit 0: docking station provides support for controlling
sequence of docking/undocking
(Table F037)
Call Plug-and-Play BIOS function 09h with:
STACK: WORD 0009h (function "Set Statically Allocated Resource
Information")
DWORD -> block of statically-allocated resources as described
in the Plug-and-Play ISA Spec
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Notes: the large-model C declaration is
int (*entry)(int, unsigned char *, unsigned int);
if the returned status is 008Dh, the Plug-and-Play BIOS supports
ESCD, and the caller should thus use functions 41h to 43h instead
of 09h and 0Ah
(Table F038)
Call Plug-and-Play BIOS function 0Ah with:
STACK: WORD 000Ah (function "Get Statically Allocated Resource
Information")
DWORD -> buffer for statically-allocated resources as
described in the Plug-and-Play ISA Spec
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Notes: the large-model C declaration is
int (*entry)(int, unsigned char *, unsigned int);
if the returned status is 008Dh, the Plug-and-Play BIOS supports
ESCD, and the caller should thus use functions 41h to 43h instead
of 09h and 0Ah
(Table F039)
Call Plug-and-Play BIOS function 0Bh with:
STACK: WORD 000Bh (function "Get APM ID Table")
Information")
DWORD -> WORD buffer for size of data buffer
DWORD -> buffer for storing APM ID table (see #F040)
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Desc: copies the Advanced Power Management v1.1 device identifier table to
Plug-and-Play device identifier mappings
Note: the large-model C declaration is
int (*entry)(int, unsigned int *, unsigned char *, unsigned int);
SeeAlso: INT 15/AX=5300h
Format of Plug-and-Play APM ID Table:
Offset Size Description (Table F040)
00h DWORD Plug-and-Play device identifier
04h WORD APM v1.1+ identifier
SeeAlso: #F039
(Table F041)
Call Plug-and-Play BIOS function 40h with:
STACK: WORD 0040h (function "Get Plug-and-Play ISA Configuration
Structure")
DWORD -> buffer for configuration structure (see #F042)
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned char *, unsigned int);
Format of Plug-and-Play ISA Configuration Structure:
Offset Size Description (Table F042)
00h BYTE structure revision level (01h)
01h BYTE total Card Select Numbers (CSNs) assigned
02h WORD ISA Read Data Port (see also PORT 0A79h)
04h WORD reserved (0)
SeeAlso: #F041
(Table F043)
Call Plug-and-Play BIOS function 41h with:
STACK: WORD 0041h (function "Get Extended System Configuration
Information")
DWORD -> WORD buffer for size of nonvolatile storage
DWORD -> WORD buffer for size of ESCD allocated
DWORD -> DWORD buffer for physical base address of NV storage
(if memory-mapped, else 00000000h)
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned int *, unsigned int *, unsigned long *,
unsigned int);
SeeAlso: INT 1A/AX=B401h
(Table F044)
Call Plug-and-Play BIOS function 42h with:
STACK: WORD 0042h (function "Read Extended System Configuration
Data")
DWORD -> buffer for storing ESCD
WORD read/writable selector for ESCD if memory-mapped and
called in protected mode (ignored otherwise)
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Notes: the large-model C declaration is
int (*entry)(int, unsigned char *, unsigned int, unsigned int);
if an ESCD selector is required, the caller must construct a 16-bit
data segment selector with a limit of 64K
(Table F045)
Call Plug-and-Play BIOS function 43h with:
STACK: WORD 0043h (function "Write Extended System Configuration
Data")
DWORD -> buffer containing ESCD
WORD read/writable selector for ESCD if memory-mapped and
called in protected mode (ignored otherwise)
WORD PnP BIOS writable segment/selector
Return: AX = status (see #F055)
Notes: the large-model C declaration is
int (*entry)(int, unsigned char *, unsigned int, unsigned int);
if an ESCD selector is required, the caller must construct a 16-bit
data segment selector with a limit of 64K
(Table F046)
Call Desktop Management Specification function 50h with:
STACK: WORD 0050h (function "Get DMI Information")
DWORD -> buffer for ASCIZ DMI BIOS revision string
DWORD -> WORD to receive number of DMI structures
DWORD -> WORD to receive DMI structure size
DWORD -> DWORD to receive DMI storage base address
DWORD -> WORD to receive DMI storage size
WORD BIOS selector
Return: AX = status (see #F055)
Note: the large-model C declaration is
short (*entry)(int, unsigned char *, unsigned short *,
unsigned short *, unsigned long *, unsigned short *,
unsigned short) ;
SeeAlso: #F047
(Table F047)
Call Desktop Management Specification function 51h with:
STACK: WORD 0051h (function "Get DMI Structure")
DWORD -> WORD "structure"
DWORD -> buffer for DMI structure
WORD DMI selector
WORD BIOS selector
Return: AX = status (see #F055)
Note: the large-model c declaration is
short (*entry)(int, unsigned short *, unsigned char *, unsigned short,
unsigned short) ;
SeeAlso: #F046
(Table F048)
Call BIOS Boot Specification function 60h with:
STACK: WORD 0060h (function "Get Version and Installation Check")
DWORD -> WORD buffer for BIOS Boot Spec version number (BCD)
Return: AX = status (see #F055)
0081h if BIOS Boot not available
Note: the large-model C declaration is
int (*entry)(int, int *) ;
SeeAlso: #F049,#F050,#F051,#F052
(Table F049)
Call BIOS Boot Specification function 61h with:
STACK: WORD 0061h (function "Get IPL Device Count")
DWORD -> WORD buffer for number of IPL devices in system
DWORD -> WORD buffer for max. number of IPL devices supported
DWORD -> WORD buffer for size of an IPL table entry
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned int *, unsigned int *, unsigned int *) ;
SeeAlso: #F048,#F050,#F051,#F052
(Table F050)
Call BIOS Boot Specification function 62h with:
STACK: WORD 0062h (function "Get Boot Priority and IPL Table")
DWORD -> buffer for copy of boot priority stored in NVRAM
DWORD -> buffer for IPL table
Return: AX = status (see #F055)
Notes: the large-model C declaration is
int (*entry)(int, unsigned char *, unsigned char *) ;
the size of the boot priority buffer must be at least MaxIPL bytes
(see #F049), of which the first CurrentIPL bytes are valid, with
the lowest-valued byte indicating the device which should attempt
booting first, the next lowest second, etc.
the size of the IPL table buffer must be at least MaxIPL + IPLsize
bytes (see #F049)
SeeAlso: #F048,#F049,#F051,#F052
(Table F051)
Call BIOS Boot Specification function 63h with:
STACK: WORD 0063h (function "Set Boot Priority")
DWORD -> buffer containing new boot priority list (see #F050)
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned char *) ;
SeeAlso: #F048,#F049,#F050,#F052
(Table F052)
Call BIOS Boot Specification function 64h with:
STACK: WORD 0064h (function "Get IPL Device from Last Boot")
DWORD -> WORD buffer for index in IPL table of boot device
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int, unsigned int *) ;
SeeAlso: #F048,#F049,#F050,#F051,#F053
(Table F053)
Call BIOS Boot Specification function 65h with:
STACK: WORD 0065h (function "Get Boot First")
DWORD -> WORD buffer for index in IPL table of current
first boot device
Return: AX = status (see #F055)
Notes: the large-model C declaration is
int (*entry)(int, unsigned int *) ;
the boot-first device will attempt booting before the boot-priority
list is considered
SeeAlso: #F048,#F049,#F050,#F051,#F054
(Table F054)
Call BIOS Boot Specification function 66h with:
STACK: WORD 0066h (function "Set Boot First")
DWORD -> WORD containing index in IPL table of new device
from which to attempt booting first before
considering the boot priority list
Return: AX = status (see #F055)
Note: the large-model C declaration is
int (*entry)(int,
SeeAlso: #F048,#F049,#F050,#F051,#F053
(Table F055)
Values for Plug-and-Play function status code:
0000h successful
0001h boot device resource configuration not saved to nonvolatile memory
0002h-007Eh reserved for future warnings
0055h unable to read/write Extended System Config Data from nonvolatile mem
0056h no valid Extended System Configuration Data in nonvolatile storage
0059h user's buffer was too small for Extended System Configuration Data
007Fh device could not be configured statically, but dynamic config succeeded
0081h unknown function
0082h unsupported function
0083h invalid device node (or DMI structure) number/handle
0084h bad parameter
0085h failure setting device node
invalid DMI subfunction
0086h no pending events
0087h system not docked
0088h no ISA Plug-and-Play cards installed
0089h unable to determine docking station's capabilities
008Ah undocking sequence failed because system unit does not have a battery
008Bh resource conflict with a primary boot device
008Ch buffer provided by user was too small
008Dh must use ESCD support for specified device
008Eh message not supported
008Fh hardware error
SeeAlso: #0939
Format of Option ROM header:
Offset Size Description (Table F056)
00h WORD AA55h signature
02h BYTE length of option ROM in 512-byte pages (should be multiple 4)
03h 4 BYTEs standard initialization entry point
(called with ES:DI -> PnP Installation Structure)
07h 19 BYTEs reserved
1Ah WORD offset to PnP Expansion Header
Format of Expansion Header:
Offset Size Description (Table F057)
00h 4 BYTEs signature ("$PnP" for Plug-and-Play expansion header)
04h BYTE structure version number
05h BYTE length of entire header in paragraphs
06h WORD offset to next header or 0000h
08h BYTE reserved
09h BYTE checksum (sum of all bytes in header, including this one,
mod 256 should equal zero)
---PnP Expansion Header---
0Ah DWORD Plug-and-Play device identifier
0Eh WORD offset of manufacturer ID string in Option ROM or 0000h
10h WORD offset of product name string in Option ROM or 0000h
12h 3 BYTEs device type code (see #F059)
byte 0: base type (general kind of device)
byte 1: device subtype
byte 2: device programming interface
15h BYTE device indicator flags (see #F058)
16h WORD Boot Connection Vector offset (real/protected mode) or 0000h
(see #F062)
18h WORD Disconnect Vector offset (real/protected mode) or 0000h
far-called by system BIOS is boot attempt failed
1Ah WORD bootstrap entry point (real/protected mode) or 0000h
1Ch WORD reserved (0)
1Eh WORD Static Resource Information offset (real/prot mode) or 0000h
should be used only by non-PnP devices to make them PnP-aware
(see #F063)
Bitfields for Plug-and-Play device indicator flags:
Bit(s) Description (Table F058)
7 supports Device Driver Initialization model
6 may be shadowed in RAM
5 may be read cached
4 only required if device used for booting
3 reserved (0)
2 device is Initial Program Load (IPL, i.e. boot) device
1 device is Input device
0 device is Display device
SeeAlso: #F059
(Table F059)
Values for Plug-and-Play device type code:
Type Subtype Description
00h --- reserved
01h --- mass storage
00h SCSI controller
01h IDE controller
02h floppy controller (NEC 765-compatible)
03h IPI controller
04h RAID controller
80h other
02h --- network interface controller
00h Ethernet
01h Token Ring
02h FDDI
03h ATM
80h other
03h --- display controller
00h VGA
01h SuperVGA
02h XGA
80h other
04h --- multi-media controller
00h video
01h audio
80h other
05h --- memory
00h RAM
01h Flash memory
80h other
06h --- bridge controller
00h host processor bridge
01h ISA bridge
02h EISA bridge
03h MicroChannel bridge
04h PCI bridge
05h PCMCIA bridge
06h NuBus bridge
07h CardBus bridge
80h other
07h --- communications device
00h XT-compatible RS-232
01h AT-compatible parallel port
80h other
08h --- system peripherals
00h 8259-compatible Programmable Interrupt Controller
01h 8237-compatible DMA Controller
02h 8254-compatible system timer
03h real-time clock
80h other
09h --- input device
00h keyboard controller
01h digitizer/pen
02h mouse
80h other
0Ah --- docking station
00h generic docking station
80h other
0Bh --- CPU
00h 386-based
01h 486-based
02h Pentium-based
03h Pentium-Pro (P6)
10h DEC Alpha
40h coprocessor
0Ch --- Serial Bus controller
00h Firewire (IEEE 1394)
01h ACCESS.bus
02h SSA
03h Universal Serial Bus (USB)
programming interface 10h = OpenHCI Host Controller
SeeAlso: #F058,#F060,#0798
(Table F060)
Values for Plug-and-Play generic EISA device ID:
PNP0xxx system devices
PNP00xx interrupt controller
PNP0000 AT interrupt controller
PNP0001 EISA interrupt controller
PNP0002 MCA interrupt controller
PNP0003 APIC
PNP0004 Cyrix SLiC MP interrupt controller
PNP01xx timer
PNP0100 AT timer
PNP0101 EISA timer
PNP0102 MCA timer
PNP02xx DMA controller
PNP0200 AT DMA controller
PNP0201 EISA DMA controller
PNP0202 MCA DMA controller
PNP03xx keyboard
PNP0300 PC/XT keyboard controller (83-key)
PNP0301 PC/AT keyboard controller (84-key)
PNP0302 PC/XT keyboard controller (84-key)
PNP0303 IBM enhanced keyboard (101/102-key, PS/2 mouse)
PNP0304 Olivetti keyboard (83-key)
PNP0305 Olivetti keyboard (102-key)
PNP0306 Olivetti keyboard (86-key)
PNP0307 enhanced keyboard with Windows keys
PNP0308 General Input Device Emulation Interface (GIDEI) legacy
PNP0309 Olivetti keyboard (A101/102-key)
PNP030A AT&T 302 keyboard
PNP04xx parallel port
PNP0400 standard printer port
PNP0401 ECP printer port
PNP05xx serial port
PNP0500 standard 8250/16450 UART
PNP0501 16550A-compatible UART
PNP06xx disk controller
PNP0600 generic ESDI/IDE/ATA controller
PNP0601 Plus Hardcard II
PNP0602 Plus Hardcard IIXL/EX
PNP0700 standard floppy controller
PNP0800 PC speaker
PNP09xx display adapter
PNP0900 VGA-compatible
PNP0Axx periperal bus
PNP0A00 ISA
PNP0A01 EISA
PNP0A02 MCA
PNP0A03 PCI
PNP0A04 VESA/VL bus
PNP0A05 generic ACPI bus
PNP0A06 extended IO bus
PNP0A07 SMB bus
PNP0A08 ACPI three-wire device bus
PNP0A09 ACPI two-wire device bus
PNP0B00 AT-style real-time clock
PNP0Cxx BIOS/system board
PNP0C00 Plug-and-Play BIOS
PNP0C01 system board
PNP0C02 (PnP-reserved resources)
PNP0C03 Plug-and-Play event notification interrupt
PNP0C04 math coprocessor
PNP0C08 ACPI driver/BIOS
PNP0C09 embedded controller device
PNP0C0A control method battery
PNP0C0B fan
PNP0C0C power button
PNP0C0D lid
PNP0Exx PCMCIA controller chipset
PNP0E00 Intel 82365-compatible
PNP0Fxx mouse
PNP8xxx network adapter
PNP9xxx modem
PNPAxxx SCSI controller/proprietary CD-ROM controller
PNPA000 Adaptec 154x-compatible
PNPA001 Adaptec 174x-compatible
PNPA002 Future Domain 16-700-compatible
PNPBxxx sound/video/multimedia
PNPB000 Sound Blaster 1.5
PNPB001 Sound Blaster 2.0
PNPB002 Sound Blaster Pro
PNPB004 Thunderboard
PNPB005 Adlib-compatible FM synthesis
PNPB006 MPU-401
PNPB007 Microsoft Windows Sound System
PNPB008 Compaq Waveform
PNPB010 Motion Video device (MCI)
PNPB011 MIDI Sequencer (MCI)
PNPB012 Wave Audio (MCI)
PNPB013 VISCA VCR (MCI)
PNPB014 Pioneer Laserdisk (MCI)
PNPB015 CD Audio (MCI)
PNPB020 Yamaha OPL3-compatible FM synthesis
PNPB02F joystick/game port
ACPI0001 three-wire serial memory device
ACPI0002 two-wire serial memory device
SeeAlso: #F059,#F061
(Table F061)
Values for data tags:
22h IRQ descriptor, no flags
23h IRQ descriptor, with flags
2Ah DMA descriptor
30h Dependent Function start
31h Dependent Function start, with priority byte
38h Dependent Function end
47h I/O port descriptor
4Bh fixed-location I/O port descriptor
78h "END_TAG" end of resource descriptors
SeeAlso: #F060
(Table F062)
Values Boot Connection Vector is called with:
AX = which vectors to hook
bit 2: connect as IPL (INT 13)
bit 1: connect as primary video (INT 10)
bit 0: connect as primary input (INT 09)
ES:DI -> system BIOS PnP Installation Check Structure
BX = Card Select Number for this card (ISA bus only)
DX = read data port (ISA only) or FFFFh
SeeAlso: #F063
(Table F063)
Values Static Resource Information vector is called with:
ES:DI -> buffer for device's static resource config info (at least 1024
bytes)
SeeAlso: #F062
Format of Plug-and-Play System Device Node:
Offset Size Description (Table F064)
00h WORD size of device node in bytes
02h BYTE device node number/handle
03h DWORD EISA product identifier
07h 3 BYTEs device type code
0Ah WORD attribute flags
bits 15-9 reserved (0)
bits 8-7: configurability
00 can only be statically configured for next boot
01 can be dynamically configured at runtime
10 reserved
11 can only be dynamically configured
bit 6: removable device
bit 5: docking station
bit 4: capable of being primary IPL (boot) device
bit 3: capable of being primary input device
bit 2: capable of being primary output device
bit 1: device is not configurable
bit 0: device can not be disabled
0Ch var allocated resource configuration descriptors
var possible resource configuration descriptors
var compatible device identifiers
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - POST Memory Manager Specification (PMM) v1.0
InstallCheck: scan paragraph boundaries E000h to FFFFh for signature string
"$PMM" followed by a valid PMM header structure (see #F065)
Note: the PMM is only available at system boot -- between the completion
of the memory check and the call to INT 19; this includes Option
ROM initialization and Plug-and-Play Boot Connection Vectors, but
not the Bootstrap Entry Vector (which is called after INT 19)
SeeAlso: INT 2F/AX=4300h,INT 67/AH=40h
Format of POST Memory Manager Specification structure:
Offset Size Description (Table F065)
00h 4 BYTEs signature "$PMM"
04h BYTE structure version number (01h)
05h BYTE length of structure in bytes
06h BYTE checksum of structure (value needed to force byte-wise sum
of entire structure to be 00h)
07h DWORD -> PMM entry point (real mode only) (see #F066)
0Bh 5 BYTEs reserved (0)
SeeAlso: #F024
(Table F066)
Call POST Memory Manager Specification entry point with:
STACK: WORD function number
0000h pmmAllocate (see #F067)
0001h pmmFind (see #F068)
0002h pmmDeallocate (see #F069)
additional parameters vary by function
Notes: PMM calls use standard large-model C-language calling conventions
the caller must provide at least 256 bytes of stack space; BIOSes
which support this specification will provide at least 1024 bytes
of stack space when calling a ROM initialization vector, Boot
Connection Vector, or Bootstrap Entry Vector (thus allowing the
Option ROM's code to provide sufficient stack space when calling
the PMM)
(Table F067)
Call PMM "pmmAllocate" entry point with:
STACK: WORD 0000h (function "pmmAllocate")
DWORD length of memory block, in paragraphs
if 00000000h, only get size of largest available block
DWORD handle to assign to memory block, or FFFFFFFh for
"anonymous" block
WORD option flags
bit 0: allocate from conventional memory
bit 1: allocate from extended memory
bit 2: use alignment based on least-significant set
bit of requested length
Return: DX:AX = 32-bit physical address of allocated memory block, or
size of largest available block in paragraphs, or
00000000h if specified handle is already in use, or
FFFFFFFFh if allocation failed
Notes: at least one of bits 0 and 1 must be set in the option flags; both
may be set if the location of the memory block is not important
the specification requires that an Option ROM must use handles
compliant with the Plug-and-Play specification (high 16 bits are
manufacturer's vendor ID, low 16 bits are vendor-defined); handles
whose highest bit is set or highest six bits are all clear are
reserved for the BIOS, and the BIOS may flag attempts to use such
reserved handles
SeeAlso: #F066,#F068,#F069
(Table F068)
Call PMM "pmmFind" entry point with:
STACK: WORD 0001h (function "pmmFind")
DWORD handle to be found
Return: DX:AX = 32-bit physical address of allocated memory block, or
00000000h if handle is not in use
Desc: get the address of the memory block associated with the given handle
SeeAlso: #F066,#F067,#F069
(Table F069)
Call PMM "pmmDeallocate" entry point with:
STACK: WORD 0002h (function "pmmDeallocate")
DWORD physical address of block (as returned by pmmAllocate)
Return: DX:AX = FFFFFFFFh on error
Notes: the memory block is cleared to all zeros by the PMM
invalid functions (0003h-FFFFh) return DX:AX = FFFFFFFFh
SeeAlso: #F066,#F067,#F068
--------b-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - BIOS Boot Specification (BBS)
InstallCheck: perform Plug-and-Play installation check, then call PnP
function 60h
SeeAlso: @xxxxh:xxxxh"Plug-and-Play"
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - QEMM Programming Interface (QPI)
InstallCheck: see INT 67/AH=3Fh
SeeAlso: INT 67/AH=3Fh
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - QEXT.SYS Private API
InstallCheck: see INT 15/AX=11DEh
SeeAlso: INT 15/AX=11DEh
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Quarterdeck VIDRAM
InstallCheck: see INT 2F/AX=D201h/BX=5649h
SeeAlso: INT 2F/AX=D201h/BX=5649h
--------s-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - SoundBlaster Speech Driver
InstallCheck: see INT 2F/AX=FBFBh
SeeAlso: INT 2F/AX=FBFBh
--------k-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Stacker
InstallCheck: see INT 2F/AX=4A12h/CX=5354h
SeeAlso: INT 2F/AX=4A12h/CX=5354h
--------s-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - VESA Audio Interface Driver
InstallCheck: see INT 10/AX=4F13h/BX=0002h
SeeAlso: INT 10/AX=4F13h/BX=0002h
--------m-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - Virtual Control Program Interface (VCPI) - Protected-Mode
InstallCheck: see INT 67/AX=DE01h
SeeAlso: INT 67/AX=DE01h
--------N-@xxxxxxxx--------------------------
CALL xxxxh:xxxxh - WEB v4.02 - MODULE APIs
InstallCheck: see INT 2F/AH=EEh
SeeAlso: INT 2F/AH=EEh
---------------------------------------------
----------@xxxxxxxx--------------------------
CALL xxxxh:xxxxh -
InstallCheck:
SeeAlso:
--------!---Admin----------------------------
Highest Table Number = F069
--------!---FILELIST-------------------------
Please redistribute all of the files comprising the interrupt list (listed at
the beginning of the list and in INTERRUP.1ST) unmodified as a group, in a
quartet of archives named INTER55A through INTER55D (preferably the original
authenticated PKZIP archives), and the utility and hypertext conversion
programs in three additional archives called INTER55E.ZIP to INTER55G.ZIP
Copyright (c) 1989,1990,1991,1992,1993,1994,1995,1996,1997 Ralf Brown
--------!---CONTACT_INFO---------------------
Internet: ralf@pobox.com (currently forwards to ralf@telerama.lm.com)
UUCP: {uunet,harvard}!pobox.com!ralf
FIDO: Ralf Brown 1:129/26.1
or post a message to me in the DR_DEBUG echo (I probably won't see it
unless you address it to me)
CIS: >INTERNET:ralf@pobox.com
