Subversion Repositories Kolibri OS

Rev

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

Rev Author Line No. Line
641 diamond 1
СИСТЕМНЫЕ ФУНКЦИИ ОПЕРАЦИОННОЙ СИСТЕМЫ Kolibri 0.7.1.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 - окно со скином
641 diamond 25
      * Y=4 - окно со скином фиксированных размеров
26
      * остальные возможные значения (от 5 до 15) зарезервированы,
77 diamond 27
        вызов функции с такими Y игнорируется
28
    * RR, GG, BB = соответственно красная, зеленая, синяя
29
      составляющие цвета рабочей области окна
30
      (игнорируется для стиля Y=2)
114 mikedld 31
    * X = DCBA (биты)
641 diamond 32
      * A = 1 - у окна есть заголовок; для стилей Y=3,4 адрес строки
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 - неперемещаемое окно
802 serge 44
    * X определяет градиент заголовка: X=0 - нет градиента,
77 diamond 45
      X=8 - обычный градиент,
46
      для окон типа II X=4 - негативный градиент
47
    * прочие значения X и Y зарезервированы
48
  * edi = 0x00RRGGBB - цвет рамки
49
Возвращаемое значение:
50
  * функция не возвращает значения
51
Замечания:
52
  * Положение и размеры окна устанавливаются при первом вызове
53
    этой функции и игнорируются при последующих; для изменения
54
    положения и/или размеров уже созданного окна используйте
55
    67-ю функцию.
641 diamond 56
  * Для окон стилей Y=3,4 с заголовком (A=1) строка заголовка
118 diamond 57
    устанавливается при первом вызове этой функции и игнорируется при
58
    последующих (точнее говоря, игнорируется после вызова
59
    подфункции 2 функции 12 - конца перерисовки);
60
    для изменения строки заголовка уже созданного окна используйте
61
    подфункцию 1 функции 71.
77 diamond 62
  * Если использовать окна соответствующих стилей, то положение
63
    и/или размеры окна могут меняться пользователем.
64
    Текущие положение и размеры могут быть получены вызовом функции 9.
65
  * Окно должно умещаться на экране. Если переданные координаты
66
    и размеры не удовлетворяют этому условию, то соответствующая
67
    координата (или, возможно, обе) считается нулем, а если и это
68
    не помогает, то соответствующий размер (или, возможно, оба)
69
    устанавливается в размер экрана.
802 serge 70
 
77 diamond 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
803 alver 624
  * если буфер не пуст, тогда возвращается:  старшие 24 бита eax
77 diamond 625
    содержат идентификатор кнопки (в частности, в ah оказывается
626
    младший байт идентификатора; если все кнопки имеют идентификатор,
803 alver 627
    меньший 256, то для различения достаточно ah),
628
    а в al возвращается 0 - если использовалась левая кнопка мыши, или бит той кнопки мыши, которая использовалась.
77 diamond 629
Замечания:
630
  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки
631
    информация о старой теряется.
632
  * При вызове этой функции приложением с неактивным окном
633
    возвращается ответ "буфер пуст".
634
 
635
======================================================================
91 diamond 636
==== Функция 18, подфункция 2 - завершить процесс/поток по слоту. ====
77 diamond 637
======================================================================
638
Параметры:
639
  * eax = 18 - номер функции
640
  * ebx = 2 - номер подфункции
641
  * ecx = номер слота процесса/потока
642
Возвращаемое значение:
643
  * функция не возвращает значения
644
Замечания:
645
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
646
    1), можно завершить любой обычный поток/процесс.
91 diamond 647
  * Смотри также подфункцию 18 - завершение
648
    процесса/потока с заданным идентификатором.
77 diamond 649
 
650
======================================================================
651
= Функция 18, подфункция 3 - сделать активным окно заданного потока. =
652
======================================================================
653
Параметры:
654
  * eax = 18 - номер функции
655
  * ebx = 3 - номер подфункции
656
  * ecx = номер слота потока
657
Возвращаемое значение:
658
  * функция не возвращает значения
659
Замечания:
660
  * При указании корректного, но несуществующего слота активизируется
661
    какое-то окно.
662
  * Узнать, какое окно является активным, можно вызовом подфункции 7.
663
 
664
======================================================================
802 serge 665
 Функция 18, подфункция 4 - получить счётчик пустых тактов в секунду.
77 diamond 666
======================================================================
667
Под пустыми тактами понимается время, в которое процессор простаивает
668
в ожидании прерывания (в инструкции hlt).
669
 
670
Параметры:
671
  * eax = 18 - номер функции
672
  * ebx = 4 - номер подфункции
673
Возвращаемое значение:
131 diamond 674
  * eax = значение счётчика пустых тактов в секунду
77 diamond 675
 
676
======================================================================
677
======== Функция 18, подфункция 5 - получить тактовую частоту. =======
678
======================================================================
679
Параметры:
680
  * eax = 18 - номер функции
681
  * ebx = 5 - номер подфункции
682
Возвращаемое значение:
683
  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)
684
 
685
======================================================================
802 serge 686
 Функция 18, подфункция 6 - сохранить рамдиск в файл на жёстком диске.
77 diamond 687
======================================================================
688
Параметры:
689
  * eax = 18 - номер функции
690
  * ebx = 6 - номер подфункции
341 heavyiron 691
  * ecx = указатель на строку с полным именем файла
692
    (например, "/hd0/1/kolibri/kolibri.img")
77 diamond 693
Возвращаемое значение:
694
  * eax = 0 - успешно
695
  * иначе eax = код ошибки файловой системы
696
Замечания:
131 diamond 697
  * Все папки в указанном пути должны существовать, иначе вернётся
77 diamond 698
    значение 5, "файл не найден".
699
 
700
======================================================================
701
====== Функция 18, подфункция 7 - получить номер активного окна. =====
702
======================================================================
703
Параметры:
704
  * eax = 18 - номер функции
705
  * ebx = 7 - номер подфункции
706
Возвращаемое значение:
707
  * eax = номер активного окна (номер слота потока, окно которого
708
    активно)
709
Замечания:
710
  * Активное окно находится вверху оконного стэка и получает
131 diamond 711
    сообщения обо всём вводе с клавиатуры.
77 diamond 712
  * Сделать окно активным можно вызовом подфункции 3.
713
 
714
======================================================================
715
==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====
716
======================================================================
131 diamond 717
При отключённом звуке вызовы подфункции 55 функции 55 игнорируются.
718
При включённом - направляются на встроенный спикер.
77 diamond 719
 
720
--------------- Подподфункция 1 - получить состояние. ----------------
721
Параметры:
722
  * eax = 18 - номер функции
723
  * ebx = 8 - номер подфункции
724
  * ecx = 1 - номер подподфункции
725
Возвращаемое значение:
131 diamond 726
  * eax = 0 - звук спикера разрешён; 1 - запрещён
77 diamond 727
 
728
-------------- Подподфункция 2 - переключить состояние. --------------
729
Переключает состояния разрешения/запрещения.
730
Параметры:
731
  * eax = 18 - номер функции
732
  * ebx = 8 - номер подфункции
733
  * ecx = 2 - номер подподфункции
734
Возвращаемое значение:
735
  * функция не возвращает значения
736
 
737
======================================================================
748 heavyiron 738
======= Функция 18, подфункция 9 - завершение работы системы  ========
77 diamond 739
======================================================================
740
Параметры:
741
  * eax = 18 - номер функции
742
  * ebx = 9 - номер подфункции
743
  * ecx = параметр:
744
    * 2 = выключить компьютер
745
    * 3 = перезагрузить компьютер
746
    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске
747
Возвращаемое значение:
748
  * при неверном ecx регистры не меняются (т.е. eax=18)
749
  * при правильном вызове всегда возвращается признак успеха eax=0
750
Замечания:
751
  * Не следует полагаться на возвращаемое значение при неверном
752
    вызове, оно может измениться в последующих версиях ядра.
753
  * Можно использовать подфункцию 1, чтобы на последнем шаге
754
    завершения работы пользователь сам решал, что ему нужно.
755
======================================================================
756
======== Функция 18, подфункция 10 - свернуть окно приложения. =======
757
======================================================================
758
Сворачивает собственное окно.
759
Параметры:
760
  * eax = 18 - номер функции
761
  * ebx = 10 - номер подфункции
762
Возвращаемое значение:
763
  * функция не возвращает значения
764
Замечания:
765
  * Минимизированное окно с точки зрения функции 9 сохраняет положение
766
    и размеры.
802 serge 767
  * Восстановление окна приложения происходит при активизировании
77 diamond 768
    подфункцией 3.
131 diamond 769
  * Обычно нет необходимости явно сворачивать/разворачивать своё окно:
77 diamond 770
    сворачивание окна осуществляется системой при нажатии на кнопку
771
    минимизации (которая для окон со скином определяется автоматически
131 diamond 772
    функцией 0, для окон без скина её можно определить функцией 8),
77 diamond 773
    восстановление - приложением @panel.
774
 
775
======================================================================
776
====================== Функция 18, подфункция 11 =====================
777
============= Получить информацию о дисковой подсистеме. =============
778
======================================================================
779
Параметры:
780
  * eax = 18 - номер функции
781
  * ebx = 11 - номер подфункции
782
  * ecx = тип таблицы:
783
    * 1 = короткая версия, 10 байт
784
    * 2 = полная версия, 65536 байт
785
  * edx = указатель на буфер (в приложении) для таблицы
786
Возвращаемое значение:
787
  * функция не возвращает значения
788
Формат таблицы: короткая версия:
789
  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,
131 diamond 790
    где AAAA задаёт тип первого дисковода, BBBB - второго согласно
77 diamond 791
    следующему списку:
792
    * 0 = нет дисковода
793
    * 1 = 360Kb, 5.25''
794
    * 2 = 1.2Mb, 5.25''
795
    * 3 = 720Kb, 3.5''
796
    * 4 = 1.44Mb, 3.5''
797
    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)
798
    Например, для стандартной конфигурации из одного 1.44-дисковода
799
    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:
800
    значение оказывается 24h.
131 diamond 801
  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,
77 diamond 802
    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
803
    * 0 = устройство отсутствует
131 diamond 804
    * 1 = жёсткий диск
77 diamond 805
    * 2 = CD-привод
806
    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
131 diamond 807
  * +2: 4 db: число найденных разделов на жёстких дисках с
77 diamond 808
    соответственно IDE0,...,IDE3.
131 diamond 809
    При отсутствии жёсткого диска на IDEx соответствующий байт
77 diamond 810
    нулевой, при наличии показывает число распознанных разделов,
811
    которых может и не быть (если носитель не отформатирован или
812
    если файловая система не поддерживается). В текущей версии ядра
277 diamond 813
    для жёстких дисков поддерживаются только FAT16, FAT32 и NTFS.
77 diamond 814
  * +6: 4 db: зарезервировано
815
Формат таблицы: полная версия:
816
  * +0: 10 db: такие же, как и в короткой версии
817
  * +10: 100 db: данные для первого раздела
818
  * +110: 100 db: данные для второго раздела
819
  * ...
820
  * +10+100*(n-1): 100 db: данные для последнего раздела
821
Разделы расположены в следующем порядке: сначала последовательно все
822
распознанные разделы на HD на IDE0 (если есть),
823
затем на HD на IDE1 (если есть) и т.д. до IDE3.
277 diamond 824
Формат информации о разделе:
77 diamond 825
  * +0: dword: начальный физический сектор раздела
826
  * +4: dword: последний физический сектор раздела
827
    (принадлежит разделу)
277 diamond 828
  * +8: byte: тип файловой системы:
829
    16=FAT16, 32=FAT32, 1=NTFS
830
  * формат дальнейших данных зависит от файловой системы,
831
    может меняться с изменениями в ядре и поэтому не описывается
77 diamond 832
Замечания:
833
  * Короткая таблица может быть использована для получения информации
834
    об имеющихся устройствах.
835
 
836
======================================================================
837
========== Функция 18, подфункция 13 - получить версию ядра. =========
838
======================================================================
839
Параметры:
840
  * eax = 18 - номер функции
841
  * ebx = 13 - номер подфункции
842
  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена
843
    информация
844
Возвращаемое значение:
845
  * функция не возвращает значения
846
Структура буфера:
847
db a,b,c,d для версии a.b.c.d
848
db UID_xxx: одно из UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
546 diamond 849
dd REV - номер svn-ревизии ядра
641 diamond 850
Для ядра Kolibri 0.7.1.0:
851
db 0,7,1,0
77 diamond 852
db 2
641 diamond 853
dd 638
77 diamond 854
 
855
======================================================================
856
====================== Функция 18, подфункция 14 =====================
131 diamond 857
======= Ожидать начала обратного хода луча развёртки монитора. =======
77 diamond 858
======================================================================
859
Параметры:
860
  * eax = 18 - номер функции
861
  * ebx = 14 - номер подфункции
862
Возвращаемое значение:
863
  * eax = 0 как признак успеха
864
Замечания:
865
  * Функция предназначена исключительно для активных
866
    высокопроизводительных графических приложений; используется для
867
    плавного вывода графики.
868
 
869
======================================================================
870
== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =
871
======================================================================
872
Параметры:
873
  * eax = 18 - номер функции
874
  * ebx = 15 - номер подфункции
875
Возвращаемое значение:
876
  * eax = 0 как признак успеха
877
 
878
======================================================================
879
====================== Функция 18, подфункция 16 =====================
880
============ Получить размер свободной оперативной памяти. ===========
881
======================================================================
882
Параметры:
883
  * eax = 18 - номер функции
884
  * ebx = 16 - номер подфункции
885
Возвращаемое значение:
886
  * eax = размер свободной памяти в килобайтах
887
 
888
======================================================================
889
====================== Функция 18, подфункция 17 =====================
890
============ Получить размер имеющейся оперативной памяти. ===========
891
======================================================================
892
Параметры:
893
  * eax = 18 - номер функции
894
  * ebx = 17 - номер подфункции
895
Возвращаемое значение:
896
  * eax = общий размер имеющейся памяти в килобайтах
897
 
898
======================================================================
91 diamond 899
====================== Функция 18, подфункция 18 =====================
900
============= Завершить процесс/поток по идентификатору. =============
85 halyavin 901
======================================================================
902
Параметры:
903
  * eax = 18 - номер функции
904
  * ebx = 18 - номер подфункции
91 diamond 905
  * ecx = идентификатор процесса/потока (PID/TID)
906
Возвращаемое значение:
907
  * eax = 0 - успешно
908
  * eax = -1 - ошибка (процесс не найден или является системным)
909
Замечания:
910
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
911
    1), можно завершить любой обычный поток/процесс.
912
  * Смотри также подфункцию 2 - завершение
913
    процесса/потока по заданному слоту.
85 halyavin 914
 
915
======================================================================
131 diamond 916
=== Функция 18, подфункция 19 - получить/установить настройки мыши. ==
120 mario79 917
======================================================================
131 diamond 918
 
919
------------- Подподфункция 0 - получить скорость мыши. --------------
120 mario79 920
Параметры:
921
  * eax = 18 - номер функции
922
  * ebx = 19 - номер подфункции
131 diamond 923
  * ecx = 0 - номер подподфункции
924
Возвращаемое значение:
925
  * eax = текущая скорость мыши
120 mario79 926
 
131 diamond 927
------------ Подподфункция 1 - установить скорость мыши. -------------
928
Параметры:
929
  * eax = 18 - номер функции
930
  * ebx = 19 - номер подфункции
931
  * ecx = 1 - номер подподфункции
932
  * edx = новое значение скорости
933
Возвращаемое значение:
934
  * функция не возвращает значения
120 mario79 935
 
131 diamond 936
------------- Подподфункция 2 - получить задержку мыши. --------------
937
Параметры:
938
  * eax = 18 - номер функции
939
  * ebx = 19 - номер подфункции
940
  * ecx = 2 - номер подподфункции
941
Возвращаемое значение:
942
  * eax = текущая задержка мыши
120 mario79 943
 
131 diamond 944
------------ Подподфункция 3 - установить задержку мыши. -------------
945
Параметры:
946
  * eax = 18 - номер функции
947
  * ebx = 19 - номер подфункции
948
  * ecx = 3 - номер подподфункции
949
  * edx = новое значение задержки мыши
950
Возвращаемое значение:
951
  * функция не возвращает значения
120 mario79 952
 
131 diamond 953
-------- Подподфункция 4 - установить положение курсора мыши. --------
954
Параметры:
955
  * eax = 18 - номер функции
956
  * ebx = 19 - номер подфункции
957
  * ecx = 4 - номер подподфункции
958
  * edx = [координата по оси x]*65536 + [координата по оси y]
959
Возвращаемое значение:
960
  * функция не возвращает значения
621 mario79 961
 
641 diamond 962
------- Подподфункция 5 - симулировать состояние клавиш мыши. --------
621 mario79 963
Параметры:
964
  * eax = 18 - номер функции
965
  * ebx = 19 - номер подфункции
966
  * ecx = 5 - номер подподфункции
641 diamond 967
  * edx = информация о эмулируемом состоянии кнопок мыши:
968
    (соответствует возвращаемому значению подфункции 2 функции 37)
969
    * бит 0 установлен = левая кнопка нажата
970
    * бит 1 установлен = правая кнопка нажата
971
    * бит 2 установлен = средняя кнопка нажата
972
    * бит 3 установлен = 4-я кнопка нажата
973
    * бит 4 установлен = 5-я кнопка нажата
621 mario79 974
Возвращаемое значение:
975
  * функция не возвращает значения
120 mario79 976
Замечания:
131 diamond 977
  * Рекомендуемая скорость мыши (в подподфункции 1) от 1 до 9.
978
    Устанавливаемая величина не проверяется кодом ядра, поэтому
979
    используйте осторожно, при некорректном значении курсор может
980
    "замёрзнуть". Скорость мыши можно регулировать в приложении SETUP.
981
  * Рекомендуемая величина задержки (в подподфункции 3) = 10.
982
    Меньшие значения не обрабатываются COM-мышами. При очень больших
983
    значениях невозможно передвижение мыши на 1 пиксель и курсор будет
984
    прыгать на величину установленной скорости (подподфункция 1).
985
    Устанавливаемая величина не проверяется кодом ядра.
133 diamond 986
    Величину задержки можно менять в приложении SETUP.
131 diamond 987
  * Подподфункция 4 не проверяет переданное значение. Перед вызовом
988
    необходимо узнать текущее разрешение экрана (подфункцией 14)
989
    и проверить, что устанавливаемое положение не выходит за пределы
990
    экрана.
120 mario79 991
 
992
======================================================================
172 serge 993
====================== Функция 18, подфункция 20 =====================
994
============= Получить информацию об оперативной памяти. =============
995
======================================================================
996
Параметры:
997
  * eax = 18 - номер функции
998
  * ebx = 20 - номер подфункции
999
  * ecx = указатель на буфер для информации (36 байт)
1000
Возвращаемое значение:
1001
  * eax = общий размер имеющейся оперативной памяти в байтах
1002
    или -1 в случае ошибки
1003
  * буфер, на который указывает ecx, содержит следующую информацию:
277 diamond 1004
    * +0: dword: общий размер имеющейся оперативной памяти в страницах
172 serge 1005
    * +4:  dword: размер свободной оперативной памяти в страницах
1006
    * +8:  dword: число страничных ошибок (исключений #PF)
1007
                 в приложениях
1008
    * +12: dword: размер кучи ядра в байтах
277 diamond 1009
    * +16: dword: размер свободной памяти в куче ядра в байтах
172 serge 1010
    * +20: dword: общее количество блоков памяти в куче ядра
277 diamond 1011
    * +24: dword: количество свободных блоков памяти в куче ядра
172 serge 1012
    * +28: dword: размер наибольшего свободного блока в куче ядра
277 diamond 1013
                 (зарезервировано)
1014
    * +32: dword: размер наибольшего выделенного блока в куче ядра
1015
                 (зарезервировано)
172 serge 1016
 
1017
======================================================================
608 alver 1018
====================== Функция 18, подфункция 21 =====================
641 diamond 1019
======= Получить номер слота процесса/потока по идентификатору. ======
608 alver 1020
======================================================================
1021
Параметры:
1022
  * eax = 18 - номер функции
1023
  * ebx = 21 - номер подфункции
641 diamond 1024
  * ecx = идентификатор процесса/потока (PID/TID)
608 alver 1025
Возвращаемое значение:
641 diamond 1026
  * eax = 0 - ошибка (неверный идентификатор)
1027
  * иначе eax = номер слота
608 alver 1028
 
1029
======================================================================
802 serge 1030
 Функция 18, подфункция 22 - операции с окном другого процесса/потока.
608 alver 1031
======================================================================
1032
Параметры:
1033
  * eax = 18 - номер функции
1034
  * ebx = 22 - номер подфункции
641 diamond 1035
  * ecx = тип операции:
1036
    * 0 = минимизация окна, поток задан номером слота
1037
    * 1 = минимизация окна, поток задан идентификатором
1038
    * 2 = восстановление окна, поток задан номером слота
1039
    * 3 = восстановление окна, поток задан идентификатором
1040
  * edx = параметр операции (номер слота или PID/TID)
608 alver 1041
Возвращаемое значение:
641 diamond 1042
  * eax = 0 - успешно
1043
  * eax = -1 - ошибка (неправильный параметр)
1044
Замечания:
1045
  * Поток может свернуть своё окно вызовом подфункции 10.
1046
  * Восстановление окна с одновременной активизацией осуществляется
1047
    подфункции 3 (принимающей номер слота).
608 alver 1048
 
1049
======================================================================
77 diamond 1050
==================== Функция 20 - интерфейс MIDI. ====================
1051
======================================================================
1052
 
1053
------------------------ Подфункция 1 - сброс ------------------------
1054
Параметры:
1055
  * eax = 20 - номер функции
1056
  * ebx = 1 - номер подфункции
1057
 
1058
-------------------- Подфункция 2 - вывести байт ---------------------
1059
Параметры:
1060
  * eax = 20 - номер функции
1061
  * ebx = 2 - номер подфункции
1062
  * cl = байт для вывода
1063
Возвращаемое значение (одинаково для обеих подфункций):
1064
  * eax = 0 - успешно
131 diamond 1065
  * eax = 1 - не определён базовый порт
77 diamond 1066
Замечания:
802 serge 1067
  * Предварительно должен быть определён базовый порт вызовом
77 diamond 1068
    подфункции 1 функции 21.
1069
 
1070
======================================================================
1071
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
1072
======================================================================
1073
Параметры:
1074
  * eax = 21 - номер функции
1075
  * ebx = 1 - номер подфункции
1076
  * ecx = номер базового порта
1077
Возвращаемое значение:
1078
  * eax = 0 - успешно
1079
  * eax = -1 - ошибочный номер порта
1080
Замечания:
1081
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1082
  * Установка базы нужна для работы функции 20.
802 serge 1083
  * Получить установленный базовый порт можно вызовом
77 diamond 1084
    подфункции 1 функции 26.
1085
 
1086
======================================================================
1087
===== Функция 21, подфункция 2 - установить раскладку клавиатуры. ====
1088
======================================================================
1089
Раскладка клавиатуры используется для преобразования сканкодов,
1090
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1091
Параметры:
1092
  * eax = 21 - номер функции
1093
  * ebx = 2 - номер подфункции
1094
  * ecx = какую раскладку устанавливать:
1095
    * 1 = нормальную
1096
    * 2 = раскладку при нажатом Shift
1097
    * 3 = раскладку при нажатом Alt
1098
  * edx = указатель на раскладку - таблицу длиной 128 байт
1099
Или:
1100
  * ecx = 9
1101
  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1102
Возвращаемое значение:
1103
  * eax = 0 - успешно
1104
  * eax = 1 - параметр задан неверно
1105
Замечания:
1106
  * Если нажат Alt, то используется раскладка с Alt;
1107
    если не нажат Alt, но нажат Shift, то
1108
    используется раскладка с Shift;
1109
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1110
    нормальная раскладка, после чего из кода вычитается 0x60;
1111
    если не нажата ни одна из управляющих клавиш, то используется
1112
    нормальная раскладка.
802 serge 1113
  * Получить раскладки и идентификатор страны можно с помощью
77 diamond 1114
    подфункции 2 функции 26.
1115
  * Идентификатор страны - глобальная системная переменная, которая
1116
    самим ядром не используется; однако приложение @panel отображает
1117
    соответствующую текущей стране иконку.
1118
  * Приложение @panel переключает раскладки по запросу пользователя.
1119
 
1120
======================================================================
1121
=========== Функция 21, подфункция 3 - установить базу CD. ===========
1122
======================================================================
1123
Параметры:
1124
  * eax = 21 - номер функции
1125
  * ebx = 3 - номер подфункции
1126
  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1127
Возвращаемое значение:
1128
  * eax = 0
1129
Замечания:
1130
  * База CD используется функцией 24.
802 serge 1131
  * Получить установленную базу CD можно вызовом
77 diamond 1132
    подфункции 3 функции 26.
1133
 
1134
======================================================================
1135
== Функция 21, подфункция 4 - установить базовый порт Sound Blaster. =
1136
======================================================================
802 serge 1137
Удалена
77 diamond 1138
 
1139
======================================================================
1140
========= Функция 21, подфункция 5 - установить язык системы. ========
1141
======================================================================
1142
Параметры:
1143
  * eax = 21 - номер функции
1144
  * ebx = 5 - номер подфункции
1145
  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1146
Возвращаемое значение:
1147
  * eax = 0
1148
Замечания:
1149
  * Язык системы - глобальная системная переменная, никак
1150
    не используемая самим ядром, однако приложение @panel рисует
1151
    соответствующую иконку.
1152
  * Проверок на корректность не делается, поскольку ядро эту
1153
    переменную не использует.
1154
  * Получить язык системы можно вызовом подфункции 5 функции 26.
1155
 
1156
======================================================================
1157
=========== Функция 21, подфункция 7 - установить базу HD. ===========
1158
======================================================================
131 diamond 1159
База HD нужна для определения, на какой жёсткий диск писать, при
346 diamond 1160
использовании устаревшего синтаксиса /HD в устаревшей функции 58;
1161
при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
1162
база устанавливается автоматически.
77 diamond 1163
Параметры:
1164
  * eax = 21 - номер функции
1165
  * ebx = 7 - номер подфункции
1166
  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1167
Возвращаемое значение:
1168
  * eax = 0
1169
Замечания:
1170
  * Любое приложение в любой момент времени может изменить базу.
1171
  * Не следует изменять базу, когда какое-нибудь приложение работает
131 diamond 1172
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1173
  * Получить установленную базу можно вызовом подфункции 7 функции 26.
802 serge 1174
  * Следует также определить используемый раздел жёсткого диска
77 diamond 1175
    подфункцией 8.
1176
 
1177
======================================================================
1178
========== Функция 21, подфункция 8 - установить раздел HD. ==========
1179
======================================================================
131 diamond 1180
Раздел HD нужен для определения, на какой раздел жёсткого диска
346 diamond 1181
писать, при использовании устаревшего синтаксиса /HD в устаревшей
1182
функции 58; при использовании современного синтаксиса
1183
/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
77 diamond 1184
Параметры:
1185
  * eax = 21 - номер функции
1186
  * ebx = 8 - номер подфункции
1187
  * ecx = раздел HD (считая с 1)
1188
Возвращаемое значение:
1189
  * eax = 0
1190
Замечания:
1191
  * Любое приложение в любой момент времени может изменить раздел.
1192
  * Не следует изменять раздел, когда какое-нибудь приложение работает
131 diamond 1193
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1194
  * Получить установленный раздел можно вызовом подфункции 8
1195
    функции 26.
1196
  * Проверок на корректность не делается.
802 serge 1197
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1198
    подфункции 11 функции 18.
802 serge 1199
  * Следует также определить используемую базу жёсткого диска
77 diamond 1200
    подфункцией 7.
1201
 
1202
======================================================================
1203
===== Функция 21, подфункция 10 - установить канал DMA для звука. ====
1204
======================================================================
802 serge 1205
Удалена:
77 diamond 1206
 
1207
======================================================================
1208
====================== Функция 21, подфункция 11 =====================
1209
=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
1210
======================================================================
1211
Параметры:
1212
  * eax = 21 - номер функции
1213
  * ebx = 11 - номер подфункции
1214
  * ecx = 0/1 - запретить/разрешить
1215
Возвращаемое значение:
1216
  * eax = 0
1217
Замечания:
1218
  * Используется при LBA-чтении (подфункция 8 функции 58).
1219
  * Текущая реализация использует только младший бит ecx.
1220
  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
1221
 
1222
======================================================================
1223
====================== Функция 21, подфункция 12 =====================
1224
========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
1225
======================================================================
1226
Параметры:
1227
  * eax = 21 - номер функции
1228
  * ebx = 12 - номер подфункции
1229
  * ecx = 0/1 - запретить/разрешить
1230
Возвращаемое значение:
1231
  * eax = 0
1232
Замечания:
1233
  * Используется при работе с шиной PCI (функция 62).
1234
  * Текущая реализация использует только младший бит ecx.
1235
  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
1236
 
1237
======================================================================
1238
============= Функция 21, подфункция 13, подподфункция 1 =============
1239
==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
1240
======================================================================
1241
Параметры:
1242
  * eax = 21 - номер функции
1243
  * ebx = 13 - номер подфункции
1244
  * ecx = 1 - номер функции драйвера
1245
  * edx = указатель на буфер размера 512 байт
1246
Возвращаемое значение:
1247
  * если драйвер не загружен (никогда не бывает в текущей реализации):
1248
    * eax = -1
1249
    * ebx, ecx разрушаются
1250
  * если драйвер загружен:
1251
    * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт,
1252
      'Z' - старший) - сигнатура
131 diamond 1253
    * ebx = текущая частота развёртки (в Гц)
77 diamond 1254
    * ecx разрушается
1255
    * буфер, на который указывает edx, заполнен
1256
Формат буфера:
1257
  * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек,
1258
    дополнено пробелами)
1259
  * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как
1260
    y*65536+x), для текущей реализации 1 (1.0)
1261
  * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
1262
  * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое
1263
    слово - номер видеорежима, после собственно списка идут нули)
131 diamond 1264
  * +128 = +0x80: 32*(5*word): список поддерживаемых частот развёрток
77 diamond 1265
    для видеорежимов: для каждого видеорежима, указанного в предыдущем
1266
    поле, указано до 5 поддерживаемых частот
1267
    (в неиспользуемых позициях записаны нули)
1268
Замечания:
131 diamond 1269
  * Функция инициализирует драйвер (если он ещё не инициализирован)
77 diamond 1270
    и должна вызываться первой, перед остальными (иначе они будут
1271
    возвращать -1, ничего не делая).
131 diamond 1272
  * В текущей реализации поддерживается только одна частота развёртки
77 diamond 1273
    на видеорежим.
1274
 
1275
======================================================================
1276
============= Функция 21, подфункция 13, подподфункция 2 =============
1277
============= Получить информацию о текущем видеорежиме. =============
1278
======================================================================
1279
Параметры:
1280
  * eax = 21 - номер функции
1281
  * ebx = 13 - номер подфункции
1282
  * ecx = 2 - номер функции драйвера
1283
Возвращаемое значение:
1284
  * eax = -1 - драйвер не загружен или не инициализирован;
1285
    ebx,ecx разрушаются
1286
  * eax = [ширина]*65536 + [высота]
131 diamond 1287
  * ebx = частота вертикальной развёртки (в Гц)
77 diamond 1288
  * ecx = номер текущего видеорежима
1289
Замечания:
802 serge 1290
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1291
    функции драйвера 1.
1292
  * Если нужны только размеры экрана, целесообразней использовать
131 diamond 1293
    функцию 14 с учётом того, что она возвращает размеры на 1 меньше.
77 diamond 1294
 
1295
======================================================================
802 serge 1296
= Функция 21, подфункция 13, подподфункция 3 - установить видеорежим.
77 diamond 1297
======================================================================
1298
Параметры:
1299
  * eax = 21 - номер функции
1300
  * ebx = 13 - номер подфункции
1301
  * ecx = 3 - номер функции драйвера
131 diamond 1302
  * edx = [частота развёртки]*65536 + [номер видеорежима]
77 diamond 1303
Возвращаемое значение:
1304
  * eax = -1 - драйвер не загружен, не инициализирован или
1305
    произошла ошибка
1306
  * eax = 0 - успешно
1307
  * ebx, ecx разрушаются
1308
Замечания:
802 serge 1309
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1310
    функции драйвера 1.
1311
  * Номер видеорежима и частота должны быть в таблице, возвращаемой
1312
    функцией драйвера 1.
1313
 
1314
======================================================================
1315
============= Функция 21, подфункция 13, подподфункция 4 =============
1316
================= Вернуться к начальному видеорежиму. ================
1317
======================================================================
1318
Возвращает экран в видеорежим, установленный при загрузке системы.
1319
Параметры:
1320
  * eax = 21 - номер функции
1321
  * ebx = 13 - номер подфункции
1322
  * ecx = 4 - номер функции драйвера
1323
Возвращаемое значение:
1324
  * eax = -1 - драйвер не загружен или не инициализирован
1325
  * eax = 0 - успешно
1326
  * ebx, ecx разрушаются
1327
Замечания:
802 serge 1328
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1329
    функции драйвера 1.
1330
 
1331
======================================================================
1332
============= Функция 21, подфункция 13, подподфункция 5 =============
1333
======== Увеличить/уменьшить размер видимой области монитора. ========
1334
======================================================================
1335
Параметры:
1336
  * eax = 21 - номер функции
1337
  * ebx = 13 - номер подфункции
1338
  * ecx = 5 - номер функции драйвера
1339
  * edx = 0/1 - уменьшить/увеличить размер по горизонтали
1340
    на одну позицию
1341
  * edx = 2/3 - в текущей реализации не поддерживается; планируется
1342
    как уменьшение/увеличение размера по вертикали на одну позицию
1343
Возвращаемое значение:
1344
  * eax = -1 - драйвер не загружен или не инициализирован
1345
  * eax = 0 - успешно
1346
  * ebx, ecx разрушаются
1347
Замечания:
802 serge 1348
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1349
    функции драйвера 1.
1350
  * Функция влияет только на физический размер изображения
1351
    на мониторе; логический размер (число пикселей) не меняется.
1352
 
1353
======================================================================
1354
============ Функция 22 - установить системную дату/время. ===========
1355
======================================================================
1356
Параметры:
1357
  * eax = 22 - номер функции
1358
  * ebx = 0 - установить время
1359
    * ecx = 0x00SSMMHH - время в двоично-десятичном коде (BCD):
1360
    * HH=час 00..23
1361
    * MM=минута 00..59
1362
    * SS=секунда 00..59
1363
  * ebx = 1 - установить дату
1364
    * ecx = 0x00DDMMYY - дата в двоично-десятичном коде (BCD):
1365
    * DD=день 01..31
1366
    * MM=месяц 01..12
1367
    * YY=год 00..99
1368
  * ebx = 2 - установить день недели
1369
    * ecx = 1 для воскресенья, ..., 7 для субботы
1370
  * ebx = 3 - установить будильник
1371
    * ecx = 0x00SSMMHH
1372
Возвращаемое значение:
1373
  * eax = 0 - успешно
1374
  * eax = 1 - параметр задан неверно
1375
  * eax = 2 - CMOS-батарейки разрядились
1376
Замечания:
1377
  * Ценность установки дня недели представляется сомнительной,
1378
    поскольку он мало где используется
1379
    (день недели можно рассчитать по дате).
1380
  * Будильник можно установить на срабатывание в заданное время
1381
    каждые сутки. При этом отключить его существующими системными
1382
    функциями нельзя.
1383
  * Срабатывание будильника заключается в генерации IRQ8.
1384
  * Вообще-то CMOS поддерживает для будильника установку значения
1385
    0xFF в качестве одного из параметров и означает это, что
1386
    соответствующий параметр игнорируется. Но в текущей реализации
131 diamond 1387
    это не пройдёт (вернётся значение 1).
77 diamond 1388
  * Будильник - глобальный системный ресурс; установка будильника
1389
    автоматически отменяет предыдущую установку. Впрочем, на данный
1390
    момент ни одна программа его не использует.
1391
 
1392
======================================================================
1393
============== Функция 23 - ожидать события с таймаутом. =============
1394
======================================================================
131 diamond 1395
Если очередь сообщений пуста, ждёт появления сообщения в очереди,
77 diamond 1396
но не более указанного времени. Затем считывает сообщение из очереди.
1397
 
1398
Параметры:
1399
  * eax = 23 - номер функции
1400
  * ebx = таймаут (в сотых долях секунды)
1401
Возвращаемое значение:
1402
  * eax = 0 - очередь сообщений пуста
1403
  * иначе eax = событие (смотри список событий)
1404
Замечания:
1405
  * Учитываются только те события, которые входят в маску,
1406
    устанавливаемую функцией 40. По умолчанию это события
1407
    перерисовки, нажатия на клавиши и на кнопки.
1408
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
1409
    Чтобы ждать сколь угодно долго, используйте функцию 10.
1410
  * Передача ebx=0 приводит к моментальному возвращению eax=0.
131 diamond 1411
  * При текущей реализации произойдёт немедленный возврат из функции
1412
    с eax=0, если сложение ebx с текущим значением счётчика времени
77 diamond 1413
    вызовет 32-битное переполнение.
1414
 
1415
======================================================================
1416
======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ======
1417
======================================================================
1418
Параметры:
1419
  * eax = 24 - номер функции
1420
  * ebx = 1 - номер подфункции
1421
  * ecx = 0x00FRSSMM, где
1422
    * MM = начальная минута
1423
    * SS = начальная секунда
1424
    * FR = начальный фрейм
1425
Возвращаемое значение:
1426
  * eax = 0 - успешно
1427
  * eax = 1 - не определена база CD
1428
Замечания:
802 serge 1429
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1430
    подфункции 3 функции 21.
1431
  * В секунде 75 фреймов, в минуте 60 секунд.
1432
  * Функция асинхронна (возвращает управление, когда началось
1433
    проигрывание).
1434
 
1435
======================================================================
1436
===== Функция 24, подфункция 2 - получить информацию о дорожках. =====
1437
======================================================================
1438
Параметры:
1439
  * eax = 24 - номер функции
1440
  * ebx = 2 - номер подфункции
1441
  * ecx = указатель на буфер для таблицы
1442
    (максимум 8*64h+4 байт=100 дорожек)
1443
Возвращаемое значение:
1444
  * eax = 0 - успешно
1445
  * eax = 1 - не определена база CD
1446
Замечания:
1447
  * Формат таблицы с информацией о дорожках такой же, как и для
1448
    ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h).
1449
    Адреса возвращаются в формате MSF.
802 serge 1450
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1451
    подфункции 3 функции 21.
1452
  * Функция возвращает информацию только о не более чем 100
1453
    первых дорожках. В большинстве случаев этого достаточно.
1454
 
1455
======================================================================
1456
==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. ===
1457
======================================================================
1458
Параметры:
1459
  * eax = 24 - номер функции
1460
  * ebx = 1 - номер подфункции
1461
Возвращаемое значение:
1462
  * eax = 0 - успешно
1463
  * eax = 1 - не определена база CD
1464
Замечания:
802 serge 1465
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1466
    подфункции 3 функции 21.
1467
 
1468
======================================================================
641 diamond 1469
======= Функция 24, подфункция 4 - извлечь лоток привода диска. ======
588 diamond 1470
======================================================================
1471
Параметры:
1472
  * eax = 24 - номер функции
1473
  * ebx = 4 - номер подфункции
641 diamond 1474
  * ecx = номер CD/DVD-диска
1475
      (от 0=Primary Master до 3=Secondary Slave)
588 diamond 1476
Возвращаемое значение:
641 diamond 1477
  * функция не возвращает значения
588 diamond 1478
Замечания:
641 diamond 1479
  * Функция поддерживается только для ATAPI-устройств (CD и DVD).
1480
  * При извлечении лотка производится разблокировка ручного управления
1481
    механизмом лотка.
1482
  * При извлечении лотка код производит очистку кэша соответствующего
1483
    устройства.
588 diamond 1484
  * Примером использования функции является приложение CD_tray.
1485
 
1486
======================================================================
641 diamond 1487
====== Функция 24, подфункция 5 - загрузить лоток привода диска. =====
588 diamond 1488
======================================================================
1489
Параметры:
1490
  * eax = 24 - номер функции
1491
  * ebx = 5 - номер подфункции
641 diamond 1492
  * ecx = номер CD/DVD-диска
1493
      (от 0=Primary Master до 3=Secondary Slave)
588 diamond 1494
Возвращаемое значение:
641 diamond 1495
  * функция не возвращает значения
588 diamond 1496
Замечания:
641 diamond 1497
  * Функция поддерживается только для ATAPI-устройств (CD и DVD).
588 diamond 1498
  * Примером использования функции является приложение CD_tray.
1499
 
1500
======================================================================
77 diamond 1501
============== Функция 25 - установить громкость SBPro. ==============
1502
======================================================================
802 serge 1503
Удалена
77 diamond 1504
 
1505
======================================================================
1506
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
1507
======================================================================
1508
Параметры:
1509
  * eax = 26 - номер функции
1510
  * ebx = 1 - номер подфункции
1511
Возвращаемое значение:
1512
  * eax = номер порта
1513
Замечания:
802 serge 1514
  * Установить базовый порт можно вызовом
77 diamond 1515
    подфункции 1 функции 21.
1516
 
1517
======================================================================
1518
====== Функция 26, подфункция 2 - получить раскладку клавиатуры. =====
1519
======================================================================
1520
Раскладка клавиатуры используется для преобразования сканкодов,
1521
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1522
Параметры:
1523
  * eax = 26 - номер функции
1524
  * ebx = 2 - номер подфункции
1525
  * ecx = какую раскладку получать:
1526
    * 1 = нормальную
1527
    * 2 = раскладку при нажатом Shift
1528
    * 3 = раскладку при нажатом Alt
1529
  * edx = указатель на буфер длиной 128 байт, куда будет скопирована
1530
    раскладка
1531
Возвращаемое значение:
1532
  * функция не возвращает значения
1533
Или:
1534
  * eax = 26 - номер функции
1535
  * ebx = 2 - номер подфункции
1536
  * ecx = 9
1537
Возвращаемое значение:
1538
  * eax = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1539
Замечания:
1540
  * Если нажат Alt, то используется раскладка с Alt;
1541
    если не нажат Alt, но нажат Shift, то используется
1542
    раскладка с Shift;
1543
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1544
    нормальная раскладка, после чего из кода вычитается 0x60;
1545
    если не нажата ни одна из управляющих клавиш, то используется
1546
    нормальная раскладка.
802 serge 1547
  * Установить раскладки и идентификатор страны можно с помощью
77 diamond 1548
    подфункции 2 функции 21.
1549
  * Идентификатор страны - глобальная системная переменная, которая
1550
    самим ядром не используется; однако приложение @panel отображает
1551
    соответствующую текущей стране иконку
1552
    (используя описываемую функцию).
1553
  * Приложение @panel переключает раскладки по запросу пользователя.
1554
 
1555
======================================================================
1556
============ Функция 26, подфункция 3 - получить базу CD. ============
1557
======================================================================
1558
Параметры:
1559
  * eax = 26 - номер функции
1560
  * ebx = 3 - номер подфункции
1561
Возвращаемое значение:
1562
  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1563
Замечания:
1564
  * База CD используется функцией 24.
114 mikedld 1565
  * Установить базу CD можно вызовом подфункции 3 функции 21.
77 diamond 1566
 
1567
======================================================================
1568
=== Функция 26, подфункция 4 - получить базовый порт Sound Blaster. ==
1569
======================================================================
802 serge 1570
Удалена
77 diamond 1571
 
1572
======================================================================
1573
========== Функция 26, подфункция 5 - получить язык системы. =========
1574
======================================================================
1575
Параметры:
1576
  * eax = 26 - номер функции
1577
  * ebx = 5 - номер подфункции
1578
Возвращаемое значение:
1579
  * eax = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1580
Замечания:
1581
  * Язык системы - глобальная системная переменная, никак
1582
    не используемая самим ядром, однако приложение @panel рисует
1583
    соответствующую иконку (используя описываемую функцию).
1584
  * Установить язык системы можно вызовом подфункции 5 функции 21.
1585
 
1586
======================================================================
1587
============ Функция 26, подфункция 7 - получить базу HD. ============
1588
======================================================================
131 diamond 1589
База HD нужна для определения, на какой жёсткий диск писать, при
346 diamond 1590
использовании устаревшего синтаксиса /HD в устаревшей функции 58;
1591
при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
1592
база устанавливается автоматически.
77 diamond 1593
Параметры:
1594
  * eax = 26 - номер функции
1595
  * ebx = 7 - номер подфункции
1596
Возвращаемое значение:
1597
  * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1598
Замечания:
1599
  * Любое приложение в любой момент времени может изменить базу.
1600
  * Установить базу можно вызовом подфункции 7 функции 21.
131 diamond 1601
  * Получить используемый раздел жёсткого диска можно подфункцией 8.
77 diamond 1602
 
1603
======================================================================
1604
=========== Функция 26, подфункция 8 - получить раздел HD. ===========
1605
======================================================================
131 diamond 1606
Раздел HD нужен для определения, на какой раздел жёсткого диска
346 diamond 1607
писать, при использовании устаревшего синтаксиса /HD в устаревшей
1608
функции 58; при использовании современного синтаксиса
1609
/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
77 diamond 1610
Параметры:
1611
  * eax = 26 - номер функции
1612
  * ebx = 8 - номер подфункции
1613
Возвращаемое значение:
1614
  * eax = раздел HD (считая с 1)
1615
Замечания:
1616
  * Любое приложение в любой момент времени может изменить раздел.
1617
  * Установить раздел можно вызовом подфункции 8 функции 21.
131 diamond 1618
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1619
    подфункции 11 функции 18.
131 diamond 1620
  * Получить используемую базу жёсткого диска можно подфункцией 7.
77 diamond 1621
 
1622
======================================================================
131 diamond 1623
=== Функция 26, подфункция 9 - получить значение счётчика времени. ===
77 diamond 1624
======================================================================
1625
Параметры:
1626
  * eax = 26 - номер функции
1627
  * ebx = 9 - номер подфункции
1628
Возвращаемое значение:
1629
  * eax = число сотых долей секунды, прошедших с момента
1630
    запуска системы
1631
Замечания:
131 diamond 1632
  * Счётчик берётся по модулю 2^32, что соответствует немногим более
77 diamond 1633
    497 суток.
1634
  * Системное время можно получить функцией 3.
1635
 
1636
======================================================================
1637
====== Функция 26, подфункция 10 - получить канал DMA для звука. =====
1638
======================================================================
802 serge 1639
Удалена
77 diamond 1640
 
1641
======================================================================
1642
====================== Функция 26, подфункция 11 =====================
131 diamond 1643
=========== Узнать, разрешён ли низкоуровневый доступ к HD. ==========
77 diamond 1644
======================================================================
1645
Параметры:
1646
  * eax = 26 - номер функции
1647
  * ebx = 11 - номер подфункции
1648
Возвращаемое значение:
131 diamond 1649
  * eax = 0/1 - запрещён/разрешён
77 diamond 1650
Замечания:
1651
  * Используется при LBA-чтении (подфункция 8 функции 58).
802 serge 1652
  * Установить текущее состояние можно вызовом
77 diamond 1653
    подфункции 11 функции 21.
1654
 
1655
======================================================================
1656
====================== Функция 26, подфункция 12 =====================
131 diamond 1657
========== Узнать, разрешён ли низкоуровневый доступ к PCI. ==========
77 diamond 1658
======================================================================
1659
Параметры:
1660
  * eax = 26 - номер функции
1661
  * ebx = 12 - номер подфункции
1662
Возвращаемое значение:
131 diamond 1663
  * eax = 0/1 - запрещён/разрешён
77 diamond 1664
Замечания:
1665
  * Используется при работе с шиной PCI (функция 62).
1666
  * Текущая реализация использует только младший бит ecx.
802 serge 1667
  * Установить текущее состояние можно вызовом
77 diamond 1668
    подфункции 12 функции 21.
1669
 
1670
======================================================================
1671
=============== Функция 28 - установить громкость SB16. ==============
1672
======================================================================
802 serge 1673
Удалена
77 diamond 1674
 
1675
======================================================================
1676
================ Функция 29 - получить системную дату. ===============
1677
======================================================================
1678
Параметры:
1679
  * eax = 29 - номер функции
1680
Возвращаемое значение:
1681
  * eax = 0x00DDMMYY, где
1682
    (используется двоично-десятичное кодирование, BCD)
1683
  * YY = две младшие цифры года (00..99)
1684
  * MM = месяц (01..12)
1685
  * DD = день (01..31)
1686
Замечания:
1687
  * Системную дату можно установить функцией 22.
1688
 
1689
======================================================================
521 diamond 1690
================ Функция 30 - работа с текущей папкой. ===============
1691
======================================================================
1692
 
1693
-------- Подфункция 1 - установить текущую папку для потока. ---------
1694
Параметры:
1695
  * eax = 30 - номер функции
1696
  * ebx = 1 - номер подфункции
1697
  * ecx = указатель на ASCIIZ-строку с путём к новой текущей папке
1698
Возвращаемое значение:
1699
  * функция не возвращает значения
1700
 
1701
--------- Подфункция 2 - получить текущую папку для потока. ----------
1702
Параметры:
1703
  * eax = 30 - номер функции
1704
  * ebx = 2 - номер подфункции
1705
  * ecx = указатель на буфер
1706
  * edx = размер буфера
1707
Возвращаемое значение:
1708
  * eax = длина имени текущей папки (включая завершающий 0)
1709
Замечания:
1710
  * Если размера буфера недостаточно для копирования всего имени,
1711
    копируются только первые (edx-1) байт
1712
    и в конце ставится завершающий 0.
1713
 
1714
======================================================================
77 diamond 1715
============ Функция 35 - прочитать цвет точки на экране. ============
1716
======================================================================
1717
Параметры:
1718
  * eax = 35
1719
  * ebx = y*xsize+x, где
1720
  * (x,y) = координаты точки (считая от 0)
1721
  * xsize = размер экрана по горизонтали
1722
Возвращаемое значение:
1723
  * eax = цвет 0x00RRGGBB
1724
Замечания:
1725
  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
1726
    что она вычитает 1 из обоих размеров.
1727
  * К видеопамяти есть также прямой доступ (без вызовов системных
1728
    функций) через селектор gs. Параметры текущего видеорежима
1729
    можно получить функцией 61.
1730
 
1731
======================================================================
921 mario79 1732
=============== Функция 36 - прочитать область экрана. ==============
1733
======================================================================
1734
Параметры:
1735
  * eax = 36 - номер функции
1736
  * ebx = указатель на предварительно выделенную область памяти,
1737
             куда будет помещено изображение в формате BBGGRRBBGGRR...
1738
  * ecx = [размер по оси x]*65536 + [размер по оси y]
1739
  * edx = [координата по оси x]*65536 + [координата по оси y]
1740
Возвращаемое значение:
1741
  * функция не возвращает значения
1742
Замечания:
1743
  * Координаты изображения - это координаты верхнего левого угла
1744
    изображения относительно окна.
1745
  * Размер изображения в байтах есть 3*xsize*ysize.
1746
 
1747
======================================================================
277 diamond 1748
==================== Функция 37 - работа с мышью. ====================
77 diamond 1749
======================================================================
1750
 
1751
-------------- Подфункция 0 - экранные координаты мыши ---------------
1752
Параметры:
1753
  * eax = 37 - номер функции
1754
  * ebx = 0 - номер подфункции
1755
Возвращаемое значение:
1756
  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
1757
 
1758
---------- Подфункция 1 - координаты мыши относительно окна ----------
1759
Параметры:
1760
  * eax = 37 - номер функции
1761
  * ebx = 1 - номер подфункции
1762
Возвращаемое значение:
1763
  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
1764
    окна приложения (считая от 0)
1765
Замечания:
1766
  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
1767
    Если y>=ywnd, то младшее слово неотрицательно и содержит
1768
    относительную y-координату, а старшее - относительную x-координату
1769
    (правильного знака). В противном случае младшее слово отрицательно
131 diamond 1770
    и всё равно содержит относительную y-координату,
77 diamond 1771
    а к старшему слову следует прибавить 1.
1772
 
1773
----------------- Подфункция 2 - нажатые кнопки мыши -----------------
1774
Параметры:
1775
  * eax = 37 - номер функции
1776
  * ebx = 2 - номер подфункции
1777
Возвращаемое значение:
1778
  * eax содержит информацию о нажатых кнопках мыши:
1779
  * бит 0 установлен = левая кнопка нажата
1780
  * бит 1 установлен = правая кнопка нажата
486 kastigar 1781
  * бит 2 установлен = средняя кнопка нажата
1782
  * бит 3 установлен = 4-я кнопка нажата
1783
  * бит 4 установлен = 5-я кнопка нажата
77 diamond 1784
  * прочие биты сброшены
1785
 
277 diamond 1786
------------------ Подфункция 4 - загрузить курсор -------------------
221 serge 1787
Параметры:
1788
  * eax = 37 - номер функции
1789
  * ebx = 4 - номер подфункции
277 diamond 1790
  * dx = источник данных:
1791
  * dx = LOAD_FROM_FILE = 0 - данные в файле
1792
    * ecx = указатель на полный путь к файлу курсора
1793
    * файл курсора должен быть в формате .cur, стандартном для
1794
      MS Windows, причём размером 32*32 пикселя
1795
  * dx = LOAD_FROM_MEM = 1 - данные файла уже загружены в память
1796
    * ecx = указатель на данные файла курсора
1797
    * формат данных такой же, как и в предыдущем случае
1798
  * dx = LOAD_INDIRECT = 2 - данные в памяти
1799
    * ecx = указатель на образ курсора в формате ARGB 32*32 пикселя
1800
    * edx = 0xXXYY0002, где
1801
      * XX = x-координата "горячей точки" курсора
1802
      * YY = y-координата
1803
      * 0 <= XX, YY <= 31
221 serge 1804
Возвращаемое значение:
277 diamond 1805
  * eax = 0 - неудача
1806
  * иначе eax = хэндл курсора
221 serge 1807
 
277 diamond 1808
------------------ Подфункция 5 - установить курсор ------------------
1809
Устанавливает новый курсор для окна текущего потока.
221 serge 1810
Параметры:
1811
  * eax = 37 - номер функции
1812
  * ebx = 5 - номер подфункции
277 diamond 1813
  * ecx = хэндл курсора
221 serge 1814
Возвращаемое значение:
277 diamond 1815
  * eax = хэндл предыдущего установленного курсора
1816
Замечания:
1817
  * Если передан некорректный хэндл, то функция восстановит курсор
1818
    по умолчанию (стандартную стрелку). В частности, к восстановлению
1819
    курсора по умолчанию приводит передача ecx=0.
221 serge 1820
 
277 diamond 1821
------------------- Подфункция 6 - удалить курсор --------------------
221 serge 1822
Параметры:
1823
  * eax = 37 - номер функции
1824
  * ebx = 6 - номер подфункции
277 diamond 1825
  * ecx = хэндл курсора
221 serge 1826
Возвращаемое значение:
277 diamond 1827
  * eax разрушается
1828
Замечания:
1829
  * Курсор должен был быть ранее загружен текущим потоком
1830
    (вызовом подфункции 4). Функция не удаляет системные курсоры и
1831
    курсоры, загруженные другими приложениями.
1832
  * Если удаляется активный (установленный подфункцией 5) курсор, то
1833
    восстанавливается курсор по умолчанию (стандартная стрелка).
221 serge 1834
 
499 diamond 1835
------------------ Подфункция 7 - данные прокрутки -------------------
486 kastigar 1836
Параметры:
1837
  * eax = 37 - номер функции
499 diamond 1838
  * ebx = 6 - номер подфункции
486 kastigar 1839
Возвращаемое значение:
499 diamond 1840
  * eax = [horizontal offset]*65536 + [vertical offset]
486 kastigar 1841
Замечания:
499 diamond 1842
  * Данные доступны только активному окну.
1843
  * После прочтения значения обнуляются.
1844
  * Данные имеют знаковые значения.
486 kastigar 1845
 
77 diamond 1846
======================================================================
1847
================== Функция 38 - нарисовать отрезок. ==================
1848
======================================================================
1849
Параметры:
1850
  * eax = 38 - номер функции
1851
  * ebx = [координата начала по оси x]*65536 +
1852
              [координата конца по оси x]
1853
  * ecx = [координата начала по оси y]*65536 +
1854
              [координата конца по оси y]
1855
  * edx = 0x00RRGGBB - цвет
133 diamond 1856
    edx = 0x01xxxxxx - рисовать инверсный отрезок
1857
          (младшие 24 бита игнорируются)
77 diamond 1858
Возвращаемое значение:
1859
  * функция не возвращает значения
1860
Замечания:
1861
  * Координаты берутся относительно окна.
1862
  * Конечная точка также рисуется.
1863
 
1864
======================================================================
1865
== Функция 39, подфункция 1 - получить размер фонового изображения. ==
1866
======================================================================
1867
Параметры:
1868
  * eax = 39 - номер функции
1869
  * ebx = 1 - номер подфункции
1870
Возвращаемое значение:
1871
  * eax = [ширина]*65536 + [высота]
1872
Замечания:
802 serge 1873
  * Есть парная команда установки размеров фонового изображения -
77 diamond 1874
    подфункция 1 функции 15. После которой, разумеется, следует
1875
    заново определить само изображение.
1876
 
1877
======================================================================
1878
= Функция 39, подфункция 2 - прочитать точку с фонового изображения. =
1879
======================================================================
1880
Параметры:
1881
  * eax = 39 - номер функции
1882
  * ebx = 2 - номер подфункции
1883
  * ecx = смещение
1884
Возвращаемое значение:
1885
  * eax = 0x00RRGGBB - цвет точки, если смещение допустимо
1886
    (меньше 0x160000-16)
1887
  * eax = 2 - иначе
1888
Замечания:
1889
  * Не следует полагаться на возвращаемое значение в случае неверного
1890
    смещения, оно может измениться в следующих версиях ядра.
1891
  * Смещение точки с координатами (x,y) вычисляется как (x+y*xsize)*3.
802 serge 1892
  * Есть парная функция установки точки на фоновом изображении -
77 diamond 1893
    подфункция 2 функции 15.
1894
 
1895
======================================================================
1896
====== Функция 39, подфункция 4 - получить режим отрисовки фона. =====
1897
======================================================================
1898
Параметры:
1899
  * eax = 39 - номер функции
1900
  * ebx = 4 - номер подфункции
1901
Возвращаемое значение:
1902
  * eax = 1 - замостить
1903
  * eax = 2 - растянуть
1904
Замечания:
802 serge 1905
  * Есть парная функция установки режима отрисовки фона -
77 diamond 1906
    подфункция 4 функции 15.
1907
 
1908
======================================================================
1909
======== Функция 40 - установить маску для ожидаемых событий. ========
1910
======================================================================
1911
Маска для ожидаемых событий влияет на функции работы с событиями 10,
131 diamond 1912
11, 23 - они сообщают только о событиях, разрешённых этой маской.
77 diamond 1913
Параметры:
1914
  * eax = 40 - номер функции
1915
  * ebx = маска: бит i соответствует событию i+1 (см. список событий)
1916
    (установленный бит разрешает извещение о событии)
1917
Возвращаемое значение:
1918
  * функция не возвращает значения
1919
Замечания:
1920
  * Маска по умолчанию (7=111b) разрешает извещения о перерисовке
1921
    и нажатиях клавиш и кнопок.
1922
    Этого достаточно для большинства приложений.
131 diamond 1923
  * События, запрещённые в маске, всё равно сохраняются, если
77 diamond 1924
    приходят; о них просто не извещают функции работы с событиями.
1925
  * Функции работы с событиями учитывают маску на момент
1926
    вызова функции, а не на момент поступления сообщения.
1927
 
1928
======================================================================
1929
================= Функция 41 - узнать владельца IRQ. =================
1930
======================================================================
1931
Параметры:
1932
  * eax = 41 - номер функции
1933
  * ebx = номер IRQ, 0..15
1934
Возвращаемое значение:
1935
  * eax = PID владельца
1936
  * eax = 0, если владельца нет
1937
  * eax = -1 для некорректного ebx
1938
 
1939
======================================================================
760 Rus 1940
========== Функция 42 - работа с данными, полученными по IRQ. =======
77 diamond 1941
======================================================================
760 Rus 1942
 
1943
------------------------ Чтение данных -------------------------------
77 diamond 1944
При возникновении IRQ система может считывать данные из указанных
1945
ранее функцией 44 портов и записывать эти данные в буфер.
802 serge 1946
Описываемая функция считывает данные из этого буфера в буфер
760 Rus 1947
указанный в качестве параметра.
77 diamond 1948
Параметры:
1949
  * eax = 42 - номер функции
760 Rus 1950
  * bl  = номер IRQ, 0..15
1951
  * bh = номер подфункции, 0
1952
Остальная часть регистра ebx должна быть обнулена.
1953
  * ecx = указатель на буфер, куда будут приниматься данные
1954
Возвращаемое значение: (ситуацию можно различить по значению eax)
77 diamond 1955
  * если поток не является владельцем IRQ
1956
    (или номер IRQ задан неверно):
760 Rus 1957
    * eax = -1
77 diamond 1958
  * если данных нет:
1959
    * eax = 0
131 diamond 1960
  * если всё в порядке и данные были:
760 Rus 1961
    * eax = размер данных, прочитанных из буфера (в байтах)
1962
 
1963
Смотрите замечания ниже.
1964
 
1965
------------------------ Узнать размер данных в буфере ---------------
1966
Параметры:
1967
  * eax = 42 - номер функции
1968
  * bl  = номер IRQ, 0..15
1969
  * bh = номер подфункции, 1
1970
Остальная часть регистра ebx должна быть обнулена.
1971
Возвращаемое значение: (ситуацию можно различить по значению eax)
1972
  * если поток не является владельцем IRQ
1973
    (или номер IRQ задан неверно):
1974
    * eax = -1
1975
  * если всё в порядке, в eax размер данных
1976
 
77 diamond 1977
Замечания:
1978
  * Предварительно поток должен зарезервировать для себя указанный IRQ
1979
    функцией 45.
1980
  * Размер буфера для данных - 4000 байт, при переполнении
1981
    "свежие" данные перестают записываться в буфер.
1982
 
1983
======================================================================
1984
=================== Функция 43 - ввод/вывод в порт. ==================
1985
======================================================================
1986
 
1987
------------------------ Вывод данных в порт -------------------------
1988
Параметры:
1989
  * eax = 43 - номер функции
1990
  * bl = байт для вывода
1991
  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
1992
Возвращаемое значение:
1993
  * eax = 0 - успешно
1994
  * eax = 1 - поток не зарезервировал указанный порт
1995
 
1996
------------------------ Ввод данных из порта ------------------------
1997
Параметры:
1998
  * eax = 43 - номер функции
1999
  * ebx игнорируется
2000
  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
2001
Возвращаемое значение:
131 diamond 2002
  * eax = 0 - успешно, при этом ebx = введённый байт
77 diamond 2003
  * eax = 1 - поток не зарезервировал данный порт
2004
Замечания:
2005
  * Предварительно поток должен зарезервировать за собой
2006
    указанный порт функцией 46.
2007
  * Для зарезервированных портов вместо вызова этих функций
2008
    лучше использовать команды процессора in/out - это значительно
2009
    быстрее и несколько короче и проще. Из незарезервированных
131 diamond 2010
    портов читать всё равно нельзя.
77 diamond 2011
 
2012
======================================================================
2013
======== Функция 44 - определить действия при поступлении IRQ. =======
2014
======================================================================
2015
При возникновении IRQ система может считывать данные из указанных этой
2016
функцией портов и записывать эти данные в буфер, откуда их можно
2017
прочитать функцией 42.
2018
Параметры:
2019
  * eax = 44 - номер функции
2020
  * ebx = указатель на массив структур, описывающих по одному порту:
2021
    * +0: word: 0 означает конец массива, иначе номер порта
2022
    * +2: byte: зарезервировано (игнорируется)
2023
    * +3: byte: 1=считывать байт из этого порта, 2=считывать слово
2024
  * ecx = номер IRQ, 0..15
2025
Возвращаемое значение:
2026
  * eax = 0 - успешно
2027
  * eax = 1 - поток не является владельцем указанного IRQ
2028
Замечания:
2029
  * Предварительно поток должен зарезервировать за собой
2030
    указываемый IRQ функцией 45.
2031
  * Принимаются во внимание только первые 16 портов.
2032
  * Текущая реализация рассматривает неправильное значение поля +3
2033
    как сигнал прекращения обработки IRQ.
2034
 
2035
======================================================================
2036
============ Функция 45 - зарезервировать/освободить IRQ. ============
2037
======================================================================
2038
Параметры:
2039
  * eax = 45 - номер функции
2040
  * ebx = 0 - зарезервировать, 1 = освободить
2041
  * ecx = номер IRQ, 0..15
2042
Возвращаемое значение:
2043
  * eax = 0 - успешно
2044
  * eax = 1 - ошибка (неверный номер IRQ или
2045
    попытка зарезервировать несвободный IRQ или освободить IRQ, не
2046
    зарезервированный текущим потоком)
2047
Замечания:
2048
  * Резервирование IRQ нужно для работы функций 42 и 44.
2049
  * Только один поток может зарезервировать конкретный IRQ.
2050
  * IRQ, обрабатываемые системой самостоятельно, резервируются
2051
    системой (потоком 1) при загрузке.
2052
  * При завершении потока автоматически освобождаются
2053
    все зарезервированные им IRQ.
2054
 
2055
======================================================================
802 serge 2056
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
77 diamond 2057
======================================================================
2058
К зарезервированным портам можно обращаться напрямую из приложения
2059
командами in/out (рекомендуемый способ) и вызовом функции 43
2060
(нерекомендуемый способ).
2061
Параметры:
2062
  * eax = 46 - номер функции
2063
  * ebx = 0 - зарезервировать, 1 - освободить
2064
  * ecx = номер начала диапазона портов
2065
  * edx = номер конца диапазона портов (включительно)
2066
Возвращаемое значение:
2067
  * eax = 0 - успешно
2068
  * eax = 1 - ошибка
2069
Замечания:
2070
  * В случае резервирования портов ошибкой считается выполнение
2071
    одного из условий:
2072
    * начальный адрес больше конечного;
2073
    * указанный диапазон содержит некорректный номер порта
2074
      (корректные - от 0 до 0xFFFF);
2075
    * превышено ограничение на общее число зарезервированных областей
2076
      - допускается максимум 255;
2077
    * указанный диапазон пересекается с одним из
2078
      ранее зарезервированных
2079
  * В случае освобождения портов ошибкой считается попытка
2080
    освобождения диапазона, который ранее не был целиком
2081
    зарезервирован этой же функцией (с такими же значениями ecx,edx).
2082
  * При обнаружении ошибки (в обоих случаях) никаких действий
2083
    не производится.
277 diamond 2084
  * При загрузке система резервирует за собой порты
2085
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (включительно).
77 diamond 2086
  * При завершении потока автоматически освобождаются все
2087
    зарезервированные им порты.
2088
 
2089
======================================================================
2090
================= Функция 47 - вывести число в окно. =================
2091
======================================================================
2092
Параметры:
2093
  * eax = 47 - номер функции
2094
  * ebx = параметры преобразования числа в текст:
2095
    * bl = 0 - ecx содержит число
665 diamond 2096
    * bl = 1 - ecx содержит указатель на dword/qword-число
77 diamond 2097
    * bh = 0 - отображать в десятичной системе счисления
2098
    * bh = 1 - отображать в шестнадцатеричной системе
2099
    * bh = 2 - отображать в двоичной системе
2100
    * биты 16-21 = сколько цифр отображать
655 mario79 2101
    * биты 22-29 зарезервированы и должны быть установлены в 0
665 diamond 2102
    * бит 30 установлен = выводить qword (64-битное число);
2103
                              при этом должно быть bl = 1
2104
    * бит 31 установлен = не выводить ведущие нули числа
77 diamond 2105
  * ecx = число (при bl=0) или указатель (при bl=1)
2106
  * edx = [координата по оси x]*65536 + [координата по оси y]
142 diamond 2107
  * esi = 0xX0RRGGBB:
2108
    * RR, GG, BB задают цвет
2109
    * X = ABnn (биты)
2110
    * nn = шрифт (0/1)
2111
    * A игнорируется
2112
    * B=1 - закрашивать фон цветом edi
77 diamond 2113
Возвращаемое значение:
2114
  * функция не возвращает значения
2115
Замечания:
2116
  * Указанная длина не должна превосходить 60.
2117
  * Выводится ровно указанное количество цифр. Если число мало и
2118
    может быть записано меньшим количеством цифр, оно дополняется
2119
    ведущими нулями; если число велико и не может быть записано
2120
    таким количеством цифр, "лишние" ведущие цифры обрезаются.
2121
  * Параметры шрифтов указаны в описании функции 4 (вывода текста).
2122
 
2123
======================================================================
2124
======= Функция 48, подфункция 0 - применить настройки экрана. =======
2125
======================================================================
2126
Параметры:
2127
  * eax = 48 - номер функции
2128
  * ebx = 0 - номер подфункции
2129
  * ecx = 0 - зарезервировано
2130
Возвращаемое значение:
2131
  * функция не возвращает значения
2132
Замечания:
2133
  * Функция перерисовывает экран после изменения параметров
2134
    подфункциями 1 и 2.
2135
  * Вызов функции без предшествующих вызовов указанных подфункций
2136
    игнорируется.
2137
  * Вызов функции с ненулевым ecx игнорируется.
2138
 
2139
======================================================================
2140
========= Функция 48, подфункция 1 - установить стиль кнопок. ========
2141
======================================================================
2142
Параметры:
2143
  * eax = 48 - номер функции
2144
  * ebx = 1 - номер подфункции
2145
  * ecx = тип кнопок:
2146
    * 0 = плоские
131 diamond 2147
    * 1 = объёмные
77 diamond 2148
Возвращаемое значение:
2149
  * функция не возвращает значения
2150
Замечания:
802 serge 2151
  * После вызова описываемой функции следует перерисовать экран
77 diamond 2152
    подфункцией 0.
2153
  * Тип кнопок влияет только на их прорисовку функцией 8.
2154
 
2155
======================================================================
2156
==== Функция 48, подфункция 2 - установить стандартные цвета окон. ===
2157
======================================================================
2158
Параметры:
2159
  * eax = 48 - номер функции
2160
  * ebx = 2 - номер подфункции
2161
  * ecx = указатель на таблицу цветов
2162
  * edx = размер таблицы цветов
2163
    (должен быть 40 байт для будущей совместимости)
2164
Формат таблицы цветов указан в описании подфункции 3.
2165
Возвращаемое значение:
2166
  * функция не возвращает значения
2167
Замечания:
802 serge 2168
  * После вызова описываемой функции следует перерисовать экран
77 diamond 2169
    подфункцией 0.
2170
  * Таблица стандартных цветов влияет только на приложения,
2171
    которые эту таблицу явным образом получают (подфункцией 3) и
131 diamond 2172
    используют (указывая цвета из неё при вызовах функций рисования).
77 diamond 2173
  * Таблица стандартных цветов входит в скин и устанавливается заново
2174
    при установке скина (подфункции 8).
2175
  * Таблицу цветов можно просматривать/изменять интерактивно с помощью
2176
    приложения desktop.
2177
 
2178
======================================================================
2179
===== Функция 48, подфункция 3 - получить стандартные цвета окон. ====
2180
======================================================================
2181
Параметры:
2182
  * eax = 48 - номер функции
2183
  * ebx = 3 - номер подфункции
2184
  * ecx = указатель на буфер размером edx байт,
2185
    куда будет записана таблица
2186
  * edx = размер таблицы цветов
2187
    (должен быть 40 байт для будущей совместимости)
2188
Возвращаемое значение:
2189
  * функция не возвращает значения
2190
Формат таблицы цветов: каждый элемент -
2191
dword-значение цвета 0x00RRGGBB
2192
  * +0: dword: frames - цвет рамки
2193
  * +4: dword: grab - цвет заголовка
2194
  * +8: dword: grab_button - цвет кнопки на полосе заголовка
2195
  * +12 = +0xC: dword: grab_button_text - цвет текста на кнопке
2196
    на полосе заголовка
2197
  * +16 = +0x10: dword: grab_text - цвет текста на заголовке
2198
  * +20 = +0x14: dword: work - цвет рабочей области
2199
  * +24 = +0x18: dword: work_button - цвет кнопки в рабочей области
2200
  * +28 = +0x1C: dword: work_button_text - цвет текста на кнопке
2201
    в рабочей области
2202
  * +32 = +0x20: dword: work_text - цвет текста в рабочей области
2203
  * +36 = +0x24: dword: work_graph - цвет графики в рабочей области
2204
Замечания:
2205
  * Структура таблицы цветов описана в стандартном включаемом файле
2206
    macros.inc под названием system_colors; например, можно писать:
131 diamond 2207
    	sc	system_colors		; объявление переменной
2208
    	...				; где-то надо вызвать
2209
    					; описываемую функцию с ecx=sc
2210
    	mov	ecx, [sc.work_button_text]	; читаем цвет текста
2211
    					; на кнопке в рабочей области
77 diamond 2212
  * Использование/неиспользование этих цветов - дело исключительно
2213
    самой программы. Для использования нужно просто при вызове функций
2214
    рисования указывать цвет, взятый из этой таблицы.
2215
  * При изменении таблицы стандартных цветов (подфункцией 2 с
2216
    последующим применением изменений подфункцией 0 или
2217
    при установке скина подфункцией 8) всем окнам посылается сообщение
2218
    о необходимости перерисовки (событие с кодом 1).
2219
  * Стандартные цвета можно просматривать/изменять интерактивно
2220
    с помощью приложения desktop.
2221
 
2222
======================================================================
2223
========== Функция 48, подфункция 4 - получить высоту скина. =========
2224
======================================================================
2225
Параметры:
2226
  * eax = 48 - номер функции
2227
  * ebx = 4 - номер подфункции
2228
Возвращаемое значение:
2229
  * eax = высота скина
2230
Замечания:
2231
  * Высотой скина по определению считается высота заголовка окон,
2232
    использующих скин.
2233
  * Смотри также общую структуру окна в описании функции 0.
2234
 
2235
======================================================================
2236
===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
2237
======================================================================
2238
Параметры:
2239
  * eax = 48 - номер функции
2240
  * ebx = 5 - номер подфункции
2241
Возвращаемое значение:
2242
  * eax = [left]*65536 + [right]
2243
  * ebx = [top]*65536 + [bottom]
2244
Замечания:
2245
  * Рабочая область экрана определяет положение и координаты
2246
    максимизированного окна.
2247
  * Рабочая область экрана при нормальной работе есть весь экран
2248
    за вычетом панели (@panel).
2249
  * (left,top) - координаты левого верхнего угла,
2250
    (right,bottom) - координаты правого нижнего.
2251
    Таким образом, размер рабочей области по оси x определяется
2252
    формулой right-left+1, по оси y - формулой bottom-right+1.
2253
  * Смотри также функцию 14,
2254
    позволяющую определить размеры всего экрана.
2255
  * Есть парная функция установки рабочей области - подфункция 6.
2256
 
2257
======================================================================
2258
==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
2259
======================================================================
2260
Параметры:
2261
  * eax = 48 - номер функции
2262
  * ebx = 6 - номер подфункции
2263
  * ecx = [left]*65536 + [right]
2264
  * edx = [top]*65536 + [bottom]
2265
Возвращаемое значение:
2266
  * функция не возвращает значения
2267
Замечания:
2268
  * Рабочая область экрана определяет положение и координаты
2269
    максимизированного окна.
2270
  * Эта функция используется только приложением @panel,
2271
    устанавливающим рабочей областью весь экран за вычетом панели.
2272
  * (left,top) - координаты левого верхнего угла,
2273
    (right,bottom) - координаты правого нижнего.
2274
    Таким образом, размер рабочей области по оси x определяется
2275
    формулой right-left+1, по оси y - формулой bottom-right+1.
2276
  * Если left>=right, то x-координаты рабочей области не изменяются.
2277
    Если left<0, то left не устанавливается. Если right больше
2278
    или равно ширины экрана, то right не устанавливается.
2279
    Аналогично по оси y.
2280
  * Смотри также функцию 14,
2281
    позволяющую определить размеры всего экрана.
802 serge 2282
  * Есть парная функция получения рабочей области -
77 diamond 2283
    подфункция 5.
2284
  * Эта функция автоматически перерисовывает экран, по ходу дела
118 diamond 2285
    обновляет координаты и размеры максимизированных окон.
77 diamond 2286
    Все окна извещаются о необходимости перерисовки (событие 1).
2287
 
2288
======================================================================
2289
====================== Функция 48, подфункция 7 ======================
2290
============ Получить область скина для текста заголовка. ============
2291
======================================================================
2292
Возвращает область заголовка окна со скином, предназначенную
2293
для вывода текста заголовка.
2294
Параметры:
2295
  * eax = 48 - номер функции
2296
  * ebx = 7 - номер подфункции
2297
Возвращаемое значение:
2298
  * eax = [left]*65536 + [right]
2299
  * ebx = [top]*65536 + [bottom]
2300
Замечания:
2301
  * Использование/неиспользование этой функции -
2302
    личное дело приложения.
2303
  * Рекомендуется учитывать значения, возвращаемые этой функцией,
2304
    при выборе места для рисования текста заголовка (функцией 4) или
2305
    какого-нибудь заменителя текста заголовка
2306
    (по усмотрению приложения).
2307
 
2308
======================================================================
2309
==== Функция 48, подфункция 8 - установить используемый скин окон. ===
2310
======================================================================
2311
Параметры:
2312
  * eax = 48 - номер функции
2313
  * ebx = 8 - номер подфункции
546 diamond 2314
  * ecx = указатель на имя файла скина
77 diamond 2315
Возвращаемое значение:
2316
  * eax = 0 - успешно
546 diamond 2317
  * eax = 1 - не удалось загрузить файл
2318
  * eax = 2 - файл не является файлом скина
77 diamond 2319
Замечания:
2320
  * При успешной загрузке скина все окна извещаются о необходимости
2321
    перерисовки (событие 1).
2322
  * При загрузке система считывает скин из файла default.skn
2323
    на рамдиске.
2324
  * Пользователь может изменять скин статически, создав свой
2325
    default.skn, или динамически с помощью приложения desktop.
2326
 
2327
======================================================================
78 diamond 2328
============ Функция 49 - Advanced Power Management (APM). ===========
2329
======================================================================
2330
Параметры:
2331
  * eax = 49 - номер функции
2332
  * dx = номер функции APM (аналог ax в спецификации)
2333
  * bx, cx = параметры функции APM
2334
Возвращаемое значение:
2335
  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
2336
    установлены в соответствии со спецификацией APM
2337
  * старшие половины 32-битных регистров eax, ebx, ecx,
2338
    edx, esi, edi разрушаются
2339
Замечания:
2340
  * Спецификация APM 1.2 описывается в документе
2341
    "Advanced Power Management (APM) BIOS Specification"
2342
    (Revision 1.2), доступном на
2343
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2344
    кроме того, она включена в известный Interrupt List by Ralf Brown
2345
    (http://www.pobox.com/~ralf/files.html,
2346
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2347
 
2348
======================================================================
77 diamond 2349
================= Функция 50 - установка формы окна. =================
2350
======================================================================
2351
Обычные окна представляют собой прямоугольники. С помощью этой функции
131 diamond 2352
окну можно придать произвольную форму. Форма задаётся набором точек
77 diamond 2353
внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
2354
размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
2355
функцией 67.
2356
 
2357
--------------- Установка данных с информацией о форме ---------------
2358
Параметры:
2359
  * eax = 50 - номер функции
2360
  * ebx = 0 - номер подфункции
2361
  * ecx = указатель на данные формы (массив байт 0/1)
2362
Возвращаемое значение:
2363
  * функция не возвращает значения
2364
 
2365
------------------ Установка масштаба данных формы -------------------
2366
Параметры:
2367
  * eax = 50 - номер функции
2368
  * ebx = 1 - номер подфункции
131 diamond 2369
  * ecx задаёт масштаб: каждый байт данных определяет
77 diamond 2370
    (2^scale)*(2^scale) пикселей
2371
Возвращаемое значение:
2372
  * функция не возвращает значения
2373
Замечания:
2374
  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
2375
    данных формы один байт соответствует одному пикселю, то масштаб
2376
    можно не устанавливать.
2377
  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
2378
    обратите внимание, что они на единицу больше, чем устанавливаемые
2379
    функциями 0, 67.
2380
  * По определению масштаба xsize и ysize должны делиться на 2^scale.
2381
  * Байт данных по смещению a должен быть 0/1 и
2382
    определяет принадлежность окну квадрата со стороной 2^scale
2383
    (при scale=0 получаем пиксель) и координатами левого верхнего угла
2384
    (a mod (xsize shr scale), a div (xsize shr scale))
2385
  * Размер данных: (xsize shr scale)*(ysize shr scale).
2386
  * Данные должны присутствовать в памяти и не меняться
2387
    после установки формы.
2388
  * Система просматривает данные о форме при каждой перерисовке окна
2389
    функцией 0.
2390
  * Вызов подфункции 0 с нулевым указателем приводит к возврату
2391
    к прямоугольной форме.
2392
 
2393
======================================================================
2394
===================== Функция 51 - создать поток. ====================
2395
======================================================================
2396
Параметры:
2397
  * eax = 51 - номер функции
2398
  * ebx = 1 - единственная подфункция
2399
  * ecx = адрес точки входа потока (начальный eip)
2400
  * edx = указатель стэка потока (начальный esp)
2401
Возвращаемое значение:
2402
  * eax = -1 - ошибка (в системе слишком много потоков)
2403
  * иначе eax = TID - идентификатор потока
2404
 
2405
======================================================================
802 serge 2406
= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
77 diamond 2407
======================================================================
2408
Параметры:
2409
  * eax = 52 - номер функции
2410
  * ebx = 0 - номер подфункции
2411
Возвращаемое значение:
2412
  * eax = двойное слово конфигурации
2413
Замечания:
2414
  * Слово конфигурации можно установить подфункцией 2.
2415
  * Ядро не использует соответствующую переменную.
2416
    Ценность этой переменной и работающих с ней подфункций 0 и 2
2417
    представляется сомнительной.
2418
 
2419
======================================================================
2420
======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
2421
======================================================================
2422
Параметры:
2423
  * eax = 52 - номер функции
2424
  * ebx = 1 - номер подфункции
2425
Возвращаемое значение:
2426
  * eax = IP-адрес (4 байта)
2427
Замечания:
2428
  * Локальный IP-адрес устанавливается подфункцией 3.
2429
 
2430
======================================================================
802 serge 2431
 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
77 diamond 2432
======================================================================
2433
Параметры:
2434
  * eax = 52 - номер функции
2435
  * ebx = 2 - номер подфункции
2436
  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
2437
    число 3, это воспринимается как запрос на [пере-]инициализацию
2438
    Ethernet-карты, в противном случае Ethernet выключается
2439
Возвращаемое значение:
2440
  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
2441
    но это может измениться в будущих версиях ядра
2442
  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
2443
    (отсутствие Ethernet-карты), а ненулевое значение - успех
2444
Замечания:
2445
  * Слово конфигурации можно прочитать подфункцией 0.
2446
  * Ядро не использует соответствующую переменную.
2447
    Ценность этой переменной, подфункции 0 и части подфункции 2,
2448
    устанавливающей эту переменную, представляется сомнительной.
2449
 
2450
======================================================================
2451
====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
2452
======================================================================
2453
Параметры:
2454
  * eax = 52 - номер функции
2455
  * ebx = 3 - номер подфункции
2456
  * ecx = IP-адрес (4 байта)
2457
Возвращаемое значение:
2458
  * текущая реализация возвращает eax=3, но это может быть изменено
2459
    в будущих версиях
2460
Замечания:
2461
  * Локальный IP-адрес можно получить подфункцией 1.
2462
 
2463
======================================================================
2464
= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
2465
======================================================================
2466
Параметры:
2467
  * eax = 52 - номер функции
2468
  * ebx = 6 - номер подфункции
2469
  * edx = размер данных
2470
  * esi = указатель на данные
2471
Возвращаемое значение:
2472
  * eax = -1 - ошибка
2473
  * eax = 0 - успешно
2474
Замечания:
2475
  * Эта функция предназначена только для медленных сетевых драйверов
2476
    (PPP, SLIP).
2477
  * Размер данных не должен превосходить 1500 байт,
2478
    хотя проверок корректности не делается.
2479
 
2480
======================================================================
2481
====================== Функция 52, подфункция 8 ======================
2482
============= Прочитать данные из сетевой очереди вывода. ============
2483
======================================================================
2484
Параметры:
2485
  * eax = 52 - номер функции
2486
  * ebx = 8 - номер подфункции
2487
  * esi = указатель на буфер размером 1500 байт
2488
Возвращаемое значение:
2489
  * eax = число прочитанных байт (в текущей реализации
2490
    либо 0 = нет данных, либо 1500)
2491
  * данные скопированы в буфер
2492
Замечания:
2493
  * Эта функция предназначена только для медленных сетевых драйверов
2494
    (PPP, SLIP).
2495
 
2496
======================================================================
2497
=========== Функция 52, подфункция 9 - получить gateway IP. ==========
2498
======================================================================
2499
Параметры:
2500
  * eax = 52 - номер функции
2501
  * ebx = 9 - номер подфункции
2502
Возвращаемое значение:
2503
  * eax = gateway IP (4 байта)
2504
 
2505
======================================================================
2506
========= Функция 52, подфункция 10 - получить маску подсети. ========
2507
======================================================================
2508
Параметры:
2509
  * eax = 52 - номер функции
2510
  * ebx = 10 - номер подфункции
2511
Возвращаемое значение:
2512
  * eax = маска подсети
2513
 
2514
======================================================================
2515
========= Функция 52, подфункция 11 - установить gateway IP. =========
2516
======================================================================
2517
Параметры:
2518
  * eax = 52 - номер функции
2519
  * ebx = 11 - номер подфункции
2520
  * ecx = gateway IP (4 байта)
2521
Возвращаемое значение:
2522
  * текущая реализация возвращает eax=11, но это может быть изменено
2523
    в будущих реализациях
2524
 
2525
======================================================================
2526
======== Функция 52, подфункция 12 - установить маску подсети. =======
2527
======================================================================
2528
Параметры:
2529
  * eax = 52 - номер функции
2530
  * ebx = 12 - номер подфункции
2531
  * ecx = маска подсети
2532
Возвращаемое значение:
2533
  * текущая реализация возвращает eax=12, но это может быть изменено
2534
    в будущих версиях
2535
 
2536
======================================================================
2537
============ Функция 52, подфункция 13 - получить DNS IP. ============
2538
======================================================================
2539
Параметры:
2540
  * eax = 52 - номер функции
2541
  * ebx = 13 - номер подфункции
2542
Возвращаемое значение:
2543
  * eax = DNS IP (4 байта)
2544
 
2545
======================================================================
2546
=========== Функция 52, подфункция 14 - установить DNS IP. ===========
2547
======================================================================
2548
Параметры:
2549
  * eax = 52 - номер функции
2550
  * ebx = 14 - номер подфункции
2551
  * ecx = DNS IP (4 байта)
2552
Возвращаемое значение:
2553
  * текущая реализация возвращает eax=14, но это может быть изменено
2554
    в следующих версиях
2555
 
2556
======================================================================
277 diamond 2557
====== Функция 52, подфункция 15 - получить локальный MAC-адрес. =====
2558
======================================================================
2559
Параметры:
2560
  * eax = 52 - номер функции
2561
  * ebx = 15 - номер подфункции
2562
  * ecx = 0 - читать первые 4 байта,
2563
    ecx = 4 - читать последние 2 байта
2564
Возвращаемое значение:
2565
  * для ecx=0: eax = первые 4 байта MAC-адреса
2566
  * для ecx=4: ax = последние 2 байта MAC-адреса,
2567
               старшая половина eax разрушается
2568
  * для других ecx: eax = -1 как признак ошибки
2569
 
2570
======================================================================
77 diamond 2571
============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========
2572
======================================================================
2573
Параметры:
2574
  * eax = 53 - номер функции
2575
  * ebx = 0 - номер подфункции
2576
  * ecx = локальный порт (учитывается только младшее слово)
131 diamond 2577
  * edx = удалённый порт (учитывается только младшее слово)
2578
  * esi = удалённый IP
77 diamond 2579
Возвращаемое значение:
2580
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2581
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2582
    сокет и имеющее смысл только для системы) - успешно;
2583
    ebx разрушается
2584
 
2585
======================================================================
2586
============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========
2587
======================================================================
2588
Параметры:
2589
  * eax = 53 - номер функции
2590
  * ebx = 1 - номер подфункции
2591
  * ecx = хэндл сокета
2592
Возвращаемое значение:
2593
  * eax = -1 - неверный хэндл
2594
  * eax = 0 - успешно
2595
  * ebx разрушается
2596
Замечания:
2597
  * Текущая реализация не закрывает автоматически все сокеты потока
2598
    при его завершении. В частности, не следует прибивать поток
2599
    с кучей открытых сокетов - будет утечка ресурсов.
2600
  * Текущая реализация не делает проверок на корректность
2601
    (единственное, на что возвращается ошибка, - попытка закрыть
2602
    неоткрытый сокет с корректным хэндлом).
2603
 
2604
======================================================================
2605
============== Функция 53, подфункция 2 - опрос сокета. ==============
2606
======================================================================
2607
Параметры:
2608
  * eax = 53 - номер функции
2609
  * ebx = 2 - номер подфункции
2610
  * ecx = хэндл сокета
2611
Возвращаемое значение:
2612
  * eax = число полученных байт
2613
  * ebx разрушается
2614
Замечания:
2615
  * Проверки корректности не делается.
2616
 
2617
======================================================================
2618
======== Функция 53, подфункция 3 - прочитать байт из сокета. ========
2619
======================================================================
2620
Параметры:
2621
  * eax = 53 - номер функции
2622
  * ebx = 3 - номер подфункции
2623
  * ecx = хэндл сокета
2624
Возвращаемое значение:
2625
  * если нет принятых данных: eax=0, bl=0,
118 diamond 2626
    прочие байты ebx разрушаются
77 diamond 2627
  * если были принятые данные: eax=число оставшихся байт
118 diamond 2628
    (возможно, 0), bl=прочитанный байт, прочие байты ebx разрушаются
77 diamond 2629
Замечания:
2630
  * Проверки корректности не производится.
2631
 
2632
======================================================================
2633
========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========
2634
======================================================================
2635
Параметры:
2636
  * eax = 53 - номер функции
2637
  * ebx = 4 - номер подфункции
2638
  * ecx = хэндл сокета
2639
  * edx = число байт для записи
2640
  * esi = указатель на данные для записи
2641
Возвращаемое значение:
2642
  * eax = 0xffffffff - неверный хэндл
2643
  * eax = 0xffff - недостаточно памяти
2644
  * eax = 0 - успешно
2645
  * ebx разрушается
2646
Замечания:
114 mikedld 2647
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2648
    не очень неправильные неоткрытые хэндлы.
2649
  * Число байт для записи не может превышать 1500-28, хотя
2650
    соответствующей проверки не делается.
2651
 
2652
======================================================================
2653
============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========
2654
======================================================================
2655
Параметры:
2656
  * eax = 53 - номер функции
2657
  * ebx = 5 - номер подфункции
2658
  * ecx = локальный порт (учитывается только младшее слово)
131 diamond 2659
  * edx = удалённый порт (учитывается только младшее слово)
2660
  * esi = удалённый IP
77 diamond 2661
  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1
2662
Возвращаемое значение:
2663
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2664
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2665
    сокет и имеющее смысл только для системы) - успешно;
2666
    ebx разрушается
2667
 
2668
======================================================================
2669
====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
2670
======================================================================
2671
Параметры:
2672
  * eax = 53 - номер функции
2673
  * ebx = 6 - номер подфункции
2674
  * ecx = хэндл сокета
2675
Возвращаемое значение:
2676
  * eax = статус сокета: одно из
2677
  * TCB_LISTEN = 1
2678
  * TCB_SYN_SENT = 2
2679
  * TCB_SYN_RECEIVED = 3
2680
  * TCB_ESTABLISHED = 4
2681
  * TCB_FIN_WAIT_1 = 5
2682
  * TCB_FIN_WAIT_2 = 6
2683
  * TCB_CLOSE_WAIT = 7
2684
  * TCB_CLOSING = 8
2685
  * TCB_LAST_ASK = 9
2686
  * TCB_TIME_WAIT = 10
2687
  * TCB_CLOSED = 11
2688
  * ebx разрушается
2689
Замечания:
2690
  * Проверок корректности не производится.
2691
 
2692
======================================================================
2693
========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
2694
======================================================================
2695
Параметры:
2696
  * eax = 53 - номер функции
2697
  * ebx = 7 - номер подфункции
2698
  * ecx = хэндл сокета
2699
  * edx = число байт для записи
2700
  * esi = указатель на данные для записи
2701
Возвращаемое значение:
2702
  * eax = 0xffffffff - ошибка
2703
  * eax = 0xffff - недостаточно памяти
2704
  * eax = 0 - успешно
2705
  * ebx разрушается
2706
Замечания:
114 mikedld 2707
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2708
    не очень неправильные неоткрытые хэндлы.
2709
  * Число байт для записи не может превышать 1500-40,
2710
    хотя соответствующей проверки не делается.
2711
 
2712
======================================================================
2713
============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========
2714
======================================================================
2715
Параметры:
2716
  * eax = 53 - номер функции
2717
  * ebx = 8 - номер подфункции
2718
  * ecx = хэндл сокета
2719
Возвращаемое значение:
2720
  * eax = -1 - неверный хэндл
2721
  * eax = 0xffff - недостаточно памяти для пакета закрытия сокета
2722
  * eax = 0 - успешно
2723
  * во многих случаях eax разрушается (возвращается результат функции
2724
    queue) - видимо, это баг, который будет исправлен
2725
  * ebx разрушается
2726
Замечания:
2727
  * Текущая реализация не закрывает автоматически все сокеты потока
2728
    при его завершении. В частности, не следует прибивать поток
2729
    с кучей открытых сокетов - будет утечка ресурсов.
2730
  * Текущая реализация не делает проверок на корректность
2731
    (единственное, на что возвращается ошибка, - попытка закрыть
2732
    неоткрытый сокет с корректным хэндлом).
2733
 
2734
======================================================================
2735
== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =
2736
======================================================================
2737
Параметры:
2738
  * eax = 53 - номер функции
2739
  * ebx = 9 - номер подфункции
2740
  * ecx = номер локального порта (используются только младшие 16 бит)
2741
Возвращаемое значение:
2742
  * eax = 0 - порт используется
2743
  * eax = 1 - порт свободен
2744
  * ebx разрушается
2745
 
2746
======================================================================
314 diamond 2747
==== Функция 53, подфункция 10 - получить статус кабеля Ethernet. ====
2748
======================================================================
2749
Параметры:
2750
  * eax = 53 - номер функции
2751
  * ebx = 10 - номер подфункции
2752
Возвращаемое значение:
2753
  * al = -1 - драйвер сетевой карты не загружен или
2754
              не поддерживает эту функцию
2755
  * al = 0 - кабель не подключён
2756
  * al = 1 - кабель подключён
346 diamond 2757
  * ebx разрушается
314 diamond 2758
Замечания:
2759
  * Текущая реализация ядра поддерживает эту функцию
2760
    только для сетевых карт RTL8139.
2761
 
2762
======================================================================
346 diamond 2763
==== Функция 53, подфункция 11 - прочитать данные сетевого стека. ====
340 heavyiron 2764
======================================================================
2765
Параметры:
2766
  * eax = 53 - номер функции
2767
  * ebx = 11 - номер подфункции
346 diamond 2768
  * ecx = хэндл сокета
2769
  * edx = указатель на буфер
2770
  * esi = число байт для чтения;
2771
  * esi = 0 - читать все данные (максимум 4096 байт)
2772
Возвращаемое значение:
2773
  * eax = число прочитанных байт
2774
  * ebx разрушается
340 heavyiron 2775
Замечания:
346 diamond 2776
  * Проверки на правильность хэндла не делается.
340 heavyiron 2777
 
2778
======================================================================
802 serge 2779
 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.
77 diamond 2780
======================================================================
2781
Параметры:
2782
  * eax = 53 - номер функции
2783
  * ebx = 255 - номер подфункции
2784
  * ecx = тип запрашиваемой информации (смотри ниже)
2785
Возвращаемое значение:
2786
  * eax = запрошенная информация
2787
  * ebx разрушается
2788
Возможные значения ecx:
2789
  * 100: длина очереди 0 (empty queue)
2790
  * 101: длина очереди 1 (ip-out queue)
2791
  * 102: длина очереди 2 (ip-in queue)
2792
  * 103: длина очереди 3 (net1out queue)
2793
  * 200: число элементов в таблице ARP
2794
  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)
2795
  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда
2796
    берут информацию 5 последующих типов;
131 diamond 2797
    в этом случае eax неопределён
77 diamond 2798
  * 203: IP-адрес, запомненный типом 202
2799
  * 204: старшее dword MAC-адреса, запомненного типом 202
2800
  * 205: младшее word MAC-адреса, запомненного типом 202
2801
  * 206: слово статуса, запомненное типом 202
2802
  * 207: слово ttl, запомненное типом 202
2803
  * 2: общее число полученных IP-пакетов
2804
  * 3: общее число переданных IP-пакетов
2805
  * 4: общее число сдампленных полученных пакетов
2806
  * 5: общее число полученных ARP-пакетов
2807
  * 6: статус драйвера пакетов, 0=неактивен,
2808
    ненулевое значение=активен
2809
 
2810
======================================================================
2811
======== Функция 55, подфункция 0 - загрузить данные для SB16. =======
2812
======================================================================
2813
Параметры:
2814
  * eax = 55 - номер функции
2815
  * ebx = 0 - номер подфункции
2816
  * ecx = указатель на данные (копируется 64 килобайта, используется
2817
    столько, сколько установлено подфункцией 2)
2818
Возвращаемое значение:
2819
  * функция не возвращает значения
2820
Замечания:
2821
  * Формат и размер данных устанавливаются подфункцией 2.
2822
 
2823
======================================================================
2824
==== Функция 55, подфункция 1 - начать проигрывать данные на SB16. ===
2825
======================================================================
2826
Параметры:
2827
  * eax = 55 - номер функции
2828
  * ebx = 1 - номер подфункции
2829
Возвращаемое значение:
2830
  * функция не возвращает значения
2831
Замечания:
2832
  * Предварительно данные должны быть загружены подфункцией 0 и
131 diamond 2833
    определён их формат подфункцией 2.
77 diamond 2834
  * Функция возвращает управление, когда началось проигрывание данных;
131 diamond 2835
    после этого проигрывание идёт независимо от приложения (и вообще
77 diamond 2836
    не требует загрузки процессора).
2837
  * Предварительно должны быть определены базовый порт SB16
2838
    (подфункцией 4 функции 21) и канал DMA
2839
    (подфункцией 10 функции 21).
2840
 
2841
======================================================================
2842
====== Функция 55, подфункция 2 - установить формат данных SB16. =====
2843
======================================================================
2844
Параметры:
2845
  * eax = 55 - номер функции
2846
  * ebx = 2 - номер подфункции
2847
  * ecx = 0 - установить разрядность
2848
    * edx = 1 - 8бит моно
2849
    * edx = 2 - 8бит стерео
2850
  * ecx = 1 - установить размер данных
2851
    * edx = размер в байтах
2852
  * ecx = 2 - установить частоту проигрывания
2853
    * edx = частота
2854
Возвращаемое значение:
2855
  * функция не возвращает значения
2856
Замечания:
2857
  * При загрузке системы устанавливаются следующие параметры
2858
    по умолчанию: разрядность - 8 бит моно, размер - 64 Кб,
2859
    частота 44100 Гц. Тем не менее рекомендуется явно устанавливать
2860
    необходимые значения, поскольку они могли быть переустановлены
2861
    какой-нибудь программой.
2862
 
2863
======================================================================
2864
====================== Функция 55, подфункция 55 =====================
2865
========== Начать проигрывать данные на встроенном спикере. ==========
2866
======================================================================
2867
Параметры:
2868
  * eax = 55 - номер функции
2869
  * ebx = 55 - номер подфункции
2870
  * esi = указатель на данные
2871
Возвращаемое значение:
2872
  * eax = 0 - успешно
131 diamond 2873
  * eax = 55 - ошибка (спикер отключён или занят)
77 diamond 2874
Данные - это массив элементов переменной длины.
2875
Формат каждого элемента определяется первым байтом:
2876
  * 0 = конец данных
131 diamond 2877
  * 1..0x80 = задаёт длительность звучания в сотых долях секунды
77 diamond 2878
    ноты, определяемой непосредственным значением частоты
2879
    * следующее слово (2 байта) содержит делитель частоты;
2880
      частота определяется как 1193180/divider
2881
  * 0x81 = invalid
2882
  * 0x82..0xFF = нота, определяемая октавой и номером:
2883
    * длительность в сотых долях секунды = (первый байт)-0x81
131 diamond 2884
    * присутствует ещё один байт;
77 diamond 2885
    * (второй байт)=0xFF - пауза
2886
    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
2887
      до 12, a=номер октавы (считая с 0)
2888
Замечания:
2889
  * Пищание спикером может быть запрещено/разрешено подфункцией 8
2890
    функции 18.
2891
  * Функция возвращает управление, сообщив куда следует информацию
131 diamond 2892
    о запросе. Само проигрывание идёт независимо от программы.
77 diamond 2893
  * Данные должны сохраняться в памяти по крайней мере
2894
    до конца проигрывания.
2895
 
2896
======================================================================
641 diamond 2897
======================= Функция 57 - PCI BIOS. =======================
586 serge 2898
======================================================================
2899
Параметры:
641 diamond 2900
  * eax = 57 - номер функции
2901
  * ebp соответствует регистру al в спецификации PCI BIOS
2902
  * остальные регистры - по спецификации PCI BIOS
2903
Возвращаемое значение:
2904
  * CF не определён
2905
  * остальные регистры - по спецификации PCI BIOS
2906
Замечания:
2907
  * Многих результатов этой функции можно также добиться вызовом
2908
    соответствующих подфункций функции 62.
2909
  * Функция вызывает расширение PCI32 BIOS, документированное,
2910
    например, в http://alpha1.dyns.net/files/PCI/bios21.pdf.
2911
  * Если BIOS не поддерживает это расширение, поведение функции
2912
    эмулируется (через аналоги подфункций функции 62 режима ядра).
586 serge 2913
 
2914
======================================================================
77 diamond 2915
============== Функция 58 - работа с файловой системой. ==============
2916
======================================================================
2917
Параметры:
2918
  * eax = 58
2919
  * ebx = указатель на информационную структуру
2920
Возвращаемое значение:
2921
  * eax = 0 - успешно; иначе код ошибки файловой системы
2922
  * в зависимости от подфункции может возвращаться значение и
2923
    в других регистрах
2924
Общий формат информационной структуры:
2925
  * +0: dword: номер подфункции
2926
  * +4: dword: номер блока
2927
  * +8: dword: размер
2928
  * +12 = +0xC: dword: указатель на данные
2929
  * +16 = +0x10: dword: указатель на память для работы системы
2930
    (4096 байт)
2931
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
2932
Уточнения - в документации на соответствующую подфункцию.
2933
Имя файла нечувствительно к регистру латинских букв,
2934
русские буквы должны быть заглавными.
2935
Формат имени файла:
2936
/base/number/dir1/dir2/.../dirn/file,
2937
где /base/number идентифицирует устройство, на котором ищется файл:
2938
одно из
2939
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
2940
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
2941
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
131 diamond 2942
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к жёсткому диску
77 diamond 2943
    (в этом случае база определяется подфункцией 7 функции 21),
2944
    x - номер раздела (считая с 1)
2945
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
2946
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
2947
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2948
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
2949
    (на каждом из винчестеров нумерация начинается с 1)
2950
Замечания:
2951
  * В первых двух случаях допускается использование FIRST вместо 1,
2952
    SECOND вместо 2, но использовать эту возможность
2953
    не рекомендуется для удобства перехода на будущие расширения.
2954
  * Накладывается ограничение n<=39.
2955
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
2956
    имя не более 8 символов, точка, расширение не более 3 символов.
2957
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
2958
    Если имя занимает ровно 8 символов, точку можно опустить
2959
    (хотя пользоваться этим не рекомендуется для удобства перехода
2960
    на будущие расширения).
118 diamond 2961
  * Функция не поддерживает папок на рамдиске.
77 diamond 2962
Примеры:
2963
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2964
    '/rd/1/kernel.asm',0
2965
  * '/HD0/1/kernel.asm',0
2966
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2967
Доступные подфункции:
2968
  * подфункция 0 - чтение файла/папки
2969
  * подфункция 8 - LBA-чтение с устройства
2970
  * подфункция 15 - получение информации о файловой системе
2971
 
2972
======================================================================
2973
========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
2974
======================================================================
2975
Параметры:
2976
  * eax = 58
2977
  * ebx = указатель на информационную структуру
2978
Формат информационной структуры:
2979
  * +0: dword: 0 = номер подфункции
2980
  * +4: dword: номер блока для чтения (считая с 0)
2981
  * +8: dword: число блоков для чтения
2982
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2983
  * +16 = +0x10: dword: указатель на буфер для работы системы
2984
    (4096 байт)
131 diamond 2985
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 2986
    общем описании
2987
Возвращаемое значение:
2988
  * eax = 0 - успешно, иначе код ошибки файловой системы
2989
  * ebx = размер файла (в байтах) или
2990
    -1=0xffffffff, если файл не найден
2991
Замечания:
2992
  * Размер блока - 512 байт.
2993
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
2994
    функции 70, для чтения папок - подфункцию 1 функции 70.
2995
  * Функция позволяет читать содержимое папки. Из файловых систем
2996
    поддерживается только FAT. Формат FAT-папки описан в любой
2997
    документации по FAT.
2998
  * Размер папки определяется по размеру цепочки кластеров в FAT.
2999
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 3000
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 3001
    eax=6 (EOF).
3002
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
3003
    в первых двух случаях текущая реализация не следует
3004
    установленным правилам:
3005
    для /rd/1:
3006
    * если указано 0 блоков для чтения, считается,
3007
      что запрашивается 1;
3008
    * если запрашивается больше 14 блоков или начальный блок
3009
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
3010
    * размер корневого каталога рамдиска = 14 блоков,
3011
      0x1C00=7168 байт; но возвращается ebx=0
3012
      (за исключением случая предыдущего пункта);
3013
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
131 diamond 3014
      мусор - напоминаю, счёт ведётся с 0);
77 diamond 3015
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
3016
      то возвращается eax=6(EOF); иначе eax=0.
3017
    Для /fd/x:
3018
    * если начальный блок не меньше 14-го, то возвращается
3019
      eax=5 (not found) и ebx=0;
3020
    * кстати говоря, формат FAT12 допускает дискеты с размером
3021
      корневого каталога меньше или больше 14 блоков;
3022
    * проверки длины не делается;
3023
    * если удалось прочитать данные с дискеты, возвращается
3024
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
3025
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
3026
    но результат не соответствует ожидаемому
3027
    (по работе с обычными файлами/папками), не следует установленным
3028
    правилам, может измениться в следующих версиях ядра и потому
3029
    не описывается. Для получения информации об оборудовании
3030
    используйте подфункцию 11 функции 18 или
3031
    читайте соответствующие папки подфункцией 1 функции 70.
3032
 
3033
======================================================================
3034
========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
3035
======================================================================
3036
Параметры:
3037
  * eax = 58 - номер функции
3038
  * ebx = указатель на информационную структуру
3039
Формат информационной структуры:
3040
  * +0: dword: 8 = номер подфункции
3041
  * +4: dword: номер блока для чтения (считая с 0)
3042
  * +8: dword: игнорируется (устанавливайте в 1)
3043
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
3044
    (512 байт)
3045
  * +16 = +0x10: dword: указатель на буфер для работы системы
3046
    (4096 байт)
3047
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
3048
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
3049
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
3050
    Вместо цифр допускается, хотя и не рекомендуется для удобства
3051
    перехода на будущие расширения,
3052
    использование 'first','second','third','fourth'.
3053
Возвращаемое значение:
3054
  * если указано имя устройства /hd/xxx, где xxx не находится
3055
    в списке выше:
3056
    * eax = ebx = 1
3057
  * если указано неправильное имя устройства
3058
    (за исключением предыдущего случая):
3059
    * eax = 5
3060
    * ebx не меняется
131 diamond 3061
  * если LBA-доступ запрещён подфункцией 11 функции 21:
77 diamond 3062
    * eax = 2
3063
    * ebx разрушается
3064
  * для рамдиска: попытка чтения блока за пределами рамдиска
3065
    (18*2*80 блоков) приводит к
3066
    * eax = 3
3067
    * ebx = 0
3068
  * при успешном чтении:
3069
    * eax = ebx = 0
3070
Замечания:
3071
  * Размер блока - 512 байт; читается один блок.
3072
  * Не следует полагаться на возвращаемое значение,
3073
    оно может измениться в следующих версиях.
802 serge 3074
  * Требуется, чтобы был разрешён LBA-доступ к устройствам
3075
    подфункцией 11 функции 21. Узнать это можно вызовом
77 diamond 3076
    подфункцией 11 функции 26.
3077
  * LBA-чтение дискеты не поддерживается.
131 diamond 3078
  * Функция считывает данные физического жёсткого диска;
77 diamond 3079
    если по каким-то причинам нужны данные конкретного раздела,
131 diamond 3080
    придётся определять начальный сектор этого раздела
77 diamond 3081
    (либо напрямую через MBR, либо из расширенной структуры,
3082
    возвращаемой той же подфункцией 11 функции 18).
131 diamond 3083
  * Функция не проверяет код ошибки жёсткого диска, так что запрос
3084
    несуществующего сектора всё равно что-то прочитает
77 diamond 3085
    (вероятнее всего, нули, но это определяется устройством) и
3086
    это будет считаться успехом (eax=0).
3087
 
3088
======================================================================
802 serge 3089
= Функция 58, подфункция 15 - получить информацию о файловой системе.
77 diamond 3090
======================================================================
3091
Параметры:
3092
  * eax = 58 - номер функции
3093
  * ebx = указатель на информационную структуру
3094
Формат информационной структуры:
118 diamond 3095
  * +0: dword: 15 = номер подфункции
77 diamond 3096
  * +4: dword: игнорируется
3097
  * +8: dword: игнорируется
3098
  * +12 = +0xC: dword: игнорируется
3099
  * +16 = +0x10: dword: игнорируется
3100
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
3101
    /rd=/RAMDISK или /hd=/HARDDISK
3102
Возвращаемое значение:
3103
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
3104
    * eax = 3
3105
    * ebx = ecx = dword [fileinfo] = 0
3106
  * для рамдиска:
3107
    * eax = 0 (успех)
3108
    * ebx = общее число кластеров = 2847
3109
    * ecx = число свободных кластеров
3110
    * dword [fileinfo] = размер кластера = 512
131 diamond 3111
  * для жёсткого диска: база и раздел определяются подфункциями 7 и 8
77 diamond 3112
    функции 21:
3113
    * eax = 0 (успех)
3114
    * ebx = общее число кластеров
3115
    * ecx = число свободных кластеров
3116
    * dword [fileinfo] = размер кластера (в байтах)
3117
Замечания:
3118
  * Не удивляйтесь странному расположению 4-го возвращаемого
3119
    параметра - когда писался этот код, при системных вызовах
3120
    приложению возвращались только регистры eax,ebx,ecx (из
3121
    pushad-структуры, передающейся как аргумент системной функции).
3122
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
3123
    размер кластера в edx, пока эту функцию не начали использовать.
131 diamond 3124
  * Вообще-то ещё существует подфункция 11 функции 18, возвращающая
77 diamond 3125
    информацию о файловой системе. По расширенной таблице дисковой
3126
    подсистемы можно определить размер кластера (там он хранится
131 diamond 3127
    в секторах) и общее число кластеров для жёстких дисков.
77 diamond 3128
 
3129
======================================================================
3130
=========== Функция 60 - Inter Process Communication (IPC). ==========
3131
======================================================================
3132
IPC применяется для посылок сообщений от одного процесса/потока
3133
другому. При этом следует предварительно договориться о том, как
3134
интерпретировать конкретное сообщение.
3135
 
3136
-------- Подфункция 1 - установить область для получения IPC ---------
131 diamond 3137
Вызывается процессом-приёмником.
77 diamond 3138
Параметры:
3139
  * eax = 60 - номер функции
3140
  * ebx = 1 - номер подфункции
3141
  * ecx = указатель на буфер
3142
  * edx = размер буфера
3143
Возвращаемое значение:
3144
  * eax = 0 - всегда успешно
3145
Формат IPC-буфера:
3146
  * +0: dword: если здесь не 0, то буфер считается заблокированным;
3147
    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
3148
    и вам надо, чтобы извне не изменялись данные буфера
3149
    (не поступали новые сообщения)
3150
  * +4: dword: занято места в буфере (в байтах)
3151
  * +8: первое сообщение
3152
  * +8+n: второе сообщение
3153
  * ...
3154
Формат сообщения:
3155
  * +0: dword: PID процесса/потока, пославшего сообщение
3156
  * +4: dword: длина сообщения (не считая этот заголовок)
3157
  * +8: n*byte: данные сообщения
3158
 
3159
--------------- Подфункция 2 - послать сообщение IPC. ----------------
3160
Вызывается процессом-инициатором.
3161
Параметры:
3162
  * eax = 60 - номер функции
3163
  * ebx = 2 - номер подфункции
131 diamond 3164
  * ecx = PID приёмника
77 diamond 3165
  * edx = указатель на данные сообщения
3166
  * esi = длина сообщения (в байтах)
3167
Возвращаемое значение:
3168
  * eax = 0 - успешно
131 diamond 3169
  * eax = 1 - приёмник не определил буфер для IPC-сообщений
3170
    (может быть, ещё не успел, а может быть, это не тот поток,
77 diamond 3171
    который нужен)
131 diamond 3172
  * eax = 2 - приёмник заблокировал IPC-буфер;
77 diamond 3173
    попробуйте немного подождать
131 diamond 3174
  * eax = 3 - переполнение IPC-буфера приёмника
77 diamond 3175
  * eax = 4 - процесса/потока с таким PID не существует
3176
Замечания:
3177
  * Система сразу после записи IPC-сообщения в буфер посылает
131 diamond 3178
    потоку-приёмнику событие с кодом 7 (см. коды событий).
77 diamond 3179
 
3180
======================================================================
3181
=== Функция 61 - получить параметры для прямого доступа к графике. ===
3182
======================================================================
3183
Программе доступны данные графического экрана (область памяти, которая
3184
собственно и отображает содержимое экрана) напрямую без вызовов
3185
системных функций через селектор gs:
131 diamond 3186
	mov	eax, [gs:0]
77 diamond 3187
поместит в eax первый dword буфера, содержащий информацию о цвете
3188
левой верхней точки (и, возможно, цвета нескольких следующих).
131 diamond 3189
	mov	[gs:0], eax
77 diamond 3190
при работе в режимах VESA c LFB
3191
установит цвет левой верхней точки
3192
(и возможно, цвета нескольких следующих).
3193
Для интерпретации данных графического экрана требуется знание
3194
некоторых параметров, которые возвращаются этой функцией.
3195
Замечания:
3196
  * Параметры графики очень редко меняются при работе системы,
3197
    а именно, только в случаях, когда пользователь работает
3198
    с программой VRR.
3199
  * При изменении видеорежима система перерисовывает все окна
3200
    (событие с кодом 1) и перерисовывает фон (событие 5).
3201
    Эти же события происходят и в других случаях,
3202
    которые встречаются значительно чаще, чем изменение видеорежима.
3203
  * При работе в видеорежимах с LFB селектор gs указывает на
3204
    собственно LFB, так что чтение/запись по gs приводят
3205
    непосредственно к изменению содержимого экрана. При работе в
3206
    видеорежимах без LFB gs указывает на некоторую область данных
131 diamond 3207
    ядра, причём все функции вывода на экран добросовестно выполняют
77 diamond 3208
    двойную работу по записи непосредственно на экран и по записи
3209
    в этот буфер. В результате при чтении содержимого этого буфера
3210
    результаты соответствуют содержимому экрана
3211
    (с, вообще говоря, большим цветовым разрешением),
3212
    а запись игнорируется.
3213
    Исключением является режим 320*200, для которого в главном цикле
3214
    системного потока выполняется обновление экрана в соответствии
3215
    с движениями курсора мыши.
3216
 
3217
------------------------- Разрешение экрана --------------------------
3218
Параметры:
3219
  * eax = 61 - номер функции
3220
  * ebx = 1 - номер подфункции
3221
Возвращаемое значение:
3222
  * eax = [разрешение по оси x]*65536 + [разрешение по оси y]
3223
Замечания:
131 diamond 3224
  * Можно использовать функцию 14 с учётом того, что она возвращает
77 diamond 3225
    размеры на 1 меньше. Это полностью эквивалентный способ.
3226
 
3227
------------------------ Число бит на пиксель ------------------------
3228
Параметры:
3229
  * eax = 61 - номер функции
3230
  * ebx = 2 - номер подфункции
3231
Возвращаемое значение:
3232
  * eax = число бит на пиксель (24 или 32)
3233
 
3234
------------------------ Число байт на строку ------------------------
3235
Параметры:
3236
  * eax = 61 - номер функции
3237
  * ebx = 3 - номер подфункции
3238
Возвращаемое значение:
131 diamond 3239
  * eax = число байт, которое занимает одна строка развёртки
77 diamond 3240
    (горизонтальная линия на экране)
3241
 
3242
======================================================================
3243
===== Функция 62, подфункция 0 - получить версию PCI-интерфейса. =====
3244
======================================================================
3245
Параметры:
3246
  * eax = 62 - номер функции
3247
  * bl = 0 - номер подфункции
3248
Возвращаемое значение:
131 diamond 3249
  * eax = -1 - доступ к PCI запрещён; иначе
77 diamond 3250
  * ah.al = версия PCI-интерфейса (ah=версия, al=подверсия)
3251
  * старшее слово eax обнулено
3252
Замечания:
131 diamond 3253
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3254
    для приложений подфункцией 12 функции 21.
118 diamond 3255
  * Если PCI BIOS не поддерживается, то значение ax неопределено.
77 diamond 3256
 
3257
======================================================================
3258
==== Функция 62, подфункция 1 - получить номер последней PCI-шины. ===
3259
======================================================================
3260
Параметры:
3261
  * eax = 62 - номер функции
3262
  * bl = 1 - номер подфункции
3263
Возвращаемое значение:
131 diamond 3264
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3265
  * al = номер последней PCI-шины; оставшиеся байты eax разрушаются
77 diamond 3266
Замечания:
131 diamond 3267
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3268
    для приложений подфункцией 12 функции 21.
118 diamond 3269
  * Если PCI BIOS не поддерживается, то значение al неопределено.
77 diamond 3270
 
3271
======================================================================
3272
====================== Функция 62, подфункция 2 ======================
3273
== Получить механизм обращения к конфигурационному пространству PCI. =
3274
======================================================================
3275
Параметры:
3276
  * eax = 62 - номер функции
3277
  * bl = 2 - номер подфункции
3278
Возвращаемое значение:
131 diamond 3279
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3280
  * al = механизм (1 или 2); прочие байты eax разрушаются
77 diamond 3281
Замечания:
131 diamond 3282
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3283
    для приложений подфункцией 12 функции 21.
3284
  * Механизм обращения выбирается в соответствии
3285
    с характеристиками оборудования.
3286
  * Подфункции чтения и записи автоматически работают
3287
    с выбранным механизмом.
3288
 
3289
======================================================================
3290
======== Функция 62, подфункции 4,5,6 - прочитать PCI-регистр. =======
3291
======================================================================
3292
Параметры:
3293
  * eax = 62 - номер функции
3294
  * bl = 4 - читать байт
3295
  * bl = 5 - читать слово
3296
  * bl = 6 - читать двойное слово
3297
  * bh = номер PCI-шины
3298
  * ch = dddddfff, где ddddd = номер устройства на шине,
3299
    fff = номер функции устройства
131 diamond 3300
  * cl = номер регистра (должен быть чётным для bl=5,
77 diamond 3301
    делиться на 4 для bl=6)
3302
Возвращаемое значение:
131 diamond 3303
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3304
    неподдерживаемые параметры); иначе
3305
  * al/ax/eax (в зависимости от запрошенного размера) содержит данные;
3306
    оставшаяся часть регистра eax разрушается
3307
Замечания:
131 diamond 3308
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3309
    для приложений подфункцией 12 функции 21.
3310
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3311
    игнорирует номер функции. Получить механизм доступа можно вызовом
3312
    подфункции 2.
3313
  * Некоторые регистры стандартны и существуют для всех устройств,
3314
    некоторые определяются конкретным устройством. Список первых
3315
    входит, например, в известный Interrupt List by Ralf Brown
3316
    (http://www.pobox.com/~ralf/files.html,
3317
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3318
    список вторых должен быть указан в документации по устройству.
3319
 
3320
======================================================================
3321
======= Функция 62, подфункции 8,9,10 - записать в PCI-регистр. ======
3322
======================================================================
3323
Параметры:
3324
  * eax = 62 - номер функции
3325
  * bl = 8 - писать байт
3326
  * bl = 9 - писать слово
3327
  * bl = 10 - писать двойное слово
3328
  * bh = номер PCI-шины
3329
  * ch = dddddfff, где ddddd = номер устройства на шине,
3330
    fff = номер функции устройства
131 diamond 3331
  * cl = номер регистра (должен быть чётным для bl=9,
77 diamond 3332
    делиться на 4 для bl=10)
92 diamond 3333
  * dl/dx/edx (в зависимости от запрошенного размера) содержит
3334
    данные для записи
77 diamond 3335
Возвращаемое значение:
131 diamond 3336
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3337
    неподдерживаемые параметры)
3338
  * eax = 0 - успешно
3339
Замечания:
131 diamond 3340
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3341
    для приложений подфункцией 12 функции 21.
3342
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3343
    игнорирует номер функции. Получить механизм доступа можно вызовом
3344
    подфункции 2.
3345
  * Некоторые регистры стандартны и существуют для всех устройств,
3346
    некоторые определяются конкретным устройством. Список первых
3347
    входит, например, в известный Interrupt List by Ralf Brown;
3348
    список вторых должен быть указан в документации по устройству.
3349
 
3350
======================================================================
3351
================ Функция 63 - работа с доской отладки. ===============
3352
======================================================================
448 diamond 3353
Доска отладки представляет собой системный буфер (на 4096 байт),
77 diamond 3354
в который любая программа может записать (вообще говоря, произвольные)
3355
данные и из которого другая программа может эти данные прочитать.
3356
Есть соглашение, в соответствии с которым записываемые данные -
3357
текстовые строки, интерпретируемые как отладочные сообщения о ходе
131 diamond 3358
выполнения программы. Ядро в определённых ситуациях также записывает
77 diamond 3359
на доску отладки сведения о выполнении некоторых функций;
3360
по соглашению сообщения ядра начинаются с префикса "K : ".
3361
Для просмотра доски отладки создано приложение board,
131 diamond 3362
которое считывает данные из буфера и отображает их в своём окне. board
77 diamond 3363
понимает последовательность кодов 13,10 как переход на новую строку.
3364
Символ с нулевым кодом в конце строки не обязателен, но и не мешает.
3365
В связи с появлением отладчика ценность доски отладки несколько
3366
снизилась, поскольку отладчик позволяет полностью контролировать ход
131 diamond 3367
выполнения программы, причём для этого не требуется никаких усилий
77 diamond 3368
со стороны самой программы. Тем не менее во многих случаях
3369
доска отладки продолжает оставаться полезной.
3370
 
3371
---------------------------- Запись байта ----------------------------
3372
Параметры:
3373
  * eax = 63 - номер функции
3374
  * ebx = 1 - номер подфункции
3375
  * cl = байт данных
3376
Возвращаемое значение:
3377
  * функция не возвращает значения
3378
Замечания:
3379
  * Байт записывается в буфер. Длина буфера - 512 байт.
3380
    При переполнении буфера все полученные данные теряются
3381
    и заполнение начинается снова с нуля.
3382
  * Для вывода на доску отладки более сложных объектов (строк, чисел)
3383
    достаточно этой функции, вызываемой в цикле. Можно не писать
3384
    вручную соответствующий код, а воспользоваться файлом debug.inc,
3385
    входящим в дистрибутив.
3386
 
3387
---------------------------- Чтение байта ----------------------------
3388
Забирает байт из буфера.
3389
Параметры:
3390
  * eax = 63 - номер функции
3391
  * ebx = 2 - номер подфункции
3392
Возвращаемое значение:
3393
  * eax = ebx = 0 - буфер пуст
3394
  * eax = байт, ebx = 1 - байт успешно прочитан
3395
 
3396
======================================================================
3397
========== Функция 64 - перераспределить память приложения. ==========
3398
======================================================================
3399
Параметры:
3400
  * eax = 64 - номер функции
3401
  * ebx = 1 - единственная подфункция
3402
  * ecx = новый размер памяти
3403
Возвращаемое значение:
3404
  * eax = 0 - успешно
3405
  * eax = 1 - недостаточно памяти
3406
Замечания:
172 serge 3407
  * Есть другой способ выделения/освобождения динамической памяти -
3408
    подфункции 11, 12, 13 функции 68.
277 diamond 3409
  * Функция не может использоваться совместно с 68.11, 68.12, 68.13.
3410
    Вызов функции будет игнорироваться, если приложение создаст
3411
    локальную кучу вызовом 68.11.
77 diamond 3412
 
3413
======================================================================
283 diamond 3414
========= Функция 65 - вывести изображение с палитрой в окно. ========
3415
======================================================================
3416
Параметры:
3417
  * eax = 65 - номер функции
3418
  * ebx = указатель на изображение
3419
  * ecx = [размер по оси x]*65536 + [размер по оси y]
3420
  * edx = [координата по оси x]*65536 + [координата по оси y]
911 diamond 3421
  * esi = число бит на пиксель, должно быть 1, 4, 8, 15, 16, 24 или 32
3422
  * edi = указатель на палитру (2 в степени esi цветов 0x00RRGGBB);
906 diamond 3423
          игнорируется при esi > 8
314 diamond 3424
  * ebp = смещение данных каждой следующей строки изображения
3425
          относительно предыдущей
283 diamond 3426
Возвращаемое значение:
3427
  * функция не возвращает значения
3428
Замечания:
3429
  * Координаты изображения - это координаты верхнего левого угла
3430
    изображения относительно окна.
3431
  * Размер изображения в байтах есть xsize*ysize.
911 diamond 3432
  * Формат изображения с 1 битом на пиксель: каждый байт изображения,
3433
    за исключением, быть может, последних байтов строк, содержит
3434
    информацию о цвете 8 пикселей, старший бит соответствует первому
3435
    пикселю.
3436
  * Формат изображения с 4 битами на пиксель: каждый байт изображения,
3437
    за исключением последних байтов строк (если ширина изображения
3438
    нечётна), содержит информацию о цвете 2 пикселей, старшая тетрада
3439
    соответствует первому пикселю.
842 diamond 3440
  * Формат изображения с 8 битами на пиксель: каждый байт изображения
3441
    рассматривается как индекс в палитре.
283 diamond 3442
  * Если изображение использует не все 256 цветов, а меньше,
3443
    размер палитры может быть меньше 256.
906 diamond 3444
  * Формат изображения с 15 битами на пиксель: цвет каждого пикселя
842 diamond 3445
    кодируется как (в битовом представлении) 0RRRRRGGGGGBBBBB -
3446
    по 5 пикселей на каждый цвет.
906 diamond 3447
  * Формат изображения с 16 битами на пиксель: цвет каждого пикселя
3448
    кодируется как RRRRRGGGGGGBBBBB (схема 5+6+5).
842 diamond 3449
  * Формат изображения с 24 битами на пиксель: цвет каждого пикселя
3450
    кодируется тремя байтами - последовательно синяя, зелёная,
3451
    красная составляющие цвета.
3452
  * Формат изображения с 32 битами на пиксель: аналогично 24, только
3453
    есть ещё игнорируемый четвёртый байт.
314 diamond 3454
  * Вызов функции 7 эквивалентен вызову этой функции с параметрами
3455
    esi=24, ebp=0.
283 diamond 3456
 
3457
======================================================================
92 diamond 3458
================= Функция 66 - работа с клавиатурой. =================
77 diamond 3459
======================================================================
92 diamond 3460
Режим ввода влияет на результаты чтения клавиш функцией 2.
131 diamond 3461
При загрузке программы для неё устанавливается ASCII-режим ввода.
77 diamond 3462
 
92 diamond 3463
-------- Подфункция 1 - установить режим ввода с клавиатуры. ---------
77 diamond 3464
Параметры:
3465
  * eax = 66 - номер функции
3466
  * ebx = 1 - номер подфункции
3467
  * ecx = режим:
3468
    * 0 = обычный (ASCII-символы)
3469
    * 1 = сканкоды
3470
Возвращаемое значение:
3471
  * функция не возвращает значения
3472
 
92 diamond 3473
--------- Подфункция 2 - получить режим ввода с клавиатуры. ----------
77 diamond 3474
Параметры:
3475
  * eax = 66 - номер функции
3476
  * ebx = 2 - номер подфункции
3477
Возвращаемое значение:
3478
  * eax = текущий режим
3479
 
3480
------- Подфункция 3 - получить состояние управляющих клавиш. --------
3481
Параметры:
3482
  * eax = 66 - номер функции
3483
  * ebx = 3 - номер подфункции
3484
Возвращаемое значение:
3485
  * eax = битовая маска:
3486
  * бит 0 (маска 1): левый Shift нажат
3487
  * бит 1 (маска 2): правый Shift нажат
3488
  * бит 2 (маска 4): левый Ctrl нажат
3489
  * бит 3 (маска 8): правый Ctrl нажат
3490
  * бит 4 (маска 0x10): левый Alt нажат
3491
  * бит 5 (маска 0x20): правый Alt нажат
131 diamond 3492
  * бит 6 (маска 0x40): CapsLock включён
3493
  * бит 7 (маска 0x80): NumLock включён
3494
  * бит 8 (маска 0x100): ScrollLock включён
77 diamond 3495
  * прочие биты сброшены
3496
 
92 diamond 3497
----- Подфункция 4 - установить общесистемную "горячую клавишу". -----
3498
О нажатии "горячей клавиши" извещаются только приложения,
131 diamond 3499
установившие её; активное приложение (к которому поступает
92 diamond 3500
весь нормальный ввод) таких клавиш не получает.
3501
Извещение заключается в посылке события с кодом 2.
3502
Прочитать "горячую клавишу" можно так же, как и обычную, -
3503
функцией 2.
3504
Параметры:
3505
  * eax = 66 - номер функции
3506
  * ebx = 4 - номер подфункции
131 diamond 3507
  * cl задаёт сканкод клавиши;
92 diamond 3508
    используйте cl=0 для задания комбинаций типа Ctrl+Shift
131 diamond 3509
  * edx = 0xXYZ задаёт возможные состояния управляющих клавиш:
3510
    * Z (младшие 4 бита) задаёт состояние клавиш LShift и RShift:
92 diamond 3511
      * 0 = ни одна из клавиш не должна быть нажата;
3512
      * 1 = ровно одна из клавиш должна быть нажата;
3513
      * 2 = обе клавиши должны быть нажаты;
3514
      * 3 = должна быть нажата LShift, но не RShift;
3515
      * 4 = должна быть нажата RShift, но не LShift
3516
    * Y - аналогично для LCtrl и RCtrl;
3517
    * X - аналогично для LAlt и RAlt
3518
Возвращаемое значение:
3519
  * eax=0 - успешно
3520
  * eax=1 - слишком много "горячих клавиш" (допускается максимум 256)
3521
Замечания:
3522
  * Горячая клавиша может срабатывать либо при нажатии,
3523
    либо при отпускании. Сканкод отпускания клавиши на 128 больше,
3524
    чем сканкод нажатия (т.е. установлен старший бит).
3525
  * Несколько приложений могут установить одну и ту же комбинацию;
3526
    о нажатии такой комбинации будут извещаться все такие приложения.
3527
 
3528
------ Подфункция 5 - удалить установленную "горячую клавишу". -------
3529
Параметры:
3530
  * eax = 66 - номер функции
3531
  * ebx = 5 - номер подфункции
3532
  * cl = сканкод клавиши и edx = 0xXYZ такие же, как и в подфункции 4
3533
Возвращаемое значение:
3534
  * eax = 0 - успешно
3535
  * eax = 1 - нет такой горячей клавиши
3536
Замечания:
3537
  * При завершении процесса/потока удаляются все установленные им
3538
    горячие клавиши.
3539
  * Вызов функции не влияет на другие приложения.
3540
    Если другое приложение определило эту же комбинацию,
3541
    оно по-прежнему будет получать уведомления.
3542
 
77 diamond 3543
======================================================================
3544
============ Функция 67 - изменить положение/размеры окна. ===========
3545
======================================================================
3546
Параметры:
3547
  * eax = 67 - номер функции
3548
  * ebx = новая x-координата окна
3549
  * ecx = новая y-координата окна
3550
  * edx = новый x-размер окна
3551
  * esi = новый y-размер окна
3552
Возвращаемое значение:
3553
  * функция не возвращает значения
3554
Замечания:
3555
  * Значение -1 для параметра означает "не изменять"; например, для
3556
    перемещения окна без изменения размеров можно указать edx=esi=-1.
3557
  * Предварительно окно должно быть определено функцией 0.
131 diamond 3558
    Она же задаёт начальные координаты и размеры окна.
77 diamond 3559
  * Размеры окна понимаются в смысле функции 0, т.е.
3560
    на один пиксель меньше, чем реальные размеры.
3561
  * Вызов функции для максимизированных окон просто игнорируется.
3562
  * Для окон соответствующих стилей положение и/или размеры могут быть
3563
    изменены пользователем; текущие положение и размеры могут быть
3564
    получены вызовом функции 9.
3565
  * Функция посылает окну событие перерисовки (с кодом 1).
3566
 
3567
======================================================================
131 diamond 3568
=== Функция 68, подфункция 0 - получить счётчик переключений задач. ==
77 diamond 3569
======================================================================
3570
Параметры:
3571
  * eax = 68 - номер функции
3572
  * ebx = 0 - номер подфункции
3573
Возвращаемое значение:
3574
  * eax = число переключений задач с момента загрузки системы
3575
    (по модулю 2^32)
3576
 
3577
======================================================================
3578
====================== Функция 68, подфункция 1 ======================
3579
============ Переключиться на следующий поток выполнения. ============
3580
======================================================================
3581
Функция завершает текущий квант времени, выделенный потоку,
3582
и переключается на следующий.
3583
(Какой поток какого процесса будет следующим, предсказать нельзя).
131 diamond 3584
Позднее, когда до текущего потока дойдёт очередь,
77 diamond 3585
выполнение возобновится.
3586
Параметры:
3587
  * eax = 68 - номер функции
3588
  * ebx = 1 - номер подфункции
3589
Возвращаемое значение:
3590
  * функция не возвращает значения
3591
 
3592
======================================================================
3593
=============== Функция 68, подфункция 2 - кэш + rdpmc. ==============
3594
======================================================================
3595
Параметры:
3596
  * eax = 68 - номер функции
3597
  * ebx = 2 - номер подфункции
3598
  * ecx = требуемое действие:
3599
    * ecx = 0 - разрешить выполнение инструкции rdpmc
3600
      (ReaD Performance-Monitoring Counters)
131 diamond 3601
    * ecx = 1 - узнать, включён/выключен кэш
77 diamond 3602
    * ecx = 2 - включить кэш
3603
    * ecx = 3 - выключить кэш
3604
Возвращаемое значение:
3605
  * для ecx=0:
3606
    * eax = значение cr4
3607
  * для ecx=1:
3608
    * eax = (cr0 and 0x60000000):
131 diamond 3609
    * eax = 0 - кэш включён
77 diamond 3610
    * eax <> 0 - кэш выключен
3611
  * для ecx=2 и ecx=3:
3612
    * функция не возвращает значения
3613
 
3614
======================================================================
3615
========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
3616
======================================================================
3617
MSR = Model Specific Register; полный список MSR-регистров процессора
3618
содержится в документации по процессору (например, IA-32 Intel
3619
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3620
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3621
Параметры:
3622
  * eax = 68 - номер функции
3623
  * ebx = 3 - номер подфункции
3624
  * ecx игнорируется
3625
  * edx = адрес MSR
3626
Возвращаемое значение:
3627
  * ebx:eax = старший:младший dword результата
3628
Замечания:
3629
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3630
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3631
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3632
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3633
    которое всё равно прибьёт поток.
77 diamond 3634
 
3635
======================================================================
3636
========= Функция 68, подфункция 4 - записать в MSR-регистр. =========
3637
======================================================================
3638
MSR = Model Specific Register; полный список MSR-регистров процессора
3639
содержится в документации по процессору (например, IA-32 Intel
3640
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3641
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3642
Параметры:
3643
  * eax = 68 - номер функции
3644
  * ebx = 4 - номер подфункции
3645
  * ecx игнорируется
3646
  * edx = адрес MSR
3647
  * esi:edi = старший:младший dword
3648
Возвращаемое значение:
499 diamond 3649
  * функция не возвращает значения
77 diamond 3650
Замечания:
3651
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3652
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3653
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3654
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3655
    которое всё равно прибьёт поток.
77 diamond 3656
 
3657
======================================================================
172 serge 3658
===== Функция 68, подфункция 11 - инициализировать кучу процесса. ====
77 diamond 3659
======================================================================
3660
Параметры:
3661
  * eax = 68 - номер функции
172 serge 3662
  * ebx = 11 - номер подфункции
77 diamond 3663
Возвращаемое значение:
172 serge 3664
  * eax = 0 - неуспех
3665
  * иначе размер созданной кучи
77 diamond 3666
Замечания:
172 serge 3667
  * Вызов функции инициализирует кучу, из которой впоследствии можно
3668
    выделять и освобождать блоки памяти подфункциями 12 и 13.
188 serge 3669
    Размер кучи равен размеру всей свободной памяти приложения.
277 diamond 3670
  * При повторном вызове функции тем же процессом функция вернёт
3671
    размер существующей кучи.
3672
  * После создания кучи вызовы функции 64 игнорируются.
77 diamond 3673
 
3674
======================================================================
172 serge 3675
========== Функция 68, подфункция 12 - выделить блок памяти. =========
77 diamond 3676
======================================================================
3677
Параметры:
3678
  * eax = 68 - номер функции
172 serge 3679
  * ebx = 12 - номер подфункции
3680
  * ecx = требуемый размер в байтах
77 diamond 3681
Возвращаемое значение:
172 serge 3682
  * eax = указатель на выделенный блок
77 diamond 3683
Замечания:
172 serge 3684
  * Предварительно следует инициализировать кучу процесса вызовом
3685
    подфункции 11.
3686
  * Функция выделяет целое число страниц (4 Кб) так, что фактический
3687
    размер выделенного блока больше или равен запрошенному.
77 diamond 3688
 
3689
======================================================================
172 serge 3690
========= Функция 68, подфункция 13 - освободить блок памяти. ========
77 diamond 3691
======================================================================
3692
Параметры:
3693
  * eax = 68 - номер функции
172 serge 3694
  * ebx = 13 - номер подфункции
3695
  * ecx = указатель на блок памяти
77 diamond 3696
Возвращаемое значение:
172 serge 3697
  * eax = 1 - успешно
3698
  * eax = 0 - неудача
77 diamond 3699
Замечания:
448 diamond 3700
  * Блок памяти должен быть ранее выделен подфункцией 12
3701
    или подфункцией 20.
77 diamond 3702
 
3703
======================================================================
172 serge 3704
===== Функция 68, подфункция 14 - ожидать извещения от драйвера. =====
77 diamond 3705
======================================================================
3706
Параметры:
3707
  * eax = 68 - номер функции
172 serge 3708
  * ebx = 14 - номер подфункции
3709
  * ecx = указатель на буфер для информации (8 байт)
77 diamond 3710
Возвращаемое значение:
172 serge 3711
  * буфер, на который указывает ecx, содержит следующую информацию:
3712
    * +0: dword: константа EV_INTR = 1
3713
    * +4: dword: данные драйвера
77 diamond 3714
Замечания:
172 serge 3715
  * Текущая реализация во время ожидания требует довольно "тяжёлых"
3716
    операций переключения контекста.
77 diamond 3717
 
3718
======================================================================
172 serge 3719
== Функция 68, подфункция 15 - установить обработчик исключений FPU. =
3720
======================================================================
3721
Параметры:
3722
  * eax = 68 - номер функции
3723
  * ebx = 15 - номер подфункции
3724
  * ecx = адрес нового обработчика исключений
3725
Возвращаемое значение:
3726
  * eax = адрес старого обработчика исключений
3727
    (0, если он не был установлен)
3728
 
3729
======================================================================
3730
=========== Функция 68, подфункция 16 - загрузить драйвер. ===========
3731
======================================================================
3732
Параметры:
3733
  * eax = 68 - номер функции
3734
  * ebx = 16 - номер подфункции
277 diamond 3735
  * ecx = указатель на ASCIIZ-строку с именем драйвера
172 serge 3736
Возвращаемое значение:
3737
  * eax = 0 - неудача
3738
  * иначе eax = хэндл драйвера
3739
Замечания:
3740
  * Если драйвер ещё не загружен, он загружается;
3741
    если драйвер уже загружен, ничего не меняется.
3742
  * Имя драйвера чувствительно к регистру символов.
277 diamond 3743
    Максимальная длина имени - 16 символов, включая завершающий
3744
    нулевой символ, остальные символы игнорируются.
346 diamond 3745
  * Драйвер с именем ABC загружается из файла /rd/1/drivers/ABC.obj.
172 serge 3746
 
3747
======================================================================
3748
========== Функция 68, подфункция 17 - управление драйвером. =========
3749
======================================================================
3750
Параметры:
3751
  * eax = 68 - номер функции
3752
  * ebx = 17 - номер подфункции
3753
  * ecx = указатель на управляющую структуру:
3754
    * +0: dword: хэндл драйвера
3755
    * +4: dword: код функции драйвера
3756
    * +8: dword: указатель на входные данные
3757
    * +12 = +0xC: dword: размер входных данных
3758
    * +16 = +0x10: dword: указатель на выходные данные
3759
    * +20 = +0x14: dword: размер выходных данных
3760
Возвращаемое значение:
3761
  * eax = определяется драйвером
3762
Замечания:
3763
  * Коды функций и структура входных/выходных данных
3764
    определяются драйвером.
3765
  * Предварительно должен быть получен хэндл драйвера подфункцией 16.
3766
 
3767
======================================================================
3768
== Функция 68, подфункция 18 - установить обработчик исключений SSE. =
3769
======================================================================
3770
Параметры:
3771
  * eax = 68 - номер функции
3772
  * ebx = 18 - номер подфункции
3773
  * ecx = адрес нового обработчика исключений
3774
Возвращаемое значение:
3775
  * eax = адрес старого обработчика исключений
3776
    (0, если он не был установлен)
3777
 
3778
======================================================================
277 diamond 3779
============= Функция 68, подфункция 19 - загрузить DLL. =============
3780
======================================================================
3781
Параметры:
3782
  * eax = 68 - номер функции
3783
  * ebx = 19 - номер подфункции
3784
  * ecx = указатель на ASCIIZ-строку с полным путём к DLL
3785
Возвращаемое значение:
3786
  * eax = 0 - неудача
3787
  * иначе eax = указатель на таблицу экспорта DLL
3788
Замечания:
3789
  * Таблица экспорта представляет собой массив структур по 2 dword'а,
3790
    заканчивающийся нулём. Первый dword в структуре является
3791
    указателем на имя функции, второй содержит адрес функции.
3792
 
3793
======================================================================
448 diamond 3794
====== Функция 68, подфункция 20 - перераспределить блок памяти. =====
3795
======================================================================
3796
Параметры:
3797
  * eax = 68 - номер функции
3798
  * ebx = 20 - номер подфункции
3799
  * ecx = новый размер в байтах
3800
  * edx = указатель на уже выделенный блок памяти
3801
Возвращаемое значение:
3802
  * eax = указатель на перераспределённый блок, 0 при ошибке
3803
Замечания:
3804
  * Предварительно следует инициализировать кучу процесса вызовом
3805
    подфункции 11.
3806
  * Функция выделяет целое число страниц (4 Кб) так, что фактический
3807
    размер выделенного блока больше или равен запрошенному.
3808
  * Если edx=0, то вызов функции эквивалентен выделению памяти
3809
    подфункцией 12. В противном случае блок памяти по адресу edx
3810
    должен быть ранее выделен подфункцией 12 или
3811
    описываемой подфункцией.
3812
  * Если ecx=0, то функция освобождает блок памяти по адресу edx и
3813
    возвращает 0.
3814
  * Содержимое памяти вплоть до наименьшего из старого и нового
3815
    размеров сохраняется.
3816
 
3817
======================================================================
77 diamond 3818
======================== Функция 69 - отладка. =======================
3819
======================================================================
3820
Процесс может загрузить другой процесс как отлаживаемый установкой
172 serge 3821
соответствующего бита при вызове подфункции 7 функции 70.
77 diamond 3822
У процесса может быть только один отладчик; один процесс может
3823
отлаживать несколько разных. Система уведомляет отладчик о событиях,
3824
происходящих с отлаживаемым процессом. Сообщения записываются в буфер,
131 diamond 3825
определённый подфункцией 0.
77 diamond 3826
Формат сообщения:
3827
  * +0: dword: код сообщения
3828
  * +4: dword: PID отлаживаемого процесса
3829
  * +8: могут присутствовать дополнительные данные,
3830
    определяемые кодом сообщения
3831
Коды сообщений:
3832
  * 1 = исключение
131 diamond 3833
    * дополнительно передаётся dword-номер исключения
77 diamond 3834
    * процесс приостановлен
3835
  * 2 = процесс завершился
3836
    * приходит при любом завершении: как через системную функцию -1,
3837
      так и при "убийстве" любым другим процессом
3838
      (в том числе самим отладчиком)
3839
  * 3 = отладочное исключение int 1 = #DB
131 diamond 3840
    * дополнительно передаётся dword-образ регистра DR6:
77 diamond 3841
      * биты 0-3: выполнено условие соответствующей точки останова
3842
        (установленной подфункцией 9)
3843
      * бит 14: исключение произошло из-за режима
3844
        пошаговой трассировки (установлен флаг TF)
3845
    * процесс приостановлен
3846
При завершении отладчика прибиваются все отлаживаемые процессы.
3847
Если отладчик этого не хочет, он должен предварительно отключиться
3848
подфункцией 3.
3849
 
667 diamond 3850
Все подфункции, кроме 4 и 5, применимы только к процессам/потокам,
3851
запущенным из текущего функцией 70 с установленным флагом отладки.
77 diamond 3852
Отладка многопоточных программ пока не поддерживается.
3853
Полный список подфункций:
3854
  * подфункция 0 - определить область данных для отладочных сообщений
3855
  * подфункция 1 - получить состояние регистров отлаживаемого потока
3856
  * подфункция 2 - установить состояние регистров отлаживаемого потока
3857
  * подфункция 3 - отключиться от отлаживаемого процесса
3858
  * подфункция 4 - приостановить отлаживаемый поток
3859
  * подфункция 5 - возобновить выполнение отлаживаемого потока
3860
  * подфункция 6 - прочитать из памяти отлаживаемого процесса
3861
  * подфункция 7 - записать в память отлаживаемого процесса
3862
  * подфункция 8 - завершить отлаживаемый поток
3863
  * подфункция 9 - установить/снять аппаратную точку останова
3864
 
3865
======================================================================
3866
====================== Функция 69, подфункция 0 ======================
3867
========= Определить область данных для отладочных сообщений. ========
3868
======================================================================
3869
Параметры:
3870
  * eax = 69 - номер функции
3871
  * ebx = 0 - номер подфункции
3872
  * ecx = указатель
3873
Формат области данных:
3874
  * +0: dword: N = размер буфера (не считая этого заголовка)
3875
  * +4: dword: занято в буфере
3876
  * +8: N*byte: буфер
3877
Возвращаемое значение:
3878
  * функция не возвращает значения
3879
Замечания:
3880
  * Если поле размера отрицательно, буфер считается заблокированным
3881
    и при поступлении нового сообщения система будет ждать.
3882
    Для синхронизации обрамляйте всю работу с буфером операциями
3883
    блокировки/разблокировки
131 diamond 3884
    	neg	[bufsize]
77 diamond 3885
  * Данные в буфере трактуются как массив элементов переменной длины -
3886
    сообщений. Формат сообщения указан в общем описании.
3887
 
3888
======================================================================
3889
====================== Функция 69, подфункция 1 ======================
3890
========= Получить состояние регистров отлаживаемого потока. =========
3891
======================================================================
3892
Параметры:
3893
  * eax = 69 - номер функции
3894
  * ebx = 1 - номер подфункции
3895
  * ecx = идентификатор потока
3896
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3897
  * esi = указатель на структуру контекста
77 diamond 3898
Возвращаемое значение:
3899
  * функция не возвращает значения
3900
Формат структуры контекста: (FPU пока не поддерживается)
3901
  * +0: dword: eip
3902
  * +4: dword: eflags
3903
  * +8: dword: eax
3904
  * +12 = +0xC: dword: ecx
3905
  * +16 = +0x10: dword: edx
3906
  * +20 = +0x14: dword: ebx
3907
  * +24 = +0x18: dword: esp
3908
  * +28 = +0x1C: dword: ebp
3909
  * +32 = +0x20: dword: esi
3910
  * +36 = +0x24: dword: edi
3911
Замечания:
3912
  * Если поток выполняет код 0-кольца, возвращается
3913
    состояние регистров 3-кольца.
3914
  * Процесс должен быть загружен для отладки (как указано в
3915
    общем описании).
3916
 
3917
======================================================================
3918
====================== Функция 69, подфункция 2 ======================
3919
======== Установить состояние регистров отлаживаемого потока. ========
3920
======================================================================
3921
Параметры:
3922
  * eax = 69 - номер функции
3923
  * ebx = 2 - номер подфункции
3924
  * ecx = идентификатор потока
3925
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3926
  * esi = указатель на структуру контекста
77 diamond 3927
Возвращаемое значение:
3928
  * функция не возвращает значения
3929
Формат структуры контекста указан в описании подфункции 1.
3930
Замечания:
3931
  * Если поток выполняет код 0-кольца, устанавливается
3932
    состояние регистров 3-кольца.
3933
  * Процесс должен быть загружен для отладки (как указано в
3934
    общем описании).
3935
 
3936
======================================================================
3937
== Функция 69, подфункция 3 - отключиться от отлаживаемого процесса. =
3938
======================================================================
3939
Параметры:
3940
  * eax = 69 - номер функции
3941
  * ebx = 3 - номер подфункции
3942
  * ecx = идентификатор
3943
Возвращаемое значение:
3944
  * функция не возвращает значения
3945
Замечания:
3946
  * Если процесс был приостановлен, он возобновляет выполнение.
3947
 
3948
======================================================================
667 diamond 3949
=========== Функция 69, подфункция 4 - приостановить поток. ==========
77 diamond 3950
======================================================================
3951
Параметры:
3952
  * eax = 69 - номер процесса
3953
  * ebx = 4 - номер подфункции
3954
  * ecx = идентификатор
3955
Возвращаемое значение:
3956
  * функция не возвращает значения
3957
 
3958
======================================================================
3959
====================== Функция 69, подфункция 5 ======================
667 diamond 3960
=================== Возобновить выполнение потока. ===================
77 diamond 3961
======================================================================
3962
Параметры:
3963
  * eax = 69 - номер функции
3964
  * ebx = 5 - номер подфункции
3965
  * ecx = идентификатор
3966
Возвращаемое значение:
3967
  * функция не возвращает значения
3968
 
3969
======================================================================
3970
====================== Функция 69, подфункция 6 ======================
3971
============= Прочитать из памяти отлаживаемого процесса. ============
3972
======================================================================
3973
Параметры:
3974
  * eax = 69 - номер функции
3975
  * ebx = 6 - номер подфункции
3976
  * ecx = идентификатор
3977
  * edx = сколько байт читать
3978
  * esi = адрес памяти отлаживаемого процесса
3979
  * edi = указатель на буфер для данных
3980
Возвращаемое значение:
3981
  * eax = -1 при ошибке (неверный PID или буфер)
3982
  * иначе eax = число прочитанных байт (возможно, 0,
3983
    если в esi слишком большое значение)
3984
Замечания:
3985
  * Процесс должен быть загружен для отладки (как указано в
3986
    общем описании).
3987
 
3988
======================================================================
802 serge 3989
 Функция 69, подфункция 7 - записать в память отлаживаемого процесса.
77 diamond 3990
======================================================================
3991
Параметры:
3992
  * eax = 69 - номер функции
3993
  * ebx = 7 - номер подфункции
3994
  * ecx = идентификатор
3995
  * edx = сколько байт писать
3996
  * esi = адрес памяти в отлаживаемом процессе
3997
  * edi = указатель на данные
3998
Возвращаемое значение:
3999
  * eax = -1 при ошибке (неверный PID или буфер)
4000
  * иначе eax = число записанных байт (возможно, 0,
4001
    если в esi слишком большое значение)
4002
Замечания:
4003
  * Процесс должен быть загружен для отладки (как указано в
4004
    общем описании).
4005
 
4006
======================================================================
4007
====== Функция 69, подфункция 8 - завершить отлаживаемый поток. ======
4008
======================================================================
4009
Параметры:
4010
  * eax = 69 - номер функции
4011
  * ebx = 8 - номер подфункции
4012
  * ecx = идентификатор
4013
Возвращаемое значение:
4014
  * функция не возвращает значения
4015
Замечания:
4016
  * Процесс должен быть загружен для отладки (как указано в
4017
    общем описании).
4018
  * Функция аналогична подфункции 2 функции 18 с двумя отличиями:
4019
    требуется выполнение первого замечания и принимается PID,
4020
    а не номер слота.
4021
 
4022
======================================================================
4023
====================== Функция 69, подфункция 9 ======================
4024
============= Установить/снять аппаратную точку останова. ============
4025
======================================================================
4026
Параметры:
4027
  * eax = 69 - номер функции
4028
  * ebx = 9 - номер подфункции
4029
  * ecx = идентификатор потока
4030
  * dl = индекс точки останова, от 0 до 3 включительно
4031
  * dh = флаги:
4032
    * если старший бит сброшен - установить точку останова:
4033
      * биты 0-1 - условие:
4034
        * 00 = точка останова на выполнение
4035
        * 01 = точка останова на запись
4036
        * 11 = точка останова на чтение/запись
4037
      * биты 2-3 - длина; для точек останова на исполнение должно быть
4038
        00, в противном случае одно из
4039
        * 00 = байт
4040
        * 01 = слово
4041
        * 11 = двойное слово
4042
      * esi = адрес точки останова; должен быть выровнен
131 diamond 4043
        соответственно длине (т.е. должен быть чётным для
77 diamond 4044
        точек останова на слово, кратен 4 для двойного слова)
4045
    * если старший бит установлен - сбросить точку останова
4046
Возвращаемое значение:
4047
  * eax = 0 - успешно
4048
  * eax = 1 - ошибка во входных данных
4049
  * eax = 2 - (зарезервировано, никогда не возвращается
4050
    в текущей реализации) с этим индексом уже установлена
4051
    глобальная точка останова
4052
Замечания:
4053
  * Процесс должен быть загружен для отладки (как указано в
4054
    общем описании).
4055
  * Аппаратные точки останова реализуются через DRx-регистры
4056
    процессора, отсюда все ограничения.
4057
  * Функция может переустановить ранее установленную ей же
4058
    точку останова (никак не сообщая об этом).
4059
    Ведите список установленных точек останова в отладчике.
4060
  * Срабатывание точки останова заключается в генерировании
4061
    отладочного исключения #DB, о котором система сообщает отладчику.
4062
  * Точка останова на запись и чтение/запись срабатывает после
131 diamond 4063
    выполнения вызвавшей её инструкции.
77 diamond 4064
 
4065
======================================================================
131 diamond 4066
= Функция 70 - работа с файловой системой с поддержкой длинных имён. =
77 diamond 4067
======================================================================
4068
Параметры:
4069
  * eax = 70
4070
  * ebx = указатель на информационную структуру
4071
Возвращаемое значение:
4072
  * eax = 0 - успешно; иначе код ошибки файловой системы
4073
  * в зависимости от подфункции может возвращаться значение и
4074
    в других регистрах
4075
Общий формат информационной структуры:
4076
  * +0: dword: номер подфункции
4077
  * +4: dword: смещение в файле
91 diamond 4078
  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
77 diamond 4079
  * +12 = +0xC: dword: размер
4080
  * +16 = +0x10: dword: указатель на данные
4081
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
86 diamond 4082
    или
4083
  * +20 = +0x14: db 0
4084
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4085
Уточнения - в документации на соответствующую подфункцию.
4086
Имя файла нечувствительно к регистру букв. Русские буквы должны быть
4087
записаны в кодировке cp866 (DOS).
4088
Формат имени файла:
4089
/base/number/dir1/dir2/.../dirn/file,
4090
где /base/number идентифицирует устройство, на котором ищется файл:
4091
одно из
4092
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
4093
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
4094
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
4095
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
131 diamond 4096
    к жёстким дискам на IDE0 (Primary Master), IDE1 (Primary Slave),
77 diamond 4097
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4098
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
4099
    (на каждом из винчестеров нумерация начинается с 1)
91 diamond 4100
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 для доступа соответственно
4101
    к CD на IDE0 (Primary Master), IDE1 (Primary Slave),
118 diamond 4102
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
546 diamond 4103
  * /SYS - определяет системную папку; при обычной загрузке системы
4104
    с дискеты эквивалентно /RD/1
77 diamond 4105
Примеры:
83 diamond 4106
  * '/rd/1/kernel.asm',0
77 diamond 4107
  * '/HD0/1/kernel.asm',0
4108
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4109
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
546 diamond 4110
  * '/sys/MySuperApp.ini',0
77 diamond 4111
Доступные подфункции:
4112
  * подфункция 0 - чтение файла
4113
  * подфункция 1 - чтение папки
83 diamond 4114
  * подфункция 2 - создание/перезапись файла
131 diamond 4115
  * подфункция 3 - запись в существующий файл
133 diamond 4116
  * подфункция 4 - установка размера файла
86 diamond 4117
  * подфункция 5 - получение атрибутов файла/папки
4118
  * подфункция 6 - установка атрибутов файла/папки
91 diamond 4119
  * подфункция 7 - запуск программы
172 serge 4120
  * подфункция 8 - удаление файла/папки
321 diamond 4121
  * подфункция 9 - создание папки
118 diamond 4122
Для CD-приводов в связи с аппаратными ограничениями доступны
4123
только подфункции 0,1,5 и 7, вызов других подфункций завершится
4124
ошибкой с кодом 2.
641 diamond 4125
При первом обращении подфункций 0,1,5,7 к устройствам ATAPI
4126
(CD и DVD) производится блокировка ручного управления механизмом
4127
лотка. Это связано с кэшированием данных, полученных от привода.
4128
Разблокировка осуществляется при обращении подфункции 4 функции 24
4129
к соответствующему устройству.
77 diamond 4130
 
4131
======================================================================
131 diamond 4132
= Функция 70, подфункция 0 - чтение файла с поддержкой длинных имён. =
77 diamond 4133
======================================================================
4134
Параметры:
4135
  * eax = 70 - номер функции
4136
  * ebx = указатель на информационную структуру
4137
Формат информационной структуры:
4138
  * +0: dword: 0 = номер подфункции
4139
  * +4: dword: позиция в файле (в байтах)
4140
  * +8: dword: 0 (зарезервировано под старший dword позиции)
4141
  * +12 = +0xC: dword: сколько байт читать
4142
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
131 diamond 4143
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 4144
    общем описании
86 diamond 4145
    или
4146
  * +20 = +0x14: db 0
4147
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4148
Возвращаемое значение:
4149
  * eax = 0 - успешно, иначе код ошибки файловой системы
4150
  * ebx = число прочитанных байт или
4151
    -1=0xffffffff, если файл не найден
4152
Замечания:
4153
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 4154
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 4155
    eax=6 (EOF).
4156
  * Функция не позволяет читать папки
131 diamond 4157
    (вернётся eax=10, access denied).
77 diamond 4158
 
4159
======================================================================
131 diamond 4160
= Функция 70, подфункция 1 - чтение папки с поддержкой длинных имён. =
77 diamond 4161
======================================================================
4162
Параметры:
4163
  * eax = 70 - номер функции
4164
  * ebx = указатель на информационную структуру
4165
Формат информационной структуры:
4166
  * +0: dword: 1 = номер подфункции
4167
  * +4: dword: индекс начального блока (считая с 0)
78 diamond 4168
  * +8: dword: поле флагов:
4169
    * бит 0 (маска 1): в каком формате возвращать имена,
4170
      0=ANSI, 1=UNICODE
4171
    * прочие биты зарезервированы и должны быть установлены в 0
4172
      для будущей совместимости
77 diamond 4173
  * +12 = +0xC: dword: сколько блоков читать
4174
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
4175
    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
131 diamond 4176
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
77 diamond 4177
    общем описании
86 diamond 4178
    или
4179
  * +20 = +0x14: db 0
4180
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4181
Возвращаемое значение:
4182
  * eax = 0 - успешно, иначе код ошибки файловой системы
4183
  * ebx = число файлов, информация о которых была записана в буфер,
4184
    или -1=0xffffffff, если папка не найдена
4185
Структура буфера:
4186
  * +0: 32*byte: заголовок
4187
  * +32 = +0x20: n1*byte: блок с информацией о файле 1
4188
  * +32+n1: n2*byte: блок с информацией о файле 2
4189
  * ...
4190
Структура заголовка:
4191
  * +0: dword: версия структуры (текущая версия = 1)
131 diamond 4192
  * +4: dword: количество размещённых блоков; не больше, чем запрошено
77 diamond 4193
    в поле +12 информационной структуры; может быть меньше,
4194
    если в папке кончились файлы (то же самое, что и в ebx)
4195
  * +8: dword: общее число файлов в папке
4196
  * +12 = +0xC: 20*byte: зарезервировано (нули)
4197
Структура блока данных входа каталога (БДВК):
4198
  * +0: dword: атрибуты файла:
4199
    * бит 0 (маска 1): файл только для чтения
4200
    * бит 1 (маска 2): файл является скрытым
4201
    * бит 2 (маска 4): файл является системным
4202
    * бит 3 (маска 8): это не файл, а метка тома
4203
      (на заданном разделе встречается не более одного раза и
4204
      только в корневой папке)
4205
    * бит 4 (маска 0x10): это папка
4206
    * бит 5 (маска 0x20): файл не архивировался - многие программы
4207
      архивации имеют опцию, по которой архивируются только файлы
4208
      с установленным этим битом, после чего этот бит сбрасывается -
4209
      это может быть полезно для автоматического создания
4210
      backup-архивов, ибо при записи бит обычно устанавливается
4211
      (не в Kolibri, правда)
78 diamond 4212
  * +4: byte: тип данных имени:
4213
    (совпадает с битом 0 флагов информационной структуры)
77 diamond 4214
    * 0 = ASCII = 1-байтное представление каждого символа
4215
    * 1 = UNICODE = 2-байтное представление каждого символа
4216
  * +5: 3*byte: зарезервировано (нули)
4217
  * +8: 4*byte: время создания файла
4218
  * +12 = +0xC: 4*byte: дата создания файла
4219
  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
4220
  * +20 = +0x14: 4*byte: дата последнего доступа
4221
  * +24 = +0x18: 4*byte: время последней модификации
4222
  * +28 = +0x1C: 4*byte: дата последней модификации
4223
  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
4224
  * +40 = +0x28: имя
4225
    * для формата ASCII: максимальная длина имени 263 символа
4226
      (263 байта), байт после имени имеет значение 0
4227
    * для формата UNICODE: максимальная длина имени 259 символов
4228
      (518 байт), два байта после имени имеют значение 0
4229
Формат времени:
4230
  * +0: byte: секунды
4231
  * +1: byte: минуты
4232
  * +2: byte: часы
4233
  * +3: byte: зарезервировано (0)
4234
  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
4235
Формат даты:
4236
  * +0: byte: день
4237
  * +1: byte: месяц
4238
  * +2: word: год
4239
  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
4240
Замечания:
4241
  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
4242
    304 байта, если в UNICODE - 560 байт. Значение длины выравнено
4243
    на целое кратное 16 байт
4244
    (для ускорения обработки в кэш-памяти CPU).
78 diamond 4245
  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
4246
    данные содержат мусор.
77 diamond 4247
  * Если файлы в папке кончились раньше, чем было прочитано
4248
    запрошенное количество, то функция прочитает, сколько сможет,
131 diamond 4249
    после чего вернёт eax=6 (EOF).
77 diamond 4250
  * Любая папка на диске, кроме корневой, содержит два специальных
4251
    входа "." и "..", идентифицирующих соответственно саму папку и
4252
    родительскую папку.
4253
  * Функция позволяет также читать виртуальные папки "/", "/rd",
4254
    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
4255
    0x10, а времена и даты обнулены. Альтернативный способ получения
4256
    информации об оборудовании - подфункция 11 функции 18.
4257
 
4258
======================================================================
83 diamond 4259
====================== Функция 70, подфункция 2 ======================
131 diamond 4260
======== Создание/перезапись файла с поддержкой длинных имён. ========
83 diamond 4261
======================================================================
4262
Параметры:
4263
  * eax = 70 - номер функции
4264
  * ebx = указатель на информационную структуру
4265
Формат информационной структуры:
4266
  * +0: dword: 2 = номер подфункции
4267
  * +4: dword: 0 (зарезервировано)
4268
  * +8: dword: 0 (зарезервировано)
4269
  * +12 = +0xC: dword: сколько байт писать
4270
  * +16 = +0x10: dword: указатель на данные
131 diamond 4271
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
83 diamond 4272
    общем описании
86 diamond 4273
    или
4274
  * +20 = +0x14: db 0
4275
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
83 diamond 4276
Возвращаемое значение:
4277
  * eax = 0 - успешно, иначе код ошибки файловой системы
4278
  * ebx = число записанных байт (возможно, 0)
4279
Замечания:
131 diamond 4280
  * Если файл с таким именем не существовал, он создаётся; если
83 diamond 4281
    существовал, то перезаписывается.
4282
  * Если свободного места на диске недостаточно, то функция запишет,
131 diamond 4283
    сколько сможет, после чего вернёт код ошибки 8.
4284
  * Функция не поддерживается для CD (вернётся код ошибки 2).
83 diamond 4285
 
4286
======================================================================
131 diamond 4287
====================== Функция 70, подфункция 3 ======================
4288
======== Запись в существующий файл с поддержкой длинных имён. =======
4289
======================================================================
4290
Параметры:
4291
  * eax = 70 - номер функции
4292
  * ebx = указатель на информационную структуру
4293
Формат информационной структуры:
4294
  * +0: dword: 3 = номер подфункции
4295
  * +4: dword: позиция в файле (в байтах)
4296
  * +8: dword: старший dword позиции (должен быть 0 для FAT)
4297
  * +12 = +0xC: dword: сколько байт писать
4298
  * +16 = +0x10: dword: указатель на данные
4299
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4300
    общем описании
4301
    или
4302
  * +20 = +0x14: db 0
4303
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4304
Возвращаемое значение:
4305
  * eax = 0 - успешно, иначе код ошибки файловой системы
4306
  * ebx = число записанных байт (возможно, 0)
4307
Замечания:
4308
  * Файл должен уже существовать, иначе вернётся eax=5.
4309
  * Единственным результатом записи 0 байт является установка в
4310
    атрибутах файла даты/времени модификации и доступа в текущую.
4311
  * Если начальная и/или конечная позиция выходит за пределы файла
4312
    (за исключением предыдущего случая), файл расширяется до
4313
    необходимого размера нулевыми символами.
133 diamond 4314
  * Функция не поддерживается для CD (вернётся код ошибки 2).
131 diamond 4315
 
4316
======================================================================
133 diamond 4317
========= Функция 70, подфункция 4 - установка размера файла. ========
4318
======================================================================
4319
Параметры:
4320
  * eax = 70 - номер функции
4321
  * ebx = указатель на информационную структуру
4322
Формат информационной структуры:
4323
  * +0: dword: 4 = номер подфункции
4324
  * +4: dword: младший dword нового размера файла
4325
  * +8: dword: старший dword нового размера файла
4326
                   (должен быть 0 для FAT)
4327
  * +12 = +0xC: dword: 0 (зарезервировано)
4328
  * +16 = +0x10: dword: 0 (зарезервировано)
4329
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4330
    общем описании
4331
    или
4332
  * +20 = +0x14: db 0
4333
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4334
Возвращаемое значение:
4335
  * eax = 0 - успешно, иначе код ошибки файловой системы
4336
  * ebx разрушается
4337
Замечания:
4338
  * Если новый размер файла меньше старого, файл усекается. Если
4339
    новый размер больше старого, файл расширяется нулевыми символами.
4340
    Если новый размер равен старому, единственным результатом вызова
4341
    является установка даты/времени модификации и доступа в текущие.
4342
  * Если свободного места на диске недостаточно для расширения файла,
4343
    то функция расширит насколько возможно, после чего вернёт
4344
    код ошибки 8.
4345
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4346
 
4347
======================================================================
86 diamond 4348
=== Функция 70, подфункция 5 - получение информации о файле/папке. ===
4349
======================================================================
4350
Параметры:
4351
  * eax = 70 - номер функции
4352
  * ebx = указатель на информационную структуру
4353
Формат информационной структуры:
4354
  * +0: dword: 5 = номер подфункции
4355
  * +4: dword: 0 (зарезервировано)
4356
  * +8: dword: 0 (зарезервировано)
4357
  * +12 = +0xC: dword: 0 (зарезервировано)
4358
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
4359
                        (40 байт)
131 diamond 4360
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4361
    общем описании
4362
    или
4363
  * +20 = +0x14: db 0
4364
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4365
Возвращаемое значение:
4366
  * eax = 0 - успешно, иначе код ошибки файловой системы
4367
  * ebx разрушается
4368
Информация о файле возвращается в формате БДВК
4369
(блока данных входа каталога), указанном в описании
4370
подфункции 1, но без имени файла
4371
(то есть первые 40 = 0x28 байт).
4372
Замечания:
4373
  * Функция не поддерживает виртуальные папки типа /, /rd и
4374
    корневые папки типа /rd/1.
4375
 
4376
======================================================================
4377
===== Функция 70, подфункция 6 - установка атрибутов файла/папки. ====
4378
======================================================================
4379
Параметры:
4380
  * eax = 70 - номер функции
4381
  * ebx = указатель на информационную структуру
4382
Формат информационной структуры:
4383
  * +0: dword: 6 = номер подфункции
4384
  * +4: dword: 0 (зарезервировано)
4385
  * +8: dword: 0 (зарезервировано)
4386
  * +12 = +0xC: dword: 0 (зарезервировано)
4387
  * +16 = +0x10: dword: указатель на буфер с атрибутами (32 байта)
131 diamond 4388
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4389
    общем описании
4390
    или
4391
  * +20 = +0x14: db 0
4392
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4393
Возвращаемое значение:
4394
  * eax = 0 - успешно, иначе код ошибки файловой системы
4395
  * ebx разрушается
4396
Атрибуты файла - первые 32 байта в БДВК (блоке данных входа каталога),
4397
формат которого указан в описании подфункции 1
4398
(то есть без имени и размера файла). Атрибут файл/папка/метка тома
4399
(биты 3,4 в dword'е +0) не меняется.
4400
Байт +4 (формат имени) игнорируется.
4401
Замечания:
4402
  * Функция не поддерживает виртуальные папки типа /, /rd и
4403
    корневые папки типа /rd/1.
131 diamond 4404
  * Функция не поддерживается для CD (вернётся код ошибки 2).
86 diamond 4405
 
4406
======================================================================
91 diamond 4407
============ Функция 70, подфункция 7 - запуск программы. ============
4408
======================================================================
4409
Параметры:
4410
  * eax = 70 - номер функции
4411
  * ebx = указатель на информационную структуру
4412
Формат информационной структуры:
4413
  * +0: dword: 7 = номер подфункции
4414
  * +4: dword: поле флагов:
4415
    * бит 0: запустить процесс как отлаживаемый
4416
    * остальные биты зарезервированы и должны быть установлены в 0
4417
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
4418
  * +12 = +0xC: dword: 0 (зарезервировано)
4419
  * +16 = +0x10: dword: 0 (зарезервировано)
131 diamond 4420
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
91 diamond 4421
    общем описании
4422
    или
4423
  * +20 = +0x14: db 0
4424
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4425
Возвращаемое значение:
4426
  * eax > 0 - программа загружена, eax содержит PID
4427
  * eax < 0 - произошла ошибка, -eax содержит
4428
    код ошибки файловой системы
4429
  * ebx разрушается
4430
Замечания:
4431
  * Командная строка должна заканчиваться символом с кодом 0
4432
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
4433
    включительно, либо первые 256 символов, в зависимости от того,
4434
    что меньше.
131 diamond 4435
  * Если процесс запускается как отлаживаемый, он создаётся
91 diamond 4436
    в замороженном состоянии; для запуска используйте
4437
    подфункцию 5 функции 69.
4438
 
4439
======================================================================
172 serge 4440
========== Функция 70, подфункция 8 - удаление файла/папки. ==========
4441
======================================================================
4442
Параметры:
4443
  * eax = 70 - номер функции
4444
  * ebx = указатель на информационную структуру
4445
Формат информационной структуры:
4446
  * +0: dword: 8 = номер подфункции
4447
  * +4: dword: 0 (зарезервировано)
4448
  * +8: dword: 0 (зарезервировано)
4449
  * +12 = +0xC: dword: 0 (зарезервировано)
4450
  * +16 = +0x10: dword: 0 (зарезервировано)
4451
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4452
    общем описании
4453
    или
4454
  * +20 = +0x14: db 0
4455
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4456
Возвращаемое значение:
4457
  * eax = 0 - успешно, иначе код ошибки файловой системы
4458
  * ebx разрушается
4459
Замечания:
4460
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4461
  * Можно удалять только пустые папки (попытка удаления непустой папки
4462
    приведёт к ошибке с кодом 10, "доступ запрещён").
4463
 
4464
======================================================================
321 diamond 4465
============= Функция 70, подфункция 9 - создание папки. =============
4466
======================================================================
4467
Параметры:
4468
  * eax = 70 - номер функции
4469
  * ebx = указатель на информационную структуру
4470
Формат информационной структуры:
4471
  * +0: dword: 9 = номер подфункции
4472
  * +4: dword: 0 (зарезервировано)
4473
  * +8: dword: 0 (зарезервировано)
4474
  * +12 = +0xC: dword: 0 (зарезервировано)
4475
  * +16 = +0x10: dword: 0 (зарезервировано)
4476
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
4477
    общем описании
4478
    или
4479
  * +20 = +0x14: db 0
4480
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем папки
4481
Возвращаемое значение:
4482
  * eax = 0 - успешно, иначе код ошибки файловой системы
4483
  * ebx разрушается
4484
Замечания:
4485
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4486
  * Родительская папка должна уже существовать.
4487
  * Если папка уже существует, функция завершится успешно (eax=0).
4488
 
4489
======================================================================
118 diamond 4490
=== Функция 71, подфункция 1 - установить заголовок окна программы. ==
114 mikedld 4491
======================================================================
4492
Параметры:
4493
  * eax = 71 - номер функции
4494
  * ebx = 1 - номер подфункции
118 diamond 4495
  * ecx = адрес строки заголовка
114 mikedld 4496
Возвращаемое значение:
118 diamond 4497
  * функция не возвращает значения
114 mikedld 4498
Замечания:
4499
  * Строка заголовка должна быть в формате ASCIIZ. В заголовке
118 diamond 4500
    отображается не более 255 символов независимо от полной длины
114 mikedld 4501
    строки.
118 diamond 4502
  * Чтобы убрать заголовок, передайте NULL в ecx.
114 mikedld 4503
 
4504
======================================================================
665 diamond 4505
================ Функция 72 - послать сообщение окну. ================
4506
======================================================================
4507
 
4508
--- Подфункция 1 - послать сообщение с параметром активному окну. ----
4509
Параметры:
4510
  * eax = 72 - номер функции
4511
  * ebx = 1 - номер подфункции
4512
  * ecx = код события: 2 или 3
4513
  * edx = код клавиши для ecx=2, идентификатор кнопки для ecx=3
4514
Возвращаемое значение:
4515
  * eax = 0 - успешно
4516
  * eax = 1 - буфер заполнен
4517
 
4518
======================================================================
77 diamond 4519
========== Функция -1 - завершить выполнение потока/процесса =========
4520
======================================================================
4521
Параметры:
4522
  * eax = -1 - номер функции
4523
Возвращаемое значение:
4524
  * функция не возвращает ни значения, ни управления
4525
Замечания:
4526
  * Если процесс явно не создавал потоков, то у него есть только
4527
    один поток, завершение которого приводит к завершению процесса.
4528
  * Если текущий поток - последний в процессе, то его завершение
4529
    также приводит к завершению процесса.
4530
  * Эта функция завершает текущий поток. Другой поток можно прибить
4531
    вызовом подфункции 2 функции 18.
4532
 
4533
======================================================================
4534
=========================== Список событий ===========================
4535
======================================================================
4536
Очередное событие можно получить вызовом одной из функций 10
4537
(ожидать события), 11 (проверить без ожидания), 23
4538
(ожидать в течение заданного времени).
4539
Эти функции возвращают только те события, которые входят в маску,
4540
устанавливаемую функцией 40. По умолчанию это первые три, чего
4541
вполне достаточно для многих приложений.
4542
Коды событий:
4543
  * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
4544
  * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
92 diamond 4545
    активно) или нажата "горячая клавиша";
4546
    сбрасывается, когда все клавиши из буфера считаны функцией 2
131 diamond 4547
  * 3 = нажата кнопка, определённая ранее функцией 8 (или кнопка
77 diamond 4548
    закрытия, созданная неявно функцией 0; кнопка минимизации
4549
    обрабатывается системой и о ней сообщения не приходит;
4550
    поступает, только когда окно активно; сбрасывается, когда все
4551
    кнопки из буфера считаны функцией 17)
4552
  * 4 = зарезервировано (в текущей реализации никогда не приходит даже
4553
    при размаскировке функцией 40)
4554
  * 5 = перерисовывается фон рабочего стола (сбрасывается
4555
    автоматически после перерисовки, так что если во время перерисовки
131 diamond 4556
    фона программа не ждёт и не проверяет события, то этого события
77 diamond 4557
    она не заметит)
4558
  * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
4559
    или перемещение; сбрасывается при прочтении)
4560
  * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
4561
    Communication; сбрасывается при прочтении)
4562
  * 8 = произошло сетевое событие (сбрасывается при прочтении;
4563
    смотри работу с сетью)
4564
  * 9 = произошло отладочное событие (сбрасывается при прочтении;
4565
    смотри отладочную подсистему)
4566
  * 16..31 = произошло событие с соответствующим IRQ
4567
    (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)
4568
 
4569
======================================================================
4570
==================== Коды ошибок файловой системы ====================
4571
======================================================================
4572
  * 0 = успешно
131 diamond 4573
  * 1 = не определена база и/или раздел жёсткого диска (подфункциями
77 diamond 4574
    7, 8 функции 21)
4575
  * 2 = функция не поддерживается для данной файловой системы
4576
  * 3 = неизвестная файловая система
448 diamond 4577
  * 4 = зарезервировано, никогда не возвращается в текущей реализации
77 diamond 4578
  * 5 = файл не найден
4579
  * 6 = файл закончился
4580
  * 7 = указатель вне памяти приложения
4581
  * 8 = диск заполнен
4582
  * 9 = таблица FAT разрушена
131 diamond 4583
  * 10 = доступ запрещён
83 diamond 4584
  * 11 = ошибка устройства
77 diamond 4585
При запуске программы возможны также следующие коды ошибок:
4586
  * 30 = 0x1E = недостаточно памяти
4587
  * 31 = 0x1F = файл не является исполнимым
172 serge 4588
  * 32 = 0x20 = слишком много процессов