Subversion Repositories Kolibri OS

Rev

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

Rev 1494 Rev 1662
1
SYSTEM FUNCTIONS of OS Kolibri 0.7.5.0
1
SYSTEM FUNCTIONS of OS Kolibri 0.7.7.0
2
 
2
 
3
Number of the function is located in the register eax.
3
Number of the function is located in the register eax.
4
The call of the system function is executed by "int 0x40" command.
4
The call of the system function is executed by "int 0x40" command.
5
All registers except explicitly declared in the returned value,
5
All registers except explicitly declared in the returned value,
6
    including eflags, are preserved.
6
    including eflags, are preserved.
7
 
7
 
8
 
8
 
9
======================================================================
9
======================================================================
10
============== Function 0 - define and draw the window. ==============
10
============== Function 0 - define and draw the window. ==============
11
======================================================================
11
======================================================================
12
Defines an application window. Draws a frame of the window, header and
12
Defines an application window. Draws a frame of the window, header and
13
working area. For skinned windows defines standard close and minimize
13
working area. For skinned windows defines standard close and minimize
14
buttons.
14
buttons.
15
Parameters:
15
Parameters:
16
  * eax = 0 - function number
16
  * eax = 0 - function number
17
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
17
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
18
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
18
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
19
  * edx = 0xXYRRGGBB, where:
19
  * edx = 0xXYRRGGBB, where:
20
    * Y = style of the window:
20
    * Y = style of the window:
21
      * Y=0 - type I - fixed-size window
21
      * Y=0 - type I - fixed-size window
22
      * Y=1 - only define window area, draw nothing
22
      * Y=1 - only define window area, draw nothing
23
      * Y=2 - type II - variable-size window
23
      * Y=2 - type II - variable-size window
24
      * Y=3 - skinned window
24
      * Y=3 - skinned window
25
      * Y=4 - skinned fixed-size window
25
      * Y=4 - skinned fixed-size window
26
      * other possible values (from 5 up to 15) are reserved,
26
      * other possible values (from 5 up to 15) are reserved,
27
        function call with such Y is ignored
27
        function call with such Y is ignored
28
    * RR, GG, BB = accordingly red, green, blue components of a color
28
    * RR, GG, BB = accordingly red, green, blue components of a color
29
      of the working area of the window (are ignored for style Y=2)
29
      of the working area of the window (are ignored for style Y=2)
30
    * X = DCBA (bits)
30
    * X = DCBA (bits)
31
      * A = 1 - window has caption; for styles Y=3,4 caption string
31
      * A = 1 - window has caption; for styles Y=3,4 caption string
32
                  must be passed in edi, for other styles use
32
                  must be passed in edi, for other styles use
33
                  subfunction 1 of function 71
33
                  subfunction 1 of function 71
34
      * B = 1 - coordinates of all graphics primitives are relative to
34
      * B = 1 - coordinates of all graphics primitives are relative to
35
                  window client area
35
                  window client area
36
      * C = 1 - don't fill working area on window draw
36
      * C = 1 - don't fill working area on window draw
37
      * D = 0 - normal filling of the working area, 1 - gradient
37
      * D = 0 - normal filling of the working area, 1 - gradient
38
    The following parameters are intended for windows
38
    The following parameters are intended for windows
39
    of a type I and II, and ignored for styles Y=1,3:
39
    of a type I and II, and ignored for styles Y=1,3:
40
  * esi = 0xXYRRGGBB - color of the header
40
  * esi = 0xXYRRGGBB - color of the header
41
    * RR, GG, BB define color
41
    * RR, GG, BB define color
42
    * Y=0 - usual window, Y=1 - unmovable window
42
    * Y=0 - usual window, Y=1 - unmovable window
43
    * X defines a gradient of header: X=0 - no gradient,
43
    * X defines a gradient of header: X=0 - no gradient,
44
      X=8 - usual gradient,
44
      X=8 - usual gradient,
45
      for windows of a type II X=4 - negative gradient
45
      for windows of a type II X=4 - negative gradient
46
    * other values of X and Y are reserved
46
    * other values of X and Y are reserved
47
  * edi = 0x00RRGGBB - color of the frame
47
  * edi = 0x00RRGGBB - color of the frame
48
Returned value:
48
Returned value:
49
  * function does not return value
49
  * function does not return value
50
Remarks:
50
Remarks:
51
  * Position and sizes of the window are installed by the first
51
  * Position and sizes of the window are installed by the first
52
    call of this function and are ignored at subsequent; to change
52
    call of this function and are ignored at subsequent; to change
53
    position and/or sizes of already created window use function 67.
53
    position and/or sizes of already created window use function 67.
54
  * For windows with styles Y=3,4 and caption (A=1) caption string
54
  * For windows with styles Y=3,4 and caption (A=1) caption string
55
    is set by the first call of this function and is ignored
55
    is set by the first call of this function and is ignored
56
    at subsequent (strictly speaking, is ignored after a call to
56
    at subsequent (strictly speaking, is ignored after a call to
57
    subfunction 2 of function 12 - end redraw); to change caption of
57
    subfunction 2 of function 12 - end redraw); to change caption of
58
    already created window use subfunction 1 of function 71.
58
    already created window use subfunction 1 of function 71.
59
  * If the window has appropriate styles, position and/or sizes can be
59
  * If the window has appropriate styles, position and/or sizes can be
60
    changed by user. Current position and sizes can be obtained
60
    changed by user. Current position and sizes can be obtained
61
    by function 9.
61
    by function 9.
62
  * The window must fit on the screen. If the transferred
62
  * The window must fit on the screen. If the transferred
63
    coordinates and sizes do not satisfy to this condition,
63
    coordinates and sizes do not satisfy to this condition,
64
    appropriate coordinate (or, probably, both) is considered as zero,
64
    appropriate coordinate (or, probably, both) is considered as zero,
65
    and if it does not help too, the appropriate size
65
    and if it does not help too, the appropriate size
66
    (or, probably, both) is installed in a size of the screen.
66
    (or, probably, both) is installed in a size of the screen.
67
    
67
    
68
    Further let us designate xpos,ypos,xsize,ysize - values passed
68
    Further let us designate xpos,ypos,xsize,ysize - values passed
69
    in ebx,ecx. The coordinates are resulted concerning
69
    in ebx,ecx. The coordinates are resulted concerning
70
    the left upper corner of the window, which, thus, is set as (0,0),
70
    the left upper corner of the window, which, thus, is set as (0,0),
71
    coordinates of the right lower corner essence (xsize,ysize).
71
    coordinates of the right lower corner essence (xsize,ysize).
72
  * The sizes of the window are understood in sence of coordinates
72
  * The sizes of the window are understood in sence of coordinates
73
    of the right lower corner. This concerns all other functions too.
73
    of the right lower corner. This concerns all other functions too.
74
    It means, that the real sizes are on 1 pixel more.
74
    It means, that the real sizes are on 1 pixel more.
75
  * The window of type I looks as follows:
75
  * The window of type I looks as follows:
76
    * draw external frame of color indicated in edi, 1 pixel in width
76
    * draw external frame of color indicated in edi, 1 pixel in width
77
    * draw header - rectangle with the left upper corner (1,1) and
77
    * draw header - rectangle with the left upper corner (1,1) and
78
      right lower (xsize-1,min(25,ysize)) color indicated in esi
78
      right lower (xsize-1,min(25,ysize)) color indicated in esi
79
      (taking a gradient into account)
79
      (taking a gradient into account)
80
    * if ysize>=26, fill the working area of the window -
80
    * if ysize>=26, fill the working area of the window -
81
      rectangle with the left upper corner (1,21) and right lower
81
      rectangle with the left upper corner (1,21) and right lower
82
      (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color
82
      (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color
83
      indicated in edx (taking a gradient into account)
83
      indicated in edx (taking a gradient into account)
84
    * if A=1 and caption has been already set by subfunction 1
84
    * if A=1 and caption has been already set by subfunction 1
85
      of function 71, it is drawn in the corresponding place of header
85
      of function 71, it is drawn in the corresponding place of header
86
  * The window of style Y=1 looks as follows:
86
  * The window of style Y=1 looks as follows:
87
    * completely defined by the application
87
    * completely defined by the application
88
  * The window of type II looks as follows:
88
  * The window of type II looks as follows:
89
    * draw external frame of width 1 pixel with the "shaded" color
89
    * draw external frame of width 1 pixel with the "shaded" color
90
      edi (all components of the color decrease twice)
90
      edi (all components of the color decrease twice)
91
    * draw intermediate frame of width 3 pixels with color edi
91
    * draw intermediate frame of width 3 pixels with color edi
92
    * draw internal frame of width 1 pixel with the "shaded" color edi
92
    * draw internal frame of width 1 pixel with the "shaded" color edi
93
    * draw header - rectangle with the left upper corner (4,4)
93
    * draw header - rectangle with the left upper corner (4,4)
94
      and right lower (xsize-4,min(20,ysize)) color, indicated in esi
94
      and right lower (xsize-4,min(20,ysize)) color, indicated in esi
95
      (taking a gradient into account)
95
      (taking a gradient into account)
96
    * if ysize>=26, fill the working area of the window -
96
    * if ysize>=26, fill the working area of the window -
97
      rectangle with the left upper corner (5,20) and right lower
97
      rectangle with the left upper corner (5,20) and right lower
98
      (xsize-5,ysize-5) with color indicated in edx
98
      (xsize-5,ysize-5) with color indicated in edx
99
      (taking a gradient into account)
99
      (taking a gradient into account)
100
    * if A=1 and caption has been already set by subfunction 1
100
    * if A=1 and caption has been already set by subfunction 1
101
      of function 71, it is drawn in the corresponding place of header
101
      of function 71, it is drawn in the corresponding place of header
102
  * The skinned window looks as follows:
102
  * The skinned window looks as follows:
103
    * draw external frame of width 1 pixel
103
    * draw external frame of width 1 pixel
104
      with color 'outer' from the skin
104
      with color 'outer' from the skin
105
    * draw intermediate frame of width 3 pixel
105
    * draw intermediate frame of width 3 pixel
106
      with color 'frame' from the skin
106
      with color 'frame' from the skin
107
    * draw internal frame of width 1 pixel
107
    * draw internal frame of width 1 pixel
108
      with color 'inner' from the skin
108
      with color 'inner' from the skin
109
    * draw header (on bitmaps from the skin) in a rectangle
109
    * draw header (on bitmaps from the skin) in a rectangle
110
      (0,0) - (xsize,_skinh-1)
110
      (0,0) - (xsize,_skinh-1)
111
    * if ysize>=26, fill the working area of the window -
111
    * if ysize>=26, fill the working area of the window -
112
      rectangle with the left upper corner (5,_skinh) and right lower
112
      rectangle with the left upper corner (5,_skinh) and right lower
113
      (xsize-5,ysize-5) with color indicated in edx
113
      (xsize-5,ysize-5) with color indicated in edx
114
      (taking a gradient into account)
114
      (taking a gradient into account)
115
    * define two standard buttons: close and minimize
115
    * define two standard buttons: close and minimize
116
      (see function 8)
116
      (see function 8)
117
    * if A=1 and edi contains (nonzero) pointer to caption string,
117
    * if A=1 and edi contains (nonzero) pointer to caption string,
118
      it is drawn in place in header defined in the skin
118
      it is drawn in place in header defined in the skin
119
    * value _skinh is accessible as the result of call
119
    * value _skinh is accessible as the result of call
120
      subfunction 4 of function 48
120
      subfunction 4 of function 48
121
 
121
 
122
======================================================================
122
======================================================================
123
================ Function 1 - put pixel in the window. ===============
123
================ Function 1 - put pixel in the window. ===============
124
======================================================================
124
======================================================================
125
Parameters:
125
Parameters:
126
  * eax = 1 - function number
126
  * eax = 1 - function number
127
  * ebx = x-coordinate (relative to the window)
127
  * ebx = x-coordinate (relative to the window)
128
  * ecx = y-coordinate (relative to the window)
128
  * ecx = y-coordinate (relative to the window)
129
  * edx = 0x00RRGGBB - color of a pixel
129
  * edx = 0x00RRGGBB - color of a pixel
130
    edx = 0x01xxxxxx - invert color of a pixel
130
    edx = 0x01xxxxxx - invert color of a pixel
131
          (low 24 bits are ignored)
131
          (low 24 bits are ignored)
132
Returned value:
132
Returned value:
133
  * function does not return value
133
  * function does not return value
134
 
134
 
135
======================================================================
135
======================================================================
136
============ Function 2 - get the code of the pressed key. ===========
136
============ Function 2 - get the code of the pressed key. ===========
137
======================================================================
137
======================================================================
138
Takes away the code of the pressed key from the buffer.
138
Takes away the code of the pressed key from the buffer.
139
Parameters:
139
Parameters:
140
  * eax = 2 - function number
140
  * eax = 2 - function number
141
Returned value:
141
Returned value:
142
  * if the buffer is empty, function returns eax=1
142
  * if the buffer is empty, function returns eax=1
143
  * if the buffer is not empty, function returns al=0,
143
  * if the buffer is not empty, function returns al=0,
144
    ah=code of the pressed key, high word of eax is zero
144
    ah=code of the pressed key, high word of eax is zero
145
  * if there is "hotkey", function returns al=2,
145
  * if there is "hotkey", function returns al=2,
146
    ah=scancode of the pressed key (0 for control keys),
146
    ah=scancode of the pressed key (0 for control keys),
147
    high word of eax contains a status of control keys at the moment
147
    high word of eax contains a status of control keys at the moment
148
    of pressing a hotkey
148
    of pressing a hotkey
149
Remarks:
149
Remarks:
150
  * There is a common system buffer of the pressed keys
150
  * There is a common system buffer of the pressed keys
151
    by a size of 120 bytes, organized as queue.
151
    by a size of 120 bytes, organized as queue.
152
  * There is one more common system buffer on 120 "hotkeys".
152
  * There is one more common system buffer on 120 "hotkeys".
153
  * If the application with the inactive window calls this function,
153
  * If the application with the inactive window calls this function,
154
    the buffer of the pressed keys is considered to be empty.
154
    the buffer of the pressed keys is considered to be empty.
155
  * By default this function returns ASCII-codes; to switch
155
  * By default this function returns ASCII-codes; to switch
156
    to the scancodes mode (and back) use function 66.
156
    to the scancodes mode (and back) use function 66.
157
    However, hotkeys are always notificated as scancodes.
157
    However, hotkeys are always notificated as scancodes.
158
  * To find out, what keys correspond to what codes, start
158
  * To find out, what keys correspond to what codes, start
159
    the application keyascii and scancode.
159
    the application keyascii and scancode.
160
  * Scancodes come directly from keyboard and are fixed;
160
  * Scancodes come directly from keyboard and are fixed;
161
    ASCII-codes turn out with usage of the conversion tables,
161
    ASCII-codes turn out with usage of the conversion tables,
162
    which can be set by subfunction 2 of function 21
162
    which can be set by subfunction 2 of function 21
163
    and get by subfunction 2 of function 26.
163
    and get by subfunction 2 of function 26.
164
  * As a consequence, ASCII-codes take into account current
164
  * As a consequence, ASCII-codes take into account current
165
    keyboard layout (rus/en) as opposed to scancodes.
165
    keyboard layout (rus/en) as opposed to scancodes.
166
  * This function notifies only about those hotkeys, which were
166
  * This function notifies only about those hotkeys, which were
167
    defined by this thread by subfunction 4 of function 66.
167
    defined by this thread by subfunction 4 of function 66.
168
 
168
 
169
======================================================================
169
======================================================================
170
==================== Function 3 - get system time. ===================
170
==================== Function 3 - get system time. ===================
171
======================================================================
171
======================================================================
172
Parameters:
172
Parameters:
173
  * eax = 3 - function number
173
  * eax = 3 - function number
174
Returned value:
174
Returned value:
175
  * eax = 0x00SSMMHH, where HH:MM:SS = Hours:Minutes:Seconds
175
  * eax = 0x00SSMMHH, where HH:MM:SS = Hours:Minutes:Seconds
176
  * each item is BCD-number, for example,
176
  * each item is BCD-number, for example,
177
    for time 23:59:59 function returns 0x00595923
177
    for time 23:59:59 function returns 0x00595923
178
Remarks:
178
Remarks:
179
  * See also subfunction 9 of function 26 - get time from
179
  * See also subfunction 9 of function 26 - get time from
180
    the moment of start of the system; it is more convenient, because
180
    the moment of start of the system; it is more convenient, because
181
    returns simply DWORD-value of the time counter.
181
    returns simply DWORD-value of the time counter.
182
  * System time can be set by function 22.
182
  * System time can be set by function 22.
183
 
183
 
184
======================================================================
184
======================================================================
185
============ Function 4 - draw text string in the window. ============
185
============ Function 4 - draw text string in the window. ============
186
======================================================================
186
======================================================================
187
Parameters:
187
Parameters:
188
  * eax = 4 - function number
188
  * eax = 4 - function number
189
  * ebx = [coordinate on axis x]*65536 + [coordinate on axis y]
189
  * ebx = [coordinate on axis x]*65536 + [coordinate on axis y]
190
  * ecx = 0xX0RRGGBB, where
190
  * ecx = 0xX0RRGGBB, where
191
    * RR, GG, BB specify text color
191
    * RR, GG, BB specify text color
192
    * X=ABnn (bits):
192
    * X=ABnn (bits):
193
    * nn specifies the used font: 0=system monospaced,
193
    * nn specifies the used font: 0=system monospaced,
194
      1=system font of variable width
194
      1=system font of variable width
195
    * A=0 - output esi characters, A=1 - output ASCIIZ-string
195
    * A=0 - output esi characters, A=1 - output ASCIIZ-string
196
    * B=1 - fill background with the color edi
196
    * B=1 - fill background with the color edi
197
  * edx = pointer to the beginning of the string
197
  * edx = pointer to the beginning of the string
198
  * esi = for A=0 length of the string, must not exceed 255;
198
  * esi = for A=0 length of the string, must not exceed 255;
199
          for A=1 is ignored
199
          for A=1 is ignored
200
Returned value:
200
Returned value:
201
  * function does not return value
201
  * function does not return value
202
Remarks:
202
Remarks:
203
  * First system font is read out at loading from the file char.mt,
203
  * First system font is read out at loading from the file char.mt,
204
    second - from char2.mt.
204
    second - from char2.mt.
205
  * Both fonts have height 9 pixels, width of the monospaced font
205
  * Both fonts have height 9 pixels, width of the monospaced font
206
    is equal to 6 pixels.
206
    is equal to 6 pixels.
207
 
207
 
208
======================================================================
208
======================================================================
209
========================= Function 5 - delay. ========================
209
========================= Function 5 - delay. ========================
210
======================================================================
210
======================================================================
211
Delays execution of the program on the given time.
211
Delays execution of the program on the given time.
212
Parameters:
212
Parameters:
213
  * eax = 5 - function number
213
  * eax = 5 - function number
214
  * ebx = time in the 1/100 of second
214
  * ebx = time in the 1/100 of second
215
Returned value:
215
Returned value:
216
  * function does not return value
216
  * function does not return value
217
Remarks:
217
Remarks:
218
  * Passing ebx=0 does not transfer control to the next process
218
  * Passing ebx=0 does not transfer control to the next process
219
    and does not make any operations at all. If it is really required
219
    and does not make any operations at all. If it is really required
220
    to transfer control to the next process (to complete a current
220
    to transfer control to the next process (to complete a current
221
    time slice), use subfunction 1 of function 68.
221
    time slice), use subfunction 1 of function 68.
222
 
222
 
223
======================================================================
223
======================================================================
224
============== Function 6 - read the file from ramdisk. ==============
224
============== Function 6 - read the file from ramdisk. ==============
225
======================================================================
225
======================================================================
226
Parameters:
226
Parameters:
227
  * eax = 6 - function number
227
  * eax = 6 - function number
228
  * ebx = pointer to the filename
228
  * ebx = pointer to the filename
229
  * ecx = number of start block, beginning from 1;
229
  * ecx = number of start block, beginning from 1;
230
    ecx=0 - read from the beginning of the file (same as ecx=1)
230
    ecx=0 - read from the beginning of the file (same as ecx=1)
231
  * edx = number of blocks to read;
231
  * edx = number of blocks to read;
232
    edx=0 - read one block (same as edx=1)
232
    edx=0 - read one block (same as edx=1)
233
  * esi = pointer to memory area for the data
233
  * esi = pointer to memory area for the data
234
Returned value:
234
Returned value:
235
  * eax = file size in bytes, if the file was successfully read
235
  * eax = file size in bytes, if the file was successfully read
236
  * eax = -1, if the file was not found
236
  * eax = -1, if the file was not found
237
Remarks:
237
Remarks:
238
  * This function is out-of-date; function 70 allows
238
  * This function is out-of-date; function 70 allows
239
    to fulfil the same operations with the extended possibilities.
239
    to fulfil the same operations with the extended possibilities.
240
  * Block = 512 bytes.
240
  * Block = 512 bytes.
241
  * For reading all file you can specify the certainly large value
241
  * For reading all file you can specify the certainly large value
242
    in edx, for example, edx = -1; but in this case be ready that
242
    in edx, for example, edx = -1; but in this case be ready that
243
    the program will "fall", if the file will appear too large and can
243
    the program will "fall", if the file will appear too large and can
244
    not be placed in the program memory.
244
    not be placed in the program memory.
245
  * The filename must be either in the format 8+3 characters
245
  * The filename must be either in the format 8+3 characters
246
    (first 8 characters - name itself, last 3 - extension,
246
    (first 8 characters - name itself, last 3 - extension,
247
    the short names and extensions are supplemented with spaces),
247
    the short names and extensions are supplemented with spaces),
248
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
248
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
249
    (name no more than 8 characters, dot, extension 3 characters
249
    (name no more than 8 characters, dot, extension 3 characters
250
    supplemented if necessary by spaces).
250
    supplemented if necessary by spaces).
251
    The filename must be written with capital letters. The terminating
251
    The filename must be written with capital letters. The terminating
252
    character with code 0 is not necessary (not ASCIIZ-string).
252
    character with code 0 is not necessary (not ASCIIZ-string).
253
  * This function does not support folders on the ramdisk.
253
  * This function does not support folders on the ramdisk.
254
 
254
 
255
======================================================================
255
======================================================================
256
=============== Function 7 - draw image in the window. ===============
256
=============== Function 7 - draw image in the window. ===============
257
======================================================================
257
======================================================================
258
Paramters:
258
Paramters:
259
  * eax = 7 - function number
259
  * eax = 7 - function number
260
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
260
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
261
  * ecx = [size on axis x]*65536 + [size on axis y]
261
  * ecx = [size on axis x]*65536 + [size on axis y]
262
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
262
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
263
Returned value:
263
Returned value:
264
  * function does not return value
264
  * function does not return value
265
Remarks:
265
Remarks:
266
  * Coordinates of the image are coordinates of the upper left corner
266
  * Coordinates of the image are coordinates of the upper left corner
267
    of the image relative to the window.
267
    of the image relative to the window.
268
  * Size of the image in bytes is 3*xsize*ysize.
268
  * Size of the image in bytes is 3*xsize*ysize.
269
 
269
 
270
======================================================================
270
======================================================================
271
=============== Function 8 - define/delete the button. ===============
271
=============== Function 8 - define/delete the button. ===============
272
======================================================================
272
======================================================================
273
Parameters for button definition:
273
Parameters for button definition:
274
  * eax = 8 - function number
274
  * eax = 8 - function number
275
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
275
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
276
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
276
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
277
  * edx = 0xXYnnnnnn, where:
277
  * edx = 0xXYnnnnnn, where:
278
    * nnnnnn = identifier of the button
278
    * nnnnnn = identifier of the button
279
    * high (31st) bit of edx is cleared
279
    * high (31st) bit of edx is cleared
280
    * if 30th bit of edx is set - do not draw the button
280
    * if 30th bit of edx is set - do not draw the button
281
    * if 29th bit of edx is set - do not draw a frame
281
    * if 29th bit of edx is set - do not draw a frame
282
      at pressing the button
282
      at pressing the button
283
  * esi = 0x00RRGGBB - color of the button
283
  * esi = 0x00RRGGBB - color of the button
284
Parameters for button deleting:
284
Parameters for button deleting:
285
  * eax = 8 - function number
285
  * eax = 8 - function number
286
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
286
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
287
Returned value:
287
Returned value:
288
  * function does not return value
288
  * function does not return value
289
Remarks:
289
Remarks:
290
  * Sizes of the button must be more than 0 and less than 0x8000.
290
  * Sizes of the button must be more than 0 and less than 0x8000.
291
  * For skinned windows definition of the window
291
  * For skinned windows definition of the window
292
    (call of 0th function) creates two standard buttons -
292
    (call of 0th function) creates two standard buttons -
293
    for close of the window with identifier 1 and
293
    for close of the window with identifier 1 and
294
    for minimize of the window with identifier 0xffff.
294
    for minimize of the window with identifier 0xffff.
295
  * The creation of two buttons with same identifiers is admitted.
295
  * The creation of two buttons with same identifiers is admitted.
296
  * The button with the identifier 0xffff at pressing is interpreted
296
  * The button with the identifier 0xffff at pressing is interpreted
297
    by the system as the button of minimization, the system handles
297
    by the system as the button of minimization, the system handles
298
    such pressing independently, not accessing to the application.
298
    such pressing independently, not accessing to the application.
299
    In rest it is usual button.
299
    In rest it is usual button.
300
  * Total number of buttons for all applications is limited to 4095.
300
  * Total number of buttons for all applications is limited to 4095.
301
 
301
 
302
======================================================================
302
======================================================================
303
============ Function 9 - information on execution thread. ===========
303
============ Function 9 - information on execution thread. ===========
304
======================================================================
304
======================================================================
305
Parameters:
305
Parameters:
306
  * eax = 9 - function number
306
  * eax = 9 - function number
307
  * ebx = pointer to 1-Kb buffer
307
  * ebx = pointer to 1-Kb buffer
308
  * ecx = number of the slot of the thread
308
  * ecx = number of the slot of the thread
309
    ecx = -1 - get information on the current thread
309
    ecx = -1 - get information on the current thread
310
Returned value:
310
Returned value:
311
  * eax = maximum number of the slot of a thread
311
  * eax = maximum number of the slot of a thread
312
  * buffer pointed to by ebx contains the following information:
312
  * buffer pointed to by ebx contains the following information:
313
    * +0: dword: usage of the processor (how many time units
313
    * +0: dword: usage of the processor (how many time units
314
      per second leaves on execution of this thread)
314
      per second leaves on execution of this thread)
315
    * +4: word: position of the window of thread in the window stack
315
    * +4: word: position of the window of thread in the window stack
316
    * +6: word: (has no relation to the specified thread)
316
    * +6: word: (has no relation to the specified thread)
317
      number of the thread slot, which window has in the window stack
317
      number of the thread slot, which window has in the window stack
318
      position ecx
318
      position ecx
319
    * +8: word: reserved
319
    * +8: word: reserved
320
    * +10 = +0xA: 11 bytes: name of the process
320
    * +10 = +0xA: 11 bytes: name of the process
321
      (name of corresponding executable file in the format 8+3)
321
      (name of corresponding executable file in the format 8+3)
322
    * +21 = +0x15: byte: reserved, this byte is not changed
322
    * +21 = +0x15: byte: reserved, this byte is not changed
323
    * +22 = +0x16: dword: address of the process in memory
323
    * +22 = +0x16: dword: address of the process in memory
324
    * +26 = +0x1A: dword: size of used memory - 1
324
    * +26 = +0x1A: dword: size of used memory - 1
325
    * +30 = +0x1E: dword: identifier (PID/TID)
325
    * +30 = +0x1E: dword: identifier (PID/TID)
326
    * +34 = +0x22: dword: coordinate of the thread window on axis x
326
    * +34 = +0x22: dword: coordinate of the thread window on axis x
327
    * +38 = +0x26: dword: coordinate of the thread window on axis y
327
    * +38 = +0x26: dword: coordinate of the thread window on axis y
328
    * +42 = +0x2A: dword: size of the thread window on axis x
328
    * +42 = +0x2A: dword: size of the thread window on axis x
329
    * +46 = +0x2E: dword: size of the thread window on axis y
329
    * +46 = +0x2E: dword: size of the thread window on axis y
330
    * +50 = +0x32: word: status of the thread slot:
330
    * +50 = +0x32: word: status of the thread slot:
331
      * 0 = thread is running
331
      * 0 = thread is running
332
      * 1 = thread is suspended
332
      * 1 = thread is suspended
333
      * 2 = thread is suspended while waiting for event
333
      * 2 = thread is suspended while waiting for event
334
      * 3 = thread is terminating as a result of call to function -1
334
      * 3 = thread is terminating as a result of call to function -1
335
        or under duress as a result of call to subfunction 2
335
        or under duress as a result of call to subfunction 2
336
        of function 18 or termination of the system
336
        of function 18 or termination of the system
337
      * 4 = thread is terminating as a result of exception
337
      * 4 = thread is terminating as a result of exception
338
      * 5 = thread waits for event
338
      * 5 = thread waits for event
339
      * 9 = requested slot is free, all other information on the slot
339
      * 9 = requested slot is free, all other information on the slot
340
        is not meaningful
340
        is not meaningful
341
    * +52 = +0x34: word: reserved, this word is not changed
341
    * +52 = +0x34: word: reserved, this word is not changed
342
    * +54 = +0x36: dword: coordinate of the client area on axis x
342
    * +54 = +0x36: dword: coordinate of the client area on axis x
343
    * +58 = +0x3A: dword: coordinate of the client area on axis y
343
    * +58 = +0x3A: dword: coordinate of the client area on axis y
344
    * +62 = +0x3E: dword: width of the client area
344
    * +62 = +0x3E: dword: width of the client area
345
    * +66 = +0x42: dword: height of the client area
345
    * +66 = +0x42: dword: height of the client area
346
    * +70 = +0x46: byte: state of the window - bitfield
346
    * +70 = +0x46: byte: state of the window - bitfield
347
      * bit 0 (mask 1): window is maximized
347
      * bit 0 (mask 1): window is maximized
348
      * bit 1 (mask 2): window is minimized to panel
348
      * bit 1 (mask 2): window is minimized to panel
349
      * bit 2 (mask 4): window is rolled up
349
      * bit 2 (mask 4): window is rolled up
350
Remarks:
350
Remarks:
351
  * Slots are numbered starting from 1.
351
  * Slots are numbered starting from 1.
352
  * Returned value is not a total number of threads, because there
352
  * Returned value is not a total number of threads, because there
353
    can be free slots.
353
    can be free slots.
354
  * When process is starting, system automatically creates
354
  * When process is starting, system automatically creates
355
    execution thread.
355
    execution thread.
356
  * Function gives information on the thread. Each process has
356
  * Function gives information on the thread. Each process has
357
    at least one thread. One process can create many threads,
357
    at least one thread. One process can create many threads,
358
    in this case each thread has its own slot and the fields
358
    in this case each thread has its own slot and the fields
359
    +10, +22, +26 in these slots coincide.
359
    +10, +22, +26 in these slots coincide.
360
    Applications have no common way to define whether two threads
360
    Applications have no common way to define whether two threads
361
    belong to one process.
361
    belong to one process.
362
  * The active window - window on top of the window stack -
362
  * The active window - window on top of the window stack -
363
    receives the messages on a keyboard input. For such window
363
    receives the messages on a keyboard input. For such window
364
    the position in the window stack coincides with returned value.
364
    the position in the window stack coincides with returned value.
365
  * Slot 1 corresponds to special system thread, for which:
365
  * Slot 1 corresponds to special system thread, for which:
366
    * the window is in the bottom of the window stack, the fields
366
    * the window is in the bottom of the window stack, the fields
367
      +4 and +6 contain value 1
367
      +4 and +6 contain value 1
368
    * name of the process - "OS/IDLE" (supplemented by spaces)
368
    * name of the process - "OS/IDLE" (supplemented by spaces)
369
    * address of the process in memory is 0, size of used memory is
369
    * address of the process in memory is 0, size of used memory is
370
      16 Mb (0x1000000)
370
      16 Mb (0x1000000)
371
    * PID=1
371
    * PID=1
372
    * coordinates and sizes of the window and the client area are by
372
    * coordinates and sizes of the window and the client area are by
373
      convention set to 0
373
      convention set to 0
374
    * status of the slot is always 0 (running)
374
    * status of the slot is always 0 (running)
375
    * the execution time adds of time leaving on operations itself
375
    * the execution time adds of time leaving on operations itself
376
      and idle time in waiting for interrupt (which can be got by call
376
      and idle time in waiting for interrupt (which can be got by call
377
      to subfunction 4 of function 18).
377
      to subfunction 4 of function 18).
378
  * Beginning from slot 2, the normal applications are placed.
378
  * Beginning from slot 2, the normal applications are placed.
379
  * Applications are placed in memory at the address   0x0 
379
  * The normal applications are placed in memory at the address
380
    (kernel constant 'std_application_base_address').
380
    0 (kernel constant 'std_application_base_address').
381
    There is no intersection, as each process has its own page table.
381
    There is no intersection, as each process has its own page table.
382
  * At creation of the thread it is assigned the slot
382
  * At creation of the thread it is assigned the slot
383
    in the system table and identifier (Process/Thread IDentifier =
383
    in the system table and identifier (Process/Thread IDentifier =
384
    PID/TID), which do not vary with time for given thread.
384
    PID/TID), which do not vary with time for given thread.
385
    After completion of the thread its slot can be anew used
385
    After completion of the thread its slot can be anew used
386
    for another thread. The thread identifier can not be assigned
386
    for another thread. The thread identifier can not be assigned
387
    to other thread even after completion of this thread.
387
    to other thread even after completion of this thread.
388
    Identifiers, assigned to new threads, grow monotonously.
388
    Identifiers, assigned to new threads, grow monotonously.
389
  * If the thread has not yet defined the window by call to
389
  * If the thread has not yet defined the window by call to
390
    function 0, the position and the sizes
390
    function 0, the position and the sizes
391
    of its window are considered to be zero.
391
    of its window are considered to be zero.
392
  * Coordinates of the client area are relative to the window.
392
  * Coordinates of the client area are relative to the window.
393
  * At the moment only the part of the buffer by a size
393
  * At the moment only the part of the buffer by a size
394
    71 = 0x37 bytes is used. Nevertheless it is recommended to use
394
    71 = 0x37 bytes is used. Nevertheless it is recommended to use
395
    1-Kb buffer for the future compatibility, in the future
395
    1-Kb buffer for the future compatibility, in the future
396
    some fields can be added.
396
    some fields can be added.
397
 
397
 
398
======================================================================
398
======================================================================
399
==================== Function 10 - wait for event. ===================
399
==================== Function 10 - wait for event. ===================
400
======================================================================
400
======================================================================
401
If the message queue is empty, waits for appearance of the message
401
If the message queue is empty, waits for appearance of the message
402
in queue. In this state thread does not consume CPU time.
402
in queue. In this state thread does not consume CPU time.
403
Then reads out the message from queue.
403
Then reads out the message from queue.
404
 
404
 
405
Parameters:
405
Parameters:
406
  * eax = 10 - function number
406
  * eax = 10 - function number
407
Returned value:
407
Returned value:
408
  * eax = event (see the list of events)
408
  * eax = event (see the list of events)
409
Remarks:
409
Remarks:
410
  * Those events are taken into account only which enter into
410
  * Those events are taken into account only which enter into
411
    a mask set by function 40. By default it is
411
    a mask set by function 40. By default it is
412
    redraw, key and button events.
412
    redraw, key and button events.
413
  * To check, whether there is a message in queue, use function 11.
413
  * To check, whether there is a message in queue, use function 11.
414
    To wait for no more than given time, use function 23.
414
    To wait for no more than given time, use function 23.
415
 
415
 
416
======================================================================
416
======================================================================
417
=============== Function 11 - check for event, no wait. ==============
417
=============== Function 11 - check for event, no wait. ==============
418
======================================================================
418
======================================================================
419
If the message queue contains event, function reads out
419
If the message queue contains event, function reads out
420
and return it. If the queue is empty, function returns 0.
420
and return it. If the queue is empty, function returns 0.
421
Parameters:
421
Parameters:
422
  * eax = 11 - function number
422
  * eax = 11 - function number
423
Returned value:
423
Returned value:
424
  * eax = 0 - message queue is empty
424
  * eax = 0 - message queue is empty
425
  * else eax = event (see the list of events)
425
  * else eax = event (see the list of events)
426
Remarks:
426
Remarks:
427
  * Those events are taken into account only, which enter into
427
  * Those events are taken into account only, which enter into
428
    a mask set by function 40. By default it is
428
    a mask set by function 40. By default it is
429
    redraw, key and button events.
429
    redraw, key and button events.
430
  * To wait for event, use function 10.
430
  * To wait for event, use function 10.
431
    To wait for no more than given time, use function 23.
431
    To wait for no more than given time, use function 23.
432
 
432
 
433
======================================================================
433
======================================================================
434
=============== Function 12 - begin/end window redraw. ===============
434
=============== Function 12 - begin/end window redraw. ===============
435
======================================================================
435
======================================================================
436
 
436
 
437
---------------- Subfunction 1 - begin window redraw. ----------------
437
---------------- Subfunction 1 - begin window redraw. ----------------
438
Parameters:
438
Parameters:
439
  * eax = 12 - function number
439
  * eax = 12 - function number
440
  * ebx = 1 - subfunction number
440
  * ebx = 1 - subfunction number
441
Returned value:
441
Returned value:
442
  * function does not return value
442
  * function does not return value
443
 
443
 
444
----------------- Subfunction 2 - end window redraw. -----------------
444
----------------- Subfunction 2 - end window redraw. -----------------
445
Parameters:
445
Parameters:
446
  * eax = 12 - function number
446
  * eax = 12 - function number
447
  * ebx = 2 - subfunction number
447
  * ebx = 2 - subfunction number
448
Returned value:
448
Returned value:
449
  * function does not return value
449
  * function does not return value
450
Remarks:
450
Remarks:
451
  * Subfunction 1 deletes all buttons defined with
451
  * Subfunction 1 deletes all buttons defined with
452
    function 8, they must be defined again.
452
    function 8, they must be defined again.
453
 
453
 
454
======================================================================
454
======================================================================
455
============ Function 13 - draw a rectangle in the window. ===========
455
============ Function 13 - draw a rectangle in the window. ===========
456
======================================================================
456
======================================================================
457
Parameters:
457
Parameters:
458
  * eax = 13 - function number
458
  * eax = 13 - function number
459
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
459
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
460
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
460
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
461
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
461
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
462
Returned value:
462
Returned value:
463
  * function does not return value
463
  * function does not return value
464
Remarks:
464
Remarks:
465
  * Coordinates are understood as coordinates of the left upper corner
465
  * Coordinates are understood as coordinates of the left upper corner
466
    of a rectangle relative to the window.
466
    of a rectangle relative to the window.
467
 
467
 
468
======================================================================
468
======================================================================
469
=================== Function 14 - get screen size. ===================
469
=================== Function 14 - get screen size. ===================
470
======================================================================
470
======================================================================
471
Parameters:
471
Parameters:
472
  * eax = 14 - function number
472
  * eax = 14 - function number
473
Returned value:
473
Returned value:
474
  * eax = [xsize]*65536 + [ysize], where
474
  * eax = [xsize]*65536 + [ysize], where
475
  * xsize = x-coordinate of the right lower corner of the screen =
475
  * xsize = x-coordinate of the right lower corner of the screen =
476
            horizontal size - 1
476
            horizontal size - 1
477
  * ysize = y-coordinate of the right lower corner of the screen =
477
  * ysize = y-coordinate of the right lower corner of the screen =
478
            vertical size - 1
478
            vertical size - 1
479
Remarks:
479
Remarks:
480
  * See also subfunction 5 of function 48 - get sizes of
480
  * See also subfunction 5 of function 48 - get sizes of
481
    working area of the screen.
481
    working area of the screen.
482
 
482
 
483
======================================================================
483
======================================================================
484
== Function 15, subfunction 1 - set a size of the background image. ==
484
== Function 15, subfunction 1 - set a size of the background image. ==
485
======================================================================
485
======================================================================
486
Parameters:
486
Parameters:
487
  * eax = 15 - function number
487
  * eax = 15 - function number
488
  * ebx = 1 - subfunction number
488
  * ebx = 1 - subfunction number
489
  * ecx = width of the image
489
  * ecx = width of the image
490
  * edx = height of the image
490
  * edx = height of the image
491
Returned value:
491
Returned value:
492
  * function does not return value
492
  * function does not return value
493
Remarks:
493
Remarks:
494
  * Before calling subfunctions 2 and 5 you should call this function
494
  * Before calling subfunctions 2 and 5 you should call this function
495
    to set image size!
495
    to set image size!
496
  * For update of the screen (after completion of a series of commands
496
  * For update of the screen (after completion of a series of commands
497
    working with a background) call subfunction 3.
497
    working with a background) call subfunction 3.
498
  * There is a pair function for get size of the background image -
498
  * There is a pair function for get size of the background image -
499
    subfunction 1 of function 39.
499
    subfunction 1 of function 39.
500
 
500
 
501
======================================================================
501
======================================================================
502
=== Function 15, subfunction 2 - put pixel on the background image. ==
502
=== Function 15, subfunction 2 - put pixel on the background image. ==
503
======================================================================
503
======================================================================
504
Parameters:
504
Parameters:
505
  * eax = 15 - function number
505
  * eax = 15 - function number
506
  * ebx = 2 - subfunction number
506
  * ebx = 2 - subfunction number
507
  * ecx = offset
507
  * ecx = offset
508
  * edx = color of a pixel 0xRRGGBB
508
  * edx = color of a pixel 0xRRGGBB
509
Returned value:
509
Returned value:
510
  * function does not return value
510
  * function does not return value
511
Remarks:
511
Remarks:
512
  * Offset for a pixel with coordinates (x,y) is calculated as
512
  * Offset for a pixel with coordinates (x,y) is calculated as
513
    (x+y*xsize)*3.
513
    (x+y*xsize)*3.
514
  * If the given offset exceeds size set by subfunction 1,
514
  * If the given offset exceeds size set by subfunction 1,
515
    the call is ignored.
515
    the call is ignored.
516
  * For update of the screen (after completion of a series of commands
516
  * For update of the screen (after completion of a series of commands
517
    working with a background) call subfunction 3.
517
    working with a background) call subfunction 3.
518
  * There is a pair function for get pixel on the background image -
518
  * There is a pair function for get pixel on the background image -
519
    subfunction 2 of function 39.
519
    subfunction 2 of function 39.
520
 
520
 
521
======================================================================
521
======================================================================
522
=========== Function 15, subfunction 3 - redraw background. ==========
522
=========== Function 15, subfunction 3 - redraw background. ==========
523
======================================================================
523
======================================================================
524
Parameters:
524
Parameters:
525
  * eax = 15 - function number
525
  * eax = 15 - function number
526
  * ebx = 3 - subfunction number
526
  * ebx = 3 - subfunction number
527
Returned value:
527
Returned value:
528
  * function does not return value
528
  * function does not return value
529
 
529
 
530
======================================================================
530
======================================================================
531
== Function 15, subfunction 4 - set drawing mode for the background. =
531
== Function 15, subfunction 4 - set drawing mode for the background. =
532
======================================================================
532
======================================================================
533
Parameters:
533
Parameters:
534
  * eax = 15 - function number
534
  * eax = 15 - function number
535
  * ebx = 4 - subfunction number
535
  * ebx = 4 - subfunction number
536
  * ecx = drawing mode:
536
  * ecx = drawing mode:
537
    * 1 = tile
537
    * 1 = tile
538
    * 2 = stretch
538
    * 2 = stretch
539
Returned value:
539
Returned value:
540
  * function does not return value
540
  * function does not return value
541
Remarks:
541
Remarks:
542
  * For update of the screen (after completion of a series of commands
542
  * For update of the screen (after completion of a series of commands
543
    working with a background) call subfunction 3.
543
    working with a background) call subfunction 3.
544
  * There is a pair function for get drawing mode of the background -
544
  * There is a pair function for get drawing mode of the background -
545
    subfunction 4 of function 39.
545
    subfunction 4 of function 39.
546
 
546
 
547
======================================================================
547
======================================================================
548
===================== Function 15, subfunction 5 =====================
548
===================== Function 15, subfunction 5 =====================
549
============ Put block of pixels on the background image. ============
549
============ Put block of pixels on the background image. ============
550
======================================================================
550
======================================================================
551
Parameters:
551
Parameters:
552
  * eax = 15 - function number
552
  * eax = 15 - function number
553
  * ebx = 5 - subfunction number
553
  * ebx = 5 - subfunction number
554
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
554
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
555
  * edx = offset in data of the background image
555
  * edx = offset in data of the background image
556
  * esi = size of data in bytes = 3 * number of pixels
556
  * esi = size of data in bytes = 3 * number of pixels
557
Returned value:
557
Returned value:
558
  * function does not return value
558
  * function does not return value
559
Remarks:
559
Remarks:
560
  * Offset and size are not checked for correctness.
560
  * Offset and size are not checked for correctness.
561
  * Color of each pixel is stored as 3-bytes value BBGGRR.
561
  * Color of each pixel is stored as 3-bytes value BBGGRR.
562
  * Pixels of the background image are written sequentially
562
  * Pixels of the background image are written sequentially
563
    from left to right, from up to down.
563
    from left to right, from up to down.
564
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
564
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
565
  * For update of the screen (after completion of a series of commands
565
  * For update of the screen (after completion of a series of commands
566
    working with a background) call subfunction 3.
566
    working with a background) call subfunction 3.
567
 
567
 
568
======================================================================
568
======================================================================
569
===================== Function 15, subfunction 6 =====================
569
===================== Function 15, subfunction 6 =====================
570
======== Map background data to the address space of process. ========
570
======== Map background data to the address space of process. ========
571
======================================================================
571
======================================================================
572
Parameters:
572
Parameters:
573
  * eax = 15 - function number
573
  * eax = 15 - function number
574
  * ebx = 6 - subfunction number
574
  * ebx = 6 - subfunction number
575
Returned value:
575
Returned value:
576
  * eax = pointer to background data, 0 if error
576
  * eax = pointer to background data, 0 if error
577
Remarks:
577
Remarks:
578
  * Mapped data are available for read and write.
578
  * Mapped data are available for read and write.
579
  * Size of background data is 3*xsize*ysize. The system blocks
579
  * Size of background data is 3*xsize*ysize. The system blocks
580
    changes of background sizes while process works with mapped data.
580
    changes of background sizes while process works with mapped data.
581
  * Color of each pixel is stored as 3-bytes value BBGGRR.
581
  * Color of each pixel is stored as 3-bytes value BBGGRR.
582
  * Pixels of the background image are written sequentially
582
  * Pixels of the background image are written sequentially
583
    from left to right, from up to down.
583
    from left to right, from up to down.
584
 
584
 
585
======================================================================
585
======================================================================
586
===== Function 15, subfunction 7 - close mapped background data. =====
586
===== Function 15, subfunction 7 - close mapped background data. =====
587
======================================================================
587
======================================================================
588
Parameters:
588
Parameters:
589
  * eax = 15 - function number
589
  * eax = 15 - function number
590
  * ebx = 7 - subfunction number
590
  * ebx = 7 - subfunction number
591
  * ecx = pointer to mapped data
591
  * ecx = pointer to mapped data
592
Returned value:
592
Returned value:
593
  * eax = 1 - success, 0 - error
593
  * eax = 1 - success, 0 - error
594
 
594
 
595
======================================================================
595
======================================================================
596
=============== Function 16 - save ramdisk on a floppy. ==============
596
=============== Function 16 - save ramdisk on a floppy. ==============
597
======================================================================
597
======================================================================
598
Parameters:
598
Parameters:
599
  * eax = 16 - function number
599
  * eax = 16 - function number
600
  * ebx = 1 or ebx = 2 - on which floppy save
600
  * ebx = 1 or ebx = 2 - on which floppy save
601
Returned value:
601
Returned value:
602
  * eax = 0 - success
602
  * eax = 0 - success
603
  * eax = 1 - error
603
  * eax = 1 - error
604
 
604
 
605
======================================================================
605
======================================================================
606
======= Function 17 - get the identifier of the pressed button. ======
606
======= Function 17 - get the identifier of the pressed button. ======
607
======================================================================
607
======================================================================
608
Takes away the code of the pressed button from the buffer.
608
Takes away the code of the pressed button from the buffer.
609
Parameters:
609
Parameters:
610
  * eax = 17 - function number
610
  * eax = 17 - function number
611
Returned value:
611
Returned value:
612
  * if the buffer is empty, function returns eax=1
612
  * if the buffer is empty, function returns eax=1
613
  * if the buffer is not empty:
613
  * if the buffer is not empty:
614
    * high 24 bits of eax contain button identifier (in particular,
614
    * high 24 bits of eax contain button identifier (in particular,
615
      ah contains low byte of the identifier; if all buttons have
615
      ah contains low byte of the identifier; if all buttons have
616
      the identifier less than 256, ah is enough to distinguish)
616
      the identifier less than 256, ah is enough to distinguish)
617
    * al = 0 - the button was pressed with left mouse button
617
    * al = 0 - the button was pressed with left mouse button
618
    * al = bit corresponding to used mouse button otherwise
618
    * al = bit corresponding to used mouse button otherwise
619
Remarks:
619
Remarks:
620
  * "Buffer" keeps only one button, at pressing the new button the
620
  * "Buffer" keeps only one button, at pressing the new button the
621
    information about old is lost.
621
    information about old is lost.
622
  * The call of this function by an application with inactive window
622
  * The call of this function by an application with inactive window
623
    will return answer "buffer is empty".
623
    will return answer "buffer is empty".
624
  * Returned value for al corresponds to the state of mouse buttons
624
  * Returned value for al corresponds to the state of mouse buttons
625
    as in subfunction 2 of function 37 at the beginning
625
    as in subfunction 2 of function 37 at the beginning
626
    of button press, excluding lower bit, which is cleared.
626
    of button press, excluding lower bit, which is cleared.
627
 
627
 
628
======================================================================
628
======================================================================
629
= Function 18, subfunction 2 - terminate process/thread by the slot. =
629
= Function 18, subfunction 2 - terminate process/thread by the slot. =
630
======================================================================
630
======================================================================
631
Parameters:
631
Parameters:
632
  * eax = 18 - function number
632
  * eax = 18 - function number
633
  * ebx = 2 - subfunction number
633
  * ebx = 2 - subfunction number
634
  * ecx = number of the slot of process/thread
634
  * ecx = number of the slot of process/thread
635
Returned value:
635
Returned value:
636
  * function does not return value
636
  * function does not return value
637
Remarks:
637
Remarks:
638
  * It is impossible to terminate system thread OS/IDLE (with
638
  * It is impossible to terminate system thread OS/IDLE (with
639
    number of the slot 1),
639
    number of the slot 1),
640
    it is possible to terminate any normal process/thread.
640
    it is possible to terminate any normal process/thread.
641
  * See also subfunction 18 - terminate
641
  * See also subfunction 18 - terminate
642
    process/thread by the identifier.
642
    process/thread by the identifier.
643
 
643
 
644
======================================================================
644
======================================================================
645
===================== Function 18, subfunction 3 =====================
645
===================== Function 18, subfunction 3 =====================
646
============= Make active the window of the given thread. ============
646
============= Make active the window of the given thread. ============
647
======================================================================
647
======================================================================
648
Parameters:
648
Parameters:
649
  * eax = 18 - function number
649
  * eax = 18 - function number
650
  * ebx = 3 - subfunction number
650
  * ebx = 3 - subfunction number
651
  * ecx = number of the thread slot
651
  * ecx = number of the thread slot
652
Returned value:
652
Returned value:
653
  * function does not return value
653
  * function does not return value
654
Remarks:
654
Remarks:
655
  * If correct, but nonexistent slot is given,
655
  * If correct, but nonexistent slot is given,
656
    some window is made active.
656
    some window is made active.
657
  * To find out, which window is active, use subfunction 7.
657
  * To find out, which window is active, use subfunction 7.
658
 
658
 
659
======================================================================
659
======================================================================
660
===================== Function 18, subfunction 4 =====================
660
===================== Function 18, subfunction 4 =====================
661
=========== Get counter of idle time units per one second. ===========
661
=========== Get counter of idle time units per one second. ===========
662
======================================================================
662
======================================================================
663
Idle time units are units, in which the processor stands idle
663
Idle time units are units, in which the processor stands idle
664
in waiting for interrupt (in the command 'hlt').
664
in waiting for interrupt (in the command 'hlt').
665
 
665
 
666
Parameters:
666
Parameters:
667
  * eax = 18 - function number
667
  * eax = 18 - function number
668
  * ebx = 4 - subfunction number
668
  * ebx = 4 - subfunction number
669
Returned value:
669
Returned value:
670
  * eax = value of the counter of idle time units per one second
670
  * eax = value of the counter of idle time units per one second
671
 
671
 
672
======================================================================
672
======================================================================
673
========== Function 18, subfunction 5 - get CPU clock rate. ==========
673
========== Function 18, subfunction 5 - get CPU clock rate. ==========
674
======================================================================
674
======================================================================
675
Parameters:
675
Parameters:
676
  * eax = 18 - function number
676
  * eax = 18 - function number
677
  * ebx = 5 - subfunction number
677
  * ebx = 5 - subfunction number
678
Returned value:
678
Returned value:
679
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
679
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
680
 
680
 
681
======================================================================
681
======================================================================
682
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
682
 Function 18, subfunction 6 - save ramdisk to the file on hard drive. 
683
======================================================================
683
======================================================================
684
Parameters:
684
Parameters:
685
  * eax = 18 - function number
685
  * eax = 18 - function number
686
  * ebx = 6 - subfunction number
686
  * ebx = 6 - subfunction number
687
  * ecx = pointer to the full path to file
687
  * ecx = pointer to the full path to file
688
    (for example, "/hd0/1/kolibri/kolibri.img")
688
    (for example, "/hd0/1/kolibri/kolibri.img")
689
Returned value:
689
Returned value:
690
  * eax = 0 - success
690
  * eax = 0 - success
691
  * else eax = error code of the file system
691
  * else eax = error code of the file system
692
Remarks:
692
Remarks:
693
  * All folders in the given path must exist, otherwise function
693
  * All folders in the given path must exist, otherwise function
694
    returns value 5, "file not found".
694
    returns value 5, "file not found".
695
 
695
 
696
======================================================================
696
======================================================================
697
=========== Function 18, subfunction 7 - get active window. ==========
697
=========== Function 18, subfunction 7 - get active window. ==========
698
======================================================================
698
======================================================================
699
Parameters:
699
Parameters:
700
  * eax = 18 - function number
700
  * eax = 18 - function number
701
  * ebx = 7 - subfunction number
701
  * ebx = 7 - subfunction number
702
Returned value:
702
Returned value:
703
  * eax = number of the active window
703
  * eax = number of the active window
704
    (number of the slot of the thread with active window)
704
    (number of the slot of the thread with active window)
705
Remarks:
705
Remarks:
706
  * Active window is at the top of the window stack and receives
706
  * Active window is at the top of the window stack and receives
707
    messages on all keyboard input.
707
    messages on all keyboard input.
708
  * To make a window active, use subfunction 3.
708
  * To make a window active, use subfunction 3.
709
 
709
 
710
======================================================================
710
======================================================================
711
== Function 18, subfunction 8 - disable/enable the internal speaker. =
711
== Function 18, subfunction 8 - disable/enable the internal speaker. =
712
======================================================================
712
======================================================================
713
If speaker sound is disabled, all calls to subfunction 55 of
713
If speaker sound is disabled, all calls to subfunction 55 of
714
function 55 are ignored. If speaker sound is enabled,
714
function 55 are ignored. If speaker sound is enabled,
715
they are routed on builtin speaker.
715
they are routed on builtin speaker.
716
 
716
 
717
------------------- Subsubfunction 1 - get status. -------------------
717
------------------- Subsubfunction 1 - get status. -------------------
718
Parameters:
718
Parameters:
719
  * eax = 18 - function number
719
  * eax = 18 - function number
720
  * ebx = 8 - subfunction number
720
  * ebx = 8 - subfunction number
721
  * ecx = 1 - number of the subsubfunction
721
  * ecx = 1 - number of the subsubfunction
722
Returned value:
722
Returned value:
723
  * eax = 0 - speaker sound is enabled; 1 - disabled
723
  * eax = 0 - speaker sound is enabled; 1 - disabled
724
 
724
 
725
----------------- Subsubfunction 2 - toggle status. ------------------
725
----------------- Subsubfunction 2 - toggle status. ------------------
726
Toggles states of disable/enable.
726
Toggles states of disable/enable.
727
Parameters:
727
Parameters:
728
  * eax = 18 - function number
728
  * eax = 18 - function number
729
  * ebx = 8 - subfunction number
729
  * ebx = 8 - subfunction number
730
  * ecx = 2 - number of the subsubfunction
730
  * ecx = 2 - number of the subsubfunction
731
Returned value:
731
Returned value:
732
  * function does not return value
732
  * function does not return value
733
 
733
 
734
======================================================================
734
======================================================================
735
== Function 18, subfunction 9 - system shutdown with the parameter. ==
735
== Function 18, subfunction 9 - system shutdown with the parameter. ==
736
======================================================================
736
======================================================================
737
Parameters:
737
Parameters:
738
  * eax = 18 - function number
738
  * eax = 18 - function number
739
  * ebx = 9 - subfunction number
739
  * ebx = 9 - subfunction number
740
  * ecx = parameter:
740
  * ecx = parameter:
741
    * 2 = turn off computer
741
    * 2 = turn off computer
742
    * 3 = reboot computer
742
    * 3 = reboot computer
743
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
743
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
744
Returned value:
744
Returned value:
745
  * at incorrect ecx the registers do not change (i.e. eax=18)
745
  * at incorrect ecx the registers do not change (i.e. eax=18)
746
  * by correct call function always returns eax=0
746
  * by correct call function always returns eax=0
747
    as the tag of success
747
    as the tag of success
748
Remarks:
748
Remarks:
749
  * Do not rely on returned value by incorrect call, it can be
749
  * Do not rely on returned value by incorrect call, it can be
750
    changed in future versions of the kernel.
750
    changed in future versions of the kernel.
751
 
751
 
752
======================================================================
752
======================================================================
753
===== Function 18, subfunction 10 - minimize application window. =====
753
===== Function 18, subfunction 10 - minimize application window. =====
754
======================================================================
754
======================================================================
755
Minimizes the own window.
755
Minimizes the own window.
756
Parameters:
756
Parameters:
757
  * eax = 18 - function number
757
  * eax = 18 - function number
758
  * ebx = 10 - subfunction number
758
  * ebx = 10 - subfunction number
759
Returned value:
759
Returned value:
760
  * function does not return value
760
  * function does not return value
761
Remarks:
761
Remarks:
762
  * The minimized window from the point of view of function 9
762
  * The minimized window from the point of view of function 9
763
    keeps position and sizes.
763
    keeps position and sizes.
764
  * Restoring of an application window occurs at its activation by
764
  * Restoring of an application window occurs at its activation by 
765
    subfunction 3.
765
    subfunction 3.
766
  * Usually there is no necessity to minimize/restire a window
766
  * Usually there is no necessity to minimize/restire a window
767
    obviously: minimization of a window is carried out by the system
767
    obviously: minimization of a window is carried out by the system
768
    at pressing the minimization button (for skinned windows
768
    at pressing the minimization button (for skinned windows
769
    it is defined automatically by function 0,
769
    it is defined automatically by function 0,
770
    for other windows it can be defined manually by function 8),
770
    for other windows it can be defined manually by function 8),
771
    restore of a window is done by the application '@panel'.
771
    restore of a window is done by the application '@panel'.
772
 
772
 
773
======================================================================
773
======================================================================
774
 Function 18, subfunction 11 - get information on the disk subsystem.
774
 Function 18, subfunction 11 - get information on the disk subsystem. 
775
======================================================================
775
======================================================================
776
Parameters:
776
Parameters:
777
  * eax = 18 - function number
777
  * eax = 18 - function number
778
  * ebx = 11 - subfunction number
778
  * ebx = 11 - subfunction number
779
  * ecx = type of the table:
779
  * ecx = type of the table:
780
    * 1 = short version, 10 bytes
780
    * 1 = short version, 10 bytes
781
    * 2 = full version, 65536 bytes
781
    * 2 = full version, 65536 bytes
782
  * edx = pointer to the buffer (in the application) for the table
782
  * edx = pointer to the buffer (in the application) for the table
783
Returned value:
783
Returned value:
784
  * function does not return value
784
  * function does not return value
785
Format of the table: short version:
785
Format of the table: short version:
786
  * +0: byte: information about FDD's (drives for floppies),
786
  * +0: byte: information about FDD's (drives for floppies),
787
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
787
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
788
    of the second regarding to the following list:
788
    of the second regarding to the following list:
789
    * 0 = there is no drive
789
    * 0 = there is no drive
790
    * 1 = 360Kb, 5.25''
790
    * 1 = 360Kb, 5.25''
791
    * 2 = 1.2Mb, 5.25''
791
    * 2 = 1.2Mb, 5.25''
792
    * 3 = 720Kb, 3.5''
792
    * 3 = 720Kb, 3.5''
793
    * 4 = 1.44Mb, 3.5''
793
    * 4 = 1.44Mb, 3.5''
794
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
794
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
795
    For example, for the standard configuration from one 1.44-drive
795
    For example, for the standard configuration from one 1.44-drive
796
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
796
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
797
    the value is 24h.
797
    the value is 24h.
798
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
798
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
799
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
799
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
800
    * 0 = device is absent
800
    * 0 = device is absent
801
    * 1 = hard drive
801
    * 1 = hard drive
802
    * 2 = CD-drive
802
    * 2 = CD-drive
803
    For example, in the case HD on IDE0 and CD on IDE2
803
    For example, in the case HD on IDE0 and CD on IDE2
804
    this field contains 48h.
804
    this field contains 48h.
805
  * +2: 4 db: number of the retrieved partitions on hard disks
805
  * +2: 4 db: number of the retrieved partitions on hard disks
806
    at accordingly IDE0,...,IDE3.
806
    at accordingly IDE0,...,IDE3.
807
    If the hard disk on IDEx is absent, appropriate byte is zero,
807
    If the hard disk on IDEx is absent, appropriate byte is zero,
808
    otherwise it shows number of the recognized partitions, which
808
    otherwise it shows number of the recognized partitions, which
809
    can be not presented (if the drive is not formatted or if
809
    can be not presented (if the drive is not formatted or if
810
    the file system is not supported). Current version of the kernel
810
    the file system is not supported). Current version of the kernel
811
    supports only FAT16, FAT32 and NTFS for hard disks.
811
    supports only FAT16, FAT32 and NTFS for hard disks.
812
  * +6: 4 db: reserved
812
  * +6: 4 db: reserved
813
Format of the table: full version:
813
Format of the table: full version:
814
  * +0: 10 db: same as for the short version
814
  * +0: 10 db: same as for the short version
815
  * +10: 100 db: data for the first partition
815
  * +10: 100 db: data for the first partition
816
  * +110: 100 db: data for the second partition
816
  * +110: 100 db: data for the second partition
817
  * ...
817
  * ...
818
  * +10+100*(n-1): 100 db: data for the last partition
818
  * +10+100*(n-1): 100 db: data for the last partition
819
The partitions are located as follows: at first sequentially all
819
The partitions are located as follows: at first sequentially all
820
recoginzed partitions on HD on IDE0 (if present),
820
recoginzed partitions on HD on IDE0 (if present),
821
then on HD on IDE1 (if present) and so on up to IDE3.
821
then on HD on IDE1 (if present) and so on up to IDE3.
822
Format of the information about partition
822
Format of the information about partition
823
(at moment only FAT is supported):
823
(at moment only FAT is supported):
824
  * +0: dword: first physical sector of the partition
824
  * +0: dword: first physical sector of the partition
825
  * +4: dword: last physical sector of the partition
825
  * +4: dword: last physical sector of the partition
826
    (belongs to the partition)
826
    (belongs to the partition)
827
  * +8: byte: file system type:
827
  * +8: byte: file system type:
828
    16=FAT16, 32=FAT32, 1=NTFS
828
    16=FAT16, 32=FAT32, 1=NTFS
829
  * other data are dependent on file system, are modified with
829
  * other data are dependent on file system, are modified with
830
    kernel modifications and therefore are not described
830
    kernel modifications and therefore are not described
831
Remarks:
831
Remarks:
832
  * The short table can be used for obtaining the information about
832
  * The short table can be used for obtaining the information about
833
    available devices.
833
    available devices.
834
 
834
 
835
======================================================================
835
======================================================================
836
========== Function 18, subfunction 13 - get kernel version. =========
836
========== Function 18, subfunction 13 - get kernel version. =========
837
======================================================================
837
======================================================================
838
Parameters:
838
Parameters:
839
  * eax = 18 - function number
839
  * eax = 18 - function number
840
  * ebx = 13 - subfunction number
840
  * ebx = 13 - subfunction number
841
  * ecx = pointer to the buffer (not less than 16 bytes), where
841
  * ecx = pointer to the buffer (not less than 16 bytes), where
842
    the information will be placed
842
    the information will be placed
843
Returned value:
843
Returned value:
844
  * function does not return value
844
  * function does not return value
845
Structure of the buffer:
845
Structure of the buffer:
846
db a,b,c,d for version a.b.c.d
846
db a,b,c,d for version a.b.c.d
847
db UID_xxx: one of UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
847
db UID_xxx: one of UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
848
dd REV - kernel SVN revision number
848
dd REV - kernel SVN revision number
849
For Kolibri 0.7.1.0 kernel:
849
For Kolibri 0.7.7.0 kernel:
850
db 0,7,0,0
850
db 0,7,7,0
851
db 2
851
db 2
852
dd 638
852
dd 1319
853
 
853
 
854
======================================================================
854
======================================================================
855
======= Function 18, subfunction 14 - wait for screen retrace. =======
855
======= Function 18, subfunction 14 - wait for screen retrace. =======
856
======================================================================
856
======================================================================
857
Waits for the beginning of retrace of the scanning ray of the screen
857
Waits for the beginning of retrace of the scanning ray of the screen
858
monitor.
858
monitor.
859
Parameters:
859
Parameters:
860
  * eax = 18 - function number
860
  * eax = 18 - function number
861
  * ebx = 14 - subfunction number
861
  * ebx = 14 - subfunction number
862
Returned value:
862
Returned value:
863
  * eax = 0 as the tag of success
863
  * eax = 0 as the tag of success
864
Remarks:
864
Remarks:
865
  * Function is intended only for active high-efficiency graphics
865
  * Function is intended only for active high-efficiency graphics
866
    applications; is used for smooth output of a graphics.
866
    applications; is used for smooth output of a graphics.
867
 
867
 
868
======================================================================
868
======================================================================
869
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
869
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
870
======================================================================
870
======================================================================
871
Parameters:
871
Parameters:
872
  * eax = 18 - function number
872
  * eax = 18 - function number
873
  * ebx = 15 - subfunction number
873
  * ebx = 15 - subfunction number
874
Returned value:
874
Returned value:
875
  * eax = 0 as the tag of success
875
  * eax = 0 as the tag of success
876
 
876
 
877
======================================================================
877
======================================================================
878
========= Function 18, subfunction 16 - get size of free RAM. ========
878
========= Function 18, subfunction 16 - get size of free RAM. ========
879
======================================================================
879
======================================================================
880
Parameters:
880
Parameters:
881
  * eax = 18 - function number
881
  * eax = 18 - function number
882
  * ebx = 16 - subfunction number
882
  * ebx = 16 - subfunction number
883
Returned value:
883
Returned value:
884
  * eax = size of free memory in kilobytes
884
  * eax = size of free memory in kilobytes
885
 
885
 
886
======================================================================
886
======================================================================
887
======== Function 18, subfunction 17 - get full amount of RAM. =======
887
======== Function 18, subfunction 17 - get full amount of RAM. =======
888
======================================================================
888
======================================================================
889
Parameters:
889
Parameters:
890
  * eax = 18 - function number
890
  * eax = 18 - function number
891
  * ebx = 17 - subfunction number
891
  * ebx = 17 - subfunction number
892
Returned value:
892
Returned value:
893
  * eax = total size of existing memory in kilobytes
893
  * eax = total size of existing memory in kilobytes
894
 
894
 
895
======================================================================
895
======================================================================
896
===================== Function 18, subfunction 18 ====================
896
===================== Function 18, subfunction 18 ====================
897
============= Terminate process/thread by the identifier. ============
897
============= Terminate process/thread by the identifier. ============
898
======================================================================
898
======================================================================
899
Parameters:
899
Parameters:
900
  * eax = 18 - function number
900
  * eax = 18 - function number
901
  * ebx = 18 - subfunction number
901
  * ebx = 18 - subfunction number
902
  * ecx = identifer of process/thread (PID/TID)
902
  * ecx = identifer of process/thread (PID/TID)
903
Returned value:
903
Returned value:
904
  * eax = 0 - success
904
  * eax = 0 - success
905
  * eax = -1 - error (process is not found or is system)
905
  * eax = -1 - error (process is not found or is system)
906
Remarks:
906
Remarks:
907
  * It is impossible to terminate system thread OS/IDLE (identifier
907
  * It is impossible to terminate system thread OS/IDLE (identifier
908
    1), it is possible to terminate any normal process/thread.
908
    1), it is possible to terminate any normal process/thread.
909
  * See also subfunction 2 - terminate
909
  * See also subfunction 2 - terminate
910
    process/thread by given slot.
910
    process/thread by given slot.
911
 
911
 
912
======================================================================
912
======================================================================
913
======== Function 18, subfunction 19 - get/set mouse features. =======
913
======== Function 18, subfunction 19 - get/set mouse features. =======
914
======================================================================
914
======================================================================
915
 
915
 
916
---------------- Subsubfunction 0 - get mouse speed. -----------------
916
---------------- Subsubfunction 0 - get mouse speed. -----------------
917
Parameters:
917
Parameters:
918
  * eax = 18 - function number
918
  * eax = 18 - function number
919
  * ebx = 19 - subfunction number
919
  * ebx = 19 - subfunction number
920
  * ecx = 0 - subsubfunction number
920
  * ecx = 0 - subsubfunction number
921
Returned value:
921
Returned value:
922
  * eax = current mouse speed
922
  * eax = current mouse speed
923
 
923
 
924
---------------- Subsubfunction 1 - set mouse speed. -----------------
924
---------------- Subsubfunction 1 - set mouse speed. -----------------
925
Parameters:
925
Parameters:
926
  * eax = 18 - function number
926
  * eax = 18 - function number
927
  * ebx = 19 - subfunction number
927
  * ebx = 19 - subfunction number
928
  * ecx = 1 - subsubfunction number
928
  * ecx = 1 - subsubfunction number
929
  * edx = new value for speed
929
  * edx = new value for speed
930
Returned value:
930
Returned value:
931
  * function does not return value
931
  * function does not return value
932
 
932
 
933
---------------- Subsubfunction 2 - get mouse delay. -----------------
933
---------------- Subsubfunction 2 - get mouse delay. -----------------
934
Parameters:
934
Parameters:
935
  * eax = 18 - function number
935
  * eax = 18 - function number
936
  * ebx = 19 - subfunction number
936
  * ebx = 19 - subfunction number
937
  * ecx = 2 - subsubfunction number
937
  * ecx = 2 - subsubfunction number
938
Returned value:
938
Returned value:
939
  * eax = current mouse delay
939
  * eax = current mouse delay
940
 
940
 
941
---------------- Subsubfunction 3 - set mouse delay. -----------------
941
---------------- Subsubfunction 3 - set mouse delay. -----------------
942
Parameters:
942
Parameters:
943
  * eax = 18 - function number
943
  * eax = 18 - function number
944
  * ebx = 19 - subfunction number
944
  * ebx = 19 - subfunction number
945
  * ecx = 3 - subsubfunction number
945
  * ecx = 3 - subsubfunction number
946
  * edx = new value for mouse delay
946
  * edx = new value for mouse delay
947
Returned value:
947
Returned value:
948
  * function does not return value
948
  * function does not return value
949
 
949
 
950
----------- Subsubfunction 4 - set mouse pointer position. -----------
950
----------- Subsubfunction 4 - set mouse pointer position. -----------
951
Parameters:
951
Parameters:
952
  * eax = 18 - function number
952
  * eax = 18 - function number
953
  * ebx = 19 - subfunction number
953
  * ebx = 19 - subfunction number
954
  * ecx = 4 - subsubfunction number
954
  * ecx = 4 - subsubfunction number
955
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
955
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
956
Returned value:
956
Returned value:
957
  * function does not return value
957
  * function does not return value
958
 
958
 
959
-------- Subsubfunction 5 - simulate state of mouse buttons. ---------
959
-------- Subsubfunction 5 - simulate state of mouse buttons. ---------
960
Parameters:
960
Parameters:
961
  * eax = 18 - function number
961
  * eax = 18 - function number
962
  * ebx = 19 - subfunction number
962
  * ebx = 19 - subfunction number
963
  * ecx = 5 - subsubfunction number
963
  * ecx = 5 - subsubfunction number
964
  * edx = information about emulated state of mouse buttons:
964
  * edx = information about emulated state of mouse buttons:
965
    (same as return value in subfunction 2 of function 37)
965
    (same as return value in subfunction 2 of function 37)
966
    * bit 0 is set = left button is pressed
966
    * bit 0 is set = left button is pressed
967
    * bit 1 is set = right button is pressed
967
    * bit 1 is set = right button is pressed
968
    * bit 2 is set = middle button is pressed
968
    * bit 2 is set = middle button is pressed
969
    * bit 3 is set = 4th button is pressed
969
    * bit 3 is set = 4th button is pressed
970
    * bit 4 is set = 5th button is pressed
970
    * bit 4 is set = 5th button is pressed
971
Returned value:
971
Returned value:
972
  * function does not return value
972
  * function does not return value
973
Remarks:
973
Remarks:
974
  * It is recommended to set speed of the mouse (in subsubfunction 1)
974
  * It is recommended to set speed of the mouse (in subsubfunction 1)
975
    from 1 up to 9. The installed value is not inspected by the kernel
975
    from 1 up to 9. The installed value is not inspected by the kernel
976
    code, so set it carefully, at incorrect value the cursor
976
    code, so set it carefully, at incorrect value the cursor
977
    can "freeze". Speed of the mouse can be regulated through the
977
    can "freeze". Speed of the mouse can be regulated through the
978
    application SETUP.
978
    application SETUP.
979
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
979
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
980
    value is not handled by COM mice. At the very large values the
980
    value is not handled by COM mice. At the very large values the
981
    movement of the mouse on 1 pixel is impossible and the cursor will
981
    movement of the mouse on 1 pixel is impossible and the cursor will
982
    jump on the value of installed speed (subsubfunction 1). The
982
    jump on the value of installed speed (subsubfunction 1). The
983
    installed value is not inspected by the kernel code.
983
    installed value is not inspected by the kernel code.
984
    Mouse delay can be regulated through the application SETUP.
984
    Mouse delay can be regulated through the application SETUP.
985
  * The subsubfunction 4 does not check the passed value. Before
985
  * The subsubfunction 4 does not check the passed value. Before
986
    its call find out current screen resolution (with function 14)
986
    its call find out current screen resolution (with function 14)
987
    and check that the value of position is inside the limits of the
987
    and check that the value of position is inside the limits of the
988
    screen.
988
    screen.
989
 
989
 
990
======================================================================
990
======================================================================
991
======== Function 18, subfunction 20 - get information on RAM. =======
991
======== Function 18, subfunction 20 - get information on RAM. =======
992
======================================================================
992
======================================================================
993
Parameters:
993
Parameters:
994
  * eax = 18 - function number
994
  * eax = 18 - function number
995
  * ebx = 20 - subfunction number
995
  * ebx = 20 - subfunction number
996
  * ecx = pointer to the buffer for information (36 bytes)
996
  * ecx = pointer to the buffer for information (36 bytes)
997
Returned value:
997
Returned value:
998
  * eax = total size of existing RAM in pages
998
  * eax = total size of existing RAM in pages
999
    or -1 if error has occured
999
    or -1 if error has occured
1000
  * buffer pointed to by ecx contains the following information:
1000
  * buffer pointed to by ecx contains the following information:
1001
    * +0:  dword: total size of existing RAM in pages
1001
    * +0:  dword: total size of existing RAM in pages
1002
    * +4:  dword: size of free RAM in pages
1002
    * +4:  dword: size of free RAM in pages
1003
    * +8:  dword: number of page faults (exceptions #PF)
1003
    * +8:  dword: number of page faults (exceptions #PF)
1004
                 in applications
1004
                 in applications
1005
    * +12: dword: size of kernel heap in bytes
1005
    * +12: dword: size of kernel heap in bytes
1006
    * +16: dword: free in kernel heap in bytes
1006
    * +16: dword: free in kernel heap in bytes
1007
    * +20: dword: total number of memory blocks in kernel heap
1007
    * +20: dword: total number of memory blocks in kernel heap
1008
    * +24: dword: number of free memory blocks in kernel heap
1008
    * +24: dword: number of free memory blocks in kernel heap
1009
    * +28: dword: size of maximum free block in kernel heap
1009
    * +28: dword: size of maximum free block in kernel heap
1010
                 (reserved)
1010
                 (reserved)
1011
    * +32: dword: size of maximum allocated block in kernel heap
1011
    * +32: dword: size of maximum allocated block in kernel heap
1012
                 (reserved)
1012
                 (reserved)
1013
 
1013
 
1014
======================================================================
1014
======================================================================
1015
===================== Function 18, subfunction 21 ====================
1015
===================== Function 18, subfunction 21 ====================
1016
======== Get slot number of process/thread by the identifier. ========
1016
======== Get slot number of process/thread by the identifier. ========
1017
======================================================================
1017
======================================================================
1018
Parameters:
1018
Parameters:
1019
  * eax = 18 - function number
1019
  * eax = 18 - function number
1020
  * ebx = 21 - subfunction number
1020
  * ebx = 21 - subfunction number
1021
  * ecx = identifer of process/thread (PID/TID)
1021
  * ecx = identifer of process/thread (PID/TID)
1022
Returned value:
1022
Returned value:
1023
  * eax = 0 - error (invalid identifier)
1023
  * eax = 0 - error (invalid identifier)
1024
  * otherwise eax = slot number
1024
  * otherwise eax = slot number
1025
 
1025
 
1026
======================================================================
1026
======================================================================
1027
===================== Function 18, subfunction 22 ====================
1027
===================== Function 18, subfunction 22 ====================
1028
============== Operations with window of another thread. =============
1028
============== Operations with window of another thread. =============
1029
======================================================================
1029
======================================================================
1030
Parameters:
1030
Parameters:
1031
  * eax = 18 - function number
1031
  * eax = 18 - function number
1032
  * ebx = 22 - subfunction number
1032
  * ebx = 22 - subfunction number
1033
  * ecx = operation type:
1033
  * ecx = operation type:
1034
    * 0 = minimize window of the thread with given slot number
1034
    * 0 = minimize window of the thread with given slot number
1035
    * 1 = minimize window of the thread with given identifier
1035
    * 1 = minimize window of the thread with given identifier
1036
    * 2 = restore window of the thread with given slot number
1036
    * 2 = restore window of the thread with given slot number
1037
    * 3 = restore window of the thread with given identifier
1037
    * 3 = restore window of the thread with given identifier
1038
  * edx = parameter (slot number or PID/TID)
1038
  * edx = parameter (slot number or PID/TID)
1039
Returned value:
1039
Returned value:
1040
  * eax = 0 - success
1040
  * eax = 0 - success
1041
  * eax = -1 - error (invalid identifier)
1041
  * eax = -1 - error (invalid identifier)
1042
Remarks:
1042
Remarks:
1043
  * The thread can minimize its window with subfunction 10.
1043
  * The thread can minimize its window with subfunction 10.
1044
  * One can restore and activate window simultaneously with
1044
  * One can restore and activate window simultaneously with
1045
    subfunction 3 (which requires slot number).
1045
    subfunction 3 (which requires slot number).
1046
 
1046
 
1047
======================================================================
1047
======================================================================
1048
==================== Function 20 - MIDI interface. ===================
1048
==================== Function 20 - MIDI interface. ===================
1049
======================================================================
1049
======================================================================
1050
 
1050
 
1051
----------------------- Subfunction 1 - reset ------------------------
1051
----------------------- Subfunction 1 - reset ------------------------
1052
Parameters:
1052
Parameters:
1053
  * eax = 20 - function number
1053
  * eax = 20 - function number
1054
  * ebx = 1 - subfunction number
1054
  * ebx = 1 - subfunction number
1055
 
1055
 
1056
-------------------- Subfunction 2 - output byte ---------------------
1056
-------------------- Subfunction 2 - output byte ---------------------
1057
Parameters:
1057
Parameters:
1058
  * eax = 20 - function number
1058
  * eax = 20 - function number
1059
  * ebx = 2 - subfunction number
1059
  * ebx = 2 - subfunction number
1060
  * cl = byte for output
1060
  * cl = byte for output
1061
Returned value (is the same for both subfunctions):
1061
Returned value (is the same for both subfunctions):
1062
  * eax = 0 - success
1062
  * eax = 0 - success
1063
  * eax = 1 - base port is not defined
1063
  * eax = 1 - base port is not defined
1064
Remarks:
1064
Remarks:
1065
  * Previously the base port must be defined by
1065
  * Previously the base port must be defined by 
1066
    subfunction 1 of function 21.
1066
    subfunction 1 of function 21.
1067
 
1067
 
1068
======================================================================
1068
======================================================================
1069
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
1069
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
1070
======================================================================
1070
======================================================================
1071
Parameters:
1071
Parameters:
1072
  * eax = 21 - function number
1072
  * eax = 21 - function number
1073
  * ebx = 1 - subfunction number
1073
  * ebx = 1 - subfunction number
1074
  * ecx = number of base port
1074
  * ecx = number of base port
1075
Returned value
1075
Returned value
1076
  * eax = 0 - success
1076
  * eax = 0 - success
1077
  * eax = -1 - erratic number of a port
1077
  * eax = -1 - erratic number of a port
1078
Remarks:
1078
Remarks:
1079
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
1079
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
1080
  * The installation of base is necessary for function 20.
1080
  * The installation of base is necessary for function 20.
1081
  * To get base port use subfunction 1 of function 26.
1081
  * To get base port use subfunction 1 of function 26.
1082
 
1082
 
1083
======================================================================
1083
======================================================================
1084
========== Function 21, subfunction 2 - set keyboard layout. =========
1084
========== Function 21, subfunction 2 - set keyboard layout. =========
1085
======================================================================
1085
======================================================================
1086
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
1086
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
1087
which will be read by function 2.
1087
which will be read by function 2.
1088
Parameters:
1088
Parameters:
1089
  * eax = 21 - function number
1089
  * eax = 21 - function number
1090
  * ebx = 2 - subfunction number
1090
  * ebx = 2 - subfunction number
1091
  * ecx = which layout to set:
1091
  * ecx = which layout to set:
1092
    * 1 = normal layout
1092
    * 1 = normal layout
1093
    * 2 = layout at pressed Shift
1093
    * 2 = layout at pressed Shift
1094
    * 3 = layout at pressed Alt
1094
    * 3 = layout at pressed Alt
1095
  * edx = pointer to layout - table of length 128 bytes
1095
  * edx = pointer to layout - table of length 128 bytes
1096
Or:
1096
Or:
1097
  * ecx = 9
1097
  * ecx = 9
1098
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1098
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1099
Returned value:
1099
Returned value:
1100
  * eax = 0 - success
1100
  * eax = 0 - success
1101
  * eax = 1 - incorrect parameter
1101
  * eax = 1 - incorrect parameter
1102
Remarks:
1102
Remarks:
1103
  * If Alt is pressed, the layout with Alt is used;
1103
  * If Alt is pressed, the layout with Alt is used;
1104
    if Alt is not pressed, but Shift is pressed,
1104
    if Alt is not pressed, but Shift is pressed,
1105
    the layout with Shift is used;
1105
    the layout with Shift is used;
1106
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1106
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1107
    layout is used and then from the code is subtracted 0x60;
1107
    layout is used and then from the code is subtracted 0x60;
1108
    if no control key is pressed, the normal layout is used.
1108
    if no control key is pressed, the normal layout is used.
1109
  * To get layout and country identifier use
1109
  * To get layout and country identifier use 
1110
    subfunction 2 of function 26.
1110
    subfunction 2 of function 26.
1111
  * Country identifier is global system variable, which is not used
1111
  * Country identifier is global system variable, which is not used
1112
    by the kernel itself; however the application '@panel' displays
1112
    by the kernel itself; however the application '@panel' displays
1113
    the corresponding icon.
1113
    the corresponding icon.
1114
  * The application @panel switches layouts on user request.
1114
  * The application @panel switches layouts on user request.
1115
 
1115
 
1116
======================================================================
1116
======================================================================
1117
============== Function 21, subfunction 3 - set CD base. =============
1117
============== Function 21, subfunction 3 - set CD base. =============
1118
======================================================================
1118
======================================================================
1119
Parameters:
1119
Parameters:
1120
  * eax = 21 - function number
1120
  * eax = 21 - function number
1121
  * ebx = 3 - subfunction number
1121
  * ebx = 3 - subfunction number
1122
  * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1122
  * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1123
Returned value:
1123
Returned value:
1124
  * eax = 0
1124
  * eax = 0
1125
Remarks:
1125
Remarks:
1126
  * CD base is used by function 24.
1126
  * CD base is used by function 24.
1127
  * To get CD base use subfunction 3 of function 26.
1127
  * To get CD base use subfunction 3 of function 26.
1128
 
1128
 
1129
======================================================================
1129
======================================================================
1130
========== Function 21, subfunction 5 - set system language. =========
1130
========== Function 21, subfunction 5 - set system language. =========
1131
======================================================================
1131
======================================================================
1132
Parameters:
1132
Parameters:
1133
  * eax = 21 - function number
1133
  * eax = 21 - function number
1134
  * ebx = 5 - subfunction number
1134
  * ebx = 5 - subfunction number
1135
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
1135
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
1136
Returned value:
1136
Returned value:
1137
  * eax = 0
1137
  * eax = 0
1138
Remarks:
1138
Remarks:
1139
  * System language is global system variable and is not used
1139
  * System language is global system variable and is not used
1140
    by the kernel itself, however application @panel draws the
1140
    by the kernel itself, however application @panel draws the
1141
    appropriate icon.
1141
    appropriate icon.
1142
  * Function does not check for correctness, as the kernel does not
1142
  * Function does not check for correctness, as the kernel does not
1143
    use this variable.
1143
    use this variable.
1144
  * To get system language use subfunction 5 of function 26.
1144
  * To get system language use subfunction 5 of function 26.
1145
 
1145
 
1146
======================================================================
1146
======================================================================
1147
============== Function 21, subfunction 7 - set HD base. =============
1147
============== Function 21, subfunction 7 - set HD base. =============
1148
======================================================================
1148
======================================================================
1149
The HD base defines hard disk to write with usage of obsolete
1149
The HD base defines hard disk to write with usage of obsolete
1150
syntax /HD in obsolete function 58; at usage of modern syntax
1150
syntax /HD in obsolete function 58; at usage of modern syntax
1151
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1151
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1152
Parameters:
1152
Parameters:
1153
  * eax = 21 - function number
1153
  * eax = 21 - function number
1154
  * ebx = 7 - subfunction number
1154
  * ebx = 7 - subfunction number
1155
  * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1155
  * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1156
Returned value:
1156
Returned value:
1157
  * eax = 0
1157
  * eax = 0
1158
Remarks:
1158
Remarks:
1159
  * Any application at any time can change the base.
1159
  * Any application at any time can change the base.
1160
  * Do not change base, when any application works with hard disk.
1160
  * Do not change base, when any application works with hard disk.
1161
    If you do not want system bugs.
1161
    If you do not want system bugs.
1162
  * To get HD base use subfunction 7 of function 26.
1162
  * To get HD base use subfunction 7 of function 26.
1163
  * It is also necessary to define used partition of hard disk by
1163
  * It is also necessary to define used partition of hard disk by 
1164
    subfunction 8.
1164
    subfunction 8.
1165
 
1165
 
1166
======================================================================
1166
======================================================================
1167
========= Function 21, subfunction 8 - set used HD partition. ========
1167
========= Function 21, subfunction 8 - set used HD partition. ========
1168
======================================================================
1168
======================================================================
1169
The HD partition defines partition of the hard disk to write with
1169
The HD partition defines partition of the hard disk to write with
1170
usage of obsolete syntax /HD and obsolete function 58;
1170
usage of obsolete syntax /HD and obsolete function 58;
1171
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1171
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1172
base and partition are set automatically.
1172
base and partition are set automatically.
1173
Parameters:
1173
Parameters:
1174
  * eax = 21 - function number
1174
  * eax = 21 - function number
1175
  * ebx = 8 - subfunction number
1175
  * ebx = 8 - subfunction number
1176
  * ecx = HD partition (beginning from 1)
1176
  * ecx = HD partition (beginning from 1)
1177
Return value:
1177
Return value:
1178
  * eax = 0
1178
  * eax = 0
1179
Remarks:
1179
Remarks:
1180
  * Any application at any time can change partition.
1180
  * Any application at any time can change partition.
1181
  * Do not change partition when any application works with hard disk.
1181
  * Do not change partition when any application works with hard disk.
1182
    If you do not want system bugs.
1182
    If you do not want system bugs.
1183
  * To get used partition use subfunction 8 of function 26.
1183
  * To get used partition use subfunction 8 of function 26.
1184
  * There is no correctness checks.
1184
  * There is no correctness checks.
1185
  * To get the number of partitions of a hard disk use
1185
  * To get the number of partitions of a hard disk use 
1186
    subfunction 11 of function 18.
1186
    subfunction 11 of function 18.
1187
  * It is also necessary to define used HD base by subfunction 7.
1187
  * It is also necessary to define used HD base by subfunction 7.
1188
 
1188
 
1189
======================================================================
1189
======================================================================
1190
 Function 21, subfunction 11 - enable/disable low-level access to HD.
1190
 Function 21, subfunction 11 - enable/disable low-level access to HD. 
1191
======================================================================
1191
======================================================================
1192
Parameters:
1192
Parameters:
1193
  * eax = 21 - function number
1193
  * eax = 21 - function number
1194
  * ebx = 11 - subfunction number
1194
  * ebx = 11 - subfunction number
1195
  * ecx = 0/1 - disable/enable
1195
  * ecx = 0/1 - disable/enable
1196
Returned value:
1196
Returned value:
1197
  * eax = 0
1197
  * eax = 0
1198
Remarks:
1198
Remarks:
1199
  * Is used in LBA-read (subfunction 8 of function 58).
1199
  * Is used in LBA-read (subfunction 8 of function 58).
1200
  * The current implementation uses only low bit of ecx.
1200
  * The current implementation uses only low bit of ecx.
1201
  * To get current status use subfunction 11 of function 26.
1201
  * To get current status use subfunction 11 of function 26.
1202
 
1202
 
1203
======================================================================
1203
======================================================================
1204
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
1204
 Function 21, subfunction 12 - enable/disable low-level access to PCI. 
1205
======================================================================
1205
======================================================================
1206
Parameters:
1206
Parameters:
1207
  * eax = 21 - function number
1207
  * eax = 21 - function number
1208
  * ebx = 12 - subfunction number
1208
  * ebx = 12 - subfunction number
1209
  * ecx = 0/1 - disable/enable
1209
  * ecx = 0/1 - disable/enable
1210
Returned value:
1210
Returned value:
1211
  * eax = 0
1211
  * eax = 0
1212
Remarks:
1212
Remarks:
1213
  * Is used in operations with PCI bus (function 62).
1213
  * Is used in operations with PCI bus (function 62).
1214
  * The current implementation uses only low bit of ecx.
1214
  * The current implementation uses only low bit of ecx.
1215
  * To get current status use subfunction 12 of function 26.
1215
  * To get current status use subfunction 12 of function 26.
1216
 
1216
 
1217
======================================================================
1217
======================================================================
1218
============ Function 21, subfunction 13, subsubfunction 1 ===========
1218
============ Function 21, subfunction 13, subsubfunction 1 ===========
1219
======== Initialize + get information on the driver vmode.mdr. =======
1219
======== Initialize + get information on the driver vmode.mdr. =======
1220
======================================================================
1220
======================================================================
1221
Parameters:
1221
Parameters:
1222
  * eax = 21 - function number
1222
  * eax = 21 - function number
1223
  * ebx = 13 - subfunction number
1223
  * ebx = 13 - subfunction number
1224
  * ecx = 1 - number of the driver function
1224
  * ecx = 1 - number of the driver function
1225
  * edx = pointer to 512-bytes buffer
1225
  * edx = pointer to 512-bytes buffer
1226
Returned value:
1226
Returned value:
1227
  * if driver is not loaded
1227
  * if driver is not loaded
1228
    (never happens in the current implementation):
1228
    (never happens in the current implementation):
1229
    * eax = -1
1229
    * eax = -1
1230
    * ebx, ecx destroyed
1230
    * ebx, ecx destroyed
1231
  * if driver is loaded:
1231
  * if driver is loaded:
1232
    * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high)
1232
    * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high)
1233
      - signature
1233
      - signature
1234
    * ebx = current frequency of the scanning (in Hz)
1234
    * ebx = current frequency of the scanning (in Hz)
1235
    * ecx destroyed
1235
    * ecx destroyed
1236
    * buffer pointed to by edx is filled
1236
    * buffer pointed to by edx is filled
1237
Format of the buffer:
1237
Format of the buffer:
1238
  * +0: 32*byte: driver name, "Trans VideoDriver"
1238
  * +0: 32*byte: driver name, "Trans VideoDriver"
1239
    (without quotes, supplemented by spaces)
1239
    (without quotes, supplemented by spaces)
1240
  * +32 = +0x20: dword: driver version (version x.y is encoded as
1240
  * +32 = +0x20: dword: driver version (version x.y is encoded as
1241
    y*65536+x), for the current implementation is 1 (1.0)
1241
    y*65536+x), for the current implementation is 1 (1.0)
1242
  * +36 = +0x24: 7*dword: reserved (0 in the current implementation)
1242
  * +36 = +0x24: 7*dword: reserved (0 in the current implementation)
1243
  * +64 = +0x40: 32*word: list of supported videomodes (each word
1243
  * +64 = +0x40: 32*word: list of supported videomodes (each word
1244
    is number of a videomode, after list itself there are zeroes)
1244
    is number of a videomode, after list itself there are zeroes)
1245
  * +128 = +0x80: 32*(5*word): list of supported frequences of the
1245
  * +128 = +0x80: 32*(5*word): list of supported frequences of the
1246
    scannings for videomodes: for each videomode listed in the
1246
    scannings for videomodes: for each videomode listed in the
1247
    previous field up to 5 supported frequences are given
1247
    previous field up to 5 supported frequences are given
1248
    (unused positions contain zeroes)
1248
    (unused positions contain zeroes)
1249
Remarks:
1249
Remarks:
1250
  * Function initializes the driver (if it is not initialized yet)
1250
  * Function initializes the driver (if it is not initialized yet)
1251
    and must be called first, before others (otherwise they will do
1251
    and must be called first, before others (otherwise they will do
1252
    nothing and return -1).
1252
    nothing and return -1).
1253
  * The current implementation supports only one frequency
1253
  * The current implementation supports only one frequency
1254
    of the scanning on videomode.
1254
    of the scanning on videomode.
1255
 
1255
 
1256
======================================================================
1256
======================================================================
1257
============ Function 21, subfunction 13, subsubfunction 2 ===========
1257
============ Function 21, subfunction 13, subsubfunction 2 ===========
1258
================ Get information on current videomode. ===============
1258
================ Get information on current videomode. ===============
1259
======================================================================
1259
======================================================================
1260
Parameters:
1260
Parameters:
1261
  * eax = 21 - function number
1261
  * eax = 21 - function number
1262
  * ebx = 13 - subfunction number
1262
  * ebx = 13 - subfunction number
1263
  * ecx = 2 - number of the driver function
1263
  * ecx = 2 - number of the driver function
1264
Returned value:
1264
Returned value:
1265
  * eax = -1 - driver is not loaded or not initialized;
1265
  * eax = -1 - driver is not loaded or not initialized;
1266
    ebx,ecx are destroyed
1266
    ebx,ecx are destroyed
1267
  * eax = [width]*65536 + [height]
1267
  * eax = [width]*65536 + [height]
1268
  * ebx = frequency of the vertical scanning (in Hz)
1268
  * ebx = frequency of the vertical scanning (in Hz)
1269
  * ecx = number of current videomode
1269
  * ecx = number of current videomode
1270
Remarks:
1270
Remarks:
1271
  * Driver must be initialized by call to
1271
  * Driver must be initialized by call to 
1272
    driver function 1.
1272
    driver function 1.
1273
  * If only screen sizes are required, it is more expedient to use
1273
  * If only screen sizes are required, it is more expedient to use
1274
    function 14 taking into account that it
1274
    function 14 taking into account that it
1275
    returns sizes on 1 less.
1275
    returns sizes on 1 less.
1276
 
1276
 
1277
======================================================================
1277
======================================================================
1278
=== Function 21, subfunction 13, subsubfunction 3 - set videomode. ===
1278
=== Function 21, subfunction 13, subsubfunction 3 - set videomode. ===
1279
======================================================================
1279
======================================================================
1280
Parameters:
1280
Parameters:
1281
  * eax = 21 - function number
1281
  * eax = 21 - function number
1282
  * ebx = 13 - subfunction number
1282
  * ebx = 13 - subfunction number
1283
  * ecx = 3 - number of the driver function
1283
  * ecx = 3 - number of the driver function
1284
  * edx = [scanning frequency]*65536 + [videomode number]
1284
  * edx = [scanning frequency]*65536 + [videomode number]
1285
Returned value:
1285
Returned value:
1286
  * eax = -1 - driver is not loaded, not initialized or
1286
  * eax = -1 - driver is not loaded, not initialized or
1287
    an error has occured
1287
    an error has occured
1288
  * eax = 0 - success
1288
  * eax = 0 - success
1289
  * ebx, ecx destroyed
1289
  * ebx, ecx destroyed
1290
Remarks:
1290
Remarks:
1291
  * Driver must be initialized by driver function 1.
1291
  * Driver must be initialized by driver function 1.
1292
  * The videomode number and frequency must be in the table
1292
  * The videomode number and frequency must be in the table
1293
    returned by driver function 1.
1293
    returned by driver function 1.
1294
 
1294
 
1295
======================================================================
1295
======================================================================
1296
============ Function 21, subfunction 13, subsubfunction 4 ===========
1296
============ Function 21, subfunction 13, subsubfunction 4 ===========
1297
================== Return to the initial videomode. ==================
1297
================== Return to the initial videomode. ==================
1298
======================================================================
1298
======================================================================
1299
Returns the screen to the videomode set at system boot.
1299
Returns the screen to the videomode set at system boot.
1300
Parameters:
1300
Parameters:
1301
  * eax = 21 - function number
1301
  * eax = 21 - function number
1302
  * ebx = 13 - subfunction number
1302
  * ebx = 13 - subfunction number
1303
  * ecx = 4 - number of the driver function
1303
  * ecx = 4 - number of the driver function
1304
Returned value:
1304
Returned value:
1305
  * eax = -1 - driver is not loaded or not initialized
1305
  * eax = -1 - driver is not loaded or not initialized
1306
  * eax = 0 - success
1306
  * eax = 0 - success
1307
  * ebx, ecx destroyed
1307
  * ebx, ecx destroyed
1308
Remarks:
1308
Remarks:
1309
  * Driver must be initialized by call to driver function 1.
1309
  * Driver must be initialized by call to driver function 1.
1310
 
1310
 
1311
======================================================================
1311
======================================================================
1312
============ Function 21, subfunction 13, subsubfunction 5 ===========
1312
============ Function 21, subfunction 13, subsubfunction 5 ===========
1313
===== Increase/decrease the size of the visible area of monitor. =====
1313
===== Increase/decrease the size of the visible area of monitor. =====
1314
======================================================================
1314
======================================================================
1315
Parameters:
1315
Parameters:
1316
  * eax = 21 - function number
1316
  * eax = 21 - function number
1317
  * ebx = 13 - subfunction number
1317
  * ebx = 13 - subfunction number
1318
  * ecx = 5 - number of the driver function
1318
  * ecx = 5 - number of the driver function
1319
  * edx = 0/1 - decrease/increase horizontal size on 1 position
1319
  * edx = 0/1 - decrease/increase horizontal size on 1 position
1320
  * edx = 2/3 - is not supported in the current implementation;
1320
  * edx = 2/3 - is not supported in the current implementation;
1321
    is planned as decrease/increase vertical size on 1 position
1321
    is planned as decrease/increase vertical size on 1 position
1322
Returned value:
1322
Returned value:
1323
  * eax = -1 - driver is not loaded or not initialized
1323
  * eax = -1 - driver is not loaded or not initialized
1324
  * eax = 0 - success
1324
  * eax = 0 - success
1325
  * ebx, ecx destroyed
1325
  * ebx, ecx destroyed
1326
Remarks:
1326
Remarks:
1327
  * Driver must be initialized by call to driver function 1.
1327
  * Driver must be initialized by call to driver function 1.
1328
  * Function influences only the physical size of the screen image;
1328
  * Function influences only the physical size of the screen image;
1329
    the logical size (number of pixels) does not change.
1329
    the logical size (number of pixels) does not change.
1330
 
1330
 
1331
======================================================================
1331
======================================================================
1332
================= Function 22 - set system date/time. ================
1332
================= Function 22 - set system date/time. ================
1333
======================================================================
1333
======================================================================
1334
Parameters:
1334
Parameters:
1335
  * eax = 22 - function number
1335
  * eax = 22 - function number
1336
  * ebx = 0 - set time
1336
  * ebx = 0 - set time
1337
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
1337
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
1338
    * HH=hour 00..23
1338
    * HH=hour 00..23
1339
    * MM=minute 00..59
1339
    * MM=minute 00..59
1340
    * SS=second 00..59
1340
    * SS=second 00..59
1341
  * ebx = 1 - set date
1341
  * ebx = 1 - set date
1342
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
1342
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
1343
    * DD=day 01..31
1343
    * DD=day 01..31
1344
    * MM=month 01..12
1344
    * MM=month 01..12
1345
    * YY=year 00..99
1345
    * YY=year 00..99
1346
  * ebx = 2 - set day of week
1346
  * ebx = 2 - set day of week
1347
    * ecx = 1 for Sunday, ..., 7 for Saturday
1347
    * ecx = 1 for Sunday, ..., 7 for Saturday
1348
  * ebx = 3 - set alarm clock
1348
  * ebx = 3 - set alarm clock
1349
    * ecx = 0x00SSMMHH
1349
    * ecx = 0x00SSMMHH
1350
Returned value:
1350
Returned value:
1351
  * eax = 0 - success
1351
  * eax = 0 - success
1352
  * eax = 1 - incorrect parameter
1352
  * eax = 1 - incorrect parameter
1353
  * eax = 2 - CMOS-battery was unloaded
1353
  * eax = 2 - CMOS-battery was unloaded
1354
Remarks:
1354
Remarks:
1355
  * Value of installation of day of week seems to be doubtful,
1355
  * Value of installation of day of week seems to be doubtful,
1356
    as it a little where is used
1356
    as it a little where is used
1357
    (day of week can be calculated by date).
1357
    (day of week can be calculated by date).
1358
  * Alarm clock can be set on operation in the given time every day.
1358
  * Alarm clock can be set on operation in the given time every day.
1359
    But there is no existing system function to disable it.
1359
    But there is no existing system function to disable it.
1360
  * Operation of alarm clock consists in generation IRQ8.
1360
  * Operation of alarm clock consists in generation IRQ8.
1361
  * Generally CMOS supports for alarm clock set of value 0xFF
1361
  * Generally CMOS supports for alarm clock set of value 0xFF
1362
    as one of parameters and it means that the appropriate parameter
1362
    as one of parameters and it means that the appropriate parameter
1363
    is ignored. But current implementation does not allow this
1363
    is ignored. But current implementation does not allow this
1364
    (will return 1).
1364
    (will return 1).
1365
  * Alarm clock is a global system resource; the set of
1365
  * Alarm clock is a global system resource; the set of
1366
    an alarm clock cancels automatically the previous set.
1366
    an alarm clock cancels automatically the previous set.
1367
    However, at moment no program uses it.
1367
    However, at moment no program uses it.
1368
 
1368
 
1369
======================================================================
1369
======================================================================
1370
============= Function 23 - wait for event with timeout. =============
1370
============= Function 23 - wait for event with timeout. =============
1371
======================================================================
1371
======================================================================
1372
If the message queue is empty, waits for new message in the queue,
1372
If the message queue is empty, waits for new message in the queue,
1373
but no more than given time. Then reads out a message from the queue.
1373
but no more than given time. Then reads out a message from the queue.
1374
 
1374
 
1375
Parameters:
1375
Parameters:
1376
  * eax = 23 - function number
1376
  * eax = 23 - function number
1377
  * ebx = timeout (in 1/100 of second)
1377
  * ebx = timeout (in 1/100 of second)
1378
Returned value:
1378
Returned value:
1379
  * eax = 0 - the message queue is empty
1379
  * eax = 0 - the message queue is empty
1380
  * otherwise eax = event (see the list of events)
1380
  * otherwise eax = event (see the list of events)
1381
Remarks:
1381
Remarks:
1382
  * Only those events are taken into account, which enter into
1382
  * Only those events are taken into account, which enter into
1383
    the mask set by function 40. By default it is
1383
    the mask set by function 40. By default it is
1384
    redraw, key and button events.
1384
    redraw, key and button events.
1385
  * To check for presence of a message in the queue use function 11.
1385
  * To check for presence of a message in the queue use function 11.
1386
    To wait without timeout use function 10.
1386
    To wait without timeout use function 10.
1387
  * Transmission ebx=0 results in immediate returning eax=0.
1387
  * Transmission ebx=0 results in immediate returning eax=0.
1388
  * Current implementation returns immediately with eax=0,
1388
  * Current implementation returns immediately with eax=0,
1389
    if the addition of ebx with the current value of time counter
1389
    if the addition of ebx with the current value of time counter
1390
    makes 32-bit overflow.
1390
    makes 32-bit overflow.
1391
 
1391
 
1392
======================================================================
1392
======================================================================
1393
======== Function 24, subfunction 1 - begin to play CD-audio. ========
1393
======== Function 24, subfunction 1 - begin to play CD-audio. ========
1394
======================================================================
1394
======================================================================
1395
Parameters:
1395
Parameters:
1396
  * eax = 24 - function number
1396
  * eax = 24 - function number
1397
  * ebx = 1 - subfunction number
1397
  * ebx = 1 - subfunction number
1398
  * ecx = 0x00FRSSMM, where
1398
  * ecx = 0x00FRSSMM, where
1399
    * MM = starting minute
1399
    * MM = starting minute
1400
    * SS = starting second
1400
    * SS = starting second
1401
    * FR = starting frame
1401
    * FR = starting frame
1402
Returned value:
1402
Returned value:
1403
  * eax = 0 - success
1403
  * eax = 0 - success
1404
  * eax = 1 - CD base is not defined
1404
  * eax = 1 - CD base is not defined
1405
Remarks:
1405
Remarks:
1406
  * Previously CD base must be defined by the call to
1406
  * Previously CD base must be defined by the call to 
1407
    subfunction 3 of function 21.
1407
    subfunction 3 of function 21.
1408
  * One second includes 75 frames, one minute includes 60 seconds.
1408
  * One second includes 75 frames, one minute includes 60 seconds.
1409
  * The function is asynchronous (returns control, when play begins).
1409
  * The function is asynchronous (returns control, when play begins).
1410
 
1410
 
1411
======================================================================
1411
======================================================================
1412
======= Function 24, subfunction 2 - get information on tracks. ======
1412
======= Function 24, subfunction 2 - get information on tracks. ======
1413
======================================================================
1413
======================================================================
1414
Parameters:
1414
Parameters:
1415
  * eax = 24 - function number
1415
  * eax = 24 - function number
1416
  * ebx = 2 - subfunction number
1416
  * ebx = 2 - subfunction number
1417
  * ecx = pointer to the buffer for the table
1417
  * ecx = pointer to the buffer for the table
1418
    (maximum 8*64h+4 bytes=100 tracks)
1418
    (maximum 8*64h+4 bytes=100 tracks)
1419
Returned value:
1419
Returned value:
1420
  * eax = 0 - success
1420
  * eax = 0 - success
1421
  * eax = 1 - CD base is not defined
1421
  * eax = 1 - CD base is not defined
1422
Remarks:
1422
Remarks:
1423
  * The format of the table with tracks information is the same as
1423
  * The format of the table with tracks information is the same as
1424
    for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h).
1424
    for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h).
1425
    Function returns addresses in MSF.
1425
    Function returns addresses in MSF.
1426
  * Previously CD base port must be set by call to
1426
  * Previously CD base port must be set by call to 
1427
    subfunction 3 of function 21.
1427
    subfunction 3 of function 21.
1428
  * Function returns information only about no more than 100
1428
  * Function returns information only about no more than 100
1429
    first tracks. In most cases it is enough.
1429
    first tracks. In most cases it is enough.
1430
 
1430
 
1431
======================================================================
1431
======================================================================
1432
========== Function 24, subfunction 3 - stop play CD-audio. ==========
1432
========== Function 24, subfunction 3 - stop play CD-audio. ==========
1433
======================================================================
1433
======================================================================
1434
Parameters:
1434
Parameters:
1435
  * eax = 24 - function number
1435
  * eax = 24 - function number
1436
  * ebx = 1 - subfunction number
1436
  * ebx = 1 - subfunction number
1437
Returned value:
1437
Returned value:
1438
  * eax = 0 - success
1438
  * eax = 0 - success
1439
  * eax = 1 - CD base is not defined
1439
  * eax = 1 - CD base is not defined
1440
Remarks:
1440
Remarks:
1441
  * Previously CD base port must be defined by call to
1441
  * Previously CD base port must be defined by call to 
1442
    subfunction 3 of function 21.
1442
    subfunction 3 of function 21.
1443
 
1443
 
1444
======================================================================
1444
======================================================================
1445
======= Function 24, subfunction 4 - eject tray of disk drive. =======
1445
======= Function 24, subfunction 4 - eject tray of disk drive. =======
1446
======================================================================
1446
======================================================================
1447
Parameters:
1447
Parameters:
1448
  * eax = 24 - function number
1448
  * eax = 24 - function number
1449
  * ebx = 4 - subfunction number
1449
  * ebx = 4 - subfunction number
1450
  * ecx = position of CD/DVD-drive
1450
  * ecx = position of CD/DVD-drive
1451
      (from 0=Primary Master to 3=Secondary Slave)
1451
      (from 0=Primary Master to 3=Secondary Slave)
1452
Returned value:
1452
Returned value:
1453
  * function does not return value
1453
  * function does not return value
1454
Remarks:
1454
Remarks:
1455
  * The function is supported only for ATAPI devices (CD and DVD).
1455
  * The function is supported only for ATAPI devices (CD and DVD).
1456
  * When the tray is being ejected,
1456
  * When the tray is being ejected,
1457
    manual control of tray is unlocked.
1457
    manual control of tray is unlocked.
1458
  * When the tray is being ejected, the code clears the cache for
1458
  * When the tray is being ejected, the code clears the cache for
1459
    corresponding device.
1459
    corresponding device.
1460
  * An example of usage of the function is the application CD_tray.
1460
  * An example of usage of the function is the application CD_tray.
1461
 
1461
 
1462
======================================================================
1462
======================================================================
1463
======== Function 24, subfunction 5 - load tray of disk drive. =======
1463
======== Function 24, subfunction 5 - load tray of disk drive. =======
1464
======================================================================
1464
======================================================================
1465
Parameters:
1465
Parameters:
1466
  * eax = 24 - function number
1466
  * eax = 24 - function number
1467
  * ebx = 5 - subfunction number
1467
  * ebx = 5 - subfunction number
1468
  * ecx = position of CD/DVD-drive
1468
  * ecx = position of CD/DVD-drive
1469
      (from 0=Primary Master to 3=Secondary Slave)
1469
      (from 0=Primary Master to 3=Secondary Slave)
1470
Returned value:
1470
Returned value:
1471
  * function does not return value
1471
  * function does not return value
1472
Remarks:
1472
Remarks:
1473
  * The function is supported only for ATAPI devices (CD and DVD).
1473
  * The function is supported only for ATAPI devices (CD and DVD).
1474
  * An example of usage of the function is the application CD_tray.
1474
  * An example of usage of the function is the application CD_tray.
1475
 
1475
 
1476
======================================================================
1476
======================================================================
1477
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
1477
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
1478
======================================================================
1478
======================================================================
1479
Parameters:
1479
Parameters:
1480
  * eax = 26 - function number
1480
  * eax = 26 - function number
1481
  * ebx = 1 - subfunction number
1481
  * ebx = 1 - subfunction number
1482
Returned value:
1482
Returned value:
1483
  * eax = port number
1483
  * eax = port number
1484
Parameters:
1484
Parameters:
1485
  * To set base port use subfunction 1 of function 21.
1485
  * To set base port use subfunction 1 of function 21.
1486
 
1486
 
1487
======================================================================
1487
======================================================================
1488
========== Function 26, subfunction 2 - get keyboard layout. =========
1488
========== Function 26, subfunction 2 - get keyboard layout. =========
1489
======================================================================
1489
======================================================================
1490
The keyboard layout is used to convert keyboard scancodes to
1490
The keyboard layout is used to convert keyboard scancodes to
1491
ASCII-codes for function 2.
1491
ASCII-codes for function 2.
1492
Parameters:
1492
Parameters:
1493
  * eax = 26 - function number
1493
  * eax = 26 - function number
1494
  * ebx = 2 - subfunction number
1494
  * ebx = 2 - subfunction number
1495
  * ecx = what layout to get:
1495
  * ecx = what layout to get:
1496
    * 1 = normal layout
1496
    * 1 = normal layout
1497
    * 2 = layout with pressed Shift
1497
    * 2 = layout with pressed Shift
1498
    * 3 = layout with pressed Alt
1498
    * 3 = layout with pressed Alt
1499
  * edx = pointer to the 128-bytes buffer, where the layout will be
1499
  * edx = pointer to the 128-bytes buffer, where the layout will be
1500
    copied
1500
    copied
1501
Returned value:
1501
Returned value:
1502
  * function does not return value
1502
  * function does not return value
1503
Or:
1503
Or:
1504
  * eax = 26 - function number
1504
  * eax = 26 - function number
1505
  * ebx = 2 - subfunction number
1505
  * ebx = 2 - subfunction number
1506
  * ecx = 9
1506
  * ecx = 9
1507
Returned value:
1507
Returned value:
1508
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1508
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1509
Remarks:
1509
Remarks:
1510
  * If Alt is pressed, the layout with Alt is used;
1510
  * If Alt is pressed, the layout with Alt is used;
1511
    if Alt is not pressed, but Shift is pressed,
1511
    if Alt is not pressed, but Shift is pressed,
1512
    the layout with Shift is used;
1512
    the layout with Shift is used;
1513
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1513
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1514
    layout is used and then from the code is subtracted 0x60;
1514
    layout is used and then from the code is subtracted 0x60;
1515
    if no control key is pressed, the normal layout is used.
1515
    if no control key is pressed, the normal layout is used.
1516
  * To set layout and country identifier use
1516
  * To set layout and country identifier use 
1517
    subfunction 2 of function 21.
1517
    subfunction 2 of function 21.
1518
  * Country identifier is global system variable, which is not used
1518
  * Country identifier is global system variable, which is not used
1519
    by the kernel itself; however the application '@panel' displays
1519
    by the kernel itself; however the application '@panel' displays
1520
    the corresponding icon (using this function).
1520
    the corresponding icon (using this function).
1521
  * The application @panel switches layouts on user request.
1521
  * The application @panel switches layouts on user request.
1522
 
1522
 
1523
======================================================================
1523
======================================================================
1524
============== Function 26, subfunction 3 - get CD base. =============
1524
============== Function 26, subfunction 3 - get CD base. =============
1525
======================================================================
1525
======================================================================
1526
Parameters:
1526
Parameters:
1527
  * eax = 26 - function number
1527
  * eax = 26 - function number
1528
  * ebx = 3 - subfunction number
1528
  * ebx = 3 - subfunction number
1529
Returned value:
1529
Returned value:
1530
  * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1530
  * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1531
Remarks:
1531
Remarks:
1532
  * CD base is used by function 24.
1532
  * CD base is used by function 24.
1533
  * To set CD base use subfunction 3 of function 21.
1533
  * To set CD base use subfunction 3 of function 21.
1534
 
1534
 
1535
======================================================================
1535
======================================================================
1536
========== Function 26, subfunction 5 - get system language. =========
1536
========== Function 26, subfunction 5 - get system language. =========
1537
======================================================================
1537
======================================================================
1538
Parameters:
1538
Parameters:
1539
  * eax = 26 - function number
1539
  * eax = 26 - function number
1540
  * ebx = 5 - subfunction number
1540
  * ebx = 5 - subfunction number
1541
Returned value:
1541
Returned value:
1542
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
1542
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
1543
Remarks:
1543
Remarks:
1544
  * System language is global system variable and is not used
1544
  * System language is global system variable and is not used
1545
    by the kernel itself, however application @panel draws the
1545
    by the kernel itself, however application @panel draws the
1546
    appropriate icon (using this function).
1546
    appropriate icon (using this function).
1547
  * To set system language use subfunction 5 of function 21.
1547
  * To set system language use subfunction 5 of function 21.
1548
 
1548
 
1549
======================================================================
1549
======================================================================
1550
============== Function 26, subfunction 7 - get HD base. =============
1550
============== Function 26, subfunction 7 - get HD base. =============
1551
======================================================================
1551
======================================================================
1552
The HD base defines hard disk to write with usage of obsolete
1552
The HD base defines hard disk to write with usage of obsolete
1553
syntax /HD in obsolete function 58; at usage of modern syntax
1553
syntax /HD in obsolete function 58; at usage of modern syntax
1554
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1554
/HD0,/HD1,/HD2,/HD3 base is set automatically.
1555
Parameters:
1555
Parameters:
1556
  * eax = 26 - function number
1556
  * eax = 26 - function number
1557
  * ebx = 7 - subfunction number
1557
  * ebx = 7 - subfunction number
1558
Returned value:
1558
Returned value:
1559
  * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1559
  * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1560
Remarks:
1560
Remarks:
1561
  * Any application in any time can change HD base.
1561
  * Any application in any time can change HD base.
1562
  * To set base use subfunction 7 of function 21.
1562
  * To set base use subfunction 7 of function 21.
1563
  * To get used partition of hard disk use subfunction 8.
1563
  * To get used partition of hard disk use subfunction 8.
1564
 
1564
 
1565
======================================================================
1565
======================================================================
1566
========= Function 26, subfunction 8 - get used HD partition. ========
1566
========= Function 26, subfunction 8 - get used HD partition. ========
1567
======================================================================
1567
======================================================================
1568
The HD partition defines partition of the hard disk to write with
1568
The HD partition defines partition of the hard disk to write with
1569
usage of obsolete syntax /HD in obsolete function 58;
1569
usage of obsolete syntax /HD in obsolete function 58;
1570
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1570
at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3
1571
base and partition are set automatically.
1571
base and partition are set automatically.
1572
Parameters:
1572
Parameters:
1573
  * eax = 26 - function number
1573
  * eax = 26 - function number
1574
  * ebx = 8 - subfunction number
1574
  * ebx = 8 - subfunction number
1575
Returned value:
1575
Returned value:
1576
  * eax = HD partition (beginning from 1)
1576
  * eax = HD partition (beginning from 1)
1577
Remarks:
1577
Remarks:
1578
  * Any application in any time can change partition.
1578
  * Any application in any time can change partition.
1579
  * To set partition use subfunction 8 of function 21.
1579
  * To set partition use subfunction 8 of function 21.
1580
  * To get number of partitions on a hard disk use
1580
  * To get number of partitions on a hard disk use
1581
    subfunction 11 of function 18.
1581
    subfunction 11 of function 18.
1582
  * To get base of used hard disk, use subfunction 7.
1582
  * To get base of used hard disk, use subfunction 7.
1583
 
1583
 
1584
======================================================================
1584
======================================================================
1585
=== Function 26, subfunction 9 - get the value of the time counter. ==
1585
=== Function 26, subfunction 9 - get the value of the time counter. ==
1586
======================================================================
1586
======================================================================
1587
Parameters:
1587
Parameters:
1588
  * eax = 26 - function number
1588
  * eax = 26 - function number
1589
  * ebx = 9 - subfunction number
1589
  * ebx = 9 - subfunction number
1590
Returned value:
1590
Returned value:
1591
  * eax = number of 1/100s of second, past from the system boot time
1591
  * eax = number of 1/100s of second, past from the system boot time
1592
Remarks:
1592
Remarks:
1593
  * Counter takes modulo 2^32, that correspond to a little more
1593
  * Counter takes modulo 2^32, that correspond to a little more
1594
    than 497 days.
1594
    than 497 days.
1595
  * To get system time use function 3.
1595
  * To get system time use function 3.
1596
 
1596
 
1597
======================================================================
1597
======================================================================
1598
===================== Function 26, subfunction 11 ====================
1598
===================== Function 26, subfunction 11 ====================
1599
========== Find out whether low-level HD access is enabled. ==========
1599
========== Find out whether low-level HD access is enabled. ==========
1600
======================================================================
1600
======================================================================
1601
Parameters:
1601
Parameters:
1602
  * eax = 26 - function number
1602
  * eax = 26 - function number
1603
  * ebx = 11 - subfunction number
1603
  * ebx = 11 - subfunction number
1604
Returned value:
1604
Returned value:
1605
  * eax = 0/1 - disabled/enabled
1605
  * eax = 0/1 - disabled/enabled
1606
Remarks:
1606
Remarks:
1607
  * Is used in LBA read (subfunction 8 of function 58).
1607
  * Is used in LBA read (subfunction 8 of function 58).
1608
  * To set current state use subfunction 11 of function 21.
1608
  * To set current state use subfunction 11 of function 21.
1609
 
1609
 
1610
======================================================================
1610
======================================================================
1611
===================== Function 26, subfunction 12 ====================
1611
===================== Function 26, subfunction 12 ====================
1612
========== Find out whether low-level PCI access is enabled. =========
1612
========== Find out whether low-level PCI access is enabled. =========
1613
======================================================================
1613
======================================================================
1614
Parameters:
1614
Parameters:
1615
  * eax = 26 - function number
1615
  * eax = 26 - function number
1616
  * ebx = 12 - subfunction number
1616
  * ebx = 12 - subfunction number
1617
Returned value:
1617
Returned value:
1618
  * eax = 0/1 - disabled/enabled
1618
  * eax = 0/1 - disabled/enabled
1619
Remarks:
1619
Remarks:
1620
  * Is used by operations with PCI bus (function 62).
1620
  * Is used by operations with PCI bus (function 62).
1621
  * The current implementation uses only low bit of ecx.
1621
  * The current implementation uses only low bit of ecx.
1622
  * To set the current state use subfunction 12 of function 21.
1622
  * To set the current state use subfunction 12 of function 21.
1623
 
1623
 
1624
======================================================================
1624
======================================================================
1625
=================== Function 29 - get system date. ===================
1625
=================== Function 29 - get system date. ===================
1626
======================================================================
1626
======================================================================
1627
Parameters:
1627
Parameters:
1628
  * eax = 29 - function number
1628
  * eax = 29 - function number
1629
Returned value:
1629
Returned value:
1630
  * eax = 0x00DDMMYY, where
1630
  * eax = 0x00DDMMYY, where
1631
    (binary-decimal coding, BCD, is used)
1631
    (binary-decimal coding, BCD, is used)
1632
  * YY = two low digits of year (00..99)
1632
  * YY = two low digits of year (00..99)
1633
  * MM = month (01..12)
1633
  * MM = month (01..12)
1634
  * DD = day (01..31)
1634
  * DD = day (01..31)
1635
Remarks:
1635
Remarks:
1636
  * To set system date use function 22.
1636
  * To set system date use function 22.
1637
 
1637
 
1638
======================================================================
1638
======================================================================
1639
============= Function 30 - work with the current folder. ============
1639
============= Function 30 - work with the current folder. ============
1640
======================================================================
1640
======================================================================
1641
 
1641
 
1642
--------- Subfunction 1 - set current folder for the thread. ---------
1642
--------- Subfunction 1 - set current folder for the thread. ---------
1643
Parameters:
1643
Parameters:
1644
  * eax = 30 - function number
1644
  * eax = 30 - function number
1645
  * ebx = 1 - subfunction number
1645
  * ebx = 1 - subfunction number
1646
  * ecx = pointer to ASCIIZ-string with the path to new current folder
1646
  * ecx = pointer to ASCIIZ-string with the path to new current folder
1647
Returned value:
1647
Returned value:
1648
  * function does not return value
1648
  * function does not return value
1649
 
1649
 
1650
--------- Subfunction 2 - get current folder for the thread. ---------
1650
--------- Subfunction 2 - get current folder for the thread. ---------
1651
Parameters:
1651
Parameters:
1652
  * eax = 30 - function number
1652
  * eax = 30 - function number
1653
  * ebx = 2 - subfunction number
1653
  * ebx = 2 - subfunction number
1654
  * ecx = pointer to buffer
1654
  * ecx = pointer to buffer
1655
  * edx = size of buffer
1655
  * edx = size of buffer
1656
Returned value:
1656
Returned value:
1657
  * eax = size of the current folder's name (including terminating 0)
1657
  * eax = size of the current folder's name (including terminating 0)
1658
Remarks:
1658
Remarks:
1659
  * If the buffer is too small to hold all data, only first (edx-1)
1659
  * If the buffer is too small to hold all data, only first (edx-1)
1660
    bytes are copied and than terminating 0 is inserted.
1660
    bytes are copied and than terminating 0 is inserted.
1661
 
-
 
1662
======================================================================
-
 
1663
=============== Function 32 - delete file from ramdisk. ==============
-
 
1664
======================================================================
-
 
1665
Parameters:
-
 
1666
  * eax = 32 - function number
-
 
1667
  * ebx = pointer to the filename
-
 
1668
Returned value:
-
 
1669
  * eax = 0 - success; otherwise file system error code
-
 
1670
Remarks:
-
 
1671
  * This function is obsolete; function 58 allows to fulfill
-
 
1672
    the same operations with the extended possibilities.
-
 
1673
  * The current implementation returns only values 0(success) and
-
 
1674
    5(file not found).
-
 
1675
  * The filename must be either in the format 8+3 characters
1661
  * By default, current folder for the thread is "/rd/1".
1676
    (first 8 characters - name itself, last 3 - extension,
-
 
1677
    the short names and extensions are supplemented with spaces),
-
 
1678
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
-
 
1679
    (name no more than 8 characters, dot, extension 3 characters
-
 
1680
    supplemented if necessary by spaces).
-
 
1681
    The filename must be written with capital letters. The terminating
-
 
1682
    character with code 0 is not necessary (not ASCIIZ-string).
-
 
1683
  * This function does not support folders on the ramdisk.
1662
  * At process/thread creation the current folder will be inherited 
1684
 
-
 
1685
======================================================================
-
 
1686
================ Function 33 - write file to ramdisk. ================
-
 
1687
======================================================================
-
 
1688
Parameters:
-
 
1689
  * eax = 33 - function number
-
 
1690
  * ebx = pointer to the filename
-
 
1691
  * ecx = pointer to data for writing
-
 
1692
  * edx = number of bytes for writing
-
 
1693
  * should be set esi=0
1663
    from the parent.
1694
Returned value:
-
 
1695
  * eax = 0 - success, otherwise file system error code
-
 
1696
Remarks:
-
 
1697
  * This function is obsolete; function 70 allows to fulfil
-
 
1698
    the same operations with extended possibilities.
-
 
1699
  * If esi contains non-zero value and selected file already exists,
-
 
1700
    one more file with the same name will be created.
-
 
1701
  * Otherwise file will be overwritten.
-
 
1702
  * The filename must be either in the format 8+3 characters
-
 
1703
    (first 8 characters - name itself, last 3 - extension,
-
 
1704
    the short names and extensions are supplemented with spaces),
-
 
1705
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
-
 
1706
    (name no more than 8 characters, dot, extension 3 characters
-
 
1707
    supplemented if necessary by spaces).
-
 
1708
    The filename must be written with capital letters. The terminating
-
 
1709
    character with code 0 is not necessary (not ASCIIZ-string).
-
 
1710
  * This function does not support folders on the ramdisk.
-
 
1711
 
1664
 
1712
======================================================================
1665
======================================================================
1713
======= Function 35 - read the color of a pixel on the screen. =======
1666
======= Function 35 - read the color of a pixel on the screen. =======
1714
======================================================================
1667
======================================================================
1715
Parameters:
1668
Parameters:
1716
  * eax = 35
1669
  * eax = 35
1717
  * ebx = y*xsize+x, where
1670
  * ebx = y*xsize+x, where
1718
  * (x,y) = coordinates of a pixel (beginning from 0)
1671
  * (x,y) = coordinates of a pixel (beginning from 0)
1719
  * xsize = horizontal screen size
1672
  * xsize = horizontal screen size
1720
Returned value:
1673
Returned value:
1721
  * eax = color 0x00RRGGBB
1674
  * eax = color 0x00RRGGBB
1722
Remarks:
1675
Remarks:
1723
  * To get screen sizes use function 14. Pay attention,
1676
  * To get screen sizes use function 14. Pay attention,
1724
    that it subtracts 1 from both sizes.
1677
    that it subtracts 1 from both sizes.
1725
  * There is also direct access (without any system calls)
1678
  * There is also direct access (without any system calls)
1726
    to videomemory through the selector gs. To get parameters of
1679
    to videomemory through the selector gs. To get parameters of
1727
    the current videomode, use function 61.
1680
    the current videomode, use function 61.
1728
 
1681
 
1729
======================================================================
1682
======================================================================
1730
=================== Function 36 - read screen area. ==================
1683
=================== Function 36 - read screen area. ==================
1731
======================================================================
1684
======================================================================
1732
Paramters:
1685
Paramters:
1733
  * eax = 36 - function number
1686
  * eax = 36 - function number
1734
  * ebx = pointer to the previously allocated memory area,
1687
  * ebx = pointer to the previously allocated memory area,
1735
        where will be placed the image in the format BBGGRRBBGGRR...
1688
        where will be placed the image in the format BBGGRRBBGGRR...
1736
  * ecx = [size on axis x]*65536 + [size on axis y]
1689
  * ecx = [size on axis x]*65536 + [size on axis y]
1737
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1690
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1738
Returned value:
1691
Returned value:
1739
  * function does not return value
1692
  * function does not return value
1740
Remarks:
1693
Remarks:
1741
  * Coordinates of the image are coordinates of the upper left corner
1694
  * Coordinates of the image are coordinates of the upper left corner
1742
    of the image relative to the screen.
1695
    of the image relative to the screen.
1743
  * Size of the image in bytes is 3*xsize*ysize.
1696
  * Size of the image in bytes is 3*xsize*ysize.
1744
 
1697
 
1745
======================================================================
1698
======================================================================
1746
=================== Function 37 - work with mouse. ===================
1699
=================== Function 37 - work with mouse. ===================
1747
======================================================================
1700
======================================================================
1748
 
1701
 
1749
---------- Subfunction 0 - screen coordinates of the mouse -----------
1702
---------- Subfunction 0 - screen coordinates of the mouse -----------
1750
Parameters:
1703
Parameters:
1751
  * eax = 37 - function number
1704
  * eax = 37 - function number
1752
  * ebx = 0 - subfunction number
1705
  * ebx = 0 - subfunction number
1753
Returned value:
1706
Returned value:
1754
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1707
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1755
    (beginning from 0)
1708
    (beginning from 0)
1756
 
1709
 
1757
-- Subfunction 1 - coordinates of the mouse relative to the window ---
1710
-- Subfunction 1 - coordinates of the mouse relative to the window ---
1758
Parameters:
1711
Parameters:
1759
  * eax = 37 - function number
1712
  * eax = 37 - function number
1760
  * ebx = 1 - subfunction number
1713
  * ebx = 1 - subfunction number
1761
Returned value:
1714
Returned value:
1762
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1715
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1763
    relative to the application window (beginning from 0)
1716
    relative to the application window (beginning from 0)
1764
Remarks:
1717
Remarks:
1765
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
1718
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
1766
    If y>=ywnd, the low word is non-negative and contains
1719
    If y>=ywnd, the low word is non-negative and contains
1767
    relative y-coordinate, and the high word - relative x-coordinate
1720
    relative y-coordinate, and the high word - relative x-coordinate
1768
    (with correct sign). Otherwise the low word is negative and still
1721
    (with correct sign). Otherwise the low word is negative and still
1769
    contains relative y-coordinate, and to the high word
1722
    contains relative y-coordinate, and to the high word
1770
    1 should be added.
1723
    1 should be added.
1771
 
1724
 
1772
------------ Subfunction 2 - pressed buttons of the mouse ------------
1725
------------ Subfunction 2 - pressed buttons of the mouse ------------
1773
Parameters:
1726
Parameters:
1774
  * eax = 37 - function number
1727
  * eax = 37 - function number
1775
  * ebx = 2 - subfunction number
1728
  * ebx = 2 - subfunction number
1776
Returned value:
1729
Returned value:
1777
  * eax contains information on the pressed mouse buttons:
1730
  * eax contains information on the pressed mouse buttons:
1778
  * bit 0 is set = left button is pressed
1731
  * bit 0 is set = left button is pressed
1779
  * bit 1 is set = right button is pressed
1732
  * bit 1 is set = right button is pressed
1780
  * bit 2 is set = middle button is pressed
1733
  * bit 2 is set = middle button is pressed
1781
  * bit 3 is set = 4th button is pressed
1734
  * bit 3 is set = 4th button is pressed
1782
  * bit 4 is set = 5th button is pressed
1735
  * bit 4 is set = 5th button is pressed
1783
  * other bits are cleared
1736
  * other bits are cleared
1784
 
1737
 
1785
-------------------- Subfunction 4 - load cursor ---------------------
1738
-------------------- Subfunction 4 - load cursor ---------------------
1786
Parameters:
1739
Parameters:
1787
  * eax = 37 - function number
1740
  * eax = 37 - function number
1788
  * ebx = 4 - subfunction number
1741
  * ebx = 4 - subfunction number
1789
  * dx = data source:
1742
  * dx = data source:
1790
  * dx = LOAD_FROM_FILE = 0 - data in a file
1743
  * dx = LOAD_FROM_FILE = 0 - data in a file
1791
    * ecx = pointer to full path to the cursor file
1744
    * ecx = pointer to full path to the cursor file
1792
    * the file must be in the format .cur, which is standard for
1745
    * the file must be in the format .cur, which is standard for
1793
      MS Windows, at that of the size 32*32 pixels
1746
      MS Windows, at that of the size 32*32 pixels
1794
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
1747
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
1795
    * ecx = pointer to data of the cursor file
1748
    * ecx = pointer to data of the cursor file
1796
    * the data format is the same as in the previous case
1749
    * the data format is the same as in the previous case
1797
  * dx = LOAD_INDIRECT = 2 - data in memory
1750
  * dx = LOAD_INDIRECT = 2 - data in memory
1798
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
1751
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
1799
    * edx = 0xXXYY0002, where
1752
    * edx = 0xXXYY0002, where
1800
      * XX = x-coordinate of cursor hotspot
1753
      * XX = x-coordinate of cursor hotspot
1801
      * YY = y-coordinate
1754
      * YY = y-coordinate
1802
      * 0 <= XX, YY <= 31
1755
      * 0 <= XX, YY <= 31
1803
Returned value:
1756
Returned value:
1804
  * eax = 0 - failed
1757
  * eax = 0 - failed
1805
  * otherwise eax = cursor handle
1758
  * otherwise eax = cursor handle
1806
 
1759
 
1807
--------------------- Subfunction 5 - set cursor ---------------------
1760
--------------------- Subfunction 5 - set cursor ---------------------
1808
Sets new cursor for the window of the current thread.
1761
Sets new cursor for the window of the current thread.
1809
Parameters:
1762
Parameters:
1810
  * eax = 37 - function number
1763
  * eax = 37 - function number
1811
  * ebx = 5 - subfunction number
1764
  * ebx = 5 - subfunction number
1812
  * ecx = cursor handle
1765
  * ecx = cursor handle
1813
Returned value:
1766
Returned value:
1814
  * eax = handle of previous cursor
1767
  * eax = handle of previous cursor
1815
Remarks:
1768
Remarks:
1816
  * If the handle is incorrect, the function restores the default
1769
  * If the handle is incorrect, the function restores the default
1817
    cursor (standard arrow). In particular, ecx=0 restores it.
1770
    cursor (standard arrow). In particular, ecx=0 restores it.
1818
 
1771
 
1819
------------------- Subfunction 6 - delete cursor --------------------
1772
------------------- Subfunction 6 - delete cursor --------------------
1820
Parameters:
1773
Parameters:
1821
  * eax = 37 - function number
1774
  * eax = 37 - function number
1822
  * ebx = 6 - subfunction number
1775
  * ebx = 6 - subfunction number
1823
  * ecx = cursor handle
1776
  * ecx = cursor handle
1824
Returned value:
1777
Returned value:
1825
  * eax destroyed
1778
  * eax destroyed
1826
Remarks:
1779
Remarks:
1827
  * The cursor must be loaded previously by the current thread
1780
  * The cursor must be loaded previously by the current thread
1828
    (with the call to subfunction 4). The function does not delete
1781
    (with the call to subfunction 4). The function does not delete
1829
    system cursors and cursors, loaded by another applications.
1782
    system cursors and cursors, loaded by another applications.
1830
  * If the active cursor (set by subfunction 5) is deleted,
1783
  * If the active cursor (set by subfunction 5) is deleted,
1831
    the system restores the default cursor (standard arrow).
1784
    the system restores the default cursor (standard arrow).
1832
 
1785
 
1833
------------------ Subfunction 7 - get scroll data -------------------
1786
------------------ Subfunction 7 - get scroll data -------------------
1834
Parameters:
1787
Parameters:
1835
  * eax = 37 - function number
1788
  * eax = 37 - function number
1836
  * ebx = 7 - subfunction number
1789
  * ebx = 7 - subfunction number
1837
Returned value:
1790
Returned value:
1838
  * eax = [horizontal offset]*65536 + [vertical offset]
1791
  * eax = [horizontal offset]*65536 + [vertical offset]
1839
Remarks:
1792
Remarks:
1840
  * Scroll data is available for active window only.
1793
  * Scroll data is available for active window only.
1841
  * Values are zeroed after reading.
1794
  * Values are zeroed after reading.
1842
  * Values are signed.
1795
  * Values are signed.
1843
 
1796
 
1844
======================================================================
1797
======================================================================
1845
====================== Function 38 - draw line. ======================
1798
====================== Function 38 - draw line. ======================
1846
======================================================================
1799
======================================================================
1847
Parameters:
1800
Parameters:
1848
  * eax = 38 - function number
1801
  * eax = 38 - function number
1849
  * ebx = [start coordinate on axis x]*65536 +
1802
  * ebx = [start coordinate on axis x]*65536 +
1850
              [end coordinate on axis x]
1803
              [end coordinate on axis x]
1851
  * ecx = [start coordinate on axis y]*65536 +
1804
  * ecx = [start coordinate on axis y]*65536 +
1852
              [end coordinate on axis y]
1805
              [end coordinate on axis y]
1853
  * edx = 0x00RRGGBB - color
1806
  * edx = 0x00RRGGBB - color
1854
    edx = 0x01xxxxxx - draw inversed line
1807
    edx = 0x01xxxxxx - draw inversed line
1855
          (low 24 bits are ignored)
1808
          (low 24 bits are ignored)
1856
Returned value:
1809
Returned value:
1857
  * function does not return value
1810
  * function does not return value
1858
Remarks:
1811
Remarks:
1859
  * Coordinates are relative to the window.
1812
  * Coordinates are relative to the window.
1860
  * End point is also drawn.
1813
  * End point is also drawn.
1861
 
1814
 
1862
======================================================================
1815
======================================================================
1863
== Function 39, subfunction 1 - get a size of the background image. ==
1816
== Function 39, subfunction 1 - get a size of the background image. ==
1864
======================================================================
1817
======================================================================
1865
Parameters:
1818
Parameters:
1866
  * eax = 39 - function number
1819
  * eax = 39 - function number
1867
  * ebx = 1 - subfunction number
1820
  * ebx = 1 - subfunction number
1868
Returned value:
1821
Returned value:
1869
  * eax = [width]*65536 + [height]
1822
  * eax = [width]*65536 + [height]
1870
Remarks:
1823
Remarks:
1871
  * There is a pair function to set sizes of background image -
1824
  * There is a pair function to set sizes of background image -
1872
    subfunction 1 of function 15. After which it is necessary,
1825
    subfunction 1 of function 15. After which it is necessary,
1873
    of course, anew to define image.
1826
    of course, anew to define image.
1874
 
1827
 
1875
======================================================================
1828
======================================================================
1876
== Function 39, subfunction 2 - get pixel from the background image. =
1829
== Function 39, subfunction 2 - get pixel from the background image. =
1877
======================================================================
1830
======================================================================
1878
Parameters:
1831
Parameters:
1879
  * eax = 39 - function number
1832
  * eax = 39 - function number
1880
  * ebx = 2 - subfunction number
1833
  * ebx = 2 - subfunction number
1881
  * ecx = offset
1834
  * ecx = offset
1882
Returned value:
1835
Returned value:
1883
  * eax = 0x00RRGGBB - pixel color, if offset is valid
1836
  * eax = 0x00RRGGBB - pixel color, if offset is valid
1884
    (less than 0x160000-16)
1837
    (less than 0x160000-16)
1885
  * eax = 2 otherwise
1838
  * eax = 2 otherwise
1886
Remarks:
1839
Remarks:
1887
  * Do not rely on returned value for invalid offsets, it may be
1840
  * Do not rely on returned value for invalid offsets, it may be
1888
    changed in future kernel versions.
1841
    changed in future kernel versions.
1889
  * Offset for pixel with coordinates (x,y)
1842
  * Offset for pixel with coordinates (x,y)
1890
    is calculated as (x+y*xsize)*3.
1843
    is calculated as (x+y*xsize)*3.
1891
  * There is a pair function to set pixel on the background image -
1844
  * There is a pair function to set pixel on the background image - 
1892
    subfunction 2 of function 15.
1845
    subfunction 2 of function 15.
1893
 
1846
 
1894
======================================================================
1847
======================================================================
1895
== Function 39, subfunction 4 - get drawing mode for the background. =
1848
== Function 39, subfunction 4 - get drawing mode for the background. =
1896
======================================================================
1849
======================================================================
1897
Parameters:
1850
Parameters:
1898
  * eax = 39 - function number
1851
  * eax = 39 - function number
1899
  * ebx = 4 - subfunction number
1852
  * ebx = 4 - subfunction number
1900
Returned value:
1853
Returned value:
1901
  * eax = 1 - tile
1854
  * eax = 1 - tile
1902
  * eax = 2 - stretch
1855
  * eax = 2 - stretch
1903
Remarks:
1856
Remarks:
1904
  * There is a pair function to set drawing mode -
1857
  * There is a pair function to set drawing mode - 
1905
    subfunction 4 of function 15.
1858
    subfunction 4 of function 15.
1906
 
1859
 
1907
======================================================================
1860
======================================================================
1908
=========== Function 40 - set the mask for expected events. ==========
1861
=========== Function 40 - set the mask for expected events. ==========
1909
======================================================================
1862
======================================================================
1910
The mask for expected events affects function working with events
1863
The mask for expected events affects function working with events
1911
10, 11, 23 - they notify only about events allowed by this mask.
1864
10, 11, 23 - they notify only about events allowed by this mask.
1912
Parameters:
1865
Parameters:
1913
  * eax = 40 - function number
1866
  * eax = 40 - function number
1914
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
1867
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
1915
    (set bit permits notice on event)
1868
    (set bit permits notice on event)
1916
Returned value:
1869
Returned value:
1917
  * eax = previous value of mask
1870
  * eax = previous value of mask
1918
Remarks:
1871
Remarks:
1919
  * Default mask (7=111b) enables nofices about redraw,
1872
  * Default mask (7=111b) enables nofices about redraw,
1920
    keys and buttons. This is enough for many applications.
1873
    keys and buttons. This is enough for many applications.
1921
  * Events prohibited in the mask are saved anyway, when come;
1874
  * Events prohibited in the mask are saved anyway, when come;
1922
    they are simply not informed with event functions.
1875
    they are simply not informed with event functions.
1923
  * Event functions take into account the mask on moment of
1876
  * Event functions take into account the mask on moment of
1924
    function call, not on moment of event arrival.
1877
    function call, not on moment of event arrival.
1925
 
1878
 
1926
======================================================================
1879
======================================================================
1927
==================== Function 41 - get IRQ owner. ====================
1880
==================== Function 41 - get IRQ owner. ====================
1928
======================================================================
1881
======================================================================
1929
Parameters:
1882
Parameters:
1930
  * eax = 41 - function number
1883
  * eax = 41 - function number
1931
  * ebx = IRQ number, 0..15
1884
  * ebx = IRQ number, 0..15
1932
Returned value:
1885
Returned value:
1933
  * eax = owner PID
1886
  * eax = owner PID
1934
  * eax = 0, if there is no owner
1887
  * eax = 0, if there is no owner
1935
  * eax = -1 for incorrect ebx
1888
  * eax = -1 for incorrect ebx
1936
 
1889
 
1937
======================================================================
1890
======================================================================
1938
================== Function 42 - work with IRQ data. =================
1891
================== Function 42 - work with IRQ data. =================
1939
======================================================================
1892
======================================================================
1940
When an IRQ occurs, the system reads data from ports indicated
1893
When an IRQ occurs, the system reads data from ports indicated
1941
earlier by function 44 and writes this data to
1894
earlier by function 44 and writes this data to
1942
internal buffer. This function reads out data from that buffer.
1895
internal buffer. This function reads out data from that buffer.
1943
 
1896
 
1944
--------------------- Subfunction 0 - read data ----------------------
1897
--------------------- Subfunction 0 - read data ----------------------
1945
Parameters:
1898
Parameters:
1946
  * eax = 42 - function number
1899
  * eax = 42 - function number
1947
  * bl = IRQ number, 0..15
1900
  * bl = IRQ number, 0..15
1948
  * bh = 0 - subfunction number
1901
  * bh = 0 - subfunction number
1949
  * rest of ebx must be zeroed
1902
  * rest of ebx must be zeroed
1950
  * ecx = pointer to a buffer with size not less than 4000 bytes
1903
  * ecx = pointer to a buffer with size not less than 4000 bytes
1951
Returned value: (use value of eax to distinguish)
1904
Returned value: (use value of eax to distinguish)
1952
  * if the thread is not IRQ owner
1905
  * if the thread is not IRQ owner
1953
    (or IRQ number is incorrect): eax = -1
1906
    (or IRQ number is incorrect): eax = -1
1954
  * if there is no data: eax = 0
1907
  * if there is no data: eax = 0
1955
  * if all is ok:
1908
  * if all is ok:
1956
    eax = size of data read (in bytes)
1909
    eax = size of data read (in bytes)
1957
 
1910
 
1958
------------- Subfunction 1 - get size of data in buffer -------------
1911
------------- Subfunction 1 - get size of data in buffer -------------
1959
Parameters:
1912
Parameters:
1960
  * eax = 42 - function number
1913
  * eax = 42 - function number
1961
  * bl = IRQ number, 0..15
1914
  * bl = IRQ number, 0..15
1962
  * bh = 0 - subfunction number
1915
  * bh = 0 - subfunction number
1963
  * rest of ebx must be zeroed
1916
  * rest of ebx must be zeroed
1964
Returned value:
1917
Returned value:
1965
  * if the thread is not IRQ owner
1918
  * if the thread is not IRQ owner
1966
    (or IRQ number is incorrect): eax = -1
1919
    (or IRQ number is incorrect): eax = -1
1967
  * otherwise eax = size of data in buffer
1920
  * otherwise eax = size of data in buffer
1968
Remarks:
1921
Remarks:
1969
  * Previously the thread must reserve indicated IRQ for itself
1922
  * Previously the thread must reserve indicated IRQ for itself
1970
    by function 45.
1923
    by function 45.
1971
  * The size of data buffer is 4000 bytes, on overflow
1924
  * The size of data buffer is 4000 bytes, on overflow
1972
    "fresh" data cease to be written in the buffer.
1925
    "fresh" data cease to be written in the buffer.
1973
 
1926
 
1974
======================================================================
1927
======================================================================
1975
================ Function 43 - input/output to a port. ===============
1928
================ Function 43 - input/output to a port. ===============
1976
======================================================================
1929
======================================================================
1977
 
1930
 
1978
------------------------ Output data to port -------------------------
1931
------------------------ Output data to port -------------------------
1979
Parameters:
1932
Parameters:
1980
  * eax = 43 - function number
1933
  * eax = 43 - function number
1981
  * bl = byte for output
1934
  * bl = byte for output
1982
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
1935
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
1983
Returned value:
1936
Returned value:
1984
  * eax = 0 - success
1937
  * eax = 0 - success
1985
  * eax = 1 - the thread has not reserved the selected port
1938
  * eax = 1 - the thread has not reserved the selected port
1986
 
1939
 
1987
------------------------ Input data from port ------------------------
1940
------------------------ Input data from port ------------------------
1988
Parameters:
1941
Parameters:
1989
  * eax = 43 - function number
1942
  * eax = 43 - function number
1990
  * ebx is ignored
1943
  * ebx is ignored
1991
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
1944
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
1992
Returned value:
1945
Returned value:
1993
  * eax = 0 - success, thus ebx = entered byte
1946
  * eax = 0 - success, thus ebx = entered byte
1994
  * eax = 1 - the thread has not reserved the selected port
1947
  * eax = 1 - the thread has not reserved the selected port
1995
Remarks:
1948
Remarks:
1996
  * Previously the thread must reserve the selected port
1949
  * Previously the thread must reserve the selected port
1997
    for itself by function 46.
1950
    for itself by function 46.
1998
  * Instead of call to this function it is better to use
1951
  * Instead of call to this function it is better to use
1999
    processor instructions in/out - this is much
1952
    processor instructions in/out - this is much
2000
    faster and a bit shorter and easier.
1953
    faster and a bit shorter and easier.
2001
 
1954
 
2002
======================================================================
1955
======================================================================
2003
=========== Function 44 - define operations at IRQ arrival. ==========
1956
=========== Function 44 - define operations at IRQ arrival. ==========
2004
======================================================================
1957
======================================================================
2005
At IRQ arrival the system can read the data from ports defined
1958
At IRQ arrival the system can read the data from ports defined
2006
by this function and write these data to internal buffer, whence
1959
by this function and write these data to internal buffer, whence
2007
they can be read by ôóíêöèåé 42.
1960
they can be read by ôóíêöèåé 42.
2008
Parameters:
1961
Parameters:
2009
  * eax = 44 - function number
1962
  * eax = 44 - function number
2010
  * ebx = pointer to the array of structures each describing one port:
1963
  * ebx = pointer to the array of structures each describing one port:
2011
    * +0: word: 0 means end of array, otherwise port number
1964
    * +0: word: 0 means end of array, otherwise port number
2012
    * +2: byte: reserved (ignored)
1965
    * +2: byte: reserved (ignored)
2013
    * +3: byte: 1=read byte from this port, 2=read word
1966
    * +3: byte: 1=read byte from this port, 2=read word
2014
  * ecx = IRQ number, 0..15
1967
  * ecx = IRQ number, 0..15
2015
Returned value:
1968
Returned value:
2016
  * eax = 0 - success
1969
  * eax = 0 - success
2017
  * eax = 1 - the thread is not owner of selected IRQ
1970
  * eax = 1 - the thread is not owner of selected IRQ
2018
Remarks:
1971
Remarks:
2019
  * Previously the thread must reserve for itself selected IRQ
1972
  * Previously the thread must reserve for itself selected IRQ
2020
    by function 45.
1973
    by function 45.
2021
  * First 16 ports are considered only.
1974
  * First 16 ports are considered only.
2022
  * The current implementation considers incorrect value of field +3
1975
  * The current implementation considers incorrect value of field +3
2023
    as a signal to terminate IRQ processing.
1976
    as a signal to terminate IRQ processing.
2024
 
1977
 
2025
======================================================================
1978
======================================================================
2026
=================== Function 45 - reserve/free IRQ. ==================
1979
=================== Function 45 - reserve/free IRQ. ==================
2027
======================================================================
1980
======================================================================
2028
Parameters:
1981
Parameters:
2029
  * eax = 45 - function number
1982
  * eax = 45 - function number
2030
  * ebx = 0 - reserve, 1 = free
1983
  * ebx = 0 - reserve, 1 = free
2031
  * ecx = IRQ number, 0..15
1984
  * ecx = IRQ number, 0..15
2032
Returned value:
1985
Returned value:
2033
  * eax = 0 - success
1986
  * eax = 0 - success
2034
  * eax = 1 - error (invalid IRQ number
1987
  * eax = 1 - error (invalid IRQ number
2035
    or attempt to reserve not free IRQ
1988
    or attempt to reserve not free IRQ
2036
    or to free IRQ, not reserved by this thread)
1989
    or to free IRQ, not reserved by this thread)
2037
Remarks:
1990
Remarks:
2038
  * IRQ reservation is required for functions 42 and 44.
1991
  * IRQ reservation is required for functions 42 and 44.
2039
  * Only one thread can reserve the specific IRQ.
1992
  * Only one thread can reserve the specific IRQ.
2040
  * IRQs, handled by the system itself, are reserved by the system
1993
  * IRQs, handled by the system itself, are reserved by the system
2041
    (thread 1) at booting.
1994
    (thread 1) at booting.
2042
  * When a thread terminates, all reserved by it IRQs
1995
  * When a thread terminates, all reserved by it IRQs
2043
    are freed automatically.
1996
    are freed automatically.
2044
 
1997
 
2045
======================================================================
1998
======================================================================
2046
====== Function 46 - reserve/free a group of input/output ports. =====
1999
====== Function 46 - reserve/free a group of input/output ports. =====
2047
======================================================================
2000
======================================================================
2048
To work with reserved ports an application can access directly by
2001
To work with reserved ports an application can access directly by
2049
commands in/out (recommended way) and can use function 43
2002
commands in/out (recommended way) and can use function 43
2050
(not recommended way).
2003
(not recommended way).
2051
Parameters:
2004
Parameters:
2052
  * eax = 46 - function number
2005
  * eax = 46 - function number
2053
  * ebx = 0 - reserve, 1 - free
2006
  * ebx = 0 - reserve, 1 - free
2054
  * ecx = start port number
2007
  * ecx = start port number
2055
  * edx = end port number (inclusive)
2008
  * edx = end port number (inclusive)
2056
Returned value:
2009
Returned value:
2057
  * eax = 0 - success
2010
  * eax = 0 - success
2058
  * eax = 1 - error
2011
  * eax = 1 - error
2059
Remarks:
2012
Remarks:
2060
  * For ports reservation: an error occurs if and only if
2013
  * For ports reservation: an error occurs if and only if
2061
    one from the following condition satisfies:
2014
    one from the following condition satisfies:
2062
    * start port is more than end port;
2015
    * start port is more than end port;
2063
    * the selected range contains incorrect port number
2016
    * the selected range contains incorrect port number
2064
      (correct are from 0 to 0xFFFF);
2017
      (correct are from 0 to 0xFFFF);
2065
    * limit for the total number of reserved areas is exceeded
2018
    * limit for the total number of reserved areas is exceeded
2066
      (maximum 255 are allowed);
2019
      (maximum 255 are allowed);
2067
    * the selected range intersects with any of earlier reserved
2020
    * the selected range intersects with any of earlier reserved
2068
  * For ports free: an error is an attempt to free range,
2021
  * For ports free: an error is an attempt to free range,
2069
    that was not earlier reserved by this function
2022
    that was not earlier reserved by this function
2070
    (with same ecx,edx).
2023
    (with same ecx,edx).
2071
  * If an error occurs (for both cases) function performs no action.
2024
  * If an error occurs (for both cases) function performs no action.
2072
  * At booting the system reserves for itself ports
2025
  * At booting the system reserves for itself ports
2073
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
2026
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
2074
  * When a thread terminates, all reserved by it ports
2027
  * When a thread terminates, all reserved by it ports
2075
    are freed automatically.
2028
    are freed automatically.
2076
 
2029
 
2077
======================================================================
2030
======================================================================
2078
============= Function 47 - draw a number in the window. =============
2031
============= Function 47 - draw a number in the window. =============
2079
======================================================================
2032
======================================================================
2080
Parameters:
2033
Parameters:
2081
  * eax = 47 - function number
2034
  * eax = 47 - function number
2082
  * ebx = parameters of conversion number to text:
2035
  * ebx = parameters of conversion number to text:
2083
    * bl = 0 - ecx contains number
2036
    * bl = 0 - ecx contains number
2084
    * bl = 1 - ecx contains pointer to dword/qword-number
2037
    * bl = 1 - ecx contains pointer to dword/qword-number
2085
    * bh = 0 - display in decimal number system
2038
    * bh = 0 - display in decimal number system
2086
    * bh = 1 - display in hexadecimal system
2039
    * bh = 1 - display in hexadecimal system
2087
    * bh = 2 - display in binary system
2040
    * bh = 2 - display in binary system
2088
    * bits 16-21 = how many digits to display
2041
    * bits 16-21 = how many digits to display
2089
    * bits 22-29 reserved and must be set to 0
2042
    * bits 22-29 reserved and must be set to 0
2090
    * bit 30 set = display qword (64-bit) number (must be bl=1)
2043
    * bit 30 set = display qword (64-bit) number (must be bl=1)
2091
    * bit 31 set = do not display leading zeroes of the number
2044
    * bit 31 set = do not display leading zeroes of the number
2092
  * ecx = number (if bl=0) or pointer (if bl=1)
2045
  * ecx = number (if bl=0) or pointer (if bl=1)
2093
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
2046
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
2094
  * esi = 0xX0RRGGBB:
2047
  * esi = 0xX0RRGGBB:
2095
    * RR, GG, BB specify the color
2048
    * RR, GG, BB specify the color
2096
    * X = ABnn (bits)
2049
    * X = ABnn (bits)
2097
    * nn = font (0/1)
2050
    * nn = font (0/1)
2098
    * A is ignored
2051
    * A is ignored
2099
    * B=1 - fill background with the color edi
2052
    * B=1 - fill background with the color edi
2100
Returned value:
2053
Returned value:
2101
  * function does not return value
2054
  * function does not return value
2102
Remarks:
2055
Remarks:
2103
  * The given length must not exceed 60.
2056
  * The given length must not exceed 60.
2104
  * The exactly given amount of digits is output. If number is small
2057
  * The exactly given amount of digits is output. If number is small
2105
    and can be written by smaller amount of digits, it is supplemented
2058
    and can be written by smaller amount of digits, it is supplemented
2106
    by leading zeroes; if the number is big and can not be written by
2059
    by leading zeroes; if the number is big and can not be written by
2107
    given amount of digits, extra digits are not drawn.
2060
    given amount of digits, extra digits are not drawn.
2108
  * Parameters of fonts are shown in the description of function 4
2061
  * Parameters of fonts are shown in the description of function 4
2109
    (text output).
2062
    (text output).
2110
 
2063
 
2111
======================================================================
2064
======================================================================
2112
========= Function 48, subfunction 0 - apply screen settings. ========
2065
========= Function 48, subfunction 0 - apply screen settings. ========
2113
======================================================================
2066
======================================================================
2114
Parameters:
2067
Parameters:
2115
  * eax = 48 - function number
2068
  * eax = 48 - function number
2116
  * ebx = 0 - subfunction number
2069
  * ebx = 0 - subfunction number
2117
  * ecx = 0 - reserved
2070
  * ecx = 0 - reserved
2118
Returned value:
2071
Returned value:
2119
  * function does not return value
2072
  * function does not return value
2120
Remarks:
2073
Remarks:
2121
  * Function redraws the screen after parameters change by
2074
  * Function redraws the screen after parameters change by
2122
    subfunctions 1 and 2.
2075
    subfunctions 1 and 2.
2123
  * Function call without prior call to one of indicated subfunctions
2076
  * Function call without prior call to one of indicated subfunctions
2124
    is ignored.
2077
    is ignored.
2125
  * Function call with nonzero ecx is ignored.
2078
  * Function call with nonzero ecx is ignored.
2126
 
2079
 
2127
======================================================================
2080
======================================================================
2128
=========== Function 48, subfunction 1 - set button style. ===========
2081
=========== Function 48, subfunction 1 - set button style. ===========
2129
======================================================================
2082
======================================================================
2130
Parameters:
2083
Parameters:
2131
  * eax = 48 - function number
2084
  * eax = 48 - function number
2132
  * ebx = 1 - subfunction number
2085
  * ebx = 1 - subfunction number
2133
  * ecx = button style:
2086
  * ecx = button style:
2134
    * 0 = flat
2087
    * 0 = flat
2135
    * 1 = 3d
2088
    * 1 = 3d
2136
Returned value:
2089
Returned value:
2137
  * function does not return value
2090
  * function does not return value
2138
Remarks:
2091
Remarks:
2139
  * After call to this function one should redraw the screen by
2092
  * After call to this function one should redraw the screen by
2140
    subfunction 0.
2093
    subfunction 0.
2141
  * Button style influences only to their draw of function 8.
2094
  * Button style influences only to their draw of function 8.
2142
 
2095
 
2143
======================================================================
2096
======================================================================
2144
====== Function 48, subfunction 2 - set standard window colors. ======
2097
====== Function 48, subfunction 2 - set standard window colors. ======
2145
======================================================================
2098
======================================================================
2146
Parameters:
2099
Parameters:
2147
  * eax = 48 - function number
2100
  * eax = 48 - function number
2148
  * ebx = 2 - subfunction number
2101
  * ebx = 2 - subfunction number
2149
  * ecx = pointer to the color table
2102
  * ecx = pointer to the color table
2150
  * edx = size of the color table
2103
  * edx = size of the color table
2151
    (must be 40 bytes for future compatibility)
2104
    (must be 40 bytes for future compatibility)
2152
Format of the color table is shown in description of subfunction 3.
2105
Format of the color table is shown in description of subfunction 3.
2153
Returned value:
2106
Returned value:
2154
  * function does not return value
2107
  * function does not return value
2155
Remarks:
2108
Remarks:
2156
  * After call to this function one should redraw the screen by
2109
  * After call to this function one should redraw the screen by
2157
    subfunction 0.
2110
    subfunction 0.
2158
  * Table of standard colors influences only to applications,
2111
  * Table of standard colors influences only to applications,
2159
    which receive this table obviously (by subfunction 3)
2112
    which receive this table obviously (by subfunction 3)
2160
    and use it (specifying colors from it to drawing functions).
2113
    and use it (specifying colors from it to drawing functions).
2161
  * Table of standard colors is included in skin and is installed
2114
  * Table of standard colors is included in skin and is installed
2162
    anew with skin installation (by subfunction 8).
2115
    anew with skin installation (by subfunction 8).
2163
  * Color table can be viewed/changed interactively with
2116
  * Color table can be viewed/changed interactively with
2164
    the application 'desktop'.
2117
    the application 'desktop'.
2165
 
2118
 
2166
======================================================================
2119
======================================================================
2167
====== Function 48, subfunction 3 - get standard window colors. ======
2120
====== Function 48, subfunction 3 - get standard window colors. ======
2168
======================================================================
2121
======================================================================
2169
Parameters:
2122
Parameters:
2170
  * eax = 48 - function number
2123
  * eax = 48 - function number
2171
  * ebx = 3 - subfunction number
2124
  * ebx = 3 - subfunction number
2172
  * ecx = pointer to the buffer with size edx bytes,
2125
  * ecx = pointer to the buffer with size edx bytes,
2173
    where table will be written
2126
    where table will be written
2174
  * edx = size of color table
2127
  * edx = size of color table
2175
    (must be 40 bytes for future compatibility)
2128
    (must be 40 bytes for future compatibility)
2176
Returned value:
2129
Returned value:
2177
  * function does not return value
2130
  * function does not return value
2178
Format of the color table:
2131
Format of the color table:
2179
each item is dword-value for color 0x00RRGGBB
2132
each item is dword-value for color 0x00RRGGBB
2180
  * +0: dword: frames - color of frame
2133
  * +0: dword: frames - color of frame
2181
  * +4: dword: grab - color of header
2134
  * +4: dword: grab - color of header
2182
  * +8: dword: grab_button - color of button on header bar
2135
  * +8: dword: grab_button - color of button on header bar
2183
  * +12 = +0xC: dword: grab_button_text - color of text on button
2136
  * +12 = +0xC: dword: grab_button_text - color of text on button
2184
    on header bar
2137
    on header bar
2185
  * +16 = +0x10: dword: grab_text - color of text on header
2138
  * +16 = +0x10: dword: grab_text - color of text on header
2186
  * +20 = +0x14: dword: work - color of working area
2139
  * +20 = +0x14: dword: work - color of working area
2187
  * +24 = +0x18: dword: work_button - color of button in working area
2140
  * +24 = +0x18: dword: work_button - color of button in working area
2188
  * +28 = +0x1C: dword: work_button_text - color of text on button
2141
  * +28 = +0x1C: dword: work_button_text - color of text on button
2189
    in working area
2142
    in working area
2190
  * +32 = +0x20: dword: work_text - color of text in working area
2143
  * +32 = +0x20: dword: work_text - color of text in working area
2191
  * +36 = +0x24: dword: work_graph - color of graphics in working area
2144
  * +36 = +0x24: dword: work_graph - color of graphics in working area
2192
Remarks:
2145
Remarks:
2193
  * Structure of the color table is described in the standard
2146
  * Structure of the color table is described in the standard
2194
    include file 'macros.inc' as 'system_colors'; for example,
2147
    include file 'macros.inc' as 'system_colors'; for example,
2195
    it is possible to write:
2148
    it is possible to write:
2196
        sc      system_colors           ; variable declaration
2149
    	sc	system_colors		; variable declaration
2197
        ...                             ; somewhere one must call
2150
    	...				; somewhere one must call
2198
                                        ; this function with ecx=sc
2151
    					; this function with ecx=sc
2199
        mov     ecx, [sc.work_button_text]      ; read text color on
2152
    	mov	ecx, [sc.work_button_text]	; read text color on
2200
                                        ; buttin in working area
2153
    					; buttin in working area
2201
  * A program itself desides to use or not to use color table.
2154
  * A program itself desides to use or not to use color table.
2202
    For usage program must simply at calls to drawing functions select
2155
    For usage program must simply at calls to drawing functions select
2203
    color taken from the table.
2156
    color taken from the table.
2204
  * At change of the table of standard colors (by subfunction 2 with
2157
  * At change of the table of standard colors (by subfunction 2 with
2205
    the subsequent application of changes by subfunction 0 or
2158
    the subsequent application of changes by subfunction 0 or
2206
    at skin set by subfunction 8) the system sends to all windows
2159
    at skin set by subfunction 8) the system sends to all windows
2207
    redraw message (the event with code 1).
2160
    redraw message (the event with code 1).
2208
  * Color table can be viewed/changed interactively with
2161
  * Color table can be viewed/changed interactively with
2209
    the application 'desktop'.
2162
    the application 'desktop'.
2210
 
2163
 
2211
======================================================================
2164
======================================================================
2212
============ Function 48, subfunction 4 - get skin height. ===========
2165
============ Function 48, subfunction 4 - get skin height. ===========
2213
======================================================================
2166
======================================================================
2214
Parameters:
2167
Parameters:
2215
  * eax = 48 - function number
2168
  * eax = 48 - function number
2216
  * ebx = 4 - subfunction number
2169
  * ebx = 4 - subfunction number
2217
Returned value:
2170
Returned value:
2218
  * eax = skin height
2171
  * eax = skin height
2219
Remarks:
2172
Remarks:
2220
  * Skin height is defined as the height of a header
2173
  * Skin height is defined as the height of a header
2221
    of skinned windows.
2174
    of skinned windows.
2222
  * See also general structure of window in the description
2175
  * See also general structure of window in the description
2223
    of function 0.
2176
    of function 0.
2224
 
2177
 
2225
======================================================================
2178
======================================================================
2226
======== Function 48, subfunction 5 - get screen working area. =======
2179
======== Function 48, subfunction 5 - get screen working area. =======
2227
======================================================================
2180
======================================================================
2228
Parameters:
2181
Parameters:
2229
  * eax = 48 - function number
2182
  * eax = 48 - function number
2230
  * ebx = 5 - subfunction number
2183
  * ebx = 5 - subfunction number
2231
Returned value:
2184
Returned value:
2232
  * eax = [left]*65536 + [right]
2185
  * eax = [left]*65536 + [right]
2233
  * ebx = [top]*65536 + [bottom]
2186
  * ebx = [top]*65536 + [bottom]
2234
Remarks:
2187
Remarks:
2235
  * The screen working area defines position and coordinates of
2188
  * The screen working area defines position and coordinates of
2236
    a maximized window.
2189
    a maximized window.
2237
  * The screen working area in view of normal work is all screen
2190
  * The screen working area in view of normal work is all screen
2238
    without system panel (the application '@panel').
2191
    without system panel (the application '@panel').
2239
  * (left,top) are coordinates of the left upper corner,
2192
  * (left,top) are coordinates of the left upper corner,
2240
    (right,bottom) are coordinates of the right lower one.
2193
    (right,bottom) are coordinates of the right lower one.
2241
    Thus the size of working area on x axis can be calculated by
2194
    Thus the size of working area on x axis can be calculated by
2242
    formula right-left+1, on y axis - by formula bottom-right+1.
2195
    formula right-left+1, on y axis - by formula bottom-right+1.
2243
  * See also function 14,
2196
  * See also function 14,
2244
    to get sizes of all screen.
2197
    to get sizes of all screen.
2245
  * There is a pair function to set working area - subfunction 6.
2198
  * There is a pair function to set working area - subfunction 6.
2246
 
2199
 
2247
======================================================================
2200
======================================================================
2248
======== Function 48, subfunction 6 - set screen working area. =======
2201
======== Function 48, subfunction 6 - set screen working area. =======
2249
======================================================================
2202
======================================================================
2250
Parameters:
2203
Parameters:
2251
  * eax = 48 - function number
2204
  * eax = 48 - function number
2252
  * ebx = 6 - subfunction number
2205
  * ebx = 6 - subfunction number
2253
  * ecx = [left]*65536 + [right]
2206
  * ecx = [left]*65536 + [right]
2254
  * edx = [top]*65536 + [bottom]
2207
  * edx = [top]*65536 + [bottom]
2255
Returned value:
2208
Returned value:
2256
  * function does not return value
2209
  * function does not return value
2257
Remarks:
2210
Remarks:
2258
  * The screen working area defines position and coordinates of
2211
  * The screen working area defines position and coordinates of
2259
    a maximized window.
2212
    a maximized window.
2260
  * This function is used only by the application '@panel',
2213
  * This function is used only by the application '@panel',
2261
    which set working area to all screen without system panel.
2214
    which set working area to all screen without system panel.
2262
  * (left,top) are coordinates of the left upper corner,
2215
  * (left,top) are coordinates of the left upper corner,
2263
    (right,bottom) are coordinates of the right lower one.
2216
    (right,bottom) are coordinates of the right lower one.
2264
    Thus the size of working area on x axis can be calculated by
2217
    Thus the size of working area on x axis can be calculated by
2265
    formula right-left+1, on y axis - by formula bottom-right+1.
2218
    formula right-left+1, on y axis - by formula bottom-right+1.
2266
  * If 'left'>='right', x-coordinate of working area is not changed.
2219
  * If 'left'>='right', x-coordinate of working area is not changed.
2267
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
2220
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
2268
    equal to screen width, 'right' will not be set.
2221
    equal to screen width, 'right' will not be set.
2269
    Similarly on y axis.
2222
    Similarly on y axis.
2270
  * See also function 14,
2223
  * See also function 14,
2271
    to get sizes of all screen.
2224
    to get sizes of all screen.
2272
  * There is a pair function to get working area - subfunction 5.
2225
  * There is a pair function to get working area - subfunction 5.
2273
  * This function redraws the screen automatically,
2226
  * This function redraws the screen automatically,
2274
    updating coordinates and sizes of maximized windows.
2227
    updating coordinates and sizes of maximized windows.
2275
    The system sends to all windows redraw message (the event 1).
2228
    The system sends to all windows redraw message (the event 1).
2276
 
2229
 
2277
======================================================================
2230
======================================================================
2278
=========== Function 48, subfunction 7 - get skin margins. ===========
2231
=========== Function 48, subfunction 7 - get skin margins. ===========
2279
======================================================================
2232
======================================================================
2280
Returns the area of a header of a skinned window, intended for
2233
Returns the area of a header of a skinned window, intended for
2281
a text of a header.
2234
a text of a header.
2282
Parameters:
2235
Parameters:
2283
  * eax = 48 - function number
2236
  * eax = 48 - function number
2284
  * ebx = 7 - subfunction number
2237
  * ebx = 7 - subfunction number
2285
Returned value:
2238
Returned value:
2286
  * eax = [left]*65536 + [right]
2239
  * eax = [left]*65536 + [right]
2287
  * ebx = [top]*65536 + [bottom]
2240
  * ebx = [top]*65536 + [bottom]
2288
Remarks:
2241
Remarks:
2289
  * An application decides itself to use or not to use this function.
2242
  * An application decides itself to use or not to use this function.
2290
  * It is recommended to take into account returned value
2243
  * It is recommended to take into account returned value
2291
    of this function for choice of a place for drawing header text
2244
    of this function for choice of a place for drawing header text
2292
    (by function 4) or a substitute of header text
2245
    (by function 4) or a substitute of header text
2293
    (at the discretion of an application).
2246
    (at the discretion of an application).
2294
 
2247
 
2295
======================================================================
2248
======================================================================
2296
============= Function 48, subfunction 8 - set used skin. ============
2249
============= Function 48, subfunction 8 - set used skin. ============
2297
======================================================================
2250
======================================================================
2298
Parameters:
2251
Parameters:
2299
  * eax = 48 - function number
2252
  * eax = 48 - function number
2300
  * ebx = 8 - subfunction number
2253
  * ebx = 8 - subfunction number
2301
  * ecx = pointer to a block for function 58, in
2254
  * ecx = pointer to a block for function 58, in
2302
    which the fields of intermediate buffer and file name are filled
2255
    which the fields of intermediate buffer and file name are filled
2303
Returned value:
2256
Returned value:
2304
  * eax = 0 - success
2257
  * eax = 0 - success
2305
  * otherwise eax = file system error code; if file does not
2258
  * otherwise eax = file system error code; if file does not
2306
    contain valid skin, function returns error 3
2259
    contain valid skin, function returns error 3
2307
    (unknown file system).
2260
    (unknown file system).
2308
Remarks:
2261
Remarks:
2309
  * After successful skin loading the system sends to all windows
2262
  * After successful skin loading the system sends to all windows
2310
    redraw message (the event 1).
2263
    redraw message (the event 1).
2311
  * At booting the system reads skin from file 'default.skn'
2264
  * At booting the system reads skin from file 'default.skn'
2312
    on ramdisk.
2265
    on ramdisk.
2313
  * User can change the skin statically by creating hisself
2266
  * User can change the skin statically by creating hisself
2314
    'default.skn' or dynamically with the application 'desktop'.
2267
    'default.skn' or dynamically with the application 'desktop'.
2315
 
2268
 
2316
======================================================================
2269
======================================================================
2317
=========== Function 49 - Advanced Power Management (APM). ===========
2270
=========== Function 49 - Advanced Power Management (APM). ===========
2318
======================================================================
2271
======================================================================
2319
Parameters:
2272
Parameters:
2320
  * eax = 49 - function number
2273
  * eax = 49 - function number
2321
  * dx = number of the APM function
2274
  * dx = number of the APM function
2322
    (analogue of ax in APM specification)
2275
    (analogue of ax in APM specification)
2323
  * bx, cx = parameters of the APM function
2276
  * bx, cx = parameters of the APM function
2324
Returned value:
2277
Returned value:
2325
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
2278
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
2326
    are set according to the APM specification
2279
    are set according to the APM specification
2327
  * high halves of 32-bit registers eax, ebx, ecx,
2280
  * high halves of 32-bit registers eax, ebx, ecx,
2328
    edx, esi, edi are destroyed
2281
    edx, esi, edi are destroyed
2329
Remarks:
2282
Remarks:
2330
  * APM 1.2 specification is described in the document
2283
  * APM 1.2 specification is described in the document
2331
    "Advanced Power Management (APM) BIOS Specification"
2284
    "Advanced Power Management (APM) BIOS Specification"
2332
    (Revision 1.2), available at
2285
    (Revision 1.2), available at
2333
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2286
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2334
    besides it is included in famous Interrupt List by Ralf Brown
2287
    besides it is included in famous Interrupt List by Ralf Brown
2335
    (http://www.pobox.com/~ralf/files.html,
2288
    (http://www.pobox.com/~ralf/files.html,
2336
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2289
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2337
 
2290
 
2338
======================================================================
2291
======================================================================
2339
=================== Function 50 - set window shape. ==================
2292
=================== Function 50 - set window shape. ==================
2340
======================================================================
2293
======================================================================
2341
Normal windows have rectangular shape. This function can give to
2294
Normal windows have rectangular shape. This function can give to
2342
a window any shape. The shape is given by a set of points inside
2295
a window any shape. The shape is given by a set of points inside
2343
the base rectangle belonging to a window. Position and coordinates
2296
the base rectangle belonging to a window. Position and coordinates
2344
of the base rectangle are set by function 0
2297
of the base rectangle are set by function 0
2345
and changed by function 67.
2298
and changed by function 67.
2346
 
2299
 
2347
--------------------------- Set shape data ---------------------------
2300
--------------------------- Set shape data ---------------------------
2348
Parameters:
2301
Parameters:
2349
  * eax = 50 - function number
2302
  * eax = 50 - function number
2350
  * ebx = 0 - subfunction number
2303
  * ebx = 0 - subfunction number
2351
  * ecx = pointer to shape data (array of bytes 0/1)
2304
  * ecx = pointer to shape data (array of bytes 0/1)
2352
Returned value:
2305
Returned value:
2353
  * function does not return value
2306
  * function does not return value
2354
 
2307
 
2355
-------------------------- Set shape scale ---------------------------
2308
-------------------------- Set shape scale ---------------------------
2356
Parameters:
2309
Parameters:
2357
  * eax = 50 - function number
2310
  * eax = 50 - function number
2358
  * ebx = 1 - subfunction number
2311
  * ebx = 1 - subfunction number
2359
  * ecx sets a scale: each byte of data defines
2312
  * ecx sets a scale: each byte of data defines
2360
    (2^scale)*(2^scale) pixels
2313
    (2^scale)*(2^scale) pixels
2361
Returned value:
2314
Returned value:
2362
  * function does not return value
2315
  * function does not return value
2363
Remarks:
2316
Remarks:
2364
  * Default scale is 0 (scale factor is 1). If in the shape data
2317
  * Default scale is 0 (scale factor is 1). If in the shape data
2365
    one byte corresponds to one pixel, there is no necessity
2318
    one byte corresponds to one pixel, there is no necessity
2366
    to set scale.
2319
    to set scale.
2367
  * Let's designate xsize = window width (in pixels), ysize = height;
2320
  * Let's designate xsize = window width (in pixels), ysize = height;
2368
    pay attention, that they are one pixel more than defined by
2321
    pay attention, that they are one pixel more than defined by
2369
    functions 0, 67.
2322
    functions 0, 67.
2370
  * On definition of scale xsize and ysize must be divisible
2323
  * On definition of scale xsize and ysize must be divisible
2371
    on 2^scale.
2324
    on 2^scale.
2372
  * Byte of data on offset 'a' must be 0/1 and defines belonging
2325
  * Byte of data on offset 'a' must be 0/1 and defines belonging
2373
    to a window of square with the side 2^scale (if scale=0,
2326
    to a window of square with the side 2^scale (if scale=0,
2374
    this is one pixel) and coordinates of the left upper corner
2327
    this is one pixel) and coordinates of the left upper corner
2375
    (a mod (xsize shr scale), a div (xsize shr scale))
2328
    (a mod (xsize shr scale), a div (xsize shr scale))
2376
  * Data size: (xsize shr scale)*(ysize shr scale).
2329
  * Data size: (xsize shr scale)*(ysize shr scale).
2377
  * Data must be presented in the memory and not change
2330
  * Data must be presented in the memory and not change
2378
    after set of shape.
2331
    after set of shape.
2379
  * The system views the shape data at every window redraw by
2332
  * The system views the shape data at every window redraw by
2380
    function 0.
2333
    function 0.
2381
  * The call of subfunction 0 with NULL pointer results in return
2334
  * The call of subfunction 0 with NULL pointer results in return
2382
    to the rectangular shape.
2335
    to the rectangular shape.
2383
 
2336
 
2384
======================================================================
2337
======================================================================
2385
==================== Function 51 - create thread. ====================
2338
==================== Function 51 - create thread. ====================
2386
======================================================================
2339
======================================================================
2387
Parameters:
2340
Parameters:
2388
  * eax = 51 - function number
2341
  * eax = 51 - function number
2389
  * ebx = 1 - unique subfunction
2342
  * ebx = 1 - unique subfunction
2390
  * ecx = address of thread entry point (starting eip)
2343
  * ecx = address of thread entry point (starting eip)
2391
  * edx = pointer to thread stack (starting esp)
2344
  * edx = pointer to thread stack (starting esp)
2392
Returned value:
2345
Returned value:
2393
  * eax = -1 - error (there is too many threads)
2346
  * eax = -1 - error (there is too many threads)
2394
  * otherwise eax = TID - thread identifier
2347
  * otherwise eax = TID - thread identifier
2395
    
2348
         
2396
 
2349
 
2397
======================================================================
2350
======================================================================
2398
=== Function 52, subfunction 0 - get network driver configuration. ===
2351
=== Function 52, subfunction 0 - get network driver configuration. ===
2399
======================================================================
2352
======================================================================
2400
Parameters:
2353
Parameters:
2401
  * eax = 52 - function number
2354
  * eax = 52 - function number
2402
  * ebx = 0 - subfunction number
2355
  * ebx = 0 - subfunction number
2403
Returned value:
2356
Returned value:
2404
  * eax = configuration dword
2357
  * eax = configuration dword
2405
Remarks:
2358
Remarks:
2406
  * Configuration dword can be set by subfunction 2.
2359
  * Configuration dword can be set by subfunction 2.
2407
  * The kernel does not use this variable. The value of this
2360
  * The kernel does not use this variable. The value of this
2408
    variable and working with it subfunctions 0 and 2 is represented
2361
    variable and working with it subfunctions 0 and 2 is represented
2409
    doubtful.
2362
    doubtful.
2410
 
2363
 
2411
======================================================================
2364
======================================================================
2412
========= Function 52, subfunction 1 - get local IP-address. =========
2365
========= Function 52, subfunction 1 - get local IP-address. =========
2413
======================================================================
2366
======================================================================
2414
Parameters:
2367
Parameters:
2415
  * eax = 52 - function number
2368
  * eax = 52 - function number
2416
  * ebx = 1 - subfunction number
2369
  * ebx = 1 - subfunction number
2417
Returned value:
2370
Returned value:
2418
  * eax = IP-address (4 bytes)
2371
  * eax = IP-address (4 bytes)
2419
Remarks:
2372
Remarks:
2420
  * Local IP-address is set by subfunction 3.
2373
  * Local IP-address is set by subfunction 3.
2421
 
2374
 
2422
======================================================================
2375
======================================================================
2423
=== Function 52, subfunction 2 - set network driver configuration. ===
2376
=== Function 52, subfunction 2 - set network driver configuration. ===
2424
======================================================================
2377
======================================================================
2425
Parameters:
2378
Parameters:
2426
  * eax = 52 - function number
2379
  * eax = 52 - function number
2427
  * ebx = 2 - subfunction number
2380
  * ebx = 2 - subfunction number
2428
  * ecx = configuration dword; if low 7 bits derivate the number 3,
2381
  * ecx = configuration dword; if low 7 bits derivate the number 3,
2429
    function [re-]initializes Ethernet-card, otherwise
2382
    function [re-]initializes Ethernet-card, otherwise
2430
    Ethernet turns off
2383
    Ethernet turns off
2431
Returned value:
2384
Returned value:
2432
  * if Ethernet-interface is not requested, function returns eax=2,
2385
  * if Ethernet-interface is not requested, function returns eax=2,
2433
    but this can be changed in future kernel versions
2386
    but this can be changed in future kernel versions
2434
  * if Ethernet-interface is requested, eax=0 means error
2387
  * if Ethernet-interface is requested, eax=0 means error
2435
    (absence of Ethernet-card), and nonzero value - success
2388
    (absence of Ethernet-card), and nonzero value - success
2436
Remarks:
2389
Remarks:
2437
  * Configuration dword can be read by subfunction 0.
2390
  * Configuration dword can be read by subfunction 0.
2438
  * The kernel does not use this variable. The value of this
2391
  * The kernel does not use this variable. The value of this
2439
    variable, subfunction 0 and part of subfunction 2, which set it,
2392
    variable, subfunction 0 and part of subfunction 2, which set it,
2440
    is represented doubtful.
2393
    is represented doubtful.
2441
 
2394
 
2442
======================================================================
2395
======================================================================
2443
========= Function 52, subfunction 3 - set local IP-address. =========
2396
========= Function 52, subfunction 3 - set local IP-address. =========
2444
======================================================================
2397
======================================================================
2445
Parameters:
2398
Parameters:
2446
  * eax = 52 - function number
2399
  * eax = 52 - function number
2447
  * ebx = 3 - subfunction number
2400
  * ebx = 3 - subfunction number
2448
  * ecx = IP-address (4 bytes)
2401
  * ecx = IP-address (4 bytes)
2449
Returned value:
2402
Returned value:
2450
  * the current implementation returns eax=3, but this can be changed
2403
  * the current implementation returns eax=3, but this can be changed
2451
    in future versions
2404
    in future versions
2452
Remarks:
2405
Remarks:
2453
  * Local IP-address can be get by subfunction 1.
2406
  * Local IP-address can be get by subfunction 1.
2454
 
2407
 
2455
======================================================================
2408
======================================================================
2456
= Function 52, subfunction 6 - add data to the stack of input queue. =
2409
= Function 52, subfunction 6 - add data to the stack of input queue. =
2457
======================================================================
2410
======================================================================
2458
Parameters:
2411
Parameters:
2459
  * eax = 52 - function number
2412
  * eax = 52 - function number
2460
  * ebx = 6 - subfunction number
2413
  * ebx = 6 - subfunction number
2461
  * edx = data size
2414
  * edx = data size
2462
  * esi = data pointer
2415
  * esi = data pointer
2463
Returned value:
2416
Returned value:
2464
  * eax = -1 - error
2417
  * eax = -1 - error
2465
  * eax = 0 - success
2418
  * eax = 0 - success
2466
Remarks:
2419
Remarks:
2467
  * This function is intended only for slow network drivers
2420
  * This function is intended only for slow network drivers
2468
    (PPP, SLIP).
2421
    (PPP, SLIP).
2469
  * Data size must not exceed 1500 bytes, though function
2422
  * Data size must not exceed 1500 bytes, though function
2470
    performs no checks on correctness.
2423
    performs no checks on correctness.
2471
 
2424
 
2472
======================================================================
2425
======================================================================
2473
 Function 52, subfunction 8 - read data from the network output queue.
2426
 Function 52, subfunction 8 - read data from the network output queue. 
2474
======================================================================
2427
======================================================================
2475
Parameters:
2428
Parameters:
2476
  * eax = 52 - function number
2429
  * eax = 52 - function number
2477
  * ebx = 8 - subfunction number
2430
  * ebx = 8 - subfunction number
2478
  * esi = pointer to 1500-byte buffer
2431
  * esi = pointer to 1500-byte buffer
2479
Returned value:
2432
Returned value:
2480
  * eax = number of read bytes (in the current implementation
2433
  * eax = number of read bytes (in the current implementation
2481
    either 0 = no data or 1500)
2434
    either 0 = no data or 1500)
2482
  * data was copied in buffer
2435
  * data was copied in buffer
2483
Remarks:
2436
Remarks:
2484
  * This function is intended only for slow network drivers
2437
  * This function is intended only for slow network drivers
2485
    (PPP, SLIP).
2438
    (PPP, SLIP).
2486
 
2439
 
2487
======================================================================
2440
======================================================================
2488
============ Function 52, subfunction 9 - get gateway IP. ============
2441
============ Function 52, subfunction 9 - get gateway IP. ============
2489
======================================================================
2442
======================================================================
2490
Parameters:
2443
Parameters:
2491
  * eax = 52 - function number
2444
  * eax = 52 - function number
2492
  * ebx = 9 - subfunction number
2445
  * ebx = 9 - subfunction number
2493
Returned value:
2446
Returned value:
2494
  * eax = gateway IP (4 bytes)
2447
  * eax = gateway IP (4 bytes)
2495
 
2448
 
2496
======================================================================
2449
======================================================================
2497
=========== Function 52, subfunction 10 - get subnet mask. ===========
2450
=========== Function 52, subfunction 10 - get subnet mask. ===========
2498
======================================================================
2451
======================================================================
2499
Parameters:
2452
Parameters:
2500
  * eax = 52 - function number
2453
  * eax = 52 - function number
2501
  * ebx = 10 - subfunction number
2454
  * ebx = 10 - subfunction number
2502
Returned value:
2455
Returned value:
2503
  * eax = subnet mask
2456
  * eax = subnet mask
2504
 
2457
 
2505
======================================================================
2458
======================================================================
2506
============ Function 52, subfunction 11 - set gateway IP. ===========
2459
============ Function 52, subfunction 11 - set gateway IP. ===========
2507
======================================================================
2460
======================================================================
2508
Parameters:
2461
Parameters:
2509
  * eax = 52 - function number
2462
  * eax = 52 - function number
2510
  * ebx = 11 - subfunction number
2463
  * ebx = 11 - subfunction number
2511
  * ecx = gateway IP (4 bytes)
2464
  * ecx = gateway IP (4 bytes)
2512
Returned value:
2465
Returned value:
2513
  * the current implementation returns eax=11, but this can be changed
2466
  * the current implementation returns eax=11, but this can be changed
2514
    in future versions
2467
    in future versions
2515
 
2468
 
2516
======================================================================
2469
======================================================================
2517
=========== Function 52, subfunction 12 - set subnet mask. ===========
2470
=========== Function 52, subfunction 12 - set subnet mask. ===========
2518
======================================================================
2471
======================================================================
2519
Parameters:
2472
Parameters:
2520
  * eax = 52 - function number
2473
  * eax = 52 - function number
2521
  * ebx = 12 - subfunction number
2474
  * ebx = 12 - subfunction number
2522
  * ecx = subnet mask
2475
  * ecx = subnet mask
2523
Returned value:
2476
Returned value:
2524
  * the current implementation returns eax=12, but this can be changed
2477
  * the current implementation returns eax=12, but this can be changed
2525
    in future versions
2478
    in future versions
2526
 
2479
 
2527
======================================================================
2480
======================================================================
2528
============== Function 52, subfunction 13 - get DNS IP. =============
2481
============== Function 52, subfunction 13 - get DNS IP. =============
2529
======================================================================
2482
======================================================================
2530
Parameters:
2483
Parameters:
2531
  * eax = 52 - function number
2484
  * eax = 52 - function number
2532
  * ebx = 13 - subfunction number
2485
  * ebx = 13 - subfunction number
2533
Returned value:
2486
Returned value:
2534
  * eax = DNS IP (4 bytes)
2487
  * eax = DNS IP (4 bytes)
2535
 
2488
 
2536
======================================================================
2489
======================================================================
2537
============== Function 52, subfunction 14 - set DNS IP. =============
2490
============== Function 52, subfunction 14 - set DNS IP. =============
2538
======================================================================
2491
======================================================================
2539
Parameters:
2492
Parameters:
2540
  * eax = 52 - function number
2493
  * eax = 52 - function number
2541
  * ebx = 14 - subfunction number
2494
  * ebx = 14 - subfunction number
2542
  * ecx = DNS IP (4 bytes)
2495
  * ecx = DNS IP (4 bytes)
2543
Returned value:
2496
Returned value:
2544
  * the current implementation returns eax=14, but this can be changed
2497
  * the current implementation returns eax=14, but this can be changed
2545
    in future versions
2498
    in future versions
2546
 
2499
 
2547
======================================================================
2500
======================================================================
2548
======== Function 52, subfunction 15 - get local MAC address. ========
2501
======== Function 52, subfunction 15 - get local MAC address. ========
2549
======================================================================
2502
======================================================================
2550
Parameters:
2503
Parameters:
2551
  * eax = 52 - function number
2504
  * eax = 52 - function number
2552
  * ebx = 15 - subfunction number
2505
  * ebx = 15 - subfunction number
2553
  * ecx = 0 - read first 4 bytes,
2506
  * ecx = 0 - read first 4 bytes,
2554
    ecx = 4 - read last 2 bytes
2507
    ecx = 4 - read last 2 bytes
2555
Returned value:
2508
Returned value:
2556
  * for ecx=0: eax = first 4 bytes of MAC address
2509
  * for ecx=0: eax = first 4 bytes of MAC address
2557
  * for ecx=4: ax = last 2 bytes of MAC address,
2510
  * for ecx=4: ax = last 2 bytes of MAC address,
2558
               high half of eax is destroyed
2511
               high half of eax is destroyed
2559
  * for other ecx: eax = -1 indicates an error
2512
  * for other ecx: eax = -1 indicates an error
2560
 
2513
 
2561
======================================================================
2514
======================================================================
2562
============ Function 53, subfunction 0 - open UDP-socket. ===========
2515
============ Function 53, subfunction 0 - open UDP-socket. ===========
2563
======================================================================
2516
======================================================================
2564
Parameters:
2517
Parameters:
2565
  * eax = 53 - function number
2518
  * eax = 53 - function number
2566
  * ebx = 0 - subfunction number
2519
  * ebx = 0 - subfunction number
2567
  * ecx = local port (only low word is taken into account),
2520
  * ecx = local port (only low word is taken into account),
2568
    ecx = 0 - let the system choose a port
2521
    ecx = 0 - let the system choose a port
2569
  * edx = remote port (only low word is taken into account)
2522
  * edx = remote port (only low word is taken into account)
2570
  * esi = remote IP
2523
  * esi = remote IP
2571
Returned value:
2524
Returned value:
2572
  * eax = -1 = 0xFFFFFFFF - error; ebx destroyed
2525
  * eax = -1 = 0xFFFFFFFF - error; ebx destroyed
2573
  * eax = socket handle (some number which unambiguously identifies
2526
  * eax = socket handle (some number which unambiguously identifies
2574
    socket and have sense only for the system) - success;
2527
    socket and have sense only for the system) - success;
2575
    ebx destroyed
2528
    ebx destroyed
2576
 
2529
 
2577
======================================================================
2530
======================================================================
2578
=========== Function 53, subfunction 1 - close UDP-socket. ===========
2531
=========== Function 53, subfunction 1 - close UDP-socket. ===========
2579
======================================================================
2532
======================================================================
2580
Parameters:
2533
Parameters:
2581
  * eax = 53 - function number
2534
  * eax = 53 - function number
2582
  * ebx = 1 - subfunction number
2535
  * ebx = 1 - subfunction number
2583
  * ecx = socket handle
2536
  * ecx = socket handle
2584
Returned value:
2537
Returned value:
2585
  * eax = -1 - incorrect handle
2538
  * eax = -1 - incorrect handle
2586
  * eax = 0 - success
2539
  * eax = 0 - success
2587
  * ebx destroyed
2540
  * ebx destroyed
2588
Remarks:
2541
Remarks:
2589
  * The current implementation does not close automatically all
2542
  * The current implementation does not close automatically all
2590
    sockets of a thread at termination. In particular, one should not
2543
    sockets of a thread at termination. In particular, one should not
2591
    kill a thread with many opened sockets - there will be an outflow
2544
    kill a thread with many opened sockets - there will be an outflow
2592
    of resources.
2545
    of resources.
2593
 
2546
 
2594
======================================================================
2547
======================================================================
2595
============== Function 53, subfunction 2 - poll socket. =============
2548
============== Function 53, subfunction 2 - poll socket. =============
2596
======================================================================
2549
======================================================================
2597
Parameters:
2550
Parameters:
2598
  * eax = 53 - function number
2551
  * eax = 53 - function number
2599
  * ebx = 2 - subfunction number
2552
  * ebx = 2 - subfunction number
2600
  * ecx = socket handle
2553
  * ecx = socket handle
2601
Returned value:
2554
Returned value:
2602
  * eax = number of read bytes, 0 for incorrect handle
2555
  * eax = number of read bytes, 0 for incorrect handle
2603
  * ebx destroyed
2556
  * ebx destroyed
2604
 
2557
 
2605
======================================================================
2558
======================================================================
2606
========= Function 53, subfunction 3 - read byte from socket. ========
2559
========= Function 53, subfunction 3 - read byte from socket. ========
2607
======================================================================
2560
======================================================================
2608
Parameters:
2561
Parameters:
2609
  * eax = 53 - function number
2562
  * eax = 53 - function number
2610
  * ebx = 3 - subfunction number
2563
  * ebx = 3 - subfunction number
2611
  * ecx = socket handle
2564
  * ecx = socket handle
2612
Returned value:
2565
Returned value:
2613
  * if there is no read data or handle is incorrect: eax=0, bl=0,
2566
  * if there is no read data or handle is incorrect: eax=0, bl=0,
2614
    other bytes of ebx are destroyed
2567
    other bytes of ebx are destroyed
2615
  * if there are read data: eax=number of rest bytes
2568
  * if there are read data: eax=number of rest bytes
2616
    (possibly 0), bl=read byte, other bytes of ebx are destroyed
2569
    (possibly 0), bl=read byte, other bytes of ebx are destroyed
2617
 
2570
 
2618
======================================================================
2571
======================================================================
2619
========== Function 53, subfunction 4 - write to UDP-socket. =========
2572
========== Function 53, subfunction 4 - write to UDP-socket. =========
2620
======================================================================
2573
======================================================================
2621
Parameters:
2574
Parameters:
2622
  * eax = 53 - function number
2575
  * eax = 53 - function number
2623
  * ebx = 4 - subfunction number
2576
  * ebx = 4 - subfunction number
2624
  * ecx = socket handle
2577
  * ecx = socket handle
2625
  * edx = number of bytes to write
2578
  * edx = number of bytes to write
2626
  * esi = pointer to data to write
2579
  * esi = pointer to data to write
2627
Returned value:
2580
Returned value:
2628
  * eax = 0xffffffff - error (invalid handle or not enough memory)
2581
  * eax = 0xffffffff - error (invalid handle or not enough memory)
2629
  * eax = 0 - success
2582
  * eax = 0 - success
2630
  * ebx destroyed
2583
  * ebx destroyed
2631
Remarks:
2584
Remarks:
2632
  * Number of bytes to write must not exceed 1500-28, though
2585
  * Number of bytes to write must not exceed 1500-28, though
2633
    the appropriate check is not made.
2586
    the appropriate check is not made.
2634
 
2587
 
2635
======================================================================
2588
======================================================================
2636
============ Function 53, subfunction 5 - open TCP-socket. ===========
2589
============ Function 53, subfunction 5 - open TCP-socket. ===========
2637
======================================================================
2590
======================================================================
2638
Parameters:
2591
Parameters:
2639
  * eax = 53 - function number
2592
  * eax = 53 - function number
2640
  * ebx = 5 - subfunction number
2593
  * ebx = 5 - subfunction number
2641
  * ecx = local port (only low word is taken into account),
2594
  * ecx = local port (only low word is taken into account),
2642
    ecx = 0 - let the system choose a port
2595
    ecx = 0 - let the system choose a port
2643
  * edx = remote port (only low word is taken into account)
2596
  * edx = remote port (only low word is taken into account)
2644
  * esi = remote IP
2597
  * esi = remote IP
2645
  * edi = open mode: SOCKET_PASSIVE=0 or SOCKET_ACTIVE=1
2598
  * edi = open mode: SOCKET_PASSIVE=0 or SOCKET_ACTIVE=1
2646
Returned value:
2599
Returned value:
2647
  * eax = -1 = 0xFFFFFFFF - error; ebx destroys
2600
  * eax = -1 = 0xFFFFFFFF - error; ebx destroys
2648
  * eax = socket handle (some number which unambiguously identifies
2601
  * eax = socket handle (some number which unambiguously identifies
2649
    socket and have sense only for the system) - success;
2602
    socket and have sense only for the system) - success;
2650
    ebx destroyed
2603
    ebx destroyed
2651
 
2604
 
2652
======================================================================
2605
======================================================================
2653
========= Function 53, subfunction 6 - get TCP-socket status. ========
2606
========= Function 53, subfunction 6 - get TCP-socket status. ========
2654
======================================================================
2607
======================================================================
2655
Parameters:
2608
Parameters:
2656
  * eax = 53 - function number
2609
  * eax = 53 - function number
2657
  * ebx = 6 - subfunction number
2610
  * ebx = 6 - subfunction number
2658
  * ecx = socket handle
2611
  * ecx = socket handle
2659
Returned value:
2612
Returned value:
2660
  * eax = 0 for incorrect handle or socket status: one of
2613
  * eax = 0 for incorrect handle or socket status: one of
2661
  * TCB_LISTEN = 1
2614
  * TCB_LISTEN = 1
2662
  * TCB_SYN_SENT = 2
2615
  * TCB_SYN_SENT = 2
2663
  * TCB_SYN_RECEIVED = 3
2616
  * TCB_SYN_RECEIVED = 3
2664
  * TCB_ESTABLISHED = 4
2617
  * TCB_ESTABLISHED = 4
2665
  * TCB_FIN_WAIT_1 = 5
2618
  * TCB_FIN_WAIT_1 = 5
2666
  * TCB_FIN_WAIT_2 = 6
2619
  * TCB_FIN_WAIT_2 = 6
2667
  * TCB_CLOSE_WAIT = 7
2620
  * TCB_CLOSE_WAIT = 7
2668
  * TCB_CLOSING = 8
2621
  * TCB_CLOSING = 8
2669
  * TCB_LAST_ASK = 9
2622
  * TCB_LAST_ASK = 9
2670
  * TCB_TIME_WAIT = 10
2623
  * TCB_TIME_WAIT = 10
2671
  * TCB_CLOSED = 11
2624
  * TCB_CLOSED = 11
2672
  * ebx destroyed
2625
  * ebx destroyed
2673
 
2626
 
2674
======================================================================
2627
======================================================================
2675
========== Function 53, subfunction 7 - write to TCP-socket. =========
2628
========== Function 53, subfunction 7 - write to TCP-socket. =========
2676
======================================================================
2629
======================================================================
2677
Parameters:
2630
Parameters:
2678
  * eax = 53 - function number
2631
  * eax = 53 - function number
2679
  * ebx = 7 - subfunction number
2632
  * ebx = 7 - subfunction number
2680
  * ecx = socket handle
2633
  * ecx = socket handle
2681
  * edx = number of bytes to write
2634
  * edx = number of bytes to write
2682
  * esi = pointer to data to write
2635
  * esi = pointer to data to write
2683
Returned value:
2636
Returned value:
2684
  * eax = 0xffffffff - error (invalid handle or not enough memory)
2637
  * eax = 0xffffffff - error (invalid handle or not enough memory)
2685
  * eax = 0 - success
2638
  * eax = 0 - success
2686
  * ebx destroyed
2639
  * ebx destroyed
2687
Remarks:
2640
Remarks:
2688
  * Number of bytes to write must not exceed 1500-40, though
2641
  * Number of bytes to write must not exceed 1500-40, though
2689
    the appropriate check is not made.
2642
    the appropriate check is not made.
2690
 
2643
 
2691
======================================================================
2644
======================================================================
2692
=========== Function 53, subfunction 8 - close TCP-socket. ===========
2645
=========== Function 53, subfunction 8 - close TCP-socket. ===========
2693
======================================================================
2646
======================================================================
2694
Parameters:
2647
Parameters:
2695
  * eax = 53 - function number
2648
  * eax = 53 - function number
2696
  * ebx = 8 - subfunction number
2649
  * ebx = 8 - subfunction number
2697
  * ecx = socket handle
2650
  * ecx = socket handle
2698
Returned value:
2651
Returned value:
2699
  * eax = -1 - error (invalid handle or
2652
  * eax = -1 - error (invalid handle or
2700
    not enough memory for socket close packet)
2653
    not enough memory for socket close packet)
2701
  * eax = 0 - success
2654
  * eax = 0 - success
2702
  * ebx destroyed
2655
  * ebx destroyed
2703
Remarks:
2656
Remarks:
2704
  * The current implementation does not close automatically all
2657
  * The current implementation does not close automatically all
2705
    sockets of a thread at termination. In particular, one should not
2658
    sockets of a thread at termination. In particular, one should not
2706
    kill a thread with many opened sockets - there will be an outflow
2659
    kill a thread with many opened sockets - there will be an outflow
2707
    of resources.
2660
    of resources.
2708
 
2661
 
2709
======================================================================
2662
======================================================================
2710
=== Function 53, subfunction 9 - check whether local port is free. ===
2663
=== Function 53, subfunction 9 - check whether local port is free. ===
2711
======================================================================
2664
======================================================================
2712
Parameters:
2665
Parameters:
2713
  * eax = 53 - function number
2666
  * eax = 53 - function number
2714
  * ebx = 9 - subfunction number
2667
  * ebx = 9 - subfunction number
2715
  * ecx = local port number (low 16 bits are used only)
2668
  * ecx = local port number (low 16 bits are used only)
2716
Returned value:
2669
Returned value:
2717
  * eax = 0 - port is used
2670
  * eax = 0 - port is used
2718
  * eax = 1 - port is free
2671
  * eax = 1 - port is free
2719
  * ebx destroyed
2672
  * ebx destroyed
2720
 
2673
 
2721
======================================================================
2674
======================================================================
2722
===== Function 53, subfunction 10 - query Ethernet cable status. =====
2675
===== Function 53, subfunction 10 - query Ethernet cable status. =====
2723
======================================================================
2676
======================================================================
2724
Parameters:
2677
Parameters:
2725
  * eax = 53 - function number
2678
  * eax = 53 - function number
2726
  * ebx = 10 - subfunction number
2679
  * ebx = 10 - subfunction number
2727
Returned value:
2680
Returned value:
2728
  * al = -1 - a network driver is not loaded or
2681
  * al = -1 - a network driver is not loaded or
2729
              does not support this function
2682
              does not support this function
2730
  * al = 0 - Ethernet cable is unplugged
2683
  * al = 0 - Ethernet cable is unplugged
2731
  * al = 1 - Ethernet cable is plugged
2684
  * al = 1 - Ethernet cable is plugged
2732
  * ebx destroyed
2685
  * ebx destroyed
2733
Remarks:
2686
Remarks:
2734
  * The current kernel implementation supports this function
2687
  * The current kernel implementation supports this function
2735
    only for RTL8139 network cards.
2688
    only for RTL8139 network cards.
2736
 
2689
 
2737
======================================================================
2690
======================================================================
2738
======= Function 53, subfunction 11 - read network stack data. =======
2691
======= Function 53, subfunction 11 - read network stack data. =======
2739
======================================================================
2692
======================================================================
2740
Paramters:
2693
Paramters:
2741
  * eax = 53 - function number
2694
  * eax = 53 - function number
2742
  * ebx = 11 - subfunction number
2695
  * ebx = 11 - subfunction number
2743
  * ecx = socket handle
2696
  * ecx = socket handle
2744
  * edx = pointer to buffer
2697
  * edx = pointer to buffer
2745
  * esi = number of bytes to read;
2698
  * esi = number of bytes to read;
2746
  * esi = 0 - read all data (maximum 4096 bytes)
2699
  * esi = 0 - read all data (maximum 4096 bytes)
2747
Returned value:
2700
Returned value:
2748
  * eax = number of bytes read (0 for incorrect handle)
2701
  * eax = number of bytes read (0 for incorrect handle)
2749
  * ebx destroyed
2702
  * ebx destroyed
2750
 
2703
 
2751
======================================================================
2704
======================================================================
2752
= Function 53, subfunction 255 - debug information of network driver.
2705
= Function 53, subfunction 255 - debug information of network driver. 
2753
======================================================================
2706
======================================================================
2754
Parameters:
2707
Parameters:
2755
  * eax = 53 - function number
2708
  * eax = 53 - function number
2756
  * ebx = 255 - subfunction number
2709
  * ebx = 255 - subfunction number
2757
  * ecx = type of requested information (see below)
2710
  * ecx = type of requested information (see below)
2758
Returned value:
2711
Returned value:
2759
  * eax = requested information
2712
  * eax = requested information
2760
  * ebx destroyed
2713
  * ebx destroyed
2761
Possible values for ecx:
2714
Possible values for ecx:
2762
  * 100: length of queue 0 (empty queue)
2715
  * 100: length of queue 0 (empty queue)
2763
  * 101: length of queue 1 (ip-out queue)
2716
  * 101: length of queue 1 (ip-out queue)
2764
  * 102: length of queue 2 (ip-in queue)
2717
  * 102: length of queue 2 (ip-in queue)
2765
  * 103: length of queue 3 (net1out queue)
2718
  * 103: length of queue 3 (net1out queue)
2766
  * 200: number of items in the ARP table
2719
  * 200: number of items in the ARP table
2767
  * 201: size of the ARP table (in items) (20 for current version)
2720
  * 201: size of the ARP table (in items) (20 for current version)
2768
  * 202: read item at edx of the ARP table to the temporary buffer,
2721
  * 202: read item at edx of the ARP table to the temporary buffer,
2769
    whence 5 following types take information;
2722
    whence 5 following types take information;
2770
    in this case eax is not defined
2723
    in this case eax is not defined
2771
  * 203: IP-address saved by type 202
2724
  * 203: IP-address saved by type 202
2772
  * 204: high dword of MAC-address saved by type 202
2725
  * 204: high dword of MAC-address saved by type 202
2773
  * 205: low word of MAC-address saved by type 202
2726
  * 205: low word of MAC-address saved by type 202
2774
  * 206: status word saved by type 202
2727
  * 206: status word saved by type 202
2775
  * 207: ttl word saved by type 202
2728
  * 207: ttl word saved by type 202
2776
  * 2: total number of received IP-packets
2729
  * 2: total number of received IP-packets
2777
  * 3: total number of transferred IP-packets
2730
  * 3: total number of transferred IP-packets
2778
  * 4: total number of dumped received packets
2731
  * 4: total number of dumped received packets
2779
  * 5: total number of received ARP-packets
2732
  * 5: total number of received ARP-packets
2780
  * 6: status of packet driver, 0=inactive, nonzero=active
2733
  * 6: status of packet driver, 0=inactive, nonzero=active
2781
 
2734
 
2782
======================================================================
2735
======================================================================
2783
 Function 55, subfunction 55 - begin to play data on built-in speaker.
2736
 Function 55, subfunction 55 - begin to play data on built-in speaker. 
2784
======================================================================
2737
======================================================================
2785
Parameters:
2738
Parameters:
2786
  * eax = 55 - function number
2739
  * eax = 55 - function number
2787
  * ebx = 55 - subfunction number
2740
  * ebx = 55 - subfunction number
2788
  * esi = pointer to data
2741
  * esi = pointer to data
2789
Returned value:
2742
Returned value:
2790
  * eax = 0 - success
2743
  * eax = 0 - success
2791
  * eax = 55 - error (speaker is off or busy)
2744
  * eax = 55 - error (speaker is off or busy)
2792
Data is an array of items with variable length.
2745
Data is an array of items with variable length.
2793
Format of each item is defined by first byte:
2746
Format of each item is defined by first byte:
2794
  * 0 = end of data
2747
  * 0 = end of data
2795
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
2748
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
2796
    is defined by immediate value of frequency
2749
    is defined by immediate value of frequency
2797
    * following word (2 bytes) contains frequency divider;
2750
    * following word (2 bytes) contains frequency divider;
2798
      frequency is defined as 1193180/divider
2751
      frequency is defined as 1193180/divider
2799
  * 0x81 = invalid
2752
  * 0x81 = invalid
2800
  * 0x82..0xFF = note is defined by octave and number:
2753
  * 0x82..0xFF = note is defined by octave and number:
2801
    * duration in 1/100 of second = (first byte)-0x81
2754
    * duration in 1/100 of second = (first byte)-0x81
2802
    * there is one more byte;
2755
    * there is one more byte;
2803
    * (second byte)=0xFF - delay
2756
    * (second byte)=0xFF - delay
2804
    * otherwise it looks like a*0x10+b, where b=number of the note in
2757
    * otherwise it looks like a*0x10+b, where b=number of the note in
2805
      an octave from 1 to 12, a=number of octave (beginning from 0)
2758
      an octave from 1 to 12, a=number of octave (beginning from 0)
2806
Remarks:
2759
Remarks:
2807
  * Speaker play can be disabled/enabled by
2760
  * Speaker play can be disabled/enabled by
2808
    subfunction 8 of function 18.
2761
    subfunction 8 of function 18.
2809
  * Function returns control, having informed the system
2762
  * Function returns control, having informed the system
2810
    an information on request. Play itself goes independently from
2763
    an information on request. Play itself goes independently from
2811
    the program.
2764
    the program.
2812
  * The data must be kept in the memory at least up to the end
2765
  * The data must be kept in the memory at least up to the end
2813
    of play.
2766
    of play.
2814
 
2767
 
2815
======================================================================
2768
======================================================================
2816
======================= Function 57 - PCI BIOS. ======================
2769
======================= Function 57 - PCI BIOS. ======================
2817
======================================================================
2770
======================================================================
2818
Parameters:
2771
Parameters:
2819
  * eax = 57 - function number
2772
  * eax = 57 - function number
2820
  * ebp corresponds to al in PCI BIOS specification
2773
  * ebp corresponds to al in PCI BIOS specification
2821
  * other registers are set according to PCI BIOS specification
2774
  * other registers are set according to PCI BIOS specification
2822
Returned value:
2775
Returned value:
2823
  * CF is undefined
2776
  * CF is undefined
2824
  * other registers are set according to PCI BIOS specification
2777
  * other registers are set according to PCI BIOS specification
2825
Remarks:
2778
Remarks:
2826
  * Many effects of this function can be also achieved with
2779
  * Many effects of this function can be also achieved with
2827
    corresponding subfunctions of function 62.
2780
    corresponding subfunctions of function 62.
2828
  * The function calls PCI32 BIOS extension, documented e.g. in
2781
  * The function calls PCI32 BIOS extension, documented e.g. in
2829
    http://alpha1.dyns.net/files/PCI/bios21.pdf.
2782
    http://alpha1.dyns.net/files/PCI/bios21.pdf.
2830
  * If BIOS does not support this extension, its behavior is emulated
2783
  * If BIOS does not support this extension, its behavior is emulated
2831
    (through kernel-mode analogues of subfunctions of function 62).
2784
    (through kernel-mode analogues of subfunctions of function 62).
2832
 
2785
 
2833
======================================================================
2786
======================================================================
2834
================ Function 58 - work with file system. ================
2787
================ Function 58 - work with file system. ================
2835
======================================================================
2788
======================================================================
2836
Parameters:
2789
Parameters:
2837
  * eax = 58
2790
  * eax = 58
2838
  * ebx = pointer to the information structure
2791
  * ebx = pointer to the information structure
2839
Returned value:
2792
Returned value:
2840
  * eax = 0 - success; otherwise file system error code
2793
  * eax = 0 - success; otherwise file system error code
2841
  * some subfunctions return value in other registers too
2794
  * some subfunctions return value in other registers too
2842
General format of the information structure:
2795
General format of the information structure:
2843
  * +0: dword: subfunction number
2796
  * +0: dword: subfunction number
2844
  * +4: dword: number of block
2797
  * +4: dword: number of block
2845
  * +8: dword: size
2798
  * +8: dword: size
2846
  * +12 = +0xC: dword: pointer to data
2799
  * +12 = +0xC: dword: pointer to data
2847
  * +16 = +0x10: dword: pointer to a memory for system operations
2800
  * +16 = +0x10: dword: pointer to a memory for system operations
2848
    (4096 bytes)
2801
    (4096 bytes)
2849
  * +20 = +0x14: n db: ASCIIZ-string with the file name
2802
  * +20 = +0x14: n db: ASCIIZ-string with the file name
2850
Specifications - in documentation on the appropriate subfunction.
2803
Specifications - in documentation on the appropriate subfunction.
2851
Filename is case-insensitive for latin letters, russian letters
2804
Filename is case-insensitive for latin letters, russian letters
2852
must be capital.
2805
must be capital.
2853
Format of filename:
2806
Format of filename:
2854
/base/number/dir1/dir2/.../dirn/file,
2807
/base/number/dir1/dir2/.../dirn/file,
2855
where /base/number identifies device, on which file is located:
2808
where /base/number identifies device, on which file is located:
2856
one of
2809
one of
2857
  * /RD/1 = /RAMDISK/1 to access ramdisk
2810
  * /RD/1 = /RAMDISK/1 to access ramdisk
2858
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
2811
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
2859
    /FD/2 = /FLOPPYDISK/2 to access second one
2812
    /FD/2 = /FLOPPYDISK/2 to access second one
2860
  * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk
2813
  * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk
2861
    (in this case base is defined by subfunction 7 of function 21),
2814
    (in this case base is defined by subfunction 7 of function 21),
2862
    x - partition number (beginning from 1)
2815
    x - partition number (beginning from 1)
2863
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
2816
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
2864
    IDE0 (Primary Master), IDE1 (Primary Slave),
2817
    IDE0 (Primary Master), IDE1 (Primary Slave),
2865
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2818
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2866
    x - partition number on the selected hard drive, varies from 1
2819
    x - partition number on the selected hard drive, varies from 1
2867
    to 255 (on each hard drive the indexing starts from 1)
2820
    to 255 (on each hard drive the indexing starts from 1)
2868
Remarks:
2821
Remarks:
2869
  * In the first two cases it is also possible to use FIRST
2822
  * In the first two cases it is also possible to use FIRST
2870
    instead of 1, SECOND instead of 2, but it is not recommended
2823
    instead of 1, SECOND instead of 2, but it is not recommended
2871
    for convenience of transition to the future extensions.
2824
    for convenience of transition to the future extensions.
2872
  * Limitation n<=39 is imposed.
2825
  * Limitation n<=39 is imposed.
2873
  * Names of folders and file dir1,...,dirn,file must have the
2826
  * Names of folders and file dir1,...,dirn,file must have the
2874
    format 8.3: name no more than 8 characters, dot, extension no
2827
    format 8.3: name no more than 8 characters, dot, extension no
2875
    more than 3 characters. Trailing spaces are ignored, no other
2828
    more than 3 characters. Trailing spaces are ignored, no other
2876
    spaces is allowed. If name occupies equally 8 characters,
2829
    spaces is allowed. If name occupies equally 8 characters,
2877
    dot may be omitted (though it is not recommended to use this
2830
    dot may be omitted (though it is not recommended to use this
2878
    feature for convenience of transition to the future extensions).
2831
    feature for convenience of transition to the future extensions).
2879
  * This function does not support folders on ramdisk.
2832
  * This function does not support folders on ramdisk.
2880
Examples:
2833
Examples:
2881
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2834
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2882
    '/rd/1/kernel.asm',0
2835
    '/rd/1/kernel.asm',0
2883
  * '/HD0/1/kernel.asm',0
2836
  * '/HD0/1/kernel.asm',0
2884
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2837
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2885
Existing subfunctions:
2838
Existing subfunctions:
2886
  * subfunction 0 - read file/folder
2839
  * subfunction 0 - read file/folder
2887
  * subfunction 8 - LBA-read from device
2840
  * subfunction 8 - LBA-read from device
2888
  * subfunction 15 - get file system information
2841
  * subfunction 15 - get file system information
2889
 
2842
 
2890
======================================================================
2843
======================================================================
2891
=========== Function 58, subfunction 0 - read file/folder. ===========
2844
=========== Function 58, subfunction 0 - read file/folder. ===========
2892
======================================================================
2845
======================================================================
2893
Parameters:
2846
Parameters:
2894
  * eax = 58
2847
  * eax = 58
2895
  * ebx = pointer to the information structure
2848
  * ebx = pointer to the information structure
2896
Format of the information structure:
2849
Format of the information structure:
2897
  * +0: dword: 0 = subfunction number
2850
  * +0: dword: 0 = subfunction number
2898
  * +4: dword: first block to read (beginning from 0)
2851
  * +4: dword: first block to read (beginning from 0)
2899
  * +8: dword: amount of blocks to read
2852
  * +8: dword: amount of blocks to read
2900
  * +12 = +0xC: dword: pointer to buffer for data
2853
  * +12 = +0xC: dword: pointer to buffer for data
2901
  * +16 = +0x10: dword: pointer to buffer for system operations
2854
  * +16 = +0x10: dword: pointer to buffer for system operations
2902
    (4096 bytes)
2855
    (4096 bytes)
2903
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
2856
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
2904
    given in the general description
2857
    given in the general description
2905
Returned value:
2858
Returned value:
2906
  * eax = 0 - success, otherwise file system error code
2859
  * eax = 0 - success, otherwise file system error code
2907
  * ebx = file size (in bytes) or -1=0xffffffff, if file was not found
2860
  * ebx = file size (in bytes) or -1=0xffffffff, if file was not found
2908
Remarks:
2861
Remarks:
2909
  * Block size is 512 bytes.
2862
  * Block size is 512 bytes.
2910
  * This function is obsolete, for reading files use subfunction 0
2863
  * This function is obsolete, for reading files use subfunction 0
2911
    of function 70, for reading folders - subfunction 1 of
2864
    of function 70, for reading folders - subfunction 1 of
2912
    function 70.
2865
    function 70.
2913
  * Function can read contents of a folder. Only FAT file system is
2866
  * Function can read contents of a folder. Only FAT file system is
2914
    supported. The format of FAT-folder is described
2867
    supported. The format of FAT-folder is described
2915
    in any FAT documentation.
2868
    in any FAT documentation.
2916
  * Size of a folder is determined by size of FAT clusters chain.
2869
  * Size of a folder is determined by size of FAT clusters chain.
2917
  * If file was ended before last requested block was read,
2870
  * If file was ended before last requested block was read,
2918
    the function will read as many as it can, and after that return
2871
    the function will read as many as it can, and after that return
2919
    eax=6 (EOF).
2872
    eax=6 (EOF).
2920
  * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but
2873
  * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but
2921
    in the first two cases the current implementation does not follow
2874
    in the first two cases the current implementation does not follow
2922
    to the declared rules:
2875
    to the declared rules:
2923
    for /rd/1:
2876
    for /rd/1:
2924
    * if one want to read 0 blocks, function considers,
2877
    * if one want to read 0 blocks, function considers,
2925
      that he requested 1;
2878
      that he requested 1;
2926
    * if one requests more than 14 blocks or starting block is
2879
    * if one requests more than 14 blocks or starting block is
2927
      not less than 14, function returns eax=5 (not found) è ebx=-1;
2880
      not less than 14, function returns eax=5 (not found) è ebx=-1;
2928
    * size of ramdisk root folder is 14 blocks,
2881
    * size of ramdisk root folder is 14 blocks, 
2929
      0x1C00=7168 áàéò; but function returns ebx=0
2882
      0x1C00=7168 áàéò; but function returns ebx=0
2930
      (except of the case of previous item);
2883
      (except of the case of previous item);
2931
    * strangely enough, it is possible to read 14th block (which
2884
    * strangely enough, it is possible to read 14th block (which
2932
      generally contains a garbage - I remind, the indexing begins
2885
      generally contains a garbage - I remind, the indexing begins
2933
      from 0);
2886
      from 0);
2934
    * if some block with the number not less than 14 was requested,
2887
    * if some block with the number not less than 14 was requested,
2935
      function returns eax=6(EOF); otherwise eax=0.
2888
      function returns eax=6(EOF); otherwise eax=0.
2936
    For /fd/x:
2889
    For /fd/x:
2937
    * if the start block is not less than 14, function returns
2890
    * if the start block is not less than 14, function returns
2938
      eax=5 (not found) and ebx=0;
2891
      eax=5 (not found) and ebx=0;
2939
    * note that format of FAT12 allows floppies with the root size
2892
    * note that format of FAT12 allows floppies with the root size
2940
      more or less than 14 blocks;
2893
      more or less than 14 blocks;
2941
    * check for length is not performed;
2894
    * check for length is not performed;
2942
    * if data was successful read, function returns
2895
    * if data was successful read, function returns
2943
      eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1.
2896
      eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1.
2944
  * The function handles reading of special folders /,/rd,/fd,/hd[n];
2897
  * The function handles reading of special folders /,/rd,/fd,/hd[n];
2945
    but the result does not correspond to expected (on operations with
2898
    but the result does not correspond to expected (on operations with
2946
    normal files/folders), does not follow the declared rules,
2899
    normal files/folders), does not follow the declared rules,
2947
    may be changed in future versions of the kernel and consequently
2900
    may be changed in future versions of the kernel and consequently
2948
    is not described. To obtain the information about the equipment
2901
    is not described. To obtain the information about the equipment
2949
    use subfunction 11 of function 18 or
2902
    use subfunction 11 of function 18 or
2950
    read corresponding folder with subfunction 1 of function 70.
2903
    read corresponding folder with subfunction 1 of function 70.
2951
 
2904
 
2952
======================================================================
2905
======================================================================
2953
========= Function 58, subfunction 8 - LBA-read from device. =========
2906
========= Function 58, subfunction 8 - LBA-read from device. =========
2954
======================================================================
2907
======================================================================
2955
Parameters:
2908
Parameters:
2956
  * eax = 58 - function number
2909
  * eax = 58 - function number
2957
  * ebx = pointer to the information structure
2910
  * ebx = pointer to the information structure
2958
Format of the information structure:
2911
Format of the information structure:
2959
  * +0: dword: 8 = subfunction number
2912
  * +0: dword: 8 = subfunction number
2960
  * +4: dword: number of block to read (beginning from 0)
2913
  * +4: dword: number of block to read (beginning from 0)
2961
  * +8: dword: ignored (set to 1)
2914
  * +8: dword: ignored (set to 1)
2962
  * +12 = +0xC: dword: pointer to buffer for data (512 bytes)
2915
  * +12 = +0xC: dword: pointer to buffer for data (512 bytes)
2963
  * +16 = +0x10: dword: pointer to buffer for system operations
2916
  * +16 = +0x10: dword: pointer to buffer for system operations
2964
    (4096 bytes)
2917
    (4096 bytes)
2965
  * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of
2918
  * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of
2966
    /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
2919
    /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
2967
    1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3.
2920
    1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3.
2968
    Instead of digits it is allowed, though not recommended for
2921
    Instead of digits it is allowed, though not recommended for
2969
    convenience of transition to future extensions, to use
2922
    convenience of transition to future extensions, to use
2970
    'first','second','third','fourth'.
2923
    'first','second','third','fourth'.
2971
Returned value:
2924
Returned value:
2972
  * for device name /hd/xxx, where xxx is not in the list above:
2925
  * for device name /hd/xxx, where xxx is not in the list above:
2973
    * eax = ebx = 1
2926
    * eax = ebx = 1
2974
  * for invalid device name (except for the previous case):
2927
  * for invalid device name (except for the previous case):
2975
    * eax = 5
2928
    * eax = 5
2976
    * ebx does not change
2929
    * ebx does not change
2977
  * if LBA-access is disabled by subfunction 11 of function 21:
2930
  * if LBA-access is disabled by subfunction 11 of function 21:
2978
    * eax = 2
2931
    * eax = 2
2979
    * ebx destroyed
2932
    * ebx destroyed
2980
  * for ramdisk: attempt to read block outside ramdisk
2933
  * for ramdisk: attempt to read block outside ramdisk
2981
    (18*2*80 blocks) results in
2934
    (18*2*80 blocks) results in
2982
    * eax = 3
2935
    * eax = 3
2983
    * ebx = 0
2936
    * ebx = 0
2984
  * for successful read:
2937
  * for successful read:
2985
    * eax = ebx = 0
2938
    * eax = ebx = 0
2986
Remarks:
2939
Remarks:
2987
  * Block size is 512 bytes; function reads one block.
2940
  * Block size is 512 bytes; function reads one block.
2988
  * Do not depend on returned value, it can be changed
2941
  * Do not depend on returned value, it can be changed
2989
    in future versions.
2942
    in future versions.
2990
  * Function requires that LBA-access to devices is enabled by
2943
  * Function requires that LBA-access to devices is enabled by 
2991
    subfunction 11 of function 21. To check this one can use
2944
    subfunction 11 of function 21. To check this one can use 
2992
    subfunction 11 of function 26.
2945
    subfunction 11 of function 26.
2993
  * LBA-read of floppy is not supported.
2946
  * LBA-read of floppy is not supported.
2994
  * Function reads data on physical hard drive; if for any reason
2947
  * Function reads data on physical hard drive; if for any reason
2995
    data of the concrete partition are required, application must
2948
    data of the concrete partition are required, application must
2996
    define starting sector of this partition (either directly
2949
    define starting sector of this partition (either directly
2997
    through MBR, or from the full structure returned by
2950
    through MBR, or from the full structure returned by
2998
    ïîäôóíêöèåé 11 ôóíêöèè 18).
2951
    ïîäôóíêöèåé 11 ôóíêöèè 18).
2999
  * Function does not check error code of hard disk, so request of
2952
  * Function does not check error code of hard disk, so request of
3000
    nonexisting sector reads something (most probably it will be
2953
    nonexisting sector reads something (most probably it will be
3001
    zeroes, but this is defined by device) and this is considered
2954
    zeroes, but this is defined by device) and this is considered
3002
    as success (eax=0).
2955
    as success (eax=0).
3003
 
2956
 
3004
======================================================================
2957
======================================================================
3005
==== Function 58, subfunction 15 - get information on file system. ===
2958
==== Function 58, subfunction 15 - get information on file system. ===
3006
======================================================================
2959
======================================================================
3007
Parameters:
2960
Parameters:
3008
  * eax = 58 - function number
2961
  * eax = 58 - function number
3009
  * ebx = pointer to the information structure
2962
  * ebx = pointer to the information structure
3010
Format of the information structure:
2963
Format of the information structure:
3011
  * +0: dword: 15 = subfunction number
2964
  * +0: dword: 15 = subfunction number
3012
  * +4: dword: ignored
2965
  * +4: dword: ignored
3013
  * +8: dword: ignored
2966
  * +8: dword: ignored
3014
  * +12 = +0xC: dword: ignored
2967
  * +12 = +0xC: dword: ignored
3015
  * +16 = +0x10: dword: ignored
2968
  * +16 = +0x10: dword: ignored
3016
  * +20 = +0x14: (only second character is checked)
2969
  * +20 = +0x14: (only second character is checked)
3017
    /rd=/RAMDISK or /hd=/HARDDISK
2970
    /rd=/RAMDISK or /hd=/HARDDISK
3018
Returned value:
2971
Returned value:
3019
  * if the second character does not belong to set {'r','R','h','H'}:
2972
  * if the second character does not belong to set {'r','R','h','H'}:
3020
    * eax = 3
2973
    * eax = 3
3021
    * ebx = ecx = dword [fileinfo] = 0
2974
    * ebx = ecx = dword [fileinfo] = 0
3022
  * for ramdisk:
2975
  * for ramdisk:
3023
    * eax = 0 (success)
2976
    * eax = 0 (success)
3024
    * ebx = total number of clusters = 2847
2977
    * ebx = total number of clusters = 2847
3025
    * ecx = number of free clusters
2978
    * ecx = number of free clusters
3026
    * dword [fileinfo] = cluster size = 512
2979
    * dword [fileinfo] = cluster size = 512
3027
  * for hard disk: base and partition are defined by subfunctions
2980
  * for hard disk: base and partition are defined by subfunctions
3028
    7 and 8 of function 21:
2981
    7 and 8 of function 21:
3029
    * eax = 0 (success)
2982
    * eax = 0 (success)
3030
    * ebx = total number of clusters
2983
    * ebx = total number of clusters
3031
    * ecx = number of free clusters
2984
    * ecx = number of free clusters
3032
    * dword [fileinfo] = cluster size (in bytes)
2985
    * dword [fileinfo] = cluster size (in bytes)
3033
Remarks:
2986
Remarks:
3034
  * Be not surprised to strange layout of 4th returned parameter
2987
  * Be not surprised to strange layout of 4th returned parameter
3035
    - when this code was writing, at system calls application got
2988
    - when this code was writing, at system calls application got
3036
    only registers eax,ebx,ecx (from pushad-structure transmitted
2989
    only registers eax,ebx,ecx (from pushad-structure transmitted
3037
    as argument to the system function). Now it is corrected, so,
2990
    as argument to the system function). Now it is corrected, so,
3038
    probably, it is meaningful to return cluster size in edx, while
2991
    probably, it is meaningful to return cluster size in edx, while
3039
    this function is not used yet.
2992
    this function is not used yet.
3040
  * There exists also subfunction 11 of function 18,
2993
  * There exists also subfunction 11 of function 18,
3041
    which returns information on file system. From the full table
2994
    which returns information on file system. From the full table
3042
    of disk subsystem it is possible to deduce cluster size (there
2995
    of disk subsystem it is possible to deduce cluster size (there
3043
    it is stored in sectors) and total number of clusters
2996
    it is stored in sectors) and total number of clusters
3044
    for hard disks.
2997
    for hard disks.
3045
 
2998
 
3046
======================================================================
2999
======================================================================
3047
========== Function 60 - Inter Process Communication (IPC). ==========
3000
========== Function 60 - Inter Process Communication (IPC). ==========
3048
======================================================================
3001
======================================================================
3049
IPC is used for message dispatching from one process/thread to
3002
IPC is used for message dispatching from one process/thread to
3050
another. Previously it is necessary to agree how to interpret
3003
another. Previously it is necessary to agree how to interpret
3051
the concrete message.
3004
the concrete message.
3052
 
3005
 
3053
----------- Subfunction 1 - set the area for IPC receiving -----------
3006
----------- Subfunction 1 - set the area for IPC receiving -----------
3054
Is called by process-receiver.
3007
Is called by process-receiver.
3055
Parameters:
3008
Parameters:
3056
  * eax = 60 - function number
3009
  * eax = 60 - function number
3057
  * ebx = 1 - subfunction number
3010
  * ebx = 1 - subfunction number
3058
  * ecx = pointer to the buffer
3011
  * ecx = pointer to the buffer
3059
  * edx = size of the buffer
3012
  * edx = size of the buffer
3060
Returned value:
3013
Returned value:
3061
  * eax = 0 - always success
3014
  * eax = 0 - always success
3062
Format of IPC-buffer:
3015
Format of IPC-buffer:
3063
  * +0: dword: if nonzero, buffer is considered locked;
3016
  * +0: dword: if nonzero, buffer is considered locked;
3064
    lock/unlock the buffer, when you work with it and need that
3017
    lock/unlock the buffer, when you work with it and need that
3065
    buffer data are not changed from outside (no new messages)
3018
    buffer data are not changed from outside (no new messages)
3066
  * +4: dword: occupied place in the buffer (in bytes)
3019
  * +4: dword: occupied place in the buffer (in bytes)
3067
  * +8: first message
3020
  * +8: first message
3068
  * +8+n: second message
3021
  * +8+n: second message
3069
  * ...
3022
  * ...
3070
Format of a message:
3023
Format of a message:
3071
  * +0: dword: PID of sender
3024
  * +0: dword: PID of sender
3072
  * +4: dword: message length (not including this header)
3025
  * +4: dword: message length (not including this header)
3073
  * +8: n*byte: message data
3026
  * +8: n*byte: message data
3074
 
3027
 
3075
------------------ Subfunction 2 - send IPC message ------------------
3028
------------------ Subfunction 2 - send IPC message ------------------
3076
Is called by process-sender.
3029
Is called by process-sender.
3077
Parameters:
3030
Parameters:
3078
  * eax = 60 - function number
3031
  * eax = 60 - function number
3079
  * ebx = 2 - subfunction number
3032
  * ebx = 2 - subfunction number
3080
  * ecx = PID of receiver
3033
  * ecx = PID of receiver
3081
  * edx = pointer to the message data
3034
  * edx = pointer to the message data
3082
  * esi = message length (in bytes)
3035
  * esi = message length (in bytes)
3083
Returned value:
3036
Returned value:
3084
  * eax = 0 - success
3037
  * eax = 0 - success
3085
  * eax = 1 - the receiver has not defined buffer for IPC messages
3038
  * eax = 1 - the receiver has not defined buffer for IPC messages
3086
    (can be, still have no time,
3039
    (can be, still have no time,
3087
    and can be, this is not right process)
3040
    and can be, this is not right process)
3088
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
3041
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
3089
  * eax = 3 - overflow of IPC-buffer of the receiver
3042
  * eax = 3 - overflow of IPC-buffer of the receiver
3090
  * eax = 4 - process/thread with such PID does not exist
3043
  * eax = 4 - process/thread with such PID does not exist
3091
Remarks:
3044
Remarks:
3092
  * Immediately after writing of IPC-message to the buffer the system
3045
  * Immediately after writing of IPC-message to the buffer the system
3093
    sends to the receiver the event with code 7 (see event codes).
3046
    sends to the receiver the event with code 7 (see event codes).
3094
 
3047
 
3095
======================================================================
3048
======================================================================
3096
==== Function 61 - get parameters for the direct graphics access. ====
3049
==== Function 61 - get parameters for the direct graphics access. ====
3097
======================================================================
3050
======================================================================
3098
The data of the graphics screen (the memory area which displays
3051
The data of the graphics screen (the memory area which displays
3099
screen contents) are accessible to a program directly, without
3052
screen contents) are accessible to a program directly, without
3100
any system calls, through the selector gs:
3053
any system calls, through the selector gs:
3101
        mov     eax, [gs:0]
3054
	mov	eax, [gs:0]
3102
places in eax the first dword of the buffer, which contains
3055
places in eax the first dword of the buffer, which contains
3103
information on color of the left upper point (and, possibly, colors
3056
information on color of the left upper point (and, possibly, colors
3104
of several following).
3057
of several following).
3105
        mov     [gs:0], eax
3058
	mov	[gs:0], eax
3106
by work in VESA modes with LFB sets color of the left upper point
3059
by work in VESA modes with LFB sets color of the left upper point
3107
(and, possibly, colors of several following).
3060
(and, possibly, colors of several following).
3108
To interpret the data of graphics screen program needs to know
3061
To interpret the data of graphics screen program needs to know
3109
some parameters, returning by this function.
3062
some parameters, returning by this function.
3110
Remarks:
3063
Remarks:
3111
  * Graphics parameters changes very seldom at work,
3064
  * Graphics parameters changes very seldom at work,
3112
    namely, only in cases, when user works with the application VRR.
3065
    namely, only in cases, when user works with the application VRR.
3113
  * At videomode change the system redraws all windows (event
3066
  * At videomode change the system redraws all windows (event
3114
    with code 1) and redraws the background (event 5).
3067
    with code 1) and redraws the background (event 5).
3115
    Same events occur in other cases too, which meet much more often,
3068
    Same events occur in other cases too, which meet much more often,
3116
    than videomode change.
3069
    than videomode change.
3117
  * By operation in videomodes with LFB the selector gs points to
3070
  * By operation in videomodes with LFB the selector gs points to
3118
    LFB itself, so reading/writing on gs result directly in
3071
    LFB itself, so reading/writing on gs result directly in
3119
    change of screen contents. By operation in videomodes without
3072
    change of screen contents. By operation in videomodes without
3120
    LFB gs points to some data area in the kernel, and all functions
3073
    LFB gs points to some data area in the kernel, and all functions
3121
    of screen output fulfil honesty double operation on writing
3074
    of screen output fulfil honesty double operation on writing
3122
    directly to the screen and writing to this buffer. In result
3075
    directly to the screen and writing to this buffer. In result
3123
    at reading contents of this buffer the results correspond to
3076
    at reading contents of this buffer the results correspond to
3124
    screen contents (with, generally speaking, large color
3077
    screen contents (with, generally speaking, large color
3125
    resolution), and writing is ignored.
3078
    resolution), and writing is ignored.
3126
    One exception is the mode 320*200, for which main loop of the
3079
    One exception is the mode 320*200, for which main loop of the
3127
    system thread updates the screen according to mouse movements.
3080
    system thread updates the screen according to mouse movements.
3128
 
3081
 
3129
------------------------- Screen resolution --------------------------
3082
------------------------- Screen resolution --------------------------
3130
Parameters:
3083
Parameters:
3131
  * eax = 61 - function number
3084
  * eax = 61 - function number
3132
  * ebx = 1 - subfunction number
3085
  * ebx = 1 - subfunction number
3133
Returned value:
3086
Returned value:
3134
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
3087
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
3135
Remarks:
3088
Remarks:
3136
  * One can use function 14 paying attention that
3089
  * One can use function 14 paying attention that
3137
    it returns sizes on 1 pixel less. It is fully equivalent way.
3090
    it returns sizes on 1 pixel less. It is fully equivalent way.
3138
 
3091
 
3139
---------------------- Number of bits per pixel ----------------------
3092
---------------------- Number of bits per pixel ----------------------
3140
Parameters:
3093
Parameters:
3141
  * eax = 61 - function number
3094
  * eax = 61 - function number
3142
  * ebx = 2 - subfunction number
3095
  * ebx = 2 - subfunction number
3143
Returned value:
3096
Returned value:
3144
  * eax = number of bits per pixel (24 or 32)
3097
  * eax = number of bits per pixel (24 or 32)
3145
 
3098
 
3146
-------------------- Number of bytes per scanline --------------------
3099
-------------------- Number of bytes per scanline --------------------
3147
Parameters:
3100
Parameters:
3148
  * eax = 61 - function number
3101
  * eax = 61 - function number
3149
  * ebx = 3 - subfunction number
3102
  * ebx = 3 - subfunction number
3150
Returned value:
3103
Returned value:
3151
  * eax = number of bytes occupied by one scanline
3104
  * eax = number of bytes occupied by one scanline
3152
    (horizontal line on the screen)
3105
    (horizontal line on the screen)
3153
 
3106
 
3154
======================================================================
3107
======================================================================
3155
===== Function 62, subfunction 0 - get version of PCI-interface. =====
3108
===== Function 62, subfunction 0 - get version of PCI-interface. =====
3156
======================================================================
3109
======================================================================
3157
Parameters:
3110
Parameters:
3158
  * eax = 62 - function number
3111
  * eax = 62 - function number
3159
  * bl = 0 - subfunction number
3112
  * bl = 0 - subfunction number
3160
Returned value:
3113
Returned value:
3161
  * eax = -1 - PCI access is disabled; otherwise
3114
  * eax = -1 - PCI access is disabled; otherwise
3162
  * ah.al = version of PCI-interface (ah=version, al=subversion)
3115
  * ah.al = version of PCI-interface (ah=version, al=subversion)
3163
  * high word of eax is zeroed
3116
  * high word of eax is zeroed
3164
Remarks:
3117
Remarks:
3165
  * Previously low-level access to PCI for applications must be
3118
  * Previously low-level access to PCI for applications must be
3166
    enabled by subfunction 12 of function 21.
3119
    enabled by subfunction 12 of function 21.
3167
  * If PCI BIOS is not supported, the value of ax is undefined.
3120
  * If PCI BIOS is not supported, the value of ax is undefined.
3168
 
3121
 
3169
======================================================================
3122
======================================================================
3170
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
3123
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
3171
======================================================================
3124
======================================================================
3172
Parameters:
3125
Parameters:
3173
  * eax = 62 - function number
3126
  * eax = 62 - function number
3174
  * bl = 1 - subfunction number
3127
  * bl = 1 - subfunction number
3175
Returned value:
3128
Returned value:
3176
  * eax = -1 - access to PCI is disabled; otherwise
3129
  * eax = -1 - access to PCI is disabled; otherwise
3177
  * al = number of the last PCI-bus; other bytes of eax are destroyed
3130
  * al = number of the last PCI-bus; other bytes of eax are destroyed
3178
Remarks:
3131
Remarks:
3179
  * Previously low-level access to PCI for applications must be
3132
  * Previously low-level access to PCI for applications must be
3180
    enabled by subfunction 12 of function 21.
3133
    enabled by subfunction 12 of function 21.
3181
  * If PCI BIOS is not supported, the value of ax is undefined.
3134
  * If PCI BIOS is not supported, the value of ax is undefined.
3182
 
3135
 
3183
======================================================================
3136
======================================================================
3184
===================== Function 62, subfunction 2 =====================
3137
===================== Function 62, subfunction 2 =====================
3185
===== Get mechanism of addressing to the PCI configuration space. ====
3138
===== Get mechanism of addressing to the PCI configuration space. ====
3186
======================================================================
3139
======================================================================
3187
Parameters:
3140
Parameters:
3188
  * eax = 62 - function number
3141
  * eax = 62 - function number
3189
  * bl = 2 - subfunction number
3142
  * bl = 2 - subfunction number
3190
Returned value:
3143
Returned value:
3191
  * eax = -1 - access to PCI is disabled; otherwise
3144
  * eax = -1 - access to PCI is disabled; otherwise
3192
  * al = mechanism (1 or 2); other bytes of eax are destroyed
3145
  * al = mechanism (1 or 2); other bytes of eax are destroyed
3193
Remarks:
3146
Remarks:
3194
  * Previously low-level access to PCI for applications must be
3147
  * Previously low-level access to PCI for applications must be
3195
    enabled by subfunction 12 of function 21.
3148
    enabled by subfunction 12 of function 21.
3196
  * Addressing mechanism is selected depending on
3149
  * Addressing mechanism is selected depending on
3197
    equipment characteristics.
3150
    equipment characteristics.
3198
  * Subfunctions of read and write work automatically
3151
  * Subfunctions of read and write work automatically
3199
    with the selected mechanism.
3152
    with the selected mechanism.
3200
 
3153
 
3201
======================================================================
3154
======================================================================
3202
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
3155
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
3203
======================================================================
3156
======================================================================
3204
Parameters:
3157
Parameters:
3205
  * eax = 62 - function number
3158
  * eax = 62 - function number
3206
  * bl = 4 - read byte
3159
  * bl = 4 - read byte
3207
  * bl = 5 - read word
3160
  * bl = 5 - read word
3208
  * bl = 6 - read dword
3161
  * bl = 6 - read dword
3209
  * bh = number of PCI-bus
3162
  * bh = number of PCI-bus
3210
  * ch = dddddfff, where ddddd = number of the device on the bus,
3163
  * ch = dddddfff, where ddddd = number of the device on the bus,
3211
    fff = function number of device
3164
    fff = function number of device
3212
  * cl = number of register (must be even for bl=5,
3165
  * cl = number of register (must be even for bl=5,
3213
    divisible by 4 for bl=6)
3166
    divisible by 4 for bl=6)
3214
Returned value:
3167
Returned value:
3215
  * eax = -1 - error (access to PCI is disabled or parameters
3168
  * eax = -1 - error (access to PCI is disabled or parameters
3216
    are not supported); otherwise
3169
    are not supported); otherwise
3217
  * al/ax/eax (depending on requested size) contains the data;
3170
  * al/ax/eax (depending on requested size) contains the data;
3218
    the other part of register eax is destroyed
3171
    the other part of register eax is destroyed
3219
Remarks:
3172
Remarks:
3220
  * Previously low-level access to PCI for applications must be
3173
  * Previously low-level access to PCI for applications must be
3221
    enabled by subfunction 12 of function 21.
3174
    enabled by subfunction 12 of function 21.
3222
  * Access mechanism 2 supports only 16 devices on a bus and ignores
3175
  * Access mechanism 2 supports only 16 devices on a bus and ignores
3223
    function number. To get access mechanism use subfunction 2.
3176
    function number. To get access mechanism use subfunction 2.
3224
  * Some registers are standard and exist for all devices, some are
3177
  * Some registers are standard and exist for all devices, some are
3225
    defined by the concrete device. The list of registers of the
3178
    defined by the concrete device. The list of registers of the
3226
    first type can be found e.g. in famous
3179
    first type can be found e.g. in famous
3227
    Interrupt List by Ralf Brown
3180
    Interrupt List by Ralf Brown
3228
    (http://www.pobox.com/~ralf/files.html,
3181
    (http://www.pobox.com/~ralf/files.html,
3229
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3182
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3230
    registers of the second type must be listed
3183
    registers of the second type must be listed
3231
    in the device documentation.
3184
    in the device documentation.
3232
 
3185
 
3233
======================================================================
3186
======================================================================
3234
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
3187
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
3235
======================================================================
3188
======================================================================
3236
Parameters:
3189
Parameters:
3237
  * eax = 62 - function number
3190
  * eax = 62 - function number
3238
  * bl = 8 - write byte
3191
  * bl = 8 - write byte
3239
  * bl = 9 - write word
3192
  * bl = 9 - write word
3240
  * bl = 10 - write dword
3193
  * bl = 10 - write dword
3241
  * bh = number of PCI-bus
3194
  * bh = number of PCI-bus
3242
  * ch = dddddfff, where ddddd = number of the device on the bus,
3195
  * ch = dddddfff, where ddddd = number of the device on the bus,
3243
    fff = function number of device
3196
    fff = function number of device
3244
  * cl = number of register (must be even for bl=9,
3197
  * cl = number of register (must be even for bl=9,
3245
    divisible by 4 for bl=10)
3198
    divisible by 4 for bl=10)
3246
  * dl/dx/edx (depending on requested size) contatins
3199
  * dl/dx/edx (depending on requested size) contatins
3247
    the data to write
3200
    the data to write
3248
Returned value:
3201
Returned value:
3249
  * eax = -1 - error (access to PCI is disabled or parameters
3202
  * eax = -1 - error (access to PCI is disabled or parameters
3250
    are not supported)
3203
    are not supported)
3251
  * eax = 0 - success
3204
  * eax = 0 - success
3252
Remarks:
3205
Remarks:
3253
  * Previously low-level access to PCI for applications must be
3206
  * Previously low-level access to PCI for applications must be
3254
    enabled by subfunction 12 of function 21.
3207
    enabled by subfunction 12 of function 21.
3255
  * Access mechanism 2 supports only 16 devices on a bus and ignores
3208
  * Access mechanism 2 supports only 16 devices on a bus and ignores
3256
    function number. To get access mechanism use subfunction 2.
3209
    function number. To get access mechanism use subfunction 2.
3257
  * Some registers are standard and exist for all devices, some are
3210
  * Some registers are standard and exist for all devices, some are
3258
    defined by the concrete device. The list of registers of the
3211
    defined by the concrete device. The list of registers of the
3259
    first type can be found e.g. in famous Interrupt List by
3212
    first type can be found e.g. in famous Interrupt List by
3260
    Ralf Brown; registers of the second type must be listed
3213
    Ralf Brown; registers of the second type must be listed
3261
    in the device documentation.
3214
    in the device documentation.
3262
 
3215
 
3263
======================================================================
3216
======================================================================
3264
===================== Function 62, subfunction 11 ====================
-
 
3265
==              Initialize user-accessible MMIO channel             ==
-
 
3266
======================================================================
-
 
3267
Parameters:
-
 
3268
  * eax = 62 - function
-
 
3269
  * bl  = 11 - subfunction
-
 
3270
  * cx  = PCI-address (bbbbbbbb dddddfff) 
-
 
3271
Returns:
-
 
3272
  * eax = -1 - PCI access not granted; 
-
 
3273
  * eax = -2 - no user MMIO access to this PCI address; 
-
 
3274
  * eax = -3 - memory allocation error; otherwise
-
 
3275
  * eax = available user heap size.
-
 
3276
Remarks:
-
 
3277
  * Low-level PCI access must be allowed (fn21:12)
-
 
3278
  * PCI-address should correspond the system var [mmio_pci_addr]
-
 
3279
 
-
 
3280
======================================================================
-
 
3281
===================== Function 62, subfunction 12 ====================
-
 
3282
==            Request user-accessible MMIO address space            ==
-
 
3283
======================================================================
-
 
3284
Parameters:
-
 
3285
  * eax = 62 - function
-
 
3286
  * bl  = 12 - subfunction
-
 
3287
  * bh  = BAR number in PCI configuration space
-
 
3288
  * ecx = MMIO-block size needed (bytes)
-
 
3289
  * edx = MMIO-offset (number of whole 4Kb-pages!)
-
 
3290
Returns:
-
 
3291
  * eax = -1 - user PCI access denied; 
-
 
3292
  * eax = -2 - invalid BAR number; 
-
 
3293
  * eax = -3 - BAR contains no valid IO addres;
-
 
3294
  * eax = -4 - BAR addresses IO ports;
-
 
3295
  * eax = -5 - dynamic allocation error; otherwise
-
 
3296
  * eax = MMIO start address (in application's linear space).
-
 
3297
Remarks:
-
 
3298
  * Low-level PCI access must be allowed (fn21:12)
-
 
3299
  * The system var [mmio_pci_addr] sets the actual PCI-address
-
 
3300
  * The granted MMIO addresses should be released after use (fn62:13)
-
 
3301
 
-
 
3302
======================================================================
-
 
3303
===================== Function 62, subfunction 13 ====================
-
 
3304
==              Release a block of user MMIO addresses              ==
-
 
3305
======================================================================
-
 
3306
 à ¬¥âàë:
-
 
3307
  * eax = 62 - function
-
 
3308
  * bl  = 12 - subfunction
-
 
3309
  * ecx = MMIO start address (in application's linear space).
-
 
3310
Returns:
-
 
3311
  * eax = 1 if the block is successfully released; 
-
 
3312
  * eax = 0 in case of reallocation error; 
-
 
3313
Remarks:
-
 
3314
  * A valid uMMIO block should exist at this address (fn62:12)
-
 
3315
 
-
 
3316
======================================================================
-
 
3317
============== Function 63 - work with the debug board. ==============
3217
============== Function 63 - work with the debug board. ==============
3318
======================================================================
3218
======================================================================
3319
The debug board is the global system buffer (with the size
3219
The debug board is the global system buffer (with the size
3320
1024 bytes), to which any program can write (generally speaking,
3220
1024 bytes), to which any program can write (generally speaking,
3321
arbitrary) data and from which other program can read these data.
3221
arbitrary) data and from which other program can read these data.
3322
By the agreement written data are text strings interpreted as
3222
By the agreement written data are text strings interpreted as
3323
debug messages on a course of program execution. The kernel in
3223
debug messages on a course of program execution. The kernel in
3324
some situations also writes to the debug board information on
3224
some situations also writes to the debug board information on
3325
execution of some functions; by the agreement kernel messages
3225
execution of some functions; by the agreement kernel messages
3326
begins from the prefix "K : ".
3226
begins from the prefix "K : ".
3327
For view of the debug board the application 'board' was created,
3227
For view of the debug board the application 'board' was created,
3328
which reads data from the buffer and displays them in its window.
3228
which reads data from the buffer and displays them in its window.
3329
'board' interpretes the sequence of codes 13,10 as newline.
3229
'board' interpretes the sequence of codes 13,10 as newline.
3330
A character with null code in an end of line is not necessary,
3230
A character with null code in an end of line is not necessary,
3331
but also does not prevent.
3231
but also does not prevent.
3332
Because debugger has been written, the value of the debug board
3232
Because debugger has been written, the value of the debug board
3333
has decreased, as debugger allows to inspect completely a course of
3233
has decreased, as debugger allows to inspect completely a course of
3334
program execution without any efforts from the direction of program
3234
program execution without any efforts from the direction of program
3335
itself. Nevertheless in some cases the debug board is still useful.
3235
itself. Nevertheless in some cases the debug board is still useful.
3336
 
3236
 
3337
----------------------------- Write byte -----------------------------
3237
----------------------------- Write byte -----------------------------
3338
Parameters:
3238
Parameters:
3339
  * eax = 63 - function number
3239
  * eax = 63 - function number
3340
  * ebx = 1 - subfunction number
3240
  * ebx = 1 - subfunction number
3341
  * cl = data byte
3241
  * cl = data byte
3342
Returned value:
3242
Returned value:
3343
  * function does not return value
3243
  * function does not return value
3344
Remarks:
3244
Remarks:
3345
  * Byte is written to the buffer. Buffer size is 512 bytes.
3245
  * Byte is written to the buffer. Buffer size is 512 bytes.
3346
    At buffer overflow all obtained data are lost.
3246
    At buffer overflow all obtained data are lost.
3347
  * For output to the debug board of more complicated objects
3247
  * For output to the debug board of more complicated objects
3348
    (strings, numbers) it is enough to call this function in cycle.
3248
    (strings, numbers) it is enough to call this function in cycle.
3349
    It is possible not to write the appropriate code manually and use
3249
    It is possible not to write the appropriate code manually and use
3350
    file 'debug.inc', which is included into the distributive.
3250
    file 'debug.inc', which is included into the distributive.
3351
 
3251
 
3352
----------------------------- Read byte ------------------------------
3252
----------------------------- Read byte ------------------------------
3353
Takes away byte from the buffer.
3253
Takes away byte from the buffer.
3354
Parameters:
3254
Parameters:
3355
  * eax = 63 - function number
3255
  * eax = 63 - function number
3356
  * ebx = 2 - subfunction number
3256
  * ebx = 2 - subfunction number
3357
Returned value:
3257
Returned value:
3358
  * eax = ebx = 0 - the buffer is empty
3258
  * eax = ebx = 0 - the buffer is empty
3359
  * eax = byte, ebx = 1 - byte was successfully read
3259
  * eax = byte, ebx = 1 - byte was successfully read
3360
 
3260
 
3361
======================================================================
3261
======================================================================
3362
============== Function 64 - resize application memory. ==============
3262
============== Function 64 - resize application memory. ==============
3363
======================================================================
3263
======================================================================
3364
Parameters:
3264
Parameters:
3365
  * eax = 64 - function number
3265
  * eax = 64 - function number
3366
  * ebx = 1 - unique subfunction
3266
  * ebx = 1 - unique subfunction
3367
  * ecx = new memory size
3267
  * ecx = new memory size
3368
Returned value:
3268
Returned value:
3369
  * eax = 0 - success
3269
  * eax = 0 - success
3370
  * eax = 1 - not enough memory
3270
  * eax = 1 - not enough memory
3371
Remarks:
3271
Remarks:
3372
  * There is another way to dynamically allocate/free memory -
3272
  * There is another way to dynamically allocate/free memory -
3373
    subfunctions 11, 12, 13 of function 68.
3273
    subfunctions 11, 12, 13 of function 68.
3374
  * The function cannot be used together with 68.11, 68.12, 68.13.
3274
  * The function cannot be used together with 68.11, 68.12, 68.13.
3375
    The function call will be ignored after creation of process heap
3275
    The function call will be ignored after creation of process heap
3376
    with function 68.11.
3276
    with function 68.11.
3377
 
3277
 
3378
======================================================================
3278
======================================================================
3379
======== Function 65 - draw image with palette in the window. ========
3279
======== Function 65 - draw image with palette in the window. ========
3380
======================================================================
3280
======================================================================
3381
Parameters:
3281
Parameters:
3382
  * eax = 65 - function number
3282
  * eax = 65 - function number
3383
  * ebx = pointer to the image
3283
  * ebx = pointer to the image
3384
  * ecx = [size on axis x]*65536 + [size on axis y]
3284
  * ecx = [size on axis x]*65536 + [size on axis y]
3385
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
3285
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
3386
  * esi = number of bits per pixel, must be 1,2,4,8,15,16,24 or 32
3286
  * esi = number of bits per pixel, must be 1,2,4,8,15,16,24 or 32
3387
  * edi = pointer to palette (2 to the power esi colors 0x00RRGGBB);
3287
  * edi = pointer to palette (2 to the power esi colors 0x00RRGGBB);
3388
          ignored when esi > 8
3288
          ignored when esi > 8
3389
  * ebp = offset of next row data relative to previous row data
3289
  * ebp = offset of next row data relative to previous row data
3390
Returned value:
3290
Returned value:
3391
  * function does not return value
3291
  * function does not return value
3392
Remarks:
3292
Remarks:
3393
  * Coordinates of the image are coordinates of the upper left corner
3293
  * Coordinates of the image are coordinates of the upper left corner
3394
    of the image relative to the window.
3294
    of the image relative to the window.
3395
  * Format of image with 1 bit per pixel: each byte of image
3295
  * Format of image with 1 bit per pixel: each byte of image
3396
    (possibly excluding last bytes in rows), contains information on
3296
    (possibly excluding last bytes in rows), contains information on
3397
    the color of 8 pixels, MSB corresponds to first pixel.
3297
    the color of 8 pixels, MSB corresponds to first pixel.
3398
  * Format of image with 2 bits per pixel: each byte of image
3298
  * Format of image with 2 bits per pixel: each byte of image
3399
    (possibly excluding last bytes in rows), contains information on
3299
    (possibly excluding last bytes in rows), contains information on
3400
    the color of 4 pixels, two MSBs correspond to first pixel.
3300
    the color of 4 pixels, two MSBs correspond to first pixel.
3401
  * Format of image with 4 bits per pixel: each byte of image
3301
  * Format of image with 4 bits per pixel: each byte of image
3402
    excluding last bytes in rows (if width is odd) contains
3302
    excluding last bytes in rows (if width is odd) contains
3403
    information on the color of 2 pixels, high-order tetrad
3303
    information on the color of 2 pixels, high-order tetrad
3404
    corresponds to first pixel.
3304
    corresponds to first pixel.
3405
  * Format of image with 8 bits per pixel: each byte of image is
3305
  * Format of image with 8 bits per pixel: each byte of image is
3406
    index in the palette.
3306
    index in the palette.
3407
  * Format of image with 15 bits per pixel: the color of each pixel
3307
  * Format of image with 15 bits per pixel: the color of each pixel
3408
    is coded as (bit representation) 0RRRRRGGGGGBBBBB - 5 bits per
3308
    is coded as (bit representation) 0RRRRRGGGGGBBBBB - 5 bits per
3409
    each color.
3309
    each color.
3410
  * Format of image with 16 bits per pixel: the color of each pixel
3310
  * Format of image with 16 bits per pixel: the color of each pixel
3411
    is coded as RRRRRGGGGGGBBBBB (5+6+5).
3311
    is coded as RRRRRGGGGGGBBBBB (5+6+5).
3412
  * Format of image with 24 bits per pixel: the color of each pixel
3312
  * Format of image with 24 bits per pixel: the color of each pixel
3413
    is coded as 3 bytes - sequentially blue, green, red components.
3313
    is coded as 3 bytes - sequentially blue, green, red components.
3414
  * Format of image with 32 bits per pixel: similar to 24, but
3314
  * Format of image with 32 bits per pixel: similar to 24, but
3415
    one additional ignored byte is present.
3315
    one additional ignored byte is present.
3416
  * The call to function 7 is equivalent to call to this function
3316
  * The call to function 7 is equivalent to call to this function
3417
    with esi=24, ebp=0.
3317
    with esi=24, ebp=0.
3418
 
3318
 
3419
======================================================================
3319
======================================================================
3420
================== Function 66 - work with keyboard. =================
3320
================== Function 66 - work with keyboard. =================
3421
======================================================================
3321
======================================================================
3422
The input mode influences results of reading keys by function 2.
3322
The input mode influences results of reading keys by function 2.
3423
When a program loads, ASCII input mode is set for it.
3323
When a program loads, ASCII input mode is set for it.
3424
If subfunction is not support then eax=-1.
-
 
3425
 
3324
 
3426
-------------- Subfunction 1 - set keyboard input mode. --------------
3325
-------------- Subfunction 1 - set keyboard input mode. --------------
3427
Parameters:
3326
Parameters:
3428
  * eax = 66 - function number
3327
  * eax = 66 - function number
3429
  * ebx = 1 - subfunction number
3328
  * ebx = 1 - subfunction number
3430
  * ecx = mode:
3329
  * ecx = mode:
3431
    * 0 = normal (ASCII-characters)
3330
    * 0 = normal (ASCII-characters)
3432
    * 1 = scancodes
3331
    * 1 = scancodes
3433
Returned value:
3332
Returned value:
3434
  * function does not return value
3333
  * function does not return value
3435
 
3334
 
3436
-------------- Subfunction 2 - get keyboard input mode. --------------
3335
-------------- Subfunction 2 - get keyboard input mode. --------------
3437
Parameters:
3336
Parameters:
3438
  * eax = 66 - function number
3337
  * eax = 66 - function number
3439
  * ebx = 2 - subfunction number
3338
  * ebx = 2 - subfunction number
3440
Returned value:
3339
Returned value:
3441
  * eax = current mode
3340
  * eax = current mode
3442
 
3341
 
3443
------------ Subfunction 3 - get status of control keys. -------------
3342
------------ Subfunction 3 - get status of control keys. -------------
3444
Parameters:
3343
Parameters:
3445
  * eax = 66 - function number
3344
  * eax = 66 - function number
3446
  * ebx = 3 - subfunction number
3345
  * ebx = 3 - subfunction number
3447
Returned value:
3346
Returned value:
3448
  * eax = bit mask:
3347
  * eax = bit mask:
3449
  * bit 0 (mask 1): left Shift is pressed
3348
  * bit 0 (mask 1): left Shift is pressed
3450
  * bit 1 (mask 2): right Shift is pressed
3349
  * bit 1 (mask 2): right Shift is pressed
3451
  * bit 2 (mask 4): left Ctrl is pressed
3350
  * bit 2 (mask 4): left Ctrl is pressed
3452
  * bit 3 (mask 8): right Ctrl is pressed
3351
  * bit 3 (mask 8): right Ctrl is pressed
3453
  * bit 4 (mask 0x10): left Alt is pressed
3352
  * bit 4 (mask 0x10): left Alt is pressed
3454
  * bit 5 (mask 0x20): right Alt is pressed
3353
  * bit 5 (mask 0x20): right Alt is pressed
3455
  * bit 6 (mask 0x40): CapsLock is on
3354
  * bit 6 (mask 0x40): CapsLock is on
3456
  * bit 7 (mask 0x80): NumLock is on
3355
  * bit 7 (mask 0x80): NumLock is on
3457
  * bit 8 (mask 0x100): ScrollLock is on
3356
  * bit 8 (mask 0x100): ScrollLock is on
3458
  * other bits are cleared
3357
  * other bits are cleared
3459
 
3358
 
3460
-------------- Subfunction 4 - set system-wide hotkey. ---------------
3359
-------------- Subfunction 4 - set system-wide hotkey. ---------------
3461
When hotkey is pressed, the system notifies only those applications,
3360
When hotkey is pressed, the system notifies only those applications,
3462
which have installed it; the active application (which receives
3361
which have installed it; the active application (which receives
3463
all normal input) does not receive such keys.
3362
all normal input) does not receive such keys.
3464
The notification consists in sending event with the code 2.
3363
The notification consists in sending event with the code 2.
3465
Reading hotkey is the same as reading normal key - by function 2.
3364
Reading hotkey is the same as reading normal key - by function 2.
3466
Parameters:
3365
Parameters:
3467
  * eax = 66 - function number
3366
  * eax = 66 - function number
3468
  * ebx = 4 - subfunction number
3367
  * ebx = 4 - subfunction number
3469
  * cl determines key scancode;
3368
  * cl determines key scancode;
3470
    use cl=0 to give combinations such as Ctrl+Shift
3369
    use cl=0 to give combinations such as Ctrl+Shift
3471
  * edx = 0xXYZ determines possible states of control keys:
3370
  * edx = 0xXYZ determines possible states of control keys:
3472
    * Z (low 4 bits) determines state of LShift and RShift:
3371
    * Z (low 4 bits) determines state of LShift and RShift:
3473
      * 0 = no key must be pressed;
3372
      * 0 = no key must be pressed;
3474
      * 1 = exactly one key must be pressed;
3373
      * 1 = exactly one key must be pressed;
3475
      * 2 = both keys must be pressed;
3374
      * 2 = both keys must be pressed;
3476
      * 3 = must be pressed LShift, but not RShift;
3375
      * 3 = must be pressed LShift, but not RShift;
3477
      * 4 = must be pressed RShift, but not LShift
3376
      * 4 = must be pressed RShift, but not LShift
3478
    * Y - similar for LCtrl and RCtrl;
3377
    * Y - similar for LCtrl and RCtrl;
3479
    * X - similar for LAlt and RAlt
3378
    * X - similar for LAlt and RAlt
3480
Returned value:
3379
Returned value:
3481
  * eax=0 - success
3380
  * eax=0 - success
3482
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
3381
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
3483
Remarks:
3382
Remarks:
3484
  * Hotkey can work either at pressing or at release. Release
3383
  * Hotkey can work either at pressing or at release. Release
3485
    scancode of a key is more on 128 than pressing scancode
3384
    scancode of a key is more on 128 than pressing scancode
3486
    (i.e. high bit is set).
3385
    (i.e. high bit is set).
3487
  * Several applications can set the same combination;
3386
  * Several applications can set the same combination;
3488
    all such applications will be informed on pressing
3387
    all such applications will be informed on pressing
3489
    such combination.
3388
    such combination.
3490
 
3389
 
3491
-------------- Subfunction 5 - delete installed hotkey. --------------
3390
-------------- Subfunction 5 - delete installed hotkey. --------------
3492
Parameters:
3391
Parameters:
3493
  * eax = 66 - function number
3392
  * eax = 66 - function number
3494
  * ebx = 5 - subfunction number
3393
  * ebx = 5 - subfunction number
3495
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
3394
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
3496
Returned value:
3395
Returned value:
3497
  * eax = 0 - success
3396
  * eax = 0 - success
3498
  * eax = 1 - there is no such hotkey
3397
  * eax = 1 - there is no such hotkey
3499
Remarks:
3398
Remarks:
3500
  * When a process/thread terminates, all hotkey installed by it are
3399
  * When a process/thread terminates, all hotkey installed by it are
3501
    deleted.
3400
    deleted.
3502
  * The call to this subfunction does not affect other applications.
3401
  * The call to this subfunction does not affect other applications.
3503
    If other application has defined the same combination, it will
3402
    If other application has defined the same combination, it will
3504
    still receive notices.
3403
    still receive notices.
3505
 
3404
 
3506
======================================================================
3405
======================================================================
3507
========= Function 67 - change position/sizes of the window. =========
3406
========= Function 67 - change position/sizes of the window. =========
3508
======================================================================
3407
======================================================================
3509
Parameters:
3408
Parameters:
3510
  * eax = 67 - function number
3409
  * eax = 67 - function number
3511
  * ebx = new x-coordinate of the window
3410
  * ebx = new x-coordinate of the window
3512
  * ecx = new y-coordinate of the window
3411
  * ecx = new y-coordinate of the window
3513
  * edx = new x-size of the window
3412
  * edx = new x-size of the window
3514
  * esi = new y-size of the window
3413
  * esi = new y-size of the window
3515
Returned value:
3414
Returned value:
3516
  * function does not return value
3415
  * function does not return value
3517
Remarks:
3416
Remarks:
3518
  * The value -1 for a parameter means "do not change"; e.g. to move
3417
  * The value -1 for a parameter means "do not change"; e.g. to move
3519
    the window without resizing it is possible to specify edx=esi=-1.
3418
    the window without resizing it is possible to specify edx=esi=-1.
3520
  * Previously the window must be defined by function 0.
3419
  * Previously the window must be defined by function 0.
3521
    It sets initial coordinates and sizes of the window.
3420
    It sets initial coordinates and sizes of the window.
3522
  * Sizes of the window are understood in sense of function 0,
3421
  * Sizes of the window are understood in sense of function 0,
3523
    that is one pixel less than real sizes.
3422
    that is one pixel less than real sizes.
3524
  * The function call for maximized windows is simply ignored.
3423
  * The function call for maximized windows is simply ignored.
3525
  * For windows of appropriate styles position and/or sizes can be
3424
  * For windows of appropriate styles position and/or sizes can be
3526
    changed by user; current position and sizes can be obtained by
3425
    changed by user; current position and sizes can be obtained by
3527
    call to function 9.
3426
    call to function 9.
3528
  * The function sends to the window redraw event (with the code 1).
3427
  * The function sends to the window redraw event (with the code 1).
3529
 
3428
 
3530
======================================================================
3429
======================================================================
3531
====== Function 68, subfunction 0 - get the task switch counter. =====
3430
====== Function 68, subfunction 0 - get the task switch counter. =====
3532
======================================================================
3431
======================================================================
3533
Parameters:
3432
Parameters:
3534
  * eax = 68 - function number
3433
  * eax = 68 - function number
3535
  * ebx = 0 - subfunction number
3434
  * ebx = 0 - subfunction number
3536
Returned value:
3435
Returned value:
3537
  * eax = number of task switches from the system booting
3436
  * eax = number of task switches from the system booting
3538
    (modulo 2^32)
3437
    (modulo 2^32)
3539
 
3438
 
3540
======================================================================
3439
======================================================================
3541
======= Function 68, subfunction 1 - switch to the next thread. ======
3440
======= Function 68, subfunction 1 - switch to the next thread. ======
3542
======================================================================
3441
======================================================================
3543
The function completes the current time slice allocated to the
3442
The function completes the current time slice allocated to the
3544
thread and switches to the next. (Which thread in which process
3443
thread and switches to the next. (Which thread in which process
3545
will be next, is unpredictable). Later, when execution queue
3444
will be next, is unpredictable). Later, when execution queue
3546
will reach the current thread, execution will be continued.
3445
will reach the current thread, execution will be continued.
3547
Parameters:
3446
Parameters:
3548
  * eax = 68 - function number
3447
  * eax = 68 - function number
3549
  * ebx = 1 - subfunction number
3448
  * ebx = 1 - subfunction number
3550
Returned value:
3449
Returned value:
3551
  * function does not return value
3450
  * function does not return value
3552
 
3451
 
3553
======================================================================
3452
======================================================================
3554
============= Function 68, subfunction 2 - cache + rdpmc. ============
3453
============= Function 68, subfunction 2 - cache + rdpmc. ============
3555
======================================================================
3454
======================================================================
3556
Parameters:
3455
Parameters:
3557
  * eax = 68 - function number
3456
  * eax = 68 - function number
3558
  * ebx = 2 - subfunction number
3457
  * ebx = 2 - subfunction number
3559
  * ecx = required action:
3458
  * ecx = required action:
3560
    * ecx = 0 - enable instruction 'rdpmc'
3459
    * ecx = 0 - enable instruction 'rdpmc'
3561
      (ReaD Performance-Monitoring Counters) for applications
3460
      (ReaD Performance-Monitoring Counters) for applications
3562
    * ecx = 1 - find out whether cache is disabled/enabled
3461
    * ecx = 1 - find out whether cache is disabled/enabled
3563
    * ecx = 2 - enable cache
3462
    * ecx = 2 - enable cache
3564
    * ecx = 3 - disable cache
3463
    * ecx = 3 - disable cache
3565
Returned value:
3464
Returned value:
3566
  * for ecx=0:
3465
  * for ecx=0:
3567
    * eax = the value of cr4
3466
    * eax = the value of cr4
3568
  * for ecx=1:
3467
  * for ecx=1:
3569
    * eax = (cr0 and 0x60000000):
3468
    * eax = (cr0 and 0x60000000):
3570
    * eax = 0 - cache is on
3469
    * eax = 0 - cache is on
3571
    * eax <> 0 - cache is off
3470
    * eax <> 0 - cache is off
3572
  * for ecx=2 and ecx=3:
3471
  * for ecx=2 and ecx=3:
3573
    * function does not return value
3472
    * function does not return value
3574
 
3473
 
3575
======================================================================
3474
======================================================================
3576
=========== Function 68, subfunction 3 - read MSR-register. ==========
3475
=========== Function 68, subfunction 3 - read MSR-register. ==========
3577
======================================================================
3476
======================================================================
3578
MSR = Model Specific Register; the complete list of MSR-registers
3477
MSR = Model Specific Register; the complete list of MSR-registers
3579
of a processor is included to the documentation on it (for example,
3478
of a processor is included to the documentation on it (for example,
3580
IA-32 Intel Architecture Software Developer's Manual,
3479
IA-32 Intel Architecture Software Developer's Manual,
3581
Volume 3, Appendix B); each processor family has its own subset
3480
Volume 3, Appendix B); each processor family has its own subset
3582
of the MSR-registers.
3481
of the MSR-registers.
3583
Parameters:
3482
Parameters:
3584
  * eax = 68 - function number
3483
  * eax = 68 - function number
3585
  * ebx = 3 - subfunction number
3484
  * ebx = 3 - subfunction number
3586
  * ecx is ignored
3485
  * ecx is ignored
3587
  * edx = MSR address
3486
  * edx = MSR address
3588
Returned value:
3487
Returned value:
3589
  * ebx:eax = high:low dword of the result
3488
  * ebx:eax = high:low dword of the result
3590
Remarks:
3489
Remarks:
3591
  * If ecx contains nonexistent or not implemented for this processor
3490
  * If ecx contains nonexistent or not implemented for this processor
3592
    MSR, processor will generate an exception in the kernel, which
3491
    MSR, processor will generate an exception in the kernel, which
3593
    will kill the thread.
3492
    will kill the thread.
3594
  * Previously it is necessary to check, whether MSRs are supported
3493
  * Previously it is necessary to check, whether MSRs are supported
3595
    as a whole, with the instruction 'cpuid'. Otherwise processor
3494
    as a whole, with the instruction 'cpuid'. Otherwise processor
3596
    will generate other exception in the kernel, which will anyway
3495
    will generate other exception in the kernel, which will anyway
3597
    kill the thread.
3496
    kill the thread.
3598
 
3497
 
3599
======================================================================
3498
======================================================================
3600
========= Function 68, subfunction 4 - write to MSR-register. ========
3499
========= Function 68, subfunction 4 - write to MSR-register. ========
3601
======================================================================
3500
======================================================================
3602
MSR = Model Specific Register; the complete list of MSR-registers
3501
MSR = Model Specific Register; the complete list of MSR-registers
3603
of a processor is included to the documentation on it (for example,
3502
of a processor is included to the documentation on it (for example,
3604
IA-32 Intel Architecture Software Developer's Manual,
3503
IA-32 Intel Architecture Software Developer's Manual,
3605
Volume 3, Appendix B); each processor family has its own subset
3504
Volume 3, Appendix B); each processor family has its own subset
3606
of the MSR-registers.
3505
of the MSR-registers.
3607
Parameters:
3506
Parameters:
3608
  * eax = 68 - function number
3507
  * eax = 68 - function number
3609
  * ebx = 4 - subfunction number
3508
  * ebx = 4 - subfunction number
3610
  * ecx is ignored
3509
  * ecx is ignored
3611
  * edx = MSR address
3510
  * edx = MSR address
3612
  * esi:edi = high:low dword
3511
  * esi:edi = high:low dword
3613
Returned value:
3512
Returned value:
3614
  * function does not return value
3513
  * function does not return value
3615
Remarks:
3514
Remarks:
3616
  * If ecx contains nonexistent or not implemented for this processor
3515
  * If ecx contains nonexistent or not implemented for this processor
3617
    MSR, processor will generate an exception in the kernel, which
3516
    MSR, processor will generate an exception in the kernel, which
3618
    will kill the thread.
3517
    will kill the thread.
3619
  * Previously it is necessary to check, whether MSRs are supported
3518
  * Previously it is necessary to check, whether MSRs are supported
3620
    as a whole, with the instruction 'cpuid'. Otherwise processor
3519
    as a whole, with the instruction 'cpuid'. Otherwise processor
3621
    will generate other exception in the kernel, which will anyway
3520
    will generate other exception in the kernel, which will anyway
3622
    kill the thread.
3521
    kill the thread.
3623
 
3522
 
3624
======================================================================
3523
======================================================================
3625
======= Function 68, subfunction 11 - initialize process heap. =======
3524
======= Function 68, subfunction 11 - initialize process heap. =======
3626
======================================================================
3525
======================================================================
3627
Parameters:
3526
Parameters:
3628
  * eax = 68 - function number
3527
  * eax = 68 - function number
3629
  * ebx = 11 - subfunction number
3528
  * ebx = 11 - subfunction number
3630
Returned value:
3529
Returned value:
3631
  * eax = 0 - failed
3530
  * eax = 0 - failed
3632
  * otherwise size of created heap
3531
  * otherwise size of created heap
3633
Remarks:
3532
Remarks:
3634
  * The function call initializes heap, from which one can in future
3533
  * The function call initializes heap, from which one can in future
3635
    allocate and free memory blocks with subfunctions 12 and 13.
3534
    allocate and free memory blocks with subfunctions 12 and 13.
3636
    Heap size is equal to total amount of free application memory.
3535
    Heap size is equal to total amount of free application memory.
3637
  * The second function call from the same process results in
3536
  * The second function call from the same process results in
3638
    returning the size of the existing heap.
3537
    returning the size of the existing heap.
3639
  * After creation of the heap calls to function 64 will be ignored.
3538
  * After creation of the heap calls to function 64 will be ignored.
3640
 
3539
 
3641
======================================================================
3540
======================================================================
3642
======== Function 68, subfunction 12 - allocate memory block. ========
3541
======== Function 68, subfunction 12 - allocate memory block. ========
3643
======================================================================
3542
======================================================================
3644
Parameters:
3543
Parameters:
3645
  * eax = 68 - function number
3544
  * eax = 68 - function number
3646
  * ebx = 12 - subfunction number
3545
  * ebx = 12 - subfunction number
3647
  * ecx = required size in bytes
3546
  * ecx = required size in bytes
3648
Returned value:
3547
Returned value:
3649
  * eax = pointer to the allocated block
3548
  * eax = pointer to the allocated block
3650
Remarks:
3549
Remarks:
3651
  * Before this call one must initialize process heap by call to
3550
  * Before this call one must initialize process heap by call to
3652
    subfunction 11.
3551
    subfunction 11.
3653
  * The function allocates an integer number of pages (4 Kb) in such
3552
  * The function allocates an integer number of pages (4 Kb) in such
3654
    way that the real size of allocated block is more than or equal to
3553
    way that the real size of allocated block is more than or equal to
3655
    requested size.
3554
    requested size.
3656
 
3555
 
3657
======================================================================
3556
======================================================================
3658
========== Function 68, subfunction 13 - free memory block. ==========
3557
========== Function 68, subfunction 13 - free memory block. ==========
3659
======================================================================
3558
======================================================================
3660
Parameters:
3559
Parameters:
3661
  * eax = 68 - function number
3560
  * eax = 68 - function number
3662
  * ebx = 13 - subfunction number
3561
  * ebx = 13 - subfunction number
3663
  * ecx = pointer to the memory block
3562
  * ecx = pointer to the memory block
3664
Returned value:
3563
Returned value:
3665
  * eax = 1 - success
3564
  * eax = 1 - success
3666
  * eax = 0 - failed
3565
  * eax = 0 - failed
3667
Remarks:
3566
Remarks:
3668
  * The memory block must have been allocated by subfunction 12
3567
  * The memory block must have been allocated by subfunction 12
3669
    or subfunction 20.
3568
    or subfunction 20.
3670
 
3569
 
3671
======================================================================
3570
======================================================================
3672
===================== Function 68, subfunction 14 ====================
3571
===================== Function 68, subfunction 14 ====================
3673
====== Waiting delivering of signal from another program/driver ======
3572
============ Wait for signal from another program/driver. ============
3674
======================================================================
3573
======================================================================
3675
Parameters:
3574
Parameters:
3676
  * eax = 68 - function number
3575
  * eax = 68 - function number
3677
  * ebx = 14 - subfunction number
3576
  * ebx = 14 - subfunction number
3678
  * ecx = pointer to the buffer for information (24 bytes)
3577
  * ecx = pointer to the buffer for information (24 bytes)
3679
Returned value:
3578
Returned value:
3680
  * buffer pointed to by ecx contains the following information:
3579
  * buffer pointed to by ecx contains the following information:
3681
    * +0: dword: identifier for underlying data of signal
3580
    * +0: dword: identifier for following data of signal
3682
    * +4: data of signal (20 bytes), format of which is defining by
3581
    * +4: dword: data of signal (20 bytes), format of which is defined
3683
          first dword
3582
          by the first dword
3684
 
-
 
3685
======================================================================
-
 
3686
====== Function 68, subfunction 15 - set FPU exception handler. ======
-
 
3687
======================================================================
-
 
3688
Deleted (in current implementation only 0 is returned).
-
 
3689
Using subfunctions 24, 25 is true.
-
 
3690
 
3583
 
3691
======================================================================
3584
======================================================================
3692
============= Function 68, subfunction 16 - load driver. =============
3585
============= Function 68, subfunction 16 - load driver. =============
3693
======================================================================
3586
======================================================================
3694
Parameters:
3587
Parameters:
3695
  * eax = 68 - function number
3588
  * eax = 68 - function number
3696
  * ebx = 16 - subfunction number
3589
  * ebx = 16 - subfunction number
3697
  * ecx = pointer to ASCIIZ-string with driver name
3590
  * ecx = pointer to ASCIIZ-string with driver name
3698
Returned value:
3591
Returned value:
3699
  * eax = 0 - failed
3592
  * eax = 0 - failed
3700
  * otherwise eax = driver handle
3593
  * otherwise eax = driver handle
3701
Remarks:
3594
Remarks:
3702
  * If the driver was not loaded yet, it is loaded;
3595
  * If the driver was not loaded yet, it is loaded;
3703
    if the driver was loaded yet, nothing happens.
3596
    if the driver was loaded yet, nothing happens.
3704
  * Driver name is case-sensitive.
3597
  * Driver name is case-sensitive.
3705
    Maximum length of the name is 16 characters, including
3598
    Maximum length of the name is 16 characters, including
3706
    terminating null character, the rest is ignored.
3599
    terminating null character, the rest is ignored.
3707
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
3600
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
3708
 
3601
 
3709
======================================================================
3602
======================================================================
3710
============ Function 68, subfunction 17 - driver control. ===========
3603
============ Function 68, subfunction 17 - driver control. ===========
3711
======================================================================
3604
======================================================================
3712
Parameters:
3605
Parameters:
3713
  * eax = 68 - function number
3606
  * eax = 68 - function number
3714
  * ebx = 17 - subfunction number
3607
  * ebx = 17 - subfunction number
3715
  * ecx = pointer to the control structure:
3608
  * ecx = pointer to the control structure:
3716
    * +0: dword: handle of driver
3609
    * +0: dword: handle of driver
3717
    * +4: dword: code of driver function
3610
    * +4: dword: code of driver function
3718
    * +8: dword: pointer to input data
3611
    * +8: dword: pointer to input data
3719
    * +12 = +0xC: dword: size of input data
3612
    * +12 = +0xC: dword: size of input data
3720
    * +16 = +0x10: dword: pointer to output data
3613
    * +16 = +0x10: dword: pointer to output data
3721
    * +20 = +0x14: dword: size of output data
3614
    * +20 = +0x14: dword: size of output data
3722
Returned value:
3615
Returned value:
3723
  * eax =  error code
3616
  * eax = determined by driver
3724
      0  - successful call
-
 
3725
     -1  - any error.
-
 
3726
     -2, -3, -4, etc. reserved for kernel error codes
-
 
3727
      1, 2, 3, etc    driver specific error codes
-
 
3728
Remarks:
3617
Remarks:
3729
  * Function codes and the structure of input/output data
3618
  * Function codes and the structure of input/output data
3730
    are defined by driver.
3619
    are defined by driver.
3731
  * Previously one must obtain driver handle by subfunction 16.
3620
  * Previously one must obtain driver handle by subfunction 16.
3732
 
3621
 
3733
======================================================================
3622
======================================================================
3734
====== Function 68, subfunction 18 - set SSE exception handler. ======
-
 
3735
======================================================================
-
 
3736
Deleted (in current implementation only 0 is returned).
-
 
3737
Using subfunctions 24, 25 is true.
-
 
3738
 
-
 
3739
======================================================================
-
 
3740
=============== Function 68, subfunction 19 - load DLL. ==============
3623
=============== Function 68, subfunction 19 - load DLL. ==============
3741
======================================================================
3624
======================================================================
3742
Parameters:
3625
Parameters:
3743
  * eax = 68 - function number
3626
  * eax = 68 - function number
3744
  * ebx = 19 - subfunction number
3627
  * ebx = 19 - subfunction number
3745
  * ecx = pointer to ASCIIZ-string with the full path to DLL
3628
  * ecx = pointer to ASCIIZ-string with the full path to DLL
3746
Returned value:
3629
Returned value:
3747
  * eax = 0 - failed
3630
  * eax = 0 - failed
3748
  * otherwise eax = pointer to DLL export table
3631
  * otherwise eax = pointer to DLL export table
3749
Remarks:
3632
Remarks:
3750
  * Export table is an array of structures of 2 dword's, terminated
3633
  * Export table is an array of structures of 2 dword's, terminated
3751
    by zero. The first dword in structure points to function name,
3634
    by zero. The first dword in structure points to function name,
3752
    the second dword contains address of function.
3635
    the second dword contains address of function.
3753
 
3636
 
3754
======================================================================
3637
======================================================================
3755
======= Function 68, subfunction 20 - reallocate memory block. =======
3638
======= Function 68, subfunction 20 - reallocate memory block. =======
3756
======================================================================
3639
======================================================================
3757
Parameters:
3640
Parameters:
3758
  * eax = 68 - function number
3641
  * eax = 68 - function number
3759
  * ebx = 20 - subfunction number
3642
  * ebx = 20 - subfunction number
3760
  * ecx = new size in bytes
3643
  * ecx = new size in bytes
3761
  * edx = pointer to already allocated block
3644
  * edx = pointer to already allocated block
3762
Returned value:
3645
Returned value:
3763
  * eax = pointer to the reallocated block, 0 = error
3646
  * eax = pointer to the reallocated block, 0 = error
3764
Remarks:
3647
Remarks:
3765
  * Before this call one must initialize process heap by call to
3648
  * Before this call one must initialize process heap by call to
3766
    subfunction 11.
3649
    subfunction 11.
3767
  * The function allocates an integer number of pages (4 Kb) in such
3650
  * The function allocates an integer number of pages (4 Kb) in such
3768
    way that the real size of allocated block is more than or equal to
3651
    way that the real size of allocated block is more than or equal to
3769
    requested size.
3652
    requested size.
3770
  * If edx=0, the function call is equivalent to memory allocation
3653
  * If edx=0, the function call is equivalent to memory allocation
3771
    with subfunction 12. Otherwise the block at edx
3654
    with subfunction 12. Otherwise the block at edx
3772
    must be allocated earlier with subfunction 12 or this subfunction.
3655
    must be allocated earlier with subfunction 12 or this subfunction.
3773
  * If ecx=0, the function frees memory block at edx and returns 0.
3656
  * If ecx=0, the function frees memory block at edx and returns 0.
3774
  * The contents of the block are unchanged up to the shorter of
3657
  * The contents of the block are unchanged up to the shorter of
3775
    the new and old sizes.
3658
    the new and old sizes.
3776
 
3659
 
3777
======================================================================
3660
======================================================================
-
 
3661
======== Function 68, subfunction 22 - open named memory area. =======
-
 
3662
======================================================================
-
 
3663
Parameters:
-
 
3664
  * eax = 68 - function number
-
 
3665
  * ebx = 22 - subfunction number
-
 
3666
  * ecx = area name. Maximum of 31 characters with terminating zero
-
 
3667
  * edx = area size in bytes for SHM_CREATE and SHM_OPEN_ALWAYS
-
 
3668
  * esi = flags for open and access:
-
 
3669
    * SHM_OPEN        = 0x00 - open existing memory area. If an area
-
 
3670
                          with such name does not exist, the function
-
 
3671
                          will return error code 5.
-
 
3672
    * SHM_OPEN_ALWAYS = 0x04 - open existing or create new
-
 
3673
                          memory area.
-
 
3674
    * SHM_CREATE      = 0x08 - create new memory area. If an area
-
 
3675
                          with such name already exists, the function
-
 
3676
                          will return error code 10.
-
 
3677
    * SHM_READ        = 0x00 - only read access
-
 
3678
    * SHM_WRITE       = 0x01 - read and write access
-
 
3679
Returned value:
-
 
3680
  * eax = pointer to memory area, 0 if error has occured
-
 
3681
  * if new area is created (SHM_CREATE or SHM_OPEN_ALWAYS):
-
 
3682
    edx = 0 - success, otherwise - error code
-
 
3683
  * if existing area is opened (SHM_OPEN or SHM_OPEN_ALWAYS):
-
 
3684
    edx = error code (if eax=0) or area size in bytes
-
 
3685
Error codes:
-
 
3686
  * E_NOTFOUND = 5
-
 
3687
  * E_ACCESS = 10
-
 
3688
  * E_NOMEM = 30
-
 
3689
  * E_PARAM = 33
-
 
3690
Remarks:
-
 
3691
  * Before this call one must initialize process heap by call to
-
 
3692
    subfunction 11.
-
 
3693
  * If a new area is created, access flags set maximal rights
-
 
3694
    for other processes. An attempt from other process to open
-
 
3695
    with denied rights will fail with error code E_ACCESS.
-
 
3696
  * The process which has created an area always has write access.
-
 
3697
 
-
 
3698
======================================================================
-
 
3699
======= Function 68, subfunction 23 - close named memory area. =======
-
 
3700
======================================================================
-
 
3701
Parameters:
-
 
3702
  * eax = 68 - function number
-
 
3703
  * ebx = 23 - subfunction number
-
 
3704
  * ecx = area name. Maximum of 31 characters with terminating zero
-
 
3705
Returned value:
-
 
3706
  * eax destroyed
-
 
3707
Remarks:
-
 
3708
  * A memory area is physically freed (with deleting all data and
-
 
3709
    freeing physical memory), when all threads which have opened
-
 
3710
    this area will close it.
-
 
3711
  * When thread is terminating, all opened by it areas are closed.
-
 
3712
 
-
 
3713
======================================================================
3778
====== Function 68, subfunction 24 - set new exceptions handler ======
3714
======== Function 68, subfunction 24 - set exception handler. ========
3779
======================================================================
3715
======================================================================
3780
Parameters:
3716
Parameters:
3781
  * eax = 68 - function number
3717
  * eax = 68 - function number
3782
  * ebx = 24 - subfunction number
3718
  * ebx = 24 - subfunction number
3783
  * ecx = address of the new exception handler
3719
  * ecx = address of the new exception handler
3784
  * edx = the mask of processing exceptions
3720
  * edx = the mask of handled exceptions
3785
Returned value:
3721
Returned value:
3786
  * eax = address of the old exception handler (0, if it was not set)
3722
  * eax = address of the old exception handler (0, if it was not set)
3787
  * ebx = the old mask of exception handler
3723
  * ebx = the old mask of handled exceptions
3788
Remarks:
3724
Remarks:
3789
  * Bit number in mask of exceptions is correspond to exception number
3725
  * Bit number in mask of exceptions corresponds to exception number
3790
    by CPU-specification (Intel-PC). For example, FPU-exception have
3726
    in CPU-specification (Intel-PC). For example, FPU exceptions have
3791
    number 16 (#MF), and SSE-exception - 19 (#XF)
3727
    number 16 (#MF), and SSE exceptions - 19 (#XF).
3792
  * The current implementation ignore the inquiry for hook of 7
3728
  * The current implementation ignores the inquiry for hook of 7
3793
    exception - system process #NM by one's own.
3729
    exception - the system handles #NM by its own.
3794
  * User handler get exception number in stack parameter. So, correct
3730
  * The exception handler is called with exception number as first
3795
    exit from handler is: RET 4. Return from handler is to the same
3731
    (and only) stack parameter. So, correct exit from the handler is
3796
    instruction, that was cause the exception
3732
    RET 4. It returns to the instruction, that caused the exception,
-
 
3733
    for faults, and to the next instruction for traps (see
-
 
3734
    classification of exceptions in CPU specification).
3797
  * When control is transfering to user handler, corresponding bit in
3735
  * When user handler receives control, the corresponding bit in
3798
    exception mask is clearing. Rising this exception in consequence
3736
    the exception mask is cleared. Raising this exception
3799
    - reduce to default-handling. Exactly: terminating the application,
3737
    in consequence leads to default handling, that is,
-
 
3738
    terminating the application in absence of debugger or
3800
    or suspending with debug-notify to owner.
3739
    suspend with notification of debugger otherwise.
3801
  * After completion of critical operations in user handler, it may be
3740
  * After user handler completes critical operations, it can set
3802
    rising corresponding bit in exception mask by using subfunction 25
3741
    the corresponding bit in the exception mask with subfunction 25.
3803
    Clearing exceptions flags in FPU and/or XMM modules - is
3742
    Also user handler is responsible for clearing exceptions flags in
3804
    responsibility of user handler too.
3743
    FPU and/or SSE.
3805
 
3744
 
3806
======================================================================
3745
======================================================================
3807
==== Function 68, subfunction 25 - change state of signal activity ===
3746
====== Function 68, subfunction 25 - set FPU exception handler. ======
3808
======================================================================
3747
======================================================================
3809
Parameters:
3748
Parameters:
3810
  * eax = 68 - function number
3749
  * eax = 68 - function number
3811
  * ebx = 25 - subfunction number
3750
  * ebx = 25 - subfunction number
3812
  * ecx = signal number
3751
  * ecx = signal number
3813
  * edx = value of activity (0/1)
3752
  * edx = value of activity (0/1)
3814
Returned value:
3753
Returned value:
-
 
3754
  * eax = -1 - invalid signal number
3815
  * eax = value of old activity for this signal (0/1)
3755
  * otherwise eax = old value of activity for this signal (0/1)
3816
Remarks:
3756
Remarks:
3817
  * In current implementation, it is changed only exception mask for
3757
  * In current implementation only mask for user excepton handler,
3818
    user exception handler, wich was previously set by subfunction 24.
3758
    which has been previously set by subfunction 24,
3819
    At that, number of signal correspond to exception number.
3759
    is changed. Signal number corresponds to exception number.
3820
 
3760
 
3821
======================================================================
3761
======================================================================
3822
====================== Fucntion 69 - debugging. ======================
3762
====================== Function 69 - debugging. ======================
3823
======================================================================
3763
======================================================================
3824
A process can load other process as debugged by set of corresponding
3764
A process can load other process as debugged by set of corresponding
3825
bit by call to subfunction 7 of function 70.
3765
bit by call to subfunction 7 of function 70.
3826
A process can have only one debugger; one process can debug some
3766
A process can have only one debugger; one process can debug some
3827
others. The system notifies debugger on events occuring with
3767
others. The system notifies debugger on events occuring with
3828
debugged process. Messages are written to the buffer defined by
3768
debugged process. Messages are written to the buffer defined by
3829
subfunction 0.
3769
subfunction 0.
3830
Format of a message:
3770
Format of a message:
3831
  * +0: dword: message code
3771
  * +0: dword: message code
3832
  * +4: dword: PID of debugged process
3772
  * +4: dword: PID of debugged process
3833
  * +8: there can be additional data depending on message code
3773
  * +8: there can be additional data depending on message code
3834
Message codes:
3774
Message codes:
3835
  * 1 = exception
3775
  * 1 = exception
3836
    * in addition dword-number of the exception is given
3776
    * in addition dword-number of the exception is given
3837
    * process is suspended
3777
    * process is suspended
3838
  * 2 = process has terminated
3778
  * 2 = process has terminated
3839
    * comes at any termination: both through the system function -1,
3779
    * comes at any termination: both through the system function -1,
3840
      and at "murder" by any other process (including debugger itself)
3780
      and at "murder" by any other process (including debugger itself)
3841
  * 3 = debug exception int 1 = #DB
3781
  * 3 = debug exception int 1 = #DB
3842
    * in addition dword-image of the register DR6 is given:
3782
    * in addition dword-image of the register DR6 is given:
3843
      * bits 0-3: condition of the corresponding breakpoint (set by
3783
      * bits 0-3: condition of the corresponding breakpoint (set by
3844
        subfunction 9) is satisfied
3784
        subfunction 9) is satisfied
3845
      * áèò 14: exception has occured because of the trace mode
3785
      * áèò 14: exception has occured because of the trace mode
3846
        (flag TF is set TF)
3786
        (flag TF is set TF)
3847
    * process is suspended
3787
    * process is suspended
3848
When debugger terminates, all debugged processes are killed.
3788
When debugger terminates, all debugged processes are killed.
3849
If debugger does not want this, it must previously detach by
3789
If debugger does not want this, it must previously detach by
3850
subfunction 3.
3790
subfunction 3.
3851
 
3791
 
3852
All subfunctions are applicable only to processes/threads started
3792
All subfunctions are applicable only to processes/threads started
3853
from the current by function 70 with set debugging flag.
3793
from the current by function 70 with set debugging flag.
3854
Debugging of multithreaded programs is not supported yet.
3794
Debugging of multithreaded programs is not supported yet.
3855
The full list of subfunctions:
3795
The full list of subfunctions:
3856
  * subfunction 0 - define data area for debug messages
3796
  * subfunction 0 - define data area for debug messages
3857
  * subfunction 1 - get contents of registers of debugged thread
3797
  * subfunction 1 - get contents of registers of debugged thread
3858
  * subfunction 2 - set contents of registers of debugged thread
3798
  * subfunction 2 - set contents of registers of debugged thread
3859
  * subfunction 3 - detach from debugged process
3799
  * subfunction 3 - detach from debugged process
3860
  * subfunction 4 - suspend debugged thread
3800
  * subfunction 4 - suspend debugged thread
3861
  * subfunction 5 - resume debugged thread
3801
  * subfunction 5 - resume debugged thread
3862
  * subfunction 6 - read from the memory of debugged process
3802
  * subfunction 6 - read from the memory of debugged process
3863
  * subfunction 7 - write to the memory of debugged process
3803
  * subfunction 7 - write to the memory of debugged process
3864
  * subfunction 8 - terminate debugged thread
3804
  * subfunction 8 - terminate debugged thread
3865
  * subfunction 9 - set/clear hardware breakpoint
3805
  * subfunction 9 - set/clear hardware breakpoint
3866
 
3806
 
3867
======================================================================
3807
======================================================================
3868
= Function 69, subfunction 0 - define data area fror debug messages. =
3808
= Function 69, subfunction 0 - define data area fror debug messages. =
3869
======================================================================
3809
======================================================================
3870
Parameters:
3810
Parameters:
3871
  * eax = 69 - function number
3811
  * eax = 69 - function number
3872
  * ebx = 0 - subfunction number
3812
  * ebx = 0 - subfunction number
3873
  * ecx = pointer
3813
  * ecx = pointer
3874
Format of data area:
3814
Format of data area:
3875
  * +0: dword: N = buffer size (not including this header)
3815
  * +0: dword: N = buffer size (not including this header)
3876
  * +4: dword: occupied place
3816
  * +4: dword: occupied place
3877
  * +8: N*byte: buffer
3817
  * +8: N*byte: buffer
3878
Returned value:
3818
Returned value:
3879
  * function does not return value
3819
  * function does not return value
3880
Remarks:
3820
Remarks:
3881
  * If the size field is negative, the buffer is considered locked
3821
  * If the size field is negative, the buffer is considered locked
3882
    and at arrival of new message the system will wait.
3822
    and at arrival of new message the system will wait.
3883
    For synchronization frame all work with the buffer by operations
3823
    For synchronization frame all work with the buffer by operations
3884
    lock/unlock
3824
    lock/unlock
3885
        neg     [bufsize]
3825
    	neg	[bufsize]
3886
  * Data in the buffer are considered as array of items with variable
3826
  * Data in the buffer are considered as array of items with variable
3887
    length - messages. Format of a message is explained in
3827
    length - messages. Format of a message is explained in
3888
    general description.
3828
    general description.
3889
 
3829
 
3890
======================================================================
3830
======================================================================
3891
===================== Function 69, subfunction 1 =====================
3831
===================== Function 69, subfunction 1 =====================
3892
============ Get contents of registers of debugged thread. ===========
3832
============ Get contents of registers of debugged thread. ===========
3893
======================================================================
3833
======================================================================
3894
Parameters:
3834
Parameters:
3895
  * eax = 69 - function number
3835
  * eax = 69 - function number
3896
  * ebx = 1 - subfunction number
3836
  * ebx = 1 - subfunction number
3897
  * ecx = thread identifier
3837
  * ecx = thread identifier
3898
  * edx = size of context structure, must be 0x28=40 bytes
3838
  * edx = size of context structure, must be 0x28=40 bytes
3899
  * esi = pointer to context structure
3839
  * esi = pointer to context structure
3900
Returned value:
3840
Returned value:
3901
  * function does not return value
3841
  * function does not return value
3902
Format of context structure: (FPU is not supported yet)
3842
Format of context structure: (FPU is not supported yet)
3903
  * +0: dword: eip
3843
  * +0: dword: eip
3904
  * +4: dword: eflags
3844
  * +4: dword: eflags
3905
  * +8: dword: eax
3845
  * +8: dword: eax
3906
  * +12 = +0xC: dword: ecx
3846
  * +12 = +0xC: dword: ecx
3907
  * +16 = +0x10: dword: edx
3847
  * +16 = +0x10: dword: edx
3908
  * +20 = +0x14: dword: ebx
3848
  * +20 = +0x14: dword: ebx
3909
  * +24 = +0x18: dword: esp
3849
  * +24 = +0x18: dword: esp
3910
  * +28 = +0x1C: dword: ebp
3850
  * +28 = +0x1C: dword: ebp
3911
  * +32 = +0x20: dword: esi
3851
  * +32 = +0x20: dword: esi
3912
  * +36 = +0x24: dword: edi
3852
  * +36 = +0x24: dword: edi
3913
Remarks:
3853
Remarks:
3914
  * If the thread executes code of ring-0, the function returns
3854
  * If the thread executes code of ring-0, the function returns
3915
    contents of registers of ring-3.
3855
    contents of registers of ring-3.
3916
  * Process must be loaded for debugging (as is shown in
3856
  * Process must be loaded for debugging (as is shown in
3917
    general description).
3857
    general description).
3918
 
3858
 
3919
======================================================================
3859
======================================================================
3920
===================== Function 69, subfunction 2 =====================
3860
===================== Function 69, subfunction 2 =====================
3921
============ Set contents of registers of debugged thread. ===========
3861
============ Set contents of registers of debugged thread. ===========
3922
======================================================================
3862
======================================================================
3923
Parameters:
3863
Parameters:
3924
  * eax = 69 - function number
3864
  * eax = 69 - function number
3925
  * ebx = 2 - subfunction number
3865
  * ebx = 2 - subfunction number
3926
  * ecx = thread identifier
3866
  * ecx = thread identifier
3927
  * edx = size of context structure, must be 0x28=40 bytes
3867
  * edx = size of context structure, must be 0x28=40 bytes
3928
Returned value:
3868
Returned value:
3929
  * function does not return value
3869
  * function does not return value
3930
Format of context structure is shown in the description of
3870
Format of context structure is shown in the description of
3931
subfunction 1.
3871
subfunction 1.
3932
Remarks:
3872
Remarks:
3933
  * If the thread executes code of ring-0, the function returns
3873
  * If the thread executes code of ring-0, the function returns
3934
    contents of registers of ring-3.
3874
    contents of registers of ring-3.
3935
  * Process must be loaded for debugging (as is shown in
3875
  * Process must be loaded for debugging (as is shown in
3936
    general description).
3876
    general description).
3937
 
3877
 
3938
======================================================================
3878
======================================================================
3939
===== Function 69, subfunction 3 - detach from debugged process. =====
3879
===== Function 69, subfunction 3 - detach from debugged process. =====
3940
======================================================================
3880
======================================================================
3941
Parameters:
3881
Parameters:
3942
  * eax = 69 - function number
3882
  * eax = 69 - function number
3943
  * ebx = 3 - subfunction number
3883
  * ebx = 3 - subfunction number
3944
  * ecx = identifier
3884
  * ecx = identifier
3945
Returned value:
3885
Returned value:
3946
  * function does not return value
3886
  * function does not return value
3947
Remarks:
3887
Remarks:
3948
  * If the process was suspended, it resumes execution.
3888
  * If the process was suspended, it resumes execution.
3949
 
3889
 
3950
======================================================================
3890
======================================================================
3951
======== Function 69, subfunction 4 - suspend debugged thread. =======
3891
======== Function 69, subfunction 4 - suspend debugged thread. =======
3952
======================================================================
3892
======================================================================
3953
Parameters:
3893
Parameters:
3954
  * eax = 69 - function number
3894
  * eax = 69 - function number
3955
  * ebx = 4 - subfunction number
3895
  * ebx = 4 - subfunction number
3956
  * ecx = thread identifier
3896
  * ecx = thread identifier
3957
Returned value:
3897
Returned value:
3958
  * function does not return value
3898
  * function does not return value
3959
Remarks:
3899
Remarks:
3960
  * Process must be loaded for debugging (as is shown in
3900
  * Process must be loaded for debugging (as is shown in
3961
    general description).
3901
    general description).
3962
 
3902
 
3963
======================================================================
3903
======================================================================
3964
======== Function 69, subfunction 5 - resume debugged thread. ========
3904
======== Function 69, subfunction 5 - resume debugged thread. ========
3965
======================================================================
3905
======================================================================
3966
Parameters:
3906
Parameters:
3967
  * eax = 69 - function number
3907
  * eax = 69 - function number
3968
  * ebx = 5 - subfunction number
3908
  * ebx = 5 - subfunction number
3969
  * ecx = thread identifier
3909
  * ecx = thread identifier
3970
Returned value:
3910
Returned value:
3971
  * function does not return value
3911
  * function does not return value
3972
Remarks:
3912
Remarks:
3973
  * Process must be loaded for debugging (as is shown in
3913
  * Process must be loaded for debugging (as is shown in
3974
    general description).
3914
    general description).
3975
 
3915
 
3976
======================================================================
3916
======================================================================
3977
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
3917
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
3978
======================================================================
3918
======================================================================
3979
Parameters:
3919
Parameters:
3980
  * eax = 69 - function number
3920
  * eax = 69 - function number
3981
  * ebx = 6 - subfunction number
3921
  * ebx = 6 - subfunction number
3982
  * ecx = identifier
3922
  * ecx = identifier
3983
  * edx = number of bytes to read
3923
  * edx = number of bytes to read
3984
  * esi = address in the memory of debugged process
3924
  * esi = address in the memory of debugged process
3985
  * edi = pointer to buffer for data
3925
  * edi = pointer to buffer for data
3986
Returned value:
3926
Returned value:
3987
  * eax = -1 at an error (invalid PID or buffer)
3927
  * eax = -1 at an error (invalid PID or buffer)
3988
  * otherwise eax = number of read bytes (possibly, 0,
3928
  * otherwise eax = number of read bytes (possibly, 0,
3989
    if esi is too large)
3929
    if esi is too large)
3990
Remarks:
3930
Remarks:
3991
  * Process must be loaded for debugging (as is shown in
3931
  * Process must be loaded for debugging (as is shown in
3992
    general description).
3932
    general description).
3993
 
3933
 
3994
======================================================================
3934
======================================================================
3995
== Function 69, subfunction 7 - write to memory of debugged process. =
3935
== Function 69, subfunction 7 - write to memory of debugged process. =
3996
======================================================================
3936
======================================================================
3997
Parameters:
3937
Parameters:
3998
  * eax = 69 - function number
3938
  * eax = 69 - function number
3999
  * ebx = 7 - subfunction number
3939
  * ebx = 7 - subfunction number
4000
  * ecx = identifier
3940
  * ecx = identifier
4001
  * edx = number of bytes to write
3941
  * edx = number of bytes to write
4002
  * esi = address of memory in debugged process
3942
  * esi = address of memory in debugged process
4003
  * edi = pointer to data
3943
  * edi = pointer to data
4004
Returned value:
3944
Returned value:
4005
  * eax = -1 at an error (invalid PID or buffer)
3945
  * eax = -1 at an error (invalid PID or buffer)
4006
  * otherwise eax = number of written bytes (possibly, 0,
3946
  * otherwise eax = number of written bytes (possibly, 0,
4007
    if esi is too large)
3947
    if esi is too large)
4008
Remarks:
3948
Remarks:
4009
  * Process must be loaded for debugging (as is shown in
3949
  * Process must be loaded for debugging (as is shown in
4010
    general description).
3950
    general description).
4011
 
3951
 
4012
======================================================================
3952
======================================================================
4013
======= Function 69, subfunction 8 - terminate debugged thread. ======
3953
======= Function 69, subfunction 8 - terminate debugged thread. ======
4014
======================================================================
3954
======================================================================
4015
Parameters:
3955
Parameters:
4016
  * eax = 69 - function number
3956
  * eax = 69 - function number
4017
  * ebx = 8 - subfunction number
3957
  * ebx = 8 - subfunction number
4018
  * ecx = identifier
3958
  * ecx = identifier
4019
Returned value:
3959
Returned value:
4020
  * function does not return value
3960
  * function does not return value
4021
Remarks:
3961
Remarks:
4022
  * Process must be loaded for debugging (as is shown in
3962
  * Process must be loaded for debugging (as is shown in
4023
    general description).
3963
    general description).
4024
  * The function is similar to subfunction 2 of function 18
3964
  * The function is similar to subfunction 2 of function 18
4025
    with two differences: it requires first remark and
3965
    with two differences: it requires first remark and
4026
    accepts PID rather than slot number.
3966
    accepts PID rather than slot number.
4027
 
3967
 
4028
======================================================================
3968
======================================================================
4029
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
3969
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
4030
======================================================================
3970
======================================================================
4031
Parameters:
3971
Parameters:
4032
  * eax = 69 - function number
3972
  * eax = 69 - function number
4033
  * ebx = 9 - subfunction number
3973
  * ebx = 9 - subfunction number
4034
  * ecx = thread identifier
3974
  * ecx = thread identifier
4035
  * dl = index of breakpoint, from 0 to 3 inclusively
3975
  * dl = index of breakpoint, from 0 to 3 inclusively
4036
  * dh = flags:
3976
  * dh = flags:
4037
    * if high bit is cleared - set breakpoint:
3977
    * if high bit is cleared - set breakpoint:
4038
      * bits 0-1 - condition:
3978
      * bits 0-1 - condition:
4039
        * 00 = breakpoint on execution
3979
        * 00 = breakpoint on execution
4040
        * 01 = breakpoint on read
3980
        * 01 = breakpoint on read
4041
        * 11 = breakpoint on read/write
3981
        * 11 = breakpoint on read/write
4042
      * bits 2-3 - length; for breakpoints on exception it must be
3982
      * bits 2-3 - length; for breakpoints on exception it must be
4043
        00, otherwise one of
3983
        00, otherwise one of
4044
        * 00 = byte
3984
        * 00 = byte
4045
        * 01 = word
3985
        * 01 = word
4046
        * 11 = dword
3986
        * 11 = dword
4047
      * esi = breakpoint address; must be aligned according to
3987
      * esi = breakpoint address; must be aligned according to
4048
        the length (i.e. must be even for word breakpoints,
3988
        the length (i.e. must be even for word breakpoints,
4049
        divisible by 4 for dword)
3989
        divisible by 4 for dword)
4050
    * if high bit is set - clear breakpoint
3990
    * if high bit is set - clear breakpoint
4051
Returned value:
3991
Returned value:
4052
  * eax = 0 - success
3992
  * eax = 0 - success
4053
  * eax = 1 - error in the input data
3993
  * eax = 1 - error in the input data
4054
  * eax = 2 - (reserved, is never returned in the current
3994
  * eax = 2 - (reserved, is never returned in the current
4055
    implementation) a global breakpoint with that index is already set
3995
    implementation) a global breakpoint with that index is already set
4056
Remarks:
3996
Remarks:
4057
  * Process must be loaded for debugging (as is shown in
3997
  * Process must be loaded for debugging (as is shown in
4058
    general description).
3998
    general description).
4059
  * Hardware breakpoints are implemented through DRx-registers of
3999
  * Hardware breakpoints are implemented through DRx-registers of
4060
    the processor, all limitations results from this.
4000
    the processor, all limitations results from this.
4061
  * The function can reinstall the breakpoint, previously set
4001
  * The function can reinstall the breakpoint, previously set
4062
    by it (and it does not inform on this).
4002
    by it (and it does not inform on this).
4063
    Carry on the list of set breakpoints in the debugger.
4003
    Carry on the list of set breakpoints in the debugger.
4064
  * Breakpoints generate debug exception #DB, on which the system
4004
  * Breakpoints generate debug exception #DB, on which the system
4065
    notifies debugger.
4005
    notifies debugger.
4066
  * Breakpoints on write and read/write act after
4006
  * Breakpoints on write and read/write act after
4067
    execution of the caused it instruction.
4007
    execution of the caused it instruction.
4068
 
4008
 
4069
======================================================================
4009
======================================================================
4070
==== Function 70 - work with file system with long names support. ====
4010
==== Function 70 - work with file system with long names support. ====
4071
======================================================================
4011
======================================================================
4072
Parameters:
4012
Parameters:
4073
  * eax = 70
4013
  * eax = 70
4074
  * ebx = pointer to the information structure
4014
  * ebx = pointer to the information structure
4075
Returned value:
4015
Returned value:
4076
  * eax = 0 - success; otherwise file system error code
4016
  * eax = 0 - success; otherwise file system error code
4077
  * some subfunctions return value in other registers too
4017
  * some subfunctions return value in other registers too
4078
General format of the information structure:
4018
General format of the information structure:
4079
  * +0: dword: subfunction number
4019
  * +0: dword: subfunction number
4080
  * +4: dword: file offset
4020
  * +4: dword: file offset
4081
  * +8: dword: high dword of offset (must be 0) or flags field
4021
  * +8: dword: high dword of offset (must be 0) or flags field
4082
  * +12 = +0xC: dword: size
4022
  * +12 = +0xC: dword: size
4083
  * +16 = +0x10: dword: pointer to data
4023
  * +16 = +0x10: dword: pointer to data
4084
  * +20 = +0x14: n db: ASCIIZ-string with the filename
4024
  * +20 = +0x14: n db: ASCIIZ-string with the filename
4085
    or
4025
    or
4086
  * +20 = +0x14: db 0
4026
  * +20 = +0x14: db 0
4087
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
4027
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
4088
Specifications - in documentation on the appropriate subfunction.
4028
Specifications - in documentation on the appropriate subfunction.
4089
Filename is case-insensitive. Russian letters must be written in
4029
Filename is case-insensitive. Russian letters must be written in
4090
the encoding cp866 (DOS).
4030
the encoding cp866 (DOS).
4091
Format of filename:
4031
Format of filename:
4092
/base/number/dir1/dir2/.../dirn/file,
4032
/base/number/dir1/dir2/.../dirn/file,
4093
where /base/number identifies device, on which file is located:
4033
where /base/number identifies device, on which file is located:
4094
one of
4034
one of
4095
  * /RD/1 = /RAMDISK/1 to access ramdisk
4035
  * /RD/1 = /RAMDISK/1 to access ramdisk
4096
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
4036
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
4097
    /FD/2 = /FLOPPYDISK/2 to access second one
4037
    /FD/2 = /FLOPPYDISK/2 to access second one
4098
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
4038
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
4099
    IDE0 (Primary Master), IDE1 (Primary Slave),
4039
    IDE0 (Primary Master), IDE1 (Primary Slave),
4100
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4040
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4101
    x - partition number on the selected hard drive, varies from 1
4041
    x - partition number on the selected hard drive, varies from 1
4102
    to 255 (on each hard drive the indexing starts from 1)
4042
    to 255 (on each hard drive the indexing starts from 1)
4103
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
4043
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
4104
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
4044
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
4105
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
4045
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
4106
  * /SYS means system folder; with the usual boot (from floppy)
4046
  * /SYS means system folder; with the usual boot (from floppy)
4107
    is equivalent to /RD/1
4047
    is equivalent to /RD/1
4108
Examples:
4048
Examples:
4109
  * '/rd/1/kernel.asm',0
4049
  * '/rd/1/kernel.asm',0
4110
  * '/HD0/1/kernel.asm',0
4050
  * '/HD0/1/kernel.asm',0
4111
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4051
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4112
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
4052
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
4113
  * '/sys/MySuperApp.ini',0
4053
  * '/sys/MySuperApp.ini',0
-
 
4054
Also function supports relative names.  If the path begins not 
-
 
4055
with '/', it is considered relative to a current folder. To get or 
-
 
4056
set a current folder, use the function 30.
-
 
4057
 
4114
Available subfunctions:
4058
Available subfunctions:
4115
  * subfunction 0 - read file
4059
  * subfunction 0 - read file
4116
  * subfunction 1 - read folder
4060
  * subfunction 1 - read folder
4117
  * subfunction 2 - create/rewrite file
4061
  * subfunction 2 - create/rewrite file
4118
  * subfunction 3 - write to existing file
4062
  * subfunction 3 - write to existing file
4119
  * subfunction 4 - set file size
4063
  * subfunction 4 - set file size
4120
  * subfunction 5 - get attributes of file/folder
4064
  * subfunction 5 - get attributes of file/folder
4121
  * subfunction 6 - set attributes of file/folder
4065
  * subfunction 6 - set attributes of file/folder
4122
  * subfunction 7 - start application
4066
  * subfunction 7 - start application
4123
  * subfunction 8 - delete file/folder
4067
  * subfunction 8 - delete file/folder
4124
  * subfunction 9 - create folder
4068
  * subfunction 9 - create folder
4125
For CD-drives due to hardware limitations only subfunctions
4069
For CD-drives due to hardware limitations only subfunctions
4126
0,1,5 and 7 are available, other subfunctions return error
4070
0,1,5 and 7 are available, other subfunctions return error
4127
with code 2.
4071
with code 2.
4128
At the first call of subfunctions 0,1,5,7 to ATAPI devices
4072
At the first call of subfunctions 0,1,5,7 to ATAPI devices
4129
(CD and DVD) the manual control of tray is locked due to caching
4073
(CD and DVD) the manual control of tray is locked due to caching
4130
drive data. Unlocking is made when subfunction 4 of function 24
4074
drive data. Unlocking is made when subfunction 4 of function 24
4131
is called for corresponding device.
4075
is called for corresponding device.
4132
 
4076
 
4133
======================================================================
4077
======================================================================
4134
=== Function 70, subfunction 0 - read file with long names support. ==
4078
=== Function 70, subfunction 0 - read file with long names support. ==
4135
======================================================================
4079
======================================================================
4136
Parameters:
4080
Parameters:
4137
  * eax = 70 - function number
4081
  * eax = 70 - function number
4138
  * ebx = pointer to the information structure
4082
  * ebx = pointer to the information structure
4139
Format of the information structure:
4083
Format of the information structure:
4140
  * +0: dword: 0 = subfunction number
4084
  * +0: dword: 0 = subfunction number
4141
  * +4: dword: file offset (in bytes)
4085
  * +4: dword: file offset (in bytes)
4142
  * +8: dword: 0 (reserved for high dword of offset)
4086
  * +8: dword: 0 (reserved for high dword of offset)
4143
  * +12 = +0xC: dword: number of bytes to read
4087
  * +12 = +0xC: dword: number of bytes to read
4144
  * +16 = +0x10: dword: pointer to buffer for data
4088
  * +16 = +0x10: dword: pointer to buffer for data
4145
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4089
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4146
    given in the general description
4090
    given in the general description
4147
    or
4091
    or
4148
  * +20 = +0x14: db 0
4092
  * +20 = +0x14: db 0
4149
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4093
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4150
Returned value:
4094
Returned value:
4151
  * eax = 0 - success, otherwise file system error code
4095
  * eax = 0 - success, otherwise file system error code
4152
  * ebx = number of read bytes or -1=0xffffffff if file was not found
4096
  * ebx = number of read bytes or -1=0xffffffff if file was not found
4153
Remarks:
4097
Remarks:
4154
  * If file was ended before last requested block was read,
4098
  * If file was ended before last requested block was read,
4155
    the function will read as many as it can, and after that return
4099
    the function will read as many as it can, and after that return
4156
    eax=6 (EOF).
4100
    eax=6 (EOF).
4157
  * The function does not allow to read folder (returns eax=10,
4101
  * The function does not allow to read folder (returns eax=10,
4158
    access denied).
4102
    access denied).
4159
 
4103
 
4160
======================================================================
4104
======================================================================
4161
== Function 70, subfunction 1 - read folder with long names support. =
4105
== Function 70, subfunction 1 - read folder with long names support. =
4162
======================================================================
4106
======================================================================
4163
Parameters:
4107
Parameters:
4164
  * eax = 70 - function number
4108
  * eax = 70 - function number
4165
  * ebx = pointer to the information structure
4109
  * ebx = pointer to the information structure
4166
Format of the information structure:
4110
Format of the information structure:
4167
  * +0: dword: 1 = subfunction number
4111
  * +0: dword: 1 = subfunction number
4168
  * +4: dword: index of starting block (beginning from 0)
4112
  * +4: dword: index of starting block (beginning from 0)
4169
  * +8: dword: flags field:
4113
  * +8: dword: flags field:
4170
    * bit 0 (mask 1): in what format to return names,
4114
    * bit 0 (mask 1): in what format to return names,
4171
      0=ANSI, 1=UNICODE
4115
      0=ANSI, 1=UNICODE
4172
    * other bits are reserved and must be set to 0 for the future
4116
    * other bits are reserved and must be set to 0 for the future
4173
      compatibility
4117
      compatibility
4174
  * +12 = +0xC: dword: number of blocks to read
4118
  * +12 = +0xC: dword: number of blocks to read
4175
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
4119
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
4176
    must be not less than 32 + [+12]*560 bytes
4120
    must be not less than 32 + [+12]*560 bytes
4177
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4121
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4178
    given in the general description
4122
    given in the general description
4179
    or
4123
    or
4180
  * +20 = +0x14: db 0
4124
  * +20 = +0x14: db 0
4181
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4125
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4182
Returned value:
4126
Returned value:
4183
  * eax = 0 - success, otherwise file system error code
4127
  * eax = 0 - success, otherwise file system error code
4184
  * ebx = number of files, information on which was written to
4128
  * ebx = number of files, information on which was written to
4185
    the buffer, or -1=0xffffffff, if folder was not found
4129
    the buffer, or -1=0xffffffff, if folder was not found
4186
Structure of the buffer:
4130
Structure of the buffer:
4187
  * +0: 32*byte: header
4131
  * +0: 32*byte: header
4188
  * +32 = +0x20: n1*byte: block with information on file 1
4132
  * +32 = +0x20: n1*byte: block with information on file 1
4189
  * +32+n1: n2*byte: block with information on file 2
4133
  * +32+n1: n2*byte: block with information on file 2
4190
  * ...
4134
  * ...
4191
Structure of header:
4135
Structure of header:
4192
  * +0: dword: version of structure (current is 1)
4136
  * +0: dword: version of structure (current is 1)
4193
  * +4: dword: number of placed blocks; is not greater than requested
4137
  * +4: dword: number of placed blocks; is not greater than requested
4194
    in the field +12 of information structure; can be less, if
4138
    in the field +12 of information structure; can be less, if
4195
    there are no more files in folder (the same as in ebx)
4139
    there are no more files in folder (the same as in ebx)
4196
  * +8: dword: total number of files in folder
4140
  * +8: dword: total number of files in folder
4197
  * +12 = +0xC: 20*byte: reserved (zeroed)
4141
  * +12 = +0xC: 20*byte: reserved (zeroed)
4198
Structure of block of data for folder entry (BDFE):
4142
Structure of block of data for folder entry (BDFE):
4199
  * +0: dword: attributes of file:
4143
  * +0: dword: attributes of file:
4200
    * bit 0 (mask 1): file is read-only
4144
    * bit 0 (mask 1): file is read-only
4201
    * bit 1 (mask 2): file is hidden
4145
    * bit 1 (mask 2): file is hidden
4202
    * bit 2 (mask 4): file is system
4146
    * bit 2 (mask 4): file is system
4203
    * bit 3 (mask 8): this is not a file but volume label
4147
    * bit 3 (mask 8): this is not a file but volume label
4204
      (for one partition meets no more than once and
4148
      (for one partition meets no more than once and
4205
      only in root folder)
4149
      only in root folder)
4206
    * bit 4 (mask 0x10): this is a folder
4150
    * bit 4 (mask 0x10): this is a folder
4207
    * bit 5 (mask 0x20): file was not archived - many archivation
4151
    * bit 5 (mask 0x20): file was not archived - many archivation
4208
      programs have an option to archive only files with this bit set,
4152
      programs have an option to archive only files with this bit set,
4209
      and after archiving this bit is cleared - it can be useful
4153
      and after archiving this bit is cleared - it can be useful
4210
      for automatically creating of backup-archives as at writing
4154
      for automatically creating of backup-archives as at writing
4211
      this bit is usually set
4155
      this bit is usually set
4212
  * +4: byte: type of name data:
4156
  * +4: byte: type of name data:
4213
    (coincides with bit 0 of flags in the information structure)
4157
    (coincides with bit 0 of flags in the information structure)
4214
    * 0 = ASCII = 1-byte representation of each character
4158
    * 0 = ASCII = 1-byte representation of each character
4215
    * 1 = UNICODE = 2-byte representation of each character
4159
    * 1 = UNICODE = 2-byte representation of each character
4216
  * +5: 3*byte: reserved (zero)
4160
  * +5: 3*byte: reserved (zero)
4217
  * +8: 4*byte: time of file creation
4161
  * +8: 4*byte: time of file creation
4218
  * +12 = +0xC: 4*byte: date of file creation
4162
  * +12 = +0xC: 4*byte: date of file creation
4219
  * +16 = +0x10: 4*byte: time of last access (read or write)
4163
  * +16 = +0x10: 4*byte: time of last access (read or write)
4220
  * +20 = +0x14: 4*byte: date of last access
4164
  * +20 = +0x14: 4*byte: date of last access
4221
  * +24 = +0x18: 4*byte: time of last modification
4165
  * +24 = +0x18: 4*byte: time of last modification
4222
  * +28 = +0x1C: 4*byte: date of last modification
4166
  * +28 = +0x1C: 4*byte: date of last modification
4223
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
4167
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
4224
  * +40 = +0x28: name
4168
  * +40 = +0x28: name
4225
    * for ASCII format: maximum length is 263 characters
4169
    * for ASCII format: maximum length is 263 characters
4226
      (263 bytes), byte after the name has value 0
4170
      (263 bytes), byte after the name has value 0
4227
    * for UNICODE format: maximum length is 259 characters
4171
    * for UNICODE format: maximum length is 259 characters
4228
      (518 bytes), 2 bytes after the name have value 0
4172
      (518 bytes), 2 bytes after the name have value 0
4229
Time format:
4173
Time format:
4230
  * +0: byte: seconds
4174
  * +0: byte: seconds
4231
  * +1: byte: minutes
4175
  * +1: byte: minutes
4232
  * +2: byte: hours
4176
  * +2: byte: hours
4233
  * +3: byte: reserved (0)
4177
  * +3: byte: reserved (0)
4234
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
4178
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
4235
Date format:
4179
Date format:
4236
  * +0: byte: day
4180
  * +0: byte: day
4237
  * +1: byte: month
4181
  * +1: byte: month
4238
  * +2: word: year
4182
  * +2: word: year
4239
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
4183
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
4240
Remarks:
4184
Remarks:
4241
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
4185
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
4242
    if UNICODE name - 560 bytes. Value of length is aligned
4186
    if UNICODE name - 560 bytes. Value of length is aligned
4243
    on 16-byte bound (to accelerate processing in CPU cache).
4187
    on 16-byte bound (to accelerate processing in CPU cache).
4244
  * First character after a name is zero (ASCIIZ-string). The further
4188
  * First character after a name is zero (ASCIIZ-string). The further
4245
    data contain garbage.
4189
    data contain garbage.
4246
  * If files in folder were ended before requested number was read,
4190
  * If files in folder were ended before requested number was read,
4247
    the function will read as many as it can, and after that return
4191
    the function will read as many as it can, and after that return
4248
    eax=6 (EOF).
4192
    eax=6 (EOF).
4249
  * Any folder on the disk, except for root, contains two special
4193
  * Any folder on the disk, except for root, contains two special
4250
    entries "." and "..", identifying accordingly the folder itself
4194
    entries "." and "..", identifying accordingly the folder itself
4251
    and the parent folder.
4195
    and the parent folder.
4252
  * The function allows also to read virtual folders "/", "/rd",
4196
  * The function allows also to read virtual folders "/", "/rd",
4253
    "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
4197
    "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
4254
    and times and dates are zeroed. An alternative way to get the
4198
    and times and dates are zeroed. An alternative way to get the
4255
    equipment information - subfunction 11 of function 18.
4199
    equipment information - subfunction 11 of function 18.
4256
 
4200
 
4257
======================================================================
4201
======================================================================
4258
===================== Function 70, subfunction 2 =====================
4202
===================== Function 70, subfunction 2 =====================
4259
============ Create/rewrite file with long names support. ============
4203
============ Create/rewrite file with long names support. ============
4260
======================================================================
4204
======================================================================
4261
Parameters:
4205
Parameters:
4262
  * eax = 70 - function number
4206
  * eax = 70 - function number
4263
  * ebx = pointer to the information structure
4207
  * ebx = pointer to the information structure
4264
Format of the information structure:
4208
Format of the information structure:
4265
  * +0: dword: 2 = subfunction number
4209
  * +0: dword: 2 = subfunction number
4266
  * +4: dword: 0 (reserved)
4210
  * +4: dword: 0 (reserved)
4267
  * +8: dword: 0 (reserved)
4211
  * +8: dword: 0 (reserved)
4268
  * +12 = +0xC: dword: number of bytes to read
4212
  * +12 = +0xC: dword: number of bytes to read
4269
  * +16 = +0x10: dword: pointer to data
4213
  * +16 = +0x10: dword: pointer to data
4270
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4214
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4271
    given in the general description
4215
    given in the general description
4272
    or
4216
    or
4273
  * +20 = +0x14: db 0
4217
  * +20 = +0x14: db 0
4274
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4218
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4275
Returned value:
4219
Returned value:
4276
  * eax = 0 - success, otherwise file system error code
4220
  * eax = 0 - success, otherwise file system error code
4277
  * ebx = number of written bytes (possibly 0)
4221
  * ebx = number of written bytes (possibly 0)
4278
Remarks:
4222
Remarks:
4279
  * If a file with given name did not exist, it is created;
4223
  * If a file with given name did not exist, it is created;
4280
    if it existed, it is rewritten.
4224
    if it existed, it is rewritten.
4281
  * If there is not enough free space on disk, the function will
4225
  * If there is not enough free space on disk, the function will
4282
    write as many as can and then return error code 8.
4226
    write as many as can and then return error code 8.
4283
  * The function is not supported for CD (returns error code 2).
4227
  * The function is not supported for CD (returns error code 2).
4284
 
4228
 
4285
======================================================================
4229
======================================================================
4286
===================== Function 70, subfunction 3 =====================
4230
===================== Function 70, subfunction 3 =====================
4287
=========== Write to existing file with long names support. ==========
4231
=========== Write to existing file with long names support. ==========
4288
======================================================================
4232
======================================================================
4289
Parameters:
4233
Parameters:
4290
  * eax = 70 - function number
4234
  * eax = 70 - function number
4291
  * ebx = pointer to the information structure
4235
  * ebx = pointer to the information structure
4292
Format of the information structure:
4236
Format of the information structure:
4293
  * +0: dword: 3 = subfunction number
4237
  * +0: dword: 3 = subfunction number
4294
  * +4: dword: file offset (in bytes)
4238
  * +4: dword: file offset (in bytes)
4295
  * +8: dword: high dword of offset (must be 0 for FAT)
4239
  * +8: dword: high dword of offset (must be 0 for FAT)
4296
  * +12 = +0xC: dword: number of bytes to write
4240
  * +12 = +0xC: dword: number of bytes to write
4297
  * +16 = +0x10: dword: pointer to data
4241
  * +16 = +0x10: dword: pointer to data
4298
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4242
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4299
    given in the general description
4243
    given in the general description
4300
    or
4244
    or
4301
  * +20 = +0x14: db 0
4245
  * +20 = +0x14: db 0
4302
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4246
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4303
Returned value:
4247
Returned value:
4304
  * eax = 0 - success, otherwise file system error code
4248
  * eax = 0 - success, otherwise file system error code
4305
  * ebx = number of written bytes (possibly 0)
4249
  * ebx = number of written bytes (possibly 0)
4306
Remarks:
4250
Remarks:
4307
  * The file must already exist, otherwise function returns eax=5.
4251
  * The file must already exist, otherwise function returns eax=5.
4308
  * The only result of write 0 bytes is update in the file attributes
4252
  * The only result of write 0 bytes is update in the file attributes
4309
    date/time of modification and access to the current date/time.
4253
    date/time of modification and access to the current date/time.
4310
  * If beginning and/or ending position is greater than file size
4254
  * If beginning and/or ending position is greater than file size
4311
    (except for the previous case), the file is expanded to needed
4255
    (except for the previous case), the file is expanded to needed
4312
    size with zero characters.
4256
    size with zero characters.
4313
  * The function is not supported for CD (returns error code 2).
4257
  * The function is not supported for CD (returns error code 2).
4314
 
4258
 
4315
======================================================================
4259
======================================================================
4316
============ Function 70, subfunction 4 - set end of file. ===========
4260
============ Function 70, subfunction 4 - set end of file. ===========
4317
======================================================================
4261
======================================================================
4318
Parameters:
4262
Parameters:
4319
  * eax = 70 - function number
4263
  * eax = 70 - function number
4320
  * ebx = pointer to the information structure
4264
  * ebx = pointer to the information structure
4321
Format of the information structure:
4265
Format of the information structure:
4322
  * +0: dword: 4 = subfunction number
4266
  * +0: dword: 4 = subfunction number
4323
  * +4: dword: low dword of new file size
4267
  * +4: dword: low dword of new file size
4324
  * +8: dword: high dword of new file size (must be 0 for FAT)
4268
  * +8: dword: high dword of new file size (must be 0 for FAT)
4325
  * +12 = +0xC: dword: 0 (reserved)
4269
  * +12 = +0xC: dword: 0 (reserved)
4326
  * +16 = +0x10: dword: 0 (reserved)
4270
  * +16 = +0x10: dword: 0 (reserved)
4327
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4271
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4328
    given in the general description
4272
    given in the general description
4329
    or
4273
    or
4330
  * +20 = +0x14: db 0
4274
  * +20 = +0x14: db 0
4331
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4275
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4332
Returned value:
4276
Returned value:
4333
  * eax = 0 - success, otherwise file system error code
4277
  * eax = 0 - success, otherwise file system error code
4334
  * ebx destroyed
4278
  * ebx destroyed
4335
Remarks:
4279
Remarks:
4336
  * If the new file size is less than old one, file is truncated.
4280
  * If the new file size is less than old one, file is truncated.
4337
    If the new size is greater than old one, file is expanded with
4281
    If the new size is greater than old one, file is expanded with
4338
    characters with code 0. If the new size is equal to old one,
4282
    characters with code 0. If the new size is equal to old one,
4339
    the only result of call is set date/time of modification and
4283
    the only result of call is set date/time of modification and
4340
    access to the current date/time.
4284
    access to the current date/time.
4341
  * If there is not enough free space on disk for expansion, the
4285
  * If there is not enough free space on disk for expansion, the
4342
    function will expand to maximum possible size and then return
4286
    function will expand to maximum possible size and then return
4343
    error code 8.
4287
    error code 8.
4344
  * The function is not supported for CD (returns error code 2).
4288
  * The function is not supported for CD (returns error code 2).
4345
 
4289
 
4346
======================================================================
4290
======================================================================
4347
==== Function 70, subfunction 5 - get information on file/folder. ====
4291
==== Function 70, subfunction 5 - get information on file/folder. ====
4348
======================================================================
4292
======================================================================
4349
Parameters:
4293
Parameters:
4350
  * eax = 70 - function number
4294
  * eax = 70 - function number
4351
  * ebx = pointer to the information structure
4295
  * ebx = pointer to the information structure
4352
Format of the information structure:
4296
Format of the information structure:
4353
  * +0: dword: 5 = subfunction number
4297
  * +0: dword: 5 = subfunction number
4354
  * +4: dword: 0 (reserved)
4298
  * +4: dword: 0 (reserved)
4355
  * +8: dword: 0 (reserved)
4299
  * +8: dword: 0 (reserved)
4356
  * +12 = +0xC: dword: 0 (reserved)
4300
  * +12 = +0xC: dword: 0 (reserved)
4357
  * +16 = +0x10: dword: pointer to buffer for data (40 bytes)
4301
  * +16 = +0x10: dword: pointer to buffer for data (40 bytes)
4358
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4302
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4359
    given in the general description
4303
    given in the general description
4360
    or
4304
    or
4361
  * +20 = +0x14: db 0
4305
  * +20 = +0x14: db 0
4362
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4306
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4363
Returned value:
4307
Returned value:
4364
  * eax = 0 - success, otherwise file system error code
4308
  * eax = 0 - success, otherwise file system error code
4365
  * ebx destroyed
4309
  * ebx destroyed
4366
Information on file is returned in the BDFE format (block of data
4310
Information on file is returned in the BDFE format (block of data
4367
for folder entry), explained in the description of
4311
for folder entry), explained in the description of
4368
subfunction 1, but without filename
4312
subfunction 1, but without filename
4369
(i.e. only first 40 = 0x28 bytes).
4313
(i.e. only first 40 = 0x28 bytes).
4370
Remarks:
4314
Remarks:
4371
  * The function does not support virtual folders such as /, /rd and
4315
  * The function does not support virtual folders such as /, /rd and
4372
    root folders like /rd/1.
4316
    root folders like /rd/1.
4373
 
4317
 
4374
======================================================================
4318
======================================================================
4375
===== Function 70, subfunction 6 - set attributes of file/folder. ====
4319
===== Function 70, subfunction 6 - set attributes of file/folder. ====
4376
======================================================================
4320
======================================================================
4377
Parameters:
4321
Parameters:
4378
  * eax = 70 - function number
4322
  * eax = 70 - function number
4379
  * ebx = pointer to the information structure
4323
  * ebx = pointer to the information structure
4380
Format of the information structure:
4324
Format of the information structure:
4381
  * +0: dword: 6 = subfunction number
4325
  * +0: dword: 6 = subfunction number
4382
  * +4: dword: 0 (reserved)
4326
  * +4: dword: 0 (reserved)
4383
  * +8: dword: 0 (reserved)
4327
  * +8: dword: 0 (reserved)
4384
  * +12 = +0xC: dword: 0 (reserved)
4328
  * +12 = +0xC: dword: 0 (reserved)
4385
  * +16 = +0x10: dword: pointer to buffer with attributes (32 bytes)
4329
  * +16 = +0x10: dword: pointer to buffer with attributes (32 bytes)
4386
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4330
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4387
    given in the general description
4331
    given in the general description
4388
    or
4332
    or
4389
  * +20 = +0x14: db 0
4333
  * +20 = +0x14: db 0
4390
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4334
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4391
Returned value:
4335
Returned value:
4392
  * eax = 0 - success, otherwise file system error code
4336
  * eax = 0 - success, otherwise file system error code
4393
  * ebx destroyed
4337
  * ebx destroyed
4394
File attributes are first 32 bytes in BDFE (block of data
4338
File attributes are first 32 bytes in BDFE (block of data
4395
for folder entry), explained in the description of subfunction 1
4339
for folder entry), explained in the description of subfunction 1
4396
(that is, without name and size of file). Attribute
4340
(that is, without name and size of file). Attribute
4397
file/folder/volume label (bits 3,4 in dword +0) is not changed.
4341
file/folder/volume label (bits 3,4 in dword +0) is not changed.
4398
Byte +4 (name format) is ignored.
4342
Byte +4 (name format) is ignored.
4399
Remarks:
4343
Remarks:
4400
  * The function does not support virtual folders such as /, /rd and
4344
  * The function does not support virtual folders such as /, /rd and
4401
    root folders like /rd/1.
4345
    root folders like /rd/1.
4402
  * The function is not supported for CD (returns error code 2).
4346
  * The function is not supported for CD (returns error code 2).
4403
 
4347
 
4404
======================================================================
4348
======================================================================
4405
=========== Function 70, subfunction 7 - start application. ==========
4349
=========== Function 70, subfunction 7 - start application. ==========
4406
======================================================================
4350
======================================================================
4407
Parameters:
4351
Parameters:
4408
  * eax = 70 - function number
4352
  * eax = 70 - function number
4409
  * ebx = pointer to the information structure
4353
  * ebx = pointer to the information structure
4410
Format of the information structure:
4354
Format of the information structure:
4411
  * +0: dword: 7 = subfunction number
4355
  * +0: dword: 7 = subfunction number
4412
  * +4: dword: flags field:
4356
  * +4: dword: flags field:
4413
    * áèò 0: start process as debugged
4357
    * áèò 0: start process as debugged
4414
    * other bits are reserved and must be set to 0
4358
    * other bits are reserved and must be set to 0
4415
  * +8: dword: 0 or pointer to ASCIIZ-string with parameters
4359
  * +8: dword: 0 or pointer to ASCIIZ-string with parameters
4416
  * +12 = +0xC: dword: 0 (reserved)
4360
  * +12 = +0xC: dword: 0 (reserved)
4417
  * +16 = +0x10: dword: 0 (reserved)
4361
  * +16 = +0x10: dword: 0 (reserved)
4418
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4362
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4419
    given in the general description
4363
    given in the general description
4420
    or
4364
    or
4421
  * +20 = +0x14: db 0
4365
  * +20 = +0x14: db 0
4422
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4366
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4423
Returned value:
4367
Returned value:
4424
  * eax > 0 - program is loaded, eax contains PID
4368
  * eax > 0 - program is loaded, eax contains PID
4425
  * eax < 0 - an error has occured, -eax contains
4369
  * eax < 0 - an error has occured, -eax contains
4426
    file system error code
4370
    file system error code
4427
  * ebx destroyed
4371
  * ebx destroyed
4428
Remarks:
4372
Remarks:
4429
  * Command line must be terminated by the character with the code 0
4373
  * Command line must be terminated by the character with the code 0
4430
    (ASCIIZ-string); function takes into account either all characters
4374
    (ASCIIZ-string); function takes into account either all characters
4431
    up to terminating zero inclusively or first 256 character
4375
    up to terminating zero inclusively or first 256 character
4432
    regarding what is less.
4376
    regarding what is less.
4433
  * If the process is started as debugged, it is created in
4377
  * If the process is started as debugged, it is created in
4434
    the suspended state; to run use subfunction 5 of function 69.
4378
    the suspended state; to run use subfunction 5 of function 69.
4435
 
4379
 
4436
======================================================================
4380
======================================================================
4437
========== Function 70, subfunction 8 - delete file/folder. ==========
4381
========== Function 70, subfunction 8 - delete file/folder. ==========
4438
======================================================================
4382
======================================================================
4439
Parameters:
4383
Parameters:
4440
  * eax = 70 - function number
4384
  * eax = 70 - function number
4441
  * ebx = pointer to the information structure
4385
  * ebx = pointer to the information structure
4442
Format of the information structure:
4386
Format of the information structure:
4443
  * +0: dword: 8 = subfunction number
4387
  * +0: dword: 8 = subfunction number
4444
  * +4: dword: 0 (reserved)
4388
  * +4: dword: 0 (reserved)
4445
  * +8: dword: 0 (reserved)
4389
  * +8: dword: 0 (reserved)
4446
  * +12 = +0xC: dword: 0 (reserved)
4390
  * +12 = +0xC: dword: 0 (reserved)
4447
  * +16 = +0x10: dword: 0 (reserved)
4391
  * +16 = +0x10: dword: 0 (reserved)
4448
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4392
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
4449
    given in the general description
4393
    given in the general description
4450
    or
4394
    or
4451
  * +20 = +0x14: db 0
4395
  * +20 = +0x14: db 0
4452
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4396
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
4453
Returned value:
4397
Returned value:
4454
  * eax = 0 - success, otherwise file system error code
4398
  * eax = 0 - success, otherwise file system error code
4455
  * ebx destroyed
4399
  * ebx destroyed
4456
Remarks:
4400
Remarks:
4457
  * The function is not supported for CD (returns error code 2).
4401
  * The function is not supported for CD (returns error code 2).
4458
  * The function can delete only empty folders (attempt to delete
4402
  * The function can delete only empty folders (attempt to delete
4459
    nonempty folder results in error with code 10, "access denied").
4403
    nonempty folder results in error with code 10, "access denied").
4460
 
4404
 
4461
======================================================================
4405
======================================================================
4462
============= Function 70, subfunction 9 - create folder. ============
4406
============= Function 70, subfunction 9 - create folder. ============
4463
======================================================================
4407
======================================================================
4464
Parameters:
4408
Parameters:
4465
  * eax = 70 - function number
4409
  * eax = 70 - function number
4466
  * ebx = pointer to the information structure
4410
  * ebx = pointer to the information structure
4467
Format of the information structure:
4411
Format of the information structure:
4468
  * +0: dword: 9 = subfunction number
4412
  * +0: dword: 9 = subfunction number
4469
  * +4: dword: 0 (reserved)
4413
  * +4: dword: 0 (reserved)
4470
  * +8: dword: 0 (reserved)
4414
  * +8: dword: 0 (reserved)
4471
  * +12 = +0xC: dword: 0 (reserved)
4415
  * +12 = +0xC: dword: 0 (reserved)
4472
  * +16 = +0x10: dword: 0 (reserved)
4416
  * +16 = +0x10: dword: 0 (reserved)
4473
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4417
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
4474
    given in the general description
4418
    given in the general description
4475
    or
4419
    or
4476
  * +20 = +0x14: db 0
4420
  * +20 = +0x14: db 0
4477
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
4421
  * +21 = +0x15: dd pointer to ASCIIZ-string with folder name
4478
Returned value:
4422
Returned value:
4479
  * eax = 0 - success, otherwise file system error code
4423
  * eax = 0 - success, otherwise file system error code
4480
  * ebx destroyed
4424
  * ebx destroyed
4481
Remarks:
4425
Remarks:
4482
  * The function is not supported for CD (returns error code 2).
4426
  * The function is not supported for CD (returns error code 2).
4483
  * The parent folder must already exist.
4427
  * The parent folder must already exist.
4484
  * If target folder already exists, function returns success (eax=0).
4428
  * If target folder already exists, function returns success (eax=0).
4485
 
4429
 
4486
======================================================================
4430
======================================================================
4487
========== Function 71, subfunction 1 - set window caption. ==========
4431
========== Function 71, subfunction 1 - set window caption. ==========
4488
======================================================================
4432
======================================================================
4489
Parameters:
4433
Parameters:
4490
  * eax = 71 - function number
4434
  * eax = 71 - function number
4491
  * ebx = 1 - subfunction number
4435
  * ebx = 1 - subfunction number
4492
  * ecx = pointer to caption string
4436
  * ecx = pointer to caption string
4493
Returned value:
4437
Returned value:
4494
  * function does not return value
4438
  * function does not return value
4495
Remarks:
4439
Remarks:
4496
  * String must be in the ASCIIZ-format. Disregarding real string
4440
  * String must be in the ASCIIZ-format. Disregarding real string
4497
    length, no more than 255 characters are drawn.
4441
    length, no more than 255 characters are drawn.
4498
  * Pass NULL in ecx to remove caption.
4442
  * Pass NULL in ecx to remove caption.
4499
 
4443
 
4500
======================================================================
4444
======================================================================
4501
=============== Function 72 - send message to a window. ==============
4445
=============== Function 72 - send message to a window. ==============
4502
======================================================================
4446
======================================================================
4503
 
4447
 
4504
- Subfunction 1 - send message with parameter to the active window. --
4448
- Subfunction 1 - send message with parameter to the active window. --
4505
Parameters:
4449
Parameters:
4506
  * eax = 72 - function number
4450
  * eax = 72 - function number
4507
  * ebx = 1 - subfunction number
4451
  * ebx = 1 - subfunction number
4508
  * ecx = event code: 2 or 3
4452
  * ecx = event code: 2 or 3
4509
  * edx = parameter: key code for ecx=2, button identifier for ecx=3
4453
  * edx = parameter: key code for ecx=2, button identifier for ecx=3
4510
Returned value:
4454
Returned value:
4511
  * eax = 0 - success
4455
  * eax = 0 - success
4512
  * eax = 1 - buffer is full
4456
  * eax = 1 - buffer is full
4513
 
4457
 
4514
======================================================================
4458
======================================================================
4515
=============== Function -1 - terminate thread/process ===============
4459
=============== Function -1 - terminate thread/process ===============
4516
======================================================================
4460
======================================================================
4517
Parameters:
4461
Parameters:
4518
  * eax = -1 - function number
4462
  * eax = -1 - function number
4519
Returned value:
4463
Returned value:
4520
  * function does not return neither value nor control
4464
  * function does not return neither value nor control
4521
Remarks:
4465
Remarks:
4522
  * If the process did not create threads obviously, it has only
4466
  * If the process did not create threads obviously, it has only
4523
    one thread, which termination results in process termination.
4467
    one thread, which termination results in process termination.
4524
  * If the current thread is last in the process, its termination
4468
  * If the current thread is last in the process, its termination
4525
    also results in process terminates.
4469
    also results in process terminates.
4526
  * This function terminates the current thread. Other thread can be
4470
  * This function terminates the current thread. Other thread can be
4527
    killed by call to subfunction 2 of function 18.
4471
    killed by call to subfunction 2 of function 18.
4528
 
4472
 
4529
======================================================================
4473
======================================================================
4530
=========================== List of events ===========================
4474
=========================== List of events ===========================
4531
======================================================================
4475
======================================================================
4532
Next event can be retrieved by the call of one from functions 10
4476
Next event can be retrieved by the call of one from functions 10
4533
(to wait for event), 11 (to check without waiting), 23
4477
(to wait for event), 11 (to check without waiting), 23
4534
(to wait during the given time).
4478
(to wait during the given time).
4535
These functions return only those events, which enter into a mask set
4479
These functions return only those events, which enter into a mask set
4536
by function 40. By default it is first three,
4480
by function 40. By default it is first three,
4537
there is enough for most applications.
4481
there is enough for most applications.
4538
Codes of events:
4482
Codes of events:
4539
  * 1 = redraw event (is reset by call to function 0)
4483
  * 1 = redraw event (is reset by call to function 0)
4540
  * 2 = key on keyboard is pressed (acts, only when the window is
4484
  * 2 = key on keyboard is pressed (acts, only when the window is
4541
    active) or hotkey is pressed; is reset, when all keys from
4485
    active) or hotkey is pressed; is reset, when all keys from
4542
    the buffer are read out by function 2
4486
    the buffer are read out by function 2
4543
  * 3 = button is pressed, defined earlier by function 8
4487
  * 3 = button is pressed, defined earlier by function 8
4544
    (or close button, created implicitly by function 0;
4488
    (or close button, created implicitly by function 0;
4545
    minimize button is handled by the system and sends no message;
4489
    minimize button is handled by the system and sends no message;
4546
    acts, only when the window is active;
4490
    acts, only when the window is active;
4547
    is reset when all buttons from the buffer
4491
    is reset when all buttons from the buffer
4548
    are read out by function 17)
4492
    are read out by function 17)
4549
  * 4 = reserved (in current implementation never comes even after
4493
  * 4 = reserved (in current implementation never comes even after
4550
    unmasking by function 40)
4494
    unmasking by function 40)
4551
  * 5 = the desktop background is redrawed (is reset automatically
4495
  * 5 = the desktop background is redrawed (is reset automatically
4552
    after redraw, so if in redraw time program does not wait and
4496
    after redraw, so if in redraw time program does not wait and
4553
    does not check events, it will not remark this event)
4497
    does not check events, it will not remark this event)
4554
  * 6 = mouse event (something happened - button pressing or moving;
4498
  * 6 = mouse event (something happened - button pressing or moving;
4555
    is reset at reading)
4499
    is reset at reading)
4556
  * 7 = IPC event (see function 60 -
4500
  * 7 = IPC event (see function 60 -
4557
    Inter Process Communication; is reset at reading)
4501
    Inter Process Communication; is reset at reading)
4558
  * 8 = network event (is reset at reading)
4502
  * 8 = network event (is reset at reading)
4559
  * 9 = debug event (is reset at reading; see
4503
  * 9 = debug event (is reset at reading; see
4560
    debug subsystem)
4504
    debug subsystem)
4561
  * 16..31 = event with appropriate IRQ
4505
  * 16..31 = event with appropriate IRQ
4562
    (16=IRQ0, 31=IRQ15) (is reset after reading all IRQ data)
4506
    (16=IRQ0, 31=IRQ15) (is reset after reading all IRQ data)
4563
 
4507
 
4564
======================================================================
4508
======================================================================
4565
=================== Error codes of the file system ===================
4509
=================== Error codes of the file system ===================
4566
======================================================================
4510
======================================================================
4567
  * 0 = success
4511
  * 0 = success
4568
  * 1 = base and/or partition of a hard disk is not defined
4512
  * 1 = base and/or partition of a hard disk is not defined
4569
    (by subfunctions 7, 8 of function 21)
4513
    (by subfunctions 7, 8 of function 21)
4570
  * 2 = function is not supported for the given file system
4514
  * 2 = function is not supported for the given file system
4571
  * 3 = unknown file system
4515
  * 3 = unknown file system
4572
  * 4 = reserved, is never returned in the current implementation
4516
  * 4 = reserved, is never returned in the current implementation
4573
  * 5 = file not found
4517
  * 5 = file not found
4574
  * 6 = end of file, EOF
4518
  * 6 = end of file, EOF
4575
  * 7 = pointer lies outside of application memory
4519
  * 7 = pointer lies outside of application memory
4576
  * 8 = disk is full
4520
  * 8 = disk is full
4577
  * 9 = FAT table is destroyed
4521
  * 9 = FAT table is destroyed
4578
  * 10 = access denied
4522
  * 10 = access denied
4579
  * 11 = device error
4523
  * 11 = device error
4580
Application start functions can return also following errors:
4524
Application start functions can return also following errors:
4581
  * 30 = 0x1E = not enough memory
4525
  * 30 = 0x1E = not enough memory
4582
  * 31 = 0x1F = file is not executable
4526
  * 31 = 0x1F = file is not executable
4583
  * 32 = 0x20 = too many processes
4527
  * 32 = 0x20 = too many processes
4584
>
4528
>
4585
>
4529
>