Subversion Repositories Kolibri OS

Rev

Rev 585 | Rev 608 | Go to most recent revision | Only display areas with differences | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 585 Rev 588
1 
SYSTEM FUNCTIONS of OS Kolibri 0.7.0.0
 1 
SYSTEM FUNCTIONS of OS Kolibri 0.7.0.0
2 
 
 2 
 
3 
Number of the function is located in the register eax.
 3 
Number of the function is located in the register eax.
4 
The call of the system function is executed by "int 0x40" command.
 4 
The call of the system function is executed by "int 0x40" command.
5 
All registers except explicitly declared in the returned value,
 5 
All registers except explicitly declared in the returned value,
6 
    including eflags, are preserved.
 6 
    including eflags, are preserved.
7 
 
 7 
 
8 
 
 8 
 
9 
======================================================================
 9 
======================================================================
10 
============== Function 0 - define and draw the window. ==============
 10 
============== Function 0 - define and draw the window. ==============
11 
======================================================================
 11 
======================================================================
12 
Defines an application window. Draws a frame of the window, header and
 12 
Defines an application window. Draws a frame of the window, header and
13 
working area. For skinned windows defines standard close and minimize
 13 
working area. For skinned windows defines standard close and minimize
14 
buttons.
 14 
buttons.
15 
Parameters:
 15 
Parameters:
16 
  * eax = 0 - function number
 16 
  * eax = 0 - function number
17 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
 17 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
18 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
 18 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
19 
  * edx = 0xXYRRGGBB, where:
 19 
  * edx = 0xXYRRGGBB, where:
20 
    * Y = style of the window:
 20 
    * Y = style of the window:
21 
      * Y=0 - type I - fixed-size window
 21 
      * Y=0 - type I - fixed-size window
22 
      * Y=1 - only define window area, draw nothing
 22 
      * Y=1 - only define window area, draw nothing
23 
      * Y=2 - type II - variable-size window
 23 
      * Y=2 - type II - variable-size window
24 
      * Y=3 - skinned window
 24 
      * Y=3 - skinned window
25 
      * Y=4 - skinned window with fixed sizes
 25 
      * Y=4 - skinned window with fixed sizes
26 
      * other possible values (from 4 up to 15) are reserved,
 26 
      * other possible values (from 4 up to 15) are reserved,
27 
        function call with such Y is ignored
 27 
        function call with such Y is ignored
28 
    * RR, GG, BB = accordingly red, green, blue components of a color
 28 
    * RR, GG, BB = accordingly red, green, blue components of a color
29 
      of the working area of the window (are ignored for style Y=2)
 29 
      of the working area of the window (are ignored for style Y=2)
30 
    * X = DCBA (bits)
 30 
    * X = DCBA (bits)
31 
      * A = 1 - window has caption; for style Y=3 caption string
 31 
      * A = 1 - window has caption; for style Y=3 caption string
32 
                  must be passed in edi, for other styles use
 32 
                  must be passed in edi, for other styles use
33 
                  subfunction 1 of function 71
 33 
                  subfunction 1 of function 71
34 
      * B = 1 - coordinates of all graphics primitives are relative to
 34 
      * B = 1 - coordinates of all graphics primitives are relative to
35 
                  window client area
 35 
                  window client area
36 
      * C = 1 - don't fill working area on window draw
 36 
      * C = 1 - don't fill working area on window draw
37 
      * D = 0 - normal filling of the working area, 1 - gradient
 37 
      * D = 0 - normal filling of the working area, 1 - gradient
38 
    The following parameters are intended for windows
 38 
    The following parameters are intended for windows
39 
    of a type I and II, and ignored for styles Y=1,3:
 39 
    of a type I and II, and ignored for styles Y=1,3:
40 
  * esi = 0xXYRRGGBB - color of the header
 40 
  * esi = 0xXYRRGGBB - color of the header
41 
    * RR, GG, BB define color
 41 
    * RR, GG, BB define color
42 
    * Y=0 - usual window, Y=1 - unmovable window
 42 
    * Y=0 - usual window, Y=1 - unmovable window
43 
    * X defines a gradient of header: X=0 - no gradient,
 43 
    * X defines a gradient of header: X=0 - no gradient,
44 
      X=8 - usual gradient,
 44 
      X=8 - usual gradient,
45 
      for windows of a type II X=4 - negative gradient
 45 
      for windows of a type II X=4 - negative gradient
46 
    * other values of X and Y are reserved
 46 
    * other values of X and Y are reserved
47 
  * edi = 0x00RRGGBB - color of the frame
 47 
  * edi = 0x00RRGGBB - color of the frame
48 
Returned value:
 48 
Returned value:
49 
  * function does not return value
 49 
  * function does not return value
50 
Remarks:
 50 
Remarks:
51 
  * Position and sizes of the window are installed by the first
 51 
  * Position and sizes of the window are installed by the first
52 
    call of this function and are ignored at subsequent; to change
 52 
    call of this function and are ignored at subsequent; to change
53 
    position and/or sizes of already created window use function 67.
 53 
    position and/or sizes of already created window use function 67.
54 
  * For windows with style Y=3 and caption (A=1) caption string is set
 54 
  * For windows with style Y=3 and caption (A=1) caption string is set
55 
    by the first call of this function and is ignored at subsequent
 55 
    by the first call of this function and is ignored at subsequent
56 
    (strictly speaking, is ignored after a call to subfunction 2
 56 
    (strictly speaking, is ignored after a call to subfunction 2
57 
    of function 12 - end redraw); to change caption of already created
 57 
    of function 12 - end redraw); to change caption of already created
58 
    window use subfunction 1 of function 71.
 58 
    window use subfunction 1 of function 71.
59 
  * If the window has appropriate styles, position and/or sizes can be
 59 
  * If the window has appropriate styles, position and/or sizes can be
60 
    changed by user. Current position and sizes can be obtained
 60 
    changed by user. Current position and sizes can be obtained
61 
    by function 9.
 61 
    by function 9.
62 
  * The window must fit on the screen. If the transferred
 62 
  * The window must fit on the screen. If the transferred
63 
    coordinates and sizes do not satisfy to this condition,
 63 
    coordinates and sizes do not satisfy to this condition,
64 
    appropriate coordinate (or, probably, both) is considered as zero,
 64 
    appropriate coordinate (or, probably, both) is considered as zero,
65 
    and if it does not help too, the appropriate size
 65 
    and if it does not help too, the appropriate size
66 
    (or, probably, both) is installed in a size of the screen.
 66 
    (or, probably, both) is installed in a size of the screen.
67
67
68 
    Further let us designate xpos,ypos,xsize,ysize - values passed
 68 
    Further let us designate xpos,ypos,xsize,ysize - values passed
69 
    in ebx,ecx. The coordinates are resulted concerning
 69 
    in ebx,ecx. The coordinates are resulted concerning
70 
    the left upper corner of the window, which, thus, is set as (0,0),
 70 
    the left upper corner of the window, which, thus, is set as (0,0),
71 
    coordinates of the right lower corner essence (xsize,ysize).
 71 
    coordinates of the right lower corner essence (xsize,ysize).
72 
  * The sizes of the window are understood in sence of coordinates
 72 
  * The sizes of the window are understood in sence of coordinates
73 
    of the right lower corner. This concerns all other functions too.
 73 
    of the right lower corner. This concerns all other functions too.
74 
    It means, that the real sizes are on 1 pixel more.
 74 
    It means, that the real sizes are on 1 pixel more.
75 
  * The window of type I looks as follows:
 75 
  * The window of type I looks as follows:
76 
    * draw external frame of color indicated in edi, 1 pixel in width
 76 
    * draw external frame of color indicated in edi, 1 pixel in width
77 
    * draw header - rectangle with the left upper corner (1,1) and
 77 
    * draw header - rectangle with the left upper corner (1,1) and
78 
      right lower (xsize-1,min(25,ysize)) color indicated in esi
 78 
      right lower (xsize-1,min(25,ysize)) color indicated in esi
79 
      (taking a gradient into account)
 79 
      (taking a gradient into account)
80 
    * if ysize>=26, fill the working area of the window -
 80 
    * if ysize>=26, fill the working area of the window -
81 
      rectangle with the left upper corner (1,21) and right lower
 81 
      rectangle with the left upper corner (1,21) and right lower
82 
      (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color
 82 
      (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color
83 
      indicated in edx (taking a gradient into account)
 83 
      indicated in edx (taking a gradient into account)
84 
    * if A=1 and caption has been already set by subfunction 1
 84 
    * if A=1 and caption has been already set by subfunction 1
85 
      of function 71, it is drawn in the corresponding place of header
 85 
      of function 71, it is drawn in the corresponding place of header
86 
  * The window of style Y=1 looks as follows:
 86 
  * The window of style Y=1 looks as follows:
87 
    * completely defined by the application
 87 
    * completely defined by the application
88 
  * The window of type II looks as follows:
 88 
  * The window of type II looks as follows:
89 
    * draw external frame of width 1 pixel with the "shaded" color
 89 
    * draw external frame of width 1 pixel with the "shaded" color
90 
      edi (all components of the color decrease twice)
 90 
      edi (all components of the color decrease twice)
91 
    * draw intermediate frame of width 3 pixels with color edi
 91 
    * draw intermediate frame of width 3 pixels with color edi
92 
    * draw internal frame of width 1 pixel with the "shaded" color edi
 92 
    * draw internal frame of width 1 pixel with the "shaded" color edi
93 
    * draw header - rectangle with the left upper corner (4,4)
 93 
    * draw header - rectangle with the left upper corner (4,4)
94 
      and right lower (xsize-4,min(20,ysize)) color, indicated in esi
 94 
      and right lower (xsize-4,min(20,ysize)) color, indicated in esi
95 
      (taking a gradient into account)
 95 
      (taking a gradient into account)
96 
    * if ysize>=26, fill the working area of the window -
 96 
    * if ysize>=26, fill the working area of the window -
97 
      rectangle with the left upper corner (5,20) and right lower
 97 
      rectangle with the left upper corner (5,20) and right lower
98 
      (xsize-5,ysize-5) with color indicated in edx
 98 
      (xsize-5,ysize-5) with color indicated in edx
99 
      (taking a gradient into account)
 99 
      (taking a gradient into account)
100 
    * if A=1 and caption has been already set by subfunction 1
 100 
    * if A=1 and caption has been already set by subfunction 1
101 
      of function 71, it is drawn in the corresponding place of header
 101 
      of function 71, it is drawn in the corresponding place of header
102 
  * The skinned window looks as follows:
 102 
  * The skinned window looks as follows:
103 
    * draw external frame of width 1 pixel
 103 
    * draw external frame of width 1 pixel
104 
      with color 'outer' from the skin
 104 
      with color 'outer' from the skin
105 
    * draw intermediate frame of width 3 pixel
 105 
    * draw intermediate frame of width 3 pixel
106 
      with color 'frame' from the skin
 106 
      with color 'frame' from the skin
107 
    * draw internal frame of width 1 pixel
 107 
    * draw internal frame of width 1 pixel
108 
      with color 'inner' from the skin
 108 
      with color 'inner' from the skin
109 
    * draw header (on bitmaps from the skin) in a rectangle
 109 
    * draw header (on bitmaps from the skin) in a rectangle
110 
      (0,0) - (xsize,_skinh-1)
 110 
      (0,0) - (xsize,_skinh-1)
111 
    * if ysize>=26, fill the working area of the window -
 111 
    * if ysize>=26, fill the working area of the window -
112 
      rectangle with the left upper corner (5,_skinh) and right lower
 112 
      rectangle with the left upper corner (5,_skinh) and right lower
113 
      (xsize-5,ysize-5) with color indicated in edx
 113 
      (xsize-5,ysize-5) with color indicated in edx
114 
      (taking a gradient into account)
 114 
      (taking a gradient into account)
115 
    * define two standard buttons: close and minimize
 115 
    * define two standard buttons: close and minimize
116 
      (see function 8)
 116 
      (see function 8)
117 
    * if A=1 and edi contains (nonzero) pointer to caption string,
 117 
    * if A=1 and edi contains (nonzero) pointer to caption string,
118 
      it is drawn in place in header defined in the skin
 118 
      it is drawn in place in header defined in the skin
119 
    * value _skinh is accessible as the result of call
 119 
    * value _skinh is accessible as the result of call
120 
      subfunction 4 of function 48
 120 
      subfunction 4 of function 48
121 
 
 121 
 
122 
======================================================================
 122 
======================================================================
123 
================ Function 1 - put pixel in the window. ===============
 123 
================ Function 1 - put pixel in the window. ===============
124 
======================================================================
 124 
======================================================================
125 
Parameters:
 125 
Parameters:
126 
  * eax = 1 - function number
 126 
  * eax = 1 - function number
127 
  * ebx = x-coordinate (relative to the window)
 127 
  * ebx = x-coordinate (relative to the window)
128 
  * ecx = y-coordinate (relative to the window)
 128 
  * ecx = y-coordinate (relative to the window)
129 
  * edx = 0x00RRGGBB - color of a pixel
 129 
  * edx = 0x00RRGGBB - color of a pixel
130 
    edx = 0x01xxxxxx - invert color of a pixel
 130 
    edx = 0x01xxxxxx - invert color of a pixel
131 
          (low 24 bits are ignored)
 131 
          (low 24 bits are ignored)
132 
Returned value:
 132 
Returned value:
133 
  * function does not return value
 133 
  * function does not return value
134 
 
 134 
 
135 
======================================================================
 135 
======================================================================
136 
============ Function 2 - get the code of the pressed key. ===========
 136 
============ Function 2 - get the code of the pressed key. ===========
137 
======================================================================
 137 
======================================================================
138 
Takes away the code of the pressed key from the buffer.
 138 
Takes away the code of the pressed key from the buffer.
139 
Parameters:
 139 
Parameters:
140 
  * eax = 2 - function number
 140 
  * eax = 2 - function number
141 
Returned value:
 141 
Returned value:
142 
  * if the buffer is empty, function returns eax=1
 142 
  * if the buffer is empty, function returns eax=1
143 
  * if the buffer is not empty, function returns al=0,
 143 
  * if the buffer is not empty, function returns al=0,
144 
    ah=code of the pressed key, high word of eax is zero
 144 
    ah=code of the pressed key, high word of eax is zero
145 
  * if there is "hotkey", function returns al=2,
 145 
  * if there is "hotkey", function returns al=2,
146 
    ah=scancode of the pressed key (0 for control keys),
 146 
    ah=scancode of the pressed key (0 for control keys),
147 
    high word of eax contains a status of control keys at the moment
 147 
    high word of eax contains a status of control keys at the moment
148 
    of pressing a hotkey
 148 
    of pressing a hotkey
149 
Remarks:
 149 
Remarks:
150 
  * There is a common system buffer of the pressed keys
 150 
  * There is a common system buffer of the pressed keys
151 
    by a size of 120 bytes, organized as queue.
 151 
    by a size of 120 bytes, organized as queue.
152 
  * There is one more common system buffer on 120 "hotkeys".
 152 
  * There is one more common system buffer on 120 "hotkeys".
153 
  * If the application with the inactive window calls this function,
 153 
  * If the application with the inactive window calls this function,
154 
    the buffer of the pressed keys is considered to be empty.
 154 
    the buffer of the pressed keys is considered to be empty.
155 
  * By default this function returns ASCII-codes; to switch
 155 
  * By default this function returns ASCII-codes; to switch
156 
    to the scancodes mode (and back) use function 66.
 156 
    to the scancodes mode (and back) use function 66.
157 
    However, hotkeys are always notificated as scancodes.
 157 
    However, hotkeys are always notificated as scancodes.
158 
  * To find out, what keys correspond to what codes, start
 158 
  * To find out, what keys correspond to what codes, start
159 
    the application keyascii and scancode.
 159 
    the application keyascii and scancode.
160 
  * Scancodes come directly from keyboard and are fixed;
 160 
  * Scancodes come directly from keyboard and are fixed;
161 
    ASCII-codes turn out with usage of the conversion tables,
 161 
    ASCII-codes turn out with usage of the conversion tables,
162 
    which can be set by subfunction 2 of function 21
 162 
    which can be set by subfunction 2 of function 21
163 
    and get by subfunction 2 of function 26.
 163 
    and get by subfunction 2 of function 26.
164 
  * As a consequence, ASCII-codes take into account current
 164 
  * As a consequence, ASCII-codes take into account current
165 
    keyboard layout (rus/en) as opposed to scancodes.
 165 
    keyboard layout (rus/en) as opposed to scancodes.
166 
  * This function notifies only about those hotkeys, which were
 166 
  * This function notifies only about those hotkeys, which were
167 
    defined by this thread by subfunction 4 of function 66.
 167 
    defined by this thread by subfunction 4 of function 66.
168 
 
 168 
 
169 
======================================================================
 169 
======================================================================
170 
==================== Function 3 - get system time. ===================
 170 
==================== Function 3 - get system time. ===================
171 
======================================================================
 171 
======================================================================
172 
Parameters:
 172 
Parameters:
173 
  * eax = 3 - function number
 173 
  * eax = 3 - function number
174 
Returned value:
 174 
Returned value:
175 
  * eax = 0x00SSMMHH, where HH:MM:SS = Hours:Minutes:Seconds
 175 
  * eax = 0x00SSMMHH, where HH:MM:SS = Hours:Minutes:Seconds
176 
  * each item is BCD-number, for example,
 176 
  * each item is BCD-number, for example,
177 
    for time 23:59:59 function returns 0x00595923
 177 
    for time 23:59:59 function returns 0x00595923
178 
Remarks:
 178 
Remarks:
179 
  * See also subfunction 9 of function 26 - get time from
 179 
  * See also subfunction 9 of function 26 - get time from
180 
    the moment of start of the system; it is more convenient, because
 180 
    the moment of start of the system; it is more convenient, because
181 
    returns simply DWORD-value of the time counter.
 181 
    returns simply DWORD-value of the time counter.
182 
  * System time can be set by function 22.
 182 
  * System time can be set by function 22.
183 
 
 183 
 
184 
======================================================================
 184 
======================================================================
185 
============ Function 4 - draw text string in the window. ============
 185 
============ Function 4 - draw text string in the window. ============
186 
======================================================================
 186 
======================================================================
187 
Parameters:
 187 
Parameters:
188 
  * eax = 4 - function number
 188 
  * eax = 4 - function number
189 
  * ebx = [coordinate on axis x]*65536 + [coordinate on axis y]
 189 
  * ebx = [coordinate on axis x]*65536 + [coordinate on axis y]
190 
  * ecx = 0xX0RRGGBB, where
 190 
  * ecx = 0xX0RRGGBB, where
191 
    * RR, GG, BB specify text color
 191 
    * RR, GG, BB specify text color
192 
    * X=ABnn (bits):
 192 
    * X=ABnn (bits):
193 
    * nn specifies the used font: 0=system monospaced,
 193 
    * nn specifies the used font: 0=system monospaced,
194 
      1=system font of variable width
 194 
      1=system font of variable width
195 
    * A=0 - output esi characters, A=1 - output ASCIIZ-string
 195 
    * A=0 - output esi characters, A=1 - output ASCIIZ-string
196 
    * B=1 - fill background with the color edi
 196 
    * B=1 - fill background with the color edi
197 
  * edx = pointer to the beginning of the string
 197 
  * edx = pointer to the beginning of the string
198 
  * esi = for A=0 length of the string, must not exceed 255;
 198 
  * esi = for A=0 length of the string, must not exceed 255;
199 
          for A=1 is ignored
 199 
          for A=1 is ignored
200 
Returned value:
 200 
Returned value:
201 
  * function does not return value
 201 
  * function does not return value
202 
Remarks:
 202 
Remarks:
203 
  * First system font is read out at loading from the file char.mt,
 203 
  * First system font is read out at loading from the file char.mt,
204 
    second - from char2.mt.
 204 
    second - from char2.mt.
205 
  * Both fonts have height 9 pixels, width of the monospaced font
 205 
  * Both fonts have height 9 pixels, width of the monospaced font
206 
    is equal to 6 pixels.
 206 
    is equal to 6 pixels.
207 
 
 207 
 
208 
======================================================================
 208 
======================================================================
209 
========================= Function 5 - delay. ========================
 209 
========================= Function 5 - delay. ========================
210 
======================================================================
 210 
======================================================================
211 
Delays execution of the program on the given time.
 211 
Delays execution of the program on the given time.
212 
Parameters:
 212 
Parameters:
213 
  * eax = 5 - function number
 213 
  * eax = 5 - function number
214 
  * ebx = time in the 1/100 of second
 214 
  * ebx = time in the 1/100 of second
215 
Returned value:
 215 
Returned value:
216 
  * function does not return value
 216 
  * function does not return value
217 
Remarks:
 217 
Remarks:
218 
  * Passing ebx=0 does not transfer control to the next process
 218 
  * Passing ebx=0 does not transfer control to the next process
219 
    and does not make any operations at all. If it is really required
 219 
    and does not make any operations at all. If it is really required
220 
    to transfer control to the next process (to complete a current
 220 
    to transfer control to the next process (to complete a current
221 
    time slice), use subfunction 1 of function 68.
 221 
    time slice), use subfunction 1 of function 68.
222 
  * At current implementation there will be an immediate return from
 222 
  * At current implementation there will be an immediate return from
223 
    the function, if the addition of ebx with current value of
 223 
    the function, if the addition of ebx with current value of
224 
    time counter will call 32-bit overflow.
 224 
    time counter will call 32-bit overflow.
225 
 
 225 
 
226 
======================================================================
 226 
======================================================================
227 
============== Function 6 - read the file from ramdisk. ==============
 227 
============== Function 6 - read the file from ramdisk. ==============
228 
======================================================================
 228 
======================================================================
229 
Parameters:
 229 
Parameters:
230 
  * eax = 6 - function number
 230 
  * eax = 6 - function number
231 
  * ebx = pointer to the filename
 231 
  * ebx = pointer to the filename
232 
  * ecx = number of start block, beginning from 1;
 232 
  * ecx = number of start block, beginning from 1;
233 
    ecx=0 - read from the beginning of the file (same as ecx=1)
 233 
    ecx=0 - read from the beginning of the file (same as ecx=1)
234 
  * edx = number of blocks to read;
 234 
  * edx = number of blocks to read;
235 
    edx=0 - read one block (same as edx=1)
 235 
    edx=0 - read one block (same as edx=1)
236 
  * esi = pointer to memory area for the data
 236 
  * esi = pointer to memory area for the data
237 
Returned value:
 237 
Returned value:
238 
  * eax = file size in bytes, if the file was successfully read
 238 
  * eax = file size in bytes, if the file was successfully read
239 
  * eax = -1, if the file was not found
 239 
  * eax = -1, if the file was not found
240 
Remarks:
 240 
Remarks:
241 
  * This function is out-of-date; function 70 allows
 241 
  * This function is out-of-date; function 70 allows
242 
    to fulfil the same operations with the extended possibilities.
 242 
    to fulfil the same operations with the extended possibilities.
243 
  * Block = 512 bytes.
 243 
  * Block = 512 bytes.
244 
  * For reading all file you can specify the certainly large value
 244 
  * For reading all file you can specify the certainly large value
245 
    in edx, for example, edx = -1; but in this case be ready that
 245 
    in edx, for example, edx = -1; but in this case be ready that
246 
    the program will "fall", if the file will appear too large and can
 246 
    the program will "fall", if the file will appear too large and can
247 
    not be placed in the program memory.
 247 
    not be placed in the program memory.
248 
  * The filename must be either in the format 8+3 characters
 248 
  * The filename must be either in the format 8+3 characters
249 
    (first 8 characters - name itself, last 3 - extension,
 249 
    (first 8 characters - name itself, last 3 - extension,
250 
    the short names and extensions are supplemented with spaces),
 250 
    the short names and extensions are supplemented with spaces),
251 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
 251 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
252 
    (name no more than 8 characters, dot, extension 3 characters
 252 
    (name no more than 8 characters, dot, extension 3 characters
253 
    supplemented if necessary by spaces).
 253 
    supplemented if necessary by spaces).
254 
    The filename must be written with capital letters. The terminating
 254 
    The filename must be written with capital letters. The terminating
255 
    character with code 0 is not necessary (not ASCIIZ-string).
 255 
    character with code 0 is not necessary (not ASCIIZ-string).
256 
  * This function does not support folders on the ramdisk.
 256 
  * This function does not support folders on the ramdisk.
257 
 
 257 
 
258 
======================================================================
 258 
======================================================================
259 
=============== Function 7 - draw image in the window. ===============
 259 
=============== Function 7 - draw image in the window. ===============
260 
======================================================================
 260 
======================================================================
261 
Paramters:
 261 
Paramters:
262 
  * eax = 7 - function number
 262 
  * eax = 7 - function number
263 
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
 263 
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
264 
  * ecx = [size on axis x]*65536 + [size on axis y]
 264 
  * ecx = [size on axis x]*65536 + [size on axis y]
265 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 265 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
266 
Returned value:
 266 
Returned value:
267 
  * function does not return value
 267 
  * function does not return value
268 
Remarks:
 268 
Remarks:
269 
  * Coordinates of the image are coordinates of the upper left corner
 269 
  * Coordinates of the image are coordinates of the upper left corner
270 
    of the image relative to the window.
 270 
    of the image relative to the window.
271 
  * Size of the image in bytes is 3*xsize*ysize.
 271 
  * Size of the image in bytes is 3*xsize*ysize.
272 
 
 272 
 
273 
======================================================================
 273 
======================================================================
274 
=============== Function 8 - define/delete the button. ===============
 274 
=============== Function 8 - define/delete the button. ===============
275 
======================================================================
 275 
======================================================================
276 
Parameters for button definition:
 276 
Parameters for button definition:
277 
  * eax = 8 - function number
 277 
  * eax = 8 - function number
278 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
 278 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
279 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
 279 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
280 
  * edx = 0xXYnnnnnn, where:
 280 
  * edx = 0xXYnnnnnn, where:
281 
    * nnnnnn = identifier of the button
 281 
    * nnnnnn = identifier of the button
282 
    * high (31st) bit of edx is cleared
 282 
    * high (31st) bit of edx is cleared
283 
    * if 30th bit of edx is set - do not draw the button
 283 
    * if 30th bit of edx is set - do not draw the button
284 
    * if 29th bit of edx is set - do not draw a frame
 284 
    * if 29th bit of edx is set - do not draw a frame
285 
      at pressing the button
 285 
      at pressing the button
286 
  * esi = 0x00RRGGBB - color of the button
 286 
  * esi = 0x00RRGGBB - color of the button
287 
Parameters for button deleting:
 287 
Parameters for button deleting:
288 
  * eax = 8 - function number
 288 
  * eax = 8 - function number
289 
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
 289 
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
290 
Returned value:
 290 
Returned value:
291 
  * function does not return value
 291 
  * function does not return value
292 
Remarks:
 292 
Remarks:
293 
  * Sizes of the button must be more than 0 and less than 0x8000.
 293 
  * Sizes of the button must be more than 0 and less than 0x8000.
294 
  * For skinned windows definition of the window
 294 
  * For skinned windows definition of the window
295 
    (call of 0th function) creates two standard buttons -
 295 
    (call of 0th function) creates two standard buttons -
296 
    for close of the window with identifier 1 and
 296 
    for close of the window with identifier 1 and
297 
    for minimize of the window with identifier 0xffff.
 297 
    for minimize of the window with identifier 0xffff.
298 
  * The creation of two buttons with same identifiers is admitted.
 298 
  * The creation of two buttons with same identifiers is admitted.
299 
  * The button with the identifier 0xffff at pressing is interpreted
 299 
  * The button with the identifier 0xffff at pressing is interpreted
300 
    by the system as the button of minimization, the system handles
 300 
    by the system as the button of minimization, the system handles
301 
    such pressing independently, not accessing to the application.
 301 
    such pressing independently, not accessing to the application.
302 
    In rest it is usual button.
 302 
    In rest it is usual button.
303 
  * Total number of buttons for all applications is limited to 4095.
 303 
  * Total number of buttons for all applications is limited to 4095.
304 
 
 304 
 
305 
======================================================================
 305 
======================================================================
306 
============ Function 9 - information on execution thread. ===========
 306 
============ Function 9 - information on execution thread. ===========
307 
======================================================================
 307 
======================================================================
308 
Parameters:
 308 
Parameters:
309 
  * eax = 9 - function number
 309 
  * eax = 9 - function number
310 
  * ebx = pointer to 1-Kb buffer
 310 
  * ebx = pointer to 1-Kb buffer
311 
  * ecx = number of the slot of the thread
 311 
  * ecx = number of the slot of the thread
312 
    ecx = -1 - get information on the current thread
 312 
    ecx = -1 - get information on the current thread
313 
Returned value:
 313 
Returned value:
314 
  * eax = maximum number of the slot of a thread
 314 
  * eax = maximum number of the slot of a thread
315 
  * buffer pointed to by ebx contains the following information:
 315 
  * buffer pointed to by ebx contains the following information:
316 
    * +0: dword: usage of the processor (how many time units
 316 
    * +0: dword: usage of the processor (how many time units
317 
      per second leaves on execution of this thread)
 317 
      per second leaves on execution of this thread)
318 
    * +4: word: position of the window of thread in the window stack
 318 
    * +4: word: position of the window of thread in the window stack
319 
    * +6: word: (has no relation to the specified thread)
 319 
    * +6: word: (has no relation to the specified thread)
320 
      number of the thread slot, which window has in the window stack
 320 
      number of the thread slot, which window has in the window stack
321 
      position ecx
 321 
      position ecx
322 
    * +8: word: reserved
 322 
    * +8: word: reserved
323 
    * +10 = +0xA: 11 bytes: name of the process
 323 
    * +10 = +0xA: 11 bytes: name of the process
324 
      (name of corresponding executable file in the format 8+3)
 324 
      (name of corresponding executable file in the format 8+3)
325 
    * +21 = +0x15: byte: reserved, this byte is not changed
 325 
    * +21 = +0x15: byte: reserved, this byte is not changed
326 
    * +22 = +0x16: dword: address of the process in memory
 326 
    * +22 = +0x16: dword: address of the process in memory
327 
    * +26 = +0x1A: dword: size of used memory - 1
 327 
    * +26 = +0x1A: dword: size of used memory - 1
328 
    * +30 = +0x1E: dword: identifier (PID/TID)
 328 
    * +30 = +0x1E: dword: identifier (PID/TID)
329 
    * +34 = +0x22: dword: coordinate of the thread window on axis x
 329 
    * +34 = +0x22: dword: coordinate of the thread window on axis x
330 
    * +38 = +0x26: dword: coordinate of the thread window on axis y
 330 
    * +38 = +0x26: dword: coordinate of the thread window on axis y
331 
    * +42 = +0x2A: dword: size of the thread window on axis x
 331 
    * +42 = +0x2A: dword: size of the thread window on axis x
332 
    * +46 = +0x2E: dword: size of the thread window on axis y
 332 
    * +46 = +0x2E: dword: size of the thread window on axis y
333 
    * +50 = +0x32: word: status of the thread slot:
 333 
    * +50 = +0x32: word: status of the thread slot:
334 
      * 0 = thread is running
 334 
      * 0 = thread is running
335 
      * 1 = thread is suspended
 335 
      * 1 = thread is suspended
336 
      * 2 = thread is suspended while waiting for event
 336 
      * 2 = thread is suspended while waiting for event
337 
      * 3 = thread is terminating as a result of call to function -1
 337 
      * 3 = thread is terminating as a result of call to function -1
338 
        or under duress as a result of call to subfunction 2
 338 
        or under duress as a result of call to subfunction 2
339 
        of function 18 or termination of the system
 339 
        of function 18 or termination of the system
340 
      * 4 = thread is terminating as a result of exception
 340 
      * 4 = thread is terminating as a result of exception
341 
      * 5 = thread waits for event
 341 
      * 5 = thread waits for event
342 
      * 9 = requested slot is free, all other information on the slot
 342 
      * 9 = requested slot is free, all other information on the slot
343 
        is not meaningful
 343 
        is not meaningful
344 
    * +52 = +0x34: word: reserved, this word is not changed
 344 
    * +52 = +0x34: word: reserved, this word is not changed
345 
    * +54 = +0x36: dword: coordinate of the client area on axis x
 345 
    * +54 = +0x36: dword: coordinate of the client area on axis x
346 
    * +58 = +0x3A: dword: coordinate of the client area on axis y
 346 
    * +58 = +0x3A: dword: coordinate of the client area on axis y
347 
    * +62 = +0x3E: dword: width of the client area
 347 
    * +62 = +0x3E: dword: width of the client area
348 
    * +66 = +0x42: dword: height of the client area
 348 
    * +66 = +0x42: dword: height of the client area
349 
    * +70 = +0x46: byte: state of the window - bitfield
 349 
    * +70 = +0x46: byte: state of the window - bitfield
350 
      * bit 0 (mask 1): window is maximized
 350 
      * bit 0 (mask 1): window is maximized
351 
      * bit 1 (mask 2): window is minimized to panel
 351 
      * bit 1 (mask 2): window is minimized to panel
352 
      * bit 2 (mask 4): window is rolled up
 352 
      * bit 2 (mask 4): window is rolled up
353 
Remarks:
 353 
Remarks:
354 
  * Slots are numbered starting from 1.
 354 
  * Slots are numbered starting from 1.
355 
  * Returned value is not a total number of threads, because there
 355 
  * Returned value is not a total number of threads, because there
356 
    can be free slots.
 356 
    can be free slots.
357 
  * When process is starting, system automatically creates
 357 
  * When process is starting, system automatically creates
358 
    execution thread.
 358 
    execution thread.
359 
  * Function gives information on the thread. Each process has
 359 
  * Function gives information on the thread. Each process has
360 
    at least one thread. One process can create many threads,
 360 
    at least one thread. One process can create many threads,
361 
    in this case each thread has its own slot and the fields
 361 
    in this case each thread has its own slot and the fields
362 
    +10, +22, +26 in these slots coincide.
 362 
    +10, +22, +26 in these slots coincide.
363 
    Applications have no common way to define whether two threads
 363 
    Applications have no common way to define whether two threads
364 
    belong to one process.
 364 
    belong to one process.
365 
  * The active window - window on top of the window stack -
 365 
  * The active window - window on top of the window stack -
366 
    receives the messages on a keyboard input. For such window
 366 
    receives the messages on a keyboard input. For such window
367 
    the position in the window stack coincides with returned value.
 367 
    the position in the window stack coincides with returned value.
368 
  * Slot 1 corresponds to special system thread, for which:
 368 
  * Slot 1 corresponds to special system thread, for which:
369 
    * the window is in the bottom of the window stack, the fields
 369 
    * the window is in the bottom of the window stack, the fields
370 
      +4 and +6 contain value 1
 370 
      +4 and +6 contain value 1
371 
    * name of the process - "OS/IDLE" (supplemented by spaces)
 371 
    * name of the process - "OS/IDLE" (supplemented by spaces)
372 
    * address of the process in memory is 0, size of used memory is
 372 
    * address of the process in memory is 0, size of used memory is
373 
      16 Mb (0x1000000)
 373 
      16 Mb (0x1000000)
374 
    * PID=1
 374 
    * PID=1
375 
    * coordinates and sizes of the window and the client area are by
 375 
    * coordinates and sizes of the window and the client area are by
376 
      convention set to 0
 376 
      convention set to 0
377 
    * status of the slot is always 0 (running)
 377 
    * status of the slot is always 0 (running)
378 
    * the execution time adds of time leaving on operations itself
 378 
    * the execution time adds of time leaving on operations itself
379 
      and idle time in waiting for interrupt (which can be got by call
 379 
      and idle time in waiting for interrupt (which can be got by call
380 
      to subfunction 4 of function 18).
 380 
      to subfunction 4 of function 18).
381 
  * Beginning from slot 2, the normal applications are placed.
 381 
  * Beginning from slot 2, the normal applications are placed.
382 
  * The normal applications are placed in memory at the address
 382 
  * The normal applications are placed in memory at the address
383 
    0x60400000 (kernel constant 'std_application_base_address').
 383 
    0x60400000 (kernel constant 'std_application_base_address').
384 
    There is no intersection, as each process has its own page table.
 384 
    There is no intersection, as each process has its own page table.
385 
  * At creation of the thread it is assigned the slot
 385 
  * At creation of the thread it is assigned the slot
386 
    in the system table and identifier (Process/Thread IDentifier =
 386 
    in the system table and identifier (Process/Thread IDentifier =
387 
    PID/TID), which do not vary with time for given thread.
 387 
    PID/TID), which do not vary with time for given thread.
388 
    After completion of the thread its slot can be anew used
 388 
    After completion of the thread its slot can be anew used
389 
    for another thread. The thread identifier can not be assigned
 389 
    for another thread. The thread identifier can not be assigned
390 
    to other thread even after completion of this thread.
 390 
    to other thread even after completion of this thread.
391 
    Identifiers, assigned to new threads, grow monotonously.
 391 
    Identifiers, assigned to new threads, grow monotonously.
392 
  * If the thread has not yet defined the window by call to
 392 
  * If the thread has not yet defined the window by call to
393 
    function 0, the position and the sizes
 393 
    function 0, the position and the sizes
394 
    of its window are considered to be zero.
 394 
    of its window are considered to be zero.
395 
  * Coordinates of the client area are relative to the window.
 395 
  * Coordinates of the client area are relative to the window.
396 
  * At the moment only the part of the buffer by a size
 396 
  * At the moment only the part of the buffer by a size
397 
    71 = 0x37 bytes is used. Nevertheless it is recommended to use
 397 
    71 = 0x37 bytes is used. Nevertheless it is recommended to use
398 
    1-Kb buffer for the future compatibility, in the future
 398 
    1-Kb buffer for the future compatibility, in the future
399 
    some fields can be added.
 399 
    some fields can be added.
400 
 
 400 
 
401 
======================================================================
 401 
======================================================================
402 
==================== Function 10 - wait for event. ===================
 402 
==================== Function 10 - wait for event. ===================
403 
======================================================================
 403 
======================================================================
404 
If the message queue is empty, waits for appearance of the message
 404 
If the message queue is empty, waits for appearance of the message
405 
in queue. In this state thread does not consume CPU time.
 405 
in queue. In this state thread does not consume CPU time.
406 
Then reads out the message from queue.
 406 
Then reads out the message from queue.
407 
 
 407 
 
408 
Parameters:
 408 
Parameters:
409 
  * eax = 10 - function number
 409 
  * eax = 10 - function number
410 
Returned value:
 410 
Returned value:
411 
  * eax = event (see the list of events)
 411 
  * eax = event (see the list of events)
412 
Remarks:
 412 
Remarks:
413 
  * Those events are taken into account only which enter into
 413 
  * Those events are taken into account only which enter into
414 
    a mask set by function 40. By default it is
 414 
    a mask set by function 40. By default it is
415 
    redraw, key and button events.
 415 
    redraw, key and button events.
416 
  * To check, whether there is a message in queue, use function 11.
 416 
  * To check, whether there is a message in queue, use function 11.
417 
    To wait for no more than given time, use function 23.
 417 
    To wait for no more than given time, use function 23.
418 
 
 418 
 
419 
======================================================================
 419 
======================================================================
420 
=============== Function 11 - check for event, no wait. ==============
 420 
=============== Function 11 - check for event, no wait. ==============
421 
======================================================================
 421 
======================================================================
422 
If the message queue contains event, function reads out
 422 
If the message queue contains event, function reads out
423 
and return it. If the queue is empty, function returns 0.
 423 
and return it. If the queue is empty, function returns 0.
424 
Parameters:
 424 
Parameters:
425 
  * eax = 11 - function number
 425 
  * eax = 11 - function number
426 
Returned value:
 426 
Returned value:
427 
  * eax = 0 - message queue is empty
 427 
  * eax = 0 - message queue is empty
428 
  * else eax = event (see the list of events)
 428 
  * else eax = event (see the list of events)
429 
Remarks:
 429 
Remarks:
430 
  * Those events are taken into account only, which enter into
 430 
  * Those events are taken into account only, which enter into
431 
    a mask set by function 40. By default it is
 431 
    a mask set by function 40. By default it is
432 
    redraw, key and button events.
 432 
    redraw, key and button events.
433 
  * To wait for event, use function 10.
 433 
  * To wait for event, use function 10.
434 
    To wait for no more than given time, use function 23.
 434 
    To wait for no more than given time, use function 23.
435 
 
 435 
 
436 
======================================================================
 436 
======================================================================
437 
=============== Function 12 - begin/end window redraw. ===============
 437 
=============== Function 12 - begin/end window redraw. ===============
438 
======================================================================
 438 
======================================================================
439 
 
 439 
 
440 
---------------- Subfunction 1 - begin window redraw. ----------------
 440 
---------------- Subfunction 1 - begin window redraw. ----------------
441 
Parameters:
 441 
Parameters:
442 
  * eax = 12 - function number
 442 
  * eax = 12 - function number
443 
  * ebx = 1 - subfunction number
 443 
  * ebx = 1 - subfunction number
444 
Returned value:
 444 
Returned value:
445 
  * function does not return value
 445 
  * function does not return value
446 
 
 446 
 
447 
----------------- Subfunction 2 - end window redraw. -----------------
 447 
----------------- Subfunction 2 - end window redraw. -----------------
448 
Parameters:
 448 
Parameters:
449 
  * eax = 12 - function number
 449 
  * eax = 12 - function number
450 
  * ebx = 2 - subfunction number
 450 
  * ebx = 2 - subfunction number
451 
Returned value:
 451 
Returned value:
452 
  * function does not return value
 452 
  * function does not return value
453 
Remarks:
 453 
Remarks:
454 
  * Subfunction 1 deletes all buttons defined with
 454 
  * Subfunction 1 deletes all buttons defined with
455 
    function 8, they must be defined again.
 455 
    function 8, they must be defined again.
456 
 
 456 
 
457 
======================================================================
 457 
======================================================================
458 
============ Function 13 - draw a rectangle in the window. ===========
 458 
============ Function 13 - draw a rectangle in the window. ===========
459 
======================================================================
 459 
======================================================================
460 
Parameters:
 460 
Parameters:
461 
  * eax = 13 - function number
 461 
  * eax = 13 - function number
462 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
 462 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
463 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
 463 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
464 
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
 464 
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
465 
Returned value:
 465 
Returned value:
466 
  * function does not return value
 466 
  * function does not return value
467 
Remarks:
 467 
Remarks:
468 
  * Coordinates are understood as coordinates of the left upper corner
 468 
  * Coordinates are understood as coordinates of the left upper corner
469 
    of a rectangle relative to the window.
 469 
    of a rectangle relative to the window.
470 
 
 470 
 
471 
======================================================================
 471 
======================================================================
472 
=================== Function 14 - get screen size. ===================
 472 
=================== Function 14 - get screen size. ===================
473 
======================================================================
 473 
======================================================================
474 
Parameters:
 474 
Parameters:
475 
  * eax = 14 - function number
 475 
  * eax = 14 - function number
476 
Returned value:
 476 
Returned value:
477 
  * eax = [xsize]*65536 + [ysize], where
 477 
  * eax = [xsize]*65536 + [ysize], where
478 
  * xsize = x-coordinate of the right lower corner of the screen =
 478 
  * xsize = x-coordinate of the right lower corner of the screen =
479 
            horizontal size - 1
 479 
            horizontal size - 1
480 
  * ysize = y-coordinate of the right lower corner of the screen =
 480 
  * ysize = y-coordinate of the right lower corner of the screen =
481 
            vertical size - 1
 481 
            vertical size - 1
482 
Remarks:
 482 
Remarks:
483 
  * See also subfunction 5 of function 48 - get sizes of
 483 
  * See also subfunction 5 of function 48 - get sizes of
484 
    working area of the screen.
 484 
    working area of the screen.
485 
 
 485 
 
486 
======================================================================
 486 
======================================================================
487 
== Function 15, subfunction 1 - set a size of the background image. ==
 487 
== Function 15, subfunction 1 - set a size of the background image. ==
488 
======================================================================
 488 
======================================================================
489 
Parameters:
 489 
Parameters:
490 
  * eax = 15 - function number
 490 
  * eax = 15 - function number
491 
  * ebx = 1 - subfunction number
 491 
  * ebx = 1 - subfunction number
492 
  * ecx = width of the image
 492 
  * ecx = width of the image
493 
  * edx = height of the image
 493 
  * edx = height of the image
494 
Returned value:
 494 
Returned value:
495 
  * function does not return value
 495 
  * function does not return value
496 
Remarks:
 496 
Remarks:
497 
  * Before calling subfunctions 2 and 5 you should call this function
 497 
  * Before calling subfunctions 2 and 5 you should call this function
498 
    to set image size!
 498 
    to set image size!
499 
  * For update of the screen (after completion of a series of commands
 499 
  * For update of the screen (after completion of a series of commands
500 
    working with a background) call subfunction 3.
 500 
    working with a background) call subfunction 3.
501 
  * There is a pair function for get size of the background image -
 501 
  * There is a pair function for get size of the background image -
502 
    subfunction 1 of function 39.
 502 
    subfunction 1 of function 39.
503 
 
 503 
 
504 
======================================================================
 504 
======================================================================
505 
=== Function 15, subfunction 2 - put pixel on the background image. ==
 505 
=== Function 15, subfunction 2 - put pixel on the background image. ==
506 
======================================================================
 506 
======================================================================
507 
Parameters:
 507 
Parameters:
508 
  * eax = 15 - function number
 508 
  * eax = 15 - function number
509 
  * ebx = 2 - subfunction number
 509 
  * ebx = 2 - subfunction number
510 
  * ecx = offset
 510 
  * ecx = offset
511 
  * edx = color of a pixel 0xRRGGBB
 511 
  * edx = color of a pixel 0xRRGGBB
512 
Returned value:
 512 
Returned value:
513 
  * function does not return value
 513 
  * function does not return value
514 
Remarks:
 514 
Remarks:
515 
  * Offset for a pixel with coordinates (x,y) is calculated as
 515 
  * Offset for a pixel with coordinates (x,y) is calculated as
516 
    (x+y*xsize)*3.
 516 
    (x+y*xsize)*3.
517 
  * If the given offset exceeds size set by subfunction 1,
 517 
  * If the given offset exceeds size set by subfunction 1,
518 
    the call is ignored.
 518 
    the call is ignored.
519 
  * For update of the screen (after completion of a series of commands
 519 
  * For update of the screen (after completion of a series of commands
520 
    working with a background) call subfunction 3.
 520 
    working with a background) call subfunction 3.
521 
  * There is a pair function for get pixel on the background image -
 521 
  * There is a pair function for get pixel on the background image -
522 
    subfunction 2 of function 39.
 522 
    subfunction 2 of function 39.
523 
 
 523 
 
524 
======================================================================
 524 
======================================================================
525 
=========== Function 15, subfunction 3 - redraw background. ==========
 525 
=========== Function 15, subfunction 3 - redraw background. ==========
526 
======================================================================
 526 
======================================================================
527 
Parameters:
 527 
Parameters:
528 
  * eax = 15 - function number
 528 
  * eax = 15 - function number
529 
  * ebx = 3 - subfunction number
 529 
  * ebx = 3 - subfunction number
530 
Returned value:
 530 
Returned value:
531 
  * function does not return value
 531 
  * function does not return value
532 
 
 532 
 
533 
======================================================================
 533 
======================================================================
534 
== Function 15, subfunction 4 - set drawing mode for the background. =
 534 
== Function 15, subfunction 4 - set drawing mode for the background. =
535 
======================================================================
 535 
======================================================================
536 
Parameters:
 536 
Parameters:
537 
  * eax = 15 - function number
 537 
  * eax = 15 - function number
538 
  * ebx = 4 - subfunction number
 538 
  * ebx = 4 - subfunction number
539 
  * ecx = drawing mode:
 539 
  * ecx = drawing mode:
540 
    * 1 = tile
 540 
    * 1 = tile
541 
    * 2 = stretch
 541 
    * 2 = stretch
542 
Returned value:
 542 
Returned value:
543 
  * function does not return value
 543 
  * function does not return value
544 
Remarks:
 544 
Remarks:
545 
  * For update of the screen (after completion of a series of commands
 545 
  * For update of the screen (after completion of a series of commands
546 
    working with a background) call subfunction 3.
 546 
    working with a background) call subfunction 3.
547 
  * There is a pair function for get drawing mode of the background -
 547 
  * There is a pair function for get drawing mode of the background -
548 
    subfunction 4 of function 39.
 548 
    subfunction 4 of function 39.
549 
 
 549 
 
550 
======================================================================
 550 
======================================================================
551 
===================== Function 15, subfunction 5 =====================
 551 
===================== Function 15, subfunction 5 =====================
552 
============ Put block of pixels on the background image. ============
 552 
============ Put block of pixels on the background image. ============
553 
======================================================================
 553 
======================================================================
554 
Parameters:
 554 
Parameters:
555 
  * eax = 15 - function number
 555 
  * eax = 15 - function number
556 
  * ebx = 5 - subfunction number
 556 
  * ebx = 5 - subfunction number
557 
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
 557 
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
558 
  * edx = offset in data of the background image
 558 
  * edx = offset in data of the background image
559 
  * esi = size of data in bytes = 3 * number of pixels
 559 
  * esi = size of data in bytes = 3 * number of pixels
560 
Returned value:
 560 
Returned value:
561 
  * function does not return value
 561 
  * function does not return value
562 
Remarks:
 562 
Remarks:
563 
  * Offset and size are not checked for correctness.
 563 
  * Offset and size are not checked for correctness.
564 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
 564 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
565 
  * Pixels of the background image are written sequentially
 565 
  * Pixels of the background image are written sequentially
566 
    from left to right, from up to down.
 566 
    from left to right, from up to down.
567 
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
 567 
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
568 
  * For update of the screen (after completion of a series of commands
 568 
  * For update of the screen (after completion of a series of commands
569 
    working with a background) call subfunction 3.
 569 
    working with a background) call subfunction 3.
570 
 
 570 
 
571 
======================================================================
 571 
======================================================================
572 
===================== Function 15, subfunction 6 =====================
 572 
===================== Function 15, subfunction 6 =====================
573 
======== Map background data to the address space of process. ========
 573 
======== Map background data to the address space of process. ========
574 
======================================================================
 574 
======================================================================
575 
Parameters:
 575 
Parameters:
576 
  * eax = 15 - function number
 576 
  * eax = 15 - function number
577 
  * ebx = 6 - subfunction number
 577 
  * ebx = 6 - subfunction number
578 
Returned value:
 578 
Returned value:
579 
  * eax = pointer to background data, 0 if error
 579 
  * eax = pointer to background data, 0 if error
580 
Remarks:
 580 
Remarks:
581 
  * Mapped data are available for read and write.
 581 
  * Mapped data are available for read and write.
582 
  * Size of background data is 3*xsize*ysize. The system blocks
 582 
  * Size of background data is 3*xsize*ysize. The system blocks
583 
    changes of background sizes while process works with mapped data.
 583 
    changes of background sizes while process works with mapped data.
584 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
 584 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
585 
  * Pixels of the background image are written sequentially
 585 
  * Pixels of the background image are written sequentially
586 
    from left to right, from up to down.
 586 
    from left to right, from up to down.
587 
 
 587 
 
588 
======================================================================
 588 
======================================================================
589 
===== Function 15, subfunction 7 - close mapped background data. =====
 589 
===== Function 15, subfunction 7 - close mapped background data. =====
590 
======================================================================
 590 
======================================================================
591 
Parameters:
 591 
Parameters:
592 
  * eax = 15 - function number
 592 
  * eax = 15 - function number
593 
  * ebx = 7 - subfunction number
 593 
  * ebx = 7 - subfunction number
594 
  * ecx = pointer to mapped data
 594 
  * ecx = pointer to mapped data
595 
Returned value:
 595 
Returned value:
596 
  * eax = 1 - success, 0 - error
 596 
  * eax = 1 - success, 0 - error
597 
 
 597 
 
598 
======================================================================
 598 
======================================================================
599 
=============== Function 16 - save ramdisk on a floppy. ==============
 599 
=============== Function 16 - save ramdisk on a floppy. ==============
600 
======================================================================
 600 
======================================================================
601 
Parameters:
 601 
Parameters:
602 
  * eax = 16 - function number
 602 
  * eax = 16 - function number
603 
  * ebx = 1 or ebx = 2 - on which floppy save
 603 
  * ebx = 1 or ebx = 2 - on which floppy save
604 
Returned value:
 604 
Returned value:
605 
  * eax = 0 - success
 605 
  * eax = 0 - success
606 
  * eax = 1 - error
 606 
  * eax = 1 - error
607 
 
 607 
 
608 
======================================================================
 608 
======================================================================
609 
======= Function 17 - get the identifier of the pressed button. ======
 609 
======= Function 17 - get the identifier of the pressed button. ======
610 
======================================================================
 610 
======================================================================
611 
Takes away the code of the pressed button from the buffer.
 611 
Takes away the code of the pressed button from the buffer.
612 
Parameters:
 612 
Parameters:
613 
  * eax = 17 - function number
 613 
  * eax = 17 - function number
614 
Returned value:
 614 
Returned value:
615 
  * if the buffer is empty, function returns eax=1
 615 
  * if the buffer is empty, function returns eax=1
616 
  * if the buffer is not empty, function returns al=0,
 616 
  * if the buffer is not empty, function returns al=0,
617 
    high 24 bits of eax contain button identifier (in particular, ah
 617 
    high 24 bits of eax contain button identifier (in particular, ah
618 
    contains low byte of the identifier; if all buttons have
 618 
    contains low byte of the identifier; if all buttons have
619 
    the identifier less than 256, ah is enough to distinguish).
 619 
    the identifier less than 256, ah is enough to distinguish).
620 
Remarks:
 620 
Remarks:
621 
  * "Buffer" keeps only one button, at pressing the new button the
 621 
  * "Buffer" keeps only one button, at pressing the new button the
622 
    information about old is lost.
 622 
    information about old is lost.
623 
  * The call of this function by an application with inactive window
 623 
  * The call of this function by an application with inactive window
624 
    will return answer "buffer is empty".
 624 
    will return answer "buffer is empty".
625 
 
 625 
 
626 
======================================================================
 626 
======================================================================
627 
============ Function 18, subfunction 1 - system shutdown. ===========
 627 
============ Function 18, subfunction 1 - system shutdown. ===========
628 
======================================================================
 628 
======================================================================
629 
Parameters:
 629 
Parameters:
630 
  * eax = 18 - function number
 630 
  * eax = 18 - function number
631 
  * ebx = 1 - subfunction number
 631 
  * ebx = 1 - subfunction number
632 
Returned value:
 632 
Returned value:
633 
  * function always return eax = 0 as tag of success
 633 
  * function always return eax = 0 as tag of success
634 
Remarks:
 634 
Remarks:
635 
  * On the last step menu of exit from the system appears and waits
 635 
  * On the last step menu of exit from the system appears and waits
636 
    response of the user.
 636 
    response of the user.
637 
  * See also subfunction 9, system shutdown with
 637 
  * See also subfunction 9, system shutdown with
638 
    the parameter to force the choice in the exit menu.
 638 
    the parameter to force the choice in the exit menu.
639 
 
 639 
 
640 
======================================================================
 640 
======================================================================
641 
= Function 18, subfunction 2 - terminate process/thread by the slot. =
 641 
= Function 18, subfunction 2 - terminate process/thread by the slot. =
642 
======================================================================
 642 
======================================================================
643 
Parameters:
 643 
Parameters:
644 
  * eax = 18 - function number
 644 
  * eax = 18 - function number
645 
  * ebx = 2 - subfunction number
 645 
  * ebx = 2 - subfunction number
646 
  * ecx = number of the slot of process/thread
 646 
  * ecx = number of the slot of process/thread
647 
Returned value:
 647 
Returned value:
648 
  * function does not return value
 648 
  * function does not return value
649 
Remarks:
 649 
Remarks:
650 
  * It is impossible to terminate system thread OS/IDLE (with
 650 
  * It is impossible to terminate system thread OS/IDLE (with
651 
    number of the slot 1),
 651 
    number of the slot 1),
652 
    it is possible to terminate any normal process/thread.
 652 
    it is possible to terminate any normal process/thread.
653 
  * See also subfunction 18 - terminate
 653 
  * See also subfunction 18 - terminate
654 
    process/thread by the identifier.
 654 
    process/thread by the identifier.
655 
 
 655 
 
656 
======================================================================
 656 
======================================================================
657 
===================== Function 18, subfunction 3 =====================
 657 
===================== Function 18, subfunction 3 =====================
658 
============= Make active the window of the given thread. ============
 658 
============= Make active the window of the given thread. ============
659 
======================================================================
 659 
======================================================================
660 
Parameters:
 660 
Parameters:
661 
  * eax = 18 - function number
 661 
  * eax = 18 - function number
662 
  * ebx = 3 - subfunction number
 662 
  * ebx = 3 - subfunction number
663 
  * ecx = number of the thread slot
 663 
  * ecx = number of the thread slot
664 
Returned value:
 664 
Returned value:
665 
  * function does not return value
 665 
  * function does not return value
666 
Remarks:
 666 
Remarks:
667 
  * If correct, but nonexistent slot is given,
 667 
  * If correct, but nonexistent slot is given,
668 
    some window is made active.
 668 
    some window is made active.
669 
  * To find out, which window is active, use subfunction 7.
 669 
  * To find out, which window is active, use subfunction 7.
670 
 
 670 
 
671 
======================================================================
 671 
======================================================================
672 
===================== Function 18, subfunction 4 =====================
 672 
===================== Function 18, subfunction 4 =====================
673 
=========== Get counter of idle time units per one second. ===========
 673 
=========== Get counter of idle time units per one second. ===========
674 
======================================================================
 674 
======================================================================
675 
Idle time units are units, in which the processor stands idle
 675 
Idle time units are units, in which the processor stands idle
676 
in waiting for interrupt (in the command 'hlt').
 676 
in waiting for interrupt (in the command 'hlt').
677 
 
 677 
 
678 
Parameters:
 678 
Parameters:
679 
  * eax = 18 - function number
 679 
  * eax = 18 - function number
680 
  * ebx = 4 - subfunction number
 680 
  * ebx = 4 - subfunction number
681 
Returned value:
 681 
Returned value:
682 
  * eax = value of the counter of idle time units per one second
 682 
  * eax = value of the counter of idle time units per one second
683 
 
 683 
 
684 
======================================================================
 684 
======================================================================
685 
========== Function 18, subfunction 5 - get CPU clock rate. ==========
 685 
========== Function 18, subfunction 5 - get CPU clock rate. ==========
686 
======================================================================
 686 
======================================================================
687 
Parameters:
 687 
Parameters:
688 
  * eax = 18 - function number
 688 
  * eax = 18 - function number
689 
  * ebx = 5 - subfunction number
 689 
  * ebx = 5 - subfunction number
690 
Returned value:
 690 
Returned value:
691 
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
 691 
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
692 
 
 692 
 
693 
======================================================================
 693 
======================================================================
694 
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
694 
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
695 
======================================================================
 695 
======================================================================
696 
Parameters:
 696 
Parameters:
697 
  * eax = 18 - function number
 697 
  * eax = 18 - function number
698 
  * ebx = 6 - subfunction number
 698 
  * ebx = 6 - subfunction number
699 
  * ecx = pointer to the full path to file
 699 
  * ecx = pointer to the full path to file
700 
    (for example, "/hd0/1/kolibri/kolibri.img")
 700 
    (for example, "/hd0/1/kolibri/kolibri.img")
701 
Returned value:
 701 
Returned value:
702 
  * eax = 0 - success
 702 
  * eax = 0 - success
703 
  * else eax = error code of the file system
 703 
  * else eax = error code of the file system
704 
Remarks:
 704 
Remarks:
705 
  * All folders in the given path must exist, otherwise function
 705 
  * All folders in the given path must exist, otherwise function
706 
    returns value 5, "file not found".
 706 
    returns value 5, "file not found".
707 
 
 707 
 
708 
======================================================================
 708 
======================================================================
709 
=========== Function 18, subfunction 7 - get active window. ==========
 709 
=========== Function 18, subfunction 7 - get active window. ==========
710 
======================================================================
 710 
======================================================================
711 
Parameters:
 711 
Parameters:
712 
  * eax = 18 - function number
 712 
  * eax = 18 - function number
713 
  * ebx = 7 - subfunction number
 713 
  * ebx = 7 - subfunction number
714 
Returned value:
 714 
Returned value:
715 
  * eax = number of the active window
 715 
  * eax = number of the active window
716 
    (number of the slot of the thread with active window)
 716 
    (number of the slot of the thread with active window)
717 
Remarks:
 717 
Remarks:
718 
  * Active window is at the top of the window stack and receives
 718 
  * Active window is at the top of the window stack and receives
719 
    messages on all keyboard input.
 719 
    messages on all keyboard input.
720 
  * To make a window active, use subfunction 3.
 720 
  * To make a window active, use subfunction 3.
721 
 
 721 
 
722 
======================================================================
 722 
======================================================================
723 
== Function 18, subfunction 8 - disable/enable the internal speaker. =
 723 
== Function 18, subfunction 8 - disable/enable the internal speaker. =
724 
======================================================================
 724 
======================================================================
725 
If speaker sound is disabled, all calls to subfunction 55 of
 725 
If speaker sound is disabled, all calls to subfunction 55 of
726 
function 55 are ignored. If speaker sound is enabled,
 726 
function 55 are ignored. If speaker sound is enabled,
727 
they are routed on builtin speaker.
 727 
they are routed on builtin speaker.
728 
 
 728 
 
729 
------------------- Subsubfunction 1 - get status. -------------------
 729 
------------------- Subsubfunction 1 - get status. -------------------
730 
Parameters:
 730 
Parameters:
731 
  * eax = 18 - function number
 731 
  * eax = 18 - function number
732 
  * ebx = 8 - subfunction number
 732 
  * ebx = 8 - subfunction number
733 
  * ecx = 1 - number of the subsubfunction
 733 
  * ecx = 1 - number of the subsubfunction
734 
Returned value:
 734 
Returned value:
735 
  * eax = 0 - speaker sound is enabled; 1 - disabled
 735 
  * eax = 0 - speaker sound is enabled; 1 - disabled
736 
 
 736 
 
737 
----------------- Subsubfunction 2 - toggle status. ------------------
 737 
----------------- Subsubfunction 2 - toggle status. ------------------
738 
Toggles states of disable/enable.
 738 
Toggles states of disable/enable.
739 
Parameters:
 739 
Parameters:
740 
  * eax = 18 - function number
 740 
  * eax = 18 - function number
741 
  * ebx = 8 - subfunction number
 741 
  * ebx = 8 - subfunction number
742 
  * ecx = 2 - number of the subsubfunction
 742 
  * ecx = 2 - number of the subsubfunction
743 
Returned value:
 743 
Returned value:
744 
  * function does not return value
 744 
  * function does not return value
745 
 
 745 
 
746 
======================================================================
 746 
======================================================================
747 
== Function 18, subfunction 9 - system shutdown with the parameter. ==
 747 
== Function 18, subfunction 9 - system shutdown with the parameter. ==
748 
======================================================================
 748 
======================================================================
749 
Parameters:
 749 
Parameters:
750 
  * eax = 18 - function number
 750 
  * eax = 18 - function number
751 
  * ebx = 9 - subfunction number
 751 
  * ebx = 9 - subfunction number
752 
  * ecx = parameter:
 752 
  * ecx = parameter:
753 
    * 1 = on the last step of shutdown save ramdisk on a floppy and
 753 
    * 1 = on the last step of shutdown save ramdisk on a floppy and
754 
      then show the exit menu and request further operations
 754 
      then show the exit menu and request further operations
755 
      from the user
 755 
      from the user
756 
    * 2 = turn off computer
 756 
    * 2 = turn off computer
757 
    * 3 = reboot computer
 757 
    * 3 = reboot computer
758 
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
 758 
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
759 
Returned value:
 759 
Returned value:
760 
  * at incorrect ecx the registers do not change (i.e. eax=18)
 760 
  * at incorrect ecx the registers do not change (i.e. eax=18)
761 
  * by correct call function always returns eax=0
 761 
  * by correct call function always returns eax=0
762 
    as the tag of success
 762 
    as the tag of success
763 
Remarks:
 763 
Remarks:
764 
  * Do not rely on returned value by incorrect call, it can be
 764 
  * Do not rely on returned value by incorrect call, it can be
765 
    changed in future versions of the kernel.
 765 
    changed in future versions of the kernel.
766 
  * It is possible to use subfunction 1, that on the last step
 766 
  * It is possible to use subfunction 1, that on the last step
767 
    the user makes choice himself.
 767 
    the user makes choice himself.
768 
  * It is not recommended to use value ecx=1 (to not irritate the user
 768 
  * It is not recommended to use value ecx=1 (to not irritate the user
769 
    with excessive questions); to save ramdisk on a floppy use
 769 
    with excessive questions); to save ramdisk on a floppy use
770 
    function 16 (which admits specification, on which floppy to
 770 
    function 16 (which admits specification, on which floppy to
771 
    write), and to shutdown with the exit menu use already mentioned
 771 
    write), and to shutdown with the exit menu use already mentioned
772 
    subfunction 1.
 772 
    subfunction 1.
773 
 
 773 
 
774 
======================================================================
 774 
======================================================================
775 
===== Function 18, subfunction 10 - minimize application window. =====
 775 
===== Function 18, subfunction 10 - minimize application window. =====
776 
======================================================================
 776 
======================================================================
777 
Minimizes the own window.
 777 
Minimizes the own window.
778 
Parameters:
 778 
Parameters:
779 
  * eax = 18 - function number
 779 
  * eax = 18 - function number
780 
  * ebx = 10 - subfunction number
 780 
  * ebx = 10 - subfunction number
781 
Returned value:
 781 
Returned value:
782 
  * function does not return value
 782 
  * function does not return value
783 
Remarks:
 783 
Remarks:
784 
  * The minimized window from the point of view of function 9
 784 
  * The minimized window from the point of view of function 9
785 
    keeps position and sizes.
 785 
    keeps position and sizes.
786 
  * Restoring of an application window occurs at its activation by
786 
  * Restoring of an application window occurs at its activation by
787 
    subfunction 3.
 787 
    subfunction 3.
788 
  * Usually there is no necessity to minimize/restire a window
 788 
  * Usually there is no necessity to minimize/restire a window
789 
    obviously: minimization of a window is carried out by the system
 789 
    obviously: minimization of a window is carried out by the system
790 
    at pressing the minimization button (for skinned windows
 790 
    at pressing the minimization button (for skinned windows
791 
    it is defined automatically by function 0,
 791 
    it is defined automatically by function 0,
792 
    for other windows it can be defined manually by function 8),
 792 
    for other windows it can be defined manually by function 8),
793 
    restore of a window is done by the application '@panel'.
 793 
    restore of a window is done by the application '@panel'.
794 
 
 794 
 
795 
======================================================================
 795 
======================================================================
796 
 Function 18, subfunction 11 - get information on the disk subsystem.
796 
 Function 18, subfunction 11 - get information on the disk subsystem.
797 
======================================================================
 797 
======================================================================
798 
Parameters:
 798 
Parameters:
799 
  * eax = 18 - function number
 799 
  * eax = 18 - function number
800 
  * ebx = 11 - subfunction number
 800 
  * ebx = 11 - subfunction number
801 
  * ecx = type of the table:
 801 
  * ecx = type of the table:
802 
    * 1 = short version, 10 bytes
 802 
    * 1 = short version, 10 bytes
803 
    * 2 = full version, 65536 bytes
 803 
    * 2 = full version, 65536 bytes
804 
  * edx = pointer to the buffer (in the application) for the table
 804 
  * edx = pointer to the buffer (in the application) for the table
805 
Returned value:
 805 
Returned value:
806 
  * function does not return value
 806 
  * function does not return value
807 
Format of the table: short version:
 807 
Format of the table: short version:
808 
  * +0: byte: information about FDD's (drives for floppies),
 808 
  * +0: byte: information about FDD's (drives for floppies),
809 
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
 809 
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
810 
    of the second regarding to the following list:
 810 
    of the second regarding to the following list:
811 
    * 0 = there is no drive
 811 
    * 0 = there is no drive
812 
    * 1 = 360Kb, 5.25''
 812 
    * 1 = 360Kb, 5.25''
813 
    * 2 = 1.2Mb, 5.25''
 813 
    * 2 = 1.2Mb, 5.25''
814 
    * 3 = 720Kb, 3.5''
 814 
    * 3 = 720Kb, 3.5''
815 
    * 4 = 1.44Mb, 3.5''
 815 
    * 4 = 1.44Mb, 3.5''
816 
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
 816 
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
817 
    For example, for the standard configuration from one 1.44-drive
 817 
    For example, for the standard configuration from one 1.44-drive
818 
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
 818 
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
819 
    the value is 24h.
 819 
    the value is 24h.
820 
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
 820 
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
821 
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
 821 
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
822 
    * 0 = device is absent
 822 
    * 0 = device is absent
823 
    * 1 = hard drive
 823 
    * 1 = hard drive
824 
    * 2 = CD-drive
 824 
    * 2 = CD-drive
825 
    For example, in the case HD on IDE0 and CD on IDE2
 825 
    For example, in the case HD on IDE0 and CD on IDE2
826 
    this field contains 48h.
 826 
    this field contains 48h.
827 
  * +2: 4 db: number of the retrieved partitions on hard disks
 827 
  * +2: 4 db: number of the retrieved partitions on hard disks
828 
    at accordingly IDE0,...,IDE3.
 828 
    at accordingly IDE0,...,IDE3.
829 
    If the hard disk on IDEx is absent, appropriate byte is zero,
 829 
    If the hard disk on IDEx is absent, appropriate byte is zero,
830 
    otherwise it shows number of the recognized partitions, which
 830 
    otherwise it shows number of the recognized partitions, which
831 
    can be not presented (if the drive is not formatted or if
 831 
    can be not presented (if the drive is not formatted or if
832 
    the file system is not supported). Current version of the kernel
 832 
    the file system is not supported). Current version of the kernel
833 
    supports only FAT16, FAT32 and NTFS for hard disks.
 833 
    supports only FAT16, FAT32 and NTFS for hard disks.
834 
  * +6: 4 db: reserved
 834 
  * +6: 4 db: reserved
835 
Format of the table: full version:
 835 
Format of the table: full version:
836 
  * +0: 10 db: same as for the short version
 836 
  * +0: 10 db: same as for the short version
837 
  * +10: 100 db: data for the first partition
 837 
  * +10: 100 db: data for the first partition
838 
  * +110: 100 db: data for the second partition
 838 
  * +110: 100 db: data for the second partition
839 
  * ...
 839 
  * ...
840 
  * +10+100*(n-1): 100 db: data for the last partition
 840 
  * +10+100*(n-1): 100 db: data for the last partition
841 
The partitions are located as follows: at first sequentially all
 841 
The partitions are located as follows: at first sequentially all
842 
recoginzed partitions on HD on IDE0 (if present),
 842 
recoginzed partitions on HD on IDE0 (if present),
843 
then on HD on IDE1 (if present) and so on up to IDE3.
 843 
then on HD on IDE1 (if present) and so on up to IDE3.
844 
Format of the information about partition
 844 
Format of the information about partition
845 
(at moment only FAT is supported):
 845 
(at moment only FAT is supported):
846 
  * +0: dword: first physical sector of the partition
 846 
  * +0: dword: first physical sector of the partition
847 
  * +4: dword: last physical sector of the partition
 847 
  * +4: dword: last physical sector of the partition
848 
    (belongs to the partition)
 848 
    (belongs to the partition)
849 
  * +8: byte: file system type:
 849 
  * +8: byte: file system type:
850 
    16=FAT16, 32=FAT32, 1=NTFS
 850 
    16=FAT16, 32=FAT32, 1=NTFS
851 
  * other data are dependent on file system, are modified with
 851 
  * other data are dependent on file system, are modified with
852 
    kernel modifications and therefore are not described
 852 
    kernel modifications and therefore are not described
853 
Remarks:
 853 
Remarks:
854 
  * The short table can be used for obtaining the information about
 854 
  * The short table can be used for obtaining the information about
855 
    available devices.
 855 
    available devices.
856 
 
 856 
 
857 
======================================================================
 857 
======================================================================
858 
========== Function 18, subfunction 13 - get kernel version. =========
 858 
========== Function 18, subfunction 13 - get kernel version. =========
859 
======================================================================
 859 
======================================================================
860 
Parameters:
 860 
Parameters:
861 
  * eax = 18 - function number
 861 
  * eax = 18 - function number
862 
  * ebx = 13 - subfunction number
 862 
  * ebx = 13 - subfunction number
863 
  * ecx = pointer to the buffer (not less than 16 bytes), where
 863 
  * ecx = pointer to the buffer (not less than 16 bytes), where
864 
    the information will be placed
 864 
    the information will be placed
865 
Returned value:
 865 
Returned value:
866 
  * function does not return value
 866 
  * function does not return value
867 
Structure of the buffer:
 867 
Structure of the buffer:
868 
db a,b,c,d for version a.b.c.d
 868 
db a,b,c,d for version a.b.c.d
869 
db UID_xxx: one of UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
 869 
db UID_xxx: one of UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
870 
dd REV - kernel SVN revision number
 870 
dd REV - kernel SVN revision number
871 
For Kolibri 0.7.0.0 kernel:
 871 
For Kolibri 0.7.0.0 kernel:
872 
db 0,7,0,0
 872 
db 0,7,0,0
873 
db 2
 873 
db 2
874 
dd 533
 874 
dd 533
875 
 
 875 
 
876 
======================================================================
 876 
======================================================================
877 
======= Function 18, subfunction 14 - wait for screen retrace. =======
 877 
======= Function 18, subfunction 14 - wait for screen retrace. =======
878 
======================================================================
 878 
======================================================================
879 
Waits for the beginning of retrace of the scanning ray of the screen
 879 
Waits for the beginning of retrace of the scanning ray of the screen
880 
monitor.
 880 
monitor.
881 
Parameters:
 881 
Parameters:
882 
  * eax = 18 - function number
 882 
  * eax = 18 - function number
883 
  * ebx = 14 - subfunction number
 883 
  * ebx = 14 - subfunction number
884 
Returned value:
 884 
Returned value:
885 
  * eax = 0 as the tag of success
 885 
  * eax = 0 as the tag of success
886 
Remarks:
 886 
Remarks:
887 
  * Function is intended only for active high-efficiency graphics
 887 
  * Function is intended only for active high-efficiency graphics
888 
    applications; is used for smooth output of a graphics.
 888 
    applications; is used for smooth output of a graphics.
889 
 
 889 
 
890 
======================================================================
 890 
======================================================================
891 
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
 891 
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
892 
======================================================================
 892 
======================================================================
893 
Parameters:
 893 
Parameters:
894 
  * eax = 18 - function number
 894 
  * eax = 18 - function number
895 
  * ebx = 15 - subfunction number
 895 
  * ebx = 15 - subfunction number
896 
Returned value:
 896 
Returned value:
897 
  * eax = 0 as the tag of success
 897 
  * eax = 0 as the tag of success
898 
 
 898 
 
899 
======================================================================
 899 
======================================================================
900 
========= Function 18, subfunction 16 - get size of free RAM. ========
 900 
========= Function 18, subfunction 16 - get size of free RAM. ========
901 
======================================================================
 901 
======================================================================
902 
Parameters:
 902 
Parameters:
903 
  * eax = 18 - function number
 903 
  * eax = 18 - function number
904 
  * ebx = 16 - subfunction number
 904 
  * ebx = 16 - subfunction number
905 
Returned value:
 905 
Returned value:
906 
  * eax = size of free memory in kilobytes
 906 
  * eax = size of free memory in kilobytes
907 
 
 907 
 
908 
======================================================================
 908 
======================================================================
909 
======== Function 18, subfunction 17 - get full amount of RAM. =======
 909 
======== Function 18, subfunction 17 - get full amount of RAM. =======
910 
======================================================================
 910 
======================================================================
911 
Parameters:
 911 
Parameters:
912 
  * eax = 18 - function number
 912 
  * eax = 18 - function number
913 
  * ebx = 17 - subfunction number
 913 
  * ebx = 17 - subfunction number
914 
Returned value:
 914 
Returned value:
915 
  * eax = total size of existing memory in kilobytes
 915 
  * eax = total size of existing memory in kilobytes
916 
 
 916 
 
917 
======================================================================
 917 
======================================================================
918 
===================== Function 18, subfunction 18 ====================
 918 
===================== Function 18, subfunction 18 ====================
919 
============= Terminate process/thread by the identifier. ============
 919 
============= Terminate process/thread by the identifier. ============
920 
======================================================================
 920 
======================================================================
921 
Parameters:
 921 
Parameters:
922 
  * eax = 18 - function number
 922 
  * eax = 18 - function number
923 
  * ebx = 18 - subfunction number
 923 
  * ebx = 18 - subfunction number
924 
  * ecx = identifer of process/thread (PID/TID)
 924 
  * ecx = identifer of process/thread (PID/TID)
925 
Returned value:
 925 
Returned value:
926 
  * eax = 0 - success
 926 
  * eax = 0 - success
927 
  * eax = -1 - error (process is not found or is system)
 927 
  * eax = -1 - error (process is not found or is system)
928 
Remarks:
 928 
Remarks:
929 
  * It is impossible to terminate system thread OS/IDLE (identifier
 929 
  * It is impossible to terminate system thread OS/IDLE (identifier
930 
    1), it is possible to terminate any normal process/thread.
 930 
    1), it is possible to terminate any normal process/thread.
931 
  * See also subfunction 2 - terminate
 931 
  * See also subfunction 2 - terminate
932 
    process/thread by given slot.
 932 
    process/thread by given slot.
933 
 
 933 
 
934 
======================================================================
 934 
======================================================================
935 
======== Function 18, subfunction 19 - get/set mouse features. =======
 935 
======== Function 18, subfunction 19 - get/set mouse features. =======
936 
======================================================================
 936 
======================================================================
937 
 
 937 
 
938 
---------------- Subsubfunction 0 - get mouse speed. -----------------
 938 
---------------- Subsubfunction 0 - get mouse speed. -----------------
939 
Parameters:
 939 
Parameters:
940 
  * eax = 18 - function number
 940 
  * eax = 18 - function number
941 
  * ebx = 19 - subfunction number
 941 
  * ebx = 19 - subfunction number
942 
  * ecx = 0 - subsubfunction number
 942 
  * ecx = 0 - subsubfunction number
943 
Returned value:
 943 
Returned value:
944 
  * eax = current mouse speed
 944 
  * eax = current mouse speed
945 
 
 945 
 
946 
---------------- Subsubfunction 1 - set mouse speed. -----------------
 946 
---------------- Subsubfunction 1 - set mouse speed. -----------------
947 
Parameters:
 947 
Parameters:
948 
  * eax = 18 - function number
 948 
  * eax = 18 - function number
949 
  * ebx = 19 - subfunction number
 949 
  * ebx = 19 - subfunction number
950 
  * ecx = 1 - subsubfunction number
 950 
  * ecx = 1 - subsubfunction number
951 
  * edx = new value for speed
 951 
  * edx = new value for speed
952 
Returned value:
 952 
Returned value:
953 
  * function does not return value
 953 
  * function does not return value
954 
 
 954 
 
955 
---------------- Subsubfunction 2 - get mouse delay. -----------------
 955 
---------------- Subsubfunction 2 - get mouse delay. -----------------
956 
Parameters:
 956 
Parameters:
957 
  * eax = 18 - function number
 957 
  * eax = 18 - function number
958 
  * ebx = 19 - subfunction number
 958 
  * ebx = 19 - subfunction number
959 
  * ecx = 2 - subsubfunction number
 959 
  * ecx = 2 - subsubfunction number
960 
Returned value:
 960 
Returned value:
961 
  * eax = current mouse delay
 961 
  * eax = current mouse delay
962 
 
 962 
 
963 
---------------- Subsubfunction 3 - set mouse delay. -----------------
 963 
---------------- Subsubfunction 3 - set mouse delay. -----------------
964 
Parameters:
 964 
Parameters:
965 
  * eax = 18 - function number
 965 
  * eax = 18 - function number
966 
  * ebx = 19 - subfunction number
 966 
  * ebx = 19 - subfunction number
967 
  * ecx = 3 - subsubfunction number
 967 
  * ecx = 3 - subsubfunction number
968 
  * edx = new value for mouse delay
 968 
  * edx = new value for mouse delay
969 
Returned value:
 969 
Returned value:
970 
  * function does not return value
 970 
  * function does not return value
971 
 
 971 
 
972 
----------- Subsubfunction 4 - set mouse pointer position. -----------
 972 
----------- Subsubfunction 4 - set mouse pointer position. -----------
973 
Parameters:
 973 
Parameters:
974 
  * eax = 18 - function number
 974 
  * eax = 18 - function number
975 
  * ebx = 19 - subfunction number
 975 
  * ebx = 19 - subfunction number
976 
  * ecx = 4 - subsubfunction number
 976 
  * ecx = 4 - subsubfunction number
977 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 977 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
978 
Returned value:
 978 
Returned value:
979 
  * function does not return value
 979 
  * function does not return value
980 
Remarks:
 980 
Remarks:
981 
  * It is recommended to set speed of the mouse (in subsubfunction 1)
 981 
  * It is recommended to set speed of the mouse (in subsubfunction 1)
982 
    from 1 up to 9. The installed value is not inspected by the kernel
 982 
    from 1 up to 9. The installed value is not inspected by the kernel
983 
    code, so set it carefully, at incorrect value the cursor
 983 
    code, so set it carefully, at incorrect value the cursor
984 
    can "freeze". Speed of the mouse can be regulated through the
 984 
    can "freeze". Speed of the mouse can be regulated through the
985 
    application SETUP.
 985 
    application SETUP.
986 
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
 986 
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
987 
    value is not handled by COM mice. At the very large values the
 987 
    value is not handled by COM mice. At the very large values the
988 
    movement of the mouse on 1 pixel is impossible and the cursor will
 988 
    movement of the mouse on 1 pixel is impossible and the cursor will
989 
    jump on the value of installed speed (subsubfunction 1). The
 989 
    jump on the value of installed speed (subsubfunction 1). The
990 
    installed value is not inspected by the kernel code.
 990 
    installed value is not inspected by the kernel code.
991 
    Mouse delay can be regulated through the application SETUP.
 991 
    Mouse delay can be regulated through the application SETUP.
992 
  * The subsubfunction 4 does not check the passed value. Before
 992 
  * The subsubfunction 4 does not check the passed value. Before
993 
    its call find out current screen resolution (with function 14)
 993 
    its call find out current screen resolution (with function 14)
994 
    and check that the value of position is inside the limits of the
 994 
    and check that the value of position is inside the limits of the
995 
    screen.
 995 
    screen.
996 
 
 996 
 
997 
======================================================================
 997 
======================================================================
998 
======== Function 18, subfunction 20 - get information on RAM. =======
 998 
======== Function 18, subfunction 20 - get information on RAM. =======
999 
======================================================================
 999 
======================================================================
1000 
Parameters:
 1000 
Parameters:
1001 
  * eax = 18 - function number
 1001 
  * eax = 18 - function number
1002 
  * ebx = 20 - subfunction number
 1002 
  * ebx = 20 - subfunction number
1003 
  * ecx = pointer to the buffer for information (36 bytes)
 1003 
  * ecx = pointer to the buffer for information (36 bytes)
1004 
Returned value:
 1004 
Returned value:
1005 
  * eax = total size of existing RAM in pages
 1005 
  * eax = total size of existing RAM in pages
1006 
    or -1 if error has occured
 1006 
    or -1 if error has occured
1007 
  * buffer pointed to by ecx contains the following information:
 1007 
  * buffer pointed to by ecx contains the following information:
1008 
    * +0:  dword: total size of existing RAM in pages
 1008 
    * +0:  dword: total size of existing RAM in pages
1009 
    * +4:  dword: size of free RAM in pages
 1009 
    * +4:  dword: size of free RAM in pages
1010 
    * +8:  dword: number of page faults (exceptions #PF)
 1010 
    * +8:  dword: number of page faults (exceptions #PF)
1011 
                 in applications
 1011 
                 in applications
1012 
    * +12: dword: size of kernel heap in bytes
 1012 
    * +12: dword: size of kernel heap in bytes
1013 
    * +16: dword: free in kernel heap in bytes
 1013 
    * +16: dword: free in kernel heap in bytes
1014 
    * +20: dword: total number of memory blocks in kernel heap
 1014 
    * +20: dword: total number of memory blocks in kernel heap
1015 
    * +24: dword: number of free memory blocks in kernel heap
 1015 
    * +24: dword: number of free memory blocks in kernel heap
1016 
    * +28: dword: size of maximum free block in kernel heap
 1016 
    * +28: dword: size of maximum free block in kernel heap
1017 
                 (reserved)
 1017 
                 (reserved)
1018 
    * +32: dword: size of maximum allocated block in kernel heap
 1018 
    * +32: dword: size of maximum allocated block in kernel heap
1019 
                 (reserved)
 1019 
                 (reserved)
1020 
 
 1020 
 
1021 
======================================================================
 1021 
======================================================================
1022 
==================== Function 20 - MIDI interface. ===================
 1022 
==================== Function 20 - MIDI interface. ===================
1023 
======================================================================
 1023 
======================================================================
1024 
 
 1024 
 
1025 
----------------------- Subfunction 1 - reset ------------------------
 1025 
----------------------- Subfunction 1 - reset ------------------------
1026 
Parameters:
 1026 
Parameters:
1027 
  * eax = 20 - function number
 1027 
  * eax = 20 - function number
1028 
  * ebx = 1 - subfunction number
 1028 
  * ebx = 1 - subfunction number
1029 
 
 1029 
 
1030 
-------------------- Subfunction 2 - output byte ---------------------
 1030 
-------------------- Subfunction 2 - output byte ---------------------
1031 
Parameters:
 1031 
Parameters:
1032 
  * eax = 20 - function number
 1032 
  * eax = 20 - function number
1033 
  * ebx = 2 - subfunction number
 1033 
  * ebx = 2 - subfunction number
1034 
  * cl = byte for output
 1034 
  * cl = byte for output
1035 
Returned value (is the same for both subfunctions):
 1035 
Returned value (is the same for both subfunctions):
1036 
  * eax = 0 - success
 1036 
  * eax = 0 - success
1037 
  * eax = 1 - base port is not defined
 1037 
  * eax = 1 - base port is not defined
1038 
Remarks:
 1038 
Remarks:
1039 
  * Previously the base port must be defined by
1039 
  * Previously the base port must be defined by
1040 
    subfunction 1 of function 21.
 1040 
    subfunction 1 of function 21.
1041 
 
 1041 
 
1042 
======================================================================
 1042 
======================================================================
1043 
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
 1043 
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
1044 
======================================================================
 1044 
======================================================================
1045 
Parameters:
 1045 
Parameters:
1046 
  * eax = 21 - function number
 1046 
  * eax = 21 - function number
1047 
  * ebx = 1 - subfunction number
 1047 
  * ebx = 1 - subfunction number
1048 
  * ecx = number of base port
 1048 
  * ecx = number of base port
1049 
Returned value
 1049 
Returned value
1050 
  * eax = 0 - success
 1050 
  * eax = 0 - success
1051 
  * eax = -1 - erratic number of a port
 1051 
  * eax = -1 - erratic number of a port
1052 
Remarks:
 1052 
Remarks:
1053 
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
 1053 
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
1054 
  * The installation of base is necessary for function 20.
 1054 
  * The installation of base is necessary for function 20.
1055 
  * To get base port use subfunction 1 of function 26.
 1055 
  * To get base port use subfunction 1 of function 26.
1056 
 
 1056 
 
1057 
======================================================================
 1057 
======================================================================
1058 
========== Function 21, subfunction 2 - set keyboard layout. =========
 1058 
========== Function 21, subfunction 2 - set keyboard layout. =========
1059 
======================================================================
 1059 
======================================================================
1060 
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
 1060 
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
1061 
which will be read by function 2.
 1061 
which will be read by function 2.
1062 
Parameters:
 1062 
Parameters:
1063 
  * eax = 21 - function number
 1063 
  * eax = 21 - function number
1064 
  * ebx = 2 - subfunction number
 1064 
  * ebx = 2 - subfunction number
1065 
  * ecx = which layout to set:
 1065 
  * ecx = which layout to set:
1066 
    * 1 = normal layout
 1066 
    * 1 = normal layout
1067 
    * 2 = layout at pressed Shift
 1067 
    * 2 = layout at pressed Shift
1068 
    * 3 = layout at pressed Alt
 1068 
    * 3 = layout at pressed Alt
1069 
  * edx = pointer to layout - table of length 128 bytes
 1069 
  * edx = pointer to layout - table of length 128 bytes
1070 
Or:
 1070 
Or:
1071 
  * ecx = 9
 1071 
  * ecx = 9
1072 
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
 1072 
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1073 
Returned value:
 1073 
Returned value:
1074 
  * eax = 0 - success
 1074 
  * eax = 0 - success
1075 
  * eax = 1 - incorrect parameter
 1075 
  * eax = 1 - incorrect parameter
1076 
Remarks:
 1076 
Remarks:
1077 
  * If Alt is pressed, the layout with Alt is used;
 1077 
  * If Alt is pressed, the layout with Alt is used;
1078 
    if Alt is not pressed, but Shift is pressed,
 1078 
    if Alt is not pressed, but Shift is pressed,
1079 
    the layout with Shift is used;
 1079 
    the layout with Shift is used;
1080 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
 1080 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1081 
    layout is used and then from the code is subtracted 0x60;
 1081 
    layout is used and then from the code is subtracted 0x60;
1082 
    if no control key is pressed, the normal layout is used.
 1082 
    if no control key is pressed, the normal layout is used.
1083 
  * To get layout and country identifier use
1083 
  * To get layout and country identifier use
1084 
    subfunction 2 of function 26.
 1084 
    subfunction 2 of function 26.
1085 
  * Country identifier is global system variable, which is not used
 1085 
  * Country identifier is global system variable, which is not used
1086 
    by the kernel itself; however the application '@panel' displays
 1086 
    by the kernel itself; however the application '@panel' displays
1087 
    the corresponding icon.
 1087 
    the corresponding icon.
1088 
  * The application @panel switches layouts on user request.
 1088 
  * The application @panel switches layouts on user request.
1089 
 
 1089 
 
1090 
======================================================================
 1090 
======================================================================
1091 
============== Function 21, subfunction 3 - set CD base. =============
 1091 
============== Function 21, subfunction 3 - set CD base. =============
1092 
======================================================================
 1092 
======================================================================
1093 
Parameters:
 1093 
Parameters:
1094 
  * eax = 21 - function number
 1094 
  * eax = 21 - function number
1095 
  * ebx = 3 - subfunction number
 1095 
  * ebx = 3 - subfunction number
1096 
  * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1096 
  * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1097 
Returned value:
 1097 
Returned value:
1098 
  * eax = 0
 1098 
  * eax = 0
1099 
Remarks:
 1099 
Remarks:
1100 
  * CD base is used by function 24.
 1100 
  * CD base is used by function 24.
1101 
  * To get CD base use subfunction 3 of function 26.
 1101 
  * To get CD base use subfunction 3 of function 26.
1102 
 
 1102 
 
1103 
======================================================================
 1103 
======================================================================
1104 
====== Function 21, subfunction 4 - set Sound Blaster base port. =====
 1104 
====== Function 21, subfunction 4 - set Sound Blaster base port. =====
1105 
======================================================================
 1105 
======================================================================
1106 
Parameters:
 1106 
Parameters:
1107 
  * eax = 21 - function number
 1107 
  * eax = 21 - function number
1108 
  * ebx = 4 - subfunction number
 1108 
  * ebx = 4 - subfunction number
1109 
  * ecx = number of the base port
 1109 
  * ecx = number of the base port
1110 
Returned value:
 1110 
Returned value:
1111 
  * eax = 0 - success
 1111 
  * eax = 0 - success
1112 
  * eax = -1 - erratic port number
 1112 
  * eax = -1 - erratic port number
1113 
Remarks:
 1113 
Remarks:
1114 
  * Number of the port must satisfy to conditions 0x100<=ecx<=0xFFFF.
 1114 
  * Number of the port must satisfy to conditions 0x100<=ecx<=0xFFFF.
1115 
  * The installation of the base is necessary for
 1115 
  * The installation of the base is necessary for
1116 
    functions 25, 28, 55.
 1116 
    functions 25, 28, 55.
1117 
  * To get base port use subfunction 4 of function 26.
 1117 
  * To get base port use subfunction 4 of function 26.
1118 
 
 1118 
 
1119 
======================================================================
 1119 
======================================================================
1120 
========== Function 21, subfunction 5 - set system language. =========
 1120 
========== Function 21, subfunction 5 - set system language. =========
1121 
======================================================================
 1121 
======================================================================
1122 
Parameters:
 1122 
Parameters:
1123 
  * eax = 21 - function number
 1123 
  * eax = 21 - function number
1124 
  * ebx = 5 - subfunction number
 1124 
  * ebx = 5 - subfunction number
1125 
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
 1125 
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
1126 
Returned value:
 1126 
Returned value:
1127 
  * eax = 0
 1127 
  * eax = 0
1128 
Remarks:
 1128 
Remarks:
1129 
  * System language is global system variable and is not used
 1129 
  * System language is global system variable and is not used
1130 
    by the kernel itself, however application @panel draws the
 1130 
    by the kernel itself, however application @panel draws the
1131 
    appropriate icon.
 1131 
    appropriate icon.
1132 
  * Function does not check for correctness, as the kernel does not
 1132 
  * Function does not check for correctness, as the kernel does not
1133 
    use this variable.
 1133 
    use this variable.
1134 
  * To get system language use subfunction 5 of function 26.
 1134 
  * To get system language use subfunction 5 of function 26.
1135 
 
 1135 
 
1136 
======================================================================
 1136 
======================================================================
1137 
============== Function 21, subfunction 7 - set HD base. =============
 1137 
============== Function 21, subfunction 7 - set HD base. =============
1138 
======================================================================
 1138 
======================================================================
1139 
The HD base defines hard disk to write with usage of obsolete
 1139 
The HD base defines hard disk to write with usage of obsolete
1140 
syntax /HD in obsolete function 58; at usage of modern syntax
 1140 
syntax /HD in obsolete function 58; at usage of modern syntax
1141 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
 1141 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1142 
Parameters:
 1142 
Parameters:
1143 
  * eax = 21 - function number
 1143 
  * eax = 21 - function number
1144 
  * ebx = 7 - subfunction number
 1144 
  * ebx = 7 - subfunction number
1145 
  * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1145 
  * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1146 
Returned value:
 1146 
Returned value:
1147 
  * eax = 0
 1147 
  * eax = 0
1148 
Remarks:
 1148 
Remarks:
1149 
  * Any application at any time can change the base.
 1149 
  * Any application at any time can change the base.
1150 
  * Do not change base, when any application works with hard disk.
 1150 
  * Do not change base, when any application works with hard disk.
1151 
    If you do not want system bugs.
 1151 
    If you do not want system bugs.
1152 
  * To get HD base use subfunction 7 of function 26.
 1152 
  * To get HD base use subfunction 7 of function 26.
1153 
  * It is also necessary to define used partition of hard disk by
1153 
  * It is also necessary to define used partition of hard disk by
1154 
    subfunction 8.
 1154 
    subfunction 8.
1155 
 
 1155 
 
1156 
======================================================================
 1156 
======================================================================
1157 
========= Function 21, subfunction 8 - set used HD partition. ========
 1157 
========= Function 21, subfunction 8 - set used HD partition. ========
1158 
======================================================================
 1158 
======================================================================
1159 
The HD partition defines partition of the hard disk to write with
 1159 
The HD partition defines partition of the hard disk to write with
1160 
usage of obsolete syntax /HD and obsolete function 58;
 1160 
usage of obsolete syntax /HD and obsolete function 58;
1161 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
 1161 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1162 
base and partition are set automatically.
 1162 
base and partition are set automatically.
1163 
Parameters:
 1163 
Parameters:
1164 
  * eax = 21 - function number
 1164 
  * eax = 21 - function number
1165 
  * ebx = 8 - subfunction number
 1165 
  * ebx = 8 - subfunction number
1166 
  * ecx = HD partition (beginning from 1)
 1166 
  * ecx = HD partition (beginning from 1)
1167 
Return value:
 1167 
Return value:
1168 
  * eax = 0
 1168 
  * eax = 0
1169 
Remarks:
 1169 
Remarks:
1170 
  * Any application at any time can change partition.
 1170 
  * Any application at any time can change partition.
1171 
  * Do not change partition when any application works with hard disk.
 1171 
  * Do not change partition when any application works with hard disk.
1172 
    If you do not want system bugs.
 1172 
    If you do not want system bugs.
1173 
  * To get used partition use subfunction 8 of function 26.
 1173 
  * To get used partition use subfunction 8 of function 26.
1174 
  * There is no correctness checks.
 1174 
  * There is no correctness checks.
1175 
  * To get the number of partitions of a hard disk use
1175 
  * To get the number of partitions of a hard disk use
1176 
    subfunction 11 of function 18.
 1176 
    subfunction 11 of function 18.
1177 
  * It is also necessary to define used HD base by subfunction 7.
 1177 
  * It is also necessary to define used HD base by subfunction 7.
1178 
 
 1178 
 
1179 
======================================================================
 1179 
======================================================================
1180 
======== Function 21, subfunction 10 - set sound DMA channel. ========
 1180 
======== Function 21, subfunction 10 - set sound DMA channel. ========
1181 
======================================================================
 1181 
======================================================================
1182 
Parameters:
 1182 
Parameters:
1183 
  * eax = 21 - function number
 1183 
  * eax = 21 - function number
1184 
  * ebx = 10 - subfunction number
 1184 
  * ebx = 10 - subfunction number
1185 
  * ecx = number of channel (from 0 up to 3 inclusively)
 1185 
  * ecx = number of channel (from 0 up to 3 inclusively)
1186 
Returned value:
 1186 
Returned value:
1187 
  * eax = 0 - success
 1187 
  * eax = 0 - success
1188 
  * eax = -1 - incorrect channel number
 1188 
  * eax = -1 - incorrect channel number
1189 
Remarks:
 1189 
Remarks:
1190 
  * Number of DMA channel is used in subfunction 1 of function 55.
 1190 
  * Number of DMA channel is used in subfunction 1 of function 55.
1191 
  * To get sound DMA channel use subfunction 10 of function 26.
 1191 
  * To get sound DMA channel use subfunction 10 of function 26.
1192 
 
 1192 
 
1193 
======================================================================
 1193 
======================================================================
1194 
 Function 21, subfunction 11 - enable/disable low-level access to HD.
1194 
 Function 21, subfunction 11 - enable/disable low-level access to HD.
1195 
======================================================================
 1195 
======================================================================
1196 
Parameters:
 1196 
Parameters:
1197 
  * eax = 21 - function number
 1197 
  * eax = 21 - function number
1198 
  * ebx = 11 - subfunction number
 1198 
  * ebx = 11 - subfunction number
1199 
  * ecx = 0/1 - disable/enable
 1199 
  * ecx = 0/1 - disable/enable
1200 
Returned value:
 1200 
Returned value:
1201 
  * eax = 0
 1201 
  * eax = 0
1202 
Remarks:
 1202 
Remarks:
1203 
  * Is used in LBA-read (subfunction 8 of function 58).
 1203 
  * Is used in LBA-read (subfunction 8 of function 58).
1204 
  * The current implementation uses only low bit of ecx.
 1204 
  * The current implementation uses only low bit of ecx.
1205 
  * To get current status use subfunction 11 of function 26.
 1205 
  * To get current status use subfunction 11 of function 26.
1206 
 
 1206 
 
1207 
======================================================================
 1207 
======================================================================
1208 
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
1208 
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
1209 
======================================================================
 1209 
======================================================================
1210 
Parameters:
 1210 
Parameters:
1211 
  * eax = 21 - function number
 1211 
  * eax = 21 - function number
1212 
  * ebx = 12 - subfunction number
 1212 
  * ebx = 12 - subfunction number
1213 
  * ecx = 0/1 - disable/enable
 1213 
  * ecx = 0/1 - disable/enable
1214 
Returned value:
 1214 
Returned value:
1215 
  * eax = 0
 1215 
  * eax = 0
1216 
Remarks:
 1216 
Remarks:
1217 
  * Is used in operations with PCI bus (function 62).
 1217 
  * Is used in operations with PCI bus (function 62).
1218 
  * The current implementation uses only low bit of ecx.
 1218 
  * The current implementation uses only low bit of ecx.
1219 
  * To get current status use subfunction 12 of function 26.
 1219 
  * To get current status use subfunction 12 of function 26.
1220 
 
 1220 
 
1221 
======================================================================
 1221 
======================================================================
1222 
============ Function 21, subfunction 13, subsubfunction 1 ===========
 1222 
============ Function 21, subfunction 13, subsubfunction 1 ===========
1223 
======== Initialize + get information on the driver vmode.mdr. =======
 1223 
======== Initialize + get information on the driver vmode.mdr. =======
1224 
======================================================================
 1224 
======================================================================
1225 
Parameters:
 1225 
Parameters:
1226 
  * eax = 21 - function number
 1226 
  * eax = 21 - function number
1227 
  * ebx = 13 - subfunction number
 1227 
  * ebx = 13 - subfunction number
1228 
  * ecx = 1 - number of the driver function
 1228 
  * ecx = 1 - number of the driver function
1229 
  * edx = pointer to 512-bytes buffer
 1229 
  * edx = pointer to 512-bytes buffer
1230 
Returned value:
 1230 
Returned value:
1231 
  * if driver is not loaded
 1231 
  * if driver is not loaded
1232 
    (never happens in the current implementation):
 1232 
    (never happens in the current implementation):
1233 
    * eax = -1
 1233 
    * eax = -1
1234 
    * ebx, ecx destroyed
 1234 
    * ebx, ecx destroyed
1235 
  * if driver is loaded:
 1235 
  * if driver is loaded:
1236 
    * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high)
 1236 
    * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high)
1237 
      - signature
 1237 
      - signature
1238 
    * ebx = current frequency of the scanning (in Hz)
 1238 
    * ebx = current frequency of the scanning (in Hz)
1239 
    * ecx destroyed
 1239 
    * ecx destroyed
1240 
    * buffer pointed to by edx is filled
 1240 
    * buffer pointed to by edx is filled
1241 
Format of the buffer:
 1241 
Format of the buffer:
1242 
  * +0: 32*byte: driver name, "Trans VideoDriver"
 1242 
  * +0: 32*byte: driver name, "Trans VideoDriver"
1243 
    (without quotes, supplemented by spaces)
 1243 
    (without quotes, supplemented by spaces)
1244 
  * +32 = +0x20: dword: driver version (version x.y is encoded as
 1244 
  * +32 = +0x20: dword: driver version (version x.y is encoded as
1245 
    y*65536+x), for the current implementation is 1 (1.0)
 1245 
    y*65536+x), for the current implementation is 1 (1.0)
1246 
  * +36 = +0x24: 7*dword: reserved (0 in the current implementation)
 1246 
  * +36 = +0x24: 7*dword: reserved (0 in the current implementation)
1247 
  * +64 = +0x40: 32*word: list of supported videomodes (each word
 1247 
  * +64 = +0x40: 32*word: list of supported videomodes (each word
1248 
    is number of a videomode, after list itself there are zeroes)
 1248 
    is number of a videomode, after list itself there are zeroes)
1249 
  * +128 = +0x80: 32*(5*word): list of supported frequences of the
 1249 
  * +128 = +0x80: 32*(5*word): list of supported frequences of the
1250 
    scannings for videomodes: for each videomode listed in the
 1250 
    scannings for videomodes: for each videomode listed in the
1251 
    previous field up to 5 supported frequences are given
 1251 
    previous field up to 5 supported frequences are given
1252 
    (unused positions contain zeroes)
 1252 
    (unused positions contain zeroes)
1253 
Remarks:
 1253 
Remarks:
1254 
  * Function initializes the driver (if it is not initialized yet)
 1254 
  * Function initializes the driver (if it is not initialized yet)
1255 
    and must be called first, before others (otherwise they will do
 1255 
    and must be called first, before others (otherwise they will do
1256 
    nothing and return -1).
 1256 
    nothing and return -1).
1257 
  * The current implementation supports only one frequency
 1257 
  * The current implementation supports only one frequency
1258 
    of the scanning on videomode.
 1258 
    of the scanning on videomode.
1259 
 
 1259 
 
1260 
======================================================================
 1260 
======================================================================
1261 
============ Function 21, subfunction 13, subsubfunction 2 ===========
 1261 
============ Function 21, subfunction 13, subsubfunction 2 ===========
1262 
================ Get information on current videomode. ===============
 1262 
================ Get information on current videomode. ===============
1263 
======================================================================
 1263 
======================================================================
1264 
Parameters:
 1264 
Parameters:
1265 
  * eax = 21 - function number
 1265 
  * eax = 21 - function number
1266 
  * ebx = 13 - subfunction number
 1266 
  * ebx = 13 - subfunction number
1267 
  * ecx = 2 - number of the driver function
 1267 
  * ecx = 2 - number of the driver function
1268 
Returned value:
 1268 
Returned value:
1269 
  * eax = -1 - driver is not loaded or not initialized;
 1269 
  * eax = -1 - driver is not loaded or not initialized;
1270 
    ebx,ecx are destroyed
 1270 
    ebx,ecx are destroyed
1271 
  * eax = [width]*65536 + [height]
 1271 
  * eax = [width]*65536 + [height]
1272 
  * ebx = frequency of the vertical scanning (in Hz)
 1272 
  * ebx = frequency of the vertical scanning (in Hz)
1273 
  * ecx = number of current videomode
 1273 
  * ecx = number of current videomode
1274 
Remarks:
 1274 
Remarks:
1275 
  * Driver must be initialized by call to
1275 
  * Driver must be initialized by call to
1276 
    driver function 1.
 1276 
    driver function 1.
1277 
  * If only screen sizes are required, it is more expedient to use
 1277 
  * If only screen sizes are required, it is more expedient to use
1278 
    function 14 taking into account that it
 1278 
    function 14 taking into account that it
1279 
    returns sizes on 1 less.
 1279 
    returns sizes on 1 less.
1280 
 
 1280 
 
1281 
======================================================================
 1281 
======================================================================
1282 
=== Function 21, subfunction 13, subsubfunction 3 - set videomode. ===
 1282 
=== Function 21, subfunction 13, subsubfunction 3 - set videomode. ===
1283 
======================================================================
 1283 
======================================================================
1284 
Parameters:
 1284 
Parameters:
1285 
  * eax = 21 - function number
 1285 
  * eax = 21 - function number
1286 
  * ebx = 13 - subfunction number
 1286 
  * ebx = 13 - subfunction number
1287 
  * ecx = 3 - number of the driver function
 1287 
  * ecx = 3 - number of the driver function
1288 
  * edx = [scanning frequency]*65536 + [videomode number]
 1288 
  * edx = [scanning frequency]*65536 + [videomode number]
1289 
Returned value:
 1289 
Returned value:
1290 
  * eax = -1 - driver is not loaded, not initialized or
 1290 
  * eax = -1 - driver is not loaded, not initialized or
1291 
    an error has occured
 1291 
    an error has occured
1292 
  * eax = 0 - success
 1292 
  * eax = 0 - success
1293 
  * ebx, ecx destroyed
 1293 
  * ebx, ecx destroyed
1294 
Remarks:
 1294 
Remarks:
1295 
  * Driver must be initialized by driver function 1.
 1295 
  * Driver must be initialized by driver function 1.
1296 
  * The videomode number and frequency must be in the table
 1296 
  * The videomode number and frequency must be in the table
1297 
    returned by driver function 1.
 1297 
    returned by driver function 1.
1298 
 
 1298 
 
1299 
======================================================================
 1299 
======================================================================
1300 
============ Function 21, subfunction 13, subsubfunction 4 ===========
 1300 
============ Function 21, subfunction 13, subsubfunction 4 ===========
1301 
================== Return to the initial videomode. ==================
 1301 
================== Return to the initial videomode. ==================
1302 
======================================================================
 1302 
======================================================================
1303 
Returns the screen to the videomode set at system boot.
 1303 
Returns the screen to the videomode set at system boot.
1304 
Parameters:
 1304 
Parameters:
1305 
  * eax = 21 - function number
 1305 
  * eax = 21 - function number
1306 
  * ebx = 13 - subfunction number
 1306 
  * ebx = 13 - subfunction number
1307 
  * ecx = 4 - number of the driver function
 1307 
  * ecx = 4 - number of the driver function
1308 
Returned value:
 1308 
Returned value:
1309 
  * eax = -1 - driver is not loaded or not initialized
 1309 
  * eax = -1 - driver is not loaded or not initialized
1310 
  * eax = 0 - success
 1310 
  * eax = 0 - success
1311 
  * ebx, ecx destroyed
 1311 
  * ebx, ecx destroyed
1312 
Remarks:
 1312 
Remarks:
1313 
  * Driver must be initialized by call to driver function 1.
 1313 
  * Driver must be initialized by call to driver function 1.
1314 
 
 1314 
 
1315 
======================================================================
 1315 
======================================================================
1316 
============ Function 21, subfunction 13, subsubfunction 5 ===========
 1316 
============ Function 21, subfunction 13, subsubfunction 5 ===========
1317 
===== Increase/decrease the size of the visible area of monitor. =====
 1317 
===== Increase/decrease the size of the visible area of monitor. =====
1318 
======================================================================
 1318 
======================================================================
1319 
Parameters:
 1319 
Parameters:
1320 
  * eax = 21 - function number
 1320 
  * eax = 21 - function number
1321 
  * ebx = 13 - subfunction number
 1321 
  * ebx = 13 - subfunction number
1322 
  * ecx = 5 - number of the driver function
 1322 
  * ecx = 5 - number of the driver function
1323 
  * edx = 0/1 - decrease/increase horizontal size on 1 position
 1323 
  * edx = 0/1 - decrease/increase horizontal size on 1 position
1324 
  * edx = 2/3 - is not supported in the current implementation;
 1324 
  * edx = 2/3 - is not supported in the current implementation;
1325 
    is planned as decrease/increase vertical size on 1 position
 1325 
    is planned as decrease/increase vertical size on 1 position
1326 
Returned value:
 1326 
Returned value:
1327 
  * eax = -1 - driver is not loaded or not initialized
 1327 
  * eax = -1 - driver is not loaded or not initialized
1328 
  * eax = 0 - success
 1328 
  * eax = 0 - success
1329 
  * ebx, ecx destroyed
 1329 
  * ebx, ecx destroyed
1330 
Remarks:
 1330 
Remarks:
1331 
  * Driver must be initialized by call to driver function 1.
 1331 
  * Driver must be initialized by call to driver function 1.
1332 
  * Function influences only the physical size of the screen image;
 1332 
  * Function influences only the physical size of the screen image;
1333 
    the logical size (number of pixels) does not change.
 1333 
    the logical size (number of pixels) does not change.
1334 
 
 1334 
 
1335 
======================================================================
 1335 
======================================================================
1336 
================= Function 22 - set system date/time. ================
 1336 
================= Function 22 - set system date/time. ================
1337 
======================================================================
 1337 
======================================================================
1338 
Parameters:
 1338 
Parameters:
1339 
  * eax = 22 - function number
 1339 
  * eax = 22 - function number
1340 
  * ebx = 0 - set time
 1340 
  * ebx = 0 - set time
1341 
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
 1341 
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
1342 
    * HH=hour 00..23
 1342 
    * HH=hour 00..23
1343 
    * MM=minute 00..59
 1343 
    * MM=minute 00..59
1344 
    * SS=second 00..59
 1344 
    * SS=second 00..59
1345 
  * ebx = 1 - set date
 1345 
  * ebx = 1 - set date
1346 
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
 1346 
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
1347 
    * DD=day 01..31
 1347 
    * DD=day 01..31
1348 
    * MM=month 01..12
 1348 
    * MM=month 01..12
1349 
    * YY=year 00..99
 1349 
    * YY=year 00..99
1350 
  * ebx = 2 - set day of week
 1350 
  * ebx = 2 - set day of week
1351 
    * ecx = 1 for Sunday, ..., 7 for Saturday
 1351 
    * ecx = 1 for Sunday, ..., 7 for Saturday
1352 
  * ebx = 3 - set alarm clock
 1352 
  * ebx = 3 - set alarm clock
1353 
    * ecx = 0x00SSMMHH
 1353 
    * ecx = 0x00SSMMHH
1354 
Returned value:
 1354 
Returned value:
1355 
  * eax = 0 - success
 1355 
  * eax = 0 - success
1356 
  * eax = 1 - incorrect parameter
 1356 
  * eax = 1 - incorrect parameter
1357 
  * eax = 2 - CMOS-battery was unloaded
 1357 
  * eax = 2 - CMOS-battery was unloaded
1358 
Remarks:
 1358 
Remarks:
1359 
  * Value of installation of day of week seems to be doubtful,
 1359 
  * Value of installation of day of week seems to be doubtful,
1360 
    as it a little where is used
 1360 
    as it a little where is used
1361 
    (day of week can be calculated by date).
 1361 
    (day of week can be calculated by date).
1362 
  * Alarm clock can be set on operation in the given time every day.
 1362 
  * Alarm clock can be set on operation in the given time every day.
1363 
    But there is no existing system function to disable it.
 1363 
    But there is no existing system function to disable it.
1364 
  * Operation of alarm clock consists in generation IRQ8.
 1364 
  * Operation of alarm clock consists in generation IRQ8.
1365 
  * Generally CMOS supports for alarm clock set of value 0xFF
 1365 
  * Generally CMOS supports for alarm clock set of value 0xFF
1366 
    as one of parameters and it means that the appropriate parameter
 1366 
    as one of parameters and it means that the appropriate parameter
1367 
    is ignored. But current implementation does not allow this
 1367 
    is ignored. But current implementation does not allow this
1368 
    (will return 1).
 1368 
    (will return 1).
1369 
  * Alarm clock is a global system resource; the set of
 1369 
  * Alarm clock is a global system resource; the set of
1370 
    an alarm clock cancels automatically the previous set.
 1370 
    an alarm clock cancels automatically the previous set.
1371 
    However, at moment no program uses it.
 1371 
    However, at moment no program uses it.
1372 
 
 1372 
 
1373 
======================================================================
 1373 
======================================================================
1374 
============= Function 23 - wait for event with timeout. =============
 1374 
============= Function 23 - wait for event with timeout. =============
1375 
======================================================================
 1375 
======================================================================
1376 
If the message queue is empty, waits for new message in the queue,
 1376 
If the message queue is empty, waits for new message in the queue,
1377 
but no more than given time. Then reads out a message from the queue.
 1377 
but no more than given time. Then reads out a message from the queue.
1378 
 
 1378 
 
1379 
Parameters:
 1379 
Parameters:
1380 
  * eax = 23 - function number
 1380 
  * eax = 23 - function number
1381 
  * ebx = timeout (in 1/100 of second)
 1381 
  * ebx = timeout (in 1/100 of second)
1382 
Returned value:
 1382 
Returned value:
1383 
  * eax = 0 - the message queue is empty
 1383 
  * eax = 0 - the message queue is empty
1384 
  * otherwise eax = event (see the list of events)
 1384 
  * otherwise eax = event (see the list of events)
1385 
Remarks:
 1385 
Remarks:
1386 
  * Only those events are taken into account, which enter into
 1386 
  * Only those events are taken into account, which enter into
1387 
    the mask set by function 40. By default it is
 1387 
    the mask set by function 40. By default it is
1388 
    redraw, key and button events.
 1388 
    redraw, key and button events.
1389 
  * To check for presence of a message in the queue use function 11.
 1389 
  * To check for presence of a message in the queue use function 11.
1390 
    To wait without timeout use function 10.
 1390 
    To wait without timeout use function 10.
1391 
  * Transmission ebx=0 results in immediate returning eax=0.
 1391 
  * Transmission ebx=0 results in immediate returning eax=0.
1392 
  * Current implementation returns immediately with eax=0,
 1392 
  * Current implementation returns immediately with eax=0,
1393 
    if the addition of ebx with the current value of time counter
 1393 
    if the addition of ebx with the current value of time counter
1394 
    makes 32-bit overflow.
 1394 
    makes 32-bit overflow.
1395 
 
 1395 
 
1396 
======================================================================
 1396 
======================================================================
1397 
======== Function 24, subfunction 1 - begin to play CD-audio. ========
 1397 
======== Function 24, subfunction 1 - begin to play CD-audio. ========
1398 
======================================================================
 1398 
======================================================================
1399 
Parameters:
 1399 
Parameters:
1400 
  * eax = 24 - function number
 1400 
  * eax = 24 - function number
1401 
  * ebx = 1 - subfunction number
 1401 
  * ebx = 1 - subfunction number
1402 
  * ecx = 0x00FRSSMM, where
 1402 
  * ecx = 0x00FRSSMM, where
1403 
    * MM = starting minute
 1403 
    * MM = starting minute
1404 
    * SS = starting second
 1404 
    * SS = starting second
1405 
    * FR = starting frame
 1405 
    * FR = starting frame
1406 
Returned value:
 1406 
Returned value:
1407 
  * eax = 0 - success
 1407 
  * eax = 0 - success
1408 
  * eax = 1 - CD base is not defined
 1408 
  * eax = 1 - CD base is not defined
1409 
Remarks:
 1409 
Remarks:
1410 
  * Previously CD base must be defined by the call to
1410 
  * Previously CD base must be defined by the call to
1411 
    subfunction 3 of function 21.
 1411 
    subfunction 3 of function 21.
1412 
  * One second includes 75 frames, one minute includes 60 seconds.
 1412 
  * One second includes 75 frames, one minute includes 60 seconds.
1413 
  * The function is asynchronous (returns control, when play begins).
 1413 
  * The function is asynchronous (returns control, when play begins).
1414 
 
 1414 
 
1415 
======================================================================
 1415 
======================================================================
1416 
======= Function 24, subfunction 2 - get information on tracks. ======
 1416 
======= Function 24, subfunction 2 - get information on tracks. ======
1417 
======================================================================
 1417 
======================================================================
1418 
Parameters:
 1418 
Parameters:
1419 
  * eax = 24 - function number
 1419 
  * eax = 24 - function number
1420 
  * ebx = 2 - subfunction number
 1420 
  * ebx = 2 - subfunction number
1421 
  * ecx = pointer to the buffer for the table
 1421 
  * ecx = pointer to the buffer for the table
1422 
    (maximum 8*64h+4 bytes=100 tracks)
 1422 
    (maximum 8*64h+4 bytes=100 tracks)
1423 
Returned value:
 1423 
Returned value:
1424 
  * eax = 0 - success
 1424 
  * eax = 0 - success
1425 
  * eax = 1 - CD base is not defined
 1425 
  * eax = 1 - CD base is not defined
1426 
Remarks:
 1426 
Remarks:
1427 
  * The format of the table with tracks information is the same as
 1427 
  * The format of the table with tracks information is the same as
1428 
    for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h).
 1428 
    for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h).
1429 
    Function returns addresses in MSF.
 1429 
    Function returns addresses in MSF.
1430 
  * Previously CD base port must be set by call to
1430 
  * Previously CD base port must be set by call to
1431 
    subfunction 3 of function 21.
 1431 
    subfunction 3 of function 21.
1432 
  * Function returns information only about no more than 100
 1432 
  * Function returns information only about no more than 100
1433 
    first tracks. In most cases it is enough.
 1433 
    first tracks. In most cases it is enough.
1434 
 
 1434 
 
1435 
======================================================================
 1435 
======================================================================
1436 
========== Function 24, subfunction 3 - stop play CD-audio. ==========
 1436 
========== Function 24, subfunction 3 - stop play CD-audio. ==========
1437 
======================================================================
 1437 
======================================================================
1438 
Parameters:
 1438 
Parameters:
1439 
  * eax = 24 - function number
 1439 
  * eax = 24 - function number
1440 
  * ebx = 1 - subfunction number
 1440 
  * ebx = 1 - subfunction number
1441 
Returned value:
 1441 
Returned value:
1442 
  * eax = 0 - success
 1442 
  * eax = 0 - success
1443 
  * eax = 1 - CD base is not defined
 1443 
  * eax = 1 - CD base is not defined
1444 
Remarks:
 1444 
Remarks:
1445 
  * Previously CD base port must be defined by call to
1445 
  * Previously CD base port must be defined by call to
1446 
    subfunction 3 of function 21.
 1446 
    subfunction 3 of function 21.
1447 
 
 1447 
 
1448 
======================================================================
 1448 
======================================================================
- 
 
 1449 
================ Function 24, subfunction 4 - eject tray of disk drive. ==============
- 
 
 1450 
======================================================================
- 
 
 1451 
Parameters:
- 
 
 1452 
  * eax = 24 - function number
- 
 
 1453 
  * ebx = 4 - subfunction number
- 
 
 1454 
  * ecx = position of CD/DVD-drive (from 0=Primary Master to 3=Secondary Slave)
- 
 
 1455 
Returned value:
- 
 
 1456 
  * Nothing comes back.
- 
 
 1457 
Remarks:
- 
 
 1458 
  * The function is supported only for ATAPI devices (CD and DVD).
- 
 
 1459 
  * At extract of a tray is made deblocking of handle mechanism of a tray.
- 
 
 1460 
  * At extract of a tray the code makes clearing the cache of the appropriate device.
- 
 
 1461 
  * An example of usage of the function is the application CD_tray.
- 
 
 1462 
 
- 
 
 1463 
======================================================================
- 
 
 1464 
============== Function 24, subfunction 5 - load tray of disk drive. =================
- 
 
 1465 
======================================================================
- 
 
 1466 
Parameters:
- 
 
 1467 
  * eax = 24 - function number
- 
 
 1468 
  * ebx = 5 - subfunction number
- 
 
 1469 
  * ecx = position of CD/DVD-drive (from 0=Primary Master to 3=Secondary Slave)
- 
 
 1470 
Returned value:
- 
 
 1471 
  * Nothing comes back.
- 
 
 1472 
Remarks:
- 
 
 1473 
  * The function is supported only for ATAPI devices (CD and DVD).
- 
 
 1474 
  * An example of usage of the function is the application CD_tray.
- 
 
 1475 
 
- 
 
 1476 
======================================================================
1449 
=================== Function 25 - set SBPro volume. ==================
 1477 
=================== Function 25 - set SBPro volume. ==================
1450 
======================================================================
 1478 
======================================================================
1451 
Parameters:
 1479 
Parameters:
1452 
  * eax = 25 - function number
 1480 
  * eax = 25 - function number
1453 
  * ebx = what to set:
 1481 
  * ebx = what to set:
1454 
    * 1 - set common volume
 1482 
    * 1 - set common volume
1455 
    * 2 - set CD-audio volume
 1483 
    * 2 - set CD-audio volume
1456 
  * cl = volume level: high 4 bits for the left column,
 1484 
  * cl = volume level: high 4 bits for the left column,
1457 
    low 4 bits for the right one
 1485 
    low 4 bits for the right one
1458 
Returned value:
 1486 
Returned value:
1459 
  * eax = 0 - success
 1487 
  * eax = 0 - success
1460 
  * eax = 1 - SB base is not defined
 1488 
  * eax = 1 - SB base is not defined
1461 
  * eax = 2 - incorrect subfunction
 1489 
  * eax = 2 - incorrect subfunction
1462 
Remarks:
 1490 
Remarks:
1463 
  * Previously SB base port must be defined by
1491 
  * Previously SB base port must be defined by
1464 
    subfunction 4 of function 21.
 1492 
    subfunction 4 of function 21.
1465 
  * See also function 28 which sets
 1493 
  * See also function 28 which sets
1466 
    volume for the later standard SB16.
 1494 
    volume for the later standard SB16.
1467 
 
 1495 
 
1468 
======================================================================
 1496 
======================================================================
1469 
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
 1497 
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
1470 
======================================================================
 1498 
======================================================================
1471 
Parameters:
 1499 
Parameters:
1472 
  * eax = 26 - function number
 1500 
  * eax = 26 - function number
1473 
  * ebx = 1 - subfunction number
 1501 
  * ebx = 1 - subfunction number
1474 
Returned value:
 1502 
Returned value:
1475 
  * eax = port number
 1503 
  * eax = port number
1476 
Parameters:
 1504 
Parameters:
1477 
  * To set base port use subfunction 1 of function 21.
 1505 
  * To set base port use subfunction 1 of function 21.
1478 
 
 1506 
 
1479 
======================================================================
 1507 
======================================================================
1480 
========== Function 26, subfunction 2 - get keyboard layout. =========
 1508 
========== Function 26, subfunction 2 - get keyboard layout. =========
1481 
======================================================================
 1509 
======================================================================
1482 
The keyboard layout is used to convert keyboard scancodes to
 1510 
The keyboard layout is used to convert keyboard scancodes to
1483 
ASCII-codes for function 2.
 1511 
ASCII-codes for function 2.
1484 
Parameters:
 1512 
Parameters:
1485 
  * eax = 26 - function number
 1513 
  * eax = 26 - function number
1486 
  * ebx = 2 - subfunction number
 1514 
  * ebx = 2 - subfunction number
1487 
  * ecx = what layout to get:
 1515 
  * ecx = what layout to get:
1488 
    * 1 = normal layout
 1516 
    * 1 = normal layout
1489 
    * 2 = layout with pressed Shift
 1517 
    * 2 = layout with pressed Shift
1490 
    * 3 = layout with pressed Alt
 1518 
    * 3 = layout with pressed Alt
1491 
  * edx = pointer to the 128-bytes buffer, where the layout will be
 1519 
  * edx = pointer to the 128-bytes buffer, where the layout will be
1492 
    copied
 1520 
    copied
1493 
Returned value:
 1521 
Returned value:
1494 
  * function does not return value
 1522 
  * function does not return value
1495 
Or:
 1523 
Or:
1496 
  * eax = 26 - function number
 1524 
  * eax = 26 - function number
1497 
  * ebx = 2 - subfunction number
 1525 
  * ebx = 2 - subfunction number
1498 
  * ecx = 9
 1526 
  * ecx = 9
1499 
Returned value:
 1527 
Returned value:
1500 
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
 1528 
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1501 
Remarks:
 1529 
Remarks:
1502 
  * If Alt is pressed, the layout with Alt is used;
 1530 
  * If Alt is pressed, the layout with Alt is used;
1503 
    if Alt is not pressed, but Shift is pressed,
 1531 
    if Alt is not pressed, but Shift is pressed,
1504 
    the layout with Shift is used;
 1532 
    the layout with Shift is used;
1505 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
 1533 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1506 
    layout is used and then from the code is subtracted 0x60;
 1534 
    layout is used and then from the code is subtracted 0x60;
1507 
    if no control key is pressed, the normal layout is used.
 1535 
    if no control key is pressed, the normal layout is used.
1508 
  * To set layout and country identifier use
1536 
  * To set layout and country identifier use
1509 
    subfunction 2 of function 21.
 1537 
    subfunction 2 of function 21.
1510 
  * Country identifier is global system variable, which is not used
 1538 
  * Country identifier is global system variable, which is not used
1511 
    by the kernel itself; however the application '@panel' displays
 1539 
    by the kernel itself; however the application '@panel' displays
1512 
    the corresponding icon (using this function).
 1540 
    the corresponding icon (using this function).
1513 
  * The application @panel switches layouts on user request.
 1541 
  * The application @panel switches layouts on user request.
1514 
 
 1542 
 
1515 
======================================================================
 1543 
======================================================================
1516 
============== Function 26, subfunction 3 - get CD base. =============
 1544 
============== Function 26, subfunction 3 - get CD base. =============
1517 
======================================================================
 1545 
======================================================================
1518 
Parameters:
 1546 
Parameters:
1519 
  * eax = 26 - function number
 1547 
  * eax = 26 - function number
1520 
  * ebx = 3 - subfunction number
 1548 
  * ebx = 3 - subfunction number
1521 
Returned value:
 1549 
Returned value:
1522 
  * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1550 
  * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1523 
Remarks:
 1551 
Remarks:
1524 
  * CD base is used by function 24.
 1552 
  * CD base is used by function 24.
1525 
  * To set CD base use subfunction 3 of function 21.
 1553 
  * To set CD base use subfunction 3 of function 21.
1526 
 
 1554 
 
1527 
======================================================================
 1555 
======================================================================
1528 
====== Function 26, subfunction 4 - get Sound Blaster base port. =====
 1556 
====== Function 26, subfunction 4 - get Sound Blaster base port. =====
1529 
======================================================================
 1557 
======================================================================
1530 
Parameters:
 1558 
Parameters:
1531 
  * eax = 26 - function number
 1559 
  * eax = 26 - function number
1532 
  * ebx = 4 - subfunction number
 1560 
  * ebx = 4 - subfunction number
1533 
Returned value:
 1561 
Returned value:
1534 
  * eax = base port number
 1562 
  * eax = base port number
1535 
Remarks:
 1563 
Remarks:
1536 
  * Bae port is used by functions 25, 55.
 1564 
  * Bae port is used by functions 25, 55.
1537 
  * To set base port use subfunction 4 of function 21.
 1565 
  * To set base port use subfunction 4 of function 21.
1538 
 
 1566 
 
1539 
======================================================================
 1567 
======================================================================
1540 
========== Function 26, subfunction 5 - get system language. =========
 1568 
========== Function 26, subfunction 5 - get system language. =========
1541 
======================================================================
 1569 
======================================================================
1542 
Parameters:
 1570 
Parameters:
1543 
  * eax = 26 - function number
 1571 
  * eax = 26 - function number
1544 
  * ebx = 5 - subfunction number
 1572 
  * ebx = 5 - subfunction number
1545 
Returned value:
 1573 
Returned value:
1546 
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
 1574 
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
1547 
Remarks:
 1575 
Remarks:
1548 
  * System language is global system variable and is not used
 1576 
  * System language is global system variable and is not used
1549 
    by the kernel itself, however application @panel draws the
 1577 
    by the kernel itself, however application @panel draws the
1550 
    appropriate icon (using this function).
 1578 
    appropriate icon (using this function).
1551 
  * To set system language use subfunction 5 of function 21.
 1579 
  * To set system language use subfunction 5 of function 21.
1552 
 
 1580 
 
1553 
======================================================================
 1581 
======================================================================
1554 
============== Function 26, subfunction 7 - get HD base. =============
 1582 
============== Function 26, subfunction 7 - get HD base. =============
1555 
======================================================================
 1583 
======================================================================
1556 
The HD base defines hard disk to write with usage of obsolete
 1584 
The HD base defines hard disk to write with usage of obsolete
1557 
syntax /HD in obsolete function 58; at usage of modern syntax
 1585 
syntax /HD in obsolete function 58; at usage of modern syntax
1558 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
 1586 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1559 
Parameters:
 1587 
Parameters:
1560 
  * eax = 26 - function number
 1588 
  * eax = 26 - function number
1561 
  * ebx = 7 - subfunction number
 1589 
  * ebx = 7 - subfunction number
1562 
Returned value:
 1590 
Returned value:
1563 
  * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1591 
  * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1564 
Remarks:
 1592 
Remarks:
1565 
  * Any application in any time can change HD base.
 1593 
  * Any application in any time can change HD base.
1566 
  * To set base use subfunction 7 of function 21.
 1594 
  * To set base use subfunction 7 of function 21.
1567 
  * To get used partition of hard disk use subfunction 8.
 1595 
  * To get used partition of hard disk use subfunction 8.
1568 
 
 1596 
 
1569 
======================================================================
 1597 
======================================================================
1570 
========= Function 26, subfunction 8 - get used HD partition. ========
 1598 
========= Function 26, subfunction 8 - get used HD partition. ========
1571 
======================================================================
 1599 
======================================================================
1572 
The HD partition defines partition of the hard disk to write with
 1600 
The HD partition defines partition of the hard disk to write with
1573 
usage of obsolete syntax /HD in obsolete function 58;
 1601 
usage of obsolete syntax /HD in obsolete function 58;
1574 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
 1602 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1575 
base and partition are set automatically.
 1603 
base and partition are set automatically.
1576 
Parameters:
 1604 
Parameters:
1577 
  * eax = 26 - function number
 1605 
  * eax = 26 - function number
1578 
  * ebx = 8 - subfunction number
 1606 
  * ebx = 8 - subfunction number
1579 
Returned value:
 1607 
Returned value:
1580 
  * eax = HD partition (beginning from 1)
 1608 
  * eax = HD partition (beginning from 1)
1581 
Remarks:
 1609 
Remarks:
1582 
  * Any application in any time can change partition.
 1610 
  * Any application in any time can change partition.
1583 
  * To set partition use subfunction 8 of function 21.
 1611 
  * To set partition use subfunction 8 of function 21.
1584 
  * To get number of partitions on a hard disk use
 1612 
  * To get number of partitions on a hard disk use
1585 
    subfunction 11 of function 18.
 1613 
    subfunction 11 of function 18.
1586 
  * To get base of used hard disk, use subfunction 7.
 1614 
  * To get base of used hard disk, use subfunction 7.
1587 
 
 1615 
 
1588 
======================================================================
 1616 
======================================================================
1589 
=== Function 26, subfunction 9 - get the value of the time counter. ==
 1617 
=== Function 26, subfunction 9 - get the value of the time counter. ==
1590 
======================================================================
 1618 
======================================================================
1591 
Parameters:
 1619 
Parameters:
1592 
  * eax = 26 - function number
 1620 
  * eax = 26 - function number
1593 
  * ebx = 9 - subfunction number
 1621 
  * ebx = 9 - subfunction number
1594 
Returned value:
 1622 
Returned value:
1595 
  * eax = number of 1/100s of second, past from the system boot time
 1623 
  * eax = number of 1/100s of second, past from the system boot time
1596 
Remarks:
 1624 
Remarks:
1597 
  * Counter takes modulo 2^32, that correspond to a little more
 1625 
  * Counter takes modulo 2^32, that correspond to a little more
1598 
    than 497 days.
 1626 
    than 497 days.
1599 
  * To get system time use function 3.
 1627 
  * To get system time use function 3.
1600 
 
 1628 
 
1601 
======================================================================
 1629 
======================================================================
1602 
======== Function 26, subfunction 10 - get sound DMA channel. ========
 1630 
======== Function 26, subfunction 10 - get sound DMA channel. ========
1603 
======================================================================
 1631 
======================================================================
1604 
Parameters:
 1632 
Parameters:
1605 
  * eax = 26 - function number
 1633 
  * eax = 26 - function number
1606 
  * ebx = 10 - subfunction number
 1634 
  * ebx = 10 - subfunction number
1607 
Returned value:
 1635 
Returned value:
1608 
  * eax = number of the channel (from 0 to 3 inclusive)
 1636 
  * eax = number of the channel (from 0 to 3 inclusive)
1609 
Remarks:
 1637 
Remarks:
1610 
  * Number of the DMA channel is used by subfunction 1 of function 55.
 1638 
  * Number of the DMA channel is used by subfunction 1 of function 55.
1611 
  * To set the sound DMA channel use subfunction 10 of function 21.
 1639 
  * To set the sound DMA channel use subfunction 10 of function 21.
1612 
 
 1640 
 
1613 
======================================================================
 1641 
======================================================================
1614 
===================== Function 26, subfunction 11 ====================
 1642 
===================== Function 26, subfunction 11 ====================
1615 
========== Find out whether low-level HD access is enabled. ==========
 1643 
========== Find out whether low-level HD access is enabled. ==========
1616 
======================================================================
 1644 
======================================================================
1617 
Parameters:
 1645 
Parameters:
1618 
  * eax = 26 - function number
 1646 
  * eax = 26 - function number
1619 
  * ebx = 11 - subfunction number
 1647 
  * ebx = 11 - subfunction number
1620 
Returned value:
 1648 
Returned value:
1621 
  * eax = 0/1 - disabled/enabled
 1649 
  * eax = 0/1 - disabled/enabled
1622 
Remarks:
 1650 
Remarks:
1623 
  * Is used in LBA read (subfunction 8 of function 58).
 1651 
  * Is used in LBA read (subfunction 8 of function 58).
1624 
  * To set current state use subfunction 11 of function 21.
 1652 
  * To set current state use subfunction 11 of function 21.
1625 
 
 1653 
 
1626 
======================================================================
 1654 
======================================================================
1627 
===================== Function 26, subfunction 12 ====================
 1655 
===================== Function 26, subfunction 12 ====================
1628 
========== Find out whether low-level PCI access is enabled. =========
 1656 
========== Find out whether low-level PCI access is enabled. =========
1629 
======================================================================
 1657 
======================================================================
1630 
Parameters:
 1658 
Parameters:
1631 
  * eax = 26 - function number
 1659 
  * eax = 26 - function number
1632 
  * ebx = 12 - subfunction number
 1660 
  * ebx = 12 - subfunction number
1633 
Returned value:
 1661 
Returned value:
1634 
  * eax = 0/1 - disabled/enabled
 1662 
  * eax = 0/1 - disabled/enabled
1635 
Remarks:
 1663 
Remarks:
1636 
  * Is used by operations with PCI bus (function 62).
 1664 
  * Is used by operations with PCI bus (function 62).
1637 
  * The current implementation uses only low bit of ecx.
 1665 
  * The current implementation uses only low bit of ecx.
1638 
  * To set the current state use subfunction 12 of function 21.
 1666 
  * To set the current state use subfunction 12 of function 21.
1639 
 
 1667 
 
1640 
======================================================================
 1668 
======================================================================
1641 
=================== Function 28 - set SB16 volume. ===================
 1669 
=================== Function 28 - set SB16 volume. ===================
1642 
======================================================================
 1670 
======================================================================
1643 
Parameters:
 1671 
Parameters:
1644 
  * eax = 28 - function number
 1672 
  * eax = 28 - function number
1645 
  * ebx = what to install:
 1673 
  * ebx = what to install:
1646 
    * 1 - install common volume
 1674 
    * 1 - install common volume
1647 
    * 2 - install CD-audio volume
 1675 
    * 2 - install CD-audio volume
1648 
  * cl = volume level (0=off, 0xFF=max)
 1676 
  * cl = volume level (0=off, 0xFF=max)
1649 
Returned value:
 1677 
Returned value:
1650 
  * eax = 0 - success
 1678 
  * eax = 0 - success
1651 
  * eax = 1 - SB base is not defined
 1679 
  * eax = 1 - SB base is not defined
1652 
  * eax = 2 - incorrect subfunction
 1680 
  * eax = 2 - incorrect subfunction
1653 
Remarks:
 1681 
Remarks:
1654 
  * Previously SB base port must be defined by
 1682 
  * Previously SB base port must be defined by
1655 
    subfunction 4 of function 21.
 1683 
    subfunction 4 of function 21.
1656 
  * This function gives more variants for volume, that function 25.
 1684 
  * This function gives more variants for volume, that function 25.
1657 
 
 1685 
 
1658 
======================================================================
 1686 
======================================================================
1659 
=================== Function 29 - get system date. ===================
 1687 
=================== Function 29 - get system date. ===================
1660 
======================================================================
 1688 
======================================================================
1661 
Parameters:
 1689 
Parameters:
1662 
  * eax = 29 - function number
 1690 
  * eax = 29 - function number
1663 
Returned value:
 1691 
Returned value:
1664 
  * eax = 0x00DDMMYY, where
 1692 
  * eax = 0x00DDMMYY, where
1665 
    (binary-decimal coding, BCD, is used)
 1693 
    (binary-decimal coding, BCD, is used)
1666 
  * YY = two low digits of year (00..99)
 1694 
  * YY = two low digits of year (00..99)
1667 
  * MM = month (01..12)
 1695 
  * MM = month (01..12)
1668 
  * DD = day (01..31)
 1696 
  * DD = day (01..31)
1669 
Remarks:
 1697 
Remarks:
1670 
  * To set system date use function 22.
 1698 
  * To set system date use function 22.
1671 
 
 1699 
 
1672 
======================================================================
 1700 
======================================================================
1673 
============= Function 30 - work with the current folder. ============
 1701 
============= Function 30 - work with the current folder. ============
1674 
======================================================================
 1702 
======================================================================
1675 
 
 1703 
 
1676 
--------- Subfunction 1 - set current folder for the thread. ---------
 1704 
--------- Subfunction 1 - set current folder for the thread. ---------
1677 
Parameters:
 1705 
Parameters:
1678 
  * eax = 30 - function number
 1706 
  * eax = 30 - function number
1679 
  * ebx = 1 - subfunction number
 1707 
  * ebx = 1 - subfunction number
1680 
  * ecx = pointer to ASCIIZ-string with the path to new current folder
 1708 
  * ecx = pointer to ASCIIZ-string with the path to new current folder
1681 
Returned value:
 1709 
Returned value:
1682 
  * function does not return value
 1710 
  * function does not return value
1683 
 
 1711 
 
1684 
--------- Subfunction 2 - get current folder for the thread. ---------
 1712 
--------- Subfunction 2 - get current folder for the thread. ---------
1685 
Parameters:
 1713 
Parameters:
1686 
  * eax = 30 - function number
 1714 
  * eax = 30 - function number
1687 
  * ebx = 2 - subfunction number
 1715 
  * ebx = 2 - subfunction number
1688 
  * ecx = pointer to buffer
 1716 
  * ecx = pointer to buffer
1689 
  * edx = size of buffer
 1717 
  * edx = size of buffer
1690 
Returned value:
 1718 
Returned value:
1691 
  * eax = size of the current folder's name (including terminating 0)
 1719 
  * eax = size of the current folder's name (including terminating 0)
1692 
Remarks:
 1720 
Remarks:
1693 
  * If the buffer is too small to hold all data, only first (edx-1)
 1721 
  * If the buffer is too small to hold all data, only first (edx-1)
1694 
    bytes are copied and than terminating 0 is inserted.
 1722 
    bytes are copied and than terminating 0 is inserted.
1695 
 
 1723 
 
1696 
======================================================================
 1724 
======================================================================
1697 
=============== Function 32 - delete file from ramdisk. ==============
 1725 
=============== Function 32 - delete file from ramdisk. ==============
1698 
======================================================================
 1726 
======================================================================
1699 
Parameters:
 1727 
Parameters:
1700 
  * eax = 32 - function number
 1728 
  * eax = 32 - function number
1701 
  * ebx = pointer to the filename
 1729 
  * ebx = pointer to the filename
1702 
Returned value:
 1730 
Returned value:
1703 
  * eax = 0 - success; otherwise file system error code
 1731 
  * eax = 0 - success; otherwise file system error code
1704 
Remarks:
 1732 
Remarks:
1705 
  * This function is obsolete; function 58 allows to fulfill
 1733 
  * This function is obsolete; function 58 allows to fulfill
1706 
    the same operations with the extended possibilities.
 1734 
    the same operations with the extended possibilities.
1707 
  * The current implementation returns only values 0(success) and
 1735 
  * The current implementation returns only values 0(success) and
1708 
    5(file not found).
 1736 
    5(file not found).
1709 
  * The filename must be either in the format 8+3 characters
 1737 
  * The filename must be either in the format 8+3 characters
1710 
    (first 8 characters - name itself, last 3 - extension,
 1738 
    (first 8 characters - name itself, last 3 - extension,
1711 
    the short names and extensions are supplemented with spaces),
 1739 
    the short names and extensions are supplemented with spaces),
1712 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
 1740 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
1713 
    (name no more than 8 characters, dot, extension 3 characters
 1741 
    (name no more than 8 characters, dot, extension 3 characters
1714 
    supplemented if necessary by spaces).
 1742 
    supplemented if necessary by spaces).
1715 
    The filename must be written with capital letters. The terminating
 1743 
    The filename must be written with capital letters. The terminating
1716 
    character with code 0 is not necessary (not ASCIIZ-string).
 1744 
    character with code 0 is not necessary (not ASCIIZ-string).
1717 
  * This function does not support folders on the ramdisk.
 1745 
  * This function does not support folders on the ramdisk.
1718 
 
 1746 
 
1719 
======================================================================
 1747 
======================================================================
1720 
================ Function 33 - write file to ramdisk. ================
 1748 
================ Function 33 - write file to ramdisk. ================
1721 
======================================================================
 1749 
======================================================================
1722 
Parameters:
 1750 
Parameters:
1723 
  * eax = 33 - function number
 1751 
  * eax = 33 - function number
1724 
  * ebx = pointer to the filename
 1752 
  * ebx = pointer to the filename
1725 
  * ecx = pointer to data for writing
 1753 
  * ecx = pointer to data for writing
1726 
  * edx = number of bytes for writing
 1754 
  * edx = number of bytes for writing
1727 
  * should be set esi=0
 1755 
  * should be set esi=0
1728 
Returned value:
 1756 
Returned value:
1729 
  * eax = 0 - success, otherwise file system error code
 1757 
  * eax = 0 - success, otherwise file system error code
1730 
Remarks:
 1758 
Remarks:
1731 
  * This function is obsolete; function 70 allows to fulfil
 1759 
  * This function is obsolete; function 70 allows to fulfil
1732 
    the same operations with extended possibilities.
 1760 
    the same operations with extended possibilities.
1733 
  * If esi contains non-zero value and selected file already exists,
 1761 
  * If esi contains non-zero value and selected file already exists,
1734 
    one more file with the same name will be created.
 1762 
    one more file with the same name will be created.
1735 
  * Otherwise file will be overwritten.
 1763 
  * Otherwise file will be overwritten.
1736 
  * The filename must be either in the format 8+3 characters
 1764 
  * The filename must be either in the format 8+3 characters
1737 
    (first 8 characters - name itself, last 3 - extension,
 1765 
    (first 8 characters - name itself, last 3 - extension,
1738 
    the short names and extensions are supplemented with spaces),
 1766 
    the short names and extensions are supplemented with spaces),
1739 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
 1767 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
1740 
    (name no more than 8 characters, dot, extension 3 characters
 1768 
    (name no more than 8 characters, dot, extension 3 characters
1741 
    supplemented if necessary by spaces).
 1769 
    supplemented if necessary by spaces).
1742 
    The filename must be written with capital letters. The terminating
 1770 
    The filename must be written with capital letters. The terminating
1743 
    character with code 0 is not necessary (not ASCIIZ-string).
 1771 
    character with code 0 is not necessary (not ASCIIZ-string).
1744 
  * This function does not support folders on the ramdisk.
 1772 
  * This function does not support folders on the ramdisk.
1745 
 
 1773 
 
1746 
======================================================================
 1774 
======================================================================
1747 
======= Function 35 - read the color of a pixel on the screen. =======
 1775 
======= Function 35 - read the color of a pixel on the screen. =======
1748 
======================================================================
 1776 
======================================================================
1749 
Parameters:
 1777 
Parameters:
1750 
  * eax = 35
 1778 
  * eax = 35
1751 
  * ebx = y*xsize+x, where
 1779 
  * ebx = y*xsize+x, where
1752 
  * (x,y) = coordinates of a pixel (beginning from 0)
 1780 
  * (x,y) = coordinates of a pixel (beginning from 0)
1753 
  * xsize = horizontal screen size
 1781 
  * xsize = horizontal screen size
1754 
Returned value:
 1782 
Returned value:
1755 
  * eax = color 0x00RRGGBB
 1783 
  * eax = color 0x00RRGGBB
1756 
Remarks:
 1784 
Remarks:
1757 
  * To get screen sizes use function 14. Pay attention,
 1785 
  * To get screen sizes use function 14. Pay attention,
1758 
    that it subtracts 1 from both sizes.
 1786 
    that it subtracts 1 from both sizes.
1759 
  * There is also direct access (without any system calls)
 1787 
  * There is also direct access (without any system calls)
1760 
    to videomemory through the selector gs. To get parameters of
 1788 
    to videomemory through the selector gs. To get parameters of
1761 
    the current videomode, use function 61.
 1789 
    the current videomode, use function 61.
1762 
 
 1790 
 
1763 
======================================================================
 1791 
======================================================================
1764 
=================== Function 37 - work with mouse. ===================
 1792 
=================== Function 37 - work with mouse. ===================
1765 
======================================================================
 1793 
======================================================================
1766 
 
 1794 
 
1767 
---------- Subfunction 0 - screen coordinates of the mouse -----------
 1795 
---------- Subfunction 0 - screen coordinates of the mouse -----------
1768 
Parameters:
 1796 
Parameters:
1769 
  * eax = 37 - function number
 1797 
  * eax = 37 - function number
1770 
  * ebx = 0 - subfunction number
 1798 
  * ebx = 0 - subfunction number
1771 
Returned value:
 1799 
Returned value:
1772 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
 1800 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1773 
    (beginning from 0)
 1801 
    (beginning from 0)
1774 
 
 1802 
 
1775 
-- Subfunction 1 - coordinates of the mouse relative to the window ---
 1803 
-- Subfunction 1 - coordinates of the mouse relative to the window ---
1776 
Parameters:
 1804 
Parameters:
1777 
  * eax = 37 - function number
 1805 
  * eax = 37 - function number
1778 
  * ebx = 1 - subfunction number
 1806 
  * ebx = 1 - subfunction number
1779 
Returned value:
 1807 
Returned value:
1780 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
 1808 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1781 
    relative to the application window (beginning from 0)
 1809 
    relative to the application window (beginning from 0)
1782 
Remarks:
 1810 
Remarks:
1783 
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
 1811 
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
1784 
    If y>=ywnd, the low word is non-negative and contains
 1812 
    If y>=ywnd, the low word is non-negative and contains
1785 
    relative y-coordinate, and the high word - relative x-coordinate
 1813 
    relative y-coordinate, and the high word - relative x-coordinate
1786 
    (with correct sign). Otherwise the low word is negative and still
 1814 
    (with correct sign). Otherwise the low word is negative and still
1787 
    contains relative y-coordinate, and to the high word
 1815 
    contains relative y-coordinate, and to the high word
1788 
    1 should be added.
 1816 
    1 should be added.
1789 
 
 1817 
 
1790 
------------ Subfunction 2 - pressed buttons of the mouse ------------
 1818 
------------ Subfunction 2 - pressed buttons of the mouse ------------
1791 
Parameters:
 1819 
Parameters:
1792 
  * eax = 37 - function number
 1820 
  * eax = 37 - function number
1793 
  * ebx = 2 - subfunction number
 1821 
  * ebx = 2 - subfunction number
1794 
Returned value:
 1822 
Returned value:
1795 
  * eax contains information on the pressed mouse buttons:
 1823 
  * eax contains information on the pressed mouse buttons:
1796 
  * bit 0 is set = left button is pressed
 1824 
  * bit 0 is set = left button is pressed
1797 
  * bit 1 is set = right button is pressed
 1825 
  * bit 1 is set = right button is pressed
1798 
  * bit 2 is set = middle button is pressed
 1826 
  * bit 2 is set = middle button is pressed
1799 
  * bit 3 is set = 4th button is pressed
 1827 
  * bit 3 is set = 4th button is pressed
1800 
  * bit 4 is set = 5th button is pressed
 1828 
  * bit 4 is set = 5th button is pressed
1801 
  * other bits are cleared
 1829 
  * other bits are cleared
1802 
 
 1830 
 
1803 
-------------------- Subfunction 4 - load cursor ---------------------
 1831 
-------------------- Subfunction 4 - load cursor ---------------------
1804 
Parameters:
 1832 
Parameters:
1805 
  * eax = 37 - function number
 1833 
  * eax = 37 - function number
1806 
  * ebx = 4 - subfunction number
 1834 
  * ebx = 4 - subfunction number
1807 
  * dx = data source:
 1835 
  * dx = data source:
1808 
  * dx = LOAD_FROM_FILE = 0 - data in a file
 1836 
  * dx = LOAD_FROM_FILE = 0 - data in a file
1809 
    * ecx = pointer to full path to the cursor file
 1837 
    * ecx = pointer to full path to the cursor file
1810 
    * the file must be in the format .cur, which is standard for
 1838 
    * the file must be in the format .cur, which is standard for
1811 
      MS Windows, at that of the size 32*32 pixels
 1839 
      MS Windows, at that of the size 32*32 pixels
1812 
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
 1840 
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
1813 
    * ecx = pointer to data of the cursor file
 1841 
    * ecx = pointer to data of the cursor file
1814 
    * the data format is the same as in the previous case
 1842 
    * the data format is the same as in the previous case
1815 
  * dx = LOAD_INDIRECT = 2 - data in memory
 1843 
  * dx = LOAD_INDIRECT = 2 - data in memory
1816 
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
 1844 
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
1817 
    * edx = 0xXXYY0002, where
 1845 
    * edx = 0xXXYY0002, where
1818 
      * XX = x-coordinate of cursor hotspot
 1846 
      * XX = x-coordinate of cursor hotspot
1819 
      * YY = y-coordinate
 1847 
      * YY = y-coordinate
1820 
      * 0 <= XX, YY <= 31
 1848 
      * 0 <= XX, YY <= 31
1821 
Returned value:
 1849 
Returned value:
1822 
  * eax = 0 - failed
 1850 
  * eax = 0 - failed
1823 
  * otherwise eax = cursor handle
 1851 
  * otherwise eax = cursor handle
1824 
 
 1852 
 
1825 
--------------------- Subfunction 5 - set cursor ---------------------
 1853 
--------------------- Subfunction 5 - set cursor ---------------------
1826 
Sets new cursor for the window of the current thread.
 1854 
Sets new cursor for the window of the current thread.
1827 
Parameters:
 1855 
Parameters:
1828 
  * eax = 37 - function number
 1856 
  * eax = 37 - function number
1829 
  * ebx = 5 - subfunction number
 1857 
  * ebx = 5 - subfunction number
1830 
  * ecx = cursor handle
 1858 
  * ecx = cursor handle
1831 
Returned value:
 1859 
Returned value:
1832 
  * eax = handle of previous cursor
 1860 
  * eax = handle of previous cursor
1833 
Remarks:
 1861 
Remarks:
1834 
  * If the handle is incorrect, the function restores the default
 1862 
  * If the handle is incorrect, the function restores the default
1835 
    cursor (standard arrow). In particular, ecx=0 restores it.
 1863 
    cursor (standard arrow). In particular, ecx=0 restores it.
1836 
 
 1864 
 
1837 
------------------- Subfunction 6 - delete cursor --------------------
 1865 
------------------- Subfunction 6 - delete cursor --------------------
1838 
Parameters:
 1866 
Parameters:
1839 
  * eax = 37 - function number
 1867 
  * eax = 37 - function number
1840 
  * ebx = 6 - subfunction number
 1868 
  * ebx = 6 - subfunction number
1841 
  * ecx = cursor handle
 1869 
  * ecx = cursor handle
1842 
Returned value:
 1870 
Returned value:
1843 
  * eax destroyed
 1871 
  * eax destroyed
1844 
Remarks:
 1872 
Remarks:
1845 
  * The cursor must be loaded previously by the current thread
 1873 
  * The cursor must be loaded previously by the current thread
1846 
    (with the call to subfunction 4). The function does not delete
 1874 
    (with the call to subfunction 4). The function does not delete
1847 
    system cursors and cursors, loaded by another applications.
 1875 
    system cursors and cursors, loaded by another applications.
1848 
  * If the active cursor (set by subfunction 5) is deleted,
 1876 
  * If the active cursor (set by subfunction 5) is deleted,
1849 
    the system restores the default cursor (standard arrow).
 1877 
    the system restores the default cursor (standard arrow).
1850 
 
 1878 
 
1851 
------------------ Subfunction 7 - get scroll data -------------------
 1879 
------------------ Subfunction 7 - get scroll data -------------------
1852 
Parameters:
 1880 
Parameters:
1853 
  * eax = 37 - function number
 1881 
  * eax = 37 - function number
1854 
  * ebx = 7 - subfunction number
 1882 
  * ebx = 7 - subfunction number
1855 
Returned value:
 1883 
Returned value:
1856 
  * eax = [horizontal offset]*65536 + [vertical offset]
 1884 
  * eax = [horizontal offset]*65536 + [vertical offset]
1857 
Remarks:
 1885 
Remarks:
1858 
  * Scroll data is available for active window only.
 1886 
  * Scroll data is available for active window only.
1859 
  * Values are zeroed after reading.
 1887 
  * Values are zeroed after reading.
1860 
  * Values are signed.
 1888 
  * Values are signed.
1861 
 
 1889 
 
1862 
======================================================================
 1890 
======================================================================
1863 
====================== Function 38 - draw line. ======================
 1891 
====================== Function 38 - draw line. ======================
1864 
======================================================================
 1892 
======================================================================
1865 
Parameters:
 1893 
Parameters:
1866 
  * eax = 38 - function number
 1894 
  * eax = 38 - function number
1867 
  * ebx = [start coordinate on axis x]*65536 +
 1895 
  * ebx = [start coordinate on axis x]*65536 +
1868 
              [end coordinate on axis x]
 1896 
              [end coordinate on axis x]
1869 
  * ecx = [start coordinate on axis y]*65536 +
 1897 
  * ecx = [start coordinate on axis y]*65536 +
1870 
              [end coordinate on axis y]
 1898 
              [end coordinate on axis y]
1871 
  * edx = 0x00RRGGBB - color
 1899 
  * edx = 0x00RRGGBB - color
1872 
    edx = 0x01xxxxxx - draw inversed line
 1900 
    edx = 0x01xxxxxx - draw inversed line
1873 
          (low 24 bits are ignored)
 1901 
          (low 24 bits are ignored)
1874 
Returned value:
 1902 
Returned value:
1875 
  * function does not return value
 1903 
  * function does not return value
1876 
Remarks:
 1904 
Remarks:
1877 
  * Coordinates are relative to the window.
 1905 
  * Coordinates are relative to the window.
1878 
  * End point is also drawn.
 1906 
  * End point is also drawn.
1879 
 
 1907 
 
1880 
======================================================================
 1908 
======================================================================
1881 
== Function 39, subfunction 1 - get a size of the background image. ==
 1909 
== Function 39, subfunction 1 - get a size of the background image. ==
1882 
======================================================================
 1910 
======================================================================
1883 
Parameters:
 1911 
Parameters:
1884 
  * eax = 39 - function number
 1912 
  * eax = 39 - function number
1885 
  * ebx = 1 - subfunction number
 1913 
  * ebx = 1 - subfunction number
1886 
Returned value:
 1914 
Returned value:
1887 
  * eax = [width]*65536 + [height]
 1915 
  * eax = [width]*65536 + [height]
1888 
Remarks:
 1916 
Remarks:
1889 
  * There is a pair function to set sizes of background image -
 1917 
  * There is a pair function to set sizes of background image -
1890 
    subfunction 1 of function 15. After which it is necessary,
 1918 
    subfunction 1 of function 15. After which it is necessary,
1891 
    of course, anew to define image.
 1919 
    of course, anew to define image.
1892 
 
 1920 
 
1893 
======================================================================
 1921 
======================================================================
1894 
== Function 39, subfunction 2 - get pixel from the background image. =
 1922 
== Function 39, subfunction 2 - get pixel from the background image. =
1895 
======================================================================
 1923 
======================================================================
1896 
Parameters:
 1924 
Parameters:
1897 
  * eax = 39 - function number
 1925 
  * eax = 39 - function number
1898 
  * ebx = 2 - subfunction number
 1926 
  * ebx = 2 - subfunction number
1899 
  * ecx = offset
 1927 
  * ecx = offset
1900 
Returned value:
 1928 
Returned value:
1901 
  * eax = 0x00RRGGBB - pixel color, if offset is valid
 1929 
  * eax = 0x00RRGGBB - pixel color, if offset is valid
1902 
    (less than 0x160000-16)
 1930 
    (less than 0x160000-16)
1903 
  * eax = 2 otherwise
 1931 
  * eax = 2 otherwise
1904 
Remarks:
 1932 
Remarks:
1905 
  * Do not rely on returned value for invalid offsets, it may be
 1933 
  * Do not rely on returned value for invalid offsets, it may be
1906 
    changed in future kernel versions.
 1934 
    changed in future kernel versions.
1907 
  * Offset for pixel with coordinates (x,y)
 1935 
  * Offset for pixel with coordinates (x,y)
1908 
    is calculated as (x+y*xsize)*3.
 1936 
    is calculated as (x+y*xsize)*3.
1909 
  * There is a pair function to set pixel on the background image -
1937 
  * There is a pair function to set pixel on the background image -
1910 
    subfunction 2 of function 15.
 1938 
    subfunction 2 of function 15.
1911 
 
 1939 
 
1912 
======================================================================
 1940 
======================================================================
1913 
== Function 39, subfunction 4 - get drawing mode for the background. =
 1941 
== Function 39, subfunction 4 - get drawing mode for the background. =
1914 
======================================================================
 1942 
======================================================================
1915 
Parameters:
 1943 
Parameters:
1916 
  * eax = 39 - function number
 1944 
  * eax = 39 - function number
1917 
  * ebx = 4 - subfunction number
 1945 
  * ebx = 4 - subfunction number
1918 
Returned value:
 1946 
Returned value:
1919 
  * eax = 1 - tile
 1947 
  * eax = 1 - tile
1920 
  * eax = 2 - stretch
 1948 
  * eax = 2 - stretch
1921 
Remarks:
 1949 
Remarks:
1922 
  * There is a pair function to set drawing mode -
1950 
  * There is a pair function to set drawing mode -
1923 
    subfunction 4 of function 15.
 1951 
    subfunction 4 of function 15.
1924 
 
 1952 
 
1925 
======================================================================
 1953 
======================================================================
1926 
=========== Function 40 - set the mask for expected events. ==========
 1954 
=========== Function 40 - set the mask for expected events. ==========
1927 
======================================================================
 1955 
======================================================================
1928 
The mask for expected events affects function working with events
 1956 
The mask for expected events affects function working with events
1929 
10, 11, 23 - they notify only about events allowed by this mask.
 1957 
10, 11, 23 - they notify only about events allowed by this mask.
1930 
Parameters:
 1958 
Parameters:
1931 
  * eax = 40 - function number
 1959 
  * eax = 40 - function number
1932 
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
 1960 
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
1933 
    (set bit permits notice on event)
 1961 
    (set bit permits notice on event)
1934 
Returned value:
 1962 
Returned value:
1935 
  * function does not return value
 1963 
  * function does not return value
1936 
Remarks:
 1964 
Remarks:
1937 
  * Default mask (7=111b) enables nofices about redraw,
 1965 
  * Default mask (7=111b) enables nofices about redraw,
1938 
    keys and buttons. This is enough for many applications.
 1966 
    keys and buttons. This is enough for many applications.
1939 
  * Events prohibited in the mask are saved anyway, when come;
 1967 
  * Events prohibited in the mask are saved anyway, when come;
1940 
    they are simply not informed with event functions.
 1968 
    they are simply not informed with event functions.
1941 
  * Event functions take into account the mask on moment of
 1969 
  * Event functions take into account the mask on moment of
1942 
    function call, not on moment of event arrival.
 1970 
    function call, not on moment of event arrival.
1943 
 
 1971 
 
1944 
======================================================================
 1972 
======================================================================
1945 
==================== Function 41 - get IRQ owner. ====================
 1973 
==================== Function 41 - get IRQ owner. ====================
1946 
======================================================================
 1974 
======================================================================
1947 
Parameters:
 1975 
Parameters:
1948 
  * eax = 41 - function number
 1976 
  * eax = 41 - function number
1949 
  * ebx = IRQ number, 0..15
 1977 
  * ebx = IRQ number, 0..15
1950 
Returned value:
 1978 
Returned value:
1951 
  * eax = owner PID
 1979 
  * eax = owner PID
1952 
  * eax = 0, if there is no owner
 1980 
  * eax = 0, if there is no owner
1953 
  * eax = -1 for incorrect ebx
 1981 
  * eax = -1 for incorrect ebx
1954 
 
 1982 
 
1955 
======================================================================
 1983 
======================================================================
1956 
==================== Function 42 - read IRQ data. ====================
 1984 
==================== Function 42 - read IRQ data. ====================
1957 
======================================================================
 1985 
======================================================================
1958 
When an IRQ occurs, the system reads data from ports indicated
 1986 
When an IRQ occurs, the system reads data from ports indicated
1959 
earlier by function 44 and writes this data to
 1987 
earlier by function 44 and writes this data to
1960 
internal buffer. This function reads out data from that buffer
 1988 
internal buffer. This function reads out data from that buffer
1961 
bytewise.
 1989 
bytewise.
1962 
Parameters:
 1990 
Parameters:
1963 
  * eax = 42 - function number
 1991 
  * eax = 42 - function number
1964 
  * ebx = IRQ number, 0..15
 1992 
  * ebx = IRQ number, 0..15
1965 
Returned value: (use value of ecx to distinguish)
 1993 
Returned value: (use value of ecx to distinguish)
1966 
  * if the thread is not IRQ owner (or IRQ number is incorrect):
 1994 
  * if the thread is not IRQ owner (or IRQ number is incorrect):
1967 
    * ecx = 2
 1995 
    * ecx = 2
1968 
  * if there is no data:
 1996 
  * if there is no data:
1969 
    * eax = 0
 1997 
    * eax = 0
1970 
    * ecx = 1
 1998 
    * ecx = 1
1971 
    * ebx destroyed
 1999 
    * ebx destroyed
1972 
  * if all is ok:
 2000 
  * if all is ok:
1973 
    * eax = byte size of data, not yet read from buffer
 2001 
    * eax = byte size of data, not yet read from buffer
1974 
    * ecx = 0
 2002 
    * ecx = 0
1975 
    * ebx = current byte
 2003 
    * ebx = current byte
1976 
Remarks:
 2004 
Remarks:
1977 
  * Previously the thread must reserve indicated IRQ for itself
 2005 
  * Previously the thread must reserve indicated IRQ for itself
1978 
    by function 45.
 2006 
    by function 45.
1979 
  * The size of data buffer is 4000 bytes, on overflow
 2007 
  * The size of data buffer is 4000 bytes, on overflow
1980 
    "fresh" data cease to be written in the buffer.
 2008 
    "fresh" data cease to be written in the buffer.
1981 
 
 2009 
 
1982 
======================================================================
 2010 
======================================================================
1983 
================ Function 43 - input/output to a port. ===============
 2011 
================ Function 43 - input/output to a port. ===============
1984 
======================================================================
 2012 
======================================================================
1985 
 
 2013 
 
1986 
------------------------ Output data to port -------------------------
 2014 
------------------------ Output data to port -------------------------
1987 
Parameters:
 2015 
Parameters:
1988 
  * eax = 43 - function number
 2016 
  * eax = 43 - function number
1989 
  * bl = byte for output
 2017 
  * bl = byte for output
1990 
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
 2018 
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
1991 
Returned value:
 2019 
Returned value:
1992 
  * eax = 0 - success
 2020 
  * eax = 0 - success
1993 
  * eax = 1 - the thread has not reserved the selected port
 2021 
  * eax = 1 - the thread has not reserved the selected port
1994 
 
 2022 
 
1995 
------------------------ Input data from port ------------------------
 2023 
------------------------ Input data from port ------------------------
1996 
Parameters:
 2024 
Parameters:
1997 
  * eax = 43 - function number
 2025 
  * eax = 43 - function number
1998 
  * ebx is ignored
 2026 
  * ebx is ignored
1999 
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
 2027 
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
2000 
Returned value:
 2028 
Returned value:
2001 
  * eax = 0 - success, thus ebx = entered byte
 2029 
  * eax = 0 - success, thus ebx = entered byte
2002 
  * eax = 1 - the thread has not reserved the selected port
 2030 
  * eax = 1 - the thread has not reserved the selected port
2003 
Remarks:
 2031 
Remarks:
2004 
  * Previously the thread must reserve the selected port
 2032 
  * Previously the thread must reserve the selected port
2005 
    for itself by function 46.
 2033 
    for itself by function 46.
2006 
  * Instead of call to this function it is better to use
 2034 
  * Instead of call to this function it is better to use
2007 
    processor instructions in/out - this is much
 2035 
    processor instructions in/out - this is much
2008 
    faster and a bit shorter and easier.
 2036 
    faster and a bit shorter and easier.
2009 
 
 2037 
 
2010 
======================================================================
 2038 
======================================================================
2011 
=========== Function 44 - define operations at IRQ arrival. ==========
 2039 
=========== Function 44 - define operations at IRQ arrival. ==========
2012 
======================================================================
 2040 
======================================================================
2013 
At IRQ arrival the system can read the data from ports defined
 2041 
At IRQ arrival the system can read the data from ports defined
2014 
by this function and write these data to internal buffer, whence
 2042 
by this function and write these data to internal buffer, whence
2015 
they can be read by ôóíêöèåé 42.
 2043 
they can be read by ôóíêöèåé 42.
2016 
Parameters:
 2044 
Parameters:
2017 
  * eax = 44 - function number
 2045 
  * eax = 44 - function number
2018 
  * ebx = pointer to the array of structures each describing one port:
 2046 
  * ebx = pointer to the array of structures each describing one port:
2019 
    * +0: word: 0 means end of array, otherwise port number
 2047 
    * +0: word: 0 means end of array, otherwise port number
2020 
    * +2: byte: reserved (ignored)
 2048 
    * +2: byte: reserved (ignored)
2021 
    * +3: byte: 1=read byte from this port, 2=read word
 2049 
    * +3: byte: 1=read byte from this port, 2=read word
2022 
  * ecx = IRQ number, 0..15
 2050 
  * ecx = IRQ number, 0..15
2023 
Returned value:
 2051 
Returned value:
2024 
  * eax = 0 - success
 2052 
  * eax = 0 - success
2025 
  * eax = 1 - the thread is not owner of selected IRQ
 2053 
  * eax = 1 - the thread is not owner of selected IRQ
2026 
Remarks:
 2054 
Remarks:
2027 
  * Previously the thread must reserve for itself selected IRQ
 2055 
  * Previously the thread must reserve for itself selected IRQ
2028 
    by function 45.
 2056 
    by function 45.
2029 
  * First 16 ports are considered only.
 2057 
  * First 16 ports are considered only.
2030 
  * The current implementation considers incorrect value of field +3
 2058 
  * The current implementation considers incorrect value of field +3
2031 
    as a signal to terminate IRQ processing.
 2059 
    as a signal to terminate IRQ processing.
2032 
 
 2060 
 
2033 
======================================================================
 2061 
======================================================================
2034 
=================== Function 45 - reserve/free IRQ. ==================
 2062 
=================== Function 45 - reserve/free IRQ. ==================
2035 
======================================================================
 2063 
======================================================================
2036 
Parameters:
 2064 
Parameters:
2037 
  * eax = 45 - function number
 2065 
  * eax = 45 - function number
2038 
  * ebx = 0 - reserve, 1 = free
 2066 
  * ebx = 0 - reserve, 1 = free
2039 
  * ecx = IRQ number, 0..15
 2067 
  * ecx = IRQ number, 0..15
2040 
Returned value:
 2068 
Returned value:
2041 
  * eax = 0 - success
 2069 
  * eax = 0 - success
2042 
  * eax = 1 - error (invalid IRQ number
 2070 
  * eax = 1 - error (invalid IRQ number
2043 
    or attempt to reserve not free IRQ
 2071 
    or attempt to reserve not free IRQ
2044 
    or to free IRQ, not reserved by this thread)
 2072 
    or to free IRQ, not reserved by this thread)
2045 
Remarks:
 2073 
Remarks:
2046 
  * IRQ reservation is required for functions 42 and 44.
 2074 
  * IRQ reservation is required for functions 42 and 44.
2047 
  * Only one thread can reserve the specific IRQ.
 2075 
  * Only one thread can reserve the specific IRQ.
2048 
  * IRQs, handled by the system itself, are reserved by the system
 2076 
  * IRQs, handled by the system itself, are reserved by the system
2049 
    (thread 1) at booting.
 2077 
    (thread 1) at booting.
2050 
  * When a thread terminates, all reserved by it IRQs
 2078 
  * When a thread terminates, all reserved by it IRQs
2051 
    are freed automatically.
 2079 
    are freed automatically.
2052 
 
 2080 
 
2053 
======================================================================
 2081 
======================================================================
2054 
====== Function 46 - reserve/free a group of input/output ports. =====
 2082 
====== Function 46 - reserve/free a group of input/output ports. =====
2055 
======================================================================
 2083 
======================================================================
2056 
To work with reserved ports an application can access directly by
 2084 
To work with reserved ports an application can access directly by
2057 
commands in/out (recommended way) and can use function 43
 2085 
commands in/out (recommended way) and can use function 43
2058 
(not recommended way).
 2086 
(not recommended way).
2059 
Parameters:
 2087 
Parameters:
2060 
  * eax = 46 - function number
 2088 
  * eax = 46 - function number
2061 
  * ebx = 0 - reserve, 1 - free
 2089 
  * ebx = 0 - reserve, 1 - free
2062 
  * ecx = start port number
 2090 
  * ecx = start port number
2063 
  * edx = end port number (inclusive)
 2091 
  * edx = end port number (inclusive)
2064 
Returned value:
 2092 
Returned value:
2065 
  * eax = 0 - success
 2093 
  * eax = 0 - success
2066 
  * eax = 1 - error
 2094 
  * eax = 1 - error
2067 
Remarks:
 2095 
Remarks:
2068 
  * For ports reservation: an error occurs if and only if
 2096 
  * For ports reservation: an error occurs if and only if
2069 
    one from the following condition satisfies:
 2097 
    one from the following condition satisfies:
2070 
    * start port is more than end port;
 2098 
    * start port is more than end port;
2071 
    * the selected range contains incorrect port number
 2099 
    * the selected range contains incorrect port number
2072 
      (correct are from 0 to 0xFFFF);
 2100 
      (correct are from 0 to 0xFFFF);
2073 
    * limit for the total number of reserved areas is exceeded
 2101 
    * limit for the total number of reserved areas is exceeded
2074 
      (maximum 255 are allowed);
 2102 
      (maximum 255 are allowed);
2075 
    * the selected range intersects with any of earlier reserved
 2103 
    * the selected range intersects with any of earlier reserved
2076 
  * For ports free: an error is an attempt to free range,
 2104 
  * For ports free: an error is an attempt to free range,
2077 
    that was not earlier reserved by this function
 2105 
    that was not earlier reserved by this function
2078 
    (with same ecx,edx).
 2106 
    (with same ecx,edx).
2079 
  * If an error occurs (for both cases) function performs no action.
 2107 
  * If an error occurs (for both cases) function performs no action.
2080 
  * At booting the system reserves for itself ports
 2108 
  * At booting the system reserves for itself ports
2081 
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
 2109 
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
2082 
  * When a thread terminates, all reserved by it ports
 2110 
  * When a thread terminates, all reserved by it ports
2083 
    are freed automatically.
 2111 
    are freed automatically.
2084 
 
 2112 
 
2085 
======================================================================
 2113 
======================================================================
2086 
============= Function 47 - draw a number in the window. =============
 2114 
============= Function 47 - draw a number in the window. =============
2087 
======================================================================
 2115 
======================================================================
2088 
Parameters:
 2116 
Parameters:
2089 
  * eax = 47 - function number
 2117 
  * eax = 47 - function number
2090 
  * ebx = parameters of conversion number to text:
 2118 
  * ebx = parameters of conversion number to text:
2091 
    * bl = 0 - ecx contains number
 2119 
    * bl = 0 - ecx contains number
2092 
    * bl = 1 - ecx contains pointer to dword-number
 2120 
    * bl = 1 - ecx contains pointer to dword-number
2093 
    * bh = 0 - display in decimal number system
 2121 
    * bh = 0 - display in decimal number system
2094 
    * bh = 1 - display in hexadecimal system
 2122 
    * bh = 1 - display in hexadecimal system
2095 
    * bh = 2 - display in binary system
 2123 
    * bh = 2 - display in binary system
2096 
    * bits 16-21 = how many digits to display
 2124 
    * bits 16-21 = how many digits to display
2097 
    * bits 22-31 reserved and must be set to 0
 2125 
    * bits 22-31 reserved and must be set to 0
2098 
  * ecx = number (if bl=0) or pointer (if bl=1)
 2126 
  * ecx = number (if bl=0) or pointer (if bl=1)
2099 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 2127 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
2100 
  * esi = 0xX0RRGGBB:
 2128 
  * esi = 0xX0RRGGBB:
2101 
    * RR, GG, BB specify the color
 2129 
    * RR, GG, BB specify the color
2102 
    * X = ABnn (bits)
 2130 
    * X = ABnn (bits)
2103 
    * nn = font (0/1)
 2131 
    * nn = font (0/1)
2104 
    * A is ignored
 2132 
    * A is ignored
2105 
    * B=1 - fill background with the color edi
 2133 
    * B=1 - fill background with the color edi
2106 
Returned value:
 2134 
Returned value:
2107 
  * function does not return value
 2135 
  * function does not return value
2108 
Remarks:
 2136 
Remarks:
2109 
  * The given length must not exceed 60.
 2137 
  * The given length must not exceed 60.
2110 
  * The exactly given amount of digits is output. If number is small
 2138 
  * The exactly given amount of digits is output. If number is small
2111 
    and can be written by smaller amount of digits, it is supplemented
 2139 
    and can be written by smaller amount of digits, it is supplemented
2112 
    by leading zeroes; if the number is big and can not be written by
 2140 
    by leading zeroes; if the number is big and can not be written by
2113 
    given amount of digits, extra digits are not drawn.
 2141 
    given amount of digits, extra digits are not drawn.
2114 
  * Parameters of fonts are shown in the description of function 4
 2142 
  * Parameters of fonts are shown in the description of function 4
2115 
    (text output).
 2143 
    (text output).
2116 
 
 2144 
 
2117 
======================================================================
 2145 
======================================================================
2118 
========= Function 48, subfunction 0 - apply screen settings. ========
 2146 
========= Function 48, subfunction 0 - apply screen settings. ========
2119 
======================================================================
 2147 
======================================================================
2120 
Parameters:
 2148 
Parameters:
2121 
  * eax = 48 - function number
 2149 
  * eax = 48 - function number
2122 
  * ebx = 0 - subfunction number
 2150 
  * ebx = 0 - subfunction number
2123 
  * ecx = 0 - reserved
 2151 
  * ecx = 0 - reserved
2124 
Returned value:
 2152 
Returned value:
2125 
  * function does not return value
 2153 
  * function does not return value
2126 
Remarks:
 2154 
Remarks:
2127 
  * Function redraws the screen after parameters change by
 2155 
  * Function redraws the screen after parameters change by
2128 
    subfunctions 1 and 2.
 2156 
    subfunctions 1 and 2.
2129 
  * Function call without prior call to one of indicated subfunctions
 2157 
  * Function call without prior call to one of indicated subfunctions
2130 
    is ignored.
 2158 
    is ignored.
2131 
  * Function call with nonzero ecx is ignored.
 2159 
  * Function call with nonzero ecx is ignored.
2132 
 
 2160 
 
2133 
======================================================================
 2161 
======================================================================
2134 
=========== Function 48, subfunction 1 - set button style. ===========
 2162 
=========== Function 48, subfunction 1 - set button style. ===========
2135 
======================================================================
 2163 
======================================================================
2136 
Parameters:
 2164 
Parameters:
2137 
  * eax = 48 - function number
 2165 
  * eax = 48 - function number
2138 
  * ebx = 1 - subfunction number
 2166 
  * ebx = 1 - subfunction number
2139 
  * ecx = button style:
 2167 
  * ecx = button style:
2140 
    * 0 = flat
 2168 
    * 0 = flat
2141 
    * 1 = 3d
 2169 
    * 1 = 3d
2142 
Returned value:
 2170 
Returned value:
2143 
  * function does not return value
 2171 
  * function does not return value
2144 
Remarks:
 2172 
Remarks:
2145 
  * After call to this function one should redraw the screen by
 2173 
  * After call to this function one should redraw the screen by
2146 
    subfunction 0.
 2174 
    subfunction 0.
2147 
  * Button style influences only to their draw of function 8.
 2175 
  * Button style influences only to their draw of function 8.
2148 
 
 2176 
 
2149 
======================================================================
 2177 
======================================================================
2150 
====== Function 48, subfunction 2 - set standard window colors. ======
 2178 
====== Function 48, subfunction 2 - set standard window colors. ======
2151 
======================================================================
 2179 
======================================================================
2152 
Parameters:
 2180 
Parameters:
2153 
  * eax = 48 - function number
 2181 
  * eax = 48 - function number
2154 
  * ebx = 2 - subfunction number
 2182 
  * ebx = 2 - subfunction number
2155 
  * ecx = pointer to the color table
 2183 
  * ecx = pointer to the color table
2156 
  * edx = size of the color table
 2184 
  * edx = size of the color table
2157 
    (must be 40 bytes for future compatibility)
 2185 
    (must be 40 bytes for future compatibility)
2158 
Format of the color table is shown in description of subfunction 3.
 2186 
Format of the color table is shown in description of subfunction 3.
2159 
Returned value:
 2187 
Returned value:
2160 
  * function does not return value
 2188 
  * function does not return value
2161 
Remarks:
 2189 
Remarks:
2162 
  * After call to this function one should redraw the screen by
 2190 
  * After call to this function one should redraw the screen by
2163 
    subfunction 0.
 2191 
    subfunction 0.
2164 
  * Table of standard colors influences only to applications,
 2192 
  * Table of standard colors influences only to applications,
2165 
    which receive this table obviously (by subfunction 3)
 2193 
    which receive this table obviously (by subfunction 3)
2166 
    and use it (specifying colors from it to drawing functions).
 2194 
    and use it (specifying colors from it to drawing functions).
2167 
  * Table of standard colors is included in skin and is installed
 2195 
  * Table of standard colors is included in skin and is installed
2168 
    anew with skin installation (by subfunction 8).
 2196 
    anew with skin installation (by subfunction 8).
2169 
  * Color table can be viewed/changed interactively with
 2197 
  * Color table can be viewed/changed interactively with
2170 
    the application 'desktop'.
 2198 
    the application 'desktop'.
2171 
 
 2199 
 
2172 
======================================================================
 2200 
======================================================================
2173 
====== Function 48, subfunction 3 - get standard window colors. ======
 2201 
====== Function 48, subfunction 3 - get standard window colors. ======
2174 
======================================================================
 2202 
======================================================================
2175 
Parameters:
 2203 
Parameters:
2176 
  * eax = 48 - function number
 2204 
  * eax = 48 - function number
2177 
  * ebx = 3 - subfunction number
 2205 
  * ebx = 3 - subfunction number
2178 
  * ecx = pointer to the buffer with size edx bytes,
 2206 
  * ecx = pointer to the buffer with size edx bytes,
2179 
    where table will be written
 2207 
    where table will be written
2180 
  * edx = size of color table
 2208 
  * edx = size of color table
2181 
    (must be 40 bytes for future compatibility)
 2209 
    (must be 40 bytes for future compatibility)
2182 
Returned value:
 2210 
Returned value:
2183 
  * function does not return value
 2211 
  * function does not return value
2184 
Format of the color table:
 2212 
Format of the color table:
2185 
each item is dword-value for color 0x00RRGGBB
 2213 
each item is dword-value for color 0x00RRGGBB
2186 
  * +0: dword: frames - color of frame
 2214 
  * +0: dword: frames - color of frame
2187 
  * +4: dword: grab - color of header
 2215 
  * +4: dword: grab - color of header
2188 
  * +8: dword: grab_button - color of button on header bar
 2216 
  * +8: dword: grab_button - color of button on header bar
2189 
  * +12 = +0xC: dword: grab_button_text - color of text on button
 2217 
  * +12 = +0xC: dword: grab_button_text - color of text on button
2190 
    on header bar
 2218 
    on header bar
2191 
  * +16 = +0x10: dword: grab_text - color of text on header
 2219 
  * +16 = +0x10: dword: grab_text - color of text on header
2192 
  * +20 = +0x14: dword: work - color of working area
 2220 
  * +20 = +0x14: dword: work - color of working area
2193 
  * +24 = +0x18: dword: work_button - color of button in working area
 2221 
  * +24 = +0x18: dword: work_button - color of button in working area
2194 
  * +28 = +0x1C: dword: work_button_text - color of text on button
 2222 
  * +28 = +0x1C: dword: work_button_text - color of text on button
2195 
    in working area
 2223 
    in working area
2196 
  * +32 = +0x20: dword: work_text - color of text in working area
 2224 
  * +32 = +0x20: dword: work_text - color of text in working area
2197 
  * +36 = +0x24: dword: work_graph - color of graphics in working area
 2225 
  * +36 = +0x24: dword: work_graph - color of graphics in working area
2198 
Remarks:
 2226 
Remarks:
2199 
  * Structure of the color table is described in the standard
 2227 
  * Structure of the color table is described in the standard
2200 
    include file 'macros.inc' as 'system_colors'; for example,
 2228 
    include file 'macros.inc' as 'system_colors'; for example,
2201 
    it is possible to write:
 2229 
    it is possible to write:
2202 
    	sc	system_colors		; variable declaration
 2230 
    	sc	system_colors		; variable declaration
2203 
    	...				; somewhere one must call
 2231 
    	...				; somewhere one must call
2204 
    					; this function with ecx=sc
 2232 
    					; this function with ecx=sc
2205 
    	mov	ecx, [sc.work_button_text]	; read text color on
 2233 
    	mov	ecx, [sc.work_button_text]	; read text color on
2206 
    					; buttin in working area
 2234 
    					; buttin in working area
2207 
  * A program itself desides to use or not to use color table.
 2235 
  * A program itself desides to use or not to use color table.
2208 
    For usage program must simply at calls to drawing functions select
 2236 
    For usage program must simply at calls to drawing functions select
2209 
    color taken from the table.
 2237 
    color taken from the table.
2210 
  * At change of the table of standard colors (by subfunction 2 with
 2238 
  * At change of the table of standard colors (by subfunction 2 with
2211 
    the subsequent application of changes by subfunction 0 or
 2239 
    the subsequent application of changes by subfunction 0 or
2212 
    at skin set by subfunction 8) the system sends to all windows
 2240 
    at skin set by subfunction 8) the system sends to all windows
2213 
    redraw message (the event with code 1).
 2241 
    redraw message (the event with code 1).
2214 
  * Color table can be viewed/changed interactively with
 2242 
  * Color table can be viewed/changed interactively with
2215 
    the application 'desktop'.
 2243 
    the application 'desktop'.
2216 
 
 2244 
 
2217 
======================================================================
 2245 
======================================================================
2218 
============ Function 48, subfunction 4 - get skin height. ===========
 2246 
============ Function 48, subfunction 4 - get skin height. ===========
2219 
======================================================================
 2247 
======================================================================
2220 
Parameters:
 2248 
Parameters:
2221 
  * eax = 48 - function number
 2249 
  * eax = 48 - function number
2222 
  * ebx = 4 - subfunction number
 2250 
  * ebx = 4 - subfunction number
2223 
Returned value:
 2251 
Returned value:
2224 
  * eax = skin height
 2252 
  * eax = skin height
2225 
Remarks:
 2253 
Remarks:
2226 
  * Skin height is defined as the height of a header
 2254 
  * Skin height is defined as the height of a header
2227 
    of skinned windows.
 2255 
    of skinned windows.
2228 
  * See also general structure of window in the description
 2256 
  * See also general structure of window in the description
2229 
    of function 0.
 2257 
    of function 0.
2230 
 
 2258 
 
2231 
======================================================================
 2259 
======================================================================
2232 
======== Function 48, subfunction 5 - get screen working area. =======
 2260 
======== Function 48, subfunction 5 - get screen working area. =======
2233 
======================================================================
 2261 
======================================================================
2234 
Parameters:
 2262 
Parameters:
2235 
  * eax = 48 - function number
 2263 
  * eax = 48 - function number
2236 
  * ebx = 5 - subfunction number
 2264 
  * ebx = 5 - subfunction number
2237 
Returned value:
 2265 
Returned value:
2238 
  * eax = [left]*65536 + [right]
 2266 
  * eax = [left]*65536 + [right]
2239 
  * ebx = [top]*65536 + [bottom]
 2267 
  * ebx = [top]*65536 + [bottom]
2240 
Remarks:
 2268 
Remarks:
2241 
  * The screen working area defines position and coordinates of
 2269 
  * The screen working area defines position and coordinates of
2242 
    a maximized window.
 2270 
    a maximized window.
2243 
  * The screen working area in view of normal work is all screen
 2271 
  * The screen working area in view of normal work is all screen
2244 
    without system panel (the application '@panel').
 2272 
    without system panel (the application '@panel').
2245 
  * (left,top) are coordinates of the left upper corner,
 2273 
  * (left,top) are coordinates of the left upper corner,
2246 
    (right,bottom) are coordinates of the right lower one.
 2274 
    (right,bottom) are coordinates of the right lower one.
2247 
    Thus the size of working area on x axis can be calculated by
 2275 
    Thus the size of working area on x axis can be calculated by
2248 
    formula right-left+1, on y axis - by formula bottom-right+1.
 2276 
    formula right-left+1, on y axis - by formula bottom-right+1.
2249 
  * See also function 14,
 2277 
  * See also function 14,
2250 
    to get sizes of all screen.
 2278 
    to get sizes of all screen.
2251 
  * There is a pair function to set working area - subfunction 6.
 2279 
  * There is a pair function to set working area - subfunction 6.
2252 
 
 2280 
 
2253 
======================================================================
 2281 
======================================================================
2254 
======== Function 48, subfunction 6 - set screen working area. =======
 2282 
======== Function 48, subfunction 6 - set screen working area. =======
2255 
======================================================================
 2283 
======================================================================
2256 
Parameters:
 2284 
Parameters:
2257 
  * eax = 48 - function number
 2285 
  * eax = 48 - function number
2258 
  * ebx = 6 - subfunction number
 2286 
  * ebx = 6 - subfunction number
2259 
  * ecx = [left]*65536 + [right]
 2287 
  * ecx = [left]*65536 + [right]
2260 
  * edx = [top]*65536 + [bottom]
 2288 
  * edx = [top]*65536 + [bottom]
2261 
Returned value:
 2289 
Returned value:
2262 
  * function does not return value
 2290 
  * function does not return value
2263 
Remarks:
 2291 
Remarks:
2264 
  * The screen working area defines position and coordinates of
 2292 
  * The screen working area defines position and coordinates of
2265 
    a maximized window.
 2293 
    a maximized window.
2266 
  * This function is used only by the application '@panel',
 2294 
  * This function is used only by the application '@panel',
2267 
    which set working area to all screen without system panel.
 2295 
    which set working area to all screen without system panel.
2268 
  * (left,top) are coordinates of the left upper corner,
 2296 
  * (left,top) are coordinates of the left upper corner,
2269 
    (right,bottom) are coordinates of the right lower one.
 2297 
    (right,bottom) are coordinates of the right lower one.
2270 
    Thus the size of working area on x axis can be calculated by
 2298 
    Thus the size of working area on x axis can be calculated by
2271 
    formula right-left+1, on y axis - by formula bottom-right+1.
 2299 
    formula right-left+1, on y axis - by formula bottom-right+1.
2272 
  * If 'left'>='right', x-coordinate of working area is not changed.
 2300 
  * If 'left'>='right', x-coordinate of working area is not changed.
2273 
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
 2301 
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
2274 
    equal to screen width, 'right' will not be set.
 2302 
    equal to screen width, 'right' will not be set.
2275 
    Similarly on y axis.
 2303 
    Similarly on y axis.
2276 
  * See also function 14,
 2304 
  * See also function 14,
2277 
    to get sizes of all screen.
 2305 
    to get sizes of all screen.
2278 
  * There is a pair function to get working area - subfunction 5.
 2306 
  * There is a pair function to get working area - subfunction 5.
2279 
  * This function redraws the screen automatically,
 2307 
  * This function redraws the screen automatically,
2280 
    updating coordinates and sizes of maximized windows.
 2308 
    updating coordinates and sizes of maximized windows.
2281 
    The system sends to all windows redraw message (the event 1).
 2309 
    The system sends to all windows redraw message (the event 1).
2282 
 
 2310 
 
2283 
======================================================================
 2311 
======================================================================
2284 
=========== Function 48, subfunction 7 - get skin margins. ===========
 2312 
=========== Function 48, subfunction 7 - get skin margins. ===========
2285 
======================================================================
 2313 
======================================================================
2286 
Returns the area of a header of a skinned window, intended for
 2314 
Returns the area of a header of a skinned window, intended for
2287 
a text of a header.
 2315 
a text of a header.
2288 
Parameters:
 2316 
Parameters:
2289 
  * eax = 48 - function number
 2317 
  * eax = 48 - function number
2290 
  * ebx = 7 - subfunction number
 2318 
  * ebx = 7 - subfunction number
2291 
Returned value:
 2319 
Returned value:
2292 
  * eax = [left]*65536 + [right]
 2320 
  * eax = [left]*65536 + [right]
2293 
  * ebx = [top]*65536 + [bottom]
 2321 
  * ebx = [top]*65536 + [bottom]
2294 
Remarks:
 2322 
Remarks:
2295 
  * An application decides itself to use or not to use this function.
 2323 
  * An application decides itself to use or not to use this function.
2296 
  * It is recommended to take into account returned value
 2324 
  * It is recommended to take into account returned value
2297 
    of this function for choice of a place for drawing header text
 2325 
    of this function for choice of a place for drawing header text
2298 
    (by function 4) or a substitute of header text
 2326 
    (by function 4) or a substitute of header text
2299 
    (at the discretion of an application).
 2327 
    (at the discretion of an application).
2300 
 
 2328 
 
2301 
======================================================================
 2329 
======================================================================
2302 
============= Function 48, subfunction 8 - set used skin. ============
 2330 
============= Function 48, subfunction 8 - set used skin. ============
2303 
======================================================================
 2331 
======================================================================
2304 
Parameters:
 2332 
Parameters:
2305 
  * eax = 48 - function number
 2333 
  * eax = 48 - function number
2306 
  * ebx = 8 - subfunction number
 2334 
  * ebx = 8 - subfunction number
2307 
  * ecx = pointer to a block for function 58, in
 2335 
  * ecx = pointer to a block for function 58, in
2308 
    which the fields of intermediate buffer and file name are filled
 2336 
    which the fields of intermediate buffer and file name are filled
2309 
Returned value:
 2337 
Returned value:
2310 
  * eax = 0 - success
 2338 
  * eax = 0 - success
2311 
  * otherwise eax = file system error code; if file does not
 2339 
  * otherwise eax = file system error code; if file does not
2312 
    contain valid skin, function returns error 3
 2340 
    contain valid skin, function returns error 3
2313 
    (unknown file system).
 2341 
    (unknown file system).
2314 
Remarks:
 2342 
Remarks:
2315 
  * After successful skin loading the system sends to all windows
 2343 
  * After successful skin loading the system sends to all windows
2316 
    redraw message (the event 1).
 2344 
    redraw message (the event 1).
2317 
  * At booting the system reads skin from file 'default.skn'
 2345 
  * At booting the system reads skin from file 'default.skn'
2318 
    on ramdisk.
 2346 
    on ramdisk.
2319 
  * User can change the skin statically by creating hisself
 2347 
  * User can change the skin statically by creating hisself
2320 
    'default.skn' or dynamically with the application 'desktop'.
 2348 
    'default.skn' or dynamically with the application 'desktop'.
2321 
 
 2349 
 
2322 
======================================================================
 2350 
======================================================================
2323 
=========== Function 49 - Advanced Power Management (APM). ===========
 2351 
=========== Function 49 - Advanced Power Management (APM). ===========
2324 
======================================================================
 2352 
======================================================================
2325 
Parameters:
 2353 
Parameters:
2326 
  * eax = 49 - function number
 2354 
  * eax = 49 - function number
2327 
  * dx = number of the APM function
 2355 
  * dx = number of the APM function
2328 
    (analogue of ax in APM specification)
 2356 
    (analogue of ax in APM specification)
2329 
  * bx, cx = parameters of the APM function
 2357 
  * bx, cx = parameters of the APM function
2330 
Returned value:
 2358 
Returned value:
2331 
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
 2359 
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
2332 
    are set according to the APM specification
 2360 
    are set according to the APM specification
2333 
  * high halves of 32-bit registers eax, ebx, ecx,
 2361 
  * high halves of 32-bit registers eax, ebx, ecx,
2334 
    edx, esi, edi are destroyed
 2362 
    edx, esi, edi are destroyed
2335 
Remarks:
 2363 
Remarks:
2336 
  * APM 1.2 specification is described in the document
 2364 
  * APM 1.2 specification is described in the document
2337 
    "Advanced Power Management (APM) BIOS Specification"
 2365 
    "Advanced Power Management (APM) BIOS Specification"
2338 
    (Revision 1.2), available at
 2366 
    (Revision 1.2), available at
2339 
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
 2367 
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2340 
    besides it is included in famous Interrupt List by Ralf Brown
 2368 
    besides it is included in famous Interrupt List by Ralf Brown
2341 
    (http://www.pobox.com/~ralf/files.html,
 2369 
    (http://www.pobox.com/~ralf/files.html,
2342 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
 2370 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2343 
 
 2371 
 
2344 
======================================================================
 2372 
======================================================================
2345 
=================== Function 50 - set window shape. ==================
 2373 
=================== Function 50 - set window shape. ==================
2346 
======================================================================
 2374 
======================================================================
2347 
Normal windows have rectangular shape. This function can give to
 2375 
Normal windows have rectangular shape. This function can give to
2348 
a window any shape. The shape is given by a set of points inside
 2376 
a window any shape. The shape is given by a set of points inside
2349 
the base rectangle belonging to a window. Position and coordinates
 2377 
the base rectangle belonging to a window. Position and coordinates
2350 
of the base rectangle are set by function 0
 2378 
of the base rectangle are set by function 0
2351 
and changed by function 67.
 2379 
and changed by function 67.
2352 
 
 2380 
 
2353 
--------------------------- Set shape data ---------------------------
 2381 
--------------------------- Set shape data ---------------------------
2354 
Parameters:
 2382 
Parameters:
2355 
  * eax = 50 - function number
 2383 
  * eax = 50 - function number
2356 
  * ebx = 0 - subfunction number
 2384 
  * ebx = 0 - subfunction number
2357 
  * ecx = pointer to shape data (array of bytes 0/1)
 2385 
  * ecx = pointer to shape data (array of bytes 0/1)
2358 
Returned value:
 2386 
Returned value:
2359 
  * function does not return value
 2387 
  * function does not return value
2360 
 
 2388 
 
2361 
-------------------------- Set shape scale ---------------------------
 2389 
-------------------------- Set shape scale ---------------------------
2362 
Parameters:
 2390 
Parameters:
2363 
  * eax = 50 - function number
 2391 
  * eax = 50 - function number
2364 
  * ebx = 1 - subfunction number
 2392 
  * ebx = 1 - subfunction number
2365 
  * ecx sets a scale: each byte of data defines
 2393 
  * ecx sets a scale: each byte of data defines
2366 
    (2^scale)*(2^scale) pixels
 2394 
    (2^scale)*(2^scale) pixels
2367 
Returned value:
 2395 
Returned value:
2368 
  * function does not return value
 2396 
  * function does not return value
2369 
Remarks:
 2397 
Remarks:
2370 
  * Default scale is 0 (scale factor is 1). If in the shape data
 2398 
  * Default scale is 0 (scale factor is 1). If in the shape data
2371 
    one byte corresponds to one pixel, there is no necessity
 2399 
    one byte corresponds to one pixel, there is no necessity
2372 
    to set scale.
 2400 
    to set scale.
2373 
  * Let's designate xsize = window width (in pixels), ysize = height;
 2401 
  * Let's designate xsize = window width (in pixels), ysize = height;
2374 
    pay attention, that they are one pixel more than defined by
 2402 
    pay attention, that they are one pixel more than defined by
2375 
    functions 0, 67.
 2403 
    functions 0, 67.
2376 
  * On definition of scale xsize and ysize must be divisible
 2404 
  * On definition of scale xsize and ysize must be divisible
2377 
    on 2^scale.
 2405 
    on 2^scale.
2378 
  * Byte of data on offset 'a' must be 0/1 and defines belonging
 2406 
  * Byte of data on offset 'a' must be 0/1 and defines belonging
2379 
    to a window of square with the side 2^scale (if scale=0,
 2407 
    to a window of square with the side 2^scale (if scale=0,
2380 
    this is one pixel) and coordinates of the left upper corner
 2408 
    this is one pixel) and coordinates of the left upper corner
2381 
    (a mod (xsize shr scale), a div (xsize shr scale))
 2409 
    (a mod (xsize shr scale), a div (xsize shr scale))
2382 
  * Data size: (xsize shr scale)*(ysize shr scale).
 2410 
  * Data size: (xsize shr scale)*(ysize shr scale).
2383 
  * Data must be presented in the memory and not change
 2411 
  * Data must be presented in the memory and not change
2384 
    after set of shape.
 2412 
    after set of shape.
2385 
  * The system views the shape data at every window redraw by
 2413 
  * The system views the shape data at every window redraw by
2386 
    function 0.
 2414 
    function 0.
2387 
  * The call of subfunction 0 with NULL pointer results in return
 2415 
  * The call of subfunction 0 with NULL pointer results in return
2388 
    to the rectangular shape.
 2416 
    to the rectangular shape.
2389 
 
 2417 
 
2390 
======================================================================
 2418 
======================================================================
2391 
==================== Function 51 - create thread. ====================
 2419 
==================== Function 51 - create thread. ====================
2392 
======================================================================
 2420 
======================================================================
2393 
Parameters:
 2421 
Parameters:
2394 
  * eax = 51 - function number
 2422 
  * eax = 51 - function number
2395 
  * ebx = 1 - unique subfunction
 2423 
  * ebx = 1 - unique subfunction
2396 
  * ecx = address of thread entry point (starting eip)
 2424 
  * ecx = address of thread entry point (starting eip)
2397 
  * edx = pointer to thread stack (starting esp)
 2425 
  * edx = pointer to thread stack (starting esp)
2398 
Returned value:
 2426 
Returned value:
2399 
  * eax = -1 - error (there is too many threads)
 2427 
  * eax = -1 - error (there is too many threads)
2400 
  * otherwise eax = TID - thread identifier
 2428 
  * otherwise eax = TID - thread identifier
2401
2429
2402 
 
 2430 
 
2403 
======================================================================
 2431 
======================================================================
2404 
=== Function 52, subfunction 0 - get network driver configuration. ===
 2432 
=== Function 52, subfunction 0 - get network driver configuration. ===
2405 
======================================================================
 2433 
======================================================================
2406 
Parameters:
 2434 
Parameters:
2407 
  * eax = 52 - function number
 2435 
  * eax = 52 - function number
2408 
  * ebx = 0 - subfunction number
 2436 
  * ebx = 0 - subfunction number
2409 
Returned value:
 2437 
Returned value:
2410 
  * eax = configuration dword
 2438 
  * eax = configuration dword
2411 
Remarks:
 2439 
Remarks:
2412 
  * Configuration dword can be set by subfunction 2.
 2440 
  * Configuration dword can be set by subfunction 2.
2413 
  * The kernel does not use this variable. The value of this
 2441 
  * The kernel does not use this variable. The value of this
2414 
    variable and working with it subfunctions 0 and 2 is represented
 2442 
    variable and working with it subfunctions 0 and 2 is represented
2415 
    doubtful.
 2443 
    doubtful.
2416 
 
 2444 
 
2417 
======================================================================
 2445 
======================================================================
2418 
========= Function 52, subfunction 1 - get local IP-address. =========
 2446 
========= Function 52, subfunction 1 - get local IP-address. =========
2419 
======================================================================
 2447 
======================================================================
2420 
Parameters:
 2448 
Parameters:
2421 
  * eax = 52 - function number
 2449 
  * eax = 52 - function number
2422 
  * ebx = 1 - subfunction number
 2450 
  * ebx = 1 - subfunction number
2423 
Returned value:
 2451 
Returned value:
2424 
  * eax = IP-address (4 bytes)
 2452 
  * eax = IP-address (4 bytes)
2425 
Remarks:
 2453 
Remarks:
2426 
  * Local IP-address is set by subfunction 3.
 2454 
  * Local IP-address is set by subfunction 3.
2427 
 
 2455 
 
2428 
======================================================================
 2456 
======================================================================
2429 
=== Function 52, subfunction 2 - set network driver configuration. ===
 2457 
=== Function 52, subfunction 2 - set network driver configuration. ===
2430 
======================================================================
 2458 
======================================================================
2431 
Parameters:
 2459 
Parameters:
2432 
  * eax = 52 - function number
 2460 
  * eax = 52 - function number
2433 
  * ebx = 2 - subfunction number
 2461 
  * ebx = 2 - subfunction number
2434 
  * ecx = configuration dword; if low 7 bits derivate the number 3,
 2462 
  * ecx = configuration dword; if low 7 bits derivate the number 3,
2435 
    function [re-]initializes Ethernet-card, otherwise
 2463 
    function [re-]initializes Ethernet-card, otherwise
2436 
    Ethernet turns off
 2464 
    Ethernet turns off
2437 
Returned value:
 2465 
Returned value:
2438 
  * if Ethernet-interface is not requested, function returns eax=2,
 2466 
  * if Ethernet-interface is not requested, function returns eax=2,
2439 
    but this can be changed in future kernel versions
 2467 
    but this can be changed in future kernel versions
2440 
  * if Ethernet-interface is requested, eax=0 means error
 2468 
  * if Ethernet-interface is requested, eax=0 means error
2441 
    (absence of Ethernet-card), and nonzero value - success
 2469 
    (absence of Ethernet-card), and nonzero value - success
2442 
Remarks:
 2470 
Remarks:
2443 
  * Configuration dword can be read by subfunction 0.
 2471 
  * Configuration dword can be read by subfunction 0.
2444 
  * The kernel does not use this variable. The value of this
 2472 
  * The kernel does not use this variable. The value of this
2445 
    variable, subfunction 0 and part of subfunction 2, which set it,
 2473 
    variable, subfunction 0 and part of subfunction 2, which set it,
2446 
    is represented doubtful.
 2474 
    is represented doubtful.
2447 
 
 2475 
 
2448 
======================================================================
 2476 
======================================================================
2449 
========= Function 52, subfunction 3 - set local IP-address. =========
 2477 
========= Function 52, subfunction 3 - set local IP-address. =========
2450 
======================================================================
 2478 
======================================================================
2451 
Parameters:
 2479 
Parameters:
2452 
  * eax = 52 - function number
 2480 
  * eax = 52 - function number
2453 
  * ebx = 3 - subfunction number
 2481 
  * ebx = 3 - subfunction number
2454 
  * ecx = IP-address (4 bytes)
 2482 
  * ecx = IP-address (4 bytes)
2455 
Returned value:
 2483 
Returned value:
2456 
  * the current implementation returns eax=3, but this can be changed
 2484 
  * the current implementation returns eax=3, but this can be changed
2457 
    in future versions
 2485 
    in future versions
2458 
Remarks:
 2486 
Remarks:
2459 
  * Local IP-address can be get by subfunction 1.
 2487 
  * Local IP-address can be get by subfunction 1.
2460 
 
 2488 
 
2461 
======================================================================
 2489 
======================================================================
2462 
= Function 52, subfunction 6 - add data to the stack of input queue. =
 2490 
= Function 52, subfunction 6 - add data to the stack of input queue. =
2463 
======================================================================
 2491 
======================================================================
2464 
Parameters:
 2492 
Parameters:
2465 
  * eax = 52 - function number
 2493 
  * eax = 52 - function number
2466 
  * ebx = 6 - subfunction number
 2494 
  * ebx = 6 - subfunction number
2467 
  * edx = data size
 2495 
  * edx = data size
2468 
  * esi = data pointer
 2496 
  * esi = data pointer
2469 
Returned value:
 2497 
Returned value:
2470 
  * eax = -1 - error
 2498 
  * eax = -1 - error
2471 
  * eax = 0 - success
 2499 
  * eax = 0 - success
2472 
Remarks:
 2500 
Remarks:
2473 
  * This function is intended only for slow network drivers
 2501 
  * This function is intended only for slow network drivers
2474 
    (PPP, SLIP).
 2502 
    (PPP, SLIP).
2475 
  * Data size must not exceed 1500 bytes, though function
 2503 
  * Data size must not exceed 1500 bytes, though function
2476 
    performs no checks on correctness.
 2504 
    performs no checks on correctness.
2477 
 
 2505 
 
2478 
======================================================================
 2506 
======================================================================
2479 
 Function 52, subfunction 8 - read data from the network output queue.
2507 
 Function 52, subfunction 8 - read data from the network output queue.
2480 
======================================================================
 2508 
======================================================================
2481 
Parameters:
 2509 
Parameters:
2482 
  * eax = 52 - function number
 2510 
  * eax = 52 - function number
2483 
  * ebx = 8 - subfunction number
 2511 
  * ebx = 8 - subfunction number
2484 
  * esi = pointer to 1500-byte buffer
 2512 
  * esi = pointer to 1500-byte buffer
2485 
Returned value:
 2513 
Returned value:
2486 
  * eax = number of read bytes (in the current implementation
 2514 
  * eax = number of read bytes (in the current implementation
2487 
    either 0 = no data or 1500)
 2515 
    either 0 = no data or 1500)
2488 
  * data was copied in buffer
 2516 
  * data was copied in buffer
2489 
Remarks:
 2517 
Remarks:
2490 
  * This function is intended only for slow network drivers
 2518 
  * This function is intended only for slow network drivers
2491 
    (PPP, SLIP).
 2519 
    (PPP, SLIP).
2492 
 
 2520 
 
2493 
======================================================================
 2521 
======================================================================
2494 
============ Function 52, subfunction 9 - get gateway IP. ============
 2522 
============ Function 52, subfunction 9 - get gateway IP. ============
2495 
======================================================================
 2523 
======================================================================
2496 
Parameters:
 2524 
Parameters:
2497 
  * eax = 52 - function number
 2525 
  * eax = 52 - function number
2498 
  * ebx = 9 - subfunction number
 2526 
  * ebx = 9 - subfunction number
2499 
Returned value:
 2527 
Returned value:
2500 
  * eax = gateway IP (4 bytes)
 2528 
  * eax = gateway IP (4 bytes)
2501 
 
 2529 
 
2502 
======================================================================
 2530 
======================================================================
2503 
=========== Function 52, subfunction 10 - get subnet mask. ===========
 2531 
=========== Function 52, subfunction 10 - get subnet mask. ===========
2504 
======================================================================
 2532 
======================================================================
2505 
Parameters:
 2533 
Parameters:
2506 
  * eax = 52 - function number
 2534 
  * eax = 52 - function number
2507 
  * ebx = 10 - subfunction number
 2535 
  * ebx = 10 - subfunction number
2508 
Returned value:
 2536 
Returned value:
2509 
  * eax = subnet mask
 2537 
  * eax = subnet mask
2510 
 
 2538 
 
2511 
======================================================================
 2539 
======================================================================
2512 
============ Function 52, subfunction 11 - set gateway IP. ===========
 2540 
============ Function 52, subfunction 11 - set gateway IP. ===========
2513 
======================================================================
 2541 
======================================================================
2514 
Parameters:
 2542 
Parameters:
2515 
  * eax = 52 - function number
 2543 
  * eax = 52 - function number
2516 
  * ebx = 11 - subfunction number
 2544 
  * ebx = 11 - subfunction number
2517 
  * ecx = gateway IP (4 bytes)
 2545 
  * ecx = gateway IP (4 bytes)
2518 
Returned value:
 2546 
Returned value:
2519 
  * the current implementation returns eax=11, but this can be changed
 2547 
  * the current implementation returns eax=11, but this can be changed
2520 
    in future versions
 2548 
    in future versions
2521 
 
 2549 
 
2522 
======================================================================
 2550 
======================================================================
2523 
=========== Function 52, subfunction 12 - set subnet mask. ===========
 2551 
=========== Function 52, subfunction 12 - set subnet mask. ===========
2524 
======================================================================
 2552 
======================================================================
2525 
Parameters:
 2553 
Parameters:
2526 
  * eax = 52 - function number
 2554 
  * eax = 52 - function number
2527 
  * ebx = 12 - subfunction number
 2555 
  * ebx = 12 - subfunction number
2528 
  * ecx = subnet mask
 2556 
  * ecx = subnet mask
2529 
Returned value:
 2557 
Returned value:
2530 
  * the current implementation returns eax=12, but this can be changed
 2558 
  * the current implementation returns eax=12, but this can be changed
2531 
    in future versions
 2559 
    in future versions
2532 
 
 2560 
 
2533 
======================================================================
 2561 
======================================================================
2534 
============== Function 52, subfunction 13 - get DNS IP. =============
 2562 
============== Function 52, subfunction 13 - get DNS IP. =============
2535 
======================================================================
 2563 
======================================================================
2536 
Parameters:
 2564 
Parameters:
2537 
  * eax = 52 - function number
 2565 
  * eax = 52 - function number
2538 
  * ebx = 13 - subfunction number
 2566 
  * ebx = 13 - subfunction number
2539 
Returned value:
 2567 
Returned value:
2540 
  * eax = DNS IP (4 bytes)
 2568 
  * eax = DNS IP (4 bytes)
2541 
 
 2569 
 
2542 
======================================================================
 2570 
======================================================================
2543 
============== Function 52, subfunction 14 - set DNS IP. =============
 2571 
============== Function 52, subfunction 14 - set DNS IP. =============
2544 
======================================================================
 2572 
======================================================================
2545 
Parameters:
 2573 
Parameters:
2546 
  * eax = 52 - function number
 2574 
  * eax = 52 - function number
2547 
  * ebx = 14 - subfunction number
 2575 
  * ebx = 14 - subfunction number
2548 
  * ecx = DNS IP (4 bytes)
 2576 
  * ecx = DNS IP (4 bytes)
2549 
Returned value:
 2577 
Returned value:
2550 
  * the current implementation returns eax=14, but this can be changed
 2578 
  * the current implementation returns eax=14, but this can be changed
2551 
    in future versions
 2579 
    in future versions
2552 
 
 2580 
 
2553 
======================================================================
 2581 
======================================================================
2554 
======== Function 52, subfunction 15 - get local MAC address. ========
 2582 
======== Function 52, subfunction 15 - get local MAC address. ========
2555 
======================================================================
 2583 
======================================================================
2556 
Parameters:
 2584 
Parameters:
2557 
  * eax = 52 - function number
 2585 
  * eax = 52 - function number
2558 
  * ebx = 15 - subfunction number
 2586 
  * ebx = 15 - subfunction number
2559 
  * ecx = 0 - read first 4 bytes,
 2587 
  * ecx = 0 - read first 4 bytes,
2560 
    ecx = 4 - read last 2 bytes
 2588 
    ecx = 4 - read last 2 bytes
2561 
Returned value:
 2589 
Returned value:
2562 
  * for ecx=0: eax = first 4 bytes of MAC address
 2590 
  * for ecx=0: eax = first 4 bytes of MAC address
2563 
  * for ecx=4: ax = last 2 bytes of MAC address,
 2591 
  * for ecx=4: ax = last 2 bytes of MAC address,
2564 
               high half of eax is destroyed
 2592 
               high half of eax is destroyed
2565 
  * for other ecx: eax = -1 indicates an error
 2593 
  * for other ecx: eax = -1 indicates an error
2566 
 
 2594 
 
2567 
======================================================================
 2595 
======================================================================
2568 
============ Function 53, subfunction 0 - open UDP-socket. ===========
 2596 
============ Function 53, subfunction 0 - open UDP-socket. ===========
2569 
======================================================================
 2597 
======================================================================
2570 
Parameters:
 2598 
Parameters:
2571 
  * eax = 53 - function number
 2599 
  * eax = 53 - function number
2572 
  * ebx = 0 - subfunction number
 2600 
  * ebx = 0 - subfunction number
2573 
  * ecx = local port (only low word is taken into account)
 2601 
  * ecx = local port (only low word is taken into account)
2574 
  * edx = remote port (only low word is taken into account)
 2602 
  * edx = remote port (only low word is taken into account)
2575 
  * esi = remote IP
 2603 
  * esi = remote IP
2576 
Returned value:
 2604 
Returned value:
2577 
  * eax = -1 = 0xFFFFFFFF - error; ebx destroyed
 2605 
  * eax = -1 = 0xFFFFFFFF - error; ebx destroyed
2578 
  * eax = socket handle (some number which unambiguously identifies
 2606 
  * eax = socket handle (some number which unambiguously identifies
2579 
    socket and have sense only for the system) - success;
 2607 
    socket and have sense only for the system) - success;
2580 
    ebx destroyed
 2608 
    ebx destroyed
2581 
 
 2609 
 
2582 
======================================================================
 2610 
======================================================================
2583 
=========== Function 53, subfunction 1 - close UDP-socket. ===========
 2611 
=========== Function 53, subfunction 1 - close UDP-socket. ===========
2584 
======================================================================
 2612 
======================================================================
2585 
Parameters:
 2613 
Parameters:
2586 
  * eax = 53 - function number
 2614 
  * eax = 53 - function number
2587 
  * ebx = 1 - subfunction number
 2615 
  * ebx = 1 - subfunction number
2588 
  * ecx = socket handle
 2616 
  * ecx = socket handle
2589 
Returned value:
 2617 
Returned value:
2590 
  * eax = -1 - incorrect handle
 2618 
  * eax = -1 - incorrect handle
2591 
  * eax = 0 - success
 2619 
  * eax = 0 - success
2592 
  * ebx destroyed
 2620 
  * ebx destroyed
2593 
Remarks:
 2621 
Remarks:
2594 
  * The current implementation does not close automatically all
 2622 
  * The current implementation does not close automatically all
2595 
    sockets of a thread at termination. In particular, one should not
 2623 
    sockets of a thread at termination. In particular, one should not
2596 
    kill a thread with many opened sockets - there will be an outflow
 2624 
    kill a thread with many opened sockets - there will be an outflow
2597 
    of resources.
 2625 
    of resources.
2598 
  * The current implementation does no checks on correctness
 2626 
  * The current implementation does no checks on correctness
2599 
    (function returns error only if thread tries to close not opened
 2627 
    (function returns error only if thread tries to close not opened
2600 
    socket with correct handle).
 2628 
    socket with correct handle).
2601 
 
 2629 
 
2602 
======================================================================
 2630 
======================================================================
2603 
============== Function 53, subfunction 2 - poll socket. =============
 2631 
============== Function 53, subfunction 2 - poll socket. =============
2604 
======================================================================
 2632 
======================================================================
2605 
Parameters:
 2633 
Parameters:
2606 
  * eax = 53 - function number
 2634 
  * eax = 53 - function number
2607 
  * ebx = 2 - subfunction number
 2635 
  * ebx = 2 - subfunction number
2608 
  * ecx = socket handle
 2636 
  * ecx = socket handle
2609 
Returned value:
 2637 
Returned value:
2610 
  * eax = number of read bytes
 2638 
  * eax = number of read bytes
2611 
  * ebx destroyed
 2639 
  * ebx destroyed
2612 
Remarks:
 2640 
Remarks:
2613 
  * There is no checks for correctness.
 2641 
  * There is no checks for correctness.
2614 
 
 2642 
 
2615 
======================================================================
 2643 
======================================================================
2616 
========= Function 53, subfunction 3 - read byte from socket. ========
 2644 
========= Function 53, subfunction 3 - read byte from socket. ========
2617 
======================================================================
 2645 
======================================================================
2618 
Parameters:
 2646 
Parameters:
2619 
  * eax = 53 - function number
 2647 
  * eax = 53 - function number
2620 
  * ebx = 3 - subfunction number
 2648 
  * ebx = 3 - subfunction number
2621 
  * ecx = socket handle
 2649 
  * ecx = socket handle
2622 
Returned value:
 2650 
Returned value:
2623 
  * if there is no read data: eax=0, bl=0,
 2651 
  * if there is no read data: eax=0, bl=0,
2624 
    other bytes of ebx are destroyed
 2652 
    other bytes of ebx are destroyed
2625 
  * if there are read data: eax=number of rest bytes
 2653 
  * if there are read data: eax=number of rest bytes
2626 
    (possibly 0), bl=read byte, other bytes of ebx are destroyed
 2654 
    (possibly 0), bl=read byte, other bytes of ebx are destroyed
2627 
Remarks:
 2655 
Remarks:
2628 
  * There is no checks for correctness.
 2656 
  * There is no checks for correctness.
2629 
 
 2657 
 
2630 
======================================================================
 2658 
======================================================================
2631 
========== Function 53, subfunction 4 - write to UDP-socket. =========
 2659 
========== Function 53, subfunction 4 - write to UDP-socket. =========
2632 
======================================================================
 2660 
======================================================================
2633 
Parameters:
 2661 
Parameters:
2634 
  * eax = 53 - function number
 2662 
  * eax = 53 - function number
2635 
  * ebx = 4 - subfunction number
 2663 
  * ebx = 4 - subfunction number
2636 
  * ecx = socket handle
 2664 
  * ecx = socket handle
2637 
  * edx = number of bytes to write
 2665 
  * edx = number of bytes to write
2638 
  * esi = pointer to data to write
 2666 
  * esi = pointer to data to write
2639 
Returned value:
 2667 
Returned value:
2640 
  * eax = 0xffffffff - invalid handle
 2668 
  * eax = 0xffffffff - invalid handle
2641 
  * eax = 0xffff - not enough memory
 2669 
  * eax = 0xffff - not enough memory
2642 
  * eax = 0 - success
 2670 
  * eax = 0 - success
2643 
  * ebx destroyed
 2671 
  * ebx destroyed
2644 
Remarks:
 2672 
Remarks:
2645 
  * Check on validity of handle is minimal - only not very incorrect
 2673 
  * Check on validity of handle is minimal - only not very incorrect
2646 
    not opened handles are eliminated.
 2674 
    not opened handles are eliminated.
2647 
  * Number of bytes to write must not exceed 1500-28, though
 2675 
  * Number of bytes to write must not exceed 1500-28, though
2648 
    the appropriate check is not made.
 2676 
    the appropriate check is not made.
2649 
 
 2677 
 
2650 
======================================================================
 2678 
======================================================================
2651 
============ Function 53, subfunction 5 - open TCP-socket. ===========
 2679 
============ Function 53, subfunction 5 - open TCP-socket. ===========
2652 
======================================================================
 2680 
======================================================================
2653 
Parameters:
 2681 
Parameters:
2654 
  * eax = 53 - function number
 2682 
  * eax = 53 - function number
2655 
  * ebx = 5 - subfunction number
 2683 
  * ebx = 5 - subfunction number
2656 
  * ecx = local port (only low word is taken into account)
 2684 
  * ecx = local port (only low word is taken into account)
2657 
  * edx = remote port (only low word is taken into account)
 2685 
  * edx = remote port (only low word is taken into account)
2658 
  * esi = remote IP
 2686 
  * esi = remote IP
2659 
  * edi = open mode: SOCKET_PASSIVE=0 or SOCKET_ACTIVE=1
 2687 
  * edi = open mode: SOCKET_PASSIVE=0 or SOCKET_ACTIVE=1
2660 
Returned value:
 2688 
Returned value:
2661 
  * eax = -1 = 0xFFFFFFFF - error; ebx destroys
 2689 
  * eax = -1 = 0xFFFFFFFF - error; ebx destroys
2662 
  * eax = socket handle (some number which unambiguously identifies
 2690 
  * eax = socket handle (some number which unambiguously identifies
2663 
    socket and have sense only for the system) - success;
 2691 
    socket and have sense only for the system) - success;
2664 
    ebx destroyed
 2692 
    ebx destroyed
2665 
 
 2693 
 
2666 
======================================================================
 2694 
======================================================================
2667 
========= Function 53, subfunction 6 - get TCP-socket status. ========
 2695 
========= Function 53, subfunction 6 - get TCP-socket status. ========
2668 
======================================================================
 2696 
======================================================================
2669 
Parameters:
 2697 
Parameters:
2670 
  * eax = 53 - function number
 2698 
  * eax = 53 - function number
2671 
  * ebx = 6 - subfunction number
 2699 
  * ebx = 6 - subfunction number
2672 
  * ecx = socket handle
 2700 
  * ecx = socket handle
2673 
Returned value:
 2701 
Returned value:
2674 
  * eax = socket status: one of
 2702 
  * eax = socket status: one of
2675 
  * TCB_LISTEN = 1
 2703 
  * TCB_LISTEN = 1
2676 
  * TCB_SYN_SENT = 2
 2704 
  * TCB_SYN_SENT = 2
2677 
  * TCB_SYN_RECEIVED = 3
 2705 
  * TCB_SYN_RECEIVED = 3
2678 
  * TCB_ESTABLISHED = 4
 2706 
  * TCB_ESTABLISHED = 4
2679 
  * TCB_FIN_WAIT_1 = 5
 2707 
  * TCB_FIN_WAIT_1 = 5
2680 
  * TCB_FIN_WAIT_2 = 6
 2708 
  * TCB_FIN_WAIT_2 = 6
2681 
  * TCB_CLOSE_WAIT = 7
 2709 
  * TCB_CLOSE_WAIT = 7
2682 
  * TCB_CLOSING = 8
 2710 
  * TCB_CLOSING = 8
2683 
  * TCB_LAST_ASK = 9
 2711 
  * TCB_LAST_ASK = 9
2684 
  * TCB_TIME_WAIT = 10
 2712 
  * TCB_TIME_WAIT = 10
2685 
  * TCB_CLOSED = 11
 2713 
  * TCB_CLOSED = 11
2686 
  * ebx destroys
 2714 
  * ebx destroys
2687 
Remarks:
 2715 
Remarks:
2688 
  * There is no checks for correctness.
 2716 
  * There is no checks for correctness.
2689 
 
 2717 
 
2690 
======================================================================
 2718 
======================================================================
2691 
========== Function 53, subfunction 7 - write to TCP-socket. =========
 2719 
========== Function 53, subfunction 7 - write to TCP-socket. =========
2692 
======================================================================
 2720 
======================================================================
2693 
Parameters:
 2721 
Parameters:
2694 
  * eax = 53 - function number
 2722 
  * eax = 53 - function number
2695 
  * ebx = 7 - subfunction number
 2723 
  * ebx = 7 - subfunction number
2696 
  * ecx = socket handle
 2724 
  * ecx = socket handle
2697 
  * edx = number of bytes to write
 2725 
  * edx = number of bytes to write
2698 
  * esi = pointer to data to write
 2726 
  * esi = pointer to data to write
2699 
Returned value:
 2727 
Returned value:
2700 
  * eax = 0xffffffff - error
 2728 
  * eax = 0xffffffff - error
2701 
  * eax = 0xffff - not enough memory
 2729 
  * eax = 0xffff - not enough memory
2702 
  * eax = 0 - success
 2730 
  * eax = 0 - success
2703 
  * ebx destroyed
 2731 
  * ebx destroyed
2704 
Remarks:
 2732 
Remarks:
2705 
  * Check on validity of handle is minimal - only not very incorrect
 2733 
  * Check on validity of handle is minimal - only not very incorrect
2706 
    not opened handles are eliminated.
 2734 
    not opened handles are eliminated.
2707 
  * Number of bytes to write must not exceed 1500-40, though
 2735 
  * Number of bytes to write must not exceed 1500-40, though
2708 
    the appropriate check is not made.
 2736 
    the appropriate check is not made.
2709 
 
 2737 
 
2710 
======================================================================
 2738 
======================================================================
2711 
=========== Function 53, subfunction 8 - close TCP-socket. ===========
 2739 
=========== Function 53, subfunction 8 - close TCP-socket. ===========
2712 
======================================================================
 2740 
======================================================================
2713 
Parameters:
 2741 
Parameters:
2714 
  * eax = 53 - function number
 2742 
  * eax = 53 - function number
2715 
  * ebx = 8 - subfunction number
 2743 
  * ebx = 8 - subfunction number
2716 
  * ecx = socket handle
 2744 
  * ecx = socket handle
2717 
Returned value:
 2745 
Returned value:
2718 
  * eax = -1 - invalid handle
 2746 
  * eax = -1 - invalid handle
2719 
  * eax = 0xffff - not enough memory for socket close packet
 2747 
  * eax = 0xffff - not enough memory for socket close packet
2720 
  * eax = 0 - success
 2748 
  * eax = 0 - success
2721 
  * in many cases eax is destroyed (the result of function 'queue'
 2749 
  * in many cases eax is destroyed (the result of function 'queue'
2722 
    is returned) - probably this is bug, which will be corrected
 2750 
    is returned) - probably this is bug, which will be corrected
2723 
  * ebx destroyed
 2751 
  * ebx destroyed
2724 
Remarks:
 2752 
Remarks:
2725 
  * The current implementation does not close automatically all
 2753 
  * The current implementation does not close automatically all
2726 
    sockets of a thread at termination. In particular, one should not
 2754 
    sockets of a thread at termination. In particular, one should not
2727 
    kill a thread with many opened sockets - there will be an outflow
 2755 
    kill a thread with many opened sockets - there will be an outflow
2728 
    of resources.
 2756 
    of resources.
2729 
  * The current implementation does no checks on correctness
 2757 
  * The current implementation does no checks on correctness
2730 
    (function returns error only if thread tries to close not opened
 2758 
    (function returns error only if thread tries to close not opened
2731 
    socket with correct handle).
 2759 
    socket with correct handle).
2732 
 
 2760 
 
2733 
======================================================================
 2761 
======================================================================
2734 
=== Function 53, subfunction 9 - check whether local port is free. ===
 2762 
=== Function 53, subfunction 9 - check whether local port is free. ===
2735 
======================================================================
 2763 
======================================================================
2736 
Parameters:
 2764 
Parameters:
2737 
  * eax = 53 - function number
 2765 
  * eax = 53 - function number
2738 
  * ebx = 9 - subfunction number
 2766 
  * ebx = 9 - subfunction number
2739 
  * ecx = local port number (low 16 bits are used only)
 2767 
  * ecx = local port number (low 16 bits are used only)
2740 
Returned value:
 2768 
Returned value:
2741 
  * eax = 0 - port is used
 2769 
  * eax = 0 - port is used
2742 
  * eax = 1 - port is free
 2770 
  * eax = 1 - port is free
2743 
  * ebx destroyed
 2771 
  * ebx destroyed
2744 
 
 2772 
 
2745 
======================================================================
 2773 
======================================================================
2746 
===== Function 53, subfunction 10 - query Ethernet cable status. =====
 2774 
===== Function 53, subfunction 10 - query Ethernet cable status. =====
2747 
======================================================================
 2775 
======================================================================
2748 
Parameters:
 2776 
Parameters:
2749 
  * eax = 53 - function number
 2777 
  * eax = 53 - function number
2750 
  * ebx = 10 - subfunction number
 2778 
  * ebx = 10 - subfunction number
2751 
Returned value:
 2779 
Returned value:
2752 
  * al = -1 - a network driver is not loaded or
 2780 
  * al = -1 - a network driver is not loaded or
2753 
              does not support this function
 2781 
              does not support this function
2754 
  * al = 0 - Ethernet cable is unplugged
 2782 
  * al = 0 - Ethernet cable is unplugged
2755 
  * al = 1 - Ethernet cable is plugged
 2783 
  * al = 1 - Ethernet cable is plugged
2756 
  * ebx destroyed
 2784 
  * ebx destroyed
2757 
Remarks:
 2785 
Remarks:
2758 
  * The current kernel implementation supports this function
 2786 
  * The current kernel implementation supports this function
2759 
    only for RTL8139 network cards.
 2787 
    only for RTL8139 network cards.
2760 
 
 2788 
 
2761 
======================================================================
 2789 
======================================================================
2762 
======= Function 53, subfunction 11 - read network stack data. =======
 2790 
======= Function 53, subfunction 11 - read network stack data. =======
2763 
======================================================================
 2791 
======================================================================
2764 
Paramters:
 2792 
Paramters:
2765 
  * eax = 53 - function number
 2793 
  * eax = 53 - function number
2766 
  * ebx = 11 - subfunction number
 2794 
  * ebx = 11 - subfunction number
2767 
  * ecx = socket handle
 2795 
  * ecx = socket handle
2768 
  * edx = pointer to buffer
 2796 
  * edx = pointer to buffer
2769 
  * esi = number of bytes to read;
 2797 
  * esi = number of bytes to read;
2770 
  * esi = 0 - read all data (maximum 4096 bytes)
 2798 
  * esi = 0 - read all data (maximum 4096 bytes)
2771 
Returned value:
 2799 
Returned value:
2772 
  * eax = number of bytes read
 2800 
  * eax = number of bytes read
2773 
  * ebx destroyed
 2801 
  * ebx destroyed
2774 
Remakrs:
 2802 
Remakrs:
2775 
  * There is no check on handle correctness.
 2803 
  * There is no check on handle correctness.
2776 
 
 2804 
 
2777 
======================================================================
 2805 
======================================================================
2778 
= Function 53, subfunction 255 - debug information of network driver.
2806 
= Function 53, subfunction 255 - debug information of network driver.
2779 
======================================================================
 2807 
======================================================================
2780 
Parameters:
 2808 
Parameters:
2781 
  * eax = 53 - function number
 2809 
  * eax = 53 - function number
2782 
  * ebx = 255 - subfunction number
 2810 
  * ebx = 255 - subfunction number
2783 
  * ecx = type of requested information (see below)
 2811 
  * ecx = type of requested information (see below)
2784 
Returned value:
 2812 
Returned value:
2785 
  * eax = requested information
 2813 
  * eax = requested information
2786 
  * ebx destroyed
 2814 
  * ebx destroyed
2787 
Possible values for ecx:
 2815 
Possible values for ecx:
2788 
  * 100: length of queue 0 (empty queue)
 2816 
  * 100: length of queue 0 (empty queue)
2789 
  * 101: length of queue 1 (ip-out queue)
 2817 
  * 101: length of queue 1 (ip-out queue)
2790 
  * 102: length of queue 2 (ip-in queue)
 2818 
  * 102: length of queue 2 (ip-in queue)
2791 
  * 103: length of queue 3 (net1out queue)
 2819 
  * 103: length of queue 3 (net1out queue)
2792 
  * 200: number of items in the ARP table
 2820 
  * 200: number of items in the ARP table
2793 
  * 201: size of the ARP table (in items) (20 for current version)
 2821 
  * 201: size of the ARP table (in items) (20 for current version)
2794 
  * 202: read item at edx of the ARP table to the temporary buffer,
 2822 
  * 202: read item at edx of the ARP table to the temporary buffer,
2795 
    whence 5 following types take information;
 2823 
    whence 5 following types take information;
2796 
    in this case eax is not defined
 2824 
    in this case eax is not defined
2797 
  * 203: IP-address saved by type 202
 2825 
  * 203: IP-address saved by type 202
2798 
  * 204: high dword of MAC-address saved by type 202
 2826 
  * 204: high dword of MAC-address saved by type 202
2799 
  * 205: low word of MAC-address saved by type 202
 2827 
  * 205: low word of MAC-address saved by type 202
2800 
  * 206: status word saved by type 202
 2828 
  * 206: status word saved by type 202
2801 
  * 207: ttl word saved by type 202
 2829 
  * 207: ttl word saved by type 202
2802 
  * 2: total number of received IP-packets
 2830 
  * 2: total number of received IP-packets
2803 
  * 3: total number of transferred IP-packets
 2831 
  * 3: total number of transferred IP-packets
2804 
  * 4: total number of dumped received packets
 2832 
  * 4: total number of dumped received packets
2805 
  * 5: total number of received ARP-packets
 2833 
  * 5: total number of received ARP-packets
2806 
  * 6: status of packet driver, 0=inactive, nonzero=active
 2834 
  * 6: status of packet driver, 0=inactive, nonzero=active
2807 
 
 2835 
 
2808 
======================================================================
 2836 
======================================================================
2809 
========== Function 55, subfunction 0 - load data for SB16. ==========
 2837 
========== Function 55, subfunction 0 - load data for SB16. ==========
2810 
======================================================================
 2838 
======================================================================
2811 
Parameters:
 2839 
Parameters:
2812 
  * eax = 55 - function number
 2840 
  * eax = 55 - function number
2813 
  * ebx = 0 - subfunction number
 2841 
  * ebx = 0 - subfunction number
2814 
  * ecx = pointer to data (is copied 64 kilobytes, is used as much as
 2842 
  * ecx = pointer to data (is copied 64 kilobytes, is used as much as
2815 
    set by subfunction 2)
 2843 
    set by subfunction 2)
2816 
Returned value:
 2844 
Returned value:
2817 
  * function does not return value
 2845 
  * function does not return value
2818 
Remarks:
 2846 
Remarks:
2819 
  * Format and size of data are set by subfunction 2.
 2847 
  * Format and size of data are set by subfunction 2.
2820 
 
 2848 
 
2821 
======================================================================
 2849 
======================================================================
2822 
======== Function 55, subfunction 1 - begin play data on SB16. =======
 2850 
======== Function 55, subfunction 1 - begin play data on SB16. =======
2823 
======================================================================
 2851 
======================================================================
2824 
Parameters:
 2852 
Parameters:
2825 
  * eax = 55 - function number
 2853 
  * eax = 55 - function number
2826 
  * ebx = 1 - subfunction number
 2854 
  * ebx = 1 - subfunction number
2827 
Returned value:
 2855 
Returned value:
2828 
  * function does not return value
 2856 
  * function does not return value
2829 
Remarks:
 2857 
Remarks:
2830 
  * Previously data must be loaded by subfunction 0 and
 2858 
  * Previously data must be loaded by subfunction 0 and
2831 
    their format must be defined by subfunction 2.
 2859 
    their format must be defined by subfunction 2.
2832 
  * Function returns control, when playing of data began; after that
 2860 
  * Function returns control, when playing of data began; after that
2833 
    play goes independently from application (and does not use
 2861 
    play goes independently from application (and does not use
2834 
    processor time at all).
 2862 
    processor time at all).
2835 
  * Previously must be defined SB16 base port
 2863 
  * Previously must be defined SB16 base port
2836 
    (by subfunction 4 of function 21) and DMA channel
 2864 
    (by subfunction 4 of function 21) and DMA channel
2837 
    (by subfunction 10 of function 21).
 2865 
    (by subfunction 10 of function 21).
2838 
 
 2866 
 
2839 
======================================================================
 2867 
======================================================================
2840 
======== Function 55, subfunction 2 - set format of SB16 data. =======
 2868 
======== Function 55, subfunction 2 - set format of SB16 data. =======
2841 
======================================================================
 2869 
======================================================================
2842 
Parameters:
 2870 
Parameters:
2843 
  * eax = 55 - function number
 2871 
  * eax = 55 - function number
2844 
  * ebx = 2 - subfunction number
 2872 
  * ebx = 2 - subfunction number
2845 
  * ecx = 0 - set digit capacity
 2873 
  * ecx = 0 - set digit capacity
2846 
    * edx = 1 - 8bit mono
 2874 
    * edx = 1 - 8bit mono
2847 
    * edx = 2 - 8bit stereo
 2875 
    * edx = 2 - 8bit stereo
2848 
  * ecx = 1 - set data size
 2876 
  * ecx = 1 - set data size
2849 
    * edx = size in bytes
 2877 
    * edx = size in bytes
2850 
  * ecx = 2 - set play frequency
 2878 
  * ecx = 2 - set play frequency
2851 
    * edx = frequency
 2879 
    * edx = frequency
2852 
Returned value:
 2880 
Returned value:
2853 
  * function does not return value
 2881 
  * function does not return value
2854 
Remarks:
 2882 
Remarks:
2855 
  * When the system boots, it sets following default parameters:
 2883 
  * When the system boots, it sets following default parameters:
2856 
    digit capacity - 8bit mono, size - 64 Kb, frequency - 44100 Hz.
 2884 
    digit capacity - 8bit mono, size - 64 Kb, frequency - 44100 Hz.
2857 
    Nevertheless it is recommended to set necessary values obviously
 2885 
    Nevertheless it is recommended to set necessary values obviously
2858 
    as they could be reset by some application.
 2886 
    as they could be reset by some application.
2859 
 
 2887 
 
2860 
======================================================================
 2888 
======================================================================
2861 
 Function 55, subfunction 55 - begin to play data on built-in speaker.
2889 
 Function 55, subfunction 55 - begin to play data on built-in speaker.
2862 
======================================================================
 2890 
======================================================================
2863 
Parameters:
 2891 
Parameters:
2864 
  * eax = 55 - function number
 2892 
  * eax = 55 - function number
2865 
  * ebx = 55 - subfunction number
 2893 
  * ebx = 55 - subfunction number
2866 
  * esi = pointer to data
 2894 
  * esi = pointer to data
2867 
Returned value:
 2895 
Returned value:
2868 
  * eax = 0 - success
 2896 
  * eax = 0 - success
2869 
  * eax = 55 - error (speaker is off or busy)
 2897 
  * eax = 55 - error (speaker is off or busy)
2870 
Data is an array of items with variable length.
 2898 
Data is an array of items with variable length.
2871 
Format of each item is defined by first byte:
 2899 
Format of each item is defined by first byte:
2872 
  * 0 = end of data
 2900 
  * 0 = end of data
2873 
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
 2901 
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
2874 
    is defined by immediate value of frequency
 2902 
    is defined by immediate value of frequency
2875 
    * following word (2 bytes) contains frequency divider;
 2903 
    * following word (2 bytes) contains frequency divider;
2876 
      frequency is defined as 1193180/divider
 2904 
      frequency is defined as 1193180/divider
2877 
  * 0x81 = invalid
 2905 
  * 0x81 = invalid
2878 
  * 0x82..0xFF = note is defined by octave and number:
 2906 
  * 0x82..0xFF = note is defined by octave and number:
2879 
    * duration in 1/100 of second = (first byte)-0x81
 2907 
    * duration in 1/100 of second = (first byte)-0x81
2880 
    * there is one more byte;
 2908 
    * there is one more byte;
2881 
    * (second byte)=0xFF - delay
 2909 
    * (second byte)=0xFF - delay
2882 
    * otherwise it looks like a*0x10+b, where b=number of the note in
 2910 
    * otherwise it looks like a*0x10+b, where b=number of the note in
2883 
      an octave from 1 to 12, a=number of octave (beginning from 0)
 2911 
      an octave from 1 to 12, a=number of octave (beginning from 0)
2884 
Remarks:
 2912 
Remarks:
2885 
  * Speaker play can be disabled/enabled by
 2913 
  * Speaker play can be disabled/enabled by
2886 
    subfunction 8 of function 18.
 2914 
    subfunction 8 of function 18.
2887 
  * Function returns control, having informed the system
 2915 
  * Function returns control, having informed the system
2888 
    an information on request. Play itself goes independently from
 2916 
    an information on request. Play itself goes independently from
2889 
    the program.
 2917 
    the program.
2890 
  * The data must be kept in the memory at least up to the end
 2918 
  * The data must be kept in the memory at least up to the end
2891 
    of play.
 2919 
    of play.
2892 
 
 2920 
 
2893 
======================================================================
 2921 
======================================================================
2894 
================ Function 58 - work with file system. ================
 2922 
================ Function 58 - work with file system. ================
2895 
======================================================================
 2923 
======================================================================
2896 
Parameters:
 2924 
Parameters:
2897 
  * eax = 58
 2925 
  * eax = 58
2898 
  * ebx = pointer to the information structure
 2926 
  * ebx = pointer to the information structure
2899 
Returned value:
 2927 
Returned value:
2900 
  * eax = 0 - success; otherwise file system error code
 2928 
  * eax = 0 - success; otherwise file system error code
2901 
  * some subfunctions return value in other registers too
 2929 
  * some subfunctions return value in other registers too
2902 
General format of the information structure:
 2930 
General format of the information structure:
2903 
  * +0: dword: subfunction number
 2931 
  * +0: dword: subfunction number
2904 
  * +4: dword: number of block
 2932 
  * +4: dword: number of block
2905 
  * +8: dword: size
 2933 
  * +8: dword: size
2906 
  * +12 = +0xC: dword: pointer to data
 2934 
  * +12 = +0xC: dword: pointer to data
2907 
  * +16 = +0x10: dword: pointer to a memory for system operations
 2935 
  * +16 = +0x10: dword: pointer to a memory for system operations
2908 
    (4096 bytes)
 2936 
    (4096 bytes)
2909 
  * +20 = +0x14: n db: ASCIIZ-string with the file name
 2937 
  * +20 = +0x14: n db: ASCIIZ-string with the file name
2910 
Specifications - in documentation on the appropriate subfunction.
 2938 
Specifications - in documentation on the appropriate subfunction.
2911 
Filename is case-insensitive for latin letters, russian letters
 2939 
Filename is case-insensitive for latin letters, russian letters
2912 
must be capital.
 2940 
must be capital.
2913 
Format of filename:
 2941 
Format of filename:
2914 
/base/number/dir1/dir2/.../dirn/file,
 2942 
/base/number/dir1/dir2/.../dirn/file,
2915 
where /base/number identifies device, on which file is located:
 2943 
where /base/number identifies device, on which file is located:
2916 
one of
 2944 
one of
2917 
  * /RD/1 = /RAMDISK/1 to access ramdisk
 2945 
  * /RD/1 = /RAMDISK/1 to access ramdisk
2918 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
 2946 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
2919 
    /FD/2 = /FLOPPYDISK/2 to access second one
 2947 
    /FD/2 = /FLOPPYDISK/2 to access second one
2920 
  * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk
 2948 
  * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk
2921 
    (in this case base is defined by subfunction 7 of function 21),
 2949 
    (in this case base is defined by subfunction 7 of function 21),
2922 
    x - partition number (beginning from 1)
 2950 
    x - partition number (beginning from 1)
2923 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
 2951 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
2924 
    IDE0 (Primary Master), IDE1 (Primary Slave),
 2952 
    IDE0 (Primary Master), IDE1 (Primary Slave),
2925 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
 2953 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2926 
    x - partition number on the selected hard drive, varies from 1
 2954 
    x - partition number on the selected hard drive, varies from 1
2927 
    to 255 (on each hard drive the indexing starts from 1)
 2955 
    to 255 (on each hard drive the indexing starts from 1)
2928 
Remarks:
 2956 
Remarks:
2929 
  * In the first two cases it is also possible to use FIRST
 2957 
  * In the first two cases it is also possible to use FIRST
2930 
    instead of 1, SECOND instead of 2, but it is not recommended
 2958 
    instead of 1, SECOND instead of 2, but it is not recommended
2931 
    for convenience of transition to the future extensions.
 2959 
    for convenience of transition to the future extensions.
2932 
  * Limitation n<=39 is imposed.
 2960 
  * Limitation n<=39 is imposed.
2933 
  * Names of folders and file dir1,...,dirn,file must have the
 2961 
  * Names of folders and file dir1,...,dirn,file must have the
2934 
    format 8.3: name no more than 8 characters, dot, extension no
 2962 
    format 8.3: name no more than 8 characters, dot, extension no
2935 
    more than 3 characters. Trailing spaces are ignored, no other
 2963 
    more than 3 characters. Trailing spaces are ignored, no other
2936 
    spaces is allowed. If name occupies equally 8 characters,
 2964 
    spaces is allowed. If name occupies equally 8 characters,
2937 
    dot may be omitted (though it is not recommended to use this
 2965 
    dot may be omitted (though it is not recommended to use this
2938 
    feature for convenience of transition to the future extensions).
 2966 
    feature for convenience of transition to the future extensions).
2939 
  * This function does not support folders on ramdisk.
 2967 
  * This function does not support folders on ramdisk.
2940 
Examples:
 2968 
Examples:
2941 
  * '/RAMDISK/FIRST/KERNEL.ASM',0
 2969 
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2942 
    '/rd/1/kernel.asm',0
 2970 
    '/rd/1/kernel.asm',0
2943 
  * '/HD0/1/kernel.asm',0
 2971 
  * '/HD0/1/kernel.asm',0
2944 
  * '/hd0/1/menuet/pics/tanzania.bmp',0
 2972 
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2945 
Existing subfunctions:
 2973 
Existing subfunctions:
2946 
  * subfunction 0 - read file/folder
 2974 
  * subfunction 0 - read file/folder
2947 
  * subfunction 8 - LBA-read from device
 2975 
  * subfunction 8 - LBA-read from device
2948 
  * subfunction 15 - get file system information
 2976 
  * subfunction 15 - get file system information
2949 
 
 2977 
 
2950 
======================================================================
 2978 
======================================================================
2951 
=========== Function 58, subfunction 0 - read file/folder. ===========
 2979 
=========== Function 58, subfunction 0 - read file/folder. ===========
2952 
======================================================================
 2980 
======================================================================
2953 
Parameters:
 2981 
Parameters:
2954 
  * eax = 58
 2982 
  * eax = 58
2955 
  * ebx = pointer to the information structure
 2983 
  * ebx = pointer to the information structure
2956 
Format of the information structure:
 2984 
Format of the information structure:
2957 
  * +0: dword: 0 = subfunction number
 2985 
  * +0: dword: 0 = subfunction number
2958 
  * +4: dword: first block to read (beginning from 0)
 2986 
  * +4: dword: first block to read (beginning from 0)
2959 
  * +8: dword: amount of blocks to read
 2987 
  * +8: dword: amount of blocks to read
2960 
  * +12 = +0xC: dword: pointer to buffer for data
 2988 
  * +12 = +0xC: dword: pointer to buffer for data
2961 
  * +16 = +0x10: dword: pointer to buffer for system operations
 2989 
  * +16 = +0x10: dword: pointer to buffer for system operations
2962 
    (4096 bytes)
 2990 
    (4096 bytes)
2963 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 2991 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
2964 
    given in the general description
 2992 
    given in the general description
2965 
Returned value:
 2993 
Returned value:
2966 
  * eax = 0 - success, otherwise file system error code
 2994 
  * eax = 0 - success, otherwise file system error code
2967 
  * ebx = file size (in bytes) or -1=0xffffffff, if file was not found
 2995 
  * ebx = file size (in bytes) or -1=0xffffffff, if file was not found
2968 
Remarks:
 2996 
Remarks:
2969 
  * Block size is 512 bytes.
 2997 
  * Block size is 512 bytes.
2970 
  * This function is obsolete, for reading files use subfunction 0
 2998 
  * This function is obsolete, for reading files use subfunction 0
2971 
    of function 70, for reading folders - subfunction 1 of
 2999 
    of function 70, for reading folders - subfunction 1 of
2972 
    function 70.
 3000 
    function 70.
2973 
  * Function can read contents of a folder. Only FAT file system is
 3001 
  * Function can read contents of a folder. Only FAT file system is
2974 
    supported. The format of FAT-folder is described
 3002 
    supported. The format of FAT-folder is described
2975 
    in any FAT documentation.
 3003 
    in any FAT documentation.
2976 
  * Size of a folder is determined by size of FAT clusters chain.
 3004 
  * Size of a folder is determined by size of FAT clusters chain.
2977 
  * If file was ended before last requested block was read,
 3005 
  * If file was ended before last requested block was read,
2978 
    the function will read as many as it can, and after that return
 3006 
    the function will read as many as it can, and after that return
2979 
    eax=6 (EOF).
 3007 
    eax=6 (EOF).
2980 
  * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but
 3008 
  * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but
2981 
    in the first two cases the current implementation does not follow
 3009 
    in the first two cases the current implementation does not follow
2982 
    to the declared rules:
 3010 
    to the declared rules:
2983 
    for /rd/1:
 3011 
    for /rd/1:
2984 
    * if one want to read 0 blocks, function considers,
 3012 
    * if one want to read 0 blocks, function considers,
2985 
      that he requested 1;
 3013 
      that he requested 1;
2986 
    * if one requests more than 14 blocks or starting block is
 3014 
    * if one requests more than 14 blocks or starting block is
2987 
      not less than 14, function returns eax=5 (not found) è ebx=-1;
 3015 
      not less than 14, function returns eax=5 (not found) è ebx=-1;
2988 
    * size of ramdisk root folder is 14 blocks,
3016 
    * size of ramdisk root folder is 14 blocks,
2989 
      0x1C00=7168 áàéò; but function returns ebx=0
 3017 
      0x1C00=7168 áàéò; but function returns ebx=0
2990 
      (except of the case of previous item);
 3018 
      (except of the case of previous item);
2991 
    * strangely enough, it is possible to read 14th block (which
 3019 
    * strangely enough, it is possible to read 14th block (which
2992 
      generally contains a garbage - I remind, the indexing begins
 3020 
      generally contains a garbage - I remind, the indexing begins
2993 
      from 0);
 3021 
      from 0);
2994 
    * if some block with the number not less than 14 was requested,
 3022 
    * if some block with the number not less than 14 was requested,
2995 
      function returns eax=6(EOF); otherwise eax=0.
 3023 
      function returns eax=6(EOF); otherwise eax=0.
2996 
    For /fd/x:
 3024 
    For /fd/x:
2997 
    * if the start block is not less than 14, function returns
 3025 
    * if the start block is not less than 14, function returns
2998 
      eax=5 (not found) and ebx=0;
 3026 
      eax=5 (not found) and ebx=0;
2999 
    * note that format of FAT12 allows floppies with the root size
 3027 
    * note that format of FAT12 allows floppies with the root size
3000 
      more or less than 14 blocks;
 3028 
      more or less than 14 blocks;
3001 
    * check for length is not performed;
 3029 
    * check for length is not performed;
3002 
    * if data was successful read, function returns
 3030 
    * if data was successful read, function returns
3003 
      eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1.
 3031 
      eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1.
3004 
  * The function handles reading of special folders /,/rd,/fd,/hd[n];
 3032 
  * The function handles reading of special folders /,/rd,/fd,/hd[n];
3005 
    but the result does not correspond to expected (on operations with
 3033 
    but the result does not correspond to expected (on operations with
3006 
    normal files/folders), does not follow the declared rules,
 3034 
    normal files/folders), does not follow the declared rules,
3007 
    may be changed in future versions of the kernel and consequently
 3035 
    may be changed in future versions of the kernel and consequently
3008 
    is not described. To obtain the information about the equipment
 3036 
    is not described. To obtain the information about the equipment
3009 
    use subfunction 11 of function 18 or
 3037 
    use subfunction 11 of function 18 or
3010 
    read corresponding folder with subfunction 1 of function 70.
 3038 
    read corresponding folder with subfunction 1 of function 70.
3011 
 
 3039 
 
3012 
======================================================================
 3040 
======================================================================
3013 
========= Function 58, subfunction 8 - LBA-read from device. =========
 3041 
========= Function 58, subfunction 8 - LBA-read from device. =========
3014 
======================================================================
 3042 
======================================================================
3015 
Parameters:
 3043 
Parameters:
3016 
  * eax = 58 - function number
 3044 
  * eax = 58 - function number
3017 
  * ebx = pointer to the information structure
 3045 
  * ebx = pointer to the information structure
3018 
Format of the information structure:
 3046 
Format of the information structure:
3019 
  * +0: dword: 8 = subfunction number
 3047 
  * +0: dword: 8 = subfunction number
3020 
  * +4: dword: number of block to read (beginning from 0)
 3048 
  * +4: dword: number of block to read (beginning from 0)
3021 
  * +8: dword: ignored (set to 1)
 3049 
  * +8: dword: ignored (set to 1)
3022 
  * +12 = +0xC: dword: pointer to buffer for data (512 bytes)
 3050 
  * +12 = +0xC: dword: pointer to buffer for data (512 bytes)
3023 
  * +16 = +0x10: dword: pointer to buffer for system operations
 3051 
  * +16 = +0x10: dword: pointer to buffer for system operations
3024 
    (4096 bytes)
 3052 
    (4096 bytes)
3025 
  * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of
 3053 
  * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of
3026 
    /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
 3054 
    /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
3027 
    1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3.
 3055 
    1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3.
3028 
    Instead of digits it is allowed, though not recommended for
 3056 
    Instead of digits it is allowed, though not recommended for
3029 
    convenience of transition to future extensions, to use
 3057 
    convenience of transition to future extensions, to use
3030 
    'first','second','third','fourth'.
 3058 
    'first','second','third','fourth'.
3031 
Returned value:
 3059 
Returned value:
3032 
  * for device name /hd/xxx, where xxx is not in the list above:
 3060 
  * for device name /hd/xxx, where xxx is not in the list above:
3033 
    * eax = ebx = 1
 3061 
    * eax = ebx = 1
3034 
  * for invalid device name (except for the previous case):
 3062 
  * for invalid device name (except for the previous case):
3035 
    * eax = 5
 3063 
    * eax = 5
3036 
    * ebx does not change
 3064 
    * ebx does not change
3037 
  * if LBA-access is disabled by subfunction 11 of function 21:
 3065 
  * if LBA-access is disabled by subfunction 11 of function 21:
3038 
    * eax = 2
 3066 
    * eax = 2
3039 
    * ebx destroyed
 3067 
    * ebx destroyed
3040 
  * for ramdisk: attempt to read block outside ramdisk
 3068 
  * for ramdisk: attempt to read block outside ramdisk
3041 
    (18*2*80 blocks) results in
 3069 
    (18*2*80 blocks) results in
3042 
    * eax = 3
 3070 
    * eax = 3
3043 
    * ebx = 0
 3071 
    * ebx = 0
3044 
  * for successful read:
 3072 
  * for successful read:
3045 
    * eax = ebx = 0
 3073 
    * eax = ebx = 0
3046 
Remarks:
 3074 
Remarks:
3047 
  * Block size is 512 bytes; function reads one block.
 3075 
  * Block size is 512 bytes; function reads one block.
3048 
  * Do not depend on returned value, it can be changed
 3076 
  * Do not depend on returned value, it can be changed
3049 
    in future versions.
 3077 
    in future versions.
3050 
  * Function requires that LBA-access to devices is enabled by
3078 
  * Function requires that LBA-access to devices is enabled by
3051 
    subfunction 11 of function 21. To check this one can use
3079 
    subfunction 11 of function 21. To check this one can use
3052 
    subfunction 11 of function 26.
 3080 
    subfunction 11 of function 26.
3053 
  * LBA-read of floppy is not supported.
 3081 
  * LBA-read of floppy is not supported.
3054 
  * Function reads data on physical hard drive; if for any reason
 3082 
  * Function reads data on physical hard drive; if for any reason
3055 
    data of the concrete partition are required, application must
 3083 
    data of the concrete partition are required, application must
3056 
    define starting sector of this partition (either directly
 3084 
    define starting sector of this partition (either directly
3057 
    through MBR, or from the full structure returned by
 3085 
    through MBR, or from the full structure returned by
3058 
    ïîäôóíêöèåé 11 ôóíêöèè 18).
 3086 
    ïîäôóíêöèåé 11 ôóíêöèè 18).
3059 
  * Function does not check error code of hard disk, so request of
 3087 
  * Function does not check error code of hard disk, so request of
3060 
    nonexisting sector reads something (most probably it will be
 3088 
    nonexisting sector reads something (most probably it will be
3061 
    zeroes, but this is defined by device) and this is considered
 3089 
    zeroes, but this is defined by device) and this is considered
3062 
    as success (eax=0).
 3090 
    as success (eax=0).
3063 
 
 3091 
 
3064 
======================================================================
 3092 
======================================================================
3065 
==== Function 58, subfunction 15 - get information on file system. ===
 3093 
==== Function 58, subfunction 15 - get information on file system. ===
3066 
======================================================================
 3094 
======================================================================
3067 
Parameters:
 3095 
Parameters:
3068 
  * eax = 58 - function number
 3096 
  * eax = 58 - function number
3069 
  * ebx = pointer to the information structure
 3097 
  * ebx = pointer to the information structure
3070 
Format of the information structure:
 3098 
Format of the information structure:
3071 
  * +0: dword: 15 = subfunction number
 3099 
  * +0: dword: 15 = subfunction number
3072 
  * +4: dword: ignored
 3100 
  * +4: dword: ignored
3073 
  * +8: dword: ignored
 3101 
  * +8: dword: ignored
3074 
  * +12 = +0xC: dword: ignored
 3102 
  * +12 = +0xC: dword: ignored
3075 
  * +16 = +0x10: dword: ignored
 3103 
  * +16 = +0x10: dword: ignored
3076 
  * +20 = +0x14: (only second character is checked)
 3104 
  * +20 = +0x14: (only second character is checked)
3077 
    /rd=/RAMDISK or /hd=/HARDDISK
 3105 
    /rd=/RAMDISK or /hd=/HARDDISK
3078 
Returned value:
 3106 
Returned value:
3079 
  * if the second character does not belong to set {'r','R','h','H'}:
 3107 
  * if the second character does not belong to set {'r','R','h','H'}:
3080 
    * eax = 3
 3108 
    * eax = 3
3081 
    * ebx = ecx = dword [fileinfo] = 0
 3109 
    * ebx = ecx = dword [fileinfo] = 0
3082 
  * for ramdisk:
 3110 
  * for ramdisk:
3083 
    * eax = 0 (success)
 3111 
    * eax = 0 (success)
3084 
    * ebx = total number of clusters = 2847
 3112 
    * ebx = total number of clusters = 2847
3085 
    * ecx = number of free clusters
 3113 
    * ecx = number of free clusters
3086 
    * dword [fileinfo] = cluster size = 512
 3114 
    * dword [fileinfo] = cluster size = 512
3087 
  * for hard disk: base and partition are defined by subfunctions
 3115 
  * for hard disk: base and partition are defined by subfunctions
3088 
    7 and 8 of function 21:
 3116 
    7 and 8 of function 21:
3089 
    * eax = 0 (success)
 3117 
    * eax = 0 (success)
3090 
    * ebx = total number of clusters
 3118 
    * ebx = total number of clusters
3091 
    * ecx = number of free clusters
 3119 
    * ecx = number of free clusters
3092 
    * dword [fileinfo] = cluster size (in bytes)
 3120 
    * dword [fileinfo] = cluster size (in bytes)
3093 
Remarks:
 3121 
Remarks:
3094 
  * Be not surprised to strange layout of 4th returned parameter
 3122 
  * Be not surprised to strange layout of 4th returned parameter
3095 
    - when this code was writing, at system calls application got
 3123 
    - when this code was writing, at system calls application got
3096 
    only registers eax,ebx,ecx (from pushad-structure transmitted
 3124 
    only registers eax,ebx,ecx (from pushad-structure transmitted
3097 
    as argument to the system function). Now it is corrected, so,
 3125 
    as argument to the system function). Now it is corrected, so,
3098 
    probably, it is meaningful to return cluster size in edx, while
 3126 
    probably, it is meaningful to return cluster size in edx, while
3099 
    this function is not used yet.
 3127 
    this function is not used yet.
3100 
  * There exists also subfunction 11 of function 18,
 3128 
  * There exists also subfunction 11 of function 18,
3101 
    which returns information on file system. From the full table
 3129 
    which returns information on file system. From the full table
3102 
    of disk subsystem it is possible to deduce cluster size (there
 3130 
    of disk subsystem it is possible to deduce cluster size (there
3103 
    it is stored in sectors) and total number of clusters
 3131 
    it is stored in sectors) and total number of clusters
3104 
    for hard disks.
 3132 
    for hard disks.
3105 
 
 3133 
 
3106 
======================================================================
 3134 
======================================================================
3107 
========== Function 60 - Inter Process Communication (IPC). ==========
 3135 
========== Function 60 - Inter Process Communication (IPC). ==========
3108 
======================================================================
 3136 
======================================================================
3109 
IPC is used for message dispatching from one process/thread to
 3137 
IPC is used for message dispatching from one process/thread to
3110 
another. Previously it is necessary to agree how to interpret
 3138 
another. Previously it is necessary to agree how to interpret
3111 
the concrete message.
 3139 
the concrete message.
3112 
 
 3140 
 
3113 
----------- Subfunction 1 - set the area for IPC receiving -----------
 3141 
----------- Subfunction 1 - set the area for IPC receiving -----------
3114 
Is called by process-receiver.
 3142 
Is called by process-receiver.
3115 
Parameters:
 3143 
Parameters:
3116 
  * eax = 60 - function number
 3144 
  * eax = 60 - function number
3117 
  * ebx = 1 - subfunction number
 3145 
  * ebx = 1 - subfunction number
3118 
  * ecx = pointer to the buffer
 3146 
  * ecx = pointer to the buffer
3119 
  * edx = size of the buffer
 3147 
  * edx = size of the buffer
3120 
Returned value:
 3148 
Returned value:
3121 
  * eax = 0 - always success
 3149 
  * eax = 0 - always success
3122 
Format of IPC-buffer:
 3150 
Format of IPC-buffer:
3123 
  * +0: dword: if nonzero, buffer is considered locked;
 3151 
  * +0: dword: if nonzero, buffer is considered locked;
3124 
    lock/unlock the buffer, when you work with it and need that
 3152 
    lock/unlock the buffer, when you work with it and need that
3125 
    buffer data are not changed from outside (no new messages)
 3153 
    buffer data are not changed from outside (no new messages)
3126 
  * +4: dword: occupied place in the buffer (in bytes)
 3154 
  * +4: dword: occupied place in the buffer (in bytes)
3127 
  * +8: first message
 3155 
  * +8: first message
3128 
  * +8+n: second message
 3156 
  * +8+n: second message
3129 
  * ...
 3157 
  * ...
3130 
Format of a message:
 3158 
Format of a message:
3131 
  * +0: dword: PID of sender
 3159 
  * +0: dword: PID of sender
3132 
  * +4: dword: message length (not including this header)
 3160 
  * +4: dword: message length (not including this header)
3133 
  * +8: n*byte: message data
 3161 
  * +8: n*byte: message data
3134 
 
 3162 
 
3135 
------------------ Subfunction 2 - send IPC message ------------------
 3163 
------------------ Subfunction 2 - send IPC message ------------------
3136 
Is called by process-sender.
 3164 
Is called by process-sender.
3137 
Parameters:
 3165 
Parameters:
3138 
  * eax = 60 - function number
 3166 
  * eax = 60 - function number
3139 
  * ebx = 2 - subfunction number
 3167 
  * ebx = 2 - subfunction number
3140 
  * ecx = PID of receiver
 3168 
  * ecx = PID of receiver
3141 
  * edx = pointer to the message data
 3169 
  * edx = pointer to the message data
3142 
  * esi = message length (in bytes)
 3170 
  * esi = message length (in bytes)
3143 
Returned value:
 3171 
Returned value:
3144 
  * eax = 0 - success
 3172 
  * eax = 0 - success
3145 
  * eax = 1 - the receiver has not defined buffer for IPC messages
 3173 
  * eax = 1 - the receiver has not defined buffer for IPC messages
3146 
    (can be, still have no time,
 3174 
    (can be, still have no time,
3147 
    and can be, this is not right process)
 3175 
    and can be, this is not right process)
3148 
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
 3176 
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
3149 
  * eax = 3 - overflow of IPC-buffer of the receiver
 3177 
  * eax = 3 - overflow of IPC-buffer of the receiver
3150 
  * eax = 4 - process/thread with such PID does not exist
 3178 
  * eax = 4 - process/thread with such PID does not exist
3151 
Remarks:
 3179 
Remarks:
3152 
  * Immediately after writing of IPC-message to the buffer the system
 3180 
  * Immediately after writing of IPC-message to the buffer the system
3153 
    sends to the receiver the event with code 7 (see event codes).
 3181 
    sends to the receiver the event with code 7 (see event codes).
3154 
 
 3182 
 
3155 
======================================================================
 3183 
======================================================================
3156 
==== Function 61 - get parameters for the direct graphics access. ====
 3184 
==== Function 61 - get parameters for the direct graphics access. ====
3157 
======================================================================
 3185 
======================================================================
3158 
The data of the graphics screen (the memory area which displays
 3186 
The data of the graphics screen (the memory area which displays
3159 
screen contents) are accessible to a program directly, without
 3187 
screen contents) are accessible to a program directly, without
3160 
any system calls, through the selector gs:
 3188 
any system calls, through the selector gs:
3161 
	mov	eax, [gs:0]
 3189 
	mov	eax, [gs:0]
3162 
places in eax the first dword of the buffer, which contains
 3190 
places in eax the first dword of the buffer, which contains
3163 
information on color of the left upper point (and, possibly, colors
 3191 
information on color of the left upper point (and, possibly, colors
3164 
of several following).
 3192 
of several following).
3165 
	mov	[gs:0], eax
 3193 
	mov	[gs:0], eax
3166 
by work in VESA modes with LFB sets color of the left upper point
 3194 
by work in VESA modes with LFB sets color of the left upper point
3167 
(and, possibly, colors of several following).
 3195 
(and, possibly, colors of several following).
3168 
To interpret the data of graphics screen program needs to know
 3196 
To interpret the data of graphics screen program needs to know
3169 
some parameters, returning by this function.
 3197 
some parameters, returning by this function.
3170 
Remarks:
 3198 
Remarks:
3171 
  * Graphics parameters changes very seldom at work,
 3199 
  * Graphics parameters changes very seldom at work,
3172 
    namely, only in cases, when user works with the application VRR.
 3200 
    namely, only in cases, when user works with the application VRR.
3173 
  * At videomode change the system redraws all windows (event
 3201 
  * At videomode change the system redraws all windows (event
3174 
    with code 1) and redraws the background (event 5).
 3202 
    with code 1) and redraws the background (event 5).
3175 
    Same events occur in other cases too, which meet much more often,
 3203 
    Same events occur in other cases too, which meet much more often,
3176 
    than videomode change.
 3204 
    than videomode change.
3177 
  * By operation in videomodes with LFB the selector gs points to
 3205 
  * By operation in videomodes with LFB the selector gs points to
3178 
    LFB itself, so reading/writing on gs result directly in
 3206 
    LFB itself, so reading/writing on gs result directly in
3179 
    change of screen contents. By operation in videomodes without
 3207 
    change of screen contents. By operation in videomodes without
3180 
    LFB gs points to some data area in the kernel, and all functions
 3208 
    LFB gs points to some data area in the kernel, and all functions
3181 
    of screen output fulfil honesty double operation on writing
 3209 
    of screen output fulfil honesty double operation on writing
3182 
    directly to the screen and writing to this buffer. In result
 3210 
    directly to the screen and writing to this buffer. In result
3183 
    at reading contents of this buffer the results correspond to
 3211 
    at reading contents of this buffer the results correspond to
3184 
    screen contents (with, generally speaking, large color
 3212 
    screen contents (with, generally speaking, large color
3185 
    resolution), and writing is ignored.
 3213 
    resolution), and writing is ignored.
3186 
    One exception is the mode 320*200, for which main loop of the
 3214 
    One exception is the mode 320*200, for which main loop of the
3187 
    system thread updates the screen according to mouse movements.
 3215 
    system thread updates the screen according to mouse movements.
3188 
 
 3216 
 
3189 
------------------------- Screen resolution --------------------------
 3217 
------------------------- Screen resolution --------------------------
3190 
Parameters:
 3218 
Parameters:
3191 
  * eax = 61 - function number
 3219 
  * eax = 61 - function number
3192 
  * ebx = 1 - subfunction number
 3220 
  * ebx = 1 - subfunction number
3193 
Returned value:
 3221 
Returned value:
3194 
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
 3222 
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
3195 
Remarks:
 3223 
Remarks:
3196 
  * One can use function 14 paying attention that
 3224 
  * One can use function 14 paying attention that
3197 
    it returns sizes on 1 pixel less. It is fully equivalent way.
 3225 
    it returns sizes on 1 pixel less. It is fully equivalent way.
3198 
 
 3226 
 
3199 
---------------------- Number of bits per pixel ----------------------
 3227 
---------------------- Number of bits per pixel ----------------------
3200 
Parameters:
 3228 
Parameters:
3201 
  * eax = 61 - function number
 3229 
  * eax = 61 - function number
3202 
  * ebx = 2 - subfunction number
 3230 
  * ebx = 2 - subfunction number
3203 
Returned value:
 3231 
Returned value:
3204 
  * eax = number of bits per pixel (24 or 32)
 3232 
  * eax = number of bits per pixel (24 or 32)
3205 
 
 3233 
 
3206 
-------------------- Number of bytes per scanline --------------------
 3234 
-------------------- Number of bytes per scanline --------------------
3207 
Parameters:
 3235 
Parameters:
3208 
  * eax = 61 - function number
 3236 
  * eax = 61 - function number
3209 
  * ebx = 3 - subfunction number
 3237 
  * ebx = 3 - subfunction number
3210 
Returned value:
 3238 
Returned value:
3211 
  * eax = number of bytes occupied by one scanline
 3239 
  * eax = number of bytes occupied by one scanline
3212 
    (horizontal line on the screen)
 3240 
    (horizontal line on the screen)
3213 
 
 3241 
 
3214 
======================================================================
 3242 
======================================================================
3215 
===== Function 62, subfunction 0 - get version of PCI-interface. =====
 3243 
===== Function 62, subfunction 0 - get version of PCI-interface. =====
3216 
======================================================================
 3244 
======================================================================
3217 
Parameters:
 3245 
Parameters:
3218 
  * eax = 62 - function number
 3246 
  * eax = 62 - function number
3219 
  * bl = 0 - subfunction number
 3247 
  * bl = 0 - subfunction number
3220 
Returned value:
 3248 
Returned value:
3221 
  * eax = -1 - PCI access is disabled; otherwise
 3249 
  * eax = -1 - PCI access is disabled; otherwise
3222 
  * ah.al = version of PCI-interface (ah=version, al=subversion)
 3250 
  * ah.al = version of PCI-interface (ah=version, al=subversion)
3223 
  * high word of eax is zeroed
 3251 
  * high word of eax is zeroed
3224 
Remarks:
 3252 
Remarks:
3225 
  * Previously low-level access to PCI for applications must be
 3253 
  * Previously low-level access to PCI for applications must be
3226 
    enabled by subfunction 12 of function 21.
 3254 
    enabled by subfunction 12 of function 21.
3227 
  * If PCI BIOS is not supported, the value of ax is undefined.
 3255 
  * If PCI BIOS is not supported, the value of ax is undefined.
3228 
 
 3256 
 
3229 
======================================================================
 3257 
======================================================================
3230 
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
 3258 
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
3231 
======================================================================
 3259 
======================================================================
3232 
Parameters:
 3260 
Parameters:
3233 
  * eax = 62 - function number
 3261 
  * eax = 62 - function number
3234 
  * bl = 1 - subfunction number
 3262 
  * bl = 1 - subfunction number
3235 
Returned value:
 3263 
Returned value:
3236 
  * eax = -1 - access to PCI is disabled; otherwise
 3264 
  * eax = -1 - access to PCI is disabled; otherwise
3237 
  * al = number of the last PCI-bus; other bytes of eax are destroyed
 3265 
  * al = number of the last PCI-bus; other bytes of eax are destroyed
3238 
Remarks:
 3266 
Remarks:
3239 
  * Previously low-level access to PCI for applications must be
 3267 
  * Previously low-level access to PCI for applications must be
3240 
    enabled by subfunction 12 of function 21.
 3268 
    enabled by subfunction 12 of function 21.
3241 
  * If PCI BIOS is not supported, the value of ax is undefined.
 3269 
  * If PCI BIOS is not supported, the value of ax is undefined.
3242 
 
 3270 
 
3243 
======================================================================
 3271 
======================================================================
3244 
===================== Function 62, subfunction 2 =====================
 3272 
===================== Function 62, subfunction 2 =====================
3245 
===== Get mechanism of addressing to the PCI configuration space. ====
 3273 
===== Get mechanism of addressing to the PCI configuration space. ====
3246 
======================================================================
 3274 
======================================================================
3247 
Parameters:
 3275 
Parameters:
3248 
  * eax = 62 - function number
 3276 
  * eax = 62 - function number
3249 
  * bl = 2 - subfunction number
 3277 
  * bl = 2 - subfunction number
3250 
Returned value:
 3278 
Returned value:
3251 
  * eax = -1 - access to PCI is disabled; otherwise
 3279 
  * eax = -1 - access to PCI is disabled; otherwise
3252 
  * al = mechanism (1 or 2); other bytes of eax are destroyed
 3280 
  * al = mechanism (1 or 2); other bytes of eax are destroyed
3253 
Remarks:
 3281 
Remarks:
3254 
  * Previously low-level access to PCI for applications must be
 3282 
  * Previously low-level access to PCI for applications must be
3255 
    enabled by subfunction 12 of function 21.
 3283 
    enabled by subfunction 12 of function 21.
3256 
  * Addressing mechanism is selected depending on
 3284 
  * Addressing mechanism is selected depending on
3257 
    equipment characteristics.
 3285 
    equipment characteristics.
3258 
  * Subfunctions of read and write work automatically
 3286 
  * Subfunctions of read and write work automatically
3259 
    with the selected mechanism.
 3287 
    with the selected mechanism.
3260 
 
 3288 
 
3261 
======================================================================
 3289 
======================================================================
3262 
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
 3290 
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
3263 
======================================================================
 3291 
======================================================================
3264 
Parameters:
 3292 
Parameters:
3265 
  * eax = 62 - function number
 3293 
  * eax = 62 - function number
3266 
  * bl = 4 - read byte
 3294 
  * bl = 4 - read byte
3267 
  * bl = 5 - read word
 3295 
  * bl = 5 - read word
3268 
  * bl = 6 - read dword
 3296 
  * bl = 6 - read dword
3269 
  * bh = number of PCI-bus
 3297 
  * bh = number of PCI-bus
3270 
  * ch = dddddfff, where ddddd = number of the device on the bus,
 3298 
  * ch = dddddfff, where ddddd = number of the device on the bus,
3271 
    fff = function number of device
 3299 
    fff = function number of device
3272 
  * cl = number of register (must be even for bl=5,
 3300 
  * cl = number of register (must be even for bl=5,
3273 
    divisible by 4 for bl=6)
 3301 
    divisible by 4 for bl=6)
3274 
Returned value:
 3302 
Returned value:
3275 
  * eax = -1 - error (access to PCI is disabled or parameters
 3303 
  * eax = -1 - error (access to PCI is disabled or parameters
3276 
    are not supported); otherwise
 3304 
    are not supported); otherwise
3277 
  * al/ax/eax (depending on requested size) contains the data;
 3305 
  * al/ax/eax (depending on requested size) contains the data;
3278 
    the other part of register eax is destroyed
 3306 
    the other part of register eax is destroyed
3279 
Remarks:
 3307 
Remarks:
3280 
  * Previously low-level access to PCI for applications must be
 3308 
  * Previously low-level access to PCI for applications must be
3281 
    enabled by subfunction 12 of function 21.
 3309 
    enabled by subfunction 12 of function 21.
3282 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
 3310 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
3283 
    function number. To get access mechanism use subfunction 2.
 3311 
    function number. To get access mechanism use subfunction 2.
3284 
  * Some registers are standard and exist for all devices, some are
 3312 
  * Some registers are standard and exist for all devices, some are
3285 
    defined by the concrete device. The list of registers of the
 3313 
    defined by the concrete device. The list of registers of the
3286 
    first type can be found e.g. in famous
 3314 
    first type can be found e.g. in famous
3287 
    Interrupt List by Ralf Brown
 3315 
    Interrupt List by Ralf Brown
3288 
    (http://www.pobox.com/~ralf/files.html,
 3316 
    (http://www.pobox.com/~ralf/files.html,
3289 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
 3317 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3290 
    registers of the second type must be listed
 3318 
    registers of the second type must be listed
3291 
    in the device documentation.
 3319 
    in the device documentation.
3292 
 
 3320 
 
3293 
======================================================================
 3321 
======================================================================
3294 
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
 3322 
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
3295 
======================================================================
 3323 
======================================================================
3296 
Parameters:
 3324 
Parameters:
3297 
  * eax = 62 - function number
 3325 
  * eax = 62 - function number
3298 
  * bl = 8 - write byte
 3326 
  * bl = 8 - write byte
3299 
  * bl = 9 - write word
 3327 
  * bl = 9 - write word
3300 
  * bl = 10 - write dword
 3328 
  * bl = 10 - write dword
3301 
  * bh = number of PCI-bus
 3329 
  * bh = number of PCI-bus
3302 
  * ch = dddddfff, where ddddd = number of the device on the bus,
 3330 
  * ch = dddddfff, where ddddd = number of the device on the bus,
3303 
    fff = function number of device
 3331 
    fff = function number of device
3304 
  * cl = number of register (must be even for bl=9,
 3332 
  * cl = number of register (must be even for bl=9,
3305 
    divisible by 4 for bl=10)
 3333 
    divisible by 4 for bl=10)
3306 
  * dl/dx/edx (depending on requested size) contatins
 3334 
  * dl/dx/edx (depending on requested size) contatins
3307 
    the data to write
 3335 
    the data to write
3308 
Returned value:
 3336 
Returned value:
3309 
  * eax = -1 - error (access to PCI is disabled or parameters
 3337 
  * eax = -1 - error (access to PCI is disabled or parameters
3310 
    are not supported)
 3338 
    are not supported)
3311 
  * eax = 0 - success
 3339 
  * eax = 0 - success
3312 
Remarks:
 3340 
Remarks:
3313 
  * Previously low-level access to PCI for applications must be
 3341 
  * Previously low-level access to PCI for applications must be
3314 
    enabled by subfunction 12 of function 21.
 3342 
    enabled by subfunction 12 of function 21.
3315 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
 3343 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
3316 
    function number. To get access mechanism use subfunction 2.
 3344 
    function number. To get access mechanism use subfunction 2.
3317 
  * Some registers are standard and exist for all devices, some are
 3345 
  * Some registers are standard and exist for all devices, some are
3318 
    defined by the concrete device. The list of registers of the
 3346 
    defined by the concrete device. The list of registers of the
3319 
    first type can be found e.g. in famous Interrupt List by
 3347 
    first type can be found e.g. in famous Interrupt List by
3320 
    Ralf Brown; registers of the second type must be listed
 3348 
    Ralf Brown; registers of the second type must be listed
3321 
    in the device documentation.
 3349 
    in the device documentation.
3322 
 
 3350 
 
3323 
======================================================================
 3351 
======================================================================
3324 
============== Function 63 - work with the debug board. ==============
 3352 
============== Function 63 - work with the debug board. ==============
3325 
======================================================================
 3353 
======================================================================
3326 
The debug board is the global system buffer (with the size
 3354 
The debug board is the global system buffer (with the size
3327 
1024 bytes), to which any program can write (generally speaking,
 3355 
1024 bytes), to which any program can write (generally speaking,
3328 
arbitrary) data and from which other program can read these data.
 3356 
arbitrary) data and from which other program can read these data.
3329 
By the agreement written data are text strings interpreted as
 3357 
By the agreement written data are text strings interpreted as
3330 
debug messages on a course of program execution. The kernel in
 3358 
debug messages on a course of program execution. The kernel in
3331 
some situations also writes to the debug board information on
 3359 
some situations also writes to the debug board information on
3332 
execution of some functions; by the agreement kernel messages
 3360 
execution of some functions; by the agreement kernel messages
3333 
begins from the prefix "K : ".
 3361 
begins from the prefix "K : ".
3334 
For view of the debug board the application 'board' was created,
 3362 
For view of the debug board the application 'board' was created,
3335 
which reads data from the buffer and displays them in its window.
 3363 
which reads data from the buffer and displays them in its window.
3336 
'board' interpretes the sequence of codes 13,10 as newline.
 3364 
'board' interpretes the sequence of codes 13,10 as newline.
3337 
A character with null code in an end of line is not necessary,
 3365 
A character with null code in an end of line is not necessary,
3338 
but also does not prevent.
 3366 
but also does not prevent.
3339 
Because debugger has been written, the value of the debug board
 3367 
Because debugger has been written, the value of the debug board
3340 
has decreased, as debugger allows to inspect completely a course of
 3368 
has decreased, as debugger allows to inspect completely a course of
3341 
program execution without any efforts from the direction of program
 3369 
program execution without any efforts from the direction of program
3342 
itself. Nevertheless in some cases the debug board is still useful.
 3370 
itself. Nevertheless in some cases the debug board is still useful.
3343 
 
 3371 
 
3344 
----------------------------- Write byte -----------------------------
 3372 
----------------------------- Write byte -----------------------------
3345 
Parameters:
 3373 
Parameters:
3346 
  * eax = 63 - function number
 3374 
  * eax = 63 - function number
3347 
  * ebx = 1 - subfunction number
 3375 
  * ebx = 1 - subfunction number
3348 
  * cl = data byte
 3376 
  * cl = data byte
3349 
Returned value:
 3377 
Returned value:
3350 
  * function does not return value
 3378 
  * function does not return value
3351 
Remarks:
 3379 
Remarks:
3352 
  * Byte is written to the buffer. Buffer size is 512 bytes.
 3380 
  * Byte is written to the buffer. Buffer size is 512 bytes.
3353 
    At buffer overflow all obtained data are lost.
 3381 
    At buffer overflow all obtained data are lost.
3354 
  * For output to the debug board of more complicated objects
 3382 
  * For output to the debug board of more complicated objects
3355 
    (strings, numbers) it is enough to call this function in cycle.
 3383 
    (strings, numbers) it is enough to call this function in cycle.
3356 
    It is possible not to write the appropriate code manually and use
 3384 
    It is possible not to write the appropriate code manually and use
3357 
    file 'debug.inc', which is included into the distributive.
 3385 
    file 'debug.inc', which is included into the distributive.
3358 
 
 3386 
 
3359 
----------------------------- Read byte ------------------------------
 3387 
----------------------------- Read byte ------------------------------
3360 
Takes away byte from the buffer.
 3388 
Takes away byte from the buffer.
3361 
Parameters:
 3389 
Parameters:
3362 
  * eax = 63 - function number
 3390 
  * eax = 63 - function number
3363 
  * ebx = 2 - subfunction number
 3391 
  * ebx = 2 - subfunction number
3364 
Returned value:
 3392 
Returned value:
3365 
  * eax = ebx = 0 - the buffer is empty
 3393 
  * eax = ebx = 0 - the buffer is empty
3366 
  * eax = byte, ebx = 1 - byte was successfully read
 3394 
  * eax = byte, ebx = 1 - byte was successfully read
3367 
 
 3395 
 
3368 
======================================================================
 3396 
======================================================================
3369 
============== Function 64 - resize application memory. ==============
 3397 
============== Function 64 - resize application memory. ==============
3370 
======================================================================
 3398 
======================================================================
3371 
Parameters:
 3399 
Parameters:
3372 
  * eax = 64 - function number
 3400 
  * eax = 64 - function number
3373 
  * ebx = 1 - unique subfunction
 3401 
  * ebx = 1 - unique subfunction
3374 
  * ecx = new memory size
 3402 
  * ecx = new memory size
3375 
Returned value:
 3403 
Returned value:
3376 
  * eax = 0 - success
 3404 
  * eax = 0 - success
3377 
  * eax = 1 - not enough memory
 3405 
  * eax = 1 - not enough memory
3378 
Remarks:
 3406 
Remarks:
3379 
  * There is another way to dynamically allocate/free memory -
 3407 
  * There is another way to dynamically allocate/free memory -
3380 
    subfunctions 11, 12, 13 of function 68.
 3408 
    subfunctions 11, 12, 13 of function 68.
3381 
  * The function cannot be used together with 68.11, 68.12, 68.13.
 3409 
  * The function cannot be used together with 68.11, 68.12, 68.13.
3382 
    The function call will be ignored after creation of process heap
 3410 
    The function call will be ignored after creation of process heap
3383 
    with function 68.11.
 3411 
    with function 68.11.
3384 
 
 3412 
 
3385 
======================================================================
 3413 
======================================================================
3386 
======== Function 65 - draw image with palette in the window. ========
 3414 
======== Function 65 - draw image with palette in the window. ========
3387 
======================================================================
 3415 
======================================================================
3388 
Parameters:
 3416 
Parameters:
3389 
  * eax = 65 - function number
 3417 
  * eax = 65 - function number
3390 
  * ebx = pointer to the image
 3418 
  * ebx = pointer to the image
3391 
  * ecx = [size on axis x]*65536 + [size on axis y]
 3419 
  * ecx = [size on axis x]*65536 + [size on axis y]
3392 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 3420 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
3393 
  * esi = number of bits per pixel, must be 8, 24 or 32
 3421 
  * esi = number of bits per pixel, must be 8, 24 or 32
3394 
  * edi = pointer to palette (256 colors 0x00RRGGBB);
 3422 
  * edi = pointer to palette (256 colors 0x00RRGGBB);
3395 
          ignored when esi = 24 and 32
 3423 
          ignored when esi = 24 and 32
3396 
  * ebp = offset of next row data relative to previous row data
 3424 
  * ebp = offset of next row data relative to previous row data
3397 
Returned value:
 3425 
Returned value:
3398 
  * function does not return value
 3426 
  * function does not return value
3399 
Remarks:
 3427 
Remarks:
3400 
  * Coordinates of the image are coordinates of the upper left corner
 3428 
  * Coordinates of the image are coordinates of the upper left corner
3401 
    of the image relative to the window.
 3429 
    of the image relative to the window.
3402 
  * Size of the image in bytes is xsize*ysize.
 3430 
  * Size of the image in bytes is xsize*ysize.
3403 
  * Each byte of image is index in the palette.
 3431 
  * Each byte of image is index in the palette.
3404 
  * If the image uses less than 256 colors, palette size may be
 3432 
  * If the image uses less than 256 colors, palette size may be
3405 
    less than 256 too.
 3433 
    less than 256 too.
3406 
  * The call to function 7 is equivalent to call to this function
 3434 
  * The call to function 7 is equivalent to call to this function
3407 
    with esi=24, ebp=0.
 3435 
    with esi=24, ebp=0.
3408 
 
 3436 
 
3409 
======================================================================
 3437 
======================================================================
3410 
================== Function 66 - work with keyboard. =================
 3438 
================== Function 66 - work with keyboard. =================
3411 
======================================================================
 3439 
======================================================================
3412 
The input mode influences results of reading keys by function 2.
 3440 
The input mode influences results of reading keys by function 2.
3413 
When a program loads, ASCII input mode is set for it.
 3441 
When a program loads, ASCII input mode is set for it.
3414 
 
 3442 
 
3415 
-------------- Subfunction 1 - set keyboard input mode. --------------
 3443 
-------------- Subfunction 1 - set keyboard input mode. --------------
3416 
Parameters:
 3444 
Parameters:
3417 
  * eax = 66 - function number
 3445 
  * eax = 66 - function number
3418 
  * ebx = 1 - subfunction number
 3446 
  * ebx = 1 - subfunction number
3419 
  * ecx = mode:
 3447 
  * ecx = mode:
3420 
    * 0 = normal (ASCII-characters)
 3448 
    * 0 = normal (ASCII-characters)
3421 
    * 1 = scancodes
 3449 
    * 1 = scancodes
3422 
Returned value:
 3450 
Returned value:
3423 
  * function does not return value
 3451 
  * function does not return value
3424 
 
 3452 
 
3425 
-------------- Subfunction 2 - get keyboard input mode. --------------
 3453 
-------------- Subfunction 2 - get keyboard input mode. --------------
3426 
Parameters:
 3454 
Parameters:
3427 
  * eax = 66 - function number
 3455 
  * eax = 66 - function number
3428 
  * ebx = 2 - subfunction number
 3456 
  * ebx = 2 - subfunction number
3429 
Returned value:
 3457 
Returned value:
3430 
  * eax = current mode
 3458 
  * eax = current mode
3431 
 
 3459 
 
3432 
------------ Subfunction 3 - get status of control keys. -------------
 3460 
------------ Subfunction 3 - get status of control keys. -------------
3433 
Parameters:
 3461 
Parameters:
3434 
  * eax = 66 - function number
 3462 
  * eax = 66 - function number
3435 
  * ebx = 3 - subfunction number
 3463 
  * ebx = 3 - subfunction number
3436 
Returned value:
 3464 
Returned value:
3437 
  * eax = bit mask:
 3465 
  * eax = bit mask:
3438 
  * bit 0 (mask 1): left Shift is pressed
 3466 
  * bit 0 (mask 1): left Shift is pressed
3439 
  * bit 1 (mask 2): right Shift is pressed
 3467 
  * bit 1 (mask 2): right Shift is pressed
3440 
  * bit 2 (mask 4): left Ctrl is pressed
 3468 
  * bit 2 (mask 4): left Ctrl is pressed
3441 
  * bit 3 (mask 8): right Ctrl is pressed
 3469 
  * bit 3 (mask 8): right Ctrl is pressed
3442 
  * bit 4 (mask 0x10): left Alt is pressed
 3470 
  * bit 4 (mask 0x10): left Alt is pressed
3443 
  * bit 5 (mask 0x20): right Alt is pressed
 3471 
  * bit 5 (mask 0x20): right Alt is pressed
3444 
  * bit 6 (mask 0x40): CapsLock is on
 3472 
  * bit 6 (mask 0x40): CapsLock is on
3445 
  * bit 7 (mask 0x80): NumLock is on
 3473 
  * bit 7 (mask 0x80): NumLock is on
3446 
  * bit 8 (mask 0x100): ScrollLock is on
 3474 
  * bit 8 (mask 0x100): ScrollLock is on
3447 
  * other bits are cleared
 3475 
  * other bits are cleared
3448 
 
 3476 
 
3449 
-------------- Subfunction 4 - set system-wide hotkey. ---------------
 3477 
-------------- Subfunction 4 - set system-wide hotkey. ---------------
3450 
When hotkey is pressed, the system notifies only those applications,
 3478 
When hotkey is pressed, the system notifies only those applications,
3451 
which have installed it; the active application (which receives
 3479 
which have installed it; the active application (which receives
3452 
all normal input) does not receive such keys.
 3480 
all normal input) does not receive such keys.
3453 
The notification consists in sending event with the code 2.
 3481 
The notification consists in sending event with the code 2.
3454 
Reading hotkey is the same as reading normal key - by function 2.
 3482 
Reading hotkey is the same as reading normal key - by function 2.
3455 
Parameters:
 3483 
Parameters:
3456 
  * eax = 66 - function number
 3484 
  * eax = 66 - function number
3457 
  * ebx = 4 - subfunction number
 3485 
  * ebx = 4 - subfunction number
3458 
  * cl determines key scancode;
 3486 
  * cl determines key scancode;
3459 
    use cl=0 to give combinations such as Ctrl+Shift
 3487 
    use cl=0 to give combinations such as Ctrl+Shift
3460 
  * edx = 0xXYZ determines possible states of control keys:
 3488 
  * edx = 0xXYZ determines possible states of control keys:
3461 
    * Z (low 4 bits) determines state of LShift and RShift:
 3489 
    * Z (low 4 bits) determines state of LShift and RShift:
3462 
      * 0 = no key must be pressed;
 3490 
      * 0 = no key must be pressed;
3463 
      * 1 = exactly one key must be pressed;
 3491 
      * 1 = exactly one key must be pressed;
3464 
      * 2 = both keys must be pressed;
 3492 
      * 2 = both keys must be pressed;
3465 
      * 3 = must be pressed LShift, but not RShift;
 3493 
      * 3 = must be pressed LShift, but not RShift;
3466 
      * 4 = must be pressed RShift, but not LShift
 3494 
      * 4 = must be pressed RShift, but not LShift
3467 
    * Y - similar for LCtrl and RCtrl;
 3495 
    * Y - similar for LCtrl and RCtrl;
3468 
    * X - similar for LAlt and RAlt
 3496 
    * X - similar for LAlt and RAlt
3469 
Returned value:
 3497 
Returned value:
3470 
  * eax=0 - success
 3498 
  * eax=0 - success
3471 
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
 3499 
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
3472 
Remarks:
 3500 
Remarks:
3473 
  * Hotkey can work either at pressing or at release. Release
 3501 
  * Hotkey can work either at pressing or at release. Release
3474 
    scancode of a key is more on 128 than pressing scancode
 3502 
    scancode of a key is more on 128 than pressing scancode
3475 
    (i.e. high bit is set).
 3503 
    (i.e. high bit is set).
3476 
  * Several applications can set the same combination;
 3504 
  * Several applications can set the same combination;
3477 
    all such applications will be informed on pressing
 3505 
    all such applications will be informed on pressing
3478 
    such combination.
 3506 
    such combination.
3479 
 
 3507 
 
3480 
-------------- Subfunction 5 - delete installed hotkey. --------------
 3508 
-------------- Subfunction 5 - delete installed hotkey. --------------
3481 
Parameters:
 3509 
Parameters:
3482 
  * eax = 66 - function number
 3510 
  * eax = 66 - function number
3483 
  * ebx = 5 - subfunction number
 3511 
  * ebx = 5 - subfunction number
3484 
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
 3512 
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
3485 
Returned value:
 3513 
Returned value:
3486 
  * eax = 0 - success
 3514 
  * eax = 0 - success
3487 
  * eax = 1 - there is no such hotkey
 3515 
  * eax = 1 - there is no such hotkey
3488 
Remarks:
 3516 
Remarks:
3489 
  * When a process/thread terminates, all hotkey installed by it are
 3517 
  * When a process/thread terminates, all hotkey installed by it are
3490 
    deleted.
 3518 
    deleted.
3491 
  * The call to this subfunction does not affect other applications.
 3519 
  * The call to this subfunction does not affect other applications.
3492 
    If other application has defined the same combination, it will
 3520 
    If other application has defined the same combination, it will
3493 
    still receive notices.
 3521 
    still receive notices.
3494 
 
 3522 
 
3495 
======================================================================
 3523 
======================================================================
3496 
========= Function 67 - change position/sizes of the window. =========
 3524 
========= Function 67 - change position/sizes of the window. =========
3497 
======================================================================
 3525 
======================================================================
3498 
Parameters:
 3526 
Parameters:
3499 
  * eax = 67 - function number
 3527 
  * eax = 67 - function number
3500 
  * ebx = new x-coordinate of the window
 3528 
  * ebx = new x-coordinate of the window
3501 
  * ecx = new y-coordinate of the window
 3529 
  * ecx = new y-coordinate of the window
3502 
  * edx = new x-size of the window
 3530 
  * edx = new x-size of the window
3503 
  * esi = new y-size of the window
 3531 
  * esi = new y-size of the window
3504 
Returned value:
 3532 
Returned value:
3505 
  * function does not return value
 3533 
  * function does not return value
3506 
Remarks:
 3534 
Remarks:
3507 
  * The value -1 for a parameter means "do not change"; e.g. to move
 3535 
  * The value -1 for a parameter means "do not change"; e.g. to move
3508 
    the window without resizing it is possible to specify edx=esi=-1.
 3536 
    the window without resizing it is possible to specify edx=esi=-1.
3509 
  * Previously the window must be defined by function 0.
 3537 
  * Previously the window must be defined by function 0.
3510 
    It sets initial coordinates and sizes of the window.
 3538 
    It sets initial coordinates and sizes of the window.
3511 
  * Sizes of the window are understood in sense of function 0,
 3539 
  * Sizes of the window are understood in sense of function 0,
3512 
    that is one pixel less than real sizes.
 3540 
    that is one pixel less than real sizes.
3513 
  * The function call for maximized windows is simply ignored.
 3541 
  * The function call for maximized windows is simply ignored.
3514 
  * For windows of appropriate styles position and/or sizes can be
 3542 
  * For windows of appropriate styles position and/or sizes can be
3515 
    changed by user; current position and sizes can be obtained by
 3543 
    changed by user; current position and sizes can be obtained by
3516 
    call to function 9.
 3544 
    call to function 9.
3517 
  * The function sends to the window redraw event (with the code 1).
 3545 
  * The function sends to the window redraw event (with the code 1).
3518 
 
 3546 
 
3519 
======================================================================
 3547 
======================================================================
3520 
====== Function 68, subfunction 0 - get the task switch counter. =====
 3548 
====== Function 68, subfunction 0 - get the task switch counter. =====
3521 
======================================================================
 3549 
======================================================================
3522 
Parameters:
 3550 
Parameters:
3523 
  * eax = 68 - function number
 3551 
  * eax = 68 - function number
3524 
  * ebx = 0 - subfunction number
 3552 
  * ebx = 0 - subfunction number
3525 
Returned value:
 3553 
Returned value:
3526 
  * eax = number of task switches from the system booting
 3554 
  * eax = number of task switches from the system booting
3527 
    (modulo 2^32)
 3555 
    (modulo 2^32)
3528 
 
 3556 
 
3529 
======================================================================
 3557 
======================================================================
3530 
======= Function 68, subfunction 1 - switch to the next thread. ======
 3558 
======= Function 68, subfunction 1 - switch to the next thread. ======
3531 
======================================================================
 3559 
======================================================================
3532 
The function completes the current time slice allocated to the
 3560 
The function completes the current time slice allocated to the
3533 
thread and switches to the next. (Which thread in which process
 3561 
thread and switches to the next. (Which thread in which process
3534 
will be next, is unpredictable). Later, when execution queue
 3562 
will be next, is unpredictable). Later, when execution queue
3535 
will reach the current thread, execution will be continued.
 3563 
will reach the current thread, execution will be continued.
3536 
Parameters:
 3564 
Parameters:
3537 
  * eax = 68 - function number
 3565 
  * eax = 68 - function number
3538 
  * ebx = 1 - subfunction number
 3566 
  * ebx = 1 - subfunction number
3539 
Returned value:
 3567 
Returned value:
3540 
  * function does not return value
 3568 
  * function does not return value
3541 
 
 3569 
 
3542 
======================================================================
 3570 
======================================================================
3543 
============= Function 68, subfunction 2 - cache + rdpmc. ============
 3571 
============= Function 68, subfunction 2 - cache + rdpmc. ============
3544 
======================================================================
 3572 
======================================================================
3545 
Parameters:
 3573 
Parameters:
3546 
  * eax = 68 - function number
 3574 
  * eax = 68 - function number
3547 
  * ebx = 2 - subfunction number
 3575 
  * ebx = 2 - subfunction number
3548 
  * ecx = required action:
 3576 
  * ecx = required action:
3549 
    * ecx = 0 - enable instruction 'rdpmc'
 3577 
    * ecx = 0 - enable instruction 'rdpmc'
3550 
      (ReaD Performance-Monitoring Counters) for applications
 3578 
      (ReaD Performance-Monitoring Counters) for applications
3551 
    * ecx = 1 - find out whether cache is disabled/enabled
 3579 
    * ecx = 1 - find out whether cache is disabled/enabled
3552 
    * ecx = 2 - enable cache
 3580 
    * ecx = 2 - enable cache
3553 
    * ecx = 3 - disable cache
 3581 
    * ecx = 3 - disable cache
3554 
Returned value:
 3582 
Returned value:
3555 
  * for ecx=0:
 3583 
  * for ecx=0:
3556 
    * eax = the value of cr4
 3584 
    * eax = the value of cr4
3557 
  * for ecx=1:
 3585 
  * for ecx=1:
3558 
    * eax = (cr0 and 0x60000000):
 3586 
    * eax = (cr0 and 0x60000000):
3559 
    * eax = 0 - cache is on
 3587 
    * eax = 0 - cache is on
3560 
    * eax <> 0 - cache is off
 3588 
    * eax <> 0 - cache is off
3561 
  * for ecx=2 and ecx=3:
 3589 
  * for ecx=2 and ecx=3:
3562 
    * function does not return value
 3590 
    * function does not return value
3563 
 
 3591 
 
3564 
======================================================================
 3592 
======================================================================
3565 
=========== Function 68, subfunction 3 - read MSR-register. ==========
 3593 
=========== Function 68, subfunction 3 - read MSR-register. ==========
3566 
======================================================================
 3594 
======================================================================
3567 
MSR = Model Specific Register; the complete list of MSR-registers
 3595 
MSR = Model Specific Register; the complete list of MSR-registers
3568 
of a processor is included to the documentation on it (for example,
 3596 
of a processor is included to the documentation on it (for example,
3569 
IA-32 Intel Architecture Software Developer's Manual,
 3597 
IA-32 Intel Architecture Software Developer's Manual,
3570 
Volume 3, Appendix B); each processor family has its own subset
 3598 
Volume 3, Appendix B); each processor family has its own subset
3571 
of the MSR-registers.
 3599 
of the MSR-registers.
3572 
Parameters:
 3600 
Parameters:
3573 
  * eax = 68 - function number
 3601 
  * eax = 68 - function number
3574 
  * ebx = 3 - subfunction number
 3602 
  * ebx = 3 - subfunction number
3575 
  * ecx is ignored
 3603 
  * ecx is ignored
3576 
  * edx = MSR address
 3604 
  * edx = MSR address
3577 
Returned value:
 3605 
Returned value:
3578 
  * ebx:eax = high:low dword of the result
 3606 
  * ebx:eax = high:low dword of the result
3579 
Remarks:
 3607 
Remarks:
3580 
  * If ecx contains nonexistent or not implemented for this processor
 3608 
  * If ecx contains nonexistent or not implemented for this processor
3581 
    MSR, processor will generate an exception in the kernel, which
 3609 
    MSR, processor will generate an exception in the kernel, which
3582 
    will kill the thread.
 3610 
    will kill the thread.
3583 
  * Previously it is necessary to check, whether MSRs are supported
 3611 
  * Previously it is necessary to check, whether MSRs are supported
3584 
    as a whole, with the instruction 'cpuid'. Otherwise processor
 3612 
    as a whole, with the instruction 'cpuid'. Otherwise processor
3585 
    will generate other exception in the kernel, which will anyway
 3613 
    will generate other exception in the kernel, which will anyway
3586 
    kill the thread.
 3614 
    kill the thread.
3587 
 
 3615 
 
3588 
======================================================================
 3616 
======================================================================
3589 
========= Function 68, subfunction 4 - write to MSR-register. ========
 3617 
========= Function 68, subfunction 4 - write to MSR-register. ========
3590 
======================================================================
 3618 
======================================================================
3591 
MSR = Model Specific Register; the complete list of MSR-registers
 3619 
MSR = Model Specific Register; the complete list of MSR-registers
3592 
of a processor is included to the documentation on it (for example,
 3620 
of a processor is included to the documentation on it (for example,
3593 
IA-32 Intel Architecture Software Developer's Manual,
 3621 
IA-32 Intel Architecture Software Developer's Manual,
3594 
Volume 3, Appendix B); each processor family has its own subset
 3622 
Volume 3, Appendix B); each processor family has its own subset
3595 
of the MSR-registers.
 3623 
of the MSR-registers.
3596 
Parameters:
 3624 
Parameters:
3597 
  * eax = 68 - function number
 3625 
  * eax = 68 - function number
3598 
  * ebx = 4 - subfunction number
 3626 
  * ebx = 4 - subfunction number
3599 
  * ecx is ignored
 3627 
  * ecx is ignored
3600 
  * edx = MSR address
 3628 
  * edx = MSR address
3601 
  * esi:edi = high:low dword
 3629 
  * esi:edi = high:low dword
3602 
Returned value:
 3630 
Returned value:
3603 
  * function does not return value
 3631 
  * function does not return value
3604 
Remarks:
 3632 
Remarks:
3605 
  * If ecx contains nonexistent or not implemented for this processor
 3633 
  * If ecx contains nonexistent or not implemented for this processor
3606 
    MSR, processor will generate an exception in the kernel, which
 3634 
    MSR, processor will generate an exception in the kernel, which
3607 
    will kill the thread.
 3635 
    will kill the thread.
3608 
  * Previously it is necessary to check, whether MSRs are supported
 3636 
  * Previously it is necessary to check, whether MSRs are supported
3609 
    as a whole, with the instruction 'cpuid'. Otherwise processor
 3637 
    as a whole, with the instruction 'cpuid'. Otherwise processor
3610 
    will generate other exception in the kernel, which will anyway
 3638 
    will generate other exception in the kernel, which will anyway
3611 
    kill the thread.
 3639 
    kill the thread.
3612 
 
 3640 
 
3613 
======================================================================
 3641 
======================================================================
3614 
======= Function 68, subfunction 11 - initialize process heap. =======
 3642 
======= Function 68, subfunction 11 - initialize process heap. =======
3615 
======================================================================
 3643 
======================================================================
3616 
Parameters:
 3644 
Parameters:
3617 
  * eax = 68 - function number
 3645 
  * eax = 68 - function number
3618 
  * ebx = 11 - subfunction number
 3646 
  * ebx = 11 - subfunction number
3619 
Returned value:
 3647 
Returned value:
3620 
  * eax = 0 - failed
 3648 
  * eax = 0 - failed
3621 
  * otherwise size of created heap
 3649 
  * otherwise size of created heap
3622 
Remarks:
 3650 
Remarks:
3623 
  * The function call initializes heap, from which one can in future
 3651 
  * The function call initializes heap, from which one can in future
3624 
    allocate and free memory blocks with subfunctions 12 and 13.
 3652 
    allocate and free memory blocks with subfunctions 12 and 13.
3625 
    Heap size is equal to total amount of free application memory.
 3653 
    Heap size is equal to total amount of free application memory.
3626 
  * The second function call from the same process results in
 3654 
  * The second function call from the same process results in
3627 
    returning the size of the existing heap.
 3655 
    returning the size of the existing heap.
3628 
  * After creation of the heap calls to function 64 will be ignored.
 3656 
  * After creation of the heap calls to function 64 will be ignored.
3629 
 
 3657 
 
3630 
======================================================================
 3658 
======================================================================
3631 
======== Function 68, subfunction 12 - allocate memory block. ========
 3659 
======== Function 68, subfunction 12 - allocate memory block. ========
3632 
======================================================================
 3660 
======================================================================
3633 
Parameters:
 3661 
Parameters:
3634 
  * eax = 68 - function number
 3662 
  * eax = 68 - function number
3635 
  * ebx = 12 - subfunction number
 3663 
  * ebx = 12 - subfunction number
3636 
  * ecx = required size in bytes
 3664 
  * ecx = required size in bytes
3637 
Returned value:
 3665 
Returned value:
3638 
  * eax = pointer to the allocated block
 3666 
  * eax = pointer to the allocated block
3639 
Remarks:
 3667 
Remarks:
3640 
  * Before this call one must initialize process heap by call to
 3668 
  * Before this call one must initialize process heap by call to
3641 
    subfunction 11.
 3669 
    subfunction 11.
3642 
  * The function allocates an integer number of pages (4 Kb) in such
 3670 
  * The function allocates an integer number of pages (4 Kb) in such
3643 
    way that the real size of allocated block is more than or equal to
 3671 
    way that the real size of allocated block is more than or equal to
3644 
    requested size.
 3672 
    requested size.
3645 
 
 3673 
 
3646 
======================================================================
 3674 
======================================================================
3647 
========== Function 68, subfunction 13 - free memory block. ==========
 3675 
========== Function 68, subfunction 13 - free memory block. ==========
3648 
======================================================================
 3676 
======================================================================
3649 
Parameters:
 3677 
Parameters:
3650 
  * eax = 68 - function number
 3678 
  * eax = 68 - function number
3651 
  * ebx = 13 - subfunction number
 3679 
  * ebx = 13 - subfunction number
3652 
  * ecx = pointer to the memory block
 3680 
  * ecx = pointer to the memory block
3653 
Returned value:
 3681 
Returned value:
3654 
  * eax = 1 - success
 3682 
  * eax = 1 - success
3655 
  * eax = 0 - failed
 3683 
  * eax = 0 - failed
3656 
Remarks:
 3684 
Remarks:
3657 
  * The memory block must have been allocated by subfunction 12
 3685 
  * The memory block must have been allocated by subfunction 12
3658 
    or subfunction 20.
 3686 
    or subfunction 20.
3659 
 
 3687 
 
3660 
======================================================================
 3688 
======================================================================
3661 
======== Function 68, subfunction 14 - wait for driver notify. =======
 3689 
======== Function 68, subfunction 14 - wait for driver notify. =======
3662 
======================================================================
 3690 
======================================================================
3663 
Parameters:
 3691 
Parameters:
3664 
  * eax = 68 - function number
 3692 
  * eax = 68 - function number
3665 
  * ebx = 14 - subfunction number
 3693 
  * ebx = 14 - subfunction number
3666 
  * ecx = pointer to the buffer for information (8 bytes)
 3694 
  * ecx = pointer to the buffer for information (8 bytes)
3667 
Returned value:
 3695 
Returned value:
3668 
  * buffer pointed to by ecx contains the following information:
 3696 
  * buffer pointed to by ecx contains the following information:
3669 
    * +0: dword: constant EV_INTR = 1
 3697 
    * +0: dword: constant EV_INTR = 1
3670 
    * +4: dword: driver data
 3698 
    * +4: dword: driver data
3671 
Remarks:
 3699 
Remarks:
3672 
  * The current implementation at wait time uses "heavy" operations
 3700 
  * The current implementation at wait time uses "heavy" operations
3673 
    of task switch.
 3701 
    of task switch.
3674 
 
 3702 
 
3675 
======================================================================
 3703 
======================================================================
3676 
====== Function 68, subfunction 15 - set FPU exception handler. ======
 3704 
====== Function 68, subfunction 15 - set FPU exception handler. ======
3677 
======================================================================
 3705 
======================================================================
3678 
Parameters:
 3706 
Parameters:
3679 
  * eax = 68 - function number
 3707 
  * eax = 68 - function number
3680 
  * ebx = 15 - subfunction number
 3708 
  * ebx = 15 - subfunction number
3681 
  * ecx = address of the new exception handler
 3709 
  * ecx = address of the new exception handler
3682 
Returned value:
 3710 
Returned value:
3683 
  * eax = address of the old exception handler (0, if it was not set)
 3711 
  * eax = address of the old exception handler (0, if it was not set)
3684 
 
 3712 
 
3685 
======================================================================
 3713 
======================================================================
3686 
============= Function 68, subfunction 16 - load driver. =============
 3714 
============= Function 68, subfunction 16 - load driver. =============
3687 
======================================================================
 3715 
======================================================================
3688 
Parameters:
 3716 
Parameters:
3689 
  * eax = 68 - function number
 3717 
  * eax = 68 - function number
3690 
  * ebx = 16 - subfunction number
 3718 
  * ebx = 16 - subfunction number
3691 
  * ecx = pointer to ASCIIZ-string with driver name
 3719 
  * ecx = pointer to ASCIIZ-string with driver name
3692 
Returned value:
 3720 
Returned value:
3693 
  * eax = 0 - failed
 3721 
  * eax = 0 - failed
3694 
  * otherwise eax = driver handle
 3722 
  * otherwise eax = driver handle
3695 
Remarks:
 3723 
Remarks:
3696 
  * If the driver was not loaded yet, it is loaded;
 3724 
  * If the driver was not loaded yet, it is loaded;
3697 
    if the driver was loaded yet, nothing happens.
 3725 
    if the driver was loaded yet, nothing happens.
3698 
  * Driver name is case-sensitive.
 3726 
  * Driver name is case-sensitive.
3699 
    Maximum length of the name is 16 characters, including
 3727 
    Maximum length of the name is 16 characters, including
3700 
    terminating null character, the rest is ignored.
 3728 
    terminating null character, the rest is ignored.
3701 
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
 3729 
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
3702 
 
 3730 
 
3703 
======================================================================
 3731 
======================================================================
3704 
============ Function 68, subfunction 17 - driver control. ===========
 3732 
============ Function 68, subfunction 17 - driver control. ===========
3705 
======================================================================
 3733 
======================================================================
3706 
Parameters:
 3734 
Parameters:
3707 
  * eax = 68 - function number
 3735 
  * eax = 68 - function number
3708 
  * ebx = 17 - subfunction number
 3736 
  * ebx = 17 - subfunction number
3709 
  * ecx = pointer to the control structure:
 3737 
  * ecx = pointer to the control structure:
3710 
    * +0: dword: handle of driver
 3738 
    * +0: dword: handle of driver
3711 
    * +4: dword: code of driver function
 3739 
    * +4: dword: code of driver function
3712 
    * +8: dword: pointer to input data
 3740 
    * +8: dword: pointer to input data
3713 
    * +12 = +0xC: dword: size of input data
 3741 
    * +12 = +0xC: dword: size of input data
3714 
    * +16 = +0x10: dword: pointer to output data
 3742 
    * +16 = +0x10: dword: pointer to output data
3715 
    * +20 = +0x14: dword: size of output data
 3743 
    * +20 = +0x14: dword: size of output data
3716 
Returned value:
 3744 
Returned value:
3717 
  * eax = determined by driver
 3745 
  * eax = determined by driver
3718 
Remarks:
 3746 
Remarks:
3719 
  * Function codes and the structure of input/output data
 3747 
  * Function codes and the structure of input/output data
3720 
    are defined by driver.
 3748 
    are defined by driver.
3721 
  * Previously one must obtain driver handle by subfunction 16.
 3749 
  * Previously one must obtain driver handle by subfunction 16.
3722 
 
 3750 
 
3723 
======================================================================
 3751 
======================================================================
3724 
====== Function 68, subfunction 18 - set SSE exception handler. ======
 3752 
====== Function 68, subfunction 18 - set SSE exception handler. ======
3725 
======================================================================
 3753 
======================================================================
3726 
Parameters:
 3754 
Parameters:
3727 
  * eax = 68 - function number
 3755 
  * eax = 68 - function number
3728 
  * ebx = 15 - subfunction number
 3756 
  * ebx = 15 - subfunction number
3729 
  * ecx = address of the new exception handler
 3757 
  * ecx = address of the new exception handler
3730 
Returned value:
 3758 
Returned value:
3731 
  * eax = address of the old exception handler (0, if it was not set)
 3759 
  * eax = address of the old exception handler (0, if it was not set)
3732 
 
 3760 
 
3733 
======================================================================
 3761 
======================================================================
3734 
=============== Function 68, subfunction 19 - load DLL. ==============
 3762 
=============== Function 68, subfunction 19 - load DLL. ==============
3735 
======================================================================
 3763 
======================================================================
3736 
Parameters:
 3764 
Parameters:
3737 
  * eax = 68 - function number
 3765 
  * eax = 68 - function number
3738 
  * ebx = 19 - subfunction number
 3766 
  * ebx = 19 - subfunction number
3739 
  * ecx = pointer to ASCIIZ-string with the full path to DLL
 3767 
  * ecx = pointer to ASCIIZ-string with the full path to DLL
3740 
Returned value:
 3768 
Returned value:
3741 
  * eax = 0 - failed
 3769 
  * eax = 0 - failed
3742 
  * otherwise eax = pointer to DLL export table
 3770 
  * otherwise eax = pointer to DLL export table
3743 
Remarks:
 3771 
Remarks:
3744 
  * Export table is an array of structures of 2 dword's, terminated
 3772 
  * Export table is an array of structures of 2 dword's, terminated
3745 
    by zero. The first dword in structure points to function name,
 3773 
    by zero. The first dword in structure points to function name,
3746 
    the second dword contains address of function.
 3774 
    the second dword contains address of function.
3747 
 
 3775 
 
3748 
======================================================================
 3776 
======================================================================
3749 
======= Function 68, subfunction 20 - reallocate memory block. =======
 3777 
======= Function 68, subfunction 20 - reallocate memory block. =======
3750 
======================================================================
 3778 
======================================================================
3751 
Parameters:
 3779 
Parameters:
3752 
  * eax = 68 - function number
 3780 
  * eax = 68 - function number
3753 
  * ebx = 20 - subfunction number
 3781 
  * ebx = 20 - subfunction number
3754 
  * ecx = new size in bytes
 3782 
  * ecx = new size in bytes
3755 
  * edx = pointer to already allocated block
 3783 
  * edx = pointer to already allocated block
3756 
Returned value:
 3784 
Returned value:
3757 
  * eax = pointer to the reallocated block, 0 = error
 3785 
  * eax = pointer to the reallocated block, 0 = error
3758 
Remarks:
 3786 
Remarks:
3759 
  * Before this call one must initialize process heap by call to
 3787 
  * Before this call one must initialize process heap by call to
3760 
    subfunction 11.
 3788 
    subfunction 11.
3761 
  * The function allocates an integer number of pages (4 Kb) in such
 3789 
  * The function allocates an integer number of pages (4 Kb) in such
3762 
    way that the real size of allocated block is more than or equal to
 3790 
    way that the real size of allocated block is more than or equal to
3763 
    requested size.
 3791 
    requested size.
3764 
  * If edx=0, the function call is equivalent to memory allocation
 3792 
  * If edx=0, the function call is equivalent to memory allocation
3765 
    with subfunction 12. Otherwise the block at edx
 3793 
    with subfunction 12. Otherwise the block at edx
3766 
    must be allocated earlier with subfunction 12 or this subfunction.
 3794 
    must be allocated earlier with subfunction 12 or this subfunction.
3767 
  * If ecx=0, the function frees memory block at edx and returns 0.
 3795 
  * If ecx=0, the function frees memory block at edx and returns 0.
3768 
  * The contents of the block are unchanged up to the shorter of
 3796 
  * The contents of the block are unchanged up to the shorter of
3769 
    the new and old sizes.
 3797 
    the new and old sizes.
3770 
 
 3798 
 
3771 
======================================================================
 3799 
======================================================================
3772 
====================== Fucntion 69 - debugging. ======================
 3800 
====================== Fucntion 69 - debugging. ======================
3773 
======================================================================
 3801 
======================================================================
3774 
A process can load other process as debugged by set of corresponding
 3802 
A process can load other process as debugged by set of corresponding
3775 
bit by call to subfunction 7 of function 70.
 3803 
bit by call to subfunction 7 of function 70.
3776 
A process can have only one debugger; one process can debug some
 3804 
A process can have only one debugger; one process can debug some
3777 
others. The system notifies debugger on events occuring with
 3805 
others. The system notifies debugger on events occuring with
3778 
debugged process. Messages are written to the buffer defined by
 3806 
debugged process. Messages are written to the buffer defined by
3779 
subfunction 0.
 3807 
subfunction 0.
3780 
Format of a message:
 3808 
Format of a message:
3781 
  * +0: dword: message code
 3809 
  * +0: dword: message code
3782 
  * +4: dword: PID of debugged process
 3810 
  * +4: dword: PID of debugged process
3783 
  * +8: there can be additional data depending on message code
 3811 
  * +8: there can be additional data depending on message code
3784 
Message codes:
 3812 
Message codes:
3785 
  * 1 = exception
 3813 
  * 1 = exception
3786 
    * in addition dword-number of the exception is given
 3814 
    * in addition dword-number of the exception is given
3787 
    * process is suspended
 3815 
    * process is suspended
3788 
  * 2 = process has terminated
 3816 
  * 2 = process has terminated
3789 
    * comes at any termination: both through the system function -1,
 3817 
    * comes at any termination: both through the system function -1,
3790 
      and at "murder" by any other process (including debugger itself)
 3818 
      and at "murder" by any other process (including debugger itself)
3791 
  * 3 = debug exception int 1 = #DB
 3819 
  * 3 = debug exception int 1 = #DB
3792 
    * in addition dword-image of the register DR6 is given:
 3820 
    * in addition dword-image of the register DR6 is given:
3793 
      * bits 0-3: condition of the corresponding breakpoint (set by
 3821 
      * bits 0-3: condition of the corresponding breakpoint (set by
3794 
        subfunction 9) is satisfied
 3822 
        subfunction 9) is satisfied
3795 
      * áèò 14: exception has occured because of the trace mode
 3823 
      * áèò 14: exception has occured because of the trace mode
3796 
        (flag TF is set TF)
 3824 
        (flag TF is set TF)
3797 
    * process is suspended
 3825 
    * process is suspended
3798 
When debugger terminates, all debugged processes are killed.
 3826 
When debugger terminates, all debugged processes are killed.
3799 
If debugger does not want this, it must previously detach by
 3827 
If debugger does not want this, it must previously detach by
3800 
subfunction 3.
 3828 
subfunction 3.
3801 
 
 3829 
 
3802 
All subfunctions are applicable only to processes/threads started
 3830 
All subfunctions are applicable only to processes/threads started
3803 
from the current by function 70 with set debugging flag.
 3831 
from the current by function 70 with set debugging flag.
3804 
Debugging of multithreaded programs is not supported yet.
 3832 
Debugging of multithreaded programs is not supported yet.
3805 
The full list of subfunctions:
 3833 
The full list of subfunctions:
3806 
  * subfunction 0 - define data area for debug messages
 3834 
  * subfunction 0 - define data area for debug messages
3807 
  * subfunction 1 - get contents of registers of debugged thread
 3835 
  * subfunction 1 - get contents of registers of debugged thread
3808 
  * subfunction 2 - set contents of registers of debugged thread
 3836 
  * subfunction 2 - set contents of registers of debugged thread
3809 
  * subfunction 3 - detach from debugged process
 3837 
  * subfunction 3 - detach from debugged process
3810 
  * subfunction 4 - suspend debugged thread
 3838 
  * subfunction 4 - suspend debugged thread
3811 
  * subfunction 5 - resume debugged thread
 3839 
  * subfunction 5 - resume debugged thread
3812 
  * subfunction 6 - read from the memory of debugged process
 3840 
  * subfunction 6 - read from the memory of debugged process
3813 
  * subfunction 7 - write to the memory of debugged process
 3841 
  * subfunction 7 - write to the memory of debugged process
3814 
  * subfunction 8 - terminate debugged thread
 3842 
  * subfunction 8 - terminate debugged thread
3815 
  * subfunction 9 - set/clear hardware breakpoint
 3843 
  * subfunction 9 - set/clear hardware breakpoint
3816 
 
 3844 
 
3817 
======================================================================
 3845 
======================================================================
3818 
= Function 69, subfunction 0 - define data area fror debug messages. =
 3846 
= Function 69, subfunction 0 - define data area fror debug messages. =
3819 
======================================================================
 3847 
======================================================================
3820 
Parameters:
 3848 
Parameters:
3821 
  * eax = 69 - function number
 3849 
  * eax = 69 - function number
3822 
  * ebx = 0 - subfunction number
 3850 
  * ebx = 0 - subfunction number
3823 
  * ecx = pointer
 3851 
  * ecx = pointer
3824 
Format of data area:
 3852 
Format of data area:
3825 
  * +0: dword: N = buffer size (not including this header)
 3853 
  * +0: dword: N = buffer size (not including this header)
3826 
  * +4: dword: occupied place
 3854 
  * +4: dword: occupied place
3827 
  * +8: N*byte: buffer
 3855 
  * +8: N*byte: buffer
3828 
Returned value:
 3856 
Returned value:
3829 
  * function does not return value
 3857 
  * function does not return value
3830 
Remarks:
 3858 
Remarks:
3831 
  * If the size field is negative, the buffer is considered locked
 3859 
  * If the size field is negative, the buffer is considered locked
3832 
    and at arrival of new message the system will wait.
 3860 
    and at arrival of new message the system will wait.
3833 
    For synchronization frame all work with the buffer by operations
 3861 
    For synchronization frame all work with the buffer by operations
3834 
    lock/unlock
 3862 
    lock/unlock
3835 
    	neg	[bufsize]
 3863 
    	neg	[bufsize]
3836 
  * Data in the buffer are considered as array of items with variable
 3864 
  * Data in the buffer are considered as array of items with variable
3837 
    length - messages. Format of a message is explained in
 3865 
    length - messages. Format of a message is explained in
3838 
    general description.
 3866 
    general description.
3839 
 
 3867 
 
3840 
======================================================================
 3868 
======================================================================
3841 
===================== Function 69, subfunction 1 =====================
 3869 
===================== Function 69, subfunction 1 =====================
3842 
============ Get contents of registers of debugged thread. ===========
 3870 
============ Get contents of registers of debugged thread. ===========
3843 
======================================================================
 3871 
======================================================================
3844 
Parameters:
 3872 
Parameters:
3845 
  * eax = 69 - function number
 3873 
  * eax = 69 - function number
3846 
  * ebx = 1 - subfunction number
 3874 
  * ebx = 1 - subfunction number
3847 
  * ecx = thread identifier
 3875 
  * ecx = thread identifier
3848 
  * edx = size of context structure, must be 0x28=40 bytes
 3876 
  * edx = size of context structure, must be 0x28=40 bytes
3849 
  * esi = pointer to context structure
 3877 
  * esi = pointer to context structure
3850 
Returned value:
 3878 
Returned value:
3851 
  * function does not return value
 3879 
  * function does not return value
3852 
Format of context structure: (FPU is not supported yet)
 3880 
Format of context structure: (FPU is not supported yet)
3853 
  * +0: dword: eip
 3881 
  * +0: dword: eip
3854 
  * +4: dword: eflags
 3882 
  * +4: dword: eflags
3855 
  * +8: dword: eax
 3883 
  * +8: dword: eax
3856 
  * +12 = +0xC: dword: ecx
 3884 
  * +12 = +0xC: dword: ecx
3857 
  * +16 = +0x10: dword: edx
 3885 
  * +16 = +0x10: dword: edx
3858 
  * +20 = +0x14: dword: ebx
 3886 
  * +20 = +0x14: dword: ebx
3859 
  * +24 = +0x18: dword: esp
 3887 
  * +24 = +0x18: dword: esp
3860 
  * +28 = +0x1C: dword: ebp
 3888 
  * +28 = +0x1C: dword: ebp
3861 
  * +32 = +0x20: dword: esi
 3889 
  * +32 = +0x20: dword: esi
3862 
  * +36 = +0x24: dword: edi
 3890 
  * +36 = +0x24: dword: edi
3863 
Remarks:
 3891 
Remarks:
3864 
  * If the thread executes code of ring-0, the function returns
 3892 
  * If the thread executes code of ring-0, the function returns
3865 
    contents of registers of ring-3.
 3893 
    contents of registers of ring-3.
3866 
  * Process must be loaded for debugging (as is shown in
 3894 
  * Process must be loaded for debugging (as is shown in
3867 
    general description).
 3895 
    general description).
3868 
 
 3896 
 
3869 
======================================================================
 3897 
======================================================================
3870 
===================== Function 69, subfunction 2 =====================
 3898 
===================== Function 69, subfunction 2 =====================
3871 
============ Set contents of registers of debugged thread. ===========
 3899 
============ Set contents of registers of debugged thread. ===========
3872 
======================================================================
 3900 
======================================================================
3873 
Parameters:
 3901 
Parameters:
3874 
  * eax = 69 - function number
 3902 
  * eax = 69 - function number
3875 
  * ebx = 2 - subfunction number
 3903 
  * ebx = 2 - subfunction number
3876 
  * ecx = thread identifier
 3904 
  * ecx = thread identifier
3877 
  * edx = size of context structure, must be 0x28=40 bytes
 3905 
  * edx = size of context structure, must be 0x28=40 bytes
3878 
Returned value:
 3906 
Returned value:
3879 
  * function does not return value
 3907 
  * function does not return value
3880 
Format of context structure is shown in the description of
 3908 
Format of context structure is shown in the description of
3881 
subfunction 1.
 3909 
subfunction 1.
3882 
Remarks:
 3910 
Remarks:
3883 
  * If the thread executes code of ring-0, the function returns
 3911 
  * If the thread executes code of ring-0, the function returns
3884 
    contents of registers of ring-3.
 3912 
    contents of registers of ring-3.
3885 
  * Process must be loaded for debugging (as is shown in
 3913 
  * Process must be loaded for debugging (as is shown in
3886 
    general description).
 3914 
    general description).
3887 
 
 3915 
 
3888 
======================================================================
 3916 
======================================================================
3889 
===== Function 69, subfunction 3 - detach from debugged process. =====
 3917 
===== Function 69, subfunction 3 - detach from debugged process. =====
3890 
======================================================================
 3918 
======================================================================
3891 
Parameters:
 3919 
Parameters:
3892 
  * eax = 69 - function number
 3920 
  * eax = 69 - function number
3893 
  * ebx = 3 - subfunction number
 3921 
  * ebx = 3 - subfunction number
3894 
  * ecx = identifier
 3922 
  * ecx = identifier
3895 
Returned value:
 3923 
Returned value:
3896 
  * function does not return value
 3924 
  * function does not return value
3897 
Remarks:
 3925 
Remarks:
3898 
  * If the process was suspended, it resumes execution.
 3926 
  * If the process was suspended, it resumes execution.
3899 
 
 3927 
 
3900 
======================================================================
 3928 
======================================================================
3901 
======== Function 69, subfunction 4 - suspend debugged thread. =======
 3929 
======== Function 69, subfunction 4 - suspend debugged thread. =======
3902 
======================================================================
 3930 
======================================================================
3903 
Parameters:
 3931 
Parameters:
3904 
  * eax = 69 - function number
 3932 
  * eax = 69 - function number
3905 
  * ebx = 4 - subfunction number
 3933 
  * ebx = 4 - subfunction number
3906 
  * ecx = thread identifier
 3934 
  * ecx = thread identifier
3907 
Returned value:
 3935 
Returned value:
3908 
  * function does not return value
 3936 
  * function does not return value
3909 
Remarks:
 3937 
Remarks:
3910 
  * Process must be loaded for debugging (as is shown in
 3938 
  * Process must be loaded for debugging (as is shown in
3911 
    general description).
 3939 
    general description).
3912 
 
 3940 
 
3913 
======================================================================
 3941 
======================================================================
3914 
======== Function 69, subfunction 5 - resume debugged thread. ========
 3942 
======== Function 69, subfunction 5 - resume debugged thread. ========
3915 
======================================================================
 3943 
======================================================================
3916 
Parameters:
 3944 
Parameters:
3917 
  * eax = 69 - function number
 3945 
  * eax = 69 - function number
3918 
  * ebx = 5 - subfunction number
 3946 
  * ebx = 5 - subfunction number
3919 
  * ecx = thread identifier
 3947 
  * ecx = thread identifier
3920 
Returned value:
 3948 
Returned value:
3921 
  * function does not return value
 3949 
  * function does not return value
3922 
Remarks:
 3950 
Remarks:
3923 
  * Process must be loaded for debugging (as is shown in
 3951 
  * Process must be loaded for debugging (as is shown in
3924 
    general description).
 3952 
    general description).
3925 
 
 3953 
 
3926 
======================================================================
 3954 
======================================================================
3927 
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
 3955 
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
3928 
======================================================================
 3956 
======================================================================
3929 
Parameters:
 3957 
Parameters:
3930 
  * eax = 69 - function number
 3958 
  * eax = 69 - function number
3931 
  * ebx = 6 - subfunction number
 3959 
  * ebx = 6 - subfunction number
3932 
  * ecx = identifier
 3960 
  * ecx = identifier
3933 
  * edx = number of bytes to read
 3961 
  * edx = number of bytes to read
3934 
  * esi = address in the memory of debugged process
 3962 
  * esi = address in the memory of debugged process
3935 
  * edi = pointer to buffer for data
 3963 
  * edi = pointer to buffer for data
3936 
Returned value:
 3964 
Returned value:
3937 
  * eax = -1 at an error (invalid PID or buffer)
 3965 
  * eax = -1 at an error (invalid PID or buffer)
3938 
  * otherwise eax = number of read bytes (possibly, 0,
 3966 
  * otherwise eax = number of read bytes (possibly, 0,
3939 
    if esi is too large)
 3967 
    if esi is too large)
3940 
Remarks:
 3968 
Remarks:
3941 
  * Process must be loaded for debugging (as is shown in
 3969 
  * Process must be loaded for debugging (as is shown in
3942 
    general description).
 3970 
    general description).
3943 
 
 3971 
 
3944 
======================================================================
 3972 
======================================================================
3945 
== Function 69, subfunction 7 - write to memory of debugged process. =
 3973 
== Function 69, subfunction 7 - write to memory of debugged process. =
3946 
======================================================================
 3974 
======================================================================
3947 
Parameters:
 3975 
Parameters:
3948 
  * eax = 69 - function number
 3976 
  * eax = 69 - function number
3949 
  * ebx = 7 - subfunction number
 3977 
  * ebx = 7 - subfunction number
3950 
  * ecx = identifier
 3978 
  * ecx = identifier
3951 
  * edx = number of bytes to write
 3979 
  * edx = number of bytes to write
3952 
  * esi = address of memory in debugged process
 3980 
  * esi = address of memory in debugged process
3953 
  * edi = pointer to data
 3981 
  * edi = pointer to data
3954 
Returned value:
 3982 
Returned value:
3955 
  * eax = -1 at an error (invalid PID or buffer)
 3983 
  * eax = -1 at an error (invalid PID or buffer)
3956 
  * otherwise eax = number of written bytes (possibly, 0,
 3984 
  * otherwise eax = number of written bytes (possibly, 0,
3957 
    if esi is too large)
 3985 
    if esi is too large)
3958 
Remarks:
 3986 
Remarks:
3959 
  * Process must be loaded for debugging (as is shown in
 3987 
  * Process must be loaded for debugging (as is shown in
3960 
    general description).
 3988 
    general description).
3961 
 
 3989 
 
3962 
======================================================================
 3990 
======================================================================
3963 
======= Function 69, subfunction 8 - terminate debugged thread. ======
 3991 
======= Function 69, subfunction 8 - terminate debugged thread. ======
3964 
======================================================================
 3992 
======================================================================
3965 
Parameters:
 3993 
Parameters:
3966 
  * eax = 69 - function number
 3994 
  * eax = 69 - function number
3967 
  * ebx = 8 - subfunction number
 3995 
  * ebx = 8 - subfunction number
3968 
  * ecx = identifier
 3996 
  * ecx = identifier
3969 
Returned value:
 3997 
Returned value:
3970 
  * function does not return value
 3998 
  * function does not return value
3971 
Remarks:
 3999 
Remarks:
3972 
  * Process must be loaded for debugging (as is shown in
 4000 
  * Process must be loaded for debugging (as is shown in
3973 
    general description).
 4001 
    general description).
3974 
  * The function is similar to subfunction 2 of function 18
 4002 
  * The function is similar to subfunction 2 of function 18
3975 
    with two differences: it requires first remark and
 4003 
    with two differences: it requires first remark and
3976 
    accepts PID rather than slot number.
 4004 
    accepts PID rather than slot number.
3977 
 
 4005 
 
3978 
======================================================================
 4006 
======================================================================
3979 
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
 4007 
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
3980 
======================================================================
 4008 
======================================================================
3981 
Parameters:
 4009 
Parameters:
3982 
  * eax = 69 - function number
 4010 
  * eax = 69 - function number
3983 
  * ebx = 9 - subfunction number
 4011 
  * ebx = 9 - subfunction number
3984 
  * ecx = thread identifier
 4012 
  * ecx = thread identifier
3985 
  * dl = index of breakpoint, from 0 to 3 inclusively
 4013 
  * dl = index of breakpoint, from 0 to 3 inclusively
3986 
  * dh = flags:
 4014 
  * dh = flags:
3987 
    * if high bit is cleared - set breakpoint:
 4015 
    * if high bit is cleared - set breakpoint:
3988 
      * bits 0-1 - condition:
 4016 
      * bits 0-1 - condition:
3989 
        * 00 = breakpoint on execution
 4017 
        * 00 = breakpoint on execution
3990 
        * 01 = breakpoint on read
 4018 
        * 01 = breakpoint on read
3991 
        * 11 = breakpoint on read/write
 4019 
        * 11 = breakpoint on read/write
3992 
      * bits 2-3 - length; for breakpoints on exception it must be
 4020 
      * bits 2-3 - length; for breakpoints on exception it must be
3993 
        00, otherwise one of
 4021 
        00, otherwise one of
3994 
        * 00 = byte
 4022 
        * 00 = byte
3995 
        * 01 = word
 4023 
        * 01 = word
3996 
        * 11 = dword
 4024 
        * 11 = dword
3997 
      * esi = breakpoint address; must be aligned according to
 4025 
      * esi = breakpoint address; must be aligned according to
3998 
        the length (i.e. must be even for word breakpoints,
 4026 
        the length (i.e. must be even for word breakpoints,
3999 
        divisible by 4 for dword)
 4027 
        divisible by 4 for dword)
4000 
    * if high bit is set - clear breakpoint
 4028 
    * if high bit is set - clear breakpoint
4001 
Returned value:
 4029 
Returned value:
4002 
  * eax = 0 - success
 4030 
  * eax = 0 - success
4003 
  * eax = 1 - error in the input data
 4031 
  * eax = 1 - error in the input data
4004 
  * eax = 2 - (reserved, is never returned in the current
 4032 
  * eax = 2 - (reserved, is never returned in the current
4005 
    implementation) a global breakpoint with that index is already set
 4033 
    implementation) a global breakpoint with that index is already set
4006 
Remarks:
 4034 
Remarks:
4007 
  * Process must be loaded for debugging (as is shown in
 4035 
  * Process must be loaded for debugging (as is shown in
4008 
    general description).
 4036 
    general description).
4009 
  * Hardware breakpoints are implemented through DRx-registers of
 4037 
  * Hardware breakpoints are implemented through DRx-registers of
4010 
    the processor, all limitations results from this.
 4038 
    the processor, all limitations results from this.
4011 
  * The function can reinstall the breakpoint, previously set
 4039 
  * The function can reinstall the breakpoint, previously set
4012 
    by it (and it does not inform on this).
 4040 
    by it (and it does not inform on this).
4013 
    Carry on the list of set breakpoints in the debugger.
 4041 
    Carry on the list of set breakpoints in the debugger.
4014 
  * Breakpoints generate debug exception #DB, on which the system
 4042 
  * Breakpoints generate debug exception #DB, on which the system
4015 
    notifies debugger.
 4043 
    notifies debugger.
4016 
  * Breakpoints on write and read/write act after
 4044 
  * Breakpoints on write and read/write act after
4017 
    execution of the caused it instruction.
 4045 
    execution of the caused it instruction.
4018 
 
 4046 
 
4019 
======================================================================
 4047 
======================================================================
4020 
==== Function 70 - work with file system with long names support. ====
 4048 
==== Function 70 - work with file system with long names support. ====
4021 
======================================================================
 4049 
======================================================================
4022 
Parameters:
 4050 
Parameters:
4023 
  * eax = 70
 4051 
  * eax = 70
4024 
  * ebx = pointer to the information structure
 4052 
  * ebx = pointer to the information structure
4025 
Returned value:
 4053 
Returned value:
4026 
  * eax = 0 - success; otherwise file system error code
 4054 
  * eax = 0 - success; otherwise file system error code
4027 
  * some subfunctions return value in other registers too
 4055 
  * some subfunctions return value in other registers too
4028 
General format of the information structure:
 4056 
General format of the information structure:
4029 
  * +0: dword: subfunction number
 4057 
  * +0: dword: subfunction number
4030 
  * +4: dword: file offset
 4058 
  * +4: dword: file offset
4031 
  * +8: dword: high dword of offset (must be 0) or flags field
 4059 
  * +8: dword: high dword of offset (must be 0) or flags field
4032 
  * +12 = +0xC: dword: size
 4060 
  * +12 = +0xC: dword: size
4033 
  * +16 = +0x10: dword: pointer to data
 4061 
  * +16 = +0x10: dword: pointer to data
4034 
  * +20 = +0x14: n db: ASCIIZ-string with the filename
 4062 
  * +20 = +0x14: n db: ASCIIZ-string with the filename
4035 
    or
 4063 
    or
4036 
  * +20 = +0x14: db 0
 4064 
  * +20 = +0x14: db 0
4037 
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
 4065 
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
4038 
Specifications - in documentation on the appropriate subfunction.
 4066 
Specifications - in documentation on the appropriate subfunction.
4039 
Filename is case-insensitive. Russian letters must be written in
 4067 
Filename is case-insensitive. Russian letters must be written in
4040 
the encoding cp866 (DOS).
 4068 
the encoding cp866 (DOS).
4041 
Format of filename:
 4069 
Format of filename:
4042 
/base/number/dir1/dir2/.../dirn/file,
 4070 
/base/number/dir1/dir2/.../dirn/file,
4043 
where /base/number identifies device, on which file is located:
 4071 
where /base/number identifies device, on which file is located:
4044 
one of
 4072 
one of
4045 
  * /RD/1 = /RAMDISK/1 to access ramdisk
 4073 
  * /RD/1 = /RAMDISK/1 to access ramdisk
4046 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
 4074 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
4047 
    /FD/2 = /FLOPPYDISK/2 to access second one
 4075 
    /FD/2 = /FLOPPYDISK/2 to access second one
4048 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
 4076 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
4049 
    IDE0 (Primary Master), IDE1 (Primary Slave),
 4077 
    IDE0 (Primary Master), IDE1 (Primary Slave),
4050 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
 4078 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4051 
    x - partition number on the selected hard drive, varies from 1
 4079 
    x - partition number on the selected hard drive, varies from 1
4052 
    to 255 (on each hard drive the indexing starts from 1)
 4080 
    to 255 (on each hard drive the indexing starts from 1)
4053 
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
 4081 
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
4054 
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
 4082 
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
4055 
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
 4083 
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
4056 
  * /SYS means system folder; with the usual boot (from floppy)
 4084 
  * /SYS means system folder; with the usual boot (from floppy)
4057 
    is equivalent to /RD/1
 4085 
    is equivalent to /RD/1
4058 
Examples:
 4086 
Examples:
4059 
  * '/rd/1/kernel.asm',0
 4087 
  * '/rd/1/kernel.asm',0
4060 
  * '/HD0/1/kernel.asm',0
 4088 
  * '/HD0/1/kernel.asm',0
4061 
  * '/hd0/2/menuet/pics/tanzania.bmp',0
 4089 
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4062 
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
 4090 
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
4063 
  * '/sys/MySuperApp.ini',0
 4091 
  * '/sys/MySuperApp.ini',0
4064 
Available subfunctions:
 4092 
Available subfunctions:
4065 
  * subfunction 0 - read file
 4093 
  * subfunction 0 - read file
4066 
  * subfunction 1 - read folder
 4094 
  * subfunction 1 - read folder
4067 
  * subfunction 2 - create/rewrite file
 4095 
  * subfunction 2 - create/rewrite file
4068 
  * subfunction 3 - write to existing file
 4096 
  * subfunction 3 - write to existing file
4069 
  * subfunction 4 - set file size
 4097 
  * subfunction 4 - set file size
4070 
  * subfunction 5 - get attributes of file/folder
 4098 
  * subfunction 5 - get attributes of file/folder
4071 
  * subfunction 6 - set attributes of file/folder
 4099 
  * subfunction 6 - set attributes of file/folder
4072 
  * subfunction 7 - start application
 4100 
  * subfunction 7 - start application
4073 
  * subfunction 8 - delete file/folder
 4101 
  * subfunction 8 - delete file/folder
4074 
  * subfunction 9 - create folder
 4102 
  * subfunction 9 - create folder
4075 
For CD-drives due to hardware limitations only subfunctions
 4103 
For CD-drives due to hardware limitations only subfunctions
4076 
0,1,5 and 7 are available, other subfunctions return error
 4104 
0,1,5 and 7 are available, other subfunctions return error
4077 
with code 2.
 4105 
with code 2.
4078 
At the first call subfunctions 0,1,5,7 to devices ATAPI (CD and DVD) the locking
 4106 
At the first call subfunctions 0,1,5,7 to devices ATAPI (CD and DVD) the locking
4079 
of handle mechanism of a tray is made. It is connected to algorithm of caching
 4107 
of handle mechanism of a tray is made. It is connected to algorithm of caching
4080 
given obtained from a drive. Deblocking is made by call subfunction 10
 4108 
given obtained from a drive. Deblocking is made by call function 24.4
4081 
to the appropriate device.
 4109 
to the appropriate device.
4082 
 
 4110 
 
4083 
======================================================================
 4111 
======================================================================
4084 
=== Function 70, subfunction 0 - read file with long names support. ==
 4112 
=== Function 70, subfunction 0 - read file with long names support. ==
4085 
======================================================================
 4113 
======================================================================
4086 
Parameters:
 4114 
Parameters:
4087 
  * eax = 70 - function number
 4115 
  * eax = 70 - function number
4088 
  * ebx = pointer to the information structure
 4116 
  * ebx = pointer to the information structure
4089 
Format of the information structure:
 4117 
Format of the information structure:
4090 
  * +0: dword: 0 = subfunction number
 4118 
  * +0: dword: 0 = subfunction number
4091 
  * +4: dword: file offset (in bytes)
 4119 
  * +4: dword: file offset (in bytes)
4092 
  * +8: dword: 0 (reserved for high dword of offset)
 4120 
  * +8: dword: 0 (reserved for high dword of offset)
4093 
  * +12 = +0xC: dword: number of bytes to read
 4121 
  * +12 = +0xC: dword: number of bytes to read
4094 
  * +16 = +0x10: dword: pointer to buffer for data
 4122 
  * +16 = +0x10: dword: pointer to buffer for data
4095 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4123 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4096 
    given in the general description
 4124 
    given in the general description
4097 
    or
 4125 
    or
4098 
  * +20 = +0x14: db 0
 4126 
  * +20 = +0x14: db 0
4099 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4127 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4100 
Returned value:
 4128 
Returned value:
4101 
  * eax = 0 - success, otherwise file system error code
 4129 
  * eax = 0 - success, otherwise file system error code
4102 
  * ebx = number of read bytes or -1=0xffffffff if file was not found
 4130 
  * ebx = number of read bytes or -1=0xffffffff if file was not found
4103 
Remarks:
 4131 
Remarks:
4104 
  * If file was ended before last requested block was read,
 4132 
  * If file was ended before last requested block was read,
4105 
    the function will read as many as it can, and after that return
 4133 
    the function will read as many as it can, and after that return
4106 
    eax=6 (EOF).
 4134 
    eax=6 (EOF).
4107 
  * The function does not allow to read folder (returns eax=10,
 4135 
  * The function does not allow to read folder (returns eax=10,
4108 
    access denied).
 4136 
    access denied).
4109 
 
 4137 
 
4110 
======================================================================
 4138 
======================================================================
4111 
== Function 70, subfunction 1 - read folder with long names support. =
 4139 
== Function 70, subfunction 1 - read folder with long names support. =
4112 
======================================================================
 4140 
======================================================================
4113 
Parameters:
 4141 
Parameters:
4114 
  * eax = 70 - function number
 4142 
  * eax = 70 - function number
4115 
  * ebx = pointer to the information structure
 4143 
  * ebx = pointer to the information structure
4116 
Format of the information structure:
 4144 
Format of the information structure:
4117 
  * +0: dword: 1 = subfunction number
 4145 
  * +0: dword: 1 = subfunction number
4118 
  * +4: dword: index of starting block (beginning from 0)
 4146 
  * +4: dword: index of starting block (beginning from 0)
4119 
  * +8: dword: flags field:
 4147 
  * +8: dword: flags field:
4120 
    * bit 0 (mask 1): in what format to return names,
 4148 
    * bit 0 (mask 1): in what format to return names,
4121 
      0=ANSI, 1=UNICODE
 4149 
      0=ANSI, 1=UNICODE
4122 
    * other bits are reserved and must be set to 0 for the future
 4150 
    * other bits are reserved and must be set to 0 for the future
4123 
      compatibility
 4151 
      compatibility
4124 
  * +12 = +0xC: dword: number of blocks to read
 4152 
  * +12 = +0xC: dword: number of blocks to read
4125 
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
 4153 
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
4126 
    must be not less than 32 + [+12]*560 bytes
 4154 
    must be not less than 32 + [+12]*560 bytes
4127 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
 4155 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4128 
    given in the general description
 4156 
    given in the general description
4129 
    or
 4157 
    or
4130 
  * +20 = +0x14: db 0
 4158 
  * +20 = +0x14: db 0
4131 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4159 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4132 
Returned value:
 4160 
Returned value:
4133 
  * eax = 0 - success, otherwise file system error code
 4161 
  * eax = 0 - success, otherwise file system error code
4134 
  * ebx = number of files, information on which was written to
 4162 
  * ebx = number of files, information on which was written to
4135 
    the buffer, or -1=0xffffffff, if folder was not found
 4163 
    the buffer, or -1=0xffffffff, if folder was not found
4136 
Structure of the buffer:
 4164 
Structure of the buffer:
4137 
  * +0: 32*byte: header
 4165 
  * +0: 32*byte: header
4138 
  * +32 = +0x20: n1*byte: block with information on file 1
 4166 
  * +32 = +0x20: n1*byte: block with information on file 1
4139 
  * +32+n1: n2*byte: block with information on file 2
 4167 
  * +32+n1: n2*byte: block with information on file 2
4140 
  * ...
 4168 
  * ...
4141 
Structure of header:
 4169 
Structure of header:
4142 
  * +0: dword: version of structure (current is 1)
 4170 
  * +0: dword: version of structure (current is 1)
4143 
  * +4: dword: number of placed blocks; is not greater than requested
 4171 
  * +4: dword: number of placed blocks; is not greater than requested
4144 
    in the field +12 of information structure; can be less, if
 4172 
    in the field +12 of information structure; can be less, if
4145 
    there are no more files in folder (the same as in ebx)
 4173 
    there are no more files in folder (the same as in ebx)
4146 
  * +8: dword: total number of files in folder
 4174 
  * +8: dword: total number of files in folder
4147 
  * +12 = +0xC: 20*byte: reserved (zeroed)
 4175 
  * +12 = +0xC: 20*byte: reserved (zeroed)
4148 
Structure of block of data for folder entry (BDFE):
 4176 
Structure of block of data for folder entry (BDFE):
4149 
  * +0: dword: attributes of file:
 4177 
  * +0: dword: attributes of file:
4150 
    * bit 0 (mask 1): file is read-only
 4178 
    * bit 0 (mask 1): file is read-only
4151 
    * bit 1 (mask 2): file is hidden
 4179 
    * bit 1 (mask 2): file is hidden
4152 
    * bit 2 (mask 4): file is system
 4180 
    * bit 2 (mask 4): file is system
4153 
    * bit 3 (mask 8): this is not a file but volume label
 4181 
    * bit 3 (mask 8): this is not a file but volume label
4154 
      (for one partition meets no more than once and
 4182 
      (for one partition meets no more than once and
4155 
      only in root folder)
 4183 
      only in root folder)
4156 
    * bit 4 (mask 0x10): this is a folder
 4184 
    * bit 4 (mask 0x10): this is a folder
4157 
    * bit 5 (mask 0x20): file was not archived - many archivation
 4185 
    * bit 5 (mask 0x20): file was not archived - many archivation
4158 
      programs have an option to archive only files with this bit set,
 4186 
      programs have an option to archive only files with this bit set,
4159 
      and after archiving this bit is cleared - it can be useful
 4187 
      and after archiving this bit is cleared - it can be useful
4160 
      for automatically creating of backup-archives as at writing
 4188 
      for automatically creating of backup-archives as at writing
4161 
      this bit is usually set
 4189 
      this bit is usually set
4162 
  * +4: byte: type of name data:
 4190 
  * +4: byte: type of name data:
4163 
    (coincides with bit 0 of flags in the information structure)
 4191 
    (coincides with bit 0 of flags in the information structure)
4164 
    * 0 = ASCII = 1-byte representation of each character
 4192 
    * 0 = ASCII = 1-byte representation of each character
4165 
    * 1 = UNICODE = 2-byte representation of each character
 4193 
    * 1 = UNICODE = 2-byte representation of each character
4166 
  * +5: 3*byte: reserved (zero)
 4194 
  * +5: 3*byte: reserved (zero)
4167 
  * +8: 4*byte: time of file creation
 4195 
  * +8: 4*byte: time of file creation
4168 
  * +12 = +0xC: 4*byte: date of file creation
 4196 
  * +12 = +0xC: 4*byte: date of file creation
4169 
  * +16 = +0x10: 4*byte: time of last access (read or write)
 4197 
  * +16 = +0x10: 4*byte: time of last access (read or write)
4170 
  * +20 = +0x14: 4*byte: date of last access
 4198 
  * +20 = +0x14: 4*byte: date of last access
4171 
  * +24 = +0x18: 4*byte: time of last modification
 4199 
  * +24 = +0x18: 4*byte: time of last modification
4172 
  * +28 = +0x1C: 4*byte: date of last modification
 4200 
  * +28 = +0x1C: 4*byte: date of last modification
4173 
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
 4201 
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
4174 
  * +40 = +0x28: name
 4202 
  * +40 = +0x28: name
4175 
    * for ASCII format: maximum length is 263 characters
 4203 
    * for ASCII format: maximum length is 263 characters
4176 
      (263 bytes), byte after the name has value 0
 4204 
      (263 bytes), byte after the name has value 0
4177 
    * for UNICODE format: maximum length is 259 characters
 4205 
    * for UNICODE format: maximum length is 259 characters
4178 
      (518 bytes), 2 bytes after the name have value 0
 4206 
      (518 bytes), 2 bytes after the name have value 0
4179 
Time format:
 4207 
Time format:
4180 
  * +0: byte: seconds
 4208 
  * +0: byte: seconds
4181 
  * +1: byte: minutes
 4209 
  * +1: byte: minutes
4182 
  * +2: byte: hours
 4210 
  * +2: byte: hours
4183 
  * +3: byte: reserved (0)
 4211 
  * +3: byte: reserved (0)
4184 
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
 4212 
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
4185 
Date format:
 4213 
Date format:
4186 
  * +0: byte: day
 4214 
  * +0: byte: day
4187 
  * +1: byte: month
 4215 
  * +1: byte: month
4188 
  * +2: word: year
 4216 
  * +2: word: year
4189 
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
 4217 
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
4190 
Remarks:
 4218 
Remarks:
4191 
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
 4219 
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
4192 
    if UNICODE name - 560 bytes. Value of length is aligned
 4220 
    if UNICODE name - 560 bytes. Value of length is aligned
4193 
    on 16-byte bound (to accelerate processing in CPU cache).
 4221 
    on 16-byte bound (to accelerate processing in CPU cache).
4194 
  * First character after a name is zero (ASCIIZ-string). The further
 4222 
  * First character after a name is zero (ASCIIZ-string). The further
4195 
    data contain garbage.
 4223 
    data contain garbage.
4196 
  * If files in folder were ended before requested number was read,
 4224 
  * If files in folder were ended before requested number was read,
4197 
    the function will read as many as it can, and after that return
 4225 
    the function will read as many as it can, and after that return
4198 
    eax=6 (EOF).
 4226 
    eax=6 (EOF).
4199 
  * Any folder on the disk, except for root, contains two special
 4227 
  * Any folder on the disk, except for root, contains two special
4200 
    entries "." and "..", identifying accordingly the folder itself
 4228 
    entries "." and "..", identifying accordingly the folder itself
4201 
    and the parent folder.
 4229 
    and the parent folder.
4202 
  * The function allows also to read virtual folders "/", "/rd",
 4230 
  * The function allows also to read virtual folders "/", "/rd",
4203 
    "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
 4231 
    "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
4204 
    and times and dates are zeroed. An alternative way to get the
 4232 
    and times and dates are zeroed. An alternative way to get the
4205 
    equipment information - subfunction 11 of function 18.
 4233 
    equipment information - subfunction 11 of function 18.
4206 
 
 4234 
 
4207 
======================================================================
 4235 
======================================================================
4208 
===================== Function 70, subfunction 2 =====================
 4236 
===================== Function 70, subfunction 2 =====================
4209 
============ Create/rewrite file with long names support. ============
 4237 
============ Create/rewrite file with long names support. ============
4210 
======================================================================
 4238 
======================================================================
4211 
Parameters:
 4239 
Parameters:
4212 
  * eax = 70 - function number
 4240 
  * eax = 70 - function number
4213 
  * ebx = pointer to the information structure
 4241 
  * ebx = pointer to the information structure
4214 
Format of the information structure:
 4242 
Format of the information structure:
4215 
  * +0: dword: 2 = subfunction number
 4243 
  * +0: dword: 2 = subfunction number
4216 
  * +4: dword: 0 (reserved)
 4244 
  * +4: dword: 0 (reserved)
4217 
  * +8: dword: 0 (reserved)
 4245 
  * +8: dword: 0 (reserved)
4218 
  * +12 = +0xC: dword: number of bytes to read
 4246 
  * +12 = +0xC: dword: number of bytes to read
4219 
  * +16 = +0x10: dword: pointer to data
 4247 
  * +16 = +0x10: dword: pointer to data
4220 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4248 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4221 
    given in the general description
 4249 
    given in the general description
4222 
    or
 4250 
    or
4223 
  * +20 = +0x14: db 0
 4251 
  * +20 = +0x14: db 0
4224 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4252 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4225 
Returned value:
 4253 
Returned value:
4226 
  * eax = 0 - success, otherwise file system error code
 4254 
  * eax = 0 - success, otherwise file system error code
4227 
  * ebx = number of written bytes (possibly 0)
 4255 
  * ebx = number of written bytes (possibly 0)
4228 
Remarks:
 4256 
Remarks:
4229 
  * If a file with given name did not exist, it is created;
 4257 
  * If a file with given name did not exist, it is created;
4230 
    if it existed, it is rewritten.
 4258 
    if it existed, it is rewritten.
4231 
  * If there is not enough free space on disk, the function will
 4259 
  * If there is not enough free space on disk, the function will
4232 
    write as many as can and then return error code 8.
 4260 
    write as many as can and then return error code 8.
4233 
  * The function is not supported for CD (returns error code 2).
 4261 
  * The function is not supported for CD (returns error code 2).
4234 
 
 4262 
 
4235 
======================================================================
 4263 
======================================================================
4236 
===================== Function 70, subfunction 3 =====================
 4264 
===================== Function 70, subfunction 3 =====================
4237 
=========== Write to existing file with long names support. ==========
 4265 
=========== Write to existing file with long names support. ==========
4238 
======================================================================
 4266 
======================================================================
4239 
Parameters:
 4267 
Parameters:
4240 
  * eax = 70 - function number
 4268 
  * eax = 70 - function number
4241 
  * ebx = pointer to the information structure
 4269 
  * ebx = pointer to the information structure
4242 
Format of the information structure:
 4270 
Format of the information structure:
4243 
  * +0: dword: 3 = subfunction number
 4271 
  * +0: dword: 3 = subfunction number
4244 
  * +4: dword: file offset (in bytes)
 4272 
  * +4: dword: file offset (in bytes)
4245 
  * +8: dword: high dword of offset (must be 0 for FAT)
 4273 
  * +8: dword: high dword of offset (must be 0 for FAT)
4246 
  * +12 = +0xC: dword: number of bytes to write
 4274 
  * +12 = +0xC: dword: number of bytes to write
4247 
  * +16 = +0x10: dword: pointer to data
 4275 
  * +16 = +0x10: dword: pointer to data
4248 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4276 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4249 
    given in the general description
 4277 
    given in the general description
4250 
    or
 4278 
    or
4251 
  * +20 = +0x14: db 0
 4279 
  * +20 = +0x14: db 0
4252 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4280 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4253 
Returned value:
 4281 
Returned value:
4254 
  * eax = 0 - success, otherwise file system error code
 4282 
  * eax = 0 - success, otherwise file system error code
4255 
  * ebx = number of written bytes (possibly 0)
 4283 
  * ebx = number of written bytes (possibly 0)
4256 
Remarks:
 4284 
Remarks:
4257 
  * The file must already exist, otherwise function returns eax=5.
 4285 
  * The file must already exist, otherwise function returns eax=5.
4258 
  * The only result of write 0 bytes is update in the file attributes
 4286 
  * The only result of write 0 bytes is update in the file attributes
4259 
    date/time of modification and access to the current date/time.
 4287 
    date/time of modification and access to the current date/time.
4260 
  * If beginning and/or ending position is greater than file size
 4288 
  * If beginning and/or ending position is greater than file size
4261 
    (except for the previous case), the file is expanded to needed
 4289 
    (except for the previous case), the file is expanded to needed
4262 
    size with zero characters.
 4290 
    size with zero characters.
4263 
  * The function is not supported for CD (returns error code 2).
 4291 
  * The function is not supported for CD (returns error code 2).
4264 
 
 4292 
 
4265 
======================================================================
 4293 
======================================================================
4266 
============ Function 70, subfunction 4 - set end of file. ===========
 4294 
============ Function 70, subfunction 4 - set end of file. ===========
4267 
======================================================================
 4295 
======================================================================
4268 
Parameters:
 4296 
Parameters:
4269 
  * eax = 70 - function number
 4297 
  * eax = 70 - function number
4270 
  * ebx = pointer to the information structure
 4298 
  * ebx = pointer to the information structure
4271 
Format of the information structure:
 4299 
Format of the information structure:
4272 
  * +0: dword: 4 = subfunction number
 4300 
  * +0: dword: 4 = subfunction number
4273 
  * +4: dword: low dword of new file size
 4301 
  * +4: dword: low dword of new file size
4274 
  * +8: dword: high dword of new file size (must be 0 for FAT)
 4302 
  * +8: dword: high dword of new file size (must be 0 for FAT)
4275 
  * +12 = +0xC: dword: 0 (reserved)
 4303 
  * +12 = +0xC: dword: 0 (reserved)
4276 
  * +16 = +0x10: dword: 0 (reserved)
 4304 
  * +16 = +0x10: dword: 0 (reserved)
4277 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4305 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4278 
    given in the general description
 4306 
    given in the general description
4279 
    or
 4307 
    or
4280 
  * +20 = +0x14: db 0
 4308 
  * +20 = +0x14: db 0
4281 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4309 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4282 
Returned value:
 4310 
Returned value:
4283 
  * eax = 0 - success, otherwise file system error code
 4311 
  * eax = 0 - success, otherwise file system error code
4284 
  * ebx destroyed
 4312 
  * ebx destroyed
4285 
Remarks:
 4313 
Remarks:
4286 
  * If the new file size is less than old one, file is truncated.
 4314 
  * If the new file size is less than old one, file is truncated.
4287 
    If the new size is greater than old one, file is expanded with
 4315 
    If the new size is greater than old one, file is expanded with
4288 
    characters with code 0. If the new size is equal to old one,
 4316 
    characters with code 0. If the new size is equal to old one,
4289 
    the only result of call is set date/time of modification and
 4317 
    the only result of call is set date/time of modification and
4290 
    access to the current date/time.
 4318 
    access to the current date/time.
4291 
  * If there is not enough free space on disk for expansion, the
 4319 
  * If there is not enough free space on disk for expansion, the
4292 
    function will expand to maximum possible size and then return
 4320 
    function will expand to maximum possible size and then return
4293 
    error code 8.
 4321 
    error code 8.
4294 
  * The function is not supported for CD (returns error code 2).
 4322 
  * The function is not supported for CD (returns error code 2).
4295 
 
 4323 
 
4296 
======================================================================
 4324 
======================================================================
4297 
==== Function 70, subfunction 5 - get information on file/folder. ====
 4325 
==== Function 70, subfunction 5 - get information on file/folder. ====
4298 
======================================================================
 4326 
======================================================================
4299 
Parameters:
 4327 
Parameters:
4300 
  * eax = 70 - function number
 4328 
  * eax = 70 - function number
4301 
  * ebx = pointer to the information structure
 4329 
  * ebx = pointer to the information structure
4302 
Format of the information structure:
 4330 
Format of the information structure:
4303 
  * +0: dword: 5 = subfunction number
 4331 
  * +0: dword: 5 = subfunction number
4304 
  * +4: dword: 0 (reserved)
 4332 
  * +4: dword: 0 (reserved)
4305 
  * +8: dword: 0 (reserved)
 4333 
  * +8: dword: 0 (reserved)
4306 
  * +12 = +0xC: dword: 0 (reserved)
 4334 
  * +12 = +0xC: dword: 0 (reserved)
4307 
  * +16 = +0x10: dword: pointer to buffer for data (40 bytes)
 4335 
  * +16 = +0x10: dword: pointer to buffer for data (40 bytes)
4308 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4336 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4309 
    given in the general description
 4337 
    given in the general description
4310 
    or
 4338 
    or
4311 
  * +20 = +0x14: db 0
 4339 
  * +20 = +0x14: db 0
4312 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4340 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4313 
Returned value:
 4341 
Returned value:
4314 
  * eax = 0 - success, otherwise file system error code
 4342 
  * eax = 0 - success, otherwise file system error code
4315 
  * ebx destroyed
 4343 
  * ebx destroyed
4316 
Information on file is returned in the BDFE format (block of data
 4344 
Information on file is returned in the BDFE format (block of data
4317 
for folder entry), explained in the description of
 4345 
for folder entry), explained in the description of
4318 
subfunction 1, but without filename
 4346 
subfunction 1, but without filename
4319 
(i.e. only first 40 = 0x28 bytes).
 4347 
(i.e. only first 40 = 0x28 bytes).
4320 
Remarks:
 4348 
Remarks:
4321 
  * The function does not support virtual folders such as /, /rd and
 4349 
  * The function does not support virtual folders such as /, /rd and
4322 
    root folders like /rd/1.
 4350 
    root folders like /rd/1.
4323 
 
 4351 
 
4324 
======================================================================
 4352 
======================================================================
4325 
===== Function 70, subfunction 6 - set attributes of file/folder. ====
 4353 
===== Function 70, subfunction 6 - set attributes of file/folder. ====
4326 
======================================================================
 4354 
======================================================================
4327 
Parameters:
 4355 
Parameters:
4328 
  * eax = 70 - function number
 4356 
  * eax = 70 - function number
4329 
  * ebx = pointer to the information structure
 4357 
  * ebx = pointer to the information structure
4330 
Format of the information structure:
 4358 
Format of the information structure:
4331 
  * +0: dword: 6 = subfunction number
 4359 
  * +0: dword: 6 = subfunction number
4332 
  * +4: dword: 0 (reserved)
 4360 
  * +4: dword: 0 (reserved)
4333 
  * +8: dword: 0 (reserved)
 4361 
  * +8: dword: 0 (reserved)
4334 
  * +12 = +0xC: dword: 0 (reserved)
 4362 
  * +12 = +0xC: dword: 0 (reserved)
4335 
  * +16 = +0x10: dword: pointer to buffer with attributes (32 bytes)
 4363 
  * +16 = +0x10: dword: pointer to buffer with attributes (32 bytes)
4336 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4364 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4337 
    given in the general description
 4365 
    given in the general description
4338 
    or
 4366 
    or
4339 
  * +20 = +0x14: db 0
 4367 
  * +20 = +0x14: db 0
4340 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4368 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4341 
Returned value:
 4369 
Returned value:
4342 
  * eax = 0 - success, otherwise file system error code
 4370 
  * eax = 0 - success, otherwise file system error code
4343 
  * ebx destroyed
 4371 
  * ebx destroyed
4344 
File attributes are first 32 bytes in BDFE (block of data
 4372 
File attributes are first 32 bytes in BDFE (block of data
4345 
for folder entry), explained in the description of subfunction 1
 4373 
for folder entry), explained in the description of subfunction 1
4346 
(that is, without name and size of file). Attribute
 4374 
(that is, without name and size of file). Attribute
4347 
file/folder/volume label (bits 3,4 in dword +0) is not changed.
 4375 
file/folder/volume label (bits 3,4 in dword +0) is not changed.
4348 
Byte +4 (name format) is ignored.
 4376 
Byte +4 (name format) is ignored.
4349 
Remarks:
 4377 
Remarks:
4350 
  * The function does not support virtual folders such as /, /rd and
 4378 
  * The function does not support virtual folders such as /, /rd and
4351 
    root folders like /rd/1.
 4379 
    root folders like /rd/1.
4352 
  * The function is not supported for CD (returns error code 2).
 4380 
  * The function is not supported for CD (returns error code 2).
4353 
 
 4381 
 
4354 
======================================================================
 4382 
======================================================================
4355 
=========== Function 70, subfunction 7 - start application. ==========
 4383 
=========== Function 70, subfunction 7 - start application. ==========
4356 
======================================================================
 4384 
======================================================================
4357 
Parameters:
 4385 
Parameters:
4358 
  * eax = 70 - function number
 4386 
  * eax = 70 - function number
4359 
  * ebx = pointer to the information structure
 4387 
  * ebx = pointer to the information structure
4360 
Format of the information structure:
 4388 
Format of the information structure:
4361 
  * +0: dword: 7 = subfunction number
 4389 
  * +0: dword: 7 = subfunction number
4362 
  * +4: dword: flags field:
 4390 
  * +4: dword: flags field:
4363 
    * áèò 0: start process as debugged
 4391 
    * áèò 0: start process as debugged
4364 
    * other bits are reserved and must be set to 0
 4392 
    * other bits are reserved and must be set to 0
4365 
  * +8: dword: 0 or pointer to ASCIIZ-string with parameters
 4393 
  * +8: dword: 0 or pointer to ASCIIZ-string with parameters
4366 
  * +12 = +0xC: dword: 0 (reserved)
 4394 
  * +12 = +0xC: dword: 0 (reserved)
4367 
  * +16 = +0x10: dword: 0 (reserved)
 4395 
  * +16 = +0x10: dword: 0 (reserved)
4368 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4396 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4369 
    given in the general description
 4397 
    given in the general description
4370 
    or
 4398 
    or
4371 
  * +20 = +0x14: db 0
 4399 
  * +20 = +0x14: db 0
4372 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4400 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4373 
Returned value:
 4401 
Returned value:
4374 
  * eax > 0 - program is loaded, eax contains PID
 4402 
  * eax > 0 - program is loaded, eax contains PID
4375 
  * eax < 0 - an error has occured, -eax contains
 4403 
  * eax < 0 - an error has occured, -eax contains
4376 
    file system error code
 4404 
    file system error code
4377 
  * ebx destroyed
 4405 
  * ebx destroyed
4378 
Remarks:
 4406 
Remarks:
4379 
  * Command line must be terminated by the character with the code 0
 4407 
  * Command line must be terminated by the character with the code 0
4380 
    (ASCIIZ-string); function takes into account either all characters
 4408 
    (ASCIIZ-string); function takes into account either all characters
4381 
    up to terminating zero inclusively or first 256 character
 4409 
    up to terminating zero inclusively or first 256 character
4382 
    regarding what is less.
 4410 
    regarding what is less.
4383 
  * If the process is started as debugged, it is created in
 4411 
  * If the process is started as debugged, it is created in
4384 
    the suspended state; to run use subfunction 5 of function 69.
 4412 
    the suspended state; to run use subfunction 5 of function 69.
4385 
 
 4413 
 
4386 
======================================================================
 4414 
======================================================================
4387 
========== Function 70, subfunction 8 - delete file/folder. ==========
 4415 
========== Function 70, subfunction 8 - delete file/folder. ==========
4388 
======================================================================
 4416 
======================================================================
4389 
Parameters:
 4417 
Parameters:
4390 
  * eax = 70 - function number
 4418 
  * eax = 70 - function number
4391 
  * ebx = pointer to the information structure
 4419 
  * ebx = pointer to the information structure
4392 
Format of the information structure:
 4420 
Format of the information structure:
4393 
  * +0: dword: 8 = subfunction number
 4421 
  * +0: dword: 8 = subfunction number
4394 
  * +4: dword: 0 (reserved)
 4422 
  * +4: dword: 0 (reserved)
4395 
  * +8: dword: 0 (reserved)
 4423 
  * +8: dword: 0 (reserved)
4396 
  * +12 = +0xC: dword: 0 (reserved)
 4424 
  * +12 = +0xC: dword: 0 (reserved)
4397 
  * +16 = +0x10: dword: 0 (reserved)
 4425 
  * +16 = +0x10: dword: 0 (reserved)
4398 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4426 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4399 
    given in the general description
 4427 
    given in the general description
4400 
    or
 4428 
    or
4401 
  * +20 = +0x14: db 0
 4429 
  * +20 = +0x14: db 0
4402 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4430 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4403 
Returned value:
 4431 
Returned value:
4404 
  * eax = 0 - success, otherwise file system error code
 4432 
  * eax = 0 - success, otherwise file system error code
4405 
  * ebx destroyed
 4433 
  * ebx destroyed
4406 
Remarks:
 4434 
Remarks:
4407 
  * The function is not supported for CD (returns error code 2).
 4435 
  * The function is not supported for CD (returns error code 2).
4408 
  * The function can delete only empty folders (attempt to delete
 4436 
  * The function can delete only empty folders (attempt to delete
4409 
    nonempty folder results in error with code 10, "access denied").
 4437 
    nonempty folder results in error with code 10, "access denied").
4410 
 
 4438 
 
4411 
======================================================================
 4439 
======================================================================
4412 
============= Function 70, subfunction 9 - create folder. ============
 4440 
============= Function 70, subfunction 9 - create folder. ============
4413 
======================================================================
 4441 
======================================================================
4414 
Parameters:
 4442 
Parameters:
4415 
  * eax = 70 - function number
 4443 
  * eax = 70 - function number
4416 
  * ebx = pointer to the information structure
 4444 
  * ebx = pointer to the information structure
4417 
Format of the information structure:
 4445 
Format of the information structure:
4418 
  * +0: dword: 9 = subfunction number
 4446 
  * +0: dword: 9 = subfunction number
4419 
  * +4: dword: 0 (reserved)
 4447 
  * +4: dword: 0 (reserved)
4420 
  * +8: dword: 0 (reserved)
 4448 
  * +8: dword: 0 (reserved)
4421 
  * +12 = +0xC: dword: 0 (reserved)
 4449 
  * +12 = +0xC: dword: 0 (reserved)
4422 
  * +16 = +0x10: dword: 0 (reserved)
 4450 
  * +16 = +0x10: dword: 0 (reserved)
4423 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
 4451 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4424 
    given in the general description
 4452 
    given in the general description
4425 
    or
 4453 
    or
4426 
  * +20 = +0x14: db 0
 4454 
  * +20 = +0x14: db 0
4427 
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
 4455 
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
4428 
Returned value:
 4456 
Returned value:
4429 
  * eax = 0 - success, otherwise file system error code
 4457 
  * eax = 0 - success, otherwise file system error code
4430 
  * ebx destroyed
 4458 
  * ebx destroyed
4431 
Remarks:
 4459 
Remarks:
4432 
  * The function is not supported for CD (returns error code 2).
 4460 
  * The function is not supported for CD (returns error code 2).
4433 
  * The parent folder must already exist.
 4461 
  * The parent folder must already exist.
4434 
  * If target folder already exists, function returns success (eax=0).
 4462 
  * If target folder already exists, function returns success (eax=0).
4435 
 
 - 
 
4436 
======================================================================
 - 
 
4437 
================ Function 70, subfunction 10 - eject tray of disk drive. ==============
 - 
 
4438 
======================================================================
 - 
 
4439 
Parameters:
 - 
 
4440 
  * eax = 70 - function number
 - 
 
4441 
  * ebx = pointer to the information structure
 - 
 
4442 
Format of the information structure:
 - 
 
4443 
  * +0: dword: 10 = subfunction number
 - 
 
4444 
  * +4: dword: 0 (reserved)
 - 
 
4445 
  * +8: dword: 0 (reserved)
 - 
 
4446 
  * +12 = +0xC: dword: 0 (reserved)
 - 
 
4447 
  * +16 = +0x10: dword: 0 (reserved)
 - 
 
4448 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
 - 
 
4449 
    given in the general description
 - 
 
4450 
    or
 - 
 
4451 
  * +20 = +0x14: db 0
 - 
 
4452 
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
 - 
 
4453 
Returned value:
 - 
 
4454 
   * Nothing comes back.
 - 
 
4455 
Remarks:
 - 
 
4456 
   * The function is supported only for ATAPI devices (CD and DVD).
 - 
 
4457 
   * At extract of a tray is made deblocking of handle mechanism of a tray.
 - 
 
4458 
   * At extract of a tray the code makes clearing the cache of the appropriate device.
 - 
 
4459 
   * The path is standard for 70 functions. For serviceability it is possible to be limited to paths:
 - 
 
4460 
     db '/cd0/1/',0
 - 
 
4461 
     db '/cd1/1/',0
 - 
 
4462 
     db '/cd2/1/',0
 - 
 
4463 
     db '/cd3/1/',0
 - 
 
4464 
  * An example of usage of the function is the application CD_tray.
 - 
 
4465 
 
 - 
 
4466 
======================================================================
 - 
 
4467 
============== Function 70, subfunction 11 - load tray of disk drive. =================
 - 
 
4468 
======================================================================
 - 
 
4469 
Parameters:
 - 
 
4470 
  * eax = 70 - function number
 - 
 
4471 
  * ebx = pointer to the information structure
 - 
 
4472 
Format of the information structure:
 - 
 
4473 
  * +0: dword: 11 = subfunction number
 - 
 
4474 
  * +4: dword: 0 (reserved)
 - 
 
4475 
  * +8: dword: 0 (reserved)
 - 
 
4476 
  * +12 = +0xC: dword: 0 (reserved)
 - 
 
4477 
  * +16 = +0x10: dword: 0 (reserved)
 - 
 
4478 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
 - 
 
4479 
    given in the general description
 - 
 
4480 
    or
 - 
 
4481 
  * +20 = +0x14: db 0
 - 
 
4482 
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
 - 
 
4483 
Returned value:
 - 
 
4484 
   * Nothing comes back.
 - 
 
4485 
Remarks:
 - 
 
4486 
   * The function is supported only for ATAPI devices (CD and DVD).
 - 
 
4487 
   * The path is standard for 70 functions. For serviceability it is possible to be limited to paths:
 - 
 
4488 
     db '/cd0/1/',0
 - 
 
4489 
     db '/cd1/1/',0
 - 
 
4490 
     db '/cd2/1/',0
 - 
 
4491 
     db '/cd3/1/',0
 - 
 
4492 
  * An example of usage of the function is the application CD_tray.
 - 
 
4493 
 
 4463 
 
4494 
======================================================================
 4464 
======================================================================
4495 
========== Function 71, subfunction 1 - set window caption. ==========
 4465 
========== Function 71, subfunction 1 - set window caption. ==========
4496 
======================================================================
 4466 
======================================================================
4497 
Parameters:
 4467 
Parameters:
4498 
  * eax = 71 - function number
 4468 
  * eax = 71 - function number
4499 
  * ebx = 1 - subfunction number
 4469 
  * ebx = 1 - subfunction number
4500 
  * ecx = pointer to caption string
 4470 
  * ecx = pointer to caption string
4501 
Returned value:
 4471 
Returned value:
4502 
  * function does not return value
 4472 
  * function does not return value
4503 
Remarks:
 4473 
Remarks:
4504 
  * String must be in the ASCIIZ-format. Disregarding real string
 4474 
  * String must be in the ASCIIZ-format. Disregarding real string
4505 
    length, no more than 255 characters are drawn.
 4475 
    length, no more than 255 characters are drawn.
4506 
  * Pass NULL in ecx to remove caption.
 4476 
  * Pass NULL in ecx to remove caption.
4507 
 
 4477 
 
4508 
======================================================================
 4478 
======================================================================
4509 
=============== Function -1 - terminate thread/process ===============
 4479 
=============== Function -1 - terminate thread/process ===============
4510 
======================================================================
 4480 
======================================================================
4511 
Parameters:
 4481 
Parameters:
4512 
  * eax = -1 - function number
 4482 
  * eax = -1 - function number
4513 
Returned value:
 4483 
Returned value:
4514 
  * function does not return neither value nor control
 4484 
  * function does not return neither value nor control
4515 
Remarks:
 4485 
Remarks:
4516 
  * If the process did not create threads obviously, it has only
 4486 
  * If the process did not create threads obviously, it has only
4517 
    one thread, which termination results in process termination.
 4487 
    one thread, which termination results in process termination.
4518 
  * If the current thread is last in the process, its termination
 4488 
  * If the current thread is last in the process, its termination
4519 
    also results in process terminates.
 4489 
    also results in process terminates.
4520 
  * This function terminates the current thread. Other thread can be
 4490 
  * This function terminates the current thread. Other thread can be
4521 
    killed by call to subfunction 2 of function 18.
 4491 
    killed by call to subfunction 2 of function 18.
4522 
 
 4492 
 
4523 
======================================================================
 4493 
======================================================================
4524 
=========================== List of events ===========================
 4494 
=========================== List of events ===========================
4525 
======================================================================
 4495 
======================================================================
4526 
Next event can be retrieved by the call of one from functions 10
 4496 
Next event can be retrieved by the call of one from functions 10
4527 
(to wait for event), 11 (to check without waiting), 23
 4497 
(to wait for event), 11 (to check without waiting), 23
4528 
(to wait during the given time).
 4498 
(to wait during the given time).
4529 
These functions return only those events, which enter into a mask set
 4499 
These functions return only those events, which enter into a mask set
4530 
by function 40. By default it is first three,
 4500 
by function 40. By default it is first three,
4531 
there is enough for most applications.
 4501 
there is enough for most applications.
4532 
Codes of events:
 4502 
Codes of events:
4533 
  * 1 = redraw event (is reset by call to function 0)
 4503 
  * 1 = redraw event (is reset by call to function 0)
4534 
  * 2 = key on keyboard is pressed (acts, only when the window is
 4504 
  * 2 = key on keyboard is pressed (acts, only when the window is
4535 
    active) or hotkey is pressed; is reset, when all keys from
 4505 
    active) or hotkey is pressed; is reset, when all keys from
4536 
    the buffer are read out by function 2
 4506 
    the buffer are read out by function 2
4537 
  * 3 = button is pressed, defined earlier by function 8
 4507 
  * 3 = button is pressed, defined earlier by function 8
4538 
    (or close button, created implicitly by function 0;
 4508 
    (or close button, created implicitly by function 0;
4539 
    minimize button is handled by the system and sends no message;
 4509 
    minimize button is handled by the system and sends no message;
4540 
    acts, only when the window is active;
 4510 
    acts, only when the window is active;
4541 
    is reset when all buttons from the buffer
 4511 
    is reset when all buttons from the buffer
4542 
    are read out by function 17)
 4512 
    are read out by function 17)
4543 
  * 4 = reserved (in current implementation never comes even after
 4513 
  * 4 = reserved (in current implementation never comes even after
4544 
    unmasking by function 40)
 4514 
    unmasking by function 40)
4545 
  * 5 = the desktop background is redrawed (is reset automatically
 4515 
  * 5 = the desktop background is redrawed (is reset automatically
4546 
    after redraw, so if in redraw time program does not wait and
 4516 
    after redraw, so if in redraw time program does not wait and
4547 
    does not check events, it will not remark this event)
 4517 
    does not check events, it will not remark this event)
4548 
  * 6 = mouse event (something happened - button pressing or moving;
 4518 
  * 6 = mouse event (something happened - button pressing or moving;
4549 
    is reset at reading)
 4519 
    is reset at reading)
4550 
  * 7 = IPC event (see function 60 -
 4520 
  * 7 = IPC event (see function 60 -
4551 
    Inter Process Communication; is reset at reading)
 4521 
    Inter Process Communication; is reset at reading)
4552 
  * 8 = network event (is reset at reading)
 4522 
  * 8 = network event (is reset at reading)
4553 
  * 9 = debug event (is reset at reading; see
 4523 
  * 9 = debug event (is reset at reading; see
4554 
    debug subsystem)
 4524 
    debug subsystem)
4555 
  * 16..31 = event with appropriate IRQ
 4525 
  * 16..31 = event with appropriate IRQ
4556 
    (16=IRQ0, 31=IRQ15) (is reset after reading all IRQ data)
 4526 
    (16=IRQ0, 31=IRQ15) (is reset after reading all IRQ data)
4557 
 
 4527 
 
4558 
======================================================================
 4528 
======================================================================
4559 
=================== Error codes of the file system ===================
 4529 
=================== Error codes of the file system ===================
4560 
======================================================================
 4530 
======================================================================
4561 
  * 0 = success
 4531 
  * 0 = success
4562 
  * 1 = base and/or partition of a hard disk is not defined
 4532 
  * 1 = base and/or partition of a hard disk is not defined
4563 
    (by subfunctions 7, 8 of function 21)
 4533 
    (by subfunctions 7, 8 of function 21)
4564 
  * 2 = function is not supported for the given file system
 4534 
  * 2 = function is not supported for the given file system
4565 
  * 3 = unknown file system
 4535 
  * 3 = unknown file system
4566 
  * 4 = reserved, is never returned in the current implementation
 4536 
  * 4 = reserved, is never returned in the current implementation
4567 
  * 5 = file not found
 4537 
  * 5 = file not found
4568 
  * 6 = end of file, EOF
 4538 
  * 6 = end of file, EOF
4569 
  * 7 = pointer lies outside of application memory
 4539 
  * 7 = pointer lies outside of application memory
4570 
  * 8 = disk is full
 4540 
  * 8 = disk is full
4571 
  * 9 = FAT table is destroyed
 4541 
  * 9 = FAT table is destroyed
4572 
  * 10 = access denied
 4542 
  * 10 = access denied
4573 
  * 11 = device error
 4543 
  * 11 = device error
4574 
Application start functions can return also following errors:
 4544 
Application start functions can return also following errors:
4575 
  * 30 = 0x1E = not enough memory
 4545 
  * 30 = 0x1E = not enough memory
4576 
  * 31 = 0x1F = file is not executable
 4546 
  * 31 = 0x1F = file is not executable
4577 
  * 32 = 0x20 = too many processes
 4547 
  * 32 = 0x20 = too many processes
4578 
>
 4548 
>
4579 
>
 4549 
>
4580 
>
 4550 
>
4581 
>
 4551 
>