Subversion Repositories Kolibri OS

Rev

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

Rev Author Line No. Line
546 diamond 1
СИСТЕМНЫЕ ФУНКЦИИ ОПЕРАЦИОННОЙ СИСТЕМЫ Kolibri 0.7.0.0
77 diamond 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 - окно со скином
549 spraid 25
      * Y=4 - окно со скином и фиксированными размерами
77 diamond 26
      * остальные возможные значения (от 4 до 15) зарезервированы,
27
        вызов функции с такими Y игнорируется
28
    * RR, GG, BB = соответственно красная, зеленая, синяя
29
      составляющие цвета рабочей области окна
30
      (игнорируется для стиля Y=2)
114 mikedld 31
    * X = DCBA (биты)
118 diamond 32
      * A = 1 - у окна есть заголовок; для стиля Y=3 адрес строки
131 diamond 33
                  заголовка задаётся в edi, для прочих стилей
118 diamond 34
                  используется подфункция 1 функции 71
35
      * B = 1 - координаты всех графических примитивов задаются
36
                  относительно клиентской области окна
303 mikedld 37
      * C = 1 - не закрашивать рабочую область при отрисовке окна
118 diamond 38
      * D = 0 - нормальная заливка рабочей области, 1 - градиентная
77 diamond 39
    Следующие параметры предназначены для окон типа I и II и
40
    игнорируются для стилей Y=1,3:
41
  * esi = 0xXYRRGGBB - цвет заголовка
42
    * RR, GG, BB определяют сам цвет
43
    * Y=0 - обычное окно, Y=1 - неперемещаемое окно
44
    * X определяет градиент заголовка: X=0 - нет градиента,
45
      X=8 - обычный градиент,
46
      для окон типа II X=4 - негативный градиент
47
    * прочие значения X и Y зарезервированы
48
  * edi = 0x00RRGGBB - цвет рамки
49
Возвращаемое значение:
50
  * функция не возвращает значения
51
Замечания:
52
  * Положение и размеры окна устанавливаются при первом вызове
53
    этой функции и игнорируются при последующих; для изменения
54
    положения и/или размеров уже созданного окна используйте
55
    67-ю функцию.
118 diamond 56
  * Для окон стиля Y=3 с заголовком (A=1) строка заголовка
57
    устанавливается при первом вызове этой функции и игнорируется при
58
    последующих (точнее говоря, игнорируется после вызова
59
    подфункции 2 функции 12 - конца перерисовки);
60
    для изменения строки заголовка уже созданного окна используйте
61
    подфункцию 1 функции 71.
77 diamond 62
  * Если использовать окна соответствующих стилей, то положение
63
    и/или размеры окна могут меняться пользователем.
64
    Текущие положение и размеры могут быть получены вызовом функции 9.
65
  * Окно должно умещаться на экране. Если переданные координаты
66
    и размеры не удовлетворяют этому условию, то соответствующая
67
    координата (или, возможно, обе) считается нулем, а если и это
68
    не помогает, то соответствующий размер (или, возможно, оба)
69
    устанавливается в размер экрана.
70
 
71
    Далее обозначим xpos,ypos,xsize,ysize - значения, передаваемые
72
    в ebx,ecx. Координаты приводятся относительно левого верхнего
73
    угла окна, который, таким образом, задается как (0,0), координаты
74
    правого нижнего угла суть (xsize,ysize).
75
  * Размеры окна понимаются в смысле координат правого нижнего угла.
76
    Это же относится и ко всем остальным функциям.
77
    Это означает, что реальные размеры на 1 пиксель больше.
78
  * Вид окна типа I:
79
    * рисуется внешняя рамка цвета, указанного в edi,
80
      шириной 1 пиксель
81
    * рисуется заголовок - прямоугольник с левым верхним углом (1,1)
82
      и правым нижним (xsize-1,min(25,ysize)) цвета, указанного в esi
83
      (с учетом градиента)
84
    * если ysize>=26, то закрашивается рабочая область окна -
85
      прямоугольник с левым верхним углом (1,21) и правым нижним
86
      (xsize-1,ysize-1) (размерами (xsize-1)*(ysize-21)) - цветом,
87
      указанным в edx (с учетом градиента)
118 diamond 88
    * если A=1 и строка заголовка установлена подфункцией 1
89
      функции 71, то она выводится в соответствующем месте заголовка
77 diamond 90
  * Вид окна стиля Y=1:
91
    * полностью определяется приложением
92
  * Вид окна типа II:
131 diamond 93
    * рисуется внешняя рамка шириной 1 пиксель "затенённого" цвета
77 diamond 94
      edi (все составляющие цвета уменьшаются в два раза)
95
    * рисуется промежуточная рамка шириной 3 пикселя цвета edi
96
    * рисуется внутренняя рамка шириной 1 пиксель
131 diamond 97
      "затенённого" цвета edi
77 diamond 98
    * рисуется заголовок - прямоугольник с левым верхним углом (4,4)
99
      и правым нижним (xsize-4,min(20,ysize)) цвета, указанного в esi
100
      (с учетом градиента)
101
    * если ysize>=26, то закрашивается рабочая область окна -
102
      прямоугольник с левым верхним углом (5,20) и правым нижним
103
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
118 diamond 104
    * если A=1 и строка заголовка установлена подфункцией 1
105
      функции 71, то она выводится в соответствующем месте заголовка
77 diamond 106
  * Вид окна со скином:
107
    * рисуется внешняя рамка шириной 1 пиксель
108
      цвета 'outer' из скина
109
    * рисуется промежуточная рамка шириной 3 пикселя
110
      цвета 'frame' из скина
111
    * рисуется внутренняя рамка шириной 1 пиксель
112
      цвета 'inner' из скина
113
    * рисуется заголовок (по картинкам из скина) в прямоугольнике
114
      (0,0) - (xsize,_skinh-1)
115
    * если ysize>=26, то закрашивается рабочая область окна -
116
      прямоугольник с левым верхним углом (5,_skinh) и правым нижним
117
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
118
    * определяются две стандартные кнопки: закрытия и минимизации
119
      (смотри функцию 8)
118 diamond 120
    * если A=1 и в edi (ненулевой) указатель на строку заголовка,
121
      то она выводится в заголовке в месте, определяемом скином
77 diamond 122
    * Значение переменной _skinh доступно как результат вызова
123
      подфункции 4 функции 48
124
 
125
======================================================================
126
================= Функция 1 - поставить точку в окне. ================
127
======================================================================
128
Параметры:
129
  * eax = 1 - номер функции
130
  * ebx = x-координата (относительно окна)
131
  * ecx = y-координата (относительно окна)
132
  * edx = 0x00RRGGBB - цвет точки
133
    edx = 0x01xxxxxx - инвертировать цвет точки
134
          (младшие 24 бита игнорируются)
135
Возвращаемое значение:
136
  * функция не возвращает значения
137
 
138
======================================================================
139
============== Функция 2 - получить код нажатой клавиши. =============
140
======================================================================
141
Забирает код нажатой клавиши из буфера.
142
Параметры:
143
  * eax = 2 - номер функции
144
Возвращаемое значение:
145
  * если буфер пуст, возвращается eax=1
146
  * если буфер непуст, то возвращается al=0, ah=код нажатой клавиши,
147
    старшее слово регистра eax обнулено
92 diamond 148
  * если есть "горячая клавиша", то возвращается
149
    al=2, ah=сканкод нажатой клавиши (0 для управляющих клавиш),
150
    старшее слово регистра eax содержит состояние управляющих клавиш
151
    в момент нажатия горячей клавиши
77 diamond 152
Замечания:
153
  * Существует общесистемный буфер нажатых клавиш размером 120 байт,
154
    организованный как очередь.
131 diamond 155
  * Существует ещё один общесистемный буфер на 120 "горячих клавиш".
77 diamond 156
  * При вызове этой функции приложением с неактивным окном
92 diamond 157
    считается, что буфер нажатых клавиш пуст.
77 diamond 158
  * По умолчанию эта функция возвращает ASCII-коды; переключиться на
159
    режим сканкодов (и назад) можно с использованием функции 66.
92 diamond 160
    Однако, горячие клавиши всегда возвращаются как сканкоды.
77 diamond 161
  * Узнать, какие комбинации клавиш соответствуют каким кодам, можно,
162
    запустив приложения keyascii и scancode.
163
  * Сканкоды возвращаются непосредственно клавиатурой и фиксированы;
164
    ASCII-коды получаются с использованием таблиц преобразования,
165
    которые можно установить подфункцией 2 функции 21 и прочитать
166
    подфункцией 2 функции 26.
167
  * Как следствие, ASCII-коды учитывают текущую раскладку клавиатуры
168
    (rus/en) в отличие от сканкодов.
92 diamond 169
  * Поступает информация только о тех горячих клавишах, которые были
170
    определены этим потоком подфункцией 4 функции 66.
77 diamond 171
 
172
======================================================================
173
================ Функция 3 - получить системное время. ===============
174
======================================================================
175
Параметры:
176
  * eax = 3 - номер функции
177
Возвращаемое значение:
178
  * eax = 0x00SSMMHH, где HH:MM:SS = часы:минуты:секунды
179
  * каждый элемент возвращается как BCD-число, например,
180
    для времени 23:59:59 результат будет 0x00595923
181
Замечания:
182
  * Смотри также подфункцию 9 функции 26 - получение времени
183
    с момента запуска системы; она во многих случаях удобнее,
184
    поскольку возвращает просто DWORD-значение счетчика времени.
185
  * Системное время можно установить функцией 22.
186
 
187
======================================================================
118 diamond 188
============== Функция 4 - вывести строку текста в окно. =============
77 diamond 189
======================================================================
190
Параметры:
191
  * eax = 4 - номер функции
192
  * ebx = [координата по оси x]*65536 + [координата по оси y]
193
  * ecx = 0xX0RRGGBB, где
194
    * RR, GG, BB задают цвет текста
142 diamond 195
    * X=ABnn (биты):
185 heavyiron 196
    * nn задает используемый шрифт: 0=системный моноширинный,
197
      1=системный шрифт переменной ширины
142 diamond 198
    * A=0 - выводить esi символов, A=1 - выводить ASCIIZ-строку
199
    * B=1 - закрашивать фон цветом edi
77 diamond 200
  * edx = указатель на начало строки
142 diamond 201
  * esi = для A=0 длина строки, должна быть не больше 255;
202
          для A=1 игнорируется
77 diamond 203
Возвращаемое значение:
204
  * функция не возвращает значения
205
Замечания:
206
  * Первый системный шрифт считывается при загрузке из файла char.mt,
207
    второй - из char2.mt.
208
  * Оба шрифта имеют высоту 9 пикселей, ширина моноширинного шрифта
209
    равна 6 пикселей.
210
 
211
======================================================================
212
========================= Функция 5 - пауза. =========================
213
======================================================================
214
Задерживает выполнение программы на заданное время.
215
Параметры:
216
  * eax = 5 - номер функции
217
  * ebx = время в сотых долях секунды
218
Возвращаемое значение:
219
  * функция не возвращает значения
220
Замечания:
221
  * Передача ebx=0 не передает управление следующему процессу и
222
    вообще не производит никаких действий. Если действительно
223
    требуется передать управление следующему процессу
224
    (закончить текущий квант времени), используйте подфункцию 1
225
    функции 68.
226
  * При текущей реализации произойдет немедленный возврат из функции,
227
    если сложение ebx с текущим значением счетчика времени вызовет
228
    32-битное переполнение.
229
 
230
======================================================================
231
=============== Функция 6 - прочитать файл с рамдиска. ===============
232
======================================================================
233
Параметры:
234
  * eax = 6 - номер функции
235
  * ebx = указатель на имя файла
236
  * ecx = номер стартового блока, считая с 1;
237
    ecx=0 - читать с начала файла (то же самое, что и ecx=1)
238
  * edx = число блоков для чтения;
239
    edx=0 - читать один блок (то же самое, что и edx=1)
240
  * esi = указатель на область памяти, куда будут записаны данные
241
Возвращаемое значение:
242
  * eax = длина файла в байтах, если файл успешно прочитан
243
  * eax = -1, если файл не найден
244
Замечания:
245
  * Данная функция является устаревшей; функция 70
246
    позволяет выполнять те же действия с расширенными возможностями.
247
  * Блок = 512 байт.
248
  * Для чтения всего файла можно указать заведомо большое значение
249
    в edx, например, edx = -1; но в этом случае будьте готовы к тому,
250
    что программа "упадет", если файл окажется слишком большим
251
    и "не влезет" в память программы.
252
  * Имя файла должно быть либо в формате 8+3 символов
253
    (первые 8 символов - собственно имя, последние 3 - расширение,
254
    короткие имена и расширения дополняются пробелами),
255
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
256
    (имя не более 8 символов, точка, расширение 3 символа,
257
    дополненное при необходимости пробелами).
258
    Имя файла должно быть записано заглавными буквами.
259
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 260
  * Эта функция не поддерживает папки на рамдиске.
77 diamond 261
 
262
======================================================================
263
=============== Функция 7 - вывести изображение в окно. ==============
264
======================================================================
265
Параметры:
266
  * eax = 7 - номер функции
81 diamond 267
  * ebx = указатель на изображение в формате BBGGRRBBGGRR...
77 diamond 268
  * ecx = [размер по оси x]*65536 + [размер по оси y]
269
  * edx = [координата по оси x]*65536 + [координата по оси y]
270
Возвращаемое значение:
271
  * функция не возвращает значения
272
Замечания:
273
  * Координаты изображения - это координаты верхнего левого угла
274
    изображения относительно окна.
275
  * Размер изображения в байтах есть 3*xsize*ysize.
276
 
277
======================================================================
278
=============== Функция 8 - определить/удалить кнопку. ===============
279
======================================================================
280
Параметры для определения кнопки:
281
  * eax = 8 - номер функции
282
  * ebx = [координата по оси x]*65536 + [размер по оси x]
283
  * ecx = [координата по оси y]*65536 + [размер по оси y]
284
  * edx = 0xXYnnnnnn, где:
285
    * nnnnnn = идентификатор кнопки
286
    * старший (31-й) бит edx сброшен
287
    * если 30-й бит edx установлен - не прорисовывать кнопку
288
    * если 29-й бит edx установлен - не рисовать рамку
289
      при нажатии на кнопку
290
  * esi = 0x00RRGGBB - цвет кнопки
291
Параметры для удаления кнопки:
292
  * eax = 8 - номер функции
293
  * edx = 0x80nnnnnn, где nnnnnn - идентификатор кнопки
294
Возвращаемое значение:
295
  * функция не возвращает значения
296
Замечания:
297
  * Размеры кнопки должны быть больше 0 и меньше 0x8000.
298
  * Для окон со скином при определении окна (вызове 0-й функции)
299
    создаются две стандартные кнопки - закрытия окна
300
    с идентификатором 1 и минимизации окна с идентификатором 0xffff.
301
  * Создание двух кнопок с одинаковыми идентификаторами
302
    вполне допустимо.
303
  * Кнопка с идентификатором 0xffff при нажатии интерпретируется
304
    системой как кнопка минимизации, система обрабатывает такое
305
    нажатие самостоятельно, не обращаясь к приложению.
306
    В остальном это обычная кнопка.
307
  * Общее количество кнопок для всех приложений ограничено
308
    числом 4095.
309
 
310
======================================================================
311
============= Функция 9 - информация о потоке выполнения. ============
312
======================================================================
313
Параметры:
314
  * eax = 9 - номер функции
315
  * ebx = указатель на буфер размера 1 Кб
316
  * ecx = номер слота потока
317
    ecx = -1 - получить информацию о текущем потоке
318
Возвращаемое значение:
319
  * eax = максимальный номер слота потока
320
  * буфер, на который указывает ebx, содержит следующую информацию:
321
    * +0: dword: использование процессора (сколько тактов в секунду
322
      уходит на исполнение именно этого потока)
323
    * +4: word: позиция окна потока в оконном стэке
324
    * +6: word: (не имеет отношения к запрошенному потоку)
325
      номер слота потока, окно которого находится в оконном стэке
326
      в позиции ecx
327
    * +8: word: зарезервировано
328
    * +10 = +0xA: 11 байт: имя процесса
329
      (имя соответствующего исполняемого файла в формате 8+3)
142 diamond 330
    * +21 = +0x15: byte: зарезервировано, этот байт не изменяется
77 diamond 331
    * +22 = +0x16: dword: адрес процесса в памяти
332
    * +26 = +0x1A: dword: размер используемой памяти - 1
333
    * +30 = +0x1E: dword: идентификатор (PID/TID)
334
    * +34 = +0x22: dword: координата окна потока по оси x
335
    * +38 = +0x26: dword: координата окна потока по оси y
336
    * +42 = +0x2A: dword: размер окна потока по оси x
337
    * +46 = +0x2E: dword: размер окна потока по оси y
338
    * +50 = +0x32: word: состояние слота потока:
339
      * 0 = поток выполняется
340
      * 1 = поток приостановлен
341
      * 2 = поток приостановлен в момент ожидания события
342
      * 3 = поток завершается в результате вызова функции -1 или
343
        насильственно как следствие вызова подфункции 2 функции 18
344
        или завершения работы системы
345
      * 4 = поток завершается в результате исключения
346
      * 5 = поток ожидает события
347
      * 9 = запрошенный слот свободен, вся остальная информация о
348
        слоте не имеет смысла
142 diamond 349
    * +52 = +0x34: word: зарезервировано, это слово не изменяется
350
    * +54 = +0x36: dword: координата начала клиентской области
351
                          по оси x
352
    * +58 = +0x3A: dword: координата начала клиентской области
353
                          по оси y
354
    * +62 = +0x3E: dword: ширина клиентской области
355
    * +66 = +0x42: dword: высота клиентской области
356
    * +70 = +0x46: byte: состояние окна - битовое поле
357
      * бит 0 (маска 1): окно максимизировано
358
      * бит 1 (маска 2): окно минимизировано в панель задач
359
      * бит 2 (маска 4): окно свёрнуто в заголовок
77 diamond 360
Замечания:
361
  * Слоты нумеруются с 1.
362
  * Возвращаемое значение не есть общее число потоков, поскольку
363
    бывают свободные слоты.
364
  * При создании процесса автоматически создается поток выполнения.
365
  * Функция выдает информацию о потоке. Каждый процесс имеет
366
    хотя бы один поток. Один процесс может создать несколько потоков,
367
    в этом случае каждый поток получает свой слот, причем поля
368
    +10, +22, +26 в этих слотах совпадают.
369
    Для приложений не существует общего способа определить,
370
    принадлежат ли два потока одному процессу.
371
  * Активное окно - окно, находящееся на вершине оконного стэка,
372
    оно получает сообщения о вводе с клавиатуры. Для него позиция в
373
    оконном стэке совпадает с возвращаемым значением.
374
  * Слот 1 соответствует специальному потоку операционной системы,
375
    для которого:
376
    * окно находится внизу оконного стэка, поля +4 и +6 содержат
377
      значение 1
378
    * имя процесса - "OS/IDLE" (дополненное пробелами)
379
    * адрес процесса в памяти равен 0, размер используемой памяти
380
      16 Mb (0x1000000)
381
    * PID=1
142 diamond 382
    * координаты и размеры окна, равно как и клиентской области,
383
      условно полагаются равными 0
77 diamond 384
    * состояние слота - всегда 0 (выполняется)
385
    * время выполнения складывается из времени, уходящего на
386
      собственно работу, и времени простоя в ожидании прерывания
387
      (которое можно получить вызовом подфункции 4 функции 18).
388
  * Начиная со слота 2, размещаются обычные приложения.
172 serge 389
  * Обычные приложения размещаются в памяти по адресу 0x60400000
77 diamond 390
    (константа ядра std_application_base_address).
391
    Наложения не происходит, поскольку у каждого процесса своя
392
    таблица страниц.
393
  * При создании потока ему назначаются слот в системной таблице и
394
    идентификатор (Process/Thread IDentifier = PID/TID), которые для
395
    заданного потока не изменяются со временем.
396
    После завершения потока его слот может быть заново использован
397
    для другого потока. Идентификатор потока не может быть назначен
398
    другому потоку даже после завершения первого.
399
    Назначаемые новым потокам идентификаторы монотонно растут.
400
  * Если поток еще не определил свое окно вызовом функции 0, то
401
    положение и размеры этого окна полагаются нулями.
142 diamond 402
  * Координаты клиентской области окна берутся относительно окна.
77 diamond 403
  * В данный момент используется только часть буфера размером
142 diamond 404
    71 = 0x47 байта. Тем не менее рекомендуется использовать буфер
77 diamond 405
    размером 1 Кб для будущей совместимости, в будущем могут быть
406
    добавлены некоторые поля.
407
 
408
======================================================================
409
==================== Функция 10 - ожидать события. ===================
410
======================================================================
411
Если очередь сообщений пуста, то ждет появления сообщения в очереди.
412
В таком состоянии поток не получает процессорного времени.
413
Затем считывает сообщение из очереди.
414
 
415
Параметры:
416
  * eax = 10 - номер функции
417
Возвращаемое значение:
418
  * eax = событие (смотри список событий)
419
Замечания:
420
  * Учитываются только те события, которые входят в маску,
421
    устанавливаемую функцией 40. По умолчанию это события
422
    перерисовки, нажатия на клавиши и на кнопки.
423
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
424
    Чтобы ждать не более определенного времени, используйте
425
    функцию 23.
426
 
427
======================================================================
428
======= Функция 11 - проверить, есть ли событие, без ожидания. =======
429
======================================================================
430
Если в очереди сообщений есть какое-то событие, то считывает и
431
возвращает его. Если очередь пуста, возвращает нуль.
432
Параметры:
433
  * eax = 11 - номер функции
434
Возвращаемое значение:
435
  * eax = 0 - очередь сообщений пуста
436
  * иначе eax = событие (смотри список событий)
437
Замечания:
438
  * Учитываются только те события, которые входят в маску,
439
    устанавливаемую функцией 40. По умолчанию это события
440
    перерисовки, нажатия на клавиши и на кнопки.
441
  * Для ожидания появления события в очереди, используйте функцию 10.
442
    Чтобы ждать не более определенного времени, используйте
443
    функцию 23.
444
 
445
======================================================================
446
=========== Функция 12 - начать/закончить перерисовку окна. ==========
447
======================================================================
448
 
449
-------------- Подфункция 1 - начать перерисовку окна. ---------------
450
Параметры:
451
  * eax = 12 - номер функции
452
  * ebx = 1 - номер подфункции
453
Возвращаемое значение:
454
  * функция не возвращает значения
455
 
456
------------- Подфункция 2 - закончить перерисовку окна. -------------
457
Параметры:
458
  * eax = 12 - номер функции
459
  * ebx = 2 - номер подфункции
460
Возвращаемое значение:
461
  * функция не возвращает значения
462
Замечания:
131 diamond 463
  * Функция начала перерисовки удаляет все определённые
77 diamond 464
    функцией 8 кнопки, их следует определить повторно.
465
 
466
======================================================================
467
============ Функция 13 - нарисовать прямоугольник в окне. ===========
468
======================================================================
469
Параметры:
470
  * eax = 13 - номер функции
471
  * ebx = [координата по оси x]*65536 + [размер по оси x]
472
  * ecx = [координата по оси y]*65536 + [размер по оси y]
473
  * edx = цвет 0xRRGGBB или 0x80RRGGBB для градиентной заливки
474
Возвращаемое значение:
475
  * функция не возвращает значения
476
Замечания:
477
  * Под координатами понимаются координаты левого верхнего угла
478
    прямоугольника относительно окна.
479
 
480
======================================================================
481
================ Функция 14 - получить размеры экрана. ===============
482
======================================================================
483
Параметры:
484
  * eax = 14 - номер функции
485
Возвращаемое значение:
486
  * eax = [xsize]*65536 + [ysize], где
487
  * xsize = x-координата правого нижнего угла экрана =
488
            размер по горизонтали - 1
489
  * ysize = y-координата правого нижнего угла экрана =
490
            размер по вертикали - 1
491
Замечания:
492
  * Смотри также подфункцию 5 функции 48 - получить размеры рабочей
493
    области экрана.
494
 
495
======================================================================
496
= Функция 15, подфункция 1 - установить размер фонового изображения. =
497
======================================================================
498
Параметры:
499
  * eax = 15 - номер функции
500
  * ebx = 1 - номер подфункции
501
  * ecx = ширина изображения
502
  * edx = высота изображения
503
Возвращаемое значение:
504
  * функция не возвращает значения
505
Замечания:
499 diamond 506
  * Вызов функции обязателен перед вызовом подфункций 2 и 5.
77 diamond 507
  * Для обновления экрана (после завершения серии команд, работающих с
508
    фоном) вызывайте подфункцию 3 перерисовки фона.
509
  * Есть парная функция получения размеров фонового изображения -
510
    подфункция 1 функции 39.
511
 
512
======================================================================
513
= Функция 15, подфункция 2 - поставить точку на фоновом изображении. =
514
======================================================================
515
Параметры:
516
  * eax = 15 - номер функции
517
  * ebx = 2 - номер подфункции
518
  * ecx = смещение
519
  * edx = цвет точки 0xRRGGBB
520
Возвращаемое значение:
521
  * функция не возвращает значения
522
Замечания:
523
  * Смещение для точки с координатами (x,y) вычисляется как
524
    (x+y*xsize)*3.
499 diamond 525
  * Если указанное смещение превышает установленный подфункцией 1
526
    размер, вызов игнорируется.
77 diamond 527
  * Для обновления экрана (после завершения серии команд, работающих с
528
    фоном) вызывайте подфункцию 3 перерисовки фона.
529
  * Есть парная функция получения точки с фонового изображения -
530
    подфункция 2 функции 39.
531
 
532
======================================================================
533
============ Функция 15, подфункция 3 - перерисовать фон. ============
534
======================================================================
535
Параметры:
536
  * eax = 15 - номер функции
537
  * ebx = 3 - номер подфункции
538
Возвращаемое значение:
539
  * функция не возвращает значения
540
 
541
======================================================================
542
===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====
543
======================================================================
544
Параметры:
545
  * eax = 15 - номер функции
546
  * ebx = 4 - номер подфункции
547
  * ecx = режим отрисовки:
548
    * 1 = замостить
549
    * 2 = растянуть
550
Возвращаемое значение:
551
  * функция не возвращает значения
552
Замечания:
553
  * Для обновления экрана (после завершения серии команд, работающих с
554
    фоном) вызывайте подфункцию 3 перерисовки фона.
555
  * Есть парная команда получения режима отрисовки фона -
556
    подфункция 4 функции 39.
557
 
558
======================================================================
559
===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====
560
======================================================================
561
Параметры:
562
  * eax = 15 - номер функции
563
  * ebx = 5 - номер подфункции
81 diamond 564
  * ecx = указатель на данные в формате BBGGRRBBGGRR...
77 diamond 565
  * edx = смещение в данных фонового изображения
566
  * esi = размер данных в байтах = 3 * число пикселей
567
Возвращаемое значение:
568
  * функция не возвращает значения
569
Замечания:
499 diamond 570
  * Проверки корректности смещения и размера не производится.
81 diamond 571
  * Цвет каждого пикселя хранится как 3-байтная величина BBGGRR.
77 diamond 572
  * Пиксели фонового изображения записываются последовательно
573
    слева направо, сверху вниз.
574
  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.
575
  * Для обновления экрана (после завершения серии команд, работающих с
576
    фоном) вызывайте подфункцию 3 перерисовки фона.
577
 
578
======================================================================
546 diamond 579
====================== Функция 15, подфункция 6 ======================
580
==== Спроецировать данные фона на адресное пространство процесса. ====
581
======================================================================
582
Параметры:
583
  * eax = 15 - номер функции
584
  * ebx = 6 - номер подфункции
585
Возвращаемое значение:
586
  * eax = указатель на данные фона, 0 при ошибке
587
Замечания:
588
  * Спроецированные данные доступны на чтение и запись.
589
  * Размер данных фона равен 3*xsize*ysize. Изменение размеров фона
590
    блокируется на время работы с спроецированными данными.
591
  * Цвет каждого пикселя хранится как 3-байтовая величина BBGGRR.
592
  * Пиксели фонового изображения записываются последовательно
593
    слева направо, сверху вниз.
594
 
595
======================================================================
596
====================== Функция 15, подфункция 7 ======================
597
=== Закрыть проекцию данных фона на адресное пространство процесса. ==
598
======================================================================
599
Параметры:
600
  * eax = 15 - номер функции
601
  * ebx = 7 - номер подфункции
602
  * ecx = указатель на данные фона
603
Возвращаемое значение:
604
  * eax = 1 при успехе, 0 при ошибке
605
 
606
======================================================================
77 diamond 607
============= Функция 16 - сохранить рамдиск на дискету. =============
608
======================================================================
609
Параметры:
610
  * eax = 16 - номер функции
611
  * ebx = 1 или ebx = 2 - на какую дискету сохранять
612
Возвращаемое значение:
613
  * eax = 0 - успешно
614
  * eax = 1 - ошибка
615
 
616
======================================================================
617
============== Функция 17 - получить код нажатой кнопки. =============
618
======================================================================
619
Забирает код нажатой кнопки из буфера.
620
Параметры:
621
  * eax = 17 - номер функции
622
Возвращаемое значение:
623
  * если буфер пуст, возвращается eax=1
624
  * если буфер непуст, то возвращается al=0, старшие 24 бита eax
625
    содержат идентификатор кнопки (в частности, в ah оказывается
626
    младший байт идентификатора; если все кнопки имеют идентификатор,
627
    меньший 256, то для различения достаточно ah)
628
Замечания:
629
  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки
630
    информация о старой теряется.
631
  * При вызове этой функции приложением с неактивным окном
632
    возвращается ответ "буфер пуст".
633
 
634
======================================================================
635
======== Функция 18, подфункция 1 - завершить работу системы. ========
636
======================================================================
637
Параметры:
638
  * eax = 18 - номер функции
639
  * ebx = 1 - номер подфункции
640
Возвращаемое значение:
641
  * всегда возвращается eax = 0 как признак успеха
642
Замечания:
643
  * На последнем шаге появляется меню выхода из системы, ожидающее
644
    реакции пользователя.
645
  * Смотри также подфункцию 9, завершение работы системы с параметром,
646
    чтобы форсировать выбор в меню выхода.
647
 
648
======================================================================
91 diamond 649
==== Функция 18, подфункция 2 - завершить процесс/поток по слоту. ====
77 diamond 650
======================================================================
651
Параметры:
652
  * eax = 18 - номер функции
653
  * ebx = 2 - номер подфункции
654
  * ecx = номер слота процесса/потока
655
Возвращаемое значение:
656
  * функция не возвращает значения
657
Замечания:
658
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
659
    1), можно завершить любой обычный поток/процесс.
91 diamond 660
  * Смотри также подфункцию 18 - завершение
661
    процесса/потока с заданным идентификатором.
77 diamond 662
 
663
======================================================================
664
= Функция 18, подфункция 3 - сделать активным окно заданного потока. =
665
======================================================================
666
Параметры:
667
  * eax = 18 - номер функции
668
  * ebx = 3 - номер подфункции
669
  * ecx = номер слота потока
670
Возвращаемое значение:
671
  * функция не возвращает значения
672
Замечания:
673
  * При указании корректного, но несуществующего слота активизируется
674
    какое-то окно.
675
  * Узнать, какое окно является активным, можно вызовом подфункции 7.
676
 
677
======================================================================
131 diamond 678
 Функция 18, подфункция 4 - получить счётчик пустых тактов в секунду.
77 diamond 679
======================================================================
680
Под пустыми тактами понимается время, в которое процессор простаивает
681
в ожидании прерывания (в инструкции hlt).
682
 
683
Параметры:
684
  * eax = 18 - номер функции
685
  * ebx = 4 - номер подфункции
686
Возвращаемое значение:
131 diamond 687
  * eax = значение счётчика пустых тактов в секунду
77 diamond 688
 
689
======================================================================
690
======== Функция 18, подфункция 5 - получить тактовую частоту. =======
691
======================================================================
692
Параметры:
693
  * eax = 18 - номер функции
694
  * ebx = 5 - номер подфункции
695
Возвращаемое значение:
696
  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)
697
 
698
======================================================================
131 diamond 699
 Функция 18, подфункция 6 - сохранить рамдиск в файл на жёстком диске.
77 diamond 700
======================================================================
701
Параметры:
702
  * eax = 18 - номер функции
703
  * ebx = 6 - номер подфункции
341 heavyiron 704
  * ecx = указатель на строку с полным именем файла
705
    (например, "/hd0/1/kolibri/kolibri.img")
77 diamond 706
Возвращаемое значение:
707
  * eax = 0 - успешно
708
  * иначе eax = код ошибки файловой системы
709
Замечания:
131 diamond 710
  * Все папки в указанном пути должны существовать, иначе вернётся
77 diamond 711
    значение 5, "файл не найден".
712
 
713
======================================================================
714
====== Функция 18, подфункция 7 - получить номер активного окна. =====
715
======================================================================
716
Параметры:
717
  * eax = 18 - номер функции
718
  * ebx = 7 - номер подфункции
719
Возвращаемое значение:
720
  * eax = номер активного окна (номер слота потока, окно которого
721
    активно)
722
Замечания:
723
  * Активное окно находится вверху оконного стэка и получает
131 diamond 724
    сообщения обо всём вводе с клавиатуры.
77 diamond 725
  * Сделать окно активным можно вызовом подфункции 3.
726
 
727
======================================================================
728
==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====
729
======================================================================
131 diamond 730
При отключённом звуке вызовы подфункции 55 функции 55 игнорируются.
731
При включённом - направляются на встроенный спикер.
77 diamond 732
 
733
--------------- Подподфункция 1 - получить состояние. ----------------
734
Параметры:
735
  * eax = 18 - номер функции
736
  * ebx = 8 - номер подфункции
737
  * ecx = 1 - номер подподфункции
738
Возвращаемое значение:
131 diamond 739
  * eax = 0 - звук спикера разрешён; 1 - запрещён
77 diamond 740
 
741
-------------- Подподфункция 2 - переключить состояние. --------------
742
Переключает состояния разрешения/запрещения.
743
Параметры:
744
  * eax = 18 - номер функции
745
  * ebx = 8 - номер подфункции
746
  * ecx = 2 - номер подподфункции
747
Возвращаемое значение:
748
  * функция не возвращает значения
749
 
750
======================================================================
751
= Функция 18, подфункция 9 - завершение работы системы с параметром. =
752
======================================================================
753
Параметры:
754
  * eax = 18 - номер функции
755
  * ebx = 9 - номер подфункции
756
  * ecx = параметр:
757
    * 1 = на последнем шаге завершения работы сохранить рамдиск на
758
      дискету, после чего вывести меню выхода и запросить у
759
      пользователя дальнейшие действия
760
    * 2 = выключить компьютер
761
    * 3 = перезагрузить компьютер
762
    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске
763
Возвращаемое значение:
764
  * при неверном ecx регистры не меняются (т.е. eax=18)
765
  * при правильном вызове всегда возвращается признак успеха eax=0
766
Замечания:
767
  * Не следует полагаться на возвращаемое значение при неверном
768
    вызове, оно может измениться в последующих версиях ядра.
769
  * Можно использовать подфункцию 1, чтобы на последнем шаге
770
    завершения работы пользователь сам решал, что ему нужно.
771
  * Не рекомендуется использовать значение ecx=1 (чтобы не раздражать
772
    пользователя излишними вопросами); сохранить рамдиск на дискету
773
    можно функцией 16 (которая допускает уточнение, на какую именно
774
    дискету писать), а завершить работу с меню выхода можно уже
775
    упомянутой подфункцией 1.
776
 
777
======================================================================
778
======== Функция 18, подфункция 10 - свернуть окно приложения. =======
779
======================================================================
780
Сворачивает собственное окно.
781
Параметры:
782
  * eax = 18 - номер функции
783
  * ebx = 10 - номер подфункции
784
Возвращаемое значение:
785
  * функция не возвращает значения
786
Замечания:
787
  * Минимизированное окно с точки зрения функции 9 сохраняет положение
788
    и размеры.
789
  * Восстановление окна приложения происходит при активизировании
790
    подфункцией 3.
131 diamond 791
  * Обычно нет необходимости явно сворачивать/разворачивать своё окно:
77 diamond 792
    сворачивание окна осуществляется системой при нажатии на кнопку
793
    минимизации (которая для окон со скином определяется автоматически
131 diamond 794
    функцией 0, для окон без скина её можно определить функцией 8),
77 diamond 795
    восстановление - приложением @panel.
796
 
797
======================================================================
798
====================== Функция 18, подфункция 11 =====================
799
============= Получить информацию о дисковой подсистеме. =============
800
======================================================================
801
Параметры:
802
  * eax = 18 - номер функции
803
  * ebx = 11 - номер подфункции
804
  * ecx = тип таблицы:
805
    * 1 = короткая версия, 10 байт
806
    * 2 = полная версия, 65536 байт
807
  * edx = указатель на буфер (в приложении) для таблицы
808
Возвращаемое значение:
809
  * функция не возвращает значения
810
Формат таблицы: короткая версия:
811
  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,
131 diamond 812
    где AAAA задаёт тип первого дисковода, BBBB - второго согласно
77 diamond 813
    следующему списку:
814
    * 0 = нет дисковода
815
    * 1 = 360Kb, 5.25''
816
    * 2 = 1.2Mb, 5.25''
817
    * 3 = 720Kb, 3.5''
818
    * 4 = 1.44Mb, 3.5''
819
    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)
820
    Например, для стандартной конфигурации из одного 1.44-дисковода
821
    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:
822
    значение оказывается 24h.
131 diamond 823
  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,
77 diamond 824
    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
825
    * 0 = устройство отсутствует
131 diamond 826
    * 1 = жёсткий диск
77 diamond 827
    * 2 = CD-привод
828
    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
131 diamond 829
  * +2: 4 db: число найденных разделов на жёстких дисках с
77 diamond 830
    соответственно IDE0,...,IDE3.
131 diamond 831
    При отсутствии жёсткого диска на IDEx соответствующий байт
77 diamond 832
    нулевой, при наличии показывает число распознанных разделов,
833
    которых может и не быть (если носитель не отформатирован или
834
    если файловая система не поддерживается). В текущей версии ядра
277 diamond 835
    для жёстких дисков поддерживаются только FAT16, FAT32 и NTFS.
77 diamond 836
  * +6: 4 db: зарезервировано
837
Формат таблицы: полная версия:
838
  * +0: 10 db: такие же, как и в короткой версии
839
  * +10: 100 db: данные для первого раздела
840
  * +110: 100 db: данные для второго раздела
841
  * ...
842
  * +10+100*(n-1): 100 db: данные для последнего раздела
843
Разделы расположены в следующем порядке: сначала последовательно все
844
распознанные разделы на HD на IDE0 (если есть),
845
затем на HD на IDE1 (если есть) и т.д. до IDE3.
277 diamond 846
Формат информации о разделе:
77 diamond 847
  * +0: dword: начальный физический сектор раздела
848
  * +4: dword: последний физический сектор раздела
849
    (принадлежит разделу)
277 diamond 850
  * +8: byte: тип файловой системы:
851
    16=FAT16, 32=FAT32, 1=NTFS
852
  * формат дальнейших данных зависит от файловой системы,
853
    может меняться с изменениями в ядре и поэтому не описывается
77 diamond 854
Замечания:
855
  * Короткая таблица может быть использована для получения информации
856
    об имеющихся устройствах.
857
 
858
======================================================================
859
========== Функция 18, подфункция 13 - получить версию ядра. =========
860
======================================================================
861
Параметры:
862
  * eax = 18 - номер функции
863
  * ebx = 13 - номер подфункции
864
  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена
865
    информация
866
Возвращаемое значение:
867
  * функция не возвращает значения
868
Структура буфера:
869
db a,b,c,d для версии a.b.c.d
870
db UID_xxx: одно из UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
546 diamond 871
dd REV - номер svn-ревизии ядра
540 victor 872
Для ядра Kolibri 0.7.0.0:
873
db 0,7,0,0
77 diamond 874
db 2
540 victor 875
dd 533
77 diamond 876
 
877
======================================================================
878
====================== Функция 18, подфункция 14 =====================
131 diamond 879
======= Ожидать начала обратного хода луча развёртки монитора. =======
77 diamond 880
======================================================================
881
Параметры:
882
  * eax = 18 - номер функции
883
  * ebx = 14 - номер подфункции
884
Возвращаемое значение:
885
  * eax = 0 как признак успеха
886
Замечания:
887
  * Функция предназначена исключительно для активных
888
    высокопроизводительных графических приложений; используется для
889
    плавного вывода графики.
890
 
891
======================================================================
892
== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =
893
======================================================================
894
Параметры:
895
  * eax = 18 - номер функции
896
  * ebx = 15 - номер подфункции
897
Возвращаемое значение:
898
  * eax = 0 как признак успеха
899
 
900
======================================================================
901
====================== Функция 18, подфункция 16 =====================
902
============ Получить размер свободной оперативной памяти. ===========
903
======================================================================
904
Параметры:
905
  * eax = 18 - номер функции
906
  * ebx = 16 - номер подфункции
907
Возвращаемое значение:
908
  * eax = размер свободной памяти в килобайтах
909
 
910
======================================================================
911
====================== Функция 18, подфункция 17 =====================
912
============ Получить размер имеющейся оперативной памяти. ===========
913
======================================================================
914
Параметры:
915
  * eax = 18 - номер функции
916
  * ebx = 17 - номер подфункции
917
Возвращаемое значение:
918
  * eax = общий размер имеющейся памяти в килобайтах
919
 
920
======================================================================
91 diamond 921
====================== Функция 18, подфункция 18 =====================
922
============= Завершить процесс/поток по идентификатору. =============
85 halyavin 923
======================================================================
924
Параметры:
925
  * eax = 18 - номер функции
926
  * ebx = 18 - номер подфункции
91 diamond 927
  * ecx = идентификатор процесса/потока (PID/TID)
928
Возвращаемое значение:
929
  * eax = 0 - успешно
930
  * eax = -1 - ошибка (процесс не найден или является системным)
931
Замечания:
932
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
933
    1), можно завершить любой обычный поток/процесс.
934
  * Смотри также подфункцию 2 - завершение
935
    процесса/потока по заданному слоту.
85 halyavin 936
 
937
======================================================================
131 diamond 938
=== Функция 18, подфункция 19 - получить/установить настройки мыши. ==
120 mario79 939
======================================================================
131 diamond 940
 
941
------------- Подподфункция 0 - получить скорость мыши. --------------
120 mario79 942
Параметры:
943
  * eax = 18 - номер функции
944
  * ebx = 19 - номер подфункции
131 diamond 945
  * ecx = 0 - номер подподфункции
946
Возвращаемое значение:
947
  * eax = текущая скорость мыши
120 mario79 948
 
131 diamond 949
------------ Подподфункция 1 - установить скорость мыши. -------------
950
Параметры:
951
  * eax = 18 - номер функции
952
  * ebx = 19 - номер подфункции
953
  * ecx = 1 - номер подподфункции
954
  * edx = новое значение скорости
955
Возвращаемое значение:
956
  * функция не возвращает значения
120 mario79 957
 
131 diamond 958
------------- Подподфункция 2 - получить задержку мыши. --------------
959
Параметры:
960
  * eax = 18 - номер функции
961
  * ebx = 19 - номер подфункции
962
  * ecx = 2 - номер подподфункции
963
Возвращаемое значение:
964
  * eax = текущая задержка мыши
120 mario79 965
 
131 diamond 966
------------ Подподфункция 3 - установить задержку мыши. -------------
967
Параметры:
968
  * eax = 18 - номер функции
969
  * ebx = 19 - номер подфункции
970
  * ecx = 3 - номер подподфункции
971
  * edx = новое значение задержки мыши
972
Возвращаемое значение:
973
  * функция не возвращает значения
120 mario79 974
 
131 diamond 975
-------- Подподфункция 4 - установить положение курсора мыши. --------
976
Параметры:
977
  * eax = 18 - номер функции
978
  * ebx = 19 - номер подфункции
979
  * ecx = 4 - номер подподфункции
980
  * edx = [координата по оси x]*65536 + [координата по оси y]
981
Возвращаемое значение:
982
  * функция не возвращает значения
120 mario79 983
Замечания:
131 diamond 984
  * Рекомендуемая скорость мыши (в подподфункции 1) от 1 до 9.
985
    Устанавливаемая величина не проверяется кодом ядра, поэтому
986
    используйте осторожно, при некорректном значении курсор может
987
    "замёрзнуть". Скорость мыши можно регулировать в приложении SETUP.
988
  * Рекомендуемая величина задержки (в подподфункции 3) = 10.
989
    Меньшие значения не обрабатываются COM-мышами. При очень больших
990
    значениях невозможно передвижение мыши на 1 пиксель и курсор будет
991
    прыгать на величину установленной скорости (подподфункция 1).
992
    Устанавливаемая величина не проверяется кодом ядра.
133 diamond 993
    Величину задержки можно менять в приложении SETUP.
131 diamond 994
  * Подподфункция 4 не проверяет переданное значение. Перед вызовом
995
    необходимо узнать текущее разрешение экрана (подфункцией 14)
996
    и проверить, что устанавливаемое положение не выходит за пределы
997
    экрана.
120 mario79 998
 
999
======================================================================
172 serge 1000
====================== Функция 18, подфункция 20 =====================
1001
============= Получить информацию об оперативной памяти. =============
1002
======================================================================
1003
Параметры:
1004
  * eax = 18 - номер функции
1005
  * ebx = 20 - номер подфункции
1006
  * ecx = указатель на буфер для информации (36 байт)
1007
Возвращаемое значение:
1008
  * eax = общий размер имеющейся оперативной памяти в байтах
1009
    или -1 в случае ошибки
1010
  * буфер, на который указывает ecx, содержит следующую информацию:
277 diamond 1011
    * +0: dword: общий размер имеющейся оперативной памяти в страницах
172 serge 1012
    * +4:  dword: размер свободной оперативной памяти в страницах
1013
    * +8:  dword: число страничных ошибок (исключений #PF)
1014
                 в приложениях
1015
    * +12: dword: размер кучи ядра в байтах
277 diamond 1016
    * +16: dword: размер свободной памяти в куче ядра в байтах
172 serge 1017
    * +20: dword: общее количество блоков памяти в куче ядра
277 diamond 1018
    * +24: dword: количество свободных блоков памяти в куче ядра
172 serge 1019
    * +28: dword: размер наибольшего свободного блока в куче ядра
277 diamond 1020
                 (зарезервировано)
1021
    * +32: dword: размер наибольшего выделенного блока в куче ядра
1022
                 (зарезервировано)
172 serge 1023
 
1024
======================================================================
77 diamond 1025
==================== Функция 20 - интерфейс MIDI. ====================
1026
======================================================================
1027
 
1028
------------------------ Подфункция 1 - сброс ------------------------
1029
Параметры:
1030
  * eax = 20 - номер функции
1031
  * ebx = 1 - номер подфункции
1032
 
1033
-------------------- Подфункция 2 - вывести байт ---------------------
1034
Параметры:
1035
  * eax = 20 - номер функции
1036
  * ebx = 2 - номер подфункции
1037
  * cl = байт для вывода
1038
Возвращаемое значение (одинаково для обеих подфункций):
1039
  * eax = 0 - успешно
131 diamond 1040
  * eax = 1 - не определён базовый порт
77 diamond 1041
Замечания:
131 diamond 1042
  * Предварительно должен быть определён базовый порт вызовом
77 diamond 1043
    подфункции 1 функции 21.
1044
 
1045
======================================================================
1046
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
1047
======================================================================
1048
Параметры:
1049
  * eax = 21 - номер функции
1050
  * ebx = 1 - номер подфункции
1051
  * ecx = номер базового порта
1052
Возвращаемое значение:
1053
  * eax = 0 - успешно
1054
  * eax = -1 - ошибочный номер порта
1055
Замечания:
1056
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1057
  * Установка базы нужна для работы функции 20.
1058
  * Получить установленный базовый порт можно вызовом
1059
    подфункции 1 функции 26.
1060
 
1061
======================================================================
1062
===== Функция 21, подфункция 2 - установить раскладку клавиатуры. ====
1063
======================================================================
1064
Раскладка клавиатуры используется для преобразования сканкодов,
1065
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1066
Параметры:
1067
  * eax = 21 - номер функции
1068
  * ebx = 2 - номер подфункции
1069
  * ecx = какую раскладку устанавливать:
1070
    * 1 = нормальную
1071
    * 2 = раскладку при нажатом Shift
1072
    * 3 = раскладку при нажатом Alt
1073
  * edx = указатель на раскладку - таблицу длиной 128 байт
1074
Или:
1075
  * ecx = 9
1076
  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1077
Возвращаемое значение:
1078
  * eax = 0 - успешно
1079
  * eax = 1 - параметр задан неверно
1080
Замечания:
1081
  * Если нажат Alt, то используется раскладка с Alt;
1082
    если не нажат Alt, но нажат Shift, то
1083
    используется раскладка с Shift;
1084
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1085
    нормальная раскладка, после чего из кода вычитается 0x60;
1086
    если не нажата ни одна из управляющих клавиш, то используется
1087
    нормальная раскладка.
1088
  * Получить раскладки и идентификатор страны можно с помощью
1089
    подфункции 2 функции 26.
1090
  * Идентификатор страны - глобальная системная переменная, которая
1091
    самим ядром не используется; однако приложение @panel отображает
1092
    соответствующую текущей стране иконку.
1093
  * Приложение @panel переключает раскладки по запросу пользователя.
1094
 
1095
======================================================================
1096
=========== Функция 21, подфункция 3 - установить базу CD. ===========
1097
======================================================================
1098
Параметры:
1099
  * eax = 21 - номер функции
1100
  * ebx = 3 - номер подфункции
1101
  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1102
Возвращаемое значение:
1103
  * eax = 0
1104
Замечания:
1105
  * База CD используется функцией 24.
1106
  * Получить установленную базу CD можно вызовом
1107
    подфункции 3 функции 26.
1108
 
1109
======================================================================
1110
== Функция 21, подфункция 4 - установить базовый порт Sound Blaster. =
1111
======================================================================
1112
Параметры:
1113
  * eax = 21 - номер функции
1114
  * ebx = 4 - номер подфункции
1115
  * ecx = номер базового порта
1116
Возвращаемое значение:
1117
  * eax = 0 - успешно
1118
  * eax = -1 - ошибочный номер порта
1119
Замечания:
1120
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1121
  * Установка базы нужна для работы функций 25, 28, 55.
1122
  * Получить установленный базовый порт можно вызовом
1123
    подфункции 4 функции 26.
1124
 
1125
======================================================================
1126
========= Функция 21, подфункция 5 - установить язык системы. ========
1127
======================================================================
1128
Параметры:
1129
  * eax = 21 - номер функции
1130
  * ebx = 5 - номер подфункции
1131
  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1132
Возвращаемое значение:
1133
  * eax = 0
1134
Замечания:
1135
  * Язык системы - глобальная системная переменная, никак
1136
    не используемая самим ядром, однако приложение @panel рисует
1137
    соответствующую иконку.
1138
  * Проверок на корректность не делается, поскольку ядро эту
1139
    переменную не использует.
1140
  * Получить язык системы можно вызовом подфункции 5 функции 26.
1141
 
1142
======================================================================
1143
=========== Функция 21, подфункция 7 - установить базу HD. ===========
1144
======================================================================
131 diamond 1145
База HD нужна для определения, на какой жёсткий диск писать, при
346 diamond 1146
использовании устаревшего синтаксиса /HD в устаревшей функции 58;
1147
при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
1148
база устанавливается автоматически.
77 diamond 1149
Параметры:
1150
  * eax = 21 - номер функции
1151
  * ebx = 7 - номер подфункции
1152
  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1153
Возвращаемое значение:
1154
  * eax = 0
1155
Замечания:
1156
  * Любое приложение в любой момент времени может изменить базу.
1157
  * Не следует изменять базу, когда какое-нибудь приложение работает
131 diamond 1158
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1159
  * Получить установленную базу можно вызовом подфункции 7 функции 26.
131 diamond 1160
  * Следует также определить используемый раздел жёсткого диска
77 diamond 1161
    подфункцией 8.
1162
 
1163
======================================================================
1164
========== Функция 21, подфункция 8 - установить раздел HD. ==========
1165
======================================================================
131 diamond 1166
Раздел HD нужен для определения, на какой раздел жёсткого диска
346 diamond 1167
писать, при использовании устаревшего синтаксиса /HD в устаревшей
1168
функции 58; при использовании современного синтаксиса
1169
/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
77 diamond 1170
Параметры:
1171
  * eax = 21 - номер функции
1172
  * ebx = 8 - номер подфункции
1173
  * ecx = раздел HD (считая с 1)
1174
Возвращаемое значение:
1175
  * eax = 0
1176
Замечания:
1177
  * Любое приложение в любой момент времени может изменить раздел.
1178
  * Не следует изменять раздел, когда какое-нибудь приложение работает
131 diamond 1179
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1180
  * Получить установленный раздел можно вызовом подфункции 8
1181
    функции 26.
1182
  * Проверок на корректность не делается.
131 diamond 1183
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1184
    подфункции 11 функции 18.
131 diamond 1185
  * Следует также определить используемую базу жёсткого диска
77 diamond 1186
    подфункцией 7.
1187
 
1188
======================================================================
1189
===== Функция 21, подфункция 10 - установить канал DMA для звука. ====
1190
======================================================================
1191
Параметры:
1192
  * eax = 21 - номер функции
1193
  * ebx = 10 - номер подфункции
1194
  * ecx = номер канала (от 0 до 3 включительно)
1195
Возвращаемое значение:
1196
  * eax = 0 - успешно
1197
  * eax = -1 - неверный номер канала
1198
Замечания:
1199
  * Номер канала DMA используется в
1200
    подфункции 1 функции 55.
1201
  * Получить канал DMA для звука можно вызовом
1202
    подфункции 10 функции 26.
1203
 
1204
======================================================================
1205
====================== Функция 21, подфункция 11 =====================
1206
=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
1207
======================================================================
1208
Параметры:
1209
  * eax = 21 - номер функции
1210
  * ebx = 11 - номер подфункции
1211
  * ecx = 0/1 - запретить/разрешить
1212
Возвращаемое значение:
1213
  * eax = 0
1214
Замечания:
1215
  * Используется при LBA-чтении (подфункция 8 функции 58).
1216
  * Текущая реализация использует только младший бит ecx.
1217
  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
1218
 
1219
======================================================================
1220
====================== Функция 21, подфункция 12 =====================
1221
========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
1222
======================================================================
1223
Параметры:
1224
  * eax = 21 - номер функции
1225
  * ebx = 12 - номер подфункции
1226
  * ecx = 0/1 - запретить/разрешить
1227
Возвращаемое значение:
1228
  * eax = 0
1229
Замечания:
1230
  * Используется при работе с шиной PCI (функция 62).
1231
  * Текущая реализация использует только младший бит ecx.
1232
  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
1233
 
1234
======================================================================
1235
============= Функция 21, подфункция 13, подподфункция 1 =============
1236
==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
1237
======================================================================
1238
Параметры:
1239
  * eax = 21 - номер функции
1240
  * ebx = 13 - номер подфункции
1241
  * ecx = 1 - номер функции драйвера
1242
  * edx = указатель на буфер размера 512 байт
1243
Возвращаемое значение:
1244
  * если драйвер не загружен (никогда не бывает в текущей реализации):
1245
    * eax = -1
1246
    * ebx, ecx разрушаются
1247
  * если драйвер загружен:
1248
    * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт,
1249
      'Z' - старший) - сигнатура
131 diamond 1250
    * ebx = текущая частота развёртки (в Гц)
77 diamond 1251
    * ecx разрушается
1252
    * буфер, на который указывает edx, заполнен
1253
Формат буфера:
1254
  * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек,
1255
    дополнено пробелами)
1256
  * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как
1257
    y*65536+x), для текущей реализации 1 (1.0)
1258
  * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
1259
  * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое
1260
    слово - номер видеорежима, после собственно списка идут нули)
131 diamond 1261
  * +128 = +0x80: 32*(5*word): список поддерживаемых частот развёрток
77 diamond 1262
    для видеорежимов: для каждого видеорежима, указанного в предыдущем
1263
    поле, указано до 5 поддерживаемых частот
1264
    (в неиспользуемых позициях записаны нули)
1265
Замечания:
131 diamond 1266
  * Функция инициализирует драйвер (если он ещё не инициализирован)
77 diamond 1267
    и должна вызываться первой, перед остальными (иначе они будут
1268
    возвращать -1, ничего не делая).
131 diamond 1269
  * В текущей реализации поддерживается только одна частота развёртки
77 diamond 1270
    на видеорежим.
1271
 
1272
======================================================================
1273
============= Функция 21, подфункция 13, подподфункция 2 =============
1274
============= Получить информацию о текущем видеорежиме. =============
1275
======================================================================
1276
Параметры:
1277
  * eax = 21 - номер функции
1278
  * ebx = 13 - номер подфункции
1279
  * ecx = 2 - номер функции драйвера
1280
Возвращаемое значение:
1281
  * eax = -1 - драйвер не загружен или не инициализирован;
1282
    ebx,ecx разрушаются
1283
  * eax = [ширина]*65536 + [высота]
131 diamond 1284
  * ebx = частота вертикальной развёртки (в Гц)
77 diamond 1285
  * ecx = номер текущего видеорежима
1286
Замечания:
1287
  * Драйвер предварительно должен быть инициализирован вызовом
1288
    функции драйвера 1.
1289
  * Если нужны только размеры экрана, целесообразней использовать
131 diamond 1290
    функцию 14 с учётом того, что она возвращает размеры на 1 меньше.
77 diamond 1291
 
1292
======================================================================
1293
= Функция 21, подфункция 13, подподфункция 3 - установить видеорежим.
1294
======================================================================
1295
Параметры:
1296
  * eax = 21 - номер функции
1297
  * ebx = 13 - номер подфункции
1298
  * ecx = 3 - номер функции драйвера
131 diamond 1299
  * edx = [частота развёртки]*65536 + [номер видеорежима]
77 diamond 1300
Возвращаемое значение:
1301
  * eax = -1 - драйвер не загружен, не инициализирован или
1302
    произошла ошибка
1303
  * eax = 0 - успешно
1304
  * ebx, ecx разрушаются
1305
Замечания:
1306
  * Драйвер предварительно должен быть инициализирован вызовом
1307
    функции драйвера 1.
1308
  * Номер видеорежима и частота должны быть в таблице, возвращаемой
1309
    функцией драйвера 1.
1310
 
1311
======================================================================
1312
============= Функция 21, подфункция 13, подподфункция 4 =============
1313
================= Вернуться к начальному видеорежиму. ================
1314
======================================================================
1315
Возвращает экран в видеорежим, установленный при загрузке системы.
1316
Параметры:
1317
  * eax = 21 - номер функции
1318
  * ebx = 13 - номер подфункции
1319
  * ecx = 4 - номер функции драйвера
1320
Возвращаемое значение:
1321
  * eax = -1 - драйвер не загружен или не инициализирован
1322
  * eax = 0 - успешно
1323
  * ebx, ecx разрушаются
1324
Замечания:
1325
  * Драйвер предварительно должен быть инициализирован вызовом
1326
    функции драйвера 1.
1327
 
1328
======================================================================
1329
============= Функция 21, подфункция 13, подподфункция 5 =============
1330
======== Увеличить/уменьшить размер видимой области монитора. ========
1331
======================================================================
1332
Параметры:
1333
  * eax = 21 - номер функции
1334
  * ebx = 13 - номер подфункции
1335
  * ecx = 5 - номер функции драйвера
1336
  * edx = 0/1 - уменьшить/увеличить размер по горизонтали
1337
    на одну позицию
1338
  * edx = 2/3 - в текущей реализации не поддерживается; планируется
1339
    как уменьшение/увеличение размера по вертикали на одну позицию
1340
Возвращаемое значение:
1341
  * eax = -1 - драйвер не загружен или не инициализирован
1342
  * eax = 0 - успешно
1343
  * ebx, ecx разрушаются
1344
Замечания:
1345
  * Драйвер предварительно должен быть инициализирован вызовом
1346
    функции драйвера 1.
1347
  * Функция влияет только на физический размер изображения
1348
    на мониторе; логический размер (число пикселей) не меняется.
1349
 
1350
======================================================================
1351
============ Функция 22 - установить системную дату/время. ===========
1352
======================================================================
1353
Параметры:
1354
  * eax = 22 - номер функции
1355
  * ebx = 0 - установить время
1356
    * ecx = 0x00SSMMHH - время в двоично-десятичном коде (BCD):
1357
    * HH=час 00..23
1358
    * MM=минута 00..59
1359
    * SS=секунда 00..59
1360
  * ebx = 1 - установить дату
1361
    * ecx = 0x00DDMMYY - дата в двоично-десятичном коде (BCD):
1362
    * DD=день 01..31
1363
    * MM=месяц 01..12
1364
    * YY=год 00..99
1365
  * ebx = 2 - установить день недели
1366
    * ecx = 1 для воскресенья, ..., 7 для субботы
1367
  * ebx = 3 - установить будильник
1368
    * ecx = 0x00SSMMHH
1369
Возвращаемое значение:
1370
  * eax = 0 - успешно
1371
  * eax = 1 - параметр задан неверно
1372
  * eax = 2 - CMOS-батарейки разрядились
1373
Замечания:
1374
  * Ценность установки дня недели представляется сомнительной,
1375
    поскольку он мало где используется
1376
    (день недели можно рассчитать по дате).
1377
  * Будильник можно установить на срабатывание в заданное время
1378
    каждые сутки. При этом отключить его существующими системными
1379
    функциями нельзя.
1380
  * Срабатывание будильника заключается в генерации IRQ8.
1381
  * Вообще-то CMOS поддерживает для будильника установку значения
1382
    0xFF в качестве одного из параметров и означает это, что
1383
    соответствующий параметр игнорируется. Но в текущей реализации
131 diamond 1384
    это не пройдёт (вернётся значение 1).
77 diamond 1385
  * Будильник - глобальный системный ресурс; установка будильника
1386
    автоматически отменяет предыдущую установку. Впрочем, на данный
1387
    момент ни одна программа его не использует.
1388
 
1389
======================================================================
1390
============== Функция 23 - ожидать события с таймаутом. =============
1391
======================================================================
131 diamond 1392
Если очередь сообщений пуста, ждёт появления сообщения в очереди,
77 diamond 1393
но не более указанного времени. Затем считывает сообщение из очереди.
1394
 
1395
Параметры:
1396
  * eax = 23 - номер функции
1397
  * ebx = таймаут (в сотых долях секунды)
1398
Возвращаемое значение:
1399
  * eax = 0 - очередь сообщений пуста
1400
  * иначе eax = событие (смотри список событий)
1401
Замечания:
1402
  * Учитываются только те события, которые входят в маску,
1403
    устанавливаемую функцией 40. По умолчанию это события
1404
    перерисовки, нажатия на клавиши и на кнопки.
1405
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
1406
    Чтобы ждать сколь угодно долго, используйте функцию 10.
1407
  * Передача ebx=0 приводит к моментальному возвращению eax=0.
131 diamond 1408
  * При текущей реализации произойдёт немедленный возврат из функции
1409
    с eax=0, если сложение ebx с текущим значением счётчика времени
77 diamond 1410
    вызовет 32-битное переполнение.
1411
 
1412
======================================================================
1413
======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ======
1414
======================================================================
1415
Параметры:
1416
  * eax = 24 - номер функции
1417
  * ebx = 1 - номер подфункции
1418
  * ecx = 0x00FRSSMM, где
1419
    * MM = начальная минута
1420
    * SS = начальная секунда
1421
    * FR = начальный фрейм
1422
Возвращаемое значение:
1423
  * eax = 0 - успешно
1424
  * eax = 1 - не определена база CD
1425
Замечания:
1426
  * Предварительно нужно определить базовый порт CD вызовом
1427
    подфункции 3 функции 21.
1428
  * В секунде 75 фреймов, в минуте 60 секунд.
1429
  * Функция асинхронна (возвращает управление, когда началось
1430
    проигрывание).
1431
 
1432
======================================================================
1433
===== Функция 24, подфункция 2 - получить информацию о дорожках. =====
1434
======================================================================
1435
Параметры:
1436
  * eax = 24 - номер функции
1437
  * ebx = 2 - номер подфункции
1438
  * ecx = указатель на буфер для таблицы
1439
    (максимум 8*64h+4 байт=100 дорожек)
1440
Возвращаемое значение:
1441
  * eax = 0 - успешно
1442
  * eax = 1 - не определена база CD
1443
Замечания:
1444
  * Формат таблицы с информацией о дорожках такой же, как и для
1445
    ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h).
1446
    Адреса возвращаются в формате MSF.
1447
  * Предварительно нужно определить базовый порт CD вызовом
1448
    подфункции 3 функции 21.
1449
  * Функция возвращает информацию только о не более чем 100
1450
    первых дорожках. В большинстве случаев этого достаточно.
1451
 
1452
======================================================================
1453
==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. ===
1454
======================================================================
1455
Параметры:
1456
  * eax = 24 - номер функции
1457
  * ebx = 1 - номер подфункции
1458
Возвращаемое значение:
1459
  * eax = 0 - успешно
1460
  * eax = 1 - не определена база CD
1461
Замечания:
1462
  * Предварительно нужно определить базовый порт CD вызовом
1463
    подфункции 3 функции 21.
1464
 
1465
======================================================================
1466
============== Функция 25 - установить громкость SBPro. ==============
1467
======================================================================
1468
Параметры:
1469
  * eax = 25 - номер функции
1470
  * ebx = что устанавливать:
1471
    * 1 - установить общую громкость
1472
    * 2 - установить громкость CD-audio
1473
  * cl = уровень громкости: старшие 4 бита для левой колонки,
1474
    младшие 4 - для правой
1475
Возвращаемое значение:
1476
  * eax = 0 - успешно
1477
  * eax = 1 - не определена база SB
1478
  * eax = 2 - неверная подфункция
1479
Замечания:
1480
  * Предварительно нужно определить базовый порт SB вызовом
1481
    подфункции 4 функции 21.
1482
  * Смотри также функцию 28
1483
    установки звука для более позднего стандарта SB16.
1484
 
1485
======================================================================
1486
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
1487
======================================================================
1488
Параметры:
1489
  * eax = 26 - номер функции
1490
  * ebx = 1 - номер подфункции
1491
Возвращаемое значение:
1492
  * eax = номер порта
1493
Замечания:
1494
  * Установить базовый порт можно вызовом
1495
    подфункции 1 функции 21.
1496
 
1497
======================================================================
1498
====== Функция 26, подфункция 2 - получить раскладку клавиатуры. =====
1499
======================================================================
1500
Раскладка клавиатуры используется для преобразования сканкодов,
1501
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1502
Параметры:
1503
  * eax = 26 - номер функции
1504
  * ebx = 2 - номер подфункции
1505
  * ecx = какую раскладку получать:
1506
    * 1 = нормальную
1507
    * 2 = раскладку при нажатом Shift
1508
    * 3 = раскладку при нажатом Alt
1509
  * edx = указатель на буфер длиной 128 байт, куда будет скопирована
1510
    раскладка
1511
Возвращаемое значение:
1512
  * функция не возвращает значения
1513
Или:
1514
  * eax = 26 - номер функции
1515
  * ebx = 2 - номер подфункции
1516
  * ecx = 9
1517
Возвращаемое значение:
1518
  * eax = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1519
Замечания:
1520
  * Если нажат Alt, то используется раскладка с Alt;
1521
    если не нажат Alt, но нажат Shift, то используется
1522
    раскладка с Shift;
1523
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1524
    нормальная раскладка, после чего из кода вычитается 0x60;
1525
    если не нажата ни одна из управляющих клавиш, то используется
1526
    нормальная раскладка.
1527
  * Установить раскладки и идентификатор страны можно с помощью
1528
    подфункции 2 функции 21.
1529
  * Идентификатор страны - глобальная системная переменная, которая
1530
    самим ядром не используется; однако приложение @panel отображает
1531
    соответствующую текущей стране иконку
1532
    (используя описываемую функцию).
1533
  * Приложение @panel переключает раскладки по запросу пользователя.
1534
 
1535
======================================================================
1536
============ Функция 26, подфункция 3 - получить базу CD. ============
1537
======================================================================
1538
Параметры:
1539
  * eax = 26 - номер функции
1540
  * ebx = 3 - номер подфункции
1541
Возвращаемое значение:
1542
  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1543
Замечания:
1544
  * База CD используется функцией 24.
114 mikedld 1545
  * Установить базу CD можно вызовом подфункции 3 функции 21.
77 diamond 1546
 
1547
======================================================================
1548
=== Функция 26, подфункция 4 - получить базовый порт Sound Blaster. ==
1549
======================================================================
1550
Параметры:
1551
  * eax = 26 - номер функции
1552
  * ebx = 4 - номер подфункции
1553
Возвращаемое значение:
1554
  * eax = номер базового порта
1555
Замечания:
1556
  * Установка базы нужна для работы функций 25, 55.
1557
  * Установить базовый порт можно вызовом подфункции 4 функции 21.
1558
 
1559
======================================================================
1560
========== Функция 26, подфункция 5 - получить язык системы. =========
1561
======================================================================
1562
Параметры:
1563
  * eax = 26 - номер функции
1564
  * ebx = 5 - номер подфункции
1565
Возвращаемое значение:
1566
  * eax = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1567
Замечания:
1568
  * Язык системы - глобальная системная переменная, никак
1569
    не используемая самим ядром, однако приложение @panel рисует
1570
    соответствующую иконку (используя описываемую функцию).
1571
  * Установить язык системы можно вызовом подфункции 5 функции 21.
1572
 
1573
======================================================================
1574
============ Функция 26, подфункция 7 - получить базу HD. ============
1575
======================================================================
131 diamond 1576
База HD нужна для определения, на какой жёсткий диск писать, при
346 diamond 1577
использовании устаревшего синтаксиса /HD в устаревшей функции 58;
1578
при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
1579
база устанавливается автоматически.
77 diamond 1580
Параметры:
1581
  * eax = 26 - номер функции
1582
  * ebx = 7 - номер подфункции
1583
Возвращаемое значение:
1584
  * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1585
Замечания:
1586
  * Любое приложение в любой момент времени может изменить базу.
1587
  * Установить базу можно вызовом подфункции 7 функции 21.
131 diamond 1588
  * Получить используемый раздел жёсткого диска можно подфункцией 8.
77 diamond 1589
 
1590
======================================================================
1591
=========== Функция 26, подфункция 8 - получить раздел HD. ===========
1592
======================================================================
131 diamond 1593
Раздел HD нужен для определения, на какой раздел жёсткого диска
346 diamond 1594
писать, при использовании устаревшего синтаксиса /HD в устаревшей
1595
функции 58; при использовании современного синтаксиса
1596
/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
77 diamond 1597
Параметры:
1598
  * eax = 26 - номер функции
1599
  * ebx = 8 - номер подфункции
1600
Возвращаемое значение:
1601
  * eax = раздел HD (считая с 1)
1602
Замечания:
1603
  * Любое приложение в любой момент времени может изменить раздел.
1604
  * Установить раздел можно вызовом подфункции 8 функции 21.
131 diamond 1605
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1606
    подфункции 11 функции 18.
131 diamond 1607
  * Получить используемую базу жёсткого диска можно подфункцией 7.
77 diamond 1608
 
1609
======================================================================
131 diamond 1610
=== Функция 26, подфункция 9 - получить значение счётчика времени. ===
77 diamond 1611
======================================================================
1612
Параметры:
1613
  * eax = 26 - номер функции
1614
  * ebx = 9 - номер подфункции
1615
Возвращаемое значение:
1616
  * eax = число сотых долей секунды, прошедших с момента
1617
    запуска системы
1618
Замечания:
131 diamond 1619
  * Счётчик берётся по модулю 2^32, что соответствует немногим более
77 diamond 1620
    497 суток.
1621
  * Системное время можно получить функцией 3.
1622
 
1623
======================================================================
1624
====== Функция 26, подфункция 10 - получить канал DMA для звука. =====
1625
======================================================================
1626
Параметры:
1627
  * eax = 26 - номер функции
1628
  * ebx = 10 - номер подфункции
1629
Возвращаемое значение:
1630
  * eax = номер канала (от 0 до 3 включительно)
1631
Замечания:
1632
  * Номер канала DMA используется в подфункции 1 функции 55.
1633
  * Установить канал DMA для звука можно вызовом
1634
    подфункции 10 функции 21.
1635
 
1636
======================================================================
1637
====================== Функция 26, подфункция 11 =====================
131 diamond 1638
=========== Узнать, разрешён ли низкоуровневый доступ к HD. ==========
77 diamond 1639
======================================================================
1640
Параметры:
1641
  * eax = 26 - номер функции
1642
  * ebx = 11 - номер подфункции
1643
Возвращаемое значение:
131 diamond 1644
  * eax = 0/1 - запрещён/разрешён
77 diamond 1645
Замечания:
1646
  * Используется при LBA-чтении (подфункция 8 функции 58).
1647
  * Установить текущее состояние можно вызовом
1648
    подфункции 11 функции 21.
1649
 
1650
======================================================================
1651
====================== Функция 26, подфункция 12 =====================
131 diamond 1652
========== Узнать, разрешён ли низкоуровневый доступ к PCI. ==========
77 diamond 1653
======================================================================
1654
Параметры:
1655
  * eax = 26 - номер функции
1656
  * ebx = 12 - номер подфункции
1657
Возвращаемое значение:
131 diamond 1658
  * eax = 0/1 - запрещён/разрешён
77 diamond 1659
Замечания:
1660
  * Используется при работе с шиной PCI (функция 62).
1661
  * Текущая реализация использует только младший бит ecx.
1662
  * Установить текущее состояние можно вызовом
1663
    подфункции 12 функции 21.
1664
 
1665
======================================================================
1666
=============== Функция 28 - установить громкость SB16. ==============
1667
======================================================================
1668
Параметры:
1669
  * eax = 28 - номер функции
1670
  * ebx = что устанавливать:
1671
    * 1 - установить общую громкость
1672
    * 2 - установить громкость CD-audio
1673
  * cl = уровень громкости (0=off, 0xFF=max)
1674
Возвращаемое значение:
1675
  * eax = 0 - успешно
1676
  * eax = 1 - не определена база SB
1677
  * eax = 2 - неверная подфункция
1678
Замечания:
1679
  * Предварительно нужно определить базовый порт SB вызовом
1680
    подфункции 4 функции 21.
1681
  * Эта функция предоставляет больше вариантов для громкости,
1682
    чем функция 25.
1683
 
1684
======================================================================
1685
================ Функция 29 - получить системную дату. ===============
1686
======================================================================
1687
Параметры:
1688
  * eax = 29 - номер функции
1689
Возвращаемое значение:
1690
  * eax = 0x00DDMMYY, где
1691
    (используется двоично-десятичное кодирование, BCD)
1692
  * YY = две младшие цифры года (00..99)
1693
  * MM = месяц (01..12)
1694
  * DD = день (01..31)
1695
Замечания:
1696
  * Системную дату можно установить функцией 22.
1697
 
1698
======================================================================
521 diamond 1699
================ Функция 30 - работа с текущей папкой. ===============
1700
======================================================================
1701
 
1702
-------- Подфункция 1 - установить текущую папку для потока. ---------
1703
Параметры:
1704
  * eax = 30 - номер функции
1705
  * ebx = 1 - номер подфункции
1706
  * ecx = указатель на ASCIIZ-строку с путём к новой текущей папке
1707
Возвращаемое значение:
1708
  * функция не возвращает значения
1709
 
1710
--------- Подфункция 2 - получить текущую папку для потока. ----------
1711
Параметры:
1712
  * eax = 30 - номер функции
1713
  * ebx = 2 - номер подфункции
1714
  * ecx = указатель на буфер
1715
  * edx = размер буфера
1716
Возвращаемое значение:
1717
  * eax = длина имени текущей папки (включая завершающий 0)
1718
Замечания:
1719
  * Если размера буфера недостаточно для копирования всего имени,
1720
    копируются только первые (edx-1) байт
1721
    и в конце ставится завершающий 0.
1722
 
1723
======================================================================
77 diamond 1724
================ Функция 32 - удалить файл с рамдиска. ===============
1725
======================================================================
1726
Параметры:
1727
  * eax = 32 - номер функции
1728
  * ebx = указатель на имя файла
1729
Возвращаемое значение:
1730
  * eax = 0 - успешно; иначе код ошибки файловой системы
1731
Замечания:
1732
  * Эта функция устарела; функция 58 позволяет выполнять
1733
    те же действия с расширенными возможностями.
1734
  * Текущая реализация возвращает только значения 0(успех) и
1735
    5(файл не найден).
1736
  * Имя файла должно быть либо в формате 8+3 символов (первые
1737
    8 символов - собственно имя, последние 3 - расширение,
1738
    короткие имена и расширения дополняются пробелами),
1739
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1740
    (имя не более 8 символов, точка, расширение 3 символа,
1741
    дополненное при необходимости пробелами).
1742
    Имя файла должно быть записано заглавными буквами.
1743
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 1744
  * Эта функция не поддерживает папок на рамдиске.
77 diamond 1745
 
1746
======================================================================
1747
=============== Функция 33 - записать файл на рамдиск. ===============
1748
======================================================================
1749
Параметры:
1750
  * eax = 33 - номер функции
1751
  * ebx = указатель на имя файла
1752
  * ecx = указатель на данные для записи
1753
  * edx = число байт для записи
1754
  * следует устанавливать esi=0
1755
Возвращаемое значение:
1756
  * eax = 0 - успешно, иначе код ошибки файловой системы
1757
Замечания:
118 diamond 1758
  * Эта функция устарела; функция 70 позволяет выполнять
77 diamond 1759
    те же действия с расширенными возможностями.
1760
  * Если указать ненулевое значение в esi и на рамдиске уже есть
131 diamond 1761
    указанный файл, то будет создан ещё один файл с тем же именем.
77 diamond 1762
  * В противном случае файл перезаписывается.
1763
  * Имя файла должно быть либо в формате 8+3 символов
1764
    (первые 8 символов - собственно имя, последние 3 - расширение,
1765
    короткие имена и расширения дополняются пробелами),
1766
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1767
    (имя не более 8 символов, точка, расширение 3 символа,
1768
    дополненное при необходимости пробелами).
1769
    Имя файла должно быть записано заглавными буквами.
1770
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 1771
  * Эта функция не поддерживает папок на рамдиске.
77 diamond 1772
 
1773
======================================================================
1774
============ Функция 35 - прочитать цвет точки на экране. ============
1775
======================================================================
1776
Параметры:
1777
  * eax = 35
1778
  * ebx = y*xsize+x, где
1779
  * (x,y) = координаты точки (считая от 0)
1780
  * xsize = размер экрана по горизонтали
1781
Возвращаемое значение:
1782
  * eax = цвет 0x00RRGGBB
1783
Замечания:
1784
  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
1785
    что она вычитает 1 из обоих размеров.
1786
  * К видеопамяти есть также прямой доступ (без вызовов системных
1787
    функций) через селектор gs. Параметры текущего видеорежима
1788
    можно получить функцией 61.
1789
 
1790
======================================================================
277 diamond 1791
==================== Функция 37 - работа с мышью. ====================
77 diamond 1792
======================================================================
1793
 
1794
-------------- Подфункция 0 - экранные координаты мыши ---------------
1795
Параметры:
1796
  * eax = 37 - номер функции
1797
  * ebx = 0 - номер подфункции
1798
Возвращаемое значение:
1799
  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
1800
 
1801
---------- Подфункция 1 - координаты мыши относительно окна ----------
1802
Параметры:
1803
  * eax = 37 - номер функции
1804
  * ebx = 1 - номер подфункции
1805
Возвращаемое значение:
1806
  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
1807
    окна приложения (считая от 0)
1808
Замечания:
1809
  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
1810
    Если y>=ywnd, то младшее слово неотрицательно и содержит
1811
    относительную y-координату, а старшее - относительную x-координату
1812
    (правильного знака). В противном случае младшее слово отрицательно
131 diamond 1813
    и всё равно содержит относительную y-координату,
77 diamond 1814
    а к старшему слову следует прибавить 1.
1815
 
1816
----------------- Подфункция 2 - нажатые кнопки мыши -----------------
1817
Параметры:
1818
  * eax = 37 - номер функции
1819
  * ebx = 2 - номер подфункции
1820
Возвращаемое значение:
1821
  * eax содержит информацию о нажатых кнопках мыши:
1822
  * бит 0 установлен = левая кнопка нажата
1823
  * бит 1 установлен = правая кнопка нажата
486 kastigar 1824
  * бит 2 установлен = средняя кнопка нажата
1825
  * бит 3 установлен = 4-я кнопка нажата
1826
  * бит 4 установлен = 5-я кнопка нажата
77 diamond 1827
  * прочие биты сброшены
1828
 
277 diamond 1829
------------------ Подфункция 4 - загрузить курсор -------------------
221 serge 1830
Параметры:
1831
  * eax = 37 - номер функции
1832
  * ebx = 4 - номер подфункции
277 diamond 1833
  * dx = источник данных:
1834
  * dx = LOAD_FROM_FILE = 0 - данные в файле
1835
    * ecx = указатель на полный путь к файлу курсора
1836
    * файл курсора должен быть в формате .cur, стандартном для
1837
      MS Windows, причём размером 32*32 пикселя
1838
  * dx = LOAD_FROM_MEM = 1 - данные файла уже загружены в память
1839
    * ecx = указатель на данные файла курсора
1840
    * формат данных такой же, как и в предыдущем случае
1841
  * dx = LOAD_INDIRECT = 2 - данные в памяти
1842
    * ecx = указатель на образ курсора в формате ARGB 32*32 пикселя
1843
    * edx = 0xXXYY0002, где
1844
      * XX = x-координата "горячей точки" курсора
1845
      * YY = y-координата
1846
      * 0 <= XX, YY <= 31
221 serge 1847
Возвращаемое значение:
277 diamond 1848
  * eax = 0 - неудача
1849
  * иначе eax = хэндл курсора
221 serge 1850
 
277 diamond 1851
------------------ Подфункция 5 - установить курсор ------------------
1852
Устанавливает новый курсор для окна текущего потока.
221 serge 1853
Параметры:
1854
  * eax = 37 - номер функции
1855
  * ebx = 5 - номер подфункции
277 diamond 1856
  * ecx = хэндл курсора
221 serge 1857
Возвращаемое значение:
277 diamond 1858
  * eax = хэндл предыдущего установленного курсора
1859
Замечания:
1860
  * Если передан некорректный хэндл, то функция восстановит курсор
1861
    по умолчанию (стандартную стрелку). В частности, к восстановлению
1862
    курсора по умолчанию приводит передача ecx=0.
221 serge 1863
 
277 diamond 1864
------------------- Подфункция 6 - удалить курсор --------------------
221 serge 1865
Параметры:
1866
  * eax = 37 - номер функции
1867
  * ebx = 6 - номер подфункции
277 diamond 1868
  * ecx = хэндл курсора
221 serge 1869
Возвращаемое значение:
277 diamond 1870
  * eax разрушается
1871
Замечания:
1872
  * Курсор должен был быть ранее загружен текущим потоком
1873
    (вызовом подфункции 4). Функция не удаляет системные курсоры и
1874
    курсоры, загруженные другими приложениями.
1875
  * Если удаляется активный (установленный подфункцией 5) курсор, то
1876
    восстанавливается курсор по умолчанию (стандартная стрелка).
221 serge 1877
 
499 diamond 1878
------------------ Подфункция 7 - данные прокрутки -------------------
486 kastigar 1879
Параметры:
1880
  * eax = 37 - номер функции
499 diamond 1881
  * ebx = 6 - номер подфункции
486 kastigar 1882
Возвращаемое значение:
499 diamond 1883
  * eax = [horizontal offset]*65536 + [vertical offset]
486 kastigar 1884
Замечания:
499 diamond 1885
  * Данные доступны только активному окну.
1886
  * После прочтения значения обнуляются.
1887
  * Данные имеют знаковые значения.
486 kastigar 1888
 
77 diamond 1889
======================================================================
1890
================== Функция 38 - нарисовать отрезок. ==================
1891
======================================================================
1892
Параметры:
1893
  * eax = 38 - номер функции
1894
  * ebx = [координата начала по оси x]*65536 +
1895
              [координата конца по оси x]
1896
  * ecx = [координата начала по оси y]*65536 +
1897
              [координата конца по оси y]
1898
  * edx = 0x00RRGGBB - цвет
133 diamond 1899
    edx = 0x01xxxxxx - рисовать инверсный отрезок
1900
          (младшие 24 бита игнорируются)
77 diamond 1901
Возвращаемое значение:
1902
  * функция не возвращает значения
1903
Замечания:
1904
  * Координаты берутся относительно окна.
1905
  * Конечная точка также рисуется.
1906
 
1907
======================================================================
1908
== Функция 39, подфункция 1 - получить размер фонового изображения. ==
1909
======================================================================
1910
Параметры:
1911
  * eax = 39 - номер функции
1912
  * ebx = 1 - номер подфункции
1913
Возвращаемое значение:
1914
  * eax = [ширина]*65536 + [высота]
1915
Замечания:
1916
  * Есть парная команда установки размеров фонового изображения -
1917
    подфункция 1 функции 15. После которой, разумеется, следует
1918
    заново определить само изображение.
1919
 
1920
======================================================================
1921
= Функция 39, подфункция 2 - прочитать точку с фонового изображения. =
1922
======================================================================
1923
Параметры:
1924
  * eax = 39 - номер функции
1925
  * ebx = 2 - номер подфункции
1926
  * ecx = смещение
1927
Возвращаемое значение:
1928
  * eax = 0x00RRGGBB - цвет точки, если смещение допустимо
1929
    (меньше 0x160000-16)
1930
  * eax = 2 - иначе
1931
Замечания:
1932
  * Не следует полагаться на возвращаемое значение в случае неверного
1933
    смещения, оно может измениться в следующих версиях ядра.
1934
  * Смещение точки с координатами (x,y) вычисляется как (x+y*xsize)*3.
1935
  * Есть парная функция установки точки на фоновом изображении -
1936
    подфункция 2 функции 15.
1937
 
1938
======================================================================
1939
====== Функция 39, подфункция 4 - получить режим отрисовки фона. =====
1940
======================================================================
1941
Параметры:
1942
  * eax = 39 - номер функции
1943
  * ebx = 4 - номер подфункции
1944
Возвращаемое значение:
1945
  * eax = 1 - замостить
1946
  * eax = 2 - растянуть
1947
Замечания:
1948
  * Есть парная функция установки режима отрисовки фона -
1949
    подфункция 4 функции 15.
1950
 
1951
======================================================================
1952
======== Функция 40 - установить маску для ожидаемых событий. ========
1953
======================================================================
1954
Маска для ожидаемых событий влияет на функции работы с событиями 10,
131 diamond 1955
11, 23 - они сообщают только о событиях, разрешённых этой маской.
77 diamond 1956
Параметры:
1957
  * eax = 40 - номер функции
1958
  * ebx = маска: бит i соответствует событию i+1 (см. список событий)
1959
    (установленный бит разрешает извещение о событии)
1960
Возвращаемое значение:
1961
  * функция не возвращает значения
1962
Замечания:
1963
  * Маска по умолчанию (7=111b) разрешает извещения о перерисовке
1964
    и нажатиях клавиш и кнопок.
1965
    Этого достаточно для большинства приложений.
131 diamond 1966
  * События, запрещённые в маске, всё равно сохраняются, если
77 diamond 1967
    приходят; о них просто не извещают функции работы с событиями.
1968
  * Функции работы с событиями учитывают маску на момент
1969
    вызова функции, а не на момент поступления сообщения.
1970
 
1971
======================================================================
1972
================= Функция 41 - узнать владельца IRQ. =================
1973
======================================================================
1974
Параметры:
1975
  * eax = 41 - номер функции
1976
  * ebx = номер IRQ, 0..15
1977
Возвращаемое значение:
1978
  * eax = PID владельца
1979
  * eax = 0, если владельца нет
1980
  * eax = -1 для некорректного ebx
1981
 
1982
======================================================================
1983
========== Функция 42 - прочитать данные, полученные по IRQ. =========
1984
======================================================================
1985
При возникновении IRQ система может считывать данные из указанных
1986
ранее функцией 44 портов и записывать эти данные в буфер.
1987
Описываемая функция считывает побайтно данные из этого буфера.
1988
Параметры:
1989
  * eax = 42 - номер функции
1990
  * ebx = номер IRQ, 0..15
1991
Возвращаемое значение: (ситуацию можно различить по значению ecx)
1992
  * если поток не является владельцем IRQ
1993
    (или номер IRQ задан неверно):
1994
    * ecx = 2
1995
  * если данных нет:
1996
    * eax = 0
1997
    * ecx = 1
1998
    * ebx разрушается
131 diamond 1999
  * если всё в порядке и данные были:
2000
    * eax = размер данных, ещё не прочитанных из буфера (в байтах)
77 diamond 2001
    * ecx = 0
2002
    * ebx = очередной байт
2003
Замечания:
2004
  * Предварительно поток должен зарезервировать для себя указанный IRQ
2005
    функцией 45.
2006
  * Размер буфера для данных - 4000 байт, при переполнении
2007
    "свежие" данные перестают записываться в буфер.
2008
 
2009
======================================================================
2010
=================== Функция 43 - ввод/вывод в порт. ==================
2011
======================================================================
2012
 
2013
------------------------ Вывод данных в порт -------------------------
2014
Параметры:
2015
  * eax = 43 - номер функции
2016
  * bl = байт для вывода
2017
  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
2018
Возвращаемое значение:
2019
  * eax = 0 - успешно
2020
  * eax = 1 - поток не зарезервировал указанный порт
2021
 
2022
------------------------ Ввод данных из порта ------------------------
2023
Параметры:
2024
  * eax = 43 - номер функции
2025
  * ebx игнорируется
2026
  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
2027
Возвращаемое значение:
131 diamond 2028
  * eax = 0 - успешно, при этом ebx = введённый байт
77 diamond 2029
  * eax = 1 - поток не зарезервировал данный порт
2030
Замечания:
2031
  * Предварительно поток должен зарезервировать за собой
2032
    указанный порт функцией 46.
2033
  * Для зарезервированных портов вместо вызова этих функций
2034
    лучше использовать команды процессора in/out - это значительно
2035
    быстрее и несколько короче и проще. Из незарезервированных
131 diamond 2036
    портов читать всё равно нельзя.
77 diamond 2037
 
2038
======================================================================
2039
======== Функция 44 - определить действия при поступлении IRQ. =======
2040
======================================================================
2041
При возникновении IRQ система может считывать данные из указанных этой
2042
функцией портов и записывать эти данные в буфер, откуда их можно
2043
прочитать функцией 42.
2044
Параметры:
2045
  * eax = 44 - номер функции
2046
  * ebx = указатель на массив структур, описывающих по одному порту:
2047
    * +0: word: 0 означает конец массива, иначе номер порта
2048
    * +2: byte: зарезервировано (игнорируется)
2049
    * +3: byte: 1=считывать байт из этого порта, 2=считывать слово
2050
  * ecx = номер IRQ, 0..15
2051
Возвращаемое значение:
2052
  * eax = 0 - успешно
2053
  * eax = 1 - поток не является владельцем указанного IRQ
2054
Замечания:
2055
  * Предварительно поток должен зарезервировать за собой
2056
    указываемый IRQ функцией 45.
2057
  * Принимаются во внимание только первые 16 портов.
2058
  * Текущая реализация рассматривает неправильное значение поля +3
2059
    как сигнал прекращения обработки IRQ.
2060
 
2061
======================================================================
2062
============ Функция 45 - зарезервировать/освободить IRQ. ============
2063
======================================================================
2064
Параметры:
2065
  * eax = 45 - номер функции
2066
  * ebx = 0 - зарезервировать, 1 = освободить
2067
  * ecx = номер IRQ, 0..15
2068
Возвращаемое значение:
2069
  * eax = 0 - успешно
2070
  * eax = 1 - ошибка (неверный номер IRQ или
2071
    попытка зарезервировать несвободный IRQ или освободить IRQ, не
2072
    зарезервированный текущим потоком)
2073
Замечания:
2074
  * Резервирование IRQ нужно для работы функций 42 и 44.
2075
  * Только один поток может зарезервировать конкретный IRQ.
2076
  * IRQ, обрабатываемые системой самостоятельно, резервируются
2077
    системой (потоком 1) при загрузке.
2078
  * При завершении потока автоматически освобождаются
2079
    все зарезервированные им IRQ.
2080
 
2081
======================================================================
2082
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
2083
======================================================================
2084
К зарезервированным портам можно обращаться напрямую из приложения
2085
командами in/out (рекомендуемый способ) и вызовом функции 43
2086
(нерекомендуемый способ).
2087
Параметры:
2088
  * eax = 46 - номер функции
2089
  * ebx = 0 - зарезервировать, 1 - освободить
2090
  * ecx = номер начала диапазона портов
2091
  * edx = номер конца диапазона портов (включительно)
2092
Возвращаемое значение:
2093
  * eax = 0 - успешно
2094
  * eax = 1 - ошибка
2095
Замечания:
2096
  * В случае резервирования портов ошибкой считается выполнение
2097
    одного из условий:
2098
    * начальный адрес больше конечного;
2099
    * указанный диапазон содержит некорректный номер порта
2100
      (корректные - от 0 до 0xFFFF);
2101
    * превышено ограничение на общее число зарезервированных областей
2102
      - допускается максимум 255;
2103
    * указанный диапазон пересекается с одним из
2104
      ранее зарезервированных
2105
  * В случае освобождения портов ошибкой считается попытка
2106
    освобождения диапазона, который ранее не был целиком
2107
    зарезервирован этой же функцией (с такими же значениями ecx,edx).
2108
  * При обнаружении ошибки (в обоих случаях) никаких действий
2109
    не производится.
277 diamond 2110
  * При загрузке система резервирует за собой порты
2111
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (включительно).
77 diamond 2112
  * При завершении потока автоматически освобождаются все
2113
    зарезервированные им порты.
2114
 
2115
======================================================================
2116
================= Функция 47 - вывести число в окно. =================
2117
======================================================================
2118
Параметры:
2119
  * eax = 47 - номер функции
2120
  * ebx = параметры преобразования числа в текст:
2121
    * bl = 0 - ecx содержит число
2122
    * bl = 1 - ecx содержит указатель на dword-число
2123
    * bh = 0 - отображать в десятичной системе счисления
2124
    * bh = 1 - отображать в шестнадцатеричной системе
2125
    * bh = 2 - отображать в двоичной системе
2126
    * биты 16-21 = сколько цифр отображать
2127
    * биты 22-31 зарезервированы и должны быть установлены в 0
2128
  * ecx = число (при bl=0) или указатель (при bl=1)
2129
  * edx = [координата по оси x]*65536 + [координата по оси y]
142 diamond 2130
  * esi = 0xX0RRGGBB:
2131
    * RR, GG, BB задают цвет
2132
    * X = ABnn (биты)
2133
    * nn = шрифт (0/1)
2134
    * A игнорируется
2135
    * B=1 - закрашивать фон цветом edi
77 diamond 2136
Возвращаемое значение:
2137
  * функция не возвращает значения
2138
Замечания:
2139
  * Указанная длина не должна превосходить 60.
2140
  * Выводится ровно указанное количество цифр. Если число мало и
2141
    может быть записано меньшим количеством цифр, оно дополняется
2142
    ведущими нулями; если число велико и не может быть записано
2143
    таким количеством цифр, "лишние" ведущие цифры обрезаются.
2144
  * Параметры шрифтов указаны в описании функции 4 (вывода текста).
2145
 
2146
======================================================================
2147
======= Функция 48, подфункция 0 - применить настройки экрана. =======
2148
======================================================================
2149
Параметры:
2150
  * eax = 48 - номер функции
2151
  * ebx = 0 - номер подфункции
2152
  * ecx = 0 - зарезервировано
2153
Возвращаемое значение:
2154
  * функция не возвращает значения
2155
Замечания:
2156
  * Функция перерисовывает экран после изменения параметров
2157
    подфункциями 1 и 2.
2158
  * Вызов функции без предшествующих вызовов указанных подфункций
2159
    игнорируется.
2160
  * Вызов функции с ненулевым ecx игнорируется.
2161
 
2162
======================================================================
2163
========= Функция 48, подфункция 1 - установить стиль кнопок. ========
2164
======================================================================
2165
Параметры:
2166
  * eax = 48 - номер функции
2167
  * ebx = 1 - номер подфункции
2168
  * ecx = тип кнопок:
2169
    * 0 = плоские
131 diamond 2170
    * 1 = объёмные
77 diamond 2171
Возвращаемое значение:
2172
  * функция не возвращает значения
2173
Замечания:
2174
  * После вызова описываемой функции следует перерисовать экран
2175
    подфункцией 0.
2176
  * Тип кнопок влияет только на их прорисовку функцией 8.
2177
 
2178
======================================================================
2179
==== Функция 48, подфункция 2 - установить стандартные цвета окон. ===
2180
======================================================================
2181
Параметры:
2182
  * eax = 48 - номер функции
2183
  * ebx = 2 - номер подфункции
2184
  * ecx = указатель на таблицу цветов
2185
  * edx = размер таблицы цветов
2186
    (должен быть 40 байт для будущей совместимости)
2187
Формат таблицы цветов указан в описании подфункции 3.
2188
Возвращаемое значение:
2189
  * функция не возвращает значения
2190
Замечания:
2191
  * После вызова описываемой функции следует перерисовать экран
2192
    подфункцией 0.
2193
  * Таблица стандартных цветов влияет только на приложения,
2194
    которые эту таблицу явным образом получают (подфункцией 3) и
131 diamond 2195
    используют (указывая цвета из неё при вызовах функций рисования).
77 diamond 2196
  * Таблица стандартных цветов входит в скин и устанавливается заново
2197
    при установке скина (подфункции 8).
2198
  * Таблицу цветов можно просматривать/изменять интерактивно с помощью
2199
    приложения desktop.
2200
 
2201
======================================================================
2202
===== Функция 48, подфункция 3 - получить стандартные цвета окон. ====
2203
======================================================================
2204
Параметры:
2205
  * eax = 48 - номер функции
2206
  * ebx = 3 - номер подфункции
2207
  * ecx = указатель на буфер размером edx байт,
2208
    куда будет записана таблица
2209
  * edx = размер таблицы цветов
2210
    (должен быть 40 байт для будущей совместимости)
2211
Возвращаемое значение:
2212
  * функция не возвращает значения
2213
Формат таблицы цветов: каждый элемент -
2214
dword-значение цвета 0x00RRGGBB
2215
  * +0: dword: frames - цвет рамки
2216
  * +4: dword: grab - цвет заголовка
2217
  * +8: dword: grab_button - цвет кнопки на полосе заголовка
2218
  * +12 = +0xC: dword: grab_button_text - цвет текста на кнопке
2219
    на полосе заголовка
2220
  * +16 = +0x10: dword: grab_text - цвет текста на заголовке
2221
  * +20 = +0x14: dword: work - цвет рабочей области
2222
  * +24 = +0x18: dword: work_button - цвет кнопки в рабочей области
2223
  * +28 = +0x1C: dword: work_button_text - цвет текста на кнопке
2224
    в рабочей области
2225
  * +32 = +0x20: dword: work_text - цвет текста в рабочей области
2226
  * +36 = +0x24: dword: work_graph - цвет графики в рабочей области
2227
Замечания:
2228
  * Структура таблицы цветов описана в стандартном включаемом файле
2229
    macros.inc под названием system_colors; например, можно писать:
131 diamond 2230
    	sc	system_colors		; объявление переменной
2231
    	...				; где-то надо вызвать
2232
    					; описываемую функцию с ecx=sc
2233
    	mov	ecx, [sc.work_button_text]	; читаем цвет текста
2234
    					; на кнопке в рабочей области
77 diamond 2235
  * Использование/неиспользование этих цветов - дело исключительно
2236
    самой программы. Для использования нужно просто при вызове функций
2237
    рисования указывать цвет, взятый из этой таблицы.
2238
  * При изменении таблицы стандартных цветов (подфункцией 2 с
2239
    последующим применением изменений подфункцией 0 или
2240
    при установке скина подфункцией 8) всем окнам посылается сообщение
2241
    о необходимости перерисовки (событие с кодом 1).
2242
  * Стандартные цвета можно просматривать/изменять интерактивно
2243
    с помощью приложения desktop.
2244
 
2245
======================================================================
2246
========== Функция 48, подфункция 4 - получить высоту скина. =========
2247
======================================================================
2248
Параметры:
2249
  * eax = 48 - номер функции
2250
  * ebx = 4 - номер подфункции
2251
Возвращаемое значение:
2252
  * eax = высота скина
2253
Замечания:
2254
  * Высотой скина по определению считается высота заголовка окон,
2255
    использующих скин.
2256
  * Смотри также общую структуру окна в описании функции 0.
2257
 
2258
======================================================================
2259
===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
2260
======================================================================
2261
Параметры:
2262
  * eax = 48 - номер функции
2263
  * ebx = 5 - номер подфункции
2264
Возвращаемое значение:
2265
  * eax = [left]*65536 + [right]
2266
  * ebx = [top]*65536 + [bottom]
2267
Замечания:
2268
  * Рабочая область экрана определяет положение и координаты
2269
    максимизированного окна.
2270
  * Рабочая область экрана при нормальной работе есть весь экран
2271
    за вычетом панели (@panel).
2272
  * (left,top) - координаты левого верхнего угла,
2273
    (right,bottom) - координаты правого нижнего.
2274
    Таким образом, размер рабочей области по оси x определяется
2275
    формулой right-left+1, по оси y - формулой bottom-right+1.
2276
  * Смотри также функцию 14,
2277
    позволяющую определить размеры всего экрана.
2278
  * Есть парная функция установки рабочей области - подфункция 6.
2279
 
2280
======================================================================
2281
==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
2282
======================================================================
2283
Параметры:
2284
  * eax = 48 - номер функции
2285
  * ebx = 6 - номер подфункции
2286
  * ecx = [left]*65536 + [right]
2287
  * edx = [top]*65536 + [bottom]
2288
Возвращаемое значение:
2289
  * функция не возвращает значения
2290
Замечания:
2291
  * Рабочая область экрана определяет положение и координаты
2292
    максимизированного окна.
2293
  * Эта функция используется только приложением @panel,
2294
    устанавливающим рабочей областью весь экран за вычетом панели.
2295
  * (left,top) - координаты левого верхнего угла,
2296
    (right,bottom) - координаты правого нижнего.
2297
    Таким образом, размер рабочей области по оси x определяется
2298
    формулой right-left+1, по оси y - формулой bottom-right+1.
2299
  * Если left>=right, то x-координаты рабочей области не изменяются.
2300
    Если left<0, то left не устанавливается. Если right больше
2301
    или равно ширины экрана, то right не устанавливается.
2302
    Аналогично по оси y.
2303
  * Смотри также функцию 14,
2304
    позволяющую определить размеры всего экрана.
2305
  * Есть парная функция получения рабочей области -
2306
    подфункция 5.
2307
  * Эта функция автоматически перерисовывает экран, по ходу дела
118 diamond 2308
    обновляет координаты и размеры максимизированных окон.
77 diamond 2309
    Все окна извещаются о необходимости перерисовки (событие 1).
2310
 
2311
======================================================================
2312
====================== Функция 48, подфункция 7 ======================
2313
============ Получить область скина для текста заголовка. ============
2314
======================================================================
2315
Возвращает область заголовка окна со скином, предназначенную
2316
для вывода текста заголовка.
2317
Параметры:
2318
  * eax = 48 - номер функции
2319
  * ebx = 7 - номер подфункции
2320
Возвращаемое значение:
2321
  * eax = [left]*65536 + [right]
2322
  * ebx = [top]*65536 + [bottom]
2323
Замечания:
2324
  * Использование/неиспользование этой функции -
2325
    личное дело приложения.
2326
  * Рекомендуется учитывать значения, возвращаемые этой функцией,
2327
    при выборе места для рисования текста заголовка (функцией 4) или
2328
    какого-нибудь заменителя текста заголовка
2329
    (по усмотрению приложения).
2330
 
2331
======================================================================
2332
==== Функция 48, подфункция 8 - установить используемый скин окон. ===
2333
======================================================================
2334
Параметры:
2335
  * eax = 48 - номер функции
2336
  * ebx = 8 - номер подфункции
546 diamond 2337
  * ecx = указатель на имя файла скина
77 diamond 2338
Возвращаемое значение:
2339
  * eax = 0 - успешно
546 diamond 2340
  * eax = 1 - не удалось загрузить файл
2341
  * eax = 2 - файл не является файлом скина
77 diamond 2342
Замечания:
2343
  * При успешной загрузке скина все окна извещаются о необходимости
2344
    перерисовки (событие 1).
2345
  * При загрузке система считывает скин из файла default.skn
2346
    на рамдиске.
2347
  * Пользователь может изменять скин статически, создав свой
2348
    default.skn, или динамически с помощью приложения desktop.
2349
 
2350
======================================================================
78 diamond 2351
============ Функция 49 - Advanced Power Management (APM). ===========
2352
======================================================================
2353
Параметры:
2354
  * eax = 49 - номер функции
2355
  * dx = номер функции APM (аналог ax в спецификации)
2356
  * bx, cx = параметры функции APM
2357
Возвращаемое значение:
2358
  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
2359
    установлены в соответствии со спецификацией APM
2360
  * старшие половины 32-битных регистров eax, ebx, ecx,
2361
    edx, esi, edi разрушаются
2362
Замечания:
2363
  * Спецификация APM 1.2 описывается в документе
2364
    "Advanced Power Management (APM) BIOS Specification"
2365
    (Revision 1.2), доступном на
2366
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2367
    кроме того, она включена в известный Interrupt List by Ralf Brown
2368
    (http://www.pobox.com/~ralf/files.html,
2369
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2370
 
2371
======================================================================
77 diamond 2372
================= Функция 50 - установка формы окна. =================
2373
======================================================================
2374
Обычные окна представляют собой прямоугольники. С помощью этой функции
131 diamond 2375
окну можно придать произвольную форму. Форма задаётся набором точек
77 diamond 2376
внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
2377
размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
2378
функцией 67.
2379
 
2380
--------------- Установка данных с информацией о форме ---------------
2381
Параметры:
2382
  * eax = 50 - номер функции
2383
  * ebx = 0 - номер подфункции
2384
  * ecx = указатель на данные формы (массив байт 0/1)
2385
Возвращаемое значение:
2386
  * функция не возвращает значения
2387
 
2388
------------------ Установка масштаба данных формы -------------------
2389
Параметры:
2390
  * eax = 50 - номер функции
2391
  * ebx = 1 - номер подфункции
131 diamond 2392
  * ecx задаёт масштаб: каждый байт данных определяет
77 diamond 2393
    (2^scale)*(2^scale) пикселей
2394
Возвращаемое значение:
2395
  * функция не возвращает значения
2396
Замечания:
2397
  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
2398
    данных формы один байт соответствует одному пикселю, то масштаб
2399
    можно не устанавливать.
2400
  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
2401
    обратите внимание, что они на единицу больше, чем устанавливаемые
2402
    функциями 0, 67.
2403
  * По определению масштаба xsize и ysize должны делиться на 2^scale.
2404
  * Байт данных по смещению a должен быть 0/1 и
2405
    определяет принадлежность окну квадрата со стороной 2^scale
2406
    (при scale=0 получаем пиксель) и координатами левого верхнего угла
2407
    (a mod (xsize shr scale), a div (xsize shr scale))
2408
  * Размер данных: (xsize shr scale)*(ysize shr scale).
2409
  * Данные должны присутствовать в памяти и не меняться
2410
    после установки формы.
2411
  * Система просматривает данные о форме при каждой перерисовке окна
2412
    функцией 0.
2413
  * Вызов подфункции 0 с нулевым указателем приводит к возврату
2414
    к прямоугольной форме.
2415
 
2416
======================================================================
2417
===================== Функция 51 - создать поток. ====================
2418
======================================================================
2419
Параметры:
2420
  * eax = 51 - номер функции
2421
  * ebx = 1 - единственная подфункция
2422
  * ecx = адрес точки входа потока (начальный eip)
2423
  * edx = указатель стэка потока (начальный esp)
2424
Возвращаемое значение:
2425
  * eax = -1 - ошибка (в системе слишком много потоков)
2426
  * иначе eax = TID - идентификатор потока
2427
 
2428
======================================================================
2429
= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
2430
======================================================================
2431
Параметры:
2432
  * eax = 52 - номер функции
2433
  * ebx = 0 - номер подфункции
2434
Возвращаемое значение:
2435
  * eax = двойное слово конфигурации
2436
Замечания:
2437
  * Слово конфигурации можно установить подфункцией 2.
2438
  * Ядро не использует соответствующую переменную.
2439
    Ценность этой переменной и работающих с ней подфункций 0 и 2
2440
    представляется сомнительной.
2441
 
2442
======================================================================
2443
======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
2444
======================================================================
2445
Параметры:
2446
  * eax = 52 - номер функции
2447
  * ebx = 1 - номер подфункции
2448
Возвращаемое значение:
2449
  * eax = IP-адрес (4 байта)
2450
Замечания:
2451
  * Локальный IP-адрес устанавливается подфункцией 3.
2452
 
2453
======================================================================
2454
 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
2455
======================================================================
2456
Параметры:
2457
  * eax = 52 - номер функции
2458
  * ebx = 2 - номер подфункции
2459
  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
2460
    число 3, это воспринимается как запрос на [пере-]инициализацию
2461
    Ethernet-карты, в противном случае Ethernet выключается
2462
Возвращаемое значение:
2463
  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
2464
    но это может измениться в будущих версиях ядра
2465
  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
2466
    (отсутствие Ethernet-карты), а ненулевое значение - успех
2467
Замечания:
2468
  * Слово конфигурации можно прочитать подфункцией 0.
2469
  * Ядро не использует соответствующую переменную.
2470
    Ценность этой переменной, подфункции 0 и части подфункции 2,
2471
    устанавливающей эту переменную, представляется сомнительной.
2472
 
2473
======================================================================
2474
====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
2475
======================================================================
2476
Параметры:
2477
  * eax = 52 - номер функции
2478
  * ebx = 3 - номер подфункции
2479
  * ecx = IP-адрес (4 байта)
2480
Возвращаемое значение:
2481
  * текущая реализация возвращает eax=3, но это может быть изменено
2482
    в будущих версиях
2483
Замечания:
2484
  * Локальный IP-адрес можно получить подфункцией 1.
2485
 
2486
======================================================================
2487
= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
2488
======================================================================
2489
Параметры:
2490
  * eax = 52 - номер функции
2491
  * ebx = 6 - номер подфункции
2492
  * edx = размер данных
2493
  * esi = указатель на данные
2494
Возвращаемое значение:
2495
  * eax = -1 - ошибка
2496
  * eax = 0 - успешно
2497
Замечания:
2498
  * Эта функция предназначена только для медленных сетевых драйверов
2499
    (PPP, SLIP).
2500
  * Размер данных не должен превосходить 1500 байт,
2501
    хотя проверок корректности не делается.
2502
 
2503
======================================================================
2504
====================== Функция 52, подфункция 8 ======================
2505
============= Прочитать данные из сетевой очереди вывода. ============
2506
======================================================================
2507
Параметры:
2508
  * eax = 52 - номер функции
2509
  * ebx = 8 - номер подфункции
2510
  * esi = указатель на буфер размером 1500 байт
2511
Возвращаемое значение:
2512
  * eax = число прочитанных байт (в текущей реализации
2513
    либо 0 = нет данных, либо 1500)
2514
  * данные скопированы в буфер
2515
Замечания:
2516
  * Эта функция предназначена только для медленных сетевых драйверов
2517
    (PPP, SLIP).
2518
 
2519
======================================================================
2520
=========== Функция 52, подфункция 9 - получить gateway IP. ==========
2521
======================================================================
2522
Параметры:
2523
  * eax = 52 - номер функции
2524
  * ebx = 9 - номер подфункции
2525
Возвращаемое значение:
2526
  * eax = gateway IP (4 байта)
2527
 
2528
======================================================================
2529
========= Функция 52, подфункция 10 - получить маску подсети. ========
2530
======================================================================
2531
Параметры:
2532
  * eax = 52 - номер функции
2533
  * ebx = 10 - номер подфункции
2534
Возвращаемое значение:
2535
  * eax = маска подсети
2536
 
2537
======================================================================
2538
========= Функция 52, подфункция 11 - установить gateway IP. =========
2539
======================================================================
2540
Параметры:
2541
  * eax = 52 - номер функции
2542
  * ebx = 11 - номер подфункции
2543
  * ecx = gateway IP (4 байта)
2544
Возвращаемое значение:
2545
  * текущая реализация возвращает eax=11, но это может быть изменено
2546
    в будущих реализациях
2547
 
2548
======================================================================
2549
======== Функция 52, подфункция 12 - установить маску подсети. =======
2550
======================================================================
2551
Параметры:
2552
  * eax = 52 - номер функции
2553
  * ebx = 12 - номер подфункции
2554
  * ecx = маска подсети
2555
Возвращаемое значение:
2556
  * текущая реализация возвращает eax=12, но это может быть изменено
2557
    в будущих версиях
2558
 
2559
======================================================================
2560
============ Функция 52, подфункция 13 - получить DNS IP. ============
2561
======================================================================
2562
Параметры:
2563
  * eax = 52 - номер функции
2564
  * ebx = 13 - номер подфункции
2565
Возвращаемое значение:
2566
  * eax = DNS IP (4 байта)
2567
 
2568
======================================================================
2569
=========== Функция 52, подфункция 14 - установить DNS IP. ===========
2570
======================================================================
2571
Параметры:
2572
  * eax = 52 - номер функции
2573
  * ebx = 14 - номер подфункции
2574
  * ecx = DNS IP (4 байта)
2575
Возвращаемое значение:
2576
  * текущая реализация возвращает eax=14, но это может быть изменено
2577
    в следующих версиях
2578
 
2579
======================================================================
277 diamond 2580
====== Функция 52, подфункция 15 - получить локальный MAC-адрес. =====
2581
======================================================================
2582
Параметры:
2583
  * eax = 52 - номер функции
2584
  * ebx = 15 - номер подфункции
2585
  * ecx = 0 - читать первые 4 байта,
2586
    ecx = 4 - читать последние 2 байта
2587
Возвращаемое значение:
2588
  * для ecx=0: eax = первые 4 байта MAC-адреса
2589
  * для ecx=4: ax = последние 2 байта MAC-адреса,
2590
               старшая половина eax разрушается
2591
  * для других ecx: eax = -1 как признак ошибки
2592
 
2593
======================================================================
77 diamond 2594
============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========
2595
======================================================================
2596
Параметры:
2597
  * eax = 53 - номер функции
2598
  * ebx = 0 - номер подфункции
2599
  * ecx = локальный порт (учитывается только младшее слово)
131 diamond 2600
  * edx = удалённый порт (учитывается только младшее слово)
2601
  * esi = удалённый IP
77 diamond 2602
Возвращаемое значение:
2603
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2604
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2605
    сокет и имеющее смысл только для системы) - успешно;
2606
    ebx разрушается
2607
 
2608
======================================================================
2609
============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========
2610
======================================================================
2611
Параметры:
2612
  * eax = 53 - номер функции
2613
  * ebx = 1 - номер подфункции
2614
  * ecx = хэндл сокета
2615
Возвращаемое значение:
2616
  * eax = -1 - неверный хэндл
2617
  * eax = 0 - успешно
2618
  * ebx разрушается
2619
Замечания:
2620
  * Текущая реализация не закрывает автоматически все сокеты потока
2621
    при его завершении. В частности, не следует прибивать поток
2622
    с кучей открытых сокетов - будет утечка ресурсов.
2623
  * Текущая реализация не делает проверок на корректность
2624
    (единственное, на что возвращается ошибка, - попытка закрыть
2625
    неоткрытый сокет с корректным хэндлом).
2626
 
2627
======================================================================
2628
============== Функция 53, подфункция 2 - опрос сокета. ==============
2629
======================================================================
2630
Параметры:
2631
  * eax = 53 - номер функции
2632
  * ebx = 2 - номер подфункции
2633
  * ecx = хэндл сокета
2634
Возвращаемое значение:
2635
  * eax = число полученных байт
2636
  * ebx разрушается
2637
Замечания:
2638
  * Проверки корректности не делается.
2639
 
2640
======================================================================
2641
======== Функция 53, подфункция 3 - прочитать байт из сокета. ========
2642
======================================================================
2643
Параметры:
2644
  * eax = 53 - номер функции
2645
  * ebx = 3 - номер подфункции
2646
  * ecx = хэндл сокета
2647
Возвращаемое значение:
2648
  * если нет принятых данных: eax=0, bl=0,
118 diamond 2649
    прочие байты ebx разрушаются
77 diamond 2650
  * если были принятые данные: eax=число оставшихся байт
118 diamond 2651
    (возможно, 0), bl=прочитанный байт, прочие байты ebx разрушаются
77 diamond 2652
Замечания:
2653
  * Проверки корректности не производится.
2654
 
2655
======================================================================
2656
========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========
2657
======================================================================
2658
Параметры:
2659
  * eax = 53 - номер функции
2660
  * ebx = 4 - номер подфункции
2661
  * ecx = хэндл сокета
2662
  * edx = число байт для записи
2663
  * esi = указатель на данные для записи
2664
Возвращаемое значение:
2665
  * eax = 0xffffffff - неверный хэндл
2666
  * eax = 0xffff - недостаточно памяти
2667
  * eax = 0 - успешно
2668
  * ebx разрушается
2669
Замечания:
114 mikedld 2670
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2671
    не очень неправильные неоткрытые хэндлы.
2672
  * Число байт для записи не может превышать 1500-28, хотя
2673
    соответствующей проверки не делается.
2674
 
2675
======================================================================
2676
============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========
2677
======================================================================
2678
Параметры:
2679
  * eax = 53 - номер функции
2680
  * ebx = 5 - номер подфункции
2681
  * ecx = локальный порт (учитывается только младшее слово)
131 diamond 2682
  * edx = удалённый порт (учитывается только младшее слово)
2683
  * esi = удалённый IP
77 diamond 2684
  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1
2685
Возвращаемое значение:
2686
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2687
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2688
    сокет и имеющее смысл только для системы) - успешно;
2689
    ebx разрушается
2690
 
2691
======================================================================
2692
====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
2693
======================================================================
2694
Параметры:
2695
  * eax = 53 - номер функции
2696
  * ebx = 6 - номер подфункции
2697
  * ecx = хэндл сокета
2698
Возвращаемое значение:
2699
  * eax = статус сокета: одно из
2700
  * TCB_LISTEN = 1
2701
  * TCB_SYN_SENT = 2
2702
  * TCB_SYN_RECEIVED = 3
2703
  * TCB_ESTABLISHED = 4
2704
  * TCB_FIN_WAIT_1 = 5
2705
  * TCB_FIN_WAIT_2 = 6
2706
  * TCB_CLOSE_WAIT = 7
2707
  * TCB_CLOSING = 8
2708
  * TCB_LAST_ASK = 9
2709
  * TCB_TIME_WAIT = 10
2710
  * TCB_CLOSED = 11
2711
  * ebx разрушается
2712
Замечания:
2713
  * Проверок корректности не производится.
2714
 
2715
======================================================================
2716
========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
2717
======================================================================
2718
Параметры:
2719
  * eax = 53 - номер функции
2720
  * ebx = 7 - номер подфункции
2721
  * ecx = хэндл сокета
2722
  * edx = число байт для записи
2723
  * esi = указатель на данные для записи
2724
Возвращаемое значение:
2725
  * eax = 0xffffffff - ошибка
2726
  * eax = 0xffff - недостаточно памяти
2727
  * eax = 0 - успешно
2728
  * ebx разрушается
2729
Замечания:
114 mikedld 2730
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2731
    не очень неправильные неоткрытые хэндлы.
2732
  * Число байт для записи не может превышать 1500-40,
2733
    хотя соответствующей проверки не делается.
2734
 
2735
======================================================================
2736
============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========
2737
======================================================================
2738
Параметры:
2739
  * eax = 53 - номер функции
2740
  * ebx = 8 - номер подфункции
2741
  * ecx = хэндл сокета
2742
Возвращаемое значение:
2743
  * eax = -1 - неверный хэндл
2744
  * eax = 0xffff - недостаточно памяти для пакета закрытия сокета
2745
  * eax = 0 - успешно
2746
  * во многих случаях eax разрушается (возвращается результат функции
2747
    queue) - видимо, это баг, который будет исправлен
2748
  * ebx разрушается
2749
Замечания:
2750
  * Текущая реализация не закрывает автоматически все сокеты потока
2751
    при его завершении. В частности, не следует прибивать поток
2752
    с кучей открытых сокетов - будет утечка ресурсов.
2753
  * Текущая реализация не делает проверок на корректность
2754
    (единственное, на что возвращается ошибка, - попытка закрыть
2755
    неоткрытый сокет с корректным хэндлом).
2756
 
2757
======================================================================
2758
== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =
2759
======================================================================
2760
Параметры:
2761
  * eax = 53 - номер функции
2762
  * ebx = 9 - номер подфункции
2763
  * ecx = номер локального порта (используются только младшие 16 бит)
2764
Возвращаемое значение:
2765
  * eax = 0 - порт используется
2766
  * eax = 1 - порт свободен
2767
  * ebx разрушается
2768
 
2769
======================================================================
314 diamond 2770
==== Функция 53, подфункция 10 - получить статус кабеля Ethernet. ====
2771
======================================================================
2772
Параметры:
2773
  * eax = 53 - номер функции
2774
  * ebx = 10 - номер подфункции
2775
Возвращаемое значение:
2776
  * al = -1 - драйвер сетевой карты не загружен или
2777
              не поддерживает эту функцию
2778
  * al = 0 - кабель не подключён
2779
  * al = 1 - кабель подключён
346 diamond 2780
  * ebx разрушается
314 diamond 2781
Замечания:
2782
  * Текущая реализация ядра поддерживает эту функцию
2783
    только для сетевых карт RTL8139.
2784
 
2785
======================================================================
346 diamond 2786
==== Функция 53, подфункция 11 - прочитать данные сетевого стека. ====
340 heavyiron 2787
======================================================================
2788
Параметры:
2789
  * eax = 53 - номер функции
2790
  * ebx = 11 - номер подфункции
346 diamond 2791
  * ecx = хэндл сокета
2792
  * edx = указатель на буфер
2793
  * esi = число байт для чтения;
2794
  * esi = 0 - читать все данные (максимум 4096 байт)
2795
Возвращаемое значение:
2796
  * eax = число прочитанных байт
2797
  * ebx разрушается
340 heavyiron 2798
Замечания:
346 diamond 2799
  * Проверки на правильность хэндла не делается.
340 heavyiron 2800
 
2801
======================================================================
77 diamond 2802
 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.
2803
======================================================================
2804
Параметры:
2805
  * eax = 53 - номер функции
2806
  * ebx = 255 - номер подфункции
2807
  * ecx = тип запрашиваемой информации (смотри ниже)
2808
Возвращаемое значение:
2809
  * eax = запрошенная информация
2810
  * ebx разрушается
2811
Возможные значения ecx:
2812
  * 100: длина очереди 0 (empty queue)
2813
  * 101: длина очереди 1 (ip-out queue)
2814
  * 102: длина очереди 2 (ip-in queue)
2815
  * 103: длина очереди 3 (net1out queue)
2816
  * 200: число элементов в таблице ARP
2817
  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)
2818
  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда
2819
    берут информацию 5 последующих типов;
131 diamond 2820
    в этом случае eax неопределён
77 diamond 2821
  * 203: IP-адрес, запомненный типом 202
2822
  * 204: старшее dword MAC-адреса, запомненного типом 202
2823
  * 205: младшее word MAC-адреса, запомненного типом 202
2824
  * 206: слово статуса, запомненное типом 202
2825
  * 207: слово ttl, запомненное типом 202
2826
  * 2: общее число полученных IP-пакетов
2827
  * 3: общее число переданных IP-пакетов
2828
  * 4: общее число сдампленных полученных пакетов
2829
  * 5: общее число полученных ARP-пакетов
2830
  * 6: статус драйвера пакетов, 0=неактивен,
2831
    ненулевое значение=активен
2832
 
2833
======================================================================
2834
======== Функция 55, подфункция 0 - загрузить данные для SB16. =======
2835
======================================================================
2836
Параметры:
2837
  * eax = 55 - номер функции
2838
  * ebx = 0 - номер подфункции
2839
  * ecx = указатель на данные (копируется 64 килобайта, используется
2840
    столько, сколько установлено подфункцией 2)
2841
Возвращаемое значение:
2842
  * функция не возвращает значения
2843
Замечания:
2844
  * Формат и размер данных устанавливаются подфункцией 2.
2845
 
2846
======================================================================
2847
==== Функция 55, подфункция 1 - начать проигрывать данные на SB16. ===
2848
======================================================================
2849
Параметры:
2850
  * eax = 55 - номер функции
2851
  * ebx = 1 - номер подфункции
2852
Возвращаемое значение:
2853
  * функция не возвращает значения
2854
Замечания:
2855
  * Предварительно данные должны быть загружены подфункцией 0 и
131 diamond 2856
    определён их формат подфункцией 2.
77 diamond 2857
  * Функция возвращает управление, когда началось проигрывание данных;
131 diamond 2858
    после этого проигрывание идёт независимо от приложения (и вообще
77 diamond 2859
    не требует загрузки процессора).
2860
  * Предварительно должны быть определены базовый порт SB16
2861
    (подфункцией 4 функции 21) и канал DMA
2862
    (подфункцией 10 функции 21).
2863
 
2864
======================================================================
2865
====== Функция 55, подфункция 2 - установить формат данных SB16. =====
2866
======================================================================
2867
Параметры:
2868
  * eax = 55 - номер функции
2869
  * ebx = 2 - номер подфункции
2870
  * ecx = 0 - установить разрядность
2871
    * edx = 1 - 8бит моно
2872
    * edx = 2 - 8бит стерео
2873
  * ecx = 1 - установить размер данных
2874
    * edx = размер в байтах
2875
  * ecx = 2 - установить частоту проигрывания
2876
    * edx = частота
2877
Возвращаемое значение:
2878
  * функция не возвращает значения
2879
Замечания:
2880
  * При загрузке системы устанавливаются следующие параметры
2881
    по умолчанию: разрядность - 8 бит моно, размер - 64 Кб,
2882
    частота 44100 Гц. Тем не менее рекомендуется явно устанавливать
2883
    необходимые значения, поскольку они могли быть переустановлены
2884
    какой-нибудь программой.
2885
 
2886
======================================================================
2887
====================== Функция 55, подфункция 55 =====================
2888
========== Начать проигрывать данные на встроенном спикере. ==========
2889
======================================================================
2890
Параметры:
2891
  * eax = 55 - номер функции
2892
  * ebx = 55 - номер подфункции
2893
  * esi = указатель на данные
2894
Возвращаемое значение:
2895
  * eax = 0 - успешно
131 diamond 2896
  * eax = 55 - ошибка (спикер отключён или занят)
77 diamond 2897
Данные - это массив элементов переменной длины.
2898
Формат каждого элемента определяется первым байтом:
2899
  * 0 = конец данных
131 diamond 2900
  * 1..0x80 = задаёт длительность звучания в сотых долях секунды
77 diamond 2901
    ноты, определяемой непосредственным значением частоты
2902
    * следующее слово (2 байта) содержит делитель частоты;
2903
      частота определяется как 1193180/divider
2904
  * 0x81 = invalid
2905
  * 0x82..0xFF = нота, определяемая октавой и номером:
2906
    * длительность в сотых долях секунды = (первый байт)-0x81
131 diamond 2907
    * присутствует ещё один байт;
77 diamond 2908
    * (второй байт)=0xFF - пауза
2909
    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
2910
      до 12, a=номер октавы (считая с 0)
2911
Замечания:
2912
  * Пищание спикером может быть запрещено/разрешено подфункцией 8
2913
    функции 18.
2914
  * Функция возвращает управление, сообщив куда следует информацию
131 diamond 2915
    о запросе. Само проигрывание идёт независимо от программы.
77 diamond 2916
  * Данные должны сохраняться в памяти по крайней мере
2917
    до конца проигрывания.
2918
 
2919
======================================================================
2920
============== Функция 58 - работа с файловой системой. ==============
2921
======================================================================
2922
Параметры:
2923
  * eax = 58
2924
  * ebx = указатель на информационную структуру
2925
Возвращаемое значение:
2926
  * eax = 0 - успешно; иначе код ошибки файловой системы
2927
  * в зависимости от подфункции может возвращаться значение и
2928
    в других регистрах
2929
Общий формат информационной структуры:
2930
  * +0: dword: номер подфункции
2931
  * +4: dword: номер блока
2932
  * +8: dword: размер
2933
  * +12 = +0xC: dword: указатель на данные
2934
  * +16 = +0x10: dword: указатель на память для работы системы
2935
    (4096 байт)
2936
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
2937
Уточнения - в документации на соответствующую подфункцию.
2938
Имя файла нечувствительно к регистру латинских букв,
2939
русские буквы должны быть заглавными.
2940
Формат имени файла:
2941
/base/number/dir1/dir2/.../dirn/file,
2942
где /base/number идентифицирует устройство, на котором ищется файл:
2943
одно из
2944
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
2945
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
2946
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
131 diamond 2947
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к жёсткому диску
77 diamond 2948
    (в этом случае база определяется подфункцией 7 функции 21),
2949
    x - номер раздела (считая с 1)
2950
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
2951
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
2952
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2953
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
2954
    (на каждом из винчестеров нумерация начинается с 1)
2955
Замечания:
2956
  * В первых двух случаях допускается использование FIRST вместо 1,
2957
    SECOND вместо 2, но использовать эту возможность
2958
    не рекомендуется для удобства перехода на будущие расширения.
2959
  * Накладывается ограничение n<=39.
2960
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
2961
    имя не более 8 символов, точка, расширение не более 3 символов.
2962
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
2963
    Если имя занимает ровно 8 символов, точку можно опустить
2964
    (хотя пользоваться этим не рекомендуется для удобства перехода
2965
    на будущие расширения).
118 diamond 2966
  * Функция не поддерживает папок на рамдиске.
77 diamond 2967
Примеры:
2968
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2969
    '/rd/1/kernel.asm',0
2970
  * '/HD0/1/kernel.asm',0
2971
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2972
Доступные подфункции:
2973
  * подфункция 0 - чтение файла/папки
2974
  * подфункция 8 - LBA-чтение с устройства
2975
  * подфункция 15 - получение информации о файловой системе
2976
 
2977
======================================================================
2978
========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
2979
======================================================================
2980
Параметры:
2981
  * eax = 58
2982
  * ebx = указатель на информационную структуру
2983
Формат информационной структуры:
2984
  * +0: dword: 0 = номер подфункции
2985
  * +4: dword: номер блока для чтения (считая с 0)
2986
  * +8: dword: число блоков для чтения
2987
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2988
  * +16 = +0x10: dword: указатель на буфер для работы системы
2989
    (4096 байт)
131 diamond 2990
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 2991
    общем описании
2992
Возвращаемое значение:
2993
  * eax = 0 - успешно, иначе код ошибки файловой системы
2994
  * ebx = размер файла (в байтах) или
2995
    -1=0xffffffff, если файл не найден
2996
Замечания:
2997
  * Размер блока - 512 байт.
2998
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
2999
    функции 70, для чтения папок - подфункцию 1 функции 70.
3000
  * Функция позволяет читать содержимое папки. Из файловых систем
3001
    поддерживается только FAT. Формат FAT-папки описан в любой
3002
    документации по FAT.
3003
  * Размер папки определяется по размеру цепочки кластеров в FAT.
3004
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 3005
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 3006
    eax=6 (EOF).
3007
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
3008
    в первых двух случаях текущая реализация не следует
3009
    установленным правилам:
3010
    для /rd/1:
3011
    * если указано 0 блоков для чтения, считается,
3012
      что запрашивается 1;
3013
    * если запрашивается больше 14 блоков или начальный блок
3014
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
3015
    * размер корневого каталога рамдиска = 14 блоков,
3016
      0x1C00=7168 байт; но возвращается ebx=0
3017
      (за исключением случая предыдущего пункта);
3018
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
131 diamond 3019
      мусор - напоминаю, счёт ведётся с 0);
77 diamond 3020
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
3021
      то возвращается eax=6(EOF); иначе eax=0.
3022
    Для /fd/x:
3023
    * если начальный блок не меньше 14-го, то возвращается
3024
      eax=5 (not found) и ebx=0;
3025
    * кстати говоря, формат FAT12 допускает дискеты с размером
3026
      корневого каталога меньше или больше 14 блоков;
3027
    * проверки длины не делается;
3028
    * если удалось прочитать данные с дискеты, возвращается
3029
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
3030
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
3031
    но результат не соответствует ожидаемому
3032
    (по работе с обычными файлами/папками), не следует установленным
3033
    правилам, может измениться в следующих версиях ядра и потому
3034
    не описывается. Для получения информации об оборудовании
3035
    используйте подфункцию 11 функции 18 или
3036
    читайте соответствующие папки подфункцией 1 функции 70.
3037
 
3038
======================================================================
3039
========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
3040
======================================================================
3041
Параметры:
3042
  * eax = 58 - номер функции
3043
  * ebx = указатель на информационную структуру
3044
Формат информационной структуры:
3045
  * +0: dword: 8 = номер подфункции
3046
  * +4: dword: номер блока для чтения (считая с 0)
3047
  * +8: dword: игнорируется (устанавливайте в 1)
3048
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
3049
    (512 байт)
3050
  * +16 = +0x10: dword: указатель на буфер для работы системы
3051
    (4096 байт)
3052
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
3053
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
3054
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
3055
    Вместо цифр допускается, хотя и не рекомендуется для удобства
3056
    перехода на будущие расширения,
3057
    использование 'first','second','third','fourth'.
3058
Возвращаемое значение:
3059
  * если указано имя устройства /hd/xxx, где xxx не находится
3060
    в списке выше:
3061
    * eax = ebx = 1
3062
  * если указано неправильное имя устройства
3063
    (за исключением предыдущего случая):
3064
    * eax = 5
3065
    * ebx не меняется
131 diamond 3066
  * если LBA-доступ запрещён подфункцией 11 функции 21:
77 diamond 3067
    * eax = 2
3068
    * ebx разрушается
3069
  * для рамдиска: попытка чтения блока за пределами рамдиска
3070
    (18*2*80 блоков) приводит к
3071
    * eax = 3
3072
    * ebx = 0
3073
  * при успешном чтении:
3074
    * eax = ebx = 0
3075
Замечания:
3076
  * Размер блока - 512 байт; читается один блок.
3077
  * Не следует полагаться на возвращаемое значение,
3078
    оно может измениться в следующих версиях.
131 diamond 3079
  * Требуется, чтобы был разрешён LBA-доступ к устройствам
77 diamond 3080
    подфункцией 11 функции 21. Узнать это можно вызовом
3081
    подфункцией 11 функции 26.
3082
  * LBA-чтение дискеты не поддерживается.
131 diamond 3083
  * Функция считывает данные физического жёсткого диска;
77 diamond 3084
    если по каким-то причинам нужны данные конкретного раздела,
131 diamond 3085
    придётся определять начальный сектор этого раздела
77 diamond 3086
    (либо напрямую через MBR, либо из расширенной структуры,
3087
    возвращаемой той же подфункцией 11 функции 18).
131 diamond 3088
  * Функция не проверяет код ошибки жёсткого диска, так что запрос
3089
    несуществующего сектора всё равно что-то прочитает
77 diamond 3090
    (вероятнее всего, нули, но это определяется устройством) и
3091
    это будет считаться успехом (eax=0).
3092
 
3093
======================================================================
3094
= Функция 58, подфункция 15 - получить информацию о файловой системе.
3095
======================================================================
3096
Параметры:
3097
  * eax = 58 - номер функции
3098
  * ebx = указатель на информационную структуру
3099
Формат информационной структуры:
118 diamond 3100
  * +0: dword: 15 = номер подфункции
77 diamond 3101
  * +4: dword: игнорируется
3102
  * +8: dword: игнорируется
3103
  * +12 = +0xC: dword: игнорируется
3104
  * +16 = +0x10: dword: игнорируется
3105
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
3106
    /rd=/RAMDISK или /hd=/HARDDISK
3107
Возвращаемое значение:
3108
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
3109
    * eax = 3
3110
    * ebx = ecx = dword [fileinfo] = 0
3111
  * для рамдиска:
3112
    * eax = 0 (успех)
3113
    * ebx = общее число кластеров = 2847
3114
    * ecx = число свободных кластеров
3115
    * dword [fileinfo] = размер кластера = 512
131 diamond 3116
  * для жёсткого диска: база и раздел определяются подфункциями 7 и 8
77 diamond 3117
    функции 21:
3118
    * eax = 0 (успех)
3119
    * ebx = общее число кластеров
3120
    * ecx = число свободных кластеров
3121
    * dword [fileinfo] = размер кластера (в байтах)
3122
Замечания:
3123
  * Не удивляйтесь странному расположению 4-го возвращаемого
3124
    параметра - когда писался этот код, при системных вызовах
3125
    приложению возвращались только регистры eax,ebx,ecx (из
3126
    pushad-структуры, передающейся как аргумент системной функции).
3127
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
3128
    размер кластера в edx, пока эту функцию не начали использовать.
131 diamond 3129
  * Вообще-то ещё существует подфункция 11 функции 18, возвращающая
77 diamond 3130
    информацию о файловой системе. По расширенной таблице дисковой
3131
    подсистемы можно определить размер кластера (там он хранится
131 diamond 3132
    в секторах) и общее число кластеров для жёстких дисков.
77 diamond 3133
 
3134
======================================================================
3135
=========== Функция 60 - Inter Process Communication (IPC). ==========
3136
======================================================================
3137
IPC применяется для посылок сообщений от одного процесса/потока
3138
другому. При этом следует предварительно договориться о том, как
3139
интерпретировать конкретное сообщение.
3140
 
3141
-------- Подфункция 1 - установить область для получения IPC ---------
131 diamond 3142
Вызывается процессом-приёмником.
77 diamond 3143
Параметры:
3144
  * eax = 60 - номер функции
3145
  * ebx = 1 - номер подфункции
3146
  * ecx = указатель на буфер
3147
  * edx = размер буфера
3148
Возвращаемое значение:
3149
  * eax = 0 - всегда успешно
3150
Формат IPC-буфера:
3151
  * +0: dword: если здесь не 0, то буфер считается заблокированным;
3152
    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
3153
    и вам надо, чтобы извне не изменялись данные буфера
3154
    (не поступали новые сообщения)
3155
  * +4: dword: занято места в буфере (в байтах)
3156
  * +8: первое сообщение
3157
  * +8+n: второе сообщение
3158
  * ...
3159
Формат сообщения:
3160
  * +0: dword: PID процесса/потока, пославшего сообщение
3161
  * +4: dword: длина сообщения (не считая этот заголовок)
3162
  * +8: n*byte: данные сообщения
3163
 
3164
--------------- Подфункция 2 - послать сообщение IPC. ----------------
3165
Вызывается процессом-инициатором.
3166
Параметры:
3167
  * eax = 60 - номер функции
3168
  * ebx = 2 - номер подфункции
131 diamond 3169
  * ecx = PID приёмника
77 diamond 3170
  * edx = указатель на данные сообщения
3171
  * esi = длина сообщения (в байтах)
3172
Возвращаемое значение:
3173
  * eax = 0 - успешно
131 diamond 3174
  * eax = 1 - приёмник не определил буфер для IPC-сообщений
3175
    (может быть, ещё не успел, а может быть, это не тот поток,
77 diamond 3176
    который нужен)
131 diamond 3177
  * eax = 2 - приёмник заблокировал IPC-буфер;
77 diamond 3178
    попробуйте немного подождать
131 diamond 3179
  * eax = 3 - переполнение IPC-буфера приёмника
77 diamond 3180
  * eax = 4 - процесса/потока с таким PID не существует
3181
Замечания:
3182
  * Система сразу после записи IPC-сообщения в буфер посылает
131 diamond 3183
    потоку-приёмнику событие с кодом 7 (см. коды событий).
77 diamond 3184
 
3185
======================================================================
3186
=== Функция 61 - получить параметры для прямого доступа к графике. ===
3187
======================================================================
3188
Программе доступны данные графического экрана (область памяти, которая
3189
собственно и отображает содержимое экрана) напрямую без вызовов
3190
системных функций через селектор gs:
131 diamond 3191
	mov	eax, [gs:0]
77 diamond 3192
поместит в eax первый dword буфера, содержащий информацию о цвете
3193
левой верхней точки (и, возможно, цвета нескольких следующих).
131 diamond 3194
	mov	[gs:0], eax
77 diamond 3195
при работе в режимах VESA c LFB
3196
установит цвет левой верхней точки
3197
(и возможно, цвета нескольких следующих).
3198
Для интерпретации данных графического экрана требуется знание
3199
некоторых параметров, которые возвращаются этой функцией.
3200
Замечания:
3201
  * Параметры графики очень редко меняются при работе системы,
3202
    а именно, только в случаях, когда пользователь работает
3203
    с программой VRR.
3204
  * При изменении видеорежима система перерисовывает все окна
3205
    (событие с кодом 1) и перерисовывает фон (событие 5).
3206
    Эти же события происходят и в других случаях,
3207
    которые встречаются значительно чаще, чем изменение видеорежима.
3208
  * При работе в видеорежимах с LFB селектор gs указывает на
3209
    собственно LFB, так что чтение/запись по gs приводят
3210
    непосредственно к изменению содержимого экрана. При работе в
3211
    видеорежимах без LFB gs указывает на некоторую область данных
131 diamond 3212
    ядра, причём все функции вывода на экран добросовестно выполняют
77 diamond 3213
    двойную работу по записи непосредственно на экран и по записи
3214
    в этот буфер. В результате при чтении содержимого этого буфера
3215
    результаты соответствуют содержимому экрана
3216
    (с, вообще говоря, большим цветовым разрешением),
3217
    а запись игнорируется.
3218
    Исключением является режим 320*200, для которого в главном цикле
3219
    системного потока выполняется обновление экрана в соответствии
3220
    с движениями курсора мыши.
3221
 
3222
------------------------- Разрешение экрана --------------------------
3223
Параметры:
3224
  * eax = 61 - номер функции
3225
  * ebx = 1 - номер подфункции
3226
Возвращаемое значение:
3227
  * eax = [разрешение по оси x]*65536 + [разрешение по оси y]
3228
Замечания:
131 diamond 3229
  * Можно использовать функцию 14 с учётом того, что она возвращает
77 diamond 3230
    размеры на 1 меньше. Это полностью эквивалентный способ.
3231
 
3232
------------------------ Число бит на пиксель ------------------------
3233
Параметры:
3234
  * eax = 61 - номер функции
3235
  * ebx = 2 - номер подфункции
3236
Возвращаемое значение:
3237
  * eax = число бит на пиксель (24 или 32)
3238
 
3239
------------------------ Число байт на строку ------------------------
3240
Параметры:
3241
  * eax = 61 - номер функции
3242
  * ebx = 3 - номер подфункции
3243
Возвращаемое значение:
131 diamond 3244
  * eax = число байт, которое занимает одна строка развёртки
77 diamond 3245
    (горизонтальная линия на экране)
3246
 
3247
======================================================================
3248
===== Функция 62, подфункция 0 - получить версию PCI-интерфейса. =====
3249
======================================================================
3250
Параметры:
3251
  * eax = 62 - номер функции
3252
  * bl = 0 - номер подфункции
3253
Возвращаемое значение:
131 diamond 3254
  * eax = -1 - доступ к PCI запрещён; иначе
77 diamond 3255
  * ah.al = версия PCI-интерфейса (ah=версия, al=подверсия)
3256
  * старшее слово eax обнулено
3257
Замечания:
131 diamond 3258
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3259
    для приложений подфункцией 12 функции 21.
118 diamond 3260
  * Если PCI BIOS не поддерживается, то значение ax неопределено.
77 diamond 3261
 
3262
======================================================================
3263
==== Функция 62, подфункция 1 - получить номер последней PCI-шины. ===
3264
======================================================================
3265
Параметры:
3266
  * eax = 62 - номер функции
3267
  * bl = 1 - номер подфункции
3268
Возвращаемое значение:
131 diamond 3269
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3270
  * al = номер последней PCI-шины; оставшиеся байты eax разрушаются
77 diamond 3271
Замечания:
131 diamond 3272
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3273
    для приложений подфункцией 12 функции 21.
118 diamond 3274
  * Если PCI BIOS не поддерживается, то значение al неопределено.
77 diamond 3275
 
3276
======================================================================
3277
====================== Функция 62, подфункция 2 ======================
3278
== Получить механизм обращения к конфигурационному пространству PCI. =
3279
======================================================================
3280
Параметры:
3281
  * eax = 62 - номер функции
3282
  * bl = 2 - номер подфункции
3283
Возвращаемое значение:
131 diamond 3284
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3285
  * al = механизм (1 или 2); прочие байты eax разрушаются
77 diamond 3286
Замечания:
131 diamond 3287
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3288
    для приложений подфункцией 12 функции 21.
3289
  * Механизм обращения выбирается в соответствии
3290
    с характеристиками оборудования.
3291
  * Подфункции чтения и записи автоматически работают
3292
    с выбранным механизмом.
3293
 
3294
======================================================================
3295
======== Функция 62, подфункции 4,5,6 - прочитать PCI-регистр. =======
3296
======================================================================
3297
Параметры:
3298
  * eax = 62 - номер функции
3299
  * bl = 4 - читать байт
3300
  * bl = 5 - читать слово
3301
  * bl = 6 - читать двойное слово
3302
  * bh = номер PCI-шины
3303
  * ch = dddddfff, где ddddd = номер устройства на шине,
3304
    fff = номер функции устройства
131 diamond 3305
  * cl = номер регистра (должен быть чётным для bl=5,
77 diamond 3306
    делиться на 4 для bl=6)
3307
Возвращаемое значение:
131 diamond 3308
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3309
    неподдерживаемые параметры); иначе
3310
  * al/ax/eax (в зависимости от запрошенного размера) содержит данные;
3311
    оставшаяся часть регистра eax разрушается
3312
Замечания:
131 diamond 3313
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3314
    для приложений подфункцией 12 функции 21.
3315
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3316
    игнорирует номер функции. Получить механизм доступа можно вызовом
3317
    подфункции 2.
3318
  * Некоторые регистры стандартны и существуют для всех устройств,
3319
    некоторые определяются конкретным устройством. Список первых
3320
    входит, например, в известный Interrupt List by Ralf Brown
3321
    (http://www.pobox.com/~ralf/files.html,
3322
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3323
    список вторых должен быть указан в документации по устройству.
3324
 
3325
======================================================================
3326
======= Функция 62, подфункции 8,9,10 - записать в PCI-регистр. ======
3327
======================================================================
3328
Параметры:
3329
  * eax = 62 - номер функции
3330
  * bl = 8 - писать байт
3331
  * bl = 9 - писать слово
3332
  * bl = 10 - писать двойное слово
3333
  * bh = номер PCI-шины
3334
  * ch = dddddfff, где ddddd = номер устройства на шине,
3335
    fff = номер функции устройства
131 diamond 3336
  * cl = номер регистра (должен быть чётным для bl=9,
77 diamond 3337
    делиться на 4 для bl=10)
92 diamond 3338
  * dl/dx/edx (в зависимости от запрошенного размера) содержит
3339
    данные для записи
77 diamond 3340
Возвращаемое значение:
131 diamond 3341
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3342
    неподдерживаемые параметры)
3343
  * eax = 0 - успешно
3344
Замечания:
131 diamond 3345
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3346
    для приложений подфункцией 12 функции 21.
3347
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3348
    игнорирует номер функции. Получить механизм доступа можно вызовом
3349
    подфункции 2.
3350
  * Некоторые регистры стандартны и существуют для всех устройств,
3351
    некоторые определяются конкретным устройством. Список первых
3352
    входит, например, в известный Interrupt List by Ralf Brown;
3353
    список вторых должен быть указан в документации по устройству.
3354
 
3355
======================================================================
3356
================ Функция 63 - работа с доской отладки. ===============
3357
======================================================================
448 diamond 3358
Доска отладки представляет собой системный буфер (на 4096 байт),
77 diamond 3359
в который любая программа может записать (вообще говоря, произвольные)
3360
данные и из которого другая программа может эти данные прочитать.
3361
Есть соглашение, в соответствии с которым записываемые данные -
3362
текстовые строки, интерпретируемые как отладочные сообщения о ходе
131 diamond 3363
выполнения программы. Ядро в определённых ситуациях также записывает
77 diamond 3364
на доску отладки сведения о выполнении некоторых функций;
3365
по соглашению сообщения ядра начинаются с префикса "K : ".
3366
Для просмотра доски отладки создано приложение board,
131 diamond 3367
которое считывает данные из буфера и отображает их в своём окне. board
77 diamond 3368
понимает последовательность кодов 13,10 как переход на новую строку.
3369
Символ с нулевым кодом в конце строки не обязателен, но и не мешает.
3370
В связи с появлением отладчика ценность доски отладки несколько
3371
снизилась, поскольку отладчик позволяет полностью контролировать ход
131 diamond 3372
выполнения программы, причём для этого не требуется никаких усилий
77 diamond 3373
со стороны самой программы. Тем не менее во многих случаях
3374
доска отладки продолжает оставаться полезной.
3375
 
3376
---------------------------- Запись байта ----------------------------
3377
Параметры:
3378
  * eax = 63 - номер функции
3379
  * ebx = 1 - номер подфункции
3380
  * cl = байт данных
3381
Возвращаемое значение:
3382
  * функция не возвращает значения
3383
Замечания:
3384
  * Байт записывается в буфер. Длина буфера - 512 байт.
3385
    При переполнении буфера все полученные данные теряются
3386
    и заполнение начинается снова с нуля.
3387
  * Для вывода на доску отладки более сложных объектов (строк, чисел)
3388
    достаточно этой функции, вызываемой в цикле. Можно не писать
3389
    вручную соответствующий код, а воспользоваться файлом debug.inc,
3390
    входящим в дистрибутив.
3391
 
3392
---------------------------- Чтение байта ----------------------------
3393
Забирает байт из буфера.
3394
Параметры:
3395
  * eax = 63 - номер функции
3396
  * ebx = 2 - номер подфункции
3397
Возвращаемое значение:
3398
  * eax = ebx = 0 - буфер пуст
3399
  * eax = байт, ebx = 1 - байт успешно прочитан
3400
 
3401
======================================================================
3402
========== Функция 64 - перераспределить память приложения. ==========
3403
======================================================================
3404
Параметры:
3405
  * eax = 64 - номер функции
3406
  * ebx = 1 - единственная подфункция
3407
  * ecx = новый размер памяти
3408
Возвращаемое значение:
3409
  * eax = 0 - успешно
3410
  * eax = 1 - недостаточно памяти
3411
Замечания:
172 serge 3412
  * Есть другой способ выделения/освобождения динамической памяти -
3413
    подфункции 11, 12, 13 функции 68.
277 diamond 3414
  * Функция не может использоваться совместно с 68.11, 68.12, 68.13.
3415
    Вызов функции будет игнорироваться, если приложение создаст
3416
    локальную кучу вызовом 68.11.
77 diamond 3417
 
3418
======================================================================
283 diamond 3419
========= Функция 65 - вывести изображение с палитрой в окно. ========
3420
======================================================================
3421
Параметры:
3422
  * eax = 65 - номер функции
3423
  * ebx = указатель на изображение
3424
  * ecx = [размер по оси x]*65536 + [размер по оси y]
3425
  * edx = [координата по оси x]*65536 + [координата по оси y]
314 diamond 3426
  * esi = число бит на пиксель, должно быть 8, 24 или 32
3427
  * edi = указатель на палитру (256 цветов 0x00RRGGBB);
3428
          игнорируется при esi = 24 и 32
3429
  * ebp = смещение данных каждой следующей строки изображения
3430
          относительно предыдущей
283 diamond 3431
Возвращаемое значение:
3432
  * функция не возвращает значения
3433
Замечания:
3434
  * Координаты изображения - это координаты верхнего левого угла
3435
    изображения относительно окна.
3436
  * Размер изображения в байтах есть xsize*ysize.
3437
  * Каждый байт изображения рассматривается как индекс в палитре.
3438
  * Если изображение использует не все 256 цветов, а меньше,
3439
    размер палитры может быть меньше 256.
314 diamond 3440
  * Вызов функции 7 эквивалентен вызову этой функции с параметрами
3441
    esi=24, ebp=0.
283 diamond 3442
 
3443
======================================================================
92 diamond 3444
================= Функция 66 - работа с клавиатурой. =================
77 diamond 3445
======================================================================
92 diamond 3446
Режим ввода влияет на результаты чтения клавиш функцией 2.
131 diamond 3447
При загрузке программы для неё устанавливается ASCII-режим ввода.
77 diamond 3448
 
92 diamond 3449
-------- Подфункция 1 - установить режим ввода с клавиатуры. ---------
77 diamond 3450
Параметры:
3451
  * eax = 66 - номер функции
3452
  * ebx = 1 - номер подфункции
3453
  * ecx = режим:
3454
    * 0 = обычный (ASCII-символы)
3455
    * 1 = сканкоды
3456
Возвращаемое значение:
3457
  * функция не возвращает значения
3458
 
92 diamond 3459
--------- Подфункция 2 - получить режим ввода с клавиатуры. ----------
77 diamond 3460
Параметры:
3461
  * eax = 66 - номер функции
3462
  * ebx = 2 - номер подфункции
3463
Возвращаемое значение:
3464
  * eax = текущий режим
3465
 
3466
------- Подфункция 3 - получить состояние управляющих клавиш. --------
3467
Параметры:
3468
  * eax = 66 - номер функции
3469
  * ebx = 3 - номер подфункции
3470
Возвращаемое значение:
3471
  * eax = битовая маска:
3472
  * бит 0 (маска 1): левый Shift нажат
3473
  * бит 1 (маска 2): правый Shift нажат
3474
  * бит 2 (маска 4): левый Ctrl нажат
3475
  * бит 3 (маска 8): правый Ctrl нажат
3476
  * бит 4 (маска 0x10): левый Alt нажат
3477
  * бит 5 (маска 0x20): правый Alt нажат
131 diamond 3478
  * бит 6 (маска 0x40): CapsLock включён
3479
  * бит 7 (маска 0x80): NumLock включён
3480
  * бит 8 (маска 0x100): ScrollLock включён
77 diamond 3481
  * прочие биты сброшены
3482
 
92 diamond 3483
----- Подфункция 4 - установить общесистемную "горячую клавишу". -----
3484
О нажатии "горячей клавиши" извещаются только приложения,
131 diamond 3485
установившие её; активное приложение (к которому поступает
92 diamond 3486
весь нормальный ввод) таких клавиш не получает.
3487
Извещение заключается в посылке события с кодом 2.
3488
Прочитать "горячую клавишу" можно так же, как и обычную, -
3489
функцией 2.
3490
Параметры:
3491
  * eax = 66 - номер функции
3492
  * ebx = 4 - номер подфункции
131 diamond 3493
  * cl задаёт сканкод клавиши;
92 diamond 3494
    используйте cl=0 для задания комбинаций типа Ctrl+Shift
131 diamond 3495
  * edx = 0xXYZ задаёт возможные состояния управляющих клавиш:
3496
    * Z (младшие 4 бита) задаёт состояние клавиш LShift и RShift:
92 diamond 3497
      * 0 = ни одна из клавиш не должна быть нажата;
3498
      * 1 = ровно одна из клавиш должна быть нажата;
3499
      * 2 = обе клавиши должны быть нажаты;
3500
      * 3 = должна быть нажата LShift, но не RShift;
3501
      * 4 = должна быть нажата RShift, но не LShift
3502
    * Y - аналогично для LCtrl и RCtrl;
3503
    * X - аналогично для LAlt и RAlt
3504
Возвращаемое значение:
3505
  * eax=0 - успешно
3506
  * eax=1 - слишком много "горячих клавиш" (допускается максимум 256)
3507
Замечания:
3508
  * Горячая клавиша может срабатывать либо при нажатии,
3509
    либо при отпускании. Сканкод отпускания клавиши на 128 больше,
3510
    чем сканкод нажатия (т.е. установлен старший бит).
3511
  * Несколько приложений могут установить одну и ту же комбинацию;
3512
    о нажатии такой комбинации будут извещаться все такие приложения.
3513
 
3514
------ Подфункция 5 - удалить установленную "горячую клавишу". -------
3515
Параметры:
3516
  * eax = 66 - номер функции
3517
  * ebx = 5 - номер подфункции
3518
  * cl = сканкод клавиши и edx = 0xXYZ такие же, как и в подфункции 4
3519
Возвращаемое значение:
3520
  * eax = 0 - успешно
3521
  * eax = 1 - нет такой горячей клавиши
3522
Замечания:
3523
  * При завершении процесса/потока удаляются все установленные им
3524
    горячие клавиши.
3525
  * Вызов функции не влияет на другие приложения.
3526
    Если другое приложение определило эту же комбинацию,
3527
    оно по-прежнему будет получать уведомления.
3528
 
77 diamond 3529
======================================================================
3530
============ Функция 67 - изменить положение/размеры окна. ===========
3531
======================================================================
3532
Параметры:
3533
  * eax = 67 - номер функции
3534
  * ebx = новая x-координата окна
3535
  * ecx = новая y-координата окна
3536
  * edx = новый x-размер окна
3537
  * esi = новый y-размер окна
3538
Возвращаемое значение:
3539
  * функция не возвращает значения
3540
Замечания:
3541
  * Значение -1 для параметра означает "не изменять"; например, для
3542
    перемещения окна без изменения размеров можно указать edx=esi=-1.
3543
  * Предварительно окно должно быть определено функцией 0.
131 diamond 3544
    Она же задаёт начальные координаты и размеры окна.
77 diamond 3545
  * Размеры окна понимаются в смысле функции 0, т.е.
3546
    на один пиксель меньше, чем реальные размеры.
3547
  * Вызов функции для максимизированных окон просто игнорируется.
3548
  * Для окон соответствующих стилей положение и/или размеры могут быть
3549
    изменены пользователем; текущие положение и размеры могут быть
3550
    получены вызовом функции 9.
3551
  * Функция посылает окну событие перерисовки (с кодом 1).
3552
 
3553
======================================================================
131 diamond 3554
=== Функция 68, подфункция 0 - получить счётчик переключений задач. ==
77 diamond 3555
======================================================================
3556
Параметры:
3557
  * eax = 68 - номер функции
3558
  * ebx = 0 - номер подфункции
3559
Возвращаемое значение:
3560
  * eax = число переключений задач с момента загрузки системы
3561
    (по модулю 2^32)
3562
 
3563
======================================================================
3564
====================== Функция 68, подфункция 1 ======================
3565
============ Переключиться на следующий поток выполнения. ============
3566
======================================================================
3567
Функция завершает текущий квант времени, выделенный потоку,
3568
и переключается на следующий.
3569
(Какой поток какого процесса будет следующим, предсказать нельзя).
131 diamond 3570
Позднее, когда до текущего потока дойдёт очередь,
77 diamond 3571
выполнение возобновится.
3572
Параметры:
3573
  * eax = 68 - номер функции
3574
  * ebx = 1 - номер подфункции
3575
Возвращаемое значение:
3576
  * функция не возвращает значения
3577
 
3578
======================================================================
3579
=============== Функция 68, подфункция 2 - кэш + rdpmc. ==============
3580
======================================================================
3581
Параметры:
3582
  * eax = 68 - номер функции
3583
  * ebx = 2 - номер подфункции
3584
  * ecx = требуемое действие:
3585
    * ecx = 0 - разрешить выполнение инструкции rdpmc
3586
      (ReaD Performance-Monitoring Counters)
131 diamond 3587
    * ecx = 1 - узнать, включён/выключен кэш
77 diamond 3588
    * ecx = 2 - включить кэш
3589
    * ecx = 3 - выключить кэш
3590
Возвращаемое значение:
3591
  * для ecx=0:
3592
    * eax = значение cr4
3593
  * для ecx=1:
3594
    * eax = (cr0 and 0x60000000):
131 diamond 3595
    * eax = 0 - кэш включён
77 diamond 3596
    * eax <> 0 - кэш выключен
3597
  * для ecx=2 и ecx=3:
3598
    * функция не возвращает значения
3599
 
3600
======================================================================
3601
========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
3602
======================================================================
3603
MSR = Model Specific Register; полный список MSR-регистров процессора
3604
содержится в документации по процессору (например, IA-32 Intel
3605
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3606
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3607
Параметры:
3608
  * eax = 68 - номер функции
3609
  * ebx = 3 - номер подфункции
3610
  * ecx игнорируется
3611
  * edx = адрес MSR
3612
Возвращаемое значение:
3613
  * ebx:eax = старший:младший dword результата
3614
Замечания:
3615
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3616
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3617
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3618
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3619
    которое всё равно прибьёт поток.
77 diamond 3620
 
3621
======================================================================
3622
========= Функция 68, подфункция 4 - записать в MSR-регистр. =========
3623
======================================================================
3624
MSR = Model Specific Register; полный список MSR-регистров процессора
3625
содержится в документации по процессору (например, IA-32 Intel
3626
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3627
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3628
Параметры:
3629
  * eax = 68 - номер функции
3630
  * ebx = 4 - номер подфункции
3631
  * ecx игнорируется
3632
  * edx = адрес MSR
3633
  * esi:edi = старший:младший dword
3634
Возвращаемое значение:
499 diamond 3635
  * функция не возвращает значения
77 diamond 3636
Замечания:
3637
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3638
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3639
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3640
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3641
    которое всё равно прибьёт поток.
77 diamond 3642
 
3643
======================================================================
172 serge 3644
===== Функция 68, подфункция 11 - инициализировать кучу процесса. ====
77 diamond 3645
======================================================================
3646
Параметры:
3647
  * eax = 68 - номер функции
172 serge 3648
  * ebx = 11 - номер подфункции
77 diamond 3649
Возвращаемое значение:
172 serge 3650
  * eax = 0 - неуспех
3651
  * иначе размер созданной кучи
77 diamond 3652
Замечания:
172 serge 3653
  * Вызов функции инициализирует кучу, из которой впоследствии можно
3654
    выделять и освобождать блоки памяти подфункциями 12 и 13.
188 serge 3655
    Размер кучи равен размеру всей свободной памяти приложения.
277 diamond 3656
  * При повторном вызове функции тем же процессом функция вернёт
3657
    размер существующей кучи.
3658
  * После создания кучи вызовы функции 64 игнорируются.
77 diamond 3659
 
3660
======================================================================
172 serge 3661
========== Функция 68, подфункция 12 - выделить блок памяти. =========
77 diamond 3662
======================================================================
3663
Параметры:
3664
  * eax = 68 - номер функции
172 serge 3665
  * ebx = 12 - номер подфункции
3666
  * ecx = требуемый размер в байтах
77 diamond 3667
Возвращаемое значение:
172 serge 3668
  * eax = указатель на выделенный блок
77 diamond 3669
Замечания:
172 serge 3670
  * Предварительно следует инициализировать кучу процесса вызовом
3671
    подфункции 11.
3672
  * Функция выделяет целое число страниц (4 Кб) так, что фактический
3673
    размер выделенного блока больше или равен запрошенному.
77 diamond 3674
 
3675
======================================================================
172 serge 3676
========= Функция 68, подфункция 13 - освободить блок памяти. ========
77 diamond 3677
======================================================================
3678
Параметры:
3679
  * eax = 68 - номер функции
172 serge 3680
  * ebx = 13 - номер подфункции
3681
  * ecx = указатель на блок памяти
77 diamond 3682
Возвращаемое значение:
172 serge 3683
  * eax = 1 - успешно
3684
  * eax = 0 - неудача
77 diamond 3685
Замечания:
448 diamond 3686
  * Блок памяти должен быть ранее выделен подфункцией 12
3687
    или подфункцией 20.
77 diamond 3688
 
3689
======================================================================
172 serge 3690
===== Функция 68, подфункция 14 - ожидать извещения от драйвера. =====
77 diamond 3691
======================================================================
3692
Параметры:
3693
  * eax = 68 - номер функции
172 serge 3694
  * ebx = 14 - номер подфункции
3695
  * ecx = указатель на буфер для информации (8 байт)
77 diamond 3696
Возвращаемое значение:
172 serge 3697
  * буфер, на который указывает ecx, содержит следующую информацию:
3698
    * +0: dword: константа EV_INTR = 1
3699
    * +4: dword: данные драйвера
77 diamond 3700
Замечания:
172 serge 3701
  * Текущая реализация во время ожидания требует довольно "тяжёлых"
3702
    операций переключения контекста.
77 diamond 3703
 
3704
======================================================================
172 serge 3705
== Функция 68, подфункция 15 - установить обработчик исключений FPU. =
3706
======================================================================
3707
Параметры:
3708
  * eax = 68 - номер функции
3709
  * ebx = 15 - номер подфункции
3710
  * ecx = адрес нового обработчика исключений
3711
Возвращаемое значение:
3712
  * eax = адрес старого обработчика исключений
3713
    (0, если он не был установлен)
3714
 
3715
======================================================================
3716
=========== Функция 68, подфункция 16 - загрузить драйвер. ===========
3717
======================================================================
3718
Параметры:
3719
  * eax = 68 - номер функции
3720
  * ebx = 16 - номер подфункции
277 diamond 3721
  * ecx = указатель на ASCIIZ-строку с именем драйвера
172 serge 3722
Возвращаемое значение:
3723
  * eax = 0 - неудача
3724
  * иначе eax = хэндл драйвера
3725
Замечания:
3726
  * Если драйвер ещё не загружен, он загружается;
3727
    если драйвер уже загружен, ничего не меняется.
3728
  * Имя драйвера чувствительно к регистру символов.
277 diamond 3729
    Максимальная длина имени - 16 символов, включая завершающий
3730
    нулевой символ, остальные символы игнорируются.
346 diamond 3731
  * Драйвер с именем ABC загружается из файла /rd/1/drivers/ABC.obj.
172 serge 3732
 
3733
======================================================================
3734
========== Функция 68, подфункция 17 - управление драйвером. =========
3735
======================================================================
3736
Параметры:
3737
  * eax = 68 - номер функции
3738
  * ebx = 17 - номер подфункции
3739
  * ecx = указатель на управляющую структуру:
3740
    * +0: dword: хэндл драйвера
3741
    * +4: dword: код функции драйвера
3742
    * +8: dword: указатель на входные данные
3743
    * +12 = +0xC: dword: размер входных данных
3744
    * +16 = +0x10: dword: указатель на выходные данные
3745
    * +20 = +0x14: dword: размер выходных данных
3746
Возвращаемое значение:
3747
  * eax = определяется драйвером
3748
Замечания:
3749
  * Коды функций и структура входных/выходных данных
3750
    определяются драйвером.
3751
  * Предварительно должен быть получен хэндл драйвера подфункцией 16.
3752
 
3753
======================================================================
3754
== Функция 68, подфункция 18 - установить обработчик исключений SSE. =
3755
======================================================================
3756
Параметры:
3757
  * eax = 68 - номер функции
3758
  * ebx = 18 - номер подфункции
3759
  * ecx = адрес нового обработчика исключений
3760
Возвращаемое значение:
3761
  * eax = адрес старого обработчика исключений
3762
    (0, если он не был установлен)
3763
 
3764
======================================================================
277 diamond 3765
============= Функция 68, подфункция 19 - загрузить DLL. =============
3766
======================================================================
3767
Параметры:
3768
  * eax = 68 - номер функции
3769
  * ebx = 19 - номер подфункции
3770
  * ecx = указатель на ASCIIZ-строку с полным путём к DLL
3771
Возвращаемое значение:
3772
  * eax = 0 - неудача
3773
  * иначе eax = указатель на таблицу экспорта DLL
3774
Замечания:
3775
  * Таблица экспорта представляет собой массив структур по 2 dword'а,
3776
    заканчивающийся нулём. Первый dword в структуре является
3777
    указателем на имя функции, второй содержит адрес функции.
3778
 
3779
======================================================================
448 diamond 3780
====== Функция 68, подфункция 20 - перераспределить блок памяти. =====
3781
======================================================================
3782
Параметры:
3783
  * eax = 68 - номер функции
3784
  * ebx = 20 - номер подфункции
3785
  * ecx = новый размер в байтах
3786
  * edx = указатель на уже выделенный блок памяти
3787
Возвращаемое значение:
3788
  * eax = указатель на перераспределённый блок, 0 при ошибке
3789
Замечания:
3790
  * Предварительно следует инициализировать кучу процесса вызовом
3791
    подфункции 11.
3792
  * Функция выделяет целое число страниц (4 Кб) так, что фактический
3793
    размер выделенного блока больше или равен запрошенному.
3794
  * Если edx=0, то вызов функции эквивалентен выделению памяти
3795
    подфункцией 12. В противном случае блок памяти по адресу edx
3796
    должен быть ранее выделен подфункцией 12 или
3797
    описываемой подфункцией.
3798
  * Если ecx=0, то функция освобождает блок памяти по адресу edx и
3799
    возвращает 0.
3800
  * Содержимое памяти вплоть до наименьшего из старого и нового
3801
    размеров сохраняется.
3802
 
3803
======================================================================
77 diamond 3804
======================== Функция 69 - отладка. =======================
3805
======================================================================
3806
Процесс может загрузить другой процесс как отлаживаемый установкой
172 serge 3807
соответствующего бита при вызове подфункции 7 функции 70.
77 diamond 3808
У процесса может быть только один отладчик; один процесс может
3809
отлаживать несколько разных. Система уведомляет отладчик о событиях,
3810
происходящих с отлаживаемым процессом. Сообщения записываются в буфер,
131 diamond 3811
определённый подфункцией 0.
77 diamond 3812
Формат сообщения:
3813
  * +0: dword: код сообщения
3814
  * +4: dword: PID отлаживаемого процесса
3815
  * +8: могут присутствовать дополнительные данные,
3816
    определяемые кодом сообщения
3817
Коды сообщений:
3818
  * 1 = исключение
131 diamond 3819
    * дополнительно передаётся dword-номер исключения
77 diamond 3820
    * процесс приостановлен
3821
  * 2 = процесс завершился
3822
    * приходит при любом завершении: как через системную функцию -1,
3823
      так и при "убийстве" любым другим процессом
3824
      (в том числе самим отладчиком)
3825
  * 3 = отладочное исключение int 1 = #DB
131 diamond 3826
    * дополнительно передаётся dword-образ регистра DR6:
77 diamond 3827
      * биты 0-3: выполнено условие соответствующей точки останова
3828
        (установленной подфункцией 9)
3829
      * бит 14: исключение произошло из-за режима
3830
        пошаговой трассировки (установлен флаг TF)
3831
    * процесс приостановлен
3832
При завершении отладчика прибиваются все отлаживаемые процессы.
3833
Если отладчик этого не хочет, он должен предварительно отключиться
3834
подфункцией 3.
3835
 
3836
Все подфункции применимы только к процессам/потокам, запущенным
499 diamond 3837
из текущего функцией 70 с установленным флагом отладки.
77 diamond 3838
Отладка многопоточных программ пока не поддерживается.
3839
Полный список подфункций:
3840
  * подфункция 0 - определить область данных для отладочных сообщений
3841
  * подфункция 1 - получить состояние регистров отлаживаемого потока
3842
  * подфункция 2 - установить состояние регистров отлаживаемого потока
3843
  * подфункция 3 - отключиться от отлаживаемого процесса
3844
  * подфункция 4 - приостановить отлаживаемый поток
3845
  * подфункция 5 - возобновить выполнение отлаживаемого потока
3846
  * подфункция 6 - прочитать из памяти отлаживаемого процесса
3847
  * подфункция 7 - записать в память отлаживаемого процесса
3848
  * подфункция 8 - завершить отлаживаемый поток
3849
  * подфункция 9 - установить/снять аппаратную точку останова
3850
 
3851
======================================================================
3852
====================== Функция 69, подфункция 0 ======================
3853
========= Определить область данных для отладочных сообщений. ========
3854
======================================================================
3855
Параметры:
3856
  * eax = 69 - номер функции
3857
  * ebx = 0 - номер подфункции
3858
  * ecx = указатель
3859
Формат области данных:
3860
  * +0: dword: N = размер буфера (не считая этого заголовка)
3861
  * +4: dword: занято в буфере
3862
  * +8: N*byte: буфер
3863
Возвращаемое значение:
3864
  * функция не возвращает значения
3865
Замечания:
3866
  * Если поле размера отрицательно, буфер считается заблокированным
3867
    и при поступлении нового сообщения система будет ждать.
3868
    Для синхронизации обрамляйте всю работу с буфером операциями
3869
    блокировки/разблокировки
131 diamond 3870
    	neg	[bufsize]
77 diamond 3871
  * Данные в буфере трактуются как массив элементов переменной длины -
3872
    сообщений. Формат сообщения указан в общем описании.
3873
 
3874
======================================================================
3875
====================== Функция 69, подфункция 1 ======================
3876
========= Получить состояние регистров отлаживаемого потока. =========
3877
======================================================================
3878
Параметры:
3879
  * eax = 69 - номер функции
3880
  * ebx = 1 - номер подфункции
3881
  * ecx = идентификатор потока
3882
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3883
  * esi = указатель на структуру контекста
77 diamond 3884
Возвращаемое значение:
3885
  * функция не возвращает значения
3886
Формат структуры контекста: (FPU пока не поддерживается)
3887
  * +0: dword: eip
3888
  * +4: dword: eflags
3889
  * +8: dword: eax
3890
  * +12 = +0xC: dword: ecx
3891
  * +16 = +0x10: dword: edx
3892
  * +20 = +0x14: dword: ebx
3893
  * +24 = +0x18: dword: esp
3894
  * +28 = +0x1C: dword: ebp
3895
  * +32 = +0x20: dword: esi
3896
  * +36 = +0x24: dword: edi
3897
Замечания:
3898
  * Если поток выполняет код 0-кольца, возвращается
3899
    состояние регистров 3-кольца.
3900
  * Процесс должен быть загружен для отладки (как указано в
3901
    общем описании).
3902
 
3903
======================================================================
3904
====================== Функция 69, подфункция 2 ======================
3905
======== Установить состояние регистров отлаживаемого потока. ========
3906
======================================================================
3907
Параметры:
3908
  * eax = 69 - номер функции
3909
  * ebx = 2 - номер подфункции
3910
  * ecx = идентификатор потока
3911
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3912
  * esi = указатель на структуру контекста
77 diamond 3913
Возвращаемое значение:
3914
  * функция не возвращает значения
3915
Формат структуры контекста указан в описании подфункции 1.
3916
Замечания:
3917
  * Если поток выполняет код 0-кольца, устанавливается
3918
    состояние регистров 3-кольца.
3919
  * Процесс должен быть загружен для отладки (как указано в
3920
    общем описании).
3921
 
3922
======================================================================
3923
== Функция 69, подфункция 3 - отключиться от отлаживаемого процесса. =
3924
======================================================================
3925
Параметры:
3926
  * eax = 69 - номер функции
3927
  * ebx = 3 - номер подфункции
3928
  * ecx = идентификатор
3929
Возвращаемое значение:
3930
  * функция не возвращает значения
3931
Замечания:
3932
  * Если процесс был приостановлен, он возобновляет выполнение.
3933
 
3934
======================================================================
3935
==== Функция 69, подфункция 4 - приостановить отлаживаемый поток. ====
3936
======================================================================
3937
Параметры:
3938
  * eax = 69 - номер процесса
3939
  * ebx = 4 - номер подфункции
3940
  * ecx = идентификатор
3941
Возвращаемое значение:
3942
  * функция не возвращает значения
3943
Замечания:
3944
  * Процесс должен быть загружен для отладки (как указано в
3945
    общем описании).
3946
 
3947
======================================================================
3948
====================== Функция 69, подфункция 5 ======================
3949
============ Возобновить выполнение отлаживаемого потока. ============
3950
======================================================================
3951
Параметры:
3952
  * eax = 69 - номер функции
3953
  * ebx = 5 - номер подфункции
3954
  * ecx = идентификатор
3955
Возвращаемое значение:
3956
  * функция не возвращает значения
3957
Замечания:
3958
  * Процесс должен быть загружен для отладки (как указано в
3959
    общем описании).
3960
 
3961
======================================================================
3962
====================== Функция 69, подфункция 6 ======================
3963
============= Прочитать из памяти отлаживаемого процесса. ============
3964
======================================================================
3965
Параметры:
3966
  * eax = 69 - номер функции
3967
  * ebx = 6 - номер подфункции
3968
  * ecx = идентификатор
3969
  * edx = сколько байт читать
3970
  * esi = адрес памяти отлаживаемого процесса
3971
  * edi = указатель на буфер для данных
3972
Возвращаемое значение:
3973
  * eax = -1 при ошибке (неверный PID или буфер)
3974
  * иначе eax = число прочитанных байт (возможно, 0,
3975
    если в esi слишком большое значение)
3976
Замечания:
3977
  * Процесс должен быть загружен для отладки (как указано в
3978
    общем описании).
3979
 
3980
======================================================================
3981
 Функция 69, подфункция 7 - записать в память отлаживаемого процесса.
3982
======================================================================
3983
Параметры:
3984
  * eax = 69 - номер функции
3985
  * ebx = 7 - номер подфункции
3986
  * ecx = идентификатор
3987
  * edx = сколько байт писать
3988
  * esi = адрес памяти в отлаживаемом процессе
3989
  * edi = указатель на данные
3990
Возвращаемое значение:
3991
  * eax = -1 при ошибке (неверный PID или буфер)
3992
  * иначе eax = число записанных байт (возможно, 0,
3993
    если в esi слишком большое значение)
3994
Замечания:
3995
  * Процесс должен быть загружен для отладки (как указано в
3996
    общем описании).
3997
 
3998
======================================================================
3999
====== Функция 69, подфункция 8 - завершить отлаживаемый поток. ======
4000
======================================================================
4001
Параметры:
4002
  * eax = 69 - номер функции
4003
  * ebx = 8 - номер подфункции
4004
  * ecx = идентификатор
4005
Возвращаемое значение:
4006
  * функция не возвращает значения
4007
Замечания:
4008
  * Процесс должен быть загружен для отладки (как указано в
4009
    общем описании).
4010
  * Функция аналогична подфункции 2 функции 18 с двумя отличиями:
4011
    требуется выполнение первого замечания и принимается PID,
4012
    а не номер слота.
4013
 
4014
======================================================================
4015
====================== Функция 69, подфункция 9 ======================
4016
============= Установить/снять аппаратную точку останова. ============
4017
======================================================================
4018
Параметры:
4019
  * eax = 69 - номер функции
4020
  * ebx = 9 - номер подфункции
4021
  * ecx = идентификатор потока
4022
  * dl = индекс точки останова, от 0 до 3 включительно
4023
  * dh = флаги:
4024
    * если старший бит сброшен - установить точку останова:
4025
      * биты 0-1 - условие:
4026
        * 00 = точка останова на выполнение
4027
        * 01 = точка останова на запись
4028
        * 11 = точка останова на чтение/запись
4029
      * биты 2-3 - длина; для точек останова на исполнение должно быть
4030
        00, в противном случае одно из
4031
        * 00 = байт
4032
        * 01 = слово
4033
        * 11 = двойное слово
4034
      * esi = адрес точки останова; должен быть выровнен
131 diamond 4035
        соответственно длине (т.е. должен быть чётным для
77 diamond 4036
        точек останова на слово, кратен 4 для двойного слова)
4037
    * если старший бит установлен - сбросить точку останова
4038
Возвращаемое значение:
4039
  * eax = 0 - успешно
4040
  * eax = 1 - ошибка во входных данных
4041
  * eax = 2 - (зарезервировано, никогда не возвращается
4042
    в текущей реализации) с этим индексом уже установлена
4043
    глобальная точка останова
4044
Замечания:
4045
  * Процесс должен быть загружен для отладки (как указано в
4046
    общем описании).
4047
  * Аппаратные точки останова реализуются через DRx-регистры
4048
    процессора, отсюда все ограничения.
4049
  * Функция может переустановить ранее установленную ей же
4050
    точку останова (никак не сообщая об этом).
4051
    Ведите список установленных точек останова в отладчике.
4052
  * Срабатывание точки останова заключается в генерировании
4053
    отладочного исключения #DB, о котором система сообщает отладчику.
4054
  * Точка останова на запись и чтение/запись срабатывает после
131 diamond 4055
    выполнения вызвавшей её инструкции.
77 diamond 4056
 
4057
======================================================================
131 diamond 4058
= Функция 70 - работа с файловой системой с поддержкой длинных имён. =
77 diamond 4059
======================================================================
4060
Параметры:
4061
  * eax = 70
4062
  * ebx = указатель на информационную структуру
4063
Возвращаемое значение:
4064
  * eax = 0 - успешно; иначе код ошибки файловой системы
4065
  * в зависимости от подфункции может возвращаться значение и
4066
    в других регистрах
4067
Общий формат информационной структуры:
4068
  * +0: dword: номер подфункции
4069
  * +4: dword: смещение в файле
91 diamond 4070
  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
77 diamond 4071
  * +12 = +0xC: dword: размер
4072
  * +16 = +0x10: dword: указатель на данные
4073
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
86 diamond 4074
    или
4075
  * +20 = +0x14: db 0
4076
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4077
Уточнения - в документации на соответствующую подфункцию.
4078
Имя файла нечувствительно к регистру букв. Русские буквы должны быть
4079
записаны в кодировке cp866 (DOS).
4080
Формат имени файла:
4081
/base/number/dir1/dir2/.../dirn/file,
4082
где /base/number идентифицирует устройство, на котором ищется файл:
4083
одно из
4084
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
4085
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
4086
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
4087
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
131 diamond 4088
    к жёстким дискам на IDE0 (Primary Master), IDE1 (Primary Slave),
77 diamond 4089
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4090
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
4091
    (на каждом из винчестеров нумерация начинается с 1)
91 diamond 4092
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 для доступа соответственно
4093
    к CD на IDE0 (Primary Master), IDE1 (Primary Slave),
118 diamond 4094
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
546 diamond 4095
  * /SYS - определяет системную папку; при обычной загрузке системы
4096
    с дискеты эквивалентно /RD/1
77 diamond 4097
Примеры:
83 diamond 4098
  * '/rd/1/kernel.asm',0
77 diamond 4099
  * '/HD0/1/kernel.asm',0
4100
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4101
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
546 diamond 4102
  * '/sys/MySuperApp.ini',0
77 diamond 4103
Доступные подфункции:
4104
  * подфункция 0 - чтение файла
4105
  * подфункция 1 - чтение папки
83 diamond 4106
  * подфункция 2 - создание/перезапись файла
131 diamond 4107
  * подфункция 3 - запись в существующий файл
133 diamond 4108
  * подфункция 4 - установка размера файла
86 diamond 4109
  * подфункция 5 - получение атрибутов файла/папки
4110
  * подфункция 6 - установка атрибутов файла/папки
91 diamond 4111
  * подфункция 7 - запуск программы
172 serge 4112
  * подфункция 8 - удаление файла/папки
321 diamond 4113
  * подфункция 9 - создание папки
118 diamond 4114
Для CD-приводов в связи с аппаратными ограничениями доступны
4115
только подфункции 0,1,5 и 7, вызов других подфункций завершится
4116
ошибкой с кодом 2.
585 mario79 4117
При первом обращении подфункций 0,1,5,7 к устройствам ATAPI (CD и DVD)
4118
производится блокировка ручного управления механизмом лотка. Это связано
4119
с алгоритмом кэширования данных полученных от привода. Разблокировка
4120
производится обращением подфункцией 10 к соответствующему устройству.
77 diamond 4121
 
4122
======================================================================
131 diamond 4123
= Функция 70, подфункция 0 - чтение файла с поддержкой длинных имён. =
77 diamond 4124
======================================================================
4125
Параметры:
4126
  * eax = 70 - номер функции
4127
  * ebx = указатель на информационную структуру
4128
Формат информационной структуры:
4129
  * +0: dword: 0 = номер подфункции
4130
  * +4: dword: позиция в файле (в байтах)
4131
  * +8: dword: 0 (зарезервировано под старший dword позиции)
4132
  * +12 = +0xC: dword: сколько байт читать
4133
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
131 diamond 4134
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 4135
    общем описании
86 diamond 4136
    или
4137
  * +20 = +0x14: db 0
4138
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4139
Возвращаемое значение:
4140
  * eax = 0 - успешно, иначе код ошибки файловой системы
4141
  * ebx = число прочитанных байт или
4142
    -1=0xffffffff, если файл не найден
4143
Замечания:
4144
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 4145
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 4146
    eax=6 (EOF).
4147
  * Функция не позволяет читать папки
131 diamond 4148
    (вернётся eax=10, access denied).
77 diamond 4149
 
4150
======================================================================
131 diamond 4151
= Функция 70, подфункция 1 - чтение папки с поддержкой длинных имён. =
77 diamond 4152
======================================================================
4153
Параметры:
4154
  * eax = 70 - номер функции
4155
  * ebx = указатель на информационную структуру
4156
Формат информационной структуры:
4157
  * +0: dword: 1 = номер подфункции
4158
  * +4: dword: индекс начального блока (считая с 0)
78 diamond 4159
  * +8: dword: поле флагов:
4160
    * бит 0 (маска 1): в каком формате возвращать имена,
4161
      0=ANSI, 1=UNICODE
4162
    * прочие биты зарезервированы и должны быть установлены в 0
4163
      для будущей совместимости
77 diamond 4164
  * +12 = +0xC: dword: сколько блоков читать
4165
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
4166
    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
131 diamond 4167
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
77 diamond 4168
    общем описании
86 diamond 4169
    или
4170
  * +20 = +0x14: db 0
4171
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4172
Возвращаемое значение:
4173
  * eax = 0 - успешно, иначе код ошибки файловой системы
4174
  * ebx = число файлов, информация о которых была записана в буфер,
4175
    или -1=0xffffffff, если папка не найдена
4176
Структура буфера:
4177
  * +0: 32*byte: заголовок
4178
  * +32 = +0x20: n1*byte: блок с информацией о файле 1
4179
  * +32+n1: n2*byte: блок с информацией о файле 2
4180
  * ...
4181
Структура заголовка:
4182
  * +0: dword: версия структуры (текущая версия = 1)
131 diamond 4183
  * +4: dword: количество размещённых блоков; не больше, чем запрошено
77 diamond 4184
    в поле +12 информационной структуры; может быть меньше,
4185
    если в папке кончились файлы (то же самое, что и в ebx)
4186
  * +8: dword: общее число файлов в папке
4187
  * +12 = +0xC: 20*byte: зарезервировано (нули)
4188
Структура блока данных входа каталога (БДВК):
4189
  * +0: dword: атрибуты файла:
4190
    * бит 0 (маска 1): файл только для чтения
4191
    * бит 1 (маска 2): файл является скрытым
4192
    * бит 2 (маска 4): файл является системным
4193
    * бит 3 (маска 8): это не файл, а метка тома
4194
      (на заданном разделе встречается не более одного раза и
4195
      только в корневой папке)
4196
    * бит 4 (маска 0x10): это папка
4197
    * бит 5 (маска 0x20): файл не архивировался - многие программы
4198
      архивации имеют опцию, по которой архивируются только файлы
4199
      с установленным этим битом, после чего этот бит сбрасывается -
4200
      это может быть полезно для автоматического создания
4201
      backup-архивов, ибо при записи бит обычно устанавливается
4202
      (не в Kolibri, правда)
78 diamond 4203
  * +4: byte: тип данных имени:
4204
    (совпадает с битом 0 флагов информационной структуры)
77 diamond 4205
    * 0 = ASCII = 1-байтное представление каждого символа
4206
    * 1 = UNICODE = 2-байтное представление каждого символа
4207
  * +5: 3*byte: зарезервировано (нули)
4208
  * +8: 4*byte: время создания файла
4209
  * +12 = +0xC: 4*byte: дата создания файла
4210
  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
4211
  * +20 = +0x14: 4*byte: дата последнего доступа
4212
  * +24 = +0x18: 4*byte: время последней модификации
4213
  * +28 = +0x1C: 4*byte: дата последней модификации
4214
  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
4215
  * +40 = +0x28: имя
4216
    * для формата ASCII: максимальная длина имени 263 символа
4217
      (263 байта), байт после имени имеет значение 0
4218
    * для формата UNICODE: максимальная длина имени 259 символов
4219
      (518 байт), два байта после имени имеют значение 0
4220
Формат времени:
4221
  * +0: byte: секунды
4222
  * +1: byte: минуты
4223
  * +2: byte: часы
4224
  * +3: byte: зарезервировано (0)
4225
  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
4226
Формат даты:
4227
  * +0: byte: день
4228
  * +1: byte: месяц
4229
  * +2: word: год
4230
  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
4231
Замечания:
4232
  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
4233
    304 байта, если в UNICODE - 560 байт. Значение длины выравнено
4234
    на целое кратное 16 байт
4235
    (для ускорения обработки в кэш-памяти CPU).
78 diamond 4236
  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
4237
    данные содержат мусор.
77 diamond 4238
  * Если файлы в папке кончились раньше, чем было прочитано
4239
    запрошенное количество, то функция прочитает, сколько сможет,
131 diamond 4240
    после чего вернёт eax=6 (EOF).
77 diamond 4241
  * Любая папка на диске, кроме корневой, содержит два специальных
4242
    входа "." и "..", идентифицирующих соответственно саму папку и
4243
    родительскую папку.
4244
  * Функция позволяет также читать виртуальные папки "/", "/rd",
4245
    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
4246
    0x10, а времена и даты обнулены. Альтернативный способ получения
4247
    информации об оборудовании - подфункция 11 функции 18.
4248
 
4249
======================================================================
83 diamond 4250
====================== Функция 70, подфункция 2 ======================
131 diamond 4251
======== Создание/перезапись файла с поддержкой длинных имён. ========
83 diamond 4252
======================================================================
4253
Параметры:
4254
  * eax = 70 - номер функции
4255
  * ebx = указатель на информационную структуру
4256
Формат информационной структуры:
4257
  * +0: dword: 2 = номер подфункции
4258
  * +4: dword: 0 (зарезервировано)
4259
  * +8: dword: 0 (зарезервировано)
4260
  * +12 = +0xC: dword: сколько байт писать
4261
  * +16 = +0x10: dword: указатель на данные
131 diamond 4262
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
83 diamond 4263
    общем описании
86 diamond 4264
    или
4265
  * +20 = +0x14: db 0
4266
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
83 diamond 4267
Возвращаемое значение:
4268
  * eax = 0 - успешно, иначе код ошибки файловой системы
4269
  * ebx = число записанных байт (возможно, 0)
4270
Замечания:
131 diamond 4271
  * Если файл с таким именем не существовал, он создаётся; если
83 diamond 4272
    существовал, то перезаписывается.
4273
  * Если свободного места на диске недостаточно, то функция запишет,
131 diamond 4274
    сколько сможет, после чего вернёт код ошибки 8.
4275
  * Функция не поддерживается для CD (вернётся код ошибки 2).
83 diamond 4276
 
4277
======================================================================
131 diamond 4278
====================== Функция 70, подфункция 3 ======================
4279
======== Запись в существующий файл с поддержкой длинных имён. =======
4280
======================================================================
4281
Параметры:
4282
  * eax = 70 - номер функции
4283
  * ebx = указатель на информационную структуру
4284
Формат информационной структуры:
4285
  * +0: dword: 3 = номер подфункции
4286
  * +4: dword: позиция в файле (в байтах)
4287
  * +8: dword: старший dword позиции (должен быть 0 для FAT)
4288
  * +12 = +0xC: dword: сколько байт писать
4289
  * +16 = +0x10: dword: указатель на данные
4290
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4291
    общем описании
4292
    или
4293
  * +20 = +0x14: db 0
4294
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4295
Возвращаемое значение:
4296
  * eax = 0 - успешно, иначе код ошибки файловой системы
4297
  * ebx = число записанных байт (возможно, 0)
4298
Замечания:
4299
  * Файл должен уже существовать, иначе вернётся eax=5.
4300
  * Единственным результатом записи 0 байт является установка в
4301
    атрибутах файла даты/времени модификации и доступа в текущую.
4302
  * Если начальная и/или конечная позиция выходит за пределы файла
4303
    (за исключением предыдущего случая), файл расширяется до
4304
    необходимого размера нулевыми символами.
133 diamond 4305
  * Функция не поддерживается для CD (вернётся код ошибки 2).
131 diamond 4306
 
4307
======================================================================
133 diamond 4308
========= Функция 70, подфункция 4 - установка размера файла. ========
4309
======================================================================
4310
Параметры:
4311
  * eax = 70 - номер функции
4312
  * ebx = указатель на информационную структуру
4313
Формат информационной структуры:
4314
  * +0: dword: 4 = номер подфункции
4315
  * +4: dword: младший dword нового размера файла
4316
  * +8: dword: старший dword нового размера файла
4317
                   (должен быть 0 для FAT)
4318
  * +12 = +0xC: dword: 0 (зарезервировано)
4319
  * +16 = +0x10: dword: 0 (зарезервировано)
4320
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4321
    общем описании
4322
    или
4323
  * +20 = +0x14: db 0
4324
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4325
Возвращаемое значение:
4326
  * eax = 0 - успешно, иначе код ошибки файловой системы
4327
  * ebx разрушается
4328
Замечания:
4329
  * Если новый размер файла меньше старого, файл усекается. Если
4330
    новый размер больше старого, файл расширяется нулевыми символами.
4331
    Если новый размер равен старому, единственным результатом вызова
4332
    является установка даты/времени модификации и доступа в текущие.
4333
  * Если свободного места на диске недостаточно для расширения файла,
4334
    то функция расширит насколько возможно, после чего вернёт
4335
    код ошибки 8.
4336
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4337
 
4338
======================================================================
86 diamond 4339
=== Функция 70, подфункция 5 - получение информации о файле/папке. ===
4340
======================================================================
4341
Параметры:
4342
  * eax = 70 - номер функции
4343
  * ebx = указатель на информационную структуру
4344
Формат информационной структуры:
4345
  * +0: dword: 5 = номер подфункции
4346
  * +4: dword: 0 (зарезервировано)
4347
  * +8: dword: 0 (зарезервировано)
4348
  * +12 = +0xC: dword: 0 (зарезервировано)
4349
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
4350
                        (40 байт)
131 diamond 4351
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4352
    общем описании
4353
    или
4354
  * +20 = +0x14: db 0
4355
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4356
Возвращаемое значение:
4357
  * eax = 0 - успешно, иначе код ошибки файловой системы
4358
  * ebx разрушается
4359
Информация о файле возвращается в формате БДВК
4360
(блока данных входа каталога), указанном в описании
4361
подфункции 1, но без имени файла
4362
(то есть первые 40 = 0x28 байт).
4363
Замечания:
4364
  * Функция не поддерживает виртуальные папки типа /, /rd и
4365
    корневые папки типа /rd/1.
4366
 
4367
======================================================================
4368
===== Функция 70, подфункция 6 - установка атрибутов файла/папки. ====
4369
======================================================================
4370
Параметры:
4371
  * eax = 70 - номер функции
4372
  * ebx = указатель на информационную структуру
4373
Формат информационной структуры:
4374
  * +0: dword: 6 = номер подфункции
4375
  * +4: dword: 0 (зарезервировано)
4376
  * +8: dword: 0 (зарезервировано)
4377
  * +12 = +0xC: dword: 0 (зарезервировано)
4378
  * +16 = +0x10: dword: указатель на буфер с атрибутами (32 байта)
131 diamond 4379
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4380
    общем описании
4381
    или
4382
  * +20 = +0x14: db 0
4383
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4384
Возвращаемое значение:
4385
  * eax = 0 - успешно, иначе код ошибки файловой системы
4386
  * ebx разрушается
4387
Атрибуты файла - первые 32 байта в БДВК (блоке данных входа каталога),
4388
формат которого указан в описании подфункции 1
4389
(то есть без имени и размера файла). Атрибут файл/папка/метка тома
4390
(биты 3,4 в dword'е +0) не меняется.
4391
Байт +4 (формат имени) игнорируется.
4392
Замечания:
4393
  * Функция не поддерживает виртуальные папки типа /, /rd и
4394
    корневые папки типа /rd/1.
131 diamond 4395
  * Функция не поддерживается для CD (вернётся код ошибки 2).
86 diamond 4396
 
4397
======================================================================
91 diamond 4398
============ Функция 70, подфункция 7 - запуск программы. ============
4399
======================================================================
4400
Параметры:
4401
  * eax = 70 - номер функции
4402
  * ebx = указатель на информационную структуру
4403
Формат информационной структуры:
4404
  * +0: dword: 7 = номер подфункции
4405
  * +4: dword: поле флагов:
4406
    * бит 0: запустить процесс как отлаживаемый
4407
    * остальные биты зарезервированы и должны быть установлены в 0
4408
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
4409
  * +12 = +0xC: dword: 0 (зарезервировано)
4410
  * +16 = +0x10: dword: 0 (зарезервировано)
131 diamond 4411
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
91 diamond 4412
    общем описании
4413
    или
4414
  * +20 = +0x14: db 0
4415
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4416
Возвращаемое значение:
4417
  * eax > 0 - программа загружена, eax содержит PID
4418
  * eax < 0 - произошла ошибка, -eax содержит
4419
    код ошибки файловой системы
4420
  * ebx разрушается
4421
Замечания:
4422
  * Командная строка должна заканчиваться символом с кодом 0
4423
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
4424
    включительно, либо первые 256 символов, в зависимости от того,
4425
    что меньше.
131 diamond 4426
  * Если процесс запускается как отлаживаемый, он создаётся
91 diamond 4427
    в замороженном состоянии; для запуска используйте
4428
    подфункцию 5 функции 69.
4429
 
4430
======================================================================
172 serge 4431
========== Функция 70, подфункция 8 - удаление файла/папки. ==========
4432
======================================================================
4433
Параметры:
4434
  * eax = 70 - номер функции
4435
  * ebx = указатель на информационную структуру
4436
Формат информационной структуры:
4437
  * +0: dword: 8 = номер подфункции
4438
  * +4: dword: 0 (зарезервировано)
4439
  * +8: dword: 0 (зарезервировано)
4440
  * +12 = +0xC: dword: 0 (зарезервировано)
4441
  * +16 = +0x10: dword: 0 (зарезервировано)
4442
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4443
    общем описании
4444
    или
4445
  * +20 = +0x14: db 0
4446
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4447
Возвращаемое значение:
4448
  * eax = 0 - успешно, иначе код ошибки файловой системы
4449
  * ebx разрушается
4450
Замечания:
4451
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4452
  * Можно удалять только пустые папки (попытка удаления непустой папки
4453
    приведёт к ошибке с кодом 10, "доступ запрещён").
4454
 
4455
======================================================================
321 diamond 4456
============= Функция 70, подфункция 9 - создание папки. =============
4457
======================================================================
4458
Параметры:
4459
  * eax = 70 - номер функции
4460
  * ebx = указатель на информационную структуру
4461
Формат информационной структуры:
4462
  * +0: dword: 9 = номер подфункции
4463
  * +4: dword: 0 (зарезервировано)
4464
  * +8: dword: 0 (зарезервировано)
4465
  * +12 = +0xC: dword: 0 (зарезервировано)
4466
  * +16 = +0x10: dword: 0 (зарезервировано)
4467
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
4468
    общем описании
4469
    или
4470
  * +20 = +0x14: db 0
4471
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем папки
4472
Возвращаемое значение:
4473
  * eax = 0 - успешно, иначе код ошибки файловой системы
4474
  * ebx разрушается
4475
Замечания:
4476
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4477
  * Родительская папка должна уже существовать.
4478
  * Если папка уже существует, функция завершится успешно (eax=0).
4479
 
4480
======================================================================
585 mario79 4481
========== Функция 70, подфункция 10 - извлечь лоток привода диска. ============
4482
======================================================================
4483
Параметры:
4484
  * eax = 70 - номер функции
4485
  * ebx = указатель на информационную структуру
4486
Формат информационной структуры:
4487
  * +0: dword: 10 = номер подфункции
4488
  * +4: dword: 0 (зарезервировано)
4489
  * +8: dword: 0 (зарезервировано)
4490
  * +12 = +0xC: dword: 0 (зарезервировано)
4491
  * +16 = +0x10: dword: 0 (зарезервировано)
4492
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
4493
    общем описании
4494
    или
4495
  * +20 = +0x14: db 0
4496
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем папки
4497
Возвращаемое значение:
4498
    * Ничего не возвращается.
4499
Замечания:
4500
  * Функция поддерживается только для ATAPI устройств (CD и DVD).
4501
  * При извлечении лотка производится разблокировка ручного управления механизмом лотка.
4502
  * При извлечении лотка код производит очистку кэша соответствующего устройства.
4503
  * Путь вводится в стандартном для 70 функции виде. Для работоспособности можно
4504
     ограничиться путями вида:
4505
     db '/cd0/1/',0
4506
     db '/cd1/1/',0
4507
     db '/cd2/1/',0
4508
     db '/cd3/1/',0
4509
  * Примером использования функции является приложение CD_tray.
4510
 
4511
======================================================================
4512
========== Функция 70, подфункция 11 - загрузить лоток привода диска. ===========
4513
======================================================================
4514
Параметры:
4515
  * eax = 70 - номер функции
4516
  * ebx = указатель на информационную структуру
4517
Формат информационной структуры:
4518
  * +0: dword: 11 = номер подфункции
4519
  * +4: dword: 0 (зарезервировано)
4520
  * +8: dword: 0 (зарезервировано)
4521
  * +12 = +0xC: dword: 0 (зарезервировано)
4522
  * +16 = +0x10: dword: 0 (зарезервировано)
4523
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
4524
    общем описании
4525
    или
4526
  * +20 = +0x14: db 0
4527
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем папки
4528
Возвращаемое значение:
4529
    * Ничего не возвращается.
4530
Замечания:
4531
  * Функция поддерживается только для ATAPI устройств (CD и DVD)
4532
  * Путь вводится в стандартном для 70 функции виде. Для работоспособности можно
4533
     ограничиться путями вида:
4534
     db '/cd0/1/',0
4535
     db '/cd1/1/',0
4536
     db '/cd2/1/',0
4537
     db '/cd3/1/',0
4538
  * Примером использования функции является приложение CD_tray.
4539
 
4540
======================================================================
118 diamond 4541
=== Функция 71, подфункция 1 - установить заголовок окна программы. ==
114 mikedld 4542
======================================================================
4543
Параметры:
4544
  * eax = 71 - номер функции
4545
  * ebx = 1 - номер подфункции
118 diamond 4546
  * ecx = адрес строки заголовка
114 mikedld 4547
Возвращаемое значение:
118 diamond 4548
  * функция не возвращает значения
114 mikedld 4549
Замечания:
4550
  * Строка заголовка должна быть в формате ASCIIZ. В заголовке
118 diamond 4551
    отображается не более 255 символов независимо от полной длины
114 mikedld 4552
    строки.
118 diamond 4553
  * Чтобы убрать заголовок, передайте NULL в ecx.
114 mikedld 4554
 
4555
======================================================================
77 diamond 4556
========== Функция -1 - завершить выполнение потока/процесса =========
4557
======================================================================
4558
Параметры:
4559
  * eax = -1 - номер функции
4560
Возвращаемое значение:
4561
  * функция не возвращает ни значения, ни управления
4562
Замечания:
4563
  * Если процесс явно не создавал потоков, то у него есть только
4564
    один поток, завершение которого приводит к завершению процесса.
4565
  * Если текущий поток - последний в процессе, то его завершение
4566
    также приводит к завершению процесса.
4567
  * Эта функция завершает текущий поток. Другой поток можно прибить
4568
    вызовом подфункции 2 функции 18.
4569
 
4570
======================================================================
4571
=========================== Список событий ===========================
4572
======================================================================
4573
Очередное событие можно получить вызовом одной из функций 10
4574
(ожидать события), 11 (проверить без ожидания), 23
4575
(ожидать в течение заданного времени).
4576
Эти функции возвращают только те события, которые входят в маску,
4577
устанавливаемую функцией 40. По умолчанию это первые три, чего
4578
вполне достаточно для многих приложений.
4579
Коды событий:
4580
  * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
4581
  * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
92 diamond 4582
    активно) или нажата "горячая клавиша";
4583
    сбрасывается, когда все клавиши из буфера считаны функцией 2
131 diamond 4584
  * 3 = нажата кнопка, определённая ранее функцией 8 (или кнопка
77 diamond 4585
    закрытия, созданная неявно функцией 0; кнопка минимизации
4586
    обрабатывается системой и о ней сообщения не приходит;
4587
    поступает, только когда окно активно; сбрасывается, когда все
4588
    кнопки из буфера считаны функцией 17)
4589
  * 4 = зарезервировано (в текущей реализации никогда не приходит даже
4590
    при размаскировке функцией 40)
4591
  * 5 = перерисовывается фон рабочего стола (сбрасывается
4592
    автоматически после перерисовки, так что если во время перерисовки
131 diamond 4593
    фона программа не ждёт и не проверяет события, то этого события
77 diamond 4594
    она не заметит)
4595
  * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
4596
    или перемещение; сбрасывается при прочтении)
4597
  * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
4598
    Communication; сбрасывается при прочтении)
4599
  * 8 = произошло сетевое событие (сбрасывается при прочтении;
4600
    смотри работу с сетью)
4601
  * 9 = произошло отладочное событие (сбрасывается при прочтении;
4602
    смотри отладочную подсистему)
4603
  * 16..31 = произошло событие с соответствующим IRQ
4604
    (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)
4605
 
4606
======================================================================
4607
==================== Коды ошибок файловой системы ====================
4608
======================================================================
4609
  * 0 = успешно
131 diamond 4610
  * 1 = не определена база и/или раздел жёсткого диска (подфункциями
77 diamond 4611
    7, 8 функции 21)
4612
  * 2 = функция не поддерживается для данной файловой системы
4613
  * 3 = неизвестная файловая система
448 diamond 4614
  * 4 = зарезервировано, никогда не возвращается в текущей реализации
77 diamond 4615
  * 5 = файл не найден
4616
  * 6 = файл закончился
4617
  * 7 = указатель вне памяти приложения
4618
  * 8 = диск заполнен
4619
  * 9 = таблица FAT разрушена
131 diamond 4620
  * 10 = доступ запрещён
83 diamond 4621
  * 11 = ошибка устройства
77 diamond 4622
При запуске программы возможны также следующие коды ошибок:
4623
  * 30 = 0x1E = недостаточно памяти
4624
  * 31 = 0x1F = файл не является исполнимым
172 serge 4625
  * 32 = 0x20 = слишком много процессов