MS-DOS Player for Win32-x64 console


MS-DOS Player for Win32-x64 console
2/18/2024

----- What's This

This is MS-DOS emulator running on Win32-x64 command prompt.
16bit MS-DOS compatible commands can be executed on Win32-x64 envrionment.

This emulator inherits the environment variables from the host Windows,
and a target command can access the host's file path directly.

So you can execute 16bit MS-DOS compatible commands on your 64bit Windows
in the same sence as you did on 32bit Windows, and you do not need to copy
any files to/from a virtual machine (VMware, Virtual PC, XP mode, or others).

NOTE: This emulator DOES NOT support Win16 execution files.

This emulator aims to support character user interface utilities, for example
file converters, compilers, assemblers, debuggers, and text editors.

NOTE: This emulator DOES NOT support graphic/sound hardwares and DOES NOT
aim to support game softwares. I recommend DOSBOx for this purpose.


----- How To Use

Start a command prompt and run this emulator with a target command file
and any options.

For example, compile a sample.c with LSI C-86 and execute the compiled binary:

> msdos lcc sample.c
> msdos sample.exe


----- Options

Usage:

MSDOS [-b] [-c[(new exec file)] [-p[P]]] [-d] [-e] [-i] [-m] [-n[L[,C]]]
[-s[P1[,P2[,P3[,P4]]]]] [-sd] [-sc] [-vX.XX] [-wX.XX] [-x] [-a] [-l]
(command) [options]

-b stay busy during keyboard polling
-c convert command file to 32bit or 64bit execution file
-p record current code page when convert command file
-d pretend running under straight DOS, not Windows
-e use a reduced environment block
-i ignore invalid instructions
-m restrict free memory to 0x7FFF paragraphs
-n create a new buffer (25 lines, 80 columns by default)
-s enable serial I/O and set host's COM port numbers
-sd enable DTR/DSR flow control
-sc enable RTS/CTS flow control
-v set the DOS version
-w set the Windows version
-x enable XMS and LIM EMS
-a disable ANSI.SYS
-l draw box lines with ank characters

ISH.COM contains any invalid instructions and it cause an error.
Please specify the option '-i' to ignore the invalid instructions.

> msdos -i ish.com

EDIT.COM does not work correctly when a free memory space is large.
Please specify the option '-m' to restrict free memory to 0x7FFF paragraphs.

> msdos -m edit.com

"Windows Enhanced Mode Installation Check" API (INT 2FH, AX=1600H) and
"Identify Windows Version and Type" API (INT 2FH, AX=160AH) return the Windows
version number 4.10.
If you want to change the version number, please specify the option '-wX.XX'.

> msdos -w3.10 command.com

Or if you want to pretend that Windows is not running, specify the option '-d'.

> msdos -d command.com

"Get Version Number" API (INT 21H, AH=30H) returns the version number 7.10.
If you want to change the version number, please specify the option '-vX.XX'.

> msdos -v3.30 command.com

NOTE: "Get True Version Number" API (INT 21H, AX=3306H) always returns
the version number 7.10 and '-v' option is not affected.

NOTE: the Windows version 4.10 and the DOS version 7.10 are same as Windows 98,

To enable XMS (i286 or later) and LIM EMS, please specify the option '-x'.
In this time, the memory space 0C0000H-0CFFFFH are used for EMS page frame,
so the size of UMB is decreased from 224KB to 160KB.

To enable the serial I/O, please specify the option '-s[P1[,P2[,P3[,P4]]]]'.
If you specify '-s', the virtual COM1-COM4 are connected to the host's COM
ports found by SetupDiGetClassDevs() API.
You can specify the host's COM port numbers connected to the virtual COM ports
by adding numbers to '-s' option, for example '-s3,4,1,2'.

If you specify '-sd', DTR/DSR flow control is enabled.
In this time, MS-DOS Player sets/gets DTR and DSR pins of the host's COM port.
Otherwise, virtual DTR pin is internally connected to virtual DSR pin, and
DTR pin of the host's COM port is always active.

If you specify '-sc', RTS/CTS flow control is enabled.
In this time, MS-DOS Player sets/gets RTS and CTS pins of the host's COM port.
Otherwise, virtual RTS pin is internally connected to virtual CTS pin, and
RTS pin of the host's COM port is always active.

NOTE: The maximum baud rate is limited to 9600bps.


----- Environment Variable Table

Basically, the environment variable table on the host Windows is copied to
the table on the virtual machine (hereinafter, referred to as "virtual table"),
and in this time, APPEND/MSDOS_PATH/PATH/TEMP/TMP values are converted to
short path.

Some softwares (for example DoDiary Version 1.55) expect that the environment
variable table should be less than 1024 bytes.
On the Windows OS, there are too many variables and the environment variable
table size will be more than 1024 bytes and it causes an error.

In this case, please specify the option '-e' and only the minimum environment
variables (APPEND/COMSPEC/LASTDRIVE/MSDOS_PATH/PATH/PROMPT/TEMP/TMP/TZ) are
copied to the virtual table.

> msdos -e dd.com

The environment variable COMSPEC is not copied from the host Windows, and its
value on the virtual table is always "C:\COMMAND.COM".

If a program tries to open the "C:\COMMAND.COM" file, the file is redirected
to the path in the environment variable MSDOS_COMSPEC on the host Windows.
If MSDOS_COMSPEC is not defined, it is redirected to the COMMAND.COM file that
does exist:

- in the same directory as the target program file,
- in the same directory as the running msdos.exe,
- in the current directory,
- in the directory that is in MSDOS_PATH and PATH environment variables

You may have a directory that contains 16bit command files, and you may want
not to add this path to PATH on the host Windows but want to add it to PATH
on the virtual table.

In this case, please define MSDOS_PATH on the host Windows, and its value is
copied to the top of PATH on the virtual table.
In other words, the value of PATH on the virtual table is MSDOS_PATH;PATH
on the host Windows, so a program searches files in directories in MSDOS_PATH
before files in directories in PATH.

You can also define MSDOS_APPEND on the host Windows, and its value is copied
to the top of APPEND on the virtual table.

The environment variables TEMP and TMP on the host Windows may be very long,
in usually, it is "C:\User\(Your User Name)\AppData\Local\Temp".
DOSSHELL.EXE tries to create a batch file in the TEMP directry to start
the selected program, and it may not work correctly because of the too long
batch file path.
In this case, please define MSDOS_TEMP on the host Windows, for example
"C:\TEMP", and its value is copied to TEMP and TMP on the virtual table.

If the environment variable MSDOS_LASTDRIVE is defined on the host Windows,
its value is copied to LASTDRIVE on the virtual table.
If both MSDOS_LASTDRIVE and LASTDRIVE are not defined on the host Windows,
LASTDRIVE=Z is automatically defined on the virtual table.

If the environment variable PROMPT is not defined on the host Windows,
PROMPT=$P$G is automatically defined on the virtual table.

If the environment variable MSDOS_TZ is defined on the host Windows,
its value is copied to TZ on the virtual table.
If both MSDOS_TZ and TZ are not defined on the host Windows,
and if your timezone is in the following table, TZ is automatically defined
on the virtual table, for example TZ=JST-9 in Japan.

NOTE: This table is from:
https://science.ksc.nasa.gov/software/winvn/userguide/3_1_4.htm

------- Greenwich Mean Time ---------------------------------------------------
+00:00 GMT Standard Time GMT BST GB London
+00:00 GMT Standard Time GMT IST IE Dublin
+00:00 GMT Standard Time WET WES PT Lisbon
+00:00 Greenwich Standard Time GMT GST IS Reykjavik
------- Fernando De Noronha Std -----------------------------------------------
-02:00 Mid-Atlantic Standard Time FST FDT BR Noronha
-02:00 UTC-02 FST FDT BR Noronha
------- Brazil Standard Time --------------------------------------------------
-03:00 Bahia Standard Time BST BDT BR Bahia
-03:00 SA Eastern Standard Time BST BDT BR Fortaleza
-03:00 Tocantins Standard Time BST BDT BR Palmas
------- Eastern Standard (Brazil) ---------------------------------------------
-03:00 E. South America Standard Time EST EDT BR Sao Paulo
------- Greenland Standard Time -----------------------------------------------
-03:00 Greenland Standard Time GST GDT GL Godthab
------- Newfoundland Standard Time --------------------------------------------
-03:30 Newfoundland Standard Time NST NDT CA St.Johns
------- Atlantic Standard Time ------------------------------------------------
-04:00 Atlantic Standard Time AST ADT CA Halifax
------- Western Standard (Brazil) ---------------------------------------------
-04:00 Central Brazilian Standard Time WST WDT BR Cuiaba
-04:00 SA Western Standard Time WST WDT BR Manaus
------- Chile Standard Time ---------------------------------------------------
-04:00 Pacific SA Standard Time CST CDT CL Santiago
------- Eastern Standard Time -------------------------------------------------
-05:00 Eastern Standard Time EST EDT US New York
-05:00 Eastern Standard Time (Mexico) EST EDT MX Cancun
-05:00 US Eastern Standard Time EST EDT US Indianapolis
------- Acre Standard Time ----------------------------------------------------
-05:00 SA Pacific Standard Time AST ADT BR Rio Branco
------- Cuba Standard Time ----------------------------------------------------
-05:00 Cuba Standard Time CST CDT CU Havana
------- Central Standard Time -------------------------------------------------
-06:00 Canada Central Standard Time CST CDT CA Regina
-06:00 Central Standard Time CST CDT US Chicago
-06:00 Central Standard Time (Mexico) CST CDT MX Mexico City
------- Easter Island Standard ------------------------------------------------
-06:00 Easter Island Standard Time EST EDT CL Easter
------- Mountain Standard Time ------------------------------------------------
-07:00 Mountain Standard Time MST MDT US Denver
-07:00 Mountain Standard Time (Mexico) MST MDT MX Chihuahua
-07:00 US Mountain Standard Time MST MDT US Phoenix
------- Pacific Standard Time -------------------------------------------------
-08:00 Pacific Standard Time PST PDT US Los Angeles
-08:00 Pacific Standard Time (Mexico) PST PDT MX Tijuana
------- Alaska Standard Time --------------------------------------------------
-09:00 Alaskan Standard Time AKS AKD US Anchorage
------- Hawaii Standard Time --------------------------------------------------
-10:00 Aleutian Standard Time HST HDT US Aleutian
-10:00 Hawaiian Standard Time HST HDT US Honolulu
------- Samoa Standard Time ---------------------------------------------------
+13:00 Samoa Standard Time SST SDT US Samoa
------- New Zealand Standard Time ---------------------------------------------
+12:00 New Zealand Standard Time NZS NZD NZ Auckland
------- Guam Standard Time ----------------------------------------------------
+10:00 West Pacific Standard Time GST GDT GU Guam
------- Eastern Australian Standard -------------------------------------------
+10:00 AUS Eastern Standard Time EAS EAD AU Sydney
+10:00 E. Australia Standard Time EAS EAD AU Brisbane
+10:00 Tasmania Standard Time EAS EAD AU Hobart
------- Central Australian Standard -------------------------------------------
+09:30 AUS Central Standard Time CAS CAD AU Darwin
+09:30 Cen. Australia Standard Time CAS CAD AU Adelaide
------- Japan Standard Time ---------------------------------------------------
+09:00 Tokyo Standard Time JST JDT JP Tokyo
------- Korean Standard Time --------------------------------------------------
+09:00 Korea Standard Time KST KDT KR Seoul
+09:00 North Korea Standard Time KST KDT KP Pyongyang
------- China Coast Time ------------------------------------------------------
+08:00 China Standard Time CCT CDT CN Shanghai
+08:00 Taipei Standard Time CCT CDT TW Taipei
------- Hong Kong Time --------------------------------------------------------
+08:00 China Standard Time HKT HKS HK Hong Kong
------- Singapore Standard Time -----------------------------------------------
+08:00 Singapore Standard Time SST SDT SG Singapore
------- Western Australian Standard -------------------------------------------
+08:45 Aus Central W. Standard Time WAS WAD AU Eucla
+08:00 W. Australia Standard Time WAS WAD AU Perth
------- North Sumatra Time ----------------------------------------------------
+07:00 SE Asia Standard Time NST NDT ID Jakarta
------- Indian Standard Time --------------------------------------------------
+05:30 India Standard Time IST IDT IN Calcutta
------- Iran Standard Time ----------------------------------------------------
+03:30 Iran Standard Time IST IDT IR Tehran
------- Moscow Winter Time ----------------------------------------------------
+03:00 Belarus Standard Time MSK MSD BY Minsk
+03:00 Russian Standard Time MSK MSD RU Moscow
------- Eastern Europe Time ---------------------------------------------------
+02:00 E. Europe Standard Time EET EES MD Chisinau
+02:00 FLE Standard Time EET EES UA Kiev
+02:00 GTB Standard Time EET EES RO Bucharest
+02:00 Kaliningrad Standard Time EET EES RU Kaliningrad
------- Israel Standard Time --------------------------------------------------
+02:00 Israel Standard Time IST IDT IL Jerusalem
------- Central European Time -------------------------------------------------
+01:00 Central Europe Standard Time CET CES HU Budapest
+01:00 Central European Standard Time CET CES PL Warsaw
+01:00 Romance Standard Time CET CES FR Paris
+01:00 W. Europe Standard Time CET CES DE Berlin
------- West African Time -----------------------------------------------------
+01:00 Namibia Standard Time WAT WAS NA Windhoek
+01:00 W. Central Africa Standard Time WAT WAS NG Lagos

NOTE: MSDOS_(APPEND/COMSPEC/LASTDRIVE/TEMP/TZ) are not copied to the virtual
table, but MSDOS_PATH is copied to, because some softwares may refer it.


----- Recommended Configurations

Create C:\DOS and C:\TEMP folders.
Copy COMMAND.COM (I recommend the Windows 98's COMMAND.COM Version 7.10) and
other DOS command files (ex. MORE.COM) into C:\DOS folder.

Set the environment variables listed below on the host Windows:

MSDOS_COMSPEC = C:\DOS\COMMAND.COM
MSDOS_PATH = C:\DOS
MSDOS_TEMP = C:\TEMP


----- Convert Command File To 32bit Or 64bit Execution File

You can convert a 16bit command file to a single 32bit or 64bit execution file
by embeding a command file to the msdos.exe.

For exmaple, you can convert LIST.COM by this command:

> msdos -cLIST32.EXE LIST.COM

and you can simply run LIST32.EXE without msdos.exe.

NOTE: Please specify a target command file with its extension, and specify
a new execution file name other than "msdos.exe". If a new execution file name
is not specified (only "-c" is specified), it is "new_exec_file.exe".

Other options' value are also stored to a new execution file, for example:

> msdos -cCOMMAND32.EXE -v6.22 -x COMMAND.COM

When you run COMMAND32.EXE, it starts COMMAND.COM with the version 6.22 and
XMS/EMS option enabled.

The active code page can be also stored with '-p' option, for example:

> msdos -cSW1US32.EXE -p437 -s SW1US.EXE

> chcp 437
> msdos -cSW1US32.EXE -p -s SW1US.EXE

When you run SW1US32.EXE, it starts SW1US.EXE with the code page 437 and
serial I/O option enabled.

At the execution time, an embedded command file will be extracted with
the original command file name in the current directory.
But if the original command file exists, it will be extracted with
the temporary command file name not to overwrite the original command file.
The extracted command file will be removed when the execution is finished.


----- Binaries

This archive contains 12 executable binaries:

i86_x86 Emulates 8086 and supports both 32bit/64bit Windows
i86_x64 Emulates 8086 and supports only 64bit Windows
i286_x86 Emulates 80286 and supports both 32bit/64bit Windows
i286_x64 Emulates 80286 and supports only 64bit Windows
i386_x86 Emulates 80386 and supports both 32bit/64bit Windows
i386_x64 Emulates 80386 and supports only 64bit Windows
i486_x86 Emulates 80486 and supports both 32bit/64bit Windows
i486_x64 Emulates 80486 and supports only 64bit Window
pentium4_x86 Emulates Pentium4 and supports both 32bit/64bit Windows
pentium4_x64 Emulates Pentium4 and supports only 64bit Window
v30_x86 Emulates NEC V30 and supports both 32bit/64bit Windows
v30_x64 Emulates NEC V30 and supports only 64bit Windows
ia32_x86 Emulates IA32 and supports both 32bit/64bit Windows
ia32_x64 Emulates IA32 and supports only 64bit Windows

8086 binaries are much faster than 80286/80386/80486/Pentium4/IA32 binaries.
If you don't need the protected mode or new mnemonics added after 80286,
I recommend i86_x86 or i86_x64 binary.

NEC V30 binaries support 8080 emulation mode.
If you try CP/M-80 emulator using 8080 emulation mode, use these binaries.

IA32 binaries include Neko Project 21/W i386c core and support FPU/MMX/SSE/2/3.
These binaries will emulate the protected mode more correctly.

The VC++ project file "msdos.vcproj/vcxproj" also contains the configurations
for 80186, Pentium/PRO/MMX/2/3, and Cyrix MediaGX.
You can build all binaries for several cpu models by running build9_all.bat
or build15_all.bat.
(You need VC++ 2008 with Service Pack 1 or VC++ 2017)


----- Internal Debugger

MS-DOS Player contains the internal debugger for developers, but it is
disabled on the binaries in the archive.
To enable the internal debugger, please remove the comment out of definition
"//#define USE_DEBUGGER" in common.h and build the binary.

MS-DOS Player opens the telnet port.
The port number is 23 in default, but if it is already used, 9000 or later.
When you start your telnet client and connect to MS-DOS Player,
the virtual cpu is suspended and you can start the debugger.

If you see the messsage "waiting until cpu is suspended...",
the internal DOS service is running, for example waiting your key inputs.
The virtual cpu will be suspended when exit the internal DOS service,
and you can start the debugger.

If Tera Term PRO, PuTTY, or Windows telnet client (telnet.exe) is installed,
it is automatically started and connected to MS-DOS Player.
When you use Tera Term PRO or PuTTY, I recommend to disable "Line at Time"
and enable "Character at Time".

NOTE: When you run 32bit version of MS-DOS Player on Windows x64,
MS-DOS Player will try to start 32bit version of telnet.exe in SysWOW64,
but it is not usually installed.

Please enter ? command to show the debugger commands.
They are very similar to DEBUG command, and some break point functions
(break at memory access (*), I/O port access, and interrupt) are added.

(*) break does not occur when DOS service/BIOS emulation codes access.


----- Supported Hardwares

This emulator provides a very simple IBM PC-like hardware emulation:

CPU 8086/286/386/486/Pentium4, RAM 1MB/16MB/32MB, LIM EMS 32MB (Hardware EMS),
PC BIOS, DMA Controller (dummy), Interrupt Controller, System Timer,
Parallel I/O (LPT1-3), Serial I/O (COM1-4), Real Time Clock + CMOS Memory,
MDA/CGA CRTC + Status Register, Keyboard Controller (A20 Line Mask, CPU Reset),
and 2-Button Mouse

NOTE:
- Graphic/Sound hardwares are NOT implemented.
- DMA Controller is implemented, but FDC and HDC are not connected.
- Parallel I/O is implemented and the output data is written to the file
"Year-Month-Day_Hour-Minute-Second.PRN" created in the TEMP directory.
- Serial I/O is implemented and can be connected to the host's COM ports.


----- Memory Map

000000H - Conventional Memory (704KB)
0B0000H - MDA Text Video RAM (32KB)
0B8000H - CGA Text Video RAM (32KB)
----------
0C0000H - Upper Memory Block (224KB)
--- Or ---
0C0000H - EMS Page Frame (64K)
0D0000H - Upper Memory Block (160KB)
----------
0F8000H - V-TEXT Shadow Buffer (32KB-64B)
0FFFC0H - Dummy BIOS/DOS/Driver Service Routines
0FFFF0H - CPU Boot Address
100000H - Upper Memory (15MB/31MB)


----- Supported System Calls

INT 08H PC BIOS - System Timer

INT 10H PC BIOS - Video

00H Set Video Mode
01H Set Text-Mode Cursor Shape
02H Set Cursor Position
03H Get Cursor Position And Size
05H Select Active Display Page
06H Scroll Up Window
07H Scroll Down Window
08H Read Character And Attribute At Cursor Position
09H Write Character And Attribute At Cursor Position
0AH Write Character Only At Cursor Position
0CH Write Graphics Pixel
0DH Read Graphics Pixel
0EH Teletype Output
0FH Get Current Video Mode
1100H Load User-Specified Patterns
1101H Load ROM 8x14 Monochrome Patterns
1102H Load ROM 8x8 Dbl-Dot Patterns
1104H Load ROM 8x16 Character Set
1110H Load User-Specified Patterns
1111H Load ROM 8x14 Monochrome Patterns
1112H Load ROM 8x8 Dbl-Dot Patterns
1114H Load ROM 8x16 Character Set
1118H Set V-TEXT Vertically Long Mode
1130H Get Font Information
12H Alternate Function Select (BL=10H)
130*H Write String
1310H Read Characters And Standard Attributes
1311H Read Characters And Extended Attributes
1312H Write Characters And Standard Attributes (???)
1313H Write Characters And Extended Attributes (???)
1320H Write Characters And Standard Attributes
1321H Write Characters And Extended Attributes
1A00H Get Display Combination Code
1BH Perform Gray-Scale Summing
8200H Get/Set Scroll Mode
8300H Get Video RAM Address
90H Get Physical Workstation Display Mode
91H Get Physical Workstation Adapter Type
EFH Get Video Adapter Type And Mode (*1)
FEH Get Shadow Buffer
FFH Update Screen From Shadow Buffer

INT 11H PC BIOS - Get Equipment List

INT 12H PC BIOS - Get Memory Size

INT 13H PC BIOS - Disk I/O

00H Reset Disk System
01H Get Status Of Last Operation
02H Read Sectors Into Memory
03H Write Disk Sectors (*2)
04H Verify Disk Sectors
08H Get Drive Parameters
0AH Read Long Sectors
0BH Write Long Sectors
0DH Reset Hard Disks
10H Check If Drive Ready
15H Get Disk Type

INT 14H PC BIOS - Serial I/O

00H Initialize Port
01H Write Character To Port
02H Read Character From Port
03H Get Port Status
04H Extended Initialize
0500H Read Modem Control Register
0501H Write Modem Control Register

INT 15H PC BIOS

2300H Get CMOS Data
2301H Set CMOS Data
2400H Disable A20 Gate
2401H Enable A20 Gate
2402H Get A20 Gate Status
2403H A20 Support
49H Get BIOS Type
5000H Get Address Of "Read Font" Function
5001H Get Address Of "Write Font" Function
84H Joystick Support (*3)
86H Wait
87H Copy Extended Memory
88H Get Extended Memory Size
89H Switch To Protected Mode
8AH Get Big Memory Size
C0H Get Configuration
C200H Pointing Device BIOS Interface (PS) - Enable/Disable
C201H Pointing Device BIOS Interface (PS) - Reset
C202H Pointing Device BIOS Interface (PS) - Set Sampling Rate
C203H Pointing Device BIOS Interface (PS) - Set Resolution
C204H Pointing Device BIOS Interface (PS) - Get Type
C205H Pointing Device BIOS Interface (PS) - Initialize
C206H Pointing Device BIOS Interface (PS) - Extended Commands
C207H Pointing Device BIOS Interface (PS) - Set Device Handler Addr
C208H Pointing Device BIOS Interface (PS) - Write To Pointer Port
C209H Pointing Device BIOS Interface (PS) - Read From Pointer Port
C9H Get CPU Type And Mask Revision
CA00H Read CMOS Memory
CA01H Write CMOS Memory
E801H Get Memory Size For >64M Configurations
E820H Get System Memory MAP
E881H Get Memory Size For >64M Configurations

INT 16H PC BIOS - Keyboard

00H Get Keystroke
01H Check For Keystroke
02H Get Shift Flags
05H Store Keystroke In Keyboard Buffer
09H Get Keyboard Functionality
0AH Get Keyboard ID
10H Get Enhanced Keystroke
11H Check For Enhanced Keystroke
12H Get Extended Shift States
51H AX (Japanese AT) Keyboard - Read Shift Key Status

INT 17H PC BIOS - Printer

00H Write Character
01H Initialize Port
02H Get Status
03H AX (Japanese AT) Printer - Output String Without Conversion
5000H AX (Japanese AT) Printer - Set Printer Country Code
5001H AX (Japanese AT) Printer - Get Printer Country Code
51H AX (Japanese AT) Printer - JIS To Shift-JIS Conversion
52H AX (Japanese AT) Printer - Shift-JIS To JIS Conversion
84H AX (Japanese AT) Printer - Output Character Without Conversion
85H AX (Japanese AT) Printer - Enable/Disable Character Conversion

INT 1AH PC BIOS - Timer

1A00H Get System Timer
1A02H Get Real Time Clock Time
1A04H Get Real Time Clock Date
1A0AH Read System-Timer Day Counter

INT 20H Program Terminate

INT 21H MS-DOS System Call

00H Program Terminate
01H Keyboard Input
02H Console Output
03H (Auxiliary Input)
04H (Auxiliary Output)
05H (Printer Output)
06H Direct Console I/O
07H Direct Console Input
08H Console Input Without Echo
09H Print String
0AH Buffered Keyboard Input
0BH Check Console Status
0CH Character Input With Buffer Flush
0DH Disk Reset
0EH Select Disk
0FH Open File With FCB
10H Close File With FCB
11H Search First Entry With FCB
12H Search Next Entry With FCB
13H Delete File With FCB
14H Sequential Read With FCB
15H Sequential Write With FCB
16H Create New File With FCB
17H Rename File With FCB
18H Null Function For CP/M Compatibility
19H Current Disk
1AH Set Disk Transfer Address
1BH Get Allocation Information For Default Drive
1CH Get Allocation Information For Specified Drive
1DH Null Function For CP/M Compatibility
1EH Null Function For CP/M Compatibility
1FH Get Drive Parameter Block For Default Drive
20H Null Function For CP/M Compatibility
21H Random Read With FCB
22H Randome Write With FCB
23H Get File Size With FCB
24H Set Relative Record Field With FCB
25H Set Vector
26H Create New Program Segment Prefix
27H Random Block Read With FCB
28H Random Block Write With FCB
29H Parse File Name
2AH Get Date
2BH Set Date
2CH Get Time
2DH Set Time
2EH Set/Reset Verify Switch
2FH Get Disk Transfer Address
30H Get Version Number (*4)
31H Keep Process
32H Get DOS Drive Parameter Block
3300H Get Ctrl-Break Checking State
3301H Set Ctrl-Break Checking State
3302H Get/Set Ctrl-Break Checking State
3305H Get Boot Drive
3306H Get True Version Number (*5)
3307H Windows95 - Set/Clear DOS_FLAG
34H Get Address Of InDOS Flag
35H Get Vector
36H Get Disk Free Space
3700H Get Switch Character
3701H Set Switch Character
3702H Get AvailDev Flag
3703H Set AvailDev Flag
38H Get Country Specific Information
39H Create Subdirectory
3AH Remove Subdirectory
3BH Change Current Directory
3CH Create File
3DH Open File Handle
3EH Close File Handle
3FH Read From File Or Device
40H Write To File Or Device
41H Erase File From Directory
42H Move File Read/Write Pointer
4300H Get File Attribute
4301H Set File Attribute
4302H MS-DOS 7 - Get Compressed File Size
43FFH Windows98 - Extended-Length File Name Operations
4400H Get Device Information
4401H Set Device Information
4402H Read From Character Device Control Channel
4406H Get Input Status
4407H Get Output Status
4408H Device Removable Query
4409H Device Local Or Remote Query
440AH Handle Local Or Remote Query
440CH Generic Character Device Request
440DH Generic Block Device Request
4410H Query Generic IOCTRL Capability (Handle)
4411H Query Generic IOCTRL Capability (Drive)
45H Duplicate File Handle
46H Force Duplicate Of Handle
47H Get Current Directory
48H Allocate Memory
49H Free Allocated Memory
4AH Modify Allocated Memory Blocks
4B00H Load And Execute Program
4B01H Load Program
4B03H Load Overlay
4CH Terminate Process
4DH Get Subprocess Return Code
4EH Find First Matching File
4FH Find Next Matching File
50H Set Program Segment Prefix Address
51H Get Program Segment Prefix Address
52H Get DOS Info Table
53H Translate BIOS Parameter Block To Drive Param Bock
54H Get Verify State
55H Create Child Program Segment Prefix
56H Rename File
5700H Get Last Written Date And Time
5701H Set Last Written Date And Time
5704H Windows95 - Get Last Access Date And Time
5705H Windows95 - Set Last Access Date And Time
5706H Windows95 - Get Creation Date And Time
5707H Windows95 - Set Creation Date And Time
5800H Get Memory Allocation Strategy
5801H Set Memory Allocation Strategy
5802H Get UMB Link State
5803H Set UMB Link State
59H Get Extended Error Information
5AH Create Unique File
5BH Create New File
5CH Lock/Unlock File Access
5D00H Server Function Call
5D06H Get Address Of DOS Swappable Data Area
5D0AH Set Extended Error Information
5E00H Get Machine Name
5F02H Get Redirection List Entry
5F05H Get Extended Redirection List Entry
5F07H Enable Drive
5F08H Disable Drive
60H Canonicalize Filename Or Path
61H Reserved Fnction
62H Get Program Segment Prefix Address
6300H Get DBCS Vector
6500H Windows95 OSR2 - Set General Internationalization Info
6501H Get General Internationalization Info
6502H Get Upper Case Table
6503H Get Lower Case Table
6504H Get File Name Upper Case Table
6505H Get File Name Lower Case Table
6506H Get Collating Sequence Table
6507H Get DBCS Vector
6520H Character Capitalization
6521H String Capitalization
6522H ASCIIZ Capitalization
6523H Determine If Character Represents Yes/No Response
65A0H Character Capitalization
65A1H String Capitalization
65A2H ASCIIZ Capitalization
6601H Get Global Code Page Table
6602H Set Global Code Page Table
67H Set Handle Count
68H Commit File
6900H Get Disk Serial Number
6AH Commit File
6BH Null Function
6CH Extended Open/Create
7002H Windows95 - Set General Internationalization Info
710DH Windows95 - Reset Drive
7139H Windows95 - LFN - Create Subdirectory
713AH Windows95 - LFN - Remove Subdirectory
713BH Windows95 - LFN - Change Current Directory
7141H Windows95 - LFN - Erase File From Directory
7143H Windows95 - LFN - Get/Set File Attribute
7147H Windows95 - LFN - Get Current Directory
714EH Windows95 - LFN - Find First Matching File
714FH Windows95 - LFN - Find Next Matching File
7156H Windows95 - LFN - Rename File
7160H Windows95 - LFN - Canonicalize Filename Or Path
716CH Windows95 - LFN - Extended Open/Create
71A0H Windows95 - LFN - Get Volume Information
71A1H Windows95 - LFN - Terminate Directory Search
71A6H Windows95 - LFN - Get File Information By Handle
71A7H Windows95 - LFN - Convert File Time/DOS Time
71A8H Windows95 - LFN - Generate Short File Name
71A9H Windows95 - LFN - Extended Server Open/Create
71AAH Windows95 - LFN - Create/Terminate/Query SUBST
7300H Windows95 - FAT32 - Get Drive Locking
7302H Windows95 - FAT32 - Get Extended DPB
7303H Windows95 - FAT32 - Get Extended Free Space On Drive
DBH Novell NetWare - Workstation - Get Number Of Local Drives
DCH Novell NetWare - Connection Services - Get Connection Number

INT 23H Ctrl-Break Address

INT 24H Critical Error Handler

INT 25H Absolute Disk Read

INT 26H Absolute Disk Write (*2)

INT 27H Terminate And Stay Resident

INT 28H DOS Idle

INT 29H DOS Fast Character I/O

INT 2EH Pass Command To Command Interpreter For Execution

INT 2FH Multiplex Interrupt

0500H DOS 3.0+ Critical Error Handler - Installation Check
0502H DOS 3.0+ Critical Error Handler - Expand Error Into String
1200H DOS 3.0+ internal - Installation Check
1202H DOS 3.0+ internal - Get Interrupt Address
1203H DOS 3.0+ Internal - Get DOS Data Segment
1204H DOS 3.0+ internal - Normalize Path Separator
1205H DOS 3.0+ internal - Output Character To Standard Output
120DH DOS 3.0+ internal - Get Date And Time
1211H DOS 3.0+ internal - Normalize ASCIZ Filename
1212H DOS 3.0+ internal - Get Length Of ASCIZ String
1213H DOS 3.0+ internal - Uppercase Character
1214H DOS 3.0+ internal - Compare Far Pointers
1216H DOS 3.0+ internal - Get System File Table Entry
1217H DOS 3.0+ internal - Get Current Directory Structure For Drive
121AH DOS 3.0+ internal - Get File's Drive
121BH DOS 3.0+ internal - Set Year/Length Of February
121EH DOS 3.0+ internal - Compare Filenames
121FH DOS 3.0+ internal - Build Current Directory Structure
1220H DOS 3.0+ internal - Get Job File Table Entry
1221H DOS 3.0+ internal - Canonicalize File Name
1222H DOS 3.0+ internal - Set Extended Error Info
1225H DOS 3.0+ internal - Get Length Of ASCIZ String
1226H DOS 3.3+ internal - Open File
1227H DOS 3.3+ internal - Close File
1228H DOS 3.3+ internal - Move File Pointer
1229H DOS 3.3+ internal - Read From File
122BH DOS 3.3+ internal - IOCTL
122CH DOS 3.3+ internal - Get Device Chain
122DH DOS 3.3+ internal - Get Extended Error Code
122EH DOS 4.0+ internal - Get Error Table Addresses
122FH DOS 4.0+ internal - Set DOS Version Number To Return
1400H NLSFUNC.COM - Installation Check
1401H NLSFUNC.COM - Change Code Page
1402H NLSFUNC.COM - Get Extended Country Info
1403H NLSFUNC.COM - Set Code Page
1404H NLSFUNC.COM - Get Country Info
150BH CD-ROM v2.00+ - Drive Check
150DH CD-ROM v2.00+ - Get CD-ROM Drive Letters
1600H Windows - Windows Enhanced Mode Installation Check (*6)
1605H Windows - Windows Enhanced Mode & 286 DOSX Init Broadcast
160AH Windows - Identify Windows Version And Type (*6)
1680H Windows, DPMI - Release Current Virtual Machine Time-Slice
1683H Windows 3+ - Get Current Virtual Machine ID
1A00H ANSI.SYS - Installation Check
1A01H ANSI.SYS - Set/Get Display Information
4000H Windows 3+ - Get Virtual Device Driver (VDD) Capabilities
4300H XMS - Installation Check
4308H HIMEM.SYS - Get A20 Handler Number
4310H XMS - Get Driver Address
4810H Read Input Line From Console
4A01H DOS 5.0+ - Query Free HMA Space
4A02H DOS 5.0+ - Allocate HMA Space
4A03H Windows95 - (De)Allocate HMA Memory Block
4A04H Windows95 - Get Start Of HMA Memory Chain
AD00H DISPLAY.SYS - Installation Check
AD01H DISPLAY.SYS - Set Active Code Page
AD02H DISPLAY.SYS - Get Active Code Page
AD03H DISPLAY.SYS - Get Code Page Information
4F00H BILING - Get Version
4F01H BILING - Get Code Page
AE00H Installable Command - Installation Check
AE01H Installable Command - Execute

INT 33H Mouse

0000H Reset Driver And Rest Status
0001H Show Mouse Cursor
0002H Hide Mouse Cursor
0003H Return Position And Button Status
0004H Position Mouse Cursor
0005H Return Button Press Data
0006H Return Button Release Data
0007H Define Horizontal Cursor Range
0008H Define Vertical Cursor Range
0009H Define Graphics Cursor
000AH Define Text Cursor
000BH Read Motion Counters
000CH Define Interrupt Sub Routine Parameters
000FH Define Mickey/Pixel Ratio
0011H Get Number Of Buttons
0014H Exchange Interrupt Sub Routines
0015H Return Driver Storage Requirements
0016H Save Driver State
0017H Restore Driver State
0018H Set Alternate Mouse User Handler
0019H Return User Alternate Interrupt Vector
001AH Set Mouse Sensitivity
001BH Return Mouse Sensitivity
001DH Define Display Page Number
001EH Return Display Page Number
001FH Disable Mouse Driver
0020H Enable Mouse Driver
0021H Software Reset
0022H Set Language For Messages
0023H Get Language For Messages
0024H Get Software Version, Moouse Type, And IRQ Number (*7)
0025H Get General Driver Information
0026H Get Maximum Virtual Coordinates
0027H Get Screen/Cursor Masks And Mickey Counts
0028H Set Video Mode
0029H Enumerate Video Modes
002AH Get Cursor Host Spot
0031H Get Current Minimum/Maximum Virtual Coordinates
0032H Get Active Advanced Functions
004DH Return Pointer To Copyright String
006DH Get Version String

INT 65H-66H (Used For Dummy LIM EMS/XMS Service Routines)

INT 67H LIM EMS

40H LIM EMS - Get Manager Status
41H LIM EMS - Get Page Frame Segment
42H LIM EMS - Get Number Of Pages
43H LIM EMS - Get Handle And Allocate Memory
44H LIM EMS - Map/Unmap Memory
45H LIM EMS - Release Handle And Memory
46H LIM EMS - Get EMM Version (*8)
47H LIM EMS - Save Mapping Context
48H LIM EMS - Restore Mapping Context
4BH LIM EMS - Get Number Of EMM Handles
4CH LIM EMS - Get Pages Owned By Handle
4DH LIM EMS - Get Pages For All Handles
4E00H LIM EMS - Get Page Map
4E01H LIM EMS - Set Page Map
4E02H LIM EMS - Get And Set Page Map
4E03H LIM EMS - Get Page Map Array Size
4F00H LIM EMS 4.0 - Get Partial Page Map
4F01H LIM EMS 4.0 - Set Partial Page Map
4F02H LIM EMS 4.0 - Get Partial Page Map Array Size
50H LIM EMS 4.0 - Map/Unmap Multiple Handle Pages
51H LIM EMS 4.0 - Reallocate Pages
52H LIM EMS 4.0 - Get/Set Handle Attributes
5300H LIM EMS 4.0 - Get Handle Name
5301H LIM EMS 4.0 - Set Handle Name
5400H LIM EMS 4.0 - Get Handle Directory
5401H LIM EMS 4.0 - Search For Named Handle
5402H LIM EMS 4.0 - Get Total Handles
55H LIM EMS 4.0 - Alter Page Map And Jump
56H LIM EMS 4.0 - Alter Page Map And Call
5602H LIM EMS 4.0 - Get Page Map Stack Space Required
5700H LIM EMS 4.0 - Move Memory Region
5701H LIM EMS 4.0 - Exchange Memory Region
5800H LIM EMS 4.0 - Get Mappable Physical Address Array
5801H LIM EMS 4.0 - Get Mappable Physical Address Array Entries
5900H LIM EMS 4.0 - Get Hardware Configuration Array
5901H LIM EMS 4.0 - Get Unallocated Raw Page Count
5A00H LIM EMS 4.0 - Allocate Standard Pages
5A01H LIM EMS 4.0 - Allocate Raw Pages
5B00H LIM EMS 4.0 - Get Alternate Map Register Set
5B01H LIM EMS 4.0 - Set Alternate Map Register Set
5B02H LIM EMS 4.0 - Get Alternate Map Save Array Size
7000H EMS - Get Page Frame Status (NEC PC-9801 Only ???)
7001H EMS - Enable/Disable Page Frame (NEC PC-9801 Only ???)
DE00H VCPI - Installation Check
DE01H VCPI - Get Protected Mode Interface
DE02H VCPI - Get Max Physical Memory Address
DE03H VCPI - Get Number Of Free 4KB Pages
DE04H VCPI - Allocate 4KB Page
DE05H VCPI - Free 4KB Page
DE06H VCPI - Get Physical Address Of Page In First MB
DE07H VCPI - Read CR0
DE08H VCPI - Read Debug Registers
DE09H VCPI - Write Debug Registers
DE0AH VCPI - Get 8259 Interrupt Vector Mapping
DE0BH VCPI - Set 8259 Interrupt Vector Mapping
DE0CH VCPI - Switch To Protected Mode


INT 68H-6FH (Used For Dummy BIOS/DOS/Driver Service Routines)

CALL FAR XMS

00H XMS - Get XMS Version Number (*9)
01H XMS - Request High Memory Area
02H XMS - Release High Memory Area
03H XMS - Global Enable A20
04H XMS - Global Disable A20
05H XMS - Local Enable A20
06H XMS - Local Disable A20
07H XMS - Query A20 State
08H XMS - Query Free Extended Memory
09H XMS - Allocate Extended Memory Block
0AH XMS - Free Extended Memory Block
0BH XMS - Move Extended Memory Block
0CH XMS - Lock Extended Memory Block
0DH XMS - Unlock Extended Memory Block
0EH XMS - Get Handle Information
0FH XMS - Reallocate Extended Memory Block
10H XMS - Request Upper Memory Block
11H XMS - Release Upper Memory Block
12H XMS 3.0 - Reallocate Upper Memory Block
88H XMS 3.0 - Query Free Extended Memory
89H XMS 3.0 - Allocate Any Extended Memory
8EH XMS 3.0 - Get Extended EMB Handle Information
8FH XMS 3.0 - Reallocate Any Extended Memory Block

(*1) Not a Hercules-compatible video adapter
(*2) Support only floppy disk drive
(*3) Joysticks are not connected
(*4) MS-DOS Version: 7.10 (default) or specified version with -v option
(*5) MS-DOS Version: 7.10, -v option is not affected
(*6) Windows Version: 4.10 (default) or specified version with -w option
(*7) Mouse Version: 8.05
(*8) EMS Version: 4.0
(*9) XMS Version: 3.95


----- INT 29H Limitations

When INT 21H/2FH service outputs a character to console, INT 29H service
(DOS Fast Character I/O) is called.

If INT 21H/2FH service that outputs a character to console is called again
in INT 29H handler, INT 29H is not called again to prevent an infinite loop.

In usual, the virtual CPU is running while waiting inputs from console in
INT 21H, AH=01H/0AH/3FH service and a timer interrupt can be raised.
If INT 29H handler is hooked by your software, the virtual CPU is suspended
while waiting inputs from console, and a timer interrupt never be raised.


----- Win32/64 Child Process

When we run a Win32/64 program on usual MS-DOS environment, we will see
an error message "This program cannot be run in DOS mode."

When a Win32/64 program file is called by INT 21H, AX=4B00H, INT 2EH, or
INT 2FH, AX=AE01H services, for example the case we run it on COMMAND.COM,
it is executed as a Win32/64 child process by Win32 system() API and
waits until the child process is terminated.
In this time, any characters output to the console by this Win32/64 child
process is not hooked by INT 29H service.

When you run a Win32/64 program with pipe, it may not work as you expect.
For example, you may run Win32/64 version of more.com with pipe as follows:

> msdos command.com
> type foo.txt | more (more.com is Win32/64 program in C:\Windows\System32)

MS-DOS Player starts more.com as a Win32/64 child process and will wait until
the child process is terminated.
While waiting until the child process is terminated, the virtual CPU is
suspended and outputs of "type foo.txt" never be sent to the child process.


--- License

The copyright belongs to the author, but you can use the source codes under
the GNU GENERAL PUBLIC LICENSE Version 2.

See also COPYING.txt for more details about the license.


----- Thanks

8086/80286 code is based on MAME 0.149 and applied fixes in MAME 0.150-0.185.
NEC V30 instructions code is based on MAME 0.128.
8038/80486 code is based on MAME 0.152 and applied fixes in MAME 0.154-0.185.
IA32 code is based on Neko Project 21/W.

INT 15H AH=84H (Joystick Support),
INT 15H AH=87H (Copy Extended Memory),
INT 15H AH=89H (Switch To Protected Mode),
INT 15H AX=C209H (Read From Pointer Port)
INT 21H AX=4402H (Read From Character Device Control Channel),
INT 33H AX=001FH (Disable Mouse Driver),
INT 33H AX=0020H (Enable Mouse Driver),
INT 67H AX=DE01H (Get Protected Mode Interface),
INT 67H AX=DE0CH (Switch To Protected Mode),
and some DOS info block improvements are based on DOSBox.

Imported many fixes from Mr.cracyc's fork hosted at:
https://github.com/cracyc/msdos-player

Patched by Mr.Sagawa, Mr.sava (lukewarm), Mr.Kimura (emk), Mr.Jason Hood,
Mr.N2583ZYOB6, Mr.Fujita, Mr.Mark Ogden, Mr.cacyc, and Mr.roytam

----------------------------------------
TAKEDA, toshiya
t-takeda@m1.interq.or.jp
http://takeda-toshiya.my.coocan.jp/

DOWNLOAD:

FilenameSize
MSDOS.ZIP11.305 KB

https://thedubber.altervista.org/support/

https://thedubber.altervista.org/

 

Privacy Policy - Personalizza tracciamento pubblicitario