Subversion Repositories Kolibri OS

Rev

Rev 5848 | Rev 5865 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 5848 Rev 5851
1
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
2
;;                                                              ;;
2
;;                                                              ;;
3
;; Copyright (C) KolibriOS team 2004-2012. All rights reserved. ;;
3
;; Copyright (C) KolibriOS team 2004-2012. All rights reserved. ;;
4
;; Distributed under terms of the GNU General Public License    ;;
4
;; Distributed under terms of the GNU General Public License    ;;
5
;;                                                              ;;
5
;;                                                              ;;
6
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
6
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
7
 
7
 
8
SYSTEM FUNCTIONS of OS Kolibri 0.7.7.0
8
SYSTEM FUNCTIONS of OS Kolibri 0.7.7.0
9
 
9
 
10
Number of the function is located in the register eax.
10
Number of the function is located in the register eax.
11
The call of the system function is executed by "int 0x40" command.
11
The call of the system function is executed by "int 0x40" command.
12
All registers except explicitly declared in the returned value,
12
All registers except explicitly declared in the returned value,
13
    including eflags, are preserved.
13
    including eflags, are preserved.
14
 
14
 
15
 
15
 
16
======================================================================
16
======================================================================
17
============== Function 0 - define and draw the window. ==============
17
============== Function 0 - define and draw the window. ==============
18
======================================================================
18
======================================================================
19
Defines an application window. Draws a frame of the window, header and
19
Defines an application window. Draws a frame of the window, header and
20
working area. For skinned windows defines standard close and minimize
20
working area. For skinned windows defines standard close and minimize
21
buttons.
21
buttons.
22
Parameters:
22
Parameters:
23
  * eax = 0 - function number
23
  * eax = 0 - function number
24
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
24
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
25
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
25
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
26
  * edx = 0xXYRRGGBB, where:
26
  * edx = 0xXYRRGGBB, where:
27
    * Y = style of the window:
27
    * Y = style of the window:
28
      * Y=0 - type I - fixed-size window
28
      * Y=0 - type I - fixed-size window
29
      * Y=1 - only define window area, draw nothing
29
      * Y=1 - only define window area, draw nothing
30
      * Y=2 - type II - variable-size window
30
      * Y=2 - type II - variable-size window
31
      * Y=3 - skinned window
31
      * Y=3 - skinned window
32
      * Y=4 - skinned fixed-size window
32
      * Y=4 - skinned fixed-size window
33
      * other possible values (from 5 up to 15) are reserved,
33
      * other possible values (from 5 up to 15) are reserved,
34
        function call with such Y is ignored
34
        function call with such Y is ignored
35
    * RR, GG, BB = accordingly red, green, blue components of a color
35
    * RR, GG, BB = accordingly red, green, blue components of a color
36
      of the working area of the window (are ignored for style Y=1)
36
      of the working area of the window (are ignored for style Y=1)
37
    * X = DCBA (bits)
37
    * X = DCBA (bits)
38
      * A = 1 - window has caption; for styles Y=3,4 caption string
38
      * A = 1 - window has caption; for styles Y=3,4 caption string
39
                  must be passed in edi, for other styles use
39
                  must be passed in edi, for other styles use
40
                  subfunction 1 of function 71
40
                  subfunction 1 of function 71
41
      * B = 1 - coordinates of all graphics primitives are relative to
41
      * B = 1 - coordinates of all graphics primitives are relative to
42
                  window client area
42
                  window client area
43
      * C = 1 - don't fill working area on window draw
43
      * C = 1 - don't fill working area on window draw
44
      * D = 0 - normal filling of the working area, 1 - gradient
44
      * D = 0 - normal filling of the working area, 1 - gradient
45
    The following parameters are intended for windows
45
    The following parameters are intended for windows
46
    of a type I and II, and ignored for styles Y=1,3:
46
    of a type I and II, and ignored for styles Y=1,3:
47
  * esi = 0xXYRRGGBB - color of the header
47
  * esi = 0xXYRRGGBB - color of the header
48
    * RR, GG, BB define color
48
    * RR, GG, BB define color
49
    * Y=0 - usual window, Y=1 - unmovable window (works for all window styles)
49
    * Y=0 - usual window, Y=1 - unmovable window (works for all window styles)
50
    * X defines a gradient of header: X=0 - no gradient,
50
    * X defines a gradient of header: X=0 - no gradient,
51
      X=8 - usual gradient,
51
      X=8 - usual gradient,
52
      for windows of a type II X=4 - negative gradient
52
      for windows of a type II X=4 - negative gradient
53
    * other values of X and Y are reserved
53
    * other values of X and Y are reserved
54
  * edi = 0x00RRGGBB - color of the frame
54
  * edi = 0x00RRGGBB - color of the frame
55
Returned value:
55
Returned value:
56
  * function does not return value
56
  * function does not return value
57
Remarks:
57
Remarks:
58
  * Position and sizes of the window are installed by the first
58
  * Position and sizes of the window are installed by the first
59
    call of this function and are ignored at subsequent; to change
59
    call of this function and are ignored at subsequent; to change
60
    position and/or sizes of already created window use function 67.
60
    position and/or sizes of already created window use function 67.
61
  * For windows with styles Y=3,4 and caption (A=1) caption string
61
  * For windows with styles Y=3,4 and caption (A=1) caption string
62
    is set by the first call of this function and is ignored
62
    is set by the first call of this function and is ignored
63
    at subsequent (strictly speaking, is ignored after a call to
63
    at subsequent (strictly speaking, is ignored after a call to
64
    subfunction 2 of function 12 - end redraw); to change caption of
64
    subfunction 2 of function 12 - end redraw); to change caption of
65
    already created window use subfunction 1 of function 71.
65
    already created window use subfunction 1 of function 71.
66
  * If the window has appropriate styles, position and/or sizes can be
66
  * If the window has appropriate styles, position and/or sizes can be
67
    changed by user. Current position and sizes can be obtained
67
    changed by user. Current position and sizes can be obtained
68
    by function 9.
68
    by function 9.
69
  * The window must fit on the screen. If the transferred
69
  * The window must fit on the screen. If the transferred
70
    coordinates and sizes do not satisfy to this condition,
70
    coordinates and sizes do not satisfy to this condition,
71
    appropriate coordinate (or, probably, both) is considered as zero,
71
    appropriate coordinate (or, probably, both) is considered as zero,
72
    and if it does not help too, the appropriate size
72
    and if it does not help too, the appropriate size
73
    (or, probably, both) is installed in a size of the screen.
73
    (or, probably, both) is installed in a size of the screen.
74
 
74
 
75
    Further let us designate xpos,ypos,xsize,ysize - values passed
75
    Further let us designate xpos,ypos,xsize,ysize - values passed
76
    in ebx,ecx. The coordinates are resulted concerning
76
    in ebx,ecx. The coordinates are resulted concerning
77
    the left upper corner of the window, which, thus, is set as (0,0),
77
    the left upper corner of the window, which, thus, is set as (0,0),
78
    coordinates of the right lower corner essence (xsize,ysize).
78
    coordinates of the right lower corner essence (xsize,ysize).
79
  * The sizes of the window are understood in sence of coordinates
79
  * The sizes of the window are understood in sence of coordinates
80
    of the right lower corner. This concerns all other functions too.
80
    of the right lower corner. This concerns all other functions too.
81
    It means, that the real sizes are on 1 pixel more.
81
    It means, that the real sizes are on 1 pixel more.
82
  * The window of type I looks as follows:
82
  * The window of type I looks as follows:
83
    * draw external frame of color indicated in edi, 1 pixel in width
83
    * draw external frame of color indicated in edi, 1 pixel in width
84
    * draw header - rectangle with the left upper corner (1,1) and
84
    * draw header - rectangle with the left upper corner (1,1) and
85
      right lower (xsize-1,min(20,ysize-1)) color indicated in esi
85
      right lower (xsize-1,min(20,ysize-1)) color indicated in esi
86
      (taking a gradient into account)
86
      (taking a gradient into account)
87
    * if ysize>21, fill the working area of the window -
87
    * if ysize>21, fill the working area of the window -
88
      rectangle with the left upper corner (1,21) and right lower
88
      rectangle with the left upper corner (1,21) and right lower
89
      (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color
89
      (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color
90
      indicated in edx (taking a gradient into account)
90
      indicated in edx (taking a gradient into account)
91
    * if A=1 and caption has been already set by subfunction 1
91
    * if A=1 and caption has been already set by subfunction 1
92
      of function 71, it is drawn in the corresponding place of header
92
      of function 71, it is drawn in the corresponding place of header
93
  * The window of style Y=1 looks as follows:
93
  * The window of style Y=1 looks as follows:
94
    * completely defined by the application
94
    * completely defined by the application
95
  * The window of type II looks as follows:
95
  * The window of type II looks as follows:
96
    * draw external frame of width 1 pixel with the "shaded" color
96
    * draw external frame of width 1 pixel with the "shaded" color
97
      edi (all components of the color decrease twice)
97
      edi (all components of the color decrease twice)
98
    * draw intermediate frame of width 3 pixels with color edi
98
    * draw intermediate frame of width 3 pixels with color edi
99
    * draw internal frame of width 1 pixel with the "shaded" color edi
99
    * draw internal frame of width 1 pixel with the "shaded" color edi
100
    * draw header - rectangle with the left upper corner (4,4)
100
    * draw header - rectangle with the left upper corner (4,4)
101
      and right lower (xsize-4,min(20,ysize)) color, indicated in esi
101
      and right lower (xsize-4,min(20,ysize)) color, indicated in esi
102
      (taking a gradient into account)
102
      (taking a gradient into account)
103
    * if ysize>=26, fill the working area of the window -
103
    * if ysize>=26, fill the working area of the window -
104
      rectangle with the left upper corner (5,20) and right lower
104
      rectangle with the left upper corner (5,20) and right lower
105
      (xsize-5,ysize-5) with color indicated in edx
105
      (xsize-5,ysize-5) with color indicated in edx
106
      (taking a gradient into account)
106
      (taking a gradient into account)
107
    * if A=1 and caption has been already set by subfunction 1
107
    * if A=1 and caption has been already set by subfunction 1
108
      of function 71, it is drawn in the corresponding place of header
108
      of function 71, it is drawn in the corresponding place of header
109
  * The skinned window looks as follows:
109
  * The skinned window looks as follows:
110
    * draw external frame of width 1 pixel
110
    * draw external frame of width 1 pixel
111
      with color 'outer' from the skin
111
      with color 'outer' from the skin
112
    * draw intermediate frame of width 3 pixel
112
    * draw intermediate frame of width 3 pixel
113
      with color 'frame' from the skin
113
      with color 'frame' from the skin
114
    * draw internal frame of width 1 pixel
114
    * draw internal frame of width 1 pixel
115
      with color 'inner' from the skin
115
      with color 'inner' from the skin
116
    * draw header (on bitmaps from the skin) in a rectangle
116
    * draw header (on bitmaps from the skin) in a rectangle
117
      (0,0) - (xsize,_skinh-1)
117
      (0,0) - (xsize,_skinh-1)
118
    * if ysize>=26, fill the working area of the window -
118
    * if ysize>=26, fill the working area of the window -
119
      rectangle with the left upper corner (5,_skinh) and right lower
119
      rectangle with the left upper corner (5,_skinh) and right lower
120
      (xsize-5,ysize-5) with color indicated in edx
120
      (xsize-5,ysize-5) with color indicated in edx
121
      (taking a gradient into account)
121
      (taking a gradient into account)
122
    * define two standard buttons: close and minimize
122
    * define two standard buttons: close and minimize
123
      (see function 8)
123
      (see function 8)
124
    * if A=1 and edi contains (nonzero) pointer to caption string,
124
    * if A=1 and edi contains (nonzero) pointer to caption string,
125
      it is drawn in place in header defined in the skin
125
      it is drawn in place in header defined in the skin
126
    * value _skinh is accessible as the result of call
126
    * value _skinh is accessible as the result of call
127
      subfunction 4 of function 48
127
      subfunction 4 of function 48
128
 
128
 
129
======================================================================
129
======================================================================
130
================ Function 1 - put pixel in the window. ===============
130
================ Function 1 - put pixel in the window. ===============
131
======================================================================
131
======================================================================
132
Parameters:
132
Parameters:
133
  * eax = 1 - function number
133
  * eax = 1 - function number
134
  * ebx = x-coordinate (relative to the window)
134
  * ebx = x-coordinate (relative to the window)
135
  * ecx = y-coordinate (relative to the window)
135
  * ecx = y-coordinate (relative to the window)
136
  * edx = 0x00RRGGBB - color of a pixel
136
  * edx = 0x00RRGGBB - color of a pixel
137
    edx = 0x01xxxxxx - invert color of a pixel
137
    edx = 0x01xxxxxx - invert color of a pixel
138
          (low 24 bits are ignored)
138
          (low 24 bits are ignored)
139
Returned value:
139
Returned value:
140
  * function does not return value
140
  * function does not return value
141
 
141
 
142
======================================================================
142
======================================================================
143
============ Function 2 - get the code of the pressed key. ===========
143
============ Function 2 - get the code of the pressed key. ===========
144
======================================================================
144
======================================================================
145
Takes away the code of the pressed key from the buffer.
145
Takes away the code of the pressed key from the buffer.
146
Parameters:
146
Parameters:
147
  * eax = 2 - function number
147
  * eax = 2 - function number
148
Returned value:
148
Returned value:
149
  * if the buffer is empty, function returns eax=1
149
  * if the buffer is empty, function returns eax=1
150
  * if the buffer is not empty, function returns al=0,
150
  * if the buffer is not empty, function returns al=0,
151
    ah=code of the pressed key,
151
    ah=code of the pressed key,
152
    bits 16-23 = contain scancode for pressed key in ASCII mode,
152
    bits 16-23 = contain scancode for pressed key in ASCII mode,
153
                 in the scancodes mode this bits cleared.
153
                 in the scancodes mode this bits cleared.
154
    bits 23-31 = zero
154
    bits 23-31 = zero
155
  * if there is "hotkey", function returns al=2,
155
  * if there is "hotkey", function returns al=2,
156
    ah=scancode of the pressed key (0 for control keys),
156
    ah=scancode of the pressed key (0 for control keys),
157
    high word of eax contains a status of control keys at the moment
157
    high word of eax contains a status of control keys at the moment
158
    of pressing a hotkey
158
    of pressing a hotkey
159
Remarks:
159
Remarks:
160
  * There is a common system buffer of the pressed keys
160
  * There is a common system buffer of the pressed keys
161
    by a size of 120 bytes, organized as queue.
161
    by a size of 120 bytes, organized as queue.
162
  * There is one more common system buffer on 120 "hotkeys".
162
  * There is one more common system buffer on 120 "hotkeys".
163
  * If the application with the inactive window calls this function,
163
  * If the application with the inactive window calls this function,
164
    the buffer of the pressed keys is considered to be empty.
164
    the buffer of the pressed keys is considered to be empty.
165
  * By default this function returns ASCII-codes; to switch
165
  * By default this function returns ASCII-codes; to switch
166
    to the scancodes mode (and back) use function 66.
166
    to the scancodes mode (and back) use function 66.
167
    However, hotkeys are always notificated as scancodes.
167
    However, hotkeys are always notificated as scancodes.
168
  * To find out, what keys correspond to what codes, start
168
  * To find out, what keys correspond to what codes, start
169
    the application keyascii and scancode.
169
    the application keyascii and scancode.
170
  * Scancodes come directly from keyboard and are fixed;
170
  * Scancodes come directly from keyboard and are fixed;
171
    ASCII-codes turn out with usage of the conversion tables,
171
    ASCII-codes turn out with usage of the conversion tables,
172
    which can be set by subfunction 2 of function 21
172
    which can be set by subfunction 2 of function 21
173
    and get by subfunction 2 of function 26.
173
    and get by subfunction 2 of function 26.
174
  * As a consequence, ASCII-codes take into account current
174
  * As a consequence, ASCII-codes take into account current
175
    keyboard layout (rus/en) as opposed to scancodes.
175
    keyboard layout (rus/en) as opposed to scancodes.
176
  * This function notifies only about those hotkeys, which were
176
  * This function notifies only about those hotkeys, which were
177
    defined by this thread by subfunction 4 of function 66.
177
    defined by this thread by subfunction 4 of function 66.
178
 
178
 
179
======================================================================
179
======================================================================
180
==================== Function 3 - get system time. ===================
180
==================== Function 3 - get system time. ===================
181
======================================================================
181
======================================================================
182
Parameters:
182
Parameters:
183
  * eax = 3 - function number
183
  * eax = 3 - function number
184
Returned value:
184
Returned value:
185
  * eax = 0x00SSMMHH, where HH:MM:SS = Hours:Minutes:Seconds
185
  * eax = 0x00SSMMHH, where HH:MM:SS = Hours:Minutes:Seconds
186
  * each item is BCD-number, for example,
186
  * each item is BCD-number, for example,
187
    for time 23:59:59 function returns 0x00595923
187
    for time 23:59:59 function returns 0x00595923
188
Remarks:
188
Remarks:
189
  * See also subfunction 9 of function 26 - get time from
189
  * See also subfunction 9 of function 26 - get time from
190
    the moment of start of the system; it is more convenient, because
190
    the moment of start of the system; it is more convenient, because
191
    returns simply DWORD-value of the time counter.
191
    returns simply DWORD-value of the time counter.
192
  * System time can be set by function 22.
192
  * System time can be set by function 22.
193
 
193
 
194
======================================================================
194
======================================================================
195
=================== Function 4 - draw text string. ===================
195
=================== Function 4 - draw text string. ===================
196
======================================================================
196
======================================================================
197
Parameters:
197
Parameters:
198
  * eax = 4 - function number
198
  * eax = 4 - function number
199
  * ebx = X*65536+Y, coordinates in the window or buffer
199
  * ebx = X*65536+Y, coordinates in the window or buffer
200
  * ecx = 0xXXRRGGBB, where
200
  * ecx = 0xXXRRGGBB, where
201
    * RR, GG, BB specify text color
201
    * RR, GG, BB specify text color
202
    * XX = ABFFCSSS (bits):
202
    * XX = ABFFCSSS (bits):
203
      * A=1 - output zero terminated string
203
      * A=1 - output zero terminated string
204
      * B=1 - fill background (color = edi)
204
      * B=1 - fill background (color = edi)
205
      * FF specifies the font and encoding:
205
      * FF specifies the font and encoding:
206
        0 = 6x9  cp866
206
        0 = 6x9  cp866
207
        2 = 8x16 UTF-16LE
207
        2 = 8x16 UTF-16LE
208
        3 = 8x16 UTF-8
208
        3 = 8x16 UTF-8
209
      * C=0 - draw to the window,
209
      * C=0 - draw to the window,
210
        C=1 - draw to the user buffer (edi)
210
        C=1 - draw to the user buffer (edi)
211
      * SSS = (size multiplier)-1, so 0 = x1, 7 = x8
211
      * SSS = (size multiplier)-1, so 0 = x1, 7 = x8
212
  * edx = pointer to the beginning of the string
212
  * edx = pointer to the beginning of the string
213
  * esi = for A=0 length of the string, for A=1 is ignored
213
  * esi = for A=0 length of the string, for A=1 is ignored
214
  * edi = for B=1 color to fill background,
214
  * edi = for B=1 color to fill background,
215
          for C=1 pointer to user buffer
215
          for C=1 pointer to user buffer
216
 
216
 
217
Returned value:
217
Returned value:
218
  * function does not return value
218
  * function does not return value
219
Remarks:
219
Remarks:
220
  * You can not use B=1 and C=1 at the same time, since both use edi.
220
  * You can not use B=1 and C=1 at the same time, since both use edi.
221
  * When SSS=0, font may be smoothed, depending on system setting.
221
  * When SSS=0, font may be smoothed, depending on system setting.
222
  * User buffer structure:
222
  * User buffer structure:
223
Xsize       dd
223
Xsize       dd
224
Ysize       dd
224
Ysize       dd
225
picture     rb  Xsize*Ysize*4  ; 32 bpp
225
picture     rb  Xsize*Ysize*4  ; 32 bpp
226
 
226
 
227
======================================================================
227
======================================================================
228
========================= Function 5 - delay. ========================
228
========================= Function 5 - delay. ========================
229
======================================================================
229
======================================================================
230
Delays execution of the program on the given time.
230
Delays execution of the program on the given time.
231
Parameters:
231
Parameters:
232
  * eax = 5 - function number
232
  * eax = 5 - function number
233
  * ebx = time in the 1/100 of second
233
  * ebx = time in the 1/100 of second
234
Returned value:
234
Returned value:
235
  * function does not return value
235
  * function does not return value
236
Remarks:
236
Remarks:
237
  * Passing ebx=0 does not transfer control to the next process
237
  * Passing ebx=0 does not transfer control to the next process
238
    and does not make any operations at all. If it is really required
238
    and does not make any operations at all. If it is really required
239
    to transfer control to the next process (to complete a current
239
    to transfer control to the next process (to complete a current
240
    time slice), use subfunction 1 of function 68.
240
    time slice), use subfunction 1 of function 68.
241
 
241
 
242
======================================================================
242
======================================================================
243
============== Function 6 - read the file from ramdisk. ==============
243
============== Function 6 - read the file from ramdisk. ==============
244
======================================================================
244
======================================================================
245
Parameters:
245
Parameters:
246
  * eax = 6 - function number
246
  * eax = 6 - function number
247
  * ebx = pointer to the filename
247
  * ebx = pointer to the filename
248
  * ecx = number of start block, beginning from 1;
248
  * ecx = number of start block, beginning from 1;
249
    ecx=0 - read from the beginning of the file (same as ecx=1)
249
    ecx=0 - read from the beginning of the file (same as ecx=1)
250
  * edx = number of blocks to read;
250
  * edx = number of blocks to read;
251
    edx=0 - read one block (same as edx=1)
251
    edx=0 - read one block (same as edx=1)
252
  * esi = pointer to memory area for the data
252
  * esi = pointer to memory area for the data
253
Returned value:
253
Returned value:
254
  * eax = file size in bytes, if the file was successfully read
254
  * eax = file size in bytes, if the file was successfully read
255
  * eax = -1, if the file was not found
255
  * eax = -1, if the file was not found
256
Remarks:
256
Remarks:
257
  * This function is out-of-date; function 70 allows
257
  * This function is out-of-date; function 70 allows
258
    to fulfil the same operations with the extended possibilities.
258
    to fulfil the same operations with the extended possibilities.
259
  * Block = 512 bytes.
259
  * Block = 512 bytes.
260
  * For reading all file you can specify the certainly large value
260
  * For reading all file you can specify the certainly large value
261
    in edx, for example, edx = -1; but in this case be ready that
261
    in edx, for example, edx = -1; but in this case be ready that
262
    the program will "fall", if the file will appear too large and can
262
    the program will "fall", if the file will appear too large and can
263
    not be placed in the program memory.
263
    not be placed in the program memory.
264
  * The filename must be either in the format 8+3 characters
264
  * The filename must be either in the format 8+3 characters
265
    (first 8 characters - name itself, last 3 - extension,
265
    (first 8 characters - name itself, last 3 - extension,
266
    the short names and extensions are supplemented with spaces),
266
    the short names and extensions are supplemented with spaces),
267
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
267
    or in the format 8.3 characters "FILE.EXT"/"FILE.EX "
268
    (name no more than 8 characters, dot, extension 3 characters
268
    (name no more than 8 characters, dot, extension 3 characters
269
    supplemented if necessary by spaces).
269
    supplemented if necessary by spaces).
270
    The filename must be written with capital letters. The terminating
270
    The filename must be written with capital letters. The terminating
271
    character with code 0 is not necessary (not ASCIIZ-string).
271
    character with code 0 is not necessary (not ASCIIZ-string).
272
  * This function does not support folders on the ramdisk.
272
  * This function does not support folders on the ramdisk.
273
 
273
 
274
======================================================================
274
======================================================================
275
=============== Function 7 - draw image in the window. ===============
275
=============== Function 7 - draw image in the window. ===============
276
======================================================================
276
======================================================================
277
Paramters:
277
Paramters:
278
  * eax = 7 - function number
278
  * eax = 7 - function number
279
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
279
  * ebx = pointer to the image in the format BBGGRRBBGGRR...
280
  * ecx = [size on axis x]*65536 + [size on axis y]
280
  * ecx = [size on axis x]*65536 + [size on axis y]
281
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
281
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
282
Returned value:
282
Returned value:
283
  * function does not return value
283
  * function does not return value
284
Remarks:
284
Remarks:
285
  * Coordinates of the image are coordinates of the upper left corner
285
  * Coordinates of the image are coordinates of the upper left corner
286
    of the image relative to the window.
286
    of the image relative to the window.
287
  * Size of the image in bytes is 3*xsize*ysize.
287
  * Size of the image in bytes is 3*xsize*ysize.
288
 
288
 
289
======================================================================
289
======================================================================
290
=============== Function 8 - define/delete the button. ===============
290
=============== Function 8 - define/delete the button. ===============
291
======================================================================
291
======================================================================
292
Parameters for button definition:
292
Parameters for button definition:
293
  * eax = 8 - function number
293
  * eax = 8 - function number
294
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
294
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
295
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
295
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
296
  * edx = 0xXYnnnnnn, where:
296
  * edx = 0xXYnnnnnn, where:
297
    * nnnnnn = identifier of the button
297
    * nnnnnn = identifier of the button
298
    * high (31st) bit of edx is cleared
298
    * high (31st) bit of edx is cleared
299
    * if 30th bit of edx is set - do not draw the button
299
    * if 30th bit of edx is set - do not draw the button
300
    * if 29th bit of edx is set - do not draw a frame
300
    * if 29th bit of edx is set - do not draw a frame
301
      at pressing the button
301
      at pressing the button
302
  * esi = 0x00RRGGBB - color of the button
302
  * esi = 0x00RRGGBB - color of the button
303
Parameters for button deleting:
303
Parameters for button deleting:
304
  * eax = 8 - function number
304
  * eax = 8 - function number
305
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
305
  * edx = 0x80nnnnnn, where nnnnnn - identifier of the button
306
Returned value:
306
Returned value:
307
  * function does not return value
307
  * function does not return value
308
Remarks:
308
Remarks:
309
  * Sizes of the button must be more than 0 and less than 0x8000.
309
  * Sizes of the button must be more than 0 and less than 0x8000.
310
  * For skinned windows definition of the window
310
  * For skinned windows definition of the window
311
    (call of 0th function) creates two standard buttons -
311
    (call of 0th function) creates two standard buttons -
312
    for close of the window with identifier 1 and
312
    for close of the window with identifier 1 and
313
    for minimize of the window with identifier 0xffff.
313
    for minimize of the window with identifier 0xffff.
314
  * The creation of two buttons with same identifiers is admitted.
314
  * The creation of two buttons with same identifiers is admitted.
315
  * The button with the identifier 0xffff at pressing is interpreted
315
  * The button with the identifier 0xffff at pressing is interpreted
316
    by the system as the button of minimization, the system handles
316
    by the system as the button of minimization, the system handles
317
    such pressing independently, not accessing to the application.
317
    such pressing independently, not accessing to the application.
318
    In rest it is usual button.
318
    In rest it is usual button.
319
  * Total number of buttons for all applications is limited to 4095.
319
  * Total number of buttons for all applications is limited to 4095.
320
 
320
 
321
======================================================================
321
======================================================================
322
============ Function 9 - information on execution thread. ===========
322
============ Function 9 - information on execution thread. ===========
323
======================================================================
323
======================================================================
324
Parameters:
324
Parameters:
325
  * eax = 9 - function number
325
  * eax = 9 - function number
326
  * ebx = pointer to 1-Kb buffer
326
  * ebx = pointer to 1-Kb buffer
327
  * ecx = number of the slot of the thread
327
  * ecx = number of the slot of the thread
328
    ecx = -1 - get information on the current thread
328
    ecx = -1 - get information on the current thread
329
Returned value:
329
Returned value:
330
  * eax = maximum number of the slot of a thread
330
  * eax = maximum number of the slot of a thread
331
  * buffer pointed to by ebx contains the following information:
331
  * buffer pointed to by ebx contains the following information:
332
    * +0: dword: usage of the processor (how many time units
332
    * +0: dword: usage of the processor (how many time units
333
      per second leaves on execution of this thread)
333
      per second leaves on execution of this thread)
334
    * +4: word: position of the window of thread in the window stack
334
    * +4: word: position of the window of thread in the window stack
335
    * +6: word: (has no relation to the specified thread)
335
    * +6: word: (has no relation to the specified thread)
336
      number of the thread slot, which window has in the window stack
336
      number of the thread slot, which window has in the window stack
337
      position ecx
337
      position ecx
338
    * +8: word: reserved
338
    * +8: word: reserved
339
    * +10 = +0xA: 11 bytes: name of the process
339
    * +10 = +0xA: 11 bytes: name of the process
340
      (name of the started file - executable file without extension)
340
      (name of the started file - executable file without extension)
341
    * +21 = +0x15: byte: reserved, this byte is not changed
341
    * +21 = +0x15: byte: reserved, this byte is not changed
342
    * +22 = +0x16: dword: address of the process in memory
342
    * +22 = +0x16: dword: address of the process in memory
343
    * +26 = +0x1A: dword: size of used memory - 1
343
    * +26 = +0x1A: dword: size of used memory - 1
344
    * +30 = +0x1E: dword: identifier (PID/TID)
344
    * +30 = +0x1E: dword: identifier (PID/TID)
345
    * +34 = +0x22: dword: coordinate of the thread window on axis x
345
    * +34 = +0x22: dword: coordinate of the thread window on axis x
346
    * +38 = +0x26: dword: coordinate of the thread window on axis y
346
    * +38 = +0x26: dword: coordinate of the thread window on axis y
347
    * +42 = +0x2A: dword: size of the thread window on axis x
347
    * +42 = +0x2A: dword: size of the thread window on axis x
348
    * +46 = +0x2E: dword: size of the thread window on axis y
348
    * +46 = +0x2E: dword: size of the thread window on axis y
349
    * +50 = +0x32: word: status of the thread slot:
349
    * +50 = +0x32: word: status of the thread slot:
350
      * 0 = thread is running
350
      * 0 = thread is running
351
      * 1 = thread is suspended
351
      * 1 = thread is suspended
352
      * 2 = thread is suspended while waiting for event
352
      * 2 = thread is suspended while waiting for event
353
      * 3 = thread is terminating as a result of call to function -1
353
      * 3 = thread is terminating as a result of call to function -1
354
        or under duress as a result of call to subfunction 2
354
        or under duress as a result of call to subfunction 2
355
        of function 18 or termination of the system
355
        of function 18 or termination of the system
356
      * 4 = thread is terminating as a result of exception
356
      * 4 = thread is terminating as a result of exception
357
      * 5 = thread waits for event
357
      * 5 = thread waits for event
358
      * 9 = requested slot is free, all other information on the slot
358
      * 9 = requested slot is free, all other information on the slot
359
        is not meaningful
359
        is not meaningful
360
    * +52 = +0x34: word: reserved, this word is not changed
360
    * +52 = +0x34: word: reserved, this word is not changed
361
    * +54 = +0x36: dword: coordinate of the client area on axis x
361
    * +54 = +0x36: dword: coordinate of the client area on axis x
362
    * +58 = +0x3A: dword: coordinate of the client area on axis y
362
    * +58 = +0x3A: dword: coordinate of the client area on axis y
363
    * +62 = +0x3E: dword: width of the client area
363
    * +62 = +0x3E: dword: width of the client area
364
    * +66 = +0x42: dword: height of the client area
364
    * +66 = +0x42: dword: height of the client area
365
    * +70 = +0x46: byte: state of the window - bitfield
365
    * +70 = +0x46: byte: state of the window - bitfield
366
      * bit 0 (mask 1): window is maximized
366
      * bit 0 (mask 1): window is maximized
367
      * bit 1 (mask 2): window is minimized to panel
367
      * bit 1 (mask 2): window is minimized to panel
368
      * bit 2 (mask 4): window is rolled up
368
      * bit 2 (mask 4): window is rolled up
369
    * +71 = +0x47: dword: event mask
369
    * +71 = +0x47: dword: event mask
370
    * +75 = +0x4B: byte: keyboard mode(ASCII = 0; SCAN = 1)
370
    * +75 = +0x4B: byte: keyboard mode(ASCII = 0; SCAN = 1)
371
Remarks:
371
Remarks:
372
  * Slots are numbered starting from 1.
372
  * Slots are numbered starting from 1.
373
  * Returned value is not a total number of threads, because there
373
  * Returned value is not a total number of threads, because there
374
    can be free slots.
374
    can be free slots.
375
  * When process is starting, system automatically creates
375
  * When process is starting, system automatically creates
376
    execution thread.
376
    execution thread.
377
  * Function gives information on the thread. Each process has
377
  * Function gives information on the thread. Each process has
378
    at least one thread. One process can create many threads,
378
    at least one thread. One process can create many threads,
379
    in this case each thread has its own slot and the fields
379
    in this case each thread has its own slot and the fields
380
    +10, +22, +26 in these slots coincide.
380
    +10, +22, +26 in these slots coincide.
381
    Applications have no common way to define whether two threads
381
    Applications have no common way to define whether two threads
382
    belong to one process.
382
    belong to one process.
383
  * The active window - window on top of the window stack -
383
  * The active window - window on top of the window stack -
384
    receives the messages on a keyboard input. For such window
384
    receives the messages on a keyboard input. For such window
385
    the position in the window stack coincides with returned value.
385
    the position in the window stack coincides with returned value.
386
  * Slot 1 corresponds to special system thread, for which:
386
  * Slot 1 corresponds to special system thread, for which:
387
    * the window is in the bottom of the window stack, the fields
387
    * the window is in the bottom of the window stack, the fields
388
      +4 and +6 contain value 1
388
      +4 and +6 contain value 1
389
    * name of the process - "OS/IDLE" (supplemented by spaces)
389
    * name of the process - "OS/IDLE" (supplemented by spaces)
390
    * address of the process in memory is 0, size of used memory is
390
    * address of the process in memory is 0, size of used memory is
391
      16 Mb (0x1000000)
391
      16 Mb (0x1000000)
392
    * PID=1
392
    * PID=1
393
    * coordinates and sizes of the window and the client area are by
393
    * coordinates and sizes of the window and the client area are by
394
      convention set to 0
394
      convention set to 0
395
    * status of the slot is always 0 (running)
395
    * status of the slot is always 0 (running)
396
    * the execution time adds of time leaving on operations itself
396
    * the execution time adds of time leaving on operations itself
397
      and idle time in waiting for interrupt (which can be got by call
397
      and idle time in waiting for interrupt (which can be got by call
398
      to subfunction 4 of function 18).
398
      to subfunction 4 of function 18).
399
  * Beginning from slot 2, the normal applications are placed.
399
  * Beginning from slot 2, the normal applications are placed.
400
  * The normal applications are placed in memory at the address
400
  * The normal applications are placed in memory at the address
401
    0 (kernel constant 'std_application_base_address').
401
    0 (kernel constant 'std_application_base_address').
402
    There is no intersection, as each process has its own page table.
402
    There is no intersection, as each process has its own page table.
403
  * At creation of the thread it is assigned the slot
403
  * At creation of the thread it is assigned the slot
404
    in the system table and identifier (Process/Thread IDentifier =
404
    in the system table and identifier (Process/Thread IDentifier =
405
    PID/TID), which do not vary with time for given thread.
405
    PID/TID), which do not vary with time for given thread.
406
    After completion of the thread its slot can be anew used
406
    After completion of the thread its slot can be anew used
407
    for another thread. The thread identifier can not be assigned
407
    for another thread. The thread identifier can not be assigned
408
    to other thread even after completion of this thread.
408
    to other thread even after completion of this thread.
409
    Identifiers, assigned to new threads, grow monotonously.
409
    Identifiers, assigned to new threads, grow monotonously.
410
  * If the thread has not yet defined the window by call to
410
  * If the thread has not yet defined the window by call to
411
    function 0, the position and the sizes
411
    function 0, the position and the sizes
412
    of its window are considered to be zero.
412
    of its window are considered to be zero.
413
  * Coordinates of the client area are relative to the window.
413
  * Coordinates of the client area are relative to the window.
414
  * At the moment only the part of the buffer by a size
414
  * At the moment only the part of the buffer by a size
415
    76 = 0x4C bytes is used. Nevertheless it is recommended to use
415
    76 = 0x4C bytes is used. Nevertheless it is recommended to use
416
    1-Kb buffer for the future compatibility, in the future
416
    1-Kb buffer for the future compatibility, in the future
417
    some fields can be added.
417
    some fields can be added.
418
 
418
 
419
======================================================================
419
======================================================================
420
==================== Function 10 - wait for event. ===================
420
==================== Function 10 - wait for event. ===================
421
======================================================================
421
======================================================================
422
If the message queue is empty, waits for appearance of the message
422
If the message queue is empty, waits for appearance of the message
423
in queue. In this state thread does not consume CPU time.
423
in queue. In this state thread does not consume CPU time.
424
Then reads out the message from queue.
424
Then reads out the message from queue.
425
 
425
 
426
Parameters:
426
Parameters:
427
  * eax = 10 - function number
427
  * eax = 10 - function number
428
Returned value:
428
Returned value:
429
  * eax = event (see the list of events)
429
  * eax = event (see the list of events)
430
Remarks:
430
Remarks:
431
  * Those events are taken into account only which enter into
431
  * Those events are taken into account only which enter into
432
    a mask set by function 40. By default it is
432
    a mask set by function 40. By default it is
433
    redraw, key and button events.
433
    redraw, key and button events.
434
  * To check, whether there is a message in queue, use function 11.
434
  * To check, whether there is a message in queue, use function 11.
435
    To wait for no more than given time, use function 23.
435
    To wait for no more than given time, use function 23.
436
 
436
 
437
======================================================================
437
======================================================================
438
=============== Function 11 - check for event, no wait. ==============
438
=============== Function 11 - check for event, no wait. ==============
439
======================================================================
439
======================================================================
440
If the message queue contains event, function reads out
440
If the message queue contains event, function reads out
441
and return it. If the queue is empty, function returns 0.
441
and return it. If the queue is empty, function returns 0.
442
Parameters:
442
Parameters:
443
  * eax = 11 - function number
443
  * eax = 11 - function number
444
Returned value:
444
Returned value:
445
  * eax = 0 - message queue is empty
445
  * eax = 0 - message queue is empty
446
  * else eax = event (see the list of events)
446
  * else eax = event (see the list of events)
447
Remarks:
447
Remarks:
448
  * Those events are taken into account only, which enter into
448
  * Those events are taken into account only, which enter into
449
    a mask set by function 40. By default it is
449
    a mask set by function 40. By default it is
450
    redraw, key and button events.
450
    redraw, key and button events.
451
  * To wait for event, use function 10.
451
  * To wait for event, use function 10.
452
    To wait for no more than given time, use function 23.
452
    To wait for no more than given time, use function 23.
453
 
453
 
454
======================================================================
454
======================================================================
455
=============== Function 12 - begin/end window redraw. ===============
455
=============== Function 12 - begin/end window redraw. ===============
456
======================================================================
456
======================================================================
457
 
457
 
458
---------------- Subfunction 1 - begin window redraw. ----------------
458
---------------- Subfunction 1 - begin window redraw. ----------------
459
Parameters:
459
Parameters:
460
  * eax = 12 - function number
460
  * eax = 12 - function number
461
  * ebx = 1 - subfunction number
461
  * ebx = 1 - subfunction number
462
Returned value:
462
Returned value:
463
  * function does not return value
463
  * function does not return value
464
 
464
 
465
----------------- Subfunction 2 - end window redraw. -----------------
465
----------------- Subfunction 2 - end window redraw. -----------------
466
Parameters:
466
Parameters:
467
  * eax = 12 - function number
467
  * eax = 12 - function number
468
  * ebx = 2 - subfunction number
468
  * ebx = 2 - subfunction number
469
Returned value:
469
Returned value:
470
  * function does not return value
470
  * function does not return value
471
Remarks:
471
Remarks:
472
  * Subfunction 1 deletes all buttons defined with
472
  * Subfunction 1 deletes all buttons defined with
473
    function 8, they must be defined again.
473
    function 8, they must be defined again.
474
 
474
 
475
======================================================================
475
======================================================================
476
============ Function 13 - draw a rectangle in the window. ===========
476
============ Function 13 - draw a rectangle in the window. ===========
477
======================================================================
477
======================================================================
478
Parameters:
478
Parameters:
479
  * eax = 13 - function number
479
  * eax = 13 - function number
480
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
480
  * ebx = [coordinate on axis x]*65536 + [size on axis x]
481
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
481
  * ecx = [coordinate on axis y]*65536 + [size on axis y]
482
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
482
  * edx = color 0xRRGGBB or 0x80RRGGBB for gradient fill
483
Returned value:
483
Returned value:
484
  * function does not return value
484
  * function does not return value
485
Remarks:
485
Remarks:
486
  * Coordinates are understood as coordinates of the left upper corner
486
  * Coordinates are understood as coordinates of the left upper corner
487
    of a rectangle relative to the window.
487
    of a rectangle relative to the window.
488
 
488
 
489
======================================================================
489
======================================================================
490
=================== Function 14 - get screen size. ===================
490
=================== Function 14 - get screen size. ===================
491
======================================================================
491
======================================================================
492
Parameters:
492
Parameters:
493
  * eax = 14 - function number
493
  * eax = 14 - function number
494
Returned value:
494
Returned value:
495
  * eax = [xsize]*65536 + [ysize], where
495
  * eax = [xsize]*65536 + [ysize], where
496
  * xsize = x-coordinate of the right lower corner of the screen =
496
  * xsize = x-coordinate of the right lower corner of the screen =
497
            horizontal size - 1
497
            horizontal size - 1
498
  * ysize = y-coordinate of the right lower corner of the screen =
498
  * ysize = y-coordinate of the right lower corner of the screen =
499
            vertical size - 1
499
            vertical size - 1
500
Remarks:
500
Remarks:
501
  * See also subfunction 5 of function 48 - get sizes of
501
  * See also subfunction 5 of function 48 - get sizes of
502
    working area of the screen.
502
    working area of the screen.
503
 
503
 
504
======================================================================
504
======================================================================
505
== Function 15, subfunction 1 - set a size of the background image. ==
505
== Function 15, subfunction 1 - set a size of the background image. ==
506
======================================================================
506
======================================================================
507
Parameters:
507
Parameters:
508
  * eax = 15 - function number
508
  * eax = 15 - function number
509
  * ebx = 1 - subfunction number
509
  * ebx = 1 - subfunction number
510
  * ecx = width of the image
510
  * ecx = width of the image
511
  * edx = height of the image
511
  * edx = height of the image
512
Returned value:
512
Returned value:
513
  * function does not return value
513
  * function does not return value
514
Remarks:
514
Remarks:
515
  * Before calling subfunctions 2 and 5 you should call this function
515
  * Before calling subfunctions 2 and 5 you should call this function
516
    to set image size!
516
    to set image size!
517
  * For update of the screen (after completion of a series of commands
517
  * For update of the screen (after completion of a series of commands
518
    working with a background) call subfunction 3.
518
    working with a background) call subfunction 3.
519
  * There is a pair function for get size of the background image -
519
  * There is a pair function for get size of the background image -
520
    subfunction 1 of function 39.
520
    subfunction 1 of function 39.
521
 
521
 
522
======================================================================
522
======================================================================
523
=== Function 15, subfunction 2 - put pixel on the background image. ==
523
=== Function 15, subfunction 2 - put pixel on the background image. ==
524
======================================================================
524
======================================================================
525
Parameters:
525
Parameters:
526
  * eax = 15 - function number
526
  * eax = 15 - function number
527
  * ebx = 2 - subfunction number
527
  * ebx = 2 - subfunction number
528
  * ecx = offset
528
  * ecx = offset
529
  * edx = color of a pixel 0xRRGGBB
529
  * edx = color of a pixel 0xRRGGBB
530
Returned value:
530
Returned value:
531
  * function does not return value
531
  * function does not return value
532
Remarks:
532
Remarks:
533
  * Offset for a pixel with coordinates (x,y) is calculated as
533
  * Offset for a pixel with coordinates (x,y) is calculated as
534
    (x+y*xsize)*3.
534
    (x+y*xsize)*3.
535
  * If the given offset exceeds size set by subfunction 1,
535
  * If the given offset exceeds size set by subfunction 1,
536
    the call is ignored.
536
    the call is ignored.
537
  * For update of the screen (after completion of a series of commands
537
  * For update of the screen (after completion of a series of commands
538
    working with a background) call subfunction 3.
538
    working with a background) call subfunction 3.
539
  * There is a pair function for get pixel on the background image -
539
  * There is a pair function for get pixel on the background image -
540
    subfunction 2 of function 39.
540
    subfunction 2 of function 39.
541
 
541
 
542
======================================================================
542
======================================================================
543
=========== Function 15, subfunction 3 - redraw background. ==========
543
=========== Function 15, subfunction 3 - redraw background. ==========
544
======================================================================
544
======================================================================
545
Parameters:
545
Parameters:
546
  * eax = 15 - function number
546
  * eax = 15 - function number
547
  * ebx = 3 - subfunction number
547
  * ebx = 3 - subfunction number
548
Returned value:
548
Returned value:
549
  * function does not return value
549
  * function does not return value
550
 
550
 
551
======================================================================
551
======================================================================
552
== Function 15, subfunction 4 - set drawing mode for the background. =
552
== Function 15, subfunction 4 - set drawing mode for the background. =
553
======================================================================
553
======================================================================
554
Parameters:
554
Parameters:
555
  * eax = 15 - function number
555
  * eax = 15 - function number
556
  * ebx = 4 - subfunction number
556
  * ebx = 4 - subfunction number
557
  * ecx = drawing mode:
557
  * ecx = drawing mode:
558
    * 1 = tile
558
    * 1 = tile
559
    * 2 = stretch
559
    * 2 = stretch
560
Returned value:
560
Returned value:
561
  * function does not return value
561
  * function does not return value
562
Remarks:
562
Remarks:
563
  * For update of the screen (after completion of a series of commands
563
  * For update of the screen (after completion of a series of commands
564
    working with a background) call subfunction 3.
564
    working with a background) call subfunction 3.
565
  * There is a pair function for get drawing mode of the background -
565
  * There is a pair function for get drawing mode of the background -
566
    subfunction 4 of function 39.
566
    subfunction 4 of function 39.
567
 
567
 
568
======================================================================
568
======================================================================
569
===================== Function 15, subfunction 5 =====================
569
===================== Function 15, subfunction 5 =====================
570
============ Put block of pixels on the background image. ============
570
============ Put block of pixels on the background image. ============
571
======================================================================
571
======================================================================
572
Parameters:
572
Parameters:
573
  * eax = 15 - function number
573
  * eax = 15 - function number
574
  * ebx = 5 - subfunction number
574
  * ebx = 5 - subfunction number
575
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
575
  * ecx = pointer to the data in the format BBGGRRBBGGRR...
576
  * edx = offset in data of the background image
576
  * edx = offset in data of the background image
577
  * esi = size of data in bytes = 3 * number of pixels
577
  * esi = size of data in bytes = 3 * number of pixels
578
Returned value:
578
Returned value:
579
  * function does not return value
579
  * function does not return value
580
Remarks:
580
Remarks:
581
  * Offset and size are not checked for correctness.
581
  * Offset and size are not checked for correctness.
582
  * Color of each pixel is stored as 3-bytes value BBGGRR.
582
  * Color of each pixel is stored as 3-bytes value BBGGRR.
583
  * Pixels of the background image are written sequentially
583
  * Pixels of the background image are written sequentially
584
    from left to right, from up to down.
584
    from left to right, from up to down.
585
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
585
  * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
586
  * For update of the screen (after completion of a series of commands
586
  * For update of the screen (after completion of a series of commands
587
    working with a background) call subfunction 3.
587
    working with a background) call subfunction 3.
588
 
588
 
589
======================================================================
589
======================================================================
590
===================== Function 15, subfunction 6 =====================
590
===================== Function 15, subfunction 6 =====================
591
======== Map background data to the address space of process. ========
591
======== Map background data to the address space of process. ========
592
======================================================================
592
======================================================================
593
Parameters:
593
Parameters:
594
  * eax = 15 - function number
594
  * eax = 15 - function number
595
  * ebx = 6 - subfunction number
595
  * ebx = 6 - subfunction number
596
Returned value:
596
Returned value:
597
  * eax = pointer to background data, 0 if error
597
  * eax = pointer to background data, 0 if error
598
Remarks:
598
Remarks:
599
  * Mapped data are available for read and write.
599
  * Mapped data are available for read and write.
600
  * Size of background data is 3*xsize*ysize. The system blocks
600
  * Size of background data is 3*xsize*ysize. The system blocks
601
    changes of background sizes while process works with mapped data.
601
    changes of background sizes while process works with mapped data.
602
  * Color of each pixel is stored as 3-bytes value BBGGRR.
602
  * Color of each pixel is stored as 3-bytes value BBGGRR.
603
  * Pixels of the background image are written sequentially
603
  * Pixels of the background image are written sequentially
604
    from left to right, from up to down.
604
    from left to right, from up to down.
605
 
605
 
606
======================================================================
606
======================================================================
607
===== Function 15, subfunction 7 - close mapped background data. =====
607
===== Function 15, subfunction 7 - close mapped background data. =====
608
======================================================================
608
======================================================================
609
Parameters:
609
Parameters:
610
  * eax = 15 - function number
610
  * eax = 15 - function number
611
  * ebx = 7 - subfunction number
611
  * ebx = 7 - subfunction number
612
  * ecx = pointer to mapped data
612
  * ecx = pointer to mapped data
613
Returned value:
613
Returned value:
614
  * eax = 1 - success, 0 - error
614
  * eax = 1 - success, 0 - error
615
 
615
 
616
======================================================================
616
======================================================================
617
===================== Function 15, subfunction 8 =====================
617
===================== Function 15, subfunction 8 =====================
618
============= Get coordinates of last draw the background ============
618
============= Get coordinates of last draw the background ============
619
======================================================================
619
======================================================================
620
Parameters:
620
Parameters:
621
  * eax = 15 - function number
621
  * eax = 15 - function number
622
  * ebx = 8 - subfunction number
622
  * ebx = 8 - subfunction number
623
Returned value:
623
Returned value:
624
  * eax = [left]*65536 + [right]
624
  * eax = [left]*65536 + [right]
625
  * ebx = [top]*65536 + [bottom]
625
  * ebx = [top]*65536 + [bottom]
626
Remarks:
626
Remarks:
627
  * (left,top) are coordinates of the left upper corner,
627
  * (left,top) are coordinates of the left upper corner,
628
    (right,bottom) are coordinates of the right lower one.
628
    (right,bottom) are coordinates of the right lower one.
629
  * For receiving more reliable information, call the function
629
  * For receiving more reliable information, call the function
630
    immediately after the event:
630
    immediately after the event:
631
             5 = kernel finished redrawing of the desktop background
631
             5 = kernel finished redrawing of the desktop background
632
 
632
 
633
======================================================================
633
======================================================================
634
===================== Function 15, subfunction 9 =====================
634
===================== Function 15, subfunction 9 =====================
635
============= Redraws a rectangular part of the background ===========
635
============= Redraws a rectangular part of the background ===========
636
======================================================================
636
======================================================================
637
Parameters:
637
Parameters:
638
  * eax = 15 - function number
638
  * eax = 15 - function number
639
  * ebx = 9 - subfunction number
639
  * ebx = 9 - subfunction number
640
  * ecx = [left]*65536 + [right]
640
  * ecx = [left]*65536 + [right]
641
  * edx = [top]*65536 + [bottom]
641
  * edx = [top]*65536 + [bottom]
642
Returned value:
642
Returned value:
643
  * function does not return value
643
  * function does not return value
644
Remarks:
644
Remarks:
645
  * (left,top) are coordinates of the left upper corner,
645
  * (left,top) are coordinates of the left upper corner,
646
    (right,bottom) are coordinates of the right lower one.
646
    (right,bottom) are coordinates of the right lower one.
647
  * If parameters are set incorrectly then background is not redrawn.
647
  * If parameters are set incorrectly then background is not redrawn.
648
 
648
 
649
======================================================================
649
======================================================================
650
=============== Function 16 - save ramdisk on a floppy. ==============
650
=============== Function 16 - save ramdisk on a floppy. ==============
651
======================================================================
651
======================================================================
652
Parameters:
652
Parameters:
653
  * eax = 16 - function number
653
  * eax = 16 - function number
654
  * ebx = 1 or ebx = 2 - on which floppy save
654
  * ebx = 1 or ebx = 2 - on which floppy save
655
Returned value:
655
Returned value:
656
  * eax = 0 - success
656
  * eax = 0 - success
657
  * eax = 1 - error
657
  * eax = 1 - error
658
 
658
 
659
======================================================================
659
======================================================================
660
======= Function 17 - get the identifier of the pressed button. ======
660
======= Function 17 - get the identifier of the pressed button. ======
661
======================================================================
661
======================================================================
662
Takes away the code of the pressed button from the buffer.
662
Takes away the code of the pressed button from the buffer.
663
Parameters:
663
Parameters:
664
  * eax = 17 - function number
664
  * eax = 17 - function number
665
Returned value:
665
Returned value:
666
  * if the buffer is empty, function returns eax=1
666
  * if the buffer is empty, function returns eax=1
667
  * if the buffer is not empty:
667
  * if the buffer is not empty:
668
    * high 24 bits of eax contain button identifier (in particular,
668
    * high 24 bits of eax contain button identifier (in particular,
669
      ah contains low byte of the identifier; if all buttons have
669
      ah contains low byte of the identifier; if all buttons have
670
      the identifier less than 256, ah is enough to distinguish)
670
      the identifier less than 256, ah is enough to distinguish)
671
    * al = 0 - the button was pressed with left mouse button
671
    * al = 0 - the button was pressed with left mouse button
672
    * al = bit corresponding to used mouse button otherwise
672
    * al = bit corresponding to used mouse button otherwise
673
Remarks:
673
Remarks:
674
  * "Buffer" keeps only one button, at pressing the new button the
674
  * "Buffer" keeps only one button, at pressing the new button the
675
    information about old is lost.
675
    information about old is lost.
676
  * The call of this function by an application with inactive window
676
  * The call of this function by an application with inactive window
677
    will return answer "buffer is empty".
677
    will return answer "buffer is empty".
678
  * Returned value for al corresponds to the state of mouse buttons
678
  * Returned value for al corresponds to the state of mouse buttons
679
    as in subfunction 2 of function 37 at the beginning
679
    as in subfunction 2 of function 37 at the beginning
680
    of button press, excluding lower bit, which is cleared.
680
    of button press, excluding lower bit, which is cleared.
681
 
681
 
682
======================================================================
682
======================================================================
683
===================== Function 18, subfunction 1 =====================
683
===================== Function 18, subfunction 1 =====================
684
============= Make deactive the window of the given thread. ==========
684
============= Make deactive the window of the given thread. ==========
685
======================================================================
685
======================================================================
686
Parameters:
686
Parameters:
687
  * eax = 18 - function number
687
  * eax = 18 - function number
688
  * ebx = 1 - subfunction number
688
  * ebx = 1 - subfunction number
689
  * ecx = number of the thread slot
689
  * ecx = number of the thread slot
690
Returned value:
690
Returned value:
691
  * function does not return value
691
  * function does not return value
692
 
692
 
693
======================================================================
693
======================================================================
694
= Function 18, subfunction 2 - terminate process/thread by the slot. =
694
= Function 18, subfunction 2 - terminate process/thread by the slot. =
695
======================================================================
695
======================================================================
696
Parameters:
696
Parameters:
697
  * eax = 18 - function number
697
  * eax = 18 - function number
698
  * ebx = 2 - subfunction number
698
  * ebx = 2 - subfunction number
699
  * ecx = number of the slot of process/thread
699
  * ecx = number of the slot of process/thread
700
Returned value:
700
Returned value:
701
  * function does not return value
701
  * function does not return value
702
Remarks:
702
Remarks:
703
  * It is impossible to terminate system thread OS/IDLE (with
703
  * It is impossible to terminate system thread OS/IDLE (with
704
    number of the slot 1),
704
    number of the slot 1),
705
    it is possible to terminate any normal process/thread.
705
    it is possible to terminate any normal process/thread.
706
  * See also subfunction 18 - terminate
706
  * See also subfunction 18 - terminate
707
    process/thread by the identifier.
707
    process/thread by the identifier.
708
 
708
 
709
======================================================================
709
======================================================================
710
===================== Function 18, subfunction 3 =====================
710
===================== Function 18, subfunction 3 =====================
711
============= Make active the window of the given thread. ============
711
============= Make active the window of the given thread. ============
712
======================================================================
712
======================================================================
713
Parameters:
713
Parameters:
714
  * eax = 18 - function number
714
  * eax = 18 - function number
715
  * ebx = 3 - subfunction number
715
  * ebx = 3 - subfunction number
716
  * ecx = number of the thread slot
716
  * ecx = number of the thread slot
717
Returned value:
717
Returned value:
718
  * function does not return value
718
  * function does not return value
719
Remarks:
719
Remarks:
720
  * If correct, but nonexistent slot is given,
720
  * If correct, but nonexistent slot is given,
721
    some window is made active.
721
    some window is made active.
722
  * To find out, which window is active, use subfunction 7.
722
  * To find out, which window is active, use subfunction 7.
723
 
723
 
724
======================================================================
724
======================================================================
725
===================== Function 18, subfunction 4 =====================
725
===================== Function 18, subfunction 4 =====================
726
=========== Get counter of idle time units per one second. ===========
726
=========== Get counter of idle time units per one second. ===========
727
======================================================================
727
======================================================================
728
Idle time units are units, in which the processor stands idle
728
Idle time units are units, in which the processor stands idle
729
in waiting for interrupt (in the command 'hlt').
729
in waiting for interrupt (in the command 'hlt').
730
 
730
 
731
Parameters:
731
Parameters:
732
  * eax = 18 - function number
732
  * eax = 18 - function number
733
  * ebx = 4 - subfunction number
733
  * ebx = 4 - subfunction number
734
Returned value:
734
Returned value:
735
  * eax = value of the counter of idle time units per one second
735
  * eax = value of the counter of idle time units per one second
736
 
736
 
737
======================================================================
737
======================================================================
738
========== Function 18, subfunction 5 - get CPU clock rate. ==========
738
========== Function 18, subfunction 5 - get CPU clock rate. ==========
739
======================================================================
739
======================================================================
740
Parameters:
740
Parameters:
741
  * eax = 18 - function number
741
  * eax = 18 - function number
742
  * ebx = 5 - subfunction number
742
  * ebx = 5 - subfunction number
743
Returned value:
743
Returned value:
744
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
744
  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
745
 
745
 
746
======================================================================
746
======================================================================
747
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
747
 Function 18, subfunction 6 - save ramdisk to the file on hard drive.
748
======================================================================
748
======================================================================
749
Parameters:
749
Parameters:
750
  * eax = 18 - function number
750
  * eax = 18 - function number
751
  * ebx = 6 - subfunction number
751
  * ebx = 6 - subfunction number
752
  * ecx = pointer to the full path to file
752
  * ecx = pointer to the full path to file
753
    (for example, "/hd0/1/kolibri/kolibri.img")
753
    (for example, "/hd0/1/kolibri/kolibri.img")
754
Returned value:
754
Returned value:
755
  * eax = 0 - success
755
  * eax = 0 - success
756
  * else eax = error code of the file system
756
  * else eax = error code of the file system
757
Remarks:
757
Remarks:
758
  * All folders in the given path must exist, otherwise function
758
  * All folders in the given path must exist, otherwise function
759
    returns value 5, "file not found".
759
    returns value 5, "file not found".
760
 
760
 
761
======================================================================
761
======================================================================
762
=========== Function 18, subfunction 7 - get active window. ==========
762
=========== Function 18, subfunction 7 - get active window. ==========
763
======================================================================
763
======================================================================
764
Parameters:
764
Parameters:
765
  * eax = 18 - function number
765
  * eax = 18 - function number
766
  * ebx = 7 - subfunction number
766
  * ebx = 7 - subfunction number
767
Returned value:
767
Returned value:
768
  * eax = number of the active window
768
  * eax = number of the active window
769
    (number of the slot of the thread with active window)
769
    (number of the slot of the thread with active window)
770
Remarks:
770
Remarks:
771
  * Active window is at the top of the window stack and receives
771
  * Active window is at the top of the window stack and receives
772
    messages on all keyboard input.
772
    messages on all keyboard input.
773
  * To make a window active, use subfunction 3.
773
  * To make a window active, use subfunction 3.
774
 
774
 
775
======================================================================
775
======================================================================
776
== Function 18, subfunction 8 - disable/enable the internal speaker. =
776
== Function 18, subfunction 8 - disable/enable the internal speaker. =
777
======================================================================
777
======================================================================
778
If speaker sound is disabled, all calls to subfunction 55 of
778
If speaker sound is disabled, all calls to subfunction 55 of
779
function 55 are ignored. If speaker sound is enabled,
779
function 55 are ignored. If speaker sound is enabled,
780
they are routed on builtin speaker.
780
they are routed on builtin speaker.
781
 
781
 
782
------------------- Subsubfunction 1 - get status. -------------------
782
------------------- Subsubfunction 1 - get status. -------------------
783
Parameters:
783
Parameters:
784
  * eax = 18 - function number
784
  * eax = 18 - function number
785
  * ebx = 8 - subfunction number
785
  * ebx = 8 - subfunction number
786
  * ecx = 1 - number of the subsubfunction
786
  * ecx = 1 - number of the subsubfunction
787
Returned value:
787
Returned value:
788
  * eax = 0 - speaker sound is enabled; 1 - disabled
788
  * eax = 0 - speaker sound is enabled; 1 - disabled
789
 
789
 
790
----------------- Subsubfunction 2 - toggle status. ------------------
790
----------------- Subsubfunction 2 - toggle status. ------------------
791
Toggles states of disable/enable.
791
Toggles states of disable/enable.
792
Parameters:
792
Parameters:
793
  * eax = 18 - function number
793
  * eax = 18 - function number
794
  * ebx = 8 - subfunction number
794
  * ebx = 8 - subfunction number
795
  * ecx = 2 - number of the subsubfunction
795
  * ecx = 2 - number of the subsubfunction
796
Returned value:
796
Returned value:
797
  * function does not return value
797
  * function does not return value
798
 
798
 
799
======================================================================
799
======================================================================
800
== Function 18, subfunction 9 - system shutdown with the parameter. ==
800
== Function 18, subfunction 9 - system shutdown with the parameter. ==
801
======================================================================
801
======================================================================
802
Parameters:
802
Parameters:
803
  * eax = 18 - function number
803
  * eax = 18 - function number
804
  * ebx = 9 - subfunction number
804
  * ebx = 9 - subfunction number
805
  * ecx = parameter:
805
  * ecx = parameter:
806
    * 2 = turn off computer
806
    * 2 = turn off computer
807
    * 3 = reboot computer
807
    * 3 = reboot computer
808
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
808
    * 4 = restart the kernel from the file 'kernel.mnt' on ramdisk
809
Returned value:
809
Returned value:
810
  * at incorrect ecx the registers do not change (i.e. eax=18)
810
  * at incorrect ecx the registers do not change (i.e. eax=18)
811
  * by correct call function always returns eax=0
811
  * by correct call function always returns eax=0
812
    as the tag of success
812
    as the tag of success
813
Remarks:
813
Remarks:
814
  * Do not rely on returned value by incorrect call, it can be
814
  * Do not rely on returned value by incorrect call, it can be
815
    changed in future versions of the kernel.
815
    changed in future versions of the kernel.
816
 
816
 
817
======================================================================
817
======================================================================
818
======= Function 18, subfunction 10 - minimize topmost window. =======
818
======= Function 18, subfunction 10 - minimize topmost window. =======
819
======================================================================
819
======================================================================
820
Minimizes the topmost (active) window.
820
Minimizes the topmost (active) window.
821
Parameters:
821
Parameters:
822
  * eax = 18 - function number
822
  * eax = 18 - function number
823
  * ebx = 10 - subfunction number
823
  * ebx = 10 - subfunction number
824
Returned value:
824
Returned value:
825
  * function does not return value
825
  * function does not return value
826
Remarks:
826
Remarks:
827
  * The minimized window from the point of view of function 9
827
  * The minimized window from the point of view of function 9
828
    keeps position and sizes.
828
    keeps position and sizes.
829
  * Restoring of an application window occurs at its activation by
829
  * Restoring of an application window occurs at its activation by
830
    subfunction 3.
830
    subfunction 3.
831
  * Usually there is no necessity to minimize/restore a window
831
  * Usually there is no necessity to minimize/restore a window
832
    explicitly: minimization of a window is carried out by the system
832
    explicitly: minimization of a window is carried out by the system
833
    at pressing the minimization button (for skinned windows
833
    at pressing the minimization button (for skinned windows
834
    it is defined automatically by function 0,
834
    it is defined automatically by function 0,
835
    for other windows it can be defined manually by function 8),
835
    for other windows it can be defined manually by function 8),
836
    restore of a window is done by the application '@taskbar'.
836
    restore of a window is done by the application '@taskbar'.
837
 
837
 
838
======================================================================
838
======================================================================
839
 Function 18, subfunction 11 - get information on the disk subsystem.
839
 Function 18, subfunction 11 - get information on the disk subsystem.
840
======================================================================
840
======================================================================
841
Parameters:
841
Parameters:
842
  * eax = 18 - function number
842
  * eax = 18 - function number
843
  * ebx = 11 - subfunction number
843
  * ebx = 11 - subfunction number
844
  * ecx = type of the table:
844
  * ecx = type of the table:
845
    * 1 = short version, 16 bytes
845
    * 1 = short version, 16 bytes
846
  * edx = pointer to the buffer (in the application) for the table
846
  * edx = pointer to the buffer (in the application) for the table
847
Returned value:
847
Returned value:
848
  * function does not return value
848
  * function does not return value
849
Format of the table: short version:
849
Format of the table: short version:
850
  * +0: byte: information about FDD's (drives for floppies),
850
  * +0: byte: information about FDD's (drives for floppies),
851
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
851
    AAAABBBB, where AAAA gives type of the first drive, BBBB -
852
    of the second regarding to the following list:
852
    of the second regarding to the following list:
853
    * 0 = there is no drive
853
    * 0 = there is no drive
854
    * 1 = 360Kb, 5.25''
854
    * 1 = 360Kb, 5.25''
855
    * 2 = 1.2Mb, 5.25''
855
    * 2 = 1.2Mb, 5.25''
856
    * 3 = 720Kb, 3.5''
856
    * 3 = 720Kb, 3.5''
857
    * 4 = 1.44Mb, 3.5''
857
    * 4 = 1.44Mb, 3.5''
858
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
858
    * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
859
    For example, for the standard configuration from one 1.44-drive
859
    For example, for the standard configuration from one 1.44-drive
860
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
860
    here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
861
    the value is 24h.
861
    the value is 24h.
862
    
862
    
863
  First IDE controller:
863
  First IDE controller:
864
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
864
  * +1: byte: information about hard disks and CD-drives, AABBCCDD,
865
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
865
    where AA corresponds to the controller IDE0, ..., DD - IDE3:
866
    * 0 = device not found
866
    * 0 = device not found
867
    * 1 = hard drive
867
    * 1 = hard drive
868
    * 2 = CD-drive
868
    * 2 = CD-drive
869
    For example, in the case HD on IDE0 and CD on IDE2
869
    For example, in the case HD on IDE0 and CD on IDE2
870
    this field contains 48h.
870
    this field contains 48h.
871
  * +2: 4 db: number of the retrieved partitions on hard disks
871
  * +2: 4 db: number of the retrieved partitions on hard disks
872
    at accordingly IDE0,...,IDE3.
872
    at accordingly IDE0,...,IDE3.
873
    
873
    
874
  Second IDE controller:
874
  Second IDE controller:
875
  * +6: byte: information about hard disks and CD-drives, AABBCCDD,
875
  * +6: byte: information about hard disks and CD-drives, AABBCCDD,
876
    where AA corresponds to the controller IDE4, ..., DD - IDE7:
876
    where AA corresponds to the controller IDE4, ..., DD - IDE7:
877
    * 0 = device not found
877
    * 0 = device not found
878
    * 1 = hard drive
878
    * 1 = hard drive
879
    * 2 = CD-drive
879
    * 2 = CD-drive
880
    For example, in the case HD on IDE4 and CD on IDE6
880
    For example, in the case HD on IDE4 and CD on IDE6
881
    this field contains 48h.
881
    this field contains 48h.
882
  * +7: 4 db: number of the retrieved partitions on hard disks
882
  * +7: 4 db: number of the retrieved partitions on hard disks
883
    at accordingly IDE4,...,IDE7.
883
    at accordingly IDE4,...,IDE7.
884
 
884
 
885
  Third IDE controller:
885
  Third IDE controller:
886
  * +11: byte: information about hard disks and CD-drives, AABBCCDD,
886
  * +11: byte: information about hard disks and CD-drives, AABBCCDD,
887
    where AA corresponds to the controller IDE8, ..., DD - IDE11:
887
    where AA corresponds to the controller IDE8, ..., DD - IDE11:
888
    * 0 = device not found
888
    * 0 = device not found
889
    * 1 = hard drive
889
    * 1 = hard drive
890
    * 2 = CD-drive
890
    * 2 = CD-drive
891
    For example, in the case HD on IDE8 and CD on IDE10
891
    For example, in the case HD on IDE8 and CD on IDE10
892
    this field contains 48h.
892
    this field contains 48h.
893
  * +12: 4 db: number of the retrieved partitions on hard disks
893
  * +12: 4 db: number of the retrieved partitions on hard disks
894
    at accordingly IDE8,...,IDE11.   
894
    at accordingly IDE8,...,IDE11.   
895
    
895
    
896
    If the hard disk on IDEx is absent, appropriate byte is zero,
896
    If the hard disk on IDEx is absent, appropriate byte is zero,
897
    otherwise it shows number of the recognized partitions, which
897
    otherwise it shows number of the recognized partitions, which
898
    can be not presented (if the drive is not formatted or if
898
    can be not presented (if the drive is not formatted or if
899
    the file system is not supported). Current version of the kernel
899
    the file system is not supported). Current version of the kernel
900
    supports only FAT12/16/32, NTFS, ext2/3/4 and XFS for hard disks.
900
    supports only FAT12/16/32, NTFS, ext2/3/4 and XFS for hard disks.
901
 
901
 
902
Remarks:
902
Remarks:
903
  * The table can be used for obtaining the information about
903
  * The table can be used for obtaining the information about
904
    available devices.
904
    available devices.
905
 
905
 
906
======================================================================
906
======================================================================
907
========== Function 18, subfunction 13 - get kernel version. =========
907
========== Function 18, subfunction 13 - get kernel version. =========
908
======================================================================
908
======================================================================
909
Parameters:
909
Parameters:
910
  * eax = 18 - function number
910
  * eax = 18 - function number
911
  * ebx = 13 - subfunction number
911
  * ebx = 13 - subfunction number
912
  * ecx = pointer to the buffer (not less than 16 bytes), where
912
  * ecx = pointer to the buffer (not less than 16 bytes), where
913
    the information will be placed
913
    the information will be placed
914
Returned value:
914
Returned value:
915
  * function does not return value
915
  * function does not return value
916
Structure of the buffer:
916
Structure of the buffer:
917
db a,b,c,d for version a.b.c.d
917
db a,b,c,d for version a.b.c.d
918
db 0: reserved
918
db 0: reserved
919
dd REV - kernel SVN revision number
919
dd REV - kernel SVN revision number
920
For Kolibri 0.7.7.0+ kernel:
920
For Kolibri 0.7.7.0+ kernel:
921
db 0,7,7,0
921
db 0,7,7,0
922
db 0
922
db 0
923
dd 1675
923
dd 1675
924
 
924
 
925
======================================================================
925
======================================================================
926
======= Function 18, subfunction 14 - wait for screen retrace. =======
926
======= Function 18, subfunction 14 - wait for screen retrace. =======
927
======================================================================
927
======================================================================
928
Waits for the beginning of retrace of the scanning ray of the screen
928
Waits for the beginning of retrace of the scanning ray of the screen
929
monitor.
929
monitor.
930
Parameters:
930
Parameters:
931
  * eax = 18 - function number
931
  * eax = 18 - function number
932
  * ebx = 14 - subfunction number
932
  * ebx = 14 - subfunction number
933
Returned value:
933
Returned value:
934
  * eax = 0 as the tag of success
934
  * eax = 0 as the tag of success
935
Remarks:
935
Remarks:
936
  * Function is intended only for active high-efficiency graphics
936
  * Function is intended only for active high-efficiency graphics
937
    applications; is used for smooth output of a graphics.
937
    applications; is used for smooth output of a graphics.
938
 
938
 
939
======================================================================
939
======================================================================
940
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
940
== Function 18, subfunction 15 - center mouse cursor on the screen. ==
941
======================================================================
941
======================================================================
942
Parameters:
942
Parameters:
943
  * eax = 18 - function number
943
  * eax = 18 - function number
944
  * ebx = 15 - subfunction number
944
  * ebx = 15 - subfunction number
945
Returned value:
945
Returned value:
946
  * eax = 0 as the tag of success
946
  * eax = 0 as the tag of success
947
 
947
 
948
======================================================================
948
======================================================================
949
========= Function 18, subfunction 16 - get size of free RAM. ========
949
========= Function 18, subfunction 16 - get size of free RAM. ========
950
======================================================================
950
======================================================================
951
Parameters:
951
Parameters:
952
  * eax = 18 - function number
952
  * eax = 18 - function number
953
  * ebx = 16 - subfunction number
953
  * ebx = 16 - subfunction number
954
Returned value:
954
Returned value:
955
  * eax = size of free memory in kilobytes
955
  * eax = size of free memory in kilobytes
956
 
956
 
957
======================================================================
957
======================================================================
958
======== Function 18, subfunction 17 - get full amount of RAM. =======
958
======== Function 18, subfunction 17 - get full amount of RAM. =======
959
======================================================================
959
======================================================================
960
Parameters:
960
Parameters:
961
  * eax = 18 - function number
961
  * eax = 18 - function number
962
  * ebx = 17 - subfunction number
962
  * ebx = 17 - subfunction number
963
Returned value:
963
Returned value:
964
  * eax = total size of existing memory in kilobytes
964
  * eax = total size of existing memory in kilobytes
965
 
965
 
966
======================================================================
966
======================================================================
967
===================== Function 18, subfunction 18 ====================
967
===================== Function 18, subfunction 18 ====================
968
============= Terminate process/thread by the identifier. ============
968
============= Terminate process/thread by the identifier. ============
969
======================================================================
969
======================================================================
970
Parameters:
970
Parameters:
971
  * eax = 18 - function number
971
  * eax = 18 - function number
972
  * ebx = 18 - subfunction number
972
  * ebx = 18 - subfunction number
973
  * ecx = identifer of process/thread (PID/TID)
973
  * ecx = identifer of process/thread (PID/TID)
974
Returned value:
974
Returned value:
975
  * eax = 0 - success
975
  * eax = 0 - success
976
  * eax = -1 - error (process is not found or is system)
976
  * eax = -1 - error (process is not found or is system)
977
Remarks:
977
Remarks:
978
  * It is impossible to terminate system thread OS/IDLE (identifier
978
  * It is impossible to terminate system thread OS/IDLE (identifier
979
    1), it is possible to terminate any normal process/thread.
979
    1), it is possible to terminate any normal process/thread.
980
  * See also subfunction 2 - terminate
980
  * See also subfunction 2 - terminate
981
    process/thread by given slot.
981
    process/thread by given slot.
982
 
982
 
983
======================================================================
983
======================================================================
984
======== Function 18, subfunction 19 - get/set mouse features. =======
984
======== Function 18, subfunction 19 - get/set mouse features. =======
985
======================================================================
985
======================================================================
986
 
986
 
987
---------------- Subsubfunction 0 - get mouse speed. -----------------
987
---------------- Subsubfunction 0 - get mouse speed. -----------------
988
Parameters:
988
Parameters:
989
  * eax = 18 - function number
989
  * eax = 18 - function number
990
  * ebx = 19 - subfunction number
990
  * ebx = 19 - subfunction number
991
  * ecx = 0 - subsubfunction number
991
  * ecx = 0 - subsubfunction number
992
Returned value:
992
Returned value:
993
  * eax = current mouse speed
993
  * eax = current mouse speed
994
 
994
 
995
---------------- Subsubfunction 1 - set mouse speed. -----------------
995
---------------- Subsubfunction 1 - set mouse speed. -----------------
996
Parameters:
996
Parameters:
997
  * eax = 18 - function number
997
  * eax = 18 - function number
998
  * ebx = 19 - subfunction number
998
  * ebx = 19 - subfunction number
999
  * ecx = 1 - subsubfunction number
999
  * ecx = 1 - subsubfunction number
1000
  * edx = new value for speed
1000
  * edx = new value for speed
1001
Returned value:
1001
Returned value:
1002
  * function does not return value
1002
  * function does not return value
1003
 
1003
 
1004
---------------- Subsubfunction 2 - get mouse delay. -----------------
1004
---------------- Subsubfunction 2 - get mouse delay. -----------------
1005
Parameters:
1005
Parameters:
1006
  * eax = 18 - function number
1006
  * eax = 18 - function number
1007
  * ebx = 19 - subfunction number
1007
  * ebx = 19 - subfunction number
1008
  * ecx = 2 - subsubfunction number
1008
  * ecx = 2 - subsubfunction number
1009
Returned value:
1009
Returned value:
1010
  * eax = current mouse delay
1010
  * eax = current mouse delay
1011
 
1011
 
1012
---------------- Subsubfunction 3 - set mouse delay. -----------------
1012
---------------- Subsubfunction 3 - set mouse delay. -----------------
1013
Parameters:
1013
Parameters:
1014
  * eax = 18 - function number
1014
  * eax = 18 - function number
1015
  * ebx = 19 - subfunction number
1015
  * ebx = 19 - subfunction number
1016
  * ecx = 3 - subsubfunction number
1016
  * ecx = 3 - subsubfunction number
1017
  * edx = new value for mouse delay
1017
  * edx = new value for mouse delay
1018
Returned value:
1018
Returned value:
1019
  * function does not return value
1019
  * function does not return value
1020
 
1020
 
1021
----------- Subsubfunction 4 - set mouse pointer position. -----------
1021
----------- Subsubfunction 4 - set mouse pointer position. -----------
1022
Parameters:
1022
Parameters:
1023
  * eax = 18 - function number
1023
  * eax = 18 - function number
1024
  * ebx = 19 - subfunction number
1024
  * ebx = 19 - subfunction number
1025
  * ecx = 4 - subsubfunction number
1025
  * ecx = 4 - subsubfunction number
1026
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1026
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1027
Returned value:
1027
Returned value:
1028
  * function does not return value
1028
  * function does not return value
1029
 
1029
 
1030
-------- Subsubfunction 5 - simulate state of mouse buttons. ---------
1030
-------- Subsubfunction 5 - simulate state of mouse buttons. ---------
1031
Parameters:
1031
Parameters:
1032
  * eax = 18 - function number
1032
  * eax = 18 - function number
1033
  * ebx = 19 - subfunction number
1033
  * ebx = 19 - subfunction number
1034
  * ecx = 5 - subsubfunction number
1034
  * ecx = 5 - subsubfunction number
1035
  * edx = information about emulated state of mouse buttons:
1035
  * edx = information about emulated state of mouse buttons:
1036
    (same as return value in subfunction 2 of function 37)
1036
    (same as return value in subfunction 2 of function 37)
1037
    * bit 0 is set = left button is pressed
1037
    * bit 0 is set = left button is pressed
1038
    * bit 1 is set = right button is pressed
1038
    * bit 1 is set = right button is pressed
1039
    * bit 2 is set = middle button is pressed
1039
    * bit 2 is set = middle button is pressed
1040
    * bit 3 is set = 4th button is pressed
1040
    * bit 3 is set = 4th button is pressed
1041
    * bit 4 is set = 5th button is pressed
1041
    * bit 4 is set = 5th button is pressed
1042
Returned value:
1042
Returned value:
1043
  * function does not return value
1043
  * function does not return value
-
 
1044
 
-
 
1045
-------------- Subsubfunction 6 - get doubleclick delay. -------------
-
 
1046
Parameters:
-
 
1047
  * eax = 18 - function number
-
 
1048
  * ebx = 19 - subfunction number
-
 
1049
  * ecx = 6 - subsubfunction number
-
 
1050
Returned value:
-
 
1051
  * eax = current doubleclick delay (100 = 1 second)
-
 
1052
 
-
 
1053
-------------- Subsubfunction 7 - set doubleclick delay. -------------
-
 
1054
Parameters:
-
 
1055
  * eax = 18 - function number
-
 
1056
  * ebx = 19 - subfunction number
-
 
1057
  * ecx = 7 - subsubfunction number
-
 
1058
  * dl  = new value for doubleclick delay (100 = 1 second)
-
 
1059
Returned value:
-
 
1060
  * function does not return value
-
 
1061
 
1044
Remarks:
1062
Remarks:
1045
  * It is recommended to set speed of the mouse (in subsubfunction 1)
1063
  * It is recommended to set speed of the mouse (in subsubfunction 1)
1046
    from 1 up to 9. The installed value is not inspected by the kernel
1064
    from 1 up to 9. The installed value is not inspected by the kernel
1047
    code, so set it carefully, at incorrect value the cursor
1065
    code, so set it carefully, at incorrect value the cursor
1048
    can "freeze". Speed of the mouse can be regulated through the
1066
    can "freeze". Speed of the mouse can be regulated through the
1049
    application SETUP.
1067
    application SETUP.
1050
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
1068
  * Recommended delay of the mouse (in subsubfunction 3) = 10. Lower
1051
    value is not handled by COM mice. At the very large values the
1069
    value is not handled by COM mice. At the very large values the
1052
    movement of the mouse on 1 pixel is impossible and the cursor will
1070
    movement of the mouse on 1 pixel is impossible and the cursor will
1053
    jump on the value of installed speed (subsubfunction 1). The
1071
    jump on the value of installed speed (subsubfunction 1). The
1054
    installed value is not inspected by the kernel code.
1072
    installed value is not inspected by the kernel code.
1055
    Mouse delay can be regulated through the application SETUP.
1073
    Mouse delay can be regulated through the application SETUP.
1056
  * The subsubfunction 4 does not check the passed value. Before
1074
  * The subsubfunction 4 does not check the passed value. Before
1057
    its call find out current screen resolution (with function 14)
1075
    its call find out current screen resolution (with function 14)
1058
    and check that the value of position is inside the limits of the
1076
    and check that the value of position is inside the limits of the
1059
    screen.
1077
    screen.
1060
 
1078
 
1061
======================================================================
1079
======================================================================
1062
======== Function 18, subfunction 20 - get information on RAM. =======
1080
======== Function 18, subfunction 20 - get information on RAM. =======
1063
======================================================================
1081
======================================================================
1064
Parameters:
1082
Parameters:
1065
  * eax = 18 - function number
1083
  * eax = 18 - function number
1066
  * ebx = 20 - subfunction number
1084
  * ebx = 20 - subfunction number
1067
  * ecx = pointer to the buffer for information (36 bytes)
1085
  * ecx = pointer to the buffer for information (36 bytes)
1068
Returned value:
1086
Returned value:
1069
  * eax = total size of existing RAM in pages
1087
  * eax = total size of existing RAM in pages
1070
    or -1 if error has occured
1088
    or -1 if error has occured
1071
  * buffer pointed to by ecx contains the following information:
1089
  * buffer pointed to by ecx contains the following information:
1072
    * +0:  dword: total size of existing RAM in pages
1090
    * +0:  dword: total size of existing RAM in pages
1073
    * +4:  dword: size of free RAM in pages
1091
    * +4:  dword: size of free RAM in pages
1074
    * +8:  dword: number of page faults (exceptions #PF)
1092
    * +8:  dword: number of page faults (exceptions #PF)
1075
                 in applications
1093
                 in applications
1076
    * +12: dword: size of kernel heap in bytes
1094
    * +12: dword: size of kernel heap in bytes
1077
    * +16: dword: free in kernel heap in bytes
1095
    * +16: dword: free in kernel heap in bytes
1078
    * +20: dword: total number of memory blocks in kernel heap
1096
    * +20: dword: total number of memory blocks in kernel heap
1079
    * +24: dword: number of free memory blocks in kernel heap
1097
    * +24: dword: number of free memory blocks in kernel heap
1080
    * +28: dword: size of maximum free block in kernel heap
1098
    * +28: dword: size of maximum free block in kernel heap
1081
                 (reserved)
1099
                 (reserved)
1082
    * +32: dword: size of maximum allocated block in kernel heap
1100
    * +32: dword: size of maximum allocated block in kernel heap
1083
                 (reserved)
1101
                 (reserved)
1084
 
1102
 
1085
======================================================================
1103
======================================================================
1086
===================== Function 18, subfunction 21 ====================
1104
===================== Function 18, subfunction 21 ====================
1087
======== Get slot number of process/thread by the identifier. ========
1105
======== Get slot number of process/thread by the identifier. ========
1088
======================================================================
1106
======================================================================
1089
Parameters:
1107
Parameters:
1090
  * eax = 18 - function number
1108
  * eax = 18 - function number
1091
  * ebx = 21 - subfunction number
1109
  * ebx = 21 - subfunction number
1092
  * ecx = identifer of process/thread (PID/TID)
1110
  * ecx = identifer of process/thread (PID/TID)
1093
Returned value:
1111
Returned value:
1094
  * eax = 0 - error (invalid identifier)
1112
  * eax = 0 - error (invalid identifier)
1095
  * otherwise eax = slot number
1113
  * otherwise eax = slot number
1096
 
1114
 
1097
======================================================================
1115
======================================================================
1098
===================== Function 18, subfunction 22 ====================
1116
===================== Function 18, subfunction 22 ====================
1099
============== Operations with window of another thread. =============
1117
============== Operations with window of another thread. =============
1100
======================================================================
1118
======================================================================
1101
Parameters:
1119
Parameters:
1102
  * eax = 18 - function number
1120
  * eax = 18 - function number
1103
  * ebx = 22 - subfunction number
1121
  * ebx = 22 - subfunction number
1104
  * ecx = operation type:
1122
  * ecx = operation type:
1105
    * 0 = minimize window of the thread with given slot number
1123
    * 0 = minimize window of the thread with given slot number
1106
    * 1 = minimize window of the thread with given identifier
1124
    * 1 = minimize window of the thread with given identifier
1107
    * 2 = restore window of the thread with given slot number
1125
    * 2 = restore window of the thread with given slot number
1108
    * 3 = restore window of the thread with given identifier
1126
    * 3 = restore window of the thread with given identifier
1109
  * edx = parameter (slot number or PID/TID)
1127
  * edx = parameter (slot number or PID/TID)
1110
Returned value:
1128
Returned value:
1111
  * eax = 0 - success
1129
  * eax = 0 - success
1112
  * eax = -1 - error (invalid identifier)
1130
  * eax = -1 - error (invalid identifier)
1113
Remarks:
1131
Remarks:
1114
  * The thread can minimize its window with subfunction 10.
1132
  * The thread can minimize its window with subfunction 10.
1115
  * One can restore and activate window simultaneously with
1133
  * One can restore and activate window simultaneously with
1116
    subfunction 3 (which requires slot number).
1134
    subfunction 3 (which requires slot number).
1117
 
1135
 
1118
======================================================================
1136
======================================================================
1119
======== Function 18, subfunction 23 - minimize all windows. ==========
1137
======== Function 18, subfunction 23 - minimize all windows. ==========
1120
======================================================================
1138
======================================================================
1121
Parameters:
1139
Parameters:
1122
  * eax = 18 - function number
1140
  * eax = 18 - function number
1123
  * ebx = 23 - subfunction number
1141
  * ebx = 23 - subfunction number
1124
Returned value:
1142
Returned value:
1125
  * eax = 0 - all windows have been minimized before a function call
1143
  * eax = 0 - all windows have been minimized before a function call
1126
  * eax = N - number of windows minimized from function
1144
  * eax = N - number of windows minimized from function
1127
Remarks:
1145
Remarks:
1128
  * Window of special thread (name begin to symbol @) is not minimize.
1146
  * Window of special thread (name begin to symbol @) is not minimize.
1129
 
1147
 
1130
======================================================================
1148
======================================================================
1131
======= Function 18, subfunction 24 - set limits of screen. ==========
1149
======= Function 18, subfunction 24 - set limits of screen. ==========
1132
======================================================================
1150
======================================================================
1133
Parameters:
1151
Parameters:
1134
  * eax = 18 - function number
1152
  * eax = 18 - function number
1135
  * ebx = 24 - subfunction number
1153
  * ebx = 24 - subfunction number
1136
  * ecx = new X size
1154
  * ecx = new X size
1137
  * edx = new Y size
1155
  * edx = new Y size
1138
Returned value:
1156
Returned value:
1139
  * function does not return value
1157
  * function does not return value
1140
Remarks:
1158
Remarks:
1141
  * The function does not change the physical size of the video mode.
1159
  * The function does not change the physical size of the video mode.
1142
    It is designed for non-standard displays which display the image
1160
    It is designed for non-standard displays which display the image
1143
    partially.
1161
    partially.
1144
  * The sizes specified in the function should not exceed the sizes
1162
  * The sizes specified in the function should not exceed the sizes
1145
    of the current video mode, otherwise the function will not change
1163
    of the current video mode, otherwise the function will not change
1146
    anything.
1164
    anything.
1147
 
1165
 
1148
======================================================================
1166
======================================================================
1149
===================== Function 18, subfunction 25 ====================
1167
===================== Function 18, subfunction 25 ====================
1150
===== Control position of the window relative to other windows. ======
1168
===== Control position of the window relative to other windows. ======
1151
======================================================================
1169
======================================================================
1152
 
1170
 
1153
------------- Subsubfunction 1 - get position  -----------------------
1171
------------- Subsubfunction 1 - get position  -----------------------
1154
Parameters:
1172
Parameters:
1155
  * eax = 18 - function number
1173
  * eax = 18 - function number
1156
  * ebx = 25 - subfunction number
1174
  * ebx = 25 - subfunction number
1157
  * ecx = 1 - subsubfunction number
1175
  * ecx = 1 - subsubfunction number
1158
  * edx = -1(for current window) or PID application
1176
  * edx = -1(for current window) or PID application
1159
Returned value:
1177
Returned value:
1160
  * eax = one of the constants window position
1178
  * eax = one of the constants window position
1161
 
1179
 
1162
------------- Subsubfunction 2 - set position  -----------------------
1180
------------- Subsubfunction 2 - set position  -----------------------
1163
Parameters:
1181
Parameters:
1164
  * eax = 18 - function number
1182
  * eax = 18 - function number
1165
  * ebx = 25 - subfunction number
1183
  * ebx = 25 - subfunction number
1166
  * ecx = 2 - subsubfunction number
1184
  * ecx = 2 - subsubfunction number
1167
  * edx = -1(for current window) or PID application
1185
  * edx = -1(for current window) or PID application
1168
  * esi = new window position (one of the constants below)
1186
  * esi = new window position (one of the constants below)
1169
Returned value:
1187
Returned value:
1170
  * eax = 0 - error
1188
  * eax = 0 - error
1171
  * eax = 1 - success
1189
  * eax = 1 - success
1172
 
1190
 
1173
Constant position of the window relative to other windows:
1191
Constant position of the window relative to other windows:
1174
 ZPOS_NORMAL      = 0 - normal
1192
 ZPOS_NORMAL      = 0 - normal
1175
 ZPOS_ALWAYS_BACK = 1 - behind all the windows
1193
 ZPOS_ALWAYS_BACK = 1 - behind all the windows
1176
 ZPOS_DESKTOP     = 2 - on the background
1194
 ZPOS_DESKTOP     = 2 - on the background
1177
 ZPOS_ALWAYS_TOP  = 3 - on top of all windows
1195
 ZPOS_ALWAYS_TOP  = 3 - on top of all windows
1178
 
1196
 
1179
======================================================================
1197
======================================================================
1180
==================== Function 20 - MIDI interface. ===================
1198
==================== Function 20 - MIDI interface. ===================
1181
======================================================================
1199
======================================================================
1182
 
1200
 
1183
----------------------- Subfunction 1 - reset ------------------------
1201
----------------------- Subfunction 1 - reset ------------------------
1184
Parameters:
1202
Parameters:
1185
  * eax = 20 - function number
1203
  * eax = 20 - function number
1186
  * ebx = 1 - subfunction number
1204
  * ebx = 1 - subfunction number
1187
 
1205
 
1188
-------------------- Subfunction 2 - output byte ---------------------
1206
-------------------- Subfunction 2 - output byte ---------------------
1189
Parameters:
1207
Parameters:
1190
  * eax = 20 - function number
1208
  * eax = 20 - function number
1191
  * ebx = 2 - subfunction number
1209
  * ebx = 2 - subfunction number
1192
  * cl = byte for output
1210
  * cl = byte for output
1193
Returned value (is the same for both subfunctions):
1211
Returned value (is the same for both subfunctions):
1194
  * eax = 0 - success
1212
  * eax = 0 - success
1195
  * eax = 1 - base port is not defined
1213
  * eax = 1 - base port is not defined
1196
Remarks:
1214
Remarks:
1197
  * Previously the base port must be defined by
1215
  * Previously the base port must be defined by
1198
    subfunction 1 of function 21.
1216
    subfunction 1 of function 21.
1199
 
1217
 
1200
======================================================================
1218
======================================================================
1201
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
1219
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
1202
======================================================================
1220
======================================================================
1203
Parameters:
1221
Parameters:
1204
  * eax = 21 - function number
1222
  * eax = 21 - function number
1205
  * ebx = 1 - subfunction number
1223
  * ebx = 1 - subfunction number
1206
  * ecx = number of base port
1224
  * ecx = number of base port
1207
Returned value
1225
Returned value
1208
  * eax = 0 - success
1226
  * eax = 0 - success
1209
  * eax = -1 - erratic number of a port
1227
  * eax = -1 - erratic number of a port
1210
Remarks:
1228
Remarks:
1211
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
1229
  * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
1212
  * The installation of base is necessary for function 20.
1230
  * The installation of base is necessary for function 20.
1213
  * To get base port use subfunction 1 of function 26.
1231
  * To get base port use subfunction 1 of function 26.
1214
 
1232
 
1215
======================================================================
1233
======================================================================
1216
========== Function 21, subfunction 2 - set keyboard layout. =========
1234
========== Function 21, subfunction 2 - set keyboard layout. =========
1217
======================================================================
1235
======================================================================
1218
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
1236
Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
1219
which will be read by function 2.
1237
which will be read by function 2.
1220
Parameters:
1238
Parameters:
1221
  * eax = 21 - function number
1239
  * eax = 21 - function number
1222
  * ebx = 2 - subfunction number
1240
  * ebx = 2 - subfunction number
1223
  * ecx = which layout to set:
1241
  * ecx = which layout to set:
1224
    * 1 = normal layout
1242
    * 1 = normal layout
1225
    * 2 = layout at pressed Shift
1243
    * 2 = layout at pressed Shift
1226
    * 3 = layout at pressed Alt
1244
    * 3 = layout at pressed Alt
1227
  * edx = pointer to layout - table of length 128 bytes
1245
  * edx = pointer to layout - table of length 128 bytes
1228
Or:
1246
Or:
1229
  * ecx = 9
1247
  * ecx = 9
1230
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1248
  * dx = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1231
Returned value:
1249
Returned value:
1232
  * eax = 0 - success
1250
  * eax = 0 - success
1233
  * eax = 1 - incorrect parameter
1251
  * eax = 1 - incorrect parameter
1234
Remarks:
1252
Remarks:
1235
  * If Alt is pressed, the layout with Alt is used;
1253
  * If Alt is pressed, the layout with Alt is used;
1236
    if Alt is not pressed, but Shift is pressed,
1254
    if Alt is not pressed, but Shift is pressed,
1237
    the layout with Shift is used;
1255
    the layout with Shift is used;
1238
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1256
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1239
    layout is used and then from the code is subtracted 0x60;
1257
    layout is used and then from the code is subtracted 0x60;
1240
    if no control key is pressed, the normal layout is used.
1258
    if no control key is pressed, the normal layout is used.
1241
  * To get layout and country identifier use
1259
  * To get layout and country identifier use
1242
    subfunction 2 of function 26.
1260
    subfunction 2 of function 26.
1243
  * Country identifier is global system variable, which is not used
1261
  * Country identifier is global system variable, which is not used
1244
    by the kernel itself; however the application '@taskbar' displays
1262
    by the kernel itself; however the application '@taskbar' displays
1245
    the corresponding icon.
1263
    the corresponding icon.
1246
  * The application @taskbar switches layouts on user request.
1264
  * The application @taskbar switches layouts on user request.
1247
 
1265
 
1248
======================================================================
1266
======================================================================
1249
========== Function 21, subfunction 5 - set system language. =========
1267
========== Function 21, subfunction 5 - set system language. =========
1250
======================================================================
1268
======================================================================
1251
Parameters:
1269
Parameters:
1252
  * eax = 21 - function number
1270
  * eax = 21 - function number
1253
  * ebx = 5 - subfunction number
1271
  * ebx = 5 - subfunction number
1254
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
1272
  * ecx = system language (1=eng, 2=fi, 3=ger, 4=rus)
1255
Returned value:
1273
Returned value:
1256
  * eax = 0
1274
  * eax = 0
1257
Remarks:
1275
Remarks:
1258
  * System language is global system variable and is not used
1276
  * System language is global system variable and is not used
1259
    by the kernel itself, however application @taskbar draws the
1277
    by the kernel itself, however application @taskbar draws the
1260
    appropriate icon.
1278
    appropriate icon.
1261
  * Function does not check for correctness, as the kernel does not
1279
  * Function does not check for correctness, as the kernel does not
1262
    use this variable.
1280
    use this variable.
1263
  * To get system language use subfunction 5 of function 26.
1281
  * To get system language use subfunction 5 of function 26.
1264
 
1282
 
1265
======================================================================
1283
======================================================================
1266
 Function 21, subfunction 11 - enable/disable low-level access to HD.
1284
 Function 21, subfunction 11 - enable/disable low-level access to HD.
1267
======================================================================
1285
======================================================================
1268
Parameters:
1286
Parameters:
1269
  * eax = 21 - function number
1287
  * eax = 21 - function number
1270
  * ebx = 11 - subfunction number
1288
  * ebx = 11 - subfunction number
1271
  * ecx = 0/1 - disable/enable
1289
  * ecx = 0/1 - disable/enable
1272
Returned value:
1290
Returned value:
1273
  * eax = 0
1291
  * eax = 0
1274
Remarks:
1292
Remarks:
1275
  * Is used in LBA-read (subfunction 8 of function 58).
1293
  * Is used in LBA-read (subfunction 8 of function 58).
1276
  * The current implementation uses only low bit of ecx.
1294
  * The current implementation uses only low bit of ecx.
1277
  * To get current status use subfunction 11 of function 26.
1295
  * To get current status use subfunction 11 of function 26.
1278
 
1296
 
1279
======================================================================
1297
======================================================================
1280
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
1298
 Function 21, subfunction 12 - enable/disable low-level access to PCI.
1281
======================================================================
1299
======================================================================
1282
Parameters:
1300
Parameters:
1283
  * eax = 21 - function number
1301
  * eax = 21 - function number
1284
  * ebx = 12 - subfunction number
1302
  * ebx = 12 - subfunction number
1285
  * ecx = 0/1 - disable/enable
1303
  * ecx = 0/1 - disable/enable
1286
Returned value:
1304
Returned value:
1287
  * eax = 0
1305
  * eax = 0
1288
Remarks:
1306
Remarks:
1289
  * Is used in operations with PCI bus (function 62).
1307
  * Is used in operations with PCI bus (function 62).
1290
  * The current implementation uses only low bit of ecx.
1308
  * The current implementation uses only low bit of ecx.
1291
  * To get current status use subfunction 12 of function 26.
1309
  * To get current status use subfunction 12 of function 26.
1292
 
1310
 
1293
======================================================================
1311
======================================================================
1294
================= Function 22 - set system date/time. ================
1312
================= Function 22 - set system date/time. ================
1295
======================================================================
1313
======================================================================
1296
Parameters:
1314
Parameters:
1297
  * eax = 22 - function number
1315
  * eax = 22 - function number
1298
  * ebx = 0 - set time
1316
  * ebx = 0 - set time
1299
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
1317
    * ecx = 0x00SSMMHH - time in the binary-decimal code (BCD):
1300
    * HH=hour 00..23
1318
    * HH=hour 00..23
1301
    * MM=minute 00..59
1319
    * MM=minute 00..59
1302
    * SS=second 00..59
1320
    * SS=second 00..59
1303
  * ebx = 1 - set date
1321
  * ebx = 1 - set date
1304
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
1322
    * ecx = 0x00DDMMYY - date in the binary-decimal code (BCD):
1305
    * DD=day 01..31
1323
    * DD=day 01..31
1306
    * MM=month 01..12
1324
    * MM=month 01..12
1307
    * YY=year 00..99
1325
    * YY=year 00..99
1308
  * ebx = 2 - set day of week
1326
  * ebx = 2 - set day of week
1309
    * ecx = 1 for Sunday, ..., 7 for Saturday
1327
    * ecx = 1 for Sunday, ..., 7 for Saturday
1310
  * ebx = 3 - set alarm clock
1328
  * ebx = 3 - set alarm clock
1311
    * ecx = 0x00SSMMHH
1329
    * ecx = 0x00SSMMHH
1312
Returned value:
1330
Returned value:
1313
  * eax = 0 - success
1331
  * eax = 0 - success
1314
  * eax = 1 - incorrect parameter
1332
  * eax = 1 - incorrect parameter
1315
  * eax = 2 - CMOS-battery was unloaded
1333
  * eax = 2 - CMOS-battery was unloaded
1316
Remarks:
1334
Remarks:
1317
  * Value of installation of day of week seems to be doubtful,
1335
  * Value of installation of day of week seems to be doubtful,
1318
    as it a little where is used
1336
    as it a little where is used
1319
    (day of week can be calculated by date).
1337
    (day of week can be calculated by date).
1320
  * Alarm clock can be set on operation in the given time every day.
1338
  * Alarm clock can be set on operation in the given time every day.
1321
    But there is no existing system function to disable it.
1339
    But there is no existing system function to disable it.
1322
  * Operation of alarm clock consists in generation IRQ8.
1340
  * Operation of alarm clock consists in generation IRQ8.
1323
  * Generally CMOS supports for alarm clock set of value 0xFF
1341
  * Generally CMOS supports for alarm clock set of value 0xFF
1324
    as one of parameters and it means that the appropriate parameter
1342
    as one of parameters and it means that the appropriate parameter
1325
    is ignored. But current implementation does not allow this
1343
    is ignored. But current implementation does not allow this
1326
    (will return 1).
1344
    (will return 1).
1327
  * Alarm clock is a global system resource; the set of
1345
  * Alarm clock is a global system resource; the set of
1328
    an alarm clock cancels automatically the previous set.
1346
    an alarm clock cancels automatically the previous set.
1329
    However, at moment no program uses it.
1347
    However, at moment no program uses it.
1330
 
1348
 
1331
======================================================================
1349
======================================================================
1332
============= Function 23 - wait for event with timeout. =============
1350
============= Function 23 - wait for event with timeout. =============
1333
======================================================================
1351
======================================================================
1334
If the message queue is empty, waits for new message in the queue,
1352
If the message queue is empty, waits for new message in the queue,
1335
but no more than given time. Then reads out a message from the queue.
1353
but no more than given time. Then reads out a message from the queue.
1336
 
1354
 
1337
Parameters:
1355
Parameters:
1338
  * eax = 23 - function number
1356
  * eax = 23 - function number
1339
  * ebx = timeout (in 1/100 of second)
1357
  * ebx = timeout (in 1/100 of second)
1340
Returned value:
1358
Returned value:
1341
  * eax = 0 - the message queue is empty
1359
  * eax = 0 - the message queue is empty
1342
  * otherwise eax = event (see the list of events)
1360
  * otherwise eax = event (see the list of events)
1343
Remarks:
1361
Remarks:
1344
  * Only those events are taken into account, which enter into
1362
  * Only those events are taken into account, which enter into
1345
    the mask set by function 40. By default it is
1363
    the mask set by function 40. By default it is
1346
    redraw, key and button events.
1364
    redraw, key and button events.
1347
  * To check for presence of a message in the queue use function 11.
1365
  * To check for presence of a message in the queue use function 11.
1348
    To wait without timeout use function 10.
1366
    To wait without timeout use function 10.
1349
  * Transmission ebx=0 results in immediate returning eax=0.
1367
  * Transmission ebx=0 results in immediate returning eax=0.
1350
  * Current implementation returns immediately with eax=0,
1368
  * Current implementation returns immediately with eax=0,
1351
    if the addition of ebx with the current value of time counter
1369
    if the addition of ebx with the current value of time counter
1352
    makes 32-bit overflow.
1370
    makes 32-bit overflow.
1353
 
1371
 
1354
======================================================================
1372
======================================================================
1355
======= Function 24, subfunction 4 - eject tray of disk drive. =======
1373
======= Function 24, subfunction 4 - eject tray of disk drive. =======
1356
======================================================================
1374
======================================================================
1357
Parameters:
1375
Parameters:
1358
  * eax = 24 - function number
1376
  * eax = 24 - function number
1359
  * ebx = 4 - subfunction number
1377
  * ebx = 4 - subfunction number
1360
  * ecx = position of CD/DVD-drive
1378
  * ecx = position of CD/DVD-drive
1361
    from 0=Primary Master to 3=Secondary Slave for first IDE contr.
1379
    from 0=Primary Master to 3=Secondary Slave for first IDE contr.
1362
    from 4=Primary Master to 7=Secondary Slave for second IDE contr.
1380
    from 4=Primary Master to 7=Secondary Slave for second IDE contr.
1363
    from 8=Primary Master to 11=Secondary Slave for third IDE contr.
1381
    from 8=Primary Master to 11=Secondary Slave for third IDE contr.
1364
Returned value:
1382
Returned value:
1365
  * function does not return value
1383
  * function does not return value
1366
Remarks:
1384
Remarks:
1367
  * The function is supported only for ATAPI devices (CD and DVD).
1385
  * The function is supported only for ATAPI devices (CD and DVD).
1368
  * When the tray is being ejected,
1386
  * When the tray is being ejected,
1369
    manual control of tray is unlocked.
1387
    manual control of tray is unlocked.
1370
  * When the tray is being ejected, the code clears the cache for
1388
  * When the tray is being ejected, the code clears the cache for
1371
    corresponding device.
1389
    corresponding device.
1372
  * An example of usage of the function is the application CD_tray.
1390
  * An example of usage of the function is the application CD_tray.
1373
 
1391
 
1374
======================================================================
1392
======================================================================
1375
======== Function 24, subfunction 5 - load tray of disk drive. =======
1393
======== Function 24, subfunction 5 - load tray of disk drive. =======
1376
======================================================================
1394
======================================================================
1377
Parameters:
1395
Parameters:
1378
  * eax = 24 - function number
1396
  * eax = 24 - function number
1379
  * ebx = 5 - subfunction number
1397
  * ebx = 5 - subfunction number
1380
  * ecx = position of CD/DVD-drive
1398
  * ecx = position of CD/DVD-drive
1381
    from 0=Primary Master to 3=Secondary Slave for first IDE contr.
1399
    from 0=Primary Master to 3=Secondary Slave for first IDE contr.
1382
    from 4=Primary Master to 7=Secondary Slave for second IDE contr.
1400
    from 4=Primary Master to 7=Secondary Slave for second IDE contr.
1383
    from 8=Primary Master to 11=Secondary Slave for third IDE contr.
1401
    from 8=Primary Master to 11=Secondary Slave for third IDE contr.
1384
Returned value:
1402
Returned value:
1385
  * function does not return value
1403
  * function does not return value
1386
Remarks:
1404
Remarks:
1387
  * The function is supported only for ATAPI devices (CD and DVD).
1405
  * The function is supported only for ATAPI devices (CD and DVD).
1388
  * An example of usage of the function is the application CD_tray.
1406
  * An example of usage of the function is the application CD_tray.
1389
 
1407
 
1390
======================================================================
1408
======================================================================
1391
======= Function 25 - put image area on the background layer. ========
1409
======= Function 25 - put image area on the background layer. ========
1392
======================================================================
1410
======================================================================
1393
Paramters:
1411
Paramters:
1394
  * eax = 25 - function number
1412
  * eax = 25 - function number
1395
  * ebx = pointer to the previously allocated memory area,
1413
  * ebx = pointer to the previously allocated memory area,
1396
        where placed the source images in a format BBGGRRTTBBGGRRTT...
1414
        where placed the source images in a format BBGGRRTTBBGGRRTT...
1397
  * ecx = [size on axis x]*65536 + [size on axis y]
1415
  * ecx = [size on axis x]*65536 + [size on axis y]
1398
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1416
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1399
Returned value:
1417
Returned value:
1400
  * function does not return value
1418
  * function does not return value
1401
Remarks:
1419
Remarks:
1402
  * Coordinates of the image are coordinates of the upper left corner
1420
  * Coordinates of the image are coordinates of the upper left corner
1403
    of the image relative to the screen.
1421
    of the image relative to the screen.
1404
  * Size of the image in bytes is 4*xsize*ysize
1422
  * Size of the image in bytes is 4*xsize*ysize
1405
  * TT - byte pointer of transparency, at current version:
1423
  * TT - byte pointer of transparency, at current version:
1406
         1 to FF - opaque, 0 - transparent.
1424
         1 to FF - opaque, 0 - transparent.
1407
  * The function places the image directly to LFB. It is not for
1425
  * The function places the image directly to LFB. It is not for
1408
    background image f.15. Options f.15 to f.25 does not make sense.
1426
    background image f.15. Options f.15 to f.25 does not make sense.
1409
 
1427
 
1410
======================================================================
1428
======================================================================
1411
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
1429
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
1412
======================================================================
1430
======================================================================
1413
Parameters:
1431
Parameters:
1414
  * eax = 26 - function number
1432
  * eax = 26 - function number
1415
  * ebx = 1 - subfunction number
1433
  * ebx = 1 - subfunction number
1416
Returned value:
1434
Returned value:
1417
  * eax = port number
1435
  * eax = port number
1418
Parameters:
1436
Parameters:
1419
  * To set base port use subfunction 1 of function 21.
1437
  * To set base port use subfunction 1 of function 21.
1420
 
1438
 
1421
======================================================================
1439
======================================================================
1422
========== Function 26, subfunction 2 - get keyboard layout. =========
1440
========== Function 26, subfunction 2 - get keyboard layout. =========
1423
======================================================================
1441
======================================================================
1424
The keyboard layout is used to convert keyboard scancodes to
1442
The keyboard layout is used to convert keyboard scancodes to
1425
ASCII-codes for function 2.
1443
ASCII-codes for function 2.
1426
Parameters:
1444
Parameters:
1427
  * eax = 26 - function number
1445
  * eax = 26 - function number
1428
  * ebx = 2 - subfunction number
1446
  * ebx = 2 - subfunction number
1429
  * ecx = what layout to get:
1447
  * ecx = what layout to get:
1430
    * 1 = normal layout
1448
    * 1 = normal layout
1431
    * 2 = layout with pressed Shift
1449
    * 2 = layout with pressed Shift
1432
    * 3 = layout with pressed Alt
1450
    * 3 = layout with pressed Alt
1433
  * edx = pointer to the 128-bytes buffer, where the layout will be
1451
  * edx = pointer to the 128-bytes buffer, where the layout will be
1434
    copied
1452
    copied
1435
Returned value:
1453
Returned value:
1436
  * function does not return value
1454
  * function does not return value
1437
Or:
1455
Or:
1438
  * eax = 26 - function number
1456
  * eax = 26 - function number
1439
  * ebx = 2 - subfunction number
1457
  * ebx = 2 - subfunction number
1440
  * ecx = 9
1458
  * ecx = 9
1441
Returned value:
1459
Returned value:
1442
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1460
  * eax = country identifier (1=eng, 2=fi, 3=ger, 4=rus)
1443
Remarks:
1461
Remarks:
1444
  * If Alt is pressed, the layout with Alt is used;
1462
  * If Alt is pressed, the layout with Alt is used;
1445
    if Alt is not pressed, but Shift is pressed,
1463
    if Alt is not pressed, but Shift is pressed,
1446
    the layout with Shift is used;
1464
    the layout with Shift is used;
1447
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1465
    if Alt and Shift are not pressed, but Ctrl is pressed, the normal
1448
    layout is used and then from the code is subtracted 0x60;
1466
    layout is used and then from the code is subtracted 0x60;
1449
    if no control key is pressed, the normal layout is used.
1467
    if no control key is pressed, the normal layout is used.
1450
  * To set layout and country identifier use
1468
  * To set layout and country identifier use
1451
    subfunction 2 of function 21.
1469
    subfunction 2 of function 21.
1452
  * Country identifier is global system variable, which is not used
1470
  * Country identifier is global system variable, which is not used
1453
    by the kernel itself; however the application '@taskbar' displays
1471
    by the kernel itself; however the application '@taskbar' displays
1454
    the corresponding icon (using this function).
1472
    the corresponding icon (using this function).
1455
  * The application @taskbar switches layouts on user request.
1473
  * The application @taskbar switches layouts on user request.
1456
 
1474
 
1457
======================================================================
1475
======================================================================
1458
========== Function 26, subfunction 5 - get system language. =========
1476
========== Function 26, subfunction 5 - get system language. =========
1459
======================================================================
1477
======================================================================
1460
Parameters:
1478
Parameters:
1461
  * eax = 26 - function number
1479
  * eax = 26 - function number
1462
  * ebx = 5 - subfunction number
1480
  * ebx = 5 - subfunction number
1463
Returned value:
1481
Returned value:
1464
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
1482
  * eax = system language (1=eng, 2=fi, 3=ger, 4=rus)
1465
Remarks:
1483
Remarks:
1466
  * System language is global system variable and is not used
1484
  * System language is global system variable and is not used
1467
    by the kernel itself, however application @taskbar draws the
1485
    by the kernel itself, however application @taskbar draws the
1468
    appropriate icon (using this function).
1486
    appropriate icon (using this function).
1469
  * To set system language use subfunction 5 of function 21.
1487
  * To set system language use subfunction 5 of function 21.
1470
 
1488
 
1471
======================================================================
1489
======================================================================
1472
=== Function 26, subfunction 9 - get the value of the time counter. ==
1490
=== Function 26, subfunction 9 - get the value of the time counter. ==
1473
======================================================================
1491
======================================================================
1474
Parameters:
1492
Parameters:
1475
  * eax = 26 - function number
1493
  * eax = 26 - function number
1476
  * ebx = 9 - subfunction number
1494
  * ebx = 9 - subfunction number
1477
Returned value:
1495
Returned value:
1478
  * eax = number of 1/100s of second, past from the system boot time
1496
  * eax = number of 1/100s of second, past from the system boot time
1479
Remarks:
1497
Remarks:
1480
  * Counter takes modulo 2^32, that correspond to a little more
1498
  * Counter takes modulo 2^32, that correspond to a little more
1481
    than 497 days.
1499
    than 497 days.
1482
  * To get system time use function 3.  
1500
  * To get system time use function 3.  
1483
  
1501
  
1484
======================================================================
1502
======================================================================
1485
===================== Function 26, subfunction 10 ====================
1503
===================== Function 26, subfunction 10 ====================
1486
========== Get the value of the high precision time counter. =========
1504
========== Get the value of the high precision time counter. =========
1487
======================================================================
1505
======================================================================
1488
Parameters:
1506
Parameters:
1489
  * eax = 26 - function number
1507
  * eax = 26 - function number
1490
  * ebx = 10 - subfunction number
1508
  * ebx = 10 - subfunction number
1491
Returned value:
1509
Returned value:
1492
  * eax = number of nanoseconds since system boot time (lower DWORD)
1510
  * eax = number of nanoseconds since system boot time (lower DWORD)
1493
  * edx = number of nanoseconds since system boot time (high DWORD)  
1511
  * edx = number of nanoseconds since system boot time (high DWORD)  
1494
Remarks:
1512
Remarks:
1495
  * The counter is based on HPET, if HPET is not available, resolution
1513
  * The counter is based on HPET, if HPET is not available, resolution
1496
    will be reduced to 10 000 000 nanoseconds.
1514
    will be reduced to 10 000 000 nanoseconds.
1497
 
1515
 
1498
======================================================================
1516
======================================================================
1499
===================== Function 26, subfunction 11 ====================
1517
===================== Function 26, subfunction 11 ====================
1500
========== Find out whether low-level HD access is enabled. ==========
1518
========== Find out whether low-level HD access is enabled. ==========
1501
======================================================================
1519
======================================================================
1502
Parameters:
1520
Parameters:
1503
  * eax = 26 - function number
1521
  * eax = 26 - function number
1504
  * ebx = 11 - subfunction number
1522
  * ebx = 11 - subfunction number
1505
Returned value:
1523
Returned value:
1506
  * eax = 0/1 - disabled/enabled
1524
  * eax = 0/1 - disabled/enabled
1507
Remarks:
1525
Remarks:
1508
  * Is used in LBA read (subfunction 8 of function 58).
1526
  * Is used in LBA read (subfunction 8 of function 58).
1509
  * To set current state use subfunction 11 of function 21.
1527
  * To set current state use subfunction 11 of function 21.
1510
 
1528
 
1511
======================================================================
1529
======================================================================
1512
===================== Function 26, subfunction 12 ====================
1530
===================== Function 26, subfunction 12 ====================
1513
========== Find out whether low-level PCI access is enabled. =========
1531
========== Find out whether low-level PCI access is enabled. =========
1514
======================================================================
1532
======================================================================
1515
Parameters:
1533
Parameters:
1516
  * eax = 26 - function number
1534
  * eax = 26 - function number
1517
  * ebx = 12 - subfunction number
1535
  * ebx = 12 - subfunction number
1518
Returned value:
1536
Returned value:
1519
  * eax = 0/1 - disabled/enabled
1537
  * eax = 0/1 - disabled/enabled
1520
Remarks:
1538
Remarks:
1521
  * Is used by operations with PCI bus (function 62).
1539
  * Is used by operations with PCI bus (function 62).
1522
  * The current implementation uses only low bit of ecx.
1540
  * The current implementation uses only low bit of ecx.
1523
  * To set the current state use subfunction 12 of function 21.
1541
  * To set the current state use subfunction 12 of function 21.
1524
 
1542
 
1525
======================================================================
1543
======================================================================
1526
=================== Function 29 - get system date. ===================
1544
=================== Function 29 - get system date. ===================
1527
======================================================================
1545
======================================================================
1528
Parameters:
1546
Parameters:
1529
  * eax = 29 - function number
1547
  * eax = 29 - function number
1530
Returned value:
1548
Returned value:
1531
  * eax = 0x00DDMMYY, where
1549
  * eax = 0x00DDMMYY, where
1532
    (binary-decimal coding, BCD, is used)
1550
    (binary-decimal coding, BCD, is used)
1533
  * YY = two low digits of year (00..99)
1551
  * YY = two low digits of year (00..99)
1534
  * MM = month (01..12)
1552
  * MM = month (01..12)
1535
  * DD = day (01..31)
1553
  * DD = day (01..31)
1536
Remarks:
1554
Remarks:
1537
  * To set system date use function 22.
1555
  * To set system date use function 22.
1538
 
1556
 
1539
======================================================================
1557
======================================================================
1540
============= Function 30 - work with the current folder. ============
1558
============= Function 30 - work with the current folder. ============
1541
======================================================================
1559
======================================================================
1542
 
1560
 
1543
--------- Subfunction 1 - set current folder for the thread. ---------
1561
--------- Subfunction 1 - set current folder for the thread. ---------
1544
Parameters:
1562
Parameters:
1545
  * eax = 30 - function number
1563
  * eax = 30 - function number
1546
  * ebx = 1 - subfunction number
1564
  * ebx = 1 - subfunction number
1547
  * ecx = pointer to ASCIIZ-string with the path to new current folder
1565
  * ecx = pointer to ASCIIZ-string with the path to new current folder
1548
Returned value:
1566
Returned value:
1549
  * function does not return value
1567
  * function does not return value
1550
 
1568
 
1551
--------- Subfunction 2 - get current folder for the thread. ---------
1569
--------- Subfunction 2 - get current folder for the thread. ---------
1552
Parameters:
1570
Parameters:
1553
  * eax = 30 - function number
1571
  * eax = 30 - function number
1554
  * ebx = 2 - subfunction number
1572
  * ebx = 2 - subfunction number
1555
  * ecx = pointer to buffer
1573
  * ecx = pointer to buffer
1556
  * edx = size of buffer
1574
  * edx = size of buffer
1557
Returned value:
1575
Returned value:
1558
  * eax = size of the current folder's name (including terminating 0)
1576
  * eax = size of the current folder's name (including terminating 0)
1559
Remarks:
1577
Remarks:
1560
  * If the buffer is too small to hold all data, only first (edx-1)
1578
  * If the buffer is too small to hold all data, only first (edx-1)
1561
    bytes are copied and than terminating 0 is inserted.
1579
    bytes are copied and than terminating 0 is inserted.
1562
  * By default, current folder for the thread is "/rd/1".
1580
  * By default, current folder for the thread is "/rd/1".
1563
  * At process/thread creation the current folder will be inherited
1581
  * At process/thread creation the current folder will be inherited
1564
    from the parent.
1582
    from the parent.
1565
 
1583
 
1566
--- Subfunction 3 - install the add.system directory for the kernel --
1584
--- Subfunction 3 - install the add.system directory for the kernel --
1567
Parameters:
1585
Parameters:
1568
  * eax = 30 - function number
1586
  * eax = 30 - function number
1569
  * ebx = 3 - subfunction number
1587
  * ebx = 3 - subfunction number
1570
  * ecx = pointer to a block of data:
1588
  * ecx = pointer to a block of data:
1571
          sysdir_name     rb 64
1589
          sysdir_name     rb 64
1572
          sysdir_path     rb 64
1590
          sysdir_path     rb 64
1573
For example:
1591
For example:
1574
dir_name1       db 'KolibriOS',0
1592
dir_name1       db 'KolibriOS',0
1575
                rb 64-10
1593
                rb 64-10
1576
dir_path1       db 'HD0/1',0
1594
dir_path1       db 'HD0/1',0
1577
                rb 64-6
1595
                rb 64-6
1578
Returned value:
1596
Returned value:
1579
  * function does not return value
1597
  * function does not return value
1580
Remarks:
1598
Remarks:
1581
  * The function can be called only 1 time for 1 session of the OS.
1599
  * The function can be called only 1 time for 1 session of the OS.
1582
 
1600
 
1583
======================================================================
1601
======================================================================
1584
========= Function 34 - who owner the pixel on the screen. ===========
1602
========= Function 34 - who owner the pixel on the screen. ===========
1585
======================================================================
1603
======================================================================
1586
Parameters:
1604
Parameters:
1587
  * eax = 34 - function number
1605
  * eax = 34 - function number
1588
  * ebx = x-coordinate (relative to the display)
1606
  * ebx = x-coordinate (relative to the display)
1589
  * ecx = y-coordinate (relative to the display)
1607
  * ecx = y-coordinate (relative to the display)
1590
 
1608
 
1591
Returned value:
1609
Returned value:
1592
  * eax = 0x000000XX - owner of pixel the slot window N
1610
  * eax = 0x000000XX - owner of pixel the slot window N
1593
    If incorrect values ebx and ecx then function returns 0
1611
    If incorrect values ebx and ecx then function returns 0
1594
  * The function takes the value from the area [_WinMapAddress]
1612
  * The function takes the value from the area [_WinMapAddress]
1595
 
1613
 
1596
======================================================================
1614
======================================================================
1597
======= Function 35 - read the color of a pixel on the screen. =======
1615
======= Function 35 - read the color of a pixel on the screen. =======
1598
======================================================================
1616
======================================================================
1599
Parameters:
1617
Parameters:
1600
  * eax = 35
1618
  * eax = 35
1601
  * ebx = y*xsize+x, where
1619
  * ebx = y*xsize+x, where
1602
  * (x,y) = coordinates of a pixel (beginning from 0)
1620
  * (x,y) = coordinates of a pixel (beginning from 0)
1603
  * xsize = horizontal screen size
1621
  * xsize = horizontal screen size
1604
Returned value:
1622
Returned value:
1605
  * eax = color 0x00RRGGBB
1623
  * eax = color 0x00RRGGBB
1606
Remarks:
1624
Remarks:
1607
  * To get screen sizes use function 14. Pay attention,
1625
  * To get screen sizes use function 14. Pay attention,
1608
    that it subtracts 1 from both sizes.
1626
    that it subtracts 1 from both sizes.
1609
  * There is also direct access (without any system calls)
1627
  * There is also direct access (without any system calls)
1610
    to videomemory through the selector gs. To get parameters of
1628
    to videomemory through the selector gs. To get parameters of
1611
    the current videomode, use function 61.
1629
    the current videomode, use function 61.
1612
 
1630
 
1613
======================================================================
1631
======================================================================
1614
=================== Function 36 - read screen area. ==================
1632
=================== Function 36 - read screen area. ==================
1615
======================================================================
1633
======================================================================
1616
Paramters:
1634
Paramters:
1617
  * eax = 36 - function number
1635
  * eax = 36 - function number
1618
  * ebx = pointer to the previously allocated memory area,
1636
  * ebx = pointer to the previously allocated memory area,
1619
        where will be placed the image in the format BBGGRRBBGGRR...
1637
        where will be placed the image in the format BBGGRRBBGGRR...
1620
  * ecx = [size on axis x]*65536 + [size on axis y]
1638
  * ecx = [size on axis x]*65536 + [size on axis y]
1621
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1639
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1622
Returned value:
1640
Returned value:
1623
  * function does not return value
1641
  * function does not return value
1624
Remarks:
1642
Remarks:
1625
  * Coordinates of the image are coordinates of the upper left corner
1643
  * Coordinates of the image are coordinates of the upper left corner
1626
    of the image relative to the screen.
1644
    of the image relative to the screen.
1627
  * Size of the image in bytes is 3*xsize*ysize.
1645
  * Size of the image in bytes is 3*xsize*ysize.
1628
 
1646
 
1629
======================================================================
1647
======================================================================
1630
=================== Function 37 - work with mouse. ===================
1648
=================== Function 37 - work with mouse. ===================
1631
======================================================================
1649
======================================================================
1632
 
1650
 
1633
---------- Subfunction 0 - screen coordinates of the mouse -----------
1651
---------- Subfunction 0 - screen coordinates of the mouse -----------
1634
Parameters:
1652
Parameters:
1635
  * eax = 37 - function number
1653
  * eax = 37 - function number
1636
  * ebx = 0 - subfunction number
1654
  * ebx = 0 - subfunction number
1637
Returned value:
1655
Returned value:
1638
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1656
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1639
    (beginning from 0)
1657
    (beginning from 0)
1640
 
1658
 
1641
-- Subfunction 1 - coordinates of the mouse relative to the window ---
1659
-- Subfunction 1 - coordinates of the mouse relative to the window ---
1642
Parameters:
1660
Parameters:
1643
  * eax = 37 - function number
1661
  * eax = 37 - function number
1644
  * ebx = 1 - subfunction number
1662
  * ebx = 1 - subfunction number
1645
Returned value:
1663
Returned value:
1646
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1664
  * eax = x*65536 + y, (x,y)=coordinates of the mouse pointer
1647
    relative to the application window (beginning from 0)
1665
    relative to the application window (beginning from 0)
1648
Remarks:
1666
Remarks:
1649
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
1667
  * The value is calculated by formula (x-xwnd)*65536 + (y-ywnd).
1650
    If y>=ywnd, the low word is non-negative and contains
1668
    If y>=ywnd, the low word is non-negative and contains
1651
    relative y-coordinate, and the high word - relative x-coordinate
1669
    relative y-coordinate, and the high word - relative x-coordinate
1652
    (with correct sign). Otherwise the low word is negative and still
1670
    (with correct sign). Otherwise the low word is negative and still
1653
    contains relative y-coordinate, and to the high word
1671
    contains relative y-coordinate, and to the high word
1654
    1 should be added.
1672
    1 should be added.
1655
 
1673
 
1656
------------ Subfunction 2 - pressed buttons of the mouse ------------
1674
------------- Subfunction 2 - states of the mouse buttons ------------
1657
Parameters:
1675
Parameters:
1658
  * eax = 37 - function number
1676
  * eax = 37 - function number
1659
  * ebx = 2 - subfunction number
1677
  * ebx = 2 - subfunction number
1660
Returned value:
1678
Returned value:
-
 
1679
  * eax = bits 0-4 equal to subfunction 3
-
 
1680
 
-
 
1681
------- Subfunction 3 - states and events of the mouse buttons -------
-
 
1682
Parameters:
-
 
1683
  * eax = 37 - function number
-
 
1684
  * ebx = 3 - subfunction number
-
 
1685
Returned value:
1661
  * eax contains information on the pressed mouse buttons:
1686
  * eax contains next information:
-
 
1687
 
-
 
1688
states:
1662
  * bit 0 is set = left button is pressed
1689
  * bit 0 is set = left button is held
1663
  * bit 1 is set = right button is pressed
1690
  * bit 1 is set = right button is held
1664
  * bit 2 is set = middle button is pressed
1691
  * bit 2 is set = middle button is held
-
 
1692
  * bit 3 is set = 4th button is held
-
 
1693
  * bit 4 is set = 5th button is held
-
 
1694
 
-
 
1695
events:
1665
  * bit 3 is set = 4th button is pressed
1696
  * bit 8 is set = left button is pressed
1666
  * bit 4 is set = 5th button is pressed
1697
  * bit 9 is set = right button is pressed
-
 
1698
  * bit 10 is set = middle button is pressed
-
 
1699
 
-
 
1700
  * bit 15 is set = vertical scroll is used
-
 
1701
 
-
 
1702
  * bit 16 is set = left button is released
1667
  * other bits are cleared
1703
  * bit 17 is set = right button is released
-
 
1704
  * bit 18 is set = middle button is released
-
 
1705
 
-
 
1706
  * bit 23 is set = horisontal scroll is used
-
 
1707
 
-
 
1708
  * bit 24 is set = doubleclick by left button
1668
 
1709
 
1669
-------------------- Subfunction 4 - load cursor ---------------------
1710
-------------------- Subfunction 4 - load cursor ---------------------
1670
Parameters:
1711
Parameters:
1671
  * eax = 37 - function number
1712
  * eax = 37 - function number
1672
  * ebx = 4 - subfunction number
1713
  * ebx = 4 - subfunction number
1673
  * dx = data source:
1714
  * dx = data source:
1674
  * dx = LOAD_FROM_FILE = 0 - data in a file
1715
  * dx = LOAD_FROM_FILE = 0 - data in a file
1675
    * ecx = pointer to full path to the cursor file
1716
    * ecx = pointer to full path to the cursor file
1676
    * the file must be in the format .cur, which is standard for
1717
    * the file must be in the format .cur, which is standard for
1677
      MS Windows, at that of the size 32*32 pixels
1718
      MS Windows, at that of the size 32*32 pixels
1678
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
1719
  * dx = LOAD_FROM_MEM = 1 - data of file are already loaded in memory
1679
    * ecx = pointer to data of the cursor file
1720
    * ecx = pointer to data of the cursor file
1680
    * the data format is the same as in the previous case
1721
    * the data format is the same as in the previous case
1681
  * dx = LOAD_INDIRECT = 2 - data in memory
1722
  * dx = LOAD_INDIRECT = 2 - data in memory
1682
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
1723
    * ecx = pointer to cursor image in the format ARGB 32*32 pixels
1683
    * edx = 0xXXYY0002, where
1724
    * edx = 0xXXYY0002, where
1684
      * XX = x-coordinate of cursor hotspot
1725
      * XX = x-coordinate of cursor hotspot
1685
      * YY = y-coordinate
1726
      * YY = y-coordinate
1686
      * 0 <= XX, YY <= 31
1727
      * 0 <= XX, YY <= 31
1687
Returned value:
1728
Returned value:
1688
  * eax = 0 - failed
1729
  * eax = 0 - failed
1689
  * otherwise eax = cursor handle
1730
  * otherwise eax = cursor handle
1690
 
1731
 
1691
--------------------- Subfunction 5 - set cursor ---------------------
1732
--------------------- Subfunction 5 - set cursor ---------------------
1692
Sets new cursor for the window of the current thread.
1733
Sets new cursor for the window of the current thread.
1693
Parameters:
1734
Parameters:
1694
  * eax = 37 - function number
1735
  * eax = 37 - function number
1695
  * ebx = 5 - subfunction number
1736
  * ebx = 5 - subfunction number
1696
  * ecx = cursor handle
1737
  * ecx = cursor handle
1697
Returned value:
1738
Returned value:
1698
  * eax = handle of previous cursor
1739
  * eax = handle of previous cursor
1699
Remarks:
1740
Remarks:
1700
  * If the handle is incorrect, the function restores the default
1741
  * If the handle is incorrect, the function restores the default
1701
    cursor (standard arrow). In particular, ecx=0 restores it.
1742
    cursor (standard arrow). In particular, ecx=0 restores it.
1702
 
1743
 
1703
------------------- Subfunction 6 - delete cursor --------------------
1744
------------------- Subfunction 6 - delete cursor --------------------
1704
Parameters:
1745
Parameters:
1705
  * eax = 37 - function number
1746
  * eax = 37 - function number
1706
  * ebx = 6 - subfunction number
1747
  * ebx = 6 - subfunction number
1707
  * ecx = cursor handle
1748
  * ecx = cursor handle
1708
Returned value:
1749
Returned value:
1709
  * eax destroyed
1750
  * eax destroyed
1710
Remarks:
1751
Remarks:
1711
  * The cursor must be loaded previously by the current thread
1752
  * The cursor must be loaded previously by the current thread
1712
    (with the call to subfunction 4). The function does not delete
1753
    (with the call to subfunction 4). The function does not delete
1713
    system cursors and cursors, loaded by another applications.
1754
    system cursors and cursors, loaded by another applications.
1714
  * If the active cursor (set by subfunction 5) is deleted,
1755
  * If the active cursor (set by subfunction 5) is deleted,
1715
    the system restores the default cursor (standard arrow).
1756
    the system restores the default cursor (standard arrow).
1716
 
1757
 
1717
------------------ Subfunction 7 - get scroll data -------------------
1758
------------------ Subfunction 7 - get scroll data -------------------
1718
Parameters:
1759
Parameters:
1719
  * eax = 37 - function number
1760
  * eax = 37 - function number
1720
  * ebx = 7 - subfunction number
1761
  * ebx = 7 - subfunction number
1721
Returned value:
1762
Returned value:
1722
  * eax = [horizontal offset]*65536 + [vertical offset]
1763
  * eax = [horizontal offset]*65536 + [vertical offset]
1723
Remarks:
1764
Remarks:
1724
  * Scroll data is available for active window only.
1765
  * Scroll data is available for active window only.
1725
  * Values are zeroed after reading.
1766
  * Values are zeroed after reading.
1726
  * Values are signed.
1767
  * Values are signed.
1727
 
1768
 
1728
======================================================================
1769
======================================================================
1729
====================== Function 38 - draw line. ======================
1770
====================== Function 38 - draw line. ======================
1730
======================================================================
1771
======================================================================
1731
Parameters:
1772
Parameters:
1732
  * eax = 38 - function number
1773
  * eax = 38 - function number
1733
  * ebx = [start coordinate on axis x]*65536 +
1774
  * ebx = [start coordinate on axis x]*65536 +
1734
              [end coordinate on axis x]
1775
              [end coordinate on axis x]
1735
  * ecx = [start coordinate on axis y]*65536 +
1776
  * ecx = [start coordinate on axis y]*65536 +
1736
              [end coordinate on axis y]
1777
              [end coordinate on axis y]
1737
  * edx = 0x00RRGGBB - color
1778
  * edx = 0x00RRGGBB - color
1738
    edx = 0x01xxxxxx - draw inversed line
1779
    edx = 0x01xxxxxx - draw inversed line
1739
          (low 24 bits are ignored)
1780
          (low 24 bits are ignored)
1740
Returned value:
1781
Returned value:
1741
  * function does not return value
1782
  * function does not return value
1742
Remarks:
1783
Remarks:
1743
  * Coordinates are relative to the window.
1784
  * Coordinates are relative to the window.
1744
  * End point is also drawn.
1785
  * End point is also drawn.
1745
 
1786
 
1746
======================================================================
1787
======================================================================
1747
== Function 39, subfunction 1 - get a size of the background image. ==
1788
== Function 39, subfunction 1 - get a size of the background image. ==
1748
======================================================================
1789
======================================================================
1749
Parameters:
1790
Parameters:
1750
  * eax = 39 - function number
1791
  * eax = 39 - function number
1751
  * ebx = 1 - subfunction number
1792
  * ebx = 1 - subfunction number
1752
Returned value:
1793
Returned value:
1753
  * eax = [width]*65536 + [height]
1794
  * eax = [width]*65536 + [height]
1754
Remarks:
1795
Remarks:
1755
  * There is a pair function to set sizes of background image -
1796
  * There is a pair function to set sizes of background image -
1756
    subfunction 1 of function 15. After which it is necessary,
1797
    subfunction 1 of function 15. After which it is necessary,
1757
    of course, anew to define image.
1798
    of course, anew to define image.
1758
 
1799
 
1759
======================================================================
1800
======================================================================
1760
== Function 39, subfunction 2 - get pixel from the background image. =
1801
== Function 39, subfunction 2 - get pixel from the background image. =
1761
======================================================================
1802
======================================================================
1762
Parameters:
1803
Parameters:
1763
  * eax = 39 - function number
1804
  * eax = 39 - function number
1764
  * ebx = 2 - subfunction number
1805
  * ebx = 2 - subfunction number
1765
  * ecx = offset
1806
  * ecx = offset
1766
Returned value:
1807
Returned value:
1767
  * eax = 0x00RRGGBB - pixel color, if offset is valid
1808
  * eax = 0x00RRGGBB - pixel color, if offset is valid
1768
    (less than 0x160000-16)
1809
    (less than 0x160000-16)
1769
  * eax = 2 otherwise
1810
  * eax = 2 otherwise
1770
Remarks:
1811
Remarks:
1771
  * Do not rely on returned value for invalid offsets, it may be
1812
  * Do not rely on returned value for invalid offsets, it may be
1772
    changed in future kernel versions.
1813
    changed in future kernel versions.
1773
  * Offset for pixel with coordinates (x,y)
1814
  * Offset for pixel with coordinates (x,y)
1774
    is calculated as (x+y*xsize)*3.
1815
    is calculated as (x+y*xsize)*3.
1775
  * There is a pair function to set pixel on the background image -
1816
  * There is a pair function to set pixel on the background image -
1776
    subfunction 2 of function 15.
1817
    subfunction 2 of function 15.
1777
 
1818
 
1778
======================================================================
1819
======================================================================
1779
== Function 39, subfunction 4 - get drawing mode for the background. =
1820
== Function 39, subfunction 4 - get drawing mode for the background. =
1780
======================================================================
1821
======================================================================
1781
Parameters:
1822
Parameters:
1782
  * eax = 39 - function number
1823
  * eax = 39 - function number
1783
  * ebx = 4 - subfunction number
1824
  * ebx = 4 - subfunction number
1784
Returned value:
1825
Returned value:
1785
  * eax = 1 - tile
1826
  * eax = 1 - tile
1786
  * eax = 2 - stretch
1827
  * eax = 2 - stretch
1787
Remarks:
1828
Remarks:
1788
  * There is a pair function to set drawing mode -
1829
  * There is a pair function to set drawing mode -
1789
    subfunction 4 of function 15.
1830
    subfunction 4 of function 15.
1790
 
1831
 
1791
======================================================================
1832
======================================================================
1792
=========== Function 40 - set the mask for expected events. ==========
1833
=========== Function 40 - set the mask for expected events. ==========
1793
======================================================================
1834
======================================================================
1794
The mask for expected events affects function working with events
1835
The mask for expected events affects function working with events
1795
10, 11, 23 - they notify only about events allowed by this mask.
1836
10, 11, 23 - they notify only about events allowed by this mask.
1796
Parameters:
1837
Parameters:
1797
  * eax = 40 - function number
1838
  * eax = 40 - function number
1798
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
1839
  * ebx = mask: bit i corresponds to event i+1 (see list of events)
1799
    (set bit permits notice on event)
1840
    (set bit permits notice on event)
1800
    bit 31: mouse active/inactive filter
1841
    bit 31: mouse active/inactive filter
1801
    bit 31 = 0 - inactive window receive mouse events
1842
    bit 31 = 0 - inactive window receive mouse events
1802
    bit 31 = 1 - inactive window does not receive mouse events
1843
    bit 31 = 1 - inactive window does not receive mouse events
1803
    bit 30: cursor position filter
1844
    bit 30: cursor position filter
1804
    bit 30 = 0 = the window receive mouse events if cursor
1845
    bit 30 = 0 = the window receive mouse events if cursor
1805
                 outside window
1846
                 outside window
1806
    bit 30 = 1 - the window does not receive mouse events if cursor
1847
    bit 30 = 1 - the window does not receive mouse events if cursor
1807
                 outside window
1848
                 outside window
1808
Returned value:
1849
Returned value:
1809
  * eax = previous value of mask
1850
  * eax = previous value of mask
1810
Remarks:
1851
Remarks:
1811
  * Default mask (7=111b) enables nofices about redraw,
1852
  * Default mask (7=111b) enables nofices about redraw,
1812
    keys and buttons. This is enough for many applications.
1853
    keys and buttons. This is enough for many applications.
1813
  * Events prohibited in the mask are saved anyway, when come;
1854
  * Events prohibited in the mask are saved anyway, when come;
1814
    they are simply not informed with event functions.
1855
    they are simply not informed with event functions.
1815
  * Event functions take into account the mask on moment of
1856
  * Event functions take into account the mask on moment of
1816
    function call, not on moment of event arrival.
1857
    function call, not on moment of event arrival.
1817
 
1858
 
1818
 
1859
 
1819
======================================================================
1860
======================================================================
1820
================ Function 43 - input/output to a port. ===============
1861
================ Function 43 - input/output to a port. ===============
1821
======================================================================
1862
======================================================================
1822
 
1863
 
1823
------------------------ Output data to port -------------------------
1864
------------------------ Output data to port -------------------------
1824
Parameters:
1865
Parameters:
1825
  * eax = 43 - function number
1866
  * eax = 43 - function number
1826
  * bl = byte for output
1867
  * bl = byte for output
1827
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
1868
  * ecx = port number 0xnnnn (from 0 to 0xFFFF)
1828
Returned value:
1869
Returned value:
1829
  * eax = 0 - success
1870
  * eax = 0 - success
1830
  * eax = 1 - the thread has not reserved the selected port
1871
  * eax = 1 - the thread has not reserved the selected port
1831
 
1872
 
1832
------------------------ Input data from port ------------------------
1873
------------------------ Input data from port ------------------------
1833
Parameters:
1874
Parameters:
1834
  * eax = 43 - function number
1875
  * eax = 43 - function number
1835
  * ebx is ignored
1876
  * ebx is ignored
1836
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
1877
  * ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
1837
Returned value:
1878
Returned value:
1838
  * eax = 0 - success, thus ebx = entered byte
1879
  * eax = 0 - success, thus ebx = entered byte
1839
  * eax = 1 - the thread has not reserved the selected port
1880
  * eax = 1 - the thread has not reserved the selected port
1840
Remarks:
1881
Remarks:
1841
  * Previously the thread must reserve the selected port
1882
  * Previously the thread must reserve the selected port
1842
    for itself by function 46.
1883
    for itself by function 46.
1843
  * Instead of call to this function it is better to use
1884
  * Instead of call to this function it is better to use
1844
    processor instructions in/out - this is much
1885
    processor instructions in/out - this is much
1845
    faster and a bit shorter and easier.
1886
    faster and a bit shorter and easier.
1846
 
1887
 
1847
 
1888
 
1848
======================================================================
1889
======================================================================
1849
====== Function 46 - reserve/free a group of input/output ports. =====
1890
====== Function 46 - reserve/free a group of input/output ports. =====
1850
======================================================================
1891
======================================================================
1851
To work with reserved ports an application can access directly by
1892
To work with reserved ports an application can access directly by
1852
commands in/out (recommended way) and can use function 43
1893
commands in/out (recommended way) and can use function 43
1853
(not recommended way).
1894
(not recommended way).
1854
Parameters:
1895
Parameters:
1855
  * eax = 46 - function number
1896
  * eax = 46 - function number
1856
  * ebx = 0 - reserve, 1 - free
1897
  * ebx = 0 - reserve, 1 - free
1857
  * ecx = start port number
1898
  * ecx = start port number
1858
  * edx = end port number (inclusive)
1899
  * edx = end port number (inclusive)
1859
Returned value:
1900
Returned value:
1860
  * eax = 0 - success
1901
  * eax = 0 - success
1861
  * eax = 1 - error
1902
  * eax = 1 - error
1862
Remarks:
1903
Remarks:
1863
  * For ports reservation: an error occurs if and only if
1904
  * For ports reservation: an error occurs if and only if
1864
    one from the following condition satisfies:
1905
    one from the following condition satisfies:
1865
    * start port is more than end port;
1906
    * start port is more than end port;
1866
    * the selected range contains incorrect port number
1907
    * the selected range contains incorrect port number
1867
      (correct are from 0 to 0xFFFF);
1908
      (correct are from 0 to 0xFFFF);
1868
    * limit for the total number of reserved areas is exceeded
1909
    * limit for the total number of reserved areas is exceeded
1869
      (maximum 255 are allowed);
1910
      (maximum 255 are allowed);
1870
    * the selected range intersects with any of earlier reserved
1911
    * the selected range intersects with any of earlier reserved
1871
  * For ports free: an error is an attempt to free range,
1912
  * For ports free: an error is an attempt to free range,
1872
    that was not earlier reserved by this function
1913
    that was not earlier reserved by this function
1873
    (with same ecx,edx).
1914
    (with same ecx,edx).
1874
  * If an error occurs (for both cases) function performs no action.
1915
  * If an error occurs (for both cases) function performs no action.
1875
  * At booting the system reserves for itself ports
1916
  * At booting the system reserves for itself ports
1876
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
1917
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
1877
  * When a thread terminates, all reserved by it ports
1918
  * When a thread terminates, all reserved by it ports
1878
    are freed automatically.
1919
    are freed automatically.
1879
 
1920
 
1880
======================================================================
1921
======================================================================
1881
============= Function 47 - draw a number in the window. =============
1922
============= Function 47 - draw a number in the window. =============
1882
======================================================================
1923
======================================================================
1883
Parameters:
1924
Parameters:
1884
  * eax = 47 - function number
1925
  * eax = 47 - function number
1885
  * ebx = parameters of conversion number to text:
1926
  * ebx = parameters of conversion number to text:
1886
    * bl = 0 - ecx contains number
1927
    * bl = 0 - ecx contains number
1887
    * bl = 1 - ecx contains pointer to dword/qword-number
1928
    * bl = 1 - ecx contains pointer to dword/qword-number
1888
    * bh = 0 - display in decimal number system
1929
    * bh = 0 - display in decimal number system
1889
    * bh = 1 - display in hexadecimal system
1930
    * bh = 1 - display in hexadecimal system
1890
    * bh = 2 - display in binary system
1931
    * bh = 2 - display in binary system
1891
    * bits 16-21 = how many digits to display
1932
    * bits 16-21 = how many digits to display
1892
    * bits 22-29 reserved and must be set to 0
1933
    * bits 22-29 reserved and must be set to 0
1893
    * bit 30 set = display qword (64-bit) number (must be bl=1)
1934
    * bit 30 set = display qword (64-bit) number (must be bl=1)
1894
    * bit 31 set = do not display leading zeroes of the number
1935
    * bit 31 set = do not display leading zeroes of the number
1895
  * ecx = number (if bl=0) or pointer (if bl=1)
1936
  * ecx = number (if bl=0) or pointer (if bl=1)
1896
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1937
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
1897
  * esi = 0xX0RRGGBB:
1938
  * esi = 0xX0RRGGBB:
1898
    * RR, GG, BB specify the color
1939
    * RR, GG, BB specify the color
1899
    * X = ABnn (bits)
1940
    * X = ABnn (bits)
1900
    * nn = font (0/1)
1941
    * nn = font (0/1)
1901
    * A is ignored
1942
    * A is ignored
1902
    * B=1 - fill background with the color edi
1943
    * B=1 - fill background with the color edi
1903
Returned value:
1944
Returned value:
1904
  * function does not return value
1945
  * function does not return value
1905
Remarks:
1946
Remarks:
1906
  * The given length must not exceed 60.
1947
  * The given length must not exceed 60.
1907
  * The exactly given amount of digits is output. If number is small
1948
  * The exactly given amount of digits is output. If number is small
1908
    and can be written by smaller amount of digits, it is supplemented
1949
    and can be written by smaller amount of digits, it is supplemented
1909
    by leading zeroes; if the number is big and can not be written by
1950
    by leading zeroes; if the number is big and can not be written by
1910
    given amount of digits, extra digits are not drawn.
1951
    given amount of digits, extra digits are not drawn.
1911
  * Parameters of fonts are shown in the description of function 4
1952
  * Parameters of fonts are shown in the description of function 4
1912
    (text output).
1953
    (text output).
1913
 
1954
 
1914
======================================================================
1955
======================================================================
1915
========= Function 48, subfunction 0 - apply screen settings. ========
1956
========= Function 48, subfunction 0 - apply screen settings. ========
1916
======================================================================
1957
======================================================================
1917
Parameters:
1958
Parameters:
1918
  * eax = 48 - function number
1959
  * eax = 48 - function number
1919
  * ebx = 0 - subfunction number
1960
  * ebx = 0 - subfunction number
1920
  * ecx = 0 - reserved
1961
  * ecx = 0 - reserved
1921
Returned value:
1962
Returned value:
1922
  * function does not return value
1963
  * function does not return value
1923
Remarks:
1964
Remarks:
1924
  * Function redraws the screen after parameters change by
1965
  * Function redraws the screen after parameters change by
1925
    subfunctions 1 and 2.
1966
    subfunctions 1 and 2.
1926
  * Function call without prior call to one of indicated subfunctions
1967
  * Function call without prior call to one of indicated subfunctions
1927
    is ignored.
1968
    is ignored.
1928
  * Function call with nonzero ecx is ignored.
1969
  * Function call with nonzero ecx is ignored.
1929
 
1970
 
1930
======================================================================
1971
======================================================================
1931
=========== Function 48, subfunction 1 - set button style. ===========
1972
=========== Function 48, subfunction 1 - set button style. ===========
1932
======================================================================
1973
======================================================================
1933
Parameters:
1974
Parameters:
1934
  * eax = 48 - function number
1975
  * eax = 48 - function number
1935
  * ebx = 1 - subfunction number
1976
  * ebx = 1 - subfunction number
1936
  * ecx = button style:
1977
  * ecx = button style:
1937
    * 0 = flat
1978
    * 0 = flat
1938
    * 1 = 3d
1979
    * 1 = 3d
1939
Returned value:
1980
Returned value:
1940
  * function does not return value
1981
  * function does not return value
1941
Remarks:
1982
Remarks:
1942
  * After call to this function one should redraw the screen by
1983
  * After call to this function one should redraw the screen by
1943
    subfunction 0.
1984
    subfunction 0.
1944
  * Button style influences only to their draw of function 8.
1985
  * Button style influences only to their draw of function 8.
1945
 
1986
 
1946
======================================================================
1987
======================================================================
1947
====== Function 48, subfunction 2 - set standard window colors. ======
1988
====== Function 48, subfunction 2 - set standard window colors. ======
1948
======================================================================
1989
======================================================================
1949
Parameters:
1990
Parameters:
1950
  * eax = 48 - function number
1991
  * eax = 48 - function number
1951
  * ebx = 2 - subfunction number
1992
  * ebx = 2 - subfunction number
1952
  * ecx = pointer to the color table
1993
  * ecx = pointer to the color table
1953
  * edx = size of the color table
1994
  * edx = size of the color table
1954
    (must be 40 bytes for future compatibility)
1995
    (must be 40 bytes for future compatibility)
1955
Format of the color table is shown in description of subfunction 3.
1996
Format of the color table is shown in description of subfunction 3.
1956
Returned value:
1997
Returned value:
1957
  * function does not return value
1998
  * function does not return value
1958
Remarks:
1999
Remarks:
1959
  * After call to this function one should redraw the screen by
2000
  * After call to this function one should redraw the screen by
1960
    subfunction 0.
2001
    subfunction 0.
1961
  * Table of standard colors influences only to applications,
2002
  * Table of standard colors influences only to applications,
1962
    which receive this table obviously (by subfunction 3)
2003
    which receive this table obviously (by subfunction 3)
1963
    and use it (specifying colors from it to drawing functions).
2004
    and use it (specifying colors from it to drawing functions).
1964
  * Table of standard colors is included in skin and is installed
2005
  * Table of standard colors is included in skin and is installed
1965
    anew with skin installation (by subfunction 8).
2006
    anew with skin installation (by subfunction 8).
1966
  * Color table can be viewed/changed interactively with
2007
  * Color table can be viewed/changed interactively with
1967
    the application 'desktop'.
2008
    the application 'desktop'.
1968
 
2009
 
1969
======================================================================
2010
======================================================================
1970
====== Function 48, subfunction 3 - get standard window colors. ======
2011
====== Function 48, subfunction 3 - get standard window colors. ======
1971
======================================================================
2012
======================================================================
1972
Parameters:
2013
Parameters:
1973
  * eax = 48 - function number
2014
  * eax = 48 - function number
1974
  * ebx = 3 - subfunction number
2015
  * ebx = 3 - subfunction number
1975
  * ecx = pointer to the buffer with size edx bytes,
2016
  * ecx = pointer to the buffer with size edx bytes,
1976
    where table will be written
2017
    where table will be written
1977
  * edx = size of color table
2018
  * edx = size of color table
1978
    (must be 40 bytes for future compatibility)
2019
    (must be 40 bytes for future compatibility)
1979
Returned value:
2020
Returned value:
1980
  * function does not return value
2021
  * function does not return value
1981
Format of the color table:
2022
Format of the color table:
1982
each item is dword-value for color 0x00RRGGBB
2023
each item is dword-value for color 0x00RRGGBB
1983
  * +0: dword: frames - color of frame
2024
  * +0: dword: frames - color of frame
1984
  * +4: dword: grab - color of header
2025
  * +4: dword: grab - color of header
1985
  * +8: dword: grab_button - color of button on header bar
2026
  * +8: dword: grab_button - color of button on header bar
1986
  * +12 = +0xC: dword: grab_button_text - color of text on button
2027
  * +12 = +0xC: dword: grab_button_text - color of text on button
1987
    on header bar
2028
    on header bar
1988
  * +16 = +0x10: dword: grab_text - color of text on header
2029
  * +16 = +0x10: dword: grab_text - color of text on header
1989
  * +20 = +0x14: dword: work - color of working area
2030
  * +20 = +0x14: dword: work - color of working area
1990
  * +24 = +0x18: dword: work_button - color of button in working area
2031
  * +24 = +0x18: dword: work_button - color of button in working area
1991
  * +28 = +0x1C: dword: work_button_text - color of text on button
2032
  * +28 = +0x1C: dword: work_button_text - color of text on button
1992
    in working area
2033
    in working area
1993
  * +32 = +0x20: dword: work_text - color of text in working area
2034
  * +32 = +0x20: dword: work_text - color of text in working area
1994
  * +36 = +0x24: dword: work_graph - color of graphics in working area
2035
  * +36 = +0x24: dword: work_graph - color of graphics in working area
1995
Remarks:
2036
Remarks:
1996
  * Structure of the color table is described in the standard
2037
  * Structure of the color table is described in the standard
1997
    include file 'macros.inc' as 'system_colors'; for example,
2038
    include file 'macros.inc' as 'system_colors'; for example,
1998
    it is possible to write:
2039
    it is possible to write:
1999
    	sc	system_colors		; variable declaration
2040
    	sc	system_colors		; variable declaration
2000
    	...				; somewhere one must call
2041
    	...				; somewhere one must call
2001
    					; this function with ecx=sc
2042
    					; this function with ecx=sc
2002
    	mov	ecx, [sc.work_button_text]	; read text color on
2043
    	mov	ecx, [sc.work_button_text]	; read text color on
2003
    					; buttin in working area
2044
    					; buttin in working area
2004
  * A program itself desides to use or not to use color table.
2045
  * A program itself desides to use or not to use color table.
2005
    For usage program must simply at calls to drawing functions select
2046
    For usage program must simply at calls to drawing functions select
2006
    color taken from the table.
2047
    color taken from the table.
2007
  * At change of the table of standard colors (by subfunction 2 with
2048
  * At change of the table of standard colors (by subfunction 2 with
2008
    the subsequent application of changes by subfunction 0 or
2049
    the subsequent application of changes by subfunction 0 or
2009
    at skin set by subfunction 8) the system sends to all windows
2050
    at skin set by subfunction 8) the system sends to all windows
2010
    redraw message (the event with code 1).
2051
    redraw message (the event with code 1).
2011
  * Color table can be viewed/changed interactively with
2052
  * Color table can be viewed/changed interactively with
2012
    the application 'desktop'.
2053
    the application 'desktop'.
2013
 
2054
 
2014
======================================================================
2055
======================================================================
2015
============ Function 48, subfunction 4 - get skin height. ===========
2056
============ Function 48, subfunction 4 - get skin height. ===========
2016
======================================================================
2057
======================================================================
2017
Parameters:
2058
Parameters:
2018
  * eax = 48 - function number
2059
  * eax = 48 - function number
2019
  * ebx = 4 - subfunction number
2060
  * ebx = 4 - subfunction number
2020
Returned value:
2061
Returned value:
2021
  * eax = skin height
2062
  * eax = skin height
2022
Remarks:
2063
Remarks:
2023
  * Skin height is defined as the height of a header
2064
  * Skin height is defined as the height of a header
2024
    of skinned windows.
2065
    of skinned windows.
2025
  * See also general structure of window in the description
2066
  * See also general structure of window in the description
2026
    of function 0.
2067
    of function 0.
2027
 
2068
 
2028
======================================================================
2069
======================================================================
2029
======== Function 48, subfunction 5 - get screen working area. =======
2070
======== Function 48, subfunction 5 - get screen working area. =======
2030
======================================================================
2071
======================================================================
2031
Parameters:
2072
Parameters:
2032
  * eax = 48 - function number
2073
  * eax = 48 - function number
2033
  * ebx = 5 - subfunction number
2074
  * ebx = 5 - subfunction number
2034
Returned value:
2075
Returned value:
2035
  * eax = [left]*65536 + [right]
2076
  * eax = [left]*65536 + [right]
2036
  * ebx = [top]*65536 + [bottom]
2077
  * ebx = [top]*65536 + [bottom]
2037
Remarks:
2078
Remarks:
2038
  * The screen working area defines position and coordinates of
2079
  * The screen working area defines position and coordinates of
2039
    a maximized window.
2080
    a maximized window.
2040
  * The screen working area in view of normal work is all screen
2081
  * The screen working area in view of normal work is all screen
2041
    without taskbar ('@taskbar' application).
2082
    without taskbar ('@taskbar' application).
2042
  * (left,top) are coordinates of the left upper corner,
2083
  * (left,top) are coordinates of the left upper corner,
2043
    (right,bottom) are coordinates of the right lower one.
2084
    (right,bottom) are coordinates of the right lower one.
2044
    Thus the size of working area on x axis can be calculated by
2085
    Thus the size of working area on x axis can be calculated by
2045
    formula right-left+1, on y axis - by formula bottom-right+1.
2086
    formula right-left+1, on y axis - by formula bottom-right+1.
2046
  * See also function 14,
2087
  * See also function 14,
2047
    to get sizes of all screen.
2088
    to get sizes of all screen.
2048
  * There is a pair function to set working area - subfunction 6.
2089
  * There is a pair function to set working area - subfunction 6.
2049
 
2090
 
2050
======================================================================
2091
======================================================================
2051
======== Function 48, subfunction 6 - set screen working area. =======
2092
======== Function 48, subfunction 6 - set screen working area. =======
2052
======================================================================
2093
======================================================================
2053
Parameters:
2094
Parameters:
2054
  * eax = 48 - function number
2095
  * eax = 48 - function number
2055
  * ebx = 6 - subfunction number
2096
  * ebx = 6 - subfunction number
2056
  * ecx = [left]*65536 + [right]
2097
  * ecx = [left]*65536 + [right]
2057
  * edx = [top]*65536 + [bottom]
2098
  * edx = [top]*65536 + [bottom]
2058
Returned value:
2099
Returned value:
2059
  * function does not return value
2100
  * function does not return value
2060
Remarks:
2101
Remarks:
2061
  * The screen working area defines position and coordinates of
2102
  * The screen working area defines position and coordinates of
2062
    a maximized window.
2103
    a maximized window.
2063
  * This function is used only by the application '@taskbar',
2104
  * This function is used only by the application '@taskbar',
2064
    which set working area to all screen without taskbar.
2105
    which set working area to all screen without taskbar.
2065
  * (left,top) are coordinates of the left upper corner,
2106
  * (left,top) are coordinates of the left upper corner,
2066
    (right,bottom) are coordinates of the right lower one.
2107
    (right,bottom) are coordinates of the right lower one.
2067
    Thus the size of working area on x axis can be calculated by
2108
    Thus the size of working area on x axis can be calculated by
2068
    formula right-left+1, on y axis - by formula bottom-right+1.
2109
    formula right-left+1, on y axis - by formula bottom-right+1.
2069
  * If 'left'>='right', x-coordinate of working area is not changed.
2110
  * If 'left'>='right', x-coordinate of working area is not changed.
2070
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
2111
    If 'left'<0, 'left' will not be set. If 'right' is greater than or
2071
    equal to screen width, 'right' will not be set.
2112
    equal to screen width, 'right' will not be set.
2072
    Similarly on y axis.
2113
    Similarly on y axis.
2073
  * See also function 14,
2114
  * See also function 14,
2074
    to get sizes of all screen.
2115
    to get sizes of all screen.
2075
  * There is a pair function to get working area - subfunction 5.
2116
  * There is a pair function to get working area - subfunction 5.
2076
  * This function redraws the screen automatically,
2117
  * This function redraws the screen automatically,
2077
    updating coordinates and sizes of maximized windows.
2118
    updating coordinates and sizes of maximized windows.
2078
    The system sends to all windows redraw message (the event 1).
2119
    The system sends to all windows redraw message (the event 1).
2079
 
2120
 
2080
======================================================================
2121
======================================================================
2081
=========== Function 48, subfunction 7 - get skin margins. ===========
2122
=========== Function 48, subfunction 7 - get skin margins. ===========
2082
======================================================================
2123
======================================================================
2083
Returns the area of a header of a skinned window, intended for
2124
Returns the area of a header of a skinned window, intended for
2084
a text of a header.
2125
a text of a header.
2085
Parameters:
2126
Parameters:
2086
  * eax = 48 - function number
2127
  * eax = 48 - function number
2087
  * ebx = 7 - subfunction number
2128
  * ebx = 7 - subfunction number
2088
Returned value:
2129
Returned value:
2089
  * eax = [left]*65536 + [right]
2130
  * eax = [left]*65536 + [right]
2090
  * ebx = [top]*65536 + [bottom]
2131
  * ebx = [top]*65536 + [bottom]
2091
Remarks:
2132
Remarks:
2092
  * An application decides itself to use or not to use this function.
2133
  * An application decides itself to use or not to use this function.
2093
  * It is recommended to take into account returned value
2134
  * It is recommended to take into account returned value
2094
    of this function for choice of a place for drawing header text
2135
    of this function for choice of a place for drawing header text
2095
    (by function 4) or a substitute of header text
2136
    (by function 4) or a substitute of header text
2096
    (at the discretion of an application).
2137
    (at the discretion of an application).
2097
 
2138
 
2098
======================================================================
2139
======================================================================
2099
============= Function 48, subfunction 8 - set used skin. ============
2140
============= Function 48, subfunction 8 - set used skin. ============
2100
======================================================================
2141
======================================================================
2101
Parameters:
2142
Parameters:
2102
  * eax = 48 - function number
2143
  * eax = 48 - function number
2103
  * ebx = 8 - subfunction number
2144
  * ebx = 8 - subfunction number
2104
  * ecx = pointer to filename of the skin
2145
  * ecx = pointer to filename of the skin
2105
Returned value:
2146
Returned value:
2106
  * eax = 0 - success
2147
  * eax = 0 - success
2107
  * otherwise eax = file system error code; if file does not
2148
  * otherwise eax = file system error code; if file does not
2108
    contain valid skin, function returns error 3
2149
    contain valid skin, function returns error 3
2109
    (unknown file system).
2150
    (unknown file system).
2110
Remarks:
2151
Remarks:
2111
  * After successful skin loading the system sends to all windows
2152
  * After successful skin loading the system sends to all windows
2112
    redraw message (the event 1).
2153
    redraw message (the event 1).
2113
  * At booting the system reads skin from file 'default.skn'
2154
  * At booting the system reads skin from file 'default.skn'
2114
    on ramdisk.
2155
    on ramdisk.
2115
  * User can change the skin statically by creating hisself
2156
  * User can change the skin statically by creating hisself
2116
    'default.skn' or dynamically with the application 'desktop'.
2157
    'default.skn' or dynamically with the application 'desktop'.
2117
 
2158
 
2118
======================================================================
2159
======================================================================
2119
====== Function 48, subfunction 9 - get font smoothing setting. ======
2160
====== Function 48, subfunction 9 - get font smoothing setting. ======
2120
======================================================================
2161
======================================================================
2121
Parameters:
2162
Parameters:
2122
  * eax = 48 - function number
2163
  * eax = 48 - function number
2123
  * ebx = 9 - subfunction number
2164
  * ebx = 9 - subfunction number
2124
Returned value:
2165
Returned value:
2125
  * eax = 2 - subpixel, 1 - anti-aliasing, 0 - off
2166
  * eax = 2 - subpixel, 1 - anti-aliasing, 0 - off
2126
 
2167
 
2127
======================================================================
2168
======================================================================
2128
========== Function 48, subfunction 10 - set font smoothing. =========
2169
========== Function 48, subfunction 10 - set font smoothing. =========
2129
======================================================================
2170
======================================================================
2130
Parameters:
2171
Parameters:
2131
  * eax = 48 - function number
2172
  * eax = 48 - function number
2132
  * ebx = 10 - subfunction number
2173
  * ebx = 10 - subfunction number
2133
  * cl  = 2 - subpixel, 1 - anti-aliasing, 0 - off
2174
  * cl  = 2 - subpixel, 1 - anti-aliasing, 0 - off
2134
 
2175
 
2135
======================================================================
2176
======================================================================
2136
=========== Function 49 - Advanced Power Management (APM). ===========
2177
=========== Function 49 - Advanced Power Management (APM). ===========
2137
======================================================================
2178
======================================================================
2138
Parameters:
2179
Parameters:
2139
  * eax = 49 - function number
2180
  * eax = 49 - function number
2140
  * dx = number of the APM function
2181
  * dx = number of the APM function
2141
    (analogue of ax in APM specification)
2182
    (analogue of ax in APM specification)
2142
  * bx, cx = parameters of the APM function
2183
  * bx, cx = parameters of the APM function
2143
Returned value:
2184
Returned value:
2144
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
2185
  * 16-bit registers ax, bx, cx, dx, si, di and carry flag CF
2145
    are set according to the APM specification
2186
    are set according to the APM specification
2146
  * high halves of 32-bit registers eax, ebx, ecx,
2187
  * high halves of 32-bit registers eax, ebx, ecx,
2147
    edx, esi, edi are destroyed
2188
    edx, esi, edi are destroyed
2148
Remarks:
2189
Remarks:
2149
  * APM 1.2 specification is described in the document
2190
  * APM 1.2 specification is described in the document
2150
    "Advanced Power Management (APM) BIOS Specification"
2191
    "Advanced Power Management (APM) BIOS Specification"
2151
    (Revision 1.2), available at
2192
    (Revision 1.2), available at
2152
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2193
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2153
    besides it is included in famous Interrupt List by Ralf Brown
2194
    besides it is included in famous Interrupt List by Ralf Brown
2154
    (http://www.pobox.com/~ralf/files.html,
2195
    (http://www.pobox.com/~ralf/files.html,
2155
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2196
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2156
 
2197
 
2157
======================================================================
2198
======================================================================
2158
=================== Function 50 - set window shape. ==================
2199
=================== Function 50 - set window shape. ==================
2159
======================================================================
2200
======================================================================
2160
Normal windows have rectangular shape. This function can give to
2201
Normal windows have rectangular shape. This function can give to
2161
a window any shape. The shape is given by a set of points inside
2202
a window any shape. The shape is given by a set of points inside
2162
the base rectangle belonging to a window. Position and coordinates
2203
the base rectangle belonging to a window. Position and coordinates
2163
of the base rectangle are set by function 0
2204
of the base rectangle are set by function 0
2164
and changed by function 67.
2205
and changed by function 67.
2165
 
2206
 
2166
--------------------------- Set shape data ---------------------------
2207
--------------------------- Set shape data ---------------------------
2167
Parameters:
2208
Parameters:
2168
  * eax = 50 - function number
2209
  * eax = 50 - function number
2169
  * ebx = 0 - subfunction number
2210
  * ebx = 0 - subfunction number
2170
  * ecx = pointer to shape data (array of bytes 0/1)
2211
  * ecx = pointer to shape data (array of bytes 0/1)
2171
Returned value:
2212
Returned value:
2172
  * function does not return value
2213
  * function does not return value
2173
 
2214
 
2174
-------------------------- Set shape scale ---------------------------
2215
-------------------------- Set shape scale ---------------------------
2175
Parameters:
2216
Parameters:
2176
  * eax = 50 - function number
2217
  * eax = 50 - function number
2177
  * ebx = 1 - subfunction number
2218
  * ebx = 1 - subfunction number
2178
  * ecx sets a scale: each byte of data defines
2219
  * ecx sets a scale: each byte of data defines
2179
    (2^scale)*(2^scale) pixels
2220
    (2^scale)*(2^scale) pixels
2180
Returned value:
2221
Returned value:
2181
  * function does not return value
2222
  * function does not return value
2182
Remarks:
2223
Remarks:
2183
  * Default scale is 0 (scale factor is 1). If in the shape data
2224
  * Default scale is 0 (scale factor is 1). If in the shape data
2184
    one byte corresponds to one pixel, there is no necessity
2225
    one byte corresponds to one pixel, there is no necessity
2185
    to set scale.
2226
    to set scale.
2186
  * Let's designate xsize = window width (in pixels), ysize = height;
2227
  * Let's designate xsize = window width (in pixels), ysize = height;
2187
    pay attention, that they are one pixel more than defined by
2228
    pay attention, that they are one pixel more than defined by
2188
    functions 0, 67.
2229
    functions 0, 67.
2189
  * On definition of scale xsize and ysize must be divisible
2230
  * On definition of scale xsize and ysize must be divisible
2190
    on 2^scale.
2231
    on 2^scale.
2191
  * Byte of data on offset 'a' must be 0/1 and defines belonging
2232
  * Byte of data on offset 'a' must be 0/1 and defines belonging
2192
    to a window of square with the side 2^scale (if scale=0,
2233
    to a window of square with the side 2^scale (if scale=0,
2193
    this is one pixel) and coordinates of the left upper corner
2234
    this is one pixel) and coordinates of the left upper corner
2194
    (a mod (xsize shr scale), a div (xsize shr scale))
2235
    (a mod (xsize shr scale), a div (xsize shr scale))
2195
  * Data size: (xsize shr scale)*(ysize shr scale).
2236
  * Data size: (xsize shr scale)*(ysize shr scale).
2196
  * Data must be presented in the memory and not change
2237
  * Data must be presented in the memory and not change
2197
    after set of shape.
2238
    after set of shape.
2198
  * The system views the shape data at every window redraw by
2239
  * The system views the shape data at every window redraw by
2199
    function 0.
2240
    function 0.
2200
  * The call of subfunction 0 with NULL pointer results in return
2241
  * The call of subfunction 0 with NULL pointer results in return
2201
    to the rectangular shape.
2242
    to the rectangular shape.
2202
 
2243
 
2203
======================================================================
2244
======================================================================
2204
==================== Function 51 - create thread. ====================
2245
==================== Function 51 - create thread. ====================
2205
======================================================================
2246
======================================================================
2206
Parameters:
2247
Parameters:
2207
  * eax = 51 - function number
2248
  * eax = 51 - function number
2208
  * ebx = 1 - unique subfunction
2249
  * ebx = 1 - unique subfunction
2209
  * ecx = address of thread entry point (starting eip)
2250
  * ecx = address of thread entry point (starting eip)
2210
  * edx = pointer to thread stack (starting esp)
2251
  * edx = pointer to thread stack (starting esp)
2211
Returned value:
2252
Returned value:
2212
  * eax = -1 - error (there is too many threads)
2253
  * eax = -1 - error (there is too many threads)
2213
  * otherwise eax = TID - thread identifier
2254
  * otherwise eax = TID - thread identifier
2214
    
2255
    
2215
 
2256
 
2216
======================================================================
2257
======================================================================
2217
==================== Function 54, subfunction 0 ======================
2258
==================== Function 54, subfunction 0 ======================
2218
============== Get the number of slots in the clipboard. =============
2259
============== Get the number of slots in the clipboard. =============
2219
======================================================================
2260
======================================================================
2220
Parameters:
2261
Parameters:
2221
  * eax = 54 - function number
2262
  * eax = 54 - function number
2222
  * ebx = 0 - subfunction number
2263
  * ebx = 0 - subfunction number
2223
Returned value:
2264
Returned value:
2224
  * eax = slots in the clipboard
2265
  * eax = slots in the clipboard
2225
  * eax = -1 - main list area not found
2266
  * eax = -1 - main list area not found
2226
 
2267
 
2227
======================================================================
2268
======================================================================
2228
==================== Function 54, subfunction 1 ======================
2269
==================== Function 54, subfunction 1 ======================
2229
================= Read the data from the clipboard. ==================
2270
================= Read the data from the clipboard. ==================
2230
======================================================================
2271
======================================================================
2231
Parameters:
2272
Parameters:
2232
  * eax = 54 - function number
2273
  * eax = 54 - function number
2233
  * ebx = 1 - subfunction number
2274
  * ebx = 1 - subfunction number
2234
  * eсx = slot number
2275
  * eсx = slot number
2235
Returned value:
2276
Returned value:
2236
  * eax = if successful - pointer to a memory with data
2277
  * eax = if successful - pointer to a memory with data
2237
  * eax = 1 - error
2278
  * eax = 1 - error
2238
  * eax = -1 - main list area not found
2279
  * eax = -1 - main list area not found
2239
 
2280
 
2240
======================================================================
2281
======================================================================
2241
==================== Function 54, subfunction 2 ======================
2282
==================== Function 54, subfunction 2 ======================
2242
================= Write the data to the clipboard. ===================
2283
================= Write the data to the clipboard. ===================
2243
======================================================================
2284
======================================================================
2244
Parameters:
2285
Parameters:
2245
  * eax = 54 - function number
2286
  * eax = 54 - function number
2246
  * ebx = 2 - subfunction number
2287
  * ebx = 2 - subfunction number
2247
  * eсx = the number of bytes to be copied
2288
  * eсx = the number of bytes to be copied
2248
  * edx = a pointer to a buffer for data to be copied
2289
  * edx = a pointer to a buffer for data to be copied
2249
Returned value:
2290
Returned value:
2250
  * eax = 0 - success
2291
  * eax = 0 - success
2251
  * eax = 1 - error
2292
  * eax = 1 - error
2252
  * eax = -1 - main list area not found
2293
  * eax = -1 - main list area not found
2253
 
2294
 
2254
======================================================================
2295
======================================================================
2255
===================== Function 54, subfunction 3 =====================
2296
===================== Function 54, subfunction 3 =====================
2256
================ Delete the last slot in the clipboard ===============
2297
================ Delete the last slot in the clipboard ===============
2257
======================================================================
2298
======================================================================
2258
Parameters:
2299
Parameters:
2259
  * eax = 54 - function number
2300
  * eax = 54 - function number
2260
  * ebx = 3 - subfunction number
2301
  * ebx = 3 - subfunction number
2261
Returned value:
2302
Returned value:
2262
  * eax = 0 - success
2303
  * eax = 0 - success
2263
  * eax = 1 - error
2304
  * eax = 1 - error
2264
  * eax = -1 - main list area not found
2305
  * eax = -1 - main list area not found
2265
  
2306
  
2266
======================================================================
2307
======================================================================
2267
===================== Function 54, subfunction 4 =====================
2308
===================== Function 54, subfunction 4 =====================
2268
===================== Alarm reset the lock buffer ====================
2309
===================== Alarm reset the lock buffer ====================
2269
======================================================================
2310
======================================================================
2270
Parameters:
2311
Parameters:
2271
  * eax = 54 - function number
2312
  * eax = 54 - function number
2272
  * ebx = 4 - subfunction number
2313
  * ebx = 4 - subfunction number
2273
Returned value:
2314
Returned value:
2274
  * eax = 0 - success
2315
  * eax = 0 - success
2275
  * eax = -1 - main list area not found or no blocking
2316
  * eax = -1 - main list area not found or no blocking
2276
Remarks:
2317
Remarks:
2277
  * Used in exceptional cases, where no responsible or killed
2318
  * Used in exceptional cases, where no responsible or killed
2278
    application blocked the clipboard operations.
2319
    application blocked the clipboard operations.
2279
 
2320
 
2280
======================================================================
2321
======================================================================
2281
 Function 55, subfunction 55 - begin to play data on built-in speaker.
2322
 Function 55, subfunction 55 - begin to play data on built-in speaker.
2282
======================================================================
2323
======================================================================
2283
Parameters:
2324
Parameters:
2284
  * eax = 55 - function number
2325
  * eax = 55 - function number
2285
  * ebx = 55 - subfunction number
2326
  * ebx = 55 - subfunction number
2286
  * esi = pointer to data
2327
  * esi = pointer to data
2287
Returned value:
2328
Returned value:
2288
  * eax = 0 - success
2329
  * eax = 0 - success
2289
  * eax = 55 - error (speaker is off or busy)
2330
  * eax = 55 - error (speaker is off or busy)
2290
Data is an array of items with variable length.
2331
Data is an array of items with variable length.
2291
Format of each item is defined by first byte:
2332
Format of each item is defined by first byte:
2292
  * 0 = end of data
2333
  * 0 = end of data
2293
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
2334
  * 1..0x80 = sets sound duration on 1/100 of second; sound note
2294
    is defined by immediate value of frequency
2335
    is defined by immediate value of frequency
2295
    * following word (2 bytes) contains frequency divider;
2336
    * following word (2 bytes) contains frequency divider;
2296
      frequency is defined as 1193180/divider
2337
      frequency is defined as 1193180/divider
2297
  * 0x81 = invalid
2338
  * 0x81 = invalid
2298
  * 0x82..0xFF = note is defined by octave and number:
2339
  * 0x82..0xFF = note is defined by octave and number:
2299
    * duration in 1/100 of second = (first byte)-0x81
2340
    * duration in 1/100 of second = (first byte)-0x81
2300
    * there is one more byte;
2341
    * there is one more byte;
2301
    * (second byte)=0xFF - delay
2342
    * (second byte)=0xFF - delay
2302
    * otherwise it looks like a*0x10+b, where b=number of the note in
2343
    * otherwise it looks like a*0x10+b, where b=number of the note in
2303
      an octave from 1 to 12, a=number of octave (beginning from 0)
2344
      an octave from 1 to 12, a=number of octave (beginning from 0)
2304
Remarks:
2345
Remarks:
2305
  * Speaker play can be disabled/enabled by
2346
  * Speaker play can be disabled/enabled by
2306
    subfunction 8 of function 18.
2347
    subfunction 8 of function 18.
2307
  * Function returns control, having informed the system
2348
  * Function returns control, having informed the system
2308
    an information on request. Play itself goes independently from
2349
    an information on request. Play itself goes independently from
2309
    the program.
2350
    the program.
2310
  * The data must be kept in the memory at least up to the end
2351
  * The data must be kept in the memory at least up to the end
2311
    of play.
2352
    of play.
2312
 
2353
 
2313
======================================================================
2354
======================================================================
2314
======================= Function 57 - PCI BIOS. ======================
2355
======================= Function 57 - PCI BIOS. ======================
2315
======================================================================
2356
======================================================================
2316
Parameters:
2357
Parameters:
2317
  * eax = 57 - function number
2358
  * eax = 57 - function number
2318
  * ebp corresponds to al in PCI BIOS specification
2359
  * ebp corresponds to al in PCI BIOS specification
2319
  * other registers are set according to PCI BIOS specification
2360
  * other registers are set according to PCI BIOS specification
2320
Returned value:
2361
Returned value:
2321
  * CF is undefined
2362
  * CF is undefined
2322
  * other registers are set according to PCI BIOS specification
2363
  * other registers are set according to PCI BIOS specification
2323
Remarks:
2364
Remarks:
2324
  * Many effects of this function can be also achieved with
2365
  * Many effects of this function can be also achieved with
2325
    corresponding subfunctions of function 62.
2366
    corresponding subfunctions of function 62.
2326
  * The function calls PCI32 BIOS extension, documented e.g. in
2367
  * The function calls PCI32 BIOS extension, documented e.g. in
2327
    http://alpha1.dyns.net/files/PCI/bios21.pdf.
2368
    http://alpha1.dyns.net/files/PCI/bios21.pdf.
2328
  * If BIOS does not support this extension, its behavior is emulated
2369
  * If BIOS does not support this extension, its behavior is emulated
2329
    (through kernel-mode analogues of subfunctions of function 62).
2370
    (through kernel-mode analogues of subfunctions of function 62).
2330
 
2371
 
2331
======================================================================
2372
======================================================================
2332
========== Function 60 - Inter Process Communication (IPC). ==========
2373
========== Function 60 - Inter Process Communication (IPC). ==========
2333
======================================================================
2374
======================================================================
2334
IPC is used for message dispatching from one process/thread to
2375
IPC is used for message dispatching from one process/thread to
2335
another. Previously it is necessary to agree how to interpret
2376
another. Previously it is necessary to agree how to interpret
2336
the concrete message.
2377
the concrete message.
2337
 
2378
 
2338
----------- Subfunction 1 - set the area for IPC receiving -----------
2379
----------- Subfunction 1 - set the area for IPC receiving -----------
2339
Is called by process-receiver.
2380
Is called by process-receiver.
2340
Parameters:
2381
Parameters:
2341
  * eax = 60 - function number
2382
  * eax = 60 - function number
2342
  * ebx = 1 - subfunction number
2383
  * ebx = 1 - subfunction number
2343
  * ecx = pointer to the buffer
2384
  * ecx = pointer to the buffer
2344
  * edx = size of the buffer
2385
  * edx = size of the buffer
2345
Returned value:
2386
Returned value:
2346
  * eax = 0 - always success
2387
  * eax = 0 - always success
2347
Format of IPC-buffer:
2388
Format of IPC-buffer:
2348
  * +0: dword: if nonzero, buffer is considered locked;
2389
  * +0: dword: if nonzero, buffer is considered locked;
2349
    lock/unlock the buffer, when you work with it and need that
2390
    lock/unlock the buffer, when you work with it and need that
2350
    buffer data are not changed from outside (no new messages)
2391
    buffer data are not changed from outside (no new messages)
2351
  * +4: dword: occupied place in the buffer (in bytes)
2392
  * +4: dword: occupied place in the buffer (in bytes)
2352
  * +8: first message
2393
  * +8: first message
2353
  * +8+n: second message
2394
  * +8+n: second message
2354
  * ...
2395
  * ...
2355
Format of a message:
2396
Format of a message:
2356
  * +0: dword: PID of sender
2397
  * +0: dword: PID of sender
2357
  * +4: dword: message length (not including this header)
2398
  * +4: dword: message length (not including this header)
2358
  * +8: n*byte: message data
2399
  * +8: n*byte: message data
2359
 
2400
 
2360
------------------ Subfunction 2 - send IPC message ------------------
2401
------------------ Subfunction 2 - send IPC message ------------------
2361
Is called by process-sender.
2402
Is called by process-sender.
2362
Parameters:
2403
Parameters:
2363
  * eax = 60 - function number
2404
  * eax = 60 - function number
2364
  * ebx = 2 - subfunction number
2405
  * ebx = 2 - subfunction number
2365
  * ecx = PID of receiver
2406
  * ecx = PID of receiver
2366
  * edx = pointer to the message data
2407
  * edx = pointer to the message data
2367
  * esi = message length (in bytes)
2408
  * esi = message length (in bytes)
2368
Returned value:
2409
Returned value:
2369
  * eax = 0 - success
2410
  * eax = 0 - success
2370
  * eax = 1 - the receiver has not defined buffer for IPC messages
2411
  * eax = 1 - the receiver has not defined buffer for IPC messages
2371
    (can be, still have no time,
2412
    (can be, still have no time,
2372
    and can be, this is not right process)
2413
    and can be, this is not right process)
2373
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
2414
  * eax = 2 - the receiver has blocked IPC-buffer; try to wait a bit
2374
  * eax = 3 - overflow of IPC-buffer of the receiver
2415
  * eax = 3 - overflow of IPC-buffer of the receiver
2375
  * eax = 4 - process/thread with such PID does not exist
2416
  * eax = 4 - process/thread with such PID does not exist
2376
Remarks:
2417
Remarks:
2377
  * Immediately after writing of IPC-message to the buffer the system
2418
  * Immediately after writing of IPC-message to the buffer the system
2378
    sends to the receiver the event with code 7 (see event codes).
2419
    sends to the receiver the event with code 7 (see event codes).
2379
 
2420
 
2380
======================================================================
2421
======================================================================
2381
==== Function 61 - get parameters for the direct graphics access. ====
2422
==== Function 61 - get parameters for the direct graphics access. ====
2382
======================================================================
2423
======================================================================
2383
The data of the graphics screen (the memory area which displays
2424
The data of the graphics screen (the memory area which displays
2384
screen contents) are accessible to a program directly, without
2425
screen contents) are accessible to a program directly, without
2385
any system calls, through the selector gs:
2426
any system calls, through the selector gs:
2386
	mov	eax, [gs:0]
2427
	mov	eax, [gs:0]
2387
places in eax the first dword of the buffer, which contains
2428
places in eax the first dword of the buffer, which contains
2388
information on color of the left upper point (and, possibly, colors
2429
information on color of the left upper point (and, possibly, colors
2389
of several following).
2430
of several following).
2390
	mov	[gs:0], eax
2431
	mov	[gs:0], eax
2391
by work in VESA modes with LFB sets color of the left upper point
2432
by work in VESA modes with LFB sets color of the left upper point
2392
(and, possibly, colors of several following).
2433
(and, possibly, colors of several following).
2393
To interpret the data of graphics screen program needs to know
2434
To interpret the data of graphics screen program needs to know
2394
some parameters, returning by this function.
2435
some parameters, returning by this function.
2395
Remarks:
2436
Remarks:
2396
  * Graphics parameters changes very seldom at work,
2437
  * Graphics parameters changes very seldom at work,
2397
    namely, only in cases, when user works with the application VRR.
2438
    namely, only in cases, when user works with the application VRR.
2398
  * At videomode change the system redraws all windows (event
2439
  * At videomode change the system redraws all windows (event
2399
    with code 1) and redraws the background (event 5).
2440
    with code 1) and redraws the background (event 5).
2400
    Same events occur in other cases too, which meet much more often,
2441
    Same events occur in other cases too, which meet much more often,
2401
    than videomode change.
2442
    than videomode change.
2402
  * By operation in videomodes with LFB the selector gs points to
2443
  * By operation in videomodes with LFB the selector gs points to
2403
    LFB itself, so reading/writing on gs result directly in
2444
    LFB itself, so reading/writing on gs result directly in
2404
    change of screen contents. By operation in videomodes without
2445
    change of screen contents. By operation in videomodes without
2405
    LFB gs points to some data area in the kernel, and all functions
2446
    LFB gs points to some data area in the kernel, and all functions
2406
    of screen output fulfil honesty double operation on writing
2447
    of screen output fulfil honesty double operation on writing
2407
    directly to the screen and writing to this buffer. In result
2448
    directly to the screen and writing to this buffer. In result
2408
    at reading contents of this buffer the results correspond to
2449
    at reading contents of this buffer the results correspond to
2409
    screen contents (with, generally speaking, large color
2450
    screen contents (with, generally speaking, large color
2410
    resolution), and writing is ignored.
2451
    resolution), and writing is ignored.
2411
    One exception is the mode 320*200, for which main loop of the
2452
    One exception is the mode 320*200, for which main loop of the
2412
    system thread updates the screen according to mouse movements.
2453
    system thread updates the screen according to mouse movements.
2413
 
2454
 
2414
------------------------- Screen resolution --------------------------
2455
------------------------- Screen resolution --------------------------
2415
Parameters:
2456
Parameters:
2416
  * eax = 61 - function number
2457
  * eax = 61 - function number
2417
  * ebx = 1 - subfunction number
2458
  * ebx = 1 - subfunction number
2418
Returned value:
2459
Returned value:
2419
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
2460
  * eax = [resolution on x axis]*65536 + [resolution on y axis]
2420
Remarks:
2461
Remarks:
2421
  * One can use function 14 paying attention that
2462
  * One can use function 14 paying attention that
2422
    it returns sizes on 1 pixel less. It is fully equivalent way.
2463
    it returns sizes on 1 pixel less. It is fully equivalent way.
2423
 
2464
 
2424
---------------------- Number of bits per pixel ----------------------
2465
---------------------- Number of bits per pixel ----------------------
2425
Parameters:
2466
Parameters:
2426
  * eax = 61 - function number
2467
  * eax = 61 - function number
2427
  * ebx = 2 - subfunction number
2468
  * ebx = 2 - subfunction number
2428
Returned value:
2469
Returned value:
2429
  * eax = number of bits per pixel (24 or 32)
2470
  * eax = number of bits per pixel (24 or 32)
2430
 
2471
 
2431
-------------------- Number of bytes per scanline --------------------
2472
-------------------- Number of bytes per scanline --------------------
2432
Parameters:
2473
Parameters:
2433
  * eax = 61 - function number
2474
  * eax = 61 - function number
2434
  * ebx = 3 - subfunction number
2475
  * ebx = 3 - subfunction number
2435
Returned value:
2476
Returned value:
2436
  * eax = number of bytes occupied by one scanline
2477
  * eax = number of bytes occupied by one scanline
2437
    (horizontal line on the screen)
2478
    (horizontal line on the screen)
2438
 
2479
 
2439
======================================================================
2480
======================================================================
2440
===== Function 62, subfunction 0 - get version of PCI-interface. =====
2481
===== Function 62, subfunction 0 - get version of PCI-interface. =====
2441
======================================================================
2482
======================================================================
2442
Parameters:
2483
Parameters:
2443
  * eax = 62 - function number
2484
  * eax = 62 - function number
2444
  * bl = 0 - subfunction number
2485
  * bl = 0 - subfunction number
2445
Returned value:
2486
Returned value:
2446
  * eax = -1 - PCI access is disabled; otherwise
2487
  * eax = -1 - PCI access is disabled; otherwise
2447
  * ah.al = version of PCI-interface (ah=version, al=subversion)
2488
  * ah.al = version of PCI-interface (ah=version, al=subversion)
2448
  * high word of eax is zeroed
2489
  * high word of eax is zeroed
2449
Remarks:
2490
Remarks:
2450
  * Previously low-level access to PCI for applications must be
2491
  * Previously low-level access to PCI for applications must be
2451
    enabled by subfunction 12 of function 21.
2492
    enabled by subfunction 12 of function 21.
2452
  * If PCI BIOS is not supported, the value of ax is undefined.
2493
  * If PCI BIOS is not supported, the value of ax is undefined.
2453
 
2494
 
2454
======================================================================
2495
======================================================================
2455
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
2496
==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
2456
======================================================================
2497
======================================================================
2457
Parameters:
2498
Parameters:
2458
  * eax = 62 - function number
2499
  * eax = 62 - function number
2459
  * bl = 1 - subfunction number
2500
  * bl = 1 - subfunction number
2460
Returned value:
2501
Returned value:
2461
  * eax = -1 - access to PCI is disabled; otherwise
2502
  * eax = -1 - access to PCI is disabled; otherwise
2462
  * al = number of the last PCI-bus; other bytes of eax are destroyed
2503
  * al = number of the last PCI-bus; other bytes of eax are destroyed
2463
Remarks:
2504
Remarks:
2464
  * Previously low-level access to PCI for applications must be
2505
  * Previously low-level access to PCI for applications must be
2465
    enabled by subfunction 12 of function 21.
2506
    enabled by subfunction 12 of function 21.
2466
  * If PCI BIOS is not supported, the value of ax is undefined.
2507
  * If PCI BIOS is not supported, the value of ax is undefined.
2467
 
2508
 
2468
======================================================================
2509
======================================================================
2469
===================== Function 62, subfunction 2 =====================
2510
===================== Function 62, subfunction 2 =====================
2470
===== Get mechanism of addressing to the PCI configuration space. ====
2511
===== Get mechanism of addressing to the PCI configuration space. ====
2471
======================================================================
2512
======================================================================
2472
Parameters:
2513
Parameters:
2473
  * eax = 62 - function number
2514
  * eax = 62 - function number
2474
  * bl = 2 - subfunction number
2515
  * bl = 2 - subfunction number
2475
Returned value:
2516
Returned value:
2476
  * eax = -1 - access to PCI is disabled; otherwise
2517
  * eax = -1 - access to PCI is disabled; otherwise
2477
  * al = mechanism (1 or 2); other bytes of eax are destroyed
2518
  * al = mechanism (1 or 2); other bytes of eax are destroyed
2478
Remarks:
2519
Remarks:
2479
  * Previously low-level access to PCI for applications must be
2520
  * Previously low-level access to PCI for applications must be
2480
    enabled by subfunction 12 of function 21.
2521
    enabled by subfunction 12 of function 21.
2481
  * Addressing mechanism is selected depending on
2522
  * Addressing mechanism is selected depending on
2482
    equipment characteristics.
2523
    equipment characteristics.
2483
  * Subfunctions of read and write work automatically
2524
  * Subfunctions of read and write work automatically
2484
    with the selected mechanism.
2525
    with the selected mechanism.
2485
 
2526
 
2486
======================================================================
2527
======================================================================
2487
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
2528
======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
2488
======================================================================
2529
======================================================================
2489
Parameters:
2530
Parameters:
2490
  * eax = 62 - function number
2531
  * eax = 62 - function number
2491
  * bl = 4 - read byte
2532
  * bl = 4 - read byte
2492
  * bl = 5 - read word
2533
  * bl = 5 - read word
2493
  * bl = 6 - read dword
2534
  * bl = 6 - read dword
2494
  * bh = number of PCI-bus
2535
  * bh = number of PCI-bus
2495
  * ch = dddddfff, where ddddd = number of the device on the bus,
2536
  * ch = dddddfff, where ddddd = number of the device on the bus,
2496
    fff = function number of device
2537
    fff = function number of device
2497
  * cl = number of register (must be even for bl=5,
2538
  * cl = number of register (must be even for bl=5,
2498
    divisible by 4 for bl=6)
2539
    divisible by 4 for bl=6)
2499
Returned value:
2540
Returned value:
2500
  * eax = -1 - error (access to PCI is disabled or parameters
2541
  * eax = -1 - error (access to PCI is disabled or parameters
2501
    are not supported); otherwise
2542
    are not supported); otherwise
2502
  * al/ax/eax (depending on requested size) contains the data;
2543
  * al/ax/eax (depending on requested size) contains the data;
2503
    the other part of register eax is destroyed
2544
    the other part of register eax is destroyed
2504
Remarks:
2545
Remarks:
2505
  * Previously low-level access to PCI for applications must be
2546
  * Previously low-level access to PCI for applications must be
2506
    enabled by subfunction 12 of function 21.
2547
    enabled by subfunction 12 of function 21.
2507
  * Access mechanism 2 supports only 16 devices on a bus and ignores
2548
  * Access mechanism 2 supports only 16 devices on a bus and ignores
2508
    function number. To get access mechanism use subfunction 2.
2549
    function number. To get access mechanism use subfunction 2.
2509
  * Some registers are standard and exist for all devices, some are
2550
  * Some registers are standard and exist for all devices, some are
2510
    defined by the concrete device. The list of registers of the
2551
    defined by the concrete device. The list of registers of the
2511
    first type can be found e.g. in famous
2552
    first type can be found e.g. in famous
2512
    Interrupt List by Ralf Brown
2553
    Interrupt List by Ralf Brown
2513
    (http://www.pobox.com/~ralf/files.html,
2554
    (http://www.pobox.com/~ralf/files.html,
2514
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
2555
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
2515
    registers of the second type must be listed
2556
    registers of the second type must be listed
2516
    in the device documentation.
2557
    in the device documentation.
2517
 
2558
 
2518
======================================================================
2559
======================================================================
2519
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
2560
====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
2520
======================================================================
2561
======================================================================
2521
Parameters:
2562
Parameters:
2522
  * eax = 62 - function number
2563
  * eax = 62 - function number
2523
  * bl = 8 - write byte
2564
  * bl = 8 - write byte
2524
  * bl = 9 - write word
2565
  * bl = 9 - write word
2525
  * bl = 10 - write dword
2566
  * bl = 10 - write dword
2526
  * bh = number of PCI-bus
2567
  * bh = number of PCI-bus
2527
  * ch = dddddfff, where ddddd = number of the device on the bus,
2568
  * ch = dddddfff, where ddddd = number of the device on the bus,
2528
    fff = function number of device
2569
    fff = function number of device
2529
  * cl = number of register (must be even for bl=9,
2570
  * cl = number of register (must be even for bl=9,
2530
    divisible by 4 for bl=10)
2571
    divisible by 4 for bl=10)
2531
  * dl/dx/edx (depending on requested size) contatins
2572
  * dl/dx/edx (depending on requested size) contatins
2532
    the data to write
2573
    the data to write
2533
Returned value:
2574
Returned value:
2534
  * eax = -1 - error (access to PCI is disabled or parameters
2575
  * eax = -1 - error (access to PCI is disabled or parameters
2535
    are not supported)
2576
    are not supported)
2536
  * eax = 0 - success
2577
  * eax = 0 - success
2537
Remarks:
2578
Remarks:
2538
  * Previously low-level access to PCI for applications must be
2579
  * Previously low-level access to PCI for applications must be
2539
    enabled by subfunction 12 of function 21.
2580
    enabled by subfunction 12 of function 21.
2540
  * Access mechanism 2 supports only 16 devices on a bus and ignores
2581
  * Access mechanism 2 supports only 16 devices on a bus and ignores
2541
    function number. To get access mechanism use subfunction 2.
2582
    function number. To get access mechanism use subfunction 2.
2542
  * Some registers are standard and exist for all devices, some are
2583
  * Some registers are standard and exist for all devices, some are
2543
    defined by the concrete device. The list of registers of the
2584
    defined by the concrete device. The list of registers of the
2544
    first type can be found e.g. in famous Interrupt List by
2585
    first type can be found e.g. in famous Interrupt List by
2545
    Ralf Brown; registers of the second type must be listed
2586
    Ralf Brown; registers of the second type must be listed
2546
    in the device documentation.
2587
    in the device documentation.
2547
 
2588
 
2548
======================================================================
2589
======================================================================
2549
============== Function 63 - work with the debug board. ==============
2590
============== Function 63 - work with the debug board. ==============
2550
======================================================================
2591
======================================================================
2551
The debug board is the global system buffer (with the size
2592
The debug board is the global system buffer (with the size
2552
1024 bytes), to which any program can write (generally speaking,
2593
1024 bytes), to which any program can write (generally speaking,
2553
arbitrary) data and from which other program can read these data.
2594
arbitrary) data and from which other program can read these data.
2554
By the agreement written data are text strings interpreted as
2595
By the agreement written data are text strings interpreted as
2555
debug messages on a course of program execution. The kernel in
2596
debug messages on a course of program execution. The kernel in
2556
some situations also writes to the debug board information on
2597
some situations also writes to the debug board information on
2557
execution of some functions; by the agreement kernel messages
2598
execution of some functions; by the agreement kernel messages
2558
begins from the prefix "K : ".
2599
begins from the prefix "K : ".
2559
For view of the debug board the application 'board' was created,
2600
For view of the debug board the application 'board' was created,
2560
which reads data from the buffer and displays them in its window.
2601
which reads data from the buffer and displays them in its window.
2561
'board' interpretes the sequence of codes 13,10 as newline.
2602
'board' interpretes the sequence of codes 13,10 as newline.
2562
A character with null code in an end of line is not necessary,
2603
A character with null code in an end of line is not necessary,
2563
but also does not prevent.
2604
but also does not prevent.
2564
Because debugger has been written, the value of the debug board
2605
Because debugger has been written, the value of the debug board
2565
has decreased, as debugger allows to inspect completely a course of
2606
has decreased, as debugger allows to inspect completely a course of
2566
program execution without any efforts from the direction of program
2607
program execution without any efforts from the direction of program
2567
itself. Nevertheless in some cases the debug board is still useful.
2608
itself. Nevertheless in some cases the debug board is still useful.
2568
 
2609
 
2569
----------------------------- Write byte -----------------------------
2610
----------------------------- Write byte -----------------------------
2570
Parameters:
2611
Parameters:
2571
  * eax = 63 - function number
2612
  * eax = 63 - function number
2572
  * ebx = 1 - subfunction number
2613
  * ebx = 1 - subfunction number
2573
  * cl = data byte
2614
  * cl = data byte
2574
Returned value:
2615
Returned value:
2575
  * function does not return value
2616
  * function does not return value
2576
Remarks:
2617
Remarks:
2577
  * Byte is written to the buffer. Buffer size is 512 bytes.
2618
  * Byte is written to the buffer. Buffer size is 512 bytes.
2578
    At buffer overflow all obtained data are lost.
2619
    At buffer overflow all obtained data are lost.
2579
  * For output to the debug board of more complicated objects
2620
  * For output to the debug board of more complicated objects
2580
    (strings, numbers) it is enough to call this function in cycle.
2621
    (strings, numbers) it is enough to call this function in cycle.
2581
    It is possible not to write the appropriate code manually and use
2622
    It is possible not to write the appropriate code manually and use
2582
    file 'debug.inc', which is included into the distributive.
2623
    file 'debug.inc', which is included into the distributive.
2583
 
2624
 
2584
----------------------------- Read byte ------------------------------
2625
----------------------------- Read byte ------------------------------
2585
Takes away byte from the buffer.
2626
Takes away byte from the buffer.
2586
Parameters:
2627
Parameters:
2587
  * eax = 63 - function number
2628
  * eax = 63 - function number
2588
  * ebx = 2 - subfunction number
2629
  * ebx = 2 - subfunction number
2589
Returned value:
2630
Returned value:
2590
  * eax = ebx = 0 - the buffer is empty
2631
  * eax = ebx = 0 - the buffer is empty
2591
  * eax = byte, ebx = 1 - byte was successfully read
2632
  * eax = byte, ebx = 1 - byte was successfully read
2592
 
2633
 
2593
======================================================================
2634
======================================================================
2594
============== Function 64 - resize application memory. ==============
2635
============== Function 64 - resize application memory. ==============
2595
======================================================================
2636
======================================================================
2596
Parameters:
2637
Parameters:
2597
  * eax = 64 - function number
2638
  * eax = 64 - function number
2598
  * ebx = 1 - unique subfunction
2639
  * ebx = 1 - unique subfunction
2599
  * ecx = new memory size
2640
  * ecx = new memory size
2600
Returned value:
2641
Returned value:
2601
  * eax = 0 - success
2642
  * eax = 0 - success
2602
  * eax = 1 - not enough memory
2643
  * eax = 1 - not enough memory
2603
Remarks:
2644
Remarks:
2604
  * There is another way to dynamically allocate/free memory -
2645
  * There is another way to dynamically allocate/free memory -
2605
    subfunctions 11, 12, 13 of function 68.
2646
    subfunctions 11, 12, 13 of function 68.
2606
  * The function cannot be used together with 68.11, 68.12, 68.13.
2647
  * The function cannot be used together with 68.11, 68.12, 68.13.
2607
    The function call will be ignored after creation of process heap
2648
    The function call will be ignored after creation of process heap
2608
    with function 68.11.
2649
    with function 68.11.
2609
 
2650
 
2610
======================================================================
2651
======================================================================
2611
======== Function 65 - draw image with palette in the window. ========
2652
======== Function 65 - draw image with palette in the window. ========
2612
======================================================================
2653
======================================================================
2613
Parameters:
2654
Parameters:
2614
  * eax = 65 - function number
2655
  * eax = 65 - function number
2615
  * ebx = pointer to the image
2656
  * ebx = pointer to the image
2616
  * ecx = [size on axis x]*65536 + [size on axis y]
2657
  * ecx = [size on axis x]*65536 + [size on axis y]
2617
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
2658
  * edx = [coordinate on axis x]*65536 + [coordinate on axis y]
2618
  * esi = number of bits per pixel, must be 1,2,4,8,9,15,16,24 or 32;
2659
  * esi = number of bits per pixel, must be 1,2,4,8,9,15,16,24 or 32;
2619
  * edi = pointer to palette (2 to the power esi colors 0x00RRGGBB);
2660
  * edi = pointer to palette (2 to the power esi colors 0x00RRGGBB);
2620
          ignored when esi > 8
2661
          ignored when esi > 8
2621
  * ebp = offset of next row data relative to previous row data
2662
  * ebp = offset of next row data relative to previous row data
2622
Returned value:
2663
Returned value:
2623
  * function does not return value
2664
  * function does not return value
2624
Remarks:
2665
Remarks:
2625
  * Coordinates of the image are coordinates of the upper left corner
2666
  * Coordinates of the image are coordinates of the upper left corner
2626
    of the image relative to the window.
2667
    of the image relative to the window.
2627
  * Format of image with 1 bit per pixel: each byte of image
2668
  * Format of image with 1 bit per pixel: each byte of image
2628
    (possibly excluding last bytes in rows), contains information on
2669
    (possibly excluding last bytes in rows), contains information on
2629
    the color of 8 pixels, MSB corresponds to first pixel.
2670
    the color of 8 pixels, MSB corresponds to first pixel.
2630
  * Format of image with 2 bits per pixel: each byte of image
2671
  * Format of image with 2 bits per pixel: each byte of image
2631
    (possibly excluding last bytes in rows), contains information on
2672
    (possibly excluding last bytes in rows), contains information on
2632
    the color of 4 pixels, two MSBs correspond to first pixel.
2673
    the color of 4 pixels, two MSBs correspond to first pixel.
2633
  * Format of image with 4 bits per pixel: each byte of image
2674
  * Format of image with 4 bits per pixel: each byte of image
2634
    excluding last bytes in rows (if width is odd) contains
2675
    excluding last bytes in rows (if width is odd) contains
2635
    information on the color of 2 pixels, high-order tetrad
2676
    information on the color of 2 pixels, high-order tetrad
2636
    corresponds to first pixel.
2677
    corresponds to first pixel.
2637
  * Format of image with 8 bits per pixel: each byte of image is
2678
  * Format of image with 8 bits per pixel: each byte of image is
2638
    index in the palette.
2679
    index in the palette.
2639
  * Format of image with 9 bits per pixel: array of one byte values;
2680
  * Format of image with 9 bits per pixel: array of one byte values;
2640
    each byte (8 bit) represents the intensity of gray for one pixel;
2681
    each byte (8 bit) represents the intensity of gray for one pixel;
2641
    this format is equal to 8bpp without palette.
2682
    this format is equal to 8bpp without palette.
2642
  * Format of image with 15 bits per pixel: the color of each pixel
2683
  * Format of image with 15 bits per pixel: the color of each pixel
2643
    is coded as (bit representation) 0RRRRRGGGGGBBBBB - 5 bits per
2684
    is coded as (bit representation) 0RRRRRGGGGGBBBBB - 5 bits per
2644
    each color.
2685
    each color.
2645
  * Format of image with 16 bits per pixel: the color of each pixel
2686
  * Format of image with 16 bits per pixel: the color of each pixel
2646
    is coded as RRRRRGGGGGGBBBBB (5+6+5).
2687
    is coded as RRRRRGGGGGGBBBBB (5+6+5).
2647
  * Format of image with 24 bits per pixel: the color of each pixel
2688
  * Format of image with 24 bits per pixel: the color of each pixel
2648
    is coded as 3 bytes - sequentially blue, green, red components.
2689
    is coded as 3 bytes - sequentially blue, green, red components.
2649
  * Format of image with 32 bits per pixel: similar to 24, but
2690
  * Format of image with 32 bits per pixel: similar to 24, but
2650
    one additional ignored byte is present.
2691
    one additional ignored byte is present.
2651
  * The call to function 7 is equivalent to call to this function
2692
  * The call to function 7 is equivalent to call to this function
2652
    with esi=24, ebp=0.
2693
    with esi=24, ebp=0.
2653
 
2694
 
2654
======================================================================
2695
======================================================================
2655
================== Function 66 - work with keyboard. =================
2696
================== Function 66 - work with keyboard. =================
2656
======================================================================
2697
======================================================================
2657
The input mode influences results of reading keys by function 2.
2698
The input mode influences results of reading keys by function 2.
2658
When a program loads, ASCII input mode is set for it.
2699
When a program loads, ASCII input mode is set for it.
2659
 
2700
 
2660
-------------- Subfunction 1 - set keyboard input mode. --------------
2701
-------------- Subfunction 1 - set keyboard input mode. --------------
2661
Parameters:
2702
Parameters:
2662
  * eax = 66 - function number
2703
  * eax = 66 - function number
2663
  * ebx = 1 - subfunction number
2704
  * ebx = 1 - subfunction number
2664
  * ecx = mode:
2705
  * ecx = mode:
2665
    * 0 = normal (ASCII-characters)
2706
    * 0 = normal (ASCII-characters)
2666
    * 1 = scancodes
2707
    * 1 = scancodes
2667
Returned value:
2708
Returned value:
2668
  * function does not return value
2709
  * function does not return value
2669
 
2710
 
2670
-------------- Subfunction 2 - get keyboard input mode. --------------
2711
-------------- Subfunction 2 - get keyboard input mode. --------------
2671
Parameters:
2712
Parameters:
2672
  * eax = 66 - function number
2713
  * eax = 66 - function number
2673
  * ebx = 2 - subfunction number
2714
  * ebx = 2 - subfunction number
2674
Returned value:
2715
Returned value:
2675
  * eax = current mode
2716
  * eax = current mode
2676
 
2717
 
2677
------------ Subfunction 3 - get status of control keys. -------------
2718
------------ Subfunction 3 - get status of control keys. -------------
2678
Parameters:
2719
Parameters:
2679
  * eax = 66 - function number
2720
  * eax = 66 - function number
2680
  * ebx = 3 - subfunction number
2721
  * ebx = 3 - subfunction number
2681
Returned value:
2722
Returned value:
2682
  * eax = bit mask:
2723
  * eax = bit mask:
2683
  * bit 0  (mask 1): left Shift is pressed
2724
  * bit 0  (mask 1): left Shift is pressed
2684
  * bit 1  (mask 2): right Shift is pressed
2725
  * bit 1  (mask 2): right Shift is pressed
2685
  * bit 2  (mask 4): left Ctrl is pressed
2726
  * bit 2  (mask 4): left Ctrl is pressed
2686
  * bit 3  (mask 8): right Ctrl is pressed
2727
  * bit 3  (mask 8): right Ctrl is pressed
2687
  * bit 4  (mask 0x10): left Alt is pressed
2728
  * bit 4  (mask 0x10): left Alt is pressed
2688
  * bit 5  (mask 0x20): right Alt is pressed
2729
  * bit 5  (mask 0x20): right Alt is pressed
2689
  * bit 6  (mask 0x40): CapsLock is on
2730
  * bit 6  (mask 0x40): CapsLock is on
2690
  * bit 7  (mask 0x80): NumLock is on
2731
  * bit 7  (mask 0x80): NumLock is on
2691
  * bit 8  (mask 0x100): ScrollLock is on
2732
  * bit 8  (mask 0x100): ScrollLock is on
2692
  * bit 9  (mask 0x200): left Win is pressed
2733
  * bit 9  (mask 0x200): left Win is pressed
2693
  * bit 10 (mask 0x400): right Win is pressed
2734
  * bit 10 (mask 0x400): right Win is pressed
2694
  * other bits are cleared
2735
  * other bits are cleared
2695
 
2736
 
2696
-------------- Subfunction 4 - set system-wide hotkey. ---------------
2737
-------------- Subfunction 4 - set system-wide hotkey. ---------------
2697
When hotkey is pressed, the system notifies only those applications,
2738
When hotkey is pressed, the system notifies only those applications,
2698
which have installed it; the active application (which receives
2739
which have installed it; the active application (which receives
2699
all normal input) does not receive such keys.
2740
all normal input) does not receive such keys.
2700
The notification consists in sending event with the code 2.
2741
The notification consists in sending event with the code 2.
2701
Reading hotkey is the same as reading normal key - by function 2.
2742
Reading hotkey is the same as reading normal key - by function 2.
2702
Parameters:
2743
Parameters:
2703
  * eax = 66 - function number
2744
  * eax = 66 - function number
2704
  * ebx = 4 - subfunction number
2745
  * ebx = 4 - subfunction number
2705
  * cl determines key scancode;
2746
  * cl determines key scancode;
2706
    use cl=0 to give combinations such as Ctrl+Shift
2747
    use cl=0 to give combinations such as Ctrl+Shift
2707
  * edx = 0xXYZ determines possible states of control keys:
2748
  * edx = 0xXYZ determines possible states of control keys:
2708
    * Z (low 4 bits) determines state of LShift and RShift:
2749
    * Z (low 4 bits) determines state of LShift and RShift:
2709
      * 0 = no key must be pressed;
2750
      * 0 = no key must be pressed;
2710
      * 1 = exactly one key must be pressed;
2751
      * 1 = exactly one key must be pressed;
2711
      * 2 = both keys must be pressed;
2752
      * 2 = both keys must be pressed;
2712
      * 3 = must be pressed LShift, but not RShift;
2753
      * 3 = must be pressed LShift, but not RShift;
2713
      * 4 = must be pressed RShift, but not LShift
2754
      * 4 = must be pressed RShift, but not LShift
2714
    * Y - similar for LCtrl and RCtrl;
2755
    * Y - similar for LCtrl and RCtrl;
2715
    * X - similar for LAlt and RAlt
2756
    * X - similar for LAlt and RAlt
2716
Returned value:
2757
Returned value:
2717
  * eax=0 - success
2758
  * eax=0 - success
2718
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
2759
  * eax=1 - too mant hotkeys (maximum 256 are allowed)
2719
Remarks:
2760
Remarks:
2720
  * Hotkey can work either at pressing or at release. Release
2761
  * Hotkey can work either at pressing or at release. Release
2721
    scancode of a key is more on 128 than pressing scancode
2762
    scancode of a key is more on 128 than pressing scancode
2722
    (i.e. high bit is set).
2763
    (i.e. high bit is set).
2723
  * Several applications can set the same combination;
2764
  * Several applications can set the same combination;
2724
    all such applications will be informed on pressing
2765
    all such applications will be informed on pressing
2725
    such combination.
2766
    such combination.
2726
 
2767
 
2727
-------------- Subfunction 5 - delete installed hotkey. --------------
2768
-------------- Subfunction 5 - delete installed hotkey. --------------
2728
Parameters:
2769
Parameters:
2729
  * eax = 66 - function number
2770
  * eax = 66 - function number
2730
  * ebx = 5 - subfunction number
2771
  * ebx = 5 - subfunction number
2731
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
2772
  * cl = scancode of key and edx = 0xXYZ the same as in subfunction 4
2732
Returned value:
2773
Returned value:
2733
  * eax = 0 - success
2774
  * eax = 0 - success
2734
  * eax = 1 - there is no such hotkey
2775
  * eax = 1 - there is no such hotkey
2735
Remarks:
2776
Remarks:
2736
  * When a process/thread terminates, all hotkey installed by it are
2777
  * When a process/thread terminates, all hotkey installed by it are
2737
    deleted.
2778
    deleted.
2738
  * The call to this subfunction does not affect other applications.
2779
  * The call to this subfunction does not affect other applications.
2739
    If other application has defined the same combination, it will
2780
    If other application has defined the same combination, it will
2740
    still receive notices.
2781
    still receive notices.
2741
 
2782
 
2742
--------------- Subfunction 6 - block the normal input. --------------
2783
--------------- Subfunction 6 - block the normal input. --------------
2743
Parameters:
2784
Parameters:
2744
  * eax = 66 - function number
2785
  * eax = 66 - function number
2745
  * ebx = 6 - subfunction number
2786
  * ebx = 6 - subfunction number
2746
Returned value:
2787
Returned value:
2747
  * function does not return value
2788
  * function does not return value
2748
Remarks:
2789
Remarks:
2749
  * Blocking the normal keyboard input for installed hotkeys
2790
  * Blocking the normal keyboard input for installed hotkeys
2750
  * To emulate a mouse via the keyboard, the application MOUSEMUL
2791
  * To emulate a mouse via the keyboard, the application MOUSEMUL
2751
 
2792
 
2752
------------ Subfunction 7 - unlock the normal input. ----------------
2793
------------ Subfunction 7 - unlock the normal input. ----------------
2753
Parameters:
2794
Parameters:
2754
  * eax = 66 - function number
2795
  * eax = 66 - function number
2755
  * ebx = 7 - subfunction number
2796
  * ebx = 7 - subfunction number
2756
Returned value:
2797
Returned value:
2757
  * function does not return value
2798
  * function does not return value
2758
Remarks:
2799
Remarks:
2759
  * Unlocking the results of the f. 66.6
2800
  * Unlocking the results of the f. 66.6
2760
  * To emulate a mouse via the keyboard, the application MOUSEMUL
2801
  * To emulate a mouse via the keyboard, the application MOUSEMUL
2761
 
2802
 
2762
======================================================================
2803
======================================================================
2763
========= Function 67 - change position/sizes of the window. =========
2804
========= Function 67 - change position/sizes of the window. =========
2764
======================================================================
2805
======================================================================
2765
Parameters:
2806
Parameters:
2766
  * eax = 67 - function number
2807
  * eax = 67 - function number
2767
  * ebx = new x-coordinate of the window
2808
  * ebx = new x-coordinate of the window
2768
  * ecx = new y-coordinate of the window
2809
  * ecx = new y-coordinate of the window
2769
  * edx = new x-size of the window
2810
  * edx = new x-size of the window
2770
  * esi = new y-size of the window
2811
  * esi = new y-size of the window
2771
Returned value:
2812
Returned value:
2772
  * function does not return value
2813
  * function does not return value
2773
Remarks:
2814
Remarks:
2774
  * The value -1 for a parameter means "do not change"; e.g. to move
2815
  * The value -1 for a parameter means "do not change"; e.g. to move
2775
    the window without resizing it is possible to specify edx=esi=-1.
2816
    the window without resizing it is possible to specify edx=esi=-1.
2776
  * Previously the window must be defined by function 0.
2817
  * Previously the window must be defined by function 0.
2777
    It sets initial coordinates and sizes of the window.
2818
    It sets initial coordinates and sizes of the window.
2778
  * Sizes of the window are understood in sense of function 0,
2819
  * Sizes of the window are understood in sense of function 0,
2779
    that is one pixel less than real sizes.
2820
    that is one pixel less than real sizes.
2780
  * The function call for maximized windows is simply ignored.
2821
  * The function call for maximized windows is simply ignored.
2781
  * For windows of appropriate styles position and/or sizes can be
2822
  * For windows of appropriate styles position and/or sizes can be
2782
    changed by user; current position and sizes can be obtained by
2823
    changed by user; current position and sizes can be obtained by
2783
    call to function 9.
2824
    call to function 9.
2784
  * The function sends to the window redraw event (with the code 1).
2825
  * The function sends to the window redraw event (with the code 1).
2785
 
2826
 
2786
======================================================================
2827
======================================================================
2787
====== Function 68, subfunction 0 - get the task switch counter. =====
2828
====== Function 68, subfunction 0 - get the task switch counter. =====
2788
======================================================================
2829
======================================================================
2789
Parameters:
2830
Parameters:
2790
  * eax = 68 - function number
2831
  * eax = 68 - function number
2791
  * ebx = 0 - subfunction number
2832
  * ebx = 0 - subfunction number
2792
Returned value:
2833
Returned value:
2793
  * eax = number of task switches from the system booting
2834
  * eax = number of task switches from the system booting
2794
    (modulo 2^32)
2835
    (modulo 2^32)
2795
 
2836
 
2796
======================================================================
2837
======================================================================
2797
======= Function 68, subfunction 1 - switch to the next thread. ======
2838
======= Function 68, subfunction 1 - switch to the next thread. ======
2798
======================================================================
2839
======================================================================
2799
The function completes the current time slice allocated to the
2840
The function completes the current time slice allocated to the
2800
thread and switches to the next. (Which thread in which process
2841
thread and switches to the next. (Which thread in which process
2801
will be next, is unpredictable). Later, when execution queue
2842
will be next, is unpredictable). Later, when execution queue
2802
will reach the current thread, execution will be continued.
2843
will reach the current thread, execution will be continued.
2803
Parameters:
2844
Parameters:
2804
  * eax = 68 - function number
2845
  * eax = 68 - function number
2805
  * ebx = 1 - subfunction number
2846
  * ebx = 1 - subfunction number
2806
Returned value:
2847
Returned value:
2807
  * function does not return value
2848
  * function does not return value
2808
 
2849
 
2809
======================================================================
2850
======================================================================
2810
============= Function 68, subfunction 2 - cache + rdpmc. ============
2851
============= Function 68, subfunction 2 - cache + rdpmc. ============
2811
======================================================================
2852
======================================================================
2812
Parameters:
2853
Parameters:
2813
  * eax = 68 - function number
2854
  * eax = 68 - function number
2814
  * ebx = 2 - subfunction number
2855
  * ebx = 2 - subfunction number
2815
  * ecx = required action:
2856
  * ecx = required action:
2816
    * ecx = 0 - enable instruction 'rdpmc'
2857
    * ecx = 0 - enable instruction 'rdpmc'
2817
      (ReaD Performance-Monitoring Counters) for applications
2858
      (ReaD Performance-Monitoring Counters) for applications
2818
    * ecx = 1 - find out whether cache is disabled/enabled
2859
    * ecx = 1 - find out whether cache is disabled/enabled
2819
    * ecx = 2 - enable cache
2860
    * ecx = 2 - enable cache
2820
    * ecx = 3 - disable cache
2861
    * ecx = 3 - disable cache
2821
Returned value:
2862
Returned value:
2822
  * for ecx=0:
2863
  * for ecx=0:
2823
    * eax = the value of cr4
2864
    * eax = the value of cr4
2824
  * for ecx=1:
2865
  * for ecx=1:
2825
    * eax = (cr0 and 0x60000000):
2866
    * eax = (cr0 and 0x60000000):
2826
    * eax = 0 - cache is on
2867
    * eax = 0 - cache is on
2827
    * eax <> 0 - cache is off
2868
    * eax <> 0 - cache is off
2828
  * for ecx=2 and ecx=3:
2869
  * for ecx=2 and ecx=3:
2829
    * function does not return value
2870
    * function does not return value
2830
 
2871
 
2831
======================================================================
2872
======================================================================
2832
=========== Function 68, subfunction 3 - read MSR-register. ==========
2873
=========== Function 68, subfunction 3 - read MSR-register. ==========
2833
======================================================================
2874
======================================================================
2834
MSR = Model Specific Register; the complete list of MSR-registers
2875
MSR = Model Specific Register; the complete list of MSR-registers
2835
of a processor is included to the documentation on it (for example,
2876
of a processor is included to the documentation on it (for example,
2836
IA-32 Intel Architecture Software Developer's Manual,
2877
IA-32 Intel Architecture Software Developer's Manual,
2837
Volume 3, Appendix B); each processor family has its own subset
2878
Volume 3, Appendix B); each processor family has its own subset
2838
of the MSR-registers.
2879
of the MSR-registers.
2839
Parameters:
2880
Parameters:
2840
  * eax = 68 - function number
2881
  * eax = 68 - function number
2841
  * ebx = 3 - subfunction number
2882
  * ebx = 3 - subfunction number
2842
  * ecx is ignored
2883
  * ecx is ignored
2843
  * edx = MSR address
2884
  * edx = MSR address
2844
Returned value:
2885
Returned value:
2845
  * ebx:eax = high:low dword of the result
2886
  * ebx:eax = high:low dword of the result
2846
Remarks:
2887
Remarks:
2847
  * If ecx contains nonexistent or not implemented for this processor
2888
  * If ecx contains nonexistent or not implemented for this processor
2848
    MSR, processor will generate an exception in the kernel, which
2889
    MSR, processor will generate an exception in the kernel, which
2849
    will kill the thread.
2890
    will kill the thread.
2850
  * Previously it is necessary to check, whether MSRs are supported
2891
  * Previously it is necessary to check, whether MSRs are supported
2851
    as a whole, with the instruction 'cpuid'. Otherwise processor
2892
    as a whole, with the instruction 'cpuid'. Otherwise processor
2852
    will generate other exception in the kernel, which will anyway
2893
    will generate other exception in the kernel, which will anyway
2853
    kill the thread.
2894
    kill the thread.
2854
 
2895
 
2855
======================================================================
2896
======================================================================
2856
========= Function 68, subfunction 4 - write to MSR-register. ========
2897
========= Function 68, subfunction 4 - write to MSR-register. ========
2857
======================================================================
2898
======================================================================
2858
MSR = Model Specific Register; the complete list of MSR-registers
2899
MSR = Model Specific Register; the complete list of MSR-registers
2859
of a processor is included to the documentation on it (for example,
2900
of a processor is included to the documentation on it (for example,
2860
IA-32 Intel Architecture Software Developer's Manual,
2901
IA-32 Intel Architecture Software Developer's Manual,
2861
Volume 3, Appendix B); each processor family has its own subset
2902
Volume 3, Appendix B); each processor family has its own subset
2862
of the MSR-registers.
2903
of the MSR-registers.
2863
Parameters:
2904
Parameters:
2864
  * eax = 68 - function number
2905
  * eax = 68 - function number
2865
  * ebx = 4 - subfunction number
2906
  * ebx = 4 - subfunction number
2866
  * ecx is ignored
2907
  * ecx is ignored
2867
  * edx = MSR address
2908
  * edx = MSR address
2868
  * esi:edi = high:low dword
2909
  * esi:edi = high:low dword
2869
Returned value:
2910
Returned value:
2870
  * function does not return value
2911
  * function does not return value
2871
Remarks:
2912
Remarks:
2872
  * If ecx contains nonexistent or not implemented for this processor
2913
  * If ecx contains nonexistent or not implemented for this processor
2873
    MSR, processor will generate an exception in the kernel, which
2914
    MSR, processor will generate an exception in the kernel, which
2874
    will kill the thread.
2915
    will kill the thread.
2875
  * Previously it is necessary to check, whether MSRs are supported
2916
  * Previously it is necessary to check, whether MSRs are supported
2876
    as a whole, with the instruction 'cpuid'. Otherwise processor
2917
    as a whole, with the instruction 'cpuid'. Otherwise processor
2877
    will generate other exception in the kernel, which will anyway
2918
    will generate other exception in the kernel, which will anyway
2878
    kill the thread.
2919
    kill the thread.
2879
 
2920
 
2880
======================================================================
2921
======================================================================
2881
======= Function 68, subfunction 11 - initialize process heap. =======
2922
======= Function 68, subfunction 11 - initialize process heap. =======
2882
======================================================================
2923
======================================================================
2883
Parameters:
2924
Parameters:
2884
  * eax = 68 - function number
2925
  * eax = 68 - function number
2885
  * ebx = 11 - subfunction number
2926
  * ebx = 11 - subfunction number
2886
Returned value:
2927
Returned value:
2887
  * eax = 0 - failed
2928
  * eax = 0 - failed
2888
  * otherwise size of created heap
2929
  * otherwise size of created heap
2889
Remarks:
2930
Remarks:
2890
  * The function call initializes heap, from which one can in future
2931
  * The function call initializes heap, from which one can in future
2891
    allocate and free memory blocks with subfunctions 12 and 13.
2932
    allocate and free memory blocks with subfunctions 12 and 13.
2892
    Heap size is equal to total amount of free application memory.
2933
    Heap size is equal to total amount of free application memory.
2893
  * The second function call from the same process results in
2934
  * The second function call from the same process results in
2894
    returning the size of the existing heap.
2935
    returning the size of the existing heap.
2895
  * After creation of the heap calls to function 64 will be ignored.
2936
  * After creation of the heap calls to function 64 will be ignored.
2896
 
2937
 
2897
======================================================================
2938
======================================================================
2898
======== Function 68, subfunction 12 - allocate memory block. ========
2939
======== Function 68, subfunction 12 - allocate memory block. ========
2899
======================================================================
2940
======================================================================
2900
Parameters:
2941
Parameters:
2901
  * eax = 68 - function number
2942
  * eax = 68 - function number
2902
  * ebx = 12 - subfunction number
2943
  * ebx = 12 - subfunction number
2903
  * ecx = required size in bytes
2944
  * ecx = required size in bytes
2904
Returned value:
2945
Returned value:
2905
  * eax = pointer to the allocated block
2946
  * eax = pointer to the allocated block
2906
Remarks:
2947
Remarks:
2907
  * Before this call one must initialize process heap by call to
2948
  * Before this call one must initialize process heap by call to
2908
    subfunction 11.
2949
    subfunction 11.
2909
  * The function allocates an integer number of pages (4 Kb) in such
2950
  * The function allocates an integer number of pages (4 Kb) in such
2910
    way that the real size of allocated block is more than or equal to
2951
    way that the real size of allocated block is more than or equal to
2911
    requested size.
2952
    requested size.
2912
 
2953
 
2913
======================================================================
2954
======================================================================
2914
========== Function 68, subfunction 13 - free memory block. ==========
2955
========== Function 68, subfunction 13 - free memory block. ==========
2915
======================================================================
2956
======================================================================
2916
Parameters:
2957
Parameters:
2917
  * eax = 68 - function number
2958
  * eax = 68 - function number
2918
  * ebx = 13 - subfunction number
2959
  * ebx = 13 - subfunction number
2919
  * ecx = pointer to the memory block
2960
  * ecx = pointer to the memory block
2920
Returned value:
2961
Returned value:
2921
  * eax = 1 - success
2962
  * eax = 1 - success
2922
  * eax = 0 - failed
2963
  * eax = 0 - failed
2923
Remarks:
2964
Remarks:
2924
  * The memory block must have been allocated by subfunction 12
2965
  * The memory block must have been allocated by subfunction 12
2925
    or subfunction 20.
2966
    or subfunction 20.
2926
 
2967
 
2927
======================================================================
2968
======================================================================
2928
===================== Function 68, subfunction 14 ====================
2969
===================== Function 68, subfunction 14 ====================
2929
============ Wait for signal from another program/driver. ============
2970
============ Wait for signal from another program/driver. ============
2930
======================================================================
2971
======================================================================
2931
Parameters:
2972
Parameters:
2932
  * eax = 68 - function number
2973
  * eax = 68 - function number
2933
  * ebx = 14 - subfunction number
2974
  * ebx = 14 - subfunction number
2934
  * ecx = pointer to the buffer for information (24 bytes)
2975
  * ecx = pointer to the buffer for information (24 bytes)
2935
Returned value:
2976
Returned value:
2936
  * buffer pointed to by ecx contains the following information:
2977
  * buffer pointed to by ecx contains the following information:
2937
    * +0: dword: identifier for following data of signal
2978
    * +0: dword: identifier for following data of signal
2938
    * +4: dword: data of signal (20 bytes), format of which is defined
2979
    * +4: dword: data of signal (20 bytes), format of which is defined
2939
          by the first dword
2980
          by the first dword
2940
 
2981
 
2941
======================================================================
2982
======================================================================
2942
============= Function 68, subfunction 16 - load driver. =============
2983
============= Function 68, subfunction 16 - load driver. =============
2943
======================================================================
2984
======================================================================
2944
Parameters:
2985
Parameters:
2945
  * eax = 68 - function number
2986
  * eax = 68 - function number
2946
  * ebx = 16 - subfunction number
2987
  * ebx = 16 - subfunction number
2947
  * ecx = pointer to ASCIIZ-string with driver name
2988
  * ecx = pointer to ASCIIZ-string with driver name
2948
Returned value:
2989
Returned value:
2949
  * eax = 0 - failed
2990
  * eax = 0 - failed
2950
  * otherwise eax = driver handle
2991
  * otherwise eax = driver handle
2951
Remarks:
2992
Remarks:
2952
  * If the driver was not loaded yet, it is loaded;
2993
  * If the driver was not loaded yet, it is loaded;
2953
    if the driver was loaded yet, nothing happens.
2994
    if the driver was loaded yet, nothing happens.
2954
  * Driver name is case-sensitive.
2995
  * Driver name is case-sensitive.
2955
    Maximum length of the name is 16 characters, including
2996
    Maximum length of the name is 16 characters, including
2956
    terminating null character, the rest is ignored.
2997
    terminating null character, the rest is ignored.
2957
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
2998
  * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
2958
 
2999
 
2959
======================================================================
3000
======================================================================
2960
============ Function 68, subfunction 17 - driver control. ===========
3001
============ Function 68, subfunction 17 - driver control. ===========
2961
======================================================================
3002
======================================================================
2962
Parameters:
3003
Parameters:
2963
  * eax = 68 - function number
3004
  * eax = 68 - function number
2964
  * ebx = 17 - subfunction number
3005
  * ebx = 17 - subfunction number
2965
  * ecx = pointer to the control structure:
3006
  * ecx = pointer to the control structure:
2966
    * +0: dword: handle of driver
3007
    * +0: dword: handle of driver
2967
    * +4: dword: code of driver function
3008
    * +4: dword: code of driver function
2968
    * +8: dword: pointer to input data
3009
    * +8: dword: pointer to input data
2969
    * +12 = +0xC: dword: size of input data
3010
    * +12 = +0xC: dword: size of input data
2970
    * +16 = +0x10: dword: pointer to output data
3011
    * +16 = +0x10: dword: pointer to output data
2971
    * +20 = +0x14: dword: size of output data
3012
    * +20 = +0x14: dword: size of output data
2972
Returned value:
3013
Returned value:
2973
  * eax = determined by driver
3014
  * eax = determined by driver
2974
Remarks:
3015
Remarks:
2975
  * Function codes and the structure of input/output data
3016
  * Function codes and the structure of input/output data
2976
    are defined by driver.
3017
    are defined by driver.
2977
  * Previously one must obtain driver handle by subfunction 16.
3018
  * Previously one must obtain driver handle by subfunction 16.
2978
 
3019
 
2979
======================================================================
3020
======================================================================
2980
=============== Function 68, subfunction 19 - load DLL. ==============
3021
=============== Function 68, subfunction 19 - load DLL. ==============
2981
======================================================================
3022
======================================================================
2982
Parameters:
3023
Parameters:
2983
  * eax = 68 - function number
3024
  * eax = 68 - function number
2984
  * ebx = 19 - subfunction number
3025
  * ebx = 19 - subfunction number
2985
  * ecx = pointer to ASCIIZ-string with the full path to DLL
3026
  * ecx = pointer to ASCIIZ-string with the full path to DLL
2986
Returned value:
3027
Returned value:
2987
  * eax = 0 - failed
3028
  * eax = 0 - failed
2988
  * otherwise eax = pointer to DLL export table
3029
  * otherwise eax = pointer to DLL export table
2989
Remarks:
3030
Remarks:
2990
  * Export table is an array of structures of 2 dword's, terminated
3031
  * Export table is an array of structures of 2 dword's, terminated
2991
    by zero. The first dword in structure points to function name,
3032
    by zero. The first dword in structure points to function name,
2992
    the second dword contains address of function.
3033
    the second dword contains address of function.
2993
 
3034
 
2994
======================================================================
3035
======================================================================
2995
======= Function 68, subfunction 20 - reallocate memory block. =======
3036
======= Function 68, subfunction 20 - reallocate memory block. =======
2996
======================================================================
3037
======================================================================
2997
Parameters:
3038
Parameters:
2998
  * eax = 68 - function number
3039
  * eax = 68 - function number
2999
  * ebx = 20 - subfunction number
3040
  * ebx = 20 - subfunction number
3000
  * ecx = new size in bytes
3041
  * ecx = new size in bytes
3001
  * edx = pointer to already allocated block
3042
  * edx = pointer to already allocated block
3002
Returned value:
3043
Returned value:
3003
  * eax = pointer to the reallocated block, 0 = error
3044
  * eax = pointer to the reallocated block, 0 = error
3004
Remarks:
3045
Remarks:
3005
  * Before this call one must initialize process heap by call to
3046
  * Before this call one must initialize process heap by call to
3006
    subfunction 11.
3047
    subfunction 11.
3007
  * The function allocates an integer number of pages (4 Kb) in such
3048
  * The function allocates an integer number of pages (4 Kb) in such
3008
    way that the real size of allocated block is more than or equal to
3049
    way that the real size of allocated block is more than or equal to
3009
    requested size.
3050
    requested size.
3010
  * If edx=0, the function call is equivalent to memory allocation
3051
  * If edx=0, the function call is equivalent to memory allocation
3011
    with subfunction 12. Otherwise the block at edx
3052
    with subfunction 12. Otherwise the block at edx
3012
    must be allocated earlier with subfunction 12 or this subfunction.
3053
    must be allocated earlier with subfunction 12 or this subfunction.
3013
  * If ecx=0, the function frees memory block at edx and returns 0.
3054
  * If ecx=0, the function frees memory block at edx and returns 0.
3014
  * The contents of the block are unchanged up to the shorter of
3055
  * The contents of the block are unchanged up to the shorter of
3015
    the new and old sizes.
3056
    the new and old sizes.
3016
 
3057
 
3017
======================================================================
3058
======================================================================
3018
=========== Function 68, subfunction 21 - load driver PE. ============
3059
=========== Function 68, subfunction 21 - load driver PE. ============
3019
======================================================================
3060
======================================================================
3020
Parameters:
3061
Parameters:
3021
  * eax = 68 - function number
3062
  * eax = 68 - function number
3022
  * ebx = 21 - subfunction number
3063
  * ebx = 21 - subfunction number
3023
  * ecx = pointer to ASCIIZ-string with driver name
3064
  * ecx = pointer to ASCIIZ-string with driver name
3024
  * edx = pointer to command line
3065
  * edx = pointer to command line
3025
Returned value:
3066
Returned value:
3026
  * eax = 0 - failed
3067
  * eax = 0 - failed
3027
  * otherwise eax = driver handle
3068
  * otherwise eax = driver handle
3028
Remarks:
3069
Remarks:
3029
  * If the driver was not loaded yet, it is loaded;
3070
  * If the driver was not loaded yet, it is loaded;
3030
    if the driver was loaded yet, nothing happens.
3071
    if the driver was loaded yet, nothing happens.
3031
 
3072
 
3032
======================================================================
3073
======================================================================
3033
======== Function 68, subfunction 22 - open named memory area. =======
3074
======== Function 68, subfunction 22 - open named memory area. =======
3034
======================================================================
3075
======================================================================
3035
Parameters:
3076
Parameters:
3036
  * eax = 68 - function number
3077
  * eax = 68 - function number
3037
  * ebx = 22 - subfunction number
3078
  * ebx = 22 - subfunction number
3038
  * ecx = area name. Maximum of 31 characters with terminating zero
3079
  * ecx = area name. Maximum of 31 characters with terminating zero
3039
  * edx = area size in bytes for SHM_CREATE and SHM_OPEN_ALWAYS
3080
  * edx = area size in bytes for SHM_CREATE and SHM_OPEN_ALWAYS
3040
  * esi = flags for open and access:
3081
  * esi = flags for open and access:
3041
    * SHM_OPEN        = 0x00 - open existing memory area. If an area
3082
    * SHM_OPEN        = 0x00 - open existing memory area. If an area
3042
                          with such name does not exist, the function
3083
                          with such name does not exist, the function
3043
                          will return error code 5.
3084
                          will return error code 5.
3044
    * SHM_OPEN_ALWAYS = 0x04 - open existing or create new
3085
    * SHM_OPEN_ALWAYS = 0x04 - open existing or create new
3045
                          memory area.
3086
                          memory area.
3046
    * SHM_CREATE      = 0x08 - create new memory area. If an area
3087
    * SHM_CREATE      = 0x08 - create new memory area. If an area
3047
                          with such name already exists, the function
3088
                          with such name already exists, the function
3048
                          will return error code 10.
3089
                          will return error code 10.
3049
    * SHM_READ        = 0x00 - only read access
3090
    * SHM_READ        = 0x00 - only read access
3050
    * SHM_WRITE       = 0x01 - read and write access
3091
    * SHM_WRITE       = 0x01 - read and write access
3051
Returned value:
3092
Returned value:
3052
  * eax = pointer to memory area, 0 if error has occured
3093
  * eax = pointer to memory area, 0 if error has occured
3053
  * if new area is created (SHM_CREATE or SHM_OPEN_ALWAYS):
3094
  * if new area is created (SHM_CREATE or SHM_OPEN_ALWAYS):
3054
    edx = 0 - success, otherwise - error code
3095
    edx = 0 - success, otherwise - error code
3055
  * if existing area is opened (SHM_OPEN or SHM_OPEN_ALWAYS):
3096
  * if existing area is opened (SHM_OPEN or SHM_OPEN_ALWAYS):
3056
    edx = error code (if eax=0) or area size in bytes
3097
    edx = error code (if eax=0) or area size in bytes
3057
Error codes:
3098
Error codes:
3058
  * E_NOTFOUND = 5
3099
  * E_NOTFOUND = 5
3059
  * E_ACCESS = 10
3100
  * E_ACCESS = 10
3060
  * E_NOMEM = 30
3101
  * E_NOMEM = 30
3061
  * E_PARAM = 33
3102
  * E_PARAM = 33
3062
Remarks:
3103
Remarks:
3063
  * Before this call one must initialize process heap by call to
3104
  * Before this call one must initialize process heap by call to
3064
    subfunction 11.
3105
    subfunction 11.
3065
  * If a new area is created, access flags set maximal rights
3106
  * If a new area is created, access flags set maximal rights
3066
    for other processes. An attempt from other process to open
3107
    for other processes. An attempt from other process to open
3067
    with denied rights will fail with error code E_ACCESS.
3108
    with denied rights will fail with error code E_ACCESS.
3068
  * The process which has created an area always has write access.
3109
  * The process which has created an area always has write access.
3069
 
3110
 
3070
======================================================================
3111
======================================================================
3071
======= Function 68, subfunction 23 - close named memory area. =======
3112
======= Function 68, subfunction 23 - close named memory area. =======
3072
======================================================================
3113
======================================================================
3073
Parameters:
3114
Parameters:
3074
  * eax = 68 - function number
3115
  * eax = 68 - function number
3075
  * ebx = 23 - subfunction number
3116
  * ebx = 23 - subfunction number
3076
  * ecx = area name. Maximum of 31 characters with terminating zero
3117
  * ecx = area name. Maximum of 31 characters with terminating zero
3077
Returned value:
3118
Returned value:
3078
  * eax destroyed
3119
  * eax destroyed
3079
Remarks:
3120
Remarks:
3080
  * A memory area is physically freed (with deleting all data and
3121
  * A memory area is physically freed (with deleting all data and
3081
    freeing physical memory), when all threads which have opened
3122
    freeing physical memory), when all threads which have opened
3082
    this area will close it.
3123
    this area will close it.
3083
  * When thread is terminating, all opened by it areas are closed.
3124
  * When thread is terminating, all opened by it areas are closed.
3084
 
3125
 
3085
======================================================================
3126
======================================================================
3086
======== Function 68, subfunction 24 - set exception handler. ========
3127
======== Function 68, subfunction 24 - set exception handler. ========
3087
======================================================================
3128
======================================================================
3088
Parameters:
3129
Parameters:
3089
  * eax = 68 - function number
3130
  * eax = 68 - function number
3090
  * ebx = 24 - subfunction number
3131
  * ebx = 24 - subfunction number
3091
  * ecx = address of the new exception handler
3132
  * ecx = address of the new exception handler
3092
  * edx = the mask of handled exceptions
3133
  * edx = the mask of handled exceptions
3093
Returned value:
3134
Returned value:
3094
  * eax = address of the old exception handler (0, if it was not set)
3135
  * eax = address of the old exception handler (0, if it was not set)
3095
  * ebx = the old mask of handled exceptions
3136
  * ebx = the old mask of handled exceptions
3096
Remarks:
3137
Remarks:
3097
  * Bit number in mask of exceptions corresponds to exception number
3138
  * Bit number in mask of exceptions corresponds to exception number
3098
    in CPU-specification (Intel-PC). For example, FPU exceptions have
3139
    in CPU-specification (Intel-PC). For example, FPU exceptions have
3099
    number 16 (#MF), and SSE exceptions - 19 (#XF).
3140
    number 16 (#MF), and SSE exceptions - 19 (#XF).
3100
  * The current implementation ignores the inquiry for hook of 7
3141
  * The current implementation ignores the inquiry for hook of 7
3101
    exception - the system handles #NM by its own.
3142
    exception - the system handles #NM by its own.
3102
  * The exception handler is called with exception number as first
3143
  * The exception handler is called with exception number as first
3103
    (and only) stack parameter. So, correct exit from the handler is
3144
    (and only) stack parameter. So, correct exit from the handler is
3104
    RET 4. It returns to the instruction, that caused the exception,
3145
    RET 4. It returns to the instruction, that caused the exception,
3105
    for faults, and to the next instruction for traps (see
3146
    for faults, and to the next instruction for traps (see
3106
    classification of exceptions in CPU specification).
3147
    classification of exceptions in CPU specification).
3107
  * When user handler receives control, the corresponding bit in
3148
  * When user handler receives control, the corresponding bit in
3108
    the exception mask is cleared. Raising this exception
3149
    the exception mask is cleared. Raising this exception
3109
    in consequence leads to default handling, that is,
3150
    in consequence leads to default handling, that is,
3110
    terminating the application in absence of debugger or
3151
    terminating the application in absence of debugger or
3111
    suspend with notification of debugger otherwise.
3152
    suspend with notification of debugger otherwise.
3112
  * After user handler completes critical operations, it can set
3153
  * After user handler completes critical operations, it can set
3113
    the corresponding bit in the exception mask with subfunction 25.
3154
    the corresponding bit in the exception mask with subfunction 25.
3114
    Also user handler is responsible for clearing exceptions flags in
3155
    Also user handler is responsible for clearing exceptions flags in
3115
    FPU and/or SSE.
3156
    FPU and/or SSE.
3116
 
3157
 
3117
======================================================================
3158
======================================================================
3118
====== Function 68, subfunction 25 - set FPU exception handler. ======
3159
====== Function 68, subfunction 25 - set FPU exception handler. ======
3119
======================================================================
3160
======================================================================
3120
Parameters:
3161
Parameters:
3121
  * eax = 68 - function number
3162
  * eax = 68 - function number
3122
  * ebx = 25 - subfunction number
3163
  * ebx = 25 - subfunction number
3123
  * ecx = signal number
3164
  * ecx = signal number
3124
  * edx = value of activity (0/1)
3165
  * edx = value of activity (0/1)
3125
Returned value:
3166
Returned value:
3126
  * eax = -1 - invalid signal number
3167
  * eax = -1 - invalid signal number
3127
  * otherwise eax = old value of activity for this signal (0/1)
3168
  * otherwise eax = old value of activity for this signal (0/1)
3128
Remarks:
3169
Remarks:
3129
  * In current implementation only mask for user excepton handler,
3170
  * In current implementation only mask for user excepton handler,
3130
    which has been previously set by subfunction 24,
3171
    which has been previously set by subfunction 24,
3131
    is changed. Signal number corresponds to exception number.
3172
    is changed. Signal number corresponds to exception number.
3132
 
3173
 
3133
======================================================================
3174
======================================================================
3134
====== Function 68, subfunction 26 - release memory pages ============
3175
====== Function 68, subfunction 26 - release memory pages ============
3135
======================================================================
3176
======================================================================
3136
Parameters:
3177
Parameters:
3137
  * eax = 68 - function number
3178
  * eax = 68 - function number
3138
  * ebx = 26 - subfunction number
3179
  * ebx = 26 - subfunction number
3139
  * ecx = pointer to the memory block, allocated by subfunction 12
3180
  * ecx = pointer to the memory block, allocated by subfunction 12
3140
  * edx = offset from the block beginnings
3181
  * edx = offset from the block beginnings
3141
  * esi = the size of the region of memory to release, in bytes
3182
  * esi = the size of the region of memory to release, in bytes
3142
Remarks:
3183
Remarks:
3143
  * function release range of pages from ecx+edx to ecx+edx+esi
3184
  * function release range of pages from ecx+edx to ecx+edx+esi
3144
    and set virtual memory into reserved state.
3185
    and set virtual memory into reserved state.
3145
 
3186
 
3146
======================================================================
3187
======================================================================
3147
========== Function 68, subfunction 27 - load file ===================
3188
========== Function 68, subfunction 27 - load file ===================
3148
======================================================================
3189
======================================================================
3149
Parameters:
3190
Parameters:
3150
  * eax = 68 - function number
3191
  * eax = 68 - function number
3151
  * ebx = 27 - subfunction number
3192
  * ebx = 27 - subfunction number
3152
  * ecx = pointer to ASCIIZ-string with the filename
3193
  * ecx = pointer to ASCIIZ-string with the filename
3153
Returned value:
3194
Returned value:
3154
  * eax = pointer to the loaded file, or zero
3195
  * eax = pointer to the loaded file, or zero
3155
  * edx = size of the loaded file, or zero
3196
  * edx = size of the loaded file, or zero
3156
Remarks:
3197
Remarks:
3157
  * function loads file and unpacks, if necessary
3198
  * function loads file and unpacks, if necessary
3158
 
3199
 
3159
======================================================================
3200
======================================================================
3160
====================== Function 69 - debugging. ======================
3201
====================== Function 69 - debugging. ======================
3161
======================================================================
3202
======================================================================
3162
A process can load other process as debugged by set of corresponding
3203
A process can load other process as debugged by set of corresponding
3163
bit by call to subfunction 7 of function 70.
3204
bit by call to subfunction 7 of function 70.
3164
A process can have only one debugger; one process can debug some
3205
A process can have only one debugger; one process can debug some
3165
others. The system notifies debugger on events occuring with
3206
others. The system notifies debugger on events occuring with
3166
debugged process. Messages are written to the buffer defined by
3207
debugged process. Messages are written to the buffer defined by
3167
subfunction 0.
3208
subfunction 0.
3168
Format of a message:
3209
Format of a message:
3169
  * +0: dword: message code
3210
  * +0: dword: message code
3170
  * +4: dword: PID of debugged process
3211
  * +4: dword: PID of debugged process
3171
  * +8: there can be additional data depending on message code
3212
  * +8: there can be additional data depending on message code
3172
Message codes:
3213
Message codes:
3173
  * 1 = exception
3214
  * 1 = exception
3174
    * in addition dword-number of the exception is given
3215
    * in addition dword-number of the exception is given
3175
    * process is suspended
3216
    * process is suspended
3176
  * 2 = process has terminated
3217
  * 2 = process has terminated
3177
    * comes at any termination: both through the system function -1,
3218
    * comes at any termination: both through the system function -1,
3178
      and at "murder" by any other process (including debugger itself)
3219
      and at "murder" by any other process (including debugger itself)
3179
  * 3 = debug exception int 1 = #DB
3220
  * 3 = debug exception int 1 = #DB
3180
    * in addition dword-image of the register DR6 is given:
3221
    * in addition dword-image of the register DR6 is given:
3181
      * bits 0-3: condition of the corresponding breakpoint (set by
3222
      * bits 0-3: condition of the corresponding breakpoint (set by
3182
        subfunction 9) is satisfied
3223
        subfunction 9) is satisfied
3183
      * bit 14: exception has occured because of the trace mode
3224
      * bit 14: exception has occured because of the trace mode
3184
        (flag TF is set TF)
3225
        (flag TF is set TF)
3185
    * process is suspended
3226
    * process is suspended
3186
When debugger terminates, all debugged processes are killed.
3227
When debugger terminates, all debugged processes are killed.
3187
If debugger does not want this, it must previously detach by
3228
If debugger does not want this, it must previously detach by
3188
subfunction 3.
3229
subfunction 3.
3189
 
3230
 
3190
All subfunctions are applicable only to processes/threads started
3231
All subfunctions are applicable only to processes/threads started
3191
from the current by function 70 with set debugging flag.
3232
from the current by function 70 with set debugging flag.
3192
Debugging of multithreaded programs is not supported yet.
3233
Debugging of multithreaded programs is not supported yet.
3193
The full list of subfunctions:
3234
The full list of subfunctions:
3194
  * subfunction 0 - define data area for debug messages
3235
  * subfunction 0 - define data area for debug messages
3195
  * subfunction 1 - get contents of registers of debugged thread
3236
  * subfunction 1 - get contents of registers of debugged thread
3196
  * subfunction 2 - set contents of registers of debugged thread
3237
  * subfunction 2 - set contents of registers of debugged thread
3197
  * subfunction 3 - detach from debugged process
3238
  * subfunction 3 - detach from debugged process
3198
  * subfunction 4 - suspend debugged thread
3239
  * subfunction 4 - suspend debugged thread
3199
  * subfunction 5 - resume debugged thread
3240
  * subfunction 5 - resume debugged thread
3200
  * subfunction 6 - read from the memory of debugged process
3241
  * subfunction 6 - read from the memory of debugged process
3201
  * subfunction 7 - write to the memory of debugged process
3242
  * subfunction 7 - write to the memory of debugged process
3202
  * subfunction 8 - terminate debugged thread
3243
  * subfunction 8 - terminate debugged thread
3203
  * subfunction 9 - set/clear hardware breakpoint
3244
  * subfunction 9 - set/clear hardware breakpoint
3204
 
3245
 
3205
======================================================================
3246
======================================================================
3206
= Function 69, subfunction 0 - define data area fror debug messages. =
3247
= Function 69, subfunction 0 - define data area fror debug messages. =
3207
======================================================================
3248
======================================================================
3208
Parameters:
3249
Parameters:
3209
  * eax = 69 - function number
3250
  * eax = 69 - function number
3210
  * ebx = 0 - subfunction number
3251
  * ebx = 0 - subfunction number
3211
  * ecx = pointer
3252
  * ecx = pointer
3212
Format of data area:
3253
Format of data area:
3213
  * +0: dword: N = buffer size (not including this header)
3254
  * +0: dword: N = buffer size (not including this header)
3214
  * +4: dword: occupied place
3255
  * +4: dword: occupied place
3215
  * +8: N*byte: buffer
3256
  * +8: N*byte: buffer
3216
Returned value:
3257
Returned value:
3217
  * function does not return value
3258
  * function does not return value
3218
Remarks:
3259
Remarks:
3219
  * If the size field is negative, the buffer is considered locked
3260
  * If the size field is negative, the buffer is considered locked
3220
    and at arrival of new message the system will wait.
3261
    and at arrival of new message the system will wait.
3221
    For synchronization frame all work with the buffer by operations
3262
    For synchronization frame all work with the buffer by operations
3222
    lock/unlock
3263
    lock/unlock
3223
    	neg	[bufsize]
3264
    	neg	[bufsize]
3224
  * Data in the buffer are considered as array of items with variable
3265
  * Data in the buffer are considered as array of items with variable
3225
    length - messages. Format of a message is explained in
3266
    length - messages. Format of a message is explained in
3226
    general description.
3267
    general description.
3227
 
3268
 
3228
======================================================================
3269
======================================================================
3229
===================== Function 69, subfunction 1 =====================
3270
===================== Function 69, subfunction 1 =====================
3230
============ Get contents of registers of debugged thread. ===========
3271
============ Get contents of registers of debugged thread. ===========
3231
======================================================================
3272
======================================================================
3232
Parameters:
3273
Parameters:
3233
  * eax = 69 - function number
3274
  * eax = 69 - function number
3234
  * ebx = 1 - subfunction number
3275
  * ebx = 1 - subfunction number
3235
  * ecx = thread identifier
3276
  * ecx = thread identifier
3236
  * edx = size of context structure, must be 0x28=40 bytes
3277
  * edx = size of context structure, must be 0x28=40 bytes
3237
  * esi = pointer to context structure
3278
  * esi = pointer to context structure
3238
Returned value:
3279
Returned value:
3239
  * function does not return value
3280
  * function does not return value
3240
Format of context structure: (FPU is not supported yet)
3281
Format of context structure: (FPU is not supported yet)
3241
  * +0: dword: eip
3282
  * +0: dword: eip
3242
  * +4: dword: eflags
3283
  * +4: dword: eflags
3243
  * +8: dword: eax
3284
  * +8: dword: eax
3244
  * +12 = +0xC: dword: ecx
3285
  * +12 = +0xC: dword: ecx
3245
  * +16 = +0x10: dword: edx
3286
  * +16 = +0x10: dword: edx
3246
  * +20 = +0x14: dword: ebx
3287
  * +20 = +0x14: dword: ebx
3247
  * +24 = +0x18: dword: esp
3288
  * +24 = +0x18: dword: esp
3248
  * +28 = +0x1C: dword: ebp
3289
  * +28 = +0x1C: dword: ebp
3249
  * +32 = +0x20: dword: esi
3290
  * +32 = +0x20: dword: esi
3250
  * +36 = +0x24: dword: edi
3291
  * +36 = +0x24: dword: edi
3251
Remarks:
3292
Remarks:
3252
  * If the thread executes code of ring-0, the function returns
3293
  * If the thread executes code of ring-0, the function returns
3253
    contents of registers of ring-3.
3294
    contents of registers of ring-3.
3254
  * Process must be loaded for debugging (as is shown in
3295
  * Process must be loaded for debugging (as is shown in
3255
    general description).
3296
    general description).
3256
 
3297
 
3257
======================================================================
3298
======================================================================
3258
===================== Function 69, subfunction 2 =====================
3299
===================== Function 69, subfunction 2 =====================
3259
============ Set contents of registers of debugged thread. ===========
3300
============ Set contents of registers of debugged thread. ===========
3260
======================================================================
3301
======================================================================
3261
Parameters:
3302
Parameters:
3262
  * eax = 69 - function number
3303
  * eax = 69 - function number
3263
  * ebx = 2 - subfunction number
3304
  * ebx = 2 - subfunction number
3264
  * ecx = thread identifier
3305
  * ecx = thread identifier
3265
  * edx = size of context structure, must be 0x28=40 bytes
3306
  * edx = size of context structure, must be 0x28=40 bytes
3266
Returned value:
3307
Returned value:
3267
  * function does not return value
3308
  * function does not return value
3268
Format of context structure is shown in the description of
3309
Format of context structure is shown in the description of
3269
subfunction 1.
3310
subfunction 1.
3270
Remarks:
3311
Remarks:
3271
  * If the thread executes code of ring-0, the function returns
3312
  * If the thread executes code of ring-0, the function returns
3272
    contents of registers of ring-3.
3313
    contents of registers of ring-3.
3273
  * Process must be loaded for debugging (as is shown in
3314
  * Process must be loaded for debugging (as is shown in
3274
    general description).
3315
    general description).
3275
 
3316
 
3276
======================================================================
3317
======================================================================
3277
===== Function 69, subfunction 3 - detach from debugged process. =====
3318
===== Function 69, subfunction 3 - detach from debugged process. =====
3278
======================================================================
3319
======================================================================
3279
Parameters:
3320
Parameters:
3280
  * eax = 69 - function number
3321
  * eax = 69 - function number
3281
  * ebx = 3 - subfunction number
3322
  * ebx = 3 - subfunction number
3282
  * ecx = identifier
3323
  * ecx = identifier
3283
Returned value:
3324
Returned value:
3284
  * function does not return value
3325
  * function does not return value
3285
Remarks:
3326
Remarks:
3286
  * If the process was suspended, it resumes execution.
3327
  * If the process was suspended, it resumes execution.
3287
 
3328
 
3288
======================================================================
3329
======================================================================
3289
======== Function 69, subfunction 4 - suspend debugged thread. =======
3330
======== Function 69, subfunction 4 - suspend debugged thread. =======
3290
======================================================================
3331
======================================================================
3291
Parameters:
3332
Parameters:
3292
  * eax = 69 - function number
3333
  * eax = 69 - function number
3293
  * ebx = 4 - subfunction number
3334
  * ebx = 4 - subfunction number
3294
  * ecx = thread identifier
3335
  * ecx = thread identifier
3295
Returned value:
3336
Returned value:
3296
  * function does not return value
3337
  * function does not return value
3297
Remarks:
3338
Remarks:
3298
  * Process must be loaded for debugging (as is shown in
3339
  * Process must be loaded for debugging (as is shown in
3299
    general description).
3340
    general description).
3300
 
3341
 
3301
======================================================================
3342
======================================================================
3302
======== Function 69, subfunction 5 - resume debugged thread. ========
3343
======== Function 69, subfunction 5 - resume debugged thread. ========
3303
======================================================================
3344
======================================================================
3304
Parameters:
3345
Parameters:
3305
  * eax = 69 - function number
3346
  * eax = 69 - function number
3306
  * ebx = 5 - subfunction number
3347
  * ebx = 5 - subfunction number
3307
  * ecx = thread identifier
3348
  * ecx = thread identifier
3308
Returned value:
3349
Returned value:
3309
  * function does not return value
3350
  * function does not return value
3310
Remarks:
3351
Remarks:
3311
  * Process must be loaded for debugging (as is shown in
3352
  * Process must be loaded for debugging (as is shown in
3312
    general description).
3353
    general description).
3313
 
3354
 
3314
======================================================================
3355
======================================================================
3315
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
3356
= Fucntion 69, subfunction 6 - read from memory of debugged process. =
3316
======================================================================
3357
======================================================================
3317
Parameters:
3358
Parameters:
3318
  * eax = 69 - function number
3359
  * eax = 69 - function number
3319
  * ebx = 6 - subfunction number
3360
  * ebx = 6 - subfunction number
3320
  * ecx = identifier
3361
  * ecx = identifier
3321
  * edx = number of bytes to read
3362
  * edx = number of bytes to read
3322
  * esi = address in the memory of debugged process
3363
  * esi = address in the memory of debugged process
3323
  * edi = pointer to buffer for data
3364
  * edi = pointer to buffer for data
3324
Returned value:
3365
Returned value:
3325
  * eax = -1 at an error (invalid PID or buffer)
3366
  * eax = -1 at an error (invalid PID or buffer)
3326
  * otherwise eax = number of read bytes (possibly, 0,
3367
  * otherwise eax = number of read bytes (possibly, 0,
3327
    if esi is too large)
3368
    if esi is too large)
3328
Remarks:
3369
Remarks:
3329
  * Process must be loaded for debugging (as is shown in
3370
  * Process must be loaded for debugging (as is shown in
3330
    general description).
3371
    general description).
3331
 
3372
 
3332
======================================================================
3373
======================================================================
3333
== Function 69, subfunction 7 - write to memory of debugged process. =
3374
== Function 69, subfunction 7 - write to memory of debugged process. =
3334
======================================================================
3375
======================================================================
3335
Parameters:
3376
Parameters:
3336
  * eax = 69 - function number
3377
  * eax = 69 - function number
3337
  * ebx = 7 - subfunction number
3378
  * ebx = 7 - subfunction number
3338
  * ecx = identifier
3379
  * ecx = identifier
3339
  * edx = number of bytes to write
3380
  * edx = number of bytes to write
3340
  * esi = address of memory in debugged process
3381
  * esi = address of memory in debugged process
3341
  * edi = pointer to data
3382
  * edi = pointer to data
3342
Returned value:
3383
Returned value:
3343
  * eax = -1 at an error (invalid PID or buffer)
3384
  * eax = -1 at an error (invalid PID or buffer)
3344
  * otherwise eax = number of written bytes (possibly, 0,
3385
  * otherwise eax = number of written bytes (possibly, 0,
3345
    if esi is too large)
3386
    if esi is too large)
3346
Remarks:
3387
Remarks:
3347
  * Process must be loaded for debugging (as is shown in
3388
  * Process must be loaded for debugging (as is shown in
3348
    general description).
3389
    general description).
3349
 
3390
 
3350
======================================================================
3391
======================================================================
3351
======= Function 69, subfunction 8 - terminate debugged thread. ======
3392
======= Function 69, subfunction 8 - terminate debugged thread. ======
3352
======================================================================
3393
======================================================================
3353
Parameters:
3394
Parameters:
3354
  * eax = 69 - function number
3395
  * eax = 69 - function number
3355
  * ebx = 8 - subfunction number
3396
  * ebx = 8 - subfunction number
3356
  * ecx = identifier
3397
  * ecx = identifier
3357
Returned value:
3398
Returned value:
3358
  * function does not return value
3399
  * function does not return value
3359
Remarks:
3400
Remarks:
3360
  * Process must be loaded for debugging (as is shown in
3401
  * Process must be loaded for debugging (as is shown in
3361
    general description).
3402
    general description).
3362
  * The function is similar to subfunction 2 of function 18
3403
  * The function is similar to subfunction 2 of function 18
3363
    with two differences: it requires first remark and
3404
    with two differences: it requires first remark and
3364
    accepts PID rather than slot number.
3405
    accepts PID rather than slot number.
3365
 
3406
 
3366
======================================================================
3407
======================================================================
3367
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
3408
===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
3368
======================================================================
3409
======================================================================
3369
Parameters:
3410
Parameters:
3370
  * eax = 69 - function number
3411
  * eax = 69 - function number
3371
  * ebx = 9 - subfunction number
3412
  * ebx = 9 - subfunction number
3372
  * ecx = thread identifier
3413
  * ecx = thread identifier
3373
  * dl = index of breakpoint, from 0 to 3 inclusively
3414
  * dl = index of breakpoint, from 0 to 3 inclusively
3374
  * dh = flags:
3415
  * dh = flags:
3375
    * if high bit is cleared - set breakpoint:
3416
    * if high bit is cleared - set breakpoint:
3376
      * bits 0-1 - condition:
3417
      * bits 0-1 - condition:
3377
        * 00 = breakpoint on execution
3418
        * 00 = breakpoint on execution
3378
        * 01 = breakpoint on read
3419
        * 01 = breakpoint on read
3379
        * 11 = breakpoint on read/write
3420
        * 11 = breakpoint on read/write
3380
      * bits 2-3 - length; for breakpoints on exception it must be
3421
      * bits 2-3 - length; for breakpoints on exception it must be
3381
        00, otherwise one of
3422
        00, otherwise one of
3382
        * 00 = byte
3423
        * 00 = byte
3383
        * 01 = word
3424
        * 01 = word
3384
        * 11 = dword
3425
        * 11 = dword
3385
      * esi = breakpoint address; must be aligned according to
3426
      * esi = breakpoint address; must be aligned according to
3386
        the length (i.e. must be even for word breakpoints,
3427
        the length (i.e. must be even for word breakpoints,
3387
        divisible by 4 for dword)
3428
        divisible by 4 for dword)
3388
    * if high bit is set - clear breakpoint
3429
    * if high bit is set - clear breakpoint
3389
Returned value:
3430
Returned value:
3390
  * eax = 0 - success
3431
  * eax = 0 - success
3391
  * eax = 1 - error in the input data
3432
  * eax = 1 - error in the input data
3392
  * eax = 2 - (reserved, is never returned in the current
3433
  * eax = 2 - (reserved, is never returned in the current
3393
    implementation) a global breakpoint with that index is already set
3434
    implementation) a global breakpoint with that index is already set
3394
Remarks:
3435
Remarks:
3395
  * Process must be loaded for debugging (as is shown in
3436
  * Process must be loaded for debugging (as is shown in
3396
    general description).
3437
    general description).
3397
  * Hardware breakpoints are implemented through DRx-registers of
3438
  * Hardware breakpoints are implemented through DRx-registers of
3398
    the processor, all limitations results from this.
3439
    the processor, all limitations results from this.
3399
  * The function can reinstall the breakpoint, previously set
3440
  * The function can reinstall the breakpoint, previously set
3400
    by it (and it does not inform on this).
3441
    by it (and it does not inform on this).
3401
    Carry on the list of set breakpoints in the debugger.
3442
    Carry on the list of set breakpoints in the debugger.
3402
  * Breakpoints generate debug exception #DB, on which the system
3443
  * Breakpoints generate debug exception #DB, on which the system
3403
    notifies debugger.
3444
    notifies debugger.
3404
  * Breakpoints on write and read/write act after
3445
  * Breakpoints on write and read/write act after
3405
    execution of the caused it instruction.
3446
    execution of the caused it instruction.
3406
 
3447
 
3407
======================================================================
3448
======================================================================
3408
==== Function 70 - work with file system with long names support. ====
3449
==== Function 70 - work with file system with long names support. ====
3409
======================================================================
3450
======================================================================
3410
Parameters:
3451
Parameters:
3411
  * eax = 70
3452
  * eax = 70
3412
  * ebx = pointer to the information structure
3453
  * ebx = pointer to the information structure
3413
Returned value:
3454
Returned value:
3414
  * eax = 0 - success; otherwise file system error code
3455
  * eax = 0 - success; otherwise file system error code
3415
  * some subfunctions return value in other registers too
3456
  * some subfunctions return value in other registers too
3416
General format of the information structure:
3457
General format of the information structure:
3417
  * +0: dword: subfunction number
3458
  * +0: dword: subfunction number
3418
  * +4: dword: file offset
3459
  * +4: dword: file offset
3419
  * +8: dword: high dword of offset (must be 0) or flags field
3460
  * +8: dword: high dword of offset (must be 0) or flags field
3420
  * +12 = +0xC: dword: size
3461
  * +12 = +0xC: dword: size
3421
  * +16 = +0x10: dword: pointer to data
3462
  * +16 = +0x10: dword: pointer to data
3422
  * +20 = +0x14: n db: ASCIIZ-string with the filename
3463
  * +20 = +0x14: n db: ASCIIZ-string with the filename
3423
    or
3464
    or
3424
  * +20 = +0x14: db 0
3465
  * +20 = +0x14: db 0
3425
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
3466
  * +21 = +0x15: dd pointer to ASCIIZ-string with the filename
3426
Specifications - in documentation on the appropriate subfunction.
3467
Specifications - in documentation on the appropriate subfunction.
3427
Filename is case-insensitive. Russian letters must be written in
3468
Filename is case-insensitive. Russian letters must be written in
3428
the encoding cp866 (DOS).
3469
the encoding cp866 (DOS).
3429
Format of filename:
3470
Format of filename:
3430
/base/number/dir1/dir2/.../dirn/file,
3471
/base/number/dir1/dir2/.../dirn/file,
3431
where /base/number identifies device, on which file is located:
3472
where /base/number identifies device, on which file is located:
3432
one of
3473
one of
3433
  * /RD/1 = /RAMDISK/1 to access ramdisk
3474
  * /RD/1 = /RAMDISK/1 to access ramdisk
3434
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
3475
  * /FD/1 = /FLOPPYDISK/1 to access first floppy drive,
3435
    /FD/2 = /FLOPPYDISK/2 to access second one
3476
    /FD/2 = /FLOPPYDISK/2 to access second one
3436
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
3477
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices
3437
    IDE0 (Primary Master), IDE1 (Primary Slave),
3478
    IDE0 (Primary Master), IDE1 (Primary Slave),
3438
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
3479
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
3439
    x - partition number on the selected hard drive, varies from 1
3480
    x - partition number on the selected hard drive, varies from 1
3440
    to 255 (on each hard drive the indexing starts from 1)
3481
    to 255 (on each hard drive the indexing starts from 1)
3441
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
3482
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 to access accordingly to
3442
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
3483
    CD on IDE0 (Primary Master), IDE1 (Primary Slave),
3443
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
3484
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
3444
  * /SYS means system folder; with the usual boot (from floppy)
3485
  * /SYS means system folder; with the usual boot (from floppy)
3445
    is equivalent to /RD/1
3486
    is equivalent to /RD/1
3446
Examples:
3487
Examples:
3447
  * '/rd/1/kernel.asm',0
3488
  * '/rd/1/kernel.asm',0
3448
  * '/HD0/1/kernel.asm',0
3489
  * '/HD0/1/kernel.asm',0
3449
  * '/hd0/2/menuet/pics/tanzania.bmp',0
3490
  * '/hd0/2/menuet/pics/tanzania.bmp',0
3450
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
3491
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
3451
  * '/sys/MySuperApp.ini',0
3492
  * '/sys/MySuperApp.ini',0
3452
Also function supports relative names.  If the path begins not
3493
Also function supports relative names.  If the path begins not
3453
with '/', it is considered relative to a current folder. To get or
3494
with '/', it is considered relative to a current folder. To get or
3454
set a current folder, use the function 30.
3495
set a current folder, use the function 30.
3455
 
3496
 
3456
Available subfunctions:
3497
Available subfunctions:
3457
  * subfunction 0 - read file
3498
  * subfunction 0 - read file
3458
  * subfunction 1 - read folder
3499
  * subfunction 1 - read folder
3459
  * subfunction 2 - create/rewrite file
3500
  * subfunction 2 - create/rewrite file
3460
  * subfunction 3 - write to existing file
3501
  * subfunction 3 - write to existing file
3461
  * subfunction 4 - set file size
3502
  * subfunction 4 - set file size
3462
  * subfunction 5 - get attributes of file/folder
3503
  * subfunction 5 - get attributes of file/folder
3463
  * subfunction 6 - set attributes of file/folder
3504
  * subfunction 6 - set attributes of file/folder
3464
  * subfunction 7 - start application
3505
  * subfunction 7 - start application
3465
  * subfunction 8 - delete file/folder
3506
  * subfunction 8 - delete file/folder
3466
  * subfunction 9 - create folder
3507
  * subfunction 9 - create folder
3467
For CD-drives due to hardware limitations only subfunctions
3508
For CD-drives due to hardware limitations only subfunctions
3468
0,1,5 and 7 are available, other subfunctions return error
3509
0,1,5 and 7 are available, other subfunctions return error
3469
with code 2.
3510
with code 2.
3470
At the first call of subfunctions 0,1,5,7 to ATAPI devices
3511
At the first call of subfunctions 0,1,5,7 to ATAPI devices
3471
(CD and DVD) the manual control of tray is locked due to caching
3512
(CD and DVD) the manual control of tray is locked due to caching
3472
drive data. Unlocking is made when subfunction 4 of function 24
3513
drive data. Unlocking is made when subfunction 4 of function 24
3473
is called for corresponding device.
3514
is called for corresponding device.
3474
 
3515
 
3475
======================================================================
3516
======================================================================
3476
=== Function 70, subfunction 0 - read file with long names support. ==
3517
=== Function 70, subfunction 0 - read file with long names support. ==
3477
======================================================================
3518
======================================================================
3478
Parameters:
3519
Parameters:
3479
  * eax = 70 - function number
3520
  * eax = 70 - function number
3480
  * ebx = pointer to the information structure
3521
  * ebx = pointer to the information structure
3481
Format of the information structure:
3522
Format of the information structure:
3482
  * +0: dword: 0 = subfunction number
3523
  * +0: dword: 0 = subfunction number
3483
  * +4: dword: file offset (in bytes)
3524
  * +4: dword: file offset (in bytes)
3484
  * +8: dword: 0 (reserved for high dword of offset)
3525
  * +8: dword: 0 (reserved for high dword of offset)
3485
  * +12 = +0xC: dword: number of bytes to read
3526
  * +12 = +0xC: dword: number of bytes to read
3486
  * +16 = +0x10: dword: pointer to buffer for data
3527
  * +16 = +0x10: dword: pointer to buffer for data
3487
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
3528
  * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are
3488
    given in the general description
3529
    given in the general description
3489
    or
3530
    or
3490
  * +20 = +0x14: db 0
3531
  * +20 = +0x14: db 0
3491
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
3532
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
3492
Returned value:
3533
Returned value:
3493
  * eax = 0 - success, otherwise file system error code
3534
  * eax = 0 - success, otherwise file system error code
3494
  * ebx = number of read bytes or -1=0xffffffff if file was not found
3535
  * ebx = number of read bytes or -1=0xffffffff if file was not found
3495
Remarks:
3536
Remarks:
3496
  * If file was ended before last requested block was read,
3537
  * If file was ended before last requested block was read,
3497
    the function will read as many as it can, and after that return
3538
    the function will read as many as it can, and after that return
3498
    eax=6 (EOF).
3539
    eax=6 (EOF).
3499
  * The function does not allow to read folder (returns eax=10,
3540
  * The function does not allow to read folder (returns eax=10,
3500
    access denied).
3541
    access denied).
3501
 
3542
 
3502
======================================================================
3543
======================================================================
3503
== Function 70, subfunction 1 - read folder with long names support. =
3544
== Function 70, subfunction 1 - read folder with long names support. =
3504
======================================================================
3545
======================================================================
3505
Parameters:
3546
Parameters:
3506
  * eax = 70 - function number
3547
  * eax = 70 - function number
3507
  * ebx = pointer to the information structure
3548
  * ebx = pointer to the information structure
3508
Format of the information structure:
3549
Format of the information structure:
3509
  * +0: dword: 1 = subfunction number
3550
  * +0: dword: 1 = subfunction number
3510
  * +4: dword: index of starting block (beginning from 0)
3551
  * +4: dword: index of starting block (beginning from 0)
3511
  * +8: dword: flags field:
3552
  * +8: dword: flags field:
3512
    * bit 0 (mask 1): in what format to return names,
3553
    * bit 0 (mask 1): in what format to return names,
3513
      0=ANSI, 1=UNICODE
3554
      0=ANSI, 1=UNICODE
3514
    * other bits are reserved and must be set to 0 for the future
3555
    * other bits are reserved and must be set to 0 for the future
3515
      compatibility
3556
      compatibility
3516
  * +12 = +0xC: dword: number of blocks to read
3557
  * +12 = +0xC: dword: number of blocks to read
3517
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
3558
  * +16 = +0x10: dword: pointer to buffer for data, buffer size
3518
    must be not less than 32 + [+12]*560 bytes
3559
    must be not less than 32 + [+12]*560 bytes
3519
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
3560
  * +20 = +0x14: ASCIIZ-name of folder, the rules of names forming are
3520
    given in the general description
3561
    given in the general description
3521
    or
3562
    or
3522
  * +20 = +0x14: db 0
3563
  * +20 = +0x14: db 0
3523
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
3564
  * +21 = +0x15: dd pointer to ASCIIZ-string with file name
3524
Returned value:
3565
Returned value:
3525
  * eax = 0 - success, otherwise file system error code
3566
  * eax = 0 - success, otherwise file system error code
3526
  * ebx = number of files, information on which was written to
3567
  * ebx = number of files, information on which was written to
3527
    the buffer, or -1=0xffffffff, if folder was not found
3568
    the buffer, or -1=0xffffffff, if folder was not found
3528
Structure of the buffer:
3569
Structure of the buffer:
3529
  * +0: 32*byte: header
3570
  * +0: 32*byte: header
3530
  * +32 = +0x20: n1*byte: block with information on file 1
3571
  * +32 = +0x20: n1*byte: block with information on file 1
3531
  * +32+n1: n2*byte: block with information on file 2
3572
  * +32+n1: n2*byte: block with information on file 2
3532
  * ...
3573
  * ...
3533
Structure of header:
3574
Structure of header:
3534
  * +0: dword: version of structure (current is 1)
3575
  * +0: dword: version of structure (current is 1)
3535
  * +4: dword: number of placed blocks; is not greater than requested
3576
  * +4: dword: number of placed blocks; is not greater than requested
3536
    in the field +12 of information structure; can be less, if
3577
    in the field +12 of information structure; can be less, if
3537
    there are no more files in folder (the same as in ebx)
3578
    there are no more files in folder (the same as in ebx)
3538
  * +8: dword: total number of files in folder
3579
  * +8: dword: total number of files in folder
3539
  * +12 = +0xC: 20*byte: reserved (zeroed)
3580
  * +12 = +0xC: 20*byte: reserved (zeroed)
3540
Structure of block of data for folder entry (BDFE):
3581
Structure of block of data for folder entry (BDFE):
3541
  * +0: dword: attributes of file:
3582
  * +0: dword: attributes of file:
3542
    * bit 0 (mask 1): file is read-only
3583
    * bit 0 (mask 1): file is read-only
3543
    * bit 1 (mask 2): file is hidden
3584
    * bit 1 (mask 2): file is hidden
3544
    * bit 2 (mask 4): file is system
3585
    * bit 2 (mask 4): file is system
3545
    * bit 3 (mask 8): this is not a file but volume label
3586
    * bit 3 (mask 8): this is not a file but volume label
3546
      (for one partition meets no more than once and
3587
      (for one partition meets no more than once and
3547
      only in root folder)
3588
      only in root folder)
3548
    * bit 4 (mask 0x10): this is a folder
3589
    * bit 4 (mask 0x10): this is a folder
3549
    * bit 5 (mask 0x20): file was not archived - many archivation
3590
    * bit 5 (mask 0x20): file was not archived - many archivation
3550
      programs have an option to archive only files with this bit set,
3591
      programs have an option to archive only files with this bit set,
3551
      and after archiving this bit is cleared - it can be useful
3592
      and after archiving this bit is cleared - it can be useful
3552
      for automatically creating of backup-archives as at writing
3593
      for automatically creating of backup-archives as at writing
3553
      this bit is usually set
3594
      this bit is usually set
3554
  * +4: byte: type of name data:
3595
  * +4: byte: type of name data:
3555
    (coincides with bit 0 of flags in the information structure)
3596
    (coincides with bit 0 of flags in the information structure)
3556
    * 0 = ASCII = 1-byte representation of each character
3597
    * 0 = ASCII = 1-byte representation of each character
3557
    * 1 = UNICODE = 2-byte representation of each character
3598
    * 1 = UNICODE = 2-byte representation of each character
3558
  * +5: 3*byte: reserved (zero)
3599
  * +5: 3*byte: reserved (zero)
3559
  * +8: 4*byte: time of file creation
3600
  * +8: 4*byte: time of file creation
3560
  * +12 = +0xC: 4*byte: date of file creation
3601
  * +12 = +0xC: 4*byte: date of file creation
3561
  * +16 = +0x10: 4*byte: time of last access (read or write)
3602
  * +16 = +0x10: 4*byte: time of last access (read or write)
3562
  * +20 = +0x14: 4*byte: date of last access
3603
  * +20 = +0x14: 4*byte: date of last access
3563
  * +24 = +0x18: 4*byte: time of last modification
3604
  * +24 = +0x18: 4*byte: time of last modification
3564
  * +28 = +0x1C: 4*byte: date of last modification
3605
  * +28 = +0x1C: 4*byte: date of last modification
3565
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
3606
  * +32 = +0x20: qword: file size in bytes (up to 16777216 Tb)
3566
  * +40 = +0x28: name
3607
  * +40 = +0x28: name
3567
    * for ASCII format: maximum length is 263 characters
3608
    * for ASCII format: maximum length is 263 characters
3568
      (263 bytes), byte after the name has value 0
3609
      (263 bytes), byte after the name has value 0
3569
    * for UNICODE format: maximum length is 259 characters
3610
    * for UNICODE format: maximum length is 259 characters
3570
      (518 bytes), 2 bytes after the name have value 0
3611
      (518 bytes), 2 bytes after the name have value 0
3571
Time format:
3612
Time format:
3572
  * +0: byte: seconds
3613
  * +0: byte: seconds
3573
  * +1: byte: minutes
3614
  * +1: byte: minutes
3574
  * +2: byte: hours
3615
  * +2: byte: hours
3575
  * +3: byte: reserved (0)
3616
  * +3: byte: reserved (0)
3576
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
3617
  * for example, 23.59.59 is written as (in hex) 3B 3B 17 00
3577
Date format:
3618
Date format:
3578
  * +0: byte: day
3619
  * +0: byte: day
3579
  * +1: byte: month
3620
  * +1: byte: month
3580
  * +2: word: year
3621
  * +2: word: year
3581
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
3622
  * for example, 25.11.1979 is written as (in hex) 19 0B BB 07
3582
Remarks:
3623
Remarks:
3583
  * If BDFE contains ASCII name, the length of BDFE is 304 bytes,
3624