Files
oldlinux-files/docs/interrupts/int-html/rb-2894.htm
2024-02-19 00:23:35 -05:00

323 lines
19 KiB
HTML

<HTML>
<HEAD>
<TITLE>Int 21/AX=440Ch
</TITLE>
<META NAME="Description" CONTENT="
Int 21/AX=440Ch - DOS 3.2+ - IOCTL - GENERIC CHARACTER DEVICE REQUEST -
AX = 440Ch
BX = device handle
CH = category code (see #01545)
CL = function number (see #01546)
DS:DX - parameter block (see #01547,#01548,#01549,#01550,#01551,#01552)
SI = parameter to pass to driver (European MS-DOS 4.0, OS/2 comp box)
DI = parameter to pass to driver (European MS-DOS 4.0, OS/2 comp box)
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
">
<META NAME="robots" CONTENT="none">
</HEAD>
<BODY BGCOLOR="#FFD0A0">
<center>
<h2>Int 21/AX=440Ch
</h2>
</center><p>
<table border=1 cellpadding=3 cellspacing=1>
<td>
<a href="rb-2893.htm" tppabs="http://www.ctyme.com/intr/rb-2893.htm">
<img src="lup.gif" tppabs="http://graphics.ctyme.com/gif/lup.gif" border=0 alt=Prev></a>
<a href="rb-2895.htm" tppabs="http://www.ctyme.com/intr/rb-2895.htm">
<img src="ldown.gif" tppabs="http://graphics.ctyme.com/gif/ldown.gif" border=0 alt=Next></a>
<a href="javascript:if(confirm('http://www.ctyme.com/rbrown.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/rbrown.htm'" tppabs="http://www.ctyme.com/rbrown.htm">
<img src="lhome.gif" tppabs="http://graphics.ctyme.com/gif/lhome.gif" border=0 alt=Ralf Brown Page></a>
<td><a href="int.htm" tppabs="http://www.ctyme.com/intr/int.htm">Interrups</a></td>
<td><a href="cat.htm" tppabs="http://www.ctyme.com/intr/cat.htm">Categories</a></td>
<td><a href="alpha.htm" tppabs="http://www.ctyme.com/intr/alpha.htm">Contents</a></td>
</td></table><p>
<p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
<h3><font color=#C00040>DOS 3.2+ - IOCTL - GENERIC CHARACTER DEVICE REQUEST</font></h3>
<PRE>
AX = 440Ch
BX = device handle
CH = category code <a href="rb-2894.htm#Table1545" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1545">(see #01545)</a>
CL = function number <a href="rb-2894.htm#Table1546" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1546">(see #01546)</a>
DS:DX -> parameter block <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #01547,#01548,#01549,#01550,#01551,#01552)
SI = parameter to pass to driver (European MS-DOS 4.0, OS/2 comp box)
DI = parameter to pass to driver (European MS-DOS 4.0, OS/2 comp box)<br>
<p><b>Return:</b><br>CF set on error
AX = error code <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #01680 at AH=59h/BX=0000h)
CF clear if successful
DS:DX -> iteration count if CL=65h
SI = returned value (European MS-DOS 4.0, OS/2 comp box)
DI = returned value (European MS-DOS 4.0, OS/2 comp box)
</PRE>
<p><b>Note:</b>
DR DOS 3.41 and 5.0 return error code 16h on CL=45h,65h if the device
does not support a retry counter
<p><b>See Also:</b>
<a href="rb-2896.htm" tppabs="http://www.ctyme.com/intr/rb-2896.htm">AX=440Dh"DOS 3.2+"</a> - <a href="rb-4282.htm" tppabs="http://www.ctyme.com/intr/rb-4282.htm">INT 2F/AX=0802h</a> - <a href="rb-4411.htm" tppabs="http://www.ctyme.com/intr/rb-4411.htm">INT 2F/AX=122Bh</a> - <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb \n\nThis file was not retrieved by Teleport Pro, because the server reports that this file cannot be found. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb'" tppabs="http://www.ctyme.com/intr/rb"
<p><b>See Also:</b>
<a href="rb-4657.htm" tppabs="http://www.ctyme.com/intr/rb-4657.htm">INT 2F/AX=1A01h</a>
<PRE>
<p>
<a name=table1545></a>
(Table 01545)
Values for IOCTL category code:
00h unknown (DOS 3.3+)
<p><b>01h COMn:</b><br>(DOS 3.3+)
02h reserved for terminal control
03h CON (DOS 3.3+)
04h reserved for keyboard control
05h LPTn:
07h mouse control (European MS-DOS 4.0)
08h reserved for disk control -- same as for block devices.
(see INT 21/AX=440Dh)
9Eh Media Access Control driver (STARLITE)
00h-7Fh reserved for Microsoft
80h-FFh reserved for OEM/user-defined
</PRE>
<p><b>See Also:</b>
#01558
<PRE>
<p>
<a name=table1546></a>
(Table 01546)
Values for generic character IOCTL function:
00h MAC driver Bind (STARLITE) <a href="rb-2894.htm#Table1547" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1547">(see #01547)</a>
<p><b>40h DOS 3??? only:</b><br>Was reserved for set screen mode (see #04116)
45h set iteration (retry) count <a href="rb-2894.htm#Table1548" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1548">(see #01548)</a>
4Ah select code page <a href="rb-2894.htm#Table1549" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1549">(see #01549)</a>
4Ch start code-page preparation <a href="rb-2894.htm#Table1550" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1550">(see #01550)</a>
4Dh end code-page preparation <a href="rb-2894.htm#Table1551" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1551">(see #01551)</a>
5Fh set display information (DOS 4.0+) <a href="rb-2894.htm#Table1552" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1552">(see #01552)</a>
<p><b>60h DOS 3??? only:</b><br>Was reserved for get screen mode (see #04116)
65h get iteration (retry) count
6Ah query selected code page <a href="rb-2894.htm#Table1549" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1549">(see #01549)</a>
6Bh query codepage prepare list (DOS 4.0+) <a href="rb-2894.htm#Table1553" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1553">(see #01553)</a>
7Fh get display information (DOS 4.0+) <a href="rb-2894.htm#Table1552" tppabs="http://www.ctyme.com/intr/rb-2894.htm#Table1552">(see #01552)</a>
</PRE>
<p><b>Note:</b>
Bit assignments for function code:
<PRE>
<p><b>bit 7:</b><br>Set to ignore if unsupported, clear to return error
<p><b>bit 6:</b><br>Set if passed to driver, clear if intercepted by DOS
<p><b>bit 5:</b><br>Set if queries data from device, clear if sends command
(by convention, if a function both queries and sends data,
bit 5 should be clear)
<p><b>bits 4-0:</b><br>Subfunction
<p>
Format of parameter block for function 00h:
<a name=table1547></a>
Offset Size Description (Table 01547)
00h 8 BYTEs ASCIZ signature "STARMAC"
08h WORD version
0Ah WORD flags
<p><b>bit 0:</b><br>Media requires connect or listen request before use
<p><b>bit 1:</b><br>Network is a LAN (broadcast/multicast supported)
<p><b>bit 2:</b><br>Point-to-point network
0Ch WORD handle for use with MAC driver's private interface (filled in
by MAC driver)
0Eh WORD context
10h WORD approximate speed in KB/sec (filled in by MAC driver)
12h WORD approximate cost in cents per hour (filled in by MAC driver)
14h WORD maximum packet size in bytes (filled in by MAC driver)
16h WORD addressing format (filled in by MAC driver)
0000h general addressing
0001h Ethernet addressing
0002h Token Ring addressing
0003h Token Bus addressing
18h DWORD Send entry point (filled in by MAC driver)
1Ch DWORD RegisterEventHandler entry point (filled in by MAC driver)
20h DWORD SetPacketFilter entry point (filled in by MAC driver)
24h DWORD UnBind entry point (filled in by MAC driver)
<p>
Format of parameter block for DOS 3??? screen mode functions 40h and 60h:
<a name=table4116></a>
Offset Size Description (Table 04116)
00h WORD length of folowing data (0009h)
02h BYTE mode type
03h WORD number of colors
05h WORD width
07h WORD height
</PRE>
<p><b>Note:</b>
These functions appear never to have been released to the public
<p><b>See Also:</b>
#01546
<PRE>
<p>
Format of parameter block for function 45h:
<a name=table1548></a>
Offset Size Description (Table 01548)
00h WORD number of times output is attempted before driver assumes
device is busy
<p>
Format of parameter block for functions 4Ah and 6Ah:
<a name=table1549></a>
Offset Size Description (Table 01549)
00h WORD length of data
02h WORD code page ID <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #01757 at INT 21/AX=6602h)
04h 2N BYTEs DCBS (double byte character set) lead byte range
start/end for each of N ranges (DOS 4.0).
WORD 0000h end of data (DOS 4.0)
<p>
Format of parameter block for function 4Ch:
<a name=table1550></a>
Offset Size Description (Table 01550)
00h WORD flags
DISPLAY.SYS = 0000h
PRINTER.SYS bit 0 clear to prepare downloaded font, set to
prepare cartridge selection
02h WORD length of remainder of parameter block
04h WORD number of code pages following
06h N WORDs code page 1,...,N
<p>
Format of parameter block for function 4Dh:
<a name=table1551></a>
Offset Size Description (Table 01551)
00h WORD length of data
02h WORD code page ID <a href="javascript:if(confirm('http://www.ctyme.com/intr/rb-0000.htm \n\nThis file was not retrieved by Teleport Pro, because it was unavailable, or its retrieval was aborted, or the project was stopped too soon. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/intr/rb-0000.htm#Table0'" tppabs="http://www.ctyme.com/intr/rb-0000.htm#Table0"></a>(see #01757 at INT 21/AX=6602h)
<p>
Format of parameter block for functions 5Fh and 7Fh:
<a name=table1552></a>
Offset Size Description (Table 01552)
00h BYTE level (0 for DOS 4.x-6.0)
01h BYTE reserved (0)
02h WORD length of following data (14)
04h WORD control flags
bit 0 set for blink, clear for intensity
bits 1-15 reserved
06h BYTE mode type (1=text, 2=graphics)
07h BYTE reserved (0)
08h WORD colors
0000h = monochrome
else N bits per pixel
0Ah WORD pixel columns
0Ch WORD pixel rows
0Eh WORD character columns
10h WORD character rows
<p>
Format of parameter block for function 6Bh:
<a name=table1553></a>
Offset Size Description (Table 01553)
00h WORD length of following data
02h WORD number of hardware code pages
04h N WORDs hardware code pages 1,...,N.
WORD number of prepared code pages
N WORDs prepared code pages 1,...,N
</PRE>
<p>
<b>Category: <a href="cat-010.htm" tppabs="http://www.ctyme.com/intr/cat-010.htm">
DOS Kernel</a>
- <a href="int-21.htm" tppabs="http://www.ctyme.com/intr/int-21.htm">
Int 21h</a>
- <a href="alpha-d.htm" tppabs="http://www.ctyme.com/intr/alpha-d.htm">
D</a>
</b><p><p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
<table border=1 cellpadding=3 cellspacing=1>
<td>
<a href="rb-2893.htm" tppabs="http://www.ctyme.com/intr/rb-2893.htm">
<img src="lup.gif" tppabs="http://graphics.ctyme.com/gif/lup.gif" border=0 alt=Prev></a>
<a href="rb-2895.htm" tppabs="http://www.ctyme.com/intr/rb-2895.htm">
<img src="ldown.gif" tppabs="http://graphics.ctyme.com/gif/ldown.gif" border=0 alt=Next></a>
<a href="javascript:if(confirm('http://www.ctyme.com/rbrown.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/rbrown.htm'" tppabs="http://www.ctyme.com/rbrown.htm">
<img src="lhome.gif" tppabs="http://graphics.ctyme.com/gif/lhome.gif" border=0 alt=Ralf Brown Page></a>
<td><a href="int.htm" tppabs="http://www.ctyme.com/intr/int.htm">Interrups</a></td>
<td><a href="cat.htm" tppabs="http://www.ctyme.com/intr/cat.htm">Categories</a></td>
<td><a href="alpha.htm" tppabs="http://www.ctyme.com/intr/alpha.htm">Contents</a></td>
</td></table><p>
<!-- Bottom Link Start -->
<center>
<p><table border=1 bgcolor="#ffff99"><tr><td>
<table border=0 height=80>
<tr align=center><td width="65">
<a href="javascript:if(confirm('http://www.ctyme.com/sponsor.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/sponsor.htm'" tppabs="http://www.ctyme.com/sponsor.htm">
<img src="tip.gif" tppabs="http://graphics.ctyme.com/gif/tip.gif" ALT="Sponsors" height="40" width="40"></a>
<br><a href="javascript:if(confirm('http://www.ctyme.com/sponsor.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/sponsor.htm'" tppabs="http://www.ctyme.com/sponsor.htm">Shopping</a>
</td><td width="65">
<a href="javascript:if(confirm('http://talk.ctyme.com/webx.cgi?13@@.ee6b2be \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://talk.ctyme.com/webx.cgi?13@@.ee6b2be'" tppabs="http://talk.ctyme.com/webx.cgi?13@@.ee6b2be">
<img src="comment.gif" tppabs="http://graphics.ctyme.com/gif/comment.gif" ALT="Forum" height="40" width="40"></a>
<br><a href="javascript:if(confirm('http://talk.ctyme.com/webx.cgi?13@@.ee6b2be \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://talk.ctyme.com/webx.cgi?13@@.ee6b2be'" tppabs="http://talk.ctyme.com/webx.cgi?13@@.ee6b2be">Forum</a>
</td><td width="65">
<a href="javascript:if(confirm('http://www.ctyme.com/mail.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/mail.htm'" tppabs="http://www.ctyme.com/mail.htm">
<img src="mail.gif" tppabs="http://graphics.ctyme.com/gif/mail.gif" ALT="email" height="40" width="40"></a>
<br><a href="javascript:if(confirm('http://www.ctyme.com/mail.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/mail.htm'" tppabs="http://www.ctyme.com/mail.htm">EMail</a>
</td><td width="65">
<a href="javascript:if(confirm('http://www.ctyme.com/map.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/map.htm'" tppabs="http://www.ctyme.com/map.htm">
<img src="toc.gif" tppabs="http://graphics.ctyme.com/gif/toc.gif" ALT="Index" height="40" width="40"></a>
<br><a href="javascript:if(confirm('http://www.ctyme.com/map.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/map.htm'" tppabs="http://www.ctyme.com/map.htm">Index</a>
</td><td width="65">
<a href="javascript:if(confirm('http://www.ctyme.com/ \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/'" tppabs="http://www.ctyme.com/">
<img src="home.gif" tppabs="http://graphics.ctyme.com/gif/home.gif" ALT="Home" height="40" width="40"></a>
<br><a href="javascript:if(confirm('http://www.ctyme.com/ \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/'" tppabs="http://www.ctyme.com/">Home</a>
</td><td width="90">
<center>
<FORM ACTION="https://secure.paypal.com/cgi-bin/webscr" tppabs="https://secure.paypal.com/cgi-bin/webscr" METHOD="POST" traget="_blank">
<INPUT TYPE="hidden" NAME="cmd" VALUE="_xclick">
<INPUT TYPE="hidden" NAME="business" VALUE="marc@perkel.com">
<INPUT TYPE="hidden" NAME="return" VALUE="http://www.perkel.com">
<INPUT TYPE="hidden" NAME="item_name" VALUE="Donation To Support this Site">
<INPUT TYPE="hidden" NAME="no_intl" VALUE="1">
<INPUT TYPE="image" SRC="x-click-but7.gif" tppabs="http://images.paypal.com/images/x-click-but7.gif" vspace=9
NAME="submit" ALT="Make payments with PayPal - it's fast, free and secure!">
</FORM>
</td></tr></table></td></tr></table><p>
<center>
<p>
<a href="javascript:if(confirm('http://www.ctyme.com/hosting/index.htm \n\nThis file was not retrieved by Teleport Pro, because it is addressed on a domain or path outside the boundaries set for its Starting Address. \n\nDo you want to open it from the server?'))window.location='http://www.ctyme.com/hosting/index.htm'" tppabs="http://www.ctyme.com/hosting/index.htm" target="_blank">
<img src="ctymehost.gif" tppabs="http://graphics.ctyme.com/gif/ctymehost.gif"
border=3 height=60 width=468></a>
<p>
<!-- Ad End --->
</center>
<FORM ACTION="http://service.bfast.com/bfast/click" target="_blank">
<INPUT TYPE="hidden" NAME="siteid" VALUE="30472466" >
<INPUT TYPE="hidden" NAME="bfpage" VALUE="horizontal">
<INPUT TYPE="hidden" NAME="bfmid" VALUE="27253343" >
<INPUT TYPE="hidden" NAME="num" VALUE="30">
<table bgcolor=white border=3><tr><td>
<table bgcolor=white border=0>
<tr><td>
<IMG SRC="serve-bfmid=27253343&siteid=30472466&bfpage=horizontal.gif" tppabs="http://service.bfast.com/bfast/serve?bfmid=27253343&siteid=30472466&bfpage=horizontal" BORDER="0" WIDTH="1" HEIGHT="1" align=right NOSAVE >
<center><b>Search the web with Google</b></center>
</td></tr><tr><td>
<TABLE cellpadding=0 cellspacing=5 bgcolor="#FFFFFF">
<tr><td bgcolor="#0000cc"><IMG SRC="cleardot.gif" tppabs="http://www.google.com/images/cleardot.gif" height=1 border="0" ALT="Google"></td></tr><tr><td>
<IMG SRC="affiliate_logo.gif" tppabs="http://www.google.com/affiliates/affiliate_logo.gif" border="0" ALT="Google" align="center">
<INPUT TYPE=text name=q size=30 maxlength=255 value="">
<INPUT type=submit name=sa VALUE="Go">
</td></tr>
<tr><td bgcolor="#0000cc"><IMG SRC="cleardot.gif" tppabs="http://www.google.com/images/cleardot.gif" height=1 border="0" ALT="Google"></td></tr></TABLE>
</td></tr></table>
</tr></td></table>
</FORM>
</center>
<p><img src="rbline.gif" tppabs="http://graphics.ctyme.com/gif/rbline.gif" width="100%" alt="------"><p>
<!-- Bottom Link End -->
</BODY>
</HTML>