Subversion Repositories Kolibri OS

Rev

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

Rev 1353 Rev 1445
1 
SYSTEM FUNCTIONS of OS Kolibri 0.7.5.0
 1 
SYSTEM FUNCTIONS of OS Kolibri 0.7.5.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 fixed-size window
 25 
      * Y=4 - skinned fixed-size window
26 
      * other possible values (from 5 up to 15) are reserved,
 26 
      * other possible values (from 5 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 styles Y=3,4 caption string
 31 
      * A = 1 - window has caption; for styles Y=3,4 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 styles Y=3,4 and caption (A=1) caption string
 54 
  * For windows with styles Y=3,4 and caption (A=1) caption string
55 
    is set by the first call of this function and is ignored
 55 
    is set by the first call of this function and is ignored
56 
    at subsequent (strictly speaking, is ignored after a call to
 56 
    at subsequent (strictly speaking, is ignored after a call to
57 
    subfunction 2 of function 12 - end redraw); to change caption of
 57 
    subfunction 2 of function 12 - end redraw); to change caption of
58 
    already created window use subfunction 1 of function 71.
 58 
    already created 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 
 
 222 
 
223 
======================================================================
 223 
======================================================================
224 
============== Function 6 - read the file from ramdisk. ==============
 224 
============== Function 6 - read the file from ramdisk. ==============
225 
======================================================================
 225 
======================================================================
226 
Parameters:
 226 
Parameters:
227 
  * eax = 6 - function number
 227 
  * eax = 6 - function number
228 
  * ebx = pointer to the filename
 228 
  * ebx = pointer to the filename
229 
  * ecx = number of start block, beginning from 1;
 229 
  * ecx = number of start block, beginning from 1;
230 
    ecx=0 - read from the beginning of the file (same as ecx=1)
 230 
    ecx=0 - read from the beginning of the file (same as ecx=1)
231 
  * edx = number of blocks to read;
 231 
  * edx = number of blocks to read;
232 
    edx=0 - read one block (same as edx=1)
 232 
    edx=0 - read one block (same as edx=1)
233 
  * esi = pointer to memory area for the data
 233 
  * esi = pointer to memory area for the data
234 
Returned value:
 234 
Returned value:
235 
  * eax = file size in bytes, if the file was successfully read
 235 
  * eax = file size in bytes, if the file was successfully read
236 
  * eax = -1, if the file was not found
 236 
  * eax = -1, if the file was not found
237 
Remarks:
 237 
Remarks:
238 
  * This function is out-of-date; function 70 allows
 238 
  * This function is out-of-date; function 70 allows
239 
    to fulfil the same operations with the extended possibilities.
 239 
    to fulfil the same operations with the extended possibilities.
240 
  * Block = 512 bytes.
 240 
  * Block = 512 bytes.
241 
  * For reading all file you can specify the certainly large value
 241 
  * For reading all file you can specify the certainly large value
242 
    in edx, for example, edx = -1; but in this case be ready that
 242 
    in edx, for example, edx = -1; but in this case be ready that
243 
    the program will "fall", if the file will appear too large and can
 243 
    the program will "fall", if the file will appear too large and can
244 
    not be placed in the program memory.
 244 
    not be placed in the program memory.
245 
  * The filename must be either in the format 8+3 characters
 245 
  * The filename must be either in the format 8+3 characters
246 
    (first 8 characters - name itself, last 3 - extension,
 246 
    (first 8 characters - name itself, last 3 - extension,
247 
    the short names and extensions are supplemented with spaces),
 247 
    the short names and extensions are supplemented with spaces),
248 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
 248 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
249 
    (name no more than 8 characters, dot, extension 3 characters
 249 
    (name no more than 8 characters, dot, extension 3 characters
250 
    supplemented if necessary by spaces).
 250 
    supplemented if necessary by spaces).
251 
    The filename must be written with capital letters. The terminating
 251 
    The filename must be written with capital letters. The terminating
252 
    character with code 0 is not necessary (not ASCIIZ-string).
 252 
    character with code 0 is not necessary (not ASCIIZ-string).
253 
  * This function does not support folders on the ramdisk.
 253 
  * This function does not support folders on the ramdisk.
254 
 
 254 
 
255 
======================================================================
 255 
======================================================================
256 
=============== Function 7 - draw image in the window. ===============
 256 
=============== Function 7 - draw image in the window. ===============
257 
======================================================================
 257 
======================================================================
258 
Paramters:
 258 
Paramters:
259 
  * eax = 7 - function number
 259 
  * eax = 7 - function number
260 
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
 260 
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
261 
  * ecx = [size on axis x]*65536 + [size on axis y]
 261 
  * ecx = [size on axis x]*65536 + [size on axis y]
262 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 262 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
263 
Returned value:
 263 
Returned value:
264 
  * function does not return value
 264 
  * function does not return value
265 
Remarks:
 265 
Remarks:
266 
  * Coordinates of the image are coordinates of the upper left corner
 266 
  * Coordinates of the image are coordinates of the upper left corner
267 
    of the image relative to the window.
 267 
    of the image relative to the window.
268 
  * Size of the image in bytes is 3*xsize*ysize.
 268 
  * Size of the image in bytes is 3*xsize*ysize.
269 
 
 269 
 
270 
======================================================================
 270 
======================================================================
271 
=============== Function 8 - define/delete the button. ===============
 271 
=============== Function 8 - define/delete the button. ===============
272 
======================================================================
 272 
======================================================================
273 
Parameters for button definition:
 273 
Parameters for button definition:
274 
  * eax = 8 - function number
 274 
  * eax = 8 - function number
275 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
 275 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
276 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
 276 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
277 
  * edx = 0xXYnnnnnn, where:
 277 
  * edx = 0xXYnnnnnn, where:
278 
    * nnnnnn = identifier of the button
 278 
    * nnnnnn = identifier of the button
279 
    * high (31st) bit of edx is cleared
 279 
    * high (31st) bit of edx is cleared
280 
    * if 30th bit of edx is set - do not draw the button
 280 
    * if 30th bit of edx is set - do not draw the button
281 
    * if 29th bit of edx is set - do not draw a frame
 281 
    * if 29th bit of edx is set - do not draw a frame
282 
      at pressing the button
 282 
      at pressing the button
283 
  * esi = 0x00RRGGBB - color of the button
 283 
  * esi = 0x00RRGGBB - color of the button
284 
Parameters for button deleting:
 284 
Parameters for button deleting:
285 
  * eax = 8 - function number
 285 
  * eax = 8 - function number
286 
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
 286 
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
287 
Returned value:
 287 
Returned value:
288 
  * function does not return value
 288 
  * function does not return value
289 
Remarks:
 289 
Remarks:
290 
  * Sizes of the button must be more than 0 and less than 0x8000.
 290 
  * Sizes of the button must be more than 0 and less than 0x8000.
291 
  * For skinned windows definition of the window
 291 
  * For skinned windows definition of the window
292 
    (call of 0th function) creates two standard buttons -
 292 
    (call of 0th function) creates two standard buttons -
293 
    for close of the window with identifier 1 and
 293 
    for close of the window with identifier 1 and
294 
    for minimize of the window with identifier 0xffff.
 294 
    for minimize of the window with identifier 0xffff.
295 
  * The creation of two buttons with same identifiers is admitted.
 295 
  * The creation of two buttons with same identifiers is admitted.
296 
  * The button with the identifier 0xffff at pressing is interpreted
 296 
  * The button with the identifier 0xffff at pressing is interpreted
297 
    by the system as the button of minimization, the system handles
 297 
    by the system as the button of minimization, the system handles
298 
    such pressing independently, not accessing to the application.
 298 
    such pressing independently, not accessing to the application.
299 
    In rest it is usual button.
 299 
    In rest it is usual button.
300 
  * Total number of buttons for all applications is limited to 4095.
 300 
  * Total number of buttons for all applications is limited to 4095.
301 
 
 301 
 
302 
======================================================================
 302 
======================================================================
303 
============ Function 9 - information on execution thread. ===========
 303 
============ Function 9 - information on execution thread. ===========
304 
======================================================================
 304 
======================================================================
305 
Parameters:
 305 
Parameters:
306 
  * eax = 9 - function number
 306 
  * eax = 9 - function number
307 
  * ebx = pointer to 1-Kb buffer
 307 
  * ebx = pointer to 1-Kb buffer
308 
  * ecx = number of the slot of the thread
 308 
  * ecx = number of the slot of the thread
309 
    ecx = -1 - get information on the current thread
 309 
    ecx = -1 - get information on the current thread
310 
Returned value:
 310 
Returned value:
311 
  * eax = maximum number of the slot of a thread
 311 
  * eax = maximum number of the slot of a thread
312 
  * buffer pointed to by ebx contains the following information:
 312 
  * buffer pointed to by ebx contains the following information:
313 
    * +0: dword: usage of the processor (how many time units
 313 
    * +0: dword: usage of the processor (how many time units
314 
      per second leaves on execution of this thread)
 314 
      per second leaves on execution of this thread)
315 
    * +4: word: position of the window of thread in the window stack
 315 
    * +4: word: position of the window of thread in the window stack
316 
    * +6: word: (has no relation to the specified thread)
 316 
    * +6: word: (has no relation to the specified thread)
317 
      number of the thread slot, which window has in the window stack
 317 
      number of the thread slot, which window has in the window stack
318 
      position ecx
 318 
      position ecx
319 
    * +8: word: reserved
 319 
    * +8: word: reserved
320 
    * +10 = +0xA: 11 bytes: name of the process
 320 
    * +10 = +0xA: 11 bytes: name of the process
321 
      (name of corresponding executable file in the format 8+3)
 321 
      (name of corresponding executable file in the format 8+3)
322 
    * +21 = +0x15: byte: reserved, this byte is not changed
 322 
    * +21 = +0x15: byte: reserved, this byte is not changed
323 
    * +22 = +0x16: dword: address of the process in memory
 323 
    * +22 = +0x16: dword: address of the process in memory
324 
    * +26 = +0x1A: dword: size of used memory - 1
 324 
    * +26 = +0x1A: dword: size of used memory - 1
325 
    * +30 = +0x1E: dword: identifier (PID/TID)
 325 
    * +30 = +0x1E: dword: identifier (PID/TID)
326 
    * +34 = +0x22: dword: coordinate of the thread window on axis x
 326 
    * +34 = +0x22: dword: coordinate of the thread window on axis x
327 
    * +38 = +0x26: dword: coordinate of the thread window on axis y
 327 
    * +38 = +0x26: dword: coordinate of the thread window on axis y
328 
    * +42 = +0x2A: dword: size of the thread window on axis x
 328 
    * +42 = +0x2A: dword: size of the thread window on axis x
329 
    * +46 = +0x2E: dword: size of the thread window on axis y
 329 
    * +46 = +0x2E: dword: size of the thread window on axis y
330 
    * +50 = +0x32: word: status of the thread slot:
 330 
    * +50 = +0x32: word: status of the thread slot:
331 
      * 0 = thread is running
 331 
      * 0 = thread is running
332 
      * 1 = thread is suspended
 332 
      * 1 = thread is suspended
333 
      * 2 = thread is suspended while waiting for event
 333 
      * 2 = thread is suspended while waiting for event
334 
      * 3 = thread is terminating as a result of call to function -1
 334 
      * 3 = thread is terminating as a result of call to function -1
335 
        or under duress as a result of call to subfunction 2
 335 
        or under duress as a result of call to subfunction 2
336 
        of function 18 or termination of the system
 336 
        of function 18 or termination of the system
337 
      * 4 = thread is terminating as a result of exception
 337 
      * 4 = thread is terminating as a result of exception
338 
      * 5 = thread waits for event
 338 
      * 5 = thread waits for event
339 
      * 9 = requested slot is free, all other information on the slot
 339 
      * 9 = requested slot is free, all other information on the slot
340 
        is not meaningful
 340 
        is not meaningful
341 
    * +52 = +0x34: word: reserved, this word is not changed
 341 
    * +52 = +0x34: word: reserved, this word is not changed
342 
    * +54 = +0x36: dword: coordinate of the client area on axis x
 342 
    * +54 = +0x36: dword: coordinate of the client area on axis x
343 
    * +58 = +0x3A: dword: coordinate of the client area on axis y
 343 
    * +58 = +0x3A: dword: coordinate of the client area on axis y
344 
    * +62 = +0x3E: dword: width of the client area
 344 
    * +62 = +0x3E: dword: width of the client area
345 
    * +66 = +0x42: dword: height of the client area
 345 
    * +66 = +0x42: dword: height of the client area
346 
    * +70 = +0x46: byte: state of the window - bitfield
 346 
    * +70 = +0x46: byte: state of the window - bitfield
347 
      * bit 0 (mask 1): window is maximized
 347 
      * bit 0 (mask 1): window is maximized
348 
      * bit 1 (mask 2): window is minimized to panel
 348 
      * bit 1 (mask 2): window is minimized to panel
349 
      * bit 2 (mask 4): window is rolled up
 349 
      * bit 2 (mask 4): window is rolled up
350 
Remarks:
 350 
Remarks:
351 
  * Slots are numbered starting from 1.
 351 
  * Slots are numbered starting from 1.
352 
  * Returned value is not a total number of threads, because there
 352 
  * Returned value is not a total number of threads, because there
353 
    can be free slots.
 353 
    can be free slots.
354 
  * When process is starting, system automatically creates
 354 
  * When process is starting, system automatically creates
355 
    execution thread.
 355 
    execution thread.
356 
  * Function gives information on the thread. Each process has
 356 
  * Function gives information on the thread. Each process has
357 
    at least one thread. One process can create many threads,
 357 
    at least one thread. One process can create many threads,
358 
    in this case each thread has its own slot and the fields
 358 
    in this case each thread has its own slot and the fields
359 
    +10, +22, +26 in these slots coincide.
 359 
    +10, +22, +26 in these slots coincide.
360 
    Applications have no common way to define whether two threads
 360 
    Applications have no common way to define whether two threads
361 
    belong to one process.
 361 
    belong to one process.
362 
  * The active window - window on top of the window stack -
 362 
  * The active window - window on top of the window stack -
363 
    receives the messages on a keyboard input. For such window
 363 
    receives the messages on a keyboard input. For such window
364 
    the position in the window stack coincides with returned value.
 364 
    the position in the window stack coincides with returned value.
365 
  * Slot 1 corresponds to special system thread, for which:
 365 
  * Slot 1 corresponds to special system thread, for which:
366 
    * the window is in the bottom of the window stack, the fields
 366 
    * the window is in the bottom of the window stack, the fields
367 
      +4 and +6 contain value 1
 367 
      +4 and +6 contain value 1
368 
    * name of the process - "OS/IDLE" (supplemented by spaces)
 368 
    * name of the process - "OS/IDLE" (supplemented by spaces)
369 
    * address of the process in memory is 0, size of used memory is
 369 
    * address of the process in memory is 0, size of used memory is
370 
      16 Mb (0x1000000)
 370 
      16 Mb (0x1000000)
371 
    * PID=1
 371 
    * PID=1
372 
    * coordinates and sizes of the window and the client area are by
 372 
    * coordinates and sizes of the window and the client area are by
373 
      convention set to 0
 373 
      convention set to 0
374 
    * status of the slot is always 0 (running)
 374 
    * status of the slot is always 0 (running)
375 
    * the execution time adds of time leaving on operations itself
 375 
    * the execution time adds of time leaving on operations itself
376 
      and idle time in waiting for interrupt (which can be got by call
 376 
      and idle time in waiting for interrupt (which can be got by call
377 
      to subfunction 4 of function 18).
 377 
      to subfunction 4 of function 18).
378 
  * Beginning from slot 2, the normal applications are placed.
 378 
  * Beginning from slot 2, the normal applications are placed.
379 
  * The normal applications are placed in memory at the address
 379 
  * Applications are placed in memory at the address   0x0
380 
    0x60400000 (kernel constant 'std_application_base_address').
 380 
    (kernel constant 'std_application_base_address').
381 
    There is no intersection, as each process has its own page table.
 381 
    There is no intersection, as each process has its own page table.
382 
  * At creation of the thread it is assigned the slot
 382 
  * At creation of the thread it is assigned the slot
383 
    in the system table and identifier (Process/Thread IDentifier =
 383 
    in the system table and identifier (Process/Thread IDentifier =
384 
    PID/TID), which do not vary with time for given thread.
 384 
    PID/TID), which do not vary with time for given thread.
385 
    After completion of the thread its slot can be anew used
 385 
    After completion of the thread its slot can be anew used
386 
    for another thread. The thread identifier can not be assigned
 386 
    for another thread. The thread identifier can not be assigned
387 
    to other thread even after completion of this thread.
 387 
    to other thread even after completion of this thread.
388 
    Identifiers, assigned to new threads, grow monotonously.
 388 
    Identifiers, assigned to new threads, grow monotonously.
389 
  * If the thread has not yet defined the window by call to
 389 
  * If the thread has not yet defined the window by call to
390 
    function 0, the position and the sizes
 390 
    function 0, the position and the sizes
391 
    of its window are considered to be zero.
 391 
    of its window are considered to be zero.
392 
  * Coordinates of the client area are relative to the window.
 392 
  * Coordinates of the client area are relative to the window.
393 
  * At the moment only the part of the buffer by a size
 393 
  * At the moment only the part of the buffer by a size
394 
    71 = 0x37 bytes is used. Nevertheless it is recommended to use
 394 
    71 = 0x37 bytes is used. Nevertheless it is recommended to use
395 
    1-Kb buffer for the future compatibility, in the future
 395 
    1-Kb buffer for the future compatibility, in the future
396 
    some fields can be added.
 396 
    some fields can be added.
397 
 
 397 
 
398 
======================================================================
 398 
======================================================================
399 
==================== Function 10 - wait for event. ===================
 399 
==================== Function 10 - wait for event. ===================
400 
======================================================================
 400 
======================================================================
401 
If the message queue is empty, waits for appearance of the message
 401 
If the message queue is empty, waits for appearance of the message
402 
in queue. In this state thread does not consume CPU time.
 402 
in queue. In this state thread does not consume CPU time.
403 
Then reads out the message from queue.
 403 
Then reads out the message from queue.
404 
 
 404 
 
405 
Parameters:
 405 
Parameters:
406 
  * eax = 10 - function number
 406 
  * eax = 10 - function number
407 
Returned value:
 407 
Returned value:
408 
  * eax = event (see the list of events)
 408 
  * eax = event (see the list of events)
409 
Remarks:
 409 
Remarks:
410 
  * Those events are taken into account only which enter into
 410 
  * Those events are taken into account only which enter into
411 
    a mask set by function 40. By default it is
 411 
    a mask set by function 40. By default it is
412 
    redraw, key and button events.
 412 
    redraw, key and button events.
413 
  * To check, whether there is a message in queue, use function 11.
 413 
  * To check, whether there is a message in queue, use function 11.
414 
    To wait for no more than given time, use function 23.
 414 
    To wait for no more than given time, use function 23.
415 
 
 415 
 
416 
======================================================================
 416 
======================================================================
417 
=============== Function 11 - check for event, no wait. ==============
 417 
=============== Function 11 - check for event, no wait. ==============
418 
======================================================================
 418 
======================================================================
419 
If the message queue contains event, function reads out
 419 
If the message queue contains event, function reads out
420 
and return it. If the queue is empty, function returns 0.
 420 
and return it. If the queue is empty, function returns 0.
421 
Parameters:
 421 
Parameters:
422 
  * eax = 11 - function number
 422 
  * eax = 11 - function number
423 
Returned value:
 423 
Returned value:
424 
  * eax = 0 - message queue is empty
 424 
  * eax = 0 - message queue is empty
425 
  * else eax = event (see the list of events)
 425 
  * else eax = event (see the list of events)
426 
Remarks:
 426 
Remarks:
427 
  * Those events are taken into account only, which enter into
 427 
  * Those events are taken into account only, which enter into
428 
    a mask set by function 40. By default it is
 428 
    a mask set by function 40. By default it is
429 
    redraw, key and button events.
 429 
    redraw, key and button events.
430 
  * To wait for event, use function 10.
 430 
  * To wait for event, use function 10.
431 
    To wait for no more than given time, use function 23.
 431 
    To wait for no more than given time, use function 23.
432 
 
 432 
 
433 
======================================================================
 433 
======================================================================
434 
=============== Function 12 - begin/end window redraw. ===============
 434 
=============== Function 12 - begin/end window redraw. ===============
435 
======================================================================
 435 
======================================================================
436 
 
 436 
 
437 
---------------- Subfunction 1 - begin window redraw. ----------------
 437 
---------------- Subfunction 1 - begin window redraw. ----------------
438 
Parameters:
 438 
Parameters:
439 
  * eax = 12 - function number
 439 
  * eax = 12 - function number
440 
  * ebx = 1 - subfunction number
 440 
  * ebx = 1 - subfunction number
441 
Returned value:
 441 
Returned value:
442 
  * function does not return value
 442 
  * function does not return value
443 
 
 443 
 
444 
----------------- Subfunction 2 - end window redraw. -----------------
 444 
----------------- Subfunction 2 - end window redraw. -----------------
445 
Parameters:
 445 
Parameters:
446 
  * eax = 12 - function number
 446 
  * eax = 12 - function number
447 
  * ebx = 2 - subfunction number
 447 
  * ebx = 2 - subfunction number
448 
Returned value:
 448 
Returned value:
449 
  * function does not return value
 449 
  * function does not return value
450 
Remarks:
 450 
Remarks:
451 
  * Subfunction 1 deletes all buttons defined with
 451 
  * Subfunction 1 deletes all buttons defined with
452 
    function 8, they must be defined again.
 452 
    function 8, they must be defined again.
453 
 
 453 
 
454 
======================================================================
 454 
======================================================================
455 
============ Function 13 - draw a rectangle in the window. ===========
 455 
============ Function 13 - draw a rectangle in the window. ===========
456 
======================================================================
 456 
======================================================================
457 
Parameters:
 457 
Parameters:
458 
  * eax = 13 - function number
 458 
  * eax = 13 - function number
459 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
 459 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
460 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
 460 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
461 
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
 461 
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
462 
Returned value:
 462 
Returned value:
463 
  * function does not return value
 463 
  * function does not return value
464 
Remarks:
 464 
Remarks:
465 
  * Coordinates are understood as coordinates of the left upper corner
 465 
  * Coordinates are understood as coordinates of the left upper corner
466 
    of a rectangle relative to the window.
 466 
    of a rectangle relative to the window.
467 
 
 467 
 
468 
======================================================================
 468 
======================================================================
469 
=================== Function 14 - get screen size. ===================
 469 
=================== Function 14 - get screen size. ===================
470 
======================================================================
 470 
======================================================================
471 
Parameters:
 471 
Parameters:
472 
  * eax = 14 - function number
 472 
  * eax = 14 - function number
473 
Returned value:
 473 
Returned value:
474 
  * eax = [xsize]*65536 + [ysize], where
 474 
  * eax = [xsize]*65536 + [ysize], where
475 
  * xsize = x-coordinate of the right lower corner of the screen =
 475 
  * xsize = x-coordinate of the right lower corner of the screen =
476 
            horizontal size - 1
 476 
            horizontal size - 1
477 
  * ysize = y-coordinate of the right lower corner of the screen =
 477 
  * ysize = y-coordinate of the right lower corner of the screen =
478 
            vertical size - 1
 478 
            vertical size - 1
479 
Remarks:
 479 
Remarks:
480 
  * See also subfunction 5 of function 48 - get sizes of
 480 
  * See also subfunction 5 of function 48 - get sizes of
481 
    working area of the screen.
 481 
    working area of the screen.
482 
 
 482 
 
483 
======================================================================
 483 
======================================================================
484 
== Function 15, subfunction 1 - set a size of the background image. ==
 484 
== Function 15, subfunction 1 - set a size of the background image. ==
485 
======================================================================
 485 
======================================================================
486 
Parameters:
 486 
Parameters:
487 
  * eax = 15 - function number
 487 
  * eax = 15 - function number
488 
  * ebx = 1 - subfunction number
 488 
  * ebx = 1 - subfunction number
489 
  * ecx = width of the image
 489 
  * ecx = width of the image
490 
  * edx = height of the image
 490 
  * edx = height of the image
491 
Returned value:
 491 
Returned value:
492 
  * function does not return value
 492 
  * function does not return value
493 
Remarks:
 493 
Remarks:
494 
  * Before calling subfunctions 2 and 5 you should call this function
 494 
  * Before calling subfunctions 2 and 5 you should call this function
495 
    to set image size!
 495 
    to set image size!
496 
  * For update of the screen (after completion of a series of commands
 496 
  * For update of the screen (after completion of a series of commands
497 
    working with a background) call subfunction 3.
 497 
    working with a background) call subfunction 3.
498 
  * There is a pair function for get size of the background image -
 498 
  * There is a pair function for get size of the background image -
499 
    subfunction 1 of function 39.
 499 
    subfunction 1 of function 39.
500 
 
 500 
 
501 
======================================================================
 501 
======================================================================
502 
=== Function 15, subfunction 2 - put pixel on the background image. ==
 502 
=== Function 15, subfunction 2 - put pixel on the background image. ==
503 
======================================================================
 503 
======================================================================
504 
Parameters:
 504 
Parameters:
505 
  * eax = 15 - function number
 505 
  * eax = 15 - function number
506 
  * ebx = 2 - subfunction number
 506 
  * ebx = 2 - subfunction number
507 
  * ecx = offset
 507 
  * ecx = offset
508 
  * edx = color of a pixel 0xRRGGBB
 508 
  * edx = color of a pixel 0xRRGGBB
509 
Returned value:
 509 
Returned value:
510 
  * function does not return value
 510 
  * function does not return value
511 
Remarks:
 511 
Remarks:
512 
  * Offset for a pixel with coordinates (x,y) is calculated as
 512 
  * Offset for a pixel with coordinates (x,y) is calculated as
513 
    (x+y*xsize)*3.
 513 
    (x+y*xsize)*3.
514 
  * If the given offset exceeds size set by subfunction 1,
 514 
  * If the given offset exceeds size set by subfunction 1,
515 
    the call is ignored.
 515 
    the call is ignored.
516 
  * For update of the screen (after completion of a series of commands
 516 
  * For update of the screen (after completion of a series of commands
517 
    working with a background) call subfunction 3.
 517 
    working with a background) call subfunction 3.
518 
  * There is a pair function for get pixel on the background image -
 518 
  * There is a pair function for get pixel on the background image -
519 
    subfunction 2 of function 39.
 519 
    subfunction 2 of function 39.
520 
 
 520 
 
521 
======================================================================
 521 
======================================================================
522 
=========== Function 15, subfunction 3 - redraw background. ==========
 522 
=========== Function 15, subfunction 3 - redraw background. ==========
523 
======================================================================
 523 
======================================================================
524 
Parameters:
 524 
Parameters:
525 
  * eax = 15 - function number
 525 
  * eax = 15 - function number
526 
  * ebx = 3 - subfunction number
 526 
  * ebx = 3 - subfunction number
527 
Returned value:
 527 
Returned value:
528 
  * function does not return value
 528 
  * function does not return value
529 
 
 529 
 
530 
======================================================================
 530 
======================================================================
531 
== Function 15, subfunction 4 - set drawing mode for the background. =
 531 
== Function 15, subfunction 4 - set drawing mode for the background. =
532 
======================================================================
 532 
======================================================================
533 
Parameters:
 533 
Parameters:
534 
  * eax = 15 - function number
 534 
  * eax = 15 - function number
535 
  * ebx = 4 - subfunction number
 535 
  * ebx = 4 - subfunction number
536 
  * ecx = drawing mode:
 536 
  * ecx = drawing mode:
537 
    * 1 = tile
 537 
    * 1 = tile
538 
    * 2 = stretch
 538 
    * 2 = stretch
539 
Returned value:
 539 
Returned value:
540 
  * function does not return value
 540 
  * function does not return value
541 
Remarks:
 541 
Remarks:
542 
  * For update of the screen (after completion of a series of commands
 542 
  * For update of the screen (after completion of a series of commands
543 
    working with a background) call subfunction 3.
 543 
    working with a background) call subfunction 3.
544 
  * There is a pair function for get drawing mode of the background -
 544 
  * There is a pair function for get drawing mode of the background -
545 
    subfunction 4 of function 39.
 545 
    subfunction 4 of function 39.
546 
 
 546 
 
547 
======================================================================
 547 
======================================================================
548 
===================== Function 15, subfunction 5 =====================
 548 
===================== Function 15, subfunction 5 =====================
549 
============ Put block of pixels on the background image. ============
 549 
============ Put block of pixels on the background image. ============
550 
======================================================================
 550 
======================================================================
551 
Parameters:
 551 
Parameters:
552 
  * eax = 15 - function number
 552 
  * eax = 15 - function number
553 
  * ebx = 5 - subfunction number
 553 
  * ebx = 5 - subfunction number
554 
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
 554 
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
555 
  * edx = offset in data of the background image
 555 
  * edx = offset in data of the background image
556 
  * esi = size of data in bytes = 3 * number of pixels
 556 
  * esi = size of data in bytes = 3 * number of pixels
557 
Returned value:
 557 
Returned value:
558 
  * function does not return value
 558 
  * function does not return value
559 
Remarks:
 559 
Remarks:
560 
  * Offset and size are not checked for correctness.
 560 
  * Offset and size are not checked for correctness.
561 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
 561 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
562 
  * Pixels of the background image are written sequentially
 562 
  * Pixels of the background image are written sequentially
563 
    from left to right, from up to down.
 563 
    from left to right, from up to down.
564 
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
 564 
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
565 
  * For update of the screen (after completion of a series of commands
 565 
  * For update of the screen (after completion of a series of commands
566 
    working with a background) call subfunction 3.
 566 
    working with a background) call subfunction 3.
567 
 
 567 
 
568 
======================================================================
 568 
======================================================================
569 
===================== Function 15, subfunction 6 =====================
 569 
===================== Function 15, subfunction 6 =====================
570 
======== Map background data to the address space of process. ========
 570 
======== Map background data to the address space of process. ========
571 
======================================================================
 571 
======================================================================
572 
Parameters:
 572 
Parameters:
573 
  * eax = 15 - function number
 573 
  * eax = 15 - function number
574 
  * ebx = 6 - subfunction number
 574 
  * ebx = 6 - subfunction number
575 
Returned value:
 575 
Returned value:
576 
  * eax = pointer to background data, 0 if error
 576 
  * eax = pointer to background data, 0 if error
577 
Remarks:
 577 
Remarks:
578 
  * Mapped data are available for read and write.
 578 
  * Mapped data are available for read and write.
579 
  * Size of background data is 3*xsize*ysize. The system blocks
 579 
  * Size of background data is 3*xsize*ysize. The system blocks
580 
    changes of background sizes while process works with mapped data.
 580 
    changes of background sizes while process works with mapped data.
581 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
 581 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
582 
  * Pixels of the background image are written sequentially
 582 
  * Pixels of the background image are written sequentially
583 
    from left to right, from up to down.
 583 
    from left to right, from up to down.
584 
 
 584 
 
585 
======================================================================
 585 
======================================================================
586 
===== Function 15, subfunction 7 - close mapped background data. =====
 586 
===== Function 15, subfunction 7 - close mapped background data. =====
587 
======================================================================
 587 
======================================================================
588 
Parameters:
 588 
Parameters:
589 
  * eax = 15 - function number
 589 
  * eax = 15 - function number
590 
  * ebx = 7 - subfunction number
 590 
  * ebx = 7 - subfunction number
591 
  * ecx = pointer to mapped data
 591 
  * ecx = pointer to mapped data
592 
Returned value:
 592 
Returned value:
593 
  * eax = 1 - success, 0 - error
 593 
  * eax = 1 - success, 0 - error
594 
 
 594 
 
595 
======================================================================
 595 
======================================================================
596 
=============== Function 16 - save ramdisk on a floppy. ==============
 596 
=============== Function 16 - save ramdisk on a floppy. ==============
597 
======================================================================
 597 
======================================================================
598 
Parameters:
 598 
Parameters:
599 
  * eax = 16 - function number
 599 
  * eax = 16 - function number
600 
  * ebx = 1 or ebx = 2 - on which floppy save
 600 
  * ebx = 1 or ebx = 2 - on which floppy save
601 
Returned value:
 601 
Returned value:
602 
  * eax = 0 - success
 602 
  * eax = 0 - success
603 
  * eax = 1 - error
 603 
  * eax = 1 - error
604 
 
 604 
 
605 
======================================================================
 605 
======================================================================
606 
======= Function 17 - get the identifier of the pressed button. ======
 606 
======= Function 17 - get the identifier of the pressed button. ======
607 
======================================================================
 607 
======================================================================
608 
Takes away the code of the pressed button from the buffer.
 608 
Takes away the code of the pressed button from the buffer.
609 
Parameters:
 609 
Parameters:
610 
  * eax = 17 - function number
 610 
  * eax = 17 - function number
611 
Returned value:
 611 
Returned value:
612 
  * if the buffer is empty, function returns eax=1
 612 
  * if the buffer is empty, function returns eax=1
613 
  * if the buffer is not empty:
 613 
  * if the buffer is not empty:
614 
    * high 24 bits of eax contain button identifier (in particular,
 614 
    * high 24 bits of eax contain button identifier (in particular,
615 
      ah contains low byte of the identifier; if all buttons have
 615 
      ah contains low byte of the identifier; if all buttons have
616 
      the identifier less than 256, ah is enough to distinguish)
 616 
      the identifier less than 256, ah is enough to distinguish)
617 
    * al = 0 - the button was pressed with left mouse button
 617 
    * al = 0 - the button was pressed with left mouse button
618 
    * al = bit corresponding to used mouse button otherwise
 618 
    * al = bit corresponding to used mouse button otherwise
619 
Remarks:
 619 
Remarks:
620 
  * "Buffer" keeps only one button, at pressing the new button the
 620 
  * "Buffer" keeps only one button, at pressing the new button the
621 
    information about old is lost.
 621 
    information about old is lost.
622 
  * The call of this function by an application with inactive window
 622 
  * The call of this function by an application with inactive window
623 
    will return answer "buffer is empty".
 623 
    will return answer "buffer is empty".
624 
  * Returned value for al corresponds to the state of mouse buttons
 624 
  * Returned value for al corresponds to the state of mouse buttons
625 
    as in subfunction 2 of function 37 at the beginning
 625 
    as in subfunction 2 of function 37 at the beginning
626 
    of button press, excluding lower bit, which is cleared.
 626 
    of button press, excluding lower bit, which is cleared.
627 
 
 627 
 
628 
======================================================================
 628 
======================================================================
629 
= Function 18, subfunction 2 - terminate process/thread by the slot. =
 629 
= Function 18, subfunction 2 - terminate process/thread by the slot. =
630 
======================================================================
 630 
======================================================================
631 
Parameters:
 631 
Parameters:
632 
  * eax = 18 - function number
 632 
  * eax = 18 - function number
633 
  * ebx = 2 - subfunction number
 633 
  * ebx = 2 - subfunction number
634 
  * ecx = number of the slot of process/thread
 634 
  * ecx = number of the slot of process/thread
635 
Returned value:
 635 
Returned value:
636 
  * function does not return value
 636 
  * function does not return value
637 
Remarks:
 637 
Remarks:
638 
  * It is impossible to terminate system thread OS/IDLE (with
 638 
  * It is impossible to terminate system thread OS/IDLE (with
639 
    number of the slot 1),
 639 
    number of the slot 1),
640 
    it is possible to terminate any normal process/thread.
 640 
    it is possible to terminate any normal process/thread.
641 
  * See also subfunction 18 - terminate
 641 
  * See also subfunction 18 - terminate
642 
    process/thread by the identifier.
 642 
    process/thread by the identifier.
643 
 
 643 
 
644 
======================================================================
 644 
======================================================================
645 
===================== Function 18, subfunction 3 =====================
 645 
===================== Function 18, subfunction 3 =====================
646 
============= Make active the window of the given thread. ============
 646 
============= Make active the window of the given thread. ============
647 
======================================================================
 647 
======================================================================
648 
Parameters:
 648 
Parameters:
649 
  * eax = 18 - function number
 649 
  * eax = 18 - function number
650 
  * ebx = 3 - subfunction number
 650 
  * ebx = 3 - subfunction number
651 
  * ecx = number of the thread slot
 651 
  * ecx = number of the thread slot
652 
Returned value:
 652 
Returned value:
653 
  * function does not return value
 653 
  * function does not return value
654 
Remarks:
 654 
Remarks:
655 
  * If correct, but nonexistent slot is given,
 655 
  * If correct, but nonexistent slot is given,
656 
    some window is made active.
 656 
    some window is made active.
657 
  * To find out, which window is active, use subfunction 7.
 657 
  * To find out, which window is active, use subfunction 7.
658 
 
 658 
 
659 
======================================================================
 659 
======================================================================
660 
===================== Function 18, subfunction 4 =====================
 660 
===================== Function 18, subfunction 4 =====================
661 
=========== Get counter of idle time units per one second. ===========
 661 
=========== Get counter of idle time units per one second. ===========
662 
======================================================================
 662 
======================================================================
663 
Idle time units are units, in which the processor stands idle
 663 
Idle time units are units, in which the processor stands idle
664 
in waiting for interrupt (in the command 'hlt').
 664 
in waiting for interrupt (in the command 'hlt').
665 
 
 665 
 
666 
Parameters:
 666 
Parameters:
667 
  * eax = 18 - function number
 667 
  * eax = 18 - function number
668 
  * ebx = 4 - subfunction number
 668 
  * ebx = 4 - subfunction number
669 
Returned value:
 669 
Returned value:
670 
  * eax = value of the counter of idle time units per one second
 670 
  * eax = value of the counter of idle time units per one second
671 
 
 671 
 
672 
======================================================================
 672 
======================================================================
673 
========== Function 18, subfunction 5 - get CPU clock rate. ==========
 673 
========== Function 18, subfunction 5 - get CPU clock rate. ==========
674 
======================================================================
 674 
======================================================================
675 
Parameters:
 675 
Parameters:
676 
  * eax = 18 - function number
 676 
  * eax = 18 - function number
677 
  * ebx = 5 - subfunction number
 677 
  * ebx = 5 - subfunction number
678 
Returned value:
 678 
Returned value:
679 
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
 679 
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
680 
 
 680 
 
681 
======================================================================
 681 
======================================================================
682 
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
 682 
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
683 
======================================================================
 683 
======================================================================
684 
Parameters:
 684 
Parameters:
685 
  * eax = 18 - function number
 685 
  * eax = 18 - function number
686 
  * ebx = 6 - subfunction number
 686 
  * ebx = 6 - subfunction number
687 
  * ecx = pointer to the full path to file
 687 
  * ecx = pointer to the full path to file
688 
    (for example, "/hd0/1/kolibri/kolibri.img")
 688 
    (for example, "/hd0/1/kolibri/kolibri.img")
689 
Returned value:
 689 
Returned value:
690 
  * eax = 0 - success
 690 
  * eax = 0 - success
691 
  * else eax = error code of the file system
 691 
  * else eax = error code of the file system
692 
Remarks:
 692 
Remarks:
693 
  * All folders in the given path must exist, otherwise function
 693 
  * All folders in the given path must exist, otherwise function
694 
    returns value 5, "file not found".
 694 
    returns value 5, "file not found".
695 
 
 695 
 
696 
======================================================================
 696 
======================================================================
697 
=========== Function 18, subfunction 7 - get active window. ==========
 697 
=========== Function 18, subfunction 7 - get active window. ==========
698 
======================================================================
 698 
======================================================================
699 
Parameters:
 699 
Parameters:
700 
  * eax = 18 - function number
 700 
  * eax = 18 - function number
701 
  * ebx = 7 - subfunction number
 701 
  * ebx = 7 - subfunction number
702 
Returned value:
 702 
Returned value:
703 
  * eax = number of the active window
 703 
  * eax = number of the active window
704 
    (number of the slot of the thread with active window)
 704 
    (number of the slot of the thread with active window)
705 
Remarks:
 705 
Remarks:
706 
  * Active window is at the top of the window stack and receives
 706 
  * Active window is at the top of the window stack and receives
707 
    messages on all keyboard input.
 707 
    messages on all keyboard input.
708 
  * To make a window active, use subfunction 3.
 708 
  * To make a window active, use subfunction 3.
709 
 
 709 
 
710 
======================================================================
 710 
======================================================================
711 
== Function 18, subfunction 8 - disable/enable the internal speaker. =
 711 
== Function 18, subfunction 8 - disable/enable the internal speaker. =
712 
======================================================================
 712 
======================================================================
713 
If speaker sound is disabled, all calls to subfunction 55 of
 713 
If speaker sound is disabled, all calls to subfunction 55 of
714 
function 55 are ignored. If speaker sound is enabled,
 714 
function 55 are ignored. If speaker sound is enabled,
715 
they are routed on builtin speaker.
 715 
they are routed on builtin speaker.
716 
 
 716 
 
717 
------------------- Subsubfunction 1 - get status. -------------------
 717 
------------------- Subsubfunction 1 - get status. -------------------
718 
Parameters:
 718 
Parameters:
719 
  * eax = 18 - function number
 719 
  * eax = 18 - function number
720 
  * ebx = 8 - subfunction number
 720 
  * ebx = 8 - subfunction number
721 
  * ecx = 1 - number of the subsubfunction
 721 
  * ecx = 1 - number of the subsubfunction
722 
Returned value:
 722 
Returned value:
723 
  * eax = 0 - speaker sound is enabled; 1 - disabled
 723 
  * eax = 0 - speaker sound is enabled; 1 - disabled
724 
 
 724 
 
725 
----------------- Subsubfunction 2 - toggle status. ------------------
 725 
----------------- Subsubfunction 2 - toggle status. ------------------
726 
Toggles states of disable/enable.
 726 
Toggles states of disable/enable.
727 
Parameters:
 727 
Parameters:
728 
  * eax = 18 - function number
 728 
  * eax = 18 - function number
729 
  * ebx = 8 - subfunction number
 729 
  * ebx = 8 - subfunction number
730 
  * ecx = 2 - number of the subsubfunction
 730 
  * ecx = 2 - number of the subsubfunction
731 
Returned value:
 731 
Returned value:
732 
  * function does not return value
 732 
  * function does not return value
733 
 
 733 
 
734 
======================================================================
 734 
======================================================================
735 
== Function 18, subfunction 9 - system shutdown with the parameter. ==
 735 
== Function 18, subfunction 9 - system shutdown with the parameter. ==
736 
======================================================================
 736 
======================================================================
737 
Parameters:
 737 
Parameters:
738 
  * eax = 18 - function number
 738 
  * eax = 18 - function number
739 
  * ebx = 9 - subfunction number
 739 
  * ebx = 9 - subfunction number
740 
  * ecx = parameter:
 740 
  * ecx = parameter:
741 
    * 2 = turn off computer
 741 
    * 2 = turn off computer
742 
    * 3 = reboot computer
 742 
    * 3 = reboot computer
743 
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
 743 
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
744 
Returned value:
 744 
Returned value:
745 
  * at incorrect ecx the registers do not change (i.e. eax=18)
 745 
  * at incorrect ecx the registers do not change (i.e. eax=18)
746 
  * by correct call function always returns eax=0
 746 
  * by correct call function always returns eax=0
747 
    as the tag of success
 747 
    as the tag of success
748 
Remarks:
 748 
Remarks:
749 
  * Do not rely on returned value by incorrect call, it can be
 749 
  * Do not rely on returned value by incorrect call, it can be
750 
    changed in future versions of the kernel.
 750 
    changed in future versions of the kernel.
751 
 
 751 
 
752 
======================================================================
 752 
======================================================================
753 
===== Function 18, subfunction 10 - minimize application window. =====
 753 
===== Function 18, subfunction 10 - minimize application window. =====
754 
======================================================================
 754 
======================================================================
755 
Minimizes the own window.
 755 
Minimizes the own window.
756 
Parameters:
 756 
Parameters:
757 
  * eax = 18 - function number
 757 
  * eax = 18 - function number
758 
  * ebx = 10 - subfunction number
 758 
  * ebx = 10 - subfunction number
759 
Returned value:
 759 
Returned value:
760 
  * function does not return value
 760 
  * function does not return value
761 
Remarks:
 761 
Remarks:
762 
  * The minimized window from the point of view of function 9
 762 
  * The minimized window from the point of view of function 9
763 
    keeps position and sizes.
 763 
    keeps position and sizes.
764 
  * Restoring of an application window occurs at its activation by
 764 
  * Restoring of an application window occurs at its activation by
765 
    subfunction 3.
 765 
    subfunction 3.
766 
  * Usually there is no necessity to minimize/restire a window
 766 
  * Usually there is no necessity to minimize/restire a window
767 
    obviously: minimization of a window is carried out by the system
 767 
    obviously: minimization of a window is carried out by the system
768 
    at pressing the minimization button (for skinned windows
 768 
    at pressing the minimization button (for skinned windows
769 
    it is defined automatically by function 0,
 769 
    it is defined automatically by function 0,
770 
    for other windows it can be defined manually by function 8),
 770 
    for other windows it can be defined manually by function 8),
771 
    restore of a window is done by the application '@panel'.
 771 
    restore of a window is done by the application '@panel'.
772 
 
 772 
 
773 
======================================================================
 773 
======================================================================
774 
 Function 18, subfunction 11 - get information on the disk subsystem.
 774 
 Function 18, subfunction 11 - get information on the disk subsystem.
775 
======================================================================
 775 
======================================================================
776 
Parameters:
 776 
Parameters:
777 
  * eax = 18 - function number
 777 
  * eax = 18 - function number
778 
  * ebx = 11 - subfunction number
 778 
  * ebx = 11 - subfunction number
779 
  * ecx = type of the table:
 779 
  * ecx = type of the table:
780 
    * 1 = short version, 10 bytes
 780 
    * 1 = short version, 10 bytes
781 
    * 2 = full version, 65536 bytes
 781 
    * 2 = full version, 65536 bytes
782 
  * edx = pointer to the buffer (in the application) for the table
 782 
  * edx = pointer to the buffer (in the application) for the table
783 
Returned value:
 783 
Returned value:
784 
  * function does not return value
 784 
  * function does not return value
785 
Format of the table: short version:
 785 
Format of the table: short version:
786 
  * +0: byte: information about FDD's (drives for floppies),
 786 
  * +0: byte: information about FDD's (drives for floppies),
787 
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
 787 
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
788 
    of the second regarding to the following list:
 788 
    of the second regarding to the following list:
789 
    * 0 = there is no drive
 789 
    * 0 = there is no drive
790 
    * 1 = 360Kb, 5.25''
 790 
    * 1 = 360Kb, 5.25''
791 
    * 2 = 1.2Mb, 5.25''
 791 
    * 2 = 1.2Mb, 5.25''
792 
    * 3 = 720Kb, 3.5''
 792 
    * 3 = 720Kb, 3.5''
793 
    * 4 = 1.44Mb, 3.5''
 793 
    * 4 = 1.44Mb, 3.5''
794 
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
 794 
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
795 
    For example, for the standard configuration from one 1.44-drive
 795 
    For example, for the standard configuration from one 1.44-drive
796 
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
 796 
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
797 
    the value is 24h.
 797 
    the value is 24h.
798 
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
 798 
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
799 
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
 799 
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
800 
    * 0 = device is absent
 800 
    * 0 = device is absent
801 
    * 1 = hard drive
 801 
    * 1 = hard drive
802 
    * 2 = CD-drive
 802 
    * 2 = CD-drive
803 
    For example, in the case HD on IDE0 and CD on IDE2
 803 
    For example, in the case HD on IDE0 and CD on IDE2
804 
    this field contains 48h.
 804 
    this field contains 48h.
805 
  * +2: 4 db: number of the retrieved partitions on hard disks
 805 
  * +2: 4 db: number of the retrieved partitions on hard disks
806 
    at accordingly IDE0,...,IDE3.
 806 
    at accordingly IDE0,...,IDE3.
807 
    If the hard disk on IDEx is absent, appropriate byte is zero,
 807 
    If the hard disk on IDEx is absent, appropriate byte is zero,
808 
    otherwise it shows number of the recognized partitions, which
 808 
    otherwise it shows number of the recognized partitions, which
809 
    can be not presented (if the drive is not formatted or if
 809 
    can be not presented (if the drive is not formatted or if
810 
    the file system is not supported). Current version of the kernel
 810 
    the file system is not supported). Current version of the kernel
811 
    supports only FAT16, FAT32 and NTFS for hard disks.
 811 
    supports only FAT16, FAT32 and NTFS for hard disks.
812 
  * +6: 4 db: reserved
 812 
  * +6: 4 db: reserved
813 
Format of the table: full version:
 813 
Format of the table: full version:
814 
  * +0: 10 db: same as for the short version
 814 
  * +0: 10 db: same as for the short version
815 
  * +10: 100 db: data for the first partition
 815 
  * +10: 100 db: data for the first partition
816 
  * +110: 100 db: data for the second partition
 816 
  * +110: 100 db: data for the second partition
817 
  * ...
 817 
  * ...
818 
  * +10+100*(n-1): 100 db: data for the last partition
 818 
  * +10+100*(n-1): 100 db: data for the last partition
819 
The partitions are located as follows: at first sequentially all
 819 
The partitions are located as follows: at first sequentially all
820 
recoginzed partitions on HD on IDE0 (if present),
 820 
recoginzed partitions on HD on IDE0 (if present),
821 
then on HD on IDE1 (if present) and so on up to IDE3.
 821 
then on HD on IDE1 (if present) and so on up to IDE3.
822 
Format of the information about partition
 822 
Format of the information about partition
823 
(at moment only FAT is supported):
 823 
(at moment only FAT is supported):
824 
  * +0: dword: first physical sector of the partition
 824 
  * +0: dword: first physical sector of the partition
825 
  * +4: dword: last physical sector of the partition
 825 
  * +4: dword: last physical sector of the partition
826 
    (belongs to the partition)
 826 
    (belongs to the partition)
827 
  * +8: byte: file system type:
 827 
  * +8: byte: file system type:
828 
    16=FAT16, 32=FAT32, 1=NTFS
 828 
    16=FAT16, 32=FAT32, 1=NTFS
829 
  * other data are dependent on file system, are modified with
 829 
  * other data are dependent on file system, are modified with
830 
    kernel modifications and therefore are not described
 830 
    kernel modifications and therefore are not described
831 
Remarks:
 831 
Remarks:
832 
  * The short table can be used for obtaining the information about
 832 
  * The short table can be used for obtaining the information about
833 
    available devices.
 833 
    available devices.
834 
 
 834 
 
835 
======================================================================
 835 
======================================================================
836 
========== Function 18, subfunction 13 - get kernel version. =========
 836 
========== Function 18, subfunction 13 - get kernel version. =========
837 
======================================================================
 837 
======================================================================
838 
Parameters:
 838 
Parameters:
839 
  * eax = 18 - function number
 839 
  * eax = 18 - function number
840 
  * ebx = 13 - subfunction number
 840 
  * ebx = 13 - subfunction number
841 
  * ecx = pointer to the buffer (not less than 16 bytes), where
 841 
  * ecx = pointer to the buffer (not less than 16 bytes), where
842 
    the information will be placed
 842 
    the information will be placed
843 
Returned value:
 843 
Returned value:
844 
  * function does not return value
 844 
  * function does not return value
845 
Structure of the buffer:
 845 
Structure of the buffer:
846 
db a,b,c,d for version a.b.c.d
 846 
db a,b,c,d for version a.b.c.d
847 
db UID_xxx: one of UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
 847 
db UID_xxx: one of UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
848 
dd REV - kernel SVN revision number
 848 
dd REV - kernel SVN revision number
849 
For Kolibri 0.7.1.0 kernel:
 849 
For Kolibri 0.7.1.0 kernel:
850 
db 0,7,0,0
 850 
db 0,7,0,0
851 
db 2
 851 
db 2
852 
dd 638
 852 
dd 638
853 
 
 853 
 
854 
======================================================================
 854 
======================================================================
855 
======= Function 18, subfunction 14 - wait for screen retrace. =======
 855 
======= Function 18, subfunction 14 - wait for screen retrace. =======
856 
======================================================================
 856 
======================================================================
857 
Waits for the beginning of retrace of the scanning ray of the screen
 857 
Waits for the beginning of retrace of the scanning ray of the screen
858 
monitor.
 858 
monitor.
859 
Parameters:
 859 
Parameters:
860 
  * eax = 18 - function number
 860 
  * eax = 18 - function number
861 
  * ebx = 14 - subfunction number
 861 
  * ebx = 14 - subfunction number
862 
Returned value:
 862 
Returned value:
863 
  * eax = 0 as the tag of success
 863 
  * eax = 0 as the tag of success
864 
Remarks:
 864 
Remarks:
865 
  * Function is intended only for active high-efficiency graphics
 865 
  * Function is intended only for active high-efficiency graphics
866 
    applications; is used for smooth output of a graphics.
 866 
    applications; is used for smooth output of a graphics.
867 
 
 867 
 
868 
======================================================================
 868 
======================================================================
869 
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
 869 
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
870 
======================================================================
 870 
======================================================================
871 
Parameters:
 871 
Parameters:
872 
  * eax = 18 - function number
 872 
  * eax = 18 - function number
873 
  * ebx = 15 - subfunction number
 873 
  * ebx = 15 - subfunction number
874 
Returned value:
 874 
Returned value:
875 
  * eax = 0 as the tag of success
 875 
  * eax = 0 as the tag of success
876 
 
 876 
 
877 
======================================================================
 877 
======================================================================
878 
========= Function 18, subfunction 16 - get size of free RAM. ========
 878 
========= Function 18, subfunction 16 - get size of free RAM. ========
879 
======================================================================
 879 
======================================================================
880 
Parameters:
 880 
Parameters:
881 
  * eax = 18 - function number
 881 
  * eax = 18 - function number
882 
  * ebx = 16 - subfunction number
 882 
  * ebx = 16 - subfunction number
883 
Returned value:
 883 
Returned value:
884 
  * eax = size of free memory in kilobytes
 884 
  * eax = size of free memory in kilobytes
885 
 
 885 
 
886 
======================================================================
 886 
======================================================================
887 
======== Function 18, subfunction 17 - get full amount of RAM. =======
 887 
======== Function 18, subfunction 17 - get full amount of RAM. =======
888 
======================================================================
 888 
======================================================================
889 
Parameters:
 889 
Parameters:
890 
  * eax = 18 - function number
 890 
  * eax = 18 - function number
891 
  * ebx = 17 - subfunction number
 891 
  * ebx = 17 - subfunction number
892 
Returned value:
 892 
Returned value:
893 
  * eax = total size of existing memory in kilobytes
 893 
  * eax = total size of existing memory in kilobytes
894 
 
 894 
 
895 
======================================================================
 895 
======================================================================
896 
===================== Function 18, subfunction 18 ====================
 896 
===================== Function 18, subfunction 18 ====================
897 
============= Terminate process/thread by the identifier. ============
 897 
============= Terminate process/thread by the identifier. ============
898 
======================================================================
 898 
======================================================================
899 
Parameters:
 899 
Parameters:
900 
  * eax = 18 - function number
 900 
  * eax = 18 - function number
901 
  * ebx = 18 - subfunction number
 901 
  * ebx = 18 - subfunction number
902 
  * ecx = identifer of process/thread (PID/TID)
 902 
  * ecx = identifer of process/thread (PID/TID)
903 
Returned value:
 903 
Returned value:
904 
  * eax = 0 - success
 904 
  * eax = 0 - success
905 
  * eax = -1 - error (process is not found or is system)
 905 
  * eax = -1 - error (process is not found or is system)
906 
Remarks:
 906 
Remarks:
907 
  * It is impossible to terminate system thread OS/IDLE (identifier
 907 
  * It is impossible to terminate system thread OS/IDLE (identifier
908 
    1), it is possible to terminate any normal process/thread.
 908 
    1), it is possible to terminate any normal process/thread.
909 
  * See also subfunction 2 - terminate
 909 
  * See also subfunction 2 - terminate
910 
    process/thread by given slot.
 910 
    process/thread by given slot.
911 
 
 911 
 
912 
======================================================================
 912 
======================================================================
913 
======== Function 18, subfunction 19 - get/set mouse features. =======
 913 
======== Function 18, subfunction 19 - get/set mouse features. =======
914 
======================================================================
 914 
======================================================================
915 
 
 915 
 
916 
---------------- Subsubfunction 0 - get mouse speed. -----------------
 916 
---------------- Subsubfunction 0 - get mouse speed. -----------------
917 
Parameters:
 917 
Parameters:
918 
  * eax = 18 - function number
 918 
  * eax = 18 - function number
919 
  * ebx = 19 - subfunction number
 919 
  * ebx = 19 - subfunction number
920 
  * ecx = 0 - subsubfunction number
 920 
  * ecx = 0 - subsubfunction number
921 
Returned value:
 921 
Returned value:
922 
  * eax = current mouse speed
 922 
  * eax = current mouse speed
923 
 
 923 
 
924 
---------------- Subsubfunction 1 - set mouse speed. -----------------
 924 
---------------- Subsubfunction 1 - set mouse speed. -----------------
925 
Parameters:
 925 
Parameters:
926 
  * eax = 18 - function number
 926 
  * eax = 18 - function number
927 
  * ebx = 19 - subfunction number
 927 
  * ebx = 19 - subfunction number
928 
  * ecx = 1 - subsubfunction number
 928 
  * ecx = 1 - subsubfunction number
929 
  * edx = new value for speed
 929 
  * edx = new value for speed
930 
Returned value:
 930 
Returned value:
931 
  * function does not return value
 931 
  * function does not return value
932 
 
 932 
 
933 
---------------- Subsubfunction 2 - get mouse delay. -----------------
 933 
---------------- Subsubfunction 2 - get mouse delay. -----------------
934 
Parameters:
 934 
Parameters:
935 
  * eax = 18 - function number
 935 
  * eax = 18 - function number
936 
  * ebx = 19 - subfunction number
 936 
  * ebx = 19 - subfunction number
937 
  * ecx = 2 - subsubfunction number
 937 
  * ecx = 2 - subsubfunction number
938 
Returned value:
 938 
Returned value:
939 
  * eax = current mouse delay
 939 
  * eax = current mouse delay
940 
 
 940 
 
941 
---------------- Subsubfunction 3 - set mouse delay. -----------------
 941 
---------------- Subsubfunction 3 - set mouse delay. -----------------
942 
Parameters:
 942 
Parameters:
943 
  * eax = 18 - function number
 943 
  * eax = 18 - function number
944 
  * ebx = 19 - subfunction number
 944 
  * ebx = 19 - subfunction number
945 
  * ecx = 3 - subsubfunction number
 945 
  * ecx = 3 - subsubfunction number
946 
  * edx = new value for mouse delay
 946 
  * edx = new value for mouse delay
947 
Returned value:
 947 
Returned value:
948 
  * function does not return value
 948 
  * function does not return value
949 
 
 949 
 
950 
----------- Subsubfunction 4 - set mouse pointer position. -----------
 950 
----------- Subsubfunction 4 - set mouse pointer position. -----------
951 
Parameters:
 951 
Parameters:
952 
  * eax = 18 - function number
 952 
  * eax = 18 - function number
953 
  * ebx = 19 - subfunction number
 953 
  * ebx = 19 - subfunction number
954 
  * ecx = 4 - subsubfunction number
 954 
  * ecx = 4 - subsubfunction number
955 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 955 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
956 
Returned value:
 956 
Returned value:
957 
  * function does not return value
 957 
  * function does not return value
958 
 
 958 
 
959 
-------- Subsubfunction 5 - simulate state of mouse buttons. ---------
 959 
-------- Subsubfunction 5 - simulate state of mouse buttons. ---------
960 
Parameters:
 960 
Parameters:
961 
  * eax = 18 - function number
 961 
  * eax = 18 - function number
962 
  * ebx = 19 - subfunction number
 962 
  * ebx = 19 - subfunction number
963 
  * ecx = 5 - subsubfunction number
 963 
  * ecx = 5 - subsubfunction number
964 
  * edx = information about emulated state of mouse buttons:
 964 
  * edx = information about emulated state of mouse buttons:
965 
    (same as return value in subfunction 2 of function 37)
 965 
    (same as return value in subfunction 2 of function 37)
966 
    * bit 0 is set = left button is pressed
 966 
    * bit 0 is set = left button is pressed
967 
    * bit 1 is set = right button is pressed
 967 
    * bit 1 is set = right button is pressed
968 
    * bit 2 is set = middle button is pressed
 968 
    * bit 2 is set = middle button is pressed
969 
    * bit 3 is set = 4th button is pressed
 969 
    * bit 3 is set = 4th button is pressed
970 
    * bit 4 is set = 5th button is pressed
 970 
    * bit 4 is set = 5th button is pressed
971 
Returned value:
 971 
Returned value:
972 
  * function does not return value
 972 
  * function does not return value
973 
Remarks:
 973 
Remarks:
974 
  * It is recommended to set speed of the mouse (in subsubfunction 1)
 974 
  * It is recommended to set speed of the mouse (in subsubfunction 1)
975 
    from 1 up to 9. The installed value is not inspected by the kernel
 975 
    from 1 up to 9. The installed value is not inspected by the kernel
976 
    code, so set it carefully, at incorrect value the cursor
 976 
    code, so set it carefully, at incorrect value the cursor
977 
    can "freeze". Speed of the mouse can be regulated through the
 977 
    can "freeze". Speed of the mouse can be regulated through the
978 
    application SETUP.
 978 
    application SETUP.
979 
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
 979 
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
980 
    value is not handled by COM mice. At the very large values the
 980 
    value is not handled by COM mice. At the very large values the
981 
    movement of the mouse on 1 pixel is impossible and the cursor will
 981 
    movement of the mouse on 1 pixel is impossible and the cursor will
982 
    jump on the value of installed speed (subsubfunction 1). The
 982 
    jump on the value of installed speed (subsubfunction 1). The
983 
    installed value is not inspected by the kernel code.
 983 
    installed value is not inspected by the kernel code.
984 
    Mouse delay can be regulated through the application SETUP.
 984 
    Mouse delay can be regulated through the application SETUP.
985 
  * The subsubfunction 4 does not check the passed value. Before
 985 
  * The subsubfunction 4 does not check the passed value. Before
986 
    its call find out current screen resolution (with function 14)
 986 
    its call find out current screen resolution (with function 14)
987 
    and check that the value of position is inside the limits of the
 987 
    and check that the value of position is inside the limits of the
988 
    screen.
 988 
    screen.
989 
 
 989 
 
990 
======================================================================
 990 
======================================================================
991 
======== Function 18, subfunction 20 - get information on RAM. =======
 991 
======== Function 18, subfunction 20 - get information on RAM. =======
992 
======================================================================
 992 
======================================================================
993 
Parameters:
 993 
Parameters:
994 
  * eax = 18 - function number
 994 
  * eax = 18 - function number
995 
  * ebx = 20 - subfunction number
 995 
  * ebx = 20 - subfunction number
996 
  * ecx = pointer to the buffer for information (36 bytes)
 996 
  * ecx = pointer to the buffer for information (36 bytes)
997 
Returned value:
 997 
Returned value:
998 
  * eax = total size of existing RAM in pages
 998 
  * eax = total size of existing RAM in pages
999 
    or -1 if error has occured
 999 
    or -1 if error has occured
1000 
  * buffer pointed to by ecx contains the following information:
 1000 
  * buffer pointed to by ecx contains the following information:
1001 
    * +0:  dword: total size of existing RAM in pages
 1001 
    * +0:  dword: total size of existing RAM in pages
1002 
    * +4:  dword: size of free RAM in pages
 1002 
    * +4:  dword: size of free RAM in pages
1003 
    * +8:  dword: number of page faults (exceptions #PF)
 1003 
    * +8:  dword: number of page faults (exceptions #PF)
1004 
                 in applications
 1004 
                 in applications
1005 
    * +12: dword: size of kernel heap in bytes
 1005 
    * +12: dword: size of kernel heap in bytes
1006 
    * +16: dword: free in kernel heap in bytes
 1006 
    * +16: dword: free in kernel heap in bytes
1007 
    * +20: dword: total number of memory blocks in kernel heap
 1007 
    * +20: dword: total number of memory blocks in kernel heap
1008 
    * +24: dword: number of free memory blocks in kernel heap
 1008 
    * +24: dword: number of free memory blocks in kernel heap
1009 
    * +28: dword: size of maximum free block in kernel heap
 1009 
    * +28: dword: size of maximum free block in kernel heap
1010 
                 (reserved)
 1010 
                 (reserved)
1011 
    * +32: dword: size of maximum allocated block in kernel heap
 1011 
    * +32: dword: size of maximum allocated block in kernel heap
1012 
                 (reserved)
 1012 
                 (reserved)
1013 
 
 1013 
 
1014 
======================================================================
 1014 
======================================================================
1015 
===================== Function 18, subfunction 21 ====================
 1015 
===================== Function 18, subfunction 21 ====================
1016 
======== Get slot number of process/thread by the identifier. ========
 1016 
======== Get slot number of process/thread by the identifier. ========
1017 
======================================================================
 1017 
======================================================================
1018 
Parameters:
 1018 
Parameters:
1019 
  * eax = 18 - function number
 1019 
  * eax = 18 - function number
1020 
  * ebx = 21 - subfunction number
 1020 
  * ebx = 21 - subfunction number
1021 
  * ecx = identifer of process/thread (PID/TID)
 1021 
  * ecx = identifer of process/thread (PID/TID)
1022 
Returned value:
 1022 
Returned value:
1023 
  * eax = 0 - error (invalid identifier)
 1023 
  * eax = 0 - error (invalid identifier)
1024 
  * otherwise eax = slot number
 1024 
  * otherwise eax = slot number
1025 
 
 1025 
 
1026 
======================================================================
 1026 
======================================================================
1027 
===================== Function 18, subfunction 22 ====================
 1027 
===================== Function 18, subfunction 22 ====================
1028 
============== Operations with window of another thread. =============
 1028 
============== Operations with window of another thread. =============
1029 
======================================================================
 1029 
======================================================================
1030 
Parameters:
 1030 
Parameters:
1031 
  * eax = 18 - function number
 1031 
  * eax = 18 - function number
1032 
  * ebx = 22 - subfunction number
 1032 
  * ebx = 22 - subfunction number
1033 
  * ecx = operation type:
 1033 
  * ecx = operation type:
1034 
    * 0 = minimize window of the thread with given slot number
 1034 
    * 0 = minimize window of the thread with given slot number
1035 
    * 1 = minimize window of the thread with given identifier
 1035 
    * 1 = minimize window of the thread with given identifier
1036 
    * 2 = restore window of the thread with given slot number
 1036 
    * 2 = restore window of the thread with given slot number
1037 
    * 3 = restore window of the thread with given identifier
 1037 
    * 3 = restore window of the thread with given identifier
1038 
  * edx = parameter (slot number or PID/TID)
 1038 
  * edx = parameter (slot number or PID/TID)
1039 
Returned value:
 1039 
Returned value:
1040 
  * eax = 0 - success
 1040 
  * eax = 0 - success
1041 
  * eax = -1 - error (invalid identifier)
 1041 
  * eax = -1 - error (invalid identifier)
1042 
Remarks:
 1042 
Remarks:
1043 
  * The thread can minimize its window with subfunction 10.
 1043 
  * The thread can minimize its window with subfunction 10.
1044 
  * One can restore and activate window simultaneously with
 1044 
  * One can restore and activate window simultaneously with
1045 
    subfunction 3 (which requires slot number).
 1045 
    subfunction 3 (which requires slot number).
1046 
 
 1046 
 
1047 
======================================================================
 1047 
======================================================================
1048 
==================== Function 20 - MIDI interface. ===================
 1048 
==================== Function 20 - MIDI interface. ===================
1049 
======================================================================
 1049 
======================================================================
1050 
 
 1050 
 
1051 
----------------------- Subfunction 1 - reset ------------------------
 1051 
----------------------- Subfunction 1 - reset ------------------------
1052 
Parameters:
 1052 
Parameters:
1053 
  * eax = 20 - function number
 1053 
  * eax = 20 - function number
1054 
  * ebx = 1 - subfunction number
 1054 
  * ebx = 1 - subfunction number
1055 
 
 1055 
 
1056 
-------------------- Subfunction 2 - output byte ---------------------
 1056 
-------------------- Subfunction 2 - output byte ---------------------
1057 
Parameters:
 1057 
Parameters:
1058 
  * eax = 20 - function number
 1058 
  * eax = 20 - function number
1059 
  * ebx = 2 - subfunction number
 1059 
  * ebx = 2 - subfunction number
1060 
  * cl = byte for output
 1060 
  * cl = byte for output
1061 
Returned value (is the same for both subfunctions):
 1061 
Returned value (is the same for both subfunctions):
1062 
  * eax = 0 - success
 1062 
  * eax = 0 - success
1063 
  * eax = 1 - base port is not defined
 1063 
  * eax = 1 - base port is not defined
1064 
Remarks:
 1064 
Remarks:
1065 
  * Previously the base port must be defined by
 1065 
  * Previously the base port must be defined by
1066 
    subfunction 1 of function 21.
 1066 
    subfunction 1 of function 21.
1067 
 
 1067 
 
1068 
======================================================================
 1068 
======================================================================
1069 
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
 1069 
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
1070 
======================================================================
 1070 
======================================================================
1071 
Parameters:
 1071 
Parameters:
1072 
  * eax = 21 - function number
 1072 
  * eax = 21 - function number
1073 
  * ebx = 1 - subfunction number
 1073 
  * ebx = 1 - subfunction number
1074 
  * ecx = number of base port
 1074 
  * ecx = number of base port
1075 
Returned value
 1075 
Returned value
1076 
  * eax = 0 - success
 1076 
  * eax = 0 - success
1077 
  * eax = -1 - erratic number of a port
 1077 
  * eax = -1 - erratic number of a port
1078 
Remarks:
 1078 
Remarks:
1079 
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
 1079 
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
1080 
  * The installation of base is necessary for function 20.
 1080 
  * The installation of base is necessary for function 20.
1081 
  * To get base port use subfunction 1 of function 26.
 1081 
  * To get base port use subfunction 1 of function 26.
1082 
 
 1082 
 
1083 
======================================================================
 1083 
======================================================================
1084 
========== Function 21, subfunction 2 - set keyboard layout. =========
 1084 
========== Function 21, subfunction 2 - set keyboard layout. =========
1085 
======================================================================
 1085 
======================================================================
1086 
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
 1086 
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
1087 
which will be read by function 2.
 1087 
which will be read by function 2.
1088 
Parameters:
 1088 
Parameters:
1089 
  * eax = 21 - function number
 1089 
  * eax = 21 - function number
1090 
  * ebx = 2 - subfunction number
 1090 
  * ebx = 2 - subfunction number
1091 
  * ecx = which layout to set:
 1091 
  * ecx = which layout to set:
1092 
    * 1 = normal layout
 1092 
    * 1 = normal layout
1093 
    * 2 = layout at pressed Shift
 1093 
    * 2 = layout at pressed Shift
1094 
    * 3 = layout at pressed Alt
 1094 
    * 3 = layout at pressed Alt
1095 
  * edx = pointer to layout - table of length 128 bytes
 1095 
  * edx = pointer to layout - table of length 128 bytes
1096 
Or:
 1096 
Or:
1097 
  * ecx = 9
 1097 
  * ecx = 9
1098 
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
 1098 
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1099 
Returned value:
 1099 
Returned value:
1100 
  * eax = 0 - success
 1100 
  * eax = 0 - success
1101 
  * eax = 1 - incorrect parameter
 1101 
  * eax = 1 - incorrect parameter
1102 
Remarks:
 1102 
Remarks:
1103 
  * If Alt is pressed, the layout with Alt is used;
 1103 
  * If Alt is pressed, the layout with Alt is used;
1104 
    if Alt is not pressed, but Shift is pressed,
 1104 
    if Alt is not pressed, but Shift is pressed,
1105 
    the layout with Shift is used;
 1105 
    the layout with Shift is used;
1106 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
 1106 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1107 
    layout is used and then from the code is subtracted 0x60;
 1107 
    layout is used and then from the code is subtracted 0x60;
1108 
    if no control key is pressed, the normal layout is used.
 1108 
    if no control key is pressed, the normal layout is used.
1109 
  * To get layout and country identifier use
 1109 
  * To get layout and country identifier use
1110 
    subfunction 2 of function 26.
 1110 
    subfunction 2 of function 26.
1111 
  * Country identifier is global system variable, which is not used
 1111 
  * Country identifier is global system variable, which is not used
1112 
    by the kernel itself; however the application '@panel' displays
 1112 
    by the kernel itself; however the application '@panel' displays
1113 
    the corresponding icon.
 1113 
    the corresponding icon.
1114 
  * The application @panel switches layouts on user request.
 1114 
  * The application @panel switches layouts on user request.
1115 
 
 1115 
 
1116 
======================================================================
 1116 
======================================================================
1117 
============== Function 21, subfunction 3 - set CD base. =============
 1117 
============== Function 21, subfunction 3 - set CD base. =============
1118 
======================================================================
 1118 
======================================================================
1119 
Parameters:
 1119 
Parameters:
1120 
  * eax = 21 - function number
 1120 
  * eax = 21 - function number
1121 
  * ebx = 3 - subfunction number
 1121 
  * ebx = 3 - subfunction number
1122 
  * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1122 
  * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1123 
Returned value:
 1123 
Returned value:
1124 
  * eax = 0
 1124 
  * eax = 0
1125 
Remarks:
 1125 
Remarks:
1126 
  * CD base is used by function 24.
 1126 
  * CD base is used by function 24.
1127 
  * To get CD base use subfunction 3 of function 26.
 1127 
  * To get CD base use subfunction 3 of function 26.
1128 
 
 1128 
 
1129 
======================================================================
 1129 
======================================================================
1130 
========== Function 21, subfunction 5 - set system language. =========
 1130 
========== Function 21, subfunction 5 - set system language. =========
1131 
======================================================================
 1131 
======================================================================
1132 
Parameters:
 1132 
Parameters:
1133 
  * eax = 21 - function number
 1133 
  * eax = 21 - function number
1134 
  * ebx = 5 - subfunction number
 1134 
  * ebx = 5 - subfunction number
1135 
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
 1135 
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
1136 
Returned value:
 1136 
Returned value:
1137 
  * eax = 0
 1137 
  * eax = 0
1138 
Remarks:
 1138 
Remarks:
1139 
  * System language is global system variable and is not used
 1139 
  * System language is global system variable and is not used
1140 
    by the kernel itself, however application @panel draws the
 1140 
    by the kernel itself, however application @panel draws the
1141 
    appropriate icon.
 1141 
    appropriate icon.
1142 
  * Function does not check for correctness, as the kernel does not
 1142 
  * Function does not check for correctness, as the kernel does not
1143 
    use this variable.
 1143 
    use this variable.
1144 
  * To get system language use subfunction 5 of function 26.
 1144 
  * To get system language use subfunction 5 of function 26.
1145 
 
 1145 
 
1146 
======================================================================
 1146 
======================================================================
1147 
============== Function 21, subfunction 7 - set HD base. =============
 1147 
============== Function 21, subfunction 7 - set HD base. =============
1148 
======================================================================
 1148 
======================================================================
1149 
The HD base defines hard disk to write with usage of obsolete
 1149 
The HD base defines hard disk to write with usage of obsolete
1150 
syntax /HD in obsolete function 58; at usage of modern syntax
 1150 
syntax /HD in obsolete function 58; at usage of modern syntax
1151 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
 1151 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1152 
Parameters:
 1152 
Parameters:
1153 
  * eax = 21 - function number
 1153 
  * eax = 21 - function number
1154 
  * ebx = 7 - subfunction number
 1154 
  * ebx = 7 - subfunction number
1155 
  * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1155 
  * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1156 
Returned value:
 1156 
Returned value:
1157 
  * eax = 0
 1157 
  * eax = 0
1158 
Remarks:
 1158 
Remarks:
1159 
  * Any application at any time can change the base.
 1159 
  * Any application at any time can change the base.
1160 
  * Do not change base, when any application works with hard disk.
 1160 
  * Do not change base, when any application works with hard disk.
1161 
    If you do not want system bugs.
 1161 
    If you do not want system bugs.
1162 
  * To get HD base use subfunction 7 of function 26.
 1162 
  * To get HD base use subfunction 7 of function 26.
1163 
  * It is also necessary to define used partition of hard disk by
 1163 
  * It is also necessary to define used partition of hard disk by
1164 
    subfunction 8.
 1164 
    subfunction 8.
1165 
 
 1165 
 
1166 
======================================================================
 1166 
======================================================================
1167 
========= Function 21, subfunction 8 - set used HD partition. ========
 1167 
========= Function 21, subfunction 8 - set used HD partition. ========
1168 
======================================================================
 1168 
======================================================================
1169 
The HD partition defines partition of the hard disk to write with
 1169 
The HD partition defines partition of the hard disk to write with
1170 
usage of obsolete syntax /HD and obsolete function 58;
 1170 
usage of obsolete syntax /HD and obsolete function 58;
1171 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
 1171 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1172 
base and partition are set automatically.
 1172 
base and partition are set automatically.
1173 
Parameters:
 1173 
Parameters:
1174 
  * eax = 21 - function number
 1174 
  * eax = 21 - function number
1175 
  * ebx = 8 - subfunction number
 1175 
  * ebx = 8 - subfunction number
1176 
  * ecx = HD partition (beginning from 1)
 1176 
  * ecx = HD partition (beginning from 1)
1177 
Return value:
 1177 
Return value:
1178 
  * eax = 0
 1178 
  * eax = 0
1179 
Remarks:
 1179 
Remarks:
1180 
  * Any application at any time can change partition.
 1180 
  * Any application at any time can change partition.
1181 
  * Do not change partition when any application works with hard disk.
 1181 
  * Do not change partition when any application works with hard disk.
1182 
    If you do not want system bugs.
 1182 
    If you do not want system bugs.
1183 
  * To get used partition use subfunction 8 of function 26.
 1183 
  * To get used partition use subfunction 8 of function 26.
1184 
  * There is no correctness checks.
 1184 
  * There is no correctness checks.
1185 
  * To get the number of partitions of a hard disk use
 1185 
  * To get the number of partitions of a hard disk use
1186 
    subfunction 11 of function 18.
 1186 
    subfunction 11 of function 18.
1187 
  * It is also necessary to define used HD base by subfunction 7.
 1187 
  * It is also necessary to define used HD base by subfunction 7.
1188 
 
 1188 
 
1189 
======================================================================
 1189 
======================================================================
1190 
 Function 21, subfunction 11 - enable/disable low-level access to HD.
 1190 
 Function 21, subfunction 11 - enable/disable low-level access to HD.
1191 
======================================================================
 1191 
======================================================================
1192 
Parameters:
 1192 
Parameters:
1193 
  * eax = 21 - function number
 1193 
  * eax = 21 - function number
1194 
  * ebx = 11 - subfunction number
 1194 
  * ebx = 11 - subfunction number
1195 
  * ecx = 0/1 - disable/enable
 1195 
  * ecx = 0/1 - disable/enable
1196 
Returned value:
 1196 
Returned value:
1197 
  * eax = 0
 1197 
  * eax = 0
1198 
Remarks:
 1198 
Remarks:
1199 
  * Is used in LBA-read (subfunction 8 of function 58).
 1199 
  * Is used in LBA-read (subfunction 8 of function 58).
1200 
  * The current implementation uses only low bit of ecx.
 1200 
  * The current implementation uses only low bit of ecx.
1201 
  * To get current status use subfunction 11 of function 26.
 1201 
  * To get current status use subfunction 11 of function 26.
1202 
 
 1202 
 
1203 
======================================================================
 1203 
======================================================================
1204 
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
 1204 
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
1205 
======================================================================
 1205 
======================================================================
1206 
Parameters:
 1206 
Parameters:
1207 
  * eax = 21 - function number
 1207 
  * eax = 21 - function number
1208 
  * ebx = 12 - subfunction number
 1208 
  * ebx = 12 - subfunction number
1209 
  * ecx = 0/1 - disable/enable
 1209 
  * ecx = 0/1 - disable/enable
1210 
Returned value:
 1210 
Returned value:
1211 
  * eax = 0
 1211 
  * eax = 0
1212 
Remarks:
 1212 
Remarks:
1213 
  * Is used in operations with PCI bus (function 62).
 1213 
  * Is used in operations with PCI bus (function 62).
1214 
  * The current implementation uses only low bit of ecx.
 1214 
  * The current implementation uses only low bit of ecx.
1215 
  * To get current status use subfunction 12 of function 26.
 1215 
  * To get current status use subfunction 12 of function 26.
1216 
 
 1216 
 
1217 
======================================================================
 1217 
======================================================================
1218 
============ Function 21, subfunction 13, subsubfunction 1 ===========
 1218 
============ Function 21, subfunction 13, subsubfunction 1 ===========
1219 
======== Initialize + get information on the driver vmode.mdr. =======
 1219 
======== Initialize + get information on the driver vmode.mdr. =======
1220 
======================================================================
 1220 
======================================================================
1221 
Parameters:
 1221 
Parameters:
1222 
  * eax = 21 - function number
 1222 
  * eax = 21 - function number
1223 
  * ebx = 13 - subfunction number
 1223 
  * ebx = 13 - subfunction number
1224 
  * ecx = 1 - number of the driver function
 1224 
  * ecx = 1 - number of the driver function
1225 
  * edx = pointer to 512-bytes buffer
 1225 
  * edx = pointer to 512-bytes buffer
1226 
Returned value:
 1226 
Returned value:
1227 
  * if driver is not loaded
 1227 
  * if driver is not loaded
1228 
    (never happens in the current implementation):
 1228 
    (never happens in the current implementation):
1229 
    * eax = -1
 1229 
    * eax = -1
1230 
    * ebx, ecx destroyed
 1230 
    * ebx, ecx destroyed
1231 
  * if driver is loaded:
 1231 
  * if driver is loaded:
1232 
    * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high)
 1232 
    * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high)
1233 
      - signature
 1233 
      - signature
1234 
    * ebx = current frequency of the scanning (in Hz)
 1234 
    * ebx = current frequency of the scanning (in Hz)
1235 
    * ecx destroyed
 1235 
    * ecx destroyed
1236 
    * buffer pointed to by edx is filled
 1236 
    * buffer pointed to by edx is filled
1237 
Format of the buffer:
 1237 
Format of the buffer:
1238 
  * +0: 32*byte: driver name, "Trans VideoDriver"
 1238 
  * +0: 32*byte: driver name, "Trans VideoDriver"
1239 
    (without quotes, supplemented by spaces)
 1239 
    (without quotes, supplemented by spaces)
1240 
  * +32 = +0x20: dword: driver version (version x.y is encoded as
 1240 
  * +32 = +0x20: dword: driver version (version x.y is encoded as
1241 
    y*65536+x), for the current implementation is 1 (1.0)
 1241 
    y*65536+x), for the current implementation is 1 (1.0)
1242 
  * +36 = +0x24: 7*dword: reserved (0 in the current implementation)
 1242 
  * +36 = +0x24: 7*dword: reserved (0 in the current implementation)
1243 
  * +64 = +0x40: 32*word: list of supported videomodes (each word
 1243 
  * +64 = +0x40: 32*word: list of supported videomodes (each word
1244 
    is number of a videomode, after list itself there are zeroes)
 1244 
    is number of a videomode, after list itself there are zeroes)
1245 
  * +128 = +0x80: 32*(5*word): list of supported frequences of the
 1245 
  * +128 = +0x80: 32*(5*word): list of supported frequences of the
1246 
    scannings for videomodes: for each videomode listed in the
 1246 
    scannings for videomodes: for each videomode listed in the
1247 
    previous field up to 5 supported frequences are given
 1247 
    previous field up to 5 supported frequences are given
1248 
    (unused positions contain zeroes)
 1248 
    (unused positions contain zeroes)
1249 
Remarks:
 1249 
Remarks:
1250 
  * Function initializes the driver (if it is not initialized yet)
 1250 
  * Function initializes the driver (if it is not initialized yet)
1251 
    and must be called first, before others (otherwise they will do
 1251 
    and must be called first, before others (otherwise they will do
1252 
    nothing and return -1).
 1252 
    nothing and return -1).
1253 
  * The current implementation supports only one frequency
 1253 
  * The current implementation supports only one frequency
1254 
    of the scanning on videomode.
 1254 
    of the scanning on videomode.
1255 
 
 1255 
 
1256 
======================================================================
 1256 
======================================================================
1257 
============ Function 21, subfunction 13, subsubfunction 2 ===========
 1257 
============ Function 21, subfunction 13, subsubfunction 2 ===========
1258 
================ Get information on current videomode. ===============
 1258 
================ Get information on current videomode. ===============
1259 
======================================================================
 1259 
======================================================================
1260 
Parameters:
 1260 
Parameters:
1261 
  * eax = 21 - function number
 1261 
  * eax = 21 - function number
1262 
  * ebx = 13 - subfunction number
 1262 
  * ebx = 13 - subfunction number
1263 
  * ecx = 2 - number of the driver function
 1263 
  * ecx = 2 - number of the driver function
1264 
Returned value:
 1264 
Returned value:
1265 
  * eax = -1 - driver is not loaded or not initialized;
 1265 
  * eax = -1 - driver is not loaded or not initialized;
1266 
    ebx,ecx are destroyed
 1266 
    ebx,ecx are destroyed
1267 
  * eax = [width]*65536 + [height]
 1267 
  * eax = [width]*65536 + [height]
1268 
  * ebx = frequency of the vertical scanning (in Hz)
 1268 
  * ebx = frequency of the vertical scanning (in Hz)
1269 
  * ecx = number of current videomode
 1269 
  * ecx = number of current videomode
1270 
Remarks:
 1270 
Remarks:
1271 
  * Driver must be initialized by call to
 1271 
  * Driver must be initialized by call to
1272 
    driver function 1.
 1272 
    driver function 1.
1273 
  * If only screen sizes are required, it is more expedient to use
 1273 
  * If only screen sizes are required, it is more expedient to use
1274 
    function 14 taking into account that it
 1274 
    function 14 taking into account that it
1275 
    returns sizes on 1 less.
 1275 
    returns sizes on 1 less.
1276 
 
 1276 
 
1277 
======================================================================
 1277 
======================================================================
1278 
=== Function 21, subfunction 13, subsubfunction 3 - set videomode. ===
 1278 
=== Function 21, subfunction 13, subsubfunction 3 - set videomode. ===
1279 
======================================================================
 1279 
======================================================================
1280 
Parameters:
 1280 
Parameters:
1281 
  * eax = 21 - function number
 1281 
  * eax = 21 - function number
1282 
  * ebx = 13 - subfunction number
 1282 
  * ebx = 13 - subfunction number
1283 
  * ecx = 3 - number of the driver function
 1283 
  * ecx = 3 - number of the driver function
1284 
  * edx = [scanning frequency]*65536 + [videomode number]
 1284 
  * edx = [scanning frequency]*65536 + [videomode number]
1285 
Returned value:
 1285 
Returned value:
1286 
  * eax = -1 - driver is not loaded, not initialized or
 1286 
  * eax = -1 - driver is not loaded, not initialized or
1287 
    an error has occured
 1287 
    an error has occured
1288 
  * eax = 0 - success
 1288 
  * eax = 0 - success
1289 
  * ebx, ecx destroyed
 1289 
  * ebx, ecx destroyed
1290 
Remarks:
 1290 
Remarks:
1291 
  * Driver must be initialized by driver function 1.
 1291 
  * Driver must be initialized by driver function 1.
1292 
  * The videomode number and frequency must be in the table
 1292 
  * The videomode number and frequency must be in the table
1293 
    returned by driver function 1.
 1293 
    returned by driver function 1.
1294 
 
 1294 
 
1295 
======================================================================
 1295 
======================================================================
1296 
============ Function 21, subfunction 13, subsubfunction 4 ===========
 1296 
============ Function 21, subfunction 13, subsubfunction 4 ===========
1297 
================== Return to the initial videomode. ==================
 1297 
================== Return to the initial videomode. ==================
1298 
======================================================================
 1298 
======================================================================
1299 
Returns the screen to the videomode set at system boot.
 1299 
Returns the screen to the videomode set at system boot.
1300 
Parameters:
 1300 
Parameters:
1301 
  * eax = 21 - function number
 1301 
  * eax = 21 - function number
1302 
  * ebx = 13 - subfunction number
 1302 
  * ebx = 13 - subfunction number
1303 
  * ecx = 4 - number of the driver function
 1303 
  * ecx = 4 - number of the driver function
1304 
Returned value:
 1304 
Returned value:
1305 
  * eax = -1 - driver is not loaded or not initialized
 1305 
  * eax = -1 - driver is not loaded or not initialized
1306 
  * eax = 0 - success
 1306 
  * eax = 0 - success
1307 
  * ebx, ecx destroyed
 1307 
  * ebx, ecx destroyed
1308 
Remarks:
 1308 
Remarks:
1309 
  * Driver must be initialized by call to driver function 1.
 1309 
  * Driver must be initialized by call to driver function 1.
1310 
 
 1310 
 
1311 
======================================================================
 1311 
======================================================================
1312 
============ Function 21, subfunction 13, subsubfunction 5 ===========
 1312 
============ Function 21, subfunction 13, subsubfunction 5 ===========
1313 
===== Increase/decrease the size of the visible area of monitor. =====
 1313 
===== Increase/decrease the size of the visible area of monitor. =====
1314 
======================================================================
 1314 
======================================================================
1315 
Parameters:
 1315 
Parameters:
1316 
  * eax = 21 - function number
 1316 
  * eax = 21 - function number
1317 
  * ebx = 13 - subfunction number
 1317 
  * ebx = 13 - subfunction number
1318 
  * ecx = 5 - number of the driver function
 1318 
  * ecx = 5 - number of the driver function
1319 
  * edx = 0/1 - decrease/increase horizontal size on 1 position
 1319 
  * edx = 0/1 - decrease/increase horizontal size on 1 position
1320 
  * edx = 2/3 - is not supported in the current implementation;
 1320 
  * edx = 2/3 - is not supported in the current implementation;
1321 
    is planned as decrease/increase vertical size on 1 position
 1321 
    is planned as decrease/increase vertical size on 1 position
1322 
Returned value:
 1322 
Returned value:
1323 
  * eax = -1 - driver is not loaded or not initialized
 1323 
  * eax = -1 - driver is not loaded or not initialized
1324 
  * eax = 0 - success
 1324 
  * eax = 0 - success
1325 
  * ebx, ecx destroyed
 1325 
  * ebx, ecx destroyed
1326 
Remarks:
 1326 
Remarks:
1327 
  * Driver must be initialized by call to driver function 1.
 1327 
  * Driver must be initialized by call to driver function 1.
1328 
  * Function influences only the physical size of the screen image;
 1328 
  * Function influences only the physical size of the screen image;
1329 
    the logical size (number of pixels) does not change.
 1329 
    the logical size (number of pixels) does not change.
1330 
 
 1330 
 
1331 
======================================================================
 1331 
======================================================================
1332 
================= Function 22 - set system date/time. ================
 1332 
================= Function 22 - set system date/time. ================
1333 
======================================================================
 1333 
======================================================================
1334 
Parameters:
 1334 
Parameters:
1335 
  * eax = 22 - function number
 1335 
  * eax = 22 - function number
1336 
  * ebx = 0 - set time
 1336 
  * ebx = 0 - set time
1337 
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
 1337 
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
1338 
    * HH=hour 00..23
 1338 
    * HH=hour 00..23
1339 
    * MM=minute 00..59
 1339 
    * MM=minute 00..59
1340 
    * SS=second 00..59
 1340 
    * SS=second 00..59
1341 
  * ebx = 1 - set date
 1341 
  * ebx = 1 - set date
1342 
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
 1342 
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
1343 
    * DD=day 01..31
 1343 
    * DD=day 01..31
1344 
    * MM=month 01..12
 1344 
    * MM=month 01..12
1345 
    * YY=year 00..99
 1345 
    * YY=year 00..99
1346 
  * ebx = 2 - set day of week
 1346 
  * ebx = 2 - set day of week
1347 
    * ecx = 1 for Sunday, ..., 7 for Saturday
 1347 
    * ecx = 1 for Sunday, ..., 7 for Saturday
1348 
  * ebx = 3 - set alarm clock
 1348 
  * ebx = 3 - set alarm clock
1349 
    * ecx = 0x00SSMMHH
 1349 
    * ecx = 0x00SSMMHH
1350 
Returned value:
 1350 
Returned value:
1351 
  * eax = 0 - success
 1351 
  * eax = 0 - success
1352 
  * eax = 1 - incorrect parameter
 1352 
  * eax = 1 - incorrect parameter
1353 
  * eax = 2 - CMOS-battery was unloaded
 1353 
  * eax = 2 - CMOS-battery was unloaded
1354 
Remarks:
 1354 
Remarks:
1355 
  * Value of installation of day of week seems to be doubtful,
 1355 
  * Value of installation of day of week seems to be doubtful,
1356 
    as it a little where is used
 1356 
    as it a little where is used
1357 
    (day of week can be calculated by date).
 1357 
    (day of week can be calculated by date).
1358 
  * Alarm clock can be set on operation in the given time every day.
 1358 
  * Alarm clock can be set on operation in the given time every day.
1359 
    But there is no existing system function to disable it.
 1359 
    But there is no existing system function to disable it.
1360 
  * Operation of alarm clock consists in generation IRQ8.
 1360 
  * Operation of alarm clock consists in generation IRQ8.
1361 
  * Generally CMOS supports for alarm clock set of value 0xFF
 1361 
  * Generally CMOS supports for alarm clock set of value 0xFF
1362 
    as one of parameters and it means that the appropriate parameter
 1362 
    as one of parameters and it means that the appropriate parameter
1363 
    is ignored. But current implementation does not allow this
 1363 
    is ignored. But current implementation does not allow this
1364 
    (will return 1).
 1364 
    (will return 1).
1365 
  * Alarm clock is a global system resource; the set of
 1365 
  * Alarm clock is a global system resource; the set of
1366 
    an alarm clock cancels automatically the previous set.
 1366 
    an alarm clock cancels automatically the previous set.
1367 
    However, at moment no program uses it.
 1367 
    However, at moment no program uses it.
1368 
 
 1368 
 
1369 
======================================================================
 1369 
======================================================================
1370 
============= Function 23 - wait for event with timeout. =============
 1370 
============= Function 23 - wait for event with timeout. =============
1371 
======================================================================
 1371 
======================================================================
1372 
If the message queue is empty, waits for new message in the queue,
 1372 
If the message queue is empty, waits for new message in the queue,
1373 
but no more than given time. Then reads out a message from the queue.
 1373 
but no more than given time. Then reads out a message from the queue.
1374 
 
 1374 
 
1375 
Parameters:
 1375 
Parameters:
1376 
  * eax = 23 - function number
 1376 
  * eax = 23 - function number
1377 
  * ebx = timeout (in 1/100 of second)
 1377 
  * ebx = timeout (in 1/100 of second)
1378 
Returned value:
 1378 
Returned value:
1379 
  * eax = 0 - the message queue is empty
 1379 
  * eax = 0 - the message queue is empty
1380 
  * otherwise eax = event (see the list of events)
 1380 
  * otherwise eax = event (see the list of events)
1381 
Remarks:
 1381 
Remarks:
1382 
  * Only those events are taken into account, which enter into
 1382 
  * Only those events are taken into account, which enter into
1383 
    the mask set by function 40. By default it is
 1383 
    the mask set by function 40. By default it is
1384 
    redraw, key and button events.
 1384 
    redraw, key and button events.
1385 
  * To check for presence of a message in the queue use function 11.
 1385 
  * To check for presence of a message in the queue use function 11.
1386 
    To wait without timeout use function 10.
 1386 
    To wait without timeout use function 10.
1387 
  * Transmission ebx=0 results in immediate returning eax=0.
 1387 
  * Transmission ebx=0 results in immediate returning eax=0.
1388 
  * Current implementation returns immediately with eax=0,
 1388 
  * Current implementation returns immediately with eax=0,
1389 
    if the addition of ebx with the current value of time counter
 1389 
    if the addition of ebx with the current value of time counter
1390 
    makes 32-bit overflow.
 1390 
    makes 32-bit overflow.
1391 
 
 1391 
 
1392 
======================================================================
 1392 
======================================================================
1393 
======== Function 24, subfunction 1 - begin to play CD-audio. ========
 1393 
======== Function 24, subfunction 1 - begin to play CD-audio. ========
1394 
======================================================================
 1394 
======================================================================
1395 
Parameters:
 1395 
Parameters:
1396 
  * eax = 24 - function number
 1396 
  * eax = 24 - function number
1397 
  * ebx = 1 - subfunction number
 1397 
  * ebx = 1 - subfunction number
1398 
  * ecx = 0x00FRSSMM, where
 1398 
  * ecx = 0x00FRSSMM, where
1399 
    * MM = starting minute
 1399 
    * MM = starting minute
1400 
    * SS = starting second
 1400 
    * SS = starting second
1401 
    * FR = starting frame
 1401 
    * FR = starting frame
1402 
Returned value:
 1402 
Returned value:
1403 
  * eax = 0 - success
 1403 
  * eax = 0 - success
1404 
  * eax = 1 - CD base is not defined
 1404 
  * eax = 1 - CD base is not defined
1405 
Remarks:
 1405 
Remarks:
1406 
  * Previously CD base must be defined by the call to
 1406 
  * Previously CD base must be defined by the call to
1407 
    subfunction 3 of function 21.
 1407 
    subfunction 3 of function 21.
1408 
  * One second includes 75 frames, one minute includes 60 seconds.
 1408 
  * One second includes 75 frames, one minute includes 60 seconds.
1409 
  * The function is asynchronous (returns control, when play begins).
 1409 
  * The function is asynchronous (returns control, when play begins).
1410 
 
 1410 
 
1411 
======================================================================
 1411 
======================================================================
1412 
======= Function 24, subfunction 2 - get information on tracks. ======
 1412 
======= Function 24, subfunction 2 - get information on tracks. ======
1413 
======================================================================
 1413 
======================================================================
1414 
Parameters:
 1414 
Parameters:
1415 
  * eax = 24 - function number
 1415 
  * eax = 24 - function number
1416 
  * ebx = 2 - subfunction number
 1416 
  * ebx = 2 - subfunction number
1417 
  * ecx = pointer to the buffer for the table
 1417 
  * ecx = pointer to the buffer for the table
1418 
    (maximum 8*64h+4 bytes=100 tracks)
 1418 
    (maximum 8*64h+4 bytes=100 tracks)
1419 
Returned value:
 1419 
Returned value:
1420 
  * eax = 0 - success
 1420 
  * eax = 0 - success
1421 
  * eax = 1 - CD base is not defined
 1421 
  * eax = 1 - CD base is not defined
1422 
Remarks:
 1422 
Remarks:
1423 
  * The format of the table with tracks information is the same as
 1423 
  * The format of the table with tracks information is the same as
1424 
    for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h).
 1424 
    for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h).
1425 
    Function returns addresses in MSF.
 1425 
    Function returns addresses in MSF.
1426 
  * Previously CD base port must be set by call to
 1426 
  * Previously CD base port must be set by call to
1427 
    subfunction 3 of function 21.
 1427 
    subfunction 3 of function 21.
1428 
  * Function returns information only about no more than 100
 1428 
  * Function returns information only about no more than 100
1429 
    first tracks. In most cases it is enough.
 1429 
    first tracks. In most cases it is enough.
1430 
 
 1430 
 
1431 
======================================================================
 1431 
======================================================================
1432 
========== Function 24, subfunction 3 - stop play CD-audio. ==========
 1432 
========== Function 24, subfunction 3 - stop play CD-audio. ==========
1433 
======================================================================
 1433 
======================================================================
1434 
Parameters:
 1434 
Parameters:
1435 
  * eax = 24 - function number
 1435 
  * eax = 24 - function number
1436 
  * ebx = 1 - subfunction number
 1436 
  * ebx = 1 - subfunction number
1437 
Returned value:
 1437 
Returned value:
1438 
  * eax = 0 - success
 1438 
  * eax = 0 - success
1439 
  * eax = 1 - CD base is not defined
 1439 
  * eax = 1 - CD base is not defined
1440 
Remarks:
 1440 
Remarks:
1441 
  * Previously CD base port must be defined by call to
 1441 
  * Previously CD base port must be defined by call to
1442 
    subfunction 3 of function 21.
 1442 
    subfunction 3 of function 21.
1443 
 
 1443 
 
1444 
======================================================================
 1444 
======================================================================
1445 
======= Function 24, subfunction 4 - eject tray of disk drive. =======
 1445 
======= Function 24, subfunction 4 - eject tray of disk drive. =======
1446 
======================================================================
 1446 
======================================================================
1447 
Parameters:
 1447 
Parameters:
1448 
  * eax = 24 - function number
 1448 
  * eax = 24 - function number
1449 
  * ebx = 4 - subfunction number
 1449 
  * ebx = 4 - subfunction number
1450 
  * ecx = position of CD/DVD-drive
 1450 
  * ecx = position of CD/DVD-drive
1451 
      (from 0=Primary Master to 3=Secondary Slave)
 1451 
      (from 0=Primary Master to 3=Secondary Slave)
1452 
Returned value:
 1452 
Returned value:
1453 
  * function does not return value
 1453 
  * function does not return value
1454 
Remarks:
 1454 
Remarks:
1455 
  * The function is supported only for ATAPI devices (CD and DVD).
 1455 
  * The function is supported only for ATAPI devices (CD and DVD).
1456 
  * When the tray is being ejected,
 1456 
  * When the tray is being ejected,
1457 
    manual control of tray is unlocked.
 1457 
    manual control of tray is unlocked.
1458 
  * When the tray is being ejected, the code clears the cache for
 1458 
  * When the tray is being ejected, the code clears the cache for
1459 
    corresponding device.
 1459 
    corresponding device.
1460 
  * An example of usage of the function is the application CD_tray.
 1460 
  * An example of usage of the function is the application CD_tray.
1461 
 
 1461 
 
1462 
======================================================================
 1462 
======================================================================
1463 
======== Function 24, subfunction 5 - load tray of disk drive. =======
 1463 
======== Function 24, subfunction 5 - load tray of disk drive. =======
1464 
======================================================================
 1464 
======================================================================
1465 
Parameters:
 1465 
Parameters:
1466 
  * eax = 24 - function number
 1466 
  * eax = 24 - function number
1467 
  * ebx = 5 - subfunction number
 1467 
  * ebx = 5 - subfunction number
1468 
  * ecx = position of CD/DVD-drive
 1468 
  * ecx = position of CD/DVD-drive
1469 
      (from 0=Primary Master to 3=Secondary Slave)
 1469 
      (from 0=Primary Master to 3=Secondary Slave)
1470 
Returned value:
 1470 
Returned value:
1471 
  * function does not return value
 1471 
  * function does not return value
1472 
Remarks:
 1472 
Remarks:
1473 
  * The function is supported only for ATAPI devices (CD and DVD).
 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.
 1474 
  * An example of usage of the function is the application CD_tray.
1475 
 
 1475 
 
1476 
======================================================================
 1476 
======================================================================
1477 
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
 1477 
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
1478 
======================================================================
 1478 
======================================================================
1479 
Parameters:
 1479 
Parameters:
1480 
  * eax = 26 - function number
 1480 
  * eax = 26 - function number
1481 
  * ebx = 1 - subfunction number
 1481 
  * ebx = 1 - subfunction number
1482 
Returned value:
 1482 
Returned value:
1483 
  * eax = port number
 1483 
  * eax = port number
1484 
Parameters:
 1484 
Parameters:
1485 
  * To set base port use subfunction 1 of function 21.
 1485 
  * To set base port use subfunction 1 of function 21.
1486 
 
 1486 
 
1487 
======================================================================
 1487 
======================================================================
1488 
========== Function 26, subfunction 2 - get keyboard layout. =========
 1488 
========== Function 26, subfunction 2 - get keyboard layout. =========
1489 
======================================================================
 1489 
======================================================================
1490 
The keyboard layout is used to convert keyboard scancodes to
 1490 
The keyboard layout is used to convert keyboard scancodes to
1491 
ASCII-codes for function 2.
 1491 
ASCII-codes for function 2.
1492 
Parameters:
 1492 
Parameters:
1493 
  * eax = 26 - function number
 1493 
  * eax = 26 - function number
1494 
  * ebx = 2 - subfunction number
 1494 
  * ebx = 2 - subfunction number
1495 
  * ecx = what layout to get:
 1495 
  * ecx = what layout to get:
1496 
    * 1 = normal layout
 1496 
    * 1 = normal layout
1497 
    * 2 = layout with pressed Shift
 1497 
    * 2 = layout with pressed Shift
1498 
    * 3 = layout with pressed Alt
 1498 
    * 3 = layout with pressed Alt
1499 
  * edx = pointer to the 128-bytes buffer, where the layout will be
 1499 
  * edx = pointer to the 128-bytes buffer, where the layout will be
1500 
    copied
 1500 
    copied
1501 
Returned value:
 1501 
Returned value:
1502 
  * function does not return value
 1502 
  * function does not return value
1503 
Or:
 1503 
Or:
1504 
  * eax = 26 - function number
 1504 
  * eax = 26 - function number
1505 
  * ebx = 2 - subfunction number
 1505 
  * ebx = 2 - subfunction number
1506 
  * ecx = 9
 1506 
  * ecx = 9
1507 
Returned value:
 1507 
Returned value:
1508 
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
 1508 
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1509 
Remarks:
 1509 
Remarks:
1510 
  * If Alt is pressed, the layout with Alt is used;
 1510 
  * If Alt is pressed, the layout with Alt is used;
1511 
    if Alt is not pressed, but Shift is pressed,
 1511 
    if Alt is not pressed, but Shift is pressed,
1512 
    the layout with Shift is used;
 1512 
    the layout with Shift is used;
1513 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
 1513 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1514 
    layout is used and then from the code is subtracted 0x60;
 1514 
    layout is used and then from the code is subtracted 0x60;
1515 
    if no control key is pressed, the normal layout is used.
 1515 
    if no control key is pressed, the normal layout is used.
1516 
  * To set layout and country identifier use
 1516 
  * To set layout and country identifier use
1517 
    subfunction 2 of function 21.
 1517 
    subfunction 2 of function 21.
1518 
  * Country identifier is global system variable, which is not used
 1518 
  * Country identifier is global system variable, which is not used
1519 
    by the kernel itself; however the application '@panel' displays
 1519 
    by the kernel itself; however the application '@panel' displays
1520 
    the corresponding icon (using this function).
 1520 
    the corresponding icon (using this function).
1521 
  * The application @panel switches layouts on user request.
 1521 
  * The application @panel switches layouts on user request.
1522 
 
 1522 
 
1523 
======================================================================
 1523 
======================================================================
1524 
============== Function 26, subfunction 3 - get CD base. =============
 1524 
============== Function 26, subfunction 3 - get CD base. =============
1525 
======================================================================
 1525 
======================================================================
1526 
Parameters:
 1526 
Parameters:
1527 
  * eax = 26 - function number
 1527 
  * eax = 26 - function number
1528 
  * ebx = 3 - subfunction number
 1528 
  * ebx = 3 - subfunction number
1529 
Returned value:
 1529 
Returned value:
1530 
  * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1530 
  * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1531 
Remarks:
 1531 
Remarks:
1532 
  * CD base is used by function 24.
 1532 
  * CD base is used by function 24.
1533 
  * To set CD base use subfunction 3 of function 21.
 1533 
  * To set CD base use subfunction 3 of function 21.
1534 
 
 1534 
 
1535 
======================================================================
 1535 
======================================================================
1536 
========== Function 26, subfunction 5 - get system language. =========
 1536 
========== Function 26, subfunction 5 - get system language. =========
1537 
======================================================================
 1537 
======================================================================
1538 
Parameters:
 1538 
Parameters:
1539 
  * eax = 26 - function number
 1539 
  * eax = 26 - function number
1540 
  * ebx = 5 - subfunction number
 1540 
  * ebx = 5 - subfunction number
1541 
Returned value:
 1541 
Returned value:
1542 
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
 1542 
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
1543 
Remarks:
 1543 
Remarks:
1544 
  * System language is global system variable and is not used
 1544 
  * System language is global system variable and is not used
1545 
    by the kernel itself, however application @panel draws the
 1545 
    by the kernel itself, however application @panel draws the
1546 
    appropriate icon (using this function).
 1546 
    appropriate icon (using this function).
1547 
  * To set system language use subfunction 5 of function 21.
 1547 
  * To set system language use subfunction 5 of function 21.
1548 
 
 1548 
 
1549 
======================================================================
 1549 
======================================================================
1550 
============== Function 26, subfunction 7 - get HD base. =============
 1550 
============== Function 26, subfunction 7 - get HD base. =============
1551 
======================================================================
 1551 
======================================================================
1552 
The HD base defines hard disk to write with usage of obsolete
 1552 
The HD base defines hard disk to write with usage of obsolete
1553 
syntax /HD in obsolete function 58; at usage of modern syntax
 1553 
syntax /HD in obsolete function 58; at usage of modern syntax
1554 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
 1554 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1555 
Parameters:
 1555 
Parameters:
1556 
  * eax = 26 - function number
 1556 
  * eax = 26 - function number
1557 
  * ebx = 7 - subfunction number
 1557 
  * ebx = 7 - subfunction number
1558 
Returned value:
 1558 
Returned value:
1559 
  * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1559 
  * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1560 
Remarks:
 1560 
Remarks:
1561 
  * Any application in any time can change HD base.
 1561 
  * Any application in any time can change HD base.
1562 
  * To set base use subfunction 7 of function 21.
 1562 
  * To set base use subfunction 7 of function 21.
1563 
  * To get used partition of hard disk use subfunction 8.
 1563 
  * To get used partition of hard disk use subfunction 8.
1564 
 
 1564 
 
1565 
======================================================================
 1565 
======================================================================
1566 
========= Function 26, subfunction 8 - get used HD partition. ========
 1566 
========= Function 26, subfunction 8 - get used HD partition. ========
1567 
======================================================================
 1567 
======================================================================
1568 
The HD partition defines partition of the hard disk to write with
 1568 
The HD partition defines partition of the hard disk to write with
1569 
usage of obsolete syntax /HD in obsolete function 58;
 1569 
usage of obsolete syntax /HD in obsolete function 58;
1570 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
 1570 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1571 
base and partition are set automatically.
 1571 
base and partition are set automatically.
1572 
Parameters:
 1572 
Parameters:
1573 
  * eax = 26 - function number
 1573 
  * eax = 26 - function number
1574 
  * ebx = 8 - subfunction number
 1574 
  * ebx = 8 - subfunction number
1575 
Returned value:
 1575 
Returned value:
1576 
  * eax = HD partition (beginning from 1)
 1576 
  * eax = HD partition (beginning from 1)
1577 
Remarks:
 1577 
Remarks:
1578 
  * Any application in any time can change partition.
 1578 
  * Any application in any time can change partition.
1579 
  * To set partition use subfunction 8 of function 21.
 1579 
  * To set partition use subfunction 8 of function 21.
1580 
  * To get number of partitions on a hard disk use
 1580 
  * To get number of partitions on a hard disk use
1581 
    subfunction 11 of function 18.
 1581 
    subfunction 11 of function 18.
1582 
  * To get base of used hard disk, use subfunction 7.
 1582 
  * To get base of used hard disk, use subfunction 7.
1583 
 
 1583 
 
1584 
======================================================================
 1584 
======================================================================
1585 
=== Function 26, subfunction 9 - get the value of the time counter. ==
 1585 
=== Function 26, subfunction 9 - get the value of the time counter. ==
1586 
======================================================================
 1586 
======================================================================
1587 
Parameters:
 1587 
Parameters:
1588 
  * eax = 26 - function number
 1588 
  * eax = 26 - function number
1589 
  * ebx = 9 - subfunction number
 1589 
  * ebx = 9 - subfunction number
1590 
Returned value:
 1590 
Returned value:
1591 
  * eax = number of 1/100s of second, past from the system boot time
 1591 
  * eax = number of 1/100s of second, past from the system boot time
1592 
Remarks:
 1592 
Remarks:
1593 
  * Counter takes modulo 2^32, that correspond to a little more
 1593 
  * Counter takes modulo 2^32, that correspond to a little more
1594 
    than 497 days.
 1594 
    than 497 days.
1595 
  * To get system time use function 3.
 1595 
  * To get system time use function 3.
1596 
 
 1596 
 
1597 
======================================================================
 1597 
======================================================================
1598 
===================== Function 26, subfunction 11 ====================
 1598 
===================== Function 26, subfunction 11 ====================
1599 
========== Find out whether low-level HD access is enabled. ==========
 1599 
========== Find out whether low-level HD access is enabled. ==========
1600 
======================================================================
 1600 
======================================================================
1601 
Parameters:
 1601 
Parameters:
1602 
  * eax = 26 - function number
 1602 
  * eax = 26 - function number
1603 
  * ebx = 11 - subfunction number
 1603 
  * ebx = 11 - subfunction number
1604 
Returned value:
 1604 
Returned value:
1605 
  * eax = 0/1 - disabled/enabled
 1605 
  * eax = 0/1 - disabled/enabled
1606 
Remarks:
 1606 
Remarks:
1607 
  * Is used in LBA read (subfunction 8 of function 58).
 1607 
  * Is used in LBA read (subfunction 8 of function 58).
1608 
  * To set current state use subfunction 11 of function 21.
 1608 
  * To set current state use subfunction 11 of function 21.
1609 
 
 1609 
 
1610 
======================================================================
 1610 
======================================================================
1611 
===================== Function 26, subfunction 12 ====================
 1611 
===================== Function 26, subfunction 12 ====================
1612 
========== Find out whether low-level PCI access is enabled. =========
 1612 
========== Find out whether low-level PCI access is enabled. =========
1613 
======================================================================
 1613 
======================================================================
1614 
Parameters:
 1614 
Parameters:
1615 
  * eax = 26 - function number
 1615 
  * eax = 26 - function number
1616 
  * ebx = 12 - subfunction number
 1616 
  * ebx = 12 - subfunction number
1617 
Returned value:
 1617 
Returned value:
1618 
  * eax = 0/1 - disabled/enabled
 1618 
  * eax = 0/1 - disabled/enabled
1619 
Remarks:
 1619 
Remarks:
1620 
  * Is used by operations with PCI bus (function 62).
 1620 
  * Is used by operations with PCI bus (function 62).
1621 
  * The current implementation uses only low bit of ecx.
 1621 
  * The current implementation uses only low bit of ecx.
1622 
  * To set the current state use subfunction 12 of function 21.
 1622 
  * To set the current state use subfunction 12 of function 21.
1623 
 
 1623 
 
1624 
======================================================================
 1624 
======================================================================
1625 
=================== Function 29 - get system date. ===================
 1625 
=================== Function 29 - get system date. ===================
1626 
======================================================================
 1626 
======================================================================
1627 
Parameters:
 1627 
Parameters:
1628 
  * eax = 29 - function number
 1628 
  * eax = 29 - function number
1629 
Returned value:
 1629 
Returned value:
1630 
  * eax = 0x00DDMMYY, where
 1630 
  * eax = 0x00DDMMYY, where
1631 
    (binary-decimal coding, BCD, is used)
 1631 
    (binary-decimal coding, BCD, is used)
1632 
  * YY = two low digits of year (00..99)
 1632 
  * YY = two low digits of year (00..99)
1633 
  * MM = month (01..12)
 1633 
  * MM = month (01..12)
1634 
  * DD = day (01..31)
 1634 
  * DD = day (01..31)
1635 
Remarks:
 1635 
Remarks:
1636 
  * To set system date use function 22.
 1636 
  * To set system date use function 22.
1637 
 
 1637 
 
1638 
======================================================================
 1638 
======================================================================
1639 
============= Function 30 - work with the current folder. ============
 1639 
============= Function 30 - work with the current folder. ============
1640 
======================================================================
 1640 
======================================================================
1641 
 
 1641 
 
1642 
--------- Subfunction 1 - set current folder for the thread. ---------
 1642 
--------- Subfunction 1 - set current folder for the thread. ---------
1643 
Parameters:
 1643 
Parameters:
1644 
  * eax = 30 - function number
 1644 
  * eax = 30 - function number
1645 
  * ebx = 1 - subfunction number
 1645 
  * ebx = 1 - subfunction number
1646 
  * ecx = pointer to ASCIIZ-string with the path to new current folder
 1646 
  * ecx = pointer to ASCIIZ-string with the path to new current folder
1647 
Returned value:
 1647 
Returned value:
1648 
  * function does not return value
 1648 
  * function does not return value
1649 
 
 1649 
 
1650 
--------- Subfunction 2 - get current folder for the thread. ---------
 1650 
--------- Subfunction 2 - get current folder for the thread. ---------
1651 
Parameters:
 1651 
Parameters:
1652 
  * eax = 30 - function number
 1652 
  * eax = 30 - function number
1653 
  * ebx = 2 - subfunction number
 1653 
  * ebx = 2 - subfunction number
1654 
  * ecx = pointer to buffer
 1654 
  * ecx = pointer to buffer
1655 
  * edx = size of buffer
 1655 
  * edx = size of buffer
1656 
Returned value:
 1656 
Returned value:
1657 
  * eax = size of the current folder's name (including terminating 0)
 1657 
  * eax = size of the current folder's name (including terminating 0)
1658 
Remarks:
 1658 
Remarks:
1659 
  * If the buffer is too small to hold all data, only first (edx-1)
 1659 
  * If the buffer is too small to hold all data, only first (edx-1)
1660 
    bytes are copied and than terminating 0 is inserted.
 1660 
    bytes are copied and than terminating 0 is inserted.
1661 
 
 1661 
 
1662 
======================================================================
 1662 
======================================================================
1663 
=============== Function 32 - delete file from ramdisk. ==============
 1663 
=============== Function 32 - delete file from ramdisk. ==============
1664 
======================================================================
 1664 
======================================================================
1665 
Parameters:
 1665 
Parameters:
1666 
  * eax = 32 - function number
 1666 
  * eax = 32 - function number
1667 
  * ebx = pointer to the filename
 1667 
  * ebx = pointer to the filename
1668 
Returned value:
 1668 
Returned value:
1669 
  * eax = 0 - success; otherwise file system error code
 1669 
  * eax = 0 - success; otherwise file system error code
1670 
Remarks:
 1670 
Remarks:
1671 
  * This function is obsolete; function 58 allows to fulfill
 1671 
  * This function is obsolete; function 58 allows to fulfill
1672 
    the same operations with the extended possibilities.
 1672 
    the same operations with the extended possibilities.
1673 
  * The current implementation returns only values 0(success) and
 1673 
  * The current implementation returns only values 0(success) and
1674 
    5(file not found).
 1674 
    5(file not found).
1675 
  * The filename must be either in the format 8+3 characters
 1675 
  * The filename must be either in the format 8+3 characters
1676 
    (first 8 characters - name itself, last 3 - extension,
 1676 
    (first 8 characters - name itself, last 3 - extension,
1677 
    the short names and extensions are supplemented with spaces),
 1677 
    the short names and extensions are supplemented with spaces),
1678 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
 1678 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
1679 
    (name no more than 8 characters, dot, extension 3 characters
 1679 
    (name no more than 8 characters, dot, extension 3 characters
1680 
    supplemented if necessary by spaces).
 1680 
    supplemented if necessary by spaces).
1681 
    The filename must be written with capital letters. The terminating
 1681 
    The filename must be written with capital letters. The terminating
1682 
    character with code 0 is not necessary (not ASCIIZ-string).
 1682 
    character with code 0 is not necessary (not ASCIIZ-string).
1683 
  * This function does not support folders on the ramdisk.
 1683 
  * This function does not support folders on the ramdisk.
1684 
 
 1684 
 
1685 
======================================================================
 1685 
======================================================================
1686 
================ Function 33 - write file to ramdisk. ================
 1686 
================ Function 33 - write file to ramdisk. ================
1687 
======================================================================
 1687 
======================================================================
1688 
Parameters:
 1688 
Parameters:
1689 
  * eax = 33 - function number
 1689 
  * eax = 33 - function number
1690 
  * ebx = pointer to the filename
 1690 
  * ebx = pointer to the filename
1691 
  * ecx = pointer to data for writing
 1691 
  * ecx = pointer to data for writing
1692 
  * edx = number of bytes for writing
 1692 
  * edx = number of bytes for writing
1693 
  * should be set esi=0
 1693 
  * should be set esi=0
1694 
Returned value:
 1694 
Returned value:
1695 
  * eax = 0 - success, otherwise file system error code
 1695 
  * eax = 0 - success, otherwise file system error code
1696 
Remarks:
 1696 
Remarks:
1697 
  * This function is obsolete; function 70 allows to fulfil
 1697 
  * This function is obsolete; function 70 allows to fulfil
1698 
    the same operations with extended possibilities.
 1698 
    the same operations with extended possibilities.
1699 
  * If esi contains non-zero value and selected file already exists,
 1699 
  * If esi contains non-zero value and selected file already exists,
1700 
    one more file with the same name will be created.
 1700 
    one more file with the same name will be created.
1701 
  * Otherwise file will be overwritten.
 1701 
  * Otherwise file will be overwritten.
1702 
  * The filename must be either in the format 8+3 characters
 1702 
  * The filename must be either in the format 8+3 characters
1703 
    (first 8 characters - name itself, last 3 - extension,
 1703 
    (first 8 characters - name itself, last 3 - extension,
1704 
    the short names and extensions are supplemented with spaces),
 1704 
    the short names and extensions are supplemented with spaces),
1705 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
 1705 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
1706 
    (name no more than 8 characters, dot, extension 3 characters
 1706 
    (name no more than 8 characters, dot, extension 3 characters
1707 
    supplemented if necessary by spaces).
 1707 
    supplemented if necessary by spaces).
1708 
    The filename must be written with capital letters. The terminating
 1708 
    The filename must be written with capital letters. The terminating
1709 
    character with code 0 is not necessary (not ASCIIZ-string).
 1709 
    character with code 0 is not necessary (not ASCIIZ-string).
1710 
  * This function does not support folders on the ramdisk.
 1710 
  * This function does not support folders on the ramdisk.
1711 
 
 1711 
 
1712 
======================================================================
 1712 
======================================================================
1713 
======= Function 35 - read the color of a pixel on the screen. =======
 1713 
======= Function 35 - read the color of a pixel on the screen. =======
1714 
======================================================================
 1714 
======================================================================
1715 
Parameters:
 1715 
Parameters:
1716 
  * eax = 35
 1716 
  * eax = 35
1717 
  * ebx = y*xsize+x, where
 1717 
  * ebx = y*xsize+x, where
1718 
  * (x,y) = coordinates of a pixel (beginning from 0)
 1718 
  * (x,y) = coordinates of a pixel (beginning from 0)
1719 
  * xsize = horizontal screen size
 1719 
  * xsize = horizontal screen size
1720 
Returned value:
 1720 
Returned value:
1721 
  * eax = color 0x00RRGGBB
 1721 
  * eax = color 0x00RRGGBB
1722 
Remarks:
 1722 
Remarks:
1723 
  * To get screen sizes use function 14. Pay attention,
 1723 
  * To get screen sizes use function 14. Pay attention,
1724 
    that it subtracts 1 from both sizes.
 1724 
    that it subtracts 1 from both sizes.
1725 
  * There is also direct access (without any system calls)
 1725 
  * There is also direct access (without any system calls)
1726 
    to videomemory through the selector gs. To get parameters of
 1726 
    to videomemory through the selector gs. To get parameters of
1727 
    the current videomode, use function 61.
 1727 
    the current videomode, use function 61.
1728 
 
 1728 
 
1729 
======================================================================
 1729 
======================================================================
1730 
=================== Function 36 - read screen area. ==================
 1730 
=================== Function 36 - read screen area. ==================
1731 
======================================================================
 1731 
======================================================================
1732 
Paramters:
 1732 
Paramters:
1733 
  * eax = 36 - function number
 1733 
  * eax = 36 - function number
1734 
  * ebx = pointer to the previously allocated memory area,
 1734 
  * ebx = pointer to the previously allocated memory area,
1735 
        where will be placed the image in the format BBGGRRBBGGRR...
 1735 
        where will be placed the image in the format BBGGRRBBGGRR...
1736 
  * ecx = [size on axis x]*65536 + [size on axis y]
 1736 
  * ecx = [size on axis x]*65536 + [size on axis y]
1737 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 1737 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1738 
Returned value:
 1738 
Returned value:
1739 
  * function does not return value
 1739 
  * function does not return value
1740 
Remarks:
 1740 
Remarks:
1741 
  * Coordinates of the image are coordinates of the upper left corner
 1741 
  * Coordinates of the image are coordinates of the upper left corner
1742 
    of the image relative to the screen.
 1742 
    of the image relative to the screen.
1743 
  * Size of the image in bytes is 3*xsize*ysize.
 1743 
  * Size of the image in bytes is 3*xsize*ysize.
1744 
 
 1744 
 
1745 
======================================================================
 1745 
======================================================================
1746 
=================== Function 37 - work with mouse. ===================
 1746 
=================== Function 37 - work with mouse. ===================
1747 
======================================================================
 1747 
======================================================================
1748 
 
 1748 
 
1749 
---------- Subfunction 0 - screen coordinates of the mouse -----------
 1749 
---------- Subfunction 0 - screen coordinates of the mouse -----------
1750 
Parameters:
 1750 
Parameters:
1751 
  * eax = 37 - function number
 1751 
  * eax = 37 - function number
1752 
  * ebx = 0 - subfunction number
 1752 
  * ebx = 0 - subfunction number
1753 
Returned value:
 1753 
Returned value:
1754 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
 1754 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1755 
    (beginning from 0)
 1755 
    (beginning from 0)
1756 
 
 1756 
 
1757 
-- Subfunction 1 - coordinates of the mouse relative to the window ---
 1757 
-- Subfunction 1 - coordinates of the mouse relative to the window ---
1758 
Parameters:
 1758 
Parameters:
1759 
  * eax = 37 - function number
 1759 
  * eax = 37 - function number
1760 
  * ebx = 1 - subfunction number
 1760 
  * ebx = 1 - subfunction number
1761 
Returned value:
 1761 
Returned value:
1762 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
 1762 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1763 
    relative to the application window (beginning from 0)
 1763 
    relative to the application window (beginning from 0)
1764 
Remarks:
 1764 
Remarks:
1765 
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
 1765 
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
1766 
    If y>=ywnd, the low word is non-negative and contains
 1766 
    If y>=ywnd, the low word is non-negative and contains
1767 
    relative y-coordinate, and the high word - relative x-coordinate
 1767 
    relative y-coordinate, and the high word - relative x-coordinate
1768 
    (with correct sign). Otherwise the low word is negative and still
 1768 
    (with correct sign). Otherwise the low word is negative and still
1769 
    contains relative y-coordinate, and to the high word
 1769 
    contains relative y-coordinate, and to the high word
1770 
    1 should be added.
 1770 
    1 should be added.
1771 
 
 1771 
 
1772 
------------ Subfunction 2 - pressed buttons of the mouse ------------
 1772 
------------ Subfunction 2 - pressed buttons of the mouse ------------
1773 
Parameters:
 1773 
Parameters:
1774 
  * eax = 37 - function number
 1774 
  * eax = 37 - function number
1775 
  * ebx = 2 - subfunction number
 1775 
  * ebx = 2 - subfunction number
1776 
Returned value:
 1776 
Returned value:
1777 
  * eax contains information on the pressed mouse buttons:
 1777 
  * eax contains information on the pressed mouse buttons:
1778 
  * bit 0 is set = left button is pressed
 1778 
  * bit 0 is set = left button is pressed
1779 
  * bit 1 is set = right button is pressed
 1779 
  * bit 1 is set = right button is pressed
1780 
  * bit 2 is set = middle button is pressed
 1780 
  * bit 2 is set = middle button is pressed
1781 
  * bit 3 is set = 4th button is pressed
 1781 
  * bit 3 is set = 4th button is pressed
1782 
  * bit 4 is set = 5th button is pressed
 1782 
  * bit 4 is set = 5th button is pressed
1783 
  * other bits are cleared
 1783 
  * other bits are cleared
1784 
 
 1784 
 
1785 
-------------------- Subfunction 4 - load cursor ---------------------
 1785 
-------------------- Subfunction 4 - load cursor ---------------------
1786 
Parameters:
 1786 
Parameters:
1787 
  * eax = 37 - function number
 1787 
  * eax = 37 - function number
1788 
  * ebx = 4 - subfunction number
 1788 
  * ebx = 4 - subfunction number
1789 
  * dx = data source:
 1789 
  * dx = data source:
1790 
  * dx = LOAD_FROM_FILE = 0 - data in a file
 1790 
  * dx = LOAD_FROM_FILE = 0 - data in a file
1791 
    * ecx = pointer to full path to the cursor file
 1791 
    * ecx = pointer to full path to the cursor file
1792 
    * the file must be in the format .cur, which is standard for
 1792 
    * the file must be in the format .cur, which is standard for
1793 
      MS Windows, at that of the size 32*32 pixels
 1793 
      MS Windows, at that of the size 32*32 pixels
1794 
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
 1794 
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
1795 
    * ecx = pointer to data of the cursor file
 1795 
    * ecx = pointer to data of the cursor file
1796 
    * the data format is the same as in the previous case
 1796 
    * the data format is the same as in the previous case
1797 
  * dx = LOAD_INDIRECT = 2 - data in memory
 1797 
  * dx = LOAD_INDIRECT = 2 - data in memory
1798 
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
 1798 
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
1799 
    * edx = 0xXXYY0002, where
 1799 
    * edx = 0xXXYY0002, where
1800 
      * XX = x-coordinate of cursor hotspot
 1800 
      * XX = x-coordinate of cursor hotspot
1801 
      * YY = y-coordinate
 1801 
      * YY = y-coordinate
1802 
      * 0 <= XX, YY <= 31
 1802 
      * 0 <= XX, YY <= 31
1803 
Returned value:
 1803 
Returned value:
1804 
  * eax = 0 - failed
 1804 
  * eax = 0 - failed
1805 
  * otherwise eax = cursor handle
 1805 
  * otherwise eax = cursor handle
1806 
 
 1806 
 
1807 
--------------------- Subfunction 5 - set cursor ---------------------
 1807 
--------------------- Subfunction 5 - set cursor ---------------------
1808 
Sets new cursor for the window of the current thread.
 1808 
Sets new cursor for the window of the current thread.
1809 
Parameters:
 1809 
Parameters:
1810 
  * eax = 37 - function number
 1810 
  * eax = 37 - function number
1811 
  * ebx = 5 - subfunction number
 1811 
  * ebx = 5 - subfunction number
1812 
  * ecx = cursor handle
 1812 
  * ecx = cursor handle
1813 
Returned value:
 1813 
Returned value:
1814 
  * eax = handle of previous cursor
 1814 
  * eax = handle of previous cursor
1815 
Remarks:
 1815 
Remarks:
1816 
  * If the handle is incorrect, the function restores the default
 1816 
  * If the handle is incorrect, the function restores the default
1817 
    cursor (standard arrow). In particular, ecx=0 restores it.
 1817 
    cursor (standard arrow). In particular, ecx=0 restores it.
1818 
 
 1818 
 
1819 
------------------- Subfunction 6 - delete cursor --------------------
 1819 
------------------- Subfunction 6 - delete cursor --------------------
1820 
Parameters:
 1820 
Parameters:
1821 
  * eax = 37 - function number
 1821 
  * eax = 37 - function number
1822 
  * ebx = 6 - subfunction number
 1822 
  * ebx = 6 - subfunction number
1823 
  * ecx = cursor handle
 1823 
  * ecx = cursor handle
1824 
Returned value:
 1824 
Returned value:
1825 
  * eax destroyed
 1825 
  * eax destroyed
1826 
Remarks:
 1826 
Remarks:
1827 
  * The cursor must be loaded previously by the current thread
 1827 
  * The cursor must be loaded previously by the current thread
1828 
    (with the call to subfunction 4). The function does not delete
 1828 
    (with the call to subfunction 4). The function does not delete
1829 
    system cursors and cursors, loaded by another applications.
 1829 
    system cursors and cursors, loaded by another applications.
1830 
  * If the active cursor (set by subfunction 5) is deleted,
 1830 
  * If the active cursor (set by subfunction 5) is deleted,
1831 
    the system restores the default cursor (standard arrow).
 1831 
    the system restores the default cursor (standard arrow).
1832 
 
 1832 
 
1833 
------------------ Subfunction 7 - get scroll data -------------------
 1833 
------------------ Subfunction 7 - get scroll data -------------------
1834 
Parameters:
 1834 
Parameters:
1835 
  * eax = 37 - function number
 1835 
  * eax = 37 - function number
1836 
  * ebx = 7 - subfunction number
 1836 
  * ebx = 7 - subfunction number
1837 
Returned value:
 1837 
Returned value:
1838 
  * eax = [horizontal offset]*65536 + [vertical offset]
 1838 
  * eax = [horizontal offset]*65536 + [vertical offset]
1839 
Remarks:
 1839 
Remarks:
1840 
  * Scroll data is available for active window only.
 1840 
  * Scroll data is available for active window only.
1841 
  * Values are zeroed after reading.
 1841 
  * Values are zeroed after reading.
1842 
  * Values are signed.
 1842 
  * Values are signed.
1843 
 
 1843 
 
1844 
======================================================================
 1844 
======================================================================
1845 
====================== Function 38 - draw line. ======================
 1845 
====================== Function 38 - draw line. ======================
1846 
======================================================================
 1846 
======================================================================
1847 
Parameters:
 1847 
Parameters:
1848 
  * eax = 38 - function number
 1848 
  * eax = 38 - function number
1849 
  * ebx = [start coordinate on axis x]*65536 +
 1849 
  * ebx = [start coordinate on axis x]*65536 +
1850 
              [end coordinate on axis x]
 1850 
              [end coordinate on axis x]
1851 
  * ecx = [start coordinate on axis y]*65536 +
 1851 
  * ecx = [start coordinate on axis y]*65536 +
1852 
              [end coordinate on axis y]
 1852 
              [end coordinate on axis y]
1853 
  * edx = 0x00RRGGBB - color
 1853 
  * edx = 0x00RRGGBB - color
1854 
    edx = 0x01xxxxxx - draw inversed line
 1854 
    edx = 0x01xxxxxx - draw inversed line
1855 
          (low 24 bits are ignored)
 1855 
          (low 24 bits are ignored)
1856 
Returned value:
 1856 
Returned value:
1857 
  * function does not return value
 1857 
  * function does not return value
1858 
Remarks:
 1858 
Remarks:
1859 
  * Coordinates are relative to the window.
 1859 
  * Coordinates are relative to the window.
1860 
  * End point is also drawn.
 1860 
  * End point is also drawn.
1861 
 
 1861 
 
1862 
======================================================================
 1862 
======================================================================
1863 
== Function 39, subfunction 1 - get a size of the background image. ==
 1863 
== Function 39, subfunction 1 - get a size of the background image. ==
1864 
======================================================================
 1864 
======================================================================
1865 
Parameters:
 1865 
Parameters:
1866 
  * eax = 39 - function number
 1866 
  * eax = 39 - function number
1867 
  * ebx = 1 - subfunction number
 1867 
  * ebx = 1 - subfunction number
1868 
Returned value:
 1868 
Returned value:
1869 
  * eax = [width]*65536 + [height]
 1869 
  * eax = [width]*65536 + [height]
1870 
Remarks:
 1870 
Remarks:
1871 
  * There is a pair function to set sizes of background image -
 1871 
  * There is a pair function to set sizes of background image -
1872 
    subfunction 1 of function 15. After which it is necessary,
 1872 
    subfunction 1 of function 15. After which it is necessary,
1873 
    of course, anew to define image.
 1873 
    of course, anew to define image.
1874 
 
 1874 
 
1875 
======================================================================
 1875 
======================================================================
1876 
== Function 39, subfunction 2 - get pixel from the background image. =
 1876 
== Function 39, subfunction 2 - get pixel from the background image. =
1877 
======================================================================
 1877 
======================================================================
1878 
Parameters:
 1878 
Parameters:
1879 
  * eax = 39 - function number
 1879 
  * eax = 39 - function number
1880 
  * ebx = 2 - subfunction number
 1880 
  * ebx = 2 - subfunction number
1881 
  * ecx = offset
 1881 
  * ecx = offset
1882 
Returned value:
 1882 
Returned value:
1883 
  * eax = 0x00RRGGBB - pixel color, if offset is valid
 1883 
  * eax = 0x00RRGGBB - pixel color, if offset is valid
1884 
    (less than 0x160000-16)
 1884 
    (less than 0x160000-16)
1885 
  * eax = 2 otherwise
 1885 
  * eax = 2 otherwise
1886 
Remarks:
 1886 
Remarks:
1887 
  * Do not rely on returned value for invalid offsets, it may be
 1887 
  * Do not rely on returned value for invalid offsets, it may be
1888 
    changed in future kernel versions.
 1888 
    changed in future kernel versions.
1889 
  * Offset for pixel with coordinates (x,y)
 1889 
  * Offset for pixel with coordinates (x,y)
1890 
    is calculated as (x+y*xsize)*3.
 1890 
    is calculated as (x+y*xsize)*3.
1891 
  * There is a pair function to set pixel on the background image -
 1891 
  * There is a pair function to set pixel on the background image -
1892 
    subfunction 2 of function 15.
 1892 
    subfunction 2 of function 15.
1893 
 
 1893 
 
1894 
======================================================================
 1894 
======================================================================
1895 
== Function 39, subfunction 4 - get drawing mode for the background. =
 1895 
== Function 39, subfunction 4 - get drawing mode for the background. =
1896 
======================================================================
 1896 
======================================================================
1897 
Parameters:
 1897 
Parameters:
1898 
  * eax = 39 - function number
 1898 
  * eax = 39 - function number
1899 
  * ebx = 4 - subfunction number
 1899 
  * ebx = 4 - subfunction number
1900 
Returned value:
 1900 
Returned value:
1901 
  * eax = 1 - tile
 1901 
  * eax = 1 - tile
1902 
  * eax = 2 - stretch
 1902 
  * eax = 2 - stretch
1903 
Remarks:
 1903 
Remarks:
1904 
  * There is a pair function to set drawing mode -
 1904 
  * There is a pair function to set drawing mode -
1905 
    subfunction 4 of function 15.
 1905 
    subfunction 4 of function 15.
1906 
 
 1906 
 
1907 
======================================================================
 1907 
======================================================================
1908 
=========== Function 40 - set the mask for expected events. ==========
 1908 
=========== Function 40 - set the mask for expected events. ==========
1909 
======================================================================
 1909 
======================================================================
1910 
The mask for expected events affects function working with events
 1910 
The mask for expected events affects function working with events
1911 
10, 11, 23 - they notify only about events allowed by this mask.
 1911 
10, 11, 23 - they notify only about events allowed by this mask.
1912 
Parameters:
 1912 
Parameters:
1913 
  * eax = 40 - function number
 1913 
  * eax = 40 - function number
1914 
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
 1914 
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
1915 
    (set bit permits notice on event)
 1915 
    (set bit permits notice on event)
1916 
Returned value:
 1916 
Returned value:
1917 
  * eax = previous value of mask
 1917 
  * eax = previous value of mask
1918 
Remarks:
 1918 
Remarks:
1919 
  * Default mask (7=111b) enables nofices about redraw,
 1919 
  * Default mask (7=111b) enables nofices about redraw,
1920 
    keys and buttons. This is enough for many applications.
 1920 
    keys and buttons. This is enough for many applications.
1921 
  * Events prohibited in the mask are saved anyway, when come;
 1921 
  * Events prohibited in the mask are saved anyway, when come;
1922 
    they are simply not informed with event functions.
 1922 
    they are simply not informed with event functions.
1923 
  * Event functions take into account the mask on moment of
 1923 
  * Event functions take into account the mask on moment of
1924 
    function call, not on moment of event arrival.
 1924 
    function call, not on moment of event arrival.
1925 
 
 1925 
 
1926 
======================================================================
 1926 
======================================================================
1927 
==================== Function 41 - get IRQ owner. ====================
 1927 
==================== Function 41 - get IRQ owner. ====================
1928 
======================================================================
 1928 
======================================================================
1929 
Parameters:
 1929 
Parameters:
1930 
  * eax = 41 - function number
 1930 
  * eax = 41 - function number
1931 
  * ebx = IRQ number, 0..15
 1931 
  * ebx = IRQ number, 0..15
1932 
Returned value:
 1932 
Returned value:
1933 
  * eax = owner PID
 1933 
  * eax = owner PID
1934 
  * eax = 0, if there is no owner
 1934 
  * eax = 0, if there is no owner
1935 
  * eax = -1 for incorrect ebx
 1935 
  * eax = -1 for incorrect ebx
1936 
 
 1936 
 
1937 
======================================================================
 1937 
======================================================================
1938 
================== Function 42 - work with IRQ data. =================
 1938 
================== Function 42 - work with IRQ data. =================
1939 
======================================================================
 1939 
======================================================================
1940 
When an IRQ occurs, the system reads data from ports indicated
 1940 
When an IRQ occurs, the system reads data from ports indicated
1941 
earlier by function 44 and writes this data to
 1941 
earlier by function 44 and writes this data to
1942 
internal buffer. This function reads out data from that buffer.
 1942 
internal buffer. This function reads out data from that buffer.
1943 
 
 1943 
 
1944 
--------------------- Subfunction 0 - read data ----------------------
 1944 
--------------------- Subfunction 0 - read data ----------------------
1945 
Parameters:
 1945 
Parameters:
1946 
  * eax = 42 - function number
 1946 
  * eax = 42 - function number
1947 
  * bl = IRQ number, 0..15
 1947 
  * bl = IRQ number, 0..15
1948 
  * bh = 0 - subfunction number
 1948 
  * bh = 0 - subfunction number
1949 
  * rest of ebx must be zeroed
 1949 
  * rest of ebx must be zeroed
1950 
  * ecx = pointer to a buffer with size not less than 4000 bytes
 1950 
  * ecx = pointer to a buffer with size not less than 4000 bytes
1951 
Returned value: (use value of eax to distinguish)
 1951 
Returned value: (use value of eax to distinguish)
1952 
  * if the thread is not IRQ owner
 1952 
  * if the thread is not IRQ owner
1953 
    (or IRQ number is incorrect): eax = -1
 1953 
    (or IRQ number is incorrect): eax = -1
1954 
  * if there is no data: eax = 0
 1954 
  * if there is no data: eax = 0
1955 
  * if all is ok:
 1955 
  * if all is ok:
1956 
    eax = size of data read (in bytes)
 1956 
    eax = size of data read (in bytes)
1957 
 
 1957 
 
1958 
------------- Subfunction 1 - get size of data in buffer -------------
 1958 
------------- Subfunction 1 - get size of data in buffer -------------
1959 
Parameters:
 1959 
Parameters:
1960 
  * eax = 42 - function number
 1960 
  * eax = 42 - function number
1961 
  * bl = IRQ number, 0..15
 1961 
  * bl = IRQ number, 0..15
1962 
  * bh = 0 - subfunction number
 1962 
  * bh = 0 - subfunction number
1963 
  * rest of ebx must be zeroed
 1963 
  * rest of ebx must be zeroed
1964 
Returned value:
 1964 
Returned value:
1965 
  * if the thread is not IRQ owner
 1965 
  * if the thread is not IRQ owner
1966 
    (or IRQ number is incorrect): eax = -1
 1966 
    (or IRQ number is incorrect): eax = -1
1967 
  * otherwise eax = size of data in buffer
 1967 
  * otherwise eax = size of data in buffer
1968 
Remarks:
 1968 
Remarks:
1969 
  * Previously the thread must reserve indicated IRQ for itself
 1969 
  * Previously the thread must reserve indicated IRQ for itself
1970 
    by function 45.
 1970 
    by function 45.
1971 
  * The size of data buffer is 4000 bytes, on overflow
 1971 
  * The size of data buffer is 4000 bytes, on overflow
1972 
    "fresh" data cease to be written in the buffer.
 1972 
    "fresh" data cease to be written in the buffer.
1973 
 
 1973 
 
1974 
======================================================================
 1974 
======================================================================
1975 
================ Function 43 - input/output to a port. ===============
 1975 
================ Function 43 - input/output to a port. ===============
1976 
======================================================================
 1976 
======================================================================
1977 
 
 1977 
 
1978 
------------------------ Output data to port -------------------------
 1978 
------------------------ Output data to port -------------------------
1979 
Parameters:
 1979 
Parameters:
1980 
  * eax = 43 - function number
 1980 
  * eax = 43 - function number
1981 
  * bl = byte for output
 1981 
  * bl = byte for output
1982 
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
 1982 
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
1983 
Returned value:
 1983 
Returned value:
1984 
  * eax = 0 - success
 1984 
  * eax = 0 - success
1985 
  * eax = 1 - the thread has not reserved the selected port
 1985 
  * eax = 1 - the thread has not reserved the selected port
1986 
 
 1986 
 
1987 
------------------------ Input data from port ------------------------
 1987 
------------------------ Input data from port ------------------------
1988 
Parameters:
 1988 
Parameters:
1989 
  * eax = 43 - function number
 1989 
  * eax = 43 - function number
1990 
  * ebx is ignored
 1990 
  * ebx is ignored
1991 
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
 1991 
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
1992 
Returned value:
 1992 
Returned value:
1993 
  * eax = 0 - success, thus ebx = entered byte
 1993 
  * eax = 0 - success, thus ebx = entered byte
1994 
  * eax = 1 - the thread has not reserved the selected port
 1994 
  * eax = 1 - the thread has not reserved the selected port
1995 
Remarks:
 1995 
Remarks:
1996 
  * Previously the thread must reserve the selected port
 1996 
  * Previously the thread must reserve the selected port
1997 
    for itself by function 46.
 1997 
    for itself by function 46.
1998 
  * Instead of call to this function it is better to use
 1998 
  * Instead of call to this function it is better to use
1999 
    processor instructions in/out - this is much
 1999 
    processor instructions in/out - this is much
2000 
    faster and a bit shorter and easier.
 2000 
    faster and a bit shorter and easier.
2001 
 
 2001 
 
2002 
======================================================================
 2002 
======================================================================
2003 
=========== Function 44 - define operations at IRQ arrival. ==========
 2003 
=========== Function 44 - define operations at IRQ arrival. ==========
2004 
======================================================================
 2004 
======================================================================
2005 
At IRQ arrival the system can read the data from ports defined
 2005 
At IRQ arrival the system can read the data from ports defined
2006 
by this function and write these data to internal buffer, whence
 2006 
by this function and write these data to internal buffer, whence
2007 
they can be read by ôóíêöèåé 42.
 2007 
they can be read by ôóíêöèåé 42.
2008 
Parameters:
 2008 
Parameters:
2009 
  * eax = 44 - function number
 2009 
  * eax = 44 - function number
2010 
  * ebx = pointer to the array of structures each describing one port:
 2010 
  * ebx = pointer to the array of structures each describing one port:
2011 
    * +0: word: 0 means end of array, otherwise port number
 2011 
    * +0: word: 0 means end of array, otherwise port number
2012 
    * +2: byte: reserved (ignored)
 2012 
    * +2: byte: reserved (ignored)
2013 
    * +3: byte: 1=read byte from this port, 2=read word
 2013 
    * +3: byte: 1=read byte from this port, 2=read word
2014 
  * ecx = IRQ number, 0..15
 2014 
  * ecx = IRQ number, 0..15
2015 
Returned value:
 2015 
Returned value:
2016 
  * eax = 0 - success
 2016 
  * eax = 0 - success
2017 
  * eax = 1 - the thread is not owner of selected IRQ
 2017 
  * eax = 1 - the thread is not owner of selected IRQ
2018 
Remarks:
 2018 
Remarks:
2019 
  * Previously the thread must reserve for itself selected IRQ
 2019 
  * Previously the thread must reserve for itself selected IRQ
2020 
    by function 45.
 2020 
    by function 45.
2021 
  * First 16 ports are considered only.
 2021 
  * First 16 ports are considered only.
2022 
  * The current implementation considers incorrect value of field +3
 2022 
  * The current implementation considers incorrect value of field +3
2023 
    as a signal to terminate IRQ processing.
 2023 
    as a signal to terminate IRQ processing.
2024 
 
 2024 
 
2025 
======================================================================
 2025 
======================================================================
2026 
=================== Function 45 - reserve/free IRQ. ==================
 2026 
=================== Function 45 - reserve/free IRQ. ==================
2027 
======================================================================
 2027 
======================================================================
2028 
Parameters:
 2028 
Parameters:
2029 
  * eax = 45 - function number
 2029 
  * eax = 45 - function number
2030 
  * ebx = 0 - reserve, 1 = free
 2030 
  * ebx = 0 - reserve, 1 = free
2031 
  * ecx = IRQ number, 0..15
 2031 
  * ecx = IRQ number, 0..15
2032 
Returned value:
 2032 
Returned value:
2033 
  * eax = 0 - success
 2033 
  * eax = 0 - success
2034 
  * eax = 1 - error (invalid IRQ number
 2034 
  * eax = 1 - error (invalid IRQ number
2035 
    or attempt to reserve not free IRQ
 2035 
    or attempt to reserve not free IRQ
2036 
    or to free IRQ, not reserved by this thread)
 2036 
    or to free IRQ, not reserved by this thread)
2037 
Remarks:
 2037 
Remarks:
2038 
  * IRQ reservation is required for functions 42 and 44.
 2038 
  * IRQ reservation is required for functions 42 and 44.
2039 
  * Only one thread can reserve the specific IRQ.
 2039 
  * Only one thread can reserve the specific IRQ.
2040 
  * IRQs, handled by the system itself, are reserved by the system
 2040 
  * IRQs, handled by the system itself, are reserved by the system
2041 
    (thread 1) at booting.
 2041 
    (thread 1) at booting.
2042 
  * When a thread terminates, all reserved by it IRQs
 2042 
  * When a thread terminates, all reserved by it IRQs
2043 
    are freed automatically.
 2043 
    are freed automatically.
2044 
 
 2044 
 
2045 
======================================================================
 2045 
======================================================================
2046 
====== Function 46 - reserve/free a group of input/output ports. =====
 2046 
====== Function 46 - reserve/free a group of input/output ports. =====
2047 
======================================================================
 2047 
======================================================================
2048 
To work with reserved ports an application can access directly by
 2048 
To work with reserved ports an application can access directly by
2049 
commands in/out (recommended way) and can use function 43
 2049 
commands in/out (recommended way) and can use function 43
2050 
(not recommended way).
 2050 
(not recommended way).
2051 
Parameters:
 2051 
Parameters:
2052 
  * eax = 46 - function number
 2052 
  * eax = 46 - function number
2053 
  * ebx = 0 - reserve, 1 - free
 2053 
  * ebx = 0 - reserve, 1 - free
2054 
  * ecx = start port number
 2054 
  * ecx = start port number
2055 
  * edx = end port number (inclusive)
 2055 
  * edx = end port number (inclusive)
2056 
Returned value:
 2056 
Returned value:
2057 
  * eax = 0 - success
 2057 
  * eax = 0 - success
2058 
  * eax = 1 - error
 2058 
  * eax = 1 - error
2059 
Remarks:
 2059 
Remarks:
2060 
  * For ports reservation: an error occurs if and only if
 2060 
  * For ports reservation: an error occurs if and only if
2061 
    one from the following condition satisfies:
 2061 
    one from the following condition satisfies:
2062 
    * start port is more than end port;
 2062 
    * start port is more than end port;
2063 
    * the selected range contains incorrect port number
 2063 
    * the selected range contains incorrect port number
2064 
      (correct are from 0 to 0xFFFF);
 2064 
      (correct are from 0 to 0xFFFF);
2065 
    * limit for the total number of reserved areas is exceeded
 2065 
    * limit for the total number of reserved areas is exceeded
2066 
      (maximum 255 are allowed);
 2066 
      (maximum 255 are allowed);
2067 
    * the selected range intersects with any of earlier reserved
 2067 
    * the selected range intersects with any of earlier reserved
2068 
  * For ports free: an error is an attempt to free range,
 2068 
  * For ports free: an error is an attempt to free range,
2069 
    that was not earlier reserved by this function
 2069 
    that was not earlier reserved by this function
2070 
    (with same ecx,edx).
 2070 
    (with same ecx,edx).
2071 
  * If an error occurs (for both cases) function performs no action.
 2071 
  * If an error occurs (for both cases) function performs no action.
2072 
  * At booting the system reserves for itself ports
 2072 
  * At booting the system reserves for itself ports
2073 
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
 2073 
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
2074 
  * When a thread terminates, all reserved by it ports
 2074 
  * When a thread terminates, all reserved by it ports
2075 
    are freed automatically.
 2075 
    are freed automatically.
2076 
 
 2076 
 
2077 
======================================================================
 2077 
======================================================================
2078 
============= Function 47 - draw a number in the window. =============
 2078 
============= Function 47 - draw a number in the window. =============
2079 
======================================================================
 2079 
======================================================================
2080 
Parameters:
 2080 
Parameters:
2081 
  * eax = 47 - function number
 2081 
  * eax = 47 - function number
2082 
  * ebx = parameters of conversion number to text:
 2082 
  * ebx = parameters of conversion number to text:
2083 
    * bl = 0 - ecx contains number
 2083 
    * bl = 0 - ecx contains number
2084 
    * bl = 1 - ecx contains pointer to dword/qword-number
 2084 
    * bl = 1 - ecx contains pointer to dword/qword-number
2085 
    * bh = 0 - display in decimal number system
 2085 
    * bh = 0 - display in decimal number system
2086 
    * bh = 1 - display in hexadecimal system
 2086 
    * bh = 1 - display in hexadecimal system
2087 
    * bh = 2 - display in binary system
 2087 
    * bh = 2 - display in binary system
2088 
    * bits 16-21 = how many digits to display
 2088 
    * bits 16-21 = how many digits to display
2089 
    * bits 22-29 reserved and must be set to 0
 2089 
    * bits 22-29 reserved and must be set to 0
2090 
    * bit 30 set = display qword (64-bit) number (must be bl=1)
 2090 
    * bit 30 set = display qword (64-bit) number (must be bl=1)
2091 
    * bit 31 set = do not display leading zeroes of the number
 2091 
    * bit 31 set = do not display leading zeroes of the number
2092 
  * ecx = number (if bl=0) or pointer (if bl=1)
 2092 
  * ecx = number (if bl=0) or pointer (if bl=1)
2093 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 2093 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
2094 
  * esi = 0xX0RRGGBB:
 2094 
  * esi = 0xX0RRGGBB:
2095 
    * RR, GG, BB specify the color
 2095 
    * RR, GG, BB specify the color
2096 
    * X = ABnn (bits)
 2096 
    * X = ABnn (bits)
2097 
    * nn = font (0/1)
 2097 
    * nn = font (0/1)
2098 
    * A is ignored
 2098 
    * A is ignored
2099 
    * B=1 - fill background with the color edi
 2099 
    * B=1 - fill background with the color edi
2100 
Returned value:
 2100 
Returned value:
2101 
  * function does not return value
 2101 
  * function does not return value
2102 
Remarks:
 2102 
Remarks:
2103 
  * The given length must not exceed 60.
 2103 
  * The given length must not exceed 60.
2104 
  * The exactly given amount of digits is output. If number is small
 2104 
  * The exactly given amount of digits is output. If number is small
2105 
    and can be written by smaller amount of digits, it is supplemented
 2105 
    and can be written by smaller amount of digits, it is supplemented
2106 
    by leading zeroes; if the number is big and can not be written by
 2106 
    by leading zeroes; if the number is big and can not be written by
2107 
    given amount of digits, extra digits are not drawn.
 2107 
    given amount of digits, extra digits are not drawn.
2108 
  * Parameters of fonts are shown in the description of function 4
 2108 
  * Parameters of fonts are shown in the description of function 4
2109 
    (text output).
 2109 
    (text output).
2110 
 
 2110 
 
2111 
======================================================================
 2111 
======================================================================
2112 
========= Function 48, subfunction 0 - apply screen settings. ========
 2112 
========= Function 48, subfunction 0 - apply screen settings. ========
2113 
======================================================================
 2113 
======================================================================
2114 
Parameters:
 2114 
Parameters:
2115 
  * eax = 48 - function number
 2115 
  * eax = 48 - function number
2116 
  * ebx = 0 - subfunction number
 2116 
  * ebx = 0 - subfunction number
2117 
  * ecx = 0 - reserved
 2117 
  * ecx = 0 - reserved
2118 
Returned value:
 2118 
Returned value:
2119 
  * function does not return value
 2119 
  * function does not return value
2120 
Remarks:
 2120 
Remarks:
2121 
  * Function redraws the screen after parameters change by
 2121 
  * Function redraws the screen after parameters change by
2122 
    subfunctions 1 and 2.
 2122 
    subfunctions 1 and 2.
2123 
  * Function call without prior call to one of indicated subfunctions
 2123 
  * Function call without prior call to one of indicated subfunctions
2124 
    is ignored.
 2124 
    is ignored.
2125 
  * Function call with nonzero ecx is ignored.
 2125 
  * Function call with nonzero ecx is ignored.
2126 
 
 2126 
 
2127 
======================================================================
 2127 
======================================================================
2128 
=========== Function 48, subfunction 1 - set button style. ===========
 2128 
=========== Function 48, subfunction 1 - set button style. ===========
2129 
======================================================================
 2129 
======================================================================
2130 
Parameters:
 2130 
Parameters:
2131 
  * eax = 48 - function number
 2131 
  * eax = 48 - function number
2132 
  * ebx = 1 - subfunction number
 2132 
  * ebx = 1 - subfunction number
2133 
  * ecx = button style:
 2133 
  * ecx = button style:
2134 
    * 0 = flat
 2134 
    * 0 = flat
2135 
    * 1 = 3d
 2135 
    * 1 = 3d
2136 
Returned value:
 2136 
Returned value:
2137 
  * function does not return value
 2137 
  * function does not return value
2138 
Remarks:
 2138 
Remarks:
2139 
  * After call to this function one should redraw the screen by
 2139 
  * After call to this function one should redraw the screen by
2140 
    subfunction 0.
 2140 
    subfunction 0.
2141 
  * Button style influences only to their draw of function 8.
 2141 
  * Button style influences only to their draw of function 8.
2142 
 
 2142 
 
2143 
======================================================================
 2143 
======================================================================
2144 
====== Function 48, subfunction 2 - set standard window colors. ======
 2144 
====== Function 48, subfunction 2 - set standard window colors. ======
2145 
======================================================================
 2145 
======================================================================
2146 
Parameters:
 2146 
Parameters:
2147 
  * eax = 48 - function number
 2147 
  * eax = 48 - function number
2148 
  * ebx = 2 - subfunction number
 2148 
  * ebx = 2 - subfunction number
2149 
  * ecx = pointer to the color table
 2149 
  * ecx = pointer to the color table
2150 
  * edx = size of the color table
 2150 
  * edx = size of the color table
2151 
    (must be 40 bytes for future compatibility)
 2151 
    (must be 40 bytes for future compatibility)
2152 
Format of the color table is shown in description of subfunction 3.
 2152 
Format of the color table is shown in description of subfunction 3.
2153 
Returned value:
 2153 
Returned value:
2154 
  * function does not return value
 2154 
  * function does not return value
2155 
Remarks:
 2155 
Remarks:
2156 
  * After call to this function one should redraw the screen by
 2156 
  * After call to this function one should redraw the screen by
2157 
    subfunction 0.
 2157 
    subfunction 0.
2158 
  * Table of standard colors influences only to applications,
 2158 
  * Table of standard colors influences only to applications,
2159 
    which receive this table obviously (by subfunction 3)
 2159 
    which receive this table obviously (by subfunction 3)
2160 
    and use it (specifying colors from it to drawing functions).
 2160 
    and use it (specifying colors from it to drawing functions).
2161 
  * Table of standard colors is included in skin and is installed
 2161 
  * Table of standard colors is included in skin and is installed
2162 
    anew with skin installation (by subfunction 8).
 2162 
    anew with skin installation (by subfunction 8).
2163 
  * Color table can be viewed/changed interactively with
 2163 
  * Color table can be viewed/changed interactively with
2164 
    the application 'desktop'.
 2164 
    the application 'desktop'.
2165 
 
 2165 
 
2166 
======================================================================
 2166 
======================================================================
2167 
====== Function 48, subfunction 3 - get standard window colors. ======
 2167 
====== Function 48, subfunction 3 - get standard window colors. ======
2168 
======================================================================
 2168 
======================================================================
2169 
Parameters:
 2169 
Parameters:
2170 
  * eax = 48 - function number
 2170 
  * eax = 48 - function number
2171 
  * ebx = 3 - subfunction number
 2171 
  * ebx = 3 - subfunction number
2172 
  * ecx = pointer to the buffer with size edx bytes,
 2172 
  * ecx = pointer to the buffer with size edx bytes,
2173 
    where table will be written
 2173 
    where table will be written
2174 
  * edx = size of color table
 2174 
  * edx = size of color table
2175 
    (must be 40 bytes for future compatibility)
 2175 
    (must be 40 bytes for future compatibility)
2176 
Returned value:
 2176 
Returned value:
2177 
  * function does not return value
 2177 
  * function does not return value
2178 
Format of the color table:
 2178 
Format of the color table:
2179 
each item is dword-value for color 0x00RRGGBB
 2179 
each item is dword-value for color 0x00RRGGBB
2180 
  * +0: dword: frames - color of frame
 2180 
  * +0: dword: frames - color of frame
2181 
  * +4: dword: grab - color of header
 2181 
  * +4: dword: grab - color of header
2182 
  * +8: dword: grab_button - color of button on header bar
 2182 
  * +8: dword: grab_button - color of button on header bar
2183 
  * +12 = +0xC: dword: grab_button_text - color of text on button
 2183 
  * +12 = +0xC: dword: grab_button_text - color of text on button
2184 
    on header bar
 2184 
    on header bar
2185 
  * +16 = +0x10: dword: grab_text - color of text on header
 2185 
  * +16 = +0x10: dword: grab_text - color of text on header
2186 
  * +20 = +0x14: dword: work - color of working area
 2186 
  * +20 = +0x14: dword: work - color of working area
2187 
  * +24 = +0x18: dword: work_button - color of button in working area
 2187 
  * +24 = +0x18: dword: work_button - color of button in working area
2188 
  * +28 = +0x1C: dword: work_button_text - color of text on button
 2188 
  * +28 = +0x1C: dword: work_button_text - color of text on button
2189 
    in working area
 2189 
    in working area
2190 
  * +32 = +0x20: dword: work_text - color of text in working area
 2190 
  * +32 = +0x20: dword: work_text - color of text in working area
2191 
  * +36 = +0x24: dword: work_graph - color of graphics in working area
 2191 
  * +36 = +0x24: dword: work_graph - color of graphics in working area
2192 
Remarks:
 2192 
Remarks:
2193 
  * Structure of the color table is described in the standard
 2193 
  * Structure of the color table is described in the standard
2194 
    include file 'macros.inc' as 'system_colors'; for example,
 2194 
    include file 'macros.inc' as 'system_colors'; for example,
2195 
    it is possible to write:
 2195 
    it is possible to write:
2196 
        sc      system_colors           ; variable declaration
 2196 
        sc      system_colors           ; variable declaration
2197 
        ...                             ; somewhere one must call
 2197 
        ...                             ; somewhere one must call
2198 
                                        ; this function with ecx=sc
 2198 
                                        ; this function with ecx=sc
2199 
        mov     ecx, [sc.work_button_text]      ; read text color on
 2199 
        mov     ecx, [sc.work_button_text]      ; read text color on
2200 
                                        ; buttin in working area
 2200 
                                        ; buttin in working area
2201 
  * A program itself desides to use or not to use color table.
 2201 
  * A program itself desides to use or not to use color table.
2202 
    For usage program must simply at calls to drawing functions select
 2202 
    For usage program must simply at calls to drawing functions select
2203 
    color taken from the table.
 2203 
    color taken from the table.
2204 
  * At change of the table of standard colors (by subfunction 2 with
 2204 
  * At change of the table of standard colors (by subfunction 2 with
2205 
    the subsequent application of changes by subfunction 0 or
 2205 
    the subsequent application of changes by subfunction 0 or
2206 
    at skin set by subfunction 8) the system sends to all windows
 2206 
    at skin set by subfunction 8) the system sends to all windows
2207 
    redraw message (the event with code 1).
 2207 
    redraw message (the event with code 1).
2208 
  * Color table can be viewed/changed interactively with
 2208 
  * Color table can be viewed/changed interactively with
2209 
    the application 'desktop'.
 2209 
    the application 'desktop'.
2210 
 
 2210 
 
2211 
======================================================================
 2211 
======================================================================
2212 
============ Function 48, subfunction 4 - get skin height. ===========
 2212 
============ Function 48, subfunction 4 - get skin height. ===========
2213 
======================================================================
 2213 
======================================================================
2214 
Parameters:
 2214 
Parameters:
2215 
  * eax = 48 - function number
 2215 
  * eax = 48 - function number
2216 
  * ebx = 4 - subfunction number
 2216 
  * ebx = 4 - subfunction number
2217 
Returned value:
 2217 
Returned value:
2218 
  * eax = skin height
 2218 
  * eax = skin height
2219 
Remarks:
 2219 
Remarks:
2220 
  * Skin height is defined as the height of a header
 2220 
  * Skin height is defined as the height of a header
2221 
    of skinned windows.
 2221 
    of skinned windows.
2222 
  * See also general structure of window in the description
 2222 
  * See also general structure of window in the description
2223 
    of function 0.
 2223 
    of function 0.
2224 
 
 2224 
 
2225 
======================================================================
 2225 
======================================================================
2226 
======== Function 48, subfunction 5 - get screen working area. =======
 2226 
======== Function 48, subfunction 5 - get screen working area. =======
2227 
======================================================================
 2227 
======================================================================
2228 
Parameters:
 2228 
Parameters:
2229 
  * eax = 48 - function number
 2229 
  * eax = 48 - function number
2230 
  * ebx = 5 - subfunction number
 2230 
  * ebx = 5 - subfunction number
2231 
Returned value:
 2231 
Returned value:
2232 
  * eax = [left]*65536 + [right]
 2232 
  * eax = [left]*65536 + [right]
2233 
  * ebx = [top]*65536 + [bottom]
 2233 
  * ebx = [top]*65536 + [bottom]
2234 
Remarks:
 2234 
Remarks:
2235 
  * The screen working area defines position and coordinates of
 2235 
  * The screen working area defines position and coordinates of
2236 
    a maximized window.
 2236 
    a maximized window.
2237 
  * The screen working area in view of normal work is all screen
 2237 
  * The screen working area in view of normal work is all screen
2238 
    without system panel (the application '@panel').
 2238 
    without system panel (the application '@panel').
2239 
  * (left,top) are coordinates of the left upper corner,
 2239 
  * (left,top) are coordinates of the left upper corner,
2240 
    (right,bottom) are coordinates of the right lower one.
 2240 
    (right,bottom) are coordinates of the right lower one.
2241 
    Thus the size of working area on x axis can be calculated by
 2241 
    Thus the size of working area on x axis can be calculated by
2242 
    formula right-left+1, on y axis - by formula bottom-right+1.
 2242 
    formula right-left+1, on y axis - by formula bottom-right+1.
2243 
  * See also function 14,
 2243 
  * See also function 14,
2244 
    to get sizes of all screen.
 2244 
    to get sizes of all screen.
2245 
  * There is a pair function to set working area - subfunction 6.
 2245 
  * There is a pair function to set working area - subfunction 6.
2246 
 
 2246 
 
2247 
======================================================================
 2247 
======================================================================
2248 
======== Function 48, subfunction 6 - set screen working area. =======
 2248 
======== Function 48, subfunction 6 - set screen working area. =======
2249 
======================================================================
 2249 
======================================================================
2250 
Parameters:
 2250 
Parameters:
2251 
  * eax = 48 - function number
 2251 
  * eax = 48 - function number
2252 
  * ebx = 6 - subfunction number
 2252 
  * ebx = 6 - subfunction number
2253 
  * ecx = [left]*65536 + [right]
 2253 
  * ecx = [left]*65536 + [right]
2254 
  * edx = [top]*65536 + [bottom]
 2254 
  * edx = [top]*65536 + [bottom]
2255 
Returned value:
 2255 
Returned value:
2256 
  * function does not return value
 2256 
  * function does not return value
2257 
Remarks:
 2257 
Remarks:
2258 
  * The screen working area defines position and coordinates of
 2258 
  * The screen working area defines position and coordinates of
2259 
    a maximized window.
 2259 
    a maximized window.
2260 
  * This function is used only by the application '@panel',
 2260 
  * This function is used only by the application '@panel',
2261 
    which set working area to all screen without system panel.
 2261 
    which set working area to all screen without system panel.
2262 
  * (left,top) are coordinates of the left upper corner,
 2262 
  * (left,top) are coordinates of the left upper corner,
2263 
    (right,bottom) are coordinates of the right lower one.
 2263 
    (right,bottom) are coordinates of the right lower one.
2264 
    Thus the size of working area on x axis can be calculated by
 2264 
    Thus the size of working area on x axis can be calculated by
2265 
    formula right-left+1, on y axis - by formula bottom-right+1.
 2265 
    formula right-left+1, on y axis - by formula bottom-right+1.
2266 
  * If 'left'>='right', x-coordinate of working area is not changed.
 2266 
  * If 'left'>='right', x-coordinate of working area is not changed.
2267 
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
 2267 
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
2268 
    equal to screen width, 'right' will not be set.
 2268 
    equal to screen width, 'right' will not be set.
2269 
    Similarly on y axis.
 2269 
    Similarly on y axis.
2270 
  * See also function 14,
 2270 
  * See also function 14,
2271 
    to get sizes of all screen.
 2271 
    to get sizes of all screen.
2272 
  * There is a pair function to get working area - subfunction 5.
 2272 
  * There is a pair function to get working area - subfunction 5.
2273 
  * This function redraws the screen automatically,
 2273 
  * This function redraws the screen automatically,
2274 
    updating coordinates and sizes of maximized windows.
 2274 
    updating coordinates and sizes of maximized windows.
2275 
    The system sends to all windows redraw message (the event 1).
 2275 
    The system sends to all windows redraw message (the event 1).
2276 
 
 2276 
 
2277 
======================================================================
 2277 
======================================================================
2278 
=========== Function 48, subfunction 7 - get skin margins. ===========
 2278 
=========== Function 48, subfunction 7 - get skin margins. ===========
2279 
======================================================================
 2279 
======================================================================
2280 
Returns the area of a header of a skinned window, intended for
 2280 
Returns the area of a header of a skinned window, intended for
2281 
a text of a header.
 2281 
a text of a header.
2282 
Parameters:
 2282 
Parameters:
2283 
  * eax = 48 - function number
 2283 
  * eax = 48 - function number
2284 
  * ebx = 7 - subfunction number
 2284 
  * ebx = 7 - subfunction number
2285 
Returned value:
 2285 
Returned value:
2286 
  * eax = [left]*65536 + [right]
 2286 
  * eax = [left]*65536 + [right]
2287 
  * ebx = [top]*65536 + [bottom]
 2287 
  * ebx = [top]*65536 + [bottom]
2288 
Remarks:
 2288 
Remarks:
2289 
  * An application decides itself to use or not to use this function.
 2289 
  * An application decides itself to use or not to use this function.
2290 
  * It is recommended to take into account returned value
 2290 
  * It is recommended to take into account returned value
2291 
    of this function for choice of a place for drawing header text
 2291 
    of this function for choice of a place for drawing header text
2292 
    (by function 4) or a substitute of header text
 2292 
    (by function 4) or a substitute of header text
2293 
    (at the discretion of an application).
 2293 
    (at the discretion of an application).
2294 
 
 2294 
 
2295 
======================================================================
 2295 
======================================================================
2296 
============= Function 48, subfunction 8 - set used skin. ============
 2296 
============= Function 48, subfunction 8 - set used skin. ============
2297 
======================================================================
 2297 
======================================================================
2298 
Parameters:
 2298 
Parameters:
2299 
  * eax = 48 - function number
 2299 
  * eax = 48 - function number
2300 
  * ebx = 8 - subfunction number
 2300 
  * ebx = 8 - subfunction number
2301 
  * ecx = pointer to a block for function 58, in
 2301 
  * ecx = pointer to a block for function 58, in
2302 
    which the fields of intermediate buffer and file name are filled
 2302 
    which the fields of intermediate buffer and file name are filled
2303 
Returned value:
 2303 
Returned value:
2304 
  * eax = 0 - success
 2304 
  * eax = 0 - success
2305 
  * otherwise eax = file system error code; if file does not
 2305 
  * otherwise eax = file system error code; if file does not
2306 
    contain valid skin, function returns error 3
 2306 
    contain valid skin, function returns error 3
2307 
    (unknown file system).
 2307 
    (unknown file system).
2308 
Remarks:
 2308 
Remarks:
2309 
  * After successful skin loading the system sends to all windows
 2309 
  * After successful skin loading the system sends to all windows
2310 
    redraw message (the event 1).
 2310 
    redraw message (the event 1).
2311 
  * At booting the system reads skin from file 'default.skn'
 2311 
  * At booting the system reads skin from file 'default.skn'
2312 
    on ramdisk.
 2312 
    on ramdisk.
2313 
  * User can change the skin statically by creating hisself
 2313 
  * User can change the skin statically by creating hisself
2314 
    'default.skn' or dynamically with the application 'desktop'.
 2314 
    'default.skn' or dynamically with the application 'desktop'.
2315 
 
 2315 
 
2316 
======================================================================
 2316 
======================================================================
2317 
=========== Function 49 - Advanced Power Management (APM). ===========
 2317 
=========== Function 49 - Advanced Power Management (APM). ===========
2318 
======================================================================
 2318 
======================================================================
2319 
Parameters:
 2319 
Parameters:
2320 
  * eax = 49 - function number
 2320 
  * eax = 49 - function number
2321 
  * dx = number of the APM function
 2321 
  * dx = number of the APM function
2322 
    (analogue of ax in APM specification)
 2322 
    (analogue of ax in APM specification)
2323 
  * bx, cx = parameters of the APM function
 2323 
  * bx, cx = parameters of the APM function
2324 
Returned value:
 2324 
Returned value:
2325 
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
 2325 
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
2326 
    are set according to the APM specification
 2326 
    are set according to the APM specification
2327 
  * high halves of 32-bit registers eax, ebx, ecx,
 2327 
  * high halves of 32-bit registers eax, ebx, ecx,
2328 
    edx, esi, edi are destroyed
 2328 
    edx, esi, edi are destroyed
2329 
Remarks:
 2329 
Remarks:
2330 
  * APM 1.2 specification is described in the document
 2330 
  * APM 1.2 specification is described in the document
2331 
    "Advanced Power Management (APM) BIOS Specification"
 2331 
    "Advanced Power Management (APM) BIOS Specification"
2332 
    (Revision 1.2), available at
 2332 
    (Revision 1.2), available at
2333 
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
 2333 
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2334 
    besides it is included in famous Interrupt List by Ralf Brown
 2334 
    besides it is included in famous Interrupt List by Ralf Brown
2335 
    (http://www.pobox.com/~ralf/files.html,
 2335 
    (http://www.pobox.com/~ralf/files.html,
2336 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
 2336 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2337 
 
 2337 
 
2338 
======================================================================
 2338 
======================================================================
2339 
=================== Function 50 - set window shape. ==================
 2339 
=================== Function 50 - set window shape. ==================
2340 
======================================================================
 2340 
======================================================================
2341 
Normal windows have rectangular shape. This function can give to
 2341 
Normal windows have rectangular shape. This function can give to
2342 
a window any shape. The shape is given by a set of points inside
 2342 
a window any shape. The shape is given by a set of points inside
2343 
the base rectangle belonging to a window. Position and coordinates
 2343 
the base rectangle belonging to a window. Position and coordinates
2344 
of the base rectangle are set by function 0
 2344 
of the base rectangle are set by function 0
2345 
and changed by function 67.
 2345 
and changed by function 67.
2346 
 
 2346 
 
2347 
--------------------------- Set shape data ---------------------------
 2347 
--------------------------- Set shape data ---------------------------
2348 
Parameters:
 2348 
Parameters:
2349 
  * eax = 50 - function number
 2349 
  * eax = 50 - function number
2350 
  * ebx = 0 - subfunction number
 2350 
  * ebx = 0 - subfunction number
2351 
  * ecx = pointer to shape data (array of bytes 0/1)
 2351 
  * ecx = pointer to shape data (array of bytes 0/1)
2352 
Returned value:
 2352 
Returned value:
2353 
  * function does not return value
 2353 
  * function does not return value
2354 
 
 2354 
 
2355 
-------------------------- Set shape scale ---------------------------
 2355 
-------------------------- Set shape scale ---------------------------
2356 
Parameters:
 2356 
Parameters:
2357 
  * eax = 50 - function number
 2357 
  * eax = 50 - function number
2358 
  * ebx = 1 - subfunction number
 2358 
  * ebx = 1 - subfunction number
2359 
  * ecx sets a scale: each byte of data defines
 2359 
  * ecx sets a scale: each byte of data defines
2360 
    (2^scale)*(2^scale) pixels
 2360 
    (2^scale)*(2^scale) pixels
2361 
Returned value:
 2361 
Returned value:
2362 
  * function does not return value
 2362 
  * function does not return value
2363 
Remarks:
 2363 
Remarks:
2364 
  * Default scale is 0 (scale factor is 1). If in the shape data
 2364 
  * Default scale is 0 (scale factor is 1). If in the shape data
2365 
    one byte corresponds to one pixel, there is no necessity
 2365 
    one byte corresponds to one pixel, there is no necessity
2366 
    to set scale.
 2366 
    to set scale.
2367 
  * Let's designate xsize = window width (in pixels), ysize = height;
 2367 
  * Let's designate xsize = window width (in pixels), ysize = height;
2368 
    pay attention, that they are one pixel more than defined by
 2368 
    pay attention, that they are one pixel more than defined by
2369 
    functions 0, 67.
 2369 
    functions 0, 67.
2370 
  * On definition of scale xsize and ysize must be divisible
 2370 
  * On definition of scale xsize and ysize must be divisible
2371 
    on 2^scale.
 2371 
    on 2^scale.
2372 
  * Byte of data on offset 'a' must be 0/1 and defines belonging
 2372 
  * Byte of data on offset 'a' must be 0/1 and defines belonging
2373 
    to a window of square with the side 2^scale (if scale=0,
 2373 
    to a window of square with the side 2^scale (if scale=0,
2374 
    this is one pixel) and coordinates of the left upper corner
 2374 
    this is one pixel) and coordinates of the left upper corner
2375 
    (a mod (xsize shr scale), a div (xsize shr scale))
 2375 
    (a mod (xsize shr scale), a div (xsize shr scale))
2376 
  * Data size: (xsize shr scale)*(ysize shr scale).
 2376 
  * Data size: (xsize shr scale)*(ysize shr scale).
2377 
  * Data must be presented in the memory and not change
 2377 
  * Data must be presented in the memory and not change
2378 
    after set of shape.
 2378 
    after set of shape.
2379 
  * The system views the shape data at every window redraw by
 2379 
  * The system views the shape data at every window redraw by
2380 
    function 0.
 2380 
    function 0.
2381 
  * The call of subfunction 0 with NULL pointer results in return
 2381 
  * The call of subfunction 0 with NULL pointer results in return
2382 
    to the rectangular shape.
 2382 
    to the rectangular shape.
2383 
 
 2383 
 
2384 
======================================================================
 2384 
======================================================================
2385 
==================== Function 51 - create thread. ====================
 2385 
==================== Function 51 - create thread. ====================
2386 
======================================================================
 2386 
======================================================================
2387 
Parameters:
 2387 
Parameters:
2388 
  * eax = 51 - function number
 2388 
  * eax = 51 - function number
2389 
  * ebx = 1 - unique subfunction
 2389 
  * ebx = 1 - unique subfunction
2390 
  * ecx = address of thread entry point (starting eip)
 2390 
  * ecx = address of thread entry point (starting eip)
2391 
  * edx = pointer to thread stack (starting esp)
 2391 
  * edx = pointer to thread stack (starting esp)
2392 
Returned value:
 2392 
Returned value:
2393 
  * eax = -1 - error (there is too many threads)
 2393 
  * eax = -1 - error (there is too many threads)
2394 
  * otherwise eax = TID - thread identifier
 2394 
  * otherwise eax = TID - thread identifier
2395
2395
2396 
 
 2396 
 
2397 
======================================================================
 2397 
======================================================================
2398 
=== Function 52, subfunction 0 - get network driver configuration. ===
 2398 
=== Function 52, subfunction 0 - get network driver configuration. ===
2399 
======================================================================
 2399 
======================================================================
2400 
Parameters:
 2400 
Parameters:
2401 
  * eax = 52 - function number
 2401 
  * eax = 52 - function number
2402 
  * ebx = 0 - subfunction number
 2402 
  * ebx = 0 - subfunction number
2403 
Returned value:
 2403 
Returned value:
2404 
  * eax = configuration dword
 2404 
  * eax = configuration dword
2405 
Remarks:
 2405 
Remarks:
2406 
  * Configuration dword can be set by subfunction 2.
 2406 
  * Configuration dword can be set by subfunction 2.
2407 
  * The kernel does not use this variable. The value of this
 2407 
  * The kernel does not use this variable. The value of this
2408 
    variable and working with it subfunctions 0 and 2 is represented
 2408 
    variable and working with it subfunctions 0 and 2 is represented
2409 
    doubtful.
 2409 
    doubtful.
2410 
 
 2410 
 
2411 
======================================================================
 2411 
======================================================================
2412 
========= Function 52, subfunction 1 - get local IP-address. =========
 2412 
========= Function 52, subfunction 1 - get local IP-address. =========
2413 
======================================================================
 2413 
======================================================================
2414 
Parameters:
 2414 
Parameters:
2415 
  * eax = 52 - function number
 2415 
  * eax = 52 - function number
2416 
  * ebx = 1 - subfunction number
 2416 
  * ebx = 1 - subfunction number
2417 
Returned value:
 2417 
Returned value:
2418 
  * eax = IP-address (4 bytes)
 2418 
  * eax = IP-address (4 bytes)
2419 
Remarks:
 2419 
Remarks:
2420 
  * Local IP-address is set by subfunction 3.
 2420 
  * Local IP-address is set by subfunction 3.
2421 
 
 2421 
 
2422 
======================================================================
 2422 
======================================================================
2423 
=== Function 52, subfunction 2 - set network driver configuration. ===
 2423 
=== Function 52, subfunction 2 - set network driver configuration. ===
2424 
======================================================================
 2424 
======================================================================
2425 
Parameters:
 2425 
Parameters:
2426 
  * eax = 52 - function number
 2426 
  * eax = 52 - function number
2427 
  * ebx = 2 - subfunction number
 2427 
  * ebx = 2 - subfunction number
2428 
  * ecx = configuration dword; if low 7 bits derivate the number 3,
 2428 
  * ecx = configuration dword; if low 7 bits derivate the number 3,
2429 
    function [re-]initializes Ethernet-card, otherwise
 2429 
    function [re-]initializes Ethernet-card, otherwise
2430 
    Ethernet turns off
 2430 
    Ethernet turns off
2431 
Returned value:
 2431 
Returned value:
2432 
  * if Ethernet-interface is not requested, function returns eax=2,
 2432 
  * if Ethernet-interface is not requested, function returns eax=2,
2433 
    but this can be changed in future kernel versions
 2433 
    but this can be changed in future kernel versions
2434 
  * if Ethernet-interface is requested, eax=0 means error
 2434 
  * if Ethernet-interface is requested, eax=0 means error
2435 
    (absence of Ethernet-card), and nonzero value - success
 2435 
    (absence of Ethernet-card), and nonzero value - success
2436 
Remarks:
 2436 
Remarks:
2437 
  * Configuration dword can be read by subfunction 0.
 2437 
  * Configuration dword can be read by subfunction 0.
2438 
  * The kernel does not use this variable. The value of this
 2438 
  * The kernel does not use this variable. The value of this
2439 
    variable, subfunction 0 and part of subfunction 2, which set it,
 2439 
    variable, subfunction 0 and part of subfunction 2, which set it,
2440 
    is represented doubtful.
 2440 
    is represented doubtful.
2441 
 
 2441 
 
2442 
======================================================================
 2442 
======================================================================
2443 
========= Function 52, subfunction 3 - set local IP-address. =========
 2443 
========= Function 52, subfunction 3 - set local IP-address. =========
2444 
======================================================================
 2444 
======================================================================
2445 
Parameters:
 2445 
Parameters:
2446 
  * eax = 52 - function number
 2446 
  * eax = 52 - function number
2447 
  * ebx = 3 - subfunction number
 2447 
  * ebx = 3 - subfunction number
2448 
  * ecx = IP-address (4 bytes)
 2448 
  * ecx = IP-address (4 bytes)
2449 
Returned value:
 2449 
Returned value:
2450 
  * the current implementation returns eax=3, but this can be changed
 2450 
  * the current implementation returns eax=3, but this can be changed
2451 
    in future versions
 2451 
    in future versions
2452 
Remarks:
 2452 
Remarks:
2453 
  * Local IP-address can be get by subfunction 1.
 2453 
  * Local IP-address can be get by subfunction 1.
2454 
 
 2454 
 
2455 
======================================================================
 2455 
======================================================================
2456 
= Function 52, subfunction 6 - add data to the stack of input queue. =
 2456 
= Function 52, subfunction 6 - add data to the stack of input queue. =
2457 
======================================================================
 2457 
======================================================================
2458 
Parameters:
 2458 
Parameters:
2459 
  * eax = 52 - function number
 2459 
  * eax = 52 - function number
2460 
  * ebx = 6 - subfunction number
 2460 
  * ebx = 6 - subfunction number
2461 
  * edx = data size
 2461 
  * edx = data size
2462 
  * esi = data pointer
 2462 
  * esi = data pointer
2463 
Returned value:
 2463 
Returned value:
2464 
  * eax = -1 - error
 2464 
  * eax = -1 - error
2465 
  * eax = 0 - success
 2465 
  * eax = 0 - success
2466 
Remarks:
 2466 
Remarks:
2467 
  * This function is intended only for slow network drivers
 2467 
  * This function is intended only for slow network drivers
2468 
    (PPP, SLIP).
 2468 
    (PPP, SLIP).
2469 
  * Data size must not exceed 1500 bytes, though function
 2469 
  * Data size must not exceed 1500 bytes, though function
2470 
    performs no checks on correctness.
 2470 
    performs no checks on correctness.
2471 
 
 2471 
 
2472 
======================================================================
 2472 
======================================================================
2473 
 Function 52, subfunction 8 - read data from the network output queue.
 2473 
 Function 52, subfunction 8 - read data from the network output queue.
2474 
======================================================================
 2474 
======================================================================
2475 
Parameters:
 2475 
Parameters:
2476 
  * eax = 52 - function number
 2476 
  * eax = 52 - function number
2477 
  * ebx = 8 - subfunction number
 2477 
  * ebx = 8 - subfunction number
2478 
  * esi = pointer to 1500-byte buffer
 2478 
  * esi = pointer to 1500-byte buffer
2479 
Returned value:
 2479 
Returned value:
2480 
  * eax = number of read bytes (in the current implementation
 2480 
  * eax = number of read bytes (in the current implementation
2481 
    either 0 = no data or 1500)
 2481 
    either 0 = no data or 1500)
2482 
  * data was copied in buffer
 2482 
  * data was copied in buffer
2483 
Remarks:
 2483 
Remarks:
2484 
  * This function is intended only for slow network drivers
 2484 
  * This function is intended only for slow network drivers
2485 
    (PPP, SLIP).
 2485 
    (PPP, SLIP).
2486 
 
 2486 
 
2487 
======================================================================
 2487 
======================================================================
2488 
============ Function 52, subfunction 9 - get gateway IP. ============
 2488 
============ Function 52, subfunction 9 - get gateway IP. ============
2489 
======================================================================
 2489 
======================================================================
2490 
Parameters:
 2490 
Parameters:
2491 
  * eax = 52 - function number
 2491 
  * eax = 52 - function number
2492 
  * ebx = 9 - subfunction number
 2492 
  * ebx = 9 - subfunction number
2493 
Returned value:
 2493 
Returned value:
2494 
  * eax = gateway IP (4 bytes)
 2494 
  * eax = gateway IP (4 bytes)
2495 
 
 2495 
 
2496 
======================================================================
 2496 
======================================================================
2497 
=========== Function 52, subfunction 10 - get subnet mask. ===========
 2497 
=========== Function 52, subfunction 10 - get subnet mask. ===========
2498 
======================================================================
 2498 
======================================================================
2499 
Parameters:
 2499 
Parameters:
2500 
  * eax = 52 - function number
 2500 
  * eax = 52 - function number
2501 
  * ebx = 10 - subfunction number
 2501 
  * ebx = 10 - subfunction number
2502 
Returned value:
 2502 
Returned value:
2503 
  * eax = subnet mask
 2503 
  * eax = subnet mask
2504 
 
 2504 
 
2505 
======================================================================
 2505 
======================================================================
2506 
============ Function 52, subfunction 11 - set gateway IP. ===========
 2506 
============ Function 52, subfunction 11 - set gateway IP. ===========
2507 
======================================================================
 2507 
======================================================================
2508 
Parameters:
 2508 
Parameters:
2509 
  * eax = 52 - function number
 2509 
  * eax = 52 - function number
2510 
  * ebx = 11 - subfunction number
 2510 
  * ebx = 11 - subfunction number
2511 
  * ecx = gateway IP (4 bytes)
 2511 
  * ecx = gateway IP (4 bytes)
2512 
Returned value:
 2512 
Returned value:
2513 
  * the current implementation returns eax=11, but this can be changed
 2513 
  * the current implementation returns eax=11, but this can be changed
2514 
    in future versions
 2514 
    in future versions
2515 
 
 2515 
 
2516 
======================================================================
 2516 
======================================================================
2517 
=========== Function 52, subfunction 12 - set subnet mask. ===========
 2517 
=========== Function 52, subfunction 12 - set subnet mask. ===========
2518 
======================================================================
 2518 
======================================================================
2519 
Parameters:
 2519 
Parameters:
2520 
  * eax = 52 - function number
 2520 
  * eax = 52 - function number
2521 
  * ebx = 12 - subfunction number
 2521 
  * ebx = 12 - subfunction number
2522 
  * ecx = subnet mask
 2522 
  * ecx = subnet mask
2523 
Returned value:
 2523 
Returned value:
2524 
  * the current implementation returns eax=12, but this can be changed
 2524 
  * the current implementation returns eax=12, but this can be changed
2525 
    in future versions
 2525 
    in future versions
2526 
 
 2526 
 
2527 
======================================================================
 2527 
======================================================================
2528 
============== Function 52, subfunction 13 - get DNS IP. =============
 2528 
============== Function 52, subfunction 13 - get DNS IP. =============
2529 
======================================================================
 2529 
======================================================================
2530 
Parameters:
 2530 
Parameters:
2531 
  * eax = 52 - function number
 2531 
  * eax = 52 - function number
2532 
  * ebx = 13 - subfunction number
 2532 
  * ebx = 13 - subfunction number
2533 
Returned value:
 2533 
Returned value:
2534 
  * eax = DNS IP (4 bytes)
 2534 
  * eax = DNS IP (4 bytes)
2535 
 
 2535 
 
2536 
======================================================================
 2536 
======================================================================
2537 
============== Function 52, subfunction 14 - set DNS IP. =============
 2537 
============== Function 52, subfunction 14 - set DNS IP. =============
2538 
======================================================================
 2538 
======================================================================
2539 
Parameters:
 2539 
Parameters:
2540 
  * eax = 52 - function number
 2540 
  * eax = 52 - function number
2541 
  * ebx = 14 - subfunction number
 2541 
  * ebx = 14 - subfunction number
2542 
  * ecx = DNS IP (4 bytes)
 2542 
  * ecx = DNS IP (4 bytes)
2543 
Returned value:
 2543 
Returned value:
2544 
  * the current implementation returns eax=14, but this can be changed
 2544 
  * the current implementation returns eax=14, but this can be changed
2545 
    in future versions
 2545 
    in future versions
2546 
 
 2546 
 
2547 
======================================================================
 2547 
======================================================================
2548 
======== Function 52, subfunction 15 - get local MAC address. ========
 2548 
======== Function 52, subfunction 15 - get local MAC address. ========
2549 
======================================================================
 2549 
======================================================================
2550 
Parameters:
 2550 
Parameters:
2551 
  * eax = 52 - function number
 2551 
  * eax = 52 - function number
2552 
  * ebx = 15 - subfunction number
 2552 
  * ebx = 15 - subfunction number
2553 
  * ecx = 0 - read first 4 bytes,
 2553 
  * ecx = 0 - read first 4 bytes,
2554 
    ecx = 4 - read last 2 bytes
 2554 
    ecx = 4 - read last 2 bytes
2555 
Returned value:
 2555 
Returned value:
2556 
  * for ecx=0: eax = first 4 bytes of MAC address
 2556 
  * for ecx=0: eax = first 4 bytes of MAC address
2557 
  * for ecx=4: ax = last 2 bytes of MAC address,
 2557 
  * for ecx=4: ax = last 2 bytes of MAC address,
2558 
               high half of eax is destroyed
 2558 
               high half of eax is destroyed
2559 
  * for other ecx: eax = -1 indicates an error
 2559 
  * for other ecx: eax = -1 indicates an error
2560 
 
 2560 
 
2561 
======================================================================
 2561 
======================================================================
2562 
============ Function 53, subfunction 0 - open UDP-socket. ===========
 2562 
============ Function 53, subfunction 0 - open UDP-socket. ===========
2563 
======================================================================
 2563 
======================================================================
2564 
Parameters:
 2564 
Parameters:
2565 
  * eax = 53 - function number
 2565 
  * eax = 53 - function number
2566 
  * ebx = 0 - subfunction number
 2566 
  * ebx = 0 - subfunction number
2567 
  * ecx = local port (only low word is taken into account),
 2567 
  * ecx = local port (only low word is taken into account),
2568 
    ecx = 0 - let the system choose a port
 2568 
    ecx = 0 - let the system choose a port
2569 
  * edx = remote port (only low word is taken into account)
 2569 
  * edx = remote port (only low word is taken into account)
2570 
  * esi = remote IP
 2570 
  * esi = remote IP
2571 
Returned value:
 2571 
Returned value:
2572 
  * eax = -1 = 0xFFFFFFFF - error; ebx destroyed
 2572 
  * eax = -1 = 0xFFFFFFFF - error; ebx destroyed
2573 
  * eax = socket handle (some number which unambiguously identifies
 2573 
  * eax = socket handle (some number which unambiguously identifies
2574 
    socket and have sense only for the system) - success;
 2574 
    socket and have sense only for the system) - success;
2575 
    ebx destroyed
 2575 
    ebx destroyed
2576 
 
 2576 
 
2577 
======================================================================
 2577 
======================================================================
2578 
=========== Function 53, subfunction 1 - close UDP-socket. ===========
 2578 
=========== Function 53, subfunction 1 - close UDP-socket. ===========
2579 
======================================================================
 2579 
======================================================================
2580 
Parameters:
 2580 
Parameters:
2581 
  * eax = 53 - function number
 2581 
  * eax = 53 - function number
2582 
  * ebx = 1 - subfunction number
 2582 
  * ebx = 1 - subfunction number
2583 
  * ecx = socket handle
 2583 
  * ecx = socket handle
2584 
Returned value:
 2584 
Returned value:
2585 
  * eax = -1 - incorrect handle
 2585 
  * eax = -1 - incorrect handle
2586 
  * eax = 0 - success
 2586 
  * eax = 0 - success
2587 
  * ebx destroyed
 2587 
  * ebx destroyed
2588 
Remarks:
 2588 
Remarks:
2589 
  * The current implementation does not close automatically all
 2589 
  * The current implementation does not close automatically all
2590 
    sockets of a thread at termination. In particular, one should not
 2590 
    sockets of a thread at termination. In particular, one should not
2591 
    kill a thread with many opened sockets - there will be an outflow
 2591 
    kill a thread with many opened sockets - there will be an outflow
2592 
    of resources.
 2592 
    of resources.
2593 
 
 2593 
 
2594 
======================================================================
 2594 
======================================================================
2595 
============== Function 53, subfunction 2 - poll socket. =============
 2595 
============== Function 53, subfunction 2 - poll socket. =============
2596 
======================================================================
 2596 
======================================================================
2597 
Parameters:
 2597 
Parameters:
2598 
  * eax = 53 - function number
 2598 
  * eax = 53 - function number
2599 
  * ebx = 2 - subfunction number
 2599 
  * ebx = 2 - subfunction number
2600 
  * ecx = socket handle
 2600 
  * ecx = socket handle
2601 
Returned value:
 2601 
Returned value:
2602 
  * eax = number of read bytes, 0 for incorrect handle
 2602 
  * eax = number of read bytes, 0 for incorrect handle
2603 
  * ebx destroyed
 2603 
  * ebx destroyed
2604 
 
 2604 
 
2605 
======================================================================
 2605 
======================================================================
2606 
========= Function 53, subfunction 3 - read byte from socket. ========
 2606 
========= Function 53, subfunction 3 - read byte from socket. ========
2607 
======================================================================
 2607 
======================================================================
2608 
Parameters:
 2608 
Parameters:
2609 
  * eax = 53 - function number
 2609 
  * eax = 53 - function number
2610 
  * ebx = 3 - subfunction number
 2610 
  * ebx = 3 - subfunction number
2611 
  * ecx = socket handle
 2611 
  * ecx = socket handle
2612 
Returned value:
 2612 
Returned value:
2613 
  * if there is no read data or handle is incorrect: eax=0, bl=0,
 2613 
  * if there is no read data or handle is incorrect: eax=0, bl=0,
2614 
    other bytes of ebx are destroyed
 2614 
    other bytes of ebx are destroyed
2615 
  * if there are read data: eax=number of rest bytes
 2615 
  * if there are read data: eax=number of rest bytes
2616 
    (possibly 0), bl=read byte, other bytes of ebx are destroyed
 2616 
    (possibly 0), bl=read byte, other bytes of ebx are destroyed
2617 
 
 2617 
 
2618 
======================================================================
 2618 
======================================================================
2619 
========== Function 53, subfunction 4 - write to UDP-socket. =========
 2619 
========== Function 53, subfunction 4 - write to UDP-socket. =========
2620 
======================================================================
 2620 
======================================================================
2621 
Parameters:
 2621 
Parameters:
2622 
  * eax = 53 - function number
 2622 
  * eax = 53 - function number
2623 
  * ebx = 4 - subfunction number
 2623 
  * ebx = 4 - subfunction number
2624 
  * ecx = socket handle
 2624 
  * ecx = socket handle
2625 
  * edx = number of bytes to write
 2625 
  * edx = number of bytes to write
2626 
  * esi = pointer to data to write
 2626 
  * esi = pointer to data to write
2627 
Returned value:
 2627 
Returned value:
2628 
  * eax = 0xffffffff - error (invalid handle or not enough memory)
 2628 
  * eax = 0xffffffff - error (invalid handle or not enough memory)
2629 
  * eax = 0 - success
 2629 
  * eax = 0 - success
2630 
  * ebx destroyed
 2630 
  * ebx destroyed
2631 
Remarks:
 2631 
Remarks:
2632 
  * Number of bytes to write must not exceed 1500-28, though
 2632 
  * Number of bytes to write must not exceed 1500-28, though
2633 
    the appropriate check is not made.
 2633 
    the appropriate check is not made.
2634 
 
 2634 
 
2635 
======================================================================
 2635 
======================================================================
2636 
============ Function 53, subfunction 5 - open TCP-socket. ===========
 2636 
============ Function 53, subfunction 5 - open TCP-socket. ===========
2637 
======================================================================
 2637 
======================================================================
2638 
Parameters:
 2638 
Parameters:
2639 
  * eax = 53 - function number
 2639 
  * eax = 53 - function number
2640 
  * ebx = 5 - subfunction number
 2640 
  * ebx = 5 - subfunction number
2641 
  * ecx = local port (only low word is taken into account),
 2641 
  * ecx = local port (only low word is taken into account),
2642 
    ecx = 0 - let the system choose a port
 2642 
    ecx = 0 - let the system choose a port
2643 
  * edx = remote port (only low word is taken into account)
 2643 
  * edx = remote port (only low word is taken into account)
2644 
  * esi = remote IP
 2644 
  * esi = remote IP
2645 
  * edi = open mode: SOCKET_PASSIVE=0 or SOCKET_ACTIVE=1
 2645 
  * edi = open mode: SOCKET_PASSIVE=0 or SOCKET_ACTIVE=1
2646 
Returned value:
 2646 
Returned value:
2647 
  * eax = -1 = 0xFFFFFFFF - error; ebx destroys
 2647 
  * eax = -1 = 0xFFFFFFFF - error; ebx destroys
2648 
  * eax = socket handle (some number which unambiguously identifies
 2648 
  * eax = socket handle (some number which unambiguously identifies
2649 
    socket and have sense only for the system) - success;
 2649 
    socket and have sense only for the system) - success;
2650 
    ebx destroyed
 2650 
    ebx destroyed
2651 
 
 2651 
 
2652 
======================================================================
 2652 
======================================================================
2653 
========= Function 53, subfunction 6 - get TCP-socket status. ========
 2653 
========= Function 53, subfunction 6 - get TCP-socket status. ========
2654 
======================================================================
 2654 
======================================================================
2655 
Parameters:
 2655 
Parameters:
2656 
  * eax = 53 - function number
 2656 
  * eax = 53 - function number
2657 
  * ebx = 6 - subfunction number
 2657 
  * ebx = 6 - subfunction number
2658 
  * ecx = socket handle
 2658 
  * ecx = socket handle
2659 
Returned value:
 2659 
Returned value:
2660 
  * eax = 0 for incorrect handle or socket status: one of
 2660 
  * eax = 0 for incorrect handle or socket status: one of
2661 
  * TCB_LISTEN = 1
 2661 
  * TCB_LISTEN = 1
2662 
  * TCB_SYN_SENT = 2
 2662 
  * TCB_SYN_SENT = 2
2663 
  * TCB_SYN_RECEIVED = 3
 2663 
  * TCB_SYN_RECEIVED = 3
2664 
  * TCB_ESTABLISHED = 4
 2664 
  * TCB_ESTABLISHED = 4
2665 
  * TCB_FIN_WAIT_1 = 5
 2665 
  * TCB_FIN_WAIT_1 = 5
2666 
  * TCB_FIN_WAIT_2 = 6
 2666 
  * TCB_FIN_WAIT_2 = 6
2667 
  * TCB_CLOSE_WAIT = 7
 2667 
  * TCB_CLOSE_WAIT = 7
2668 
  * TCB_CLOSING = 8
 2668 
  * TCB_CLOSING = 8
2669 
  * TCB_LAST_ASK = 9
 2669 
  * TCB_LAST_ASK = 9
2670 
  * TCB_TIME_WAIT = 10
 2670 
  * TCB_TIME_WAIT = 10
2671 
  * TCB_CLOSED = 11
 2671 
  * TCB_CLOSED = 11
2672 
  * ebx destroyed
 2672 
  * ebx destroyed
2673 
 
 2673 
 
2674 
======================================================================
 2674 
======================================================================
2675 
========== Function 53, subfunction 7 - write to TCP-socket. =========
 2675 
========== Function 53, subfunction 7 - write to TCP-socket. =========
2676 
======================================================================
 2676 
======================================================================
2677 
Parameters:
 2677 
Parameters:
2678 
  * eax = 53 - function number
 2678 
  * eax = 53 - function number
2679 
  * ebx = 7 - subfunction number
 2679 
  * ebx = 7 - subfunction number
2680 
  * ecx = socket handle
 2680 
  * ecx = socket handle
2681 
  * edx = number of bytes to write
 2681 
  * edx = number of bytes to write
2682 
  * esi = pointer to data to write
 2682 
  * esi = pointer to data to write
2683 
Returned value:
 2683 
Returned value:
2684 
  * eax = 0xffffffff - error (invalid handle or not enough memory)
 2684 
  * eax = 0xffffffff - error (invalid handle or not enough memory)
2685 
  * eax = 0 - success
 2685 
  * eax = 0 - success
2686 
  * ebx destroyed
 2686 
  * ebx destroyed
2687 
Remarks:
 2687 
Remarks:
2688 
  * Number of bytes to write must not exceed 1500-40, though
 2688 
  * Number of bytes to write must not exceed 1500-40, though
2689 
    the appropriate check is not made.
 2689 
    the appropriate check is not made.
2690 
 
 2690 
 
2691 
======================================================================
 2691 
======================================================================
2692 
=========== Function 53, subfunction 8 - close TCP-socket. ===========
 2692 
=========== Function 53, subfunction 8 - close TCP-socket. ===========
2693 
======================================================================
 2693 
======================================================================
2694 
Parameters:
 2694 
Parameters:
2695 
  * eax = 53 - function number
 2695 
  * eax = 53 - function number
2696 
  * ebx = 8 - subfunction number
 2696 
  * ebx = 8 - subfunction number
2697 
  * ecx = socket handle
 2697 
  * ecx = socket handle
2698 
Returned value:
 2698 
Returned value:
2699 
  * eax = -1 - error (invalid handle or
 2699 
  * eax = -1 - error (invalid handle or
2700 
    not enough memory for socket close packet)
 2700 
    not enough memory for socket close packet)
2701 
  * eax = 0 - success
 2701 
  * eax = 0 - success
2702 
  * ebx destroyed
 2702 
  * ebx destroyed
2703 
Remarks:
 2703 
Remarks:
2704 
  * The current implementation does not close automatically all
 2704 
  * The current implementation does not close automatically all
2705 
    sockets of a thread at termination. In particular, one should not
 2705 
    sockets of a thread at termination. In particular, one should not
2706 
    kill a thread with many opened sockets - there will be an outflow
 2706 
    kill a thread with many opened sockets - there will be an outflow
2707 
    of resources.
 2707 
    of resources.
2708 
 
 2708 
 
2709 
======================================================================
 2709 
======================================================================
2710 
=== Function 53, subfunction 9 - check whether local port is free. ===
 2710 
=== Function 53, subfunction 9 - check whether local port is free. ===
2711 
======================================================================
 2711 
======================================================================
2712 
Parameters:
 2712 
Parameters:
2713 
  * eax = 53 - function number
 2713 
  * eax = 53 - function number
2714 
  * ebx = 9 - subfunction number
 2714 
  * ebx = 9 - subfunction number
2715 
  * ecx = local port number (low 16 bits are used only)
 2715 
  * ecx = local port number (low 16 bits are used only)
2716 
Returned value:
 2716 
Returned value:
2717 
  * eax = 0 - port is used
 2717 
  * eax = 0 - port is used
2718 
  * eax = 1 - port is free
 2718 
  * eax = 1 - port is free
2719 
  * ebx destroyed
 2719 
  * ebx destroyed
2720 
 
 2720 
 
2721 
======================================================================
 2721 
======================================================================
2722 
===== Function 53, subfunction 10 - query Ethernet cable status. =====
 2722 
===== Function 53, subfunction 10 - query Ethernet cable status. =====
2723 
======================================================================
 2723 
======================================================================
2724 
Parameters:
 2724 
Parameters:
2725 
  * eax = 53 - function number
 2725 
  * eax = 53 - function number
2726 
  * ebx = 10 - subfunction number
 2726 
  * ebx = 10 - subfunction number
2727 
Returned value:
 2727 
Returned value:
2728 
  * al = -1 - a network driver is not loaded or
 2728 
  * al = -1 - a network driver is not loaded or
2729 
              does not support this function
 2729 
              does not support this function
2730 
  * al = 0 - Ethernet cable is unplugged
 2730 
  * al = 0 - Ethernet cable is unplugged
2731 
  * al = 1 - Ethernet cable is plugged
 2731 
  * al = 1 - Ethernet cable is plugged
2732 
  * ebx destroyed
 2732 
  * ebx destroyed
2733 
Remarks:
 2733 
Remarks:
2734 
  * The current kernel implementation supports this function
 2734 
  * The current kernel implementation supports this function
2735 
    only for RTL8139 network cards.
 2735 
    only for RTL8139 network cards.
2736 
 
 2736 
 
2737 
======================================================================
 2737 
======================================================================
2738 
======= Function 53, subfunction 11 - read network stack data. =======
 2738 
======= Function 53, subfunction 11 - read network stack data. =======
2739 
======================================================================
 2739 
======================================================================
2740 
Paramters:
 2740 
Paramters:
2741 
  * eax = 53 - function number
 2741 
  * eax = 53 - function number
2742 
  * ebx = 11 - subfunction number
 2742 
  * ebx = 11 - subfunction number
2743 
  * ecx = socket handle
 2743 
  * ecx = socket handle
2744 
  * edx = pointer to buffer
 2744 
  * edx = pointer to buffer
2745 
  * esi = number of bytes to read;
 2745 
  * esi = number of bytes to read;
2746 
  * esi = 0 - read all data (maximum 4096 bytes)
 2746 
  * esi = 0 - read all data (maximum 4096 bytes)
2747 
Returned value:
 2747 
Returned value:
2748 
  * eax = number of bytes read (0 for incorrect handle)
 2748 
  * eax = number of bytes read (0 for incorrect handle)
2749 
  * ebx destroyed
 2749 
  * ebx destroyed
2750 
 
 2750 
 
2751 
======================================================================
 2751 
======================================================================
2752 
= Function 53, subfunction 255 - debug information of network driver.
 2752 
= Function 53, subfunction 255 - debug information of network driver.
2753 
======================================================================
 2753 
======================================================================
2754 
Parameters:
 2754 
Parameters:
2755 
  * eax = 53 - function number
 2755 
  * eax = 53 - function number
2756 
  * ebx = 255 - subfunction number
 2756 
  * ebx = 255 - subfunction number
2757 
  * ecx = type of requested information (see below)
 2757 
  * ecx = type of requested information (see below)
2758 
Returned value:
 2758 
Returned value:
2759 
  * eax = requested information
 2759 
  * eax = requested information
2760 
  * ebx destroyed
 2760 
  * ebx destroyed
2761 
Possible values for ecx:
 2761 
Possible values for ecx:
2762 
  * 100: length of queue 0 (empty queue)
 2762 
  * 100: length of queue 0 (empty queue)
2763 
  * 101: length of queue 1 (ip-out queue)
 2763 
  * 101: length of queue 1 (ip-out queue)
2764 
  * 102: length of queue 2 (ip-in queue)
 2764 
  * 102: length of queue 2 (ip-in queue)
2765 
  * 103: length of queue 3 (net1out queue)
 2765 
  * 103: length of queue 3 (net1out queue)
2766 
  * 200: number of items in the ARP table
 2766 
  * 200: number of items in the ARP table
2767 
  * 201: size of the ARP table (in items) (20 for current version)
 2767 
  * 201: size of the ARP table (in items) (20 for current version)
2768 
  * 202: read item at edx of the ARP table to the temporary buffer,
 2768 
  * 202: read item at edx of the ARP table to the temporary buffer,
2769 
    whence 5 following types take information;
 2769 
    whence 5 following types take information;
2770 
    in this case eax is not defined
 2770 
    in this case eax is not defined
2771 
  * 203: IP-address saved by type 202
 2771 
  * 203: IP-address saved by type 202
2772 
  * 204: high dword of MAC-address saved by type 202
 2772 
  * 204: high dword of MAC-address saved by type 202
2773 
  * 205: low word of MAC-address saved by type 202
 2773 
  * 205: low word of MAC-address saved by type 202
2774 
  * 206: status word saved by type 202
 2774 
  * 206: status word saved by type 202
2775 
  * 207: ttl word saved by type 202
 2775 
  * 207: ttl word saved by type 202
2776 
  * 2: total number of received IP-packets
 2776 
  * 2: total number of received IP-packets
2777 
  * 3: total number of transferred IP-packets
 2777 
  * 3: total number of transferred IP-packets
2778 
  * 4: total number of dumped received packets
 2778 
  * 4: total number of dumped received packets
2779 
  * 5: total number of received ARP-packets
 2779 
  * 5: total number of received ARP-packets
2780 
  * 6: status of packet driver, 0=inactive, nonzero=active
 2780 
  * 6: status of packet driver, 0=inactive, nonzero=active
2781 
 
 2781 
 
2782 
======================================================================
 2782 
======================================================================
2783 
 Function 55, subfunction 55 - begin to play data on built-in speaker.
 2783 
 Function 55, subfunction 55 - begin to play data on built-in speaker.
2784 
======================================================================
 2784 
======================================================================
2785 
Parameters:
 2785 
Parameters:
2786 
  * eax = 55 - function number
 2786 
  * eax = 55 - function number
2787 
  * ebx = 55 - subfunction number
 2787 
  * ebx = 55 - subfunction number
2788 
  * esi = pointer to data
 2788 
  * esi = pointer to data
2789 
Returned value:
 2789 
Returned value:
2790 
  * eax = 0 - success
 2790 
  * eax = 0 - success
2791 
  * eax = 55 - error (speaker is off or busy)
 2791 
  * eax = 55 - error (speaker is off or busy)
2792 
Data is an array of items with variable length.
 2792 
Data is an array of items with variable length.
2793 
Format of each item is defined by first byte:
 2793 
Format of each item is defined by first byte:
2794 
  * 0 = end of data
 2794 
  * 0 = end of data
2795 
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
 2795 
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
2796 
    is defined by immediate value of frequency
 2796 
    is defined by immediate value of frequency
2797 
    * following word (2 bytes) contains frequency divider;
 2797 
    * following word (2 bytes) contains frequency divider;
2798 
      frequency is defined as 1193180/divider
 2798 
      frequency is defined as 1193180/divider
2799 
  * 0x81 = invalid
 2799 
  * 0x81 = invalid
2800 
  * 0x82..0xFF = note is defined by octave and number:
 2800 
  * 0x82..0xFF = note is defined by octave and number:
2801 
    * duration in 1/100 of second = (first byte)-0x81
 2801 
    * duration in 1/100 of second = (first byte)-0x81
2802 
    * there is one more byte;
 2802 
    * there is one more byte;
2803 
    * (second byte)=0xFF - delay
 2803 
    * (second byte)=0xFF - delay
2804 
    * otherwise it looks like a*0x10+b, where b=number of the note in
 2804 
    * otherwise it looks like a*0x10+b, where b=number of the note in
2805 
      an octave from 1 to 12, a=number of octave (beginning from 0)
 2805 
      an octave from 1 to 12, a=number of octave (beginning from 0)
2806 
Remarks:
 2806 
Remarks:
2807 
  * Speaker play can be disabled/enabled by
 2807 
  * Speaker play can be disabled/enabled by
2808 
    subfunction 8 of function 18.
 2808 
    subfunction 8 of function 18.
2809 
  * Function returns control, having informed the system
 2809 
  * Function returns control, having informed the system
2810 
    an information on request. Play itself goes independently from
 2810 
    an information on request. Play itself goes independently from
2811 
    the program.
 2811 
    the program.
2812 
  * The data must be kept in the memory at least up to the end
 2812 
  * The data must be kept in the memory at least up to the end
2813 
    of play.
 2813 
    of play.
2814 
 
 2814 
 
2815 
======================================================================
 2815 
======================================================================
2816 
======================= Function 57 - PCI BIOS. ======================
 2816 
======================= Function 57 - PCI BIOS. ======================
2817 
======================================================================
 2817 
======================================================================
2818 
Parameters:
 2818 
Parameters:
2819 
  * eax = 57 - function number
 2819 
  * eax = 57 - function number
2820 
  * ebp corresponds to al in PCI BIOS specification
 2820 
  * ebp corresponds to al in PCI BIOS specification
2821 
  * other registers are set according to PCI BIOS specification
 2821 
  * other registers are set according to PCI BIOS specification
2822 
Returned value:
 2822 
Returned value:
2823 
  * CF is undefined
 2823 
  * CF is undefined
2824 
  * other registers are set according to PCI BIOS specification
 2824 
  * other registers are set according to PCI BIOS specification
2825 
Remarks:
 2825 
Remarks:
2826 
  * Many effects of this function can be also achieved with
 2826 
  * Many effects of this function can be also achieved with
2827 
    corresponding subfunctions of function 62.
 2827 
    corresponding subfunctions of function 62.
2828 
  * The function calls PCI32 BIOS extension, documented e.g. in
 2828 
  * The function calls PCI32 BIOS extension, documented e.g. in
2829 
    http://alpha1.dyns.net/files/PCI/bios21.pdf.
 2829 
    http://alpha1.dyns.net/files/PCI/bios21.pdf.
2830 
  * If BIOS does not support this extension, its behavior is emulated
 2830 
  * If BIOS does not support this extension, its behavior is emulated
2831 
    (through kernel-mode analogues of subfunctions of function 62).
 2831 
    (through kernel-mode analogues of subfunctions of function 62).
2832 
 
 2832 
 
2833 
======================================================================
 2833 
======================================================================
2834 
================ Function 58 - work with file system. ================
 2834 
================ Function 58 - work with file system. ================
2835 
======================================================================
 2835 
======================================================================
2836 
Parameters:
 2836 
Parameters:
2837 
  * eax = 58
 2837 
  * eax = 58
2838 
  * ebx = pointer to the information structure
 2838 
  * ebx = pointer to the information structure
2839 
Returned value:
 2839 
Returned value:
2840 
  * eax = 0 - success; otherwise file system error code
 2840 
  * eax = 0 - success; otherwise file system error code
2841 
  * some subfunctions return value in other registers too
 2841 
  * some subfunctions return value in other registers too
2842 
General format of the information structure:
 2842 
General format of the information structure:
2843 
  * +0: dword: subfunction number
 2843 
  * +0: dword: subfunction number
2844 
  * +4: dword: number of block
 2844 
  * +4: dword: number of block
2845 
  * +8: dword: size
 2845 
  * +8: dword: size
2846 
  * +12 = +0xC: dword: pointer to data
 2846 
  * +12 = +0xC: dword: pointer to data
2847 
  * +16 = +0x10: dword: pointer to a memory for system operations
 2847 
  * +16 = +0x10: dword: pointer to a memory for system operations
2848 
    (4096 bytes)
 2848 
    (4096 bytes)
2849 
  * +20 = +0x14: n db: ASCIIZ-string with the file name
 2849 
  * +20 = +0x14: n db: ASCIIZ-string with the file name
2850 
Specifications - in documentation on the appropriate subfunction.
 2850 
Specifications - in documentation on the appropriate subfunction.
2851 
Filename is case-insensitive for latin letters, russian letters
 2851 
Filename is case-insensitive for latin letters, russian letters
2852 
must be capital.
 2852 
must be capital.
2853 
Format of filename:
 2853 
Format of filename:
2854 
/base/number/dir1/dir2/.../dirn/file,
 2854 
/base/number/dir1/dir2/.../dirn/file,
2855 
where /base/number identifies device, on which file is located:
 2855 
where /base/number identifies device, on which file is located:
2856 
one of
 2856 
one of
2857 
  * /RD/1 = /RAMDISK/1 to access ramdisk
 2857 
  * /RD/1 = /RAMDISK/1 to access ramdisk
2858 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
 2858 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
2859 
    /FD/2 = /FLOPPYDISK/2 to access second one
 2859 
    /FD/2 = /FLOPPYDISK/2 to access second one
2860 
  * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk
 2860 
  * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk
2861 
    (in this case base is defined by subfunction 7 of function 21),
 2861 
    (in this case base is defined by subfunction 7 of function 21),
2862 
    x - partition number (beginning from 1)
 2862 
    x - partition number (beginning from 1)
2863 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
 2863 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
2864 
    IDE0 (Primary Master), IDE1 (Primary Slave),
 2864 
    IDE0 (Primary Master), IDE1 (Primary Slave),
2865 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
 2865 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2866 
    x - partition number on the selected hard drive, varies from 1
 2866 
    x - partition number on the selected hard drive, varies from 1
2867 
    to 255 (on each hard drive the indexing starts from 1)
 2867 
    to 255 (on each hard drive the indexing starts from 1)
2868 
Remarks:
 2868 
Remarks:
2869 
  * In the first two cases it is also possible to use FIRST
 2869 
  * In the first two cases it is also possible to use FIRST
2870 
    instead of 1, SECOND instead of 2, but it is not recommended
 2870 
    instead of 1, SECOND instead of 2, but it is not recommended
2871 
    for convenience of transition to the future extensions.
 2871 
    for convenience of transition to the future extensions.
2872 
  * Limitation n<=39 is imposed.
 2872 
  * Limitation n<=39 is imposed.
2873 
  * Names of folders and file dir1,...,dirn,file must have the
 2873 
  * Names of folders and file dir1,...,dirn,file must have the
2874 
    format 8.3: name no more than 8 characters, dot, extension no
 2874 
    format 8.3: name no more than 8 characters, dot, extension no
2875 
    more than 3 characters. Trailing spaces are ignored, no other
 2875 
    more than 3 characters. Trailing spaces are ignored, no other
2876 
    spaces is allowed. If name occupies equally 8 characters,
 2876 
    spaces is allowed. If name occupies equally 8 characters,
2877 
    dot may be omitted (though it is not recommended to use this
 2877 
    dot may be omitted (though it is not recommended to use this
2878 
    feature for convenience of transition to the future extensions).
 2878 
    feature for convenience of transition to the future extensions).
2879 
  * This function does not support folders on ramdisk.
 2879 
  * This function does not support folders on ramdisk.
2880 
Examples:
 2880 
Examples:
2881 
  * '/RAMDISK/FIRST/KERNEL.ASM',0
 2881 
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2882 
    '/rd/1/kernel.asm',0
 2882 
    '/rd/1/kernel.asm',0
2883 
  * '/HD0/1/kernel.asm',0
 2883 
  * '/HD0/1/kernel.asm',0
2884 
  * '/hd0/1/menuet/pics/tanzania.bmp',0
 2884 
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2885 
Existing subfunctions:
 2885 
Existing subfunctions:
2886 
  * subfunction 0 - read file/folder
 2886 
  * subfunction 0 - read file/folder
2887 
  * subfunction 8 - LBA-read from device
 2887 
  * subfunction 8 - LBA-read from device
2888 
  * subfunction 15 - get file system information
 2888 
  * subfunction 15 - get file system information
2889 
 
 2889 
 
2890 
======================================================================
 2890 
======================================================================
2891 
=========== Function 58, subfunction 0 - read file/folder. ===========
 2891 
=========== Function 58, subfunction 0 - read file/folder. ===========
2892 
======================================================================
 2892 
======================================================================
2893 
Parameters:
 2893 
Parameters:
2894 
  * eax = 58
 2894 
  * eax = 58
2895 
  * ebx = pointer to the information structure
 2895 
  * ebx = pointer to the information structure
2896 
Format of the information structure:
 2896 
Format of the information structure:
2897 
  * +0: dword: 0 = subfunction number
 2897 
  * +0: dword: 0 = subfunction number
2898 
  * +4: dword: first block to read (beginning from 0)
 2898 
  * +4: dword: first block to read (beginning from 0)
2899 
  * +8: dword: amount of blocks to read
 2899 
  * +8: dword: amount of blocks to read
2900 
  * +12 = +0xC: dword: pointer to buffer for data
 2900 
  * +12 = +0xC: dword: pointer to buffer for data
2901 
  * +16 = +0x10: dword: pointer to buffer for system operations
 2901 
  * +16 = +0x10: dword: pointer to buffer for system operations
2902 
    (4096 bytes)
 2902 
    (4096 bytes)
2903 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 2903 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
2904 
    given in the general description
 2904 
    given in the general description
2905 
Returned value:
 2905 
Returned value:
2906 
  * eax = 0 - success, otherwise file system error code
 2906 
  * eax = 0 - success, otherwise file system error code
2907 
  * ebx = file size (in bytes) or -1=0xffffffff, if file was not found
 2907 
  * ebx = file size (in bytes) or -1=0xffffffff, if file was not found
2908 
Remarks:
 2908 
Remarks:
2909 
  * Block size is 512 bytes.
 2909 
  * Block size is 512 bytes.
2910 
  * This function is obsolete, for reading files use subfunction 0
 2910 
  * This function is obsolete, for reading files use subfunction 0
2911 
    of function 70, for reading folders - subfunction 1 of
 2911 
    of function 70, for reading folders - subfunction 1 of
2912 
    function 70.
 2912 
    function 70.
2913 
  * Function can read contents of a folder. Only FAT file system is
 2913 
  * Function can read contents of a folder. Only FAT file system is
2914 
    supported. The format of FAT-folder is described
 2914 
    supported. The format of FAT-folder is described
2915 
    in any FAT documentation.
 2915 
    in any FAT documentation.
2916 
  * Size of a folder is determined by size of FAT clusters chain.
 2916 
  * Size of a folder is determined by size of FAT clusters chain.
2917 
  * If file was ended before last requested block was read,
 2917 
  * If file was ended before last requested block was read,
2918 
    the function will read as many as it can, and after that return
 2918 
    the function will read as many as it can, and after that return
2919 
    eax=6 (EOF).
 2919 
    eax=6 (EOF).
2920 
  * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but
 2920 
  * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but
2921 
    in the first two cases the current implementation does not follow
 2921 
    in the first two cases the current implementation does not follow
2922 
    to the declared rules:
 2922 
    to the declared rules:
2923 
    for /rd/1:
 2923 
    for /rd/1:
2924 
    * if one want to read 0 blocks, function considers,
 2924 
    * if one want to read 0 blocks, function considers,
2925 
      that he requested 1;
 2925 
      that he requested 1;
2926 
    * if one requests more than 14 blocks or starting block is
 2926 
    * if one requests more than 14 blocks or starting block is
2927 
      not less than 14, function returns eax=5 (not found) è ebx=-1;
 2927 
      not less than 14, function returns eax=5 (not found) è ebx=-1;
2928 
    * size of ramdisk root folder is 14 blocks,
 2928 
    * size of ramdisk root folder is 14 blocks,
2929 
      0x1C00=7168 áàéò; but function returns ebx=0
 2929 
      0x1C00=7168 áàéò; but function returns ebx=0
2930 
      (except of the case of previous item);
 2930 
      (except of the case of previous item);
2931 
    * strangely enough, it is possible to read 14th block (which
 2931 
    * strangely enough, it is possible to read 14th block (which
2932 
      generally contains a garbage - I remind, the indexing begins
 2932 
      generally contains a garbage - I remind, the indexing begins
2933 
      from 0);
 2933 
      from 0);
2934 
    * if some block with the number not less than 14 was requested,
 2934 
    * if some block with the number not less than 14 was requested,
2935 
      function returns eax=6(EOF); otherwise eax=0.
 2935 
      function returns eax=6(EOF); otherwise eax=0.
2936 
    For /fd/x:
 2936 
    For /fd/x:
2937 
    * if the start block is not less than 14, function returns
 2937 
    * if the start block is not less than 14, function returns
2938 
      eax=5 (not found) and ebx=0;
 2938 
      eax=5 (not found) and ebx=0;
2939 
    * note that format of FAT12 allows floppies with the root size
 2939 
    * note that format of FAT12 allows floppies with the root size
2940 
      more or less than 14 blocks;
 2940 
      more or less than 14 blocks;
2941 
    * check for length is not performed;
 2941 
    * check for length is not performed;
2942 
    * if data was successful read, function returns
 2942 
    * if data was successful read, function returns
2943 
      eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1.
 2943 
      eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1.
2944 
  * The function handles reading of special folders /,/rd,/fd,/hd[n];
 2944 
  * The function handles reading of special folders /,/rd,/fd,/hd[n];
2945 
    but the result does not correspond to expected (on operations with
 2945 
    but the result does not correspond to expected (on operations with
2946 
    normal files/folders), does not follow the declared rules,
 2946 
    normal files/folders), does not follow the declared rules,
2947 
    may be changed in future versions of the kernel and consequently
 2947 
    may be changed in future versions of the kernel and consequently
2948 
    is not described. To obtain the information about the equipment
 2948 
    is not described. To obtain the information about the equipment
2949 
    use subfunction 11 of function 18 or
 2949 
    use subfunction 11 of function 18 or
2950 
    read corresponding folder with subfunction 1 of function 70.
 2950 
    read corresponding folder with subfunction 1 of function 70.
2951 
 
 2951 
 
2952 
======================================================================
 2952 
======================================================================
2953 
========= Function 58, subfunction 8 - LBA-read from device. =========
 2953 
========= Function 58, subfunction 8 - LBA-read from device. =========
2954 
======================================================================
 2954 
======================================================================
2955 
Parameters:
 2955 
Parameters:
2956 
  * eax = 58 - function number
 2956 
  * eax = 58 - function number
2957 
  * ebx = pointer to the information structure
 2957 
  * ebx = pointer to the information structure
2958 
Format of the information structure:
 2958 
Format of the information structure:
2959 
  * +0: dword: 8 = subfunction number
 2959 
  * +0: dword: 8 = subfunction number
2960 
  * +4: dword: number of block to read (beginning from 0)
 2960 
  * +4: dword: number of block to read (beginning from 0)
2961 
  * +8: dword: ignored (set to 1)
 2961 
  * +8: dword: ignored (set to 1)
2962 
  * +12 = +0xC: dword: pointer to buffer for data (512 bytes)
 2962 
  * +12 = +0xC: dword: pointer to buffer for data (512 bytes)
2963 
  * +16 = +0x10: dword: pointer to buffer for system operations
 2963 
  * +16 = +0x10: dword: pointer to buffer for system operations
2964 
    (4096 bytes)
 2964 
    (4096 bytes)
2965 
  * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of
 2965 
  * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of
2966 
    /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
 2966 
    /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
2967 
    1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3.
 2967 
    1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3.
2968 
    Instead of digits it is allowed, though not recommended for
 2968 
    Instead of digits it is allowed, though not recommended for
2969 
    convenience of transition to future extensions, to use
 2969 
    convenience of transition to future extensions, to use
2970 
    'first','second','third','fourth'.
 2970 
    'first','second','third','fourth'.
2971 
Returned value:
 2971 
Returned value:
2972 
  * for device name /hd/xxx, where xxx is not in the list above:
 2972 
  * for device name /hd/xxx, where xxx is not in the list above:
2973 
    * eax = ebx = 1
 2973 
    * eax = ebx = 1
2974 
  * for invalid device name (except for the previous case):
 2974 
  * for invalid device name (except for the previous case):
2975 
    * eax = 5
 2975 
    * eax = 5
2976 
    * ebx does not change
 2976 
    * ebx does not change
2977 
  * if LBA-access is disabled by subfunction 11 of function 21:
 2977 
  * if LBA-access is disabled by subfunction 11 of function 21:
2978 
    * eax = 2
 2978 
    * eax = 2
2979 
    * ebx destroyed
 2979 
    * ebx destroyed
2980 
  * for ramdisk: attempt to read block outside ramdisk
 2980 
  * for ramdisk: attempt to read block outside ramdisk
2981 
    (18*2*80 blocks) results in
 2981 
    (18*2*80 blocks) results in
2982 
    * eax = 3
 2982 
    * eax = 3
2983 
    * ebx = 0
 2983 
    * ebx = 0
2984 
  * for successful read:
 2984 
  * for successful read:
2985 
    * eax = ebx = 0
 2985 
    * eax = ebx = 0
2986 
Remarks:
 2986 
Remarks:
2987 
  * Block size is 512 bytes; function reads one block.
 2987 
  * Block size is 512 bytes; function reads one block.
2988 
  * Do not depend on returned value, it can be changed
 2988 
  * Do not depend on returned value, it can be changed
2989 
    in future versions.
 2989 
    in future versions.
2990 
  * Function requires that LBA-access to devices is enabled by
 2990 
  * Function requires that LBA-access to devices is enabled by
2991 
    subfunction 11 of function 21. To check this one can use
 2991 
    subfunction 11 of function 21. To check this one can use
2992 
    subfunction 11 of function 26.
 2992 
    subfunction 11 of function 26.
2993 
  * LBA-read of floppy is not supported.
 2993 
  * LBA-read of floppy is not supported.
2994 
  * Function reads data on physical hard drive; if for any reason
 2994 
  * Function reads data on physical hard drive; if for any reason
2995 
    data of the concrete partition are required, application must
 2995 
    data of the concrete partition are required, application must
2996 
    define starting sector of this partition (either directly
 2996 
    define starting sector of this partition (either directly
2997 
    through MBR, or from the full structure returned by
 2997 
    through MBR, or from the full structure returned by
2998 
    ïîäôóíêöèåé 11 ôóíêöèè 18).
 2998 
    ïîäôóíêöèåé 11 ôóíêöèè 18).
2999 
  * Function does not check error code of hard disk, so request of
 2999 
  * Function does not check error code of hard disk, so request of
3000 
    nonexisting sector reads something (most probably it will be
 3000 
    nonexisting sector reads something (most probably it will be
3001 
    zeroes, but this is defined by device) and this is considered
 3001 
    zeroes, but this is defined by device) and this is considered
3002 
    as success (eax=0).
 3002 
    as success (eax=0).
3003 
 
 3003 
 
3004 
======================================================================
 3004 
======================================================================
3005 
==== Function 58, subfunction 15 - get information on file system. ===
 3005 
==== Function 58, subfunction 15 - get information on file system. ===
3006 
======================================================================
 3006 
======================================================================
3007 
Parameters:
 3007 
Parameters:
3008 
  * eax = 58 - function number
 3008 
  * eax = 58 - function number
3009 
  * ebx = pointer to the information structure
 3009 
  * ebx = pointer to the information structure
3010 
Format of the information structure:
 3010 
Format of the information structure:
3011 
  * +0: dword: 15 = subfunction number
 3011 
  * +0: dword: 15 = subfunction number
3012 
  * +4: dword: ignored
 3012 
  * +4: dword: ignored
3013 
  * +8: dword: ignored
 3013 
  * +8: dword: ignored
3014 
  * +12 = +0xC: dword: ignored
 3014 
  * +12 = +0xC: dword: ignored
3015 
  * +16 = +0x10: dword: ignored
 3015 
  * +16 = +0x10: dword: ignored
3016 
  * +20 = +0x14: (only second character is checked)
 3016 
  * +20 = +0x14: (only second character is checked)
3017 
    /rd=/RAMDISK or /hd=/HARDDISK
 3017 
    /rd=/RAMDISK or /hd=/HARDDISK
3018 
Returned value:
 3018 
Returned value:
3019 
  * if the second character does not belong to set {'r','R','h','H'}:
 3019 
  * if the second character does not belong to set {'r','R','h','H'}:
3020 
    * eax = 3
 3020 
    * eax = 3
3021 
    * ebx = ecx = dword [fileinfo] = 0
 3021 
    * ebx = ecx = dword [fileinfo] = 0
3022 
  * for ramdisk:
 3022 
  * for ramdisk:
3023 
    * eax = 0 (success)
 3023 
    * eax = 0 (success)
3024 
    * ebx = total number of clusters = 2847
 3024 
    * ebx = total number of clusters = 2847
3025 
    * ecx = number of free clusters
 3025 
    * ecx = number of free clusters
3026 
    * dword [fileinfo] = cluster size = 512
 3026 
    * dword [fileinfo] = cluster size = 512
3027 
  * for hard disk: base and partition are defined by subfunctions
 3027 
  * for hard disk: base and partition are defined by subfunctions
3028 
    7 and 8 of function 21:
 3028 
    7 and 8 of function 21:
3029 
    * eax = 0 (success)
 3029 
    * eax = 0 (success)
3030 
    * ebx = total number of clusters
 3030 
    * ebx = total number of clusters
3031 
    * ecx = number of free clusters
 3031 
    * ecx = number of free clusters
3032 
    * dword [fileinfo] = cluster size (in bytes)
 3032 
    * dword [fileinfo] = cluster size (in bytes)
3033 
Remarks:
 3033 
Remarks:
3034 
  * Be not surprised to strange layout of 4th returned parameter
 3034 
  * Be not surprised to strange layout of 4th returned parameter
3035 
    - when this code was writing, at system calls application got
 3035 
    - when this code was writing, at system calls application got
3036 
    only registers eax,ebx,ecx (from pushad-structure transmitted
 3036 
    only registers eax,ebx,ecx (from pushad-structure transmitted
3037 
    as argument to the system function). Now it is corrected, so,
 3037 
    as argument to the system function). Now it is corrected, so,
3038 
    probably, it is meaningful to return cluster size in edx, while
 3038 
    probably, it is meaningful to return cluster size in edx, while
3039 
    this function is not used yet.
 3039 
    this function is not used yet.
3040 
  * There exists also subfunction 11 of function 18,
 3040 
  * There exists also subfunction 11 of function 18,
3041 
    which returns information on file system. From the full table
 3041 
    which returns information on file system. From the full table
3042 
    of disk subsystem it is possible to deduce cluster size (there
 3042 
    of disk subsystem it is possible to deduce cluster size (there
3043 
    it is stored in sectors) and total number of clusters
 3043 
    it is stored in sectors) and total number of clusters
3044 
    for hard disks.
 3044 
    for hard disks.
3045 
 
 3045 
 
3046 
======================================================================
 3046 
======================================================================
3047 
========== Function 60 - Inter Process Communication (IPC). ==========
 3047 
========== Function 60 - Inter Process Communication (IPC). ==========
3048 
======================================================================
 3048 
======================================================================
3049 
IPC is used for message dispatching from one process/thread to
 3049 
IPC is used for message dispatching from one process/thread to
3050 
another. Previously it is necessary to agree how to interpret
 3050 
another. Previously it is necessary to agree how to interpret
3051 
the concrete message.
 3051 
the concrete message.
3052 
 
 3052 
 
3053 
----------- Subfunction 1 - set the area for IPC receiving -----------
 3053 
----------- Subfunction 1 - set the area for IPC receiving -----------
3054 
Is called by process-receiver.
 3054 
Is called by process-receiver.
3055 
Parameters:
 3055 
Parameters:
3056 
  * eax = 60 - function number
 3056 
  * eax = 60 - function number
3057 
  * ebx = 1 - subfunction number
 3057 
  * ebx = 1 - subfunction number
3058 
  * ecx = pointer to the buffer
 3058 
  * ecx = pointer to the buffer
3059 
  * edx = size of the buffer
 3059 
  * edx = size of the buffer
3060 
Returned value:
 3060 
Returned value:
3061 
  * eax = 0 - always success
 3061 
  * eax = 0 - always success
3062 
Format of IPC-buffer:
 3062 
Format of IPC-buffer:
3063 
  * +0: dword: if nonzero, buffer is considered locked;
 3063 
  * +0: dword: if nonzero, buffer is considered locked;
3064 
    lock/unlock the buffer, when you work with it and need that
 3064 
    lock/unlock the buffer, when you work with it and need that
3065 
    buffer data are not changed from outside (no new messages)
 3065 
    buffer data are not changed from outside (no new messages)
3066 
  * +4: dword: occupied place in the buffer (in bytes)
 3066 
  * +4: dword: occupied place in the buffer (in bytes)
3067 
  * +8: first message
 3067 
  * +8: first message
3068 
  * +8+n: second message
 3068 
  * +8+n: second message
3069 
  * ...
 3069 
  * ...
3070 
Format of a message:
 3070 
Format of a message:
3071 
  * +0: dword: PID of sender
 3071 
  * +0: dword: PID of sender
3072 
  * +4: dword: message length (not including this header)
 3072 
  * +4: dword: message length (not including this header)
3073 
  * +8: n*byte: message data
 3073 
  * +8: n*byte: message data
3074 
 
 3074 
 
3075 
------------------ Subfunction 2 - send IPC message ------------------
 3075 
------------------ Subfunction 2 - send IPC message ------------------
3076 
Is called by process-sender.
 3076 
Is called by process-sender.
3077 
Parameters:
 3077 
Parameters:
3078 
  * eax = 60 - function number
 3078 
  * eax = 60 - function number
3079 
  * ebx = 2 - subfunction number
 3079 
  * ebx = 2 - subfunction number
3080 
  * ecx = PID of receiver
 3080 
  * ecx = PID of receiver
3081 
  * edx = pointer to the message data
 3081 
  * edx = pointer to the message data
3082 
  * esi = message length (in bytes)
 3082 
  * esi = message length (in bytes)
3083 
Returned value:
 3083 
Returned value:
3084 
  * eax = 0 - success
 3084 
  * eax = 0 - success
3085 
  * eax = 1 - the receiver has not defined buffer for IPC messages
 3085 
  * eax = 1 - the receiver has not defined buffer for IPC messages
3086 
    (can be, still have no time,
 3086 
    (can be, still have no time,
3087 
    and can be, this is not right process)
 3087 
    and can be, this is not right process)
3088 
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
 3088 
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
3089 
  * eax = 3 - overflow of IPC-buffer of the receiver
 3089 
  * eax = 3 - overflow of IPC-buffer of the receiver
3090 
  * eax = 4 - process/thread with such PID does not exist
 3090 
  * eax = 4 - process/thread with such PID does not exist
3091 
Remarks:
 3091 
Remarks:
3092 
  * Immediately after writing of IPC-message to the buffer the system
 3092 
  * Immediately after writing of IPC-message to the buffer the system
3093 
    sends to the receiver the event with code 7 (see event codes).
 3093 
    sends to the receiver the event with code 7 (see event codes).
3094 
 
 3094 
 
3095 
======================================================================
 3095 
======================================================================
3096 
==== Function 61 - get parameters for the direct graphics access. ====
 3096 
==== Function 61 - get parameters for the direct graphics access. ====
3097 
======================================================================
 3097 
======================================================================
3098 
The data of the graphics screen (the memory area which displays
 3098 
The data of the graphics screen (the memory area which displays
3099 
screen contents) are accessible to a program directly, without
 3099 
screen contents) are accessible to a program directly, without
3100 
any system calls, through the selector gs:
 3100 
any system calls, through the selector gs:
3101 
        mov     eax, [gs:0]
 3101 
        mov     eax, [gs:0]
3102 
places in eax the first dword of the buffer, which contains
 3102 
places in eax the first dword of the buffer, which contains
3103 
information on color of the left upper point (and, possibly, colors
 3103 
information on color of the left upper point (and, possibly, colors
3104 
of several following).
 3104 
of several following).
3105 
        mov     [gs:0], eax
 3105 
        mov     [gs:0], eax
3106 
by work in VESA modes with LFB sets color of the left upper point
 3106 
by work in VESA modes with LFB sets color of the left upper point
3107 
(and, possibly, colors of several following).
 3107 
(and, possibly, colors of several following).
3108 
To interpret the data of graphics screen program needs to know
 3108 
To interpret the data of graphics screen program needs to know
3109 
some parameters, returning by this function.
 3109 
some parameters, returning by this function.
3110 
Remarks:
 3110 
Remarks:
3111 
  * Graphics parameters changes very seldom at work,
 3111 
  * Graphics parameters changes very seldom at work,
3112 
    namely, only in cases, when user works with the application VRR.
 3112 
    namely, only in cases, when user works with the application VRR.
3113 
  * At videomode change the system redraws all windows (event
 3113 
  * At videomode change the system redraws all windows (event
3114 
    with code 1) and redraws the background (event 5).
 3114 
    with code 1) and redraws the background (event 5).
3115 
    Same events occur in other cases too, which meet much more often,
 3115 
    Same events occur in other cases too, which meet much more often,
3116 
    than videomode change.
 3116 
    than videomode change.
3117 
  * By operation in videomodes with LFB the selector gs points to
 3117 
  * By operation in videomodes with LFB the selector gs points to
3118 
    LFB itself, so reading/writing on gs result directly in
 3118 
    LFB itself, so reading/writing on gs result directly in
3119 
    change of screen contents. By operation in videomodes without
 3119 
    change of screen contents. By operation in videomodes without
3120 
    LFB gs points to some data area in the kernel, and all functions
 3120 
    LFB gs points to some data area in the kernel, and all functions
3121 
    of screen output fulfil honesty double operation on writing
 3121 
    of screen output fulfil honesty double operation on writing
3122 
    directly to the screen and writing to this buffer. In result
 3122 
    directly to the screen and writing to this buffer. In result
3123 
    at reading contents of this buffer the results correspond to
 3123 
    at reading contents of this buffer the results correspond to
3124 
    screen contents (with, generally speaking, large color
 3124 
    screen contents (with, generally speaking, large color
3125 
    resolution), and writing is ignored.
 3125 
    resolution), and writing is ignored.
3126 
    One exception is the mode 320*200, for which main loop of the
 3126 
    One exception is the mode 320*200, for which main loop of the
3127 
    system thread updates the screen according to mouse movements.
 3127 
    system thread updates the screen according to mouse movements.
3128 
 
 3128 
 
3129 
------------------------- Screen resolution --------------------------
 3129 
------------------------- Screen resolution --------------------------
3130 
Parameters:
 3130 
Parameters:
3131 
  * eax = 61 - function number
 3131 
  * eax = 61 - function number
3132 
  * ebx = 1 - subfunction number
 3132 
  * ebx = 1 - subfunction number
3133 
Returned value:
 3133 
Returned value:
3134 
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
 3134 
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
3135 
Remarks:
 3135 
Remarks:
3136 
  * One can use function 14 paying attention that
 3136 
  * One can use function 14 paying attention that
3137 
    it returns sizes on 1 pixel less. It is fully equivalent way.
 3137 
    it returns sizes on 1 pixel less. It is fully equivalent way.
3138 
 
 3138 
 
3139 
---------------------- Number of bits per pixel ----------------------
 3139 
---------------------- Number of bits per pixel ----------------------
3140 
Parameters:
 3140 
Parameters:
3141 
  * eax = 61 - function number
 3141 
  * eax = 61 - function number
3142 
  * ebx = 2 - subfunction number
 3142 
  * ebx = 2 - subfunction number
3143 
Returned value:
 3143 
Returned value:
3144 
  * eax = number of bits per pixel (24 or 32)
 3144 
  * eax = number of bits per pixel (24 or 32)
3145 
 
 3145 
 
3146 
-------------------- Number of bytes per scanline --------------------
 3146 
-------------------- Number of bytes per scanline --------------------
3147 
Parameters:
 3147 
Parameters:
3148 
  * eax = 61 - function number
 3148 
  * eax = 61 - function number
3149 
  * ebx = 3 - subfunction number
 3149 
  * ebx = 3 - subfunction number
3150 
Returned value:
 3150 
Returned value:
3151 
  * eax = number of bytes occupied by one scanline
 3151 
  * eax = number of bytes occupied by one scanline
3152 
    (horizontal line on the screen)
 3152 
    (horizontal line on the screen)
3153 
 
 3153 
 
3154 
======================================================================
 3154 
======================================================================
3155 
===== Function 62, subfunction 0 - get version of PCI-interface. =====
 3155 
===== Function 62, subfunction 0 - get version of PCI-interface. =====
3156 
======================================================================
 3156 
======================================================================
3157 
Parameters:
 3157 
Parameters:
3158 
  * eax = 62 - function number
 3158 
  * eax = 62 - function number
3159 
  * bl = 0 - subfunction number
 3159 
  * bl = 0 - subfunction number
3160 
Returned value:
 3160 
Returned value:
3161 
  * eax = -1 - PCI access is disabled; otherwise
 3161 
  * eax = -1 - PCI access is disabled; otherwise
3162 
  * ah.al = version of PCI-interface (ah=version, al=subversion)
 3162 
  * ah.al = version of PCI-interface (ah=version, al=subversion)
3163 
  * high word of eax is zeroed
 3163 
  * high word of eax is zeroed
3164 
Remarks:
 3164 
Remarks:
3165 
  * Previously low-level access to PCI for applications must be
 3165 
  * Previously low-level access to PCI for applications must be
3166 
    enabled by subfunction 12 of function 21.
 3166 
    enabled by subfunction 12 of function 21.
3167 
  * If PCI BIOS is not supported, the value of ax is undefined.
 3167 
  * If PCI BIOS is not supported, the value of ax is undefined.
3168 
 
 3168 
 
3169 
======================================================================
 3169 
======================================================================
3170 
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
 3170 
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
3171 
======================================================================
 3171 
======================================================================
3172 
Parameters:
 3172 
Parameters:
3173 
  * eax = 62 - function number
 3173 
  * eax = 62 - function number
3174 
  * bl = 1 - subfunction number
 3174 
  * bl = 1 - subfunction number
3175 
Returned value:
 3175 
Returned value:
3176 
  * eax = -1 - access to PCI is disabled; otherwise
 3176 
  * eax = -1 - access to PCI is disabled; otherwise
3177 
  * al = number of the last PCI-bus; other bytes of eax are destroyed
 3177 
  * al = number of the last PCI-bus; other bytes of eax are destroyed
3178 
Remarks:
 3178 
Remarks:
3179 
  * Previously low-level access to PCI for applications must be
 3179 
  * Previously low-level access to PCI for applications must be
3180 
    enabled by subfunction 12 of function 21.
 3180 
    enabled by subfunction 12 of function 21.
3181 
  * If PCI BIOS is not supported, the value of ax is undefined.
 3181 
  * If PCI BIOS is not supported, the value of ax is undefined.
3182 
 
 3182 
 
3183 
======================================================================
 3183 
======================================================================
3184 
===================== Function 62, subfunction 2 =====================
 3184 
===================== Function 62, subfunction 2 =====================
3185 
===== Get mechanism of addressing to the PCI configuration space. ====
 3185 
===== Get mechanism of addressing to the PCI configuration space. ====
3186 
======================================================================
 3186 
======================================================================
3187 
Parameters:
 3187 
Parameters:
3188 
  * eax = 62 - function number
 3188 
  * eax = 62 - function number
3189 
  * bl = 2 - subfunction number
 3189 
  * bl = 2 - subfunction number
3190 
Returned value:
 3190 
Returned value:
3191 
  * eax = -1 - access to PCI is disabled; otherwise
 3191 
  * eax = -1 - access to PCI is disabled; otherwise
3192 
  * al = mechanism (1 or 2); other bytes of eax are destroyed
 3192 
  * al = mechanism (1 or 2); other bytes of eax are destroyed
3193 
Remarks:
 3193 
Remarks:
3194 
  * Previously low-level access to PCI for applications must be
 3194 
  * Previously low-level access to PCI for applications must be
3195 
    enabled by subfunction 12 of function 21.
 3195 
    enabled by subfunction 12 of function 21.
3196 
  * Addressing mechanism is selected depending on
 3196 
  * Addressing mechanism is selected depending on
3197 
    equipment characteristics.
 3197 
    equipment characteristics.
3198 
  * Subfunctions of read and write work automatically
 3198 
  * Subfunctions of read and write work automatically
3199 
    with the selected mechanism.
 3199 
    with the selected mechanism.
3200 
 
 3200 
 
3201 
======================================================================
 3201 
======================================================================
3202 
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
 3202 
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
3203 
======================================================================
 3203 
======================================================================
3204 
Parameters:
 3204 
Parameters:
3205 
  * eax = 62 - function number
 3205 
  * eax = 62 - function number
3206 
  * bl = 4 - read byte
 3206 
  * bl = 4 - read byte
3207 
  * bl = 5 - read word
 3207 
  * bl = 5 - read word
3208 
  * bl = 6 - read dword
 3208 
  * bl = 6 - read dword
3209 
  * bh = number of PCI-bus
 3209 
  * bh = number of PCI-bus
3210 
  * ch = dddddfff, where ddddd = number of the device on the bus,
 3210 
  * ch = dddddfff, where ddddd = number of the device on the bus,
3211 
    fff = function number of device
 3211 
    fff = function number of device
3212 
  * cl = number of register (must be even for bl=5,
 3212 
  * cl = number of register (must be even for bl=5,
3213 
    divisible by 4 for bl=6)
 3213 
    divisible by 4 for bl=6)
3214 
Returned value:
 3214 
Returned value:
3215 
  * eax = -1 - error (access to PCI is disabled or parameters
 3215 
  * eax = -1 - error (access to PCI is disabled or parameters
3216 
    are not supported); otherwise
 3216 
    are not supported); otherwise
3217 
  * al/ax/eax (depending on requested size) contains the data;
 3217 
  * al/ax/eax (depending on requested size) contains the data;
3218 
    the other part of register eax is destroyed
 3218 
    the other part of register eax is destroyed
3219 
Remarks:
 3219 
Remarks:
3220 
  * Previously low-level access to PCI for applications must be
 3220 
  * Previously low-level access to PCI for applications must be
3221 
    enabled by subfunction 12 of function 21.
 3221 
    enabled by subfunction 12 of function 21.
3222 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
 3222 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
3223 
    function number. To get access mechanism use subfunction 2.
 3223 
    function number. To get access mechanism use subfunction 2.
3224 
  * Some registers are standard and exist for all devices, some are
 3224 
  * Some registers are standard and exist for all devices, some are
3225 
    defined by the concrete device. The list of registers of the
 3225 
    defined by the concrete device. The list of registers of the
3226 
    first type can be found e.g. in famous
 3226 
    first type can be found e.g. in famous
3227 
    Interrupt List by Ralf Brown
 3227 
    Interrupt List by Ralf Brown
3228 
    (http://www.pobox.com/~ralf/files.html,
 3228 
    (http://www.pobox.com/~ralf/files.html,
3229 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
 3229 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3230 
    registers of the second type must be listed
 3230 
    registers of the second type must be listed
3231 
    in the device documentation.
 3231 
    in the device documentation.
3232 
 
 3232 
 
3233 
======================================================================
 3233 
======================================================================
3234 
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
 3234 
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
3235 
======================================================================
 3235 
======================================================================
3236 
Parameters:
 3236 
Parameters:
3237 
  * eax = 62 - function number
 3237 
  * eax = 62 - function number
3238 
  * bl = 8 - write byte
 3238 
  * bl = 8 - write byte
3239 
  * bl = 9 - write word
 3239 
  * bl = 9 - write word
3240 
  * bl = 10 - write dword
 3240 
  * bl = 10 - write dword
3241 
  * bh = number of PCI-bus
 3241 
  * bh = number of PCI-bus
3242 
  * ch = dddddfff, where ddddd = number of the device on the bus,
 3242 
  * ch = dddddfff, where ddddd = number of the device on the bus,
3243 
    fff = function number of device
 3243 
    fff = function number of device
3244 
  * cl = number of register (must be even for bl=9,
 3244 
  * cl = number of register (must be even for bl=9,
3245 
    divisible by 4 for bl=10)
 3245 
    divisible by 4 for bl=10)
3246 
  * dl/dx/edx (depending on requested size) contatins
 3246 
  * dl/dx/edx (depending on requested size) contatins
3247 
    the data to write
 3247 
    the data to write
3248 
Returned value:
 3248 
Returned value:
3249 
  * eax = -1 - error (access to PCI is disabled or parameters
 3249 
  * eax = -1 - error (access to PCI is disabled or parameters
3250 
    are not supported)
 3250 
    are not supported)
3251 
  * eax = 0 - success
 3251 
  * eax = 0 - success
3252 
Remarks:
 3252 
Remarks:
3253 
  * Previously low-level access to PCI for applications must be
 3253 
  * Previously low-level access to PCI for applications must be
3254 
    enabled by subfunction 12 of function 21.
 3254 
    enabled by subfunction 12 of function 21.
3255 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
 3255 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
3256 
    function number. To get access mechanism use subfunction 2.
 3256 
    function number. To get access mechanism use subfunction 2.
3257 
  * Some registers are standard and exist for all devices, some are
 3257 
  * Some registers are standard and exist for all devices, some are
3258 
    defined by the concrete device. The list of registers of the
 3258 
    defined by the concrete device. The list of registers of the
3259 
    first type can be found e.g. in famous Interrupt List by
 3259 
    first type can be found e.g. in famous Interrupt List by
3260 
    Ralf Brown; registers of the second type must be listed
 3260 
    Ralf Brown; registers of the second type must be listed
3261 
    in the device documentation.
 3261 
    in the device documentation.
3262 
 
 3262 
 
3263 
======================================================================
 3263 
======================================================================
3264 
===================== Function 62, subfunction 11 ====================
 3264 
===================== Function 62, subfunction 11 ====================
3265 
==              Initialize user-accessible MMIO channel             ==
 3265 
==              Initialize user-accessible MMIO channel             ==
3266 
======================================================================
 3266 
======================================================================
3267 
Parameters:
 3267 
Parameters:
3268 
  * eax = 62 - function
 3268 
  * eax = 62 - function
3269 
  * bl  = 11 - subfunction
 3269 
  * bl  = 11 - subfunction
3270 
  * cx  = PCI-address (bbbbbbbb dddddfff)
3270 
  * cx  = PCI-address (bbbbbbbb dddddfff)
3271 
Returns:
 3271 
Returns:
3272 
  * eax = -1 - PCI access not granted;
3272 
  * eax = -1 - PCI access not granted;
3273 
  * eax = -2 - no user MMIO access to this PCI address;
3273 
  * eax = -2 - no user MMIO access to this PCI address;
3274 
  * eax = -3 - memory allocation error; otherwise
 3274 
  * eax = -3 - memory allocation error; otherwise
3275 
  * eax = available user heap size.
 3275 
  * eax = available user heap size.
3276 
Remarks:
 3276 
Remarks:
3277 
  * Low-level PCI access must be allowed (fn21:12)
 3277 
  * Low-level PCI access must be allowed (fn21:12)
3278 
  * PCI-address should correspond the system var [mmio_pci_addr]
 3278 
  * PCI-address should correspond the system var [mmio_pci_addr]
3279 
 
 3279 
 
3280 
======================================================================
 3280 
======================================================================
3281 
===================== Function 62, subfunction 12 ====================
 3281 
===================== Function 62, subfunction 12 ====================
3282 
==            Request user-accessible MMIO address space            ==
 3282 
==            Request user-accessible MMIO address space            ==
3283 
======================================================================
 3283 
======================================================================
3284 
Parameters:
 3284 
Parameters:
3285 
  * eax = 62 - function
 3285 
  * eax = 62 - function
3286 
  * bl  = 12 - subfunction
 3286 
  * bl  = 12 - subfunction
3287 
  * bh  = BAR number in PCI configuration space
 3287 
  * bh  = BAR number in PCI configuration space
3288 
  * ecx = MMIO-block size needed (bytes)
 3288 
  * ecx = MMIO-block size needed (bytes)
3289 
  * edx = MMIO-offset (number of whole 4Kb-pages!)
 3289 
  * edx = MMIO-offset (number of whole 4Kb-pages!)
3290 
Returns:
 3290 
Returns:
3291 
  * eax = -1 - user PCI access denied;
3291 
  * eax = -1 - user PCI access denied;
3292 
  * eax = -2 - invalid BAR number;
3292 
  * eax = -2 - invalid BAR number;
3293 
  * eax = -3 - BAR contains no valid IO addres;
 3293 
  * eax = -3 - BAR contains no valid IO addres;
3294 
  * eax = -4 - BAR addresses IO ports;
 3294 
  * eax = -4 - BAR addresses IO ports;
3295 
  * eax = -5 - dynamic allocation error; otherwise
 3295 
  * eax = -5 - dynamic allocation error; otherwise
3296 
  * eax = MMIO start address (in application's linear space).
 3296 
  * eax = MMIO start address (in application's linear space).
3297 
Remarks:
 3297 
Remarks:
3298 
  * Low-level PCI access must be allowed (fn21:12)
 3298 
  * Low-level PCI access must be allowed (fn21:12)
3299 
  * The system var [mmio_pci_addr] sets the actual PCI-address
 3299 
  * The system var [mmio_pci_addr] sets the actual PCI-address
3300 
  * The granted MMIO addresses should be released after use (fn62:13)
 3300 
  * The granted MMIO addresses should be released after use (fn62:13)
3301 
 
 3301 
 
3302 
======================================================================
 3302 
======================================================================
3303 
===================== Function 62, subfunction 13 ====================
 3303 
===================== Function 62, subfunction 13 ====================
3304 
==              Release a block of user MMIO addresses              ==
 3304 
==              Release a block of user MMIO addresses              ==
3305 
======================================================================
 3305 
======================================================================
3306 
 à ¬¥âàë:
 3306 
 à ¬¥âàë:
3307 
  * eax = 62 - function
 3307 
  * eax = 62 - function
3308 
  * bl  = 12 - subfunction
 3308 
  * bl  = 12 - subfunction
3309 
  * ecx = MMIO start address (in application's linear space).
 3309 
  * ecx = MMIO start address (in application's linear space).
3310 
Returns:
 3310 
Returns:
3311 
  * eax = 1 if the block is successfully released;
3311 
  * eax = 1 if the block is successfully released;
3312 
  * eax = 0 in case of reallocation error;
3312 
  * eax = 0 in case of reallocation error;
3313 
Remarks:
 3313 
Remarks:
3314 
  * A valid uMMIO block should exist at this address (fn62:12)
 3314 
  * A valid uMMIO block should exist at this address (fn62:12)
3315 
 
 3315 
 
3316 
======================================================================
 3316 
======================================================================
3317 
============== Function 63 - work with the debug board. ==============
 3317 
============== Function 63 - work with the debug board. ==============
3318 
======================================================================
 3318 
======================================================================
3319 
The debug board is the global system buffer (with the size
 3319 
The debug board is the global system buffer (with the size
3320 
1024 bytes), to which any program can write (generally speaking,
 3320 
1024 bytes), to which any program can write (generally speaking,
3321 
arbitrary) data and from which other program can read these data.
 3321 
arbitrary) data and from which other program can read these data.
3322 
By the agreement written data are text strings interpreted as
 3322 
By the agreement written data are text strings interpreted as
3323 
debug messages on a course of program execution. The kernel in
 3323 
debug messages on a course of program execution. The kernel in
3324 
some situations also writes to the debug board information on
 3324 
some situations also writes to the debug board information on
3325 
execution of some functions; by the agreement kernel messages
 3325 
execution of some functions; by the agreement kernel messages
3326 
begins from the prefix "K : ".
 3326 
begins from the prefix "K : ".
3327 
For view of the debug board the application 'board' was created,
 3327 
For view of the debug board the application 'board' was created,
3328 
which reads data from the buffer and displays them in its window.
 3328 
which reads data from the buffer and displays them in its window.
3329 
'board' interpretes the sequence of codes 13,10 as newline.
 3329 
'board' interpretes the sequence of codes 13,10 as newline.
3330 
A character with null code in an end of line is not necessary,
 3330 
A character with null code in an end of line is not necessary,
3331 
but also does not prevent.
 3331 
but also does not prevent.
3332 
Because debugger has been written, the value of the debug board
 3332 
Because debugger has been written, the value of the debug board
3333 
has decreased, as debugger allows to inspect completely a course of
 3333 
has decreased, as debugger allows to inspect completely a course of
3334 
program execution without any efforts from the direction of program
 3334 
program execution without any efforts from the direction of program
3335 
itself. Nevertheless in some cases the debug board is still useful.
 3335 
itself. Nevertheless in some cases the debug board is still useful.
3336 
 
 3336 
 
3337 
----------------------------- Write byte -----------------------------
 3337 
----------------------------- Write byte -----------------------------
3338 
Parameters:
 3338 
Parameters:
3339 
  * eax = 63 - function number
 3339 
  * eax = 63 - function number
3340 
  * ebx = 1 - subfunction number
 3340 
  * ebx = 1 - subfunction number
3341 
  * cl = data byte
 3341 
  * cl = data byte
3342 
Returned value:
 3342 
Returned value:
3343 
  * function does not return value
 3343 
  * function does not return value
3344 
Remarks:
 3344 
Remarks:
3345 
  * Byte is written to the buffer. Buffer size is 512 bytes.
 3345 
  * Byte is written to the buffer. Buffer size is 512 bytes.
3346 
    At buffer overflow all obtained data are lost.
 3346 
    At buffer overflow all obtained data are lost.
3347 
  * For output to the debug board of more complicated objects
 3347 
  * For output to the debug board of more complicated objects
3348 
    (strings, numbers) it is enough to call this function in cycle.
 3348 
    (strings, numbers) it is enough to call this function in cycle.
3349 
    It is possible not to write the appropriate code manually and use
 3349 
    It is possible not to write the appropriate code manually and use
3350 
    file 'debug.inc', which is included into the distributive.
 3350 
    file 'debug.inc', which is included into the distributive.
3351 
 
 3351 
 
3352 
----------------------------- Read byte ------------------------------
 3352 
----------------------------- Read byte ------------------------------
3353 
Takes away byte from the buffer.
 3353 
Takes away byte from the buffer.
3354 
Parameters:
 3354 
Parameters:
3355 
  * eax = 63 - function number
 3355 
  * eax = 63 - function number
3356 
  * ebx = 2 - subfunction number
 3356 
  * ebx = 2 - subfunction number
3357 
Returned value:
 3357 
Returned value:
3358 
  * eax = ebx = 0 - the buffer is empty
 3358 
  * eax = ebx = 0 - the buffer is empty
3359 
  * eax = byte, ebx = 1 - byte was successfully read
 3359 
  * eax = byte, ebx = 1 - byte was successfully read
3360 
 
 3360 
 
3361 
======================================================================
 3361 
======================================================================
3362 
============== Function 64 - resize application memory. ==============
 3362 
============== Function 64 - resize application memory. ==============
3363 
======================================================================
 3363 
======================================================================
3364 
Parameters:
 3364 
Parameters:
3365 
  * eax = 64 - function number
 3365 
  * eax = 64 - function number
3366 
  * ebx = 1 - unique subfunction
 3366 
  * ebx = 1 - unique subfunction
3367 
  * ecx = new memory size
 3367 
  * ecx = new memory size
3368 
Returned value:
 3368 
Returned value:
3369 
  * eax = 0 - success
 3369 
  * eax = 0 - success
3370 
  * eax = 1 - not enough memory
 3370 
  * eax = 1 - not enough memory
3371 
Remarks:
 3371 
Remarks:
3372 
  * There is another way to dynamically allocate/free memory -
 3372 
  * There is another way to dynamically allocate/free memory -
3373 
    subfunctions 11, 12, 13 of function 68.
 3373 
    subfunctions 11, 12, 13 of function 68.
3374 
  * The function cannot be used together with 68.11, 68.12, 68.13.
 3374 
  * The function cannot be used together with 68.11, 68.12, 68.13.
3375 
    The function call will be ignored after creation of process heap
 3375 
    The function call will be ignored after creation of process heap
3376 
    with function 68.11.
 3376 
    with function 68.11.
3377 
 
 3377 
 
3378 
======================================================================
 3378 
======================================================================
3379 
======== Function 65 - draw image with palette in the window. ========
 3379 
======== Function 65 - draw image with palette in the window. ========
3380 
======================================================================
 3380 
======================================================================
3381 
Parameters:
 3381 
Parameters:
3382 
  * eax = 65 - function number
 3382 
  * eax = 65 - function number
3383 
  * ebx = pointer to the image
 3383 
  * ebx = pointer to the image
3384 
  * ecx = [size on axis x]*65536 + [size on axis y]
 3384 
  * ecx = [size on axis x]*65536 + [size on axis y]
3385 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 3385 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
3386 
  * esi = number of bits per pixel, must be 1,2,4,8,15,16,24 or 32
 3386 
  * esi = number of bits per pixel, must be 1,2,4,8,15,16,24 or 32
3387 
  * edi = pointer to palette (2 to the power esi colors 0x00RRGGBB);
 3387 
  * edi = pointer to palette (2 to the power esi colors 0x00RRGGBB);
3388 
          ignored when esi > 8
 3388 
          ignored when esi > 8
3389 
  * ebp = offset of next row data relative to previous row data
 3389 
  * ebp = offset of next row data relative to previous row data
3390 
Returned value:
 3390 
Returned value:
3391 
  * function does not return value
 3391 
  * function does not return value
3392 
Remarks:
 3392 
Remarks:
3393 
  * Coordinates of the image are coordinates of the upper left corner
 3393 
  * Coordinates of the image are coordinates of the upper left corner
3394 
    of the image relative to the window.
 3394 
    of the image relative to the window.
3395 
  * Format of image with 1 bit per pixel: each byte of image
 3395 
  * Format of image with 1 bit per pixel: each byte of image
3396 
    (possibly excluding last bytes in rows), contains information on
 3396 
    (possibly excluding last bytes in rows), contains information on
3397 
    the color of 8 pixels, MSB corresponds to first pixel.
 3397 
    the color of 8 pixels, MSB corresponds to first pixel.
3398 
  * Format of image with 2 bits per pixel: each byte of image
 3398 
  * Format of image with 2 bits per pixel: each byte of image
3399 
    (possibly excluding last bytes in rows), contains information on
 3399 
    (possibly excluding last bytes in rows), contains information on
3400 
    the color of 4 pixels, two MSBs correspond to first pixel.
 3400 
    the color of 4 pixels, two MSBs correspond to first pixel.
3401 
  * Format of image with 4 bits per pixel: each byte of image
 3401 
  * Format of image with 4 bits per pixel: each byte of image
3402 
    excluding last bytes in rows (if width is odd) contains
 3402 
    excluding last bytes in rows (if width is odd) contains
3403 
    information on the color of 2 pixels, high-order tetrad
 3403 
    information on the color of 2 pixels, high-order tetrad
3404 
    corresponds to first pixel.
 3404 
    corresponds to first pixel.
3405 
  * Format of image with 8 bits per pixel: each byte of image is
 3405 
  * Format of image with 8 bits per pixel: each byte of image is
3406 
    index in the palette.
 3406 
    index in the palette.
3407 
  * Format of image with 15 bits per pixel: the color of each pixel
 3407 
  * Format of image with 15 bits per pixel: the color of each pixel
3408 
    is coded as (bit representation) 0RRRRRGGGGGBBBBB - 5 bits per
 3408 
    is coded as (bit representation) 0RRRRRGGGGGBBBBB - 5 bits per
3409 
    each color.
 3409 
    each color.
3410 
  * Format of image with 16 bits per pixel: the color of each pixel
 3410 
  * Format of image with 16 bits per pixel: the color of each pixel
3411 
    is coded as RRRRRGGGGGGBBBBB (5+6+5).
 3411 
    is coded as RRRRRGGGGGGBBBBB (5+6+5).
3412 
  * Format of image with 24 bits per pixel: the color of each pixel
 3412 
  * Format of image with 24 bits per pixel: the color of each pixel
3413 
    is coded as 3 bytes - sequentially blue, green, red components.
 3413 
    is coded as 3 bytes - sequentially blue, green, red components.
3414 
  * Format of image with 32 bits per pixel: similar to 24, but
 3414 
  * Format of image with 32 bits per pixel: similar to 24, but
3415 
    one additional ignored byte is present.
 3415 
    one additional ignored byte is present.
3416 
  * The call to function 7 is equivalent to call to this function
 3416 
  * The call to function 7 is equivalent to call to this function
3417 
    with esi=24, ebp=0.
 3417 
    with esi=24, ebp=0.
3418 
 
 3418 
 
3419 
======================================================================
 3419 
======================================================================
3420 
================== Function 66 - work with keyboard. =================
 3420 
================== Function 66 - work with keyboard. =================
3421 
======================================================================
 3421 
======================================================================
3422 
The input mode influences results of reading keys by function 2.
 3422 
The input mode influences results of reading keys by function 2.
3423 
When a program loads, ASCII input mode is set for it.
 3423 
When a program loads, ASCII input mode is set for it.
3424 
 
 3424 
 
3425 
-------------- Subfunction 1 - set keyboard input mode. --------------
 3425 
-------------- Subfunction 1 - set keyboard input mode. --------------
3426 
Parameters:
 3426 
Parameters:
3427 
  * eax = 66 - function number
 3427 
  * eax = 66 - function number
3428 
  * ebx = 1 - subfunction number
 3428 
  * ebx = 1 - subfunction number
3429 
  * ecx = mode:
 3429 
  * ecx = mode:
3430 
    * 0 = normal (ASCII-characters)
 3430 
    * 0 = normal (ASCII-characters)
3431 
    * 1 = scancodes
 3431 
    * 1 = scancodes
3432 
Returned value:
 3432 
Returned value:
3433 
  * function does not return value
 3433 
  * function does not return value
3434 
 
 3434 
 
3435 
-------------- Subfunction 2 - get keyboard input mode. --------------
 3435 
-------------- Subfunction 2 - get keyboard input mode. --------------
3436 
Parameters:
 3436 
Parameters:
3437 
  * eax = 66 - function number
 3437 
  * eax = 66 - function number
3438 
  * ebx = 2 - subfunction number
 3438 
  * ebx = 2 - subfunction number
3439 
Returned value:
 3439 
Returned value:
3440 
  * eax = current mode
 3440 
  * eax = current mode
3441 
 
 3441 
 
3442 
------------ Subfunction 3 - get status of control keys. -------------
 3442 
------------ Subfunction 3 - get status of control keys. -------------
3443 
Parameters:
 3443 
Parameters:
3444 
  * eax = 66 - function number
 3444 
  * eax = 66 - function number
3445 
  * ebx = 3 - subfunction number
 3445 
  * ebx = 3 - subfunction number
3446 
Returned value:
 3446 
Returned value:
3447 
  * eax = bit mask:
 3447 
  * eax = bit mask:
3448 
  * bit 0 (mask 1): left Shift is pressed
 3448 
  * bit 0 (mask 1): left Shift is pressed
3449 
  * bit 1 (mask 2): right Shift is pressed
 3449 
  * bit 1 (mask 2): right Shift is pressed
3450 
  * bit 2 (mask 4): left Ctrl is pressed
 3450 
  * bit 2 (mask 4): left Ctrl is pressed
3451 
  * bit 3 (mask 8): right Ctrl is pressed
 3451 
  * bit 3 (mask 8): right Ctrl is pressed
3452 
  * bit 4 (mask 0x10): left Alt is pressed
 3452 
  * bit 4 (mask 0x10): left Alt is pressed
3453 
  * bit 5 (mask 0x20): right Alt is pressed
 3453 
  * bit 5 (mask 0x20): right Alt is pressed
3454 
  * bit 6 (mask 0x40): CapsLock is on
 3454 
  * bit 6 (mask 0x40): CapsLock is on
3455 
  * bit 7 (mask 0x80): NumLock is on
 3455 
  * bit 7 (mask 0x80): NumLock is on
3456 
  * bit 8 (mask 0x100): ScrollLock is on
 3456 
  * bit 8 (mask 0x100): ScrollLock is on
3457 
  * other bits are cleared
 3457 
  * other bits are cleared
3458 
 
 3458 
 
3459 
-------------- Subfunction 4 - set system-wide hotkey. ---------------
 3459 
-------------- Subfunction 4 - set system-wide hotkey. ---------------
3460 
When hotkey is pressed, the system notifies only those applications,
 3460 
When hotkey is pressed, the system notifies only those applications,
3461 
which have installed it; the active application (which receives
 3461 
which have installed it; the active application (which receives
3462 
all normal input) does not receive such keys.
 3462 
all normal input) does not receive such keys.
3463 
The notification consists in sending event with the code 2.
 3463 
The notification consists in sending event with the code 2.
3464 
Reading hotkey is the same as reading normal key - by function 2.
 3464 
Reading hotkey is the same as reading normal key - by function 2.
3465 
Parameters:
 3465 
Parameters:
3466 
  * eax = 66 - function number
 3466 
  * eax = 66 - function number
3467 
  * ebx = 4 - subfunction number
 3467 
  * ebx = 4 - subfunction number
3468 
  * cl determines key scancode;
 3468 
  * cl determines key scancode;
3469 
    use cl=0 to give combinations such as Ctrl+Shift
 3469 
    use cl=0 to give combinations such as Ctrl+Shift
3470 
  * edx = 0xXYZ determines possible states of control keys:
 3470 
  * edx = 0xXYZ determines possible states of control keys:
3471 
    * Z (low 4 bits) determines state of LShift and RShift:
 3471 
    * Z (low 4 bits) determines state of LShift and RShift:
3472 
      * 0 = no key must be pressed;
 3472 
      * 0 = no key must be pressed;
3473 
      * 1 = exactly one key must be pressed;
 3473 
      * 1 = exactly one key must be pressed;
3474 
      * 2 = both keys must be pressed;
 3474 
      * 2 = both keys must be pressed;
3475 
      * 3 = must be pressed LShift, but not RShift;
 3475 
      * 3 = must be pressed LShift, but not RShift;
3476 
      * 4 = must be pressed RShift, but not LShift
 3476 
      * 4 = must be pressed RShift, but not LShift
3477 
    * Y - similar for LCtrl and RCtrl;
 3477 
    * Y - similar for LCtrl and RCtrl;
3478 
    * X - similar for LAlt and RAlt
 3478 
    * X - similar for LAlt and RAlt
3479 
Returned value:
 3479 
Returned value:
3480 
  * eax=0 - success
 3480 
  * eax=0 - success
3481 
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
 3481 
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
3482 
Remarks:
 3482 
Remarks:
3483 
  * Hotkey can work either at pressing or at release. Release
 3483 
  * Hotkey can work either at pressing or at release. Release
3484 
    scancode of a key is more on 128 than pressing scancode
 3484 
    scancode of a key is more on 128 than pressing scancode
3485 
    (i.e. high bit is set).
 3485 
    (i.e. high bit is set).
3486 
  * Several applications can set the same combination;
 3486 
  * Several applications can set the same combination;
3487 
    all such applications will be informed on pressing
 3487 
    all such applications will be informed on pressing
3488 
    such combination.
 3488 
    such combination.
3489 
 
 3489 
 
3490 
-------------- Subfunction 5 - delete installed hotkey. --------------
 3490 
-------------- Subfunction 5 - delete installed hotkey. --------------
3491 
Parameters:
 3491 
Parameters:
3492 
  * eax = 66 - function number
 3492 
  * eax = 66 - function number
3493 
  * ebx = 5 - subfunction number
 3493 
  * ebx = 5 - subfunction number
3494 
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
 3494 
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
3495 
Returned value:
 3495 
Returned value:
3496 
  * eax = 0 - success
 3496 
  * eax = 0 - success
3497 
  * eax = 1 - there is no such hotkey
 3497 
  * eax = 1 - there is no such hotkey
3498 
Remarks:
 3498 
Remarks:
3499 
  * When a process/thread terminates, all hotkey installed by it are
 3499 
  * When a process/thread terminates, all hotkey installed by it are
3500 
    deleted.
 3500 
    deleted.
3501 
  * The call to this subfunction does not affect other applications.
 3501 
  * The call to this subfunction does not affect other applications.
3502 
    If other application has defined the same combination, it will
 3502 
    If other application has defined the same combination, it will
3503 
    still receive notices.
 3503 
    still receive notices.
3504 
 
 3504 
 
3505 
======================================================================
 3505 
======================================================================
3506 
========= Function 67 - change position/sizes of the window. =========
 3506 
========= Function 67 - change position/sizes of the window. =========
3507 
======================================================================
 3507 
======================================================================
3508 
Parameters:
 3508 
Parameters:
3509 
  * eax = 67 - function number
 3509 
  * eax = 67 - function number
3510 
  * ebx = new x-coordinate of the window
 3510 
  * ebx = new x-coordinate of the window
3511 
  * ecx = new y-coordinate of the window
 3511 
  * ecx = new y-coordinate of the window
3512 
  * edx = new x-size of the window
 3512 
  * edx = new x-size of the window
3513 
  * esi = new y-size of the window
 3513 
  * esi = new y-size of the window
3514 
Returned value:
 3514 
Returned value:
3515 
  * function does not return value
 3515 
  * function does not return value
3516 
Remarks:
 3516 
Remarks:
3517 
  * The value -1 for a parameter means "do not change"; e.g. to move
 3517 
  * The value -1 for a parameter means "do not change"; e.g. to move
3518 
    the window without resizing it is possible to specify edx=esi=-1.
 3518 
    the window without resizing it is possible to specify edx=esi=-1.
3519 
  * Previously the window must be defined by function 0.
 3519 
  * Previously the window must be defined by function 0.
3520 
    It sets initial coordinates and sizes of the window.
 3520 
    It sets initial coordinates and sizes of the window.
3521 
  * Sizes of the window are understood in sense of function 0,
 3521 
  * Sizes of the window are understood in sense of function 0,
3522 
    that is one pixel less than real sizes.
 3522 
    that is one pixel less than real sizes.
3523 
  * The function call for maximized windows is simply ignored.
 3523 
  * The function call for maximized windows is simply ignored.
3524 
  * For windows of appropriate styles position and/or sizes can be
 3524 
  * For windows of appropriate styles position and/or sizes can be
3525 
    changed by user; current position and sizes can be obtained by
 3525 
    changed by user; current position and sizes can be obtained by
3526 
    call to function 9.
 3526 
    call to function 9.
3527 
  * The function sends to the window redraw event (with the code 1).
 3527 
  * The function sends to the window redraw event (with the code 1).
3528 
 
 3528 
 
3529 
======================================================================
 3529 
======================================================================
3530 
====== Function 68, subfunction 0 - get the task switch counter. =====
 3530 
====== Function 68, subfunction 0 - get the task switch counter. =====
3531 
======================================================================
 3531 
======================================================================
3532 
Parameters:
 3532 
Parameters:
3533 
  * eax = 68 - function number
 3533 
  * eax = 68 - function number
3534 
  * ebx = 0 - subfunction number
 3534 
  * ebx = 0 - subfunction number
3535 
Returned value:
 3535 
Returned value:
3536 
  * eax = number of task switches from the system booting
 3536 
  * eax = number of task switches from the system booting
3537 
    (modulo 2^32)
 3537 
    (modulo 2^32)
3538 
 
 3538 
 
3539 
======================================================================
 3539 
======================================================================
3540 
======= Function 68, subfunction 1 - switch to the next thread. ======
 3540 
======= Function 68, subfunction 1 - switch to the next thread. ======
3541 
======================================================================
 3541 
======================================================================
3542 
The function completes the current time slice allocated to the
 3542 
The function completes the current time slice allocated to the
3543 
thread and switches to the next. (Which thread in which process
 3543 
thread and switches to the next. (Which thread in which process
3544 
will be next, is unpredictable). Later, when execution queue
 3544 
will be next, is unpredictable). Later, when execution queue
3545 
will reach the current thread, execution will be continued.
 3545 
will reach the current thread, execution will be continued.
3546 
Parameters:
 3546 
Parameters:
3547 
  * eax = 68 - function number
 3547 
  * eax = 68 - function number
3548 
  * ebx = 1 - subfunction number
 3548 
  * ebx = 1 - subfunction number
3549 
Returned value:
 3549 
Returned value:
3550 
  * function does not return value
 3550 
  * function does not return value
3551 
 
 3551 
 
3552 
======================================================================
 3552 
======================================================================
3553 
============= Function 68, subfunction 2 - cache + rdpmc. ============
 3553 
============= Function 68, subfunction 2 - cache + rdpmc. ============
3554 
======================================================================
 3554 
======================================================================
3555 
Parameters:
 3555 
Parameters:
3556 
  * eax = 68 - function number
 3556 
  * eax = 68 - function number
3557 
  * ebx = 2 - subfunction number
 3557 
  * ebx = 2 - subfunction number
3558 
  * ecx = required action:
 3558 
  * ecx = required action:
3559 
    * ecx = 0 - enable instruction 'rdpmc'
 3559 
    * ecx = 0 - enable instruction 'rdpmc'
3560 
      (ReaD Performance-Monitoring Counters) for applications
 3560 
      (ReaD Performance-Monitoring Counters) for applications
3561 
    * ecx = 1 - find out whether cache is disabled/enabled
 3561 
    * ecx = 1 - find out whether cache is disabled/enabled
3562 
    * ecx = 2 - enable cache
 3562 
    * ecx = 2 - enable cache
3563 
    * ecx = 3 - disable cache
 3563 
    * ecx = 3 - disable cache
3564 
Returned value:
 3564 
Returned value:
3565 
  * for ecx=0:
 3565 
  * for ecx=0:
3566 
    * eax = the value of cr4
 3566 
    * eax = the value of cr4
3567 
  * for ecx=1:
 3567 
  * for ecx=1:
3568 
    * eax = (cr0 and 0x60000000):
 3568 
    * eax = (cr0 and 0x60000000):
3569 
    * eax = 0 - cache is on
 3569 
    * eax = 0 - cache is on
3570 
    * eax <> 0 - cache is off
 3570 
    * eax <> 0 - cache is off
3571 
  * for ecx=2 and ecx=3:
 3571 
  * for ecx=2 and ecx=3:
3572 
    * function does not return value
 3572 
    * function does not return value
3573 
 
 3573 
 
3574 
======================================================================
 3574 
======================================================================
3575 
=========== Function 68, subfunction 3 - read MSR-register. ==========
 3575 
=========== Function 68, subfunction 3 - read MSR-register. ==========
3576 
======================================================================
 3576 
======================================================================
3577 
MSR = Model Specific Register; the complete list of MSR-registers
 3577 
MSR = Model Specific Register; the complete list of MSR-registers
3578 
of a processor is included to the documentation on it (for example,
 3578 
of a processor is included to the documentation on it (for example,
3579 
IA-32 Intel Architecture Software Developer's Manual,
 3579 
IA-32 Intel Architecture Software Developer's Manual,
3580 
Volume 3, Appendix B); each processor family has its own subset
 3580 
Volume 3, Appendix B); each processor family has its own subset
3581 
of the MSR-registers.
 3581 
of the MSR-registers.
3582 
Parameters:
 3582 
Parameters:
3583 
  * eax = 68 - function number
 3583 
  * eax = 68 - function number
3584 
  * ebx = 3 - subfunction number
 3584 
  * ebx = 3 - subfunction number
3585 
  * ecx is ignored
 3585 
  * ecx is ignored
3586 
  * edx = MSR address
 3586 
  * edx = MSR address
3587 
Returned value:
 3587 
Returned value:
3588 
  * ebx:eax = high:low dword of the result
 3588 
  * ebx:eax = high:low dword of the result
3589 
Remarks:
 3589 
Remarks:
3590 
  * If ecx contains nonexistent or not implemented for this processor
 3590 
  * If ecx contains nonexistent or not implemented for this processor
3591 
    MSR, processor will generate an exception in the kernel, which
 3591 
    MSR, processor will generate an exception in the kernel, which
3592 
    will kill the thread.
 3592 
    will kill the thread.
3593 
  * Previously it is necessary to check, whether MSRs are supported
 3593 
  * Previously it is necessary to check, whether MSRs are supported
3594 
    as a whole, with the instruction 'cpuid'. Otherwise processor
 3594 
    as a whole, with the instruction 'cpuid'. Otherwise processor
3595 
    will generate other exception in the kernel, which will anyway
 3595 
    will generate other exception in the kernel, which will anyway
3596 
    kill the thread.
 3596 
    kill the thread.
3597 
 
 3597 
 
3598 
======================================================================
 3598 
======================================================================
3599 
========= Function 68, subfunction 4 - write to MSR-register. ========
 3599 
========= Function 68, subfunction 4 - write to MSR-register. ========
3600 
======================================================================
 3600 
======================================================================
3601 
MSR = Model Specific Register; the complete list of MSR-registers
 3601 
MSR = Model Specific Register; the complete list of MSR-registers
3602 
of a processor is included to the documentation on it (for example,
 3602 
of a processor is included to the documentation on it (for example,
3603 
IA-32 Intel Architecture Software Developer's Manual,
 3603 
IA-32 Intel Architecture Software Developer's Manual,
3604 
Volume 3, Appendix B); each processor family has its own subset
 3604 
Volume 3, Appendix B); each processor family has its own subset
3605 
of the MSR-registers.
 3605 
of the MSR-registers.
3606 
Parameters:
 3606 
Parameters:
3607 
  * eax = 68 - function number
 3607 
  * eax = 68 - function number
3608 
  * ebx = 4 - subfunction number
 3608 
  * ebx = 4 - subfunction number
3609 
  * ecx is ignored
 3609 
  * ecx is ignored
3610 
  * edx = MSR address
 3610 
  * edx = MSR address
3611 
  * esi:edi = high:low dword
 3611 
  * esi:edi = high:low dword
3612 
Returned value:
 3612 
Returned value:
3613 
  * function does not return value
 3613 
  * function does not return value
3614 
Remarks:
 3614 
Remarks:
3615 
  * If ecx contains nonexistent or not implemented for this processor
 3615 
  * If ecx contains nonexistent or not implemented for this processor
3616 
    MSR, processor will generate an exception in the kernel, which
 3616 
    MSR, processor will generate an exception in the kernel, which
3617 
    will kill the thread.
 3617 
    will kill the thread.
3618 
  * Previously it is necessary to check, whether MSRs are supported
 3618 
  * Previously it is necessary to check, whether MSRs are supported
3619 
    as a whole, with the instruction 'cpuid'. Otherwise processor
 3619 
    as a whole, with the instruction 'cpuid'. Otherwise processor
3620 
    will generate other exception in the kernel, which will anyway
 3620 
    will generate other exception in the kernel, which will anyway
3621 
    kill the thread.
 3621 
    kill the thread.
3622 
 
 3622 
 
3623 
======================================================================
 3623 
======================================================================
3624 
======= Function 68, subfunction 11 - initialize process heap. =======
 3624 
======= Function 68, subfunction 11 - initialize process heap. =======
3625 
======================================================================
 3625 
======================================================================
3626 
Parameters:
 3626 
Parameters:
3627 
  * eax = 68 - function number
 3627 
  * eax = 68 - function number
3628 
  * ebx = 11 - subfunction number
 3628 
  * ebx = 11 - subfunction number
3629 
Returned value:
 3629 
Returned value:
3630 
  * eax = 0 - failed
 3630 
  * eax = 0 - failed
3631 
  * otherwise size of created heap
 3631 
  * otherwise size of created heap
3632 
Remarks:
 3632 
Remarks:
3633 
  * The function call initializes heap, from which one can in future
 3633 
  * The function call initializes heap, from which one can in future
3634 
    allocate and free memory blocks with subfunctions 12 and 13.
 3634 
    allocate and free memory blocks with subfunctions 12 and 13.
3635 
    Heap size is equal to total amount of free application memory.
 3635 
    Heap size is equal to total amount of free application memory.
3636 
  * The second function call from the same process results in
 3636 
  * The second function call from the same process results in
3637 
    returning the size of the existing heap.
 3637 
    returning the size of the existing heap.
3638 
  * After creation of the heap calls to function 64 will be ignored.
 3638 
  * After creation of the heap calls to function 64 will be ignored.
3639 
 
 3639 
 
3640 
======================================================================
 3640 
======================================================================
3641 
======== Function 68, subfunction 12 - allocate memory block. ========
 3641 
======== Function 68, subfunction 12 - allocate memory block. ========
3642 
======================================================================
 3642 
======================================================================
3643 
Parameters:
 3643 
Parameters:
3644 
  * eax = 68 - function number
 3644 
  * eax = 68 - function number
3645 
  * ebx = 12 - subfunction number
 3645 
  * ebx = 12 - subfunction number
3646 
  * ecx = required size in bytes
 3646 
  * ecx = required size in bytes
3647 
Returned value:
 3647 
Returned value:
3648 
  * eax = pointer to the allocated block
 3648 
  * eax = pointer to the allocated block
3649 
Remarks:
 3649 
Remarks:
3650 
  * Before this call one must initialize process heap by call to
 3650 
  * Before this call one must initialize process heap by call to
3651 
    subfunction 11.
 3651 
    subfunction 11.
3652 
  * The function allocates an integer number of pages (4 Kb) in such
 3652 
  * The function allocates an integer number of pages (4 Kb) in such
3653 
    way that the real size of allocated block is more than or equal to
 3653 
    way that the real size of allocated block is more than or equal to
3654 
    requested size.
 3654 
    requested size.
3655 
 
 3655 
 
3656 
======================================================================
 3656 
======================================================================
3657 
========== Function 68, subfunction 13 - free memory block. ==========
 3657 
========== Function 68, subfunction 13 - free memory block. ==========
3658 
======================================================================
 3658 
======================================================================
3659 
Parameters:
 3659 
Parameters:
3660 
  * eax = 68 - function number
 3660 
  * eax = 68 - function number
3661 
  * ebx = 13 - subfunction number
 3661 
  * ebx = 13 - subfunction number
3662 
  * ecx = pointer to the memory block
 3662 
  * ecx = pointer to the memory block
3663 
Returned value:
 3663 
Returned value:
3664 
  * eax = 1 - success
 3664 
  * eax = 1 - success
3665 
  * eax = 0 - failed
 3665 
  * eax = 0 - failed
3666 
Remarks:
 3666 
Remarks:
3667 
  * The memory block must have been allocated by subfunction 12
 3667 
  * The memory block must have been allocated by subfunction 12
3668 
    or subfunction 20.
 3668 
    or subfunction 20.
3669 
 
 3669 
 
3670 
======================================================================
 3670 
======================================================================
3671 
===================== Function 68, subfunction 14 ====================
 3671 
===================== Function 68, subfunction 14 ====================
3672 
====== Waiting delivering of signal from another program/driver ======
 3672 
====== Waiting delivering of signal from another program/driver ======
3673 
======================================================================
 3673 
======================================================================
3674 
Parameters:
 3674 
Parameters:
3675 
  * eax = 68 - function number
 3675 
  * eax = 68 - function number
3676 
  * ebx = 14 - subfunction number
 3676 
  * ebx = 14 - subfunction number
3677 
  * ecx = pointer to the buffer for information (24 bytes)
 3677 
  * ecx = pointer to the buffer for information (24 bytes)
3678 
Returned value:
 3678 
Returned value:
3679 
  * buffer pointed to by ecx contains the following information:
 3679 
  * buffer pointed to by ecx contains the following information:
3680 
    * +0: dword: identifier for underlying data of signal
 3680 
    * +0: dword: identifier for underlying data of signal
3681 
    * +4: data of signal (20 bytes), format of which is defining by
 3681 
    * +4: data of signal (20 bytes), format of which is defining by
3682 
          first dword
 3682 
          first dword
3683 
 
 3683 
 
3684 
======================================================================
 3684 
======================================================================
3685 
====== Function 68, subfunction 15 - set FPU exception handler. ======
 3685 
====== Function 68, subfunction 15 - set FPU exception handler. ======
3686 
======================================================================
 3686 
======================================================================
3687 
Deleted (in current implementation only 0 is returned).
 3687 
Deleted (in current implementation only 0 is returned).
3688 
Using subfunctions 24, 25 is true.
 3688 
Using subfunctions 24, 25 is true.
3689 
 
 3689 
 
3690 
======================================================================
 3690 
======================================================================
3691 
============= Function 68, subfunction 16 - load driver. =============
 3691 
============= Function 68, subfunction 16 - load driver. =============
3692 
======================================================================
 3692 
======================================================================
3693 
Parameters:
 3693 
Parameters:
3694 
  * eax = 68 - function number
 3694 
  * eax = 68 - function number
3695 
  * ebx = 16 - subfunction number
 3695 
  * ebx = 16 - subfunction number
3696 
  * ecx = pointer to ASCIIZ-string with driver name
 3696 
  * ecx = pointer to ASCIIZ-string with driver name
3697 
Returned value:
 3697 
Returned value:
3698 
  * eax = 0 - failed
 3698 
  * eax = 0 - failed
3699 
  * otherwise eax = driver handle
 3699 
  * otherwise eax = driver handle
3700 
Remarks:
 3700 
Remarks:
3701 
  * If the driver was not loaded yet, it is loaded;
 3701 
  * If the driver was not loaded yet, it is loaded;
3702 
    if the driver was loaded yet, nothing happens.
 3702 
    if the driver was loaded yet, nothing happens.
3703 
  * Driver name is case-sensitive.
 3703 
  * Driver name is case-sensitive.
3704 
    Maximum length of the name is 16 characters, including
 3704 
    Maximum length of the name is 16 characters, including
3705 
    terminating null character, the rest is ignored.
 3705 
    terminating null character, the rest is ignored.
3706 
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
 3706 
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
3707 
 
 3707 
 
3708 
======================================================================
 3708 
======================================================================
3709 
============ Function 68, subfunction 17 - driver control. ===========
 3709 
============ Function 68, subfunction 17 - driver control. ===========
3710 
======================================================================
 3710 
======================================================================
3711 
Parameters:
 3711 
Parameters:
3712 
  * eax = 68 - function number
 3712 
  * eax = 68 - function number
3713 
  * ebx = 17 - subfunction number
 3713 
  * ebx = 17 - subfunction number
3714 
  * ecx = pointer to the control structure:
 3714 
  * ecx = pointer to the control structure:
3715 
    * +0: dword: handle of driver
 3715 
    * +0: dword: handle of driver
3716 
    * +4: dword: code of driver function
 3716 
    * +4: dword: code of driver function
3717 
    * +8: dword: pointer to input data
 3717 
    * +8: dword: pointer to input data
3718 
    * +12 = +0xC: dword: size of input data
 3718 
    * +12 = +0xC: dword: size of input data
3719 
    * +16 = +0x10: dword: pointer to output data
 3719 
    * +16 = +0x10: dword: pointer to output data
3720 
    * +20 = +0x14: dword: size of output data
 3720 
    * +20 = +0x14: dword: size of output data
3721 
Returned value:
 3721 
Returned value:
3722 
  * eax =  error code
 3722 
  * eax =  error code
3723 
      0  - successful call
 3723 
      0  - successful call
3724 
     -1  - any error.
 3724 
     -1  - any error.
3725 
     -2, -3, -4, etc. reserved for kernel error codes
 3725 
     -2, -3, -4, etc. reserved for kernel error codes
3726 
      1, 2, 3, etc    driver specific error codes
 3726 
      1, 2, 3, etc    driver specific error codes
3727 
Remarks:
 3727 
Remarks:
3728 
  * Function codes and the structure of input/output data
 3728 
  * Function codes and the structure of input/output data
3729 
    are defined by driver.
 3729 
    are defined by driver.
3730 
  * Previously one must obtain driver handle by subfunction 16.
 3730 
  * Previously one must obtain driver handle by subfunction 16.
3731 
 
 3731 
 
3732 
======================================================================
 3732 
======================================================================
3733 
====== Function 68, subfunction 18 - set SSE exception handler. ======
 3733 
====== Function 68, subfunction 18 - set SSE exception handler. ======
3734 
======================================================================
 3734 
======================================================================
3735 
Deleted (in current implementation only 0 is returned).
 3735 
Deleted (in current implementation only 0 is returned).
3736 
Using subfunctions 24, 25 is true.
 3736 
Using subfunctions 24, 25 is true.
3737 
 
 3737 
 
3738 
======================================================================
 3738 
======================================================================
3739 
=============== Function 68, subfunction 19 - load DLL. ==============
 3739 
=============== Function 68, subfunction 19 - load DLL. ==============
3740 
======================================================================
 3740 
======================================================================
3741 
Parameters:
 3741 
Parameters:
3742 
  * eax = 68 - function number
 3742 
  * eax = 68 - function number
3743 
  * ebx = 19 - subfunction number
 3743 
  * ebx = 19 - subfunction number
3744 
  * ecx = pointer to ASCIIZ-string with the full path to DLL
 3744 
  * ecx = pointer to ASCIIZ-string with the full path to DLL
3745 
Returned value:
 3745 
Returned value:
3746 
  * eax = 0 - failed
 3746 
  * eax = 0 - failed
3747 
  * otherwise eax = pointer to DLL export table
 3747 
  * otherwise eax = pointer to DLL export table
3748 
Remarks:
 3748 
Remarks:
3749 
  * Export table is an array of structures of 2 dword's, terminated
 3749 
  * Export table is an array of structures of 2 dword's, terminated
3750 
    by zero. The first dword in structure points to function name,
 3750 
    by zero. The first dword in structure points to function name,
3751 
    the second dword contains address of function.
 3751 
    the second dword contains address of function.
3752 
 
 3752 
 
3753 
======================================================================
 3753 
======================================================================
3754 
======= Function 68, subfunction 20 - reallocate memory block. =======
 3754 
======= Function 68, subfunction 20 - reallocate memory block. =======
3755 
======================================================================
 3755 
======================================================================
3756 
Parameters:
 3756 
Parameters:
3757 
  * eax = 68 - function number
 3757 
  * eax = 68 - function number
3758 
  * ebx = 20 - subfunction number
 3758 
  * ebx = 20 - subfunction number
3759 
  * ecx = new size in bytes
 3759 
  * ecx = new size in bytes
3760 
  * edx = pointer to already allocated block
 3760 
  * edx = pointer to already allocated block
3761 
Returned value:
 3761 
Returned value:
3762 
  * eax = pointer to the reallocated block, 0 = error
 3762 
  * eax = pointer to the reallocated block, 0 = error
3763 
Remarks:
 3763 
Remarks:
3764 
  * Before this call one must initialize process heap by call to
 3764 
  * Before this call one must initialize process heap by call to
3765 
    subfunction 11.
 3765 
    subfunction 11.
3766 
  * The function allocates an integer number of pages (4 Kb) in such
 3766 
  * The function allocates an integer number of pages (4 Kb) in such
3767 
    way that the real size of allocated block is more than or equal to
 3767 
    way that the real size of allocated block is more than or equal to
3768 
    requested size.
 3768 
    requested size.
3769 
  * If edx=0, the function call is equivalent to memory allocation
 3769 
  * If edx=0, the function call is equivalent to memory allocation
3770 
    with subfunction 12. Otherwise the block at edx
 3770 
    with subfunction 12. Otherwise the block at edx
3771 
    must be allocated earlier with subfunction 12 or this subfunction.
 3771 
    must be allocated earlier with subfunction 12 or this subfunction.
3772 
  * If ecx=0, the function frees memory block at edx and returns 0.
 3772 
  * If ecx=0, the function frees memory block at edx and returns 0.
3773 
  * The contents of the block are unchanged up to the shorter of
 3773 
  * The contents of the block are unchanged up to the shorter of
3774 
    the new and old sizes.
 3774 
    the new and old sizes.
3775 
 
 3775 
 
3776 
======================================================================
 3776 
======================================================================
3777 
====== Function 68, subfunction 24 - set new exceptions handler ======
 3777 
====== Function 68, subfunction 24 - set new exceptions handler ======
3778 
======================================================================
 3778 
======================================================================
3779 
Parameters:
 3779 
Parameters:
3780 
  * eax = 68 - function number
 3780 
  * eax = 68 - function number
3781 
  * ebx = 24 - subfunction number
 3781 
  * ebx = 24 - subfunction number
3782 
  * ecx = address of the new exception handler
 3782 
  * ecx = address of the new exception handler
3783 
  * edx = the mask of processing exceptions
 3783 
  * edx = the mask of processing exceptions
3784 
Returned value:
 3784 
Returned value:
3785 
  * eax = address of the old exception handler (0, if it was not set)
 3785 
  * eax = address of the old exception handler (0, if it was not set)
3786 
  * ebx = the old mask of exception handler
 3786 
  * ebx = the old mask of exception handler
3787 
Remarks:
 3787 
Remarks:
3788 
  * Bit number in mask of exceptions is correspond to exception number
 3788 
  * Bit number in mask of exceptions is correspond to exception number
3789 
    by CPU-specification (Intel-PC). For example, FPU-exception have
 3789 
    by CPU-specification (Intel-PC). For example, FPU-exception have
3790 
    number 16 (#MF), and SSE-exception - 19 (#XF)
 3790 
    number 16 (#MF), and SSE-exception - 19 (#XF)
3791 
  * The current implementation ignore the inquiry for hook of 7
 3791 
  * The current implementation ignore the inquiry for hook of 7
3792 
    exception - system process #NM by one's own.
 3792 
    exception - system process #NM by one's own.
3793 
  * User handler get exception number in stack parameter. So, correct
 3793 
  * User handler get exception number in stack parameter. So, correct
3794 
    exit from handler is: RET 4. Return from handler is to the same
 3794 
    exit from handler is: RET 4. Return from handler is to the same
3795 
    instruction, that was cause the exception
 3795 
    instruction, that was cause the exception
3796 
  * When control is transfering to user handler, corresponding bit in
 3796 
  * When control is transfering to user handler, corresponding bit in
3797 
    exception mask is clearing. Rising this exception in consequence
 3797 
    exception mask is clearing. Rising this exception in consequence
3798 
    - reduce to default-handling. Exactly: terminating the application,
 3798 
    - reduce to default-handling. Exactly: terminating the application,
3799 
    or suspending with debug-notify to owner.
 3799 
    or suspending with debug-notify to owner.
3800 
  * After completion of critical operations in user handler, it may be
 3800 
  * After completion of critical operations in user handler, it may be
3801 
    rising corresponding bit in exception mask by using subfunction 25
 3801 
    rising corresponding bit in exception mask by using subfunction 25
3802 
    Clearing exceptions flags in FPU and/or XMM modules - is
 3802 
    Clearing exceptions flags in FPU and/or XMM modules - is
3803 
    responsibility of user handler too.
 3803 
    responsibility of user handler too.
3804 
 
 3804 
 
3805 
======================================================================
 3805 
======================================================================
3806 
==== Function 68, subfunction 25 - change state of signal activity ===
 3806 
==== Function 68, subfunction 25 - change state of signal activity ===
3807 
======================================================================
 3807 
======================================================================
3808 
Parameters:
 3808 
Parameters:
3809 
  * eax = 68 - function number
 3809 
  * eax = 68 - function number
3810 
  * ebx = 25 - subfunction number
 3810 
  * ebx = 25 - subfunction number
3811 
  * ecx = signal number
 3811 
  * ecx = signal number
3812 
  * edx = value of activity (0/1)
 3812 
  * edx = value of activity (0/1)
3813 
Returned value:
 3813 
Returned value:
3814 
  * eax = value of old activity for this signal (0/1)
 3814 
  * eax = value of old activity for this signal (0/1)
3815 
Remarks:
 3815 
Remarks:
3816 
  * In current implementation, it is changed only exception mask for
 3816 
  * In current implementation, it is changed only exception mask for
3817 
    user exception handler, wich was previously set by subfunction 24.
 3817 
    user exception handler, wich was previously set by subfunction 24.
3818 
    At that, number of signal correspond to exception number.
 3818 
    At that, number of signal correspond to exception number.
3819 
 
 3819 
 
3820 
======================================================================
 3820 
======================================================================
3821 
====================== Fucntion 69 - debugging. ======================
 3821 
====================== Fucntion 69 - debugging. ======================
3822 
======================================================================
 3822 
======================================================================
3823 
A process can load other process as debugged by set of corresponding
 3823 
A process can load other process as debugged by set of corresponding
3824 
bit by call to subfunction 7 of function 70.
 3824 
bit by call to subfunction 7 of function 70.
3825 
A process can have only one debugger; one process can debug some
 3825 
A process can have only one debugger; one process can debug some
3826 
others. The system notifies debugger on events occuring with
 3826 
others. The system notifies debugger on events occuring with
3827 
debugged process. Messages are written to the buffer defined by
 3827 
debugged process. Messages are written to the buffer defined by
3828 
subfunction 0.
 3828 
subfunction 0.
3829 
Format of a message:
 3829 
Format of a message:
3830 
  * +0: dword: message code
 3830 
  * +0: dword: message code
3831 
  * +4: dword: PID of debugged process
 3831 
  * +4: dword: PID of debugged process
3832 
  * +8: there can be additional data depending on message code
 3832 
  * +8: there can be additional data depending on message code
3833 
Message codes:
 3833 
Message codes:
3834 
  * 1 = exception
 3834 
  * 1 = exception
3835 
    * in addition dword-number of the exception is given
 3835 
    * in addition dword-number of the exception is given
3836 
    * process is suspended
 3836 
    * process is suspended
3837 
  * 2 = process has terminated
 3837 
  * 2 = process has terminated
3838 
    * comes at any termination: both through the system function -1,
 3838 
    * comes at any termination: both through the system function -1,
3839 
      and at "murder" by any other process (including debugger itself)
 3839 
      and at "murder" by any other process (including debugger itself)
3840 
  * 3 = debug exception int 1 = #DB
 3840 
  * 3 = debug exception int 1 = #DB
3841 
    * in addition dword-image of the register DR6 is given:
 3841 
    * in addition dword-image of the register DR6 is given:
3842 
      * bits 0-3: condition of the corresponding breakpoint (set by
 3842 
      * bits 0-3: condition of the corresponding breakpoint (set by
3843 
        subfunction 9) is satisfied
 3843 
        subfunction 9) is satisfied
3844 
      * áèò 14: exception has occured because of the trace mode
 3844 
      * áèò 14: exception has occured because of the trace mode
3845 
        (flag TF is set TF)
 3845 
        (flag TF is set TF)
3846 
    * process is suspended
 3846 
    * process is suspended
3847 
When debugger terminates, all debugged processes are killed.
 3847 
When debugger terminates, all debugged processes are killed.
3848 
If debugger does not want this, it must previously detach by
 3848 
If debugger does not want this, it must previously detach by
3849 
subfunction 3.
 3849 
subfunction 3.
3850 
 
 3850 
 
3851 
All subfunctions are applicable only to processes/threads started
 3851 
All subfunctions are applicable only to processes/threads started
3852 
from the current by function 70 with set debugging flag.
 3852 
from the current by function 70 with set debugging flag.
3853 
Debugging of multithreaded programs is not supported yet.
 3853 
Debugging of multithreaded programs is not supported yet.
3854 
The full list of subfunctions:
 3854 
The full list of subfunctions:
3855 
  * subfunction 0 - define data area for debug messages
 3855 
  * subfunction 0 - define data area for debug messages
3856 
  * subfunction 1 - get contents of registers of debugged thread
 3856 
  * subfunction 1 - get contents of registers of debugged thread
3857 
  * subfunction 2 - set contents of registers of debugged thread
 3857 
  * subfunction 2 - set contents of registers of debugged thread
3858 
  * subfunction 3 - detach from debugged process
 3858 
  * subfunction 3 - detach from debugged process
3859 
  * subfunction 4 - suspend debugged thread
 3859 
  * subfunction 4 - suspend debugged thread
3860 
  * subfunction 5 - resume debugged thread
 3860 
  * subfunction 5 - resume debugged thread
3861 
  * subfunction 6 - read from the memory of debugged process
 3861 
  * subfunction 6 - read from the memory of debugged process
3862 
  * subfunction 7 - write to the memory of debugged process
 3862 
  * subfunction 7 - write to the memory of debugged process
3863 
  * subfunction 8 - terminate debugged thread
 3863 
  * subfunction 8 - terminate debugged thread
3864 
  * subfunction 9 - set/clear hardware breakpoint
 3864 
  * subfunction 9 - set/clear hardware breakpoint
3865 
 
 3865 
 
3866 
======================================================================
 3866 
======================================================================
3867 
= Function 69, subfunction 0 - define data area fror debug messages. =
 3867 
= Function 69, subfunction 0 - define data area fror debug messages. =
3868 
======================================================================
 3868 
======================================================================
3869 
Parameters:
 3869 
Parameters:
3870 
  * eax = 69 - function number
 3870 
  * eax = 69 - function number
3871 
  * ebx = 0 - subfunction number
 3871 
  * ebx = 0 - subfunction number
3872 
  * ecx = pointer
 3872 
  * ecx = pointer
3873 
Format of data area:
 3873 
Format of data area:
3874 
  * +0: dword: N = buffer size (not including this header)
 3874 
  * +0: dword: N = buffer size (not including this header)
3875 
  * +4: dword: occupied place
 3875 
  * +4: dword: occupied place
3876 
  * +8: N*byte: buffer
 3876 
  * +8: N*byte: buffer
3877 
Returned value:
 3877 
Returned value:
3878 
  * function does not return value
 3878 
  * function does not return value
3879 
Remarks:
 3879 
Remarks:
3880 
  * If the size field is negative, the buffer is considered locked
 3880 
  * If the size field is negative, the buffer is considered locked
3881 
    and at arrival of new message the system will wait.
 3881 
    and at arrival of new message the system will wait.
3882 
    For synchronization frame all work with the buffer by operations
 3882 
    For synchronization frame all work with the buffer by operations
3883 
    lock/unlock
 3883 
    lock/unlock
3884 
        neg     [bufsize]
 3884 
        neg     [bufsize]
3885 
  * Data in the buffer are considered as array of items with variable
 3885 
  * Data in the buffer are considered as array of items with variable
3886 
    length - messages. Format of a message is explained in
 3886 
    length - messages. Format of a message is explained in
3887 
    general description.
 3887 
    general description.
3888 
 
 3888 
 
3889 
======================================================================
 3889 
======================================================================
3890 
===================== Function 69, subfunction 1 =====================
 3890 
===================== Function 69, subfunction 1 =====================
3891 
============ Get contents of registers of debugged thread. ===========
 3891 
============ Get contents of registers of debugged thread. ===========
3892 
======================================================================
 3892 
======================================================================
3893 
Parameters:
 3893 
Parameters:
3894 
  * eax = 69 - function number
 3894 
  * eax = 69 - function number
3895 
  * ebx = 1 - subfunction number
 3895 
  * ebx = 1 - subfunction number
3896 
  * ecx = thread identifier
 3896 
  * ecx = thread identifier
3897 
  * edx = size of context structure, must be 0x28=40 bytes
 3897 
  * edx = size of context structure, must be 0x28=40 bytes
3898 
  * esi = pointer to context structure
 3898 
  * esi = pointer to context structure
3899 
Returned value:
 3899 
Returned value:
3900 
  * function does not return value
 3900 
  * function does not return value
3901 
Format of context structure: (FPU is not supported yet)
 3901 
Format of context structure: (FPU is not supported yet)
3902 
  * +0: dword: eip
 3902 
  * +0: dword: eip
3903 
  * +4: dword: eflags
 3903 
  * +4: dword: eflags
3904 
  * +8: dword: eax
 3904 
  * +8: dword: eax
3905 
  * +12 = +0xC: dword: ecx
 3905 
  * +12 = +0xC: dword: ecx
3906 
  * +16 = +0x10: dword: edx
 3906 
  * +16 = +0x10: dword: edx
3907 
  * +20 = +0x14: dword: ebx
 3907 
  * +20 = +0x14: dword: ebx
3908 
  * +24 = +0x18: dword: esp
 3908 
  * +24 = +0x18: dword: esp
3909 
  * +28 = +0x1C: dword: ebp
 3909 
  * +28 = +0x1C: dword: ebp
3910 
  * +32 = +0x20: dword: esi
 3910 
  * +32 = +0x20: dword: esi
3911 
  * +36 = +0x24: dword: edi
 3911 
  * +36 = +0x24: dword: edi
3912 
Remarks:
 3912 
Remarks:
3913 
  * If the thread executes code of ring-0, the function returns
 3913 
  * If the thread executes code of ring-0, the function returns
3914 
    contents of registers of ring-3.
 3914 
    contents of registers of ring-3.
3915 
  * Process must be loaded for debugging (as is shown in
 3915 
  * Process must be loaded for debugging (as is shown in
3916 
    general description).
 3916 
    general description).
3917 
 
 3917 
 
3918 
======================================================================
 3918 
======================================================================
3919 
===================== Function 69, subfunction 2 =====================
 3919 
===================== Function 69, subfunction 2 =====================
3920 
============ Set contents of registers of debugged thread. ===========
 3920 
============ Set contents of registers of debugged thread. ===========
3921 
======================================================================
 3921 
======================================================================
3922 
Parameters:
 3922 
Parameters:
3923 
  * eax = 69 - function number
 3923 
  * eax = 69 - function number
3924 
  * ebx = 2 - subfunction number
 3924 
  * ebx = 2 - subfunction number
3925 
  * ecx = thread identifier
 3925 
  * ecx = thread identifier
3926 
  * edx = size of context structure, must be 0x28=40 bytes
 3926 
  * edx = size of context structure, must be 0x28=40 bytes
3927 
Returned value:
 3927 
Returned value:
3928 
  * function does not return value
 3928 
  * function does not return value
3929 
Format of context structure is shown in the description of
 3929 
Format of context structure is shown in the description of
3930 
subfunction 1.
 3930 
subfunction 1.
3931 
Remarks:
 3931 
Remarks:
3932 
  * If the thread executes code of ring-0, the function returns
 3932 
  * If the thread executes code of ring-0, the function returns
3933 
    contents of registers of ring-3.
 3933 
    contents of registers of ring-3.
3934 
  * Process must be loaded for debugging (as is shown in
 3934 
  * Process must be loaded for debugging (as is shown in
3935 
    general description).
 3935 
    general description).
3936 
 
 3936 
 
3937 
======================================================================
 3937 
======================================================================
3938 
===== Function 69, subfunction 3 - detach from debugged process. =====
 3938 
===== Function 69, subfunction 3 - detach from debugged process. =====
3939 
======================================================================
 3939 
======================================================================
3940 
Parameters:
 3940 
Parameters:
3941 
  * eax = 69 - function number
 3941 
  * eax = 69 - function number
3942 
  * ebx = 3 - subfunction number
 3942 
  * ebx = 3 - subfunction number
3943 
  * ecx = identifier
 3943 
  * ecx = identifier
3944 
Returned value:
 3944 
Returned value:
3945 
  * function does not return value
 3945 
  * function does not return value
3946 
Remarks:
 3946 
Remarks:
3947 
  * If the process was suspended, it resumes execution.
 3947 
  * If the process was suspended, it resumes execution.
3948 
 
 3948 
 
3949 
======================================================================
 3949 
======================================================================
3950 
======== Function 69, subfunction 4 - suspend debugged thread. =======
 3950 
======== Function 69, subfunction 4 - suspend debugged thread. =======
3951 
======================================================================
 3951 
======================================================================
3952 
Parameters:
 3952 
Parameters:
3953 
  * eax = 69 - function number
 3953 
  * eax = 69 - function number
3954 
  * ebx = 4 - subfunction number
 3954 
  * ebx = 4 - subfunction number
3955 
  * ecx = thread identifier
 3955 
  * ecx = thread identifier
3956 
Returned value:
 3956 
Returned value:
3957 
  * function does not return value
 3957 
  * function does not return value
3958 
Remarks:
 3958 
Remarks:
3959 
  * Process must be loaded for debugging (as is shown in
 3959 
  * Process must be loaded for debugging (as is shown in
3960 
    general description).
 3960 
    general description).
3961 
 
 3961 
 
3962 
======================================================================
 3962 
======================================================================
3963 
======== Function 69, subfunction 5 - resume debugged thread. ========
 3963 
======== Function 69, subfunction 5 - resume debugged thread. ========
3964 
======================================================================
 3964 
======================================================================
3965 
Parameters:
 3965 
Parameters:
3966 
  * eax = 69 - function number
 3966 
  * eax = 69 - function number
3967 
  * ebx = 5 - subfunction number
 3967 
  * ebx = 5 - subfunction number
3968 
  * ecx = thread identifier
 3968 
  * ecx = thread identifier
3969 
Returned value:
 3969 
Returned value:
3970 
  * function does not return value
 3970 
  * function does not return value
3971 
Remarks:
 3971 
Remarks:
3972 
  * Process must be loaded for debugging (as is shown in
 3972 
  * Process must be loaded for debugging (as is shown in
3973 
    general description).
 3973 
    general description).
3974 
 
 3974 
 
3975 
======================================================================
 3975 
======================================================================
3976 
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
 3976 
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
3977 
======================================================================
 3977 
======================================================================
3978 
Parameters:
 3978 
Parameters:
3979 
  * eax = 69 - function number
 3979 
  * eax = 69 - function number
3980 
  * ebx = 6 - subfunction number
 3980 
  * ebx = 6 - subfunction number
3981 
  * ecx = identifier
 3981 
  * ecx = identifier
3982 
  * edx = number of bytes to read
 3982 
  * edx = number of bytes to read
3983 
  * esi = address in the memory of debugged process
 3983 
  * esi = address in the memory of debugged process
3984 
  * edi = pointer to buffer for data
 3984 
  * edi = pointer to buffer for data
3985 
Returned value:
 3985 
Returned value:
3986 
  * eax = -1 at an error (invalid PID or buffer)
 3986 
  * eax = -1 at an error (invalid PID or buffer)
3987 
  * otherwise eax = number of read bytes (possibly, 0,
 3987 
  * otherwise eax = number of read bytes (possibly, 0,
3988 
    if esi is too large)
 3988 
    if esi is too large)
3989 
Remarks:
 3989 
Remarks:
3990 
  * Process must be loaded for debugging (as is shown in
 3990 
  * Process must be loaded for debugging (as is shown in
3991 
    general description).
 3991 
    general description).
3992 
 
 3992 
 
3993 
======================================================================
 3993 
======================================================================
3994 
== Function 69, subfunction 7 - write to memory of debugged process. =
 3994 
== Function 69, subfunction 7 - write to memory of debugged process. =
3995 
======================================================================
 3995 
======================================================================
3996 
Parameters:
 3996 
Parameters:
3997 
  * eax = 69 - function number
 3997 
  * eax = 69 - function number
3998 
  * ebx = 7 - subfunction number
 3998 
  * ebx = 7 - subfunction number
3999 
  * ecx = identifier
 3999 
  * ecx = identifier
4000 
  * edx = number of bytes to write
 4000 
  * edx = number of bytes to write
4001 
  * esi = address of memory in debugged process
 4001 
  * esi = address of memory in debugged process
4002 
  * edi = pointer to data
 4002 
  * edi = pointer to data
4003 
Returned value:
 4003 
Returned value:
4004 
  * eax = -1 at an error (invalid PID or buffer)
 4004 
  * eax = -1 at an error (invalid PID or buffer)
4005 
  * otherwise eax = number of written bytes (possibly, 0,
 4005 
  * otherwise eax = number of written bytes (possibly, 0,
4006 
    if esi is too large)
 4006 
    if esi is too large)
4007 
Remarks:
 4007 
Remarks:
4008 
  * Process must be loaded for debugging (as is shown in
 4008 
  * Process must be loaded for debugging (as is shown in
4009 
    general description).
 4009 
    general description).
4010 
 
 4010 
 
4011 
======================================================================
 4011 
======================================================================
4012 
======= Function 69, subfunction 8 - terminate debugged thread. ======
 4012 
======= Function 69, subfunction 8 - terminate debugged thread. ======
4013 
======================================================================
 4013 
======================================================================
4014 
Parameters:
 4014 
Parameters:
4015 
  * eax = 69 - function number
 4015 
  * eax = 69 - function number
4016 
  * ebx = 8 - subfunction number
 4016 
  * ebx = 8 - subfunction number
4017 
  * ecx = identifier
 4017 
  * ecx = identifier
4018 
Returned value:
 4018 
Returned value:
4019 
  * function does not return value
 4019 
  * function does not return value
4020 
Remarks:
 4020 
Remarks:
4021 
  * Process must be loaded for debugging (as is shown in
 4021 
  * Process must be loaded for debugging (as is shown in
4022 
    general description).
 4022 
    general description).
4023 
  * The function is similar to subfunction 2 of function 18
 4023 
  * The function is similar to subfunction 2 of function 18
4024 
    with two differences: it requires first remark and
 4024 
    with two differences: it requires first remark and
4025 
    accepts PID rather than slot number.
 4025 
    accepts PID rather than slot number.
4026 
 
 4026 
 
4027 
======================================================================
 4027 
======================================================================
4028 
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
 4028 
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
4029 
======================================================================
 4029 
======================================================================
4030 
Parameters:
 4030 
Parameters:
4031 
  * eax = 69 - function number
 4031 
  * eax = 69 - function number
4032 
  * ebx = 9 - subfunction number
 4032 
  * ebx = 9 - subfunction number
4033 
  * ecx = thread identifier
 4033 
  * ecx = thread identifier
4034 
  * dl = index of breakpoint, from 0 to 3 inclusively
 4034 
  * dl = index of breakpoint, from 0 to 3 inclusively
4035 
  * dh = flags:
 4035 
  * dh = flags:
4036 
    * if high bit is cleared - set breakpoint:
 4036 
    * if high bit is cleared - set breakpoint:
4037 
      * bits 0-1 - condition:
 4037 
      * bits 0-1 - condition:
4038 
        * 00 = breakpoint on execution
 4038 
        * 00 = breakpoint on execution
4039 
        * 01 = breakpoint on read
 4039 
        * 01 = breakpoint on read
4040 
        * 11 = breakpoint on read/write
 4040 
        * 11 = breakpoint on read/write
4041 
      * bits 2-3 - length; for breakpoints on exception it must be
 4041 
      * bits 2-3 - length; for breakpoints on exception it must be
4042 
        00, otherwise one of
 4042 
        00, otherwise one of
4043 
        * 00 = byte
 4043 
        * 00 = byte
4044 
        * 01 = word
 4044 
        * 01 = word
4045 
        * 11 = dword
 4045 
        * 11 = dword
4046 
      * esi = breakpoint address; must be aligned according to
 4046 
      * esi = breakpoint address; must be aligned according to
4047 
        the length (i.e. must be even for word breakpoints,
 4047 
        the length (i.e. must be even for word breakpoints,
4048 
        divisible by 4 for dword)
 4048 
        divisible by 4 for dword)
4049 
    * if high bit is set - clear breakpoint
 4049 
    * if high bit is set - clear breakpoint
4050 
Returned value:
 4050 
Returned value:
4051 
  * eax = 0 - success
 4051 
  * eax = 0 - success
4052 
  * eax = 1 - error in the input data
 4052 
  * eax = 1 - error in the input data
4053 
  * eax = 2 - (reserved, is never returned in the current
 4053 
  * eax = 2 - (reserved, is never returned in the current
4054 
    implementation) a global breakpoint with that index is already set
 4054 
    implementation) a global breakpoint with that index is already set
4055 
Remarks:
 4055 
Remarks:
4056 
  * Process must be loaded for debugging (as is shown in
 4056 
  * Process must be loaded for debugging (as is shown in
4057 
    general description).
 4057 
    general description).
4058 
  * Hardware breakpoints are implemented through DRx-registers of
 4058 
  * Hardware breakpoints are implemented through DRx-registers of
4059 
    the processor, all limitations results from this.
 4059 
    the processor, all limitations results from this.
4060 
  * The function can reinstall the breakpoint, previously set
 4060 
  * The function can reinstall the breakpoint, previously set
4061 
    by it (and it does not inform on this).
 4061 
    by it (and it does not inform on this).
4062 
    Carry on the list of set breakpoints in the debugger.
 4062 
    Carry on the list of set breakpoints in the debugger.
4063 
  * Breakpoints generate debug exception #DB, on which the system
 4063 
  * Breakpoints generate debug exception #DB, on which the system
4064 
    notifies debugger.
 4064 
    notifies debugger.
4065 
  * Breakpoints on write and read/write act after
 4065 
  * Breakpoints on write and read/write act after
4066 
    execution of the caused it instruction.
 4066 
    execution of the caused it instruction.
4067 
 
 4067 
 
4068 
======================================================================
 4068 
======================================================================
4069 
==== Function 70 - work with file system with long names support. ====
 4069 
==== Function 70 - work with file system with long names support. ====
4070 
======================================================================
 4070 
======================================================================
4071 
Parameters:
 4071 
Parameters:
4072 
  * eax = 70
 4072 
  * eax = 70
4073 
  * ebx = pointer to the information structure
 4073 
  * ebx = pointer to the information structure
4074 
Returned value:
 4074 
Returned value:
4075 
  * eax = 0 - success; otherwise file system error code
 4075 
  * eax = 0 - success; otherwise file system error code
4076 
  * some subfunctions return value in other registers too
 4076 
  * some subfunctions return value in other registers too
4077 
General format of the information structure:
 4077 
General format of the information structure:
4078 
  * +0: dword: subfunction number
 4078 
  * +0: dword: subfunction number
4079 
  * +4: dword: file offset
 4079 
  * +4: dword: file offset
4080 
  * +8: dword: high dword of offset (must be 0) or flags field
 4080 
  * +8: dword: high dword of offset (must be 0) or flags field
4081 
  * +12 = +0xC: dword: size
 4081 
  * +12 = +0xC: dword: size
4082 
  * +16 = +0x10: dword: pointer to data
 4082 
  * +16 = +0x10: dword: pointer to data
4083 
  * +20 = +0x14: n db: ASCIIZ-string with the filename
 4083 
  * +20 = +0x14: n db: ASCIIZ-string with the filename
4084 
    or
 4084 
    or
4085 
  * +20 = +0x14: db 0
 4085 
  * +20 = +0x14: db 0
4086 
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
 4086 
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
4087 
Specifications - in documentation on the appropriate subfunction.
 4087 
Specifications - in documentation on the appropriate subfunction.
4088 
Filename is case-insensitive. Russian letters must be written in
 4088 
Filename is case-insensitive. Russian letters must be written in
4089 
the encoding cp866 (DOS).
 4089 
the encoding cp866 (DOS).
4090 
Format of filename:
 4090 
Format of filename:
4091 
/base/number/dir1/dir2/.../dirn/file,
 4091 
/base/number/dir1/dir2/.../dirn/file,
4092 
where /base/number identifies device, on which file is located:
 4092 
where /base/number identifies device, on which file is located:
4093 
one of
 4093 
one of
4094 
  * /RD/1 = /RAMDISK/1 to access ramdisk
 4094 
  * /RD/1 = /RAMDISK/1 to access ramdisk
4095 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
 4095 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
4096 
    /FD/2 = /FLOPPYDISK/2 to access second one
 4096 
    /FD/2 = /FLOPPYDISK/2 to access second one
4097 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
 4097 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
4098 
    IDE0 (Primary Master), IDE1 (Primary Slave),
 4098 
    IDE0 (Primary Master), IDE1 (Primary Slave),
4099 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
 4099 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4100 
    x - partition number on the selected hard drive, varies from 1
 4100 
    x - partition number on the selected hard drive, varies from 1
4101 
    to 255 (on each hard drive the indexing starts from 1)
 4101 
    to 255 (on each hard drive the indexing starts from 1)
4102 
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
 4102 
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
4103 
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
 4103 
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
4104 
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
 4104 
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
4105 
  * /SYS means system folder; with the usual boot (from floppy)
 4105 
  * /SYS means system folder; with the usual boot (from floppy)
4106 
    is equivalent to /RD/1
 4106 
    is equivalent to /RD/1
4107 
Examples:
 4107 
Examples:
4108 
  * '/rd/1/kernel.asm',0
 4108 
  * '/rd/1/kernel.asm',0
4109 
  * '/HD0/1/kernel.asm',0
 4109 
  * '/HD0/1/kernel.asm',0
4110 
  * '/hd0/2/menuet/pics/tanzania.bmp',0
 4110 
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4111 
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
 4111 
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
4112 
  * '/sys/MySuperApp.ini',0
 4112 
  * '/sys/MySuperApp.ini',0
4113 
Available subfunctions:
 4113 
Available subfunctions:
4114 
  * subfunction 0 - read file
 4114 
  * subfunction 0 - read file
4115 
  * subfunction 1 - read folder
 4115 
  * subfunction 1 - read folder
4116 
  * subfunction 2 - create/rewrite file
 4116 
  * subfunction 2 - create/rewrite file
4117 
  * subfunction 3 - write to existing file
 4117 
  * subfunction 3 - write to existing file
4118 
  * subfunction 4 - set file size
 4118 
  * subfunction 4 - set file size
4119 
  * subfunction 5 - get attributes of file/folder
 4119 
  * subfunction 5 - get attributes of file/folder
4120 
  * subfunction 6 - set attributes of file/folder
 4120 
  * subfunction 6 - set attributes of file/folder
4121 
  * subfunction 7 - start application
 4121 
  * subfunction 7 - start application
4122 
  * subfunction 8 - delete file/folder
 4122 
  * subfunction 8 - delete file/folder
4123 
  * subfunction 9 - create folder
 4123 
  * subfunction 9 - create folder
4124 
For CD-drives due to hardware limitations only subfunctions
 4124 
For CD-drives due to hardware limitations only subfunctions
4125 
0,1,5 and 7 are available, other subfunctions return error
 4125 
0,1,5 and 7 are available, other subfunctions return error
4126 
with code 2.
 4126 
with code 2.
4127 
At the first call of subfunctions 0,1,5,7 to ATAPI devices
 4127 
At the first call of subfunctions 0,1,5,7 to ATAPI devices
4128 
(CD and DVD) the manual control of tray is locked due to caching
 4128 
(CD and DVD) the manual control of tray is locked due to caching
4129 
drive data. Unlocking is made when subfunction 4 of function 24
 4129 
drive data. Unlocking is made when subfunction 4 of function 24
4130 
is called for corresponding device.
 4130 
is called for corresponding device.
4131 
 
 4131 
 
4132 
======================================================================
 4132 
======================================================================
4133 
=== Function 70, subfunction 0 - read file with long names support. ==
 4133 
=== Function 70, subfunction 0 - read file with long names support. ==
4134 
======================================================================
 4134 
======================================================================
4135 
Parameters:
 4135 
Parameters:
4136 
  * eax = 70 - function number
 4136 
  * eax = 70 - function number
4137 
  * ebx = pointer to the information structure
 4137 
  * ebx = pointer to the information structure
4138 
Format of the information structure:
 4138 
Format of the information structure:
4139 
  * +0: dword: 0 = subfunction number
 4139 
  * +0: dword: 0 = subfunction number
4140 
  * +4: dword: file offset (in bytes)
 4140 
  * +4: dword: file offset (in bytes)
4141 
  * +8: dword: 0 (reserved for high dword of offset)
 4141 
  * +8: dword: 0 (reserved for high dword of offset)
4142 
  * +12 = +0xC: dword: number of bytes to read
 4142 
  * +12 = +0xC: dword: number of bytes to read
4143 
  * +16 = +0x10: dword: pointer to buffer for data
 4143 
  * +16 = +0x10: dword: pointer to buffer for data
4144 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4144 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4145 
    given in the general description
 4145 
    given in the general description
4146 
    or
 4146 
    or
4147 
  * +20 = +0x14: db 0
 4147 
  * +20 = +0x14: db 0
4148 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4148 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4149 
Returned value:
 4149 
Returned value:
4150 
  * eax = 0 - success, otherwise file system error code
 4150 
  * eax = 0 - success, otherwise file system error code
4151 
  * ebx = number of read bytes or -1=0xffffffff if file was not found
 4151 
  * ebx = number of read bytes or -1=0xffffffff if file was not found
4152 
Remarks:
 4152 
Remarks:
4153 
  * If file was ended before last requested block was read,
 4153 
  * If file was ended before last requested block was read,
4154 
    the function will read as many as it can, and after that return
 4154 
    the function will read as many as it can, and after that return
4155 
    eax=6 (EOF).
 4155 
    eax=6 (EOF).
4156 
  * The function does not allow to read folder (returns eax=10,
 4156 
  * The function does not allow to read folder (returns eax=10,
4157 
    access denied).
 4157 
    access denied).
4158 
 
 4158 
 
4159 
======================================================================
 4159 
======================================================================
4160 
== Function 70, subfunction 1 - read folder with long names support. =
 4160 
== Function 70, subfunction 1 - read folder with long names support. =
4161 
======================================================================
 4161 
======================================================================
4162 
Parameters:
 4162 
Parameters:
4163 
  * eax = 70 - function number
 4163 
  * eax = 70 - function number
4164 
  * ebx = pointer to the information structure
 4164 
  * ebx = pointer to the information structure
4165 
Format of the information structure:
 4165 
Format of the information structure:
4166 
  * +0: dword: 1 = subfunction number
 4166 
  * +0: dword: 1 = subfunction number
4167 
  * +4: dword: index of starting block (beginning from 0)
 4167 
  * +4: dword: index of starting block (beginning from 0)
4168 
  * +8: dword: flags field:
 4168 
  * +8: dword: flags field:
4169 
    * bit 0 (mask 1): in what format to return names,
 4169 
    * bit 0 (mask 1): in what format to return names,
4170 
      0=ANSI, 1=UNICODE
 4170 
      0=ANSI, 1=UNICODE
4171 
    * other bits are reserved and must be set to 0 for the future
 4171 
    * other bits are reserved and must be set to 0 for the future
4172 
      compatibility
 4172 
      compatibility
4173 
  * +12 = +0xC: dword: number of blocks to read
 4173 
  * +12 = +0xC: dword: number of blocks to read
4174 
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
 4174 
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
4175 
    must be not less than 32 + [+12]*560 bytes
 4175 
    must be not less than 32 + [+12]*560 bytes
4176 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
 4176 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4177 
    given in the general description
 4177 
    given in the general description
4178 
    or
 4178 
    or
4179 
  * +20 = +0x14: db 0
 4179 
  * +20 = +0x14: db 0
4180 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4180 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4181 
Returned value:
 4181 
Returned value:
4182 
  * eax = 0 - success, otherwise file system error code
 4182 
  * eax = 0 - success, otherwise file system error code
4183 
  * ebx = number of files, information on which was written to
 4183 
  * ebx = number of files, information on which was written to
4184 
    the buffer, or -1=0xffffffff, if folder was not found
 4184 
    the buffer, or -1=0xffffffff, if folder was not found
4185 
Structure of the buffer:
 4185 
Structure of the buffer:
4186 
  * +0: 32*byte: header
 4186 
  * +0: 32*byte: header
4187 
  * +32 = +0x20: n1*byte: block with information on file 1
 4187 
  * +32 = +0x20: n1*byte: block with information on file 1
4188 
  * +32+n1: n2*byte: block with information on file 2
 4188 
  * +32+n1: n2*byte: block with information on file 2
4189 
  * ...
 4189 
  * ...
4190 
Structure of header:
 4190 
Structure of header:
4191 
  * +0: dword: version of structure (current is 1)
 4191 
  * +0: dword: version of structure (current is 1)
4192 
  * +4: dword: number of placed blocks; is not greater than requested
 4192 
  * +4: dword: number of placed blocks; is not greater than requested
4193 
    in the field +12 of information structure; can be less, if
 4193 
    in the field +12 of information structure; can be less, if
4194 
    there are no more files in folder (the same as in ebx)
 4194 
    there are no more files in folder (the same as in ebx)
4195 
  * +8: dword: total number of files in folder
 4195 
  * +8: dword: total number of files in folder
4196 
  * +12 = +0xC: 20*byte: reserved (zeroed)
 4196 
  * +12 = +0xC: 20*byte: reserved (zeroed)
4197 
Structure of block of data for folder entry (BDFE):
 4197 
Structure of block of data for folder entry (BDFE):
4198 
  * +0: dword: attributes of file:
 4198 
  * +0: dword: attributes of file:
4199 
    * bit 0 (mask 1): file is read-only
 4199 
    * bit 0 (mask 1): file is read-only
4200 
    * bit 1 (mask 2): file is hidden
 4200 
    * bit 1 (mask 2): file is hidden
4201 
    * bit 2 (mask 4): file is system
 4201 
    * bit 2 (mask 4): file is system
4202 
    * bit 3 (mask 8): this is not a file but volume label
 4202 
    * bit 3 (mask 8): this is not a file but volume label
4203 
      (for one partition meets no more than once and
 4203 
      (for one partition meets no more than once and
4204 
      only in root folder)
 4204 
      only in root folder)
4205 
    * bit 4 (mask 0x10): this is a folder
 4205 
    * bit 4 (mask 0x10): this is a folder
4206 
    * bit 5 (mask 0x20): file was not archived - many archivation
 4206 
    * bit 5 (mask 0x20): file was not archived - many archivation
4207 
      programs have an option to archive only files with this bit set,
 4207 
      programs have an option to archive only files with this bit set,
4208 
      and after archiving this bit is cleared - it can be useful
 4208 
      and after archiving this bit is cleared - it can be useful
4209 
      for automatically creating of backup-archives as at writing
 4209 
      for automatically creating of backup-archives as at writing
4210 
      this bit is usually set
 4210 
      this bit is usually set
4211 
  * +4: byte: type of name data:
 4211 
  * +4: byte: type of name data:
4212 
    (coincides with bit 0 of flags in the information structure)
 4212 
    (coincides with bit 0 of flags in the information structure)
4213 
    * 0 = ASCII = 1-byte representation of each character
 4213 
    * 0 = ASCII = 1-byte representation of each character
4214 
    * 1 = UNICODE = 2-byte representation of each character
 4214 
    * 1 = UNICODE = 2-byte representation of each character
4215 
  * +5: 3*byte: reserved (zero)
 4215 
  * +5: 3*byte: reserved (zero)
4216 
  * +8: 4*byte: time of file creation
 4216 
  * +8: 4*byte: time of file creation
4217 
  * +12 = +0xC: 4*byte: date of file creation
 4217 
  * +12 = +0xC: 4*byte: date of file creation
4218 
  * +16 = +0x10: 4*byte: time of last access (read or write)
 4218 
  * +16 = +0x10: 4*byte: time of last access (read or write)
4219 
  * +20 = +0x14: 4*byte: date of last access
 4219 
  * +20 = +0x14: 4*byte: date of last access
4220 
  * +24 = +0x18: 4*byte: time of last modification
 4220 
  * +24 = +0x18: 4*byte: time of last modification
4221 
  * +28 = +0x1C: 4*byte: date of last modification
 4221 
  * +28 = +0x1C: 4*byte: date of last modification
4222 
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
 4222 
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
4223 
  * +40 = +0x28: name
 4223 
  * +40 = +0x28: name
4224 
    * for ASCII format: maximum length is 263 characters
 4224 
    * for ASCII format: maximum length is 263 characters
4225 
      (263 bytes), byte after the name has value 0
 4225 
      (263 bytes), byte after the name has value 0
4226 
    * for UNICODE format: maximum length is 259 characters
 4226 
    * for UNICODE format: maximum length is 259 characters
4227 
      (518 bytes), 2 bytes after the name have value 0
 4227 
      (518 bytes), 2 bytes after the name have value 0
4228 
Time format:
 4228 
Time format:
4229 
  * +0: byte: seconds
 4229 
  * +0: byte: seconds
4230 
  * +1: byte: minutes
 4230 
  * +1: byte: minutes
4231 
  * +2: byte: hours
 4231 
  * +2: byte: hours
4232 
  * +3: byte: reserved (0)
 4232 
  * +3: byte: reserved (0)
4233 
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
 4233 
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
4234 
Date format:
 4234 
Date format:
4235 
  * +0: byte: day
 4235 
  * +0: byte: day
4236 
  * +1: byte: month
 4236 
  * +1: byte: month
4237 
  * +2: word: year
 4237 
  * +2: word: year
4238 
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
 4238 
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
4239 
Remarks:
 4239 
Remarks:
4240 
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
 4240 
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
4241 
    if UNICODE name - 560 bytes. Value of length is aligned
 4241 
    if UNICODE name - 560 bytes. Value of length is aligned
4242 
    on 16-byte bound (to accelerate processing in CPU cache).
 4242 
    on 16-byte bound (to accelerate processing in CPU cache).
4243 
  * First character after a name is zero (ASCIIZ-string). The further
 4243 
  * First character after a name is zero (ASCIIZ-string). The further
4244 
    data contain garbage.
 4244 
    data contain garbage.
4245 
  * If files in folder were ended before requested number was read,
 4245 
  * If files in folder were ended before requested number was read,
4246 
    the function will read as many as it can, and after that return
 4246 
    the function will read as many as it can, and after that return
4247 
    eax=6 (EOF).
 4247 
    eax=6 (EOF).
4248 
  * Any folder on the disk, except for root, contains two special
 4248 
  * Any folder on the disk, except for root, contains two special
4249 
    entries "." and "..", identifying accordingly the folder itself
 4249 
    entries "." and "..", identifying accordingly the folder itself
4250 
    and the parent folder.
 4250 
    and the parent folder.
4251 
  * The function allows also to read virtual folders "/", "/rd",
 4251 
  * The function allows also to read virtual folders "/", "/rd",
4252 
    "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
 4252 
    "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
4253 
    and times and dates are zeroed. An alternative way to get the
 4253 
    and times and dates are zeroed. An alternative way to get the
4254 
    equipment information - subfunction 11 of function 18.
 4254 
    equipment information - subfunction 11 of function 18.
4255 
 
 4255 
 
4256 
======================================================================
 4256 
======================================================================
4257 
===================== Function 70, subfunction 2 =====================
 4257 
===================== Function 70, subfunction 2 =====================
4258 
============ Create/rewrite file with long names support. ============
 4258 
============ Create/rewrite file with long names support. ============
4259 
======================================================================
 4259 
======================================================================
4260 
Parameters:
 4260 
Parameters:
4261 
  * eax = 70 - function number
 4261 
  * eax = 70 - function number
4262 
  * ebx = pointer to the information structure
 4262 
  * ebx = pointer to the information structure
4263 
Format of the information structure:
 4263 
Format of the information structure:
4264 
  * +0: dword: 2 = subfunction number
 4264 
  * +0: dword: 2 = subfunction number
4265 
  * +4: dword: 0 (reserved)
 4265 
  * +4: dword: 0 (reserved)
4266 
  * +8: dword: 0 (reserved)
 4266 
  * +8: dword: 0 (reserved)
4267 
  * +12 = +0xC: dword: number of bytes to read
 4267 
  * +12 = +0xC: dword: number of bytes to read
4268 
  * +16 = +0x10: dword: pointer to data
 4268 
  * +16 = +0x10: dword: pointer to data
4269 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4269 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4270 
    given in the general description
 4270 
    given in the general description
4271 
    or
 4271 
    or
4272 
  * +20 = +0x14: db 0
 4272 
  * +20 = +0x14: db 0
4273 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4273 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4274 
Returned value:
 4274 
Returned value:
4275 
  * eax = 0 - success, otherwise file system error code
 4275 
  * eax = 0 - success, otherwise file system error code
4276 
  * ebx = number of written bytes (possibly 0)
 4276 
  * ebx = number of written bytes (possibly 0)
4277 
Remarks:
 4277 
Remarks:
4278 
  * If a file with given name did not exist, it is created;
 4278 
  * If a file with given name did not exist, it is created;
4279 
    if it existed, it is rewritten.
 4279 
    if it existed, it is rewritten.
4280 
  * If there is not enough free space on disk, the function will
 4280 
  * If there is not enough free space on disk, the function will
4281 
    write as many as can and then return error code 8.
 4281 
    write as many as can and then return error code 8.
4282 
  * The function is not supported for CD (returns error code 2).
 4282 
  * The function is not supported for CD (returns error code 2).
4283 
 
 4283 
 
4284 
======================================================================
 4284 
======================================================================
4285 
===================== Function 70, subfunction 3 =====================
 4285 
===================== Function 70, subfunction 3 =====================
4286 
=========== Write to existing file with long names support. ==========
 4286 
=========== Write to existing file with long names support. ==========
4287 
======================================================================
 4287 
======================================================================
4288 
Parameters:
 4288 
Parameters:
4289 
  * eax = 70 - function number
 4289 
  * eax = 70 - function number
4290 
  * ebx = pointer to the information structure
 4290 
  * ebx = pointer to the information structure
4291 
Format of the information structure:
 4291 
Format of the information structure:
4292 
  * +0: dword: 3 = subfunction number
 4292 
  * +0: dword: 3 = subfunction number
4293 
  * +4: dword: file offset (in bytes)
 4293 
  * +4: dword: file offset (in bytes)
4294 
  * +8: dword: high dword of offset (must be 0 for FAT)
 4294 
  * +8: dword: high dword of offset (must be 0 for FAT)
4295 
  * +12 = +0xC: dword: number of bytes to write
 4295 
  * +12 = +0xC: dword: number of bytes to write
4296 
  * +16 = +0x10: dword: pointer to data
 4296 
  * +16 = +0x10: dword: pointer to data
4297 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4297 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4298 
    given in the general description
 4298 
    given in the general description
4299 
    or
 4299 
    or
4300 
  * +20 = +0x14: db 0
 4300 
  * +20 = +0x14: db 0
4301 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4301 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4302 
Returned value:
 4302 
Returned value:
4303 
  * eax = 0 - success, otherwise file system error code
 4303 
  * eax = 0 - success, otherwise file system error code
4304 
  * ebx = number of written bytes (possibly 0)
 4304 
  * ebx = number of written bytes (possibly 0)
4305 
Remarks:
 4305 
Remarks:
4306 
  * The file must already exist, otherwise function returns eax=5.
 4306 
  * The file must already exist, otherwise function returns eax=5.
4307 
  * The only result of write 0 bytes is update in the file attributes
 4307 
  * The only result of write 0 bytes is update in the file attributes
4308 
    date/time of modification and access to the current date/time.
 4308 
    date/time of modification and access to the current date/time.
4309 
  * If beginning and/or ending position is greater than file size
 4309 
  * If beginning and/or ending position is greater than file size
4310 
    (except for the previous case), the file is expanded to needed
 4310 
    (except for the previous case), the file is expanded to needed
4311 
    size with zero characters.
 4311 
    size with zero characters.
4312 
  * The function is not supported for CD (returns error code 2).
 4312 
  * The function is not supported for CD (returns error code 2).
4313 
 
 4313 
 
4314 
======================================================================
 4314 
======================================================================
4315 
============ Function 70, subfunction 4 - set end of file. ===========
 4315 
============ Function 70, subfunction 4 - set end of file. ===========
4316 
======================================================================
 4316 
======================================================================
4317 
Parameters:
 4317 
Parameters:
4318 
  * eax = 70 - function number
 4318 
  * eax = 70 - function number
4319 
  * ebx = pointer to the information structure
 4319 
  * ebx = pointer to the information structure
4320 
Format of the information structure:
 4320 
Format of the information structure:
4321 
  * +0: dword: 4 = subfunction number
 4321 
  * +0: dword: 4 = subfunction number
4322 
  * +4: dword: low dword of new file size
 4322 
  * +4: dword: low dword of new file size
4323 
  * +8: dword: high dword of new file size (must be 0 for FAT)
 4323 
  * +8: dword: high dword of new file size (must be 0 for FAT)
4324 
  * +12 = +0xC: dword: 0 (reserved)
 4324 
  * +12 = +0xC: dword: 0 (reserved)
4325 
  * +16 = +0x10: dword: 0 (reserved)
 4325 
  * +16 = +0x10: dword: 0 (reserved)
4326 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4326 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4327 
    given in the general description
 4327 
    given in the general description
4328 
    or
 4328 
    or
4329 
  * +20 = +0x14: db 0
 4329 
  * +20 = +0x14: db 0
4330 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4330 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4331 
Returned value:
 4331 
Returned value:
4332 
  * eax = 0 - success, otherwise file system error code
 4332 
  * eax = 0 - success, otherwise file system error code
4333 
  * ebx destroyed
 4333 
  * ebx destroyed
4334 
Remarks:
 4334 
Remarks:
4335 
  * If the new file size is less than old one, file is truncated.
 4335 
  * If the new file size is less than old one, file is truncated.
4336 
    If the new size is greater than old one, file is expanded with
 4336 
    If the new size is greater than old one, file is expanded with
4337 
    characters with code 0. If the new size is equal to old one,
 4337 
    characters with code 0. If the new size is equal to old one,
4338 
    the only result of call is set date/time of modification and
 4338 
    the only result of call is set date/time of modification and
4339 
    access to the current date/time.
 4339 
    access to the current date/time.
4340 
  * If there is not enough free space on disk for expansion, the
 4340 
  * If there is not enough free space on disk for expansion, the
4341 
    function will expand to maximum possible size and then return
 4341 
    function will expand to maximum possible size and then return
4342 
    error code 8.
 4342 
    error code 8.
4343 
  * The function is not supported for CD (returns error code 2).
 4343 
  * The function is not supported for CD (returns error code 2).
4344 
 
 4344 
 
4345 
======================================================================
 4345 
======================================================================
4346 
==== Function 70, subfunction 5 - get information on file/folder. ====
 4346 
==== Function 70, subfunction 5 - get information on file/folder. ====
4347 
======================================================================
 4347 
======================================================================
4348 
Parameters:
 4348 
Parameters:
4349 
  * eax = 70 - function number
 4349 
  * eax = 70 - function number
4350 
  * ebx = pointer to the information structure
 4350 
  * ebx = pointer to the information structure
4351 
Format of the information structure:
 4351 
Format of the information structure:
4352 
  * +0: dword: 5 = subfunction number
 4352 
  * +0: dword: 5 = subfunction number
4353 
  * +4: dword: 0 (reserved)
 4353 
  * +4: dword: 0 (reserved)
4354 
  * +8: dword: 0 (reserved)
 4354 
  * +8: dword: 0 (reserved)
4355 
  * +12 = +0xC: dword: 0 (reserved)
 4355 
  * +12 = +0xC: dword: 0 (reserved)
4356 
  * +16 = +0x10: dword: pointer to buffer for data (40 bytes)
 4356 
  * +16 = +0x10: dword: pointer to buffer for data (40 bytes)
4357 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4357 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4358 
    given in the general description
 4358 
    given in the general description
4359 
    or
 4359 
    or
4360 
  * +20 = +0x14: db 0
 4360 
  * +20 = +0x14: db 0
4361 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4361 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4362 
Returned value:
 4362 
Returned value:
4363 
  * eax = 0 - success, otherwise file system error code
 4363 
  * eax = 0 - success, otherwise file system error code
4364 
  * ebx destroyed
 4364 
  * ebx destroyed
4365 
Information on file is returned in the BDFE format (block of data
 4365 
Information on file is returned in the BDFE format (block of data
4366 
for folder entry), explained in the description of
 4366 
for folder entry), explained in the description of
4367 
subfunction 1, but without filename
 4367 
subfunction 1, but without filename
4368 
(i.e. only first 40 = 0x28 bytes).
 4368 
(i.e. only first 40 = 0x28 bytes).
4369 
Remarks:
 4369 
Remarks:
4370 
  * The function does not support virtual folders such as /, /rd and
 4370 
  * The function does not support virtual folders such as /, /rd and
4371 
    root folders like /rd/1.
 4371 
    root folders like /rd/1.
4372 
 
 4372 
 
4373 
======================================================================
 4373 
======================================================================
4374 
===== Function 70, subfunction 6 - set attributes of file/folder. ====
 4374 
===== Function 70, subfunction 6 - set attributes of file/folder. ====
4375 
======================================================================
 4375 
======================================================================
4376 
Parameters:
 4376 
Parameters:
4377 
  * eax = 70 - function number
 4377 
  * eax = 70 - function number
4378 
  * ebx = pointer to the information structure
 4378 
  * ebx = pointer to the information structure
4379 
Format of the information structure:
 4379 
Format of the information structure:
4380 
  * +0: dword: 6 = subfunction number
 4380 
  * +0: dword: 6 = subfunction number
4381 
  * +4: dword: 0 (reserved)
 4381 
  * +4: dword: 0 (reserved)
4382 
  * +8: dword: 0 (reserved)
 4382 
  * +8: dword: 0 (reserved)
4383 
  * +12 = +0xC: dword: 0 (reserved)
 4383 
  * +12 = +0xC: dword: 0 (reserved)
4384 
  * +16 = +0x10: dword: pointer to buffer with attributes (32 bytes)
 4384 
  * +16 = +0x10: dword: pointer to buffer with attributes (32 bytes)
4385 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4385 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4386 
    given in the general description
 4386 
    given in the general description
4387 
    or
 4387 
    or
4388 
  * +20 = +0x14: db 0
 4388 
  * +20 = +0x14: db 0
4389 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4389 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4390 
Returned value:
 4390 
Returned value:
4391 
  * eax = 0 - success, otherwise file system error code
 4391 
  * eax = 0 - success, otherwise file system error code
4392 
  * ebx destroyed
 4392 
  * ebx destroyed
4393 
File attributes are first 32 bytes in BDFE (block of data
 4393 
File attributes are first 32 bytes in BDFE (block of data
4394 
for folder entry), explained in the description of subfunction 1
 4394 
for folder entry), explained in the description of subfunction 1
4395 
(that is, without name and size of file). Attribute
 4395 
(that is, without name and size of file). Attribute
4396 
file/folder/volume label (bits 3,4 in dword +0) is not changed.
 4396 
file/folder/volume label (bits 3,4 in dword +0) is not changed.
4397 
Byte +4 (name format) is ignored.
 4397 
Byte +4 (name format) is ignored.
4398 
Remarks:
 4398 
Remarks:
4399 
  * The function does not support virtual folders such as /, /rd and
 4399 
  * The function does not support virtual folders such as /, /rd and
4400 
    root folders like /rd/1.
 4400 
    root folders like /rd/1.
4401 
  * The function is not supported for CD (returns error code 2).
 4401 
  * The function is not supported for CD (returns error code 2).
4402 
 
 4402 
 
4403 
======================================================================
 4403 
======================================================================
4404 
=========== Function 70, subfunction 7 - start application. ==========
 4404 
=========== Function 70, subfunction 7 - start application. ==========
4405 
======================================================================
 4405 
======================================================================
4406 
Parameters:
 4406 
Parameters:
4407 
  * eax = 70 - function number
 4407 
  * eax = 70 - function number
4408 
  * ebx = pointer to the information structure
 4408 
  * ebx = pointer to the information structure
4409 
Format of the information structure:
 4409 
Format of the information structure:
4410 
  * +0: dword: 7 = subfunction number
 4410 
  * +0: dword: 7 = subfunction number
4411 
  * +4: dword: flags field:
 4411 
  * +4: dword: flags field:
4412 
    * áèò 0: start process as debugged
 4412 
    * áèò 0: start process as debugged
4413 
    * other bits are reserved and must be set to 0
 4413 
    * other bits are reserved and must be set to 0
4414 
  * +8: dword: 0 or pointer to ASCIIZ-string with parameters
 4414 
  * +8: dword: 0 or pointer to ASCIIZ-string with parameters
4415 
  * +12 = +0xC: dword: 0 (reserved)
 4415 
  * +12 = +0xC: dword: 0 (reserved)
4416 
  * +16 = +0x10: dword: 0 (reserved)
 4416 
  * +16 = +0x10: dword: 0 (reserved)
4417 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4417 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4418 
    given in the general description
 4418 
    given in the general description
4419 
    or
 4419 
    or
4420 
  * +20 = +0x14: db 0
 4420 
  * +20 = +0x14: db 0
4421 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4421 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4422 
Returned value:
 4422 
Returned value:
4423 
  * eax > 0 - program is loaded, eax contains PID
 4423 
  * eax > 0 - program is loaded, eax contains PID
4424 
  * eax < 0 - an error has occured, -eax contains
 4424 
  * eax < 0 - an error has occured, -eax contains
4425 
    file system error code
 4425 
    file system error code
4426 
  * ebx destroyed
 4426 
  * ebx destroyed
4427 
Remarks:
 4427 
Remarks:
4428 
  * Command line must be terminated by the character with the code 0
 4428 
  * Command line must be terminated by the character with the code 0
4429 
    (ASCIIZ-string); function takes into account either all characters
 4429 
    (ASCIIZ-string); function takes into account either all characters
4430 
    up to terminating zero inclusively or first 256 character
 4430 
    up to terminating zero inclusively or first 256 character
4431 
    regarding what is less.
 4431 
    regarding what is less.
4432 
  * If the process is started as debugged, it is created in
 4432 
  * If the process is started as debugged, it is created in
4433 
    the suspended state; to run use subfunction 5 of function 69.
 4433 
    the suspended state; to run use subfunction 5 of function 69.
4434 
 
 4434 
 
4435 
======================================================================
 4435 
======================================================================
4436 
========== Function 70, subfunction 8 - delete file/folder. ==========
 4436 
========== Function 70, subfunction 8 - delete file/folder. ==========
4437 
======================================================================
 4437 
======================================================================
4438 
Parameters:
 4438 
Parameters:
4439 
  * eax = 70 - function number
 4439 
  * eax = 70 - function number
4440 
  * ebx = pointer to the information structure
 4440 
  * ebx = pointer to the information structure
4441 
Format of the information structure:
 4441 
Format of the information structure:
4442 
  * +0: dword: 8 = subfunction number
 4442 
  * +0: dword: 8 = subfunction number
4443 
  * +4: dword: 0 (reserved)
 4443 
  * +4: dword: 0 (reserved)
4444 
  * +8: dword: 0 (reserved)
 4444 
  * +8: dword: 0 (reserved)
4445 
  * +12 = +0xC: dword: 0 (reserved)
 4445 
  * +12 = +0xC: dword: 0 (reserved)
4446 
  * +16 = +0x10: dword: 0 (reserved)
 4446 
  * +16 = +0x10: dword: 0 (reserved)
4447 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4447 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4448 
    given in the general description
 4448 
    given in the general description
4449 
    or
 4449 
    or
4450 
  * +20 = +0x14: db 0
 4450 
  * +20 = +0x14: db 0
4451 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4451 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4452 
Returned value:
 4452 
Returned value:
4453 
  * eax = 0 - success, otherwise file system error code
 4453 
  * eax = 0 - success, otherwise file system error code
4454 
  * ebx destroyed
 4454 
  * ebx destroyed
4455 
Remarks:
 4455 
Remarks:
4456 
  * The function is not supported for CD (returns error code 2).
 4456 
  * The function is not supported for CD (returns error code 2).
4457 
  * The function can delete only empty folders (attempt to delete
 4457 
  * The function can delete only empty folders (attempt to delete
4458 
    nonempty folder results in error with code 10, "access denied").
 4458 
    nonempty folder results in error with code 10, "access denied").
4459 
 
 4459 
 
4460 
======================================================================
 4460 
======================================================================
4461 
============= Function 70, subfunction 9 - create folder. ============
 4461 
============= Function 70, subfunction 9 - create folder. ============
4462 
======================================================================
 4462 
======================================================================
4463 
Parameters:
 4463 
Parameters:
4464 
  * eax = 70 - function number
 4464 
  * eax = 70 - function number
4465 
  * ebx = pointer to the information structure
 4465 
  * ebx = pointer to the information structure
4466 
Format of the information structure:
 4466 
Format of the information structure:
4467 
  * +0: dword: 9 = subfunction number
 4467 
  * +0: dword: 9 = subfunction number
4468 
  * +4: dword: 0 (reserved)
 4468 
  * +4: dword: 0 (reserved)
4469 
  * +8: dword: 0 (reserved)
 4469 
  * +8: dword: 0 (reserved)
4470 
  * +12 = +0xC: dword: 0 (reserved)
 4470 
  * +12 = +0xC: dword: 0 (reserved)
4471 
  * +16 = +0x10: dword: 0 (reserved)
 4471 
  * +16 = +0x10: dword: 0 (reserved)
4472 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
 4472 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4473 
    given in the general description
 4473 
    given in the general description
4474 
    or
 4474 
    or
4475 
  * +20 = +0x14: db 0
 4475 
  * +20 = +0x14: db 0
4476 
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
 4476 
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
4477 
Returned value:
 4477 
Returned value:
4478 
  * eax = 0 - success, otherwise file system error code
 4478 
  * eax = 0 - success, otherwise file system error code
4479 
  * ebx destroyed
 4479 
  * ebx destroyed
4480 
Remarks:
 4480 
Remarks:
4481 
  * The function is not supported for CD (returns error code 2).
 4481 
  * The function is not supported for CD (returns error code 2).
4482 
  * The parent folder must already exist.
 4482 
  * The parent folder must already exist.
4483 
  * If target folder already exists, function returns success (eax=0).
 4483 
  * If target folder already exists, function returns success (eax=0).
4484 
 
 4484 
 
4485 
======================================================================
 4485 
======================================================================
4486 
========== Function 71, subfunction 1 - set window caption. ==========
 4486 
========== Function 71, subfunction 1 - set window caption. ==========
4487 
======================================================================
 4487 
======================================================================
4488 
Parameters:
 4488 
Parameters:
4489 
  * eax = 71 - function number
 4489 
  * eax = 71 - function number
4490 
  * ebx = 1 - subfunction number
 4490 
  * ebx = 1 - subfunction number
4491 
  * ecx = pointer to caption string
 4491 
  * ecx = pointer to caption string
4492 
Returned value:
 4492 
Returned value:
4493 
  * function does not return value
 4493 
  * function does not return value
4494 
Remarks:
 4494 
Remarks:
4495 
  * String must be in the ASCIIZ-format. Disregarding real string
 4495 
  * String must be in the ASCIIZ-format. Disregarding real string
4496 
    length, no more than 255 characters are drawn.
 4496 
    length, no more than 255 characters are drawn.
4497 
  * Pass NULL in ecx to remove caption.
 4497 
  * Pass NULL in ecx to remove caption.
4498 
 
 4498 
 
4499 
======================================================================
 4499 
======================================================================
4500 
=============== Function 72 - send message to a window. ==============
 4500 
=============== Function 72 - send message to a window. ==============
4501 
======================================================================
 4501 
======================================================================
4502 
 
 4502 
 
4503 
- Subfunction 1 - send message with parameter to the active window. --
 4503 
- Subfunction 1 - send message with parameter to the active window. --
4504 
Parameters:
 4504 
Parameters:
4505 
  * eax = 72 - function number
 4505 
  * eax = 72 - function number
4506 
  * ebx = 1 - subfunction number
 4506 
  * ebx = 1 - subfunction number
4507 
  * ecx = event code: 2 or 3
 4507 
  * ecx = event code: 2 or 3
4508 
  * edx = parameter: key code for ecx=2, button identifier for ecx=3
 4508 
  * edx = parameter: key code for ecx=2, button identifier for ecx=3
4509 
Returned value:
 4509 
Returned value:
4510 
  * eax = 0 - success
 4510 
  * eax = 0 - success
4511 
  * eax = 1 - buffer is full
 4511 
  * eax = 1 - buffer is full
4512 
 
 4512 
 
4513 
======================================================================
 4513 
======================================================================
4514 
=============== Function -1 - terminate thread/process ===============
 4514 
=============== Function -1 - terminate thread/process ===============
4515 
======================================================================
 4515 
======================================================================
4516 
Parameters:
 4516 
Parameters:
4517 
  * eax = -1 - function number
 4517 
  * eax = -1 - function number
4518 
Returned value:
 4518 
Returned value:
4519 
  * function does not return neither value nor control
 4519 
  * function does not return neither value nor control
4520 
Remarks:
 4520 
Remarks:
4521 
  * If the process did not create threads obviously, it has only
 4521 
  * If the process did not create threads obviously, it has only
4522 
    one thread, which termination results in process termination.
 4522 
    one thread, which termination results in process termination.
4523 
  * If the current thread is last in the process, its termination
 4523 
  * If the current thread is last in the process, its termination
4524 
    also results in process terminates.
 4524 
    also results in process terminates.
4525 
  * This function terminates the current thread. Other thread can be
 4525 
  * This function terminates the current thread. Other thread can be
4526 
    killed by call to subfunction 2 of function 18.
 4526 
    killed by call to subfunction 2 of function 18.
4527 
 
 4527 
 
4528 
======================================================================
 4528 
======================================================================
4529 
=========================== List of events ===========================
 4529 
=========================== List of events ===========================
4530 
======================================================================
 4530 
======================================================================
4531 
Next event can be retrieved by the call of one from functions 10
 4531 
Next event can be retrieved by the call of one from functions 10
4532 
(to wait for event), 11 (to check without waiting), 23
 4532 
(to wait for event), 11 (to check without waiting), 23
4533 
(to wait during the given time).
 4533 
(to wait during the given time).
4534 
These functions return only those events, which enter into a mask set
 4534 
These functions return only those events, which enter into a mask set
4535 
by function 40. By default it is first three,
 4535 
by function 40. By default it is first three,
4536 
there is enough for most applications.
 4536 
there is enough for most applications.
4537 
Codes of events:
 4537 
Codes of events:
4538 
  * 1 = redraw event (is reset by call to function 0)
 4538 
  * 1 = redraw event (is reset by call to function 0)
4539 
  * 2 = key on keyboard is pressed (acts, only when the window is
 4539 
  * 2 = key on keyboard is pressed (acts, only when the window is
4540 
    active) or hotkey is pressed; is reset, when all keys from
 4540 
    active) or hotkey is pressed; is reset, when all keys from
4541 
    the buffer are read out by function 2
 4541 
    the buffer are read out by function 2
4542 
  * 3 = button is pressed, defined earlier by function 8
 4542 
  * 3 = button is pressed, defined earlier by function 8
4543 
    (or close button, created implicitly by function 0;
 4543 
    (or close button, created implicitly by function 0;
4544 
    minimize button is handled by the system and sends no message;
 4544 
    minimize button is handled by the system and sends no message;
4545 
    acts, only when the window is active;
 4545 
    acts, only when the window is active;
4546 
    is reset when all buttons from the buffer
 4546 
    is reset when all buttons from the buffer
4547 
    are read out by function 17)
 4547 
    are read out by function 17)
4548 
  * 4 = reserved (in current implementation never comes even after
 4548 
  * 4 = reserved (in current implementation never comes even after
4549 
    unmasking by function 40)
 4549 
    unmasking by function 40)
4550 
  * 5 = the desktop background is redrawed (is reset automatically
 4550 
  * 5 = the desktop background is redrawed (is reset automatically
4551 
    after redraw, so if in redraw time program does not wait and
 4551 
    after redraw, so if in redraw time program does not wait and
4552 
    does not check events, it will not remark this event)
 4552 
    does not check events, it will not remark this event)
4553 
  * 6 = mouse event (something happened - button pressing or moving;
 4553 
  * 6 = mouse event (something happened - button pressing or moving;
4554 
    is reset at reading)
 4554 
    is reset at reading)
4555 
  * 7 = IPC event (see function 60 -
 4555 
  * 7 = IPC event (see function 60 -
4556 
    Inter Process Communication; is reset at reading)
 4556 
    Inter Process Communication; is reset at reading)
4557 
  * 8 = network event (is reset at reading)
 4557 
  * 8 = network event (is reset at reading)
4558 
  * 9 = debug event (is reset at reading; see
 4558 
  * 9 = debug event (is reset at reading; see
4559 
    debug subsystem)
 4559 
    debug subsystem)
4560 
  * 16..31 = event with appropriate IRQ
 4560 
  * 16..31 = event with appropriate IRQ
4561 
    (16=IRQ0, 31=IRQ15) (is reset after reading all IRQ data)
 4561 
    (16=IRQ0, 31=IRQ15) (is reset after reading all IRQ data)
4562 
 
 4562 
 
4563 
======================================================================
 4563 
======================================================================
4564 
=================== Error codes of the file system ===================
 4564 
=================== Error codes of the file system ===================
4565 
======================================================================
 4565 
======================================================================
4566 
  * 0 = success
 4566 
  * 0 = success
4567 
  * 1 = base and/or partition of a hard disk is not defined
 4567 
  * 1 = base and/or partition of a hard disk is not defined
4568 
    (by subfunctions 7, 8 of function 21)
 4568 
    (by subfunctions 7, 8 of function 21)
4569 
  * 2 = function is not supported for the given file system
 4569 
  * 2 = function is not supported for the given file system
4570 
  * 3 = unknown file system
 4570 
  * 3 = unknown file system
4571 
  * 4 = reserved, is never returned in the current implementation
 4571 
  * 4 = reserved, is never returned in the current implementation
4572 
  * 5 = file not found
 4572 
  * 5 = file not found
4573 
  * 6 = end of file, EOF
 4573 
  * 6 = end of file, EOF
4574 
  * 7 = pointer lies outside of application memory
 4574 
  * 7 = pointer lies outside of application memory
4575 
  * 8 = disk is full
 4575 
  * 8 = disk is full
4576 
  * 9 = FAT table is destroyed
 4576 
  * 9 = FAT table is destroyed
4577 
  * 10 = access denied
 4577 
  * 10 = access denied
4578 
  * 11 = device error
 4578 
  * 11 = device error
4579 
Application start functions can return also following errors:
 4579 
Application start functions can return also following errors:
4580 
  * 30 = 0x1E = not enough memory
 4580 
  * 30 = 0x1E = not enough memory
4581 
  * 31 = 0x1F = file is not executable
 4581 
  * 31 = 0x1F = file is not executable
4582 
  * 32 = 0x20 = too many processes
 4582 
  * 32 = 0x20 = too many processes
4583 
>
 4583 
>
4584 
>
 4584 
>