Subversion Repositories Kolibri OS

Rev

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

Rev 4264 Rev 4572
1 
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 1 
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
2 
;;                                                              ;;
 2 
;;                                                              ;;
3 
;; Copyright (C) KolibriOS team 2004-2012. All rights reserved. ;;
 3 
;; Copyright (C) KolibriOS team 2004-2012. All rights reserved. ;;
4 
;; Distributed under terms of the GNU General Public License    ;;
 4 
;; Distributed under terms of the GNU General Public License    ;;
5 
;;                                                              ;;
 5 
;;                                                              ;;
6 
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 6 
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
7 
 
 7 
 
8 
SYSTEM FUNCTIONS of OS Kolibri 0.7.7.0
 8 
SYSTEM FUNCTIONS of OS Kolibri 0.7.7.0
9 
 
 9 
 
10 
Number of the function is located in the register eax.
 10 
Number of the function is located in the register eax.
11 
The call of the system function is executed by "int 0x40" command.
 11 
The call of the system function is executed by "int 0x40" command.
12 
All registers except explicitly declared in the returned value,
 12 
All registers except explicitly declared in the returned value,
13 
    including eflags, are preserved.
 13 
    including eflags, are preserved.
14 
 
 14 
 
15 
 
 15 
 
16 
======================================================================
 16 
======================================================================
17 
============== Function 0 - define and draw the window. ==============
 17 
============== Function 0 - define and draw the window. ==============
18 
======================================================================
 18 
======================================================================
19 
Defines an application window. Draws a frame of the window, header and
 19 
Defines an application window. Draws a frame of the window, header and
20 
working area. For skinned windows defines standard close and minimize
 20 
working area. For skinned windows defines standard close and minimize
21 
buttons.
 21 
buttons.
22 
Parameters:
 22 
Parameters:
23 
  * eax = 0 - function number
 23 
  * eax = 0 - function number
24 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
 24 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
25 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
 25 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
26 
  * edx = 0xXYRRGGBB, where:
 26 
  * edx = 0xXYRRGGBB, where:
27 
    * Y = style of the window:
 27 
    * Y = style of the window:
28 
      * Y=0 - type I - fixed-size window
 28 
      * Y=0 - type I - fixed-size window
29 
      * Y=1 - only define window area, draw nothing
 29 
      * Y=1 - only define window area, draw nothing
30 
      * Y=2 - type II - variable-size window
 30 
      * Y=2 - type II - variable-size window
31 
      * Y=3 - skinned window
 31 
      * Y=3 - skinned window
32 
      * Y=4 - skinned fixed-size window
 32 
      * Y=4 - skinned fixed-size window
33 
      * other possible values (from 5 up to 15) are reserved,
 33 
      * other possible values (from 5 up to 15) are reserved,
34 
        function call with such Y is ignored
 34 
        function call with such Y is ignored
35 
    * RR, GG, BB = accordingly red, green, blue components of a color
 35 
    * RR, GG, BB = accordingly red, green, blue components of a color
36 
      of the working area of the window (are ignored for style Y=1)
 36 
      of the working area of the window (are ignored for style Y=1)
37 
    * X = DCBA (bits)
 37 
    * X = DCBA (bits)
38 
      * A = 1 - window has caption; for styles Y=3,4 caption string
 38 
      * A = 1 - window has caption; for styles Y=3,4 caption string
39 
                  must be passed in edi, for other styles use
 39 
                  must be passed in edi, for other styles use
40 
                  subfunction 1 of function 71
 40 
                  subfunction 1 of function 71
41 
      * B = 1 - coordinates of all graphics primitives are relative to
 41 
      * B = 1 - coordinates of all graphics primitives are relative to
42 
                  window client area
 42 
                  window client area
43 
      * C = 1 - don't fill working area on window draw
 43 
      * C = 1 - don't fill working area on window draw
44 
      * D = 0 - normal filling of the working area, 1 - gradient
 44 
      * D = 0 - normal filling of the working area, 1 - gradient
45 
    The following parameters are intended for windows
 45 
    The following parameters are intended for windows
46 
    of a type I and II, and ignored for styles Y=1,3:
 46 
    of a type I and II, and ignored for styles Y=1,3:
47 
  * esi = 0xXYRRGGBB - color of the header
 47 
  * esi = 0xXYRRGGBB - color of the header
48 
    * RR, GG, BB define color
 48 
    * RR, GG, BB define color
49 
    * Y=0 - usual window, Y=1 - unmovable window (works for all window styles)
 49 
    * Y=0 - usual window, Y=1 - unmovable window (works for all window styles)
50 
    * X defines a gradient of header: X=0 - no gradient,
 50 
    * X defines a gradient of header: X=0 - no gradient,
51 
      X=8 - usual gradient,
 51 
      X=8 - usual gradient,
52 
      for windows of a type II X=4 - negative gradient
 52 
      for windows of a type II X=4 - negative gradient
53 
    * other values of X and Y are reserved
 53 
    * other values of X and Y are reserved
54 
  * edi = 0x00RRGGBB - color of the frame
 54 
  * edi = 0x00RRGGBB - color of the frame
55 
Returned value:
 55 
Returned value:
56 
  * function does not return value
 56 
  * function does not return value
57 
Remarks:
 57 
Remarks:
58 
  * Position and sizes of the window are installed by the first
 58 
  * Position and sizes of the window are installed by the first
59 
    call of this function and are ignored at subsequent; to change
 59 
    call of this function and are ignored at subsequent; to change
60 
    position and/or sizes of already created window use function 67.
 60 
    position and/or sizes of already created window use function 67.
61 
  * For windows with styles Y=3,4 and caption (A=1) caption string
 61 
  * For windows with styles Y=3,4 and caption (A=1) caption string
62 
    is set by the first call of this function and is ignored
 62 
    is set by the first call of this function and is ignored
63 
    at subsequent (strictly speaking, is ignored after a call to
 63 
    at subsequent (strictly speaking, is ignored after a call to
64 
    subfunction 2 of function 12 - end redraw); to change caption of
 64 
    subfunction 2 of function 12 - end redraw); to change caption of
65 
    already created window use subfunction 1 of function 71.
 65 
    already created window use subfunction 1 of function 71.
66 
  * If the window has appropriate styles, position and/or sizes can be
 66 
  * If the window has appropriate styles, position and/or sizes can be
67 
    changed by user. Current position and sizes can be obtained
 67 
    changed by user. Current position and sizes can be obtained
68 
    by function 9.
 68 
    by function 9.
69 
  * The window must fit on the screen. If the transferred
 69 
  * The window must fit on the screen. If the transferred
70 
    coordinates and sizes do not satisfy to this condition,
 70 
    coordinates and sizes do not satisfy to this condition,
71 
    appropriate coordinate (or, probably, both) is considered as zero,
 71 
    appropriate coordinate (or, probably, both) is considered as zero,
72 
    and if it does not help too, the appropriate size
 72 
    and if it does not help too, the appropriate size
73 
    (or, probably, both) is installed in a size of the screen.
 73 
    (or, probably, both) is installed in a size of the screen.
74 
 
 74 
 
75 
    Further let us designate xpos,ypos,xsize,ysize - values passed
 75 
    Further let us designate xpos,ypos,xsize,ysize - values passed
76 
    in ebx,ecx. The coordinates are resulted concerning
 76 
    in ebx,ecx. The coordinates are resulted concerning
77 
    the left upper corner of the window, which, thus, is set as (0,0),
 77 
    the left upper corner of the window, which, thus, is set as (0,0),
78 
    coordinates of the right lower corner essence (xsize,ysize).
 78 
    coordinates of the right lower corner essence (xsize,ysize).
79 
  * The sizes of the window are understood in sence of coordinates
 79 
  * The sizes of the window are understood in sence of coordinates
80 
    of the right lower corner. This concerns all other functions too.
 80 
    of the right lower corner. This concerns all other functions too.
81 
    It means, that the real sizes are on 1 pixel more.
 81 
    It means, that the real sizes are on 1 pixel more.
82 
  * The window of type I looks as follows:
 82 
  * The window of type I looks as follows:
83 
    * draw external frame of color indicated in edi, 1 pixel in width
 83 
    * draw external frame of color indicated in edi, 1 pixel in width
84 
    * draw header - rectangle with the left upper corner (1,1) and
 84 
    * draw header - rectangle with the left upper corner (1,1) and
85 
      right lower (xsize-1,min(25,ysize)) color indicated in esi
 85 
      right lower (xsize-1,min(20,ysize-1)) color indicated in esi
86 
      (taking a gradient into account)
 86 
      (taking a gradient into account)
87 
    * if ysize>=26, fill the working area of the window -
 87 
    * if ysize>21, fill the working area of the window -
88 
      rectangle with the left upper corner (1,21) and right lower
 88 
      rectangle with the left upper corner (1,21) and right lower
89 
      (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color
 89 
      (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color
90 
      indicated in edx (taking a gradient into account)
 90 
      indicated in edx (taking a gradient into account)
91 
    * if A=1 and caption has been already set by subfunction 1
 91 
    * if A=1 and caption has been already set by subfunction 1
92 
      of function 71, it is drawn in the corresponding place of header
 92 
      of function 71, it is drawn in the corresponding place of header
93 
  * The window of style Y=1 looks as follows:
 93 
  * The window of style Y=1 looks as follows:
94 
    * completely defined by the application
 94 
    * completely defined by the application
95 
  * The window of type II looks as follows:
 95 
  * The window of type II looks as follows:
96 
    * draw external frame of width 1 pixel with the "shaded" color
 96 
    * draw external frame of width 1 pixel with the "shaded" color
97 
      edi (all components of the color decrease twice)
 97 
      edi (all components of the color decrease twice)
98 
    * draw intermediate frame of width 3 pixels with color edi
 98 
    * draw intermediate frame of width 3 pixels with color edi
99 
    * draw internal frame of width 1 pixel with the "shaded" color edi
 99 
    * draw internal frame of width 1 pixel with the "shaded" color edi
100 
    * draw header - rectangle with the left upper corner (4,4)
 100 
    * draw header - rectangle with the left upper corner (4,4)
101 
      and right lower (xsize-4,min(20,ysize)) color, indicated in esi
 101 
      and right lower (xsize-4,min(20,ysize)) color, indicated in esi
102 
      (taking a gradient into account)
 102 
      (taking a gradient into account)
103 
    * if ysize>=26, fill the working area of the window -
 103 
    * if ysize>=26, fill the working area of the window -
104 
      rectangle with the left upper corner (5,20) and right lower
 104 
      rectangle with the left upper corner (5,20) and right lower
105 
      (xsize-5,ysize-5) with color indicated in edx
 105 
      (xsize-5,ysize-5) with color indicated in edx
106 
      (taking a gradient into account)
 106 
      (taking a gradient into account)
107 
    * if A=1 and caption has been already set by subfunction 1
 107 
    * if A=1 and caption has been already set by subfunction 1
108 
      of function 71, it is drawn in the corresponding place of header
 108 
      of function 71, it is drawn in the corresponding place of header
109 
  * The skinned window looks as follows:
 109 
  * The skinned window looks as follows:
110 
    * draw external frame of width 1 pixel
 110 
    * draw external frame of width 1 pixel
111 
      with color 'outer' from the skin
 111 
      with color 'outer' from the skin
112 
    * draw intermediate frame of width 3 pixel
 112 
    * draw intermediate frame of width 3 pixel
113 
      with color 'frame' from the skin
 113 
      with color 'frame' from the skin
114 
    * draw internal frame of width 1 pixel
 114 
    * draw internal frame of width 1 pixel
115 
      with color 'inner' from the skin
 115 
      with color 'inner' from the skin
116 
    * draw header (on bitmaps from the skin) in a rectangle
 116 
    * draw header (on bitmaps from the skin) in a rectangle
117 
      (0,0) - (xsize,_skinh-1)
 117 
      (0,0) - (xsize,_skinh-1)
118 
    * if ysize>=26, fill the working area of the window -
 118 
    * if ysize>=26, fill the working area of the window -
119 
      rectangle with the left upper corner (5,_skinh) and right lower
 119 
      rectangle with the left upper corner (5,_skinh) and right lower
120 
      (xsize-5,ysize-5) with color indicated in edx
 120 
      (xsize-5,ysize-5) with color indicated in edx
121 
      (taking a gradient into account)
 121 
      (taking a gradient into account)
122 
    * define two standard buttons: close and minimize
 122 
    * define two standard buttons: close and minimize
123 
      (see function 8)
 123 
      (see function 8)
124 
    * if A=1 and edi contains (nonzero) pointer to caption string,
 124 
    * if A=1 and edi contains (nonzero) pointer to caption string,
125 
      it is drawn in place in header defined in the skin
 125 
      it is drawn in place in header defined in the skin
126 
    * value _skinh is accessible as the result of call
 126 
    * value _skinh is accessible as the result of call
127 
      subfunction 4 of function 48
 127 
      subfunction 4 of function 48
128 
 
 128 
 
129 
======================================================================
 129 
======================================================================
130 
================ Function 1 - put pixel in the window. ===============
 130 
================ Function 1 - put pixel in the window. ===============
131 
======================================================================
 131 
======================================================================
132 
Parameters:
 132 
Parameters:
133 
  * eax = 1 - function number
 133 
  * eax = 1 - function number
134 
  * ebx = x-coordinate (relative to the window)
 134 
  * ebx = x-coordinate (relative to the window)
135 
  * ecx = y-coordinate (relative to the window)
 135 
  * ecx = y-coordinate (relative to the window)
136 
  * edx = 0x00RRGGBB - color of a pixel
 136 
  * edx = 0x00RRGGBB - color of a pixel
137 
    edx = 0x01xxxxxx - invert color of a pixel
 137 
    edx = 0x01xxxxxx - invert color of a pixel
138 
          (low 24 bits are ignored)
 138 
          (low 24 bits are ignored)
139 
Returned value:
 139 
Returned value:
140 
  * function does not return value
 140 
  * function does not return value
141 
 
 141 
 
142 
======================================================================
 142 
======================================================================
143 
============ Function 2 - get the code of the pressed key. ===========
 143 
============ Function 2 - get the code of the pressed key. ===========
144 
======================================================================
 144 
======================================================================
145 
Takes away the code of the pressed key from the buffer.
 145 
Takes away the code of the pressed key from the buffer.
146 
Parameters:
 146 
Parameters:
147 
  * eax = 2 - function number
 147 
  * eax = 2 - function number
148 
Returned value:
 148 
Returned value:
149 
  * if the buffer is empty, function returns eax=1
 149 
  * if the buffer is empty, function returns eax=1
150 
  * if the buffer is not empty, function returns al=0,
 150 
  * if the buffer is not empty, function returns al=0,
151 
    ah=code of the pressed key, high word of eax is zero
 151 
    ah=code of the pressed key, high word of eax is zero
152 
  * if there is "hotkey", function returns al=2,
 152 
  * if there is "hotkey", function returns al=2,
153 
    ah=scancode of the pressed key (0 for control keys),
 153 
    ah=scancode of the pressed key (0 for control keys),
154 
    high word of eax contains a status of control keys at the moment
 154 
    high word of eax contains a status of control keys at the moment
155 
    of pressing a hotkey
 155 
    of pressing a hotkey
156 
Remarks:
 156 
Remarks:
157 
  * There is a common system buffer of the pressed keys
 157 
  * There is a common system buffer of the pressed keys
158 
    by a size of 120 bytes, organized as queue.
 158 
    by a size of 120 bytes, organized as queue.
159 
  * There is one more common system buffer on 120 "hotkeys".
 159 
  * There is one more common system buffer on 120 "hotkeys".
160 
  * If the application with the inactive window calls this function,
 160 
  * If the application with the inactive window calls this function,
161 
    the buffer of the pressed keys is considered to be empty.
 161 
    the buffer of the pressed keys is considered to be empty.
162 
  * By default this function returns ASCII-codes; to switch
 162 
  * By default this function returns ASCII-codes; to switch
163 
    to the scancodes mode (and back) use function 66.
 163 
    to the scancodes mode (and back) use function 66.
164 
    However, hotkeys are always notificated as scancodes.
 164 
    However, hotkeys are always notificated as scancodes.
165 
  * To find out, what keys correspond to what codes, start
 165 
  * To find out, what keys correspond to what codes, start
166 
    the application keyascii and scancode.
 166 
    the application keyascii and scancode.
167 
  * Scancodes come directly from keyboard and are fixed;
 167 
  * Scancodes come directly from keyboard and are fixed;
168 
    ASCII-codes turn out with usage of the conversion tables,
 168 
    ASCII-codes turn out with usage of the conversion tables,
169 
    which can be set by subfunction 2 of function 21
 169 
    which can be set by subfunction 2 of function 21
170 
    and get by subfunction 2 of function 26.
 170 
    and get by subfunction 2 of function 26.
171 
  * As a consequence, ASCII-codes take into account current
 171 
  * As a consequence, ASCII-codes take into account current
172 
    keyboard layout (rus/en) as opposed to scancodes.
 172 
    keyboard layout (rus/en) as opposed to scancodes.
173 
  * This function notifies only about those hotkeys, which were
 173 
  * This function notifies only about those hotkeys, which were
174 
    defined by this thread by subfunction 4 of function 66.
 174 
    defined by this thread by subfunction 4 of function 66.
175 
 
 175 
 
176 
======================================================================
 176 
======================================================================
177 
==================== Function 3 - get system time. ===================
 177 
==================== Function 3 - get system time. ===================
178 
======================================================================
 178 
======================================================================
179 
Parameters:
 179 
Parameters:
180 
  * eax = 3 - function number
 180 
  * eax = 3 - function number
181 
Returned value:
 181 
Returned value:
182 
  * eax = 0x00SSMMHH, where HH:MM:SS = Hours:Minutes:Seconds
 182 
  * eax = 0x00SSMMHH, where HH:MM:SS = Hours:Minutes:Seconds
183 
  * each item is BCD-number, for example,
 183 
  * each item is BCD-number, for example,
184 
    for time 23:59:59 function returns 0x00595923
 184 
    for time 23:59:59 function returns 0x00595923
185 
Remarks:
 185 
Remarks:
186 
  * See also subfunction 9 of function 26 - get time from
 186 
  * See also subfunction 9 of function 26 - get time from
187 
    the moment of start of the system; it is more convenient, because
 187 
    the moment of start of the system; it is more convenient, because
188 
    returns simply DWORD-value of the time counter.
 188 
    returns simply DWORD-value of the time counter.
189 
  * System time can be set by function 22.
 189 
  * System time can be set by function 22.
190 
 
 190 
 
191 
======================================================================
 191 
======================================================================
192 
============ Function 4 - draw text string in the window. ============
 192 
============ Function 4 - draw text string in the window. ============
193 
======================================================================
 193 
======================================================================
194 
Parameters:
 194 
Parameters:
195 
  * eax = 4 - function number
 195 
  * eax = 4 - function number
196 
  * ebx = [coordinate on axis x]*65536 + [coordinate on axis y]
 196 
  * ebx = [coordinate on axis x]*65536 + [coordinate on axis y]
197 
  * ecx = 0xXYRRGGBB, where
 197 
  * ecx = 0xXYRRGGBB, where
198 
    * RR, GG, BB specify text color
 198 
    * RR, GG, BB specify text color
199 
    * X=ABnn (bits):
 199 
    * X=ABnn (bits):
200 
      * nn specifies the used font: 0=system monospaced,
 200 
      * nn specifies the used font: 0=system monospaced,
201 
        1=system font of variable width
 201 
        1=system font of variable width
202 
      * A=0 - output esi characters, A=1 - output ASCIIZ-string
 202 
      * A=0 - output esi characters, A=1 - output ASCIIZ-string
203 
      * B=1 - fill background with the color edi
 203 
      * B=1 - fill background with the color edi
204 
    * Y = Cnnn
 204 
    * Y = Cnnn
205 
      * C=1 redirect the output to the user area, specified in edi
 205 
      * C=1 redirect the output to the user area, specified in edi
206 
      * nnn - not used in the current, must be 0 (zero)
 206 
      * nnn - not used in the current, must be 0 (zero)
207 
  * edx = pointer to the beginning of the string
 207 
  * edx = pointer to the beginning of the string
208 
  * esi = for A=0 length of the string, must not exceed 255;
 208 
  * esi = for A=0 length of the string, must not exceed 255;
209 
          for A=1 is ignored
 209 
          for A=1 is ignored
210 
  * edi = color to fill background, if B=1
 210 
  * edi = color to fill background, if B=1
211 
  * edi = pointer to user area, for redirect, if C=1
 211 
  * edi = pointer to user area, for redirect, if C=1
212 
 
 212 
 
213 
Returned value:
 213 
Returned value:
214 
  * function does not return value
 214 
  * function does not return value
215 
Remarks:
 215 
Remarks:
216 
  * First system font is read out at loading from the file char.mt,
 216 
  * First system font is read out at loading from the file char.mt,
217 
    second - from char2.mt.
 217 
    second - from char2.mt.
218 
  * Both fonts have height 9 pixels, width of the monospaced font
 218 
  * Both fonts have height 9 pixels, width of the monospaced font
219 
    is equal to 6 pixels.
 219 
    is equal to 6 pixels.
220 
  * C=1, pixel depth = 32 bits, user area is as follows:
 220 
  * C=1, pixel depth = 32 bits, user area is as follows:
221 
    dword Xsize
 221 
    dword Xsize
222 
    dword Ysize
 222 
    dword Ysize
223 
    rest of the area = Xsize * Y size * 4
 223 
    rest of the area = Xsize * Y size * 4
224 
  * You can not use B = 1 and C = 1, at the same time. Since in both
 224 
  * You can not use B = 1 and C = 1, at the same time. Since in both
225 
    cases, the register edi is used for different purposes.
 225 
    cases, the register edi is used for different purposes.
226 
 
 226 
 
227 
======================================================================
 227 
======================================================================
228 
========================= Function 5 - delay. ========================
 228 
========================= Function 5 - delay. ========================
229 
======================================================================
 229 
======================================================================
230 
Delays execution of the program on the given time.
 230 
Delays execution of the program on the given time.
231 
Parameters:
 231 
Parameters:
232 
  * eax = 5 - function number
 232 
  * eax = 5 - function number
233 
  * ebx = time in the 1/100 of second
 233 
  * ebx = time in the 1/100 of second
234 
Returned value:
 234 
Returned value:
235 
  * function does not return value
 235 
  * function does not return value
236 
Remarks:
 236 
Remarks:
237 
  * Passing ebx=0 does not transfer control to the next process
 237 
  * Passing ebx=0 does not transfer control to the next process
238 
    and does not make any operations at all. If it is really required
 238 
    and does not make any operations at all. If it is really required
239 
    to transfer control to the next process (to complete a current
 239 
    to transfer control to the next process (to complete a current
240 
    time slice), use subfunction 1 of function 68.
 240 
    time slice), use subfunction 1 of function 68.
241 
 
 241 
 
242 
======================================================================
 242 
======================================================================
243 
============== Function 6 - read the file from ramdisk. ==============
 243 
============== Function 6 - read the file from ramdisk. ==============
244 
======================================================================
 244 
======================================================================
245 
Parameters:
 245 
Parameters:
246 
  * eax = 6 - function number
 246 
  * eax = 6 - function number
247 
  * ebx = pointer to the filename
 247 
  * ebx = pointer to the filename
248 
  * ecx = number of start block, beginning from 1;
 248 
  * ecx = number of start block, beginning from 1;
249 
    ecx=0 - read from the beginning of the file (same as ecx=1)
 249 
    ecx=0 - read from the beginning of the file (same as ecx=1)
250 
  * edx = number of blocks to read;
 250 
  * edx = number of blocks to read;
251 
    edx=0 - read one block (same as edx=1)
 251 
    edx=0 - read one block (same as edx=1)
252 
  * esi = pointer to memory area for the data
 252 
  * esi = pointer to memory area for the data
253 
Returned value:
 253 
Returned value:
254 
  * eax = file size in bytes, if the file was successfully read
 254 
  * eax = file size in bytes, if the file was successfully read
255 
  * eax = -1, if the file was not found
 255 
  * eax = -1, if the file was not found
256 
Remarks:
 256 
Remarks:
257 
  * This function is out-of-date; function 70 allows
 257 
  * This function is out-of-date; function 70 allows
258 
    to fulfil the same operations with the extended possibilities.
 258 
    to fulfil the same operations with the extended possibilities.
259 
  * Block = 512 bytes.
 259 
  * Block = 512 bytes.
260 
  * For reading all file you can specify the certainly large value
 260 
  * For reading all file you can specify the certainly large value
261 
    in edx, for example, edx = -1; but in this case be ready that
 261 
    in edx, for example, edx = -1; but in this case be ready that
262 
    the program will "fall", if the file will appear too large and can
 262 
    the program will "fall", if the file will appear too large and can
263 
    not be placed in the program memory.
 263 
    not be placed in the program memory.
264 
  * The filename must be either in the format 8+3 characters
 264 
  * The filename must be either in the format 8+3 characters
265 
    (first 8 characters - name itself, last 3 - extension,
 265 
    (first 8 characters - name itself, last 3 - extension,
266 
    the short names and extensions are supplemented with spaces),
 266 
    the short names and extensions are supplemented with spaces),
267 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
 267 
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
268 
    (name no more than 8 characters, dot, extension 3 characters
 268 
    (name no more than 8 characters, dot, extension 3 characters
269 
    supplemented if necessary by spaces).
 269 
    supplemented if necessary by spaces).
270 
    The filename must be written with capital letters. The terminating
 270 
    The filename must be written with capital letters. The terminating
271 
    character with code 0 is not necessary (not ASCIIZ-string).
 271 
    character with code 0 is not necessary (not ASCIIZ-string).
272 
  * This function does not support folders on the ramdisk.
 272 
  * This function does not support folders on the ramdisk.
273 
 
 273 
 
274 
======================================================================
 274 
======================================================================
275 
=============== Function 7 - draw image in the window. ===============
 275 
=============== Function 7 - draw image in the window. ===============
276 
======================================================================
 276 
======================================================================
277 
Paramters:
 277 
Paramters:
278 
  * eax = 7 - function number
 278 
  * eax = 7 - function number
279 
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
 279 
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
280 
  * ecx = [size on axis x]*65536 + [size on axis y]
 280 
  * ecx = [size on axis x]*65536 + [size on axis y]
281 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 281 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
282 
Returned value:
 282 
Returned value:
283 
  * function does not return value
 283 
  * function does not return value
284 
Remarks:
 284 
Remarks:
285 
  * Coordinates of the image are coordinates of the upper left corner
 285 
  * Coordinates of the image are coordinates of the upper left corner
286 
    of the image relative to the window.
 286 
    of the image relative to the window.
287 
  * Size of the image in bytes is 3*xsize*ysize.
 287 
  * Size of the image in bytes is 3*xsize*ysize.
288 
 
 288 
 
289 
======================================================================
 289 
======================================================================
290 
=============== Function 8 - define/delete the button. ===============
 290 
=============== Function 8 - define/delete the button. ===============
291 
======================================================================
 291 
======================================================================
292 
Parameters for button definition:
 292 
Parameters for button definition:
293 
  * eax = 8 - function number
 293 
  * eax = 8 - function number
294 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
 294 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
295 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
 295 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
296 
  * edx = 0xXYnnnnnn, where:
 296 
  * edx = 0xXYnnnnnn, where:
297 
    * nnnnnn = identifier of the button
 297 
    * nnnnnn = identifier of the button
298 
    * high (31st) bit of edx is cleared
 298 
    * high (31st) bit of edx is cleared
299 
    * if 30th bit of edx is set - do not draw the button
 299 
    * if 30th bit of edx is set - do not draw the button
300 
    * if 29th bit of edx is set - do not draw a frame
 300 
    * if 29th bit of edx is set - do not draw a frame
301 
      at pressing the button
 301 
      at pressing the button
302 
  * esi = 0x00RRGGBB - color of the button
 302 
  * esi = 0x00RRGGBB - color of the button
303 
Parameters for button deleting:
 303 
Parameters for button deleting:
304 
  * eax = 8 - function number
 304 
  * eax = 8 - function number
305 
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
 305 
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
306 
Returned value:
 306 
Returned value:
307 
  * function does not return value
 307 
  * function does not return value
308 
Remarks:
 308 
Remarks:
309 
  * Sizes of the button must be more than 0 and less than 0x8000.
 309 
  * Sizes of the button must be more than 0 and less than 0x8000.
310 
  * For skinned windows definition of the window
 310 
  * For skinned windows definition of the window
311 
    (call of 0th function) creates two standard buttons -
 311 
    (call of 0th function) creates two standard buttons -
312 
    for close of the window with identifier 1 and
 312 
    for close of the window with identifier 1 and
313 
    for minimize of the window with identifier 0xffff.
 313 
    for minimize of the window with identifier 0xffff.
314 
  * The creation of two buttons with same identifiers is admitted.
 314 
  * The creation of two buttons with same identifiers is admitted.
315 
  * The button with the identifier 0xffff at pressing is interpreted
 315 
  * The button with the identifier 0xffff at pressing is interpreted
316 
    by the system as the button of minimization, the system handles
 316 
    by the system as the button of minimization, the system handles
317 
    such pressing independently, not accessing to the application.
 317 
    such pressing independently, not accessing to the application.
318 
    In rest it is usual button.
 318 
    In rest it is usual button.
319 
  * Total number of buttons for all applications is limited to 4095.
 319 
  * Total number of buttons for all applications is limited to 4095.
320 
 
 320 
 
321 
======================================================================
 321 
======================================================================
322 
============ Function 9 - information on execution thread. ===========
 322 
============ Function 9 - information on execution thread. ===========
323 
======================================================================
 323 
======================================================================
324 
Parameters:
 324 
Parameters:
325 
  * eax = 9 - function number
 325 
  * eax = 9 - function number
326 
  * ebx = pointer to 1-Kb buffer
 326 
  * ebx = pointer to 1-Kb buffer
327 
  * ecx = number of the slot of the thread
 327 
  * ecx = number of the slot of the thread
328 
    ecx = -1 - get information on the current thread
 328 
    ecx = -1 - get information on the current thread
329 
Returned value:
 329 
Returned value:
330 
  * eax = maximum number of the slot of a thread
 330 
  * eax = maximum number of the slot of a thread
331 
  * buffer pointed to by ebx contains the following information:
 331 
  * buffer pointed to by ebx contains the following information:
332 
    * +0: dword: usage of the processor (how many time units
 332 
    * +0: dword: usage of the processor (how many time units
333 
      per second leaves on execution of this thread)
 333 
      per second leaves on execution of this thread)
334 
    * +4: word: position of the window of thread in the window stack
 334 
    * +4: word: position of the window of thread in the window stack
335 
    * +6: word: (has no relation to the specified thread)
 335 
    * +6: word: (has no relation to the specified thread)
336 
      number of the thread slot, which window has in the window stack
 336 
      number of the thread slot, which window has in the window stack
337 
      position ecx
 337 
      position ecx
338 
    * +8: word: reserved
 338 
    * +8: word: reserved
339 
    * +10 = +0xA: 11 bytes: name of the process
 339 
    * +10 = +0xA: 11 bytes: name of the process
340 
      (name of the started file - executable file without extension)
 340 
      (name of the started file - executable file without extension)
341 
    * +21 = +0x15: byte: reserved, this byte is not changed
 341 
    * +21 = +0x15: byte: reserved, this byte is not changed
342 
    * +22 = +0x16: dword: address of the process in memory
 342 
    * +22 = +0x16: dword: address of the process in memory
343 
    * +26 = +0x1A: dword: size of used memory - 1
 343 
    * +26 = +0x1A: dword: size of used memory - 1
344 
    * +30 = +0x1E: dword: identifier (PID/TID)
 344 
    * +30 = +0x1E: dword: identifier (PID/TID)
345 
    * +34 = +0x22: dword: coordinate of the thread window on axis x
 345 
    * +34 = +0x22: dword: coordinate of the thread window on axis x
346 
    * +38 = +0x26: dword: coordinate of the thread window on axis y
 346 
    * +38 = +0x26: dword: coordinate of the thread window on axis y
347 
    * +42 = +0x2A: dword: size of the thread window on axis x
 347 
    * +42 = +0x2A: dword: size of the thread window on axis x
348 
    * +46 = +0x2E: dword: size of the thread window on axis y
 348 
    * +46 = +0x2E: dword: size of the thread window on axis y
349 
    * +50 = +0x32: word: status of the thread slot:
 349 
    * +50 = +0x32: word: status of the thread slot:
350 
      * 0 = thread is running
 350 
      * 0 = thread is running
351 
      * 1 = thread is suspended
 351 
      * 1 = thread is suspended
352 
      * 2 = thread is suspended while waiting for event
 352 
      * 2 = thread is suspended while waiting for event
353 
      * 3 = thread is terminating as a result of call to function -1
 353 
      * 3 = thread is terminating as a result of call to function -1
354 
        or under duress as a result of call to subfunction 2
 354 
        or under duress as a result of call to subfunction 2
355 
        of function 18 or termination of the system
 355 
        of function 18 or termination of the system
356 
      * 4 = thread is terminating as a result of exception
 356 
      * 4 = thread is terminating as a result of exception
357 
      * 5 = thread waits for event
 357 
      * 5 = thread waits for event
358 
      * 9 = requested slot is free, all other information on the slot
 358 
      * 9 = requested slot is free, all other information on the slot
359 
        is not meaningful
 359 
        is not meaningful
360 
    * +52 = +0x34: word: reserved, this word is not changed
 360 
    * +52 = +0x34: word: reserved, this word is not changed
361 
    * +54 = +0x36: dword: coordinate of the client area on axis x
 361 
    * +54 = +0x36: dword: coordinate of the client area on axis x
362 
    * +58 = +0x3A: dword: coordinate of the client area on axis y
 362 
    * +58 = +0x3A: dword: coordinate of the client area on axis y
363 
    * +62 = +0x3E: dword: width of the client area
 363 
    * +62 = +0x3E: dword: width of the client area
364 
    * +66 = +0x42: dword: height of the client area
 364 
    * +66 = +0x42: dword: height of the client area
365 
    * +70 = +0x46: byte: state of the window - bitfield
 365 
    * +70 = +0x46: byte: state of the window - bitfield
366 
      * bit 0 (mask 1): window is maximized
 366 
      * bit 0 (mask 1): window is maximized
367 
      * bit 1 (mask 2): window is minimized to panel
 367 
      * bit 1 (mask 2): window is minimized to panel
368 
      * bit 2 (mask 4): window is rolled up
 368 
      * bit 2 (mask 4): window is rolled up
369 
    * +71 = +0x47: dword: event mask
 369 
    * +71 = +0x47: dword: event mask
370 
    * +75 = +0x4B: byte: keyboard mode(ASCII = 0; SCAN = 1)
 370 
    * +75 = +0x4B: byte: keyboard mode(ASCII = 0; SCAN = 1)
371 
Remarks:
 371 
Remarks:
372 
  * Slots are numbered starting from 1.
 372 
  * Slots are numbered starting from 1.
373 
  * Returned value is not a total number of threads, because there
 373 
  * Returned value is not a total number of threads, because there
374 
    can be free slots.
 374 
    can be free slots.
375 
  * When process is starting, system automatically creates
 375 
  * When process is starting, system automatically creates
376 
    execution thread.
 376 
    execution thread.
377 
  * Function gives information on the thread. Each process has
 377 
  * Function gives information on the thread. Each process has
378 
    at least one thread. One process can create many threads,
 378 
    at least one thread. One process can create many threads,
379 
    in this case each thread has its own slot and the fields
 379 
    in this case each thread has its own slot and the fields
380 
    +10, +22, +26 in these slots coincide.
 380 
    +10, +22, +26 in these slots coincide.
381 
    Applications have no common way to define whether two threads
 381 
    Applications have no common way to define whether two threads
382 
    belong to one process.
 382 
    belong to one process.
383 
  * The active window - window on top of the window stack -
 383 
  * The active window - window on top of the window stack -
384 
    receives the messages on a keyboard input. For such window
 384 
    receives the messages on a keyboard input. For such window
385 
    the position in the window stack coincides with returned value.
 385 
    the position in the window stack coincides with returned value.
386 
  * Slot 1 corresponds to special system thread, for which:
 386 
  * Slot 1 corresponds to special system thread, for which:
387 
    * the window is in the bottom of the window stack, the fields
 387 
    * the window is in the bottom of the window stack, the fields
388 
      +4 and +6 contain value 1
 388 
      +4 and +6 contain value 1
389 
    * name of the process - "OS/IDLE" (supplemented by spaces)
 389 
    * name of the process - "OS/IDLE" (supplemented by spaces)
390 
    * address of the process in memory is 0, size of used memory is
 390 
    * address of the process in memory is 0, size of used memory is
391 
      16 Mb (0x1000000)
 391 
      16 Mb (0x1000000)
392 
    * PID=1
 392 
    * PID=1
393 
    * coordinates and sizes of the window and the client area are by
 393 
    * coordinates and sizes of the window and the client area are by
394 
      convention set to 0
 394 
      convention set to 0
395 
    * status of the slot is always 0 (running)
 395 
    * status of the slot is always 0 (running)
396 
    * the execution time adds of time leaving on operations itself
 396 
    * the execution time adds of time leaving on operations itself
397 
      and idle time in waiting for interrupt (which can be got by call
 397 
      and idle time in waiting for interrupt (which can be got by call
398 
      to subfunction 4 of function 18).
 398 
      to subfunction 4 of function 18).
399 
  * Beginning from slot 2, the normal applications are placed.
 399 
  * Beginning from slot 2, the normal applications are placed.
400 
  * The normal applications are placed in memory at the address
 400 
  * The normal applications are placed in memory at the address
401 
    0 (kernel constant 'std_application_base_address').
 401 
    0 (kernel constant 'std_application_base_address').
402 
    There is no intersection, as each process has its own page table.
 402 
    There is no intersection, as each process has its own page table.
403 
  * At creation of the thread it is assigned the slot
 403 
  * At creation of the thread it is assigned the slot
404 
    in the system table and identifier (Process/Thread IDentifier =
 404 
    in the system table and identifier (Process/Thread IDentifier =
405 
    PID/TID), which do not vary with time for given thread.
 405 
    PID/TID), which do not vary with time for given thread.
406 
    After completion of the thread its slot can be anew used
 406 
    After completion of the thread its slot can be anew used
407 
    for another thread. The thread identifier can not be assigned
 407 
    for another thread. The thread identifier can not be assigned
408 
    to other thread even after completion of this thread.
 408 
    to other thread even after completion of this thread.
409 
    Identifiers, assigned to new threads, grow monotonously.
 409 
    Identifiers, assigned to new threads, grow monotonously.
410 
  * If the thread has not yet defined the window by call to
 410 
  * If the thread has not yet defined the window by call to
411 
    function 0, the position and the sizes
 411 
    function 0, the position and the sizes
412 
    of its window are considered to be zero.
 412 
    of its window are considered to be zero.
413 
  * Coordinates of the client area are relative to the window.
 413 
  * Coordinates of the client area are relative to the window.
414 
  * At the moment only the part of the buffer by a size
 414 
  * At the moment only the part of the buffer by a size
415 
    76 = 0x4C bytes is used. Nevertheless it is recommended to use
 415 
    76 = 0x4C bytes is used. Nevertheless it is recommended to use
416 
    1-Kb buffer for the future compatibility, in the future
 416 
    1-Kb buffer for the future compatibility, in the future
417 
    some fields can be added.
 417 
    some fields can be added.
418 
 
 418 
 
419 
======================================================================
 419 
======================================================================
420 
==================== Function 10 - wait for event. ===================
 420 
==================== Function 10 - wait for event. ===================
421 
======================================================================
 421 
======================================================================
422 
If the message queue is empty, waits for appearance of the message
 422 
If the message queue is empty, waits for appearance of the message
423 
in queue. In this state thread does not consume CPU time.
 423 
in queue. In this state thread does not consume CPU time.
424 
Then reads out the message from queue.
 424 
Then reads out the message from queue.
425 
 
 425 
 
426 
Parameters:
 426 
Parameters:
427 
  * eax = 10 - function number
 427 
  * eax = 10 - function number
428 
Returned value:
 428 
Returned value:
429 
  * eax = event (see the list of events)
 429 
  * eax = event (see the list of events)
430 
Remarks:
 430 
Remarks:
431 
  * Those events are taken into account only which enter into
 431 
  * Those events are taken into account only which enter into
432 
    a mask set by function 40. By default it is
 432 
    a mask set by function 40. By default it is
433 
    redraw, key and button events.
 433 
    redraw, key and button events.
434 
  * To check, whether there is a message in queue, use function 11.
 434 
  * To check, whether there is a message in queue, use function 11.
435 
    To wait for no more than given time, use function 23.
 435 
    To wait for no more than given time, use function 23.
436 
 
 436 
 
437 
======================================================================
 437 
======================================================================
438 
=============== Function 11 - check for event, no wait. ==============
 438 
=============== Function 11 - check for event, no wait. ==============
439 
======================================================================
 439 
======================================================================
440 
If the message queue contains event, function reads out
 440 
If the message queue contains event, function reads out
441 
and return it. If the queue is empty, function returns 0.
 441 
and return it. If the queue is empty, function returns 0.
442 
Parameters:
 442 
Parameters:
443 
  * eax = 11 - function number
 443 
  * eax = 11 - function number
444 
Returned value:
 444 
Returned value:
445 
  * eax = 0 - message queue is empty
 445 
  * eax = 0 - message queue is empty
446 
  * else eax = event (see the list of events)
 446 
  * else eax = event (see the list of events)
447 
Remarks:
 447 
Remarks:
448 
  * Those events are taken into account only, which enter into
 448 
  * Those events are taken into account only, which enter into
449 
    a mask set by function 40. By default it is
 449 
    a mask set by function 40. By default it is
450 
    redraw, key and button events.
 450 
    redraw, key and button events.
451 
  * To wait for event, use function 10.
 451 
  * To wait for event, use function 10.
452 
    To wait for no more than given time, use function 23.
 452 
    To wait for no more than given time, use function 23.
453 
 
 453 
 
454 
======================================================================
 454 
======================================================================
455 
=============== Function 12 - begin/end window redraw. ===============
 455 
=============== Function 12 - begin/end window redraw. ===============
456 
======================================================================
 456 
======================================================================
457 
 
 457 
 
458 
---------------- Subfunction 1 - begin window redraw. ----------------
 458 
---------------- Subfunction 1 - begin window redraw. ----------------
459 
Parameters:
 459 
Parameters:
460 
  * eax = 12 - function number
 460 
  * eax = 12 - function number
461 
  * ebx = 1 - subfunction number
 461 
  * ebx = 1 - subfunction number
462 
Returned value:
 462 
Returned value:
463 
  * function does not return value
 463 
  * function does not return value
464 
 
 464 
 
465 
----------------- Subfunction 2 - end window redraw. -----------------
 465 
----------------- Subfunction 2 - end window redraw. -----------------
466 
Parameters:
 466 
Parameters:
467 
  * eax = 12 - function number
 467 
  * eax = 12 - function number
468 
  * ebx = 2 - subfunction number
 468 
  * ebx = 2 - subfunction number
469 
Returned value:
 469 
Returned value:
470 
  * function does not return value
 470 
  * function does not return value
471 
Remarks:
 471 
Remarks:
472 
  * Subfunction 1 deletes all buttons defined with
 472 
  * Subfunction 1 deletes all buttons defined with
473 
    function 8, they must be defined again.
 473 
    function 8, they must be defined again.
474 
 
 474 
 
475 
======================================================================
 475 
======================================================================
476 
============ Function 13 - draw a rectangle in the window. ===========
 476 
============ Function 13 - draw a rectangle in the window. ===========
477 
======================================================================
 477 
======================================================================
478 
Parameters:
 478 
Parameters:
479 
  * eax = 13 - function number
 479 
  * eax = 13 - function number
480 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
 480 
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
481 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
 481 
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
482 
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
 482 
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
483 
Returned value:
 483 
Returned value:
484 
  * function does not return value
 484 
  * function does not return value
485 
Remarks:
 485 
Remarks:
486 
  * Coordinates are understood as coordinates of the left upper corner
 486 
  * Coordinates are understood as coordinates of the left upper corner
487 
    of a rectangle relative to the window.
 487 
    of a rectangle relative to the window.
488 
 
 488 
 
489 
======================================================================
 489 
======================================================================
490 
=================== Function 14 - get screen size. ===================
 490 
=================== Function 14 - get screen size. ===================
491 
======================================================================
 491 
======================================================================
492 
Parameters:
 492 
Parameters:
493 
  * eax = 14 - function number
 493 
  * eax = 14 - function number
494 
Returned value:
 494 
Returned value:
495 
  * eax = [xsize]*65536 + [ysize], where
 495 
  * eax = [xsize]*65536 + [ysize], where
496 
  * xsize = x-coordinate of the right lower corner of the screen =
 496 
  * xsize = x-coordinate of the right lower corner of the screen =
497 
            horizontal size - 1
 497 
            horizontal size - 1
498 
  * ysize = y-coordinate of the right lower corner of the screen =
 498 
  * ysize = y-coordinate of the right lower corner of the screen =
499 
            vertical size - 1
 499 
            vertical size - 1
500 
Remarks:
 500 
Remarks:
501 
  * See also subfunction 5 of function 48 - get sizes of
 501 
  * See also subfunction 5 of function 48 - get sizes of
502 
    working area of the screen.
 502 
    working area of the screen.
503 
 
 503 
 
504 
======================================================================
 504 
======================================================================
505 
== Function 15, subfunction 1 - set a size of the background image. ==
 505 
== Function 15, subfunction 1 - set a size of the background image. ==
506 
======================================================================
 506 
======================================================================
507 
Parameters:
 507 
Parameters:
508 
  * eax = 15 - function number
 508 
  * eax = 15 - function number
509 
  * ebx = 1 - subfunction number
 509 
  * ebx = 1 - subfunction number
510 
  * ecx = width of the image
 510 
  * ecx = width of the image
511 
  * edx = height of the image
 511 
  * edx = height of the image
512 
Returned value:
 512 
Returned value:
513 
  * function does not return value
 513 
  * function does not return value
514 
Remarks:
 514 
Remarks:
515 
  * Before calling subfunctions 2 and 5 you should call this function
 515 
  * Before calling subfunctions 2 and 5 you should call this function
516 
    to set image size!
 516 
    to set image size!
517 
  * For update of the screen (after completion of a series of commands
 517 
  * For update of the screen (after completion of a series of commands
518 
    working with a background) call subfunction 3.
 518 
    working with a background) call subfunction 3.
519 
  * There is a pair function for get size of the background image -
 519 
  * There is a pair function for get size of the background image -
520 
    subfunction 1 of function 39.
 520 
    subfunction 1 of function 39.
521 
 
 521 
 
522 
======================================================================
 522 
======================================================================
523 
=== Function 15, subfunction 2 - put pixel on the background image. ==
 523 
=== Function 15, subfunction 2 - put pixel on the background image. ==
524 
======================================================================
 524 
======================================================================
525 
Parameters:
 525 
Parameters:
526 
  * eax = 15 - function number
 526 
  * eax = 15 - function number
527 
  * ebx = 2 - subfunction number
 527 
  * ebx = 2 - subfunction number
528 
  * ecx = offset
 528 
  * ecx = offset
529 
  * edx = color of a pixel 0xRRGGBB
 529 
  * edx = color of a pixel 0xRRGGBB
530 
Returned value:
 530 
Returned value:
531 
  * function does not return value
 531 
  * function does not return value
532 
Remarks:
 532 
Remarks:
533 
  * Offset for a pixel with coordinates (x,y) is calculated as
 533 
  * Offset for a pixel with coordinates (x,y) is calculated as
534 
    (x+y*xsize)*3.
 534 
    (x+y*xsize)*3.
535 
  * If the given offset exceeds size set by subfunction 1,
 535 
  * If the given offset exceeds size set by subfunction 1,
536 
    the call is ignored.
 536 
    the call is ignored.
537 
  * For update of the screen (after completion of a series of commands
 537 
  * For update of the screen (after completion of a series of commands
538 
    working with a background) call subfunction 3.
 538 
    working with a background) call subfunction 3.
539 
  * There is a pair function for get pixel on the background image -
 539 
  * There is a pair function for get pixel on the background image -
540 
    subfunction 2 of function 39.
 540 
    subfunction 2 of function 39.
541 
 
 541 
 
542 
======================================================================
 542 
======================================================================
543 
=========== Function 15, subfunction 3 - redraw background. ==========
 543 
=========== Function 15, subfunction 3 - redraw background. ==========
544 
======================================================================
 544 
======================================================================
545 
Parameters:
 545 
Parameters:
546 
  * eax = 15 - function number
 546 
  * eax = 15 - function number
547 
  * ebx = 3 - subfunction number
 547 
  * ebx = 3 - subfunction number
548 
Returned value:
 548 
Returned value:
549 
  * function does not return value
 549 
  * function does not return value
550 
 
 550 
 
551 
======================================================================
 551 
======================================================================
552 
== Function 15, subfunction 4 - set drawing mode for the background. =
 552 
== Function 15, subfunction 4 - set drawing mode for the background. =
553 
======================================================================
 553 
======================================================================
554 
Parameters:
 554 
Parameters:
555 
  * eax = 15 - function number
 555 
  * eax = 15 - function number
556 
  * ebx = 4 - subfunction number
 556 
  * ebx = 4 - subfunction number
557 
  * ecx = drawing mode:
 557 
  * ecx = drawing mode:
558 
    * 1 = tile
 558 
    * 1 = tile
559 
    * 2 = stretch
 559 
    * 2 = stretch
560 
Returned value:
 560 
Returned value:
561 
  * function does not return value
 561 
  * function does not return value
562 
Remarks:
 562 
Remarks:
563 
  * For update of the screen (after completion of a series of commands
 563 
  * For update of the screen (after completion of a series of commands
564 
    working with a background) call subfunction 3.
 564 
    working with a background) call subfunction 3.
565 
  * There is a pair function for get drawing mode of the background -
 565 
  * There is a pair function for get drawing mode of the background -
566 
    subfunction 4 of function 39.
 566 
    subfunction 4 of function 39.
567 
 
 567 
 
568 
======================================================================
 568 
======================================================================
569 
===================== Function 15, subfunction 5 =====================
 569 
===================== Function 15, subfunction 5 =====================
570 
============ Put block of pixels on the background image. ============
 570 
============ Put block of pixels on the background image. ============
571 
======================================================================
 571 
======================================================================
572 
Parameters:
 572 
Parameters:
573 
  * eax = 15 - function number
 573 
  * eax = 15 - function number
574 
  * ebx = 5 - subfunction number
 574 
  * ebx = 5 - subfunction number
575 
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
 575 
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
576 
  * edx = offset in data of the background image
 576 
  * edx = offset in data of the background image
577 
  * esi = size of data in bytes = 3 * number of pixels
 577 
  * esi = size of data in bytes = 3 * number of pixels
578 
Returned value:
 578 
Returned value:
579 
  * function does not return value
 579 
  * function does not return value
580 
Remarks:
 580 
Remarks:
581 
  * Offset and size are not checked for correctness.
 581 
  * Offset and size are not checked for correctness.
582 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
 582 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
583 
  * Pixels of the background image are written sequentially
 583 
  * Pixels of the background image are written sequentially
584 
    from left to right, from up to down.
 584 
    from left to right, from up to down.
585 
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
 585 
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
586 
  * For update of the screen (after completion of a series of commands
 586 
  * For update of the screen (after completion of a series of commands
587 
    working with a background) call subfunction 3.
 587 
    working with a background) call subfunction 3.
588 
 
 588 
 
589 
======================================================================
 589 
======================================================================
590 
===================== Function 15, subfunction 6 =====================
 590 
===================== Function 15, subfunction 6 =====================
591 
======== Map background data to the address space of process. ========
 591 
======== Map background data to the address space of process. ========
592 
======================================================================
 592 
======================================================================
593 
Parameters:
 593 
Parameters:
594 
  * eax = 15 - function number
 594 
  * eax = 15 - function number
595 
  * ebx = 6 - subfunction number
 595 
  * ebx = 6 - subfunction number
596 
Returned value:
 596 
Returned value:
597 
  * eax = pointer to background data, 0 if error
 597 
  * eax = pointer to background data, 0 if error
598 
Remarks:
 598 
Remarks:
599 
  * Mapped data are available for read and write.
 599 
  * Mapped data are available for read and write.
600 
  * Size of background data is 3*xsize*ysize. The system blocks
 600 
  * Size of background data is 3*xsize*ysize. The system blocks
601 
    changes of background sizes while process works with mapped data.
 601 
    changes of background sizes while process works with mapped data.
602 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
 602 
  * Color of each pixel is stored as 3-bytes value BBGGRR.
603 
  * Pixels of the background image are written sequentially
 603 
  * Pixels of the background image are written sequentially
604 
    from left to right, from up to down.
 604 
    from left to right, from up to down.
605 
 
 605 
 
606 
======================================================================
 606 
======================================================================
607 
===== Function 15, subfunction 7 - close mapped background data. =====
 607 
===== Function 15, subfunction 7 - close mapped background data. =====
608 
======================================================================
 608 
======================================================================
609 
Parameters:
 609 
Parameters:
610 
  * eax = 15 - function number
 610 
  * eax = 15 - function number
611 
  * ebx = 7 - subfunction number
 611 
  * ebx = 7 - subfunction number
612 
  * ecx = pointer to mapped data
 612 
  * ecx = pointer to mapped data
613 
Returned value:
 613 
Returned value:
614 
  * eax = 1 - success, 0 - error
 614 
  * eax = 1 - success, 0 - error
615 
 
 615 
 
616 
======================================================================
 616 
======================================================================
617 
===================== Function 15, subfunction 8 =====================
 617 
===================== Function 15, subfunction 8 =====================
618 
============= Get coordinates of last draw the background ============
 618 
============= Get coordinates of last draw the background ============
619 
======================================================================
 619 
======================================================================
620 
Parameters:
 620 
Parameters:
621 
  * eax = 15 - function number
 621 
  * eax = 15 - function number
622 
  * ebx = 8 - subfunction number
 622 
  * ebx = 8 - subfunction number
623 
Returned value:
 623 
Returned value:
624 
  * eax = [left]*65536 + [right]
 624 
  * eax = [left]*65536 + [right]
625 
  * ebx = [top]*65536 + [bottom]
 625 
  * ebx = [top]*65536 + [bottom]
626 
Remarks:
 626 
Remarks:
627 
  * (left,top) are coordinates of the left upper corner,
 627 
  * (left,top) are coordinates of the left upper corner,
628 
    (right,bottom) are coordinates of the right lower one.
 628 
    (right,bottom) are coordinates of the right lower one.
629 
  * For receiving more reliable information, call the function
 629 
  * For receiving more reliable information, call the function
630 
    immediately after the event:
 630 
    immediately after the event:
631 
             5 = kernel finished redrawing of the desktop background
 631 
             5 = kernel finished redrawing of the desktop background
632 
 
 632 
 
633 
======================================================================
 633 
======================================================================
634 
===================== Function 15, subfunction 9 =====================
 634 
===================== Function 15, subfunction 9 =====================
635 
============= Redraws a rectangular part of the background ===========
 635 
============= Redraws a rectangular part of the background ===========
636 
======================================================================
 636 
======================================================================
637 
Parameters:
 637 
Parameters:
638 
  * eax = 15 - function number
 638 
  * eax = 15 - function number
639 
  * ebx = 9 - subfunction number
 639 
  * ebx = 9 - subfunction number
640 
  * ecx = [left]*65536 + [right]
 640 
  * ecx = [left]*65536 + [right]
641 
  * edx = [top]*65536 + [bottom]
 641 
  * edx = [top]*65536 + [bottom]
642 
Returned value:
 642 
Returned value:
643 
  * function does not return value
 643 
  * function does not return value
644 
Remarks:
 644 
Remarks:
645 
  * (left,top) are coordinates of the left upper corner,
 645 
  * (left,top) are coordinates of the left upper corner,
646 
    (right,bottom) are coordinates of the right lower one.
 646 
    (right,bottom) are coordinates of the right lower one.
647 
  * If parameters are set incorrectly then background is not redrawn.
 647 
  * If parameters are set incorrectly then background is not redrawn.
648 
 
 648 
 
649 
======================================================================
 649 
======================================================================
650 
=============== Function 16 - save ramdisk on a floppy. ==============
 650 
=============== Function 16 - save ramdisk on a floppy. ==============
651 
======================================================================
 651 
======================================================================
652 
Parameters:
 652 
Parameters:
653 
  * eax = 16 - function number
 653 
  * eax = 16 - function number
654 
  * ebx = 1 or ebx = 2 - on which floppy save
 654 
  * ebx = 1 or ebx = 2 - on which floppy save
655 
Returned value:
 655 
Returned value:
656 
  * eax = 0 - success
 656 
  * eax = 0 - success
657 
  * eax = 1 - error
 657 
  * eax = 1 - error
658 
 
 658 
 
659 
======================================================================
 659 
======================================================================
660 
======= Function 17 - get the identifier of the pressed button. ======
 660 
======= Function 17 - get the identifier of the pressed button. ======
661 
======================================================================
 661 
======================================================================
662 
Takes away the code of the pressed button from the buffer.
 662 
Takes away the code of the pressed button from the buffer.
663 
Parameters:
 663 
Parameters:
664 
  * eax = 17 - function number
 664 
  * eax = 17 - function number
665 
Returned value:
 665 
Returned value:
666 
  * if the buffer is empty, function returns eax=1
 666 
  * if the buffer is empty, function returns eax=1
667 
  * if the buffer is not empty:
 667 
  * if the buffer is not empty:
668 
    * high 24 bits of eax contain button identifier (in particular,
 668 
    * high 24 bits of eax contain button identifier (in particular,
669 
      ah contains low byte of the identifier; if all buttons have
 669 
      ah contains low byte of the identifier; if all buttons have
670 
      the identifier less than 256, ah is enough to distinguish)
 670 
      the identifier less than 256, ah is enough to distinguish)
671 
    * al = 0 - the button was pressed with left mouse button
 671 
    * al = 0 - the button was pressed with left mouse button
672 
    * al = bit corresponding to used mouse button otherwise
 672 
    * al = bit corresponding to used mouse button otherwise
673 
Remarks:
 673 
Remarks:
674 
  * "Buffer" keeps only one button, at pressing the new button the
 674 
  * "Buffer" keeps only one button, at pressing the new button the
675 
    information about old is lost.
 675 
    information about old is lost.
676 
  * The call of this function by an application with inactive window
 676 
  * The call of this function by an application with inactive window
677 
    will return answer "buffer is empty".
 677 
    will return answer "buffer is empty".
678 
  * Returned value for al corresponds to the state of mouse buttons
 678 
  * Returned value for al corresponds to the state of mouse buttons
679 
    as in subfunction 2 of function 37 at the beginning
 679 
    as in subfunction 2 of function 37 at the beginning
680 
    of button press, excluding lower bit, which is cleared.
 680 
    of button press, excluding lower bit, which is cleared.
681 
 
 681 
 
682 
======================================================================
 682 
======================================================================
683 
===================== Function 18, subfunction 1 =====================
 683 
===================== Function 18, subfunction 1 =====================
684 
============= Make deactive the window of the given thread. ==========
 684 
============= Make deactive the window of the given thread. ==========
685 
======================================================================
 685 
======================================================================
686 
Parameters:
 686 
Parameters:
687 
  * eax = 18 - function number
 687 
  * eax = 18 - function number
688 
  * ebx = 1 - subfunction number
 688 
  * ebx = 1 - subfunction number
689 
  * ecx = number of the thread slot
 689 
  * ecx = number of the thread slot
690 
Returned value:
 690 
Returned value:
691 
  * function does not return value
 691 
  * function does not return value
692 
 
 692 
 
693 
======================================================================
 693 
======================================================================
694 
= Function 18, subfunction 2 - terminate process/thread by the slot. =
 694 
= Function 18, subfunction 2 - terminate process/thread by the slot. =
695 
======================================================================
 695 
======================================================================
696 
Parameters:
 696 
Parameters:
697 
  * eax = 18 - function number
 697 
  * eax = 18 - function number
698 
  * ebx = 2 - subfunction number
 698 
  * ebx = 2 - subfunction number
699 
  * ecx = number of the slot of process/thread
 699 
  * ecx = number of the slot of process/thread
700 
Returned value:
 700 
Returned value:
701 
  * function does not return value
 701 
  * function does not return value
702 
Remarks:
 702 
Remarks:
703 
  * It is impossible to terminate system thread OS/IDLE (with
 703 
  * It is impossible to terminate system thread OS/IDLE (with
704 
    number of the slot 1),
 704 
    number of the slot 1),
705 
    it is possible to terminate any normal process/thread.
 705 
    it is possible to terminate any normal process/thread.
706 
  * See also subfunction 18 - terminate
 706 
  * See also subfunction 18 - terminate
707 
    process/thread by the identifier.
 707 
    process/thread by the identifier.
708 
 
 708 
 
709 
======================================================================
 709 
======================================================================
710 
===================== Function 18, subfunction 3 =====================
 710 
===================== Function 18, subfunction 3 =====================
711 
============= Make active the window of the given thread. ============
 711 
============= Make active the window of the given thread. ============
712 
======================================================================
 712 
======================================================================
713 
Parameters:
 713 
Parameters:
714 
  * eax = 18 - function number
 714 
  * eax = 18 - function number
715 
  * ebx = 3 - subfunction number
 715 
  * ebx = 3 - subfunction number
716 
  * ecx = number of the thread slot
 716 
  * ecx = number of the thread slot
717 
Returned value:
 717 
Returned value:
718 
  * function does not return value
 718 
  * function does not return value
719 
Remarks:
 719 
Remarks:
720 
  * If correct, but nonexistent slot is given,
 720 
  * If correct, but nonexistent slot is given,
721 
    some window is made active.
 721 
    some window is made active.
722 
  * To find out, which window is active, use subfunction 7.
 722 
  * To find out, which window is active, use subfunction 7.
723 
 
 723 
 
724 
======================================================================
 724 
======================================================================
725 
===================== Function 18, subfunction 4 =====================
 725 
===================== Function 18, subfunction 4 =====================
726 
=========== Get counter of idle time units per one second. ===========
 726 
=========== Get counter of idle time units per one second. ===========
727 
======================================================================
 727 
======================================================================
728 
Idle time units are units, in which the processor stands idle
 728 
Idle time units are units, in which the processor stands idle
729 
in waiting for interrupt (in the command 'hlt').
 729 
in waiting for interrupt (in the command 'hlt').
730 
 
 730 
 
731 
Parameters:
 731 
Parameters:
732 
  * eax = 18 - function number
 732 
  * eax = 18 - function number
733 
  * ebx = 4 - subfunction number
 733 
  * ebx = 4 - subfunction number
734 
Returned value:
 734 
Returned value:
735 
  * eax = value of the counter of idle time units per one second
 735 
  * eax = value of the counter of idle time units per one second
736 
 
 736 
 
737 
======================================================================
 737 
======================================================================
738 
========== Function 18, subfunction 5 - get CPU clock rate. ==========
 738 
========== Function 18, subfunction 5 - get CPU clock rate. ==========
739 
======================================================================
 739 
======================================================================
740 
Parameters:
 740 
Parameters:
741 
  * eax = 18 - function number
 741 
  * eax = 18 - function number
742 
  * ebx = 5 - subfunction number
 742 
  * ebx = 5 - subfunction number
743 
Returned value:
 743 
Returned value:
744 
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
 744 
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
745 
 
 745 
 
746 
======================================================================
 746 
======================================================================
747 
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
 747 
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
748 
======================================================================
 748 
======================================================================
749 
Parameters:
 749 
Parameters:
750 
  * eax = 18 - function number
 750 
  * eax = 18 - function number
751 
  * ebx = 6 - subfunction number
 751 
  * ebx = 6 - subfunction number
752 
  * ecx = pointer to the full path to file
 752 
  * ecx = pointer to the full path to file
753 
    (for example, "/hd0/1/kolibri/kolibri.img")
 753 
    (for example, "/hd0/1/kolibri/kolibri.img")
754 
Returned value:
 754 
Returned value:
755 
  * eax = 0 - success
 755 
  * eax = 0 - success
756 
  * else eax = error code of the file system
 756 
  * else eax = error code of the file system
757 
Remarks:
 757 
Remarks:
758 
  * All folders in the given path must exist, otherwise function
 758 
  * All folders in the given path must exist, otherwise function
759 
    returns value 5, "file not found".
 759 
    returns value 5, "file not found".
760 
 
 760 
 
761 
======================================================================
 761 
======================================================================
762 
=========== Function 18, subfunction 7 - get active window. ==========
 762 
=========== Function 18, subfunction 7 - get active window. ==========
763 
======================================================================
 763 
======================================================================
764 
Parameters:
 764 
Parameters:
765 
  * eax = 18 - function number
 765 
  * eax = 18 - function number
766 
  * ebx = 7 - subfunction number
 766 
  * ebx = 7 - subfunction number
767 
Returned value:
 767 
Returned value:
768 
  * eax = number of the active window
 768 
  * eax = number of the active window
769 
    (number of the slot of the thread with active window)
 769 
    (number of the slot of the thread with active window)
770 
Remarks:
 770 
Remarks:
771 
  * Active window is at the top of the window stack and receives
 771 
  * Active window is at the top of the window stack and receives
772 
    messages on all keyboard input.
 772 
    messages on all keyboard input.
773 
  * To make a window active, use subfunction 3.
 773 
  * To make a window active, use subfunction 3.
774 
 
 774 
 
775 
======================================================================
 775 
======================================================================
776 
== Function 18, subfunction 8 - disable/enable the internal speaker. =
 776 
== Function 18, subfunction 8 - disable/enable the internal speaker. =
777 
======================================================================
 777 
======================================================================
778 
If speaker sound is disabled, all calls to subfunction 55 of
 778 
If speaker sound is disabled, all calls to subfunction 55 of
779 
function 55 are ignored. If speaker sound is enabled,
 779 
function 55 are ignored. If speaker sound is enabled,
780 
they are routed on builtin speaker.
 780 
they are routed on builtin speaker.
781 
 
 781 
 
782 
------------------- Subsubfunction 1 - get status. -------------------
 782 
------------------- Subsubfunction 1 - get status. -------------------
783 
Parameters:
 783 
Parameters:
784 
  * eax = 18 - function number
 784 
  * eax = 18 - function number
785 
  * ebx = 8 - subfunction number
 785 
  * ebx = 8 - subfunction number
786 
  * ecx = 1 - number of the subsubfunction
 786 
  * ecx = 1 - number of the subsubfunction
787 
Returned value:
 787 
Returned value:
788 
  * eax = 0 - speaker sound is enabled; 1 - disabled
 788 
  * eax = 0 - speaker sound is enabled; 1 - disabled
789 
 
 789 
 
790 
----------------- Subsubfunction 2 - toggle status. ------------------
 790 
----------------- Subsubfunction 2 - toggle status. ------------------
791 
Toggles states of disable/enable.
 791 
Toggles states of disable/enable.
792 
Parameters:
 792 
Parameters:
793 
  * eax = 18 - function number
 793 
  * eax = 18 - function number
794 
  * ebx = 8 - subfunction number
 794 
  * ebx = 8 - subfunction number
795 
  * ecx = 2 - number of the subsubfunction
 795 
  * ecx = 2 - number of the subsubfunction
796 
Returned value:
 796 
Returned value:
797 
  * function does not return value
 797 
  * function does not return value
798 
 
 798 
 
799 
======================================================================
 799 
======================================================================
800 
== Function 18, subfunction 9 - system shutdown with the parameter. ==
 800 
== Function 18, subfunction 9 - system shutdown with the parameter. ==
801 
======================================================================
 801 
======================================================================
802 
Parameters:
 802 
Parameters:
803 
  * eax = 18 - function number
 803 
  * eax = 18 - function number
804 
  * ebx = 9 - subfunction number
 804 
  * ebx = 9 - subfunction number
805 
  * ecx = parameter:
 805 
  * ecx = parameter:
806 
    * 2 = turn off computer
 806 
    * 2 = turn off computer
807 
    * 3 = reboot computer
 807 
    * 3 = reboot computer
808 
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
 808 
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
809 
Returned value:
 809 
Returned value:
810 
  * at incorrect ecx the registers do not change (i.e. eax=18)
 810 
  * at incorrect ecx the registers do not change (i.e. eax=18)
811 
  * by correct call function always returns eax=0
 811 
  * by correct call function always returns eax=0
812 
    as the tag of success
 812 
    as the tag of success
813 
Remarks:
 813 
Remarks:
814 
  * Do not rely on returned value by incorrect call, it can be
 814 
  * Do not rely on returned value by incorrect call, it can be
815 
    changed in future versions of the kernel.
 815 
    changed in future versions of the kernel.
816 
 
 816 
 
817 
======================================================================
 817 
======================================================================
818 
===== Function 18, subfunction 10 - minimize application window. =====
 818 
===== Function 18, subfunction 10 - minimize application window. =====
819 
======================================================================
 819 
======================================================================
820 
Minimizes the own window.
 820 
Minimizes the own window.
821 
Parameters:
 821 
Parameters:
822 
  * eax = 18 - function number
 822 
  * eax = 18 - function number
823 
  * ebx = 10 - subfunction number
 823 
  * ebx = 10 - subfunction number
824 
Returned value:
 824 
Returned value:
825 
  * function does not return value
 825 
  * function does not return value
826 
Remarks:
 826 
Remarks:
827 
  * The minimized window from the point of view of function 9
 827 
  * The minimized window from the point of view of function 9
828 
    keeps position and sizes.
 828 
    keeps position and sizes.
829 
  * Restoring of an application window occurs at its activation by
 829 
  * Restoring of an application window occurs at its activation by
830 
    subfunction 3.
 830 
    subfunction 3.
831 
  * Usually there is no necessity to minimize/restire a window
 831 
  * Usually there is no necessity to minimize/restire a window
832 
    obviously: minimization of a window is carried out by the system
 832 
    obviously: minimization of a window is carried out by the system
833 
    at pressing the minimization button (for skinned windows
 833 
    at pressing the minimization button (for skinned windows
834 
    it is defined automatically by function 0,
 834 
    it is defined automatically by function 0,
835 
    for other windows it can be defined manually by function 8),
 835 
    for other windows it can be defined manually by function 8),
836 
    restore of a window is done by the application '@panel'.
 836 
    restore of a window is done by the application '@panel'.
837 
 
 837 
 
838 
======================================================================
 838 
======================================================================
839 
 Function 18, subfunction 11 - get information on the disk subsystem.
 839 
 Function 18, subfunction 11 - get information on the disk subsystem.
840 
======================================================================
 840 
======================================================================
841 
Parameters:
 841 
Parameters:
842 
  * eax = 18 - function number
 842 
  * eax = 18 - function number
843 
  * ebx = 11 - subfunction number
 843 
  * ebx = 11 - subfunction number
844 
  * ecx = type of the table:
 844 
  * ecx = type of the table:
845 
    * 1 = short version, 10 bytes
 845 
    * 1 = short version, 10 bytes
846 
    * 2 = full version, 65536 bytes
 846 
    * 2 = full version, 65536 bytes
847 
  * edx = pointer to the buffer (in the application) for the table
 847 
  * edx = pointer to the buffer (in the application) for the table
848 
Returned value:
 848 
Returned value:
849 
  * function does not return value
 849 
  * function does not return value
850 
Format of the table: short version:
 850 
Format of the table: short version:
851 
  * +0: byte: information about FDD's (drives for floppies),
 851 
  * +0: byte: information about FDD's (drives for floppies),
852 
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
 852 
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
853 
    of the second regarding to the following list:
 853 
    of the second regarding to the following list:
854 
    * 0 = there is no drive
 854 
    * 0 = there is no drive
855 
    * 1 = 360Kb, 5.25''
 855 
    * 1 = 360Kb, 5.25''
856 
    * 2 = 1.2Mb, 5.25''
 856 
    * 2 = 1.2Mb, 5.25''
857 
    * 3 = 720Kb, 3.5''
 857 
    * 3 = 720Kb, 3.5''
858 
    * 4 = 1.44Mb, 3.5''
 858 
    * 4 = 1.44Mb, 3.5''
859 
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
 859 
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
860 
    For example, for the standard configuration from one 1.44-drive
 860 
    For example, for the standard configuration from one 1.44-drive
861 
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
 861 
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
862 
    the value is 24h.
 862 
    the value is 24h.
863 
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
 863 
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
864 
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
 864 
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
865 
    * 0 = device is absent
 865 
    * 0 = device is absent
866 
    * 1 = hard drive
 866 
    * 1 = hard drive
867 
    * 2 = CD-drive
 867 
    * 2 = CD-drive
868 
    For example, in the case HD on IDE0 and CD on IDE2
 868 
    For example, in the case HD on IDE0 and CD on IDE2
869 
    this field contains 48h.
 869 
    this field contains 48h.
870 
  * +2: 4 db: number of the retrieved partitions on hard disks
 870 
  * +2: 4 db: number of the retrieved partitions on hard disks
871 
    at accordingly IDE0,...,IDE3.
 871 
    at accordingly IDE0,...,IDE3.
872 
    If the hard disk on IDEx is absent, appropriate byte is zero,
 872 
    If the hard disk on IDEx is absent, appropriate byte is zero,
873 
    otherwise it shows number of the recognized partitions, which
 873 
    otherwise it shows number of the recognized partitions, which
874 
    can be not presented (if the drive is not formatted or if
 874 
    can be not presented (if the drive is not formatted or if
875 
    the file system is not supported). Current version of the kernel
 875 
    the file system is not supported). Current version of the kernel
876 
    supports only FAT16, FAT32 and NTFS for hard disks.
 876 
    supports only FAT16, FAT32 and NTFS for hard disks.
877 
  * +6: 4 db: reserved
 877 
  * +6: 4 db: reserved
878 
Format of the table: full version:
 878 
Format of the table: full version:
879 
  * +0: 10 db: same as for the short version
 879 
  * +0: 10 db: same as for the short version
880 
  * +10: 100 db: data for the first partition
 880 
  * +10: 100 db: data for the first partition
881 
  * +110: 100 db: data for the second partition
 881 
  * +110: 100 db: data for the second partition
882 
  * ...
 882 
  * ...
883 
  * +10+100*(n-1): 100 db: data for the last partition
 883 
  * +10+100*(n-1): 100 db: data for the last partition
884 
The partitions are located as follows: at first sequentially all
 884 
The partitions are located as follows: at first sequentially all
885 
recoginzed partitions on HD on IDE0 (if present),
 885 
recoginzed partitions on HD on IDE0 (if present),
886 
then on HD on IDE1 (if present) and so on up to IDE3.
 886 
then on HD on IDE1 (if present) and so on up to IDE3.
887 
Format of the information about partition
 887 
Format of the information about partition
888 
(at moment only FAT is supported):
 888 
(at moment only FAT is supported):
889 
  * +0: dword: first physical sector of the partition
 889 
  * +0: dword: first physical sector of the partition
890 
  * +4: dword: last physical sector of the partition
 890 
  * +4: dword: last physical sector of the partition
891 
    (belongs to the partition)
 891 
    (belongs to the partition)
892 
  * +8: byte: file system type:
 892 
  * +8: byte: file system type:
893 
    16=FAT16, 32=FAT32, 1=NTFS
 893 
    16=FAT16, 32=FAT32, 1=NTFS
894 
  * other data are dependent on file system, are modified with
 894 
  * other data are dependent on file system, are modified with
895 
    kernel modifications and therefore are not described
 895 
    kernel modifications and therefore are not described
896 
Remarks:
 896 
Remarks:
897 
  * The short table can be used for obtaining the information about
 897 
  * The short table can be used for obtaining the information about
898 
    available devices.
 898 
    available devices.
899 
 
 899 
 
900 
======================================================================
 900 
======================================================================
901 
========== Function 18, subfunction 13 - get kernel version. =========
 901 
========== Function 18, subfunction 13 - get kernel version. =========
902 
======================================================================
 902 
======================================================================
903 
Parameters:
 903 
Parameters:
904 
  * eax = 18 - function number
 904 
  * eax = 18 - function number
905 
  * ebx = 13 - subfunction number
 905 
  * ebx = 13 - subfunction number
906 
  * ecx = pointer to the buffer (not less than 16 bytes), where
 906 
  * ecx = pointer to the buffer (not less than 16 bytes), where
907 
    the information will be placed
 907 
    the information will be placed
908 
Returned value:
 908 
Returned value:
909 
  * function does not return value
 909 
  * function does not return value
910 
Structure of the buffer:
 910 
Structure of the buffer:
911 
db a,b,c,d for version a.b.c.d
 911 
db a,b,c,d for version a.b.c.d
912 
db 0: reserved
 912 
db 0: reserved
913 
dd REV - kernel SVN revision number
 913 
dd REV - kernel SVN revision number
914 
For Kolibri 0.7.7.0+ kernel:
 914 
For Kolibri 0.7.7.0+ kernel:
915 
db 0,7,7,0
 915 
db 0,7,7,0
916 
db 0
 916 
db 0
917 
dd 1675
 917 
dd 1675
918 
 
 918 
 
919 
======================================================================
 919 
======================================================================
920 
======= Function 18, subfunction 14 - wait for screen retrace. =======
 920 
======= Function 18, subfunction 14 - wait for screen retrace. =======
921 
======================================================================
 921 
======================================================================
922 
Waits for the beginning of retrace of the scanning ray of the screen
 922 
Waits for the beginning of retrace of the scanning ray of the screen
923 
monitor.
 923 
monitor.
924 
Parameters:
 924 
Parameters:
925 
  * eax = 18 - function number
 925 
  * eax = 18 - function number
926 
  * ebx = 14 - subfunction number
 926 
  * ebx = 14 - subfunction number
927 
Returned value:
 927 
Returned value:
928 
  * eax = 0 as the tag of success
 928 
  * eax = 0 as the tag of success
929 
Remarks:
 929 
Remarks:
930 
  * Function is intended only for active high-efficiency graphics
 930 
  * Function is intended only for active high-efficiency graphics
931 
    applications; is used for smooth output of a graphics.
 931 
    applications; is used for smooth output of a graphics.
932 
 
 932 
 
933 
======================================================================
 933 
======================================================================
934 
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
 934 
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
935 
======================================================================
 935 
======================================================================
936 
Parameters:
 936 
Parameters:
937 
  * eax = 18 - function number
 937 
  * eax = 18 - function number
938 
  * ebx = 15 - subfunction number
 938 
  * ebx = 15 - subfunction number
939 
Returned value:
 939 
Returned value:
940 
  * eax = 0 as the tag of success
 940 
  * eax = 0 as the tag of success
941 
 
 941 
 
942 
======================================================================
 942 
======================================================================
943 
========= Function 18, subfunction 16 - get size of free RAM. ========
 943 
========= Function 18, subfunction 16 - get size of free RAM. ========
944 
======================================================================
 944 
======================================================================
945 
Parameters:
 945 
Parameters:
946 
  * eax = 18 - function number
 946 
  * eax = 18 - function number
947 
  * ebx = 16 - subfunction number
 947 
  * ebx = 16 - subfunction number
948 
Returned value:
 948 
Returned value:
949 
  * eax = size of free memory in kilobytes
 949 
  * eax = size of free memory in kilobytes
950 
 
 950 
 
951 
======================================================================
 951 
======================================================================
952 
======== Function 18, subfunction 17 - get full amount of RAM. =======
 952 
======== Function 18, subfunction 17 - get full amount of RAM. =======
953 
======================================================================
 953 
======================================================================
954 
Parameters:
 954 
Parameters:
955 
  * eax = 18 - function number
 955 
  * eax = 18 - function number
956 
  * ebx = 17 - subfunction number
 956 
  * ebx = 17 - subfunction number
957 
Returned value:
 957 
Returned value:
958 
  * eax = total size of existing memory in kilobytes
 958 
  * eax = total size of existing memory in kilobytes
959 
 
 959 
 
960 
======================================================================
 960 
======================================================================
961 
===================== Function 18, subfunction 18 ====================
 961 
===================== Function 18, subfunction 18 ====================
962 
============= Terminate process/thread by the identifier. ============
 962 
============= Terminate process/thread by the identifier. ============
963 
======================================================================
 963 
======================================================================
964 
Parameters:
 964 
Parameters:
965 
  * eax = 18 - function number
 965 
  * eax = 18 - function number
966 
  * ebx = 18 - subfunction number
 966 
  * ebx = 18 - subfunction number
967 
  * ecx = identifer of process/thread (PID/TID)
 967 
  * ecx = identifer of process/thread (PID/TID)
968 
Returned value:
 968 
Returned value:
969 
  * eax = 0 - success
 969 
  * eax = 0 - success
970 
  * eax = -1 - error (process is not found or is system)
 970 
  * eax = -1 - error (process is not found or is system)
971 
Remarks:
 971 
Remarks:
972 
  * It is impossible to terminate system thread OS/IDLE (identifier
 972 
  * It is impossible to terminate system thread OS/IDLE (identifier
973 
    1), it is possible to terminate any normal process/thread.
 973 
    1), it is possible to terminate any normal process/thread.
974 
  * See also subfunction 2 - terminate
 974 
  * See also subfunction 2 - terminate
975 
    process/thread by given slot.
 975 
    process/thread by given slot.
976 
 
 976 
 
977 
======================================================================
 977 
======================================================================
978 
======== Function 18, subfunction 19 - get/set mouse features. =======
 978 
======== Function 18, subfunction 19 - get/set mouse features. =======
979 
======================================================================
 979 
======================================================================
980 
 
 980 
 
981 
---------------- Subsubfunction 0 - get mouse speed. -----------------
 981 
---------------- Subsubfunction 0 - get mouse speed. -----------------
982 
Parameters:
 982 
Parameters:
983 
  * eax = 18 - function number
 983 
  * eax = 18 - function number
984 
  * ebx = 19 - subfunction number
 984 
  * ebx = 19 - subfunction number
985 
  * ecx = 0 - subsubfunction number
 985 
  * ecx = 0 - subsubfunction number
986 
Returned value:
 986 
Returned value:
987 
  * eax = current mouse speed
 987 
  * eax = current mouse speed
988 
 
 988 
 
989 
---------------- Subsubfunction 1 - set mouse speed. -----------------
 989 
---------------- Subsubfunction 1 - set mouse speed. -----------------
990 
Parameters:
 990 
Parameters:
991 
  * eax = 18 - function number
 991 
  * eax = 18 - function number
992 
  * ebx = 19 - subfunction number
 992 
  * ebx = 19 - subfunction number
993 
  * ecx = 1 - subsubfunction number
 993 
  * ecx = 1 - subsubfunction number
994 
  * edx = new value for speed
 994 
  * edx = new value for speed
995 
Returned value:
 995 
Returned value:
996 
  * function does not return value
 996 
  * function does not return value
997 
 
 997 
 
998 
---------------- Subsubfunction 2 - get mouse delay. -----------------
 998 
---------------- Subsubfunction 2 - get mouse delay. -----------------
999 
Parameters:
 999 
Parameters:
1000 
  * eax = 18 - function number
 1000 
  * eax = 18 - function number
1001 
  * ebx = 19 - subfunction number
 1001 
  * ebx = 19 - subfunction number
1002 
  * ecx = 2 - subsubfunction number
 1002 
  * ecx = 2 - subsubfunction number
1003 
Returned value:
 1003 
Returned value:
1004 
  * eax = current mouse delay
 1004 
  * eax = current mouse delay
1005 
 
 1005 
 
1006 
---------------- Subsubfunction 3 - set mouse delay. -----------------
 1006 
---------------- Subsubfunction 3 - set mouse delay. -----------------
1007 
Parameters:
 1007 
Parameters:
1008 
  * eax = 18 - function number
 1008 
  * eax = 18 - function number
1009 
  * ebx = 19 - subfunction number
 1009 
  * ebx = 19 - subfunction number
1010 
  * ecx = 3 - subsubfunction number
 1010 
  * ecx = 3 - subsubfunction number
1011 
  * edx = new value for mouse delay
 1011 
  * edx = new value for mouse delay
1012 
Returned value:
 1012 
Returned value:
1013 
  * function does not return value
 1013 
  * function does not return value
1014 
 
 1014 
 
1015 
----------- Subsubfunction 4 - set mouse pointer position. -----------
 1015 
----------- Subsubfunction 4 - set mouse pointer position. -----------
1016 
Parameters:
 1016 
Parameters:
1017 
  * eax = 18 - function number
 1017 
  * eax = 18 - function number
1018 
  * ebx = 19 - subfunction number
 1018 
  * ebx = 19 - subfunction number
1019 
  * ecx = 4 - subsubfunction number
 1019 
  * ecx = 4 - subsubfunction number
1020 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 1020 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1021 
Returned value:
 1021 
Returned value:
1022 
  * function does not return value
 1022 
  * function does not return value
1023 
 
 1023 
 
1024 
-------- Subsubfunction 5 - simulate state of mouse buttons. ---------
 1024 
-------- Subsubfunction 5 - simulate state of mouse buttons. ---------
1025 
Parameters:
 1025 
Parameters:
1026 
  * eax = 18 - function number
 1026 
  * eax = 18 - function number
1027 
  * ebx = 19 - subfunction number
 1027 
  * ebx = 19 - subfunction number
1028 
  * ecx = 5 - subsubfunction number
 1028 
  * ecx = 5 - subsubfunction number
1029 
  * edx = information about emulated state of mouse buttons:
 1029 
  * edx = information about emulated state of mouse buttons:
1030 
    (same as return value in subfunction 2 of function 37)
 1030 
    (same as return value in subfunction 2 of function 37)
1031 
    * bit 0 is set = left button is pressed
 1031 
    * bit 0 is set = left button is pressed
1032 
    * bit 1 is set = right button is pressed
 1032 
    * bit 1 is set = right button is pressed
1033 
    * bit 2 is set = middle button is pressed
 1033 
    * bit 2 is set = middle button is pressed
1034 
    * bit 3 is set = 4th button is pressed
 1034 
    * bit 3 is set = 4th button is pressed
1035 
    * bit 4 is set = 5th button is pressed
 1035 
    * bit 4 is set = 5th button is pressed
1036 
Returned value:
 1036 
Returned value:
1037 
  * function does not return value
 1037 
  * function does not return value
1038 
Remarks:
 1038 
Remarks:
1039 
  * It is recommended to set speed of the mouse (in subsubfunction 1)
 1039 
  * It is recommended to set speed of the mouse (in subsubfunction 1)
1040 
    from 1 up to 9. The installed value is not inspected by the kernel
 1040 
    from 1 up to 9. The installed value is not inspected by the kernel
1041 
    code, so set it carefully, at incorrect value the cursor
 1041 
    code, so set it carefully, at incorrect value the cursor
1042 
    can "freeze". Speed of the mouse can be regulated through the
 1042 
    can "freeze". Speed of the mouse can be regulated through the
1043 
    application SETUP.
 1043 
    application SETUP.
1044 
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
 1044 
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
1045 
    value is not handled by COM mice. At the very large values the
 1045 
    value is not handled by COM mice. At the very large values the
1046 
    movement of the mouse on 1 pixel is impossible and the cursor will
 1046 
    movement of the mouse on 1 pixel is impossible and the cursor will
1047 
    jump on the value of installed speed (subsubfunction 1). The
 1047 
    jump on the value of installed speed (subsubfunction 1). The
1048 
    installed value is not inspected by the kernel code.
 1048 
    installed value is not inspected by the kernel code.
1049 
    Mouse delay can be regulated through the application SETUP.
 1049 
    Mouse delay can be regulated through the application SETUP.
1050 
  * The subsubfunction 4 does not check the passed value. Before
 1050 
  * The subsubfunction 4 does not check the passed value. Before
1051 
    its call find out current screen resolution (with function 14)
 1051 
    its call find out current screen resolution (with function 14)
1052 
    and check that the value of position is inside the limits of the
 1052 
    and check that the value of position is inside the limits of the
1053 
    screen.
 1053 
    screen.
1054 
 
 1054 
 
1055 
======================================================================
 1055 
======================================================================
1056 
======== Function 18, subfunction 20 - get information on RAM. =======
 1056 
======== Function 18, subfunction 20 - get information on RAM. =======
1057 
======================================================================
 1057 
======================================================================
1058 
Parameters:
 1058 
Parameters:
1059 
  * eax = 18 - function number
 1059 
  * eax = 18 - function number
1060 
  * ebx = 20 - subfunction number
 1060 
  * ebx = 20 - subfunction number
1061 
  * ecx = pointer to the buffer for information (36 bytes)
 1061 
  * ecx = pointer to the buffer for information (36 bytes)
1062 
Returned value:
 1062 
Returned value:
1063 
  * eax = total size of existing RAM in pages
 1063 
  * eax = total size of existing RAM in pages
1064 
    or -1 if error has occured
 1064 
    or -1 if error has occured
1065 
  * buffer pointed to by ecx contains the following information:
 1065 
  * buffer pointed to by ecx contains the following information:
1066 
    * +0:  dword: total size of existing RAM in pages
 1066 
    * +0:  dword: total size of existing RAM in pages
1067 
    * +4:  dword: size of free RAM in pages
 1067 
    * +4:  dword: size of free RAM in pages
1068 
    * +8:  dword: number of page faults (exceptions #PF)
 1068 
    * +8:  dword: number of page faults (exceptions #PF)
1069 
                 in applications
 1069 
                 in applications
1070 
    * +12: dword: size of kernel heap in bytes
 1070 
    * +12: dword: size of kernel heap in bytes
1071 
    * +16: dword: free in kernel heap in bytes
 1071 
    * +16: dword: free in kernel heap in bytes
1072 
    * +20: dword: total number of memory blocks in kernel heap
 1072 
    * +20: dword: total number of memory blocks in kernel heap
1073 
    * +24: dword: number of free memory blocks in kernel heap
 1073 
    * +24: dword: number of free memory blocks in kernel heap
1074 
    * +28: dword: size of maximum free block in kernel heap
 1074 
    * +28: dword: size of maximum free block in kernel heap
1075 
                 (reserved)
 1075 
                 (reserved)
1076 
    * +32: dword: size of maximum allocated block in kernel heap
 1076 
    * +32: dword: size of maximum allocated block in kernel heap
1077 
                 (reserved)
 1077 
                 (reserved)
1078 
 
 1078 
 
1079 
======================================================================
 1079 
======================================================================
1080 
===================== Function 18, subfunction 21 ====================
 1080 
===================== Function 18, subfunction 21 ====================
1081 
======== Get slot number of process/thread by the identifier. ========
 1081 
======== Get slot number of process/thread by the identifier. ========
1082 
======================================================================
 1082 
======================================================================
1083 
Parameters:
 1083 
Parameters:
1084 
  * eax = 18 - function number
 1084 
  * eax = 18 - function number
1085 
  * ebx = 21 - subfunction number
 1085 
  * ebx = 21 - subfunction number
1086 
  * ecx = identifer of process/thread (PID/TID)
 1086 
  * ecx = identifer of process/thread (PID/TID)
1087 
Returned value:
 1087 
Returned value:
1088 
  * eax = 0 - error (invalid identifier)
 1088 
  * eax = 0 - error (invalid identifier)
1089 
  * otherwise eax = slot number
 1089 
  * otherwise eax = slot number
1090 
 
 1090 
 
1091 
======================================================================
 1091 
======================================================================
1092 
===================== Function 18, subfunction 22 ====================
 1092 
===================== Function 18, subfunction 22 ====================
1093 
============== Operations with window of another thread. =============
 1093 
============== Operations with window of another thread. =============
1094 
======================================================================
 1094 
======================================================================
1095 
Parameters:
 1095 
Parameters:
1096 
  * eax = 18 - function number
 1096 
  * eax = 18 - function number
1097 
  * ebx = 22 - subfunction number
 1097 
  * ebx = 22 - subfunction number
1098 
  * ecx = operation type:
 1098 
  * ecx = operation type:
1099 
    * 0 = minimize window of the thread with given slot number
 1099 
    * 0 = minimize window of the thread with given slot number
1100 
    * 1 = minimize window of the thread with given identifier
 1100 
    * 1 = minimize window of the thread with given identifier
1101 
    * 2 = restore window of the thread with given slot number
 1101 
    * 2 = restore window of the thread with given slot number
1102 
    * 3 = restore window of the thread with given identifier
 1102 
    * 3 = restore window of the thread with given identifier
1103 
  * edx = parameter (slot number or PID/TID)
 1103 
  * edx = parameter (slot number or PID/TID)
1104 
Returned value:
 1104 
Returned value:
1105 
  * eax = 0 - success
 1105 
  * eax = 0 - success
1106 
  * eax = -1 - error (invalid identifier)
 1106 
  * eax = -1 - error (invalid identifier)
1107 
Remarks:
 1107 
Remarks:
1108 
  * The thread can minimize its window with subfunction 10.
 1108 
  * The thread can minimize its window with subfunction 10.
1109 
  * One can restore and activate window simultaneously with
 1109 
  * One can restore and activate window simultaneously with
1110 
    subfunction 3 (which requires slot number).
 1110 
    subfunction 3 (which requires slot number).
1111 
 
 1111 
 
1112 
======================================================================
 1112 
======================================================================
1113 
======== Function 18, subfunction 23 - minimize all windows. ==========
 1113 
======== Function 18, subfunction 23 - minimize all windows. ==========
1114 
======================================================================
 1114 
======================================================================
1115 
Parameters:
 1115 
Parameters:
1116 
  * eax = 18 - function number
 1116 
  * eax = 18 - function number
1117 
  * ebx = 23 - subfunction number
 1117 
  * ebx = 23 - subfunction number
1118 
Returned value:
 1118 
Returned value:
1119 
  * eax = 0 - all windows have been minimized before a function call
 1119 
  * eax = 0 - all windows have been minimized before a function call
1120 
  * eax = N - number of windows minimized from function
 1120 
  * eax = N - number of windows minimized from function
1121 
Remarks:
 1121 
Remarks:
1122 
  * Window of special thread (name begin to symbol @) is not minimize.
 1122 
  * Window of special thread (name begin to symbol @) is not minimize.
1123 
 
 1123 
 
1124 
======================================================================
 1124 
======================================================================
1125 
======= Function 18, subfunction 24 - set limits of screen. ==========
 1125 
======= Function 18, subfunction 24 - set limits of screen. ==========
1126 
======================================================================
 1126 
======================================================================
1127 
Parameters:
 1127 
Parameters:
1128 
  * eax = 18 - function number
 1128 
  * eax = 18 - function number
1129 
  * ebx = 24 - subfunction number
 1129 
  * ebx = 24 - subfunction number
1130 
  * ecx = new X size
 1130 
  * ecx = new X size
1131 
  * edx = new Y size
 1131 
  * edx = new Y size
1132 
Returned value:
 1132 
Returned value:
1133 
  * function does not return value
 1133 
  * function does not return value
1134 
Remarks:
 1134 
Remarks:
1135 
  * The function does not change the physical size of the video mode.
 1135 
  * The function does not change the physical size of the video mode.
1136 
    It is designed for non-standard displays which display the image
 1136 
    It is designed for non-standard displays which display the image
1137 
    partially.
 1137 
    partially.
1138 
  * The sizes specified in the function should not exceed the sizes
 1138 
  * The sizes specified in the function should not exceed the sizes
1139 
    of the current video mode, otherwise the function will not change
 1139 
    of the current video mode, otherwise the function will not change
1140 
    anything.
 1140 
    anything.
1141 
 
 1141 
 
1142 
======================================================================
 1142 
======================================================================
1143 
==================== Function 20 - MIDI interface. ===================
 1143 
==================== Function 20 - MIDI interface. ===================
1144 
======================================================================
 1144 
======================================================================
1145 
 
 1145 
 
1146 
----------------------- Subfunction 1 - reset ------------------------
 1146 
----------------------- Subfunction 1 - reset ------------------------
1147 
Parameters:
 1147 
Parameters:
1148 
  * eax = 20 - function number
 1148 
  * eax = 20 - function number
1149 
  * ebx = 1 - subfunction number
 1149 
  * ebx = 1 - subfunction number
1150 
 
 1150 
 
1151 
-------------------- Subfunction 2 - output byte ---------------------
 1151 
-------------------- Subfunction 2 - output byte ---------------------
1152 
Parameters:
 1152 
Parameters:
1153 
  * eax = 20 - function number
 1153 
  * eax = 20 - function number
1154 
  * ebx = 2 - subfunction number
 1154 
  * ebx = 2 - subfunction number
1155 
  * cl = byte for output
 1155 
  * cl = byte for output
1156 
Returned value (is the same for both subfunctions):
 1156 
Returned value (is the same for both subfunctions):
1157 
  * eax = 0 - success
 1157 
  * eax = 0 - success
1158 
  * eax = 1 - base port is not defined
 1158 
  * eax = 1 - base port is not defined
1159 
Remarks:
 1159 
Remarks:
1160 
  * Previously the base port must be defined by
 1160 
  * Previously the base port must be defined by
1161 
    subfunction 1 of function 21.
 1161 
    subfunction 1 of function 21.
1162 
 
 1162 
 
1163 
======================================================================
 1163 
======================================================================
1164 
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
 1164 
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
1165 
======================================================================
 1165 
======================================================================
1166 
Parameters:
 1166 
Parameters:
1167 
  * eax = 21 - function number
 1167 
  * eax = 21 - function number
1168 
  * ebx = 1 - subfunction number
 1168 
  * ebx = 1 - subfunction number
1169 
  * ecx = number of base port
 1169 
  * ecx = number of base port
1170 
Returned value
 1170 
Returned value
1171 
  * eax = 0 - success
 1171 
  * eax = 0 - success
1172 
  * eax = -1 - erratic number of a port
 1172 
  * eax = -1 - erratic number of a port
1173 
Remarks:
 1173 
Remarks:
1174 
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
 1174 
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
1175 
  * The installation of base is necessary for function 20.
 1175 
  * The installation of base is necessary for function 20.
1176 
  * To get base port use subfunction 1 of function 26.
 1176 
  * To get base port use subfunction 1 of function 26.
1177 
 
 1177 
 
1178 
======================================================================
 1178 
======================================================================
1179 
========== Function 21, subfunction 2 - set keyboard layout. =========
 1179 
========== Function 21, subfunction 2 - set keyboard layout. =========
1180 
======================================================================
 1180 
======================================================================
1181 
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
 1181 
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
1182 
which will be read by function 2.
 1182 
which will be read by function 2.
1183 
Parameters:
 1183 
Parameters:
1184 
  * eax = 21 - function number
 1184 
  * eax = 21 - function number
1185 
  * ebx = 2 - subfunction number
 1185 
  * ebx = 2 - subfunction number
1186 
  * ecx = which layout to set:
 1186 
  * ecx = which layout to set:
1187 
    * 1 = normal layout
 1187 
    * 1 = normal layout
1188 
    * 2 = layout at pressed Shift
 1188 
    * 2 = layout at pressed Shift
1189 
    * 3 = layout at pressed Alt
 1189 
    * 3 = layout at pressed Alt
1190 
  * edx = pointer to layout - table of length 128 bytes
 1190 
  * edx = pointer to layout - table of length 128 bytes
1191 
Or:
 1191 
Or:
1192 
  * ecx = 9
 1192 
  * ecx = 9
1193 
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
 1193 
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1194 
Returned value:
 1194 
Returned value:
1195 
  * eax = 0 - success
 1195 
  * eax = 0 - success
1196 
  * eax = 1 - incorrect parameter
 1196 
  * eax = 1 - incorrect parameter
1197 
Remarks:
 1197 
Remarks:
1198 
  * If Alt is pressed, the layout with Alt is used;
 1198 
  * If Alt is pressed, the layout with Alt is used;
1199 
    if Alt is not pressed, but Shift is pressed,
 1199 
    if Alt is not pressed, but Shift is pressed,
1200 
    the layout with Shift is used;
 1200 
    the layout with Shift is used;
1201 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
 1201 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1202 
    layout is used and then from the code is subtracted 0x60;
 1202 
    layout is used and then from the code is subtracted 0x60;
1203 
    if no control key is pressed, the normal layout is used.
 1203 
    if no control key is pressed, the normal layout is used.
1204 
  * To get layout and country identifier use
 1204 
  * To get layout and country identifier use
1205 
    subfunction 2 of function 26.
 1205 
    subfunction 2 of function 26.
1206 
  * Country identifier is global system variable, which is not used
 1206 
  * Country identifier is global system variable, which is not used
1207 
    by the kernel itself; however the application '@panel' displays
 1207 
    by the kernel itself; however the application '@panel' displays
1208 
    the corresponding icon.
 1208 
    the corresponding icon.
1209 
  * The application @panel switches layouts on user request.
 1209 
  * The application @panel switches layouts on user request.
1210 
 
 1210 
 
1211 
======================================================================
 1211 
======================================================================
1212 
============== Function 21, subfunction 3 - set CD base. =============
 1212 
============== Function 21, subfunction 3 - set CD base. =============
1213 
======================================================================
 1213 
======================================================================
1214 
Parameters:
 1214 
Parameters:
1215 
  * eax = 21 - function number
 1215 
  * eax = 21 - function number
1216 
  * ebx = 3 - subfunction number
 1216 
  * ebx = 3 - subfunction number
1217 
  * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1217 
  * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1218 
Returned value:
 1218 
Returned value:
1219 
  * eax = 0
 1219 
  * eax = 0
1220 
Remarks:
 1220 
Remarks:
1221 
  * CD base is used by function 24.
 1221 
  * CD base is used by function 24.
1222 
  * To get CD base use subfunction 3 of function 26.
 1222 
  * To get CD base use subfunction 3 of function 26.
1223 
 
 1223 
 
1224 
======================================================================
 1224 
======================================================================
1225 
========== Function 21, subfunction 5 - set system language. =========
 1225 
========== Function 21, subfunction 5 - set system language. =========
1226 
======================================================================
 1226 
======================================================================
1227 
Parameters:
 1227 
Parameters:
1228 
  * eax = 21 - function number
 1228 
  * eax = 21 - function number
1229 
  * ebx = 5 - subfunction number
 1229 
  * ebx = 5 - subfunction number
1230 
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
 1230 
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
1231 
Returned value:
 1231 
Returned value:
1232 
  * eax = 0
 1232 
  * eax = 0
1233 
Remarks:
 1233 
Remarks:
1234 
  * System language is global system variable and is not used
 1234 
  * System language is global system variable and is not used
1235 
    by the kernel itself, however application @panel draws the
 1235 
    by the kernel itself, however application @panel draws the
1236 
    appropriate icon.
 1236 
    appropriate icon.
1237 
  * Function does not check for correctness, as the kernel does not
 1237 
  * Function does not check for correctness, as the kernel does not
1238 
    use this variable.
 1238 
    use this variable.
1239 
  * To get system language use subfunction 5 of function 26.
 1239 
  * To get system language use subfunction 5 of function 26.
1240 
 
 1240 
 
1241 
======================================================================
 1241 
======================================================================
1242 
============== Function 21, subfunction 7 - set HD base. =============
 1242 
============== Function 21, subfunction 7 - set HD base. =============
1243 
======================================================================
 1243 
======================================================================
1244 
The HD base defines hard disk to write with usage of obsolete
 1244 
The HD base defines hard disk to write with usage of obsolete
1245 
syntax /HD in obsolete function 58; at usage of modern syntax
 1245 
syntax /HD in obsolete function 58; at usage of modern syntax
1246 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
 1246 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1247 
Parameters:
 1247 
Parameters:
1248 
  * eax = 21 - function number
 1248 
  * eax = 21 - function number
1249 
  * ebx = 7 - subfunction number
 1249 
  * ebx = 7 - subfunction number
1250 
  * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1250 
  * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1251 
Returned value:
 1251 
Returned value:
1252 
  * eax = 0
 1252 
  * eax = 0
1253 
Remarks:
 1253 
Remarks:
1254 
  * Any application at any time can change the base.
 1254 
  * Any application at any time can change the base.
1255 
  * Do not change base, when any application works with hard disk.
 1255 
  * Do not change base, when any application works with hard disk.
1256 
    If you do not want system bugs.
 1256 
    If you do not want system bugs.
1257 
  * To get HD base use subfunction 7 of function 26.
 1257 
  * To get HD base use subfunction 7 of function 26.
1258 
  * It is also necessary to define used partition of hard disk by
 1258 
  * It is also necessary to define used partition of hard disk by
1259 
    subfunction 8.
 1259 
    subfunction 8.
1260 
 
 1260 
 
1261 
======================================================================
 1261 
======================================================================
1262 
========= Function 21, subfunction 8 - set used HD partition. ========
 1262 
========= Function 21, subfunction 8 - set used HD partition. ========
1263 
======================================================================
 1263 
======================================================================
1264 
The HD partition defines partition of the hard disk to write with
 1264 
The HD partition defines partition of the hard disk to write with
1265 
usage of obsolete syntax /HD and obsolete function 58;
 1265 
usage of obsolete syntax /HD and obsolete function 58;
1266 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
 1266 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1267 
base and partition are set automatically.
 1267 
base and partition are set automatically.
1268 
Parameters:
 1268 
Parameters:
1269 
  * eax = 21 - function number
 1269 
  * eax = 21 - function number
1270 
  * ebx = 8 - subfunction number
 1270 
  * ebx = 8 - subfunction number
1271 
  * ecx = HD partition (beginning from 1)
 1271 
  * ecx = HD partition (beginning from 1)
1272 
Return value:
 1272 
Return value:
1273 
  * eax = 0
 1273 
  * eax = 0
1274 
Remarks:
 1274 
Remarks:
1275 
  * Any application at any time can change partition.
 1275 
  * Any application at any time can change partition.
1276 
  * Do not change partition when any application works with hard disk.
 1276 
  * Do not change partition when any application works with hard disk.
1277 
    If you do not want system bugs.
 1277 
    If you do not want system bugs.
1278 
  * To get used partition use subfunction 8 of function 26.
 1278 
  * To get used partition use subfunction 8 of function 26.
1279 
  * There is no correctness checks.
 1279 
  * There is no correctness checks.
1280 
  * To get the number of partitions of a hard disk use
 1280 
  * To get the number of partitions of a hard disk use
1281 
    subfunction 11 of function 18.
 1281 
    subfunction 11 of function 18.
1282 
  * It is also necessary to define used HD base by subfunction 7.
 1282 
  * It is also necessary to define used HD base by subfunction 7.
1283 
 
 1283 
 
1284 
======================================================================
 1284 
======================================================================
1285 
 Function 21, subfunction 11 - enable/disable low-level access to HD.
 1285 
 Function 21, subfunction 11 - enable/disable low-level access to HD.
1286 
======================================================================
 1286 
======================================================================
1287 
Parameters:
 1287 
Parameters:
1288 
  * eax = 21 - function number
 1288 
  * eax = 21 - function number
1289 
  * ebx = 11 - subfunction number
 1289 
  * ebx = 11 - subfunction number
1290 
  * ecx = 0/1 - disable/enable
 1290 
  * ecx = 0/1 - disable/enable
1291 
Returned value:
 1291 
Returned value:
1292 
  * eax = 0
 1292 
  * eax = 0
1293 
Remarks:
 1293 
Remarks:
1294 
  * Is used in LBA-read (subfunction 8 of function 58).
 1294 
  * Is used in LBA-read (subfunction 8 of function 58).
1295 
  * The current implementation uses only low bit of ecx.
 1295 
  * The current implementation uses only low bit of ecx.
1296 
  * To get current status use subfunction 11 of function 26.
 1296 
  * To get current status use subfunction 11 of function 26.
1297 
 
 1297 
 
1298 
======================================================================
 1298 
======================================================================
1299 
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
 1299 
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
1300 
======================================================================
 1300 
======================================================================
1301 
Parameters:
 1301 
Parameters:
1302 
  * eax = 21 - function number
 1302 
  * eax = 21 - function number
1303 
  * ebx = 12 - subfunction number
 1303 
  * ebx = 12 - subfunction number
1304 
  * ecx = 0/1 - disable/enable
 1304 
  * ecx = 0/1 - disable/enable
1305 
Returned value:
 1305 
Returned value:
1306 
  * eax = 0
 1306 
  * eax = 0
1307 
Remarks:
 1307 
Remarks:
1308 
  * Is used in operations with PCI bus (function 62).
 1308 
  * Is used in operations with PCI bus (function 62).
1309 
  * The current implementation uses only low bit of ecx.
 1309 
  * The current implementation uses only low bit of ecx.
1310 
  * To get current status use subfunction 12 of function 26.
 1310 
  * To get current status use subfunction 12 of function 26.
1311 
 
 1311 
 
1312 
======================================================================
 1312 
======================================================================
1313 
============ Function 21, subfunction 13, subsubfunction 1 ===========
 1313 
============ Function 21, subfunction 13, subsubfunction 1 ===========
1314 
======== Initialize + get information on the driver vmode.mdr. =======
 1314 
======== Initialize + get information on the driver vmode.mdr. =======
1315 
======================================================================
 1315 
======================================================================
1316 
Parameters:
 1316 
Parameters:
1317 
  * eax = 21 - function number
 1317 
  * eax = 21 - function number
1318 
  * ebx = 13 - subfunction number
 1318 
  * ebx = 13 - subfunction number
1319 
  * ecx = 1 - number of the driver function
 1319 
  * ecx = 1 - number of the driver function
1320 
  * edx = pointer to 512-bytes buffer
 1320 
  * edx = pointer to 512-bytes buffer
1321 
Returned value:
 1321 
Returned value:
1322 
  * if driver is not loaded
 1322 
  * if driver is not loaded
1323 
    (never happens in the current implementation):
 1323 
    (never happens in the current implementation):
1324 
    * eax = -1
 1324 
    * eax = -1
1325 
    * ebx, ecx destroyed
 1325 
    * ebx, ecx destroyed
1326 
  * if driver is loaded:
 1326 
  * if driver is loaded:
1327 
    * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high)
 1327 
    * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high)
1328 
      - signature
 1328 
      - signature
1329 
    * ebx = current frequency of the scanning (in Hz)
 1329 
    * ebx = current frequency of the scanning (in Hz)
1330 
    * ecx destroyed
 1330 
    * ecx destroyed
1331 
    * buffer pointed to by edx is filled
 1331 
    * buffer pointed to by edx is filled
1332 
Format of the buffer:
 1332 
Format of the buffer:
1333 
  * +0: 32*byte: driver name, "Trans VideoDriver"
 1333 
  * +0: 32*byte: driver name, "Trans VideoDriver"
1334 
    (without quotes, supplemented by spaces)
 1334 
    (without quotes, supplemented by spaces)
1335 
  * +32 = +0x20: dword: driver version (version x.y is encoded as
 1335 
  * +32 = +0x20: dword: driver version (version x.y is encoded as
1336 
    y*65536+x), for the current implementation is 1 (1.0)
 1336 
    y*65536+x), for the current implementation is 1 (1.0)
1337 
  * +36 = +0x24: 7*dword: reserved (0 in the current implementation)
 1337 
  * +36 = +0x24: 7*dword: reserved (0 in the current implementation)
1338 
  * +64 = +0x40: 32*word: list of supported videomodes (each word
 1338 
  * +64 = +0x40: 32*word: list of supported videomodes (each word
1339 
    is number of a videomode, after list itself there are zeroes)
 1339 
    is number of a videomode, after list itself there are zeroes)
1340 
  * +128 = +0x80: 32*(5*word): list of supported frequences of the
 1340 
  * +128 = +0x80: 32*(5*word): list of supported frequences of the
1341 
    scannings for videomodes: for each videomode listed in the
 1341 
    scannings for videomodes: for each videomode listed in the
1342 
    previous field up to 5 supported frequences are given
 1342 
    previous field up to 5 supported frequences are given
1343 
    (unused positions contain zeroes)
 1343 
    (unused positions contain zeroes)
1344 
Remarks:
 1344 
Remarks:
1345 
  * Function initializes the driver (if it is not initialized yet)
 1345 
  * Function initializes the driver (if it is not initialized yet)
1346 
    and must be called first, before others (otherwise they will do
 1346 
    and must be called first, before others (otherwise they will do
1347 
    nothing and return -1).
 1347 
    nothing and return -1).
1348 
  * The current implementation supports only one frequency
 1348 
  * The current implementation supports only one frequency
1349 
    of the scanning on videomode.
 1349 
    of the scanning on videomode.
1350 
 
 1350 
 
1351 
======================================================================
 1351 
======================================================================
1352 
============ Function 21, subfunction 13, subsubfunction 2 ===========
 1352 
============ Function 21, subfunction 13, subsubfunction 2 ===========
1353 
================ Get information on current videomode. ===============
 1353 
================ Get information on current videomode. ===============
1354 
======================================================================
 1354 
======================================================================
1355 
Parameters:
 1355 
Parameters:
1356 
  * eax = 21 - function number
 1356 
  * eax = 21 - function number
1357 
  * ebx = 13 - subfunction number
 1357 
  * ebx = 13 - subfunction number
1358 
  * ecx = 2 - number of the driver function
 1358 
  * ecx = 2 - number of the driver function
1359 
Returned value:
 1359 
Returned value:
1360 
  * eax = -1 - driver is not loaded or not initialized;
 1360 
  * eax = -1 - driver is not loaded or not initialized;
1361 
    ebx,ecx are destroyed
 1361 
    ebx,ecx are destroyed
1362 
  * eax = [width]*65536 + [height]
 1362 
  * eax = [width]*65536 + [height]
1363 
  * ebx = frequency of the vertical scanning (in Hz)
 1363 
  * ebx = frequency of the vertical scanning (in Hz)
1364 
  * ecx = number of current videomode
 1364 
  * ecx = number of current videomode
1365 
Remarks:
 1365 
Remarks:
1366 
  * Driver must be initialized by call to
 1366 
  * Driver must be initialized by call to
1367 
    driver function 1.
 1367 
    driver function 1.
1368 
  * If only screen sizes are required, it is more expedient to use
 1368 
  * If only screen sizes are required, it is more expedient to use
1369 
    function 14 taking into account that it
 1369 
    function 14 taking into account that it
1370 
    returns sizes on 1 less.
 1370 
    returns sizes on 1 less.
1371 
 
 1371 
 
1372 
======================================================================
 1372 
======================================================================
1373 
=== Function 21, subfunction 13, subsubfunction 3 - set videomode. ===
 1373 
=== Function 21, subfunction 13, subsubfunction 3 - set videomode. ===
1374 
======================================================================
 1374 
======================================================================
1375 
Parameters:
 1375 
Parameters:
1376 
  * eax = 21 - function number
 1376 
  * eax = 21 - function number
1377 
  * ebx = 13 - subfunction number
 1377 
  * ebx = 13 - subfunction number
1378 
  * ecx = 3 - number of the driver function
 1378 
  * ecx = 3 - number of the driver function
1379 
  * edx = [scanning frequency]*65536 + [videomode number]
 1379 
  * edx = [scanning frequency]*65536 + [videomode number]
1380 
Returned value:
 1380 
Returned value:
1381 
  * eax = -1 - driver is not loaded, not initialized or
 1381 
  * eax = -1 - driver is not loaded, not initialized or
1382 
    an error has occured
 1382 
    an error has occured
1383 
  * eax = 0 - success
 1383 
  * eax = 0 - success
1384 
  * ebx, ecx destroyed
 1384 
  * ebx, ecx destroyed
1385 
Remarks:
 1385 
Remarks:
1386 
  * Driver must be initialized by driver function 1.
 1386 
  * Driver must be initialized by driver function 1.
1387 
  * The videomode number and frequency must be in the table
 1387 
  * The videomode number and frequency must be in the table
1388 
    returned by driver function 1.
 1388 
    returned by driver function 1.
1389 
 
 1389 
 
1390 
======================================================================
 1390 
======================================================================
1391 
============ Function 21, subfunction 13, subsubfunction 4 ===========
 1391 
============ Function 21, subfunction 13, subsubfunction 4 ===========
1392 
================== Return to the initial videomode. ==================
 1392 
================== Return to the initial videomode. ==================
1393 
======================================================================
 1393 
======================================================================
1394 
Returns the screen to the videomode set at system boot.
 1394 
Returns the screen to the videomode set at system boot.
1395 
Parameters:
 1395 
Parameters:
1396 
  * eax = 21 - function number
 1396 
  * eax = 21 - function number
1397 
  * ebx = 13 - subfunction number
 1397 
  * ebx = 13 - subfunction number
1398 
  * ecx = 4 - number of the driver function
 1398 
  * ecx = 4 - number of the driver function
1399 
Returned value:
 1399 
Returned value:
1400 
  * eax = -1 - driver is not loaded or not initialized
 1400 
  * eax = -1 - driver is not loaded or not initialized
1401 
  * eax = 0 - success
 1401 
  * eax = 0 - success
1402 
  * ebx, ecx destroyed
 1402 
  * ebx, ecx destroyed
1403 
Remarks:
 1403 
Remarks:
1404 
  * Driver must be initialized by call to driver function 1.
 1404 
  * Driver must be initialized by call to driver function 1.
1405 
 
 1405 
 
1406 
======================================================================
 1406 
======================================================================
1407 
============ Function 21, subfunction 13, subsubfunction 5 ===========
 1407 
============ Function 21, subfunction 13, subsubfunction 5 ===========
1408 
===== Increase/decrease the size of the visible area of monitor. =====
 1408 
===== Increase/decrease the size of the visible area of monitor. =====
1409 
======================================================================
 1409 
======================================================================
1410 
Parameters:
 1410 
Parameters:
1411 
  * eax = 21 - function number
 1411 
  * eax = 21 - function number
1412 
  * ebx = 13 - subfunction number
 1412 
  * ebx = 13 - subfunction number
1413 
  * ecx = 5 - number of the driver function
 1413 
  * ecx = 5 - number of the driver function
1414 
  * edx = 0/1 - decrease/increase horizontal size on 1 position
 1414 
  * edx = 0/1 - decrease/increase horizontal size on 1 position
1415 
  * edx = 2/3 - is not supported in the current implementation;
 1415 
  * edx = 2/3 - is not supported in the current implementation;
1416 
    is planned as decrease/increase vertical size on 1 position
 1416 
    is planned as decrease/increase vertical size on 1 position
1417 
Returned value:
 1417 
Returned value:
1418 
  * eax = -1 - driver is not loaded or not initialized
 1418 
  * eax = -1 - driver is not loaded or not initialized
1419 
  * eax = 0 - success
 1419 
  * eax = 0 - success
1420 
  * ebx, ecx destroyed
 1420 
  * ebx, ecx destroyed
1421 
Remarks:
 1421 
Remarks:
1422 
  * Driver must be initialized by call to driver function 1.
 1422 
  * Driver must be initialized by call to driver function 1.
1423 
  * Function influences only the physical size of the screen image;
 1423 
  * Function influences only the physical size of the screen image;
1424 
    the logical size (number of pixels) does not change.
 1424 
    the logical size (number of pixels) does not change.
1425 
 
 1425 
 
1426 
======================================================================
 1426 
======================================================================
1427 
================= Function 22 - set system date/time. ================
 1427 
================= Function 22 - set system date/time. ================
1428 
======================================================================
 1428 
======================================================================
1429 
Parameters:
 1429 
Parameters:
1430 
  * eax = 22 - function number
 1430 
  * eax = 22 - function number
1431 
  * ebx = 0 - set time
 1431 
  * ebx = 0 - set time
1432 
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
 1432 
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
1433 
    * HH=hour 00..23
 1433 
    * HH=hour 00..23
1434 
    * MM=minute 00..59
 1434 
    * MM=minute 00..59
1435 
    * SS=second 00..59
 1435 
    * SS=second 00..59
1436 
  * ebx = 1 - set date
 1436 
  * ebx = 1 - set date
1437 
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
 1437 
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
1438 
    * DD=day 01..31
 1438 
    * DD=day 01..31
1439 
    * MM=month 01..12
 1439 
    * MM=month 01..12
1440 
    * YY=year 00..99
 1440 
    * YY=year 00..99
1441 
  * ebx = 2 - set day of week
 1441 
  * ebx = 2 - set day of week
1442 
    * ecx = 1 for Sunday, ..., 7 for Saturday
 1442 
    * ecx = 1 for Sunday, ..., 7 for Saturday
1443 
  * ebx = 3 - set alarm clock
 1443 
  * ebx = 3 - set alarm clock
1444 
    * ecx = 0x00SSMMHH
 1444 
    * ecx = 0x00SSMMHH
1445 
Returned value:
 1445 
Returned value:
1446 
  * eax = 0 - success
 1446 
  * eax = 0 - success
1447 
  * eax = 1 - incorrect parameter
 1447 
  * eax = 1 - incorrect parameter
1448 
  * eax = 2 - CMOS-battery was unloaded
 1448 
  * eax = 2 - CMOS-battery was unloaded
1449 
Remarks:
 1449 
Remarks:
1450 
  * Value of installation of day of week seems to be doubtful,
 1450 
  * Value of installation of day of week seems to be doubtful,
1451 
    as it a little where is used
 1451 
    as it a little where is used
1452 
    (day of week can be calculated by date).
 1452 
    (day of week can be calculated by date).
1453 
  * Alarm clock can be set on operation in the given time every day.
 1453 
  * Alarm clock can be set on operation in the given time every day.
1454 
    But there is no existing system function to disable it.
 1454 
    But there is no existing system function to disable it.
1455 
  * Operation of alarm clock consists in generation IRQ8.
 1455 
  * Operation of alarm clock consists in generation IRQ8.
1456 
  * Generally CMOS supports for alarm clock set of value 0xFF
 1456 
  * Generally CMOS supports for alarm clock set of value 0xFF
1457 
    as one of parameters and it means that the appropriate parameter
 1457 
    as one of parameters and it means that the appropriate parameter
1458 
    is ignored. But current implementation does not allow this
 1458 
    is ignored. But current implementation does not allow this
1459 
    (will return 1).
 1459 
    (will return 1).
1460 
  * Alarm clock is a global system resource; the set of
 1460 
  * Alarm clock is a global system resource; the set of
1461 
    an alarm clock cancels automatically the previous set.
 1461 
    an alarm clock cancels automatically the previous set.
1462 
    However, at moment no program uses it.
 1462 
    However, at moment no program uses it.
1463 
 
 1463 
 
1464 
======================================================================
 1464 
======================================================================
1465 
============= Function 23 - wait for event with timeout. =============
 1465 
============= Function 23 - wait for event with timeout. =============
1466 
======================================================================
 1466 
======================================================================
1467 
If the message queue is empty, waits for new message in the queue,
 1467 
If the message queue is empty, waits for new message in the queue,
1468 
but no more than given time. Then reads out a message from the queue.
 1468 
but no more than given time. Then reads out a message from the queue.
1469 
 
 1469 
 
1470 
Parameters:
 1470 
Parameters:
1471 
  * eax = 23 - function number
 1471 
  * eax = 23 - function number
1472 
  * ebx = timeout (in 1/100 of second)
 1472 
  * ebx = timeout (in 1/100 of second)
1473 
Returned value:
 1473 
Returned value:
1474 
  * eax = 0 - the message queue is empty
 1474 
  * eax = 0 - the message queue is empty
1475 
  * otherwise eax = event (see the list of events)
 1475 
  * otherwise eax = event (see the list of events)
1476 
Remarks:
 1476 
Remarks:
1477 
  * Only those events are taken into account, which enter into
 1477 
  * Only those events are taken into account, which enter into
1478 
    the mask set by function 40. By default it is
 1478 
    the mask set by function 40. By default it is
1479 
    redraw, key and button events.
 1479 
    redraw, key and button events.
1480 
  * To check for presence of a message in the queue use function 11.
 1480 
  * To check for presence of a message in the queue use function 11.
1481 
    To wait without timeout use function 10.
 1481 
    To wait without timeout use function 10.
1482 
  * Transmission ebx=0 results in immediate returning eax=0.
 1482 
  * Transmission ebx=0 results in immediate returning eax=0.
1483 
  * Current implementation returns immediately with eax=0,
 1483 
  * Current implementation returns immediately with eax=0,
1484 
    if the addition of ebx with the current value of time counter
 1484 
    if the addition of ebx with the current value of time counter
1485 
    makes 32-bit overflow.
 1485 
    makes 32-bit overflow.
1486 
 
 1486 
 
1487 
======================================================================
 1487 
======================================================================
1488 
======== Function 24, subfunction 1 - begin to play CD-audio. ========
 1488 
======== Function 24, subfunction 1 - begin to play CD-audio. ========
1489 
======================================================================
 1489 
======================================================================
1490 
Parameters:
 1490 
Parameters:
1491 
  * eax = 24 - function number
 1491 
  * eax = 24 - function number
1492 
  * ebx = 1 - subfunction number
 1492 
  * ebx = 1 - subfunction number
1493 
  * ecx = 0x00FRSSMM, where
 1493 
  * ecx = 0x00FRSSMM, where
1494 
    * MM = starting minute
 1494 
    * MM = starting minute
1495 
    * SS = starting second
 1495 
    * SS = starting second
1496 
    * FR = starting frame
 1496 
    * FR = starting frame
1497 
Returned value:
 1497 
Returned value:
1498 
  * eax = 0 - success
 1498 
  * eax = 0 - success
1499 
  * eax = 1 - CD base is not defined
 1499 
  * eax = 1 - CD base is not defined
1500 
Remarks:
 1500 
Remarks:
1501 
  * Previously CD base must be defined by the call to
 1501 
  * Previously CD base must be defined by the call to
1502 
    subfunction 3 of function 21.
 1502 
    subfunction 3 of function 21.
1503 
  * One second includes 75 frames, one minute includes 60 seconds.
 1503 
  * One second includes 75 frames, one minute includes 60 seconds.
1504 
  * The function is asynchronous (returns control, when play begins).
 1504 
  * The function is asynchronous (returns control, when play begins).
1505 
 
 1505 
 
1506 
======================================================================
 1506 
======================================================================
1507 
======= Function 24, subfunction 2 - get information on tracks. ======
 1507 
======= Function 24, subfunction 2 - get information on tracks. ======
1508 
======================================================================
 1508 
======================================================================
1509 
Parameters:
 1509 
Parameters:
1510 
  * eax = 24 - function number
 1510 
  * eax = 24 - function number
1511 
  * ebx = 2 - subfunction number
 1511 
  * ebx = 2 - subfunction number
1512 
  * ecx = pointer to the buffer for the table
 1512 
  * ecx = pointer to the buffer for the table
1513 
    (maximum 8*64h+4 bytes=100 tracks)
 1513 
    (maximum 8*64h+4 bytes=100 tracks)
1514 
Returned value:
 1514 
Returned value:
1515 
  * eax = 0 - success
 1515 
  * eax = 0 - success
1516 
  * eax = 1 - CD base is not defined
 1516 
  * eax = 1 - CD base is not defined
1517 
Remarks:
 1517 
Remarks:
1518 
  * The format of the table with tracks information is the same as
 1518 
  * The format of the table with tracks information is the same as
1519 
    for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h).
 1519 
    for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h).
1520 
    Function returns addresses in MSF.
 1520 
    Function returns addresses in MSF.
1521 
  * Previously CD base port must be set by call to
 1521 
  * Previously CD base port must be set by call to
1522 
    subfunction 3 of function 21.
 1522 
    subfunction 3 of function 21.
1523 
  * Function returns information only about no more than 100
 1523 
  * Function returns information only about no more than 100
1524 
    first tracks. In most cases it is enough.
 1524 
    first tracks. In most cases it is enough.
1525 
 
 1525 
 
1526 
======================================================================
 1526 
======================================================================
1527 
========== Function 24, subfunction 3 - stop play CD-audio. ==========
 1527 
========== Function 24, subfunction 3 - stop play CD-audio. ==========
1528 
======================================================================
 1528 
======================================================================
1529 
Parameters:
 1529 
Parameters:
1530 
  * eax = 24 - function number
 1530 
  * eax = 24 - function number
1531 
  * ebx = 1 - subfunction number
 1531 
  * ebx = 1 - subfunction number
1532 
Returned value:
 1532 
Returned value:
1533 
  * eax = 0 - success
 1533 
  * eax = 0 - success
1534 
  * eax = 1 - CD base is not defined
 1534 
  * eax = 1 - CD base is not defined
1535 
Remarks:
 1535 
Remarks:
1536 
  * Previously CD base port must be defined by call to
 1536 
  * Previously CD base port must be defined by call to
1537 
    subfunction 3 of function 21.
 1537 
    subfunction 3 of function 21.
1538 
 
 1538 
 
1539 
======================================================================
 1539 
======================================================================
1540 
======= Function 24, subfunction 4 - eject tray of disk drive. =======
 1540 
======= Function 24, subfunction 4 - eject tray of disk drive. =======
1541 
======================================================================
 1541 
======================================================================
1542 
Parameters:
 1542 
Parameters:
1543 
  * eax = 24 - function number
 1543 
  * eax = 24 - function number
1544 
  * ebx = 4 - subfunction number
 1544 
  * ebx = 4 - subfunction number
1545 
  * ecx = position of CD/DVD-drive
 1545 
  * ecx = position of CD/DVD-drive
1546 
      (from 0=Primary Master to 3=Secondary Slave)
 1546 
      (from 0=Primary Master to 3=Secondary Slave)
1547 
Returned value:
 1547 
Returned value:
1548 
  * function does not return value
 1548 
  * function does not return value
1549 
Remarks:
 1549 
Remarks:
1550 
  * The function is supported only for ATAPI devices (CD and DVD).
 1550 
  * The function is supported only for ATAPI devices (CD and DVD).
1551 
  * When the tray is being ejected,
 1551 
  * When the tray is being ejected,
1552 
    manual control of tray is unlocked.
 1552 
    manual control of tray is unlocked.
1553 
  * When the tray is being ejected, the code clears the cache for
 1553 
  * When the tray is being ejected, the code clears the cache for
1554 
    corresponding device.
 1554 
    corresponding device.
1555 
  * An example of usage of the function is the application CD_tray.
 1555 
  * An example of usage of the function is the application CD_tray.
1556 
 
 1556 
 
1557 
======================================================================
 1557 
======================================================================
1558 
======== Function 24, subfunction 5 - load tray of disk drive. =======
 1558 
======== Function 24, subfunction 5 - load tray of disk drive. =======
1559 
======================================================================
 1559 
======================================================================
1560 
Parameters:
 1560 
Parameters:
1561 
  * eax = 24 - function number
 1561 
  * eax = 24 - function number
1562 
  * ebx = 5 - subfunction number
 1562 
  * ebx = 5 - subfunction number
1563 
  * ecx = position of CD/DVD-drive
 1563 
  * ecx = position of CD/DVD-drive
1564 
      (from 0=Primary Master to 3=Secondary Slave)
 1564 
      (from 0=Primary Master to 3=Secondary Slave)
1565 
Returned value:
 1565 
Returned value:
1566 
  * function does not return value
 1566 
  * function does not return value
1567 
Remarks:
 1567 
Remarks:
1568 
  * The function is supported only for ATAPI devices (CD and DVD).
 1568 
  * The function is supported only for ATAPI devices (CD and DVD).
1569 
  * An example of usage of the function is the application CD_tray.
 1569 
  * An example of usage of the function is the application CD_tray.
1570 
 
 1570 
 
1571 
======================================================================
 1571 
======================================================================
1572 
======= Function 25 - put image area on the background layer. ========
 1572 
======= Function 25 - put image area on the background layer. ========
1573 
======================================================================
 1573 
======================================================================
1574 
Paramters:
 1574 
Paramters:
1575 
  * eax = 25 - function number
 1575 
  * eax = 25 - function number
1576 
  * ebx = pointer to the previously allocated memory area,
 1576 
  * ebx = pointer to the previously allocated memory area,
1577 
        where placed the source images in a format BBGGRRTTBBGGRRTT...
 1577 
        where placed the source images in a format BBGGRRTTBBGGRRTT...
1578 
  * ecx = [size on axis x]*65536 + [size on axis y]
 1578 
  * ecx = [size on axis x]*65536 + [size on axis y]
1579 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 1579 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1580 
Returned value:
 1580 
Returned value:
1581 
  * function does not return value
 1581 
  * function does not return value
1582 
Remarks:
 1582 
Remarks:
1583 
  * Coordinates of the image are coordinates of the upper left corner
 1583 
  * Coordinates of the image are coordinates of the upper left corner
1584 
    of the image relative to the screen.
 1584 
    of the image relative to the screen.
1585 
  * Size of the image in bytes is 4*xsize*ysize
 1585 
  * Size of the image in bytes is 4*xsize*ysize
1586 
  * TT - byte pointer of transparency, at current version:
 1586 
  * TT - byte pointer of transparency, at current version:
1587 
         1 to FF - opaque, 0 - transparent.
 1587 
         1 to FF - opaque, 0 - transparent.
1588 
  * The function places the image directly to LFB. It is not for
 1588 
  * The function places the image directly to LFB. It is not for
1589 
    background image f.15. Options f.15 to f.25 does not make sense.
 1589 
    background image f.15. Options f.15 to f.25 does not make sense.
1590 
 
 1590 
 
1591 
======================================================================
 1591 
======================================================================
1592 
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
 1592 
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
1593 
======================================================================
 1593 
======================================================================
1594 
Parameters:
 1594 
Parameters:
1595 
  * eax = 26 - function number
 1595 
  * eax = 26 - function number
1596 
  * ebx = 1 - subfunction number
 1596 
  * ebx = 1 - subfunction number
1597 
Returned value:
 1597 
Returned value:
1598 
  * eax = port number
 1598 
  * eax = port number
1599 
Parameters:
 1599 
Parameters:
1600 
  * To set base port use subfunction 1 of function 21.
 1600 
  * To set base port use subfunction 1 of function 21.
1601 
 
 1601 
 
1602 
======================================================================
 1602 
======================================================================
1603 
========== Function 26, subfunction 2 - get keyboard layout. =========
 1603 
========== Function 26, subfunction 2 - get keyboard layout. =========
1604 
======================================================================
 1604 
======================================================================
1605 
The keyboard layout is used to convert keyboard scancodes to
 1605 
The keyboard layout is used to convert keyboard scancodes to
1606 
ASCII-codes for function 2.
 1606 
ASCII-codes for function 2.
1607 
Parameters:
 1607 
Parameters:
1608 
  * eax = 26 - function number
 1608 
  * eax = 26 - function number
1609 
  * ebx = 2 - subfunction number
 1609 
  * ebx = 2 - subfunction number
1610 
  * ecx = what layout to get:
 1610 
  * ecx = what layout to get:
1611 
    * 1 = normal layout
 1611 
    * 1 = normal layout
1612 
    * 2 = layout with pressed Shift
 1612 
    * 2 = layout with pressed Shift
1613 
    * 3 = layout with pressed Alt
 1613 
    * 3 = layout with pressed Alt
1614 
  * edx = pointer to the 128-bytes buffer, where the layout will be
 1614 
  * edx = pointer to the 128-bytes buffer, where the layout will be
1615 
    copied
 1615 
    copied
1616 
Returned value:
 1616 
Returned value:
1617 
  * function does not return value
 1617 
  * function does not return value
1618 
Or:
 1618 
Or:
1619 
  * eax = 26 - function number
 1619 
  * eax = 26 - function number
1620 
  * ebx = 2 - subfunction number
 1620 
  * ebx = 2 - subfunction number
1621 
  * ecx = 9
 1621 
  * ecx = 9
1622 
Returned value:
 1622 
Returned value:
1623 
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
 1623 
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1624 
Remarks:
 1624 
Remarks:
1625 
  * If Alt is pressed, the layout with Alt is used;
 1625 
  * If Alt is pressed, the layout with Alt is used;
1626 
    if Alt is not pressed, but Shift is pressed,
 1626 
    if Alt is not pressed, but Shift is pressed,
1627 
    the layout with Shift is used;
 1627 
    the layout with Shift is used;
1628 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
 1628 
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1629 
    layout is used and then from the code is subtracted 0x60;
 1629 
    layout is used and then from the code is subtracted 0x60;
1630 
    if no control key is pressed, the normal layout is used.
 1630 
    if no control key is pressed, the normal layout is used.
1631 
  * To set layout and country identifier use
 1631 
  * To set layout and country identifier use
1632 
    subfunction 2 of function 21.
 1632 
    subfunction 2 of function 21.
1633 
  * Country identifier is global system variable, which is not used
 1633 
  * Country identifier is global system variable, which is not used
1634 
    by the kernel itself; however the application '@panel' displays
 1634 
    by the kernel itself; however the application '@panel' displays
1635 
    the corresponding icon (using this function).
 1635 
    the corresponding icon (using this function).
1636 
  * The application @panel switches layouts on user request.
 1636 
  * The application @panel switches layouts on user request.
1637 
 
 1637 
 
1638 
======================================================================
 1638 
======================================================================
1639 
============== Function 26, subfunction 3 - get CD base. =============
 1639 
============== Function 26, subfunction 3 - get CD base. =============
1640 
======================================================================
 1640 
======================================================================
1641 
Parameters:
 1641 
Parameters:
1642 
  * eax = 26 - function number
 1642 
  * eax = 26 - function number
1643 
  * ebx = 3 - subfunction number
 1643 
  * ebx = 3 - subfunction number
1644 
Returned value:
 1644 
Returned value:
1645 
  * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1645 
  * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1646 
Remarks:
 1646 
Remarks:
1647 
  * CD base is used by function 24.
 1647 
  * CD base is used by function 24.
1648 
  * To set CD base use subfunction 3 of function 21.
 1648 
  * To set CD base use subfunction 3 of function 21.
1649 
 
 1649 
 
1650 
======================================================================
 1650 
======================================================================
1651 
========== Function 26, subfunction 5 - get system language. =========
 1651 
========== Function 26, subfunction 5 - get system language. =========
1652 
======================================================================
 1652 
======================================================================
1653 
Parameters:
 1653 
Parameters:
1654 
  * eax = 26 - function number
 1654 
  * eax = 26 - function number
1655 
  * ebx = 5 - subfunction number
 1655 
  * ebx = 5 - subfunction number
1656 
Returned value:
 1656 
Returned value:
1657 
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
 1657 
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
1658 
Remarks:
 1658 
Remarks:
1659 
  * System language is global system variable and is not used
 1659 
  * System language is global system variable and is not used
1660 
    by the kernel itself, however application @panel draws the
 1660 
    by the kernel itself, however application @panel draws the
1661 
    appropriate icon (using this function).
 1661 
    appropriate icon (using this function).
1662 
  * To set system language use subfunction 5 of function 21.
 1662 
  * To set system language use subfunction 5 of function 21.
1663 
 
 1663 
 
1664 
======================================================================
 1664 
======================================================================
1665 
============== Function 26, subfunction 7 - get HD base. =============
 1665 
============== Function 26, subfunction 7 - get HD base. =============
1666 
======================================================================
 1666 
======================================================================
1667 
The HD base defines hard disk to write with usage of obsolete
 1667 
The HD base defines hard disk to write with usage of obsolete
1668 
syntax /HD in obsolete function 58; at usage of modern syntax
 1668 
syntax /HD in obsolete function 58; at usage of modern syntax
1669 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
 1669 
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1670 
Parameters:
 1670 
Parameters:
1671 
  * eax = 26 - function number
 1671 
  * eax = 26 - function number
1672 
  * ebx = 7 - subfunction number
 1672 
  * ebx = 7 - subfunction number
1673 
Returned value:
 1673 
Returned value:
1674 
  * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
 1674 
  * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1675 
Remarks:
 1675 
Remarks:
1676 
  * Any application in any time can change HD base.
 1676 
  * Any application in any time can change HD base.
1677 
  * To set base use subfunction 7 of function 21.
 1677 
  * To set base use subfunction 7 of function 21.
1678 
  * To get used partition of hard disk use subfunction 8.
 1678 
  * To get used partition of hard disk use subfunction 8.
1679 
 
 1679 
 
1680 
======================================================================
 1680 
======================================================================
1681 
========= Function 26, subfunction 8 - get used HD partition. ========
 1681 
========= Function 26, subfunction 8 - get used HD partition. ========
1682 
======================================================================
 1682 
======================================================================
1683 
The HD partition defines partition of the hard disk to write with
 1683 
The HD partition defines partition of the hard disk to write with
1684 
usage of obsolete syntax /HD in obsolete function 58;
 1684 
usage of obsolete syntax /HD in obsolete function 58;
1685 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
 1685 
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1686 
base and partition are set automatically.
 1686 
base and partition are set automatically.
1687 
Parameters:
 1687 
Parameters:
1688 
  * eax = 26 - function number
 1688 
  * eax = 26 - function number
1689 
  * ebx = 8 - subfunction number
 1689 
  * ebx = 8 - subfunction number
1690 
Returned value:
 1690 
Returned value:
1691 
  * eax = HD partition (beginning from 1)
 1691 
  * eax = HD partition (beginning from 1)
1692 
Remarks:
 1692 
Remarks:
1693 
  * Any application in any time can change partition.
 1693 
  * Any application in any time can change partition.
1694 
  * To set partition use subfunction 8 of function 21.
 1694 
  * To set partition use subfunction 8 of function 21.
1695 
  * To get number of partitions on a hard disk use
 1695 
  * To get number of partitions on a hard disk use
1696 
    subfunction 11 of function 18.
 1696 
    subfunction 11 of function 18.
1697 
  * To get base of used hard disk, use subfunction 7.
 1697 
  * To get base of used hard disk, use subfunction 7.
1698 
 
 1698 
 
1699 
======================================================================
 1699 
======================================================================
1700 
=== Function 26, subfunction 9 - get the value of the time counter. ==
 1700 
=== Function 26, subfunction 9 - get the value of the time counter. ==
1701 
======================================================================
 1701 
======================================================================
1702 
Parameters:
 1702 
Parameters:
1703 
  * eax = 26 - function number
 1703 
  * eax = 26 - function number
1704 
  * ebx = 9 - subfunction number
 1704 
  * ebx = 9 - subfunction number
1705 
Returned value:
 1705 
Returned value:
1706 
  * eax = number of 1/100s of second, past from the system boot time
 1706 
  * eax = number of 1/100s of second, past from the system boot time
1707 
Remarks:
 1707 
Remarks:
1708 
  * Counter takes modulo 2^32, that correspond to a little more
 1708 
  * Counter takes modulo 2^32, that correspond to a little more
1709 
    than 497 days.
 1709 
    than 497 days.
1710 
  * To get system time use function 3.
 1710 
  * To get system time use function 3.
1711 
 
 1711 
 
1712 
======================================================================
 1712 
======================================================================
1713 
===================== Function 26, subfunction 11 ====================
 1713 
===================== Function 26, subfunction 11 ====================
1714 
========== Find out whether low-level HD access is enabled. ==========
 1714 
========== Find out whether low-level HD access is enabled. ==========
1715 
======================================================================
 1715 
======================================================================
1716 
Parameters:
 1716 
Parameters:
1717 
  * eax = 26 - function number
 1717 
  * eax = 26 - function number
1718 
  * ebx = 11 - subfunction number
 1718 
  * ebx = 11 - subfunction number
1719 
Returned value:
 1719 
Returned value:
1720 
  * eax = 0/1 - disabled/enabled
 1720 
  * eax = 0/1 - disabled/enabled
1721 
Remarks:
 1721 
Remarks:
1722 
  * Is used in LBA read (subfunction 8 of function 58).
 1722 
  * Is used in LBA read (subfunction 8 of function 58).
1723 
  * To set current state use subfunction 11 of function 21.
 1723 
  * To set current state use subfunction 11 of function 21.
1724 
 
 1724 
 
1725 
======================================================================
 1725 
======================================================================
1726 
===================== Function 26, subfunction 12 ====================
 1726 
===================== Function 26, subfunction 12 ====================
1727 
========== Find out whether low-level PCI access is enabled. =========
 1727 
========== Find out whether low-level PCI access is enabled. =========
1728 
======================================================================
 1728 
======================================================================
1729 
Parameters:
 1729 
Parameters:
1730 
  * eax = 26 - function number
 1730 
  * eax = 26 - function number
1731 
  * ebx = 12 - subfunction number
 1731 
  * ebx = 12 - subfunction number
1732 
Returned value:
 1732 
Returned value:
1733 
  * eax = 0/1 - disabled/enabled
 1733 
  * eax = 0/1 - disabled/enabled
1734 
Remarks:
 1734 
Remarks:
1735 
  * Is used by operations with PCI bus (function 62).
 1735 
  * Is used by operations with PCI bus (function 62).
1736 
  * The current implementation uses only low bit of ecx.
 1736 
  * The current implementation uses only low bit of ecx.
1737 
  * To set the current state use subfunction 12 of function 21.
 1737 
  * To set the current state use subfunction 12 of function 21.
1738 
 
 1738 
 
1739 
======================================================================
 1739 
======================================================================
1740 
=================== Function 29 - get system date. ===================
 1740 
=================== Function 29 - get system date. ===================
1741 
======================================================================
 1741 
======================================================================
1742 
Parameters:
 1742 
Parameters:
1743 
  * eax = 29 - function number
 1743 
  * eax = 29 - function number
1744 
Returned value:
 1744 
Returned value:
1745 
  * eax = 0x00DDMMYY, where
 1745 
  * eax = 0x00DDMMYY, where
1746 
    (binary-decimal coding, BCD, is used)
 1746 
    (binary-decimal coding, BCD, is used)
1747 
  * YY = two low digits of year (00..99)
 1747 
  * YY = two low digits of year (00..99)
1748 
  * MM = month (01..12)
 1748 
  * MM = month (01..12)
1749 
  * DD = day (01..31)
 1749 
  * DD = day (01..31)
1750 
Remarks:
 1750 
Remarks:
1751 
  * To set system date use function 22.
 1751 
  * To set system date use function 22.
1752 
 
 1752 
 
1753 
======================================================================
 1753 
======================================================================
1754 
============= Function 30 - work with the current folder. ============
 1754 
============= Function 30 - work with the current folder. ============
1755 
======================================================================
 1755 
======================================================================
1756 
 
 1756 
 
1757 
--------- Subfunction 1 - set current folder for the thread. ---------
 1757 
--------- Subfunction 1 - set current folder for the thread. ---------
1758 
Parameters:
 1758 
Parameters:
1759 
  * eax = 30 - function number
 1759 
  * eax = 30 - function number
1760 
  * ebx = 1 - subfunction number
 1760 
  * ebx = 1 - subfunction number
1761 
  * ecx = pointer to ASCIIZ-string with the path to new current folder
 1761 
  * ecx = pointer to ASCIIZ-string with the path to new current folder
1762 
Returned value:
 1762 
Returned value:
1763 
  * function does not return value
 1763 
  * function does not return value
1764 
 
 1764 
 
1765 
--------- Subfunction 2 - get current folder for the thread. ---------
 1765 
--------- Subfunction 2 - get current folder for the thread. ---------
1766 
Parameters:
 1766 
Parameters:
1767 
  * eax = 30 - function number
 1767 
  * eax = 30 - function number
1768 
  * ebx = 2 - subfunction number
 1768 
  * ebx = 2 - subfunction number
1769 
  * ecx = pointer to buffer
 1769 
  * ecx = pointer to buffer
1770 
  * edx = size of buffer
 1770 
  * edx = size of buffer
1771 
Returned value:
 1771 
Returned value:
1772 
  * eax = size of the current folder's name (including terminating 0)
 1772 
  * eax = size of the current folder's name (including terminating 0)
1773 
Remarks:
 1773 
Remarks:
1774 
  * If the buffer is too small to hold all data, only first (edx-1)
 1774 
  * If the buffer is too small to hold all data, only first (edx-1)
1775 
    bytes are copied and than terminating 0 is inserted.
 1775 
    bytes are copied and than terminating 0 is inserted.
1776 
  * By default, current folder for the thread is "/rd/1".
 1776 
  * By default, current folder for the thread is "/rd/1".
1777 
  * At process/thread creation the current folder will be inherited
 1777 
  * At process/thread creation the current folder will be inherited
1778 
    from the parent.
 1778 
    from the parent.
1779 
 
 1779 
 
1780 
--- Subfunction 3 - install the add.system directory for the kernel --
 1780 
--- Subfunction 3 - install the add.system directory for the kernel --
1781 
Parameters:
 1781 
Parameters:
1782 
  * eax = 30 - function number
 1782 
  * eax = 30 - function number
1783 
  * ebx = 3 - subfunction number
 1783 
  * ebx = 3 - subfunction number
1784 
  * ecx = pointer to a block of data:
 1784 
  * ecx = pointer to a block of data:
1785 
          sysdir_name     rb 64
 1785 
          sysdir_name     rb 64
1786 
          sysdir_path     rb 64
 1786 
          sysdir_path     rb 64
1787 
For example:
 1787 
For example:
1788 
dir_name1       db 'KolibriOS',0
 1788 
dir_name1       db 'KolibriOS',0
1789 
                rb 64-10
 1789 
                rb 64-10
1790 
dir_path1       db 'HD0/1',0
 1790 
dir_path1       db 'HD0/1',0
1791 
                rb 64-6
 1791 
                rb 64-6
1792 
Returned value:
 1792 
Returned value:
1793 
  * function does not return value
 1793 
  * function does not return value
1794 
Remarks:
 1794 
Remarks:
1795 
  * The function can be called only 1 time for 1 session of the OS.
 1795 
  * The function can be called only 1 time for 1 session of the OS.
1796 
 
 1796 
 
1797 
======================================================================
 1797 
======================================================================
1798 
========= Function 34 - who owner the pixel on the screen. ===========
 1798 
========= Function 34 - who owner the pixel on the screen. ===========
1799 
======================================================================
 1799 
======================================================================
1800 
Parameters:
 1800 
Parameters:
1801 
  * eax = 34 - function number
 1801 
  * eax = 34 - function number
1802 
  * ebx = x-coordinate (relative to the display)
 1802 
  * ebx = x-coordinate (relative to the display)
1803 
  * ecx = y-coordinate (relative to the display)
 1803 
  * ecx = y-coordinate (relative to the display)
1804 
 
 1804 
 
1805 
Returned value:
 1805 
Returned value:
1806 
  * eax = 0x000000XX - owner of pixel the slot window N
 1806 
  * eax = 0x000000XX - owner of pixel the slot window N
1807 
    If incorrect values ebx and ecx then function returns 0
 1807 
    If incorrect values ebx and ecx then function returns 0
1808 
  * The function takes the value from the area [_WinMapAddress]
 1808 
  * The function takes the value from the area [_WinMapAddress]
1809 
 
 1809 
 
1810 
======================================================================
 1810 
======================================================================
1811 
======= Function 35 - read the color of a pixel on the screen. =======
 1811 
======= Function 35 - read the color of a pixel on the screen. =======
1812 
======================================================================
 1812 
======================================================================
1813 
Parameters:
 1813 
Parameters:
1814 
  * eax = 35
 1814 
  * eax = 35
1815 
  * ebx = y*xsize+x, where
 1815 
  * ebx = y*xsize+x, where
1816 
  * (x,y) = coordinates of a pixel (beginning from 0)
 1816 
  * (x,y) = coordinates of a pixel (beginning from 0)
1817 
  * xsize = horizontal screen size
 1817 
  * xsize = horizontal screen size
1818 
Returned value:
 1818 
Returned value:
1819 
  * eax = color 0x00RRGGBB
 1819 
  * eax = color 0x00RRGGBB
1820 
Remarks:
 1820 
Remarks:
1821 
  * To get screen sizes use function 14. Pay attention,
 1821 
  * To get screen sizes use function 14. Pay attention,
1822 
    that it subtracts 1 from both sizes.
 1822 
    that it subtracts 1 from both sizes.
1823 
  * There is also direct access (without any system calls)
 1823 
  * There is also direct access (without any system calls)
1824 
    to videomemory through the selector gs. To get parameters of
 1824 
    to videomemory through the selector gs. To get parameters of
1825 
    the current videomode, use function 61.
 1825 
    the current videomode, use function 61.
1826 
 
 1826 
 
1827 
======================================================================
 1827 
======================================================================
1828 
=================== Function 36 - read screen area. ==================
 1828 
=================== Function 36 - read screen area. ==================
1829 
======================================================================
 1829 
======================================================================
1830 
Paramters:
 1830 
Paramters:
1831 
  * eax = 36 - function number
 1831 
  * eax = 36 - function number
1832 
  * ebx = pointer to the previously allocated memory area,
 1832 
  * ebx = pointer to the previously allocated memory area,
1833 
        where will be placed the image in the format BBGGRRBBGGRR...
 1833 
        where will be placed the image in the format BBGGRRBBGGRR...
1834 
  * ecx = [size on axis x]*65536 + [size on axis y]
 1834 
  * ecx = [size on axis x]*65536 + [size on axis y]
1835 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 1835 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1836 
Returned value:
 1836 
Returned value:
1837 
  * function does not return value
 1837 
  * function does not return value
1838 
Remarks:
 1838 
Remarks:
1839 
  * Coordinates of the image are coordinates of the upper left corner
 1839 
  * Coordinates of the image are coordinates of the upper left corner
1840 
    of the image relative to the screen.
 1840 
    of the image relative to the screen.
1841 
  * Size of the image in bytes is 3*xsize*ysize.
 1841 
  * Size of the image in bytes is 3*xsize*ysize.
1842 
 
 1842 
 
1843 
======================================================================
 1843 
======================================================================
1844 
=================== Function 37 - work with mouse. ===================
 1844 
=================== Function 37 - work with mouse. ===================
1845 
======================================================================
 1845 
======================================================================
1846 
 
 1846 
 
1847 
---------- Subfunction 0 - screen coordinates of the mouse -----------
 1847 
---------- Subfunction 0 - screen coordinates of the mouse -----------
1848 
Parameters:
 1848 
Parameters:
1849 
  * eax = 37 - function number
 1849 
  * eax = 37 - function number
1850 
  * ebx = 0 - subfunction number
 1850 
  * ebx = 0 - subfunction number
1851 
Returned value:
 1851 
Returned value:
1852 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
 1852 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1853 
    (beginning from 0)
 1853 
    (beginning from 0)
1854 
 
 1854 
 
1855 
-- Subfunction 1 - coordinates of the mouse relative to the window ---
 1855 
-- Subfunction 1 - coordinates of the mouse relative to the window ---
1856 
Parameters:
 1856 
Parameters:
1857 
  * eax = 37 - function number
 1857 
  * eax = 37 - function number
1858 
  * ebx = 1 - subfunction number
 1858 
  * ebx = 1 - subfunction number
1859 
Returned value:
 1859 
Returned value:
1860 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
 1860 
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1861 
    relative to the application window (beginning from 0)
 1861 
    relative to the application window (beginning from 0)
1862 
Remarks:
 1862 
Remarks:
1863 
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
 1863 
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
1864 
    If y>=ywnd, the low word is non-negative and contains
 1864 
    If y>=ywnd, the low word is non-negative and contains
1865 
    relative y-coordinate, and the high word - relative x-coordinate
 1865 
    relative y-coordinate, and the high word - relative x-coordinate
1866 
    (with correct sign). Otherwise the low word is negative and still
 1866 
    (with correct sign). Otherwise the low word is negative and still
1867 
    contains relative y-coordinate, and to the high word
 1867 
    contains relative y-coordinate, and to the high word
1868 
    1 should be added.
 1868 
    1 should be added.
1869 
 
 1869 
 
1870 
------------ Subfunction 2 - pressed buttons of the mouse ------------
 1870 
------------ Subfunction 2 - pressed buttons of the mouse ------------
1871 
Parameters:
 1871 
Parameters:
1872 
  * eax = 37 - function number
 1872 
  * eax = 37 - function number
1873 
  * ebx = 2 - subfunction number
 1873 
  * ebx = 2 - subfunction number
1874 
Returned value:
 1874 
Returned value:
1875 
  * eax contains information on the pressed mouse buttons:
 1875 
  * eax contains information on the pressed mouse buttons:
1876 
  * bit 0 is set = left button is pressed
 1876 
  * bit 0 is set = left button is pressed
1877 
  * bit 1 is set = right button is pressed
 1877 
  * bit 1 is set = right button is pressed
1878 
  * bit 2 is set = middle button is pressed
 1878 
  * bit 2 is set = middle button is pressed
1879 
  * bit 3 is set = 4th button is pressed
 1879 
  * bit 3 is set = 4th button is pressed
1880 
  * bit 4 is set = 5th button is pressed
 1880 
  * bit 4 is set = 5th button is pressed
1881 
  * other bits are cleared
 1881 
  * other bits are cleared
1882 
 
 1882 
 
1883 
-------------------- Subfunction 4 - load cursor ---------------------
 1883 
-------------------- Subfunction 4 - load cursor ---------------------
1884 
Parameters:
 1884 
Parameters:
1885 
  * eax = 37 - function number
 1885 
  * eax = 37 - function number
1886 
  * ebx = 4 - subfunction number
 1886 
  * ebx = 4 - subfunction number
1887 
  * dx = data source:
 1887 
  * dx = data source:
1888 
  * dx = LOAD_FROM_FILE = 0 - data in a file
 1888 
  * dx = LOAD_FROM_FILE = 0 - data in a file
1889 
    * ecx = pointer to full path to the cursor file
 1889 
    * ecx = pointer to full path to the cursor file
1890 
    * the file must be in the format .cur, which is standard for
 1890 
    * the file must be in the format .cur, which is standard for
1891 
      MS Windows, at that of the size 32*32 pixels
 1891 
      MS Windows, at that of the size 32*32 pixels
1892 
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
 1892 
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
1893 
    * ecx = pointer to data of the cursor file
 1893 
    * ecx = pointer to data of the cursor file
1894 
    * the data format is the same as in the previous case
 1894 
    * the data format is the same as in the previous case
1895 
  * dx = LOAD_INDIRECT = 2 - data in memory
 1895 
  * dx = LOAD_INDIRECT = 2 - data in memory
1896 
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
 1896 
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
1897 
    * edx = 0xXXYY0002, where
 1897 
    * edx = 0xXXYY0002, where
1898 
      * XX = x-coordinate of cursor hotspot
 1898 
      * XX = x-coordinate of cursor hotspot
1899 
      * YY = y-coordinate
 1899 
      * YY = y-coordinate
1900 
      * 0 <= XX, YY <= 31
 1900 
      * 0 <= XX, YY <= 31
1901 
Returned value:
 1901 
Returned value:
1902 
  * eax = 0 - failed
 1902 
  * eax = 0 - failed
1903 
  * otherwise eax = cursor handle
 1903 
  * otherwise eax = cursor handle
1904 
 
 1904 
 
1905 
--------------------- Subfunction 5 - set cursor ---------------------
 1905 
--------------------- Subfunction 5 - set cursor ---------------------
1906 
Sets new cursor for the window of the current thread.
 1906 
Sets new cursor for the window of the current thread.
1907 
Parameters:
 1907 
Parameters:
1908 
  * eax = 37 - function number
 1908 
  * eax = 37 - function number
1909 
  * ebx = 5 - subfunction number
 1909 
  * ebx = 5 - subfunction number
1910 
  * ecx = cursor handle
 1910 
  * ecx = cursor handle
1911 
Returned value:
 1911 
Returned value:
1912 
  * eax = handle of previous cursor
 1912 
  * eax = handle of previous cursor
1913 
Remarks:
 1913 
Remarks:
1914 
  * If the handle is incorrect, the function restores the default
 1914 
  * If the handle is incorrect, the function restores the default
1915 
    cursor (standard arrow). In particular, ecx=0 restores it.
 1915 
    cursor (standard arrow). In particular, ecx=0 restores it.
1916 
 
 1916 
 
1917 
------------------- Subfunction 6 - delete cursor --------------------
 1917 
------------------- Subfunction 6 - delete cursor --------------------
1918 
Parameters:
 1918 
Parameters:
1919 
  * eax = 37 - function number
 1919 
  * eax = 37 - function number
1920 
  * ebx = 6 - subfunction number
 1920 
  * ebx = 6 - subfunction number
1921 
  * ecx = cursor handle
 1921 
  * ecx = cursor handle
1922 
Returned value:
 1922 
Returned value:
1923 
  * eax destroyed
 1923 
  * eax destroyed
1924 
Remarks:
 1924 
Remarks:
1925 
  * The cursor must be loaded previously by the current thread
 1925 
  * The cursor must be loaded previously by the current thread
1926 
    (with the call to subfunction 4). The function does not delete
 1926 
    (with the call to subfunction 4). The function does not delete
1927 
    system cursors and cursors, loaded by another applications.
 1927 
    system cursors and cursors, loaded by another applications.
1928 
  * If the active cursor (set by subfunction 5) is deleted,
 1928 
  * If the active cursor (set by subfunction 5) is deleted,
1929 
    the system restores the default cursor (standard arrow).
 1929 
    the system restores the default cursor (standard arrow).
1930 
 
 1930 
 
1931 
------------------ Subfunction 7 - get scroll data -------------------
 1931 
------------------ Subfunction 7 - get scroll data -------------------
1932 
Parameters:
 1932 
Parameters:
1933 
  * eax = 37 - function number
 1933 
  * eax = 37 - function number
1934 
  * ebx = 7 - subfunction number
 1934 
  * ebx = 7 - subfunction number
1935 
Returned value:
 1935 
Returned value:
1936 
  * eax = [horizontal offset]*65536 + [vertical offset]
 1936 
  * eax = [horizontal offset]*65536 + [vertical offset]
1937 
Remarks:
 1937 
Remarks:
1938 
  * Scroll data is available for active window only.
 1938 
  * Scroll data is available for active window only.
1939 
  * Values are zeroed after reading.
 1939 
  * Values are zeroed after reading.
1940 
  * Values are signed.
 1940 
  * Values are signed.
1941 
 
 1941 
 
1942 
======================================================================
 1942 
======================================================================
1943 
====================== Function 38 - draw line. ======================
 1943 
====================== Function 38 - draw line. ======================
1944 
======================================================================
 1944 
======================================================================
1945 
Parameters:
 1945 
Parameters:
1946 
  * eax = 38 - function number
 1946 
  * eax = 38 - function number
1947 
  * ebx = [start coordinate on axis x]*65536 +
 1947 
  * ebx = [start coordinate on axis x]*65536 +
1948 
              [end coordinate on axis x]
 1948 
              [end coordinate on axis x]
1949 
  * ecx = [start coordinate on axis y]*65536 +
 1949 
  * ecx = [start coordinate on axis y]*65536 +
1950 
              [end coordinate on axis y]
 1950 
              [end coordinate on axis y]
1951 
  * edx = 0x00RRGGBB - color
 1951 
  * edx = 0x00RRGGBB - color
1952 
    edx = 0x01xxxxxx - draw inversed line
 1952 
    edx = 0x01xxxxxx - draw inversed line
1953 
          (low 24 bits are ignored)
 1953 
          (low 24 bits are ignored)
1954 
Returned value:
 1954 
Returned value:
1955 
  * function does not return value
 1955 
  * function does not return value
1956 
Remarks:
 1956 
Remarks:
1957 
  * Coordinates are relative to the window.
 1957 
  * Coordinates are relative to the window.
1958 
  * End point is also drawn.
 1958 
  * End point is also drawn.
1959 
 
 1959 
 
1960 
======================================================================
 1960 
======================================================================
1961 
== Function 39, subfunction 1 - get a size of the background image. ==
 1961 
== Function 39, subfunction 1 - get a size of the background image. ==
1962 
======================================================================
 1962 
======================================================================
1963 
Parameters:
 1963 
Parameters:
1964 
  * eax = 39 - function number
 1964 
  * eax = 39 - function number
1965 
  * ebx = 1 - subfunction number
 1965 
  * ebx = 1 - subfunction number
1966 
Returned value:
 1966 
Returned value:
1967 
  * eax = [width]*65536 + [height]
 1967 
  * eax = [width]*65536 + [height]
1968 
Remarks:
 1968 
Remarks:
1969 
  * There is a pair function to set sizes of background image -
 1969 
  * There is a pair function to set sizes of background image -
1970 
    subfunction 1 of function 15. After which it is necessary,
 1970 
    subfunction 1 of function 15. After which it is necessary,
1971 
    of course, anew to define image.
 1971 
    of course, anew to define image.
1972 
 
 1972 
 
1973 
======================================================================
 1973 
======================================================================
1974 
== Function 39, subfunction 2 - get pixel from the background image. =
 1974 
== Function 39, subfunction 2 - get pixel from the background image. =
1975 
======================================================================
 1975 
======================================================================
1976 
Parameters:
 1976 
Parameters:
1977 
  * eax = 39 - function number
 1977 
  * eax = 39 - function number
1978 
  * ebx = 2 - subfunction number
 1978 
  * ebx = 2 - subfunction number
1979 
  * ecx = offset
 1979 
  * ecx = offset
1980 
Returned value:
 1980 
Returned value:
1981 
  * eax = 0x00RRGGBB - pixel color, if offset is valid
 1981 
  * eax = 0x00RRGGBB - pixel color, if offset is valid
1982 
    (less than 0x160000-16)
 1982 
    (less than 0x160000-16)
1983 
  * eax = 2 otherwise
 1983 
  * eax = 2 otherwise
1984 
Remarks:
 1984 
Remarks:
1985 
  * Do not rely on returned value for invalid offsets, it may be
 1985 
  * Do not rely on returned value for invalid offsets, it may be
1986 
    changed in future kernel versions.
 1986 
    changed in future kernel versions.
1987 
  * Offset for pixel with coordinates (x,y)
 1987 
  * Offset for pixel with coordinates (x,y)
1988 
    is calculated as (x+y*xsize)*3.
 1988 
    is calculated as (x+y*xsize)*3.
1989 
  * There is a pair function to set pixel on the background image -
 1989 
  * There is a pair function to set pixel on the background image -
1990 
    subfunction 2 of function 15.
 1990 
    subfunction 2 of function 15.
1991 
 
 1991 
 
1992 
======================================================================
 1992 
======================================================================
1993 
== Function 39, subfunction 4 - get drawing mode for the background. =
 1993 
== Function 39, subfunction 4 - get drawing mode for the background. =
1994 
======================================================================
 1994 
======================================================================
1995 
Parameters:
 1995 
Parameters:
1996 
  * eax = 39 - function number
 1996 
  * eax = 39 - function number
1997 
  * ebx = 4 - subfunction number
 1997 
  * ebx = 4 - subfunction number
1998 
Returned value:
 1998 
Returned value:
1999 
  * eax = 1 - tile
 1999 
  * eax = 1 - tile
2000 
  * eax = 2 - stretch
 2000 
  * eax = 2 - stretch
2001 
Remarks:
 2001 
Remarks:
2002 
  * There is a pair function to set drawing mode -
 2002 
  * There is a pair function to set drawing mode -
2003 
    subfunction 4 of function 15.
 2003 
    subfunction 4 of function 15.
2004 
 
 2004 
 
2005 
======================================================================
 2005 
======================================================================
2006 
=========== Function 40 - set the mask for expected events. ==========
 2006 
=========== Function 40 - set the mask for expected events. ==========
2007 
======================================================================
 2007 
======================================================================
2008 
The mask for expected events affects function working with events
 2008 
The mask for expected events affects function working with events
2009 
10, 11, 23 - they notify only about events allowed by this mask.
 2009 
10, 11, 23 - they notify only about events allowed by this mask.
2010 
Parameters:
 2010 
Parameters:
2011 
  * eax = 40 - function number
 2011 
  * eax = 40 - function number
2012 
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
 2012 
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
2013 
    (set bit permits notice on event)
 2013 
    (set bit permits notice on event)
2014 
    bit 31: mouse active/inactive filter
 2014 
    bit 31: mouse active/inactive filter
2015 
    bit 31 = 0 - inactive window receive mouse events
 2015 
    bit 31 = 0 - inactive window receive mouse events
2016 
    bit 31 = 1 - inactive window does not receive mouse events
 2016 
    bit 31 = 1 - inactive window does not receive mouse events
2017 
    bit 30: cursor position filter
 2017 
    bit 30: cursor position filter
2018 
    bit 30 = 0 = the window receive mouse events if cursor
 2018 
    bit 30 = 0 = the window receive mouse events if cursor
2019 
                 outside window
 2019 
                 outside window
2020 
    bit 30 = 1 - the window does not receive mouse events if cursor
 2020 
    bit 30 = 1 - the window does not receive mouse events if cursor
2021 
                 outside window
 2021 
                 outside window
2022 
Returned value:
 2022 
Returned value:
2023 
  * eax = previous value of mask
 2023 
  * eax = previous value of mask
2024 
Remarks:
 2024 
Remarks:
2025 
  * Default mask (7=111b) enables nofices about redraw,
 2025 
  * Default mask (7=111b) enables nofices about redraw,
2026 
    keys and buttons. This is enough for many applications.
 2026 
    keys and buttons. This is enough for many applications.
2027 
  * Events prohibited in the mask are saved anyway, when come;
 2027 
  * Events prohibited in the mask are saved anyway, when come;
2028 
    they are simply not informed with event functions.
 2028 
    they are simply not informed with event functions.
2029 
  * Event functions take into account the mask on moment of
 2029 
  * Event functions take into account the mask on moment of
2030 
    function call, not on moment of event arrival.
 2030 
    function call, not on moment of event arrival.
2031 
 
 2031 
 
2032 
 
 2032 
 
2033 
======================================================================
 2033 
======================================================================
2034 
================ Function 43 - input/output to a port. ===============
 2034 
================ Function 43 - input/output to a port. ===============
2035 
======================================================================
 2035 
======================================================================
2036 
 
 2036 
 
2037 
------------------------ Output data to port -------------------------
 2037 
------------------------ Output data to port -------------------------
2038 
Parameters:
 2038 
Parameters:
2039 
  * eax = 43 - function number
 2039 
  * eax = 43 - function number
2040 
  * bl = byte for output
 2040 
  * bl = byte for output
2041 
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
 2041 
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
2042 
Returned value:
 2042 
Returned value:
2043 
  * eax = 0 - success
 2043 
  * eax = 0 - success
2044 
  * eax = 1 - the thread has not reserved the selected port
 2044 
  * eax = 1 - the thread has not reserved the selected port
2045 
 
 2045 
 
2046 
------------------------ Input data from port ------------------------
 2046 
------------------------ Input data from port ------------------------
2047 
Parameters:
 2047 
Parameters:
2048 
  * eax = 43 - function number
 2048 
  * eax = 43 - function number
2049 
  * ebx is ignored
 2049 
  * ebx is ignored
2050 
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
 2050 
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
2051 
Returned value:
 2051 
Returned value:
2052 
  * eax = 0 - success, thus ebx = entered byte
 2052 
  * eax = 0 - success, thus ebx = entered byte
2053 
  * eax = 1 - the thread has not reserved the selected port
 2053 
  * eax = 1 - the thread has not reserved the selected port
2054 
Remarks:
 2054 
Remarks:
2055 
  * Previously the thread must reserve the selected port
 2055 
  * Previously the thread must reserve the selected port
2056 
    for itself by function 46.
 2056 
    for itself by function 46.
2057 
  * Instead of call to this function it is better to use
 2057 
  * Instead of call to this function it is better to use
2058 
    processor instructions in/out - this is much
 2058 
    processor instructions in/out - this is much
2059 
    faster and a bit shorter and easier.
 2059 
    faster and a bit shorter and easier.
2060 
 
 2060 
 
2061 
 
 2061 
 
2062 
======================================================================
 2062 
======================================================================
2063 
====== Function 46 - reserve/free a group of input/output ports. =====
 2063 
====== Function 46 - reserve/free a group of input/output ports. =====
2064 
======================================================================
 2064 
======================================================================
2065 
To work with reserved ports an application can access directly by
 2065 
To work with reserved ports an application can access directly by
2066 
commands in/out (recommended way) and can use function 43
 2066 
commands in/out (recommended way) and can use function 43
2067 
(not recommended way).
 2067 
(not recommended way).
2068 
Parameters:
 2068 
Parameters:
2069 
  * eax = 46 - function number
 2069 
  * eax = 46 - function number
2070 
  * ebx = 0 - reserve, 1 - free
 2070 
  * ebx = 0 - reserve, 1 - free
2071 
  * ecx = start port number
 2071 
  * ecx = start port number
2072 
  * edx = end port number (inclusive)
 2072 
  * edx = end port number (inclusive)
2073 
Returned value:
 2073 
Returned value:
2074 
  * eax = 0 - success
 2074 
  * eax = 0 - success
2075 
  * eax = 1 - error
 2075 
  * eax = 1 - error
2076 
Remarks:
 2076 
Remarks:
2077 
  * For ports reservation: an error occurs if and only if
 2077 
  * For ports reservation: an error occurs if and only if
2078 
    one from the following condition satisfies:
 2078 
    one from the following condition satisfies:
2079 
    * start port is more than end port;
 2079 
    * start port is more than end port;
2080 
    * the selected range contains incorrect port number
 2080 
    * the selected range contains incorrect port number
2081 
      (correct are from 0 to 0xFFFF);
 2081 
      (correct are from 0 to 0xFFFF);
2082 
    * limit for the total number of reserved areas is exceeded
 2082 
    * limit for the total number of reserved areas is exceeded
2083 
      (maximum 255 are allowed);
 2083 
      (maximum 255 are allowed);
2084 
    * the selected range intersects with any of earlier reserved
 2084 
    * the selected range intersects with any of earlier reserved
2085 
  * For ports free: an error is an attempt to free range,
 2085 
  * For ports free: an error is an attempt to free range,
2086 
    that was not earlier reserved by this function
 2086 
    that was not earlier reserved by this function
2087 
    (with same ecx,edx).
 2087 
    (with same ecx,edx).
2088 
  * If an error occurs (for both cases) function performs no action.
 2088 
  * If an error occurs (for both cases) function performs no action.
2089 
  * At booting the system reserves for itself ports
 2089 
  * At booting the system reserves for itself ports
2090 
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
 2090 
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
2091 
  * When a thread terminates, all reserved by it ports
 2091 
  * When a thread terminates, all reserved by it ports
2092 
    are freed automatically.
 2092 
    are freed automatically.
2093 
 
 2093 
 
2094 
======================================================================
 2094 
======================================================================
2095 
============= Function 47 - draw a number in the window. =============
 2095 
============= Function 47 - draw a number in the window. =============
2096 
======================================================================
 2096 
======================================================================
2097 
Parameters:
 2097 
Parameters:
2098 
  * eax = 47 - function number
 2098 
  * eax = 47 - function number
2099 
  * ebx = parameters of conversion number to text:
 2099 
  * ebx = parameters of conversion number to text:
2100 
    * bl = 0 - ecx contains number
 2100 
    * bl = 0 - ecx contains number
2101 
    * bl = 1 - ecx contains pointer to dword/qword-number
 2101 
    * bl = 1 - ecx contains pointer to dword/qword-number
2102 
    * bh = 0 - display in decimal number system
 2102 
    * bh = 0 - display in decimal number system
2103 
    * bh = 1 - display in hexadecimal system
 2103 
    * bh = 1 - display in hexadecimal system
2104 
    * bh = 2 - display in binary system
 2104 
    * bh = 2 - display in binary system
2105 
    * bits 16-21 = how many digits to display
 2105 
    * bits 16-21 = how many digits to display
2106 
    * bits 22-29 reserved and must be set to 0
 2106 
    * bits 22-29 reserved and must be set to 0
2107 
    * bit 30 set = display qword (64-bit) number (must be bl=1)
 2107 
    * bit 30 set = display qword (64-bit) number (must be bl=1)
2108 
    * bit 31 set = do not display leading zeroes of the number
 2108 
    * bit 31 set = do not display leading zeroes of the number
2109 
  * ecx = number (if bl=0) or pointer (if bl=1)
 2109 
  * ecx = number (if bl=0) or pointer (if bl=1)
2110 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 2110 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
2111 
  * esi = 0xX0RRGGBB:
 2111 
  * esi = 0xX0RRGGBB:
2112 
    * RR, GG, BB specify the color
 2112 
    * RR, GG, BB specify the color
2113 
    * X = ABnn (bits)
 2113 
    * X = ABnn (bits)
2114 
    * nn = font (0/1)
 2114 
    * nn = font (0/1)
2115 
    * A is ignored
 2115 
    * A is ignored
2116 
    * B=1 - fill background with the color edi
 2116 
    * B=1 - fill background with the color edi
2117 
Returned value:
 2117 
Returned value:
2118 
  * function does not return value
 2118 
  * function does not return value
2119 
Remarks:
 2119 
Remarks:
2120 
  * The given length must not exceed 60.
 2120 
  * The given length must not exceed 60.
2121 
  * The exactly given amount of digits is output. If number is small
 2121 
  * The exactly given amount of digits is output. If number is small
2122 
    and can be written by smaller amount of digits, it is supplemented
 2122 
    and can be written by smaller amount of digits, it is supplemented
2123 
    by leading zeroes; if the number is big and can not be written by
 2123 
    by leading zeroes; if the number is big and can not be written by
2124 
    given amount of digits, extra digits are not drawn.
 2124 
    given amount of digits, extra digits are not drawn.
2125 
  * Parameters of fonts are shown in the description of function 4
 2125 
  * Parameters of fonts are shown in the description of function 4
2126 
    (text output).
 2126 
    (text output).
2127 
 
 2127 
 
2128 
======================================================================
 2128 
======================================================================
2129 
========= Function 48, subfunction 0 - apply screen settings. ========
 2129 
========= Function 48, subfunction 0 - apply screen settings. ========
2130 
======================================================================
 2130 
======================================================================
2131 
Parameters:
 2131 
Parameters:
2132 
  * eax = 48 - function number
 2132 
  * eax = 48 - function number
2133 
  * ebx = 0 - subfunction number
 2133 
  * ebx = 0 - subfunction number
2134 
  * ecx = 0 - reserved
 2134 
  * ecx = 0 - reserved
2135 
Returned value:
 2135 
Returned value:
2136 
  * function does not return value
 2136 
  * function does not return value
2137 
Remarks:
 2137 
Remarks:
2138 
  * Function redraws the screen after parameters change by
 2138 
  * Function redraws the screen after parameters change by
2139 
    subfunctions 1 and 2.
 2139 
    subfunctions 1 and 2.
2140 
  * Function call without prior call to one of indicated subfunctions
 2140 
  * Function call without prior call to one of indicated subfunctions
2141 
    is ignored.
 2141 
    is ignored.
2142 
  * Function call with nonzero ecx is ignored.
 2142 
  * Function call with nonzero ecx is ignored.
2143 
 
 2143 
 
2144 
======================================================================
 2144 
======================================================================
2145 
=========== Function 48, subfunction 1 - set button style. ===========
 2145 
=========== Function 48, subfunction 1 - set button style. ===========
2146 
======================================================================
 2146 
======================================================================
2147 
Parameters:
 2147 
Parameters:
2148 
  * eax = 48 - function number
 2148 
  * eax = 48 - function number
2149 
  * ebx = 1 - subfunction number
 2149 
  * ebx = 1 - subfunction number
2150 
  * ecx = button style:
 2150 
  * ecx = button style:
2151 
    * 0 = flat
 2151 
    * 0 = flat
2152 
    * 1 = 3d
 2152 
    * 1 = 3d
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 
  * Button style influences only to their draw of function 8.
 2158 
  * Button style influences only to their draw of function 8.
2159 
 
 2159 
 
2160 
======================================================================
 2160 
======================================================================
2161 
====== Function 48, subfunction 2 - set standard window colors. ======
 2161 
====== Function 48, subfunction 2 - set standard window colors. ======
2162 
======================================================================
 2162 
======================================================================
2163 
Parameters:
 2163 
Parameters:
2164 
  * eax = 48 - function number
 2164 
  * eax = 48 - function number
2165 
  * ebx = 2 - subfunction number
 2165 
  * ebx = 2 - subfunction number
2166 
  * ecx = pointer to the color table
 2166 
  * ecx = pointer to the color table
2167 
  * edx = size of the color table
 2167 
  * edx = size of the color table
2168 
    (must be 40 bytes for future compatibility)
 2168 
    (must be 40 bytes for future compatibility)
2169 
Format of the color table is shown in description of subfunction 3.
 2169 
Format of the color table is shown in description of subfunction 3.
2170 
Returned value:
 2170 
Returned value:
2171 
  * function does not return value
 2171 
  * function does not return value
2172 
Remarks:
 2172 
Remarks:
2173 
  * After call to this function one should redraw the screen by
 2173 
  * After call to this function one should redraw the screen by
2174 
    subfunction 0.
 2174 
    subfunction 0.
2175 
  * Table of standard colors influences only to applications,
 2175 
  * Table of standard colors influences only to applications,
2176 
    which receive this table obviously (by subfunction 3)
 2176 
    which receive this table obviously (by subfunction 3)
2177 
    and use it (specifying colors from it to drawing functions).
 2177 
    and use it (specifying colors from it to drawing functions).
2178 
  * Table of standard colors is included in skin and is installed
 2178 
  * Table of standard colors is included in skin and is installed
2179 
    anew with skin installation (by subfunction 8).
 2179 
    anew with skin installation (by subfunction 8).
2180 
  * Color table can be viewed/changed interactively with
 2180 
  * Color table can be viewed/changed interactively with
2181 
    the application 'desktop'.
 2181 
    the application 'desktop'.
2182 
 
 2182 
 
2183 
======================================================================
 2183 
======================================================================
2184 
====== Function 48, subfunction 3 - get standard window colors. ======
 2184 
====== Function 48, subfunction 3 - get standard window colors. ======
2185 
======================================================================
 2185 
======================================================================
2186 
Parameters:
 2186 
Parameters:
2187 
  * eax = 48 - function number
 2187 
  * eax = 48 - function number
2188 
  * ebx = 3 - subfunction number
 2188 
  * ebx = 3 - subfunction number
2189 
  * ecx = pointer to the buffer with size edx bytes,
 2189 
  * ecx = pointer to the buffer with size edx bytes,
2190 
    where table will be written
 2190 
    where table will be written
2191 
  * edx = size of color table
 2191 
  * edx = size of color table
2192 
    (must be 40 bytes for future compatibility)
 2192 
    (must be 40 bytes for future compatibility)
2193 
Returned value:
 2193 
Returned value:
2194 
  * function does not return value
 2194 
  * function does not return value
2195 
Format of the color table:
 2195 
Format of the color table:
2196 
each item is dword-value for color 0x00RRGGBB
 2196 
each item is dword-value for color 0x00RRGGBB
2197 
  * +0: dword: frames - color of frame
 2197 
  * +0: dword: frames - color of frame
2198 
  * +4: dword: grab - color of header
 2198 
  * +4: dword: grab - color of header
2199 
  * +8: dword: grab_button - color of button on header bar
 2199 
  * +8: dword: grab_button - color of button on header bar
2200 
  * +12 = +0xC: dword: grab_button_text - color of text on button
 2200 
  * +12 = +0xC: dword: grab_button_text - color of text on button
2201 
    on header bar
 2201 
    on header bar
2202 
  * +16 = +0x10: dword: grab_text - color of text on header
 2202 
  * +16 = +0x10: dword: grab_text - color of text on header
2203 
  * +20 = +0x14: dword: work - color of working area
 2203 
  * +20 = +0x14: dword: work - color of working area
2204 
  * +24 = +0x18: dword: work_button - color of button in working area
 2204 
  * +24 = +0x18: dword: work_button - color of button in working area
2205 
  * +28 = +0x1C: dword: work_button_text - color of text on button
 2205 
  * +28 = +0x1C: dword: work_button_text - color of text on button
2206 
    in working area
 2206 
    in working area
2207 
  * +32 = +0x20: dword: work_text - color of text in working area
 2207 
  * +32 = +0x20: dword: work_text - color of text in working area
2208 
  * +36 = +0x24: dword: work_graph - color of graphics in working area
 2208 
  * +36 = +0x24: dword: work_graph - color of graphics in working area
2209 
Remarks:
 2209 
Remarks:
2210 
  * Structure of the color table is described in the standard
 2210 
  * Structure of the color table is described in the standard
2211 
    include file 'macros.inc' as 'system_colors'; for example,
 2211 
    include file 'macros.inc' as 'system_colors'; for example,
2212 
    it is possible to write:
 2212 
    it is possible to write:
2213 
    	sc	system_colors		; variable declaration
 2213 
    	sc	system_colors		; variable declaration
2214 
    	...				; somewhere one must call
 2214 
    	...				; somewhere one must call
2215 
    					; this function with ecx=sc
 2215 
    					; this function with ecx=sc
2216 
    	mov	ecx, [sc.work_button_text]	; read text color on
 2216 
    	mov	ecx, [sc.work_button_text]	; read text color on
2217 
    					; buttin in working area
 2217 
    					; buttin in working area
2218 
  * A program itself desides to use or not to use color table.
 2218 
  * A program itself desides to use or not to use color table.
2219 
    For usage program must simply at calls to drawing functions select
 2219 
    For usage program must simply at calls to drawing functions select
2220 
    color taken from the table.
 2220 
    color taken from the table.
2221 
  * At change of the table of standard colors (by subfunction 2 with
 2221 
  * At change of the table of standard colors (by subfunction 2 with
2222 
    the subsequent application of changes by subfunction 0 or
 2222 
    the subsequent application of changes by subfunction 0 or
2223 
    at skin set by subfunction 8) the system sends to all windows
 2223 
    at skin set by subfunction 8) the system sends to all windows
2224 
    redraw message (the event with code 1).
 2224 
    redraw message (the event with code 1).
2225 
  * Color table can be viewed/changed interactively with
 2225 
  * Color table can be viewed/changed interactively with
2226 
    the application 'desktop'.
 2226 
    the application 'desktop'.
2227 
 
 2227 
 
2228 
======================================================================
 2228 
======================================================================
2229 
============ Function 48, subfunction 4 - get skin height. ===========
 2229 
============ Function 48, subfunction 4 - get skin height. ===========
2230 
======================================================================
 2230 
======================================================================
2231 
Parameters:
 2231 
Parameters:
2232 
  * eax = 48 - function number
 2232 
  * eax = 48 - function number
2233 
  * ebx = 4 - subfunction number
 2233 
  * ebx = 4 - subfunction number
2234 
Returned value:
 2234 
Returned value:
2235 
  * eax = skin height
 2235 
  * eax = skin height
2236 
Remarks:
 2236 
Remarks:
2237 
  * Skin height is defined as the height of a header
 2237 
  * Skin height is defined as the height of a header
2238 
    of skinned windows.
 2238 
    of skinned windows.
2239 
  * See also general structure of window in the description
 2239 
  * See also general structure of window in the description
2240 
    of function 0.
 2240 
    of function 0.
2241 
 
 2241 
 
2242 
======================================================================
 2242 
======================================================================
2243 
======== Function 48, subfunction 5 - get screen working area. =======
 2243 
======== Function 48, subfunction 5 - get screen working area. =======
2244 
======================================================================
 2244 
======================================================================
2245 
Parameters:
 2245 
Parameters:
2246 
  * eax = 48 - function number
 2246 
  * eax = 48 - function number
2247 
  * ebx = 5 - subfunction number
 2247 
  * ebx = 5 - subfunction number
2248 
Returned value:
 2248 
Returned value:
2249 
  * eax = [left]*65536 + [right]
 2249 
  * eax = [left]*65536 + [right]
2250 
  * ebx = [top]*65536 + [bottom]
 2250 
  * ebx = [top]*65536 + [bottom]
2251 
Remarks:
 2251 
Remarks:
2252 
  * The screen working area defines position and coordinates of
 2252 
  * The screen working area defines position and coordinates of
2253 
    a maximized window.
 2253 
    a maximized window.
2254 
  * The screen working area in view of normal work is all screen
 2254 
  * The screen working area in view of normal work is all screen
2255 
    without system panel (the application '@panel').
 2255 
    without system panel (the application '@panel').
2256 
  * (left,top) are coordinates of the left upper corner,
 2256 
  * (left,top) are coordinates of the left upper corner,
2257 
    (right,bottom) are coordinates of the right lower one.
 2257 
    (right,bottom) are coordinates of the right lower one.
2258 
    Thus the size of working area on x axis can be calculated by
 2258 
    Thus the size of working area on x axis can be calculated by
2259 
    formula right-left+1, on y axis - by formula bottom-right+1.
 2259 
    formula right-left+1, on y axis - by formula bottom-right+1.
2260 
  * See also function 14,
 2260 
  * See also function 14,
2261 
    to get sizes of all screen.
 2261 
    to get sizes of all screen.
2262 
  * There is a pair function to set working area - subfunction 6.
 2262 
  * There is a pair function to set working area - subfunction 6.
2263 
 
 2263 
 
2264 
======================================================================
 2264 
======================================================================
2265 
======== Function 48, subfunction 6 - set screen working area. =======
 2265 
======== Function 48, subfunction 6 - set screen working area. =======
2266 
======================================================================
 2266 
======================================================================
2267 
Parameters:
 2267 
Parameters:
2268 
  * eax = 48 - function number
 2268 
  * eax = 48 - function number
2269 
  * ebx = 6 - subfunction number
 2269 
  * ebx = 6 - subfunction number
2270 
  * ecx = [left]*65536 + [right]
 2270 
  * ecx = [left]*65536 + [right]
2271 
  * edx = [top]*65536 + [bottom]
 2271 
  * edx = [top]*65536 + [bottom]
2272 
Returned value:
 2272 
Returned value:
2273 
  * function does not return value
 2273 
  * function does not return value
2274 
Remarks:
 2274 
Remarks:
2275 
  * The screen working area defines position and coordinates of
 2275 
  * The screen working area defines position and coordinates of
2276 
    a maximized window.
 2276 
    a maximized window.
2277 
  * This function is used only by the application '@panel',
 2277 
  * This function is used only by the application '@panel',
2278 
    which set working area to all screen without system panel.
 2278 
    which set working area to all screen without system panel.
2279 
  * (left,top) are coordinates of the left upper corner,
 2279 
  * (left,top) are coordinates of the left upper corner,
2280 
    (right,bottom) are coordinates of the right lower one.
 2280 
    (right,bottom) are coordinates of the right lower one.
2281 
    Thus the size of working area on x axis can be calculated by
 2281 
    Thus the size of working area on x axis can be calculated by
2282 
    formula right-left+1, on y axis - by formula bottom-right+1.
 2282 
    formula right-left+1, on y axis - by formula bottom-right+1.
2283 
  * If 'left'>='right', x-coordinate of working area is not changed.
 2283 
  * If 'left'>='right', x-coordinate of working area is not changed.
2284 
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
 2284 
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
2285 
    equal to screen width, 'right' will not be set.
 2285 
    equal to screen width, 'right' will not be set.
2286 
    Similarly on y axis.
 2286 
    Similarly on y axis.
2287 
  * See also function 14,
 2287 
  * See also function 14,
2288 
    to get sizes of all screen.
 2288 
    to get sizes of all screen.
2289 
  * There is a pair function to get working area - subfunction 5.
 2289 
  * There is a pair function to get working area - subfunction 5.
2290 
  * This function redraws the screen automatically,
 2290 
  * This function redraws the screen automatically,
2291 
    updating coordinates and sizes of maximized windows.
 2291 
    updating coordinates and sizes of maximized windows.
2292 
    The system sends to all windows redraw message (the event 1).
 2292 
    The system sends to all windows redraw message (the event 1).
2293 
 
 2293 
 
2294 
======================================================================
 2294 
======================================================================
2295 
=========== Function 48, subfunction 7 - get skin margins. ===========
 2295 
=========== Function 48, subfunction 7 - get skin margins. ===========
2296 
======================================================================
 2296 
======================================================================
2297 
Returns the area of a header of a skinned window, intended for
 2297 
Returns the area of a header of a skinned window, intended for
2298 
a text of a header.
 2298 
a text of a header.
2299 
Parameters:
 2299 
Parameters:
2300 
  * eax = 48 - function number
 2300 
  * eax = 48 - function number
2301 
  * ebx = 7 - subfunction number
 2301 
  * ebx = 7 - subfunction number
2302 
Returned value:
 2302 
Returned value:
2303 
  * eax = [left]*65536 + [right]
 2303 
  * eax = [left]*65536 + [right]
2304 
  * ebx = [top]*65536 + [bottom]
 2304 
  * ebx = [top]*65536 + [bottom]
2305 
Remarks:
 2305 
Remarks:
2306 
  * An application decides itself to use or not to use this function.
 2306 
  * An application decides itself to use or not to use this function.
2307 
  * It is recommended to take into account returned value
 2307 
  * It is recommended to take into account returned value
2308 
    of this function for choice of a place for drawing header text
 2308 
    of this function for choice of a place for drawing header text
2309 
    (by function 4) or a substitute of header text
 2309 
    (by function 4) or a substitute of header text
2310 
    (at the discretion of an application).
 2310 
    (at the discretion of an application).
2311 
 
 2311 
 
2312 
======================================================================
 2312 
======================================================================
2313 
============= Function 48, subfunction 8 - set used skin. ============
 2313 
============= Function 48, subfunction 8 - set used skin. ============
2314 
======================================================================
 2314 
======================================================================
2315 
Parameters:
 2315 
Parameters:
2316 
  * eax = 48 - function number
 2316 
  * eax = 48 - function number
2317 
  * ebx = 8 - subfunction number
 2317 
  * ebx = 8 - subfunction number
2318 
  * ecx = pointer to a block for function 58, in
 2318 
  * ecx = pointer to a block for function 58, in
2319 
    which the fields of intermediate buffer and file name are filled
 2319 
    which the fields of intermediate buffer and file name are filled
2320 
Returned value:
 2320 
Returned value:
2321 
  * eax = 0 - success
 2321 
  * eax = 0 - success
2322 
  * otherwise eax = file system error code; if file does not
 2322 
  * otherwise eax = file system error code; if file does not
2323 
    contain valid skin, function returns error 3
 2323 
    contain valid skin, function returns error 3
2324 
    (unknown file system).
 2324 
    (unknown file system).
2325 
Remarks:
 2325 
Remarks:
2326 
  * After successful skin loading the system sends to all windows
 2326 
  * After successful skin loading the system sends to all windows
2327 
    redraw message (the event 1).
 2327 
    redraw message (the event 1).
2328 
  * At booting the system reads skin from file 'default.skn'
 2328 
  * At booting the system reads skin from file 'default.skn'
2329 
    on ramdisk.
 2329 
    on ramdisk.
2330 
  * User can change the skin statically by creating hisself
 2330 
  * User can change the skin statically by creating hisself
2331 
    'default.skn' or dynamically with the application 'desktop'.
 2331 
    'default.skn' or dynamically with the application 'desktop'.
2332 
 
 2332 
 
2333 
======================================================================
 2333 
======================================================================
2334 
=========== Function 49 - Advanced Power Management (APM). ===========
 2334 
=========== Function 49 - Advanced Power Management (APM). ===========
2335 
======================================================================
 2335 
======================================================================
2336 
Parameters:
 2336 
Parameters:
2337 
  * eax = 49 - function number
 2337 
  * eax = 49 - function number
2338 
  * dx = number of the APM function
 2338 
  * dx = number of the APM function
2339 
    (analogue of ax in APM specification)
 2339 
    (analogue of ax in APM specification)
2340 
  * bx, cx = parameters of the APM function
 2340 
  * bx, cx = parameters of the APM function
2341 
Returned value:
 2341 
Returned value:
2342 
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
 2342 
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
2343 
    are set according to the APM specification
 2343 
    are set according to the APM specification
2344 
  * high halves of 32-bit registers eax, ebx, ecx,
 2344 
  * high halves of 32-bit registers eax, ebx, ecx,
2345 
    edx, esi, edi are destroyed
 2345 
    edx, esi, edi are destroyed
2346 
Remarks:
 2346 
Remarks:
2347 
  * APM 1.2 specification is described in the document
 2347 
  * APM 1.2 specification is described in the document
2348 
    "Advanced Power Management (APM) BIOS Specification"
 2348 
    "Advanced Power Management (APM) BIOS Specification"
2349 
    (Revision 1.2), available at
 2349 
    (Revision 1.2), available at
2350 
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
 2350 
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2351 
    besides it is included in famous Interrupt List by Ralf Brown
 2351 
    besides it is included in famous Interrupt List by Ralf Brown
2352 
    (http://www.pobox.com/~ralf/files.html,
 2352 
    (http://www.pobox.com/~ralf/files.html,
2353 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
 2353 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2354 
 
 2354 
 
2355 
======================================================================
 2355 
======================================================================
2356 
=================== Function 50 - set window shape. ==================
 2356 
=================== Function 50 - set window shape. ==================
2357 
======================================================================
 2357 
======================================================================
2358 
Normal windows have rectangular shape. This function can give to
 2358 
Normal windows have rectangular shape. This function can give to
2359 
a window any shape. The shape is given by a set of points inside
 2359 
a window any shape. The shape is given by a set of points inside
2360 
the base rectangle belonging to a window. Position and coordinates
 2360 
the base rectangle belonging to a window. Position and coordinates
2361 
of the base rectangle are set by function 0
 2361 
of the base rectangle are set by function 0
2362 
and changed by function 67.
 2362 
and changed by function 67.
2363 
 
 2363 
 
2364 
--------------------------- Set shape data ---------------------------
 2364 
--------------------------- Set shape data ---------------------------
2365 
Parameters:
 2365 
Parameters:
2366 
  * eax = 50 - function number
 2366 
  * eax = 50 - function number
2367 
  * ebx = 0 - subfunction number
 2367 
  * ebx = 0 - subfunction number
2368 
  * ecx = pointer to shape data (array of bytes 0/1)
 2368 
  * ecx = pointer to shape data (array of bytes 0/1)
2369 
Returned value:
 2369 
Returned value:
2370 
  * function does not return value
 2370 
  * function does not return value
2371 
 
 2371 
 
2372 
-------------------------- Set shape scale ---------------------------
 2372 
-------------------------- Set shape scale ---------------------------
2373 
Parameters:
 2373 
Parameters:
2374 
  * eax = 50 - function number
 2374 
  * eax = 50 - function number
2375 
  * ebx = 1 - subfunction number
 2375 
  * ebx = 1 - subfunction number
2376 
  * ecx sets a scale: each byte of data defines
 2376 
  * ecx sets a scale: each byte of data defines
2377 
    (2^scale)*(2^scale) pixels
 2377 
    (2^scale)*(2^scale) pixels
2378 
Returned value:
 2378 
Returned value:
2379 
  * function does not return value
 2379 
  * function does not return value
2380 
Remarks:
 2380 
Remarks:
2381 
  * Default scale is 0 (scale factor is 1). If in the shape data
 2381 
  * Default scale is 0 (scale factor is 1). If in the shape data
2382 
    one byte corresponds to one pixel, there is no necessity
 2382 
    one byte corresponds to one pixel, there is no necessity
2383 
    to set scale.
 2383 
    to set scale.
2384 
  * Let's designate xsize = window width (in pixels), ysize = height;
 2384 
  * Let's designate xsize = window width (in pixels), ysize = height;
2385 
    pay attention, that they are one pixel more than defined by
 2385 
    pay attention, that they are one pixel more than defined by
2386 
    functions 0, 67.
 2386 
    functions 0, 67.
2387 
  * On definition of scale xsize and ysize must be divisible
 2387 
  * On definition of scale xsize and ysize must be divisible
2388 
    on 2^scale.
 2388 
    on 2^scale.
2389 
  * Byte of data on offset 'a' must be 0/1 and defines belonging
 2389 
  * Byte of data on offset 'a' must be 0/1 and defines belonging
2390 
    to a window of square with the side 2^scale (if scale=0,
 2390 
    to a window of square with the side 2^scale (if scale=0,
2391 
    this is one pixel) and coordinates of the left upper corner
 2391 
    this is one pixel) and coordinates of the left upper corner
2392 
    (a mod (xsize shr scale), a div (xsize shr scale))
 2392 
    (a mod (xsize shr scale), a div (xsize shr scale))
2393 
  * Data size: (xsize shr scale)*(ysize shr scale).
 2393 
  * Data size: (xsize shr scale)*(ysize shr scale).
2394 
  * Data must be presented in the memory and not change
 2394 
  * Data must be presented in the memory and not change
2395 
    after set of shape.
 2395 
    after set of shape.
2396 
  * The system views the shape data at every window redraw by
 2396 
  * The system views the shape data at every window redraw by
2397 
    function 0.
 2397 
    function 0.
2398 
  * The call of subfunction 0 with NULL pointer results in return
 2398 
  * The call of subfunction 0 with NULL pointer results in return
2399 
    to the rectangular shape.
 2399 
    to the rectangular shape.
2400 
 
 2400 
 
2401 
======================================================================
 2401 
======================================================================
2402 
==================== Function 51 - create thread. ====================
 2402 
==================== Function 51 - create thread. ====================
2403 
======================================================================
 2403 
======================================================================
2404 
Parameters:
 2404 
Parameters:
2405 
  * eax = 51 - function number
 2405 
  * eax = 51 - function number
2406 
  * ebx = 1 - unique subfunction
 2406 
  * ebx = 1 - unique subfunction
2407 
  * ecx = address of thread entry point (starting eip)
 2407 
  * ecx = address of thread entry point (starting eip)
2408 
  * edx = pointer to thread stack (starting esp)
 2408 
  * edx = pointer to thread stack (starting esp)
2409 
Returned value:
 2409 
Returned value:
2410 
  * eax = -1 - error (there is too many threads)
 2410 
  * eax = -1 - error (there is too many threads)
2411 
  * otherwise eax = TID - thread identifier
 2411 
  * otherwise eax = TID - thread identifier
2412
2412
2413 
 
 2413 
 
2414 
======================================================================
 2414 
======================================================================
2415 
==================== Function 54, subfunction 0 ======================
 2415 
==================== Function 54, subfunction 0 ======================
2416 
============== Get the number of slots in the clipboard. =============
 2416 
============== Get the number of slots in the clipboard. =============
2417 
======================================================================
 2417 
======================================================================
2418 
Parameters:
 2418 
Parameters:
2419 
  * eax = 54 - function number
 2419 
  * eax = 54 - function number
2420 
  * ebx = 0 - subfunction number
 2420 
  * ebx = 0 - subfunction number
2421 
Returned value:
 2421 
Returned value:
2422 
  * eax = slots in the clipboard
 2422 
  * eax = slots in the clipboard
2423 
  * eax = -1 - main list area not found
 2423 
  * eax = -1 - main list area not found
2424 
 
 2424 
 
2425 
======================================================================
 2425 
======================================================================
2426 
==================== Function 54, subfunction 1 ======================
 2426 
==================== Function 54, subfunction 1 ======================
2427 
================= Read the data from the clipboard. ==================
 2427 
================= Read the data from the clipboard. ==================
2428 
======================================================================
 2428 
======================================================================
2429 
Parameters:
 2429 
Parameters:
2430 
  * eax = 54 - function number
 2430 
  * eax = 54 - function number
2431 
  * ebx = 1 - subfunction number
 2431 
  * ebx = 1 - subfunction number
2432 
  * eсx = slot number
 2432 
  * eсx = slot number
2433 
Returned value:
 2433 
Returned value:
2434 
  * eax = if successful - pointer to a memory with data
 2434 
  * eax = if successful - pointer to a memory with data
2435 
  * eax = 1 - error
 2435 
  * eax = 1 - error
2436 
  * eax = -1 - main list area not found
 2436 
  * eax = -1 - main list area not found
2437 
 
 2437 
 
2438 
======================================================================
 2438 
======================================================================
2439 
==================== Function 54, subfunction 2 ======================
 2439 
==================== Function 54, subfunction 2 ======================
2440 
================= Write the data to the clipboard. ===================
 2440 
================= Write the data to the clipboard. ===================
2441 
======================================================================
 2441 
======================================================================
2442 
Parameters:
 2442 
Parameters:
2443 
  * eax = 54 - function number
 2443 
  * eax = 54 - function number
2444 
  * ebx = 2 - subfunction number
 2444 
  * ebx = 2 - subfunction number
2445 
  * eсx = the number of bytes to be copied
 2445 
  * eсx = the number of bytes to be copied
2446 
  * edx = a pointer to a buffer for data to be copied
 2446 
  * edx = a pointer to a buffer for data to be copied
2447 
Returned value:
 2447 
Returned value:
2448 
  * eax = 0 - success
 2448 
  * eax = 0 - success
2449 
  * eax = 1 - error
 2449 
  * eax = 1 - error
2450 
  * eax = -1 - main list area not found
 2450 
  * eax = -1 - main list area not found
2451
2451
2452 
======================================================================
 2452 
======================================================================
2453 
===================== Function 54, subfunction 3 =====================
 2453 
===================== Function 54, subfunction 3 =====================
2454 
================ Delete the last slot in the clipboard ===============
 2454 
================ Delete the last slot in the clipboard ===============
2455 
======================================================================
 2455 
======================================================================
2456 
Parameters:
 2456 
Parameters:
2457 
  * eax = 54 - function number
 2457 
  * eax = 54 - function number
2458 
  * ebx = 3 - subfunction number
 2458 
  * ebx = 3 - subfunction number
2459 
Returned value:
 2459 
Returned value:
2460 
  * eax = 0 - success
 2460 
  * eax = 0 - success
2461 
  * eax = 1 - error
 2461 
  * eax = 1 - error
2462 
  * eax = -1 - main list area not found
 2462 
  * eax = -1 - main list area not found
2463
2463
2464 
======================================================================
 2464 
======================================================================
2465 
===================== Function 54, subfunction 4 =====================
 2465 
===================== Function 54, subfunction 4 =====================
2466 
===================== Alarm reset the lock buffer ====================
 2466 
===================== Alarm reset the lock buffer ====================
2467 
======================================================================
 2467 
======================================================================
2468 
Parameters:
 2468 
Parameters:
2469 
  * eax = 54 - function number
 2469 
  * eax = 54 - function number
2470 
  * ebx = 4 - subfunction number
 2470 
  * ebx = 4 - subfunction number
2471 
Returned value:
 2471 
Returned value:
2472 
  * eax = 0 - success
 2472 
  * eax = 0 - success
2473 
  * eax = -1 - main list area not found or no blocking
 2473 
  * eax = -1 - main list area not found or no blocking
2474 
Remarks:
 2474 
Remarks:
2475 
  * Used in exceptional cases, where no responsible or killed
 2475 
  * Used in exceptional cases, where no responsible or killed
2476 
    application blocked the clipboard operations.
 2476 
    application blocked the clipboard operations.
2477 
 
 2477 
 
2478 
======================================================================
 2478 
======================================================================
2479 
 Function 55, subfunction 55 - begin to play data on built-in speaker.
 2479 
 Function 55, subfunction 55 - begin to play data on built-in speaker.
2480 
======================================================================
 2480 
======================================================================
2481 
Parameters:
 2481 
Parameters:
2482 
  * eax = 55 - function number
 2482 
  * eax = 55 - function number
2483 
  * ebx = 55 - subfunction number
 2483 
  * ebx = 55 - subfunction number
2484 
  * esi = pointer to data
 2484 
  * esi = pointer to data
2485 
Returned value:
 2485 
Returned value:
2486 
  * eax = 0 - success
 2486 
  * eax = 0 - success
2487 
  * eax = 55 - error (speaker is off or busy)
 2487 
  * eax = 55 - error (speaker is off or busy)
2488 
Data is an array of items with variable length.
 2488 
Data is an array of items with variable length.
2489 
Format of each item is defined by first byte:
 2489 
Format of each item is defined by first byte:
2490 
  * 0 = end of data
 2490 
  * 0 = end of data
2491 
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
 2491 
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
2492 
    is defined by immediate value of frequency
 2492 
    is defined by immediate value of frequency
2493 
    * following word (2 bytes) contains frequency divider;
 2493 
    * following word (2 bytes) contains frequency divider;
2494 
      frequency is defined as 1193180/divider
 2494 
      frequency is defined as 1193180/divider
2495 
  * 0x81 = invalid
 2495 
  * 0x81 = invalid
2496 
  * 0x82..0xFF = note is defined by octave and number:
 2496 
  * 0x82..0xFF = note is defined by octave and number:
2497 
    * duration in 1/100 of second = (first byte)-0x81
 2497 
    * duration in 1/100 of second = (first byte)-0x81
2498 
    * there is one more byte;
 2498 
    * there is one more byte;
2499 
    * (second byte)=0xFF - delay
 2499 
    * (second byte)=0xFF - delay
2500 
    * otherwise it looks like a*0x10+b, where b=number of the note in
 2500 
    * otherwise it looks like a*0x10+b, where b=number of the note in
2501 
      an octave from 1 to 12, a=number of octave (beginning from 0)
 2501 
      an octave from 1 to 12, a=number of octave (beginning from 0)
2502 
Remarks:
 2502 
Remarks:
2503 
  * Speaker play can be disabled/enabled by
 2503 
  * Speaker play can be disabled/enabled by
2504 
    subfunction 8 of function 18.
 2504 
    subfunction 8 of function 18.
2505 
  * Function returns control, having informed the system
 2505 
  * Function returns control, having informed the system
2506 
    an information on request. Play itself goes independently from
 2506 
    an information on request. Play itself goes independently from
2507 
    the program.
 2507 
    the program.
2508 
  * The data must be kept in the memory at least up to the end
 2508 
  * The data must be kept in the memory at least up to the end
2509 
    of play.
 2509 
    of play.
2510 
 
 2510 
 
2511 
======================================================================
 2511 
======================================================================
2512 
======================= Function 57 - PCI BIOS. ======================
 2512 
======================= Function 57 - PCI BIOS. ======================
2513 
======================================================================
 2513 
======================================================================
2514 
Parameters:
 2514 
Parameters:
2515 
  * eax = 57 - function number
 2515 
  * eax = 57 - function number
2516 
  * ebp corresponds to al in PCI BIOS specification
 2516 
  * ebp corresponds to al in PCI BIOS specification
2517 
  * other registers are set according to PCI BIOS specification
 2517 
  * other registers are set according to PCI BIOS specification
2518 
Returned value:
 2518 
Returned value:
2519 
  * CF is undefined
 2519 
  * CF is undefined
2520 
  * other registers are set according to PCI BIOS specification
 2520 
  * other registers are set according to PCI BIOS specification
2521 
Remarks:
 2521 
Remarks:
2522 
  * Many effects of this function can be also achieved with
 2522 
  * Many effects of this function can be also achieved with
2523 
    corresponding subfunctions of function 62.
 2523 
    corresponding subfunctions of function 62.
2524 
  * The function calls PCI32 BIOS extension, documented e.g. in
 2524 
  * The function calls PCI32 BIOS extension, documented e.g. in
2525 
    http://alpha1.dyns.net/files/PCI/bios21.pdf.
 2525 
    http://alpha1.dyns.net/files/PCI/bios21.pdf.
2526 
  * If BIOS does not support this extension, its behavior is emulated
 2526 
  * If BIOS does not support this extension, its behavior is emulated
2527 
    (through kernel-mode analogues of subfunctions of function 62).
 2527 
    (through kernel-mode analogues of subfunctions of function 62).
2528 
 
 2528 
 
2529 
======================================================================
 2529 
======================================================================
2530 
================ Function 58 - work with file system. ================
 2530 
================ Function 58 - work with file system. ================
2531 
======================================================================
 2531 
======================================================================
2532 
Parameters:
 2532 
Parameters:
2533 
  * eax = 58
 2533 
  * eax = 58
2534 
  * ebx = pointer to the information structure
 2534 
  * ebx = pointer to the information structure
2535 
Returned value:
 2535 
Returned value:
2536 
  * eax = 0 - success; otherwise file system error code
 2536 
  * eax = 0 - success; otherwise file system error code
2537 
  * some subfunctions return value in other registers too
 2537 
  * some subfunctions return value in other registers too
2538 
General format of the information structure:
 2538 
General format of the information structure:
2539 
  * +0: dword: subfunction number
 2539 
  * +0: dword: subfunction number
2540 
  * +4: dword: number of block
 2540 
  * +4: dword: number of block
2541 
  * +8: dword: size
 2541 
  * +8: dword: size
2542 
  * +12 = +0xC: dword: pointer to data
 2542 
  * +12 = +0xC: dword: pointer to data
2543 
  * +16 = +0x10: dword: pointer to a memory for system operations
 2543 
  * +16 = +0x10: dword: pointer to a memory for system operations
2544 
    (4096 bytes)
 2544 
    (4096 bytes)
2545 
  * +20 = +0x14: n db: ASCIIZ-string with the file name
 2545 
  * +20 = +0x14: n db: ASCIIZ-string with the file name
2546 
Specifications - in documentation on the appropriate subfunction.
 2546 
Specifications - in documentation on the appropriate subfunction.
2547 
Filename is case-insensitive for latin letters, russian letters
 2547 
Filename is case-insensitive for latin letters, russian letters
2548 
must be capital.
 2548 
must be capital.
2549 
Format of filename:
 2549 
Format of filename:
2550 
/base/number/dir1/dir2/.../dirn/file,
 2550 
/base/number/dir1/dir2/.../dirn/file,
2551 
where /base/number identifies device, on which file is located:
 2551 
where /base/number identifies device, on which file is located:
2552 
one of
 2552 
one of
2553 
  * /RD/1 = /RAMDISK/1 to access ramdisk
 2553 
  * /RD/1 = /RAMDISK/1 to access ramdisk
2554 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
 2554 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
2555 
    /FD/2 = /FLOPPYDISK/2 to access second one
 2555 
    /FD/2 = /FLOPPYDISK/2 to access second one
2556 
  * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk
 2556 
  * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk
2557 
    (in this case base is defined by subfunction 7 of function 21),
 2557 
    (in this case base is defined by subfunction 7 of function 21),
2558 
    x - partition number (beginning from 1)
 2558 
    x - partition number (beginning from 1)
2559 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
 2559 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
2560 
    IDE0 (Primary Master), IDE1 (Primary Slave),
 2560 
    IDE0 (Primary Master), IDE1 (Primary Slave),
2561 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
 2561 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2562 
    x - partition number on the selected hard drive, varies from 1
 2562 
    x - partition number on the selected hard drive, varies from 1
2563 
    to 255 (on each hard drive the indexing starts from 1)
 2563 
    to 255 (on each hard drive the indexing starts from 1)
2564 
Remarks:
 2564 
Remarks:
2565 
  * In the first two cases it is also possible to use FIRST
 2565 
  * In the first two cases it is also possible to use FIRST
2566 
    instead of 1, SECOND instead of 2, but it is not recommended
 2566 
    instead of 1, SECOND instead of 2, but it is not recommended
2567 
    for convenience of transition to the future extensions.
 2567 
    for convenience of transition to the future extensions.
2568 
  * Limitation n<=39 is imposed.
 2568 
  * Limitation n<=39 is imposed.
2569 
  * Names of folders and file dir1,...,dirn,file must have the
 2569 
  * Names of folders and file dir1,...,dirn,file must have the
2570 
    format 8.3: name no more than 8 characters, dot, extension no
 2570 
    format 8.3: name no more than 8 characters, dot, extension no
2571 
    more than 3 characters. Trailing spaces are ignored, no other
 2571 
    more than 3 characters. Trailing spaces are ignored, no other
2572 
    spaces is allowed. If name occupies equally 8 characters,
 2572 
    spaces is allowed. If name occupies equally 8 characters,
2573 
    dot may be omitted (though it is not recommended to use this
 2573 
    dot may be omitted (though it is not recommended to use this
2574 
    feature for convenience of transition to the future extensions).
 2574 
    feature for convenience of transition to the future extensions).
2575 
  * This function does not support folders on ramdisk.
 2575 
  * This function does not support folders on ramdisk.
2576 
Examples:
 2576 
Examples:
2577 
  * '/RAMDISK/FIRST/KERNEL.ASM',0
 2577 
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2578 
    '/rd/1/kernel.asm',0
 2578 
    '/rd/1/kernel.asm',0
2579 
  * '/HD0/1/kernel.asm',0
 2579 
  * '/HD0/1/kernel.asm',0
2580 
  * '/hd0/1/menuet/pics/tanzania.bmp',0
 2580 
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2581 
Existing subfunctions:
 2581 
Existing subfunctions:
2582 
  * subfunction 0 - read file/folder
 2582 
  * subfunction 0 - read file/folder
2583 
  * subfunction 8 - LBA-read from device
 2583 
  * subfunction 8 - LBA-read from device
2584 
  * subfunction 15 - get file system information
 2584 
  * subfunction 15 - get file system information
2585 
 
 2585 
 
2586 
======================================================================
 2586 
======================================================================
2587 
=========== Function 58, subfunction 0 - read file/folder. ===========
 2587 
=========== Function 58, subfunction 0 - read file/folder. ===========
2588 
======================================================================
 2588 
======================================================================
2589 
Parameters:
 2589 
Parameters:
2590 
  * eax = 58
 2590 
  * eax = 58
2591 
  * ebx = pointer to the information structure
 2591 
  * ebx = pointer to the information structure
2592 
Format of the information structure:
 2592 
Format of the information structure:
2593 
  * +0: dword: 0 = subfunction number
 2593 
  * +0: dword: 0 = subfunction number
2594 
  * +4: dword: first block to read (beginning from 0)
 2594 
  * +4: dword: first block to read (beginning from 0)
2595 
  * +8: dword: amount of blocks to read
 2595 
  * +8: dword: amount of blocks to read
2596 
  * +12 = +0xC: dword: pointer to buffer for data
 2596 
  * +12 = +0xC: dword: pointer to buffer for data
2597 
  * +16 = +0x10: dword: pointer to buffer for system operations
 2597 
  * +16 = +0x10: dword: pointer to buffer for system operations
2598 
    (4096 bytes)
 2598 
    (4096 bytes)
2599 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 2599 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
2600 
    given in the general description
 2600 
    given in the general description
2601 
Returned value:
 2601 
Returned value:
2602 
  * eax = 0 - success, otherwise file system error code
 2602 
  * eax = 0 - success, otherwise file system error code
2603 
  * ebx = file size (in bytes) or -1=0xffffffff, if file was not found
 2603 
  * ebx = file size (in bytes) or -1=0xffffffff, if file was not found
2604 
Remarks:
 2604 
Remarks:
2605 
  * Block size is 512 bytes.
 2605 
  * Block size is 512 bytes.
2606 
  * This function is obsolete, for reading files use subfunction 0
 2606 
  * This function is obsolete, for reading files use subfunction 0
2607 
    of function 70, for reading folders - subfunction 1 of
 2607 
    of function 70, for reading folders - subfunction 1 of
2608 
    function 70.
 2608 
    function 70.
2609 
  * Function can read contents of a folder. Only FAT file system is
 2609 
  * Function can read contents of a folder. Only FAT file system is
2610 
    supported. The format of FAT-folder is described
 2610 
    supported. The format of FAT-folder is described
2611 
    in any FAT documentation.
 2611 
    in any FAT documentation.
2612 
  * Size of a folder is determined by size of FAT clusters chain.
 2612 
  * Size of a folder is determined by size of FAT clusters chain.
2613 
  * If file was ended before last requested block was read,
 2613 
  * If file was ended before last requested block was read,
2614 
    the function will read as many as it can, and after that return
 2614 
    the function will read as many as it can, and after that return
2615 
    eax=6 (EOF).
 2615 
    eax=6 (EOF).
2616 
  * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but
 2616 
  * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but
2617 
    in the first two cases the current implementation does not follow
 2617 
    in the first two cases the current implementation does not follow
2618 
    to the declared rules:
 2618 
    to the declared rules:
2619 
    for /rd/1:
 2619 
    for /rd/1:
2620 
    * if one want to read 0 blocks, function considers,
 2620 
    * if one want to read 0 blocks, function considers,
2621 
      that he requested 1;
 2621 
      that he requested 1;
2622 
    * if one requests more than 14 blocks or starting block is
 2622 
    * if one requests more than 14 blocks or starting block is
2623 
      not less than 14, function returns eax=5 (not found) and ebx=-1;
 2623 
      not less than 14, function returns eax=5 (not found) and ebx=-1;
2624 
    * size of ramdisk root folder is 14 blocks,
 2624 
    * size of ramdisk root folder is 14 blocks,
2625 
      0x1C00=7168 bytes; but function returns ebx=0
 2625 
      0x1C00=7168 bytes; but function returns ebx=0
2626 
      (except of the case of previous item);
 2626 
      (except of the case of previous item);
2627 
    * strangely enough, it is possible to read 14th block (which
 2627 
    * strangely enough, it is possible to read 14th block (which
2628 
      generally contains a garbage - I remind, the indexing begins
 2628 
      generally contains a garbage - I remind, the indexing begins
2629 
      from 0);
 2629 
      from 0);
2630 
    * if some block with the number not less than 14 was requested,
 2630 
    * if some block with the number not less than 14 was requested,
2631 
      function returns eax=6(EOF); otherwise eax=0.
 2631 
      function returns eax=6(EOF); otherwise eax=0.
2632 
    For /fd/x:
 2632 
    For /fd/x:
2633 
    * if the start block is not less than 14, function returns
 2633 
    * if the start block is not less than 14, function returns
2634 
      eax=5 (not found) and ebx=0;
 2634 
      eax=5 (not found) and ebx=0;
2635 
    * note that format of FAT12 allows floppies with the root size
 2635 
    * note that format of FAT12 allows floppies with the root size
2636 
      more or less than 14 blocks;
 2636 
      more or less than 14 blocks;
2637 
    * check for length is not performed;
 2637 
    * check for length is not performed;
2638 
    * if data was successful read, function returns
 2638 
    * if data was successful read, function returns
2639 
      eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1.
 2639 
      eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1.
2640 
  * The function handles reading of special folders /,/rd,/fd,/hd[n];
 2640 
  * The function handles reading of special folders /,/rd,/fd,/hd[n];
2641 
    but the result does not correspond to expected (on operations with
 2641 
    but the result does not correspond to expected (on operations with
2642 
    normal files/folders), does not follow the declared rules,
 2642 
    normal files/folders), does not follow the declared rules,
2643 
    may be changed in future versions of the kernel and consequently
 2643 
    may be changed in future versions of the kernel and consequently
2644 
    is not described. To obtain the information about the equipment
 2644 
    is not described. To obtain the information about the equipment
2645 
    use subfunction 11 of function 18 or
 2645 
    use subfunction 11 of function 18 or
2646 
    read corresponding folder with subfunction 1 of function 70.
 2646 
    read corresponding folder with subfunction 1 of function 70.
2647 
 
 2647 
 
2648 
======================================================================
 2648 
======================================================================
2649 
========= Function 58, subfunction 8 - LBA-read from device. =========
 2649 
========= Function 58, subfunction 8 - LBA-read from device. =========
2650 
======================================================================
 2650 
======================================================================
2651 
Parameters:
 2651 
Parameters:
2652 
  * eax = 58 - function number
 2652 
  * eax = 58 - function number
2653 
  * ebx = pointer to the information structure
 2653 
  * ebx = pointer to the information structure
2654 
Format of the information structure:
 2654 
Format of the information structure:
2655 
  * +0: dword: 8 = subfunction number
 2655 
  * +0: dword: 8 = subfunction number
2656 
  * +4: dword: number of block to read (beginning from 0)
 2656 
  * +4: dword: number of block to read (beginning from 0)
2657 
  * +8: dword: ignored (set to 1)
 2657 
  * +8: dword: ignored (set to 1)
2658 
  * +12 = +0xC: dword: pointer to buffer for data (512 bytes)
 2658 
  * +12 = +0xC: dword: pointer to buffer for data (512 bytes)
2659 
  * +16 = +0x10: dword: pointer to buffer for system operations
 2659 
  * +16 = +0x10: dword: pointer to buffer for system operations
2660 
    (4096 bytes)
 2660 
    (4096 bytes)
2661 
  * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of
 2661 
  * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of
2662 
    /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
 2662 
    /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
2663 
    1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3.
 2663 
    1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3.
2664 
    Instead of digits it is allowed, though not recommended for
 2664 
    Instead of digits it is allowed, though not recommended for
2665 
    convenience of transition to future extensions, to use
 2665 
    convenience of transition to future extensions, to use
2666 
    'first','second','third','fourth'.
 2666 
    'first','second','third','fourth'.
2667 
Returned value:
 2667 
Returned value:
2668 
  * for device name /hd/xxx, where xxx is not in the list above:
 2668 
  * for device name /hd/xxx, where xxx is not in the list above:
2669 
    * eax = ebx = 1
 2669 
    * eax = ebx = 1
2670 
  * for invalid device name (except for the previous case):
 2670 
  * for invalid device name (except for the previous case):
2671 
    * eax = 5
 2671 
    * eax = 5
2672 
    * ebx does not change
 2672 
    * ebx does not change
2673 
  * if LBA-access is disabled by subfunction 11 of function 21:
 2673 
  * if LBA-access is disabled by subfunction 11 of function 21:
2674 
    * eax = 2
 2674 
    * eax = 2
2675 
    * ebx destroyed
 2675 
    * ebx destroyed
2676 
  * for ramdisk: attempt to read block outside ramdisk
 2676 
  * for ramdisk: attempt to read block outside ramdisk
2677 
    (18*2*80 blocks) results in
 2677 
    (18*2*80 blocks) results in
2678 
    * eax = 3
 2678 
    * eax = 3
2679 
    * ebx = 0
 2679 
    * ebx = 0
2680 
  * for successful read:
 2680 
  * for successful read:
2681 
    * eax = ebx = 0
 2681 
    * eax = ebx = 0
2682 
Remarks:
 2682 
Remarks:
2683 
  * Block size is 512 bytes; function reads one block.
 2683 
  * Block size is 512 bytes; function reads one block.
2684 
  * Do not depend on returned value, it can be changed
 2684 
  * Do not depend on returned value, it can be changed
2685 
    in future versions.
 2685 
    in future versions.
2686 
  * Function requires that LBA-access to devices is enabled by
 2686 
  * Function requires that LBA-access to devices is enabled by
2687 
    subfunction 11 of function 21. To check this one can use
 2687 
    subfunction 11 of function 21. To check this one can use
2688 
    subfunction 11 of function 26.
 2688 
    subfunction 11 of function 26.
2689 
  * LBA-read of floppy is not supported.
 2689 
  * LBA-read of floppy is not supported.
2690 
  * Function reads data on physical hard drive; if for any reason
 2690 
  * Function reads data on physical hard drive; if for any reason
2691 
    data of the concrete partition are required, application must
 2691 
    data of the concrete partition are required, application must
2692 
    define starting sector of this partition (either directly
 2692 
    define starting sector of this partition (either directly
2693 
    through MBR, or from the full structure returned by
 2693 
    through MBR, or from the full structure returned by
2694 
    subfunction 11 of function 18).
 2694 
    subfunction 11 of function 18).
2695 
  * Function does not check error code of hard disk, so request of
 2695 
  * Function does not check error code of hard disk, so request of
2696 
    nonexisting sector reads something (most probably it will be
 2696 
    nonexisting sector reads something (most probably it will be
2697 
    zeroes, but this is defined by device) and this is considered
 2697 
    zeroes, but this is defined by device) and this is considered
2698 
    as success (eax=0).
 2698 
    as success (eax=0).
2699 
 
 2699 
 
2700 
======================================================================
 2700 
======================================================================
2701 
==== Function 58, subfunction 15 - get information on file system. ===
 2701 
==== Function 58, subfunction 15 - get information on file system. ===
2702 
======================================================================
 2702 
======================================================================
2703 
Parameters:
 2703 
Parameters:
2704 
  * eax = 58 - function number
 2704 
  * eax = 58 - function number
2705 
  * ebx = pointer to the information structure
 2705 
  * ebx = pointer to the information structure
2706 
Format of the information structure:
 2706 
Format of the information structure:
2707 
  * +0: dword: 15 = subfunction number
 2707 
  * +0: dword: 15 = subfunction number
2708 
  * +4: dword: ignored
 2708 
  * +4: dword: ignored
2709 
  * +8: dword: ignored
 2709 
  * +8: dword: ignored
2710 
  * +12 = +0xC: dword: ignored
 2710 
  * +12 = +0xC: dword: ignored
2711 
  * +16 = +0x10: dword: ignored
 2711 
  * +16 = +0x10: dword: ignored
2712 
  * +20 = +0x14: (only second character is checked)
 2712 
  * +20 = +0x14: (only second character is checked)
2713 
    /rd=/RAMDISK or /hd=/HARDDISK
 2713 
    /rd=/RAMDISK or /hd=/HARDDISK
2714 
Returned value:
 2714 
Returned value:
2715 
  * if the second character does not belong to set {'r','R','h','H'}:
 2715 
  * if the second character does not belong to set {'r','R','h','H'}:
2716 
    * eax = 3
 2716 
    * eax = 3
2717 
    * ebx = ecx = dword [fileinfo] = 0
 2717 
    * ebx = ecx = dword [fileinfo] = 0
2718 
  * for ramdisk:
 2718 
  * for ramdisk:
2719 
    * eax = 0 (success)
 2719 
    * eax = 0 (success)
2720 
    * ebx = total number of clusters = 2847
 2720 
    * ebx = total number of clusters = 2847
2721 
    * ecx = number of free clusters
 2721 
    * ecx = number of free clusters
2722 
    * dword [fileinfo] = cluster size = 512
 2722 
    * dword [fileinfo] = cluster size = 512
2723 
  * for hard disk: base and partition are defined by subfunctions
 2723 
  * for hard disk: base and partition are defined by subfunctions
2724 
    7 and 8 of function 21:
 2724 
    7 and 8 of function 21:
2725 
    * eax = 0 (success)
 2725 
    * eax = 0 (success)
2726 
    * ebx = total number of clusters
 2726 
    * ebx = total number of clusters
2727 
    * ecx = number of free clusters
 2727 
    * ecx = number of free clusters
2728 
    * dword [fileinfo] = cluster size (in bytes)
 2728 
    * dword [fileinfo] = cluster size (in bytes)
2729 
Remarks:
 2729 
Remarks:
2730 
  * Be not surprised to strange layout of 4th returned parameter
 2730 
  * Be not surprised to strange layout of 4th returned parameter
2731 
    - when this code was writing, at system calls application got
 2731 
    - when this code was writing, at system calls application got
2732 
    only registers eax,ebx,ecx (from pushad-structure transmitted
 2732 
    only registers eax,ebx,ecx (from pushad-structure transmitted
2733 
    as argument to the system function). Now it is corrected, so,
 2733 
    as argument to the system function). Now it is corrected, so,
2734 
    probably, it is meaningful to return cluster size in edx, while
 2734 
    probably, it is meaningful to return cluster size in edx, while
2735 
    this function is not used yet.
 2735 
    this function is not used yet.
2736 
  * There exists also subfunction 11 of function 18,
 2736 
  * There exists also subfunction 11 of function 18,
2737 
    which returns information on file system. From the full table
 2737 
    which returns information on file system. From the full table
2738 
    of disk subsystem it is possible to deduce cluster size (there
 2738 
    of disk subsystem it is possible to deduce cluster size (there
2739 
    it is stored in sectors) and total number of clusters
 2739 
    it is stored in sectors) and total number of clusters
2740 
    for hard disks.
 2740 
    for hard disks.
2741 
 
 2741 
 
2742 
======================================================================
 2742 
======================================================================
2743 
========== Function 60 - Inter Process Communication (IPC). ==========
 2743 
========== Function 60 - Inter Process Communication (IPC). ==========
2744 
======================================================================
 2744 
======================================================================
2745 
IPC is used for message dispatching from one process/thread to
 2745 
IPC is used for message dispatching from one process/thread to
2746 
another. Previously it is necessary to agree how to interpret
 2746 
another. Previously it is necessary to agree how to interpret
2747 
the concrete message.
 2747 
the concrete message.
2748 
 
 2748 
 
2749 
----------- Subfunction 1 - set the area for IPC receiving -----------
 2749 
----------- Subfunction 1 - set the area for IPC receiving -----------
2750 
Is called by process-receiver.
 2750 
Is called by process-receiver.
2751 
Parameters:
 2751 
Parameters:
2752 
  * eax = 60 - function number
 2752 
  * eax = 60 - function number
2753 
  * ebx = 1 - subfunction number
 2753 
  * ebx = 1 - subfunction number
2754 
  * ecx = pointer to the buffer
 2754 
  * ecx = pointer to the buffer
2755 
  * edx = size of the buffer
 2755 
  * edx = size of the buffer
2756 
Returned value:
 2756 
Returned value:
2757 
  * eax = 0 - always success
 2757 
  * eax = 0 - always success
2758 
Format of IPC-buffer:
 2758 
Format of IPC-buffer:
2759 
  * +0: dword: if nonzero, buffer is considered locked;
 2759 
  * +0: dword: if nonzero, buffer is considered locked;
2760 
    lock/unlock the buffer, when you work with it and need that
 2760 
    lock/unlock the buffer, when you work with it and need that
2761 
    buffer data are not changed from outside (no new messages)
 2761 
    buffer data are not changed from outside (no new messages)
2762 
  * +4: dword: occupied place in the buffer (in bytes)
 2762 
  * +4: dword: occupied place in the buffer (in bytes)
2763 
  * +8: first message
 2763 
  * +8: first message
2764 
  * +8+n: second message
 2764 
  * +8+n: second message
2765 
  * ...
 2765 
  * ...
2766 
Format of a message:
 2766 
Format of a message:
2767 
  * +0: dword: PID of sender
 2767 
  * +0: dword: PID of sender
2768 
  * +4: dword: message length (not including this header)
 2768 
  * +4: dword: message length (not including this header)
2769 
  * +8: n*byte: message data
 2769 
  * +8: n*byte: message data
2770 
 
 2770 
 
2771 
------------------ Subfunction 2 - send IPC message ------------------
 2771 
------------------ Subfunction 2 - send IPC message ------------------
2772 
Is called by process-sender.
 2772 
Is called by process-sender.
2773 
Parameters:
 2773 
Parameters:
2774 
  * eax = 60 - function number
 2774 
  * eax = 60 - function number
2775 
  * ebx = 2 - subfunction number
 2775 
  * ebx = 2 - subfunction number
2776 
  * ecx = PID of receiver
 2776 
  * ecx = PID of receiver
2777 
  * edx = pointer to the message data
 2777 
  * edx = pointer to the message data
2778 
  * esi = message length (in bytes)
 2778 
  * esi = message length (in bytes)
2779 
Returned value:
 2779 
Returned value:
2780 
  * eax = 0 - success
 2780 
  * eax = 0 - success
2781 
  * eax = 1 - the receiver has not defined buffer for IPC messages
 2781 
  * eax = 1 - the receiver has not defined buffer for IPC messages
2782 
    (can be, still have no time,
 2782 
    (can be, still have no time,
2783 
    and can be, this is not right process)
 2783 
    and can be, this is not right process)
2784 
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
 2784 
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
2785 
  * eax = 3 - overflow of IPC-buffer of the receiver
 2785 
  * eax = 3 - overflow of IPC-buffer of the receiver
2786 
  * eax = 4 - process/thread with such PID does not exist
 2786 
  * eax = 4 - process/thread with such PID does not exist
2787 
Remarks:
 2787 
Remarks:
2788 
  * Immediately after writing of IPC-message to the buffer the system
 2788 
  * Immediately after writing of IPC-message to the buffer the system
2789 
    sends to the receiver the event with code 7 (see event codes).
 2789 
    sends to the receiver the event with code 7 (see event codes).
2790 
 
 2790 
 
2791 
======================================================================
 2791 
======================================================================
2792 
==== Function 61 - get parameters for the direct graphics access. ====
 2792 
==== Function 61 - get parameters for the direct graphics access. ====
2793 
======================================================================
 2793 
======================================================================
2794 
The data of the graphics screen (the memory area which displays
 2794 
The data of the graphics screen (the memory area which displays
2795 
screen contents) are accessible to a program directly, without
 2795 
screen contents) are accessible to a program directly, without
2796 
any system calls, through the selector gs:
 2796 
any system calls, through the selector gs:
2797 
	mov	eax, [gs:0]
 2797 
	mov	eax, [gs:0]
2798 
places in eax the first dword of the buffer, which contains
 2798 
places in eax the first dword of the buffer, which contains
2799 
information on color of the left upper point (and, possibly, colors
 2799 
information on color of the left upper point (and, possibly, colors
2800 
of several following).
 2800 
of several following).
2801 
	mov	[gs:0], eax
 2801 
	mov	[gs:0], eax
2802 
by work in VESA modes with LFB sets color of the left upper point
 2802 
by work in VESA modes with LFB sets color of the left upper point
2803 
(and, possibly, colors of several following).
 2803 
(and, possibly, colors of several following).
2804 
To interpret the data of graphics screen program needs to know
 2804 
To interpret the data of graphics screen program needs to know
2805 
some parameters, returning by this function.
 2805 
some parameters, returning by this function.
2806 
Remarks:
 2806 
Remarks:
2807 
  * Graphics parameters changes very seldom at work,
 2807 
  * Graphics parameters changes very seldom at work,
2808 
    namely, only in cases, when user works with the application VRR.
 2808 
    namely, only in cases, when user works with the application VRR.
2809 
  * At videomode change the system redraws all windows (event
 2809 
  * At videomode change the system redraws all windows (event
2810 
    with code 1) and redraws the background (event 5).
 2810 
    with code 1) and redraws the background (event 5).
2811 
    Same events occur in other cases too, which meet much more often,
 2811 
    Same events occur in other cases too, which meet much more often,
2812 
    than videomode change.
 2812 
    than videomode change.
2813 
  * By operation in videomodes with LFB the selector gs points to
 2813 
  * By operation in videomodes with LFB the selector gs points to
2814 
    LFB itself, so reading/writing on gs result directly in
 2814 
    LFB itself, so reading/writing on gs result directly in
2815 
    change of screen contents. By operation in videomodes without
 2815 
    change of screen contents. By operation in videomodes without
2816 
    LFB gs points to some data area in the kernel, and all functions
 2816 
    LFB gs points to some data area in the kernel, and all functions
2817 
    of screen output fulfil honesty double operation on writing
 2817 
    of screen output fulfil honesty double operation on writing
2818 
    directly to the screen and writing to this buffer. In result
 2818 
    directly to the screen and writing to this buffer. In result
2819 
    at reading contents of this buffer the results correspond to
 2819 
    at reading contents of this buffer the results correspond to
2820 
    screen contents (with, generally speaking, large color
 2820 
    screen contents (with, generally speaking, large color
2821 
    resolution), and writing is ignored.
 2821 
    resolution), and writing is ignored.
2822 
    One exception is the mode 320*200, for which main loop of the
 2822 
    One exception is the mode 320*200, for which main loop of the
2823 
    system thread updates the screen according to mouse movements.
 2823 
    system thread updates the screen according to mouse movements.
2824 
 
 2824 
 
2825 
------------------------- Screen resolution --------------------------
 2825 
------------------------- Screen resolution --------------------------
2826 
Parameters:
 2826 
Parameters:
2827 
  * eax = 61 - function number
 2827 
  * eax = 61 - function number
2828 
  * ebx = 1 - subfunction number
 2828 
  * ebx = 1 - subfunction number
2829 
Returned value:
 2829 
Returned value:
2830 
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
 2830 
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
2831 
Remarks:
 2831 
Remarks:
2832 
  * One can use function 14 paying attention that
 2832 
  * One can use function 14 paying attention that
2833 
    it returns sizes on 1 pixel less. It is fully equivalent way.
 2833 
    it returns sizes on 1 pixel less. It is fully equivalent way.
2834 
 
 2834 
 
2835 
---------------------- Number of bits per pixel ----------------------
 2835 
---------------------- Number of bits per pixel ----------------------
2836 
Parameters:
 2836 
Parameters:
2837 
  * eax = 61 - function number
 2837 
  * eax = 61 - function number
2838 
  * ebx = 2 - subfunction number
 2838 
  * ebx = 2 - subfunction number
2839 
Returned value:
 2839 
Returned value:
2840 
  * eax = number of bits per pixel (24 or 32)
 2840 
  * eax = number of bits per pixel (24 or 32)
2841 
 
 2841 
 
2842 
-------------------- Number of bytes per scanline --------------------
 2842 
-------------------- Number of bytes per scanline --------------------
2843 
Parameters:
 2843 
Parameters:
2844 
  * eax = 61 - function number
 2844 
  * eax = 61 - function number
2845 
  * ebx = 3 - subfunction number
 2845 
  * ebx = 3 - subfunction number
2846 
Returned value:
 2846 
Returned value:
2847 
  * eax = number of bytes occupied by one scanline
 2847 
  * eax = number of bytes occupied by one scanline
2848 
    (horizontal line on the screen)
 2848 
    (horizontal line on the screen)
2849 
 
 2849 
 
2850 
======================================================================
 2850 
======================================================================
2851 
===== Function 62, subfunction 0 - get version of PCI-interface. =====
 2851 
===== Function 62, subfunction 0 - get version of PCI-interface. =====
2852 
======================================================================
 2852 
======================================================================
2853 
Parameters:
 2853 
Parameters:
2854 
  * eax = 62 - function number
 2854 
  * eax = 62 - function number
2855 
  * bl = 0 - subfunction number
 2855 
  * bl = 0 - subfunction number
2856 
Returned value:
 2856 
Returned value:
2857 
  * eax = -1 - PCI access is disabled; otherwise
 2857 
  * eax = -1 - PCI access is disabled; otherwise
2858 
  * ah.al = version of PCI-interface (ah=version, al=subversion)
 2858 
  * ah.al = version of PCI-interface (ah=version, al=subversion)
2859 
  * high word of eax is zeroed
 2859 
  * high word of eax is zeroed
2860 
Remarks:
 2860 
Remarks:
2861 
  * Previously low-level access to PCI for applications must be
 2861 
  * Previously low-level access to PCI for applications must be
2862 
    enabled by subfunction 12 of function 21.
 2862 
    enabled by subfunction 12 of function 21.
2863 
  * If PCI BIOS is not supported, the value of ax is undefined.
 2863 
  * If PCI BIOS is not supported, the value of ax is undefined.
2864 
 
 2864 
 
2865 
======================================================================
 2865 
======================================================================
2866 
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
 2866 
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
2867 
======================================================================
 2867 
======================================================================
2868 
Parameters:
 2868 
Parameters:
2869 
  * eax = 62 - function number
 2869 
  * eax = 62 - function number
2870 
  * bl = 1 - subfunction number
 2870 
  * bl = 1 - subfunction number
2871 
Returned value:
 2871 
Returned value:
2872 
  * eax = -1 - access to PCI is disabled; otherwise
 2872 
  * eax = -1 - access to PCI is disabled; otherwise
2873 
  * al = number of the last PCI-bus; other bytes of eax are destroyed
 2873 
  * al = number of the last PCI-bus; other bytes of eax are destroyed
2874 
Remarks:
 2874 
Remarks:
2875 
  * Previously low-level access to PCI for applications must be
 2875 
  * Previously low-level access to PCI for applications must be
2876 
    enabled by subfunction 12 of function 21.
 2876 
    enabled by subfunction 12 of function 21.
2877 
  * If PCI BIOS is not supported, the value of ax is undefined.
 2877 
  * If PCI BIOS is not supported, the value of ax is undefined.
2878 
 
 2878 
 
2879 
======================================================================
 2879 
======================================================================
2880 
===================== Function 62, subfunction 2 =====================
 2880 
===================== Function 62, subfunction 2 =====================
2881 
===== Get mechanism of addressing to the PCI configuration space. ====
 2881 
===== Get mechanism of addressing to the PCI configuration space. ====
2882 
======================================================================
 2882 
======================================================================
2883 
Parameters:
 2883 
Parameters:
2884 
  * eax = 62 - function number
 2884 
  * eax = 62 - function number
2885 
  * bl = 2 - subfunction number
 2885 
  * bl = 2 - subfunction number
2886 
Returned value:
 2886 
Returned value:
2887 
  * eax = -1 - access to PCI is disabled; otherwise
 2887 
  * eax = -1 - access to PCI is disabled; otherwise
2888 
  * al = mechanism (1 or 2); other bytes of eax are destroyed
 2888 
  * al = mechanism (1 or 2); other bytes of eax are destroyed
2889 
Remarks:
 2889 
Remarks:
2890 
  * Previously low-level access to PCI for applications must be
 2890 
  * Previously low-level access to PCI for applications must be
2891 
    enabled by subfunction 12 of function 21.
 2891 
    enabled by subfunction 12 of function 21.
2892 
  * Addressing mechanism is selected depending on
 2892 
  * Addressing mechanism is selected depending on
2893 
    equipment characteristics.
 2893 
    equipment characteristics.
2894 
  * Subfunctions of read and write work automatically
 2894 
  * Subfunctions of read and write work automatically
2895 
    with the selected mechanism.
 2895 
    with the selected mechanism.
2896 
 
 2896 
 
2897 
======================================================================
 2897 
======================================================================
2898 
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
 2898 
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
2899 
======================================================================
 2899 
======================================================================
2900 
Parameters:
 2900 
Parameters:
2901 
  * eax = 62 - function number
 2901 
  * eax = 62 - function number
2902 
  * bl = 4 - read byte
 2902 
  * bl = 4 - read byte
2903 
  * bl = 5 - read word
 2903 
  * bl = 5 - read word
2904 
  * bl = 6 - read dword
 2904 
  * bl = 6 - read dword
2905 
  * bh = number of PCI-bus
 2905 
  * bh = number of PCI-bus
2906 
  * ch = dddddfff, where ddddd = number of the device on the bus,
 2906 
  * ch = dddddfff, where ddddd = number of the device on the bus,
2907 
    fff = function number of device
 2907 
    fff = function number of device
2908 
  * cl = number of register (must be even for bl=5,
 2908 
  * cl = number of register (must be even for bl=5,
2909 
    divisible by 4 for bl=6)
 2909 
    divisible by 4 for bl=6)
2910 
Returned value:
 2910 
Returned value:
2911 
  * eax = -1 - error (access to PCI is disabled or parameters
 2911 
  * eax = -1 - error (access to PCI is disabled or parameters
2912 
    are not supported); otherwise
 2912 
    are not supported); otherwise
2913 
  * al/ax/eax (depending on requested size) contains the data;
 2913 
  * al/ax/eax (depending on requested size) contains the data;
2914 
    the other part of register eax is destroyed
 2914 
    the other part of register eax is destroyed
2915 
Remarks:
 2915 
Remarks:
2916 
  * Previously low-level access to PCI for applications must be
 2916 
  * Previously low-level access to PCI for applications must be
2917 
    enabled by subfunction 12 of function 21.
 2917 
    enabled by subfunction 12 of function 21.
2918 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
 2918 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
2919 
    function number. To get access mechanism use subfunction 2.
 2919 
    function number. To get access mechanism use subfunction 2.
2920 
  * Some registers are standard and exist for all devices, some are
 2920 
  * Some registers are standard and exist for all devices, some are
2921 
    defined by the concrete device. The list of registers of the
 2921 
    defined by the concrete device. The list of registers of the
2922 
    first type can be found e.g. in famous
 2922 
    first type can be found e.g. in famous
2923 
    Interrupt List by Ralf Brown
 2923 
    Interrupt List by Ralf Brown
2924 
    (http://www.pobox.com/~ralf/files.html,
 2924 
    (http://www.pobox.com/~ralf/files.html,
2925 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
 2925 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
2926 
    registers of the second type must be listed
 2926 
    registers of the second type must be listed
2927 
    in the device documentation.
 2927 
    in the device documentation.
2928 
 
 2928 
 
2929 
======================================================================
 2929 
======================================================================
2930 
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
 2930 
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
2931 
======================================================================
 2931 
======================================================================
2932 
Parameters:
 2932 
Parameters:
2933 
  * eax = 62 - function number
 2933 
  * eax = 62 - function number
2934 
  * bl = 8 - write byte
 2934 
  * bl = 8 - write byte
2935 
  * bl = 9 - write word
 2935 
  * bl = 9 - write word
2936 
  * bl = 10 - write dword
 2936 
  * bl = 10 - write dword
2937 
  * bh = number of PCI-bus
 2937 
  * bh = number of PCI-bus
2938 
  * ch = dddddfff, where ddddd = number of the device on the bus,
 2938 
  * ch = dddddfff, where ddddd = number of the device on the bus,
2939 
    fff = function number of device
 2939 
    fff = function number of device
2940 
  * cl = number of register (must be even for bl=9,
 2940 
  * cl = number of register (must be even for bl=9,
2941 
    divisible by 4 for bl=10)
 2941 
    divisible by 4 for bl=10)
2942 
  * dl/dx/edx (depending on requested size) contatins
 2942 
  * dl/dx/edx (depending on requested size) contatins
2943 
    the data to write
 2943 
    the data to write
2944 
Returned value:
 2944 
Returned value:
2945 
  * eax = -1 - error (access to PCI is disabled or parameters
 2945 
  * eax = -1 - error (access to PCI is disabled or parameters
2946 
    are not supported)
 2946 
    are not supported)
2947 
  * eax = 0 - success
 2947 
  * eax = 0 - success
2948 
Remarks:
 2948 
Remarks:
2949 
  * Previously low-level access to PCI for applications must be
 2949 
  * Previously low-level access to PCI for applications must be
2950 
    enabled by subfunction 12 of function 21.
 2950 
    enabled by subfunction 12 of function 21.
2951 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
 2951 
  * Access mechanism 2 supports only 16 devices on a bus and ignores
2952 
    function number. To get access mechanism use subfunction 2.
 2952 
    function number. To get access mechanism use subfunction 2.
2953 
  * Some registers are standard and exist for all devices, some are
 2953 
  * Some registers are standard and exist for all devices, some are
2954 
    defined by the concrete device. The list of registers of the
 2954 
    defined by the concrete device. The list of registers of the
2955 
    first type can be found e.g. in famous Interrupt List by
 2955 
    first type can be found e.g. in famous Interrupt List by
2956 
    Ralf Brown; registers of the second type must be listed
 2956 
    Ralf Brown; registers of the second type must be listed
2957 
    in the device documentation.
 2957 
    in the device documentation.
2958 
 
 2958 
 
2959 
======================================================================
 2959 
======================================================================
2960 
============== Function 63 - work with the debug board. ==============
 2960 
============== Function 63 - work with the debug board. ==============
2961 
======================================================================
 2961 
======================================================================
2962 
The debug board is the global system buffer (with the size
 2962 
The debug board is the global system buffer (with the size
2963 
1024 bytes), to which any program can write (generally speaking,
 2963 
1024 bytes), to which any program can write (generally speaking,
2964 
arbitrary) data and from which other program can read these data.
 2964 
arbitrary) data and from which other program can read these data.
2965 
By the agreement written data are text strings interpreted as
 2965 
By the agreement written data are text strings interpreted as
2966 
debug messages on a course of program execution. The kernel in
 2966 
debug messages on a course of program execution. The kernel in
2967 
some situations also writes to the debug board information on
 2967 
some situations also writes to the debug board information on
2968 
execution of some functions; by the agreement kernel messages
 2968 
execution of some functions; by the agreement kernel messages
2969 
begins from the prefix "K : ".
 2969 
begins from the prefix "K : ".
2970 
For view of the debug board the application 'board' was created,
 2970 
For view of the debug board the application 'board' was created,
2971 
which reads data from the buffer and displays them in its window.
 2971 
which reads data from the buffer and displays them in its window.
2972 
'board' interpretes the sequence of codes 13,10 as newline.
 2972 
'board' interpretes the sequence of codes 13,10 as newline.
2973 
A character with null code in an end of line is not necessary,
 2973 
A character with null code in an end of line is not necessary,
2974 
but also does not prevent.
 2974 
but also does not prevent.
2975 
Because debugger has been written, the value of the debug board
 2975 
Because debugger has been written, the value of the debug board
2976 
has decreased, as debugger allows to inspect completely a course of
 2976 
has decreased, as debugger allows to inspect completely a course of
2977 
program execution without any efforts from the direction of program
 2977 
program execution without any efforts from the direction of program
2978 
itself. Nevertheless in some cases the debug board is still useful.
 2978 
itself. Nevertheless in some cases the debug board is still useful.
2979 
 
 2979 
 
2980 
----------------------------- Write byte -----------------------------
 2980 
----------------------------- Write byte -----------------------------
2981 
Parameters:
 2981 
Parameters:
2982 
  * eax = 63 - function number
 2982 
  * eax = 63 - function number
2983 
  * ebx = 1 - subfunction number
 2983 
  * ebx = 1 - subfunction number
2984 
  * cl = data byte
 2984 
  * cl = data byte
2985 
Returned value:
 2985 
Returned value:
2986 
  * function does not return value
 2986 
  * function does not return value
2987 
Remarks:
 2987 
Remarks:
2988 
  * Byte is written to the buffer. Buffer size is 512 bytes.
 2988 
  * Byte is written to the buffer. Buffer size is 512 bytes.
2989 
    At buffer overflow all obtained data are lost.
 2989 
    At buffer overflow all obtained data are lost.
2990 
  * For output to the debug board of more complicated objects
 2990 
  * For output to the debug board of more complicated objects
2991 
    (strings, numbers) it is enough to call this function in cycle.
 2991 
    (strings, numbers) it is enough to call this function in cycle.
2992 
    It is possible not to write the appropriate code manually and use
 2992 
    It is possible not to write the appropriate code manually and use
2993 
    file 'debug.inc', which is included into the distributive.
 2993 
    file 'debug.inc', which is included into the distributive.
2994 
 
 2994 
 
2995 
----------------------------- Read byte ------------------------------
 2995 
----------------------------- Read byte ------------------------------
2996 
Takes away byte from the buffer.
 2996 
Takes away byte from the buffer.
2997 
Parameters:
 2997 
Parameters:
2998 
  * eax = 63 - function number
 2998 
  * eax = 63 - function number
2999 
  * ebx = 2 - subfunction number
 2999 
  * ebx = 2 - subfunction number
3000 
Returned value:
 3000 
Returned value:
3001 
  * eax = ebx = 0 - the buffer is empty
 3001 
  * eax = ebx = 0 - the buffer is empty
3002 
  * eax = byte, ebx = 1 - byte was successfully read
 3002 
  * eax = byte, ebx = 1 - byte was successfully read
3003 
 
 3003 
 
3004 
======================================================================
 3004 
======================================================================
3005 
============== Function 64 - resize application memory. ==============
 3005 
============== Function 64 - resize application memory. ==============
3006 
======================================================================
 3006 
======================================================================
3007 
Parameters:
 3007 
Parameters:
3008 
  * eax = 64 - function number
 3008 
  * eax = 64 - function number
3009 
  * ebx = 1 - unique subfunction
 3009 
  * ebx = 1 - unique subfunction
3010 
  * ecx = new memory size
 3010 
  * ecx = new memory size
3011 
Returned value:
 3011 
Returned value:
3012 
  * eax = 0 - success
 3012 
  * eax = 0 - success
3013 
  * eax = 1 - not enough memory
 3013 
  * eax = 1 - not enough memory
3014 
Remarks:
 3014 
Remarks:
3015 
  * There is another way to dynamically allocate/free memory -
 3015 
  * There is another way to dynamically allocate/free memory -
3016 
    subfunctions 11, 12, 13 of function 68.
 3016 
    subfunctions 11, 12, 13 of function 68.
3017 
  * The function cannot be used together with 68.11, 68.12, 68.13.
 3017 
  * The function cannot be used together with 68.11, 68.12, 68.13.
3018 
    The function call will be ignored after creation of process heap
 3018 
    The function call will be ignored after creation of process heap
3019 
    with function 68.11.
 3019 
    with function 68.11.
3020 
 
 3020 
 
3021 
======================================================================
 3021 
======================================================================
3022 
======== Function 65 - draw image with palette in the window. ========
 3022 
======== Function 65 - draw image with palette in the window. ========
3023 
======================================================================
 3023 
======================================================================
3024 
Parameters:
 3024 
Parameters:
3025 
  * eax = 65 - function number
 3025 
  * eax = 65 - function number
3026 
  * ebx = pointer to the image
 3026 
  * ebx = pointer to the image
3027 
  * ecx = [size on axis x]*65536 + [size on axis y]
 3027 
  * ecx = [size on axis x]*65536 + [size on axis y]
3028 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
 3028 
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
3029 
  * esi = number of bits per pixel, must be 1,2,4,8,9,15,16,24 or 32;
 3029 
  * esi = number of bits per pixel, must be 1,2,4,8,9,15,16,24 or 32;
3030 
  * edi = pointer to palette (2 to the power esi colors 0x00RRGGBB);
 3030 
  * edi = pointer to palette (2 to the power esi colors 0x00RRGGBB);
3031 
          ignored when esi > 8
 3031 
          ignored when esi > 8
3032 
  * ebp = offset of next row data relative to previous row data
 3032 
  * ebp = offset of next row data relative to previous row data
3033 
Returned value:
 3033 
Returned value:
3034 
  * function does not return value
 3034 
  * function does not return value
3035 
Remarks:
 3035 
Remarks:
3036 
  * Coordinates of the image are coordinates of the upper left corner
 3036 
  * Coordinates of the image are coordinates of the upper left corner
3037 
    of the image relative to the window.
 3037 
    of the image relative to the window.
3038 
  * Format of image with 1 bit per pixel: each byte of image
 3038 
  * Format of image with 1 bit per pixel: each byte of image
3039 
    (possibly excluding last bytes in rows), contains information on
 3039 
    (possibly excluding last bytes in rows), contains information on
3040 
    the color of 8 pixels, MSB corresponds to first pixel.
 3040 
    the color of 8 pixels, MSB corresponds to first pixel.
3041 
  * Format of image with 2 bits per pixel: each byte of image
 3041 
  * Format of image with 2 bits per pixel: each byte of image
3042 
    (possibly excluding last bytes in rows), contains information on
 3042 
    (possibly excluding last bytes in rows), contains information on
3043 
    the color of 4 pixels, two MSBs correspond to first pixel.
 3043 
    the color of 4 pixels, two MSBs correspond to first pixel.
3044 
  * Format of image with 4 bits per pixel: each byte of image
 3044 
  * Format of image with 4 bits per pixel: each byte of image
3045 
    excluding last bytes in rows (if width is odd) contains
 3045 
    excluding last bytes in rows (if width is odd) contains
3046 
    information on the color of 2 pixels, high-order tetrad
 3046 
    information on the color of 2 pixels, high-order tetrad
3047 
    corresponds to first pixel.
 3047 
    corresponds to first pixel.
3048 
  * Format of image with 8 bits per pixel: each byte of image is
 3048 
  * Format of image with 8 bits per pixel: each byte of image is
3049 
    index in the palette.
 3049 
    index in the palette.
3050 
  * Format of image with 9 bits per pixel: array of one byte values;
 3050 
  * Format of image with 9 bits per pixel: array of one byte values;
3051 
    each byte (8 bit) represents the intensity of gray for one pixel;
 3051 
    each byte (8 bit) represents the intensity of gray for one pixel;
3052 
    this format is equal to 8bpp without palette.
 3052 
    this format is equal to 8bpp without palette.
3053 
  * Format of image with 15 bits per pixel: the color of each pixel
 3053 
  * Format of image with 15 bits per pixel: the color of each pixel
3054 
    is coded as (bit representation) 0RRRRRGGGGGBBBBB - 5 bits per
 3054 
    is coded as (bit representation) 0RRRRRGGGGGBBBBB - 5 bits per
3055 
    each color.
 3055 
    each color.
3056 
  * Format of image with 16 bits per pixel: the color of each pixel
 3056 
  * Format of image with 16 bits per pixel: the color of each pixel
3057 
    is coded as RRRRRGGGGGGBBBBB (5+6+5).
 3057 
    is coded as RRRRRGGGGGGBBBBB (5+6+5).
3058 
  * Format of image with 24 bits per pixel: the color of each pixel
 3058 
  * Format of image with 24 bits per pixel: the color of each pixel
3059 
    is coded as 3 bytes - sequentially blue, green, red components.
 3059 
    is coded as 3 bytes - sequentially blue, green, red components.
3060 
  * Format of image with 32 bits per pixel: similar to 24, but
 3060 
  * Format of image with 32 bits per pixel: similar to 24, but
3061 
    one additional ignored byte is present.
 3061 
    one additional ignored byte is present.
3062 
  * The call to function 7 is equivalent to call to this function
 3062 
  * The call to function 7 is equivalent to call to this function
3063 
    with esi=24, ebp=0.
 3063 
    with esi=24, ebp=0.
3064 
 
 3064 
 
3065 
======================================================================
 3065 
======================================================================
3066 
================== Function 66 - work with keyboard. =================
 3066 
================== Function 66 - work with keyboard. =================
3067 
======================================================================
 3067 
======================================================================
3068 
The input mode influences results of reading keys by function 2.
 3068 
The input mode influences results of reading keys by function 2.
3069 
When a program loads, ASCII input mode is set for it.
 3069 
When a program loads, ASCII input mode is set for it.
3070 
 
 3070 
 
3071 
-------------- Subfunction 1 - set keyboard input mode. --------------
 3071 
-------------- Subfunction 1 - set keyboard input mode. --------------
3072 
Parameters:
 3072 
Parameters:
3073 
  * eax = 66 - function number
 3073 
  * eax = 66 - function number
3074 
  * ebx = 1 - subfunction number
 3074 
  * ebx = 1 - subfunction number
3075 
  * ecx = mode:
 3075 
  * ecx = mode:
3076 
    * 0 = normal (ASCII-characters)
 3076 
    * 0 = normal (ASCII-characters)
3077 
    * 1 = scancodes
 3077 
    * 1 = scancodes
3078 
Returned value:
 3078 
Returned value:
3079 
  * function does not return value
 3079 
  * function does not return value
3080 
 
 3080 
 
3081 
-------------- Subfunction 2 - get keyboard input mode. --------------
 3081 
-------------- Subfunction 2 - get keyboard input mode. --------------
3082 
Parameters:
 3082 
Parameters:
3083 
  * eax = 66 - function number
 3083 
  * eax = 66 - function number
3084 
  * ebx = 2 - subfunction number
 3084 
  * ebx = 2 - subfunction number
3085 
Returned value:
 3085 
Returned value:
3086 
  * eax = current mode
 3086 
  * eax = current mode
3087 
 
 3087 
 
3088 
------------ Subfunction 3 - get status of control keys. -------------
 3088 
------------ Subfunction 3 - get status of control keys. -------------
3089 
Parameters:
 3089 
Parameters:
3090 
  * eax = 66 - function number
 3090 
  * eax = 66 - function number
3091 
  * ebx = 3 - subfunction number
 3091 
  * ebx = 3 - subfunction number
3092 
Returned value:
 3092 
Returned value:
3093 
  * eax = bit mask:
 3093 
  * eax = bit mask:
3094 
  * bit 0  (mask 1): left Shift is pressed
 3094 
  * bit 0  (mask 1): left Shift is pressed
3095 
  * bit 1  (mask 2): right Shift is pressed
 3095 
  * bit 1  (mask 2): right Shift is pressed
3096 
  * bit 2  (mask 4): left Ctrl is pressed
 3096 
  * bit 2  (mask 4): left Ctrl is pressed
3097 
  * bit 3  (mask 8): right Ctrl is pressed
 3097 
  * bit 3  (mask 8): right Ctrl is pressed
3098 
  * bit 4  (mask 0x10): left Alt is pressed
 3098 
  * bit 4  (mask 0x10): left Alt is pressed
3099 
  * bit 5  (mask 0x20): right Alt is pressed
 3099 
  * bit 5  (mask 0x20): right Alt is pressed
3100 
  * bit 6  (mask 0x40): CapsLock is on
 3100 
  * bit 6  (mask 0x40): CapsLock is on
3101 
  * bit 7  (mask 0x80): NumLock is on
 3101 
  * bit 7  (mask 0x80): NumLock is on
3102 
  * bit 8  (mask 0x100): ScrollLock is on
 3102 
  * bit 8  (mask 0x100): ScrollLock is on
3103 
  * bit 9  (mask 0x200): left Win is pressed
 3103 
  * bit 9  (mask 0x200): left Win is pressed
3104 
  * bit 10 (mask 0x400): right Win is pressed
 3104 
  * bit 10 (mask 0x400): right Win is pressed
3105 
  * other bits are cleared
 3105 
  * other bits are cleared
3106 
 
 3106 
 
3107 
-------------- Subfunction 4 - set system-wide hotkey. ---------------
 3107 
-------------- Subfunction 4 - set system-wide hotkey. ---------------
3108 
When hotkey is pressed, the system notifies only those applications,
 3108 
When hotkey is pressed, the system notifies only those applications,
3109 
which have installed it; the active application (which receives
 3109 
which have installed it; the active application (which receives
3110 
all normal input) does not receive such keys.
 3110 
all normal input) does not receive such keys.
3111 
The notification consists in sending event with the code 2.
 3111 
The notification consists in sending event with the code 2.
3112 
Reading hotkey is the same as reading normal key - by function 2.
 3112 
Reading hotkey is the same as reading normal key - by function 2.
3113 
Parameters:
 3113 
Parameters:
3114 
  * eax = 66 - function number
 3114 
  * eax = 66 - function number
3115 
  * ebx = 4 - subfunction number
 3115 
  * ebx = 4 - subfunction number
3116 
  * cl determines key scancode;
 3116 
  * cl determines key scancode;
3117 
    use cl=0 to give combinations such as Ctrl+Shift
 3117 
    use cl=0 to give combinations such as Ctrl+Shift
3118 
  * edx = 0xXYZ determines possible states of control keys:
 3118 
  * edx = 0xXYZ determines possible states of control keys:
3119 
    * Z (low 4 bits) determines state of LShift and RShift:
 3119 
    * Z (low 4 bits) determines state of LShift and RShift:
3120 
      * 0 = no key must be pressed;
 3120 
      * 0 = no key must be pressed;
3121 
      * 1 = exactly one key must be pressed;
 3121 
      * 1 = exactly one key must be pressed;
3122 
      * 2 = both keys must be pressed;
 3122 
      * 2 = both keys must be pressed;
3123 
      * 3 = must be pressed LShift, but not RShift;
 3123 
      * 3 = must be pressed LShift, but not RShift;
3124 
      * 4 = must be pressed RShift, but not LShift
 3124 
      * 4 = must be pressed RShift, but not LShift
3125 
    * Y - similar for LCtrl and RCtrl;
 3125 
    * Y - similar for LCtrl and RCtrl;
3126 
    * X - similar for LAlt and RAlt
 3126 
    * X - similar for LAlt and RAlt
3127 
Returned value:
 3127 
Returned value:
3128 
  * eax=0 - success
 3128 
  * eax=0 - success
3129 
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
 3129 
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
3130 
Remarks:
 3130 
Remarks:
3131 
  * Hotkey can work either at pressing or at release. Release
 3131 
  * Hotkey can work either at pressing or at release. Release
3132 
    scancode of a key is more on 128 than pressing scancode
 3132 
    scancode of a key is more on 128 than pressing scancode
3133 
    (i.e. high bit is set).
 3133 
    (i.e. high bit is set).
3134 
  * Several applications can set the same combination;
 3134 
  * Several applications can set the same combination;
3135 
    all such applications will be informed on pressing
 3135 
    all such applications will be informed on pressing
3136 
    such combination.
 3136 
    such combination.
3137 
 
 3137 
 
3138 
-------------- Subfunction 5 - delete installed hotkey. --------------
 3138 
-------------- Subfunction 5 - delete installed hotkey. --------------
3139 
Parameters:
 3139 
Parameters:
3140 
  * eax = 66 - function number
 3140 
  * eax = 66 - function number
3141 
  * ebx = 5 - subfunction number
 3141 
  * ebx = 5 - subfunction number
3142 
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
 3142 
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
3143 
Returned value:
 3143 
Returned value:
3144 
  * eax = 0 - success
 3144 
  * eax = 0 - success
3145 
  * eax = 1 - there is no such hotkey
 3145 
  * eax = 1 - there is no such hotkey
3146 
Remarks:
 3146 
Remarks:
3147 
  * When a process/thread terminates, all hotkey installed by it are
 3147 
  * When a process/thread terminates, all hotkey installed by it are
3148 
    deleted.
 3148 
    deleted.
3149 
  * The call to this subfunction does not affect other applications.
 3149 
  * The call to this subfunction does not affect other applications.
3150 
    If other application has defined the same combination, it will
 3150 
    If other application has defined the same combination, it will
3151 
    still receive notices.
 3151 
    still receive notices.
3152 
 
 3152 
 
3153 
--------------- Subfunction 6 - block the normal input. --------------
 3153 
--------------- Subfunction 6 - block the normal input. --------------
3154 
Parameters:
 3154 
Parameters:
3155 
  * eax = 66 - function number
 3155 
  * eax = 66 - function number
3156 
  * ebx = 6 - subfunction number
 3156 
  * ebx = 6 - subfunction number
3157 
Returned value:
 3157 
Returned value:
3158 
  * function does not return value
 3158 
  * function does not return value
3159 
Remarks:
 3159 
Remarks:
3160 
  * Blocking the normal keyboard input for installed hotkeys
 3160 
  * Blocking the normal keyboard input for installed hotkeys
3161 
  * To emulate a mouse via the keyboard, the application MOUSEMUL
 3161 
  * To emulate a mouse via the keyboard, the application MOUSEMUL
3162 
 
 3162 
 
3163 
------------ Subfunction 7 - unlock the normal input. ----------------
 3163 
------------ Subfunction 7 - unlock the normal input. ----------------
3164 
Parameters:
 3164 
Parameters:
3165 
  * eax = 66 - function number
 3165 
  * eax = 66 - function number
3166 
  * ebx = 7 - subfunction number
 3166 
  * ebx = 7 - subfunction number
3167 
Returned value:
 3167 
Returned value:
3168 
  * function does not return value
 3168 
  * function does not return value
3169 
Remarks:
 3169 
Remarks:
3170 
  * Unlocking the results of the f. 66.6
 3170 
  * Unlocking the results of the f. 66.6
3171 
  * To emulate a mouse via the keyboard, the application MOUSEMUL
 3171 
  * To emulate a mouse via the keyboard, the application MOUSEMUL
3172 
 
 3172 
 
3173 
======================================================================
 3173 
======================================================================
3174 
========= Function 67 - change position/sizes of the window. =========
 3174 
========= Function 67 - change position/sizes of the window. =========
3175 
======================================================================
 3175 
======================================================================
3176 
Parameters:
 3176 
Parameters:
3177 
  * eax = 67 - function number
 3177 
  * eax = 67 - function number
3178 
  * ebx = new x-coordinate of the window
 3178 
  * ebx = new x-coordinate of the window
3179 
  * ecx = new y-coordinate of the window
 3179 
  * ecx = new y-coordinate of the window
3180 
  * edx = new x-size of the window
 3180 
  * edx = new x-size of the window
3181 
  * esi = new y-size of the window
 3181 
  * esi = new y-size of the window
3182 
Returned value:
 3182 
Returned value:
3183 
  * function does not return value
 3183 
  * function does not return value
3184 
Remarks:
 3184 
Remarks:
3185 
  * The value -1 for a parameter means "do not change"; e.g. to move
 3185 
  * The value -1 for a parameter means "do not change"; e.g. to move
3186 
    the window without resizing it is possible to specify edx=esi=-1.
 3186 
    the window without resizing it is possible to specify edx=esi=-1.
3187 
  * Previously the window must be defined by function 0.
 3187 
  * Previously the window must be defined by function 0.
3188 
    It sets initial coordinates and sizes of the window.
 3188 
    It sets initial coordinates and sizes of the window.
3189 
  * Sizes of the window are understood in sense of function 0,
 3189 
  * Sizes of the window are understood in sense of function 0,
3190 
    that is one pixel less than real sizes.
 3190 
    that is one pixel less than real sizes.
3191 
  * The function call for maximized windows is simply ignored.
 3191 
  * The function call for maximized windows is simply ignored.
3192 
  * For windows of appropriate styles position and/or sizes can be
 3192 
  * For windows of appropriate styles position and/or sizes can be
3193 
    changed by user; current position and sizes can be obtained by
 3193 
    changed by user; current position and sizes can be obtained by
3194 
    call to function 9.
 3194 
    call to function 9.
3195 
  * The function sends to the window redraw event (with the code 1).
 3195 
  * The function sends to the window redraw event (with the code 1).
3196 
 
 3196 
 
3197 
======================================================================
 3197 
======================================================================
3198 
====== Function 68, subfunction 0 - get the task switch counter. =====
 3198 
====== Function 68, subfunction 0 - get the task switch counter. =====
3199 
======================================================================
 3199 
======================================================================
3200 
Parameters:
 3200 
Parameters:
3201 
  * eax = 68 - function number
 3201 
  * eax = 68 - function number
3202 
  * ebx = 0 - subfunction number
 3202 
  * ebx = 0 - subfunction number
3203 
Returned value:
 3203 
Returned value:
3204 
  * eax = number of task switches from the system booting
 3204 
  * eax = number of task switches from the system booting
3205 
    (modulo 2^32)
 3205 
    (modulo 2^32)
3206 
 
 3206 
 
3207 
======================================================================
 3207 
======================================================================
3208 
======= Function 68, subfunction 1 - switch to the next thread. ======
 3208 
======= Function 68, subfunction 1 - switch to the next thread. ======
3209 
======================================================================
 3209 
======================================================================
3210 
The function completes the current time slice allocated to the
 3210 
The function completes the current time slice allocated to the
3211 
thread and switches to the next. (Which thread in which process
 3211 
thread and switches to the next. (Which thread in which process
3212 
will be next, is unpredictable). Later, when execution queue
 3212 
will be next, is unpredictable). Later, when execution queue
3213 
will reach the current thread, execution will be continued.
 3213 
will reach the current thread, execution will be continued.
3214 
Parameters:
 3214 
Parameters:
3215 
  * eax = 68 - function number
 3215 
  * eax = 68 - function number
3216 
  * ebx = 1 - subfunction number
 3216 
  * ebx = 1 - subfunction number
3217 
Returned value:
 3217 
Returned value:
3218 
  * function does not return value
 3218 
  * function does not return value
3219 
 
 3219 
 
3220 
======================================================================
 3220 
======================================================================
3221 
============= Function 68, subfunction 2 - cache + rdpmc. ============
 3221 
============= Function 68, subfunction 2 - cache + rdpmc. ============
3222 
======================================================================
 3222 
======================================================================
3223 
Parameters:
 3223 
Parameters:
3224 
  * eax = 68 - function number
 3224 
  * eax = 68 - function number
3225 
  * ebx = 2 - subfunction number
 3225 
  * ebx = 2 - subfunction number
3226 
  * ecx = required action:
 3226 
  * ecx = required action:
3227 
    * ecx = 0 - enable instruction 'rdpmc'
 3227 
    * ecx = 0 - enable instruction 'rdpmc'
3228 
      (ReaD Performance-Monitoring Counters) for applications
 3228 
      (ReaD Performance-Monitoring Counters) for applications
3229 
    * ecx = 1 - find out whether cache is disabled/enabled
 3229 
    * ecx = 1 - find out whether cache is disabled/enabled
3230 
    * ecx = 2 - enable cache
 3230 
    * ecx = 2 - enable cache
3231 
    * ecx = 3 - disable cache
 3231 
    * ecx = 3 - disable cache
3232 
Returned value:
 3232 
Returned value:
3233 
  * for ecx=0:
 3233 
  * for ecx=0:
3234 
    * eax = the value of cr4
 3234 
    * eax = the value of cr4
3235 
  * for ecx=1:
 3235 
  * for ecx=1:
3236 
    * eax = (cr0 and 0x60000000):
 3236 
    * eax = (cr0 and 0x60000000):
3237 
    * eax = 0 - cache is on
 3237 
    * eax = 0 - cache is on
3238 
    * eax <> 0 - cache is off
 3238 
    * eax <> 0 - cache is off
3239 
  * for ecx=2 and ecx=3:
 3239 
  * for ecx=2 and ecx=3:
3240 
    * function does not return value
 3240 
    * function does not return value
3241 
 
 3241 
 
3242 
======================================================================
 3242 
======================================================================
3243 
=========== Function 68, subfunction 3 - read MSR-register. ==========
 3243 
=========== Function 68, subfunction 3 - read MSR-register. ==========
3244 
======================================================================
 3244 
======================================================================
3245 
MSR = Model Specific Register; the complete list of MSR-registers
 3245 
MSR = Model Specific Register; the complete list of MSR-registers
3246 
of a processor is included to the documentation on it (for example,
 3246 
of a processor is included to the documentation on it (for example,
3247 
IA-32 Intel Architecture Software Developer's Manual,
 3247 
IA-32 Intel Architecture Software Developer's Manual,
3248 
Volume 3, Appendix B); each processor family has its own subset
 3248 
Volume 3, Appendix B); each processor family has its own subset
3249 
of the MSR-registers.
 3249 
of the MSR-registers.
3250 
Parameters:
 3250 
Parameters:
3251 
  * eax = 68 - function number
 3251 
  * eax = 68 - function number
3252 
  * ebx = 3 - subfunction number
 3252 
  * ebx = 3 - subfunction number
3253 
  * ecx is ignored
 3253 
  * ecx is ignored
3254 
  * edx = MSR address
 3254 
  * edx = MSR address
3255 
Returned value:
 3255 
Returned value:
3256 
  * ebx:eax = high:low dword of the result
 3256 
  * ebx:eax = high:low dword of the result
3257 
Remarks:
 3257 
Remarks:
3258 
  * If ecx contains nonexistent or not implemented for this processor
 3258 
  * If ecx contains nonexistent or not implemented for this processor
3259 
    MSR, processor will generate an exception in the kernel, which
 3259 
    MSR, processor will generate an exception in the kernel, which
3260 
    will kill the thread.
 3260 
    will kill the thread.
3261 
  * Previously it is necessary to check, whether MSRs are supported
 3261 
  * Previously it is necessary to check, whether MSRs are supported
3262 
    as a whole, with the instruction 'cpuid'. Otherwise processor
 3262 
    as a whole, with the instruction 'cpuid'. Otherwise processor
3263 
    will generate other exception in the kernel, which will anyway
 3263 
    will generate other exception in the kernel, which will anyway
3264 
    kill the thread.
 3264 
    kill the thread.
3265 
 
 3265 
 
3266 
======================================================================
 3266 
======================================================================
3267 
========= Function 68, subfunction 4 - write to MSR-register. ========
 3267 
========= Function 68, subfunction 4 - write to MSR-register. ========
3268 
======================================================================
 3268 
======================================================================
3269 
MSR = Model Specific Register; the complete list of MSR-registers
 3269 
MSR = Model Specific Register; the complete list of MSR-registers
3270 
of a processor is included to the documentation on it (for example,
 3270 
of a processor is included to the documentation on it (for example,
3271 
IA-32 Intel Architecture Software Developer's Manual,
 3271 
IA-32 Intel Architecture Software Developer's Manual,
3272 
Volume 3, Appendix B); each processor family has its own subset
 3272 
Volume 3, Appendix B); each processor family has its own subset
3273 
of the MSR-registers.
 3273 
of the MSR-registers.
3274 
Parameters:
 3274 
Parameters:
3275 
  * eax = 68 - function number
 3275 
  * eax = 68 - function number
3276 
  * ebx = 4 - subfunction number
 3276 
  * ebx = 4 - subfunction number
3277 
  * ecx is ignored
 3277 
  * ecx is ignored
3278 
  * edx = MSR address
 3278 
  * edx = MSR address
3279 
  * esi:edi = high:low dword
 3279 
  * esi:edi = high:low dword
3280 
Returned value:
 3280 
Returned value:
3281 
  * function does not return value
 3281 
  * function does not return value
3282 
Remarks:
 3282 
Remarks:
3283 
  * If ecx contains nonexistent or not implemented for this processor
 3283 
  * If ecx contains nonexistent or not implemented for this processor
3284 
    MSR, processor will generate an exception in the kernel, which
 3284 
    MSR, processor will generate an exception in the kernel, which
3285 
    will kill the thread.
 3285 
    will kill the thread.
3286 
  * Previously it is necessary to check, whether MSRs are supported
 3286 
  * Previously it is necessary to check, whether MSRs are supported
3287 
    as a whole, with the instruction 'cpuid'. Otherwise processor
 3287 
    as a whole, with the instruction 'cpuid'. Otherwise processor
3288 
    will generate other exception in the kernel, which will anyway
 3288 
    will generate other exception in the kernel, which will anyway
3289 
    kill the thread.
 3289 
    kill the thread.
3290 
 
 3290 
 
3291 
======================================================================
 3291 
======================================================================
3292 
======= Function 68, subfunction 11 - initialize process heap. =======
 3292 
======= Function 68, subfunction 11 - initialize process heap. =======
3293 
======================================================================
 3293 
======================================================================
3294 
Parameters:
 3294 
Parameters:
3295 
  * eax = 68 - function number
 3295 
  * eax = 68 - function number
3296 
  * ebx = 11 - subfunction number
 3296 
  * ebx = 11 - subfunction number
3297 
Returned value:
 3297 
Returned value:
3298 
  * eax = 0 - failed
 3298 
  * eax = 0 - failed
3299 
  * otherwise size of created heap
 3299 
  * otherwise size of created heap
3300 
Remarks:
 3300 
Remarks:
3301 
  * The function call initializes heap, from which one can in future
 3301 
  * The function call initializes heap, from which one can in future
3302 
    allocate and free memory blocks with subfunctions 12 and 13.
 3302 
    allocate and free memory blocks with subfunctions 12 and 13.
3303 
    Heap size is equal to total amount of free application memory.
 3303 
    Heap size is equal to total amount of free application memory.
3304 
  * The second function call from the same process results in
 3304 
  * The second function call from the same process results in
3305 
    returning the size of the existing heap.
 3305 
    returning the size of the existing heap.
3306 
  * After creation of the heap calls to function 64 will be ignored.
 3306 
  * After creation of the heap calls to function 64 will be ignored.
3307 
 
 3307 
 
3308 
======================================================================
 3308 
======================================================================
3309 
======== Function 68, subfunction 12 - allocate memory block. ========
 3309 
======== Function 68, subfunction 12 - allocate memory block. ========
3310 
======================================================================
 3310 
======================================================================
3311 
Parameters:
 3311 
Parameters:
3312 
  * eax = 68 - function number
 3312 
  * eax = 68 - function number
3313 
  * ebx = 12 - subfunction number
 3313 
  * ebx = 12 - subfunction number
3314 
  * ecx = required size in bytes
 3314 
  * ecx = required size in bytes
3315 
Returned value:
 3315 
Returned value:
3316 
  * eax = pointer to the allocated block
 3316 
  * eax = pointer to the allocated block
3317 
Remarks:
 3317 
Remarks:
3318 
  * Before this call one must initialize process heap by call to
 3318 
  * Before this call one must initialize process heap by call to
3319 
    subfunction 11.
 3319 
    subfunction 11.
3320 
  * The function allocates an integer number of pages (4 Kb) in such
 3320 
  * The function allocates an integer number of pages (4 Kb) in such
3321 
    way that the real size of allocated block is more than or equal to
 3321 
    way that the real size of allocated block is more than or equal to
3322 
    requested size.
 3322 
    requested size.
3323 
 
 3323 
 
3324 
======================================================================
 3324 
======================================================================
3325 
========== Function 68, subfunction 13 - free memory block. ==========
 3325 
========== Function 68, subfunction 13 - free memory block. ==========
3326 
======================================================================
 3326 
======================================================================
3327 
Parameters:
 3327 
Parameters:
3328 
  * eax = 68 - function number
 3328 
  * eax = 68 - function number
3329 
  * ebx = 13 - subfunction number
 3329 
  * ebx = 13 - subfunction number
3330 
  * ecx = pointer to the memory block
 3330 
  * ecx = pointer to the memory block
3331 
Returned value:
 3331 
Returned value:
3332 
  * eax = 1 - success
 3332 
  * eax = 1 - success
3333 
  * eax = 0 - failed
 3333 
  * eax = 0 - failed
3334 
Remarks:
 3334 
Remarks:
3335 
  * The memory block must have been allocated by subfunction 12
 3335 
  * The memory block must have been allocated by subfunction 12
3336 
    or subfunction 20.
 3336 
    or subfunction 20.
3337 
 
 3337 
 
3338 
======================================================================
 3338 
======================================================================
3339 
===================== Function 68, subfunction 14 ====================
 3339 
===================== Function 68, subfunction 14 ====================
3340 
============ Wait for signal from another program/driver. ============
 3340 
============ Wait for signal from another program/driver. ============
3341 
======================================================================
 3341 
======================================================================
3342 
Parameters:
 3342 
Parameters:
3343 
  * eax = 68 - function number
 3343 
  * eax = 68 - function number
3344 
  * ebx = 14 - subfunction number
 3344 
  * ebx = 14 - subfunction number
3345 
  * ecx = pointer to the buffer for information (24 bytes)
 3345 
  * ecx = pointer to the buffer for information (24 bytes)
3346 
Returned value:
 3346 
Returned value:
3347 
  * buffer pointed to by ecx contains the following information:
 3347 
  * buffer pointed to by ecx contains the following information:
3348 
    * +0: dword: identifier for following data of signal
 3348 
    * +0: dword: identifier for following data of signal
3349 
    * +4: dword: data of signal (20 bytes), format of which is defined
 3349 
    * +4: dword: data of signal (20 bytes), format of which is defined
3350 
          by the first dword
 3350 
          by the first dword
3351 
 
 3351 
 
3352 
======================================================================
 3352 
======================================================================
3353 
============= Function 68, subfunction 16 - load driver. =============
 3353 
============= Function 68, subfunction 16 - load driver. =============
3354 
======================================================================
 3354 
======================================================================
3355 
Parameters:
 3355 
Parameters:
3356 
  * eax = 68 - function number
 3356 
  * eax = 68 - function number
3357 
  * ebx = 16 - subfunction number
 3357 
  * ebx = 16 - subfunction number
3358 
  * ecx = pointer to ASCIIZ-string with driver name
 3358 
  * ecx = pointer to ASCIIZ-string with driver name
3359 
Returned value:
 3359 
Returned value:
3360 
  * eax = 0 - failed
 3360 
  * eax = 0 - failed
3361 
  * otherwise eax = driver handle
 3361 
  * otherwise eax = driver handle
3362 
Remarks:
 3362 
Remarks:
3363 
  * If the driver was not loaded yet, it is loaded;
 3363 
  * If the driver was not loaded yet, it is loaded;
3364 
    if the driver was loaded yet, nothing happens.
 3364 
    if the driver was loaded yet, nothing happens.
3365 
  * Driver name is case-sensitive.
 3365 
  * Driver name is case-sensitive.
3366 
    Maximum length of the name is 16 characters, including
 3366 
    Maximum length of the name is 16 characters, including
3367 
    terminating null character, the rest is ignored.
 3367 
    terminating null character, the rest is ignored.
3368 
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
 3368 
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
3369 
 
 3369 
 
3370 
======================================================================
 3370 
======================================================================
3371 
============ Function 68, subfunction 17 - driver control. ===========
 3371 
============ Function 68, subfunction 17 - driver control. ===========
3372 
======================================================================
 3372 
======================================================================
3373 
Parameters:
 3373 
Parameters:
3374 
  * eax = 68 - function number
 3374 
  * eax = 68 - function number
3375 
  * ebx = 17 - subfunction number
 3375 
  * ebx = 17 - subfunction number
3376 
  * ecx = pointer to the control structure:
 3376 
  * ecx = pointer to the control structure:
3377 
    * +0: dword: handle of driver
 3377 
    * +0: dword: handle of driver
3378 
    * +4: dword: code of driver function
 3378 
    * +4: dword: code of driver function
3379 
    * +8: dword: pointer to input data
 3379 
    * +8: dword: pointer to input data
3380 
    * +12 = +0xC: dword: size of input data
 3380 
    * +12 = +0xC: dword: size of input data
3381 
    * +16 = +0x10: dword: pointer to output data
 3381 
    * +16 = +0x10: dword: pointer to output data
3382 
    * +20 = +0x14: dword: size of output data
 3382 
    * +20 = +0x14: dword: size of output data
3383 
Returned value:
 3383 
Returned value:
3384 
  * eax = determined by driver
 3384 
  * eax = determined by driver
3385 
Remarks:
 3385 
Remarks:
3386 
  * Function codes and the structure of input/output data
 3386 
  * Function codes and the structure of input/output data
3387 
    are defined by driver.
 3387 
    are defined by driver.
3388 
  * Previously one must obtain driver handle by subfunction 16.
 3388 
  * Previously one must obtain driver handle by subfunction 16.
3389 
 
 3389 
 
3390 
======================================================================
 3390 
======================================================================
3391 
=============== Function 68, subfunction 19 - load DLL. ==============
 3391 
=============== Function 68, subfunction 19 - load DLL. ==============
3392 
======================================================================
 3392 
======================================================================
3393 
Parameters:
 3393 
Parameters:
3394 
  * eax = 68 - function number
 3394 
  * eax = 68 - function number
3395 
  * ebx = 19 - subfunction number
 3395 
  * ebx = 19 - subfunction number
3396 
  * ecx = pointer to ASCIIZ-string with the full path to DLL
 3396 
  * ecx = pointer to ASCIIZ-string with the full path to DLL
3397 
Returned value:
 3397 
Returned value:
3398 
  * eax = 0 - failed
 3398 
  * eax = 0 - failed
3399 
  * otherwise eax = pointer to DLL export table
 3399 
  * otherwise eax = pointer to DLL export table
3400 
Remarks:
 3400 
Remarks:
3401 
  * Export table is an array of structures of 2 dword's, terminated
 3401 
  * Export table is an array of structures of 2 dword's, terminated
3402 
    by zero. The first dword in structure points to function name,
 3402 
    by zero. The first dword in structure points to function name,
3403 
    the second dword contains address of function.
 3403 
    the second dword contains address of function.
3404 
 
 3404 
 
3405 
======================================================================
 3405 
======================================================================
3406 
======= Function 68, subfunction 20 - reallocate memory block. =======
 3406 
======= Function 68, subfunction 20 - reallocate memory block. =======
3407 
======================================================================
 3407 
======================================================================
3408 
Parameters:
 3408 
Parameters:
3409 
  * eax = 68 - function number
 3409 
  * eax = 68 - function number
3410 
  * ebx = 20 - subfunction number
 3410 
  * ebx = 20 - subfunction number
3411 
  * ecx = new size in bytes
 3411 
  * ecx = new size in bytes
3412 
  * edx = pointer to already allocated block
 3412 
  * edx = pointer to already allocated block
3413 
Returned value:
 3413 
Returned value:
3414 
  * eax = pointer to the reallocated block, 0 = error
 3414 
  * eax = pointer to the reallocated block, 0 = error
3415 
Remarks:
 3415 
Remarks:
3416 
  * Before this call one must initialize process heap by call to
 3416 
  * Before this call one must initialize process heap by call to
3417 
    subfunction 11.
 3417 
    subfunction 11.
3418 
  * The function allocates an integer number of pages (4 Kb) in such
 3418 
  * The function allocates an integer number of pages (4 Kb) in such
3419 
    way that the real size of allocated block is more than or equal to
 3419 
    way that the real size of allocated block is more than or equal to
3420 
    requested size.
 3420 
    requested size.
3421 
  * If edx=0, the function call is equivalent to memory allocation
 3421 
  * If edx=0, the function call is equivalent to memory allocation
3422 
    with subfunction 12. Otherwise the block at edx
 3422 
    with subfunction 12. Otherwise the block at edx
3423 
    must be allocated earlier with subfunction 12 or this subfunction.
 3423 
    must be allocated earlier with subfunction 12 or this subfunction.
3424 
  * If ecx=0, the function frees memory block at edx and returns 0.
 3424 
  * If ecx=0, the function frees memory block at edx and returns 0.
3425 
  * The contents of the block are unchanged up to the shorter of
 3425 
  * The contents of the block are unchanged up to the shorter of
3426 
    the new and old sizes.
 3426 
    the new and old sizes.
3427 
 
 3427 
 
3428 
======================================================================
 3428 
======================================================================
3429 
=========== Function 68, subfunction 21 - load driver PE. ============
 3429 
=========== Function 68, subfunction 21 - load driver PE. ============
3430 
======================================================================
 3430 
======================================================================
3431 
Parameters:
 3431 
Parameters:
3432 
  * eax = 68 - function number
 3432 
  * eax = 68 - function number
3433 
  * ebx = 21 - subfunction number
 3433 
  * ebx = 21 - subfunction number
3434 
  * ecx = pointer to ASCIIZ-string with driver name
 3434 
  * ecx = pointer to ASCIIZ-string with driver name
3435 
  * edx = pointer to command line
 3435 
  * edx = pointer to command line
3436 
Returned value:
 3436 
Returned value:
3437 
  * eax = 0 - failed
 3437 
  * eax = 0 - failed
3438 
  * otherwise eax = driver handle
 3438 
  * otherwise eax = driver handle
3439 
Remarks:
 3439 
Remarks:
3440 
  * If the driver was not loaded yet, it is loaded;
 3440 
  * If the driver was not loaded yet, it is loaded;
3441 
    if the driver was loaded yet, nothing happens.
 3441 
    if the driver was loaded yet, nothing happens.
3442 
 
 3442 
 
3443 
======================================================================
 3443 
======================================================================
3444 
======== Function 68, subfunction 22 - open named memory area. =======
 3444 
======== Function 68, subfunction 22 - open named memory area. =======
3445 
======================================================================
 3445 
======================================================================
3446 
Parameters:
 3446 
Parameters:
3447 
  * eax = 68 - function number
 3447 
  * eax = 68 - function number
3448 
  * ebx = 22 - subfunction number
 3448 
  * ebx = 22 - subfunction number
3449 
  * ecx = area name. Maximum of 31 characters with terminating zero
 3449 
  * ecx = area name. Maximum of 31 characters with terminating zero
3450 
  * edx = area size in bytes for SHM_CREATE and SHM_OPEN_ALWAYS
 3450 
  * edx = area size in bytes for SHM_CREATE and SHM_OPEN_ALWAYS
3451 
  * esi = flags for open and access:
 3451 
  * esi = flags for open and access:
3452 
    * SHM_OPEN        = 0x00 - open existing memory area. If an area
 3452 
    * SHM_OPEN        = 0x00 - open existing memory area. If an area
3453 
                          with such name does not exist, the function
 3453 
                          with such name does not exist, the function
3454 
                          will return error code 5.
 3454 
                          will return error code 5.
3455 
    * SHM_OPEN_ALWAYS = 0x04 - open existing or create new
 3455 
    * SHM_OPEN_ALWAYS = 0x04 - open existing or create new
3456 
                          memory area.
 3456 
                          memory area.
3457 
    * SHM_CREATE      = 0x08 - create new memory area. If an area
 3457 
    * SHM_CREATE      = 0x08 - create new memory area. If an area
3458 
                          with such name already exists, the function
 3458 
                          with such name already exists, the function
3459 
                          will return error code 10.
 3459 
                          will return error code 10.
3460 
    * SHM_READ        = 0x00 - only read access
 3460 
    * SHM_READ        = 0x00 - only read access
3461 
    * SHM_WRITE       = 0x01 - read and write access
 3461 
    * SHM_WRITE       = 0x01 - read and write access
3462 
Returned value:
 3462 
Returned value:
3463 
  * eax = pointer to memory area, 0 if error has occured
 3463 
  * eax = pointer to memory area, 0 if error has occured
3464 
  * if new area is created (SHM_CREATE or SHM_OPEN_ALWAYS):
 3464 
  * if new area is created (SHM_CREATE or SHM_OPEN_ALWAYS):
3465 
    edx = 0 - success, otherwise - error code
 3465 
    edx = 0 - success, otherwise - error code
3466 
  * if existing area is opened (SHM_OPEN or SHM_OPEN_ALWAYS):
 3466 
  * if existing area is opened (SHM_OPEN or SHM_OPEN_ALWAYS):
3467 
    edx = error code (if eax=0) or area size in bytes
 3467 
    edx = error code (if eax=0) or area size in bytes
3468 
Error codes:
 3468 
Error codes:
3469 
  * E_NOTFOUND = 5
 3469 
  * E_NOTFOUND = 5
3470 
  * E_ACCESS = 10
 3470 
  * E_ACCESS = 10
3471 
  * E_NOMEM = 30
 3471 
  * E_NOMEM = 30
3472 
  * E_PARAM = 33
 3472 
  * E_PARAM = 33
3473 
Remarks:
 3473 
Remarks:
3474 
  * Before this call one must initialize process heap by call to
 3474 
  * Before this call one must initialize process heap by call to
3475 
    subfunction 11.
 3475 
    subfunction 11.
3476 
  * If a new area is created, access flags set maximal rights
 3476 
  * If a new area is created, access flags set maximal rights
3477 
    for other processes. An attempt from other process to open
 3477 
    for other processes. An attempt from other process to open
3478 
    with denied rights will fail with error code E_ACCESS.
 3478 
    with denied rights will fail with error code E_ACCESS.
3479 
  * The process which has created an area always has write access.
 3479 
  * The process which has created an area always has write access.
3480 
 
 3480 
 
3481 
======================================================================
 3481 
======================================================================
3482 
======= Function 68, subfunction 23 - close named memory area. =======
 3482 
======= Function 68, subfunction 23 - close named memory area. =======
3483 
======================================================================
 3483 
======================================================================
3484 
Parameters:
 3484 
Parameters:
3485 
  * eax = 68 - function number
 3485 
  * eax = 68 - function number
3486 
  * ebx = 23 - subfunction number
 3486 
  * ebx = 23 - subfunction number
3487 
  * ecx = area name. Maximum of 31 characters with terminating zero
 3487 
  * ecx = area name. Maximum of 31 characters with terminating zero
3488 
Returned value:
 3488 
Returned value:
3489 
  * eax destroyed
 3489 
  * eax destroyed
3490 
Remarks:
 3490 
Remarks:
3491 
  * A memory area is physically freed (with deleting all data and
 3491 
  * A memory area is physically freed (with deleting all data and
3492 
    freeing physical memory), when all threads which have opened
 3492 
    freeing physical memory), when all threads which have opened
3493 
    this area will close it.
 3493 
    this area will close it.
3494 
  * When thread is terminating, all opened by it areas are closed.
 3494 
  * When thread is terminating, all opened by it areas are closed.
3495 
 
 3495 
 
3496 
======================================================================
 3496 
======================================================================
3497 
======== Function 68, subfunction 24 - set exception handler. ========
 3497 
======== Function 68, subfunction 24 - set exception handler. ========
3498 
======================================================================
 3498 
======================================================================
3499 
Parameters:
 3499 
Parameters:
3500 
  * eax = 68 - function number
 3500 
  * eax = 68 - function number
3501 
  * ebx = 24 - subfunction number
 3501 
  * ebx = 24 - subfunction number
3502 
  * ecx = address of the new exception handler
 3502 
  * ecx = address of the new exception handler
3503 
  * edx = the mask of handled exceptions
 3503 
  * edx = the mask of handled exceptions
3504 
Returned value:
 3504 
Returned value:
3505 
  * eax = address of the old exception handler (0, if it was not set)
 3505 
  * eax = address of the old exception handler (0, if it was not set)
3506 
  * ebx = the old mask of handled exceptions
 3506 
  * ebx = the old mask of handled exceptions
3507 
Remarks:
 3507 
Remarks:
3508 
  * Bit number in mask of exceptions corresponds to exception number
 3508 
  * Bit number in mask of exceptions corresponds to exception number
3509 
    in CPU-specification (Intel-PC). For example, FPU exceptions have
 3509 
    in CPU-specification (Intel-PC). For example, FPU exceptions have
3510 
    number 16 (#MF), and SSE exceptions - 19 (#XF).
 3510 
    number 16 (#MF), and SSE exceptions - 19 (#XF).
3511 
  * The current implementation ignores the inquiry for hook of 7
 3511 
  * The current implementation ignores the inquiry for hook of 7
3512 
    exception - the system handles #NM by its own.
 3512 
    exception - the system handles #NM by its own.
3513 
  * The exception handler is called with exception number as first
 3513 
  * The exception handler is called with exception number as first
3514 
    (and only) stack parameter. So, correct exit from the handler is
 3514 
    (and only) stack parameter. So, correct exit from the handler is
3515 
    RET 4. It returns to the instruction, that caused the exception,
 3515 
    RET 4. It returns to the instruction, that caused the exception,
3516 
    for faults, and to the next instruction for traps (see
 3516 
    for faults, and to the next instruction for traps (see
3517 
    classification of exceptions in CPU specification).
 3517 
    classification of exceptions in CPU specification).
3518 
  * When user handler receives control, the corresponding bit in
 3518 
  * When user handler receives control, the corresponding bit in
3519 
    the exception mask is cleared. Raising this exception
 3519 
    the exception mask is cleared. Raising this exception
3520 
    in consequence leads to default handling, that is,
 3520 
    in consequence leads to default handling, that is,
3521 
    terminating the application in absence of debugger or
 3521 
    terminating the application in absence of debugger or
3522 
    suspend with notification of debugger otherwise.
 3522 
    suspend with notification of debugger otherwise.
3523 
  * After user handler completes critical operations, it can set
 3523 
  * After user handler completes critical operations, it can set
3524 
    the corresponding bit in the exception mask with subfunction 25.
 3524 
    the corresponding bit in the exception mask with subfunction 25.
3525 
    Also user handler is responsible for clearing exceptions flags in
 3525 
    Also user handler is responsible for clearing exceptions flags in
3526 
    FPU and/or SSE.
 3526 
    FPU and/or SSE.
3527 
 
 3527 
 
3528 
======================================================================
 3528 
======================================================================
3529 
====== Function 68, subfunction 25 - set FPU exception handler. ======
 3529 
====== Function 68, subfunction 25 - set FPU exception handler. ======
3530 
======================================================================
 3530 
======================================================================
3531 
Parameters:
 3531 
Parameters:
3532 
  * eax = 68 - function number
 3532 
  * eax = 68 - function number
3533 
  * ebx = 25 - subfunction number
 3533 
  * ebx = 25 - subfunction number
3534 
  * ecx = signal number
 3534 
  * ecx = signal number
3535 
  * edx = value of activity (0/1)
 3535 
  * edx = value of activity (0/1)
3536 
Returned value:
 3536 
Returned value:
3537 
  * eax = -1 - invalid signal number
 3537 
  * eax = -1 - invalid signal number
3538 
  * otherwise eax = old value of activity for this signal (0/1)
 3538 
  * otherwise eax = old value of activity for this signal (0/1)
3539 
Remarks:
 3539 
Remarks:
3540 
  * In current implementation only mask for user excepton handler,
 3540 
  * In current implementation only mask for user excepton handler,
3541 
    which has been previously set by subfunction 24,
 3541 
    which has been previously set by subfunction 24,
3542 
    is changed. Signal number corresponds to exception number.
 3542 
    is changed. Signal number corresponds to exception number.
3543 
 
 3543 
 
3544 
======================================================================
 3544 
======================================================================
3545 
====== Function 68, subfunction 26 - release memory pages ============
 3545 
====== Function 68, subfunction 26 - release memory pages ============
3546 
======================================================================
 3546 
======================================================================
3547 
Parameters:
 3547 
Parameters:
3548 
  * eax = 68 - function number
 3548 
  * eax = 68 - function number
3549 
  * ebx = 26 - subfunction number
 3549 
  * ebx = 26 - subfunction number
3550 
  * ecx = pointer to the memory block, allocated by subfunction 12
 3550 
  * ecx = pointer to the memory block, allocated by subfunction 12
3551 
  * edx = offset from the block beginnings
 3551 
  * edx = offset from the block beginnings
3552 
  * esi = the size of the region of memory to release, in bytes
 3552 
  * esi = the size of the region of memory to release, in bytes
3553 
Remarks:
 3553 
Remarks:
3554 
  * function release range of pages from ecx+edx to ecx+edx+esi
 3554 
  * function release range of pages from ecx+edx to ecx+edx+esi
3555 
    and set virtual memory into reserved state.
 3555 
    and set virtual memory into reserved state.
3556 
 
 3556 
 
3557 
======================================================================
 3557 
======================================================================
3558 
========== Function 68, subfunction 27 - load file ===================
 3558 
========== Function 68, subfunction 27 - load file ===================
3559 
======================================================================
 3559 
======================================================================
3560 
Parameters:
 3560 
Parameters:
3561 
  * eax = 68 - function number
 3561 
  * eax = 68 - function number
3562 
  * ebx = 27 - subfunction number
 3562 
  * ebx = 27 - subfunction number
3563 
  * ecx = pointer to ASCIIZ-string with the filename
 3563 
  * ecx = pointer to ASCIIZ-string with the filename
3564 
Returned value:
 3564 
Returned value:
3565 
  * eax = pointer to the loaded file, or zero
 3565 
  * eax = pointer to the loaded file, or zero
3566 
  * edx = size of the loaded file, or zero
 3566 
  * edx = size of the loaded file, or zero
3567 
Remarks:
 3567 
Remarks:
3568 
  * function loads file and unpacks, if necessary
 3568 
  * function loads file and unpacks, if necessary
3569 
 
 3569 
 
3570 
======================================================================
 3570 
======================================================================
3571 
====================== Function 69 - debugging. ======================
 3571 
====================== Function 69 - debugging. ======================
3572 
======================================================================
 3572 
======================================================================
3573 
A process can load other process as debugged by set of corresponding
 3573 
A process can load other process as debugged by set of corresponding
3574 
bit by call to subfunction 7 of function 70.
 3574 
bit by call to subfunction 7 of function 70.
3575 
A process can have only one debugger; one process can debug some
 3575 
A process can have only one debugger; one process can debug some
3576 
others. The system notifies debugger on events occuring with
 3576 
others. The system notifies debugger on events occuring with
3577 
debugged process. Messages are written to the buffer defined by
 3577 
debugged process. Messages are written to the buffer defined by
3578 
subfunction 0.
 3578 
subfunction 0.
3579 
Format of a message:
 3579 
Format of a message:
3580 
  * +0: dword: message code
 3580 
  * +0: dword: message code
3581 
  * +4: dword: PID of debugged process
 3581 
  * +4: dword: PID of debugged process
3582 
  * +8: there can be additional data depending on message code
 3582 
  * +8: there can be additional data depending on message code
3583 
Message codes:
 3583 
Message codes:
3584 
  * 1 = exception
 3584 
  * 1 = exception
3585 
    * in addition dword-number of the exception is given
 3585 
    * in addition dword-number of the exception is given
3586 
    * process is suspended
 3586 
    * process is suspended
3587 
  * 2 = process has terminated
 3587 
  * 2 = process has terminated
3588 
    * comes at any termination: both through the system function -1,
 3588 
    * comes at any termination: both through the system function -1,
3589 
      and at "murder" by any other process (including debugger itself)
 3589 
      and at "murder" by any other process (including debugger itself)
3590 
  * 3 = debug exception int 1 = #DB
 3590 
  * 3 = debug exception int 1 = #DB
3591 
    * in addition dword-image of the register DR6 is given:
 3591 
    * in addition dword-image of the register DR6 is given:
3592 
      * bits 0-3: condition of the corresponding breakpoint (set by
 3592 
      * bits 0-3: condition of the corresponding breakpoint (set by
3593 
        subfunction 9) is satisfied
 3593 
        subfunction 9) is satisfied
3594 
      * bit 14: exception has occured because of the trace mode
 3594 
      * bit 14: exception has occured because of the trace mode
3595 
        (flag TF is set TF)
 3595 
        (flag TF is set TF)
3596 
    * process is suspended
 3596 
    * process is suspended
3597 
When debugger terminates, all debugged processes are killed.
 3597 
When debugger terminates, all debugged processes are killed.
3598 
If debugger does not want this, it must previously detach by
 3598 
If debugger does not want this, it must previously detach by
3599 
subfunction 3.
 3599 
subfunction 3.
3600 
 
 3600 
 
3601 
All subfunctions are applicable only to processes/threads started
 3601 
All subfunctions are applicable only to processes/threads started
3602 
from the current by function 70 with set debugging flag.
 3602 
from the current by function 70 with set debugging flag.
3603 
Debugging of multithreaded programs is not supported yet.
 3603 
Debugging of multithreaded programs is not supported yet.
3604 
The full list of subfunctions:
 3604 
The full list of subfunctions:
3605 
  * subfunction 0 - define data area for debug messages
 3605 
  * subfunction 0 - define data area for debug messages
3606 
  * subfunction 1 - get contents of registers of debugged thread
 3606 
  * subfunction 1 - get contents of registers of debugged thread
3607 
  * subfunction 2 - set contents of registers of debugged thread
 3607 
  * subfunction 2 - set contents of registers of debugged thread
3608 
  * subfunction 3 - detach from debugged process
 3608 
  * subfunction 3 - detach from debugged process
3609 
  * subfunction 4 - suspend debugged thread
 3609 
  * subfunction 4 - suspend debugged thread
3610 
  * subfunction 5 - resume debugged thread
 3610 
  * subfunction 5 - resume debugged thread
3611 
  * subfunction 6 - read from the memory of debugged process
 3611 
  * subfunction 6 - read from the memory of debugged process
3612 
  * subfunction 7 - write to the memory of debugged process
 3612 
  * subfunction 7 - write to the memory of debugged process
3613 
  * subfunction 8 - terminate debugged thread
 3613 
  * subfunction 8 - terminate debugged thread
3614 
  * subfunction 9 - set/clear hardware breakpoint
 3614 
  * subfunction 9 - set/clear hardware breakpoint
3615 
 
 3615 
 
3616 
======================================================================
 3616 
======================================================================
3617 
= Function 69, subfunction 0 - define data area fror debug messages. =
 3617 
= Function 69, subfunction 0 - define data area fror debug messages. =
3618 
======================================================================
 3618 
======================================================================
3619 
Parameters:
 3619 
Parameters:
3620 
  * eax = 69 - function number
 3620 
  * eax = 69 - function number
3621 
  * ebx = 0 - subfunction number
 3621 
  * ebx = 0 - subfunction number
3622 
  * ecx = pointer
 3622 
  * ecx = pointer
3623 
Format of data area:
 3623 
Format of data area:
3624 
  * +0: dword: N = buffer size (not including this header)
 3624 
  * +0: dword: N = buffer size (not including this header)
3625 
  * +4: dword: occupied place
 3625 
  * +4: dword: occupied place
3626 
  * +8: N*byte: buffer
 3626 
  * +8: N*byte: buffer
3627 
Returned value:
 3627 
Returned value:
3628 
  * function does not return value
 3628 
  * function does not return value
3629 
Remarks:
 3629 
Remarks:
3630 
  * If the size field is negative, the buffer is considered locked
 3630 
  * If the size field is negative, the buffer is considered locked
3631 
    and at arrival of new message the system will wait.
 3631 
    and at arrival of new message the system will wait.
3632 
    For synchronization frame all work with the buffer by operations
 3632 
    For synchronization frame all work with the buffer by operations
3633 
    lock/unlock
 3633 
    lock/unlock
3634 
    	neg	[bufsize]
 3634 
    	neg	[bufsize]
3635 
  * Data in the buffer are considered as array of items with variable
 3635 
  * Data in the buffer are considered as array of items with variable
3636 
    length - messages. Format of a message is explained in
 3636 
    length - messages. Format of a message is explained in
3637 
    general description.
 3637 
    general description.
3638 
 
 3638 
 
3639 
======================================================================
 3639 
======================================================================
3640 
===================== Function 69, subfunction 1 =====================
 3640 
===================== Function 69, subfunction 1 =====================
3641 
============ Get contents of registers of debugged thread. ===========
 3641 
============ Get contents of registers of debugged thread. ===========
3642 
======================================================================
 3642 
======================================================================
3643 
Parameters:
 3643 
Parameters:
3644 
  * eax = 69 - function number
 3644 
  * eax = 69 - function number
3645 
  * ebx = 1 - subfunction number
 3645 
  * ebx = 1 - subfunction number
3646 
  * ecx = thread identifier
 3646 
  * ecx = thread identifier
3647 
  * edx = size of context structure, must be 0x28=40 bytes
 3647 
  * edx = size of context structure, must be 0x28=40 bytes
3648 
  * esi = pointer to context structure
 3648 
  * esi = pointer to context structure
3649 
Returned value:
 3649 
Returned value:
3650 
  * function does not return value
 3650 
  * function does not return value
3651 
Format of context structure: (FPU is not supported yet)
 3651 
Format of context structure: (FPU is not supported yet)
3652 
  * +0: dword: eip
 3652 
  * +0: dword: eip
3653 
  * +4: dword: eflags
 3653 
  * +4: dword: eflags
3654 
  * +8: dword: eax
 3654 
  * +8: dword: eax
3655 
  * +12 = +0xC: dword: ecx
 3655 
  * +12 = +0xC: dword: ecx
3656 
  * +16 = +0x10: dword: edx
 3656 
  * +16 = +0x10: dword: edx
3657 
  * +20 = +0x14: dword: ebx
 3657 
  * +20 = +0x14: dword: ebx
3658 
  * +24 = +0x18: dword: esp
 3658 
  * +24 = +0x18: dword: esp
3659 
  * +28 = +0x1C: dword: ebp
 3659 
  * +28 = +0x1C: dword: ebp
3660 
  * +32 = +0x20: dword: esi
 3660 
  * +32 = +0x20: dword: esi
3661 
  * +36 = +0x24: dword: edi
 3661 
  * +36 = +0x24: dword: edi
3662 
Remarks:
 3662 
Remarks:
3663 
  * If the thread executes code of ring-0, the function returns
 3663 
  * If the thread executes code of ring-0, the function returns
3664 
    contents of registers of ring-3.
 3664 
    contents of registers of ring-3.
3665 
  * Process must be loaded for debugging (as is shown in
 3665 
  * Process must be loaded for debugging (as is shown in
3666 
    general description).
 3666 
    general description).
3667 
 
 3667 
 
3668 
======================================================================
 3668 
======================================================================
3669 
===================== Function 69, subfunction 2 =====================
 3669 
===================== Function 69, subfunction 2 =====================
3670 
============ Set contents of registers of debugged thread. ===========
 3670 
============ Set contents of registers of debugged thread. ===========
3671 
======================================================================
 3671 
======================================================================
3672 
Parameters:
 3672 
Parameters:
3673 
  * eax = 69 - function number
 3673 
  * eax = 69 - function number
3674 
  * ebx = 2 - subfunction number
 3674 
  * ebx = 2 - subfunction number
3675 
  * ecx = thread identifier
 3675 
  * ecx = thread identifier
3676 
  * edx = size of context structure, must be 0x28=40 bytes
 3676 
  * edx = size of context structure, must be 0x28=40 bytes
3677 
Returned value:
 3677 
Returned value:
3678 
  * function does not return value
 3678 
  * function does not return value
3679 
Format of context structure is shown in the description of
 3679 
Format of context structure is shown in the description of
3680 
subfunction 1.
 3680 
subfunction 1.
3681 
Remarks:
 3681 
Remarks:
3682 
  * If the thread executes code of ring-0, the function returns
 3682 
  * If the thread executes code of ring-0, the function returns
3683 
    contents of registers of ring-3.
 3683 
    contents of registers of ring-3.
3684 
  * Process must be loaded for debugging (as is shown in
 3684 
  * Process must be loaded for debugging (as is shown in
3685 
    general description).
 3685 
    general description).
3686 
 
 3686 
 
3687 
======================================================================
 3687 
======================================================================
3688 
===== Function 69, subfunction 3 - detach from debugged process. =====
 3688 
===== Function 69, subfunction 3 - detach from debugged process. =====
3689 
======================================================================
 3689 
======================================================================
3690 
Parameters:
 3690 
Parameters:
3691 
  * eax = 69 - function number
 3691 
  * eax = 69 - function number
3692 
  * ebx = 3 - subfunction number
 3692 
  * ebx = 3 - subfunction number
3693 
  * ecx = identifier
 3693 
  * ecx = identifier
3694 
Returned value:
 3694 
Returned value:
3695 
  * function does not return value
 3695 
  * function does not return value
3696 
Remarks:
 3696 
Remarks:
3697 
  * If the process was suspended, it resumes execution.
 3697 
  * If the process was suspended, it resumes execution.
3698 
 
 3698 
 
3699 
======================================================================
 3699 
======================================================================
3700 
======== Function 69, subfunction 4 - suspend debugged thread. =======
 3700 
======== Function 69, subfunction 4 - suspend debugged thread. =======
3701 
======================================================================
 3701 
======================================================================
3702 
Parameters:
 3702 
Parameters:
3703 
  * eax = 69 - function number
 3703 
  * eax = 69 - function number
3704 
  * ebx = 4 - subfunction number
 3704 
  * ebx = 4 - subfunction number
3705 
  * ecx = thread identifier
 3705 
  * ecx = thread identifier
3706 
Returned value:
 3706 
Returned value:
3707 
  * function does not return value
 3707 
  * function does not return value
3708 
Remarks:
 3708 
Remarks:
3709 
  * Process must be loaded for debugging (as is shown in
 3709 
  * Process must be loaded for debugging (as is shown in
3710 
    general description).
 3710 
    general description).
3711 
 
 3711 
 
3712 
======================================================================
 3712 
======================================================================
3713 
======== Function 69, subfunction 5 - resume debugged thread. ========
 3713 
======== Function 69, subfunction 5 - resume debugged thread. ========
3714 
======================================================================
 3714 
======================================================================
3715 
Parameters:
 3715 
Parameters:
3716 
  * eax = 69 - function number
 3716 
  * eax = 69 - function number
3717 
  * ebx = 5 - subfunction number
 3717 
  * ebx = 5 - subfunction number
3718 
  * ecx = thread identifier
 3718 
  * ecx = thread identifier
3719 
Returned value:
 3719 
Returned value:
3720 
  * function does not return value
 3720 
  * function does not return value
3721 
Remarks:
 3721 
Remarks:
3722 
  * Process must be loaded for debugging (as is shown in
 3722 
  * Process must be loaded for debugging (as is shown in
3723 
    general description).
 3723 
    general description).
3724 
 
 3724 
 
3725 
======================================================================
 3725 
======================================================================
3726 
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
 3726 
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
3727 
======================================================================
 3727 
======================================================================
3728 
Parameters:
 3728 
Parameters:
3729 
  * eax = 69 - function number
 3729 
  * eax = 69 - function number
3730 
  * ebx = 6 - subfunction number
 3730 
  * ebx = 6 - subfunction number
3731 
  * ecx = identifier
 3731 
  * ecx = identifier
3732 
  * edx = number of bytes to read
 3732 
  * edx = number of bytes to read
3733 
  * esi = address in the memory of debugged process
 3733 
  * esi = address in the memory of debugged process
3734 
  * edi = pointer to buffer for data
 3734 
  * edi = pointer to buffer for data
3735 
Returned value:
 3735 
Returned value:
3736 
  * eax = -1 at an error (invalid PID or buffer)
 3736 
  * eax = -1 at an error (invalid PID or buffer)
3737 
  * otherwise eax = number of read bytes (possibly, 0,
 3737 
  * otherwise eax = number of read bytes (possibly, 0,
3738 
    if esi is too large)
 3738 
    if esi is too large)
3739 
Remarks:
 3739 
Remarks:
3740 
  * Process must be loaded for debugging (as is shown in
 3740 
  * Process must be loaded for debugging (as is shown in
3741 
    general description).
 3741 
    general description).
3742 
 
 3742 
 
3743 
======================================================================
 3743 
======================================================================
3744 
== Function 69, subfunction 7 - write to memory of debugged process. =
 3744 
== Function 69, subfunction 7 - write to memory of debugged process. =
3745 
======================================================================
 3745 
======================================================================
3746 
Parameters:
 3746 
Parameters:
3747 
  * eax = 69 - function number
 3747 
  * eax = 69 - function number
3748 
  * ebx = 7 - subfunction number
 3748 
  * ebx = 7 - subfunction number
3749 
  * ecx = identifier
 3749 
  * ecx = identifier
3750 
  * edx = number of bytes to write
 3750 
  * edx = number of bytes to write
3751 
  * esi = address of memory in debugged process
 3751 
  * esi = address of memory in debugged process
3752 
  * edi = pointer to data
 3752 
  * edi = pointer to data
3753 
Returned value:
 3753 
Returned value:
3754 
  * eax = -1 at an error (invalid PID or buffer)
 3754 
  * eax = -1 at an error (invalid PID or buffer)
3755 
  * otherwise eax = number of written bytes (possibly, 0,
 3755 
  * otherwise eax = number of written bytes (possibly, 0,
3756 
    if esi is too large)
 3756 
    if esi is too large)
3757 
Remarks:
 3757 
Remarks:
3758 
  * Process must be loaded for debugging (as is shown in
 3758 
  * Process must be loaded for debugging (as is shown in
3759 
    general description).
 3759 
    general description).
3760 
 
 3760 
 
3761 
======================================================================
 3761 
======================================================================
3762 
======= Function 69, subfunction 8 - terminate debugged thread. ======
 3762 
======= Function 69, subfunction 8 - terminate debugged thread. ======
3763 
======================================================================
 3763 
======================================================================
3764 
Parameters:
 3764 
Parameters:
3765 
  * eax = 69 - function number
 3765 
  * eax = 69 - function number
3766 
  * ebx = 8 - subfunction number
 3766 
  * ebx = 8 - subfunction number
3767 
  * ecx = identifier
 3767 
  * ecx = identifier
3768 
Returned value:
 3768 
Returned value:
3769 
  * function does not return value
 3769 
  * function does not return value
3770 
Remarks:
 3770 
Remarks:
3771 
  * Process must be loaded for debugging (as is shown in
 3771 
  * Process must be loaded for debugging (as is shown in
3772 
    general description).
 3772 
    general description).
3773 
  * The function is similar to subfunction 2 of function 18
 3773 
  * The function is similar to subfunction 2 of function 18
3774 
    with two differences: it requires first remark and
 3774 
    with two differences: it requires first remark and
3775 
    accepts PID rather than slot number.
 3775 
    accepts PID rather than slot number.
3776 
 
 3776 
 
3777 
======================================================================
 3777 
======================================================================
3778 
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
 3778 
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
3779 
======================================================================
 3779 
======================================================================
3780 
Parameters:
 3780 
Parameters:
3781 
  * eax = 69 - function number
 3781 
  * eax = 69 - function number
3782 
  * ebx = 9 - subfunction number
 3782 
  * ebx = 9 - subfunction number
3783 
  * ecx = thread identifier
 3783 
  * ecx = thread identifier
3784 
  * dl = index of breakpoint, from 0 to 3 inclusively
 3784 
  * dl = index of breakpoint, from 0 to 3 inclusively
3785 
  * dh = flags:
 3785 
  * dh = flags:
3786 
    * if high bit is cleared - set breakpoint:
 3786 
    * if high bit is cleared - set breakpoint:
3787 
      * bits 0-1 - condition:
 3787 
      * bits 0-1 - condition:
3788 
        * 00 = breakpoint on execution
 3788 
        * 00 = breakpoint on execution
3789 
        * 01 = breakpoint on read
 3789 
        * 01 = breakpoint on read
3790 
        * 11 = breakpoint on read/write
 3790 
        * 11 = breakpoint on read/write
3791 
      * bits 2-3 - length; for breakpoints on exception it must be
 3791 
      * bits 2-3 - length; for breakpoints on exception it must be
3792 
        00, otherwise one of
 3792 
        00, otherwise one of
3793 
        * 00 = byte
 3793 
        * 00 = byte
3794 
        * 01 = word
 3794 
        * 01 = word
3795 
        * 11 = dword
 3795 
        * 11 = dword
3796 
      * esi = breakpoint address; must be aligned according to
 3796 
      * esi = breakpoint address; must be aligned according to
3797 
        the length (i.e. must be even for word breakpoints,
 3797 
        the length (i.e. must be even for word breakpoints,
3798 
        divisible by 4 for dword)
 3798 
        divisible by 4 for dword)
3799 
    * if high bit is set - clear breakpoint
 3799 
    * if high bit is set - clear breakpoint
3800 
Returned value:
 3800 
Returned value:
3801 
  * eax = 0 - success
 3801 
  * eax = 0 - success
3802 
  * eax = 1 - error in the input data
 3802 
  * eax = 1 - error in the input data
3803 
  * eax = 2 - (reserved, is never returned in the current
 3803 
  * eax = 2 - (reserved, is never returned in the current
3804 
    implementation) a global breakpoint with that index is already set
 3804 
    implementation) a global breakpoint with that index is already set
3805 
Remarks:
 3805 
Remarks:
3806 
  * Process must be loaded for debugging (as is shown in
 3806 
  * Process must be loaded for debugging (as is shown in
3807 
    general description).
 3807 
    general description).
3808 
  * Hardware breakpoints are implemented through DRx-registers of
 3808 
  * Hardware breakpoints are implemented through DRx-registers of
3809 
    the processor, all limitations results from this.
 3809 
    the processor, all limitations results from this.
3810 
  * The function can reinstall the breakpoint, previously set
 3810 
  * The function can reinstall the breakpoint, previously set
3811 
    by it (and it does not inform on this).
 3811 
    by it (and it does not inform on this).
3812 
    Carry on the list of set breakpoints in the debugger.
 3812 
    Carry on the list of set breakpoints in the debugger.
3813 
  * Breakpoints generate debug exception #DB, on which the system
 3813 
  * Breakpoints generate debug exception #DB, on which the system
3814 
    notifies debugger.
 3814 
    notifies debugger.
3815 
  * Breakpoints on write and read/write act after
 3815 
  * Breakpoints on write and read/write act after
3816 
    execution of the caused it instruction.
 3816 
    execution of the caused it instruction.
3817 
 
 3817 
 
3818 
======================================================================
 3818 
======================================================================
3819 
==== Function 70 - work with file system with long names support. ====
 3819 
==== Function 70 - work with file system with long names support. ====
3820 
======================================================================
 3820 
======================================================================
3821 
Parameters:
 3821 
Parameters:
3822 
  * eax = 70
 3822 
  * eax = 70
3823 
  * ebx = pointer to the information structure
 3823 
  * ebx = pointer to the information structure
3824 
Returned value:
 3824 
Returned value:
3825 
  * eax = 0 - success; otherwise file system error code
 3825 
  * eax = 0 - success; otherwise file system error code
3826 
  * some subfunctions return value in other registers too
 3826 
  * some subfunctions return value in other registers too
3827 
General format of the information structure:
 3827 
General format of the information structure:
3828 
  * +0: dword: subfunction number
 3828 
  * +0: dword: subfunction number
3829 
  * +4: dword: file offset
 3829 
  * +4: dword: file offset
3830 
  * +8: dword: high dword of offset (must be 0) or flags field
 3830 
  * +8: dword: high dword of offset (must be 0) or flags field
3831 
  * +12 = +0xC: dword: size
 3831 
  * +12 = +0xC: dword: size
3832 
  * +16 = +0x10: dword: pointer to data
 3832 
  * +16 = +0x10: dword: pointer to data
3833 
  * +20 = +0x14: n db: ASCIIZ-string with the filename
 3833 
  * +20 = +0x14: n db: ASCIIZ-string with the filename
3834 
    or
 3834 
    or
3835 
  * +20 = +0x14: db 0
 3835 
  * +20 = +0x14: db 0
3836 
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
 3836 
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
3837 
Specifications - in documentation on the appropriate subfunction.
 3837 
Specifications - in documentation on the appropriate subfunction.
3838 
Filename is case-insensitive. Russian letters must be written in
 3838 
Filename is case-insensitive. Russian letters must be written in
3839 
the encoding cp866 (DOS).
 3839 
the encoding cp866 (DOS).
3840 
Format of filename:
 3840 
Format of filename:
3841 
/base/number/dir1/dir2/.../dirn/file,
 3841 
/base/number/dir1/dir2/.../dirn/file,
3842 
where /base/number identifies device, on which file is located:
 3842 
where /base/number identifies device, on which file is located:
3843 
one of
 3843 
one of
3844 
  * /RD/1 = /RAMDISK/1 to access ramdisk
 3844 
  * /RD/1 = /RAMDISK/1 to access ramdisk
3845 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
 3845 
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
3846 
    /FD/2 = /FLOPPYDISK/2 to access second one
 3846 
    /FD/2 = /FLOPPYDISK/2 to access second one
3847 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
 3847 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
3848 
    IDE0 (Primary Master), IDE1 (Primary Slave),
 3848 
    IDE0 (Primary Master), IDE1 (Primary Slave),
3849 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
 3849 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
3850 
    x - partition number on the selected hard drive, varies from 1
 3850 
    x - partition number on the selected hard drive, varies from 1
3851 
    to 255 (on each hard drive the indexing starts from 1)
 3851 
    to 255 (on each hard drive the indexing starts from 1)
3852 
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
 3852 
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
3853 
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
 3853 
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
3854 
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
 3854 
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
3855 
  * /SYS means system folder; with the usual boot (from floppy)
 3855 
  * /SYS means system folder; with the usual boot (from floppy)
3856 
    is equivalent to /RD/1
 3856 
    is equivalent to /RD/1
3857 
Examples:
 3857 
Examples:
3858 
  * '/rd/1/kernel.asm',0
 3858 
  * '/rd/1/kernel.asm',0
3859 
  * '/HD0/1/kernel.asm',0
 3859 
  * '/HD0/1/kernel.asm',0
3860 
  * '/hd0/2/menuet/pics/tanzania.bmp',0
 3860 
  * '/hd0/2/menuet/pics/tanzania.bmp',0
3861 
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
 3861 
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
3862 
  * '/sys/MySuperApp.ini',0
 3862 
  * '/sys/MySuperApp.ini',0
3863 
Also function supports relative names.  If the path begins not
 3863 
Also function supports relative names.  If the path begins not
3864 
with '/', it is considered relative to a current folder. To get or
 3864 
with '/', it is considered relative to a current folder. To get or
3865 
set a current folder, use the function 30.
 3865 
set a current folder, use the function 30.
3866 
 
 3866 
 
3867 
Available subfunctions:
 3867 
Available subfunctions:
3868 
  * subfunction 0 - read file
 3868 
  * subfunction 0 - read file
3869 
  * subfunction 1 - read folder
 3869 
  * subfunction 1 - read folder
3870 
  * subfunction 2 - create/rewrite file
 3870 
  * subfunction 2 - create/rewrite file
3871 
  * subfunction 3 - write to existing file
 3871 
  * subfunction 3 - write to existing file
3872 
  * subfunction 4 - set file size
 3872 
  * subfunction 4 - set file size
3873 
  * subfunction 5 - get attributes of file/folder
 3873 
  * subfunction 5 - get attributes of file/folder
3874 
  * subfunction 6 - set attributes of file/folder
 3874 
  * subfunction 6 - set attributes of file/folder
3875 
  * subfunction 7 - start application
 3875 
  * subfunction 7 - start application
3876 
  * subfunction 8 - delete file/folder
 3876 
  * subfunction 8 - delete file/folder
3877 
  * subfunction 9 - create folder
 3877 
  * subfunction 9 - create folder
3878 
For CD-drives due to hardware limitations only subfunctions
 3878 
For CD-drives due to hardware limitations only subfunctions
3879 
0,1,5 and 7 are available, other subfunctions return error
 3879 
0,1,5 and 7 are available, other subfunctions return error
3880 
with code 2.
 3880 
with code 2.
3881 
At the first call of subfunctions 0,1,5,7 to ATAPI devices
 3881 
At the first call of subfunctions 0,1,5,7 to ATAPI devices
3882 
(CD and DVD) the manual control of tray is locked due to caching
 3882 
(CD and DVD) the manual control of tray is locked due to caching
3883 
drive data. Unlocking is made when subfunction 4 of function 24
 3883 
drive data. Unlocking is made when subfunction 4 of function 24
3884 
is called for corresponding device.
 3884 
is called for corresponding device.
3885 
 
 3885 
 
3886 
======================================================================
 3886 
======================================================================
3887 
=== Function 70, subfunction 0 - read file with long names support. ==
 3887 
=== Function 70, subfunction 0 - read file with long names support. ==
3888 
======================================================================
 3888 
======================================================================
3889 
Parameters:
 3889 
Parameters:
3890 
  * eax = 70 - function number
 3890 
  * eax = 70 - function number
3891 
  * ebx = pointer to the information structure
 3891 
  * ebx = pointer to the information structure
3892 
Format of the information structure:
 3892 
Format of the information structure:
3893 
  * +0: dword: 0 = subfunction number
 3893 
  * +0: dword: 0 = subfunction number
3894 
  * +4: dword: file offset (in bytes)
 3894 
  * +4: dword: file offset (in bytes)
3895 
  * +8: dword: 0 (reserved for high dword of offset)
 3895 
  * +8: dword: 0 (reserved for high dword of offset)
3896 
  * +12 = +0xC: dword: number of bytes to read
 3896 
  * +12 = +0xC: dword: number of bytes to read
3897 
  * +16 = +0x10: dword: pointer to buffer for data
 3897 
  * +16 = +0x10: dword: pointer to buffer for data
3898 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 3898 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
3899 
    given in the general description
 3899 
    given in the general description
3900 
    or
 3900 
    or
3901 
  * +20 = +0x14: db 0
 3901 
  * +20 = +0x14: db 0
3902 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 3902 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
3903 
Returned value:
 3903 
Returned value:
3904 
  * eax = 0 - success, otherwise file system error code
 3904 
  * eax = 0 - success, otherwise file system error code
3905 
  * ebx = number of read bytes or -1=0xffffffff if file was not found
 3905 
  * ebx = number of read bytes or -1=0xffffffff if file was not found
3906 
Remarks:
 3906 
Remarks:
3907 
  * If file was ended before last requested block was read,
 3907 
  * If file was ended before last requested block was read,
3908 
    the function will read as many as it can, and after that return
 3908 
    the function will read as many as it can, and after that return
3909 
    eax=6 (EOF).
 3909 
    eax=6 (EOF).
3910 
  * The function does not allow to read folder (returns eax=10,
 3910 
  * The function does not allow to read folder (returns eax=10,
3911 
    access denied).
 3911 
    access denied).
3912 
 
 3912 
 
3913 
======================================================================
 3913 
======================================================================
3914 
== Function 70, subfunction 1 - read folder with long names support. =
 3914 
== Function 70, subfunction 1 - read folder with long names support. =
3915 
======================================================================
 3915 
======================================================================
3916 
Parameters:
 3916 
Parameters:
3917 
  * eax = 70 - function number
 3917 
  * eax = 70 - function number
3918 
  * ebx = pointer to the information structure
 3918 
  * ebx = pointer to the information structure
3919 
Format of the information structure:
 3919 
Format of the information structure:
3920 
  * +0: dword: 1 = subfunction number
 3920 
  * +0: dword: 1 = subfunction number
3921 
  * +4: dword: index of starting block (beginning from 0)
 3921 
  * +4: dword: index of starting block (beginning from 0)
3922 
  * +8: dword: flags field:
 3922 
  * +8: dword: flags field:
3923 
    * bit 0 (mask 1): in what format to return names,
 3923 
    * bit 0 (mask 1): in what format to return names,
3924 
      0=ANSI, 1=UNICODE
 3924 
      0=ANSI, 1=UNICODE
3925 
    * other bits are reserved and must be set to 0 for the future
 3925 
    * other bits are reserved and must be set to 0 for the future
3926 
      compatibility
 3926 
      compatibility
3927 
  * +12 = +0xC: dword: number of blocks to read
 3927 
  * +12 = +0xC: dword: number of blocks to read
3928 
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
 3928 
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
3929 
    must be not less than 32 + [+12]*560 bytes
 3929 
    must be not less than 32 + [+12]*560 bytes
3930 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
 3930 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
3931 
    given in the general description
 3931 
    given in the general description
3932 
    or
 3932 
    or
3933 
  * +20 = +0x14: db 0
 3933 
  * +20 = +0x14: db 0
3934 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 3934 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
3935 
Returned value:
 3935 
Returned value:
3936 
  * eax = 0 - success, otherwise file system error code
 3936 
  * eax = 0 - success, otherwise file system error code
3937 
  * ebx = number of files, information on which was written to
 3937 
  * ebx = number of files, information on which was written to
3938 
    the buffer, or -1=0xffffffff, if folder was not found
 3938 
    the buffer, or -1=0xffffffff, if folder was not found
3939 
Structure of the buffer:
 3939 
Structure of the buffer:
3940 
  * +0: 32*byte: header
 3940 
  * +0: 32*byte: header
3941 
  * +32 = +0x20: n1*byte: block with information on file 1
 3941 
  * +32 = +0x20: n1*byte: block with information on file 1
3942 
  * +32+n1: n2*byte: block with information on file 2
 3942 
  * +32+n1: n2*byte: block with information on file 2
3943 
  * ...
 3943 
  * ...
3944 
Structure of header:
 3944 
Structure of header:
3945 
  * +0: dword: version of structure (current is 1)
 3945 
  * +0: dword: version of structure (current is 1)
3946 
  * +4: dword: number of placed blocks; is not greater than requested
 3946 
  * +4: dword: number of placed blocks; is not greater than requested
3947 
    in the field +12 of information structure; can be less, if
 3947 
    in the field +12 of information structure; can be less, if
3948 
    there are no more files in folder (the same as in ebx)
 3948 
    there are no more files in folder (the same as in ebx)
3949 
  * +8: dword: total number of files in folder
 3949 
  * +8: dword: total number of files in folder
3950 
  * +12 = +0xC: 20*byte: reserved (zeroed)
 3950 
  * +12 = +0xC: 20*byte: reserved (zeroed)
3951 
Structure of block of data for folder entry (BDFE):
 3951 
Structure of block of data for folder entry (BDFE):
3952 
  * +0: dword: attributes of file:
 3952 
  * +0: dword: attributes of file:
3953 
    * bit 0 (mask 1): file is read-only
 3953 
    * bit 0 (mask 1): file is read-only
3954 
    * bit 1 (mask 2): file is hidden
 3954 
    * bit 1 (mask 2): file is hidden
3955 
    * bit 2 (mask 4): file is system
 3955 
    * bit 2 (mask 4): file is system
3956 
    * bit 3 (mask 8): this is not a file but volume label
 3956 
    * bit 3 (mask 8): this is not a file but volume label
3957 
      (for one partition meets no more than once and
 3957 
      (for one partition meets no more than once and
3958 
      only in root folder)
 3958 
      only in root folder)
3959 
    * bit 4 (mask 0x10): this is a folder
 3959 
    * bit 4 (mask 0x10): this is a folder
3960 
    * bit 5 (mask 0x20): file was not archived - many archivation
 3960 
    * bit 5 (mask 0x20): file was not archived - many archivation
3961 
      programs have an option to archive only files with this bit set,
 3961 
      programs have an option to archive only files with this bit set,
3962 
      and after archiving this bit is cleared - it can be useful
 3962 
      and after archiving this bit is cleared - it can be useful
3963 
      for automatically creating of backup-archives as at writing
 3963 
      for automatically creating of backup-archives as at writing
3964 
      this bit is usually set
 3964 
      this bit is usually set
3965 
  * +4: byte: type of name data:
 3965 
  * +4: byte: type of name data:
3966 
    (coincides with bit 0 of flags in the information structure)
 3966 
    (coincides with bit 0 of flags in the information structure)
3967 
    * 0 = ASCII = 1-byte representation of each character
 3967 
    * 0 = ASCII = 1-byte representation of each character
3968 
    * 1 = UNICODE = 2-byte representation of each character
 3968 
    * 1 = UNICODE = 2-byte representation of each character
3969 
  * +5: 3*byte: reserved (zero)
 3969 
  * +5: 3*byte: reserved (zero)
3970 
  * +8: 4*byte: time of file creation
 3970 
  * +8: 4*byte: time of file creation
3971 
  * +12 = +0xC: 4*byte: date of file creation
 3971 
  * +12 = +0xC: 4*byte: date of file creation
3972 
  * +16 = +0x10: 4*byte: time of last access (read or write)
 3972 
  * +16 = +0x10: 4*byte: time of last access (read or write)
3973 
  * +20 = +0x14: 4*byte: date of last access
 3973 
  * +20 = +0x14: 4*byte: date of last access
3974 
  * +24 = +0x18: 4*byte: time of last modification
 3974 
  * +24 = +0x18: 4*byte: time of last modification
3975 
  * +28 = +0x1C: 4*byte: date of last modification
 3975 
  * +28 = +0x1C: 4*byte: date of last modification
3976 
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
 3976 
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
3977 
  * +40 = +0x28: name
 3977 
  * +40 = +0x28: name
3978 
    * for ASCII format: maximum length is 263 characters
 3978 
    * for ASCII format: maximum length is 263 characters
3979 
      (263 bytes), byte after the name has value 0
 3979 
      (263 bytes), byte after the name has value 0
3980 
    * for UNICODE format: maximum length is 259 characters
 3980 
    * for UNICODE format: maximum length is 259 characters
3981 
      (518 bytes), 2 bytes after the name have value 0
 3981 
      (518 bytes), 2 bytes after the name have value 0
3982 
Time format:
 3982 
Time format:
3983 
  * +0: byte: seconds
 3983 
  * +0: byte: seconds
3984 
  * +1: byte: minutes
 3984 
  * +1: byte: minutes
3985 
  * +2: byte: hours
 3985 
  * +2: byte: hours
3986 
  * +3: byte: reserved (0)
 3986 
  * +3: byte: reserved (0)
3987 
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
 3987 
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
3988 
Date format:
 3988 
Date format:
3989 
  * +0: byte: day
 3989 
  * +0: byte: day
3990 
  * +1: byte: month
 3990 
  * +1: byte: month
3991 
  * +2: word: year
 3991 
  * +2: word: year
3992 
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
 3992 
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
3993 
Remarks:
 3993 
Remarks:
3994 
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
 3994 
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
3995 
    if UNICODE name - 560 bytes. Value of length is aligned
 3995 
    if UNICODE name - 560 bytes. Value of length is aligned
3996 
    on 16-byte bound (to accelerate processing in CPU cache).
 3996 
    on 16-byte bound (to accelerate processing in CPU cache).
3997 
  * First character after a name is zero (ASCIIZ-string). The further
 3997 
  * First character after a name is zero (ASCIIZ-string). The further
3998 
    data contain garbage.
 3998 
    data contain garbage.
3999 
  * If files in folder were ended before requested number was read,
 3999 
  * If files in folder were ended before requested number was read,
4000 
    the function will read as many as it can, and after that return
 4000 
    the function will read as many as it can, and after that return
4001 
    eax=6 (EOF).
 4001 
    eax=6 (EOF).
4002 
  * Any folder on the disk, except for root, contains two special
 4002 
  * Any folder on the disk, except for root, contains two special
4003 
    entries "." and "..", identifying accordingly the folder itself
 4003 
    entries "." and "..", identifying accordingly the folder itself
4004 
    and the parent folder.
 4004 
    and the parent folder.
4005 
  * The function allows also to read virtual folders "/", "/rd",
 4005 
  * The function allows also to read virtual folders "/", "/rd",
4006 
    "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
 4006 
    "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
4007 
    and times and dates are zeroed. An alternative way to get the
 4007 
    and times and dates are zeroed. An alternative way to get the
4008 
    equipment information - subfunction 11 of function 18.
 4008 
    equipment information - subfunction 11 of function 18.
4009 
 
 4009 
 
4010 
======================================================================
 4010 
======================================================================
4011 
===================== Function 70, subfunction 2 =====================
 4011 
===================== Function 70, subfunction 2 =====================
4012 
============ Create/rewrite file with long names support. ============
 4012 
============ Create/rewrite file with long names support. ============
4013 
======================================================================
 4013 
======================================================================
4014 
Parameters:
 4014 
Parameters:
4015 
  * eax = 70 - function number
 4015 
  * eax = 70 - function number
4016 
  * ebx = pointer to the information structure
 4016 
  * ebx = pointer to the information structure
4017 
Format of the information structure:
 4017 
Format of the information structure:
4018 
  * +0: dword: 2 = subfunction number
 4018 
  * +0: dword: 2 = subfunction number
4019 
  * +4: dword: 0 (reserved)
 4019 
  * +4: dword: 0 (reserved)
4020 
  * +8: dword: 0 (reserved)
 4020 
  * +8: dword: 0 (reserved)
4021 
  * +12 = +0xC: dword: number of bytes to write
 4021 
  * +12 = +0xC: dword: number of bytes to write
4022 
  * +16 = +0x10: dword: pointer to data
 4022 
  * +16 = +0x10: dword: pointer to data
4023 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4023 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4024 
    given in the general description
 4024 
    given in the general description
4025 
    or
 4025 
    or
4026 
  * +20 = +0x14: db 0
 4026 
  * +20 = +0x14: db 0
4027 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4027 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4028 
Returned value:
 4028 
Returned value:
4029 
  * eax = 0 - success, otherwise file system error code
 4029 
  * eax = 0 - success, otherwise file system error code
4030 
  * ebx = number of written bytes (possibly 0)
 4030 
  * ebx = number of written bytes (possibly 0)
4031 
Remarks:
 4031 
Remarks:
4032 
  * If a file with given name did not exist, it is created;
 4032 
  * If a file with given name did not exist, it is created;
4033 
    if it existed, it is rewritten.
 4033 
    if it existed, it is rewritten.
4034 
  * If there is not enough free space on disk, the function will
 4034 
  * If there is not enough free space on disk, the function will
4035 
    write as many as can and then return error code 8.
 4035 
    write as many as can and then return error code 8.
4036 
  * The function is not supported for CD (returns error code 2).
 4036 
  * The function is not supported for CD (returns error code 2).
4037 
 
 4037 
 
4038 
======================================================================
 4038 
======================================================================
4039 
===================== Function 70, subfunction 3 =====================
 4039 
===================== Function 70, subfunction 3 =====================
4040 
=========== Write to existing file with long names support. ==========
 4040 
=========== Write to existing file with long names support. ==========
4041 
======================================================================
 4041 
======================================================================
4042 
Parameters:
 4042 
Parameters:
4043 
  * eax = 70 - function number
 4043 
  * eax = 70 - function number
4044 
  * ebx = pointer to the information structure
 4044 
  * ebx = pointer to the information structure
4045 
Format of the information structure:
 4045 
Format of the information structure:
4046 
  * +0: dword: 3 = subfunction number
 4046 
  * +0: dword: 3 = subfunction number
4047 
  * +4: dword: file offset (in bytes)
 4047 
  * +4: dword: file offset (in bytes)
4048 
  * +8: dword: high dword of offset (must be 0 for FAT)
 4048 
  * +8: dword: high dword of offset (must be 0 for FAT)
4049 
  * +12 = +0xC: dword: number of bytes to write
 4049 
  * +12 = +0xC: dword: number of bytes to write
4050 
  * +16 = +0x10: dword: pointer to data
 4050 
  * +16 = +0x10: dword: pointer to data
4051 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4051 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4052 
    given in the general description
 4052 
    given in the general description
4053 
    or
 4053 
    or
4054 
  * +20 = +0x14: db 0
 4054 
  * +20 = +0x14: db 0
4055 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4055 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4056 
Returned value:
 4056 
Returned value:
4057 
  * eax = 0 - success, otherwise file system error code
 4057 
  * eax = 0 - success, otherwise file system error code
4058 
  * ebx = number of written bytes (possibly 0)
 4058 
  * ebx = number of written bytes (possibly 0)
4059 
Remarks:
 4059 
Remarks:
4060 
  * The file must already exist, otherwise function returns eax=5.
 4060 
  * The file must already exist, otherwise function returns eax=5.
4061 
  * The only result of write 0 bytes is update in the file attributes
 4061 
  * The only result of write 0 bytes is update in the file attributes
4062 
    date/time of modification and access to the current date/time.
 4062 
    date/time of modification and access to the current date/time.
4063 
  * If beginning and/or ending position is greater than file size
 4063 
  * If beginning and/or ending position is greater than file size
4064 
    (except for the previous case), the file is expanded to needed
 4064 
    (except for the previous case), the file is expanded to needed
4065 
    size with zero characters.
 4065 
    size with zero characters.
4066 
  * The function is not supported for CD (returns error code 2).
 4066 
  * The function is not supported for CD (returns error code 2).
4067 
 
 4067 
 
4068 
======================================================================
 4068 
======================================================================
4069 
============ Function 70, subfunction 4 - set end of file. ===========
 4069 
============ Function 70, subfunction 4 - set end of file. ===========
4070 
======================================================================
 4070 
======================================================================
4071 
Parameters:
 4071 
Parameters:
4072 
  * eax = 70 - function number
 4072 
  * eax = 70 - function number
4073 
  * ebx = pointer to the information structure
 4073 
  * ebx = pointer to the information structure
4074 
Format of the information structure:
 4074 
Format of the information structure:
4075 
  * +0: dword: 4 = subfunction number
 4075 
  * +0: dword: 4 = subfunction number
4076 
  * +4: dword: low dword of new file size
 4076 
  * +4: dword: low dword of new file size
4077 
  * +8: dword: high dword of new file size (must be 0 for FAT)
 4077 
  * +8: dword: high dword of new file size (must be 0 for FAT)
4078 
  * +12 = +0xC: dword: 0 (reserved)
 4078 
  * +12 = +0xC: dword: 0 (reserved)
4079 
  * +16 = +0x10: dword: 0 (reserved)
 4079 
  * +16 = +0x10: dword: 0 (reserved)
4080 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4080 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4081 
    given in the general description
 4081 
    given in the general description
4082 
    or
 4082 
    or
4083 
  * +20 = +0x14: db 0
 4083 
  * +20 = +0x14: db 0
4084 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4084 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4085 
Returned value:
 4085 
Returned value:
4086 
  * eax = 0 - success, otherwise file system error code
 4086 
  * eax = 0 - success, otherwise file system error code
4087 
  * ebx destroyed
 4087 
  * ebx destroyed
4088 
Remarks:
 4088 
Remarks:
4089 
  * If the new file size is less than old one, file is truncated.
 4089 
  * If the new file size is less than old one, file is truncated.
4090 
    If the new size is greater than old one, file is expanded with
 4090 
    If the new size is greater than old one, file is expanded with
4091 
    characters with code 0. If the new size is equal to old one,
 4091 
    characters with code 0. If the new size is equal to old one,
4092 
    the only result of call is set date/time of modification and
 4092 
    the only result of call is set date/time of modification and
4093 
    access to the current date/time.
 4093 
    access to the current date/time.
4094 
  * If there is not enough free space on disk for expansion, the
 4094 
  * If there is not enough free space on disk for expansion, the
4095 
    function will expand to maximum possible size and then return
 4095 
    function will expand to maximum possible size and then return
4096 
    error code 8.
 4096 
    error code 8.
4097 
  * The function is not supported for CD (returns error code 2).
 4097 
  * The function is not supported for CD (returns error code 2).
4098 
 
 4098 
 
4099 
======================================================================
 4099 
======================================================================
4100 
==== Function 70, subfunction 5 - get information on file/folder. ====
 4100 
==== Function 70, subfunction 5 - get information on file/folder. ====
4101 
======================================================================
 4101 
======================================================================
4102 
Parameters:
 4102 
Parameters:
4103 
  * eax = 70 - function number
 4103 
  * eax = 70 - function number
4104 
  * ebx = pointer to the information structure
 4104 
  * ebx = pointer to the information structure
4105 
Format of the information structure:
 4105 
Format of the information structure:
4106 
  * +0: dword: 5 = subfunction number
 4106 
  * +0: dword: 5 = subfunction number
4107 
  * +4: dword: 0 (reserved)
 4107 
  * +4: dword: 0 (reserved)
4108 
  * +8: dword: 0 (reserved)
 4108 
  * +8: dword: 0 (reserved)
4109 
  * +12 = +0xC: dword: 0 (reserved)
 4109 
  * +12 = +0xC: dword: 0 (reserved)
4110 
  * +16 = +0x10: dword: pointer to buffer for data (40 bytes)
 4110 
  * +16 = +0x10: dword: pointer to buffer for data (40 bytes)
4111 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4111 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4112 
    given in the general description
 4112 
    given in the general description
4113 
    or
 4113 
    or
4114 
  * +20 = +0x14: db 0
 4114 
  * +20 = +0x14: db 0
4115 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4115 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4116 
Returned value:
 4116 
Returned value:
4117 
  * eax = 0 - success, otherwise file system error code
 4117 
  * eax = 0 - success, otherwise file system error code
4118 
  * ebx destroyed
 4118 
  * ebx destroyed
4119 
Information on file is returned in the BDFE format (block of data
 4119 
Information on file is returned in the BDFE format (block of data
4120 
for folder entry), explained in the description of
 4120 
for folder entry), explained in the description of
4121 
subfunction 1, but without filename
 4121 
subfunction 1, but without filename
4122 
(i.e. only first 40 = 0x28 bytes).
 4122 
(i.e. only first 40 = 0x28 bytes).
4123 
Remarks:
 4123 
Remarks:
4124 
  * The function does not support virtual folders such as /, /rd and
 4124 
  * The function does not support virtual folders such as /, /rd and
4125 
    root folders like /rd/1.
 4125 
    root folders like /rd/1.
4126 
 
 4126 
 
4127 
======================================================================
 4127 
======================================================================
4128 
===== Function 70, subfunction 6 - set attributes of file/folder. ====
 4128 
===== Function 70, subfunction 6 - set attributes of file/folder. ====
4129 
======================================================================
 4129 
======================================================================
4130 
Parameters:
 4130 
Parameters:
4131 
  * eax = 70 - function number
 4131 
  * eax = 70 - function number
4132 
  * ebx = pointer to the information structure
 4132 
  * ebx = pointer to the information structure
4133 
Format of the information structure:
 4133 
Format of the information structure:
4134 
  * +0: dword: 6 = subfunction number
 4134 
  * +0: dword: 6 = subfunction number
4135 
  * +4: dword: 0 (reserved)
 4135 
  * +4: dword: 0 (reserved)
4136 
  * +8: dword: 0 (reserved)
 4136 
  * +8: dword: 0 (reserved)
4137 
  * +12 = +0xC: dword: 0 (reserved)
 4137 
  * +12 = +0xC: dword: 0 (reserved)
4138 
  * +16 = +0x10: dword: pointer to buffer with attributes (32 bytes)
 4138 
  * +16 = +0x10: dword: pointer to buffer with attributes (32 bytes)
4139 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4139 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4140 
    given in the general description
 4140 
    given in the general description
4141 
    or
 4141 
    or
4142 
  * +20 = +0x14: db 0
 4142 
  * +20 = +0x14: db 0
4143 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4143 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4144 
Returned value:
 4144 
Returned value:
4145 
  * eax = 0 - success, otherwise file system error code
 4145 
  * eax = 0 - success, otherwise file system error code
4146 
  * ebx destroyed
 4146 
  * ebx destroyed
4147 
File attributes are first 32 bytes in BDFE (block of data
 4147 
File attributes are first 32 bytes in BDFE (block of data
4148 
for folder entry), explained in the description of subfunction 1
 4148 
for folder entry), explained in the description of subfunction 1
4149 
(that is, without name and size of file). Attribute
 4149 
(that is, without name and size of file). Attribute
4150 
file/folder/volume label (bits 3,4 in dword +0) is not changed.
 4150 
file/folder/volume label (bits 3,4 in dword +0) is not changed.
4151 
Byte +4 (name format) is ignored.
 4151 
Byte +4 (name format) is ignored.
4152 
Remarks:
 4152 
Remarks:
4153 
  * The function does not support virtual folders such as /, /rd and
 4153 
  * The function does not support virtual folders such as /, /rd and
4154 
    root folders like /rd/1.
 4154 
    root folders like /rd/1.
4155 
  * The function is not supported for CD (returns error code 2).
 4155 
  * The function is not supported for CD (returns error code 2).
4156 
 
 4156 
 
4157 
======================================================================
 4157 
======================================================================
4158 
=========== Function 70, subfunction 7 - start application. ==========
 4158 
=========== Function 70, subfunction 7 - start application. ==========
4159 
======================================================================
 4159 
======================================================================
4160 
Parameters:
 4160 
Parameters:
4161 
  * eax = 70 - function number
 4161 
  * eax = 70 - function number
4162 
  * ebx = pointer to the information structure
 4162 
  * ebx = pointer to the information structure
4163 
Format of the information structure:
 4163 
Format of the information structure:
4164 
  * +0: dword: 7 = subfunction number
 4164 
  * +0: dword: 7 = subfunction number
4165 
  * +4: dword: flags field:
 4165 
  * +4: dword: flags field:
4166 
    * bit 0: start process as debugged
 4166 
    * bit 0: start process as debugged
4167 
    * other bits are reserved and must be set to 0
 4167 
    * other bits are reserved and must be set to 0
4168 
  * +8: dword: 0 or pointer to ASCIIZ-string with parameters
 4168 
  * +8: dword: 0 or pointer to ASCIIZ-string with parameters
4169 
  * +12 = +0xC: dword: 0 (reserved)
 4169 
  * +12 = +0xC: dword: 0 (reserved)
4170 
  * +16 = +0x10: dword: 0 (reserved)
 4170 
  * +16 = +0x10: dword: 0 (reserved)
4171 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4171 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4172 
    given in the general description
 4172 
    given in the general description
4173 
    or
 4173 
    or
4174 
  * +20 = +0x14: db 0
 4174 
  * +20 = +0x14: db 0
4175 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4175 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4176 
Returned value:
 4176 
Returned value:
4177 
  * eax > 0 - program is loaded, eax contains PID
 4177 
  * eax > 0 - program is loaded, eax contains PID
4178 
  * eax < 0 - an error has occured, -eax contains
 4178 
  * eax < 0 - an error has occured, -eax contains
4179 
    file system error code
 4179 
    file system error code
4180 
  * ebx destroyed
 4180 
  * ebx destroyed
4181 
Remarks:
 4181 
Remarks:
4182 
  * Command line must be terminated by the character with the code 0
 4182 
  * Command line must be terminated by the character with the code 0
4183 
    (ASCIIZ-string); function takes into account either all characters
 4183 
    (ASCIIZ-string); function takes into account either all characters
4184 
    up to terminating zero inclusively or first 256 character
 4184 
    up to terminating zero inclusively or first 256 character
4185 
    regarding what is less.
 4185 
    regarding what is less.
4186 
  * If the process is started as debugged, it is created in
 4186 
  * If the process is started as debugged, it is created in
4187 
    the suspended state; to run use subfunction 5 of function 69.
 4187 
    the suspended state; to run use subfunction 5 of function 69.
4188 
 
 4188 
 
4189 
======================================================================
 4189 
======================================================================
4190 
========== Function 70, subfunction 8 - delete file/folder. ==========
 4190 
========== Function 70, subfunction 8 - delete file/folder. ==========
4191 
======================================================================
 4191 
======================================================================
4192 
Parameters:
 4192 
Parameters:
4193 
  * eax = 70 - function number
 4193 
  * eax = 70 - function number
4194 
  * ebx = pointer to the information structure
 4194 
  * ebx = pointer to the information structure
4195 
Format of the information structure:
 4195 
Format of the information structure:
4196 
  * +0: dword: 8 = subfunction number
 4196 
  * +0: dword: 8 = subfunction number
4197 
  * +4: dword: 0 (reserved)
 4197 
  * +4: dword: 0 (reserved)
4198 
  * +8: dword: 0 (reserved)
 4198 
  * +8: dword: 0 (reserved)
4199 
  * +12 = +0xC: dword: 0 (reserved)
 4199 
  * +12 = +0xC: dword: 0 (reserved)
4200 
  * +16 = +0x10: dword: 0 (reserved)
 4200 
  * +16 = +0x10: dword: 0 (reserved)
4201 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
 4201 
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4202 
    given in the general description
 4202 
    given in the general description
4203 
    or
 4203 
    or
4204 
  * +20 = +0x14: db 0
 4204 
  * +20 = +0x14: db 0
4205 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
 4205 
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4206 
Returned value:
 4206 
Returned value:
4207 
  * eax = 0 - success, otherwise file system error code
 4207 
  * eax = 0 - success, otherwise file system error code
4208 
  * ebx destroyed
 4208 
  * ebx destroyed
4209 
Remarks:
 4209 
Remarks:
4210 
  * The function is not supported for CD (returns error code 2).
 4210 
  * The function is not supported for CD (returns error code 2).
4211 
  * The function can delete only empty folders (attempt to delete
 4211 
  * The function can delete only empty folders (attempt to delete
4212 
    nonempty folder results in error with code 10, "access denied").
 4212 
    nonempty folder results in error with code 10, "access denied").
4213 
 
 4213 
 
4214 
======================================================================
 4214 
======================================================================
4215 
============= Function 70, subfunction 9 - create folder. ============
 4215 
============= Function 70, subfunction 9 - create folder. ============
4216 
======================================================================
 4216 
======================================================================
4217 
Parameters:
 4217 
Parameters:
4218 
  * eax = 70 - function number
 4218 
  * eax = 70 - function number
4219 
  * ebx = pointer to the information structure
 4219 
  * ebx = pointer to the information structure
4220 
Format of the information structure:
 4220 
Format of the information structure:
4221 
  * +0: dword: 9 = subfunction number
 4221 
  * +0: dword: 9 = subfunction number
4222 
  * +4: dword: 0 (reserved)
 4222 
  * +4: dword: 0 (reserved)
4223 
  * +8: dword: 0 (reserved)
 4223 
  * +8: dword: 0 (reserved)
4224 
  * +12 = +0xC: dword: 0 (reserved)
 4224 
  * +12 = +0xC: dword: 0 (reserved)
4225 
  * +16 = +0x10: dword: 0 (reserved)
 4225 
  * +16 = +0x10: dword: 0 (reserved)
4226 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
 4226 
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4227 
    given in the general description
 4227 
    given in the general description
4228 
    or
 4228 
    or
4229 
  * +20 = +0x14: db 0
 4229 
  * +20 = +0x14: db 0
4230 
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
 4230 
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
4231 
Returned value:
 4231 
Returned value:
4232 
  * eax = 0 - success, otherwise file system error code
 4232 
  * eax = 0 - success, otherwise file system error code
4233 
  * ebx destroyed
 4233 
  * ebx destroyed
4234 
Remarks:
 4234 
Remarks:
4235 
  * The function is not supported for CD (returns error code 2).
 4235 
  * The function is not supported for CD (returns error code 2).
4236 
  * The parent folder must already exist.
 4236 
  * The parent folder must already exist.
4237 
  * If target folder already exists, function returns success (eax=0).
 4237 
  * If target folder already exists, function returns success (eax=0).
4238 
 
 4238 
 
4239 
======================================================================
 4239 
======================================================================
4240 
========== Function 71, subfunction 1 - set window caption. ==========
 4240 
========== Function 71, subfunction 1 - set window caption. ==========
4241 
======================================================================
 4241 
======================================================================
4242 
Parameters:
 4242 
Parameters:
4243 
  * eax = 71 - function number
 4243 
  * eax = 71 - function number
4244 
  * ebx = 1 - subfunction number
 4244 
  * ebx = 1 - subfunction number
4245 
  * ecx = pointer to caption string
 4245 
  * ecx = pointer to caption string
4246 
Returned value:
 4246 
Returned value:
4247 
  * function does not return value
 4247 
  * function does not return value
4248 
Remarks:
 4248 
Remarks:
4249 
  * String must be in the ASCIIZ-format. Disregarding real string
 4249 
  * String must be in the ASCIIZ-format. Disregarding real string
4250 
    length, no more than 255 characters are drawn.
 4250 
    length, no more than 255 characters are drawn.
4251 
  * Pass NULL in ecx to remove caption.
 4251 
  * Pass NULL in ecx to remove caption.
4252 
 
 4252 
 
4253 
======================================================================
 4253 
======================================================================
4254 
=============== Function 72 - send message to a window. ==============
 4254 
=============== Function 72 - send message to a window. ==============
4255 
======================================================================
 4255 
======================================================================
4256 
 
 4256 
 
4257 
- Subfunction 1 - send message with parameter to the active window. --
 4257 
- Subfunction 1 - send message with parameter to the active window. --
4258 
Parameters:
 4258 
Parameters:
4259 
  * eax = 72 - function number
 4259 
  * eax = 72 - function number
4260 
  * ebx = 1 - subfunction number
 4260 
  * ebx = 1 - subfunction number
4261 
  * ecx = event code: 2 or 3
 4261 
  * ecx = event code: 2 or 3
4262 
  * edx = parameter: key code for ecx=2, button identifier for ecx=3
 4262 
  * edx = parameter: key code for ecx=2, button identifier for ecx=3
4263 
Returned value:
 4263 
Returned value:
4264 
  * eax = 0 - success
 4264 
  * eax = 0 - success
4265 
  * eax = 1 - buffer is full
 4265 
  * eax = 1 - buffer is full
4266 
 
 4266 
 
4267 
======================================================================
 4267 
======================================================================
4268 
===================== Function 73 - blit bitmap  =====================
 4268 
===================== Function 73 - blit bitmap  =====================
4269 
======================================================================
 4269 
======================================================================
4270 
 
 4270 
 
4271 
Parameters:
 4271 
Parameters:
4272 
  * eax = 73 - function number
 4272 
  * eax = 73 - function number
4273 
 
 4273 
 
4274 
  * ebx = ROP and optional flags
 4274 
  * ebx = ROP and optional flags
4275 
     31           6 5  4 3   0
 4275 
     31           6 5  4 3   0
4276 
     [  reserved  ][T][B][ROP]
 4276 
     [  reserved  ][T][B][ROP]
4277 
     ROP - raster operation code
 4277 
     ROP - raster operation code
4278 
        0: Copy
 4278 
        0: Copy
4279 
     1-15: reserved
 4279 
     1-15: reserved
4280 
     B   - blit into the background surface
 4280 
     B   - blit into the background surface
4281 
     T   - transparent blit
 4281 
     T   - transparent blit
4282 
 
 4282 
 
4283 
  * ecx = pointer to the function parameters
 4283 
  * ecx = pointer to the function parameters
4284 
        destination offset and clipping
 4284 
        destination offset and clipping
4285 
     +0 signed dword: destination rectangle X offset from the window
 4285 
     +0 signed dword: destination rectangle X offset from the window
4286 
                      top-left corner
 4286 
                      top-left corner
4287 
     +4 signed dword: destination rectangle Y offset from the window
 4287 
     +4 signed dword: destination rectangle Y offset from the window
4288 
                      top-left corner
 4288 
                      top-left corner
4289 
     +8 dword:        destination rectangle width
 4289 
     +8 dword:        destination rectangle width
4290 
    +12 dword:        destination rectangle height
 4290 
    +12 dword:        destination rectangle height
4291 
 
 4291 
 
4292 
        source offset and clipping
 4292 
        source offset and clipping
4293 
    +16 signed dword: source rectangle X offset from the bitmap
 4293 
    +16 signed dword: source rectangle X offset from the bitmap
4294 
                      top-left corner
 4294 
                      top-left corner
4295 
    +20 signed dword: source rectangle Y offset from the bitmap
 4295 
    +20 signed dword: source rectangle Y offset from the bitmap
4296 
                      top-left corner
 4296 
                      top-left corner
4297 
    +24 dword:        source rectangle width
 4297 
    +24 dword:        source rectangle width
4298 
    +28 dword:        source rectangle height
 4298 
    +28 dword:        source rectangle height
4299 
 
 4299 
 
4300 
    +32: dword: bitmap data - must be 32bpp
 4300 
    +32: dword: bitmap data - must be 32bpp
4301 
    +36: dword: size of the bitmap row in bytes
 4301 
    +36: dword: size of the bitmap row in bytes
4302 
 
 4302 
 
4303 
Returned value:
 4303 
Returned value:
4304 
  * function does not return value
 4304 
  * function does not return value
4305 
 
 4305 
 
4306 
======================================================================
 4306 
======================================================================
4307 
= Function 74, Subfunction -1, Get number of active network devices. =
 4307 
= Function 74, Subfunction -1, Get number of active network devices. =
4308 
======================================================================
 4308 
======================================================================
4309 
Parameters:
 4309 
Parameters:
4310 
  * eax = 74 - function number
 4310 
  * eax = 74 - function number
4311 
  * bl = -1 - subfunction number
 4311 
  * bl = -1 - subfunction number
4312 
Returned value:
 4312 
Returned value:
4313 
  * eax = number of active network devices
 4313 
  * eax = number of active network devices
4314 
 
 4314 
 
4315 
======================================================================
 4315 
======================================================================
4316 
======== Function 74, Subfunction 0, Get network device type. ========
 4316 
======== Function 74, Subfunction 0, Get network device type. ========
4317 
======================================================================
 4317 
======================================================================
4318 
Parameters:
 4318 
Parameters:
4319 
  * eax = 74 - function number
 4319 
  * eax = 74 - function number
4320 
  * bl = 0 - subfunction number
 4320 
  * bl = 0 - subfunction number
4321 
  * bh = device number
 4321 
  * bh = device number
4322 
Returned value:
 4322 
Returned value:
4323 
  * eax = device type
 4323 
  * eax = device type
4324 
 
 4324 
 
4325 
======================================================================
 4325 
======================================================================
4326 
======== Function 74, Subfunction 1, Get network device name. ========
 4326 
======== Function 74, Subfunction 1, Get network device name. ========
4327 
======================================================================
 4327 
======================================================================
4328 
Parameters:
 4328 
Parameters:
4329 
  * eax = 74 - function number
 4329 
  * eax = 74 - function number
4330 
  * bl = 1 - subfunction number
 4330 
  * bl = 1 - subfunction number
4331 
  * bh = device number
 4331 
  * bh = device number
4332 
  * ecx = pointer to 64 byte buffer
 4332 
  * ecx = pointer to 64 byte buffer
4333 
Returned value:
 4333 
Returned value:
4334 
  * eax = -1 on error
 4334 
  * eax = -1 on error
4335 
  * The network device name is written into the buffer, on success
 4335 
  * The network device name is written into the buffer, on success
4336 
 
 4336 
 
4337 
======================================================================
 4337 
======================================================================
4338 
========= Function 74, Subfunction 2, Reset network device. ==========
 4338 
========= Function 74, Subfunction 2, Reset network device. ==========
4339 
======================================================================
 4339 
======================================================================
4340 
Parameters:
 4340 
Parameters:
4341 
  * eax = 74 - function number
 4341 
  * eax = 74 - function number
4342 
  * bl = 2 - subfunction number
 4342 
  * bl = 2 - subfunction number
4343 
  * bh = device number
 4343 
  * bh = device number
4344 
Returned value:
 4344 
Returned value:
4345 
  * eax = -1 on error
 4345 
  * eax = -1 on error
4346 
 
 4346 
 
4347 
======================================================================
 4347 
======================================================================
4348 
========== Function 74, Subfunction 3, Stop network device. ==========
 4348 
========== Function 74, Subfunction 3, Stop network device. ==========
4349 
======================================================================
 4349 
======================================================================
4350 
Parameters:
 4350 
Parameters:
4351 
  * eax = 74 - function number
 4351 
  * eax = 74 - function number
4352 
  * bl = 3 - subfunction number
 4352 
  * bl = 3 - subfunction number
4353 
  * bh = device number
 4353 
  * bh = device number
4354 
Returned value:
 4354 
Returned value:
4355 
  * eax = -1 on error
 4355 
  * eax = -1 on error
4356 
 
 4356 
 
4357 
======================================================================
 4357 
======================================================================
4358 
============== Function 75, Subfunction 0, Open socket. ==============
 4358 
============== Function 75, Subfunction 0, Open socket. ==============
4359 
======================================================================
 4359 
======================================================================
4360 
Parameters:
 4360 
Parameters:
4361 
  * eax = 75 - function number
 4361 
  * eax = 75 - function number
4362 
  * bl = 0 - subfunction number
 4362 
  * bl = 0 - subfunction number
4363 
  * ecx = domain
 4363 
  * ecx = domain
4364 
  * edx = type
 4364 
  * edx = type
4365 
  * esi = protocol
 4365 
  * esi = protocol
4366 
Returned value:
 4366 
Returned value:
4367 
  * eax = socket number, -1 on error
 4367 
  * eax = socket number, -1 on error
4368 
  * ebx = errorcode
 4368 
  * ebx = errorcode
4369 
 
 4369 
 
4370 
======================================================================
 4370 
======================================================================
4371 
============= Function 75, Subfunction 1, Close socket. ==============
 4371 
============= Function 75, Subfunction 1, Close socket. ==============
4372 
======================================================================
 4372 
======================================================================
4373 
Parameters:
 4373 
Parameters:
4374 
  * eax = 75 - function number
 4374 
  * eax = 75 - function number
4375 
  * bl = 1 - subfunction number
 4375 
  * bl = 1 - subfunction number
4376 
  * ecx = socket number
 4376 
  * ecx = socket number
4377 
Returned value:
 4377 
Returned value:
4378 
  * eax = -1 on error
 4378 
  * eax = -1 on error
4379 
  * ebx = errorcode
 4379 
  * ebx = errorcode
4380 
 
 4380 
 
4381 
======================================================================
 4381 
======================================================================
4382 
================== Function 75, Subfunction 2, Bind. =================
 4382 
================== Function 75, Subfunction 2, Bind. =================
4383 
======================================================================
 4383 
======================================================================
4384 
Parameters:
 4384 
Parameters:
4385 
  * eax = 75 - function number
 4385 
  * eax = 75 - function number
4386 
  * bl = 2 - subfunction number
 4386 
  * bl = 2 - subfunction number
4387 
  * ecx = socket number
 4387 
  * ecx = socket number
4388 
  * edx = pointer to sockaddr structure
 4388 
  * edx = pointer to sockaddr structure
4389 
  * esi = length of sockaddr structure
 4389 
  * esi = length of sockaddr structure
4390 
Returned value:
 4390 
Returned value:
4391 
  * eax = -1 on error
 4391 
  * eax = -1 on error
4392 
  * ebx = errorcode
 4392 
  * ebx = errorcode
4393 
 
 4393 
 
4394 
======================================================================
 4394 
======================================================================
4395 
================= Function 75, Subfunction 3, Listen. ================
 4395 
================= Function 75, Subfunction 3, Listen. ================
4396 
======================================================================
 4396 
======================================================================
4397 
Parameters:
 4397 
Parameters:
4398 
  * eax = 75 - function number
 4398 
  * eax = 75 - function number
4399 
  * bl = 3 - subfunction number
 4399 
  * bl = 3 - subfunction number
4400 
  * ecx = socket number
 4400 
  * ecx = socket number
4401 
  * edx = backlog
 4401 
  * edx = backlog
4402 
Returned value:
 4402 
Returned value:
4403 
  * eax = -1 on error
 4403 
  * eax = -1 on error
4404 
  * ebx = errorcode
 4404 
  * ebx = errorcode
4405 
 
 4405 
 
4406 
======================================================================
 4406 
======================================================================
4407 
================ Function 75, Subfunction 4, Connect. ================
 4407 
================ Function 75, Subfunction 4, Connect. ================
4408 
======================================================================
 4408 
======================================================================
4409 
Parameters:
 4409 
Parameters:
4410 
  * eax = 75 - function number
 4410 
  * eax = 75 - function number
4411 
  * bl = 4 - subfunction number
 4411 
  * bl = 4 - subfunction number
4412 
  * ecx = socket number
 4412 
  * ecx = socket number
4413 
  * edx = pointer to sockaddr structure
 4413 
  * edx = pointer to sockaddr structure
4414 
  * esi = length of sockaddr structure
 4414 
  * esi = length of sockaddr structure
4415 
Returned value:
 4415 
Returned value:
4416 
  * eax = -1 on error
 4416 
  * eax = -1 on error
4417 
  * ebx = errorcode
 4417 
  * ebx = errorcode
4418 
 
 4418 
 
4419 
======================================================================
 4419 
======================================================================
4420 
================= Function 75, Subfunction 5, Accept. ================
 4420 
================= Function 75, Subfunction 5, Accept. ================
4421 
======================================================================
 4421 
======================================================================
4422 
Parameters:
 4422 
Parameters:
4423 
  * eax = 75 - function number
 4423 
  * eax = 75 - function number
4424 
  * bl = 5 - subfunction number
 4424 
  * bl = 5 - subfunction number
4425 
  * ecx = socket number
 4425 
  * ecx = socket number
4426 
  * edx = pointer to sockaddr structure
 4426 
  * edx = pointer to sockaddr structure
4427 
  * esi = length of sockaddr structure
 4427 
  * esi = length of sockaddr structure
4428 
Returned value:
 4428 
Returned value:
4429 
  * eax = socket number of accepted socket, -1 on error
 4429 
  * eax = socket number of accepted socket, -1 on error
4430 
  * ebx = errorcode
 4430 
  * ebx = errorcode
4431 
 
 4431 
 
4432 
======================================================================
 4432 
======================================================================
4433 
================== Function 75, Subfunction 6, Send. =================
 4433 
================== Function 75, Subfunction 6, Send. =================
4434 
======================================================================
 4434 
======================================================================
4435 
Parameters:
 4435 
Parameters:
4436 
  * eax = 75 - function number
 4436 
  * eax = 75 - function number
4437 
  * bl = 6 - subfunction number
 4437 
  * bl = 6 - subfunction number
4438 
  * ecx = socket number
 4438 
  * ecx = socket number
4439 
  * edx = pointer to buffer
 4439 
  * edx = pointer to buffer
4440 
  * esi = length of buffer
 4440 
  * esi = length of buffer
4441 
  * edi = flags
 4441 
  * edi = flags
4442 
Returned value:
 4442 
Returned value:
4443 
  * eax = number of bytes copied, -1 on error
 4443 
  * eax = number of bytes copied, -1 on error
4444 
  * ebx = errorcode
 4444 
  * ebx = errorcode
4445 
 
 4445 
 
4446 
======================================================================
 4446 
======================================================================
4447 
================ Function 75, Subfunction 7, Receive. ================
 4447 
================ Function 75, Subfunction 7, Receive. ================
4448 
======================================================================
 4448 
======================================================================
4449 
Parameters:
 4449 
Parameters:
4450 
  * eax = 75 - function number
 4450 
  * eax = 75 - function number
4451 
  * bl = 7 - subfunction number
 4451 
  * bl = 7 - subfunction number
4452 
  * ecx = socket number
 4452 
  * ecx = socket number
4453 
  * edx = pointer to buffer
 4453 
  * edx = pointer to buffer
4454 
  * esi = length of buffer
 4454 
  * esi = length of buffer
4455 
  * edi = flags
 4455 
  * edi = flags
4456 
Returned value:
 4456 
Returned value:
4457 
  * eax = number of bytes copied, -1 on error
 4457 
  * eax = number of bytes copied, -1 on error
4458 
  * ebx = errorcode
 4458 
  * ebx = errorcode
4459 
 
 4459 
 
4460 
======================================================================
 4460 
======================================================================
4461 
=========== Function 75, Subfunction 8, Set socket options. ==========
 4461 
=========== Function 75, Subfunction 8, Set socket options. ==========
4462 
======================================================================
 4462 
======================================================================
4463 
Parameters:
 4463 
Parameters:
4464 
  * eax = 75 - function number
 4464 
  * eax = 75 - function number
4465 
  * bl = 8 - subfunction number
 4465 
  * bl = 8 - subfunction number
4466 
  * ecx = socket number
 4466 
  * ecx = socket number
4467 
  * edx = pointer to optstruct
 4467 
  * edx = pointer to optstruct
4468 
Returned value:
 4468 
Returned value:
4469 
  * eax = -1 on error
 4469 
  * eax = -1 on error
4470 
  * ebx = errorcode
 4470 
  * ebx = errorcode
4471 
Remarks:
 4471 
Remarks:
4472 
 
 4472 
 
4473 
  Optstruct: dd level
 4473 
  Optstruct: dd level
4474 
             dd optionname
 4474 
             dd optionname
4475 
             dd optlength
 4475 
             dd optlength
4476 
             db options...
 4476 
             db options...
4477 
 
 4477 
 
4478 
======================================================================
 4478 
======================================================================
4479 
=========== Function 75, Subfunction 9, Get socket options. ==========
 4479 
=========== Function 75, Subfunction 9, Get socket options. ==========
4480 
======================================================================
 4480 
======================================================================
4481 
Parameters:
 4481 
Parameters:
4482 
  * eax = 75 - function number
 4482 
  * eax = 75 - function number
4483 
  * bl = 9 - subfunction number
 4483 
  * bl = 9 - subfunction number
4484 
  * ecx = socket number
 4484 
  * ecx = socket number
4485 
  * edx = pointer to optstruct
 4485 
  * edx = pointer to optstruct
4486 
Returned value:
 4486 
Returned value:
4487 
  * eax = -1 on error
 4487 
  * eax = -1 on error
4488 
  * ebx = errorcode
 4488 
  * ebx = errorcode
4489 
Remarks:
 4489 
Remarks:
4490 
 
 4490 
 
4491 
  Optstruct: dd level
 4491 
  Optstruct: dd level
4492 
             dd optionname
 4492 
             dd optionname
4493 
             dd optlength
 4493 
             dd optlength
4494 
             db options...
 4494 
             db options...
4495 
 
 4495 
 
4496 
======================================================================
 4496 
======================================================================
4497 
============ Function 75, Subfunction 10, Get socketpair. ===========
 4497 
============ Function 75, Subfunction 10, Get socketpair. ===========
4498 
======================================================================
 4498 
======================================================================
4499 
Parameters:
 4499 
Parameters:
4500 
  * eax = 75 - function number
 4500 
  * eax = 75 - function number
4501 
  * bl = 10 - subfunction number
 4501 
  * bl = 10 - subfunction number
4502 
Returned value:
 4502 
Returned value:
4503 
  * eax = socketnum1, -1 on error
 4503 
  * eax = socketnum1, -1 on error
4504 
  * ebx = socketnum2, errorcode on error
 4504 
  * ebx = socketnum2, errorcode on error
4505 
Remarks:
 4505 
Remarks:
4506 
 
 4506 
 
4507 
  Optstruct: dd level
 4507 
  Optstruct: dd level
4508 
             dd optionname
 4508 
             dd optionname
4509 
             dd optlength
 4509 
             dd optlength
4510 
             db options...
 4510 
             db options...
4511 
 
 4511 
 
4512 
======================================================================
 4512 
======================================================================
4513 
=============== Function -1 - terminate thread/process ===============
 4513 
=============== Function -1 - terminate thread/process ===============
4514 
======================================================================
 4514 
======================================================================
4515 
Parameters:
 4515 
Parameters:
4516 
  * eax = -1 - function number
 4516 
  * eax = -1 - function number
4517 
Returned value:
 4517 
Returned value:
4518 
  * function does not return neither value nor control
 4518 
  * function does not return neither value nor control
4519 
Remarks:
 4519 
Remarks:
4520 
  * If the process did not create threads obviously, it has only
 4520 
  * If the process did not create threads obviously, it has only
4521 
    one thread, which termination results in process termination.
 4521 
    one thread, which termination results in process termination.
4522 
  * If the current thread is last in the process, its termination
 4522 
  * If the current thread is last in the process, its termination
4523 
    also results in process terminates.
 4523 
    also results in process terminates.
4524 
  * This function terminates the current thread. Other thread can be
 4524 
  * This function terminates the current thread. Other thread can be
4525 
    killed by call to subfunction 2 of function 18.
 4525 
    killed by call to subfunction 2 of function 18.
4526 
 
 4526 
 
4527 
======================================================================
 4527 
======================================================================
4528 
=========================== List of events ===========================
 4528 
=========================== List of events ===========================
4529 
======================================================================
 4529 
======================================================================
4530 
Next event can be retrieved by the call of one from functions 10
 4530 
Next event can be retrieved by the call of one from functions 10
4531 
(to wait for event), 11 (to check without waiting), 23
 4531 
(to wait for event), 11 (to check without waiting), 23
4532 
(to wait during the given time).
 4532 
(to wait during the given time).
4533 
These functions return only those events, which enter into a mask set
 4533 
These functions return only those events, which enter into a mask set
4534 
by function 40. By default it is first three,
 4534 
by function 40. By default it is first three,
4535 
there is enough for most applications.
 4535 
there is enough for most applications.
4536 
Codes of events:
 4536 
Codes of events:
4537 
  * 1 = redraw event (is reset by call to function 0)
 4537 
  * 1 = redraw event (is reset by call to function 0)
4538 
  * 2 = key on keyboard is pressed (acts, only when the window is
 4538 
  * 2 = key on keyboard is pressed (acts, only when the window is
4539 
    active) or hotkey is pressed; is reset, when all keys from
 4539 
    active) or hotkey is pressed; is reset, when all keys from
4540 
    the buffer are read out by function 2
 4540 
    the buffer are read out by function 2
4541 
  * 3 = button is pressed, defined earlier by function 8
 4541 
  * 3 = button is pressed, defined earlier by function 8
4542 
    (or close button, created implicitly by function 0;
 4542 
    (or close button, created implicitly by function 0;
4543 
    minimize button is handled by the system and sends no message;
 4543 
    minimize button is handled by the system and sends no message;
4544 
    acts, only when the window is active;
 4544 
    acts, only when the window is active;
4545 
    is reset when all buttons from the buffer
 4545 
    is reset when all buttons from the buffer
4546 
    are read out by function 17)
 4546 
    are read out by function 17)
4547 
  * 4 = reserved (in current implementation never comes even after
 4547 
  * 4 = reserved (in current implementation never comes even after
4548 
    unmasking by function 40)
 4548 
    unmasking by function 40)
4549 
  * 5 = kernel finished redrawing of the desktop background
 4549 
  * 5 = kernel finished redrawing of the desktop background
4550 
  * 6 = mouse event (something happened - button pressing or moving;
 4550 
  * 6 = mouse event (something happened - button pressing or moving;
4551 
    is reset at reading)
 4551 
    is reset at reading)
4552 
  * 7 = IPC event (see function 60 -
 4552 
  * 7 = IPC event (see function 60 -
4553 
    Inter Process Communication; is reset at reading)
 4553 
    Inter Process Communication; is reset at reading)
4554 
  * 8 = network event (is reset at reading)
 4554 
  * 8 = network event (is reset at reading)
4555 
  * 9 = debug event (is reset at reading; see
 4555 
  * 9 = debug event (is reset at reading; see
4556 
    debug subsystem)
 4556 
    debug subsystem)
4557 
  * 16..31 = event with appropriate IRQ
 4557 
  * 16..31 = event with appropriate IRQ
4558 
    (16=IRQ0, 31=IRQ15) (is reset after reading all IRQ data)
 4558 
    (16=IRQ0, 31=IRQ15) (is reset after reading all IRQ data)
4559 
 
 4559 
 
4560 
======================================================================
 4560 
======================================================================
4561 
=================== Error codes of the file system ===================
 4561 
=================== Error codes of the file system ===================
4562 
======================================================================
 4562 
======================================================================
4563 
  * 0 = success
 4563 
  * 0 = success
4564 
  * 1 = base and/or partition of a hard disk is not defined
 4564 
  * 1 = base and/or partition of a hard disk is not defined
4565 
    (by subfunctions 7, 8 of function 21)
 4565 
    (by subfunctions 7, 8 of function 21)
4566 
  * 2 = function is not supported for the given file system
 4566 
  * 2 = function is not supported for the given file system
4567 
  * 3 = unknown file system
 4567 
  * 3 = unknown file system
4568 
  * 4 = reserved, is never returned in the current implementation
 4568 
  * 4 = reserved, is never returned in the current implementation
4569 
  * 5 = file not found
 4569 
  * 5 = file not found
4570 
  * 6 = end of file, EOF
 4570 
  * 6 = end of file, EOF
4571 
  * 7 = pointer lies outside of application memory
 4571 
  * 7 = pointer lies outside of application memory
4572 
  * 8 = disk is full
 4572 
  * 8 = disk is full
4573 
  * 9 = FAT table is destroyed
 4573 
  * 9 = FAT table is destroyed
4574 
  * 10 = access denied
 4574 
  * 10 = access denied
4575 
  * 11 = device error
 4575 
  * 11 = device error
4576 
Application start functions can return also following errors:
 4576 
Application start functions can return also following errors:
4577 
  * 30 = 0x1E = not enough memory
 4577 
  * 30 = 0x1E = not enough memory
4578 
  * 31 = 0x1F = file is not executable
 4578 
  * 31 = 0x1F = file is not executable
4579 
  * 32 = 0x20 = too many processes
 4579 
  * 32 = 0x20 = too many processes
4580 
>
 4580 
>
4581 
>
 4581 
>