Subversion Repositories Kolibri OS

Rev

Rev 77 | Rev 81 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
77 diamond 1
СИСТЕМНЫЕ ФУНКЦИИ ОПЕРАЦИОННОЙ СИСТЕМЫ Kolibri 0.5.3.1
2
 
3
Номер функции помещается в регистр eax.
4
Вызов системной функции осуществляется командой "int 0x40".
5
Все регистры, кроме явно указанных в возвращаемом значении,
6
    включая регистр флагов eflags, сохраняются.
7
 
8
 
9
======================================================================
10
============== Функция 0 - определить и нарисовать окно. =============
11
======================================================================
12
Определяет окно приложения. Рисует рамку окна, заголовок и рабочую
13
область. Для окон со скином определяет стандартные кнопки закрытия и
14
минимизации.
15
Параметры:
16
  * eax = 0 - номер функции
17
  * ebx = [координата по оси x]*65536 + [размер по оси x]
18
  * ecx = [координата по оси y]*65536 + [размер по оси y]
19
  * edx = 0xXYRRGGBB, где:
20
    * Y = стиль окна:
21
      * Y=0 - тип I - окно фиксированных размеров
22
      * Y=1 - только определить область окна, ничего не рисовать
23
      * Y=2 - тип II - окно изменяемых размеров
24
      * Y=3 - окно со скином
25
      * остальные возможные значения (от 4 до 15) зарезервированы,
26
        вызов функции с такими Y игнорируется
27
    * RR, GG, BB = соответственно красная, зеленая, синяя
28
      составляющие цвета рабочей области окна
29
      (игнорируется для стиля Y=2)
30
    * X=0 - нормальная заливка рабочей области,
31
      X=8 - градиентная заливка,
32
      остальные значения зарезервированы
33
    Следующие параметры предназначены для окон типа I и II и
34
    игнорируются для стилей Y=1,3:
35
  * esi = 0xXYRRGGBB - цвет заголовка
36
    * RR, GG, BB определяют сам цвет
37
    * Y=0 - обычное окно, Y=1 - неперемещаемое окно
38
    * X определяет градиент заголовка: X=0 - нет градиента,
39
      X=8 - обычный градиент,
40
      для окон типа II X=4 - негативный градиент
41
    * прочие значения X и Y зарезервированы
42
  * edi = 0x00RRGGBB - цвет рамки
43
Возвращаемое значение:
44
  * функция не возвращает значения
45
Замечания:
46
  * Положение и размеры окна устанавливаются при первом вызове
47
    этой функции и игнорируются при последующих; для изменения
48
    положения и/или размеров уже созданного окна используйте
49
    67-ю функцию.
50
  * Если использовать окна соответствующих стилей, то положение
51
    и/или размеры окна могут меняться пользователем.
52
    Текущие положение и размеры могут быть получены вызовом функции 9.
53
  * Окно должно умещаться на экране. Если переданные координаты
54
    и размеры не удовлетворяют этому условию, то соответствующая
55
    координата (или, возможно, обе) считается нулем, а если и это
56
    не помогает, то соответствующий размер (или, возможно, оба)
57
    устанавливается в размер экрана.
58
 
59
    Далее обозначим xpos,ypos,xsize,ysize - значения, передаваемые
60
    в ebx,ecx. Координаты приводятся относительно левого верхнего
61
    угла окна, который, таким образом, задается как (0,0), координаты
62
    правого нижнего угла суть (xsize,ysize).
63
  * Размеры окна понимаются в смысле координат правого нижнего угла.
64
    Это же относится и ко всем остальным функциям.
65
    Это означает, что реальные размеры на 1 пиксель больше.
66
  * Вид окна типа I:
67
    * рисуется внешняя рамка цвета, указанного в edi,
68
      шириной 1 пиксель
69
    * рисуется заголовок - прямоугольник с левым верхним углом (1,1)
70
      и правым нижним (xsize-1,min(25,ysize)) цвета, указанного в esi
71
      (с учетом градиента)
72
    * если ysize>=26, то закрашивается рабочая область окна -
73
      прямоугольник с левым верхним углом (1,21) и правым нижним
74
      (xsize-1,ysize-1) (размерами (xsize-1)*(ysize-21)) - цветом,
75
      указанным в edx (с учетом градиента)
76
  * Вид окна стиля Y=1:
77
    * полностью определяется приложением
78
  * Вид окна типа II:
79
    * рисуется внешняя рамка шириной 1 пиксель "затенённого" цвета
80
      edi (все составляющие цвета уменьшаются в два раза)
81
    * рисуется промежуточная рамка шириной 3 пикселя цвета edi
82
    * рисуется внутренняя рамка шириной 1 пиксель
83
      "затенённого" цвета edi
84
    * рисуется заголовок - прямоугольник с левым верхним углом (4,4)
85
      и правым нижним (xsize-4,min(20,ysize)) цвета, указанного в esi
86
      (с учетом градиента)
87
    * если ysize>=26, то закрашивается рабочая область окна -
88
      прямоугольник с левым верхним углом (5,20) и правым нижним
89
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
90
  * Вид окна со скином:
91
    * рисуется внешняя рамка шириной 1 пиксель
92
      цвета 'outer' из скина
93
    * рисуется промежуточная рамка шириной 3 пикселя
94
      цвета 'frame' из скина
95
    * рисуется внутренняя рамка шириной 1 пиксель
96
      цвета 'inner' из скина
97
    * рисуется заголовок (по картинкам из скина) в прямоугольнике
98
      (0,0) - (xsize,_skinh-1)
99
    * если ysize>=26, то закрашивается рабочая область окна -
100
      прямоугольник с левым верхним углом (5,_skinh) и правым нижним
101
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
102
    * определяются две стандартные кнопки: закрытия и минимизации
103
      (смотри функцию 8)
104
    * Значение переменной _skinh доступно как результат вызова
105
      подфункции 4 функции 48
106
 
107
======================================================================
108
================= Функция 1 - поставить точку в окне. ================
109
======================================================================
110
Параметры:
111
  * eax = 1 - номер функции
112
  * ebx = x-координата (относительно окна)
113
  * ecx = y-координата (относительно окна)
114
  * edx = 0x00RRGGBB - цвет точки
115
    edx = 0x01xxxxxx - инвертировать цвет точки
116
          (младшие 24 бита игнорируются)
117
Возвращаемое значение:
118
  * функция не возвращает значения
119
 
120
======================================================================
121
============== Функция 2 - получить код нажатой клавиши. =============
122
======================================================================
123
Забирает код нажатой клавиши из буфера.
124
Параметры:
125
  * eax = 2 - номер функции
126
Возвращаемое значение:
127
  * если буфер пуст, возвращается eax=1
128
  * если буфер непуст, то возвращается al=0, ah=код нажатой клавиши,
129
    старшее слово регистра eax обнулено
130
Замечания:
131
  * Существует общесистемный буфер нажатых клавиш размером 120 байт,
132
    организованный как очередь.
133
  * При вызове этой функции приложением с неактивным окном
134
    возвращается ответ "буфер пуст".
135
  * Эта функция не сообщает о клавишах, нажатых в комбинации с Alt,
136
    для таких случаев есть подфункция 12 функции 18.
137
  * По умолчанию эта функция возвращает ASCII-коды; переключиться на
138
    режим сканкодов (и назад) можно с использованием функции 66.
139
  * Узнать, какие комбинации клавиш соответствуют каким кодам, можно,
140
    запустив приложения keyascii и scancode.
141
  * Сканкоды возвращаются непосредственно клавиатурой и фиксированы;
142
    ASCII-коды получаются с использованием таблиц преобразования,
143
    которые можно установить подфункцией 2 функции 21 и прочитать
144
    подфункцией 2 функции 26.
145
  * Как следствие, ASCII-коды учитывают текущую раскладку клавиатуры
146
    (rus/en) в отличие от сканкодов.
147
 
148
======================================================================
149
================ Функция 3 - получить системное время. ===============
150
======================================================================
151
Параметры:
152
  * eax = 3 - номер функции
153
Возвращаемое значение:
154
  * eax = 0x00SSMMHH, где HH:MM:SS = часы:минуты:секунды
155
  * каждый элемент возвращается как BCD-число, например,
156
    для времени 23:59:59 результат будет 0x00595923
157
Замечания:
158
  * Смотри также подфункцию 9 функции 26 - получение времени
159
    с момента запуска системы; она во многих случаях удобнее,
160
    поскольку возвращает просто DWORD-значение счетчика времени.
161
  * Системное время можно установить функцией 22.
162
 
163
======================================================================
164
================== Функция 4 - вывести текст в окно. =================
165
======================================================================
166
Параметры:
167
  * eax = 4 - номер функции
168
  * ebx = [координата по оси x]*65536 + [координата по оси y]
169
  * ecx = 0xX0RRGGBB, где
170
    * RR, GG, BB задают цвет текста
171
    * X задает используемый шрифт: 0=системный моноширинный,
172
      1=системный шрифт переменной ширины
173
  * edx = указатель на начало строки
174
  * esi = длина строки, должна быть не больше 255
175
Возвращаемое значение:
176
  * функция не возвращает значения
177
Замечания:
178
  * Первый системный шрифт считывается при загрузке из файла char.mt,
179
    второй - из char2.mt.
180
  * Оба шрифта имеют высоту 9 пикселей, ширина моноширинного шрифта
181
    равна 6 пикселей.
182
 
183
======================================================================
184
========================= Функция 5 - пауза. =========================
185
======================================================================
186
Задерживает выполнение программы на заданное время.
187
Параметры:
188
  * eax = 5 - номер функции
189
  * ebx = время в сотых долях секунды
190
Возвращаемое значение:
191
  * функция не возвращает значения
192
Замечания:
193
  * Передача ebx=0 не передает управление следующему процессу и
194
    вообще не производит никаких действий. Если действительно
195
    требуется передать управление следующему процессу
196
    (закончить текущий квант времени), используйте подфункцию 1
197
    функции 68.
198
  * При текущей реализации произойдет немедленный возврат из функции,
199
    если сложение ebx с текущим значением счетчика времени вызовет
200
    32-битное переполнение.
201
 
202
======================================================================
203
=============== Функция 6 - прочитать файл с рамдиска. ===============
204
======================================================================
205
Параметры:
206
  * eax = 6 - номер функции
207
  * ebx = указатель на имя файла
208
  * ecx = номер стартового блока, считая с 1;
209
    ecx=0 - читать с начала файла (то же самое, что и ecx=1)
210
  * edx = число блоков для чтения;
211
    edx=0 - читать один блок (то же самое, что и edx=1)
212
  * esi = указатель на область памяти, куда будут записаны данные
213
Возвращаемое значение:
214
  * eax = длина файла в байтах, если файл успешно прочитан
215
  * eax = -1, если файл не найден
216
Замечания:
217
  * Данная функция является устаревшей; функция 70
218
    позволяет выполнять те же действия с расширенными возможностями.
219
  * Блок = 512 байт.
220
  * Для чтения всего файла можно указать заведомо большое значение
221
    в edx, например, edx = -1; но в этом случае будьте готовы к тому,
222
    что программа "упадет", если файл окажется слишком большим
223
    и "не влезет" в память программы.
224
  * Имя файла должно быть либо в формате 8+3 символов
225
    (первые 8 символов - собственно имя, последние 3 - расширение,
226
    короткие имена и расширения дополняются пробелами),
227
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
228
    (имя не более 8 символов, точка, расширение 3 символа,
229
    дополненное при необходимости пробелами).
230
    Имя файла должно быть записано заглавными буквами.
231
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
232
  * Текущая реализация рамдиска не поддерживает директории.
233
 
234
======================================================================
235
=============== Функция 7 - вывести изображение в окно. ==============
236
======================================================================
237
Параметры:
238
  * eax = 7 - номер функции
239
  * ebx = указатель на изображение в формате RRGGBBRRGGBB...
240
  * ecx = [размер по оси x]*65536 + [размер по оси y]
241
  * edx = [координата по оси x]*65536 + [координата по оси y]
242
Возвращаемое значение:
243
  * функция не возвращает значения
244
Замечания:
245
  * Координаты изображения - это координаты верхнего левого угла
246
    изображения относительно окна.
247
  * Размер изображения в байтах есть 3*xsize*ysize.
248
 
249
======================================================================
250
=============== Функция 8 - определить/удалить кнопку. ===============
251
======================================================================
252
Параметры для определения кнопки:
253
  * eax = 8 - номер функции
254
  * ebx = [координата по оси x]*65536 + [размер по оси x]
255
  * ecx = [координата по оси y]*65536 + [размер по оси y]
256
  * edx = 0xXYnnnnnn, где:
257
    * nnnnnn = идентификатор кнопки
258
    * старший (31-й) бит edx сброшен
259
    * если 30-й бит edx установлен - не прорисовывать кнопку
260
    * если 29-й бит edx установлен - не рисовать рамку
261
      при нажатии на кнопку
262
  * esi = 0x00RRGGBB - цвет кнопки
263
Параметры для удаления кнопки:
264
  * eax = 8 - номер функции
265
  * edx = 0x80nnnnnn, где nnnnnn - идентификатор кнопки
266
Возвращаемое значение:
267
  * функция не возвращает значения
268
Замечания:
269
  * Размеры кнопки должны быть больше 0 и меньше 0x8000.
270
  * Для окон со скином при определении окна (вызове 0-й функции)
271
    создаются две стандартные кнопки - закрытия окна
272
    с идентификатором 1 и минимизации окна с идентификатором 0xffff.
273
  * Создание двух кнопок с одинаковыми идентификаторами
274
    вполне допустимо.
275
  * Кнопка с идентификатором 0xffff при нажатии интерпретируется
276
    системой как кнопка минимизации, система обрабатывает такое
277
    нажатие самостоятельно, не обращаясь к приложению.
278
    В остальном это обычная кнопка.
279
  * Общее количество кнопок для всех приложений ограничено
280
    числом 4095.
281
 
282
======================================================================
283
============= Функция 9 - информация о потоке выполнения. ============
284
======================================================================
285
Параметры:
286
  * eax = 9 - номер функции
287
  * ebx = указатель на буфер размера 1 Кб
288
  * ecx = номер слота потока
289
    ecx = -1 - получить информацию о текущем потоке
290
Возвращаемое значение:
291
  * eax = максимальный номер слота потока
292
  * буфер, на который указывает ebx, содержит следующую информацию:
293
    * +0: dword: использование процессора (сколько тактов в секунду
294
      уходит на исполнение именно этого потока)
295
    * +4: word: позиция окна потока в оконном стэке
296
    * +6: word: (не имеет отношения к запрошенному потоку)
297
      номер слота потока, окно которого находится в оконном стэке
298
      в позиции ecx
299
    * +8: word: зарезервировано
300
    * +10 = +0xA: 11 байт: имя процесса
301
      (имя соответствующего исполняемого файла в формате 8+3)
302
    * +21 = +0x15: byte: выравнивание, этот байт не изменяется
303
    * +22 = +0x16: dword: адрес процесса в памяти
304
    * +26 = +0x1A: dword: размер используемой памяти - 1
305
    * +30 = +0x1E: dword: идентификатор (PID/TID)
306
    * +34 = +0x22: dword: координата окна потока по оси x
307
    * +38 = +0x26: dword: координата окна потока по оси y
308
    * +42 = +0x2A: dword: размер окна потока по оси x
309
    * +46 = +0x2E: dword: размер окна потока по оси y
310
    * +50 = +0x32: word: состояние слота потока:
311
      * 0 = поток выполняется
312
      * 1 = поток приостановлен
313
      * 2 = поток приостановлен в момент ожидания события
314
      * 3 = поток завершается в результате вызова функции -1 или
315
        насильственно как следствие вызова подфункции 2 функции 18
316
        или завершения работы системы
317
      * 4 = поток завершается в результате исключения
318
      * 5 = поток ожидает события
319
      * 9 = запрошенный слот свободен, вся остальная информация о
320
        слоте не имеет смысла
321
Замечания:
322
  * Слоты нумеруются с 1.
323
  * Возвращаемое значение не есть общее число потоков, поскольку
324
    бывают свободные слоты.
325
  * При создании процесса автоматически создается поток выполнения.
326
  * Функция выдает информацию о потоке. Каждый процесс имеет
327
    хотя бы один поток. Один процесс может создать несколько потоков,
328
    в этом случае каждый поток получает свой слот, причем поля
329
    +10, +22, +26 в этих слотах совпадают.
330
    Для приложений не существует общего способа определить,
331
    принадлежат ли два потока одному процессу.
332
  * Активное окно - окно, находящееся на вершине оконного стэка,
333
    оно получает сообщения о вводе с клавиатуры. Для него позиция в
334
    оконном стэке совпадает с возвращаемым значением.
335
  * Слот 1 соответствует специальному потоку операционной системы,
336
    для которого:
337
    * окно находится внизу оконного стэка, поля +4 и +6 содержат
338
      значение 1
339
    * имя процесса - "OS/IDLE" (дополненное пробелами)
340
    * адрес процесса в памяти равен 0, размер используемой памяти
341
      16 Mb (0x1000000)
342
    * PID=1
343
    * координаты и размеры окна условно полагаются равными 0
344
    * состояние слота - всегда 0 (выполняется)
345
    * время выполнения складывается из времени, уходящего на
346
      собственно работу, и времени простоя в ожидании прерывания
347
      (которое можно получить вызовом подфункции 4 функции 18).
348
  * Начиная со слота 2, размещаются обычные приложения.
349
  * Обычные приложения размещаются в памяти по адресу 0x10000000
350
    (константа ядра std_application_base_address).
351
    Наложения не происходит, поскольку у каждого процесса своя
352
    таблица страниц.
353
  * При создании потока ему назначаются слот в системной таблице и
354
    идентификатор (Process/Thread IDentifier = PID/TID), которые для
355
    заданного потока не изменяются со временем.
356
    После завершения потока его слот может быть заново использован
357
    для другого потока. Идентификатор потока не может быть назначен
358
    другому потоку даже после завершения первого.
359
    Назначаемые новым потокам идентификаторы монотонно растут.
360
  * Если поток еще не определил свое окно вызовом функции 0, то
361
    положение и размеры этого окна полагаются нулями.
362
  * В данный момент используется только часть буфера размером
363
    52 = 0x34 байта. Тем не менее рекомендуется использовать буфер
364
    размером 1 Кб для будущей совместимости, в будущем могут быть
365
    добавлены некоторые поля.
366
 
367
======================================================================
368
==================== Функция 10 - ожидать события. ===================
369
======================================================================
370
Если очередь сообщений пуста, то ждет появления сообщения в очереди.
371
В таком состоянии поток не получает процессорного времени.
372
Затем считывает сообщение из очереди.
373
 
374
Параметры:
375
  * eax = 10 - номер функции
376
Возвращаемое значение:
377
  * eax = событие (смотри список событий)
378
Замечания:
379
  * Учитываются только те события, которые входят в маску,
380
    устанавливаемую функцией 40. По умолчанию это события
381
    перерисовки, нажатия на клавиши и на кнопки.
382
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
383
    Чтобы ждать не более определенного времени, используйте
384
    функцию 23.
385
 
386
======================================================================
387
======= Функция 11 - проверить, есть ли событие, без ожидания. =======
388
======================================================================
389
Если в очереди сообщений есть какое-то событие, то считывает и
390
возвращает его. Если очередь пуста, возвращает нуль.
391
Параметры:
392
  * eax = 11 - номер функции
393
Возвращаемое значение:
394
  * eax = 0 - очередь сообщений пуста
395
  * иначе eax = событие (смотри список событий)
396
Замечания:
397
  * Учитываются только те события, которые входят в маску,
398
    устанавливаемую функцией 40. По умолчанию это события
399
    перерисовки, нажатия на клавиши и на кнопки.
400
  * Для ожидания появления события в очереди, используйте функцию 10.
401
    Чтобы ждать не более определенного времени, используйте
402
    функцию 23.
403
 
404
======================================================================
405
=========== Функция 12 - начать/закончить перерисовку окна. ==========
406
======================================================================
407
 
408
-------------- Подфункция 1 - начать перерисовку окна. ---------------
409
Параметры:
410
  * eax = 12 - номер функции
411
  * ebx = 1 - номер подфункции
412
Возвращаемое значение:
413
  * функция не возвращает значения
414
 
415
------------- Подфункция 2 - закончить перерисовку окна. -------------
416
Параметры:
417
  * eax = 12 - номер функции
418
  * ebx = 2 - номер подфункции
419
Возвращаемое значение:
420
  * функция не возвращает значения
421
Замечания:
422
  * Функция начала перерисовки удаляет все определённые
423
    функцией 8 кнопки, их следует определить повторно.
424
 
425
======================================================================
426
============ Функция 13 - нарисовать прямоугольник в окне. ===========
427
======================================================================
428
Параметры:
429
  * eax = 13 - номер функции
430
  * ebx = [координата по оси x]*65536 + [размер по оси x]
431
  * ecx = [координата по оси y]*65536 + [размер по оси y]
432
  * edx = цвет 0xRRGGBB или 0x80RRGGBB для градиентной заливки
433
Возвращаемое значение:
434
  * функция не возвращает значения
435
Замечания:
436
  * Под координатами понимаются координаты левого верхнего угла
437
    прямоугольника относительно окна.
438
 
439
======================================================================
440
================ Функция 14 - получить размеры экрана. ===============
441
======================================================================
442
Параметры:
443
  * eax = 14 - номер функции
444
Возвращаемое значение:
445
  * eax = [xsize]*65536 + [ysize], где
446
  * xsize = x-координата правого нижнего угла экрана =
447
            размер по горизонтали - 1
448
  * ysize = y-координата правого нижнего угла экрана =
449
            размер по вертикали - 1
450
Замечания:
451
  * Смотри также подфункцию 5 функции 48 - получить размеры рабочей
452
    области экрана.
453
 
454
======================================================================
455
= Функция 15, подфункция 1 - установить размер фонового изображения. =
456
======================================================================
457
Параметры:
458
  * eax = 15 - номер функции
459
  * ebx = 1 - номер подфункции
460
  * ecx = ширина изображения
461
  * edx = высота изображения
462
Возвращаемое значение:
463
  * функция не возвращает значения
464
Замечания:
465
  * Проверок на корректность не делается. Установка слишком больших
466
    значений приведёт к тому, что в фон войдут данные за границей
467
    буфера фонового изображения. Размер буфера = 0x160000-0x10, что
468
    соответствует максимальным размерам 800*600. (800*600*3=0x15F900)
469
  * Для обновления экрана (после завершения серии команд, работающих с
470
    фоном) вызывайте подфункцию 3 перерисовки фона.
471
  * Есть парная функция получения размеров фонового изображения -
472
    подфункция 1 функции 39.
473
 
474
======================================================================
475
= Функция 15, подфункция 2 - поставить точку на фоновом изображении. =
476
======================================================================
477
Параметры:
478
  * eax = 15 - номер функции
479
  * ebx = 2 - номер подфункции
480
  * ecx = смещение
481
  * edx = цвет точки 0xRRGGBB
482
Возвращаемое значение:
483
  * функция не возвращает значения
484
Замечания:
485
  * Смещение для точки с координатами (x,y) вычисляется как
486
    (x+y*xsize)*3.
487
  * Если указанное смещение превышает 0x160000-16 =
488
    1.375 Mb - 16 bytes, вызов игнорируется.
489
  * Для обновления экрана (после завершения серии команд, работающих с
490
    фоном) вызывайте подфункцию 3 перерисовки фона.
491
  * Есть парная функция получения точки с фонового изображения -
492
    подфункция 2 функции 39.
493
 
494
======================================================================
495
============ Функция 15, подфункция 3 - перерисовать фон. ============
496
======================================================================
497
Параметры:
498
  * eax = 15 - номер функции
499
  * ebx = 3 - номер подфункции
500
Возвращаемое значение:
501
  * функция не возвращает значения
502
 
503
======================================================================
504
===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====
505
======================================================================
506
Параметры:
507
  * eax = 15 - номер функции
508
  * ebx = 4 - номер подфункции
509
  * ecx = режим отрисовки:
510
    * 1 = замостить
511
    * 2 = растянуть
512
Возвращаемое значение:
513
  * функция не возвращает значения
514
Замечания:
515
  * Для обновления экрана (после завершения серии команд, работающих с
516
    фоном) вызывайте подфункцию 3 перерисовки фона.
517
  * Есть парная команда получения режима отрисовки фона -
518
    подфункция 4 функции 39.
519
 
520
======================================================================
521
===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====
522
======================================================================
523
Параметры:
524
  * eax = 15 - номер функции
525
  * ebx = 5 - номер подфункции
526
  * ecx = указатель на данные в формате RRGGBBRRGGBB...
527
  * edx = смещение в данных фонового изображения
528
  * esi = размер данных в байтах = 3 * число пикселей
529
Возвращаемое значение:
530
  * функция не возвращает значения
531
Замечания:
532
  * Если блок вылезает за границу 0x160000-16 = 1.375 Mb - 16 bytes,
533
    то вызов игнорируется.
534
  * Цвет каждого пикселя хранится как 3-байтная величина RRGGBB.
535
  * Пиксели фонового изображения записываются последовательно
536
    слева направо, сверху вниз.
537
  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.
538
  * Для обновления экрана (после завершения серии команд, работающих с
539
    фоном) вызывайте подфункцию 3 перерисовки фона.
540
 
541
======================================================================
542
============= Функция 16 - сохранить рамдиск на дискету. =============
543
======================================================================
544
Параметры:
545
  * eax = 16 - номер функции
546
  * ebx = 1 или ebx = 2 - на какую дискету сохранять
547
Возвращаемое значение:
548
  * eax = 0 - успешно
549
  * eax = 1 - ошибка
550
 
551
======================================================================
552
============== Функция 17 - получить код нажатой кнопки. =============
553
======================================================================
554
Забирает код нажатой кнопки из буфера.
555
Параметры:
556
  * eax = 17 - номер функции
557
Возвращаемое значение:
558
  * если буфер пуст, возвращается eax=1
559
  * если буфер непуст, то возвращается al=0, старшие 24 бита eax
560
    содержат идентификатор кнопки (в частности, в ah оказывается
561
    младший байт идентификатора; если все кнопки имеют идентификатор,
562
    меньший 256, то для различения достаточно ah)
563
Замечания:
564
  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки
565
    информация о старой теряется.
566
  * При вызове этой функции приложением с неактивным окном
567
    возвращается ответ "буфер пуст".
568
 
569
======================================================================
570
======== Функция 18, подфункция 1 - завершить работу системы. ========
571
======================================================================
572
Параметры:
573
  * eax = 18 - номер функции
574
  * ebx = 1 - номер подфункции
575
Возвращаемое значение:
576
  * всегда возвращается eax = 0 как признак успеха
577
Замечания:
578
  * На последнем шаге появляется меню выхода из системы, ожидающее
579
    реакции пользователя.
580
  * Смотри также подфункцию 9, завершение работы системы с параметром,
581
    чтобы форсировать выбор в меню выхода.
582
 
583
======================================================================
584
========= Функция 18, подфункция 2 - завершить процесс/поток. ========
585
======================================================================
586
Параметры:
587
  * eax = 18 - номер функции
588
  * ebx = 2 - номер подфункции
589
  * ecx = номер слота процесса/потока
590
Возвращаемое значение:
591
  * функция не возвращает значения
592
Замечания:
593
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
594
    1), можно завершить любой обычный поток/процесс.
595
 
596
======================================================================
597
= Функция 18, подфункция 3 - сделать активным окно заданного потока. =
598
======================================================================
599
Параметры:
600
  * eax = 18 - номер функции
601
  * ebx = 3 - номер подфункции
602
  * ecx = номер слота потока
603
Возвращаемое значение:
604
  * функция не возвращает значения
605
Замечания:
606
  * При указании корректного, но несуществующего слота активизируется
607
    какое-то окно.
608
  * Узнать, какое окно является активным, можно вызовом подфункции 7.
609
 
610
======================================================================
611
 Функция 18, подфункция 4 - получить счётчик пустых тактов в секунду.
612
======================================================================
613
Под пустыми тактами понимается время, в которое процессор простаивает
614
в ожидании прерывания (в инструкции hlt).
615
 
616
Параметры:
617
  * eax = 18 - номер функции
618
  * ebx = 4 - номер подфункции
619
Возвращаемое значение:
620
  * eax = значение счётчика пустых тактов в секунду
621
 
622
======================================================================
623
======== Функция 18, подфункция 5 - получить тактовую частоту. =======
624
======================================================================
625
Параметры:
626
  * eax = 18 - номер функции
627
  * ebx = 5 - номер подфункции
628
Возвращаемое значение:
629
  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)
630
 
631
======================================================================
632
 Функция 18, подфункция 6 - сохранить рамдиск в файл на жёстком диске.
633
======================================================================
634
Параметры:
635
  * eax = 18 - номер функции
636
  * ebx = 6 - номер подфункции
637
  * ecx определяет путь к файлу:
638
    * 1 = в папке "/KOLIBRI"
639
    * 2 = в корневом каталоге
640
    * 3 = edx указывает на путь (имена папок в формате 8+3,
641
      разделённые '/')
642
Возвращаемое значение:
643
  * eax = 0 - успешно
644
  * иначе eax = код ошибки файловой системы
645
Замечания:
646
  * Имя файла фиксировано, "menuet.img" (глобальная переменная ядра
647
    image_save из preboot.inc)
648
  * На каком разделе какого диска файл будет сохранён, определяется
649
    подфункцией 7 и подфункцией 8 функции 21.
650
  * Ядро предполагает, что во время записи никакая другая программа
651
    не будет обращаться к жёсткому диску.
652
  * Все папки в указанном пути должны существовать, иначе вернётся
653
    значение 5, "файл не найден".
654
 
655
======================================================================
656
====== Функция 18, подфункция 7 - получить номер активного окна. =====
657
======================================================================
658
Параметры:
659
  * eax = 18 - номер функции
660
  * ebx = 7 - номер подфункции
661
Возвращаемое значение:
662
  * eax = номер активного окна (номер слота потока, окно которого
663
    активно)
664
Замечания:
665
  * Активное окно находится вверху оконного стэка и получает
666
    сообщения обо всём вводе с клавиатуры.
667
  * Сделать окно активным можно вызовом подфункции 3.
668
 
669
======================================================================
670
==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====
671
======================================================================
672
При отключённом звуке вызовы подфункции 55 функции 55 игнорируются.
673
При включённом - направляются на встроенный спикер.
674
 
675
--------------- Подподфункция 1 - получить состояние. ----------------
676
Параметры:
677
  * eax = 18 - номер функции
678
  * ebx = 8 - номер подфункции
679
  * ecx = 1 - номер подподфункции
680
Возвращаемое значение:
681
  * eax = 0 - звук спикера разрешён; 1 - запрещён
682
 
683
-------------- Подподфункция 2 - переключить состояние. --------------
684
Переключает состояния разрешения/запрещения.
685
Параметры:
686
  * eax = 18 - номер функции
687
  * ebx = 8 - номер подфункции
688
  * ecx = 2 - номер подподфункции
689
Возвращаемое значение:
690
  * функция не возвращает значения
691
 
692
======================================================================
693
= Функция 18, подфункция 9 - завершение работы системы с параметром. =
694
======================================================================
695
Параметры:
696
  * eax = 18 - номер функции
697
  * ebx = 9 - номер подфункции
698
  * ecx = параметр:
699
    * 1 = на последнем шаге завершения работы сохранить рамдиск на
700
      дискету, после чего вывести меню выхода и запросить у
701
      пользователя дальнейшие действия
702
    * 2 = выключить компьютер
703
    * 3 = перезагрузить компьютер
704
    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске
705
Возвращаемое значение:
706
  * при неверном ecx регистры не меняются (т.е. eax=18)
707
  * при правильном вызове всегда возвращается признак успеха eax=0
708
Замечания:
709
  * Не следует полагаться на возвращаемое значение при неверном
710
    вызове, оно может измениться в последующих версиях ядра.
711
  * Можно использовать подфункцию 1, чтобы на последнем шаге
712
    завершения работы пользователь сам решал, что ему нужно.
713
  * Не рекомендуется использовать значение ecx=1 (чтобы не раздражать
714
    пользователя излишними вопросами); сохранить рамдиск на дискету
715
    можно функцией 16 (которая допускает уточнение, на какую именно
716
    дискету писать), а завершить работу с меню выхода можно уже
717
    упомянутой подфункцией 1.
718
 
719
======================================================================
720
======== Функция 18, подфункция 10 - свернуть окно приложения. =======
721
======================================================================
722
Сворачивает собственное окно.
723
Параметры:
724
  * eax = 18 - номер функции
725
  * ebx = 10 - номер подфункции
726
Возвращаемое значение:
727
  * функция не возвращает значения
728
Замечания:
729
  * Минимизированное окно с точки зрения функции 9 сохраняет положение
730
    и размеры.
731
  * Восстановление окна приложения происходит при активизировании
732
    подфункцией 3.
733
  * Обычно нет необходимости явно сворачивать/разворачивать своё окно:
734
    сворачивание окна осуществляется системой при нажатии на кнопку
735
    минимизации (которая для окон со скином определяется автоматически
736
    функцией 0, для окон без скина её можно определить функцией 8),
737
    восстановление - приложением @panel.
738
 
739
======================================================================
740
====================== Функция 18, подфункция 11 =====================
741
============= Получить информацию о дисковой подсистеме. =============
742
======================================================================
743
Параметры:
744
  * eax = 18 - номер функции
745
  * ebx = 11 - номер подфункции
746
  * ecx = тип таблицы:
747
    * 1 = короткая версия, 10 байт
748
    * 2 = полная версия, 65536 байт
749
  * edx = указатель на буфер (в приложении) для таблицы
750
Возвращаемое значение:
751
  * функция не возвращает значения
752
Формат таблицы: короткая версия:
753
  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,
754
    где AAAA задаёт тип первого дисковода, BBBB - второго согласно
755
    следующему списку:
756
    * 0 = нет дисковода
757
    * 1 = 360Kb, 5.25''
758
    * 2 = 1.2Mb, 5.25''
759
    * 3 = 720Kb, 3.5''
760
    * 4 = 1.44Mb, 3.5''
761
    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)
762
    Например, для стандартной конфигурации из одного 1.44-дисковода
763
    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:
764
    значение оказывается 24h.
765
  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,
766
    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
767
    * 0 = устройство отсутствует
768
    * 1 = жёсткий диск
769
    * 2 = CD-привод
770
    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
771
  * +2: 4 db: число найденных разделов на жёстких дисках с
772
    соответственно IDE0,...,IDE3.
773
    При отсутствии жёсткого диска на IDEx соответствующий байт
774
    нулевой, при наличии показывает число распознанных разделов,
775
    которых может и не быть (если носитель не отформатирован или
776
    если файловая система не поддерживается). В текущей версии ядра
777
    для жёстких дисков поддерживаются только FAT16 и FAT32.
778
  * +6: 4 db: зарезервировано
779
Формат таблицы: полная версия:
780
  * +0: 10 db: такие же, как и в короткой версии
781
  * +10: 100 db: данные для первого раздела
782
  * +110: 100 db: данные для второго раздела
783
  * ...
784
  * +10+100*(n-1): 100 db: данные для последнего раздела
785
Разделы расположены в следующем порядке: сначала последовательно все
786
распознанные разделы на HD на IDE0 (если есть),
787
затем на HD на IDE1 (если есть) и т.д. до IDE3.
788
Формат информации о разделе (пока поддерживается только FAT):
789
  * +0: dword: начальный физический сектор раздела
790
  * +4: dword: последний физический сектор раздела
791
    (принадлежит разделу)
792
  * +8: dword: секторов в одной копии FAT
793
  * +12 = +0xC: dword: число копий FAT
794
  * +16 = +0x10: dword: число секторов в кластере
795
  * +20 = +0x14: dword: байт в секторе; текущая реализация ожидает,
796
    что здесь 0x200 = 512
797
  * +24 = +0x18: dword: первый кластер корневого каталога в FAT32,
798
 
799
  * +28 = +0x1C: dword: начальный физический сектор FAT
800
  * +32 = +0x20: dword: первый физический сектор корневого каталога
801
    для FAT16, игнорируется для FAT32
802
  * +36 = +0x24: dword: число секторов в корневом каталоге для FAT16,
803
 
804
  * +40 = +0x28: dword: физический сектор начала области данных
805
  * +44 = +0x2C: dword: максимальный номер кластера
806
  * +48 = +0x30: dword: физический сектор информации о
807
    файловой системе для FAT32, игнорируется для FAT16
808
  * +52 = +0x34: dword: значение, используемое как граница
809
    специальных значений в FAT
810
  * +56 = +0x38: dword: значение, используемое для плохих кластеров
811
    в FAT
812
  * +60 = +0x3C: dword: значение, используемое как маркер конца
813
    при записи цепочки в FAT
814
  * +64 = +0x40: dword: маска, накладываемая на элемент FAT
815
  * +68 = +0x44: byte: тип файловой системы: 16 или 32
816
  * +69 = +0x45: 31 db: зарезервировано
817
Замечания:
818
  * Короткая таблица может быть использована для получения информации
819
    об имеющихся устройствах.
820
  * Первые два поля информации о разделе в полной версии таблицы
821
    сообщают параметры раздела, оставшиеся - параметры файловой
822
    системы FAT. Для других файловых систем (когда они будут
823
    поддерживаться) специфическая для файловой системы информация,
824
    естественно, будет другой, но первые два поля
825
    сохранятся неизменными.
826
 
827
======================================================================
828
=== Функция 18, подфункция 12 - получить последнюю нажатую клавишу. ==
829
======================================================================
830
Параметры:
831
  * eax = 18 - номер функции
832
  * ebx = 12 - номер подфункции
833
Возвращаемое значение:
834
  * al = режим ввода с клавиатуры (0=ASCII,1=сканкоды), который
835
    имел место при обработке нажатия последней клавиши на клавиатуре
836
  * ah = код последней нажатой клавиши
837
  * старшее слово регистра eax обнулено
838
Замечания:
839
  * Только эта функция позволяет считывать клавиши, во время
840
    считывания которых из буфера была нажата клавиша Alt, функция 2
841
    в случае, когда при её вызове была нажата Alt, возвращает
842
    "буфер пуст", тем не менее считывая клавишу из очереди в
843
    глобальную системную переменную last_key_press и продвигая очередь
844
    вперёд.
845
  * После считывания код последней нажатой клавиши сбрасывается в 0.
846
    Следовательно, не стоит использовать эту функцию в двух различных
847
    программах (и даже два раза в одной программе).
848
  * Приложение @panel использует эту функцию для реагирования
849
    на Alt+F4, Alt+Win, Alt+Ctrl+F12.
850
  * last_key_press обновляется в точности в следующих случаях:
851
    * Обнуляется при вызове описываемой функции.
852
    * Когда управление получает некоторая процедура
853
      (main_loop_sys_getkey) главного цикла операционной системы:
854
      если буфер непуст, то первая клавиша буфера копируется в
855
      last_key_press (и не забирается из очереди).
856
    * При вызове функции 2: если буфер непуст, то считанная клавиша
857
      копируется в last_key_press (и возвращается приложению,
858
      вызвавшему функцию 2, но только если в момент считывания
859
      не нажата Alt).
860
  * Поскольку при активизации окна сбрасываются очереди клавиш и
861
    кнопок, то в большинстве случаев интерпретация ah соответствует al
862
    (т.е. понятно, что хранится в ah - ASCII-код или сканкод).
863
    Тем не менее возможны неприятные случаи, когда активное окно,
864
    не заботясь об оставшихся в буфере клавишах, вызывает функцию 66,
865
    переключаясь между режимами; если после этого пользователь нажмёт
866
    на клавишу, то значение переменной, соответствующей al, изменится,
867
    а начальные клавиши в буфере останутся в старом режиме.
868
 
869
======================================================================
870
========== Функция 18, подфункция 13 - получить версию ядра. =========
871
======================================================================
872
Параметры:
873
  * eax = 18 - номер функции
874
  * ebx = 13 - номер подфункции
875
  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена
876
    информация
877
Возвращаемое значение:
878
  * функция не возвращает значения
879
Структура буфера:
880
db a,b,c,d для версии a.b.c.d
881
db UID_xxx: одно из UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
882
db 'name',0 - ASCIIZ-строка с именем
883
Для ядра Kolibri 0.5.3.1:
884
db 0,5,3,1
885
db 2
886
db 'Kolibri',0
887
 
888
======================================================================
889
====================== Функция 18, подфункция 14 =====================
890
======= Ожидать начала обратного хода луча развёртки монитора. =======
891
======================================================================
892
Параметры:
893
  * eax = 18 - номер функции
894
  * ebx = 14 - номер подфункции
895
Возвращаемое значение:
896
  * eax = 0 как признак успеха
897
Замечания:
898
  * Функция предназначена исключительно для активных
899
    высокопроизводительных графических приложений; используется для
900
    плавного вывода графики.
901
 
902
======================================================================
903
== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =
904
======================================================================
905
Параметры:
906
  * eax = 18 - номер функции
907
  * ebx = 15 - номер подфункции
908
Возвращаемое значение:
909
  * eax = 0 как признак успеха
910
 
911
======================================================================
912
====================== Функция 18, подфункция 16 =====================
913
============ Получить размер свободной оперативной памяти. ===========
914
======================================================================
915
Параметры:
916
  * eax = 18 - номер функции
917
  * ebx = 16 - номер подфункции
918
Возвращаемое значение:
919
  * eax = размер свободной памяти в килобайтах
920
 
921
======================================================================
922
====================== Функция 18, подфункция 17 =====================
923
============ Получить размер имеющейся оперативной памяти. ===========
924
======================================================================
925
Параметры:
926
  * eax = 18 - номер функции
927
  * ebx = 17 - номер подфункции
928
Возвращаемое значение:
929
  * eax = общий размер имеющейся памяти в килобайтах
930
 
931
======================================================================
932
============ Функция 19 - запустить программу с рамдиска. ============
933
======================================================================
934
Параметры:
935
  * eax = 19 - номер функции
936
  * ebx = указатель на имя программы в формате, аналогичном функции 6
937
  * ecx = 0 или ecx = указатель на параметры командной строки
938
Возвращаемое значение:
939
  * Если eax > 0, то eax содержит PID созданного процесса
940
  * Если eax < 0, то -eax - код ошибки файловой системы
941
Замечания:
942
  * Эта функция устарела; используйте подфункцию 16 функции 58.
943
  * Комадная строка должна заканчиваться символом с кодом 0
944
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
945
    включительно, либо первые 256 символов, в зависимости от того,
946
    что меньше.
947
 
948
======================================================================
949
==================== Функция 20 - интерфейс MIDI. ====================
950
======================================================================
951
 
952
------------------------ Подфункция 1 - сброс ------------------------
953
Параметры:
954
  * eax = 20 - номер функции
955
  * ebx = 1 - номер подфункции
956
 
957
-------------------- Подфункция 2 - вывести байт ---------------------
958
Параметры:
959
  * eax = 20 - номер функции
960
  * ebx = 2 - номер подфункции
961
  * cl = байт для вывода
962
Возвращаемое значение (одинаково для обеих подфункций):
963
  * eax = 0 - успешно
964
  * eax = 1 - не определён базовый порт
965
Замечания:
966
  * Предварительно должен быть определён базовый порт вызовом
967
    подфункции 1 функции 21.
968
 
969
======================================================================
970
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
971
======================================================================
972
Параметры:
973
  * eax = 21 - номер функции
974
  * ebx = 1 - номер подфункции
975
  * ecx = номер базового порта
976
Возвращаемое значение:
977
  * eax = 0 - успешно
978
  * eax = -1 - ошибочный номер порта
979
Замечания:
980
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
981
  * Установка базы нужна для работы функции 20.
982
  * Получить установленный базовый порт можно вызовом
983
    подфункции 1 функции 26.
984
 
985
======================================================================
986
===== Функция 21, подфункция 2 - установить раскладку клавиатуры. ====
987
======================================================================
988
Раскладка клавиатуры используется для преобразования сканкодов,
989
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
990
Параметры:
991
  * eax = 21 - номер функции
992
  * ebx = 2 - номер подфункции
993
  * ecx = какую раскладку устанавливать:
994
    * 1 = нормальную
995
    * 2 = раскладку при нажатом Shift
996
    * 3 = раскладку при нажатом Alt
997
  * edx = указатель на раскладку - таблицу длиной 128 байт
998
Или:
999
  * ecx = 9
1000
  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1001
Возвращаемое значение:
1002
  * eax = 0 - успешно
1003
  * eax = 1 - параметр задан неверно
1004
Замечания:
1005
  * Если нажат Alt, то используется раскладка с Alt;
1006
    если не нажат Alt, но нажат Shift, то
1007
    используется раскладка с Shift;
1008
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1009
    нормальная раскладка, после чего из кода вычитается 0x60;
1010
    если не нажата ни одна из управляющих клавиш, то используется
1011
    нормальная раскладка.
1012
  * Ценность установки раскладки с Alt представляется сомнительной,
1013
    поскольку всё равно функция 2 не возвращает клавиши при
1014
    нажатом Alt.
1015
  * Получить раскладки и идентификатор страны можно с помощью
1016
    подфункции 2 функции 26.
1017
  * Идентификатор страны - глобальная системная переменная, которая
1018
    самим ядром не используется; однако приложение @panel отображает
1019
    соответствующую текущей стране иконку.
1020
  * Приложение @panel переключает раскладки по запросу пользователя.
1021
 
1022
======================================================================
1023
=========== Функция 21, подфункция 3 - установить базу CD. ===========
1024
======================================================================
1025
Параметры:
1026
  * eax = 21 - номер функции
1027
  * ebx = 3 - номер подфункции
1028
  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1029
Возвращаемое значение:
1030
  * eax = 0
1031
Замечания:
1032
  * База CD используется функцией 24.
1033
  * Получить установленную базу CD можно вызовом
1034
    подфункции 3 функции 26.
1035
 
1036
======================================================================
1037
== Функция 21, подфункция 4 - установить базовый порт Sound Blaster. =
1038
======================================================================
1039
Параметры:
1040
  * eax = 21 - номер функции
1041
  * ebx = 4 - номер подфункции
1042
  * ecx = номер базового порта
1043
Возвращаемое значение:
1044
  * eax = 0 - успешно
1045
  * eax = -1 - ошибочный номер порта
1046
Замечания:
1047
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1048
  * Установка базы нужна для работы функций 25, 28, 55.
1049
  * Получить установленный базовый порт можно вызовом
1050
    подфункции 4 функции 26.
1051
 
1052
======================================================================
1053
========= Функция 21, подфункция 5 - установить язык системы. ========
1054
======================================================================
1055
Параметры:
1056
  * eax = 21 - номер функции
1057
  * ebx = 5 - номер подфункции
1058
  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1059
Возвращаемое значение:
1060
  * eax = 0
1061
Замечания:
1062
  * Язык системы - глобальная системная переменная, никак
1063
    не используемая самим ядром, однако приложение @panel рисует
1064
    соответствующую иконку.
1065
  * Проверок на корректность не делается, поскольку ядро эту
1066
    переменную не использует.
1067
  * Получить язык системы можно вызовом подфункции 5 функции 26.
1068
 
1069
======================================================================
1070
======= Функция 21, подфункция 6 - установить базовый порт WSS. ======
1071
======================================================================
1072
Параметры:
1073
  * eax = 21 - номер функции
1074
  * ebx = 6 - номер подфункции
1075
  * ecx = базовый порт
1076
Возвращаемое значение:
1077
  * eax = 0 - успешно
1078
  * eax = -1 - ошибочный номер порта
1079
Замечания:
1080
  * Номер порта должен удовлетворять условию 0x100<=ecx.
1081
  * База WSS используется функцией 27.
1082
  * Получить установленный базовый порт WSS можно вызовом
1083
    подфункции 6 функции 26.
1084
 
1085
======================================================================
1086
=========== Функция 21, подфункция 7 - установить базу HD. ===========
1087
======================================================================
1088
База HD нужна для определения, на какой жёсткий диск писать, при
1089
использовании устаревших функций работы с файловой системой и функций,
1090
неявно использующих жёсткий диск (типа подфункции 6 функции 18);
1091
при использовании функций 58 и 70 и современного синтаксиса
1092
/HD0,/HD1,/HD2,/HD3 эти функции сами устанавливают базу.
1093
Параметры:
1094
  * eax = 21 - номер функции
1095
  * ebx = 7 - номер подфункции
1096
  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1097
Возвращаемое значение:
1098
  * eax = 0
1099
Замечания:
1100
  * Любое приложение в любой момент времени может изменить базу.
1101
  * Не следует изменять базу, когда какое-нибудь приложение работает
1102
    с жёстким диском. Если не хотите глюков системы.
1103
  * Получить установленную базу можно вызовом подфункции 7 функции 26.
1104
  * Следует также определить используемый раздел жёсткого диска
1105
    подфункцией 8.
1106
 
1107
======================================================================
1108
========== Функция 21, подфункция 8 - установить раздел HD. ==========
1109
======================================================================
1110
Раздел HD нужен для определения, на какой раздел жёсткого диска
1111
писать, при использовании устаревших функций работы с файловой
1112
системой и функций, неявно использующих жёсткий диск (типа
1113
подфункции 6 функции 18); при использовании функций 58 и 70
1114
и современного синтаксиса /HD0,/HD1,/HD2,/HD3 эти функции сами
1115
устанавливают базу и раздел.
1116
Параметры:
1117
  * eax = 21 - номер функции
1118
  * ebx = 8 - номер подфункции
1119
  * ecx = раздел HD (считая с 1)
1120
Возвращаемое значение:
1121
  * eax = 0
1122
Замечания:
1123
  * Любое приложение в любой момент времени может изменить раздел.
1124
  * Не следует изменять раздел, когда какое-нибудь приложение работает
1125
    с жёстким диском. Если не хотите глюков системы.
1126
  * Получить установленный раздел можно вызовом подфункции 8
1127
    функции 26.
1128
  * Проверок на корректность не делается.
1129
  * Узнать число разделов на жёстком диске можно вызовом
1130
    подфункции 11 функции 18.
1131
  * Следует также определить используемую базу жёсткого диска
1132
    подфункцией 7.
1133
 
1134
======================================================================
1135
===== Функция 21, подфункция 10 - установить канал DMA для звука. ====
1136
======================================================================
1137
Параметры:
1138
  * eax = 21 - номер функции
1139
  * ebx = 10 - номер подфункции
1140
  * ecx = номер канала (от 0 до 3 включительно)
1141
Возвращаемое значение:
1142
  * eax = 0 - успешно
1143
  * eax = -1 - неверный номер канала
1144
Замечания:
1145
  * Номер канала DMA используется в
1146
    подфункции 1 функции 55.
1147
  * Получить канал DMA для звука можно вызовом
1148
    подфункции 10 функции 26.
1149
 
1150
======================================================================
1151
====================== Функция 21, подфункция 11 =====================
1152
=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
1153
======================================================================
1154
Параметры:
1155
  * eax = 21 - номер функции
1156
  * ebx = 11 - номер подфункции
1157
  * ecx = 0/1 - запретить/разрешить
1158
Возвращаемое значение:
1159
  * eax = 0
1160
Замечания:
1161
  * Используется при LBA-чтении (подфункция 8 функции 58).
1162
  * Текущая реализация использует только младший бит ecx.
1163
  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
1164
 
1165
======================================================================
1166
====================== Функция 21, подфункция 12 =====================
1167
========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
1168
======================================================================
1169
Параметры:
1170
  * eax = 21 - номер функции
1171
  * ebx = 12 - номер подфункции
1172
  * ecx = 0/1 - запретить/разрешить
1173
Возвращаемое значение:
1174
  * eax = 0
1175
Замечания:
1176
  * Используется при работе с шиной PCI (функция 62).
1177
  * Текущая реализация использует только младший бит ecx.
1178
  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
1179
 
1180
======================================================================
1181
============= Функция 21, подфункция 13, подподфункция 1 =============
1182
==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
1183
======================================================================
1184
Параметры:
1185
  * eax = 21 - номер функции
1186
  * ebx = 13 - номер подфункции
1187
  * ecx = 1 - номер функции драйвера
1188
  * edx = указатель на буфер размера 512 байт
1189
Возвращаемое значение:
1190
  * если драйвер не загружен (никогда не бывает в текущей реализации):
1191
    * eax = -1
1192
    * ebx, ecx разрушаются
1193
  * если драйвер загружен:
1194
    * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт,
1195
      'Z' - старший) - сигнатура
1196
    * ebx = текущая частота развёртки (в Гц)
1197
    * ecx разрушается
1198
    * буфер, на который указывает edx, заполнен
1199
Формат буфера:
1200
  * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек,
1201
    дополнено пробелами)
1202
  * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как
1203
    y*65536+x), для текущей реализации 1 (1.0)
1204
  * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
1205
  * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое
1206
    слово - номер видеорежима, после собственно списка идут нули)
1207
  * +128 = +0x80: 32*(5*word): список поддерживаемых частот развёрток
1208
    для видеорежимов: для каждого видеорежима, указанного в предыдущем
1209
    поле, указано до 5 поддерживаемых частот
1210
    (в неиспользуемых позициях записаны нули)
1211
Замечания:
1212
  * Функция инициализирует драйвер (если он ещё не инициализирован)
1213
    и должна вызываться первой, перед остальными (иначе они будут
1214
    возвращать -1, ничего не делая).
1215
  * В текущей реализации поддерживается только одна частота развёртки
1216
    на видеорежим.
1217
 
1218
======================================================================
1219
============= Функция 21, подфункция 13, подподфункция 2 =============
1220
============= Получить информацию о текущем видеорежиме. =============
1221
======================================================================
1222
Параметры:
1223
  * eax = 21 - номер функции
1224
  * ebx = 13 - номер подфункции
1225
  * ecx = 2 - номер функции драйвера
1226
Возвращаемое значение:
1227
  * eax = -1 - драйвер не загружен или не инициализирован;
1228
    ebx,ecx разрушаются
1229
  * eax = [ширина]*65536 + [высота]
1230
  * ebx = частота вертикальной развёртки (в Гц)
1231
  * ecx = номер текущего видеорежима
1232
Замечания:
1233
  * Драйвер предварительно должен быть инициализирован вызовом
1234
    функции драйвера 1.
1235
  * Если нужны только размеры экрана, целесообразней использовать
1236
    функцию 14 с учётом того, что она возвращает размеры на 1 меньше.
1237
 
1238
======================================================================
1239
= Функция 21, подфункция 13, подподфункция 3 - установить видеорежим.
1240
======================================================================
1241
Параметры:
1242
  * eax = 21 - номер функции
1243
  * ebx = 13 - номер подфункции
1244
  * ecx = 3 - номер функции драйвера
1245
  * edx = [частота развёртки]*65536 + [номер видеорежима]
1246
Возвращаемое значение:
1247
  * eax = -1 - драйвер не загружен, не инициализирован или
1248
    произошла ошибка
1249
  * eax = 0 - успешно
1250
  * ebx, ecx разрушаются
1251
Замечания:
1252
  * Драйвер предварительно должен быть инициализирован вызовом
1253
    функции драйвера 1.
1254
  * Номер видеорежима и частота должны быть в таблице, возвращаемой
1255
    функцией драйвера 1.
1256
 
1257
======================================================================
1258
============= Функция 21, подфункция 13, подподфункция 4 =============
1259
================= Вернуться к начальному видеорежиму. ================
1260
======================================================================
1261
Возвращает экран в видеорежим, установленный при загрузке системы.
1262
Параметры:
1263
  * eax = 21 - номер функции
1264
  * ebx = 13 - номер подфункции
1265
  * ecx = 4 - номер функции драйвера
1266
Возвращаемое значение:
1267
  * eax = -1 - драйвер не загружен или не инициализирован
1268
  * eax = 0 - успешно
1269
  * ebx, ecx разрушаются
1270
Замечания:
1271
  * Драйвер предварительно должен быть инициализирован вызовом
1272
    функции драйвера 1.
1273
 
1274
======================================================================
1275
============= Функция 21, подфункция 13, подподфункция 5 =============
1276
======== Увеличить/уменьшить размер видимой области монитора. ========
1277
======================================================================
1278
Параметры:
1279
  * eax = 21 - номер функции
1280
  * ebx = 13 - номер подфункции
1281
  * ecx = 5 - номер функции драйвера
1282
  * edx = 0/1 - уменьшить/увеличить размер по горизонтали
1283
    на одну позицию
1284
  * edx = 2/3 - в текущей реализации не поддерживается; планируется
1285
    как уменьшение/увеличение размера по вертикали на одну позицию
1286
Возвращаемое значение:
1287
  * eax = -1 - драйвер не загружен или не инициализирован
1288
  * eax = 0 - успешно
1289
  * ebx, ecx разрушаются
1290
Замечания:
1291
  * Драйвер предварительно должен быть инициализирован вызовом
1292
    функции драйвера 1.
1293
  * Функция влияет только на физический размер изображения
1294
    на мониторе; логический размер (число пикселей) не меняется.
1295
 
1296
======================================================================
1297
============ Функция 22 - установить системную дату/время. ===========
1298
======================================================================
1299
Параметры:
1300
  * eax = 22 - номер функции
1301
  * ebx = 0 - установить время
1302
    * ecx = 0x00SSMMHH - время в двоично-десятичном коде (BCD):
1303
    * HH=час 00..23
1304
    * MM=минута 00..59
1305
    * SS=секунда 00..59
1306
  * ebx = 1 - установить дату
1307
    * ecx = 0x00DDMMYY - дата в двоично-десятичном коде (BCD):
1308
    * DD=день 01..31
1309
    * MM=месяц 01..12
1310
    * YY=год 00..99
1311
  * ebx = 2 - установить день недели
1312
    * ecx = 1 для воскресенья, ..., 7 для субботы
1313
  * ebx = 3 - установить будильник
1314
    * ecx = 0x00SSMMHH
1315
Возвращаемое значение:
1316
  * eax = 0 - успешно
1317
  * eax = 1 - параметр задан неверно
1318
  * eax = 2 - CMOS-батарейки разрядились
1319
Замечания:
1320
  * Ценность установки дня недели представляется сомнительной,
1321
    поскольку он мало где используется
1322
    (день недели можно рассчитать по дате).
1323
  * Будильник можно установить на срабатывание в заданное время
1324
    каждые сутки. При этом отключить его существующими системными
1325
    функциями нельзя.
1326
  * Срабатывание будильника заключается в генерации IRQ8.
1327
  * Вообще-то CMOS поддерживает для будильника установку значения
1328
    0xFF в качестве одного из параметров и означает это, что
1329
    соответствующий параметр игнорируется. Но в текущей реализации
1330
    это не пройдёт (вернётся значение 1).
1331
  * Будильник - глобальный системный ресурс; установка будильника
1332
    автоматически отменяет предыдущую установку. Впрочем, на данный
1333
    момент ни одна программа его не использует.
1334
 
1335
======================================================================
1336
============== Функция 23 - ожидать события с таймаутом. =============
1337
======================================================================
1338
Если очередь сообщений пуста, ждёт появления сообщения в очереди,
1339
но не более указанного времени. Затем считывает сообщение из очереди.
1340
 
1341
Параметры:
1342
  * eax = 23 - номер функции
1343
  * ebx = таймаут (в сотых долях секунды)
1344
Возвращаемое значение:
1345
  * eax = 0 - очередь сообщений пуста
1346
  * иначе eax = событие (смотри список событий)
1347
Замечания:
1348
  * Учитываются только те события, которые входят в маску,
1349
    устанавливаемую функцией 40. По умолчанию это события
1350
    перерисовки, нажатия на клавиши и на кнопки.
1351
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
1352
    Чтобы ждать сколь угодно долго, используйте функцию 10.
1353
  * Передача ebx=0 приводит к моментальному возвращению eax=0.
1354
  * При текущей реализации произойдёт немедленный возврат из функции
1355
    с eax=0, если сложение ebx с текущим значением счётчика времени
1356
    вызовет 32-битное переполнение.
1357
 
1358
======================================================================
1359
======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ======
1360
======================================================================
1361
Параметры:
1362
  * eax = 24 - номер функции
1363
  * ebx = 1 - номер подфункции
1364
  * ecx = 0x00FRSSMM, где
1365
    * MM = начальная минута
1366
    * SS = начальная секунда
1367
    * FR = начальный фрейм
1368
Возвращаемое значение:
1369
  * eax = 0 - успешно
1370
  * eax = 1 - не определена база CD
1371
Замечания:
1372
  * Предварительно нужно определить базовый порт CD вызовом
1373
    подфункции 3 функции 21.
1374
  * В секунде 75 фреймов, в минуте 60 секунд.
1375
  * Функция асинхронна (возвращает управление, когда началось
1376
    проигрывание).
1377
 
1378
======================================================================
1379
===== Функция 24, подфункция 2 - получить информацию о дорожках. =====
1380
======================================================================
1381
Параметры:
1382
  * eax = 24 - номер функции
1383
  * ebx = 2 - номер подфункции
1384
  * ecx = указатель на буфер для таблицы
1385
    (максимум 8*64h+4 байт=100 дорожек)
1386
Возвращаемое значение:
1387
  * eax = 0 - успешно
1388
  * eax = 1 - не определена база CD
1389
Замечания:
1390
  * Формат таблицы с информацией о дорожках такой же, как и для
1391
    ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h).
1392
    Адреса возвращаются в формате MSF.
1393
  * Предварительно нужно определить базовый порт CD вызовом
1394
    подфункции 3 функции 21.
1395
  * Функция возвращает информацию только о не более чем 100
1396
    первых дорожках. В большинстве случаев этого достаточно.
1397
 
1398
======================================================================
1399
==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. ===
1400
======================================================================
1401
Параметры:
1402
  * eax = 24 - номер функции
1403
  * ebx = 1 - номер подфункции
1404
Возвращаемое значение:
1405
  * eax = 0 - успешно
1406
  * eax = 1 - не определена база CD
1407
Замечания:
1408
  * Предварительно нужно определить базовый порт CD вызовом
1409
    подфункции 3 функции 21.
1410
 
1411
======================================================================
1412
============== Функция 25 - установить громкость SBPro. ==============
1413
======================================================================
1414
Параметры:
1415
  * eax = 25 - номер функции
1416
  * ebx = что устанавливать:
1417
    * 1 - установить общую громкость
1418
    * 2 - установить громкость CD-audio
1419
  * cl = уровень громкости: старшие 4 бита для левой колонки,
1420
    младшие 4 - для правой
1421
Возвращаемое значение:
1422
  * eax = 0 - успешно
1423
  * eax = 1 - не определена база SB
1424
  * eax = 2 - неверная подфункция
1425
Замечания:
1426
  * Предварительно нужно определить базовый порт SB вызовом
1427
    подфункции 4 функции 21.
1428
  * Смотри также функцию 28
1429
    установки звука для более позднего стандарта SB16.
1430
 
1431
======================================================================
1432
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
1433
======================================================================
1434
Параметры:
1435
  * eax = 26 - номер функции
1436
  * ebx = 1 - номер подфункции
1437
Возвращаемое значение:
1438
  * eax = номер порта
1439
Замечания:
1440
  * Установить базовый порт можно вызовом
1441
    подфункции 1 функции 21.
1442
 
1443
======================================================================
1444
====== Функция 26, подфункция 2 - получить раскладку клавиатуры. =====
1445
======================================================================
1446
Раскладка клавиатуры используется для преобразования сканкодов,
1447
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1448
Параметры:
1449
  * eax = 26 - номер функции
1450
  * ebx = 2 - номер подфункции
1451
  * ecx = какую раскладку получать:
1452
    * 1 = нормальную
1453
    * 2 = раскладку при нажатом Shift
1454
    * 3 = раскладку при нажатом Alt
1455
  * edx = указатель на буфер длиной 128 байт, куда будет скопирована
1456
    раскладка
1457
Возвращаемое значение:
1458
  * функция не возвращает значения
1459
Или:
1460
  * eax = 26 - номер функции
1461
  * ebx = 2 - номер подфункции
1462
  * ecx = 9
1463
Возвращаемое значение:
1464
  * eax = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1465
Замечания:
1466
  * Если нажат Alt, то используется раскладка с Alt;
1467
    если не нажат Alt, но нажат Shift, то используется
1468
    раскладка с Shift;
1469
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1470
    нормальная раскладка, после чего из кода вычитается 0x60;
1471
    если не нажата ни одна из управляющих клавиш, то используется
1472
    нормальная раскладка.
1473
  * Установить раскладки и идентификатор страны можно с помощью
1474
    подфункции 2 функции 21.
1475
  * Идентификатор страны - глобальная системная переменная, которая
1476
    самим ядром не используется; однако приложение @panel отображает
1477
    соответствующую текущей стране иконку
1478
    (используя описываемую функцию).
1479
  * Приложение @panel переключает раскладки по запросу пользователя.
1480
 
1481
======================================================================
1482
============ Функция 26, подфункция 3 - получить базу CD. ============
1483
======================================================================
1484
Параметры:
1485
  * eax = 26 - номер функции
1486
  * ebx = 3 - номер подфункции
1487
Возвращаемое значение:
1488
  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1489
Замечания:
1490
  * База CD используется функцией 24.
1491
  * Установлить базу CD можно вызовом подфункции 3 функции 21.
1492
 
1493
======================================================================
1494
=== Функция 26, подфункция 4 - получить базовый порт Sound Blaster. ==
1495
======================================================================
1496
Параметры:
1497
  * eax = 26 - номер функции
1498
  * ebx = 4 - номер подфункции
1499
Возвращаемое значение:
1500
  * eax = номер базового порта
1501
Замечания:
1502
  * Установка базы нужна для работы функций 25, 55.
1503
  * Установить базовый порт можно вызовом подфункции 4 функции 21.
1504
 
1505
======================================================================
1506
========== Функция 26, подфункция 5 - получить язык системы. =========
1507
======================================================================
1508
Параметры:
1509
  * eax = 26 - номер функции
1510
  * ebx = 5 - номер подфункции
1511
Возвращаемое значение:
1512
  * eax = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1513
Замечания:
1514
  * Язык системы - глобальная системная переменная, никак
1515
    не используемая самим ядром, однако приложение @panel рисует
1516
    соответствующую иконку (используя описываемую функцию).
1517
  * Установить язык системы можно вызовом подфункции 5 функции 21.
1518
 
1519
======================================================================
1520
======== Функция 26, подфункция 6 - получить базовый порт WSS. =======
1521
======================================================================
1522
Параметры:
1523
  * eax = 26 - номер функции
1524
  * ebx = 6 - номер подфункции
1525
Возвращаемое значение:
1526
  * eax = базовый порт
1527
Замечания:
1528
  * База WSS используется функцией 27.
1529
  * Установить базовый порт WSS можно вызовом подфункции 6 функции 21.
1530
 
1531
======================================================================
1532
============ Функция 26, подфункция 7 - получить базу HD. ============
1533
======================================================================
1534
База HD нужна для определения, на какой жёсткий диск писать, при
1535
использовании устаревших функций работы с файловой системой и функций,
1536
неявно использующих жёсткий диск (типа подфункции 6 функции 18);
1537
при использовании функций 58 и 70 и современного синтаксиса
1538
/HD0,/HD1,/HD2,/HD3 эти функции сами устанавливают базу.
1539
Параметры:
1540
  * eax = 26 - номер функции
1541
  * ebx = 7 - номер подфункции
1542
Возвращаемое значение:
1543
  * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1544
Замечания:
1545
  * Любое приложение в любой момент времени может изменить базу.
1546
  * Установить базу можно вызовом подфункции 7 функции 21.
1547
  * Получить используемый раздел жёсткого диска можно подфункцией 8.
1548
 
1549
======================================================================
1550
=========== Функция 26, подфункция 8 - получить раздел HD. ===========
1551
======================================================================
1552
Раздел HD нужен для определения, на какой раздел жёсткого диска
1553
писать, при использовании устаревших функций работы с файловой
1554
системой и функций, неявно использующих жёсткий диск (типа
1555
подфункции 6 функции 18); при использовании функций 58 и 70 и
1556
современного синтаксиса /HD0,/HD1,/HD2,/HD3 эти функции сами
1557
устанавливают базу и раздел.
1558
Параметры:
1559
  * eax = 26 - номер функции
1560
  * ebx = 8 - номер подфункции
1561
Возвращаемое значение:
1562
  * eax = раздел HD (считая с 1)
1563
Замечания:
1564
  * Любое приложение в любой момент времени может изменить раздел.
1565
  * Установить раздел можно вызовом подфункции 8 функции 21.
1566
  * Узнать число разделов на жёстком диске можно вызовом
1567
    подфункции 11 функции 18.
1568
  * Получить используемую базу жёсткого диска можно подфункцией 7.
1569
 
1570
======================================================================
1571
=== Функция 26, подфункция 9 - получить значение счётчика времени. ===
1572
======================================================================
1573
Параметры:
1574
  * eax = 26 - номер функции
1575
  * ebx = 9 - номер подфункции
1576
Возвращаемое значение:
1577
  * eax = число сотых долей секунды, прошедших с момента
1578
    запуска системы
1579
Замечания:
1580
  * Счётчик берётся по модулю 2^32, что соответствует немногим более
1581
    497 суток.
1582
  * Системное время можно получить функцией 3.
1583
 
1584
======================================================================
1585
====== Функция 26, подфункция 10 - получить канал DMA для звука. =====
1586
======================================================================
1587
Параметры:
1588
  * eax = 26 - номер функции
1589
  * ebx = 10 - номер подфункции
1590
Возвращаемое значение:
1591
  * eax = номер канала (от 0 до 3 включительно)
1592
Замечания:
1593
  * Номер канала DMA используется в подфункции 1 функции 55.
1594
  * Установить канал DMA для звука можно вызовом
1595
    подфункции 10 функции 21.
1596
 
1597
======================================================================
1598
====================== Функция 26, подфункция 11 =====================
1599
=========== Узнать, разрешён ли низкоуровневый доступ к HD. ==========
1600
======================================================================
1601
Параметры:
1602
  * eax = 26 - номер функции
1603
  * ebx = 11 - номер подфункции
1604
Возвращаемое значение:
1605
  * eax = 0/1 - запрещён/разрешён
1606
Замечания:
1607
  * Используется при LBA-чтении (подфункция 8 функции 58).
1608
  * Установить текущее состояние можно вызовом
1609
    подфункции 11 функции 21.
1610
 
1611
======================================================================
1612
====================== Функция 26, подфункция 12 =====================
1613
========== Узнать, разрешён ли низкоуровневый доступ к PCI. ==========
1614
======================================================================
1615
Параметры:
1616
  * eax = 26 - номер функции
1617
  * ebx = 12 - номер подфункции
1618
Возвращаемое значение:
1619
  * eax = 0/1 - запрещён/разрешён
1620
Замечания:
1621
  * Используется при работе с шиной PCI (функция 62).
1622
  * Текущая реализация использует только младший бит ecx.
1623
  * Установить текущее состояние можно вызовом
1624
    подфункции 12 функции 21.
1625
 
1626
======================================================================
1627
==== Функция 27 - установить громкость Windows Sound System (WSS). ===
1628
======================================================================
1629
Параметры:
1630
  * eax = 27 - номер функции
1631
  * ebx = что устанавливать:
1632
    * 1 - установить общую громкость
1633
    * 2 - установить громкость Line In
1634
  * cl = уровень громкости (0x0=самый высокий, 0x1F=самый низкий,
1635
    установленный бит 0x80=отключить)
1636
Возвращаемое значение:
1637
  * eax = 0 - успешно
1638
  * eax = 1 - не определена база WSS
1639
  * eax = 2 - неверная подфункция
1640
Замечания:
1641
  * Предварительно нужно определить базовый порт WSS вызовом
1642
    подфункции 6 функции 21.
1643
  * Установка общей громкости фактически игнорируется
1644
    (возвращается eax=0).
1645
  * В старой документации и в исходниках ядра подфункция 2
1646
    ошибочно названа громкостью CD-audio.
1647
 
1648
======================================================================
1649
=============== Функция 28 - установить громкость SB16. ==============
1650
======================================================================
1651
Параметры:
1652
  * eax = 28 - номер функции
1653
  * ebx = что устанавливать:
1654
    * 1 - установить общую громкость
1655
    * 2 - установить громкость CD-audio
1656
  * cl = уровень громкости (0=off, 0xFF=max)
1657
Возвращаемое значение:
1658
  * eax = 0 - успешно
1659
  * eax = 1 - не определена база SB
1660
  * eax = 2 - неверная подфункция
1661
Замечания:
1662
  * Предварительно нужно определить базовый порт SB вызовом
1663
    подфункции 4 функции 21.
1664
  * Эта функция предоставляет больше вариантов для громкости,
1665
    чем функция 25.
1666
 
1667
======================================================================
1668
================ Функция 29 - получить системную дату. ===============
1669
======================================================================
1670
Параметры:
1671
  * eax = 29 - номер функции
1672
Возвращаемое значение:
1673
  * eax = 0x00DDMMYY, где
1674
    (используется двоично-десятичное кодирование, BCD)
1675
  * YY = две младшие цифры года (00..99)
1676
  * MM = месяц (01..12)
1677
  * DD = день (01..31)
1678
Замечания:
1679
  * Системную дату можно установить функцией 22.
1680
 
1681
======================================================================
1682
================ Функция 32 - удалить файл с рамдиска. ===============
1683
======================================================================
1684
Параметры:
1685
  * eax = 32 - номер функции
1686
  * ebx = указатель на имя файла
1687
Возвращаемое значение:
1688
  * eax = 0 - успешно; иначе код ошибки файловой системы
1689
Замечания:
1690
  * Эта функция устарела; функция 58 позволяет выполнять
1691
    те же действия с расширенными возможностями.
1692
  * Текущая реализация возвращает только значения 0(успех) и
1693
    5(файл не найден).
1694
  * Имя файла должно быть либо в формате 8+3 символов (первые
1695
    8 символов - собственно имя, последние 3 - расширение,
1696
    короткие имена и расширения дополняются пробелами),
1697
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1698
    (имя не более 8 символов, точка, расширение 3 символа,
1699
    дополненное при необходимости пробелами).
1700
    Имя файла должно быть записано заглавными буквами.
1701
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
1702
 
1703
======================================================================
1704
=============== Функция 33 - записать файл на рамдиск. ===============
1705
======================================================================
1706
Параметры:
1707
  * eax = 33 - номер функции
1708
  * ebx = указатель на имя файла
1709
  * ecx = указатель на данные для записи
1710
  * edx = число байт для записи
1711
  * следует устанавливать esi=0
1712
Возвращаемое значение:
1713
  * eax = 0 - успешно, иначе код ошибки файловой системы
1714
Замечания:
1715
  * Эта функция устарела; функция 58 позволяет выполнять
1716
    те же действия с расширенными возможностями.
1717
  * Если указать ненулевое значение в esi и на рамдиске уже есть
1718
    указанный файл, то будет создан ещё один файл с тем же именем.
1719
  * В противном случае файл перезаписывается.
1720
  * Имя файла должно быть либо в формате 8+3 символов
1721
    (первые 8 символов - собственно имя, последние 3 - расширение,
1722
    короткие имена и расширения дополняются пробелами),
1723
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1724
    (имя не более 8 символов, точка, расширение 3 символа,
1725
    дополненное при необходимости пробелами).
1726
    Имя файла должно быть записано заглавными буквами.
1727
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
1728
 
1729
======================================================================
1730
============ Функция 35 - прочитать цвет точки на экране. ============
1731
======================================================================
1732
Параметры:
1733
  * eax = 35
1734
  * ebx = y*xsize+x, где
1735
  * (x,y) = координаты точки (считая от 0)
1736
  * xsize = размер экрана по горизонтали
1737
Возвращаемое значение:
1738
  * eax = цвет 0x00RRGGBB
1739
Замечания:
1740
  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
1741
    что она вычитает 1 из обоих размеров.
1742
  * К видеопамяти есть также прямой доступ (без вызовов системных
1743
    функций) через селектор gs. Параметры текущего видеорежима
1744
    можно получить функцией 61.
1745
 
1746
======================================================================
1747
========== Функция 37 - получить координаты/состояние мыши. ==========
1748
======================================================================
1749
 
1750
-------------- Подфункция 0 - экранные координаты мыши ---------------
1751
Параметры:
1752
  * eax = 37 - номер функции
1753
  * ebx = 0 - номер подфункции
1754
Возвращаемое значение:
1755
  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
1756
 
1757
---------- Подфункция 1 - координаты мыши относительно окна ----------
1758
Параметры:
1759
  * eax = 37 - номер функции
1760
  * ebx = 1 - номер подфункции
1761
Возвращаемое значение:
1762
  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
1763
    окна приложения (считая от 0)
1764
Замечания:
1765
  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
1766
    Если y>=ywnd, то младшее слово неотрицательно и содержит
1767
    относительную y-координату, а старшее - относительную x-координату
1768
    (правильного знака). В противном случае младшее слово отрицательно
1769
    и всё равно содержит относительную y-координату,
1770
    а к старшему слову следует прибавить 1.
1771
 
1772
----------------- Подфункция 2 - нажатые кнопки мыши -----------------
1773
Параметры:
1774
  * eax = 37 - номер функции
1775
  * ebx = 2 - номер подфункции
1776
Возвращаемое значение:
1777
  * eax содержит информацию о нажатых кнопках мыши:
1778
  * бит 0 установлен = левая кнопка нажата
1779
  * бит 1 установлен = правая кнопка нажата
1780
  * прочие биты сброшены
1781
 
1782
======================================================================
1783
================== Функция 38 - нарисовать отрезок. ==================
1784
======================================================================
1785
Параметры:
1786
  * eax = 38 - номер функции
1787
  * ebx = [координата начала по оси x]*65536 +
1788
              [координата конца по оси x]
1789
  * ecx = [координата начала по оси y]*65536 +
1790
              [координата конца по оси y]
1791
  * edx = 0x00RRGGBB - цвет
1792
Возвращаемое значение:
1793
  * функция не возвращает значения
1794
Замечания:
1795
  * Координаты берутся относительно окна.
1796
  * Конечная точка также рисуется.
1797
 
1798
======================================================================
1799
== Функция 39, подфункция 1 - получить размер фонового изображения. ==
1800
======================================================================
1801
Параметры:
1802
  * eax = 39 - номер функции
1803
  * ebx = 1 - номер подфункции
1804
Возвращаемое значение:
1805
  * eax = [ширина]*65536 + [высота]
1806
Замечания:
1807
  * Есть парная команда установки размеров фонового изображения -
1808
    подфункция 1 функции 15. После которой, разумеется, следует
1809
    заново определить само изображение.
1810
 
1811
======================================================================
1812
= Функция 39, подфункция 2 - прочитать точку с фонового изображения. =
1813
======================================================================
1814
Параметры:
1815
  * eax = 39 - номер функции
1816
  * ebx = 2 - номер подфункции
1817
  * ecx = смещение
1818
Возвращаемое значение:
1819
  * eax = 0x00RRGGBB - цвет точки, если смещение допустимо
1820
    (меньше 0x160000-16)
1821
  * eax = 2 - иначе
1822
Замечания:
1823
  * Не следует полагаться на возвращаемое значение в случае неверного
1824
    смещения, оно может измениться в следующих версиях ядра.
1825
  * Смещение точки с координатами (x,y) вычисляется как (x+y*xsize)*3.
1826
  * Есть парная функция установки точки на фоновом изображении -
1827
    подфункция 2 функции 15.
1828
 
1829
======================================================================
1830
====== Функция 39, подфункция 4 - получить режим отрисовки фона. =====
1831
======================================================================
1832
Параметры:
1833
  * eax = 39 - номер функции
1834
  * ebx = 4 - номер подфункции
1835
Возвращаемое значение:
1836
  * eax = 1 - замостить
1837
  * eax = 2 - растянуть
1838
Замечания:
1839
  * Есть парная функция установки режима отрисовки фона -
1840
    подфункция 4 функции 15.
1841
 
1842
======================================================================
1843
======== Функция 40 - установить маску для ожидаемых событий. ========
1844
======================================================================
1845
Маска для ожидаемых событий влияет на функции работы с событиями 10,
1846
11, 23 - они сообщают только о событиях, разрешённых этой маской.
1847
Параметры:
1848
  * eax = 40 - номер функции
1849
  * ebx = маска: бит i соответствует событию i+1 (см. список событий)
1850
    (установленный бит разрешает извещение о событии)
1851
Возвращаемое значение:
1852
  * функция не возвращает значения
1853
Замечания:
1854
  * Маска по умолчанию (7=111b) разрешает извещения о перерисовке
1855
    и нажатиях клавиш и кнопок.
1856
    Этого достаточно для большинства приложений.
1857
  * События, запрещённые в маске, всё равно сохраняются, если
1858
    приходят; о них просто не извещают функции работы с событиями.
1859
  * Функции работы с событиями учитывают маску на момент
1860
    вызова функции, а не на момент поступления сообщения.
1861
 
1862
======================================================================
1863
================= Функция 41 - узнать владельца IRQ. =================
1864
======================================================================
1865
Параметры:
1866
  * eax = 41 - номер функции
1867
  * ebx = номер IRQ, 0..15
1868
Возвращаемое значение:
1869
  * eax = PID владельца
1870
  * eax = 0, если владельца нет
1871
  * eax = -1 для некорректного ebx
1872
 
1873
======================================================================
1874
========== Функция 42 - прочитать данные, полученные по IRQ. =========
1875
======================================================================
1876
При возникновении IRQ система может считывать данные из указанных
1877
ранее функцией 44 портов и записывать эти данные в буфер.
1878
Описываемая функция считывает побайтно данные из этого буфера.
1879
Параметры:
1880
  * eax = 42 - номер функции
1881
  * ebx = номер IRQ, 0..15
1882
Возвращаемое значение: (ситуацию можно различить по значению ecx)
1883
  * если поток не является владельцем IRQ
1884
    (или номер IRQ задан неверно):
1885
    * ecx = 2
1886
  * если данных нет:
1887
    * eax = 0
1888
    * ecx = 1
1889
    * ebx разрушается
1890
  * если всё в порядке и данные были:
1891
    * eax = размер данных, ещё не прочитанных из буфера (в байтах)
1892
    * ecx = 0
1893
    * ebx = очередной байт
1894
Замечания:
1895
  * Предварительно поток должен зарезервировать для себя указанный IRQ
1896
    функцией 45.
1897
  * Размер буфера для данных - 4000 байт, при переполнении
1898
    "свежие" данные перестают записываться в буфер.
1899
 
1900
======================================================================
1901
=================== Функция 43 - ввод/вывод в порт. ==================
1902
======================================================================
1903
 
1904
------------------------ Вывод данных в порт -------------------------
1905
Параметры:
1906
  * eax = 43 - номер функции
1907
  * bl = байт для вывода
1908
  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
1909
Возвращаемое значение:
1910
  * eax = 0 - успешно
1911
  * eax = 1 - поток не зарезервировал указанный порт
1912
 
1913
------------------------ Ввод данных из порта ------------------------
1914
Параметры:
1915
  * eax = 43 - номер функции
1916
  * ebx игнорируется
1917
  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
1918
Возвращаемое значение:
1919
  * eax = 0 - успешно, при этом ebx = введённый байт
1920
  * eax = 1 - поток не зарезервировал данный порт
1921
Замечания:
1922
  * Предварительно поток должен зарезервировать за собой
1923
    указанный порт функцией 46.
1924
  * Для зарезервированных портов вместо вызова этих функций
1925
    лучше использовать команды процессора in/out - это значительно
1926
    быстрее и несколько короче и проще. Из незарезервированных
1927
    портов читать всё равно нельзя.
1928
 
1929
======================================================================
1930
======== Функция 44 - определить действия при поступлении IRQ. =======
1931
======================================================================
1932
При возникновении IRQ система может считывать данные из указанных этой
1933
функцией портов и записывать эти данные в буфер, откуда их можно
1934
прочитать функцией 42.
1935
Параметры:
1936
  * eax = 44 - номер функции
1937
  * ebx = указатель на массив структур, описывающих по одному порту:
1938
    * +0: word: 0 означает конец массива, иначе номер порта
1939
    * +2: byte: зарезервировано (игнорируется)
1940
    * +3: byte: 1=считывать байт из этого порта, 2=считывать слово
1941
  * ecx = номер IRQ, 0..15
1942
Возвращаемое значение:
1943
  * eax = 0 - успешно
1944
  * eax = 1 - поток не является владельцем указанного IRQ
1945
Замечания:
1946
  * Предварительно поток должен зарезервировать за собой
1947
    указываемый IRQ функцией 45.
1948
  * Принимаются во внимание только первые 16 портов.
1949
  * Текущая реализация рассматривает неправильное значение поля +3
1950
    как сигнал прекращения обработки IRQ.
1951
 
1952
======================================================================
1953
============ Функция 45 - зарезервировать/освободить IRQ. ============
1954
======================================================================
1955
Параметры:
1956
  * eax = 45 - номер функции
1957
  * ebx = 0 - зарезервировать, 1 = освободить
1958
  * ecx = номер IRQ, 0..15
1959
Возвращаемое значение:
1960
  * eax = 0 - успешно
1961
  * eax = 1 - ошибка (неверный номер IRQ или
1962
    попытка зарезервировать несвободный IRQ или освободить IRQ, не
1963
    зарезервированный текущим потоком)
1964
Замечания:
1965
  * Резервирование IRQ нужно для работы функций 42 и 44.
1966
  * Только один поток может зарезервировать конкретный IRQ.
1967
  * IRQ, обрабатываемые системой самостоятельно, резервируются
1968
    системой (потоком 1) при загрузке.
1969
  * При завершении потока автоматически освобождаются
1970
    все зарезервированные им IRQ.
1971
 
1972
======================================================================
1973
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
1974
======================================================================
1975
К зарезервированным портам можно обращаться напрямую из приложения
1976
командами in/out (рекомендуемый способ) и вызовом функции 43
1977
(нерекомендуемый способ).
1978
Параметры:
1979
  * eax = 46 - номер функции
1980
  * ebx = 0 - зарезервировать, 1 - освободить
1981
  * ecx = номер начала диапазона портов
1982
  * edx = номер конца диапазона портов (включительно)
1983
Возвращаемое значение:
1984
  * eax = 0 - успешно
1985
  * eax = 1 - ошибка
1986
Замечания:
1987
  * В случае резервирования портов ошибкой считается выполнение
1988
    одного из условий:
1989
    * начальный адрес больше конечного;
1990
    * указанный диапазон содержит некорректный номер порта
1991
      (корректные - от 0 до 0xFFFF);
1992
    * превышено ограничение на общее число зарезервированных областей
1993
      - допускается максимум 255;
1994
    * указанный диапазон пересекается с одним из
1995
      ранее зарезервированных
1996
  * В случае освобождения портов ошибкой считается попытка
1997
    освобождения диапазона, который ранее не был целиком
1998
    зарезервирован этой же функцией (с такими же значениями ecx,edx).
1999
  * При обнаружении ошибки (в обоих случаях) никаких действий
2000
    не производится.
2001
  * При загрузке система резервирует за собой порты 0..0xff, а при
2002
    обнаружении COM-мыши - дополнительно диапазон COM-портов
2003
    0x3f0..0x3ff и/или 0x2f0..0x2ff.
2004
  * При завершении потока автоматически освобождаются все
2005
    зарезервированные им порты.
2006
 
2007
======================================================================
2008
================= Функция 47 - вывести число в окно. =================
2009
======================================================================
2010
Параметры:
2011
  * eax = 47 - номер функции
2012
  * ebx = параметры преобразования числа в текст:
2013
    * bl = 0 - ecx содержит число
2014
    * bl = 1 - ecx содержит указатель на dword-число
2015
    * bh = 0 - отображать в десятичной системе счисления
2016
    * bh = 1 - отображать в шестнадцатеричной системе
2017
    * bh = 2 - отображать в двоичной системе
2018
    * биты 16-21 = сколько цифр отображать
2019
    * биты 22-31 зарезервированы и должны быть установлены в 0
2020
  * ecx = число (при bl=0) или указатель (при bl=1)
2021
  * edx = [координата по оси x]*65536 + [координата по оси y]
2022
  * esi = 0xN0RRGGBB, RRGGBB=цвет, N=шрифт (0/1)
2023
Возвращаемое значение:
2024
  * функция не возвращает значения
2025
Замечания:
2026
  * Указанная длина не должна превосходить 60.
2027
  * Выводится ровно указанное количество цифр. Если число мало и
2028
    может быть записано меньшим количеством цифр, оно дополняется
2029
    ведущими нулями; если число велико и не может быть записано
2030
    таким количеством цифр, "лишние" ведущие цифры обрезаются.
2031
  * Параметры шрифтов указаны в описании функции 4 (вывода текста).
2032
 
2033
======================================================================
2034
======= Функция 48, подфункция 0 - применить настройки экрана. =======
2035
======================================================================
2036
Параметры:
2037
  * eax = 48 - номер функции
2038
  * ebx = 0 - номер подфункции
2039
  * ecx = 0 - зарезервировано
2040
Возвращаемое значение:
2041
  * функция не возвращает значения
2042
Замечания:
2043
  * Функция перерисовывает экран после изменения параметров
2044
    подфункциями 1 и 2.
2045
  * Вызов функции без предшествующих вызовов указанных подфункций
2046
    игнорируется.
2047
  * Вызов функции с ненулевым ecx игнорируется.
2048
 
2049
======================================================================
2050
========= Функция 48, подфункция 1 - установить стиль кнопок. ========
2051
======================================================================
2052
Параметры:
2053
  * eax = 48 - номер функции
2054
  * ebx = 1 - номер подфункции
2055
  * ecx = тип кнопок:
2056
    * 0 = плоские
2057
    * 1 = объёмные
2058
Возвращаемое значение:
2059
  * функция не возвращает значения
2060
Замечания:
2061
  * После вызова описываемой функции следует перерисовать экран
2062
    подфункцией 0.
2063
  * Тип кнопок влияет только на их прорисовку функцией 8.
2064
 
2065
======================================================================
2066
==== Функция 48, подфункция 2 - установить стандартные цвета окон. ===
2067
======================================================================
2068
Параметры:
2069
  * eax = 48 - номер функции
2070
  * ebx = 2 - номер подфункции
2071
  * ecx = указатель на таблицу цветов
2072
  * edx = размер таблицы цветов
2073
    (должен быть 40 байт для будущей совместимости)
2074
Формат таблицы цветов указан в описании подфункции 3.
2075
Возвращаемое значение:
2076
  * функция не возвращает значения
2077
Замечания:
2078
  * После вызова описываемой функции следует перерисовать экран
2079
    подфункцией 0.
2080
  * Таблица стандартных цветов влияет только на приложения,
2081
    которые эту таблицу явным образом получают (подфункцией 3) и
2082
    используют (указывая цвета из неё при вызовах функций рисования).
2083
  * Таблица стандартных цветов входит в скин и устанавливается заново
2084
    при установке скина (подфункции 8).
2085
  * Таблицу цветов можно просматривать/изменять интерактивно с помощью
2086
    приложения desktop.
2087
 
2088
======================================================================
2089
===== Функция 48, подфункция 3 - получить стандартные цвета окон. ====
2090
======================================================================
2091
Параметры:
2092
  * eax = 48 - номер функции
2093
  * ebx = 3 - номер подфункции
2094
  * ecx = указатель на буфер размером edx байт,
2095
    куда будет записана таблица
2096
  * edx = размер таблицы цветов
2097
    (должен быть 40 байт для будущей совместимости)
2098
Возвращаемое значение:
2099
  * функция не возвращает значения
2100
Формат таблицы цветов: каждый элемент -
2101
dword-значение цвета 0x00RRGGBB
2102
  * +0: dword: frames - цвет рамки
2103
  * +4: dword: grab - цвет заголовка
2104
  * +8: dword: grab_button - цвет кнопки на полосе заголовка
2105
  * +12 = +0xC: dword: grab_button_text - цвет текста на кнопке
2106
    на полосе заголовка
2107
  * +16 = +0x10: dword: grab_text - цвет текста на заголовке
2108
  * +20 = +0x14: dword: work - цвет рабочей области
2109
  * +24 = +0x18: dword: work_button - цвет кнопки в рабочей области
2110
  * +28 = +0x1C: dword: work_button_text - цвет текста на кнопке
2111
    в рабочей области
2112
  * +32 = +0x20: dword: work_text - цвет текста в рабочей области
2113
  * +36 = +0x24: dword: work_graph - цвет графики в рабочей области
2114
Замечания:
2115
  * Структура таблицы цветов описана в стандартном включаемом файле
2116
    macros.inc под названием system_colors; например, можно писать:
2117
    	sc	system_colors		; объявление переменной
2118
    	...				; где-то надо вызвать
2119
    					; описываемую функцию с ecx=sc
2120
    	mov	ecx, [sc.work_button_text]	; читаем цвет текста
2121
    					; на кнопке в рабочей области
2122
  * Использование/неиспользование этих цветов - дело исключительно
2123
    самой программы. Для использования нужно просто при вызове функций
2124
    рисования указывать цвет, взятый из этой таблицы.
2125
  * При изменении таблицы стандартных цветов (подфункцией 2 с
2126
    последующим применением изменений подфункцией 0 или
2127
    при установке скина подфункцией 8) всем окнам посылается сообщение
2128
    о необходимости перерисовки (событие с кодом 1).
2129
  * Стандартные цвета можно просматривать/изменять интерактивно
2130
    с помощью приложения desktop.
2131
 
2132
======================================================================
2133
========== Функция 48, подфункция 4 - получить высоту скина. =========
2134
======================================================================
2135
Параметры:
2136
  * eax = 48 - номер функции
2137
  * ebx = 4 - номер подфункции
2138
Возвращаемое значение:
2139
  * eax = высота скина
2140
Замечания:
2141
  * Высотой скина по определению считается высота заголовка окон,
2142
    использующих скин.
2143
  * Смотри также общую структуру окна в описании функции 0.
2144
 
2145
======================================================================
2146
===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
2147
======================================================================
2148
Параметры:
2149
  * eax = 48 - номер функции
2150
  * ebx = 5 - номер подфункции
2151
Возвращаемое значение:
2152
  * eax = [left]*65536 + [right]
2153
  * ebx = [top]*65536 + [bottom]
2154
Замечания:
2155
  * Рабочая область экрана определяет положение и координаты
2156
    максимизированного окна.
2157
  * Рабочая область экрана при нормальной работе есть весь экран
2158
    за вычетом панели (@panel).
2159
  * (left,top) - координаты левого верхнего угла,
2160
    (right,bottom) - координаты правого нижнего.
2161
    Таким образом, размер рабочей области по оси x определяется
2162
    формулой right-left+1, по оси y - формулой bottom-right+1.
2163
  * Смотри также функцию 14,
2164
    позволяющую определить размеры всего экрана.
2165
  * Есть парная функция установки рабочей области - подфункция 6.
2166
 
2167
======================================================================
2168
==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
2169
======================================================================
2170
Параметры:
2171
  * eax = 48 - номер функции
2172
  * ebx = 6 - номер подфункции
2173
  * ecx = [left]*65536 + [right]
2174
  * edx = [top]*65536 + [bottom]
2175
Возвращаемое значение:
2176
  * функция не возвращает значения
2177
Замечания:
2178
  * Рабочая область экрана определяет положение и координаты
2179
    максимизированного окна.
2180
  * Эта функция используется только приложением @panel,
2181
    устанавливающим рабочей областью весь экран за вычетом панели.
2182
  * (left,top) - координаты левого верхнего угла,
2183
    (right,bottom) - координаты правого нижнего.
2184
    Таким образом, размер рабочей области по оси x определяется
2185
    формулой right-left+1, по оси y - формулой bottom-right+1.
2186
  * Если left>=right, то x-координаты рабочей области не изменяются.
2187
    Если left<0, то left не устанавливается. Если right больше
2188
    или равно ширины экрана, то right не устанавливается.
2189
    Аналогично по оси y.
2190
  * Смотри также функцию 14,
2191
    позволяющую определить размеры всего экрана.
2192
  * Есть парная функция получения рабочей области -
2193
    подфункция 5.
2194
  * Эта функция автоматически перерисовывает экран, по ходу дела
2195
    обновляет координаты и положение максимизированных окон.
2196
    Все окна извещаются о необходимости перерисовки (событие 1).
2197
 
2198
======================================================================
2199
====================== Функция 48, подфункция 7 ======================
2200
============ Получить область скина для текста заголовка. ============
2201
======================================================================
2202
Возвращает область заголовка окна со скином, предназначенную
2203
для вывода текста заголовка.
2204
Параметры:
2205
  * eax = 48 - номер функции
2206
  * ebx = 7 - номер подфункции
2207
Возвращаемое значение:
2208
  * eax = [left]*65536 + [right]
2209
  * ebx = [top]*65536 + [bottom]
2210
Замечания:
2211
  * Использование/неиспользование этой функции -
2212
    личное дело приложения.
2213
  * Рекомендуется учитывать значения, возвращаемые этой функцией,
2214
    при выборе места для рисования текста заголовка (функцией 4) или
2215
    какого-нибудь заменителя текста заголовка
2216
    (по усмотрению приложения).
2217
 
2218
======================================================================
2219
==== Функция 48, подфункция 8 - установить используемый скин окон. ===
2220
======================================================================
2221
Параметры:
2222
  * eax = 48 - номер функции
2223
  * ebx = 8 - номер подфункции
2224
  * ecx = указатель на блок для функции 58, в котором установлено
2225
    поле промежуточного буфера и указано имя файла
2226
Возвращаемое значение:
2227
  * eax = 0 - успешно
2228
  * иначе eax = код ошибки файловой системы; если файл не задаёт скин,
2229
    то возвращается ошибка 3 (неизвестная файловая система).
2230
Замечания:
2231
  * При успешной загрузке скина все окна извещаются о необходимости
2232
    перерисовки (событие 1).
2233
  * При загрузке система считывает скин из файла default.skn
2234
    на рамдиске.
2235
  * Пользователь может изменять скин статически, создав свой
2236
    default.skn, или динамически с помощью приложения desktop.
2237
 
2238
======================================================================
78 diamond 2239
============ Функция 49 - Advanced Power Management (APM). ===========
2240
======================================================================
2241
Параметры:
2242
  * eax = 49 - номер функции
2243
  * dx = номер функции APM (аналог ax в спецификации)
2244
  * bx, cx = параметры функции APM
2245
Возвращаемое значение:
2246
  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
2247
    установлены в соответствии со спецификацией APM
2248
  * старшие половины 32-битных регистров eax, ebx, ecx,
2249
    edx, esi, edi разрушаются
2250
Замечания:
2251
  * Спецификация APM 1.2 описывается в документе
2252
    "Advanced Power Management (APM) BIOS Specification"
2253
    (Revision 1.2), доступном на
2254
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2255
    кроме того, она включена в известный Interrupt List by Ralf Brown
2256
    (http://www.pobox.com/~ralf/files.html,
2257
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2258
 
2259
======================================================================
77 diamond 2260
================= Функция 50 - установка формы окна. =================
2261
======================================================================
2262
Обычные окна представляют собой прямоугольники. С помощью этой функции
2263
окну можно придать произвольную форму. Форма задаётся набором точек
2264
внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
2265
размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
2266
функцией 67.
2267
 
2268
--------------- Установка данных с информацией о форме ---------------
2269
Параметры:
2270
  * eax = 50 - номер функции
2271
  * ebx = 0 - номер подфункции
2272
  * ecx = указатель на данные формы (массив байт 0/1)
2273
Возвращаемое значение:
2274
  * функция не возвращает значения
2275
 
2276
------------------ Установка масштаба данных формы -------------------
2277
Параметры:
2278
  * eax = 50 - номер функции
2279
  * ebx = 1 - номер подфункции
2280
  * ecx задаёт масштаб: каждый байт данных определяет
2281
    (2^scale)*(2^scale) пикселей
2282
Возвращаемое значение:
2283
  * функция не возвращает значения
2284
Замечания:
2285
  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
2286
    данных формы один байт соответствует одному пикселю, то масштаб
2287
    можно не устанавливать.
2288
  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
2289
    обратите внимание, что они на единицу больше, чем устанавливаемые
2290
    функциями 0, 67.
2291
  * По определению масштаба xsize и ysize должны делиться на 2^scale.
2292
  * Байт данных по смещению a должен быть 0/1 и
2293
    определяет принадлежность окну квадрата со стороной 2^scale
2294
    (при scale=0 получаем пиксель) и координатами левого верхнего угла
2295
    (a mod (xsize shr scale), a div (xsize shr scale))
2296
  * Размер данных: (xsize shr scale)*(ysize shr scale).
2297
  * Данные должны присутствовать в памяти и не меняться
2298
    после установки формы.
2299
  * Система просматривает данные о форме при каждой перерисовке окна
2300
    функцией 0.
2301
  * Вызов подфункции 0 с нулевым указателем приводит к возврату
2302
    к прямоугольной форме.
2303
 
2304
======================================================================
2305
===================== Функция 51 - создать поток. ====================
2306
======================================================================
2307
Параметры:
2308
  * eax = 51 - номер функции
2309
  * ebx = 1 - единственная подфункция
2310
  * ecx = адрес точки входа потока (начальный eip)
2311
  * edx = указатель стэка потока (начальный esp)
2312
Возвращаемое значение:
2313
  * eax = -1 - ошибка (в системе слишком много потоков)
2314
  * иначе eax = TID - идентификатор потока
2315
 
2316
======================================================================
2317
= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
2318
======================================================================
2319
Параметры:
2320
  * eax = 52 - номер функции
2321
  * ebx = 0 - номер подфункции
2322
Возвращаемое значение:
2323
  * eax = двойное слово конфигурации
2324
Замечания:
2325
  * Слово конфигурации можно установить подфункцией 2.
2326
  * Ядро не использует соответствующую переменную.
2327
    Ценность этой переменной и работающих с ней подфункций 0 и 2
2328
    представляется сомнительной.
2329
 
2330
======================================================================
2331
======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
2332
======================================================================
2333
Параметры:
2334
  * eax = 52 - номер функции
2335
  * ebx = 1 - номер подфункции
2336
Возвращаемое значение:
2337
  * eax = IP-адрес (4 байта)
2338
Замечания:
2339
  * Локальный IP-адрес устанавливается подфункцией 3.
2340
 
2341
======================================================================
2342
 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
2343
======================================================================
2344
Параметры:
2345
  * eax = 52 - номер функции
2346
  * ebx = 2 - номер подфункции
2347
  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
2348
    число 3, это воспринимается как запрос на [пере-]инициализацию
2349
    Ethernet-карты, в противном случае Ethernet выключается
2350
Возвращаемое значение:
2351
  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
2352
    но это может измениться в будущих версиях ядра
2353
  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
2354
    (отсутствие Ethernet-карты), а ненулевое значение - успех
2355
Замечания:
2356
  * Слово конфигурации можно прочитать подфункцией 0.
2357
  * Ядро не использует соответствующую переменную.
2358
    Ценность этой переменной, подфункции 0 и части подфункции 2,
2359
    устанавливающей эту переменную, представляется сомнительной.
2360
 
2361
======================================================================
2362
====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
2363
======================================================================
2364
Параметры:
2365
  * eax = 52 - номер функции
2366
  * ebx = 3 - номер подфункции
2367
  * ecx = IP-адрес (4 байта)
2368
Возвращаемое значение:
2369
  * текущая реализация возвращает eax=3, но это может быть изменено
2370
    в будущих версиях
2371
Замечания:
2372
  * Локальный IP-адрес можно получить подфункцией 1.
2373
 
2374
======================================================================
2375
= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
2376
======================================================================
2377
Параметры:
2378
  * eax = 52 - номер функции
2379
  * ebx = 6 - номер подфункции
2380
  * edx = размер данных
2381
  * esi = указатель на данные
2382
Возвращаемое значение:
2383
  * eax = -1 - ошибка
2384
  * eax = 0 - успешно
2385
Замечания:
2386
  * Эта функция предназначена только для медленных сетевых драйверов
2387
    (PPP, SLIP).
2388
  * Размер данных не должен превосходить 1500 байт,
2389
    хотя проверок корректности не делается.
2390
 
2391
======================================================================
2392
====================== Функция 52, подфункция 8 ======================
2393
============= Прочитать данные из сетевой очереди вывода. ============
2394
======================================================================
2395
Параметры:
2396
  * eax = 52 - номер функции
2397
  * ebx = 8 - номер подфункции
2398
  * esi = указатель на буфер размером 1500 байт
2399
Возвращаемое значение:
2400
  * eax = число прочитанных байт (в текущей реализации
2401
    либо 0 = нет данных, либо 1500)
2402
  * данные скопированы в буфер
2403
Замечания:
2404
  * Эта функция предназначена только для медленных сетевых драйверов
2405
    (PPP, SLIP).
2406
 
2407
======================================================================
2408
=========== Функция 52, подфункция 9 - получить gateway IP. ==========
2409
======================================================================
2410
Параметры:
2411
  * eax = 52 - номер функции
2412
  * ebx = 9 - номер подфункции
2413
Возвращаемое значение:
2414
  * eax = gateway IP (4 байта)
2415
 
2416
======================================================================
2417
========= Функция 52, подфункция 10 - получить маску подсети. ========
2418
======================================================================
2419
Параметры:
2420
  * eax = 52 - номер функции
2421
  * ebx = 10 - номер подфункции
2422
Возвращаемое значение:
2423
  * eax = маска подсети
2424
 
2425
======================================================================
2426
========= Функция 52, подфункция 11 - установить gateway IP. =========
2427
======================================================================
2428
Параметры:
2429
  * eax = 52 - номер функции
2430
  * ebx = 11 - номер подфункции
2431
  * ecx = gateway IP (4 байта)
2432
Возвращаемое значение:
2433
  * текущая реализация возвращает eax=11, но это может быть изменено
2434
    в будущих реализациях
2435
 
2436
======================================================================
2437
======== Функция 52, подфункция 12 - установить маску подсети. =======
2438
======================================================================
2439
Параметры:
2440
  * eax = 52 - номер функции
2441
  * ebx = 12 - номер подфункции
2442
  * ecx = маска подсети
2443
Возвращаемое значение:
2444
  * текущая реализация возвращает eax=12, но это может быть изменено
2445
    в будущих версиях
2446
 
2447
======================================================================
2448
============ Функция 52, подфункция 13 - получить DNS IP. ============
2449
======================================================================
2450
Параметры:
2451
  * eax = 52 - номер функции
2452
  * ebx = 13 - номер подфункции
2453
Возвращаемое значение:
2454
  * eax = DNS IP (4 байта)
2455
 
2456
======================================================================
2457
=========== Функция 52, подфункция 14 - установить DNS IP. ===========
2458
======================================================================
2459
Параметры:
2460
  * eax = 52 - номер функции
2461
  * ebx = 14 - номер подфункции
2462
  * ecx = DNS IP (4 байта)
2463
Возвращаемое значение:
2464
  * текущая реализация возвращает eax=14, но это может быть изменено
2465
    в следующих версиях
2466
 
2467
======================================================================
2468
============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========
2469
======================================================================
2470
Параметры:
2471
  * eax = 53 - номер функции
2472
  * ebx = 0 - номер подфункции
2473
  * ecx = локальный порт (учитывается только младшее слово)
2474
  * edx = удалённый порт (учитывается только младшее слово)
2475
  * esi = удалённый IP
2476
Возвращаемое значение:
2477
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2478
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2479
    сокет и имеющее смысл только для системы) - успешно;
2480
    ebx разрушается
2481
 
2482
======================================================================
2483
============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========
2484
======================================================================
2485
Параметры:
2486
  * eax = 53 - номер функции
2487
  * ebx = 1 - номер подфункции
2488
  * ecx = хэндл сокета
2489
Возвращаемое значение:
2490
  * eax = -1 - неверный хэндл
2491
  * eax = 0 - успешно
2492
  * ebx разрушается
2493
Замечания:
2494
  * Текущая реализация не закрывает автоматически все сокеты потока
2495
    при его завершении. В частности, не следует прибивать поток
2496
    с кучей открытых сокетов - будет утечка ресурсов.
2497
  * Текущая реализация не делает проверок на корректность
2498
    (единственное, на что возвращается ошибка, - попытка закрыть
2499
    неоткрытый сокет с корректным хэндлом).
2500
 
2501
======================================================================
2502
============== Функция 53, подфункция 2 - опрос сокета. ==============
2503
======================================================================
2504
Параметры:
2505
  * eax = 53 - номер функции
2506
  * ebx = 2 - номер подфункции
2507
  * ecx = хэндл сокета
2508
Возвращаемое значение:
2509
  * eax = число полученных байт
2510
  * ebx разрушается
2511
Замечания:
2512
  * Проверки корректности не делается.
2513
 
2514
======================================================================
2515
======== Функция 53, подфункция 3 - прочитать байт из сокета. ========
2516
======================================================================
2517
Параметры:
2518
  * eax = 53 - номер функции
2519
  * ebx = 3 - номер подфункции
2520
  * ecx = хэндл сокета
2521
Возвращаемое значение:
2522
  * если нет принятых данных: eax=0, bl=0,
2523
    прочие байты ebx разрушаются
2524
  * если были принятые данные: eax=число оставшихся байт
2525
    (возможно, 0), bl=прочитанный байт, прочие байты ebx разрушаются
2526
Замечания:
2527
  * Проверки корректности не производится.
2528
 
2529
======================================================================
2530
========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========
2531
======================================================================
2532
Параметры:
2533
  * eax = 53 - номер функции
2534
  * ebx = 4 - номер подфункции
2535
  * ecx = хэндл сокета
2536
  * edx = число байт для записи
2537
  * esi = указатель на данные для записи
2538
Возвращаемое значение:
2539
  * eax = 0xffffffff - неверный хэндл
2540
  * eax = 0xffff - недостаточно памяти
2541
  * eax = 0 - успешно
2542
  * ebx разрушается
2543
Замечания:
2544
  * Проверка на валидность хэндла минимальна - исключаются только
2545
    не очень неправильные неоткрытые хэндлы.
2546
  * Число байт для записи не может превышать 1500-28, хотя
2547
    соответствующей проверки не делается.
2548
 
2549
======================================================================
2550
============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========
2551
======================================================================
2552
Параметры:
2553
  * eax = 53 - номер функции
2554
  * ebx = 5 - номер подфункции
2555
  * ecx = локальный порт (учитывается только младшее слово)
2556
  * edx = удалённый порт (учитывается только младшее слово)
2557
  * esi = удалённый IP
2558
  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1
2559
Возвращаемое значение:
2560
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2561
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2562
    сокет и имеющее смысл только для системы) - успешно;
2563
    ebx разрушается
2564
 
2565
======================================================================
2566
====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
2567
======================================================================
2568
Параметры:
2569
  * eax = 53 - номер функции
2570
  * ebx = 6 - номер подфункции
2571
  * ecx = хэндл сокета
2572
Возвращаемое значение:
2573
  * eax = статус сокета: одно из
2574
  * TCB_LISTEN = 1
2575
  * TCB_SYN_SENT = 2
2576
  * TCB_SYN_RECEIVED = 3
2577
  * TCB_ESTABLISHED = 4
2578
  * TCB_FIN_WAIT_1 = 5
2579
  * TCB_FIN_WAIT_2 = 6
2580
  * TCB_CLOSE_WAIT = 7
2581
  * TCB_CLOSING = 8
2582
  * TCB_LAST_ASK = 9
2583
  * TCB_TIME_WAIT = 10
2584
  * TCB_CLOSED = 11
2585
  * ebx разрушается
2586
Замечания:
2587
  * Проверок корректности не производится.
2588
 
2589
======================================================================
2590
========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
2591
======================================================================
2592
Параметры:
2593
  * eax = 53 - номер функции
2594
  * ebx = 7 - номер подфункции
2595
  * ecx = хэндл сокета
2596
  * edx = число байт для записи
2597
  * esi = указатель на данные для записи
2598
Возвращаемое значение:
2599
  * eax = 0xffffffff - ошибка
2600
  * eax = 0xffff - недостаточно памяти
2601
  * eax = 0 - успешно
2602
  * ebx разрушается
2603
Замечания:
2604
  * Проверка на валидность хэндла минимальна - исключаются только
2605
    не очень неправильные неоткрытые хэндлы.
2606
  * Число байт для записи не может превышать 1500-40,
2607
    хотя соответствующей проверки не делается.
2608
 
2609
======================================================================
2610
============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========
2611
======================================================================
2612
Параметры:
2613
  * eax = 53 - номер функции
2614
  * ebx = 8 - номер подфункции
2615
  * ecx = хэндл сокета
2616
Возвращаемое значение:
2617
  * eax = -1 - неверный хэндл
2618
  * eax = 0xffff - недостаточно памяти для пакета закрытия сокета
2619
  * eax = 0 - успешно
2620
  * во многих случаях eax разрушается (возвращается результат функции
2621
    queue) - видимо, это баг, который будет исправлен
2622
  * ebx разрушается
2623
Замечания:
2624
  * Текущая реализация не закрывает автоматически все сокеты потока
2625
    при его завершении. В частности, не следует прибивать поток
2626
    с кучей открытых сокетов - будет утечка ресурсов.
2627
  * Текущая реализация не делает проверок на корректность
2628
    (единственное, на что возвращается ошибка, - попытка закрыть
2629
    неоткрытый сокет с корректным хэндлом).
2630
 
2631
======================================================================
2632
== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =
2633
======================================================================
2634
Параметры:
2635
  * eax = 53 - номер функции
2636
  * ebx = 9 - номер подфункции
2637
  * ecx = номер локального порта (используются только младшие 16 бит)
2638
Возвращаемое значение:
2639
  * eax = 0 - порт используется
2640
  * eax = 1 - порт свободен
2641
  * ebx разрушается
2642
 
2643
======================================================================
2644
 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.
2645
======================================================================
2646
Параметры:
2647
  * eax = 53 - номер функции
2648
  * ebx = 255 - номер подфункции
2649
  * ecx = тип запрашиваемой информации (смотри ниже)
2650
Возвращаемое значение:
2651
  * eax = запрошенная информация
2652
  * ebx разрушается
2653
Возможные значения ecx:
2654
  * 100: длина очереди 0 (empty queue)
2655
  * 101: длина очереди 1 (ip-out queue)
2656
  * 102: длина очереди 2 (ip-in queue)
2657
  * 103: длина очереди 3 (net1out queue)
2658
  * 200: число элементов в таблице ARP
2659
  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)
2660
  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда
2661
    берут информацию 5 последующих типов;
2662
    в этом случае eax неопределён
2663
  * 203: IP-адрес, запомненный типом 202
2664
  * 204: старшее dword MAC-адреса, запомненного типом 202
2665
  * 205: младшее word MAC-адреса, запомненного типом 202
2666
  * 206: слово статуса, запомненное типом 202
2667
  * 207: слово ttl, запомненное типом 202
2668
  * 2: общее число полученных IP-пакетов
2669
  * 3: общее число переданных IP-пакетов
2670
  * 4: общее число сдампленных полученных пакетов
2671
  * 5: общее число полученных ARP-пакетов
2672
  * 6: статус драйвера пакетов, 0=неактивен,
2673
    ненулевое значение=активен
2674
 
2675
======================================================================
2676
======== Функция 55, подфункция 0 - загрузить данные для SB16. =======
2677
======================================================================
2678
Параметры:
2679
  * eax = 55 - номер функции
2680
  * ebx = 0 - номер подфункции
2681
  * ecx = указатель на данные (копируется 64 килобайта, используется
2682
    столько, сколько установлено подфункцией 2)
2683
Возвращаемое значение:
2684
  * функция не возвращает значения
2685
Замечания:
2686
  * Формат и размер данных устанавливаются подфункцией 2.
2687
 
2688
======================================================================
2689
==== Функция 55, подфункция 1 - начать проигрывать данные на SB16. ===
2690
======================================================================
2691
Параметры:
2692
  * eax = 55 - номер функции
2693
  * ebx = 1 - номер подфункции
2694
Возвращаемое значение:
2695
  * функция не возвращает значения
2696
Замечания:
2697
  * Предварительно данные должны быть загружены подфункцией 0 и
2698
    определён их формат подфункцией 2.
2699
  * Функция возвращает управление, когда началось проигрывание данных;
2700
    после этого проигрывание идёт независимо от приложения (и вообще
2701
    не требует загрузки процессора).
2702
  * Предварительно должны быть определены базовый порт SB16
2703
    (подфункцией 4 функции 21) и канал DMA
2704
    (подфункцией 10 функции 21).
2705
 
2706
======================================================================
2707
====== Функция 55, подфункция 2 - установить формат данных SB16. =====
2708
======================================================================
2709
Параметры:
2710
  * eax = 55 - номер функции
2711
  * ebx = 2 - номер подфункции
2712
  * ecx = 0 - установить разрядность
2713
    * edx = 1 - 8бит моно
2714
    * edx = 2 - 8бит стерео
2715
  * ecx = 1 - установить размер данных
2716
    * edx = размер в байтах
2717
  * ecx = 2 - установить частоту проигрывания
2718
    * edx = частота
2719
Возвращаемое значение:
2720
  * функция не возвращает значения
2721
Замечания:
2722
  * При загрузке системы устанавливаются следующие параметры
2723
    по умолчанию: разрядность - 8 бит моно, размер - 64 Кб,
2724
    частота 44100 Гц. Тем не менее рекомендуется явно устанавливать
2725
    необходимые значения, поскольку они могли быть переустановлены
2726
    какой-нибудь программой.
2727
 
2728
======================================================================
2729
====================== Функция 55, подфункция 55 =====================
2730
========== Начать проигрывать данные на встроенном спикере. ==========
2731
======================================================================
2732
Параметры:
2733
  * eax = 55 - номер функции
2734
  * ebx = 55 - номер подфункции
2735
  * esi = указатель на данные
2736
Возвращаемое значение:
2737
  * eax = 0 - успешно
2738
  * eax = 55 - ошибка (спикер отключён или занят)
2739
Данные - это массив элементов переменной длины.
2740
Формат каждого элемента определяется первым байтом:
2741
  * 0 = конец данных
2742
  * 1..0x80 = задаёт длительность звучания в сотых долях секунды
2743
    ноты, определяемой непосредственным значением частоты
2744
    * следующее слово (2 байта) содержит делитель частоты;
2745
      частота определяется как 1193180/divider
2746
  * 0x81 = invalid
2747
  * 0x82..0xFF = нота, определяемая октавой и номером:
2748
    * длительность в сотых долях секунды = (первый байт)-0x81
2749
    * присутствует ещё один байт;
2750
    * (второй байт)=0xFF - пауза
2751
    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
2752
      до 12, a=номер октавы (считая с 0)
2753
Замечания:
2754
  * Пищание спикером может быть запрещено/разрешено подфункцией 8
2755
    функции 18.
2756
  * Функция возвращает управление, сообщив куда следует информацию
2757
    о запросе. Само проигрывание идёт независимо от программы.
2758
  * Данные должны сохраняться в памяти по крайней мере
2759
    до конца проигрывания.
2760
 
2761
======================================================================
2762
============= Функция 56 - записать файл на жёсткий диск. ============
2763
======================================================================
2764
Параметры:
2765
  * eax = 56 - номер функции
2766
  * ebx = указатель на имя файла
2767
  * ecx = размер данных для записи (в байтах)
2768
  * edx = указатель на данные для записи
2769
  * esi = указатель на путь (ASCIIZ-строку)
2770
Возвращаемое значение:
2771
  * eax = 0 - успешно, иначе код ошибки файловой системы
2772
Замечания:
2773
  * Эта функция устарела; функция 58 позволяет выполнять
2774
    те же действия с расширенными возможностями.
2775
  * Данная функция предполагает, что во время её вызова одним
2776
    приложением никакое другое приложение не работает
2777
    с жёстким диском.
2778
  * Путь к файлу - ASCIIZ-строка, которая может быть пустой
2779
    (если файл создаётся в корневом каталоге) или иметь формат
2780
    /d1/d2/.../dn, где все имена папок должны иметь формат 8+3, т.е.
2781
    8 символов имени и 3 символа расширения без разделителя,
2782
    при необходимости дополненные пробелами;
2783
    все буквы должны быть заглавные.
2784
  * Имя к файлу также должно иметь формат 8+3.
2785
 
2786
======================================================================
2787
============== Функция 58 - работа с файловой системой. ==============
2788
======================================================================
2789
Параметры:
2790
  * eax = 58
2791
  * ebx = указатель на информационную структуру
2792
Возвращаемое значение:
2793
  * eax = 0 - успешно; иначе код ошибки файловой системы
2794
  * в зависимости от подфункции может возвращаться значение и
2795
    в других регистрах
2796
Общий формат информационной структуры:
2797
  * +0: dword: номер подфункции
2798
  * +4: dword: номер блока
2799
  * +8: dword: размер
2800
  * +12 = +0xC: dword: указатель на данные
2801
  * +16 = +0x10: dword: указатель на память для работы системы
2802
    (4096 байт)
2803
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
2804
Уточнения - в документации на соответствующую подфункцию.
2805
Имя файла нечувствительно к регистру латинских букв,
2806
русские буквы должны быть заглавными.
2807
Формат имени файла:
2808
/base/number/dir1/dir2/.../dirn/file,
2809
где /base/number идентифицирует устройство, на котором ищется файл:
2810
одно из
2811
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
2812
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
2813
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
2814
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к жёсткому диску
2815
    (в этом случае база определяется подфункцией 7 функции 21),
2816
    x - номер раздела (считая с 1)
2817
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
2818
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
2819
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2820
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
2821
    (на каждом из винчестеров нумерация начинается с 1)
2822
Замечания:
2823
  * В первых двух случаях допускается использование FIRST вместо 1,
2824
    SECOND вместо 2, но использовать эту возможность
2825
    не рекомендуется для удобства перехода на будущие расширения.
2826
  * Накладывается ограничение n<=39.
2827
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
2828
    имя не более 8 символов, точка, расширение не более 3 символов.
2829
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
2830
    Если имя занимает ровно 8 символов, точку можно опустить
2831
    (хотя пользоваться этим не рекомендуется для удобства перехода
2832
    на будущие расширения).
2833
Примеры:
2834
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2835
    '/rd/1/kernel.asm',0
2836
  * '/HD0/1/kernel.asm',0
2837
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2838
Доступные подфункции:
2839
  * подфункция 0 - чтение файла/папки
2840
  * подфункция 1 - перезапись файла
2841
  * подфункция 2 - удаление файла/папки
2842
  * подфункция 3 - запись данных в существующий файл
2843
  * подфункция 4 - создание папки
2844
  * подфункция 5 - переименование/перемещение файла/папки
2845
  * подфункция 8 - LBA-чтение с устройства
2846
  * подфункция 12 - определение размера файла
2847
  * подфункция 13 - определение атрибутов файла/папки
2848
  * подфункция 14 - определение даты/времени файла/папки
2849
  * подфункция 15 - получение информации о файловой системе
2850
  * подфункция 16 - запуск приложения
2851
 
2852
======================================================================
2853
========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
2854
======================================================================
2855
Параметры:
2856
  * eax = 58
2857
  * ebx = указатель на информационную структуру
2858
Формат информационной структуры:
2859
  * +0: dword: 0 = номер подфункции
2860
  * +4: dword: номер блока для чтения (считая с 0)
2861
  * +8: dword: число блоков для чтения
2862
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2863
  * +16 = +0x10: dword: указатель на буфер для работы системы
2864
    (4096 байт)
2865
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
2866
    общем описании
2867
Возвращаемое значение:
2868
  * eax = 0 - успешно, иначе код ошибки файловой системы
2869
  * ebx = размер файла (в байтах) или
2870
    -1=0xffffffff, если файл не найден
2871
Замечания:
2872
  * Размер блока - 512 байт.
2873
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
2874
    функции 70, для чтения папок - подфункцию 1 функции 70.
2875
  * Функция позволяет читать содержимое папки. Из файловых систем
2876
    поддерживается только FAT. Формат FAT-папки описан в любой
2877
    документации по FAT.
2878
  * Размер папки определяется по размеру цепочки кластеров в FAT.
2879
  * Если файл кончился раньше, чем был прочитан последний запрошенный
2880
    блок, то функция прочитает, сколько сможет, после чего вернёт
2881
    eax=6 (EOF).
2882
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
2883
    в первых двух случаях текущая реализация не следует
2884
    установленным правилам:
2885
    для /rd/1:
2886
    * если указано 0 блоков для чтения, считается,
2887
      что запрашивается 1;
2888
    * если запрашивается больше 14 блоков или начальный блок
2889
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
2890
    * размер корневого каталога рамдиска = 14 блоков,
2891
      0x1C00=7168 байт; но возвращается ebx=0
2892
      (за исключением случая предыдущего пункта);
2893
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
2894
      мусор - напоминаю, счёт ведётся с 0);
2895
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
2896
      то возвращается eax=6(EOF); иначе eax=0.
2897
    Для /fd/x:
2898
    * если начальный блок не меньше 14-го, то возвращается
2899
      eax=5 (not found) и ebx=0;
2900
    * кстати говоря, формат FAT12 допускает дискеты с размером
2901
      корневого каталога меньше или больше 14 блоков;
2902
    * проверки длины не делается;
2903
    * если удалось прочитать данные с дискеты, возвращается
2904
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
2905
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
2906
    но результат не соответствует ожидаемому
2907
    (по работе с обычными файлами/папками), не следует установленным
2908
    правилам, может измениться в следующих версиях ядра и потому
2909
    не описывается. Для получения информации об оборудовании
2910
    используйте подфункцию 11 функции 18 или
2911
    читайте соответствующие папки подфункцией 1 функции 70.
2912
 
2913
======================================================================
2914
============ Функция 58, подфункция 1 - перезаписать файл. ===========
2915
======================================================================
2916
Если файл не существует, он создаётся.
2917
Если файл существует, он перезаписывается.
2918
Параметры:
2919
  * eax = 58 - номер функции
2920
  * ebx = указатель на информационную структуру
2921
Формат информационной структуры:
2922
  * +0: dword: 1 = номер подфункции
2923
  * +4: dword: игнорируется (устанавливайте в 0)
2924
  * +8: dword: число байт для записи
2925
  * +12 = +0xC: dword: указатель на данные для записи
2926
  * +16 = +0x10: dword: указатель на буфер для работы системы
2927
    (4096 байт)
2928
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
2929
    общем описании
2930
Возвращаемое значение:
2931
  * eax = 0 - успешно, иначе код ошибки файловой системы
2932
  * ebx разрушается
2933
 
2934
======================================================================
2935
=========== Функция 58, подфункция 2 - удалить файл/папку. ===========
2936
======================================================================
2937
Параметры:
2938
  * eax = 58 - номер функции
2939
  * ebx = указатель на информационную структуру
2940
Формат информационной структуры:
2941
  * +0: dword: 2 = номер подфункции
2942
  * +4: dword: игнорируется
2943
  * +8: dword: игнорируется
2944
  * +12 = +0xC: dword: игнорируется
2945
  * +16 = +0x10: dword: указатель на буфер для работы системы
2946
    (4096 байт)
2947
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
2948
    общем описании
2949
Возвращаемое значение:
2950
  * eax = 0 - успешно, иначе код ошибки файловой системы
2951
  * ebx разрушается
2952
Замечания:
2953
  * При работе с дискетой не следует удалять непустую папку.
2954
    Код работы с жёстким диском непустые папки удаляет корректно
2955
    (т.е. рекурсивно со всеми файлами и вложенными папками).
2956
    Рамдиск папок не поддерживает.
2957
 
2958
======================================================================
2959
==== Функция 58, подфункция 3 - запись данных в существующий файл. ===
2960
======================================================================
2961
Параметры:
2962
  * eax = 58 - номер функции
2963
  * ebx = указатель на информационную структуру
2964
Формат информационной структуры:
2965
  * +0: dword: 3 = номер подфункции
2966
  * +4: dword: начальная позиция в файле; -1 = дописывать в конец
2967
  * +8: dword: число байт для записи
2968
  * +12 = +0xC: dword: указатель на данные для записи
2969
  * +16 = +0x10: dword: указатель на буфер для работы системы
2970
    (4096 байт)
2971
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
2972
    общем описании
2973
Возвращаемое значение:
2974
  * eax = 0 - успешно, иначе код ошибки файловой системы
2975
  * ebx разрушается
2976
Замечания:
2977
  * Рамдиск и дискеты не поддерживают эту функцию, она только для
2978
    жёстких дисков.
2979
  * Файл должен уже существовать (иначе возвращается 5, not found).
2980
    Для создания файлов используйте подфункцию 1.
2981
  * Если начальная позиция больше размера файла, возвращается
2982
    eax=6(EOF). Если конечная позиция больше размера файла,
2983
    файл расширяется.
2984
  * Код обработки записи данных для жёсткого диска интерпретирует
2985
    нулевое значение поля +8 как указание усечения файла до размера,
2986
    указанного в поле +4. Однако код обработки 58-й функции блокирует
2987
    эту возможность для приложений, сразу возвращая управление
2988
    (с eax=0) в случае нулевого размера.
2989
 
2990
======================================================================
2991
============== Функция 58, подфункция 4 - создать папку. =============
2992
======================================================================
2993
Параметры:
2994
  * eax = 58 - номер функции
2995
  * ebx = указатель на информационную структуру
2996
Формат информационной структуры:
2997
  * +0: dword: 4 = номер подфункции
2998
  * +4: dword: игнорируется
2999
  * +8: dword: игнорируется
3000
  * +12 = +0xC: dword: игнорируется
3001
  * +16 = +0x10: dword: указатель на буфер для работы системы
3002
    (4096 байт)
3003
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
3004
    общем описании
3005
Возвращаемое значение:
3006
  * eax = 0 - успешно, иначе код ошибки файловой системы
3007
  * ebx разрушается
3008
Замечания:
3009
  * Рамдиск и дискеты не поддерживают эту функцию,
3010
    она только для жёстких дисков.
3011
 
3012
======================================================================
3013
== Функция 58, подфункция 5 - переименовать/переместить файл/папку. ==
3014
======================================================================
3015
Параметры:
3016
  * eax = 58 - номер функции
3017
  * ebx = указатель на информационную структуру
3018
Формат информационной структуры:
3019
  * +0: dword: 5 = номер подфункции
3020
  * +4: dword: игнорируется
3021
  * +8: dword: игнорируется
3022
  * +12 = +0xC: dword: игнорируется
3023
  * +16 = +0x10: dword: указатель на буфер для работы системы
3024
    (4096 байт)
3025
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
3026
    общем описании
3027
  * +20+n: (сразу после завершающего нулевого символа) новое
3028
    ASCIIZ-имя, должно начинаться с /hd/1, что интерпретируется как
3029
    жёсткий диск, указанный в первом имени
3030
    (перемещение с одного диска на другой не поддерживается)
3031
Возвращаемое значение:
3032
  * eax = 0 - успешно, иначе код ошибки файловой системы
3033
  * ebx разрушается
3034
Замечания:
3035
  * Рамдиск и дискеты не поддерживают эту функцию,
3036
    она только для жёстких дисков.
3037
  * Если новое ASCIIZ-имя сильно неправильное, т.е. не начинается с
3038
    /hd/1, /hd/first, /harddisk/1, /harddisk/first или после этого
3039
    начала идёт пробел или символ с кодом 0, то функция возвращает,
3040
    как ни странно, код ошибки 4. Это единственная функция, которая
3041
    вообще возвращает этот код.
3042
 
3043
======================================================================
3044
========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
3045
======================================================================
3046
Параметры:
3047
  * eax = 58 - номер функции
3048
  * ebx = указатель на информационную структуру
3049
Формат информационной структуры:
3050
  * +0: dword: 8 = номер подфункции
3051
  * +4: dword: номер блока для чтения (считая с 0)
3052
  * +8: dword: игнорируется (устанавливайте в 1)
3053
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
3054
    (512 байт)
3055
  * +16 = +0x10: dword: указатель на буфер для работы системы
3056
    (4096 байт)
3057
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
3058
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
3059
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
3060
    Вместо цифр допускается, хотя и не рекомендуется для удобства
3061
    перехода на будущие расширения,
3062
    использование 'first','second','third','fourth'.
3063
Возвращаемое значение:
3064
  * если указано имя устройства /hd/xxx, где xxx не находится
3065
    в списке выше:
3066
    * eax = ebx = 1
3067
  * если указано неправильное имя устройства
3068
    (за исключением предыдущего случая):
3069
    * eax = 5
3070
    * ebx не меняется
3071
  * если LBA-доступ запрещён подфункцией 11 функции 21:
3072
    * eax = 2
3073
    * ebx разрушается
3074
  * для рамдиска: попытка чтения блока за пределами рамдиска
3075
    (18*2*80 блоков) приводит к
3076
    * eax = 3
3077
    * ebx = 0
3078
  * при успешном чтении:
3079
    * eax = ebx = 0
3080
Замечания:
3081
  * Размер блока - 512 байт; читается один блок.
3082
  * Не следует полагаться на возвращаемое значение,
3083
    оно может измениться в следующих версиях.
3084
  * Требуется, чтобы был разрешён LBA-доступ к устройствам
3085
    подфункцией 11 функции 21. Узнать это можно вызовом
3086
    подфункцией 11 функции 26.
3087
  * LBA-чтение дискеты не поддерживается.
3088
  * Обращение к несуществующему жёсткому диску намертво вешает поток.
3089
    Узнать, существует ли диск, можно из структуры, возвращаемой
3090
    подфункцией 11 функции 18.
3091
  * Функция считывает данные физического жёсткого диска;
3092
    если по каким-то причинам нужны данные конкретного раздела,
3093
    придётся определять начальный сектор этого раздела
3094
    (либо напрямую через MBR, либо из расширенной структуры,
3095
    возвращаемой той же подфункцией 11 функции 18).
3096
  * Функция не проверяет код ошибки жёсткого диска, так что запрос
3097
    несуществующего сектора всё равно что-то прочитает
3098
    (вероятнее всего, нули, но это определяется устройством) и
3099
    это будет считаться успехом (eax=0).
3100
 
3101
======================================================================
3102
========= Функция 58, подфункция 12 - получить размер файла. =========
3103
======================================================================
3104
Параметры:
3105
  * eax = 58 - номер функции
3106
  * ebx = указатель на информационную структуру
3107
Формат информационной структуры:
3108
  * +0: dword: 12 = номер функции
3109
  * +4: dword: игнорируется
3110
  * +8: dword: игнорируется
3111
  * +12 = +0xC: dword: игнорируется
3112
  * +16 = +0x10: dword: указатель на буфер для работы системы
3113
    (4096 байт)
3114
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
3115
    общем описании
3116
Возвращаемое значение:
3117
  * eax = 0 - успешно, иначе код ошибки файловой системы
3118
  * ebx = размер файла (в байтах) или 0 для HD, -1 для RD,
3119
    если файл не найден
3120
Замечания:
3121
  * Функция не поддерживается для дискет.
3122
  * Текущая реализация позволяет также определять размер папки
3123
    (по цепочке кластеров в FAT), но не следует на это полагаться.
3124
 
3125
======================================================================
3126
===== Функция 58, подфункция 13 - получить атрибуты файла/папки. =====
3127
======================================================================
3128
Параметры:
3129
  * eax = 58 - номер функции
3130
  * ebx = указатель на информационную структуру
3131
Формат информационной структуры:
3132
  * +0: dword: 13 = номер функции
3133
  * +4: dword: игнорируется
3134
  * +8: dword: игнорируется
3135
  * +12 = +0xC: dword: игнорируется
3136
  * +16 = +0x10: dword: указатель на буфер для работы системы
3137
    (4096 байт)
3138
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
3139
    общем описании
3140
Возвращаемое значение:
3141
  * eax = 0 - успешно, иначе код ошибки файловой системы
3142
  * ebx = байт FAT-атрибута (дополненный нулями до dword)
3143
    или 0 для HD, -1 для RD, если файл не найден
3144
Значения для битов FAT-атрибутов:
3145
  * бит 0: файл только для чтения
3146
  * бит 1: файл является скрытым
3147
  * бит 2: файл является системным
3148
  * бит 3: это не файл, а метка тома (может встречаться только
3149
    один раз на диске, в корневом каталоге)
3150
  * бит 4: это папка
3151
  * бит 5: файл не архивировался - многие программы архивации имеют
3152
    опцию, по которой архивируются только файлы с установленным этим
3153
    битом, после чего этот бит сбрасывается - это может быть полезно
3154
    для автоматического создания backup-архивов, ибо при записи
3155
    бит обычно устанавливается (не в Kolibri, правда)
3156
Замечания:
3157
  * Функция не поддерживается для дискет.
3158
 
3159
======================================================================
3160
====================== Функция 58, подфункция 14 =====================
3161
======= Получить дату/время последней модификации файла/папки. =======
3162
======================================================================
3163
Параметры:
3164
  * eax = 58 - номер функции
3165
  * ebx = указатель на информационную структуру
3166
Формат информационной структуры:
3167
  * +0: dword: 14 = номер функции
3168
  * +4: dword: игнорируется
3169
  * +8: dword: игнорируется
3170
  * +12 = +0xC: dword: игнорируется
3171
  * +16 = +0x10: dword: указатель на буфер для работы системы
3172
    (4096 байт)
3173
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
3174
    общем описании
3175
Возвращаемое значение:
3176
  * eax = 0 - успешно, иначе код ошибки файловой системы
3177
  * ebx = дата/время в формате FAT или 0 для HD, -1 для RD,
3178
    если файл не найден
3179
  * младшее слово = время последней модификации, hhhhhmmmmmmsssss:
3180
    * младшие 5 бит = число двухсекундных интервалов, 0<=s<=29
3181
    * следующие 6 бит = минуты, 0<=m<=59
3182
    * старшие 5 бит = часы, 0<=h<=23
3183
  * старшее слово = дата последней модификации, yyyyyyymmmmddddd:
3184
    * младшие 5 бит = день, 1<=d<=31
3185
    * следующие 4 бита = месяц, 1<=m<=12
3186
    * старшие 7 бит = год относительно 1980
3187
Замечания:
3188
  * Функция не поддерживается для дискет.
3189
  * Создание файла/папки считается модификацией.
3190
 
3191
======================================================================
3192
= Функция 58, подфункция 15 - получить информацию о файловой системе.
3193
======================================================================
3194
Параметры:
3195
  * eax = 58 - номер функции
3196
  * ebx = указатель на информационную структуру
3197
Формат информационной структуры:
3198
  * +0: dword: 15 = номер функции
3199
  * +4: dword: игнорируется
3200
  * +8: dword: игнорируется
3201
  * +12 = +0xC: dword: игнорируется
3202
  * +16 = +0x10: dword: игнорируется
3203
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
3204
    /rd=/RAMDISK или /hd=/HARDDISK
3205
Возвращаемое значение:
3206
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
3207
    * eax = 3
3208
    * ebx = ecx = dword [fileinfo] = 0
3209
  * для рамдиска:
3210
    * eax = 0 (успех)
3211
    * ebx = общее число кластеров = 2847
3212
    * ecx = число свободных кластеров
3213
    * dword [fileinfo] = размер кластера = 512
3214
  * для жёсткого диска: база и раздел определяются подфункциями 7 и 8
3215
    функции 21:
3216
    * eax = 0 (успех)
3217
    * ebx = общее число кластеров
3218
    * ecx = число свободных кластеров
3219
    * dword [fileinfo] = размер кластера (в байтах)
3220
Замечания:
3221
  * Не удивляйтесь странному расположению 4-го возвращаемого
3222
    параметра - когда писался этот код, при системных вызовах
3223
    приложению возвращались только регистры eax,ebx,ecx (из
3224
    pushad-структуры, передающейся как аргумент системной функции).
3225
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
3226
    размер кластера в edx, пока эту функцию не начали использовать.
3227
  * Вообще-то ещё существует подфункция 11 функции 18, возвращающая
3228
    информацию о файловой системе. По расширенной таблице дисковой
3229
    подсистемы можно определить размер кластера (там он хранится
3230
    в секторах) и общее число кластеров для жёстких дисков.
3231
 
3232
======================================================================
3233
========== Функция 58, подфункция 16 - запустить программу. ==========
3234
======================================================================
3235
Параметры:
3236
  * eax = 58 - номер функции
3237
  * ebx = указатель на информационную структуру
3238
Формат информационной структуры:
3239
  * +0: dword: 16 = номер подфункции
3240
  * +4: dword: поле флагов:
3241
    * бит 0: запустить процесс как отлаживаемый
3242
    * остальные биты зарезервированы и должны быть установлены в 0
3243
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
3244
  * +12 = +0xC: dword: игнорируется
3245
  * +16 = +0x10: dword: указатель на буфер для работы системы
3246
    (4096 байт)
3247
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
3248
    общем описании
3249
Возвращаемое значение:
3250
  * eax > 0 - программа загружена, eax содержит PID
3251
  * eax < 0 - произошла ошибка, -eax содержит
3252
    код ошибки файловой системы
3253
Замечания:
3254
  * Комадная строка должна заканчиваться символом с кодом 0
3255
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
3256
    включительно, либо первые 256 символов, в зависимости от того,
3257
    что меньше.
3258
  * Если процесс запускается как отлаживаемый, он создаётся
3259
    в замороженном состоянии; для запуска используйте
3260
    подфункцию 5 функции 69.
3261
 
3262
======================================================================
3263
=========== Функция 60 - Inter Process Communication (IPC). ==========
3264
======================================================================
3265
IPC применяется для посылок сообщений от одного процесса/потока
3266
другому. При этом следует предварительно договориться о том, как
3267
интерпретировать конкретное сообщение.
3268
 
3269
-------- Подфункция 1 - установить область для получения IPC ---------
3270
Вызывается процессом-приёмником.
3271
Параметры:
3272
  * eax = 60 - номер функции
3273
  * ebx = 1 - номер подфункции
3274
  * ecx = указатель на буфер
3275
  * edx = размер буфера
3276
Возвращаемое значение:
3277
  * eax = 0 - всегда успешно
3278
Формат IPC-буфера:
3279
  * +0: dword: если здесь не 0, то буфер считается заблокированным;
3280
    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
3281
    и вам надо, чтобы извне не изменялись данные буфера
3282
    (не поступали новые сообщения)
3283
  * +4: dword: занято места в буфере (в байтах)
3284
  * +8: первое сообщение
3285
  * +8+n: второе сообщение
3286
  * ...
3287
Формат сообщения:
3288
  * +0: dword: PID процесса/потока, пославшего сообщение
3289
  * +4: dword: длина сообщения (не считая этот заголовок)
3290
  * +8: n*byte: данные сообщения
3291
 
3292
--------------- Подфункция 2 - послать сообщение IPC. ----------------
3293
Вызывается процессом-инициатором.
3294
Параметры:
3295
  * eax = 60 - номер функции
3296
  * ebx = 2 - номер подфункции
3297
  * ecx = PID приёмника
3298
  * edx = указатель на данные сообщения
3299
  * esi = длина сообщения (в байтах)
3300
Возвращаемое значение:
3301
  * eax = 0 - успешно
3302
  * eax = 1 - приёмник не определил буфер для IPC-сообщений
3303
    (может быть, ещё не успел, а может быть, это не тот поток,
3304
    который нужен)
3305
  * eax = 2 - приёмник заблокировал IPC-буфер;
3306
    попробуйте немного подождать
3307
  * eax = 3 - переполнение IPC-буфера приёмника
3308
  * eax = 4 - процесса/потока с таким PID не существует
3309
Замечания:
3310
  * Система сразу после записи IPC-сообщения в буфер посылает
3311
    потоку-приёмнику событие с кодом 7 (см. коды событий).
3312
 
3313
======================================================================
3314
=== Функция 61 - получить параметры для прямого доступа к графике. ===
3315
======================================================================
3316
Программе доступны данные графического экрана (область памяти, которая
3317
собственно и отображает содержимое экрана) напрямую без вызовов
3318
системных функций через селектор gs:
3319
	mov	eax, [gs:0]
3320
поместит в eax первый dword буфера, содержащий информацию о цвете
3321
левой верхней точки (и, возможно, цвета нескольких следующих).
3322
	mov	[gs:0], eax
3323
при работе в режимах VESA c LFB
3324
установит цвет левой верхней точки
3325
(и возможно, цвета нескольких следующих).
3326
Для интерпретации данных графического экрана требуется знание
3327
некоторых параметров, которые возвращаются этой функцией.
3328
Замечания:
3329
  * Параметры графики очень редко меняются при работе системы,
3330
    а именно, только в случаях, когда пользователь работает
3331
    с программой VRR.
3332
  * При изменении видеорежима система перерисовывает все окна
3333
    (событие с кодом 1) и перерисовывает фон (событие 5).
3334
    Эти же события происходят и в других случаях,
3335
    которые встречаются значительно чаще, чем изменение видеорежима.
3336
  * При работе в видеорежимах с LFB селектор gs указывает на
3337
    собственно LFB, так что чтение/запись по gs приводят
3338
    непосредственно к изменению содержимого экрана. При работе в
3339
    видеорежимах без LFB gs указывает на некоторую область данных
3340
    ядра, причём все функции вывода на экран добросовестно выполняют
3341
    двойную работу по записи непосредственно на экран и по записи
3342
    в этот буфер. В результате при чтении содержимого этого буфера
3343
    результаты соответствуют содержимому экрана
3344
    (с, вообще говоря, большим цветовым разрешением),
3345
    а запись игнорируется.
3346
    Исключением является режим 320*200, для которого в главном цикле
3347
    системного потока выполняется обновление экрана в соответствии
3348
    с движениями курсора мыши.
3349
 
3350
------------------------- Разрешение экрана --------------------------
3351
Параметры:
3352
  * eax = 61 - номер функции
3353
  * ebx = 1 - номер подфункции
3354
Возвращаемое значение:
3355
  * eax = [разрешение по оси x]*65536 + [разрешение по оси y]
3356
Замечания:
3357
  * Можно использовать функцию 14 с учётом того, что она возвращает
3358
    размеры на 1 меньше. Это полностью эквивалентный способ.
3359
 
3360
------------------------ Число бит на пиксель ------------------------
3361
Параметры:
3362
  * eax = 61 - номер функции
3363
  * ebx = 2 - номер подфункции
3364
Возвращаемое значение:
3365
  * eax = число бит на пиксель (24 или 32)
3366
 
3367
------------------------ Число байт на строку ------------------------
3368
Параметры:
3369
  * eax = 61 - номер функции
3370
  * ebx = 3 - номер подфункции
3371
Возвращаемое значение:
3372
  * eax = число байт, которое занимает одна строка развёртки
3373
    (горизонтальная линия на экране)
3374
 
3375
======================================================================
3376
===== Функция 62, подфункция 0 - получить версию PCI-интерфейса. =====
3377
======================================================================
3378
Параметры:
3379
  * eax = 62 - номер функции
3380
  * bl = 0 - номер подфункции
3381
Возвращаемое значение:
3382
  * eax = -1 - доступ к PCI запрещён; иначе
3383
  * ah.al = версия PCI-интерфейса (ah=версия, al=подверсия)
3384
  * старшее слово eax обнулено
3385
Замечания:
3386
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
3387
    для приложений подфункцией 12 функции 21.
3388
  * Если PCI BIOS не поддерживается, то значение ax неопределено.
3389
 
3390
======================================================================
3391
==== Функция 62, подфункция 1 - получить номер последней PCI-шины. ===
3392
======================================================================
3393
Параметры:
3394
  * eax = 62 - номер функции
3395
  * bl = 1 - номер подфункции
3396
Возвращаемое значение:
3397
  * eax = -1 - доступ к PCI запрещён; иначе
3398
  * al = номер последней PCI-шины; оставшиеся байты eax разрушаются
3399
Замечания:
3400
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
3401
    для приложений подфункцией 12 функции 21.
3402
  * Если PCI BIOS не поддерживается, то значение al неопределено.
3403
 
3404
======================================================================
3405
====================== Функция 62, подфункция 2 ======================
3406
== Получить механизм обращения к конфигурационному пространству PCI. =
3407
======================================================================
3408
Параметры:
3409
  * eax = 62 - номер функции
3410
  * bl = 2 - номер подфункции
3411
Возвращаемое значение:
3412
  * eax = -1 - доступ к PCI запрещён; иначе
3413
  * al = механизм (1 или 2); прочие байты eax разрушаются
3414
Замечания:
3415
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
3416
    для приложений подфункцией 12 функции 21.
3417
  * Механизм обращения выбирается в соответствии
3418
    с характеристиками оборудования.
3419
  * Подфункции чтения и записи автоматически работают
3420
    с выбранным механизмом.
3421
 
3422
======================================================================
3423
======== Функция 62, подфункции 4,5,6 - прочитать PCI-регистр. =======
3424
======================================================================
3425
Параметры:
3426
  * eax = 62 - номер функции
3427
  * bl = 4 - читать байт
3428
  * bl = 5 - читать слово
3429
  * bl = 6 - читать двойное слово
3430
  * bh = номер PCI-шины
3431
  * ch = dddddfff, где ddddd = номер устройства на шине,
3432
    fff = номер функции устройства
3433
  * cl = номер регистра (должен быть чётным для bl=5,
3434
    делиться на 4 для bl=6)
3435
Возвращаемое значение:
3436
  * eax = -1 - ошибка (запрещён доступ к PCI или
3437
    неподдерживаемые параметры); иначе
3438
  * al/ax/eax (в зависимости от запрошенного размера) содержит данные;
3439
    оставшаяся часть регистра eax разрушается
3440
Замечания:
3441
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
3442
    для приложений подфункцией 12 функции 21.
3443
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3444
    игнорирует номер функции. Получить механизм доступа можно вызовом
3445
    подфункции 2.
3446
  * Некоторые регистры стандартны и существуют для всех устройств,
3447
    некоторые определяются конкретным устройством. Список первых
3448
    входит, например, в известный Interrupt List by Ralf Brown
3449
    (http://www.pobox.com/~ralf/files.html,
3450
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3451
    список вторых должен быть указан в документации по устройству.
3452
 
3453
======================================================================
3454
======= Функция 62, подфункции 8,9,10 - записать в PCI-регистр. ======
3455
======================================================================
3456
Параметры:
3457
  * eax = 62 - номер функции
3458
  * bl = 8 - писать байт
3459
  * bl = 9 - писать слово
3460
  * bl = 10 - писать двойное слово
3461
  * bh = номер PCI-шины
3462
  * ch = dddddfff, где ddddd = номер устройства на шине,
3463
    fff = номер функции устройства
3464
  * cl = номер регистра (должен быть чётным для bl=9,
3465
    делиться на 4 для bl=10)
3466
Возвращаемое значение:
3467
  * eax = -1 - ошибка (запрещён доступ к PCI или
3468
    неподдерживаемые параметры)
3469
  * eax = 0 - успешно
3470
Замечания:
3471
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
3472
    для приложений подфункцией 12 функции 21.
3473
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3474
    игнорирует номер функции. Получить механизм доступа можно вызовом
3475
    подфункции 2.
3476
  * Некоторые регистры стандартны и существуют для всех устройств,
3477
    некоторые определяются конкретным устройством. Список первых
3478
    входит, например, в известный Interrupt List by Ralf Brown;
3479
    список вторых должен быть указан в документации по устройству.
3480
 
3481
======================================================================
3482
================ Функция 63 - работа с доской отладки. ===============
3483
======================================================================
3484
Доска отладки представляет собой системный буфер (на 512 байт),
3485
в который любая программа может записать (вообще говоря, произвольные)
3486
данные и из которого другая программа может эти данные прочитать.
3487
Есть соглашение, в соответствии с которым записываемые данные -
3488
текстовые строки, интерпретируемые как отладочные сообщения о ходе
3489
выполнения программы. Ядро в определённых ситуациях также записывает
3490
на доску отладки сведения о выполнении некоторых функций;
3491
по соглашению сообщения ядра начинаются с префикса "K : ".
3492
Для просмотра доски отладки создано приложение board,
3493
которое считывает данные из буфера и отображает их в своём окне. board
3494
понимает последовательность кодов 13,10 как переход на новую строку.
3495
Символ с нулевым кодом в конце строки не обязателен, но и не мешает.
3496
В связи с появлением отладчика ценность доски отладки несколько
3497
снизилась, поскольку отладчик позволяет полностью контролировать ход
3498
выполнения программы, причём для этого не требуется никаких усилий
3499
со стороны самой программы. Тем не менее во многих случаях
3500
доска отладки продолжает оставаться полезной.
3501
 
3502
---------------------------- Запись байта ----------------------------
3503
Параметры:
3504
  * eax = 63 - номер функции
3505
  * ebx = 1 - номер подфункции
3506
  * cl = байт данных
3507
Возвращаемое значение:
3508
  * функция не возвращает значения
3509
Замечания:
3510
  * Байт записывается в буфер. Длина буфера - 512 байт.
3511
    При переполнении буфера все полученные данные теряются
3512
    и заполнение начинается снова с нуля.
3513
  * Для вывода на доску отладки более сложных объектов (строк, чисел)
3514
    достаточно этой функции, вызываемой в цикле. Можно не писать
3515
    вручную соответствующий код, а воспользоваться файлом debug.inc,
3516
    входящим в дистрибутив.
3517
 
3518
---------------------------- Чтение байта ----------------------------
3519
Забирает байт из буфера.
3520
Параметры:
3521
  * eax = 63 - номер функции
3522
  * ebx = 2 - номер подфункции
3523
Возвращаемое значение:
3524
  * eax = ebx = 0 - буфер пуст
3525
  * eax = байт, ebx = 1 - байт успешно прочитан
3526
 
3527
======================================================================
3528
========== Функция 64 - перераспределить память приложения. ==========
3529
======================================================================
3530
Параметры:
3531
  * eax = 64 - номер функции
3532
  * ebx = 1 - единственная подфункция
3533
  * ecx = новый размер памяти
3534
Возвращаемое значение:
3535
  * eax = 0 - успешно
3536
  * eax = 1 - недостаточно памяти
3537
Замечания:
3538
  * На данный момент эта функция является единственным средством для
3539
    динамического выделения/освобождения памяти приложения.
3540
 
3541
======================================================================
3542
=========== Функция 66 - режим получения данных клавиатуры. ==========
3543
======================================================================
3544
Режим ввода влияет на результаты чтения клавиш функцией 2
3545
и получения последней нажатой клавиши подфункцией 12 функции 18.
3546
При загрузке программы для неё устанавливается ASCII-режим ввода.
3547
 
3548
------------------ Подфункция 1 - установить режим. ------------------
3549
Параметры:
3550
  * eax = 66 - номер функции
3551
  * ebx = 1 - номер подфункции
3552
  * ecx = режим:
3553
    * 0 = обычный (ASCII-символы)
3554
    * 1 = сканкоды
3555
Возвращаемое значение:
3556
  * функция не возвращает значения
3557
 
3558
------------------- Подфункция 2 - получить режим. -------------------
3559
Параметры:
3560
  * eax = 66 - номер функции
3561
  * ebx = 2 - номер подфункции
3562
Возвращаемое значение:
3563
  * eax = текущий режим
3564
 
3565
------- Подфункция 3 - получить состояние управляющих клавиш. --------
3566
Параметры:
3567
  * eax = 66 - номер функции
3568
  * ebx = 3 - номер подфункции
3569
Возвращаемое значение:
3570
  * eax = битовая маска:
3571
  * бит 0 (маска 1): левый Shift нажат
3572
  * бит 1 (маска 2): правый Shift нажат
3573
  * бит 2 (маска 4): левый Ctrl нажат
3574
  * бит 3 (маска 8): правый Ctrl нажат
3575
  * бит 4 (маска 0x10): левый Alt нажат
3576
  * бит 5 (маска 0x20): правый Alt нажат
3577
  * бит 6 (маска 0x40): CapsLock включён
3578
  * бит 7 (маска 0x80): NumLock включён
3579
  * бит 8 (маска 0x100): ScrollLock включён
3580
  * прочие биты сброшены
3581
 
3582
======================================================================
3583
============ Функция 67 - изменить положение/размеры окна. ===========
3584
======================================================================
3585
Параметры:
3586
  * eax = 67 - номер функции
3587
  * ebx = новая x-координата окна
3588
  * ecx = новая y-координата окна
3589
  * edx = новый x-размер окна
3590
  * esi = новый y-размер окна
3591
Возвращаемое значение:
3592
  * функция не возвращает значения
3593
Замечания:
3594
  * Значение -1 для параметра означает "не изменять"; например, для
3595
    перемещения окна без изменения размеров можно указать edx=esi=-1.
3596
  * Предварительно окно должно быть определено функцией 0.
3597
    Она же задаёт начальные координаты и размеры окна.
3598
  * Размеры окна понимаются в смысле функции 0, т.е.
3599
    на один пиксель меньше, чем реальные размеры.
3600
  * Вызов функции для максимизированных окон просто игнорируется.
3601
  * Для окон соответствующих стилей положение и/или размеры могут быть
3602
    изменены пользователем; текущие положение и размеры могут быть
3603
    получены вызовом функции 9.
3604
  * Функция посылает окну событие перерисовки (с кодом 1).
3605
 
3606
======================================================================
3607
=== Функция 68, подфункция 0 - получить счётчик переключений задач. ==
3608
======================================================================
3609
Параметры:
3610
  * eax = 68 - номер функции
3611
  * ebx = 0 - номер подфункции
3612
Возвращаемое значение:
3613
  * eax = число переключений задач с момента загрузки системы
3614
    (по модулю 2^32)
3615
 
3616
======================================================================
3617
====================== Функция 68, подфункция 1 ======================
3618
============ Переключиться на следующий поток выполнения. ============
3619
======================================================================
3620
Функция завершает текущий квант времени, выделенный потоку,
3621
и переключается на следующий.
3622
(Какой поток какого процесса будет следующим, предсказать нельзя).
3623
Позднее, когда до текущего потока дойдёт очередь,
3624
выполнение возобновится.
3625
Параметры:
3626
  * eax = 68 - номер функции
3627
  * ebx = 1 - номер подфункции
3628
Возвращаемое значение:
3629
  * функция не возвращает значения
3630
 
3631
======================================================================
3632
=============== Функция 68, подфункция 2 - кэш + rdpmc. ==============
3633
======================================================================
3634
Параметры:
3635
  * eax = 68 - номер функции
3636
  * ebx = 2 - номер подфункции
3637
  * ecx = требуемое действие:
3638
    * ecx = 0 - разрешить выполнение инструкции rdpmc
3639
      (ReaD Performance-Monitoring Counters)
3640
    * ecx = 1 - узнать, включён/выключен кэш
3641
    * ecx = 2 - включить кэш
3642
    * ecx = 3 - выключить кэш
3643
Возвращаемое значение:
3644
  * для ecx=0:
3645
    * eax = значение cr4
3646
  * для ecx=1:
3647
    * eax = (cr0 and 0x60000000):
3648
    * eax = 0 - кэш включён
3649
    * eax <> 0 - кэш выключен
3650
  * для ecx=2 и ecx=3:
3651
    * функция не возвращает значения
3652
 
3653
======================================================================
3654
========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
3655
======================================================================
3656
MSR = Model Specific Register; полный список MSR-регистров процессора
3657
содержится в документации по процессору (например, IA-32 Intel
3658
Architecture Software Developer's Manual, Volume 3, Appendix B);
3659
каждое семейство процессоров имеет своё подмножество MSR-регистров.
3660
Параметры:
3661
  * eax = 68 - номер функции
3662
  * ebx = 3 - номер подфункции
3663
  * ecx игнорируется
3664
  * edx = адрес MSR
3665
Возвращаемое значение:
3666
  * ebx:eax = старший:младший dword результата
3667
Замечания:
3668
  * Указание в ecx несуществующего или нереализованного для данного
3669
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
3670
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3671
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
3672
    которое всё равно прибьёт поток.
3673
 
3674
======================================================================
3675
========= Функция 68, подфункция 4 - записать в MSR-регистр. =========
3676
======================================================================
3677
MSR = Model Specific Register; полный список MSR-регистров процессора
3678
содержится в документации по процессору (например, IA-32 Intel
3679
Architecture Software Developer's Manual, Volume 3, Appendix B);
3680
каждое семейство процессоров имеет своё подмножество MSR-регистров.
3681
Параметры:
3682
  * eax = 68 - номер функции
3683
  * ebx = 4 - номер подфункции
3684
  * ecx игнорируется
3685
  * edx = адрес MSR
3686
  * esi:edi = старший:младший dword
3687
Возвращаемое значение:
3688
  * ebx:eax = копия esi:edi
3689
Замечания:
3690
  * Указание в ecx несуществующего или нереализованного для данного
3691
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
3692
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3693
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
3694
    которое всё равно прибьёт поток.
3695
 
3696
======================================================================
3697
======= Функция 68, подфункция 5 - выделить физическую память. =======
3698
======================================================================
3699
Параметры:
3700
  * eax = 68 - номер функции
3701
  * ebx = 5 - номер подфункции
3702
  * ecx = размер (в байтах)
3703
Возвращаемое значение:
3704
  * eax = физический адрес выделенной памяти
3705
Замечания:
3706
  * Обычные приложения не должны использовать эту функцию, она
3707
    предназначена для случая, когда при работе с каким-либо
3708
    устройством требуется разместить данные по известному физическому
3709
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3710
  * Число блоков физической памяти ограничено (константой 24,
3711
    причём эта константа включает и несколько блоков памяти
3712
    для надобностей ядра).
3713
  * Освободить выделенную таким образом память можно
3714
    подфункцией 6, копированием данных туда/обратно
3715
    занимаются подфункции 7 и 8.
3716
 
3717
======================================================================
3718
====== Функция 68, подфункция 6 - освободить физическую память. ======
3719
======================================================================
3720
Параметры:
3721
  * eax = 68 - номер функции
3722
  * ebx = 6 - номер подфункции
3723
  * ecx = физический адрес памяти
3724
Возвращаемое значение:
3725
  * функция не возвращает значения
3726
Замечания:
3727
  * Обычные приложения не должны использовать эту функцию, она
3728
    предназначена для случая, когда при работе с каким-либо
3729
    устройством требуется разместить данные по известному физическому
3730
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3731
  * Память должна быть ранее выделена подфункцией 5.
3732
 
3733
======================================================================
3734
=== Функция 68, подфункция 7 - записать данные в физическую память. ==
3735
======================================================================
3736
Параметры:
3737
  * eax = 68 - номер функции
3738
  * ebx = 7 - номер подфункции
3739
  * ecx = физический адрес
3740
  * edx = указатель на данные (в приложении)
3741
  * esi = размер данных (в байтах)
3742
Возвращаемое значение:
3743
  * функция не возвращает значения
3744
Замечания:
3745
  * Обычные приложения не должны использовать эту функцию, она
3746
    предназначена для случая, когда при работе с каким-либо
3747
    устройством требуется разместить данные по известному физическому
3748
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3749
  * Диапазон физических адресов должен лежать внутри ранее выделенного
3750
    подфункцией 5 блока физической памяти.
3751
  * Проверок корректности не производится.
3752
 
3753
======================================================================
3754
== Функция 68, подфункция 8 - прочитать данные из физической памяти. =
3755
======================================================================
3756
Параметры:
3757
  * eax = 68 - номер функции
3758
  * ebx = 8 - номер подфункции
3759
  * ecx = физический адрес
3760
  * edx = указатель на буфер для данных (в приложении)
3761
  * esi = размер данных (в байтах)
3762
Возвращаемое значение:
3763
  * функция не возвращает значения
3764
Замечания:
3765
  * Обычные приложения не должны использовать эту функцию, она
3766
    предназначена для случая, когда при работе с каким-либо
3767
    устройством требуется разместить данные по известному физическому
3768
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3769
  * Диапазон физических адресов должен лежать внутри ранее выделенного
3770
    подфункцией 5 блока физической памяти.
3771
  * Проверок корректности не производится.
3772
 
3773
======================================================================
3774
======================== Функция 69 - отладка. =======================
3775
======================================================================
3776
Процесс может загрузить другой процесс как отлаживаемый установкой
3777
соответствующего бита при вызове подфункции 16 функции 58.
3778
У процесса может быть только один отладчик; один процесс может
3779
отлаживать несколько разных. Система уведомляет отладчик о событиях,
3780
происходящих с отлаживаемым процессом. Сообщения записываются в буфер,
3781
определённый подфункцией 0.
3782
Формат сообщения:
3783
  * +0: dword: код сообщения
3784
  * +4: dword: PID отлаживаемого процесса
3785
  * +8: могут присутствовать дополнительные данные,
3786
    определяемые кодом сообщения
3787
Коды сообщений:
3788
  * 1 = исключение
3789
    * дополнительно передаётся dword-номер исключения
3790
    * процесс приостановлен
3791
  * 2 = процесс завершился
3792
    * приходит при любом завершении: как через системную функцию -1,
3793
      так и при "убийстве" любым другим процессом
3794
      (в том числе самим отладчиком)
3795
  * 3 = отладочное исключение int 1 = #DB
3796
    * дополнительно передаётся dword-образ регистра DR6:
3797
      * биты 0-3: выполнено условие соответствующей точки останова
3798
        (установленной подфункцией 9)
3799
      * бит 14: исключение произошло из-за режима
3800
        пошаговой трассировки (установлен флаг TF)
3801
    * процесс приостановлен
3802
При завершении отладчика прибиваются все отлаживаемые процессы.
3803
Если отладчик этого не хочет, он должен предварительно отключиться
3804
подфункцией 3.
3805
 
3806
Все подфункции применимы только к процессам/потокам, запущенным
3807
из текущего функцией 58 с установленным флагом отладки.
3808
Отладка многопоточных программ пока не поддерживается.
3809
Полный список подфункций:
3810
  * подфункция 0 - определить область данных для отладочных сообщений
3811
  * подфункция 1 - получить состояние регистров отлаживаемого потока
3812
  * подфункция 2 - установить состояние регистров отлаживаемого потока
3813
  * подфункция 3 - отключиться от отлаживаемого процесса
3814
  * подфункция 4 - приостановить отлаживаемый поток
3815
  * подфункция 5 - возобновить выполнение отлаживаемого потока
3816
  * подфункция 6 - прочитать из памяти отлаживаемого процесса
3817
  * подфункция 7 - записать в память отлаживаемого процесса
3818
  * подфункция 8 - завершить отлаживаемый поток
3819
  * подфункция 9 - установить/снять аппаратную точку останова
3820
 
3821
======================================================================
3822
====================== Функция 69, подфункция 0 ======================
3823
========= Определить область данных для отладочных сообщений. ========
3824
======================================================================
3825
Параметры:
3826
  * eax = 69 - номер функции
3827
  * ebx = 0 - номер подфункции
3828
  * ecx = указатель
3829
Формат области данных:
3830
  * +0: dword: N = размер буфера (не считая этого заголовка)
3831
  * +4: dword: занято в буфере
3832
  * +8: N*byte: буфер
3833
Возвращаемое значение:
3834
  * функция не возвращает значения
3835
Замечания:
3836
  * Если поле размера отрицательно, буфер считается заблокированным
3837
    и при поступлении нового сообщения система будет ждать.
3838
    Для синхронизации обрамляйте всю работу с буфером операциями
3839
    блокировки/разблокировки
3840
    	neg	[bufsize]
3841
  * Данные в буфере трактуются как массив элементов переменной длины -
3842
    сообщений. Формат сообщения указан в общем описании.
3843
 
3844
======================================================================
3845
====================== Функция 69, подфункция 1 ======================
3846
========= Получить состояние регистров отлаживаемого потока. =========
3847
======================================================================
3848
Параметры:
3849
  * eax = 69 - номер функции
3850
  * ebx = 1 - номер подфункции
3851
  * ecx = идентификатор потока
3852
  * edx = длина структуры контекста, должно быть 0x28=40 байт
3853
Возвращаемое значение:
3854
  * функция не возвращает значения
3855
Формат структуры контекста: (FPU пока не поддерживается)
3856
  * +0: dword: eip
3857
  * +4: dword: eflags
3858
  * +8: dword: eax
3859
  * +12 = +0xC: dword: ecx
3860
  * +16 = +0x10: dword: edx
3861
  * +20 = +0x14: dword: ebx
3862
  * +24 = +0x18: dword: esp
3863
  * +28 = +0x1C: dword: ebp
3864
  * +32 = +0x20: dword: esi
3865
  * +36 = +0x24: dword: edi
3866
Замечания:
3867
  * Если поток выполняет код 0-кольца, возвращается
3868
    состояние регистров 3-кольца.
3869
  * Процесс должен быть загружен для отладки (как указано в
3870
    общем описании).
3871
 
3872
======================================================================
3873
====================== Функция 69, подфункция 2 ======================
3874
======== Установить состояние регистров отлаживаемого потока. ========
3875
======================================================================
3876
Параметры:
3877
  * eax = 69 - номер функции
3878
  * ebx = 2 - номер подфункции
3879
  * ecx = идентификатор потока
3880
  * edx = длина структуры контекста, должно быть 0x28=40 байт
3881
Возвращаемое значение:
3882
  * функция не возвращает значения
3883
Формат структуры контекста указан в описании подфункции 1.
3884
Замечания:
3885
  * Если поток выполняет код 0-кольца, устанавливается
3886
    состояние регистров 3-кольца.
3887
  * Процесс должен быть загружен для отладки (как указано в
3888
    общем описании).
3889
 
3890
======================================================================
3891
== Функция 69, подфункция 3 - отключиться от отлаживаемого процесса. =
3892
======================================================================
3893
Параметры:
3894
  * eax = 69 - номер функции
3895
  * ebx = 3 - номер подфункции
3896
  * ecx = идентификатор
3897
Возвращаемое значение:
3898
  * функция не возвращает значения
3899
Замечания:
3900
  * Если процесс был приостановлен, он возобновляет выполнение.
3901
 
3902
======================================================================
3903
==== Функция 69, подфункция 4 - приостановить отлаживаемый поток. ====
3904
======================================================================
3905
Параметры:
3906
  * eax = 69 - номер процесса
3907
  * ebx = 4 - номер подфункции
3908
  * ecx = идентификатор
3909
Возвращаемое значение:
3910
  * функция не возвращает значения
3911
Замечания:
3912
  * Процесс должен быть загружен для отладки (как указано в
3913
    общем описании).
3914
 
3915
======================================================================
3916
====================== Функция 69, подфункция 5 ======================
3917
============ Возобновить выполнение отлаживаемого потока. ============
3918
======================================================================
3919
Параметры:
3920
  * eax = 69 - номер функции
3921
  * ebx = 5 - номер подфункции
3922
  * ecx = идентификатор
3923
Возвращаемое значение:
3924
  * функция не возвращает значения
3925
Замечания:
3926
  * Процесс должен быть загружен для отладки (как указано в
3927
    общем описании).
3928
 
3929
======================================================================
3930
====================== Функция 69, подфункция 6 ======================
3931
============= Прочитать из памяти отлаживаемого процесса. ============
3932
======================================================================
3933
Параметры:
3934
  * eax = 69 - номер функции
3935
  * ebx = 6 - номер подфункции
3936
  * ecx = идентификатор
3937
  * edx = сколько байт читать
3938
  * esi = адрес памяти отлаживаемого процесса
3939
  * edi = указатель на буфер для данных
3940
Возвращаемое значение:
3941
  * eax = -1 при ошибке (неверный PID или буфер)
3942
  * иначе eax = число прочитанных байт (возможно, 0,
3943
    если в esi слишком большое значение)
3944
Замечания:
3945
  * Процесс должен быть загружен для отладки (как указано в
3946
    общем описании).
3947
 
3948
======================================================================
3949
 Функция 69, подфункция 7 - записать в память отлаживаемого процесса.
3950
======================================================================
3951
Параметры:
3952
  * eax = 69 - номер функции
3953
  * ebx = 7 - номер подфункции
3954
  * ecx = идентификатор
3955
  * edx = сколько байт писать
3956
  * esi = адрес памяти в отлаживаемом процессе
3957
  * edi = указатель на данные
3958
Возвращаемое значение:
3959
  * eax = -1 при ошибке (неверный PID или буфер)
3960
  * иначе eax = число записанных байт (возможно, 0,
3961
    если в esi слишком большое значение)
3962
Замечания:
3963
  * Процесс должен быть загружен для отладки (как указано в
3964
    общем описании).
3965
 
3966
======================================================================
3967
====== Функция 69, подфункция 8 - завершить отлаживаемый поток. ======
3968
======================================================================
3969
Параметры:
3970
  * eax = 69 - номер функции
3971
  * ebx = 8 - номер подфункции
3972
  * ecx = идентификатор
3973
Возвращаемое значение:
3974
  * функция не возвращает значения
3975
Замечания:
3976
  * Процесс должен быть загружен для отладки (как указано в
3977
    общем описании).
3978
  * Функция аналогична подфункции 2 функции 18 с двумя отличиями:
3979
    требуется выполнение первого замечания и принимается PID,
3980
    а не номер слота.
3981
 
3982
======================================================================
3983
====================== Функция 69, подфункция 9 ======================
3984
============= Установить/снять аппаратную точку останова. ============
3985
======================================================================
3986
Параметры:
3987
  * eax = 69 - номер функции
3988
  * ebx = 9 - номер подфункции
3989
  * ecx = идентификатор потока
3990
  * dl = индекс точки останова, от 0 до 3 включительно
3991
  * dh = флаги:
3992
    * если старший бит сброшен - установить точку останова:
3993
      * биты 0-1 - условие:
3994
        * 00 = точка останова на выполнение
3995
        * 01 = точка останова на запись
3996
        * 11 = точка останова на чтение/запись
3997
      * биты 2-3 - длина; для точек останова на исполнение должно быть
3998
        00, в противном случае одно из
3999
        * 00 = байт
4000
        * 01 = слово
4001
        * 11 = двойное слово
4002
      * esi = адрес точки останова; должен быть выровнен
4003
        соответственно длине (т.е. должен быть чётным для
4004
        точек останова на слово, кратен 4 для двойного слова)
4005
    * если старший бит установлен - сбросить точку останова
4006
Возвращаемое значение:
4007
  * eax = 0 - успешно
4008
  * eax = 1 - ошибка во входных данных
4009
  * eax = 2 - (зарезервировано, никогда не возвращается
4010
    в текущей реализации) с этим индексом уже установлена
4011
    глобальная точка останова
4012
Замечания:
4013
  * Процесс должен быть загружен для отладки (как указано в
4014
    общем описании).
4015
  * Аппаратные точки останова реализуются через DRx-регистры
4016
    процессора, отсюда все ограничения.
4017
  * Функция может переустановить ранее установленную ей же
4018
    точку останова (никак не сообщая об этом).
4019
    Ведите список установленных точек останова в отладчике.
4020
  * Срабатывание точки останова заключается в генерировании
4021
    отладочного исключения #DB, о котором система сообщает отладчику.
4022
  * Точка останова на запись и чтение/запись срабатывает после
4023
    выполнения вызвавшей её инструкции.
4024
 
4025
======================================================================
4026
= Функция 70 - работа с файловой системой с поддержкой длинных имён. =
4027
======================================================================
4028
Параметры:
4029
  * eax = 70
4030
  * ebx = указатель на информационную структуру
4031
Возвращаемое значение:
4032
  * eax = 0 - успешно; иначе код ошибки файловой системы
4033
  * в зависимости от подфункции может возвращаться значение и
4034
    в других регистрах
4035
Общий формат информационной структуры:
4036
  * +0: dword: номер подфункции
4037
  * +4: dword: смещение в файле
4038
  * +8: dword: старший dword смещения (должен быть 0)
4039
  * +12 = +0xC: dword: размер
4040
  * +16 = +0x10: dword: указатель на данные
4041
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
4042
Уточнения - в документации на соответствующую подфункцию.
4043
Имя файла нечувствительно к регистру букв. Русские буквы должны быть
4044
записаны в кодировке cp866 (DOS).
4045
Формат имени файла:
4046
/base/number/dir1/dir2/.../dirn/file,
4047
где /base/number идентифицирует устройство, на котором ищется файл:
4048
одно из
4049
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
4050
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
4051
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
4052
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
4053
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
4054
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4055
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
4056
    (на каждом из винчестеров нумерация начинается с 1)
4057
Примеры:
4058
  * '/RAMDISK/FIRST/KERNEL.ASM',0
4059
    '/rd/1/kernel.asm',0
4060
  * '/HD0/1/kernel.asm',0
4061
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4062
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
4063
Доступные подфункции:
4064
  * подфункция 0 - чтение файла
4065
  * подфункция 1 - чтение папки
4066
 
4067
======================================================================
4068
= Функция 70, подфункция 0 - чтение файла с поддержкой длинных имён. =
4069
======================================================================
4070
Параметры:
4071
  * eax = 70 - номер функции
4072
  * ebx = указатель на информационную структуру
4073
Формат информационной структуры:
4074
  * +0: dword: 0 = номер подфункции
4075
  * +4: dword: позиция в файле (в байтах)
4076
  * +8: dword: 0 (зарезервировано под старший dword позиции)
4077
  * +12 = +0xC: dword: сколько байт читать
4078
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
4079
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4080
    общем описании
4081
Возвращаемое значение:
4082
  * eax = 0 - успешно, иначе код ошибки файловой системы
4083
  * ebx = число прочитанных байт или
4084
    -1=0xffffffff, если файл не найден
4085
Замечания:
4086
  * Если файл кончился раньше, чем был прочитан последний запрошенный
4087
    блок, то функция прочитает, сколько сможет, после чего вернёт
4088
    eax=6 (EOF).
4089
  * Функция не позволяет читать папки
4090
    (вернётся eax=10, access denied).
4091
 
4092
======================================================================
4093
= Функция 70, подфункция 1 - чтение папки с поддержкой длинных имён. =
4094
======================================================================
4095
Параметры:
4096
  * eax = 70 - номер функции
4097
  * ebx = указатель на информационную структуру
4098
Формат информационной структуры:
4099
  * +0: dword: 1 = номер подфункции
4100
  * +4: dword: индекс начального блока (считая с 0)
78 diamond 4101
  * +8: dword: поле флагов:
4102
    * бит 0 (маска 1): в каком формате возвращать имена,
4103
      0=ANSI, 1=UNICODE
4104
    * прочие биты зарезервированы и должны быть установлены в 0
4105
      для будущей совместимости
77 diamond 4106
  * +12 = +0xC: dword: сколько блоков читать
4107
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
4108
    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
4109
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
4110
    общем описании
4111
Возвращаемое значение:
4112
  * eax = 0 - успешно, иначе код ошибки файловой системы
4113
  * ebx = число файлов, информация о которых была записана в буфер,
4114
    или -1=0xffffffff, если папка не найдена
4115
Структура буфера:
4116
  * +0: 32*byte: заголовок
4117
  * +32 = +0x20: n1*byte: блок с информацией о файле 1
4118
  * +32+n1: n2*byte: блок с информацией о файле 2
4119
  * ...
4120
Структура заголовка:
4121
  * +0: dword: версия структуры (текущая версия = 1)
4122
  * +4: dword: количество размещённых блоков; не больше, чем запрошено
4123
    в поле +12 информационной структуры; может быть меньше,
4124
    если в папке кончились файлы (то же самое, что и в ebx)
4125
  * +8: dword: общее число файлов в папке
4126
  * +12 = +0xC: 20*byte: зарезервировано (нули)
4127
Структура блока данных входа каталога (БДВК):
4128
  * +0: dword: атрибуты файла:
4129
    * бит 0 (маска 1): файл только для чтения
4130
    * бит 1 (маска 2): файл является скрытым
4131
    * бит 2 (маска 4): файл является системным
4132
    * бит 3 (маска 8): это не файл, а метка тома
4133
      (на заданном разделе встречается не более одного раза и
4134
      только в корневой папке)
4135
    * бит 4 (маска 0x10): это папка
4136
    * бит 5 (маска 0x20): файл не архивировался - многие программы
4137
      архивации имеют опцию, по которой архивируются только файлы
4138
      с установленным этим битом, после чего этот бит сбрасывается -
4139
      это может быть полезно для автоматического создания
4140
      backup-архивов, ибо при записи бит обычно устанавливается
4141
      (не в Kolibri, правда)
78 diamond 4142
  * +4: byte: тип данных имени:
4143
    (совпадает с битом 0 флагов информационной структуры)
77 diamond 4144
    * 0 = ASCII = 1-байтное представление каждого символа
4145
    * 1 = UNICODE = 2-байтное представление каждого символа
4146
  * +5: 3*byte: зарезервировано (нули)
4147
  * +8: 4*byte: время создания файла
4148
  * +12 = +0xC: 4*byte: дата создания файла
4149
  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
4150
  * +20 = +0x14: 4*byte: дата последнего доступа
4151
  * +24 = +0x18: 4*byte: время последней модификации
4152
  * +28 = +0x1C: 4*byte: дата последней модификации
4153
  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
4154
  * +40 = +0x28: имя
4155
    * для формата ASCII: максимальная длина имени 263 символа
4156
      (263 байта), байт после имени имеет значение 0
4157
    * для формата UNICODE: максимальная длина имени 259 символов
4158
      (518 байт), два байта после имени имеют значение 0
4159
Формат времени:
4160
  * +0: byte: секунды
4161
  * +1: byte: минуты
4162
  * +2: byte: часы
4163
  * +3: byte: зарезервировано (0)
4164
  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
4165
Формат даты:
4166
  * +0: byte: день
4167
  * +1: byte: месяц
4168
  * +2: word: год
4169
  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
4170
Замечания:
4171
  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
4172
    304 байта, если в UNICODE - 560 байт. Значение длины выравнено
4173
    на целое кратное 16 байт
4174
    (для ускорения обработки в кэш-памяти CPU).
78 diamond 4175
  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
4176
    данные содержат мусор.
77 diamond 4177
  * Если файлы в папке кончились раньше, чем было прочитано
4178
    запрошенное количество, то функция прочитает, сколько сможет,
4179
    после чего вернёт eax=6 (EOF).
4180
  * Любая папка на диске, кроме корневой, содержит два специальных
4181
    входа "." и "..", идентифицирующих соответственно саму папку и
4182
    родительскую папку.
4183
  * Функция позволяет также читать виртуальные папки "/", "/rd",
4184
    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
4185
    0x10, а времена и даты обнулены. Альтернативный способ получения
4186
    информации об оборудовании - подфункция 11 функции 18.
4187
 
4188
======================================================================
4189
========== Функция -1 - завершить выполнение потока/процесса =========
4190
======================================================================
4191
Параметры:
4192
  * eax = -1 - номер функции
4193
Возвращаемое значение:
4194
  * функция не возвращает ни значения, ни управления
4195
Замечания:
4196
  * Если процесс явно не создавал потоков, то у него есть только
4197
    один поток, завершение которого приводит к завершению процесса.
4198
  * Если текущий поток - последний в процессе, то его завершение
4199
    также приводит к завершению процесса.
4200
  * Эта функция завершает текущий поток. Другой поток можно прибить
4201
    вызовом подфункции 2 функции 18.
4202
 
4203
======================================================================
4204
=========================== Список событий ===========================
4205
======================================================================
4206
Очередное событие можно получить вызовом одной из функций 10
4207
(ожидать события), 11 (проверить без ожидания), 23
4208
(ожидать в течение заданного времени).
4209
Эти функции возвращают только те события, которые входят в маску,
4210
устанавливаемую функцией 40. По умолчанию это первые три, чего
4211
вполне достаточно для многих приложений.
4212
Коды событий:
4213
  * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
4214
  * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
4215
    активно; сбрасывается, когда все клавиши из буфера
4216
    считаны функцией 2)
4217
  * 3 = нажата кнопка, определённая ранее функцией 8 (или кнопка
4218
    закрытия, созданная неявно функцией 0; кнопка минимизации
4219
    обрабатывается системой и о ней сообщения не приходит;
4220
    поступает, только когда окно активно; сбрасывается, когда все
4221
    кнопки из буфера считаны функцией 17)
4222
  * 4 = зарезервировано (в текущей реализации никогда не приходит даже
4223
    при размаскировке функцией 40)
4224
  * 5 = перерисовывается фон рабочего стола (сбрасывается
4225
    автоматически после перерисовки, так что если во время перерисовки
4226
    фона программа не ждёт и не проверяет события, то этого события
4227
    она не заметит)
4228
  * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
4229
    или перемещение; сбрасывается при прочтении)
4230
  * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
4231
    Communication; сбрасывается при прочтении)
4232
  * 8 = произошло сетевое событие (сбрасывается при прочтении;
4233
    смотри работу с сетью)
4234
  * 9 = произошло отладочное событие (сбрасывается при прочтении;
4235
    смотри отладочную подсистему)
4236
  * 16..31 = произошло событие с соответствующим IRQ
4237
    (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)
4238
 
4239
======================================================================
4240
==================== Коды ошибок файловой системы ====================
4241
======================================================================
4242
  * 0 = успешно
4243
  * 1 = не определена база и/или раздел жёсткого диска (подфункциями
4244
    7, 8 функции 21)
4245
  * 2 = функция не поддерживается для данной файловой системы
4246
    (возвращается в случае попытки LBA-чтения при запрещённом LBA)
4247
  * 3 = неизвестная файловая система
4248
  * 4 = возвращается только функцией rename при передаче сильно
4249
    неверного параметра и никак не соответствует описанию
4250
    в исходниках ядра "partition not defined at hd"
4251
  * 5 = файл не найден
4252
  * 6 = файл закончился
4253
  * 7 = указатель вне памяти приложения
4254
  * 8 = диск заполнен
4255
  * 9 = таблица FAT разрушена
4256
  * 10 = доступ запрещён
4257
При запуске программы возможны также следующие коды ошибок:
4258
  * 30 = 0x1E = недостаточно памяти
4259
  * 31 = 0x1F = файл не является исполнимым
4260
  * 32 = 0x20 = слишком много процессов