Subversion Repositories Kolibri OS

Rev

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

Rev Author Line No. Line
1018 diamond 1
СИСТЕМНЫЕ ФУНКЦИИ ОПЕРАЦИОННОЙ СИСТЕМЫ Kolibri 0.7.5.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 - неперемещаемое окно
1074 Galkov 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
    устанавливается в размер экрана.
1018 diamond 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
======================================================================
228
=============== Функция 6 - прочитать файл с рамдиска. ===============
229
======================================================================
230
Параметры:
231
  * eax = 6 - номер функции
232
  * ebx = указатель на имя файла
233
  * ecx = номер стартового блока, считая с 1;
234
    ecx=0 - читать с начала файла (то же самое, что и ecx=1)
235
  * edx = число блоков для чтения;
236
    edx=0 - читать один блок (то же самое, что и edx=1)
237
  * esi = указатель на область памяти, куда будут записаны данные
238
Возвращаемое значение:
239
  * eax = длина файла в байтах, если файл успешно прочитан
240
  * eax = -1, если файл не найден
241
Замечания:
242
  * Данная функция является устаревшей; функция 70
243
    позволяет выполнять те же действия с расширенными возможностями.
244
  * Блок = 512 байт.
245
  * Для чтения всего файла можно указать заведомо большое значение
246
    в edx, например, edx = -1; но в этом случае будьте готовы к тому,
247
    что программа "упадет", если файл окажется слишком большим
248
    и "не влезет" в память программы.
249
  * Имя файла должно быть либо в формате 8+3 символов
250
    (первые 8 символов - собственно имя, последние 3 - расширение,
251
    короткие имена и расширения дополняются пробелами),
252
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
253
    (имя не более 8 символов, точка, расширение 3 символа,
254
    дополненное при необходимости пробелами).
255
    Имя файла должно быть записано заглавными буквами.
256
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 257
  * Эта функция не поддерживает папки на рамдиске.
77 diamond 258
 
259
======================================================================
260
=============== Функция 7 - вывести изображение в окно. ==============
261
======================================================================
262
Параметры:
263
  * eax = 7 - номер функции
81 diamond 264
  * ebx = указатель на изображение в формате BBGGRRBBGGRR...
77 diamond 265
  * ecx = [размер по оси x]*65536 + [размер по оси y]
266
  * edx = [координата по оси x]*65536 + [координата по оси y]
267
Возвращаемое значение:
268
  * функция не возвращает значения
269
Замечания:
270
  * Координаты изображения - это координаты верхнего левого угла
271
    изображения относительно окна.
272
  * Размер изображения в байтах есть 3*xsize*ysize.
273
 
274
======================================================================
275
=============== Функция 8 - определить/удалить кнопку. ===============
276
======================================================================
277
Параметры для определения кнопки:
278
  * eax = 8 - номер функции
279
  * ebx = [координата по оси x]*65536 + [размер по оси x]
280
  * ecx = [координата по оси y]*65536 + [размер по оси y]
281
  * edx = 0xXYnnnnnn, где:
282
    * nnnnnn = идентификатор кнопки
283
    * старший (31-й) бит edx сброшен
284
    * если 30-й бит edx установлен - не прорисовывать кнопку
285
    * если 29-й бит edx установлен - не рисовать рамку
286
      при нажатии на кнопку
287
  * esi = 0x00RRGGBB - цвет кнопки
288
Параметры для удаления кнопки:
289
  * eax = 8 - номер функции
290
  * edx = 0x80nnnnnn, где nnnnnn - идентификатор кнопки
291
Возвращаемое значение:
292
  * функция не возвращает значения
293
Замечания:
294
  * Размеры кнопки должны быть больше 0 и меньше 0x8000.
295
  * Для окон со скином при определении окна (вызове 0-й функции)
296
    создаются две стандартные кнопки - закрытия окна
297
    с идентификатором 1 и минимизации окна с идентификатором 0xffff.
298
  * Создание двух кнопок с одинаковыми идентификаторами
299
    вполне допустимо.
300
  * Кнопка с идентификатором 0xffff при нажатии интерпретируется
301
    системой как кнопка минимизации, система обрабатывает такое
302
    нажатие самостоятельно, не обращаясь к приложению.
303
    В остальном это обычная кнопка.
304
  * Общее количество кнопок для всех приложений ограничено
305
    числом 4095.
306
 
307
======================================================================
308
============= Функция 9 - информация о потоке выполнения. ============
309
======================================================================
310
Параметры:
311
  * eax = 9 - номер функции
312
  * ebx = указатель на буфер размера 1 Кб
313
  * ecx = номер слота потока
314
    ecx = -1 - получить информацию о текущем потоке
315
Возвращаемое значение:
316
  * eax = максимальный номер слота потока
317
  * буфер, на который указывает ebx, содержит следующую информацию:
318
    * +0: dword: использование процессора (сколько тактов в секунду
319
      уходит на исполнение именно этого потока)
320
    * +4: word: позиция окна потока в оконном стэке
321
    * +6: word: (не имеет отношения к запрошенному потоку)
322
      номер слота потока, окно которого находится в оконном стэке
323
      в позиции ecx
324
    * +8: word: зарезервировано
325
    * +10 = +0xA: 11 байт: имя процесса
326
      (имя соответствующего исполняемого файла в формате 8+3)
142 diamond 327
    * +21 = +0x15: byte: зарезервировано, этот байт не изменяется
77 diamond 328
    * +22 = +0x16: dword: адрес процесса в памяти
329
    * +26 = +0x1A: dword: размер используемой памяти - 1
330
    * +30 = +0x1E: dword: идентификатор (PID/TID)
331
    * +34 = +0x22: dword: координата окна потока по оси x
332
    * +38 = +0x26: dword: координата окна потока по оси y
333
    * +42 = +0x2A: dword: размер окна потока по оси x
334
    * +46 = +0x2E: dword: размер окна потока по оси y
335
    * +50 = +0x32: word: состояние слота потока:
336
      * 0 = поток выполняется
337
      * 1 = поток приостановлен
338
      * 2 = поток приостановлен в момент ожидания события
339
      * 3 = поток завершается в результате вызова функции -1 или
340
        насильственно как следствие вызова подфункции 2 функции 18
341
        или завершения работы системы
342
      * 4 = поток завершается в результате исключения
343
      * 5 = поток ожидает события
344
      * 9 = запрошенный слот свободен, вся остальная информация о
345
        слоте не имеет смысла
142 diamond 346
    * +52 = +0x34: word: зарезервировано, это слово не изменяется
347
    * +54 = +0x36: dword: координата начала клиентской области
348
                          по оси x
349
    * +58 = +0x3A: dword: координата начала клиентской области
350
                          по оси y
351
    * +62 = +0x3E: dword: ширина клиентской области
352
    * +66 = +0x42: dword: высота клиентской области
353
    * +70 = +0x46: byte: состояние окна - битовое поле
354
      * бит 0 (маска 1): окно максимизировано
355
      * бит 1 (маска 2): окно минимизировано в панель задач
356
      * бит 2 (маска 4): окно свёрнуто в заголовок
77 diamond 357
Замечания:
358
  * Слоты нумеруются с 1.
359
  * Возвращаемое значение не есть общее число потоков, поскольку
360
    бывают свободные слоты.
361
  * При создании процесса автоматически создается поток выполнения.
362
  * Функция выдает информацию о потоке. Каждый процесс имеет
363
    хотя бы один поток. Один процесс может создать несколько потоков,
364
    в этом случае каждый поток получает свой слот, причем поля
365
    +10, +22, +26 в этих слотах совпадают.
366
    Для приложений не существует общего способа определить,
367
    принадлежат ли два потока одному процессу.
368
  * Активное окно - окно, находящееся на вершине оконного стэка,
369
    оно получает сообщения о вводе с клавиатуры. Для него позиция в
370
    оконном стэке совпадает с возвращаемым значением.
371
  * Слот 1 соответствует специальному потоку операционной системы,
372
    для которого:
373
    * окно находится внизу оконного стэка, поля +4 и +6 содержат
374
      значение 1
375
    * имя процесса - "OS/IDLE" (дополненное пробелами)
376
    * адрес процесса в памяти равен 0, размер используемой памяти
377
      16 Mb (0x1000000)
378
    * PID=1
142 diamond 379
    * координаты и размеры окна, равно как и клиентской области,
380
      условно полагаются равными 0
77 diamond 381
    * состояние слота - всегда 0 (выполняется)
382
    * время выполнения складывается из времени, уходящего на
383
      собственно работу, и времени простоя в ожидании прерывания
384
      (которое можно получить вызовом подфункции 4 функции 18).
385
  * Начиная со слота 2, размещаются обычные приложения.
172 serge 386
  * Обычные приложения размещаются в памяти по адресу 0x60400000
77 diamond 387
    (константа ядра std_application_base_address).
388
    Наложения не происходит, поскольку у каждого процесса своя
389
    таблица страниц.
390
  * При создании потока ему назначаются слот в системной таблице и
391
    идентификатор (Process/Thread IDentifier = PID/TID), которые для
392
    заданного потока не изменяются со временем.
393
    После завершения потока его слот может быть заново использован
394
    для другого потока. Идентификатор потока не может быть назначен
395
    другому потоку даже после завершения первого.
396
    Назначаемые новым потокам идентификаторы монотонно растут.
397
  * Если поток еще не определил свое окно вызовом функции 0, то
398
    положение и размеры этого окна полагаются нулями.
142 diamond 399
  * Координаты клиентской области окна берутся относительно окна.
77 diamond 400
  * В данный момент используется только часть буфера размером
142 diamond 401
    71 = 0x47 байта. Тем не менее рекомендуется использовать буфер
77 diamond 402
    размером 1 Кб для будущей совместимости, в будущем могут быть
403
    добавлены некоторые поля.
404
 
405
======================================================================
406
==================== Функция 10 - ожидать события. ===================
407
======================================================================
408
Если очередь сообщений пуста, то ждет появления сообщения в очереди.
409
В таком состоянии поток не получает процессорного времени.
410
Затем считывает сообщение из очереди.
411
 
412
Параметры:
413
  * eax = 10 - номер функции
414
Возвращаемое значение:
415
  * eax = событие (смотри список событий)
416
Замечания:
417
  * Учитываются только те события, которые входят в маску,
418
    устанавливаемую функцией 40. По умолчанию это события
419
    перерисовки, нажатия на клавиши и на кнопки.
420
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
421
    Чтобы ждать не более определенного времени, используйте
422
    функцию 23.
423
 
424
======================================================================
425
======= Функция 11 - проверить, есть ли событие, без ожидания. =======
426
======================================================================
427
Если в очереди сообщений есть какое-то событие, то считывает и
428
возвращает его. Если очередь пуста, возвращает нуль.
429
Параметры:
430
  * eax = 11 - номер функции
431
Возвращаемое значение:
432
  * eax = 0 - очередь сообщений пуста
433
  * иначе eax = событие (смотри список событий)
434
Замечания:
435
  * Учитываются только те события, которые входят в маску,
436
    устанавливаемую функцией 40. По умолчанию это события
437
    перерисовки, нажатия на клавиши и на кнопки.
438
  * Для ожидания появления события в очереди, используйте функцию 10.
439
    Чтобы ждать не более определенного времени, используйте
440
    функцию 23.
441
 
442
======================================================================
443
=========== Функция 12 - начать/закончить перерисовку окна. ==========
444
======================================================================
445
 
446
-------------- Подфункция 1 - начать перерисовку окна. ---------------
447
Параметры:
448
  * eax = 12 - номер функции
449
  * ebx = 1 - номер подфункции
450
Возвращаемое значение:
451
  * функция не возвращает значения
452
 
453
------------- Подфункция 2 - закончить перерисовку окна. -------------
454
Параметры:
455
  * eax = 12 - номер функции
456
  * ebx = 2 - номер подфункции
457
Возвращаемое значение:
458
  * функция не возвращает значения
459
Замечания:
131 diamond 460
  * Функция начала перерисовки удаляет все определённые
77 diamond 461
    функцией 8 кнопки, их следует определить повторно.
462
 
463
======================================================================
464
============ Функция 13 - нарисовать прямоугольник в окне. ===========
465
======================================================================
466
Параметры:
467
  * eax = 13 - номер функции
468
  * ebx = [координата по оси x]*65536 + [размер по оси x]
469
  * ecx = [координата по оси y]*65536 + [размер по оси y]
470
  * edx = цвет 0xRRGGBB или 0x80RRGGBB для градиентной заливки
471
Возвращаемое значение:
472
  * функция не возвращает значения
473
Замечания:
474
  * Под координатами понимаются координаты левого верхнего угла
475
    прямоугольника относительно окна.
476
 
477
======================================================================
478
================ Функция 14 - получить размеры экрана. ===============
479
======================================================================
480
Параметры:
481
  * eax = 14 - номер функции
482
Возвращаемое значение:
483
  * eax = [xsize]*65536 + [ysize], где
484
  * xsize = x-координата правого нижнего угла экрана =
485
            размер по горизонтали - 1
486
  * ysize = y-координата правого нижнего угла экрана =
487
            размер по вертикали - 1
488
Замечания:
489
  * Смотри также подфункцию 5 функции 48 - получить размеры рабочей
490
    области экрана.
491
 
492
======================================================================
493
= Функция 15, подфункция 1 - установить размер фонового изображения. =
494
======================================================================
495
Параметры:
496
  * eax = 15 - номер функции
497
  * ebx = 1 - номер подфункции
498
  * ecx = ширина изображения
499
  * edx = высота изображения
500
Возвращаемое значение:
501
  * функция не возвращает значения
502
Замечания:
499 diamond 503
  * Вызов функции обязателен перед вызовом подфункций 2 и 5.
77 diamond 504
  * Для обновления экрана (после завершения серии команд, работающих с
505
    фоном) вызывайте подфункцию 3 перерисовки фона.
506
  * Есть парная функция получения размеров фонового изображения -
507
    подфункция 1 функции 39.
508
 
509
======================================================================
510
= Функция 15, подфункция 2 - поставить точку на фоновом изображении. =
511
======================================================================
512
Параметры:
513
  * eax = 15 - номер функции
514
  * ebx = 2 - номер подфункции
515
  * ecx = смещение
516
  * edx = цвет точки 0xRRGGBB
517
Возвращаемое значение:
518
  * функция не возвращает значения
519
Замечания:
520
  * Смещение для точки с координатами (x,y) вычисляется как
521
    (x+y*xsize)*3.
499 diamond 522
  * Если указанное смещение превышает установленный подфункцией 1
523
    размер, вызов игнорируется.
77 diamond 524
  * Для обновления экрана (после завершения серии команд, работающих с
525
    фоном) вызывайте подфункцию 3 перерисовки фона.
526
  * Есть парная функция получения точки с фонового изображения -
527
    подфункция 2 функции 39.
528
 
529
======================================================================
530
============ Функция 15, подфункция 3 - перерисовать фон. ============
531
======================================================================
532
Параметры:
533
  * eax = 15 - номер функции
534
  * ebx = 3 - номер подфункции
535
Возвращаемое значение:
536
  * функция не возвращает значения
537
 
538
======================================================================
539
===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====
540
======================================================================
541
Параметры:
542
  * eax = 15 - номер функции
543
  * ebx = 4 - номер подфункции
544
  * ecx = режим отрисовки:
545
    * 1 = замостить
546
    * 2 = растянуть
547
Возвращаемое значение:
548
  * функция не возвращает значения
549
Замечания:
550
  * Для обновления экрана (после завершения серии команд, работающих с
551
    фоном) вызывайте подфункцию 3 перерисовки фона.
552
  * Есть парная команда получения режима отрисовки фона -
553
    подфункция 4 функции 39.
554
 
555
======================================================================
556
===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====
557
======================================================================
558
Параметры:
559
  * eax = 15 - номер функции
560
  * ebx = 5 - номер подфункции
81 diamond 561
  * ecx = указатель на данные в формате BBGGRRBBGGRR...
77 diamond 562
  * edx = смещение в данных фонового изображения
563
  * esi = размер данных в байтах = 3 * число пикселей
564
Возвращаемое значение:
565
  * функция не возвращает значения
566
Замечания:
499 diamond 567
  * Проверки корректности смещения и размера не производится.
81 diamond 568
  * Цвет каждого пикселя хранится как 3-байтная величина BBGGRR.
77 diamond 569
  * Пиксели фонового изображения записываются последовательно
570
    слева направо, сверху вниз.
571
  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.
572
  * Для обновления экрана (после завершения серии команд, работающих с
573
    фоном) вызывайте подфункцию 3 перерисовки фона.
574
 
575
======================================================================
546 diamond 576
====================== Функция 15, подфункция 6 ======================
577
==== Спроецировать данные фона на адресное пространство процесса. ====
578
======================================================================
579
Параметры:
580
  * eax = 15 - номер функции
581
  * ebx = 6 - номер подфункции
582
Возвращаемое значение:
583
  * eax = указатель на данные фона, 0 при ошибке
584
Замечания:
585
  * Спроецированные данные доступны на чтение и запись.
586
  * Размер данных фона равен 3*xsize*ysize. Изменение размеров фона
587
    блокируется на время работы с спроецированными данными.
588
  * Цвет каждого пикселя хранится как 3-байтовая величина BBGGRR.
589
  * Пиксели фонового изображения записываются последовательно
590
    слева направо, сверху вниз.
591
 
592
======================================================================
593
====================== Функция 15, подфункция 7 ======================
594
=== Закрыть проекцию данных фона на адресное пространство процесса. ==
595
======================================================================
596
Параметры:
597
  * eax = 15 - номер функции
598
  * ebx = 7 - номер подфункции
599
  * ecx = указатель на данные фона
600
Возвращаемое значение:
601
  * eax = 1 при успехе, 0 при ошибке
602
 
603
======================================================================
77 diamond 604
============= Функция 16 - сохранить рамдиск на дискету. =============
605
======================================================================
606
Параметры:
607
  * eax = 16 - номер функции
608
  * ebx = 1 или ebx = 2 - на какую дискету сохранять
609
Возвращаемое значение:
610
  * eax = 0 - успешно
611
  * eax = 1 - ошибка
612
 
613
======================================================================
614
============== Функция 17 - получить код нажатой кнопки. =============
615
======================================================================
616
Забирает код нажатой кнопки из буфера.
617
Параметры:
618
  * eax = 17 - номер функции
619
Возвращаемое значение:
620
  * если буфер пуст, возвращается eax=1
1018 diamond 621
  * если буфер непуст:
622
    * старшие 24 бита eax содержат идентификатор кнопки
623
      (в частности, в ah оказывается младший байт идентификатора;
624
      если все кнопки имеют идентификатор, меньший 256,
625
      то для различения достаточно ah)
626
    * al = 0 - кнопка была нажата левой кнопкой мыши
627
    * al = бит, соответствующий нажавшей кнопке мыши, если не левой
77 diamond 628
Замечания:
629
  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки
630
    информация о старой теряется.
631
  * При вызове этой функции приложением с неактивным окном
632
    возвращается ответ "буфер пуст".
1018 diamond 633
  * Возвращаемое значение al соответствует состоянию кнопок мыши
634
    в формате подфункции 2 функции 37 в момент начала нажатия
635
    на кнопку, за исключением младшего бита (соответствующего левой
636
    кнопке мыши), который сбрасывается.
77 diamond 637
 
638
======================================================================
91 diamond 639
==== Функция 18, подфункция 2 - завершить процесс/поток по слоту. ====
77 diamond 640
======================================================================
641
Параметры:
642
  * eax = 18 - номер функции
643
  * ebx = 2 - номер подфункции
644
  * ecx = номер слота процесса/потока
645
Возвращаемое значение:
646
  * функция не возвращает значения
647
Замечания:
648
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
649
    1), можно завершить любой обычный поток/процесс.
91 diamond 650
  * Смотри также подфункцию 18 - завершение
651
    процесса/потока с заданным идентификатором.
77 diamond 652
 
653
======================================================================
654
= Функция 18, подфункция 3 - сделать активным окно заданного потока. =
655
======================================================================
656
Параметры:
657
  * eax = 18 - номер функции
658
  * ebx = 3 - номер подфункции
659
  * ecx = номер слота потока
660
Возвращаемое значение:
661
  * функция не возвращает значения
662
Замечания:
663
  * При указании корректного, но несуществующего слота активизируется
664
    какое-то окно.
665
  * Узнать, какое окно является активным, можно вызовом подфункции 7.
666
 
667
======================================================================
1074 Galkov 668
 Функция 18, подфункция 4 - получить счётчик пустых тактов в секунду.
77 diamond 669
======================================================================
670
Под пустыми тактами понимается время, в которое процессор простаивает
671
в ожидании прерывания (в инструкции hlt).
672
 
673
Параметры:
674
  * eax = 18 - номер функции
675
  * ebx = 4 - номер подфункции
676
Возвращаемое значение:
131 diamond 677
  * eax = значение счётчика пустых тактов в секунду
77 diamond 678
 
679
======================================================================
680
======== Функция 18, подфункция 5 - получить тактовую частоту. =======
681
======================================================================
682
Параметры:
683
  * eax = 18 - номер функции
684
  * ebx = 5 - номер подфункции
685
Возвращаемое значение:
686
  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)
687
 
688
======================================================================
1074 Galkov 689
 Функция 18, подфункция 6 - сохранить рамдиск в файл на жёстком диске.
77 diamond 690
======================================================================
691
Параметры:
692
  * eax = 18 - номер функции
693
  * ebx = 6 - номер подфункции
341 heavyiron 694
  * ecx = указатель на строку с полным именем файла
695
    (например, "/hd0/1/kolibri/kolibri.img")
77 diamond 696
Возвращаемое значение:
697
  * eax = 0 - успешно
698
  * иначе eax = код ошибки файловой системы
699
Замечания:
131 diamond 700
  * Все папки в указанном пути должны существовать, иначе вернётся
77 diamond 701
    значение 5, "файл не найден".
702
 
703
======================================================================
704
====== Функция 18, подфункция 7 - получить номер активного окна. =====
705
======================================================================
706
Параметры:
707
  * eax = 18 - номер функции
708
  * ebx = 7 - номер подфункции
709
Возвращаемое значение:
710
  * eax = номер активного окна (номер слота потока, окно которого
711
    активно)
712
Замечания:
713
  * Активное окно находится вверху оконного стэка и получает
131 diamond 714
    сообщения обо всём вводе с клавиатуры.
77 diamond 715
  * Сделать окно активным можно вызовом подфункции 3.
716
 
717
======================================================================
718
==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====
719
======================================================================
131 diamond 720
При отключённом звуке вызовы подфункции 55 функции 55 игнорируются.
721
При включённом - направляются на встроенный спикер.
77 diamond 722
 
723
--------------- Подподфункция 1 - получить состояние. ----------------
724
Параметры:
725
  * eax = 18 - номер функции
726
  * ebx = 8 - номер подфункции
727
  * ecx = 1 - номер подподфункции
728
Возвращаемое значение:
131 diamond 729
  * eax = 0 - звук спикера разрешён; 1 - запрещён
77 diamond 730
 
731
-------------- Подподфункция 2 - переключить состояние. --------------
732
Переключает состояния разрешения/запрещения.
733
Параметры:
734
  * eax = 18 - номер функции
735
  * ebx = 8 - номер подфункции
736
  * ecx = 2 - номер подподфункции
737
Возвращаемое значение:
738
  * функция не возвращает значения
739
 
740
======================================================================
1018 diamond 741
= Функция 18, подфункция 9 - завершение работы системы с параметром. =
77 diamond 742
======================================================================
743
Параметры:
744
  * eax = 18 - номер функции
745
  * ebx = 9 - номер подфункции
746
  * ecx = параметр:
747
    * 2 = выключить компьютер
748
    * 3 = перезагрузить компьютер
749
    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске
750
Возвращаемое значение:
751
  * при неверном ecx регистры не меняются (т.е. eax=18)
752
  * при правильном вызове всегда возвращается признак успеха eax=0
753
Замечания:
754
  * Не следует полагаться на возвращаемое значение при неверном
755
    вызове, оно может измениться в последующих версиях ядра.
1018 diamond 756
 
77 diamond 757
======================================================================
758
======== Функция 18, подфункция 10 - свернуть окно приложения. =======
759
======================================================================
760
Сворачивает собственное окно.
761
Параметры:
762
  * eax = 18 - номер функции
763
  * ebx = 10 - номер подфункции
764
Возвращаемое значение:
765
  * функция не возвращает значения
766
Замечания:
767
  * Минимизированное окно с точки зрения функции 9 сохраняет положение
768
    и размеры.
1074 Galkov 769
  * Восстановление окна приложения происходит при активизировании
77 diamond 770
    подфункцией 3.
131 diamond 771
  * Обычно нет необходимости явно сворачивать/разворачивать своё окно:
77 diamond 772
    сворачивание окна осуществляется системой при нажатии на кнопку
773
    минимизации (которая для окон со скином определяется автоматически
131 diamond 774
    функцией 0, для окон без скина её можно определить функцией 8),
77 diamond 775
    восстановление - приложением @panel.
776
 
777
======================================================================
778
====================== Функция 18, подфункция 11 =====================
779
============= Получить информацию о дисковой подсистеме. =============
780
======================================================================
781
Параметры:
782
  * eax = 18 - номер функции
783
  * ebx = 11 - номер подфункции
784
  * ecx = тип таблицы:
785
    * 1 = короткая версия, 10 байт
786
    * 2 = полная версия, 65536 байт
787
  * edx = указатель на буфер (в приложении) для таблицы
788
Возвращаемое значение:
789
  * функция не возвращает значения
790
Формат таблицы: короткая версия:
791
  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,
131 diamond 792
    где AAAA задаёт тип первого дисковода, BBBB - второго согласно
77 diamond 793
    следующему списку:
794
    * 0 = нет дисковода
795
    * 1 = 360Kb, 5.25''
796
    * 2 = 1.2Mb, 5.25''
797
    * 3 = 720Kb, 3.5''
798
    * 4 = 1.44Mb, 3.5''
799
    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)
800
    Например, для стандартной конфигурации из одного 1.44-дисковода
801
    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:
802
    значение оказывается 24h.
131 diamond 803
  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,
77 diamond 804
    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
805
    * 0 = устройство отсутствует
131 diamond 806
    * 1 = жёсткий диск
77 diamond 807
    * 2 = CD-привод
808
    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
131 diamond 809
  * +2: 4 db: число найденных разделов на жёстких дисках с
77 diamond 810
    соответственно IDE0,...,IDE3.
131 diamond 811
    При отсутствии жёсткого диска на IDEx соответствующий байт
77 diamond 812
    нулевой, при наличии показывает число распознанных разделов,
813
    которых может и не быть (если носитель не отформатирован или
814
    если файловая система не поддерживается). В текущей версии ядра
277 diamond 815
    для жёстких дисков поддерживаются только FAT16, FAT32 и NTFS.
77 diamond 816
  * +6: 4 db: зарезервировано
817
Формат таблицы: полная версия:
818
  * +0: 10 db: такие же, как и в короткой версии
819
  * +10: 100 db: данные для первого раздела
820
  * +110: 100 db: данные для второго раздела
821
  * ...
822
  * +10+100*(n-1): 100 db: данные для последнего раздела
823
Разделы расположены в следующем порядке: сначала последовательно все
824
распознанные разделы на HD на IDE0 (если есть),
825
затем на HD на IDE1 (если есть) и т.д. до IDE3.
277 diamond 826
Формат информации о разделе:
77 diamond 827
  * +0: dword: начальный физический сектор раздела
828
  * +4: dword: последний физический сектор раздела
829
    (принадлежит разделу)
277 diamond 830
  * +8: byte: тип файловой системы:
831
    16=FAT16, 32=FAT32, 1=NTFS
832
  * формат дальнейших данных зависит от файловой системы,
833
    может меняться с изменениями в ядре и поэтому не описывается
77 diamond 834
Замечания:
835
  * Короткая таблица может быть использована для получения информации
836
    об имеющихся устройствах.
837
 
838
======================================================================
839
========== Функция 18, подфункция 13 - получить версию ядра. =========
840
======================================================================
841
Параметры:
842
  * eax = 18 - номер функции
843
  * ebx = 13 - номер подфункции
844
  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена
845
    информация
846
Возвращаемое значение:
847
  * функция не возвращает значения
848
Структура буфера:
849
db a,b,c,d для версии a.b.c.d
850
db UID_xxx: одно из UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
546 diamond 851
dd REV - номер svn-ревизии ядра
641 diamond 852
Для ядра Kolibri 0.7.1.0:
853
db 0,7,1,0
77 diamond 854
db 2
641 diamond 855
dd 638
77 diamond 856
 
857
======================================================================
858
====================== Функция 18, подфункция 14 =====================
131 diamond 859
======= Ожидать начала обратного хода луча развёртки монитора. =======
77 diamond 860
======================================================================
861
Параметры:
862
  * eax = 18 - номер функции
863
  * ebx = 14 - номер подфункции
864
Возвращаемое значение:
865
  * eax = 0 как признак успеха
866
Замечания:
867
  * Функция предназначена исключительно для активных
868
    высокопроизводительных графических приложений; используется для
869
    плавного вывода графики.
870
 
871
======================================================================
872
== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =
873
======================================================================
874
Параметры:
875
  * eax = 18 - номер функции
876
  * ebx = 15 - номер подфункции
877
Возвращаемое значение:
878
  * eax = 0 как признак успеха
879
 
880
======================================================================
881
====================== Функция 18, подфункция 16 =====================
882
============ Получить размер свободной оперативной памяти. ===========
883
======================================================================
884
Параметры:
885
  * eax = 18 - номер функции
886
  * ebx = 16 - номер подфункции
887
Возвращаемое значение:
888
  * eax = размер свободной памяти в килобайтах
889
 
890
======================================================================
891
====================== Функция 18, подфункция 17 =====================
892
============ Получить размер имеющейся оперативной памяти. ===========
893
======================================================================
894
Параметры:
895
  * eax = 18 - номер функции
896
  * ebx = 17 - номер подфункции
897
Возвращаемое значение:
898
  * eax = общий размер имеющейся памяти в килобайтах
899
 
900
======================================================================
91 diamond 901
====================== Функция 18, подфункция 18 =====================
902
============= Завершить процесс/поток по идентификатору. =============
85 halyavin 903
======================================================================
904
Параметры:
905
  * eax = 18 - номер функции
906
  * ebx = 18 - номер подфункции
91 diamond 907
  * ecx = идентификатор процесса/потока (PID/TID)
908
Возвращаемое значение:
909
  * eax = 0 - успешно
910
  * eax = -1 - ошибка (процесс не найден или является системным)
911
Замечания:
912
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
913
    1), можно завершить любой обычный поток/процесс.
914
  * Смотри также подфункцию 2 - завершение
915
    процесса/потока по заданному слоту.
85 halyavin 916
 
917
======================================================================
131 diamond 918
=== Функция 18, подфункция 19 - получить/установить настройки мыши. ==
120 mario79 919
======================================================================
131 diamond 920
 
921
------------- Подподфункция 0 - получить скорость мыши. --------------
120 mario79 922
Параметры:
923
  * eax = 18 - номер функции
924
  * ebx = 19 - номер подфункции
131 diamond 925
  * ecx = 0 - номер подподфункции
926
Возвращаемое значение:
927
  * eax = текущая скорость мыши
120 mario79 928
 
131 diamond 929
------------ Подподфункция 1 - установить скорость мыши. -------------
930
Параметры:
931
  * eax = 18 - номер функции
932
  * ebx = 19 - номер подфункции
933
  * ecx = 1 - номер подподфункции
934
  * edx = новое значение скорости
935
Возвращаемое значение:
936
  * функция не возвращает значения
120 mario79 937
 
131 diamond 938
------------- Подподфункция 2 - получить задержку мыши. --------------
939
Параметры:
940
  * eax = 18 - номер функции
941
  * ebx = 19 - номер подфункции
942
  * ecx = 2 - номер подподфункции
943
Возвращаемое значение:
944
  * eax = текущая задержка мыши
120 mario79 945
 
131 diamond 946
------------ Подподфункция 3 - установить задержку мыши. -------------
947
Параметры:
948
  * eax = 18 - номер функции
949
  * ebx = 19 - номер подфункции
950
  * ecx = 3 - номер подподфункции
951
  * edx = новое значение задержки мыши
952
Возвращаемое значение:
953
  * функция не возвращает значения
120 mario79 954
 
131 diamond 955
-------- Подподфункция 4 - установить положение курсора мыши. --------
956
Параметры:
957
  * eax = 18 - номер функции
958
  * ebx = 19 - номер подфункции
959
  * ecx = 4 - номер подподфункции
960
  * edx = [координата по оси x]*65536 + [координата по оси y]
961
Возвращаемое значение:
962
  * функция не возвращает значения
621 mario79 963
 
641 diamond 964
------- Подподфункция 5 - симулировать состояние клавиш мыши. --------
621 mario79 965
Параметры:
966
  * eax = 18 - номер функции
967
  * ebx = 19 - номер подфункции
968
  * ecx = 5 - номер подподфункции
641 diamond 969
  * edx = информация о эмулируемом состоянии кнопок мыши:
970
    (соответствует возвращаемому значению подфункции 2 функции 37)
971
    * бит 0 установлен = левая кнопка нажата
972
    * бит 1 установлен = правая кнопка нажата
973
    * бит 2 установлен = средняя кнопка нажата
974
    * бит 3 установлен = 4-я кнопка нажата
975
    * бит 4 установлен = 5-я кнопка нажата
621 mario79 976
Возвращаемое значение:
977
  * функция не возвращает значения
120 mario79 978
Замечания:
131 diamond 979
  * Рекомендуемая скорость мыши (в подподфункции 1) от 1 до 9.
980
    Устанавливаемая величина не проверяется кодом ядра, поэтому
981
    используйте осторожно, при некорректном значении курсор может
982
    "замёрзнуть". Скорость мыши можно регулировать в приложении SETUP.
983
  * Рекомендуемая величина задержки (в подподфункции 3) = 10.
984
    Меньшие значения не обрабатываются COM-мышами. При очень больших
985
    значениях невозможно передвижение мыши на 1 пиксель и курсор будет
986
    прыгать на величину установленной скорости (подподфункция 1).
987
    Устанавливаемая величина не проверяется кодом ядра.
133 diamond 988
    Величину задержки можно менять в приложении SETUP.
131 diamond 989
  * Подподфункция 4 не проверяет переданное значение. Перед вызовом
990
    необходимо узнать текущее разрешение экрана (подфункцией 14)
991
    и проверить, что устанавливаемое положение не выходит за пределы
992
    экрана.
120 mario79 993
 
994
======================================================================
172 serge 995
====================== Функция 18, подфункция 20 =====================
996
============= Получить информацию об оперативной памяти. =============
997
======================================================================
998
Параметры:
999
  * eax = 18 - номер функции
1000
  * ebx = 20 - номер подфункции
1001
  * ecx = указатель на буфер для информации (36 байт)
1002
Возвращаемое значение:
1003
  * eax = общий размер имеющейся оперативной памяти в байтах
1004
    или -1 в случае ошибки
1005
  * буфер, на который указывает ecx, содержит следующую информацию:
277 diamond 1006
    * +0: dword: общий размер имеющейся оперативной памяти в страницах
172 serge 1007
    * +4:  dword: размер свободной оперативной памяти в страницах
1008
    * +8:  dword: число страничных ошибок (исключений #PF)
1009
                 в приложениях
1010
    * +12: dword: размер кучи ядра в байтах
277 diamond 1011
    * +16: dword: размер свободной памяти в куче ядра в байтах
172 serge 1012
    * +20: dword: общее количество блоков памяти в куче ядра
277 diamond 1013
    * +24: dword: количество свободных блоков памяти в куче ядра
172 serge 1014
    * +28: dword: размер наибольшего свободного блока в куче ядра
277 diamond 1015
                 (зарезервировано)
1016
    * +32: dword: размер наибольшего выделенного блока в куче ядра
1017
                 (зарезервировано)
172 serge 1018
 
1019
======================================================================
608 alver 1020
====================== Функция 18, подфункция 21 =====================
641 diamond 1021
======= Получить номер слота процесса/потока по идентификатору. ======
608 alver 1022
======================================================================
1023
Параметры:
1024
  * eax = 18 - номер функции
1025
  * ebx = 21 - номер подфункции
641 diamond 1026
  * ecx = идентификатор процесса/потока (PID/TID)
608 alver 1027
Возвращаемое значение:
641 diamond 1028
  * eax = 0 - ошибка (неверный идентификатор)
1029
  * иначе eax = номер слота
608 alver 1030
 
1031
======================================================================
1074 Galkov 1032
 Функция 18, подфункция 22 - операции с окном другого процесса/потока.
608 alver 1033
======================================================================
1034
Параметры:
1035
  * eax = 18 - номер функции
1036
  * ebx = 22 - номер подфункции
641 diamond 1037
  * ecx = тип операции:
1038
    * 0 = минимизация окна, поток задан номером слота
1039
    * 1 = минимизация окна, поток задан идентификатором
1040
    * 2 = восстановление окна, поток задан номером слота
1041
    * 3 = восстановление окна, поток задан идентификатором
1042
  * edx = параметр операции (номер слота или PID/TID)
608 alver 1043
Возвращаемое значение:
641 diamond 1044
  * eax = 0 - успешно
1045
  * eax = -1 - ошибка (неправильный параметр)
1046
Замечания:
1047
  * Поток может свернуть своё окно вызовом подфункции 10.
1048
  * Восстановление окна с одновременной активизацией осуществляется
1049
    подфункции 3 (принимающей номер слота).
608 alver 1050
 
1051
======================================================================
77 diamond 1052
==================== Функция 20 - интерфейс MIDI. ====================
1053
======================================================================
1054
 
1055
------------------------ Подфункция 1 - сброс ------------------------
1056
Параметры:
1057
  * eax = 20 - номер функции
1058
  * ebx = 1 - номер подфункции
1059
 
1060
-------------------- Подфункция 2 - вывести байт ---------------------
1061
Параметры:
1062
  * eax = 20 - номер функции
1063
  * ebx = 2 - номер подфункции
1064
  * cl = байт для вывода
1065
Возвращаемое значение (одинаково для обеих подфункций):
1066
  * eax = 0 - успешно
131 diamond 1067
  * eax = 1 - не определён базовый порт
77 diamond 1068
Замечания:
1074 Galkov 1069
  * Предварительно должен быть определён базовый порт вызовом
77 diamond 1070
    подфункции 1 функции 21.
1071
 
1072
======================================================================
1073
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
1074
======================================================================
1075
Параметры:
1076
  * eax = 21 - номер функции
1077
  * ebx = 1 - номер подфункции
1078
  * ecx = номер базового порта
1079
Возвращаемое значение:
1080
  * eax = 0 - успешно
1081
  * eax = -1 - ошибочный номер порта
1082
Замечания:
1083
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1084
  * Установка базы нужна для работы функции 20.
1074 Galkov 1085
  * Получить установленный базовый порт можно вызовом
77 diamond 1086
    подфункции 1 функции 26.
1087
 
1088
======================================================================
1089
===== Функция 21, подфункция 2 - установить раскладку клавиатуры. ====
1090
======================================================================
1091
Раскладка клавиатуры используется для преобразования сканкодов,
1092
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1093
Параметры:
1094
  * eax = 21 - номер функции
1095
  * ebx = 2 - номер подфункции
1096
  * ecx = какую раскладку устанавливать:
1097
    * 1 = нормальную
1098
    * 2 = раскладку при нажатом Shift
1099
    * 3 = раскладку при нажатом Alt
1100
  * edx = указатель на раскладку - таблицу длиной 128 байт
1101
Или:
1102
  * ecx = 9
1103
  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1104
Возвращаемое значение:
1105
  * eax = 0 - успешно
1106
  * eax = 1 - параметр задан неверно
1107
Замечания:
1108
  * Если нажат Alt, то используется раскладка с Alt;
1109
    если не нажат Alt, но нажат Shift, то
1110
    используется раскладка с Shift;
1111
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1112
    нормальная раскладка, после чего из кода вычитается 0x60;
1113
    если не нажата ни одна из управляющих клавиш, то используется
1114
    нормальная раскладка.
1074 Galkov 1115
  * Получить раскладки и идентификатор страны можно с помощью
77 diamond 1116
    подфункции 2 функции 26.
1117
  * Идентификатор страны - глобальная системная переменная, которая
1118
    самим ядром не используется; однако приложение @panel отображает
1119
    соответствующую текущей стране иконку.
1120
  * Приложение @panel переключает раскладки по запросу пользователя.
1121
 
1122
======================================================================
1123
=========== Функция 21, подфункция 3 - установить базу CD. ===========
1124
======================================================================
1125
Параметры:
1126
  * eax = 21 - номер функции
1127
  * ebx = 3 - номер подфункции
1128
  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1129
Возвращаемое значение:
1130
  * eax = 0
1131
Замечания:
1132
  * База CD используется функцией 24.
1074 Galkov 1133
  * Получить установленную базу CD можно вызовом
77 diamond 1134
    подфункции 3 функции 26.
1135
 
1136
======================================================================
1137
========= Функция 21, подфункция 5 - установить язык системы. ========
1138
======================================================================
1139
Параметры:
1140
  * eax = 21 - номер функции
1141
  * ebx = 5 - номер подфункции
1142
  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1143
Возвращаемое значение:
1144
  * eax = 0
1145
Замечания:
1146
  * Язык системы - глобальная системная переменная, никак
1147
    не используемая самим ядром, однако приложение @panel рисует
1148
    соответствующую иконку.
1149
  * Проверок на корректность не делается, поскольку ядро эту
1150
    переменную не использует.
1151
  * Получить язык системы можно вызовом подфункции 5 функции 26.
1152
 
1153
======================================================================
1154
=========== Функция 21, подфункция 7 - установить базу HD. ===========
1155
======================================================================
131 diamond 1156
База HD нужна для определения, на какой жёсткий диск писать, при
346 diamond 1157
использовании устаревшего синтаксиса /HD в устаревшей функции 58;
1158
при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
1159
база устанавливается автоматически.
77 diamond 1160
Параметры:
1161
  * eax = 21 - номер функции
1162
  * ebx = 7 - номер подфункции
1163
  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1164
Возвращаемое значение:
1165
  * eax = 0
1166
Замечания:
1167
  * Любое приложение в любой момент времени может изменить базу.
1168
  * Не следует изменять базу, когда какое-нибудь приложение работает
131 diamond 1169
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1170
  * Получить установленную базу можно вызовом подфункции 7 функции 26.
1074 Galkov 1171
  * Следует также определить используемый раздел жёсткого диска
77 diamond 1172
    подфункцией 8.
1173
 
1174
======================================================================
1175
========== Функция 21, подфункция 8 - установить раздел HD. ==========
1176
======================================================================
131 diamond 1177
Раздел HD нужен для определения, на какой раздел жёсткого диска
346 diamond 1178
писать, при использовании устаревшего синтаксиса /HD в устаревшей
1179
функции 58; при использовании современного синтаксиса
1180
/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
77 diamond 1181
Параметры:
1182
  * eax = 21 - номер функции
1183
  * ebx = 8 - номер подфункции
1184
  * ecx = раздел HD (считая с 1)
1185
Возвращаемое значение:
1186
  * eax = 0
1187
Замечания:
1188
  * Любое приложение в любой момент времени может изменить раздел.
1189
  * Не следует изменять раздел, когда какое-нибудь приложение работает
131 diamond 1190
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1191
  * Получить установленный раздел можно вызовом подфункции 8
1192
    функции 26.
1193
  * Проверок на корректность не делается.
1074 Galkov 1194
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1195
    подфункции 11 функции 18.
1074 Galkov 1196
  * Следует также определить используемую базу жёсткого диска
77 diamond 1197
    подфункцией 7.
1198
 
1199
======================================================================
1200
====================== Функция 21, подфункция 11 =====================
1201
=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
1202
======================================================================
1203
Параметры:
1204
  * eax = 21 - номер функции
1205
  * ebx = 11 - номер подфункции
1206
  * ecx = 0/1 - запретить/разрешить
1207
Возвращаемое значение:
1208
  * eax = 0
1209
Замечания:
1210
  * Используется при LBA-чтении (подфункция 8 функции 58).
1211
  * Текущая реализация использует только младший бит ecx.
1212
  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
1213
 
1214
======================================================================
1215
====================== Функция 21, подфункция 12 =====================
1216
========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
1217
======================================================================
1218
Параметры:
1219
  * eax = 21 - номер функции
1220
  * ebx = 12 - номер подфункции
1221
  * ecx = 0/1 - запретить/разрешить
1222
Возвращаемое значение:
1223
  * eax = 0
1224
Замечания:
1225
  * Используется при работе с шиной PCI (функция 62).
1226
  * Текущая реализация использует только младший бит ecx.
1227
  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
1228
 
1229
======================================================================
1230
============= Функция 21, подфункция 13, подподфункция 1 =============
1231
==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
1232
======================================================================
1233
Параметры:
1234
  * eax = 21 - номер функции
1235
  * ebx = 13 - номер подфункции
1236
  * ecx = 1 - номер функции драйвера
1237
  * edx = указатель на буфер размера 512 байт
1238
Возвращаемое значение:
1239
  * если драйвер не загружен (никогда не бывает в текущей реализации):
1240
    * eax = -1
1241
    * ebx, ecx разрушаются
1242
  * если драйвер загружен:
1243
    * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт,
1244
      'Z' - старший) - сигнатура
131 diamond 1245
    * ebx = текущая частота развёртки (в Гц)
77 diamond 1246
    * ecx разрушается
1247
    * буфер, на который указывает edx, заполнен
1248
Формат буфера:
1249
  * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек,
1250
    дополнено пробелами)
1251
  * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как
1252
    y*65536+x), для текущей реализации 1 (1.0)
1253
  * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
1254
  * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое
1255
    слово - номер видеорежима, после собственно списка идут нули)
131 diamond 1256
  * +128 = +0x80: 32*(5*word): список поддерживаемых частот развёрток
77 diamond 1257
    для видеорежимов: для каждого видеорежима, указанного в предыдущем
1258
    поле, указано до 5 поддерживаемых частот
1259
    (в неиспользуемых позициях записаны нули)
1260
Замечания:
131 diamond 1261
  * Функция инициализирует драйвер (если он ещё не инициализирован)
77 diamond 1262
    и должна вызываться первой, перед остальными (иначе они будут
1263
    возвращать -1, ничего не делая).
131 diamond 1264
  * В текущей реализации поддерживается только одна частота развёртки
77 diamond 1265
    на видеорежим.
1266
 
1267
======================================================================
1268
============= Функция 21, подфункция 13, подподфункция 2 =============
1269
============= Получить информацию о текущем видеорежиме. =============
1270
======================================================================
1271
Параметры:
1272
  * eax = 21 - номер функции
1273
  * ebx = 13 - номер подфункции
1274
  * ecx = 2 - номер функции драйвера
1275
Возвращаемое значение:
1276
  * eax = -1 - драйвер не загружен или не инициализирован;
1277
    ebx,ecx разрушаются
1278
  * eax = [ширина]*65536 + [высота]
131 diamond 1279
  * ebx = частота вертикальной развёртки (в Гц)
77 diamond 1280
  * ecx = номер текущего видеорежима
1281
Замечания:
1074 Galkov 1282
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1283
    функции драйвера 1.
1284
  * Если нужны только размеры экрана, целесообразней использовать
131 diamond 1285
    функцию 14 с учётом того, что она возвращает размеры на 1 меньше.
77 diamond 1286
 
1287
======================================================================
1074 Galkov 1288
= Функция 21, подфункция 13, подподфункция 3 - установить видеорежим.
77 diamond 1289
======================================================================
1290
Параметры:
1291
  * eax = 21 - номер функции
1292
  * ebx = 13 - номер подфункции
1293
  * ecx = 3 - номер функции драйвера
131 diamond 1294
  * edx = [частота развёртки]*65536 + [номер видеорежима]
77 diamond 1295
Возвращаемое значение:
1296
  * eax = -1 - драйвер не загружен, не инициализирован или
1297
    произошла ошибка
1298
  * eax = 0 - успешно
1299
  * ebx, ecx разрушаются
1300
Замечания:
1074 Galkov 1301
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1302
    функции драйвера 1.
1303
  * Номер видеорежима и частота должны быть в таблице, возвращаемой
1304
    функцией драйвера 1.
1305
 
1306
======================================================================
1307
============= Функция 21, подфункция 13, подподфункция 4 =============
1308
================= Вернуться к начальному видеорежиму. ================
1309
======================================================================
1310
Возвращает экран в видеорежим, установленный при загрузке системы.
1311
Параметры:
1312
  * eax = 21 - номер функции
1313
  * ebx = 13 - номер подфункции
1314
  * ecx = 4 - номер функции драйвера
1315
Возвращаемое значение:
1316
  * eax = -1 - драйвер не загружен или не инициализирован
1317
  * eax = 0 - успешно
1318
  * ebx, ecx разрушаются
1319
Замечания:
1074 Galkov 1320
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1321
    функции драйвера 1.
1322
 
1323
======================================================================
1324
============= Функция 21, подфункция 13, подподфункция 5 =============
1325
======== Увеличить/уменьшить размер видимой области монитора. ========
1326
======================================================================
1327
Параметры:
1328
  * eax = 21 - номер функции
1329
  * ebx = 13 - номер подфункции
1330
  * ecx = 5 - номер функции драйвера
1331
  * edx = 0/1 - уменьшить/увеличить размер по горизонтали
1332
    на одну позицию
1333
  * edx = 2/3 - в текущей реализации не поддерживается; планируется
1334
    как уменьшение/увеличение размера по вертикали на одну позицию
1335
Возвращаемое значение:
1336
  * eax = -1 - драйвер не загружен или не инициализирован
1337
  * eax = 0 - успешно
1338
  * ebx, ecx разрушаются
1339
Замечания:
1074 Galkov 1340
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1341
    функции драйвера 1.
1342
  * Функция влияет только на физический размер изображения
1343
    на мониторе; логический размер (число пикселей) не меняется.
1344
 
1345
======================================================================
1346
============ Функция 22 - установить системную дату/время. ===========
1347
======================================================================
1348
Параметры:
1349
  * eax = 22 - номер функции
1350
  * ebx = 0 - установить время
1351
    * ecx = 0x00SSMMHH - время в двоично-десятичном коде (BCD):
1352
    * HH=час 00..23
1353
    * MM=минута 00..59
1354
    * SS=секунда 00..59
1355
  * ebx = 1 - установить дату
1356
    * ecx = 0x00DDMMYY - дата в двоично-десятичном коде (BCD):
1357
    * DD=день 01..31
1358
    * MM=месяц 01..12
1359
    * YY=год 00..99
1360
  * ebx = 2 - установить день недели
1361
    * ecx = 1 для воскресенья, ..., 7 для субботы
1362
  * ebx = 3 - установить будильник
1363
    * ecx = 0x00SSMMHH
1364
Возвращаемое значение:
1365
  * eax = 0 - успешно
1366
  * eax = 1 - параметр задан неверно
1367
  * eax = 2 - CMOS-батарейки разрядились
1368
Замечания:
1369
  * Ценность установки дня недели представляется сомнительной,
1370
    поскольку он мало где используется
1371
    (день недели можно рассчитать по дате).
1372
  * Будильник можно установить на срабатывание в заданное время
1373
    каждые сутки. При этом отключить его существующими системными
1374
    функциями нельзя.
1375
  * Срабатывание будильника заключается в генерации IRQ8.
1376
  * Вообще-то CMOS поддерживает для будильника установку значения
1377
    0xFF в качестве одного из параметров и означает это, что
1378
    соответствующий параметр игнорируется. Но в текущей реализации
131 diamond 1379
    это не пройдёт (вернётся значение 1).
77 diamond 1380
  * Будильник - глобальный системный ресурс; установка будильника
1381
    автоматически отменяет предыдущую установку. Впрочем, на данный
1382
    момент ни одна программа его не использует.
1383
 
1384
======================================================================
1385
============== Функция 23 - ожидать события с таймаутом. =============
1386
======================================================================
131 diamond 1387
Если очередь сообщений пуста, ждёт появления сообщения в очереди,
77 diamond 1388
но не более указанного времени. Затем считывает сообщение из очереди.
1389
 
1390
Параметры:
1391
  * eax = 23 - номер функции
1392
  * ebx = таймаут (в сотых долях секунды)
1393
Возвращаемое значение:
1394
  * eax = 0 - очередь сообщений пуста
1395
  * иначе eax = событие (смотри список событий)
1396
Замечания:
1397
  * Учитываются только те события, которые входят в маску,
1398
    устанавливаемую функцией 40. По умолчанию это события
1399
    перерисовки, нажатия на клавиши и на кнопки.
1400
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
1401
    Чтобы ждать сколь угодно долго, используйте функцию 10.
1402
  * Передача ebx=0 приводит к моментальному возвращению eax=0.
131 diamond 1403
  * При текущей реализации произойдёт немедленный возврат из функции
1404
    с eax=0, если сложение ebx с текущим значением счётчика времени
77 diamond 1405
    вызовет 32-битное переполнение.
1406
 
1407
======================================================================
1408
======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ======
1409
======================================================================
1410
Параметры:
1411
  * eax = 24 - номер функции
1412
  * ebx = 1 - номер подфункции
1413
  * ecx = 0x00FRSSMM, где
1414
    * MM = начальная минута
1415
    * SS = начальная секунда
1416
    * FR = начальный фрейм
1417
Возвращаемое значение:
1418
  * eax = 0 - успешно
1419
  * eax = 1 - не определена база CD
1420
Замечания:
1074 Galkov 1421
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1422
    подфункции 3 функции 21.
1423
  * В секунде 75 фреймов, в минуте 60 секунд.
1424
  * Функция асинхронна (возвращает управление, когда началось
1425
    проигрывание).
1426
 
1427
======================================================================
1428
===== Функция 24, подфункция 2 - получить информацию о дорожках. =====
1429
======================================================================
1430
Параметры:
1431
  * eax = 24 - номер функции
1432
  * ebx = 2 - номер подфункции
1433
  * ecx = указатель на буфер для таблицы
1434
    (максимум 8*64h+4 байт=100 дорожек)
1435
Возвращаемое значение:
1436
  * eax = 0 - успешно
1437
  * eax = 1 - не определена база CD
1438
Замечания:
1439
  * Формат таблицы с информацией о дорожках такой же, как и для
1440
    ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h).
1441
    Адреса возвращаются в формате MSF.
1074 Galkov 1442
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1443
    подфункции 3 функции 21.
1444
  * Функция возвращает информацию только о не более чем 100
1445
    первых дорожках. В большинстве случаев этого достаточно.
1446
 
1447
======================================================================
1448
==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. ===
1449
======================================================================
1450
Параметры:
1451
  * eax = 24 - номер функции
1452
  * ebx = 1 - номер подфункции
1453
Возвращаемое значение:
1454
  * eax = 0 - успешно
1455
  * eax = 1 - не определена база CD
1456
Замечания:
1074 Galkov 1457
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1458
    подфункции 3 функции 21.
1459
 
1460
======================================================================
641 diamond 1461
======= Функция 24, подфункция 4 - извлечь лоток привода диска. ======
588 diamond 1462
======================================================================
1463
Параметры:
1464
  * eax = 24 - номер функции
1465
  * ebx = 4 - номер подфункции
641 diamond 1466
  * ecx = номер CD/DVD-диска
1467
      (от 0=Primary Master до 3=Secondary Slave)
588 diamond 1468
Возвращаемое значение:
641 diamond 1469
  * функция не возвращает значения
588 diamond 1470
Замечания:
641 diamond 1471
  * Функция поддерживается только для ATAPI-устройств (CD и DVD).
1472
  * При извлечении лотка производится разблокировка ручного управления
1473
    механизмом лотка.
1474
  * При извлечении лотка код производит очистку кэша соответствующего
1475
    устройства.
588 diamond 1476
  * Примером использования функции является приложение CD_tray.
1477
 
1478
======================================================================
641 diamond 1479
====== Функция 24, подфункция 5 - загрузить лоток привода диска. =====
588 diamond 1480
======================================================================
1481
Параметры:
1482
  * eax = 24 - номер функции
1483
  * ebx = 5 - номер подфункции
641 diamond 1484
  * ecx = номер CD/DVD-диска
1485
      (от 0=Primary Master до 3=Secondary Slave)
588 diamond 1486
Возвращаемое значение:
641 diamond 1487
  * функция не возвращает значения
588 diamond 1488
Замечания:
641 diamond 1489
  * Функция поддерживается только для ATAPI-устройств (CD и DVD).
588 diamond 1490
  * Примером использования функции является приложение CD_tray.
1491
 
1492
======================================================================
77 diamond 1493
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
1494
======================================================================
1495
Параметры:
1496
  * eax = 26 - номер функции
1497
  * ebx = 1 - номер подфункции
1498
Возвращаемое значение:
1499
  * eax = номер порта
1500
Замечания:
1074 Galkov 1501
  * Установить базовый порт можно вызовом
77 diamond 1502
    подфункции 1 функции 21.
1503
 
1504
======================================================================
1505
====== Функция 26, подфункция 2 - получить раскладку клавиатуры. =====
1506
======================================================================
1507
Раскладка клавиатуры используется для преобразования сканкодов,
1508
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1509
Параметры:
1510
  * eax = 26 - номер функции
1511
  * ebx = 2 - номер подфункции
1512
  * ecx = какую раскладку получать:
1513
    * 1 = нормальную
1514
    * 2 = раскладку при нажатом Shift
1515
    * 3 = раскладку при нажатом Alt
1516
  * edx = указатель на буфер длиной 128 байт, куда будет скопирована
1517
    раскладка
1518
Возвращаемое значение:
1519
  * функция не возвращает значения
1520
Или:
1521
  * eax = 26 - номер функции
1522
  * ebx = 2 - номер подфункции
1523
  * ecx = 9
1524
Возвращаемое значение:
1525
  * eax = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1526
Замечания:
1527
  * Если нажат Alt, то используется раскладка с Alt;
1528
    если не нажат Alt, но нажат Shift, то используется
1529
    раскладка с Shift;
1530
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1531
    нормальная раскладка, после чего из кода вычитается 0x60;
1532
    если не нажата ни одна из управляющих клавиш, то используется
1533
    нормальная раскладка.
1074 Galkov 1534
  * Установить раскладки и идентификатор страны можно с помощью
77 diamond 1535
    подфункции 2 функции 21.
1536
  * Идентификатор страны - глобальная системная переменная, которая
1537
    самим ядром не используется; однако приложение @panel отображает
1538
    соответствующую текущей стране иконку
1539
    (используя описываемую функцию).
1540
  * Приложение @panel переключает раскладки по запросу пользователя.
1541
 
1542
======================================================================
1543
============ Функция 26, подфункция 3 - получить базу CD. ============
1544
======================================================================
1545
Параметры:
1546
  * eax = 26 - номер функции
1547
  * ebx = 3 - номер подфункции
1548
Возвращаемое значение:
1549
  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1550
Замечания:
1551
  * База CD используется функцией 24.
114 mikedld 1552
  * Установить базу CD можно вызовом подфункции 3 функции 21.
77 diamond 1553
 
1554
======================================================================
1555
========== Функция 26, подфункция 5 - получить язык системы. =========
1556
======================================================================
1557
Параметры:
1558
  * eax = 26 - номер функции
1559
  * ebx = 5 - номер подфункции
1560
Возвращаемое значение:
1561
  * eax = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1562
Замечания:
1563
  * Язык системы - глобальная системная переменная, никак
1564
    не используемая самим ядром, однако приложение @panel рисует
1565
    соответствующую иконку (используя описываемую функцию).
1566
  * Установить язык системы можно вызовом подфункции 5 функции 21.
1567
 
1568
======================================================================
1569
============ Функция 26, подфункция 7 - получить базу HD. ============
1570
======================================================================
131 diamond 1571
База HD нужна для определения, на какой жёсткий диск писать, при
346 diamond 1572
использовании устаревшего синтаксиса /HD в устаревшей функции 58;
1573
при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
1574
база устанавливается автоматически.
77 diamond 1575
Параметры:
1576
  * eax = 26 - номер функции
1577
  * ebx = 7 - номер подфункции
1578
Возвращаемое значение:
1579
  * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1580
Замечания:
1581
  * Любое приложение в любой момент времени может изменить базу.
1582
  * Установить базу можно вызовом подфункции 7 функции 21.
131 diamond 1583
  * Получить используемый раздел жёсткого диска можно подфункцией 8.
77 diamond 1584
 
1585
======================================================================
1586
=========== Функция 26, подфункция 8 - получить раздел HD. ===========
1587
======================================================================
131 diamond 1588
Раздел HD нужен для определения, на какой раздел жёсткого диска
346 diamond 1589
писать, при использовании устаревшего синтаксиса /HD в устаревшей
1590
функции 58; при использовании современного синтаксиса
1591
/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
77 diamond 1592
Параметры:
1593
  * eax = 26 - номер функции
1594
  * ebx = 8 - номер подфункции
1595
Возвращаемое значение:
1596
  * eax = раздел HD (считая с 1)
1597
Замечания:
1598
  * Любое приложение в любой момент времени может изменить раздел.
1599
  * Установить раздел можно вызовом подфункции 8 функции 21.
131 diamond 1600
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1601
    подфункции 11 функции 18.
131 diamond 1602
  * Получить используемую базу жёсткого диска можно подфункцией 7.
77 diamond 1603
 
1604
======================================================================
131 diamond 1605
=== Функция 26, подфункция 9 - получить значение счётчика времени. ===
77 diamond 1606
======================================================================
1607
Параметры:
1608
  * eax = 26 - номер функции
1609
  * ebx = 9 - номер подфункции
1610
Возвращаемое значение:
1611
  * eax = число сотых долей секунды, прошедших с момента
1612
    запуска системы
1613
Замечания:
131 diamond 1614
  * Счётчик берётся по модулю 2^32, что соответствует немногим более
77 diamond 1615
    497 суток.
1616
  * Системное время можно получить функцией 3.
1617
 
1618
======================================================================
1619
====================== Функция 26, подфункция 11 =====================
131 diamond 1620
=========== Узнать, разрешён ли низкоуровневый доступ к HD. ==========
77 diamond 1621
======================================================================
1622
Параметры:
1623
  * eax = 26 - номер функции
1624
  * ebx = 11 - номер подфункции
1625
Возвращаемое значение:
131 diamond 1626
  * eax = 0/1 - запрещён/разрешён
77 diamond 1627
Замечания:
1628
  * Используется при LBA-чтении (подфункция 8 функции 58).
1074 Galkov 1629
  * Установить текущее состояние можно вызовом
77 diamond 1630
    подфункции 11 функции 21.
1631
 
1632
======================================================================
1633
====================== Функция 26, подфункция 12 =====================
131 diamond 1634
========== Узнать, разрешён ли низкоуровневый доступ к PCI. ==========
77 diamond 1635
======================================================================
1636
Параметры:
1637
  * eax = 26 - номер функции
1638
  * ebx = 12 - номер подфункции
1639
Возвращаемое значение:
131 diamond 1640
  * eax = 0/1 - запрещён/разрешён
77 diamond 1641
Замечания:
1642
  * Используется при работе с шиной PCI (функция 62).
1643
  * Текущая реализация использует только младший бит ecx.
1074 Galkov 1644
  * Установить текущее состояние можно вызовом
77 diamond 1645
    подфункции 12 функции 21.
1646
 
1647
======================================================================
1648
================ Функция 29 - получить системную дату. ===============
1649
======================================================================
1650
Параметры:
1651
  * eax = 29 - номер функции
1652
Возвращаемое значение:
1653
  * eax = 0x00DDMMYY, где
1654
    (используется двоично-десятичное кодирование, BCD)
1655
  * YY = две младшие цифры года (00..99)
1656
  * MM = месяц (01..12)
1657
  * DD = день (01..31)
1658
Замечания:
1659
  * Системную дату можно установить функцией 22.
1660
 
1661
======================================================================
521 diamond 1662
================ Функция 30 - работа с текущей папкой. ===============
1663
======================================================================
1664
 
1665
-------- Подфункция 1 - установить текущую папку для потока. ---------
1666
Параметры:
1667
  * eax = 30 - номер функции
1668
  * ebx = 1 - номер подфункции
1669
  * ecx = указатель на ASCIIZ-строку с путём к новой текущей папке
1670
Возвращаемое значение:
1671
  * функция не возвращает значения
1672
 
1673
--------- Подфункция 2 - получить текущую папку для потока. ----------
1674
Параметры:
1675
  * eax = 30 - номер функции
1676
  * ebx = 2 - номер подфункции
1677
  * ecx = указатель на буфер
1678
  * edx = размер буфера
1679
Возвращаемое значение:
1680
  * eax = длина имени текущей папки (включая завершающий 0)
1681
Замечания:
1682
  * Если размера буфера недостаточно для копирования всего имени,
1683
    копируются только первые (edx-1) байт
1684
    и в конце ставится завершающий 0.
1685
 
1686
======================================================================
1018 diamond 1687
================ Функция 32 - удалить файл с рамдиска. ===============
1688
======================================================================
1689
Параметры:
1690
  * eax = 32 - номер функции
1691
  * ebx = указатель на имя файла
1692
Возвращаемое значение:
1693
  * eax = 0 - успешно; иначе код ошибки файловой системы
1694
Замечания:
1695
  * Эта функция устарела; функция 58 позволяет выполнять
1696
    те же действия с расширенными возможностями.
1697
  * Текущая реализация возвращает только значения 0(успех) и
1698
    5(файл не найден).
1699
  * Имя файла должно быть либо в формате 8+3 символов (первые
1700
    8 символов - собственно имя, последние 3 - расширение,
1701
    короткие имена и расширения дополняются пробелами),
1702
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1703
    (имя не более 8 символов, точка, расширение 3 символа,
1704
    дополненное при необходимости пробелами).
1705
    Имя файла должно быть записано заглавными буквами.
1706
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
1707
  * Эта функция не поддерживает папок на рамдиске.
1708
 
1709
======================================================================
1710
=============== Функция 33 - записать файл на рамдиск. ===============
1711
======================================================================
1712
Параметры:
1713
  * eax = 33 - номер функции
1714
  * ebx = указатель на имя файла
1715
  * ecx = указатель на данные для записи
1716
  * edx = число байт для записи
1717
  * следует устанавливать esi=0
1718
Возвращаемое значение:
1719
  * eax = 0 - успешно, иначе код ошибки файловой системы
1720
Замечания:
1721
  * Эта функция устарела; функция 70 позволяет выполнять
1722
    те же действия с расширенными возможностями.
1723
  * Если указать ненулевое значение в esi и на рамдиске уже есть
1724
    указанный файл, то будет создан ещё один файл с тем же именем.
1725
  * В противном случае файл перезаписывается.
1726
  * Имя файла должно быть либо в формате 8+3 символов
1727
    (первые 8 символов - собственно имя, последние 3 - расширение,
1728
    короткие имена и расширения дополняются пробелами),
1729
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1730
    (имя не более 8 символов, точка, расширение 3 символа,
1731
    дополненное при необходимости пробелами).
1732
    Имя файла должно быть записано заглавными буквами.
1733
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
1734
  * Эта функция не поддерживает папок на рамдиске.
1735
 
1736
======================================================================
77 diamond 1737
============ Функция 35 - прочитать цвет точки на экране. ============
1738
======================================================================
1739
Параметры:
1740
  * eax = 35
1741
  * ebx = y*xsize+x, где
1742
  * (x,y) = координаты точки (считая от 0)
1743
  * xsize = размер экрана по горизонтали
1744
Возвращаемое значение:
1745
  * eax = цвет 0x00RRGGBB
1746
Замечания:
1747
  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
1748
    что она вычитает 1 из обоих размеров.
1749
  * К видеопамяти есть также прямой доступ (без вызовов системных
1750
    функций) через селектор gs. Параметры текущего видеорежима
1751
    можно получить функцией 61.
1752
 
1753
======================================================================
1018 diamond 1754
=============== Функция 36 - прочитать область экрана. ===============
921 mario79 1755
======================================================================
1756
Параметры:
1757
  * eax = 36 - номер функции
1758
  * ebx = указатель на предварительно выделенную область памяти,
1018 diamond 1759
            куда будет помещено изображение в формате BBGGRRBBGGRR...
921 mario79 1760
  * ecx = [размер по оси x]*65536 + [размер по оси y]
1761
  * edx = [координата по оси x]*65536 + [координата по оси y]
1762
Возвращаемое значение:
1763
  * функция не возвращает значения
1764
Замечания:
1018 diamond 1765
  * Координаты области - это координаты верхнего левого угла
1766
    области относительно экрана.
921 mario79 1767
  * Размер изображения в байтах есть 3*xsize*ysize.
1768
 
1769
======================================================================
277 diamond 1770
==================== Функция 37 - работа с мышью. ====================
77 diamond 1771
======================================================================
1772
 
1773
-------------- Подфункция 0 - экранные координаты мыши ---------------
1774
Параметры:
1775
  * eax = 37 - номер функции
1776
  * ebx = 0 - номер подфункции
1777
Возвращаемое значение:
1778
  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
1779
 
1780
---------- Подфункция 1 - координаты мыши относительно окна ----------
1781
Параметры:
1782
  * eax = 37 - номер функции
1783
  * ebx = 1 - номер подфункции
1784
Возвращаемое значение:
1785
  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
1786
    окна приложения (считая от 0)
1787
Замечания:
1788
  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
1789
    Если y>=ywnd, то младшее слово неотрицательно и содержит
1790
    относительную y-координату, а старшее - относительную x-координату
1791
    (правильного знака). В противном случае младшее слово отрицательно
131 diamond 1792
    и всё равно содержит относительную y-координату,
77 diamond 1793
    а к старшему слову следует прибавить 1.
1794
 
1795
----------------- Подфункция 2 - нажатые кнопки мыши -----------------
1796
Параметры:
1797
  * eax = 37 - номер функции
1798
  * ebx = 2 - номер подфункции
1799
Возвращаемое значение:
1800
  * eax содержит информацию о нажатых кнопках мыши:
1801
  * бит 0 установлен = левая кнопка нажата
1802
  * бит 1 установлен = правая кнопка нажата
486 kastigar 1803
  * бит 2 установлен = средняя кнопка нажата
1804
  * бит 3 установлен = 4-я кнопка нажата
1805
  * бит 4 установлен = 5-я кнопка нажата
77 diamond 1806
  * прочие биты сброшены
1807
 
277 diamond 1808
------------------ Подфункция 4 - загрузить курсор -------------------
221 serge 1809
Параметры:
1810
  * eax = 37 - номер функции
1811
  * ebx = 4 - номер подфункции
277 diamond 1812
  * dx = источник данных:
1813
  * dx = LOAD_FROM_FILE = 0 - данные в файле
1814
    * ecx = указатель на полный путь к файлу курсора
1815
    * файл курсора должен быть в формате .cur, стандартном для
1816
      MS Windows, причём размером 32*32 пикселя
1817
  * dx = LOAD_FROM_MEM = 1 - данные файла уже загружены в память
1818
    * ecx = указатель на данные файла курсора
1819
    * формат данных такой же, как и в предыдущем случае
1820
  * dx = LOAD_INDIRECT = 2 - данные в памяти
1821
    * ecx = указатель на образ курсора в формате ARGB 32*32 пикселя
1822
    * edx = 0xXXYY0002, где
1823
      * XX = x-координата "горячей точки" курсора
1824
      * YY = y-координата
1825
      * 0 <= XX, YY <= 31
221 serge 1826
Возвращаемое значение:
277 diamond 1827
  * eax = 0 - неудача
1828
  * иначе eax = хэндл курсора
221 serge 1829
 
277 diamond 1830
------------------ Подфункция 5 - установить курсор ------------------
1831
Устанавливает новый курсор для окна текущего потока.
221 serge 1832
Параметры:
1833
  * eax = 37 - номер функции
1834
  * ebx = 5 - номер подфункции
277 diamond 1835
  * ecx = хэндл курсора
221 serge 1836
Возвращаемое значение:
277 diamond 1837
  * eax = хэндл предыдущего установленного курсора
1838
Замечания:
1839
  * Если передан некорректный хэндл, то функция восстановит курсор
1840
    по умолчанию (стандартную стрелку). В частности, к восстановлению
1841
    курсора по умолчанию приводит передача ecx=0.
221 serge 1842
 
277 diamond 1843
------------------- Подфункция 6 - удалить курсор --------------------
221 serge 1844
Параметры:
1845
  * eax = 37 - номер функции
1846
  * ebx = 6 - номер подфункции
277 diamond 1847
  * ecx = хэндл курсора
221 serge 1848
Возвращаемое значение:
277 diamond 1849
  * eax разрушается
1850
Замечания:
1851
  * Курсор должен был быть ранее загружен текущим потоком
1852
    (вызовом подфункции 4). Функция не удаляет системные курсоры и
1853
    курсоры, загруженные другими приложениями.
1854
  * Если удаляется активный (установленный подфункцией 5) курсор, то
1855
    восстанавливается курсор по умолчанию (стандартная стрелка).
221 serge 1856
 
499 diamond 1857
------------------ Подфункция 7 - данные прокрутки -------------------
486 kastigar 1858
Параметры:
1859
  * eax = 37 - номер функции
499 diamond 1860
  * ebx = 6 - номер подфункции
486 kastigar 1861
Возвращаемое значение:
499 diamond 1862
  * eax = [horizontal offset]*65536 + [vertical offset]
486 kastigar 1863
Замечания:
499 diamond 1864
  * Данные доступны только активному окну.
1865
  * После прочтения значения обнуляются.
1866
  * Данные имеют знаковые значения.
486 kastigar 1867
 
77 diamond 1868
======================================================================
1869
================== Функция 38 - нарисовать отрезок. ==================
1870
======================================================================
1871
Параметры:
1872
  * eax = 38 - номер функции
1873
  * ebx = [координата начала по оси x]*65536 +
1874
              [координата конца по оси x]
1875
  * ecx = [координата начала по оси y]*65536 +
1876
              [координата конца по оси y]
1877
  * edx = 0x00RRGGBB - цвет
133 diamond 1878
    edx = 0x01xxxxxx - рисовать инверсный отрезок
1879
          (младшие 24 бита игнорируются)
77 diamond 1880
Возвращаемое значение:
1881
  * функция не возвращает значения
1882
Замечания:
1883
  * Координаты берутся относительно окна.
1884
  * Конечная точка также рисуется.
1885
 
1886
======================================================================
1887
== Функция 39, подфункция 1 - получить размер фонового изображения. ==
1888
======================================================================
1889
Параметры:
1890
  * eax = 39 - номер функции
1891
  * ebx = 1 - номер подфункции
1892
Возвращаемое значение:
1893
  * eax = [ширина]*65536 + [высота]
1894
Замечания:
1074 Galkov 1895
  * Есть парная команда установки размеров фонового изображения -
77 diamond 1896
    подфункция 1 функции 15. После которой, разумеется, следует
1897
    заново определить само изображение.
1898
 
1899
======================================================================
1900
= Функция 39, подфункция 2 - прочитать точку с фонового изображения. =
1901
======================================================================
1902
Параметры:
1903
  * eax = 39 - номер функции
1904
  * ebx = 2 - номер подфункции
1905
  * ecx = смещение
1906
Возвращаемое значение:
1907
  * eax = 0x00RRGGBB - цвет точки, если смещение допустимо
1908
    (меньше 0x160000-16)
1909
  * eax = 2 - иначе
1910
Замечания:
1911
  * Не следует полагаться на возвращаемое значение в случае неверного
1912
    смещения, оно может измениться в следующих версиях ядра.
1913
  * Смещение точки с координатами (x,y) вычисляется как (x+y*xsize)*3.
1074 Galkov 1914
  * Есть парная функция установки точки на фоновом изображении -
77 diamond 1915
    подфункция 2 функции 15.
1916
 
1917
======================================================================
1918
====== Функция 39, подфункция 4 - получить режим отрисовки фона. =====
1919
======================================================================
1920
Параметры:
1921
  * eax = 39 - номер функции
1922
  * ebx = 4 - номер подфункции
1923
Возвращаемое значение:
1924
  * eax = 1 - замостить
1925
  * eax = 2 - растянуть
1926
Замечания:
1074 Galkov 1927
  * Есть парная функция установки режима отрисовки фона -
77 diamond 1928
    подфункция 4 функции 15.
1929
 
1930
======================================================================
1931
======== Функция 40 - установить маску для ожидаемых событий. ========
1932
======================================================================
1933
Маска для ожидаемых событий влияет на функции работы с событиями 10,
131 diamond 1934
11, 23 - они сообщают только о событиях, разрешённых этой маской.
77 diamond 1935
Параметры:
1936
  * eax = 40 - номер функции
1937
  * ebx = маска: бит i соответствует событию i+1 (см. список событий)
1938
    (установленный бит разрешает извещение о событии)
1939
Возвращаемое значение:
1940
  * функция не возвращает значения
1941
Замечания:
1942
  * Маска по умолчанию (7=111b) разрешает извещения о перерисовке
1943
    и нажатиях клавиш и кнопок.
1944
    Этого достаточно для большинства приложений.
131 diamond 1945
  * События, запрещённые в маске, всё равно сохраняются, если
77 diamond 1946
    приходят; о них просто не извещают функции работы с событиями.
1947
  * Функции работы с событиями учитывают маску на момент
1948
    вызова функции, а не на момент поступления сообщения.
1949
 
1950
======================================================================
1951
================= Функция 41 - узнать владельца IRQ. =================
1952
======================================================================
1953
Параметры:
1954
  * eax = 41 - номер функции
1955
  * ebx = номер IRQ, 0..15
1956
Возвращаемое значение:
1957
  * eax = PID владельца
1958
  * eax = 0, если владельца нет
1959
  * eax = -1 для некорректного ebx
1960
 
1961
======================================================================
1018 diamond 1962
========= Функция 42 - работа с данными, полученными по IRQ. =========
77 diamond 1963
======================================================================
1964
При возникновении IRQ система может считывать данные из указанных
1965
ранее функцией 44 портов и записывать эти данные в буфер.
1018 diamond 1966
 
1967
-------------------- Подфункция 0 - чтение данных --------------------
77 diamond 1968
Параметры:
1969
  * eax = 42 - номер функции
1018 diamond 1970
  * bl = номер IRQ, 0..15
1971
  * bh = 0 - номер подфункции
1972
  * остальная часть регистра ebx должна быть обнулена
1973
  * ecx = указатель на буфер размером не менее 4000 байт
760 Rus 1974
Возвращаемое значение: (ситуацию можно различить по значению eax)
77 diamond 1975
  * если поток не является владельцем IRQ
1018 diamond 1976
    (или номер IRQ задан неверно): eax = -1
1977
  * если данных нет: eax = 0
131 diamond 1978
  * если всё в порядке и данные были:
1018 diamond 1979
    eax = размер данных, прочитанных из буфера (в байтах)
760 Rus 1980
 
1018 diamond 1981
------------ Подфункция 1 - узнать размер данных в буфере ------------
760 Rus 1982
Параметры:
1983
  * eax = 42 - номер функции
1018 diamond 1984
  * bl = номер IRQ, 0..15
1985
  * bh = 1 - номер подфункции
1986
  * остальная часть регистра ebx должна быть обнулена
1987
Возвращаемое значение:
760 Rus 1988
  * если поток не является владельцем IRQ
1018 diamond 1989
    (или номер IRQ задан неверно): eax = -1
1990
  * иначе eax = размер данных в буфере
77 diamond 1991
Замечания:
1992
  * Предварительно поток должен зарезервировать для себя указанный IRQ
1993
    функцией 45.
1994
  * Размер буфера для данных - 4000 байт, при переполнении
1995
    "свежие" данные перестают записываться в буфер.
1996
 
1997
======================================================================
1998
=================== Функция 43 - ввод/вывод в порт. ==================
1999
======================================================================
2000
 
2001
------------------------ Вывод данных в порт -------------------------
2002
Параметры:
2003
  * eax = 43 - номер функции
2004
  * bl = байт для вывода
2005
  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
2006
Возвращаемое значение:
2007
  * eax = 0 - успешно
2008
  * eax = 1 - поток не зарезервировал указанный порт
2009
 
2010
------------------------ Ввод данных из порта ------------------------
2011
Параметры:
2012
  * eax = 43 - номер функции
2013
  * ebx игнорируется
2014
  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
2015
Возвращаемое значение:
131 diamond 2016
  * eax = 0 - успешно, при этом ebx = введённый байт
77 diamond 2017
  * eax = 1 - поток не зарезервировал данный порт
2018
Замечания:
2019
  * Предварительно поток должен зарезервировать за собой
2020
    указанный порт функцией 46.
2021
  * Для зарезервированных портов вместо вызова этих функций
2022
    лучше использовать команды процессора in/out - это значительно
2023
    быстрее и несколько короче и проще. Из незарезервированных
131 diamond 2024
    портов читать всё равно нельзя.
77 diamond 2025
 
2026
======================================================================
2027
======== Функция 44 - определить действия при поступлении IRQ. =======
2028
======================================================================
2029
При возникновении IRQ система может считывать данные из указанных этой
2030
функцией портов и записывать эти данные в буфер, откуда их можно
2031
прочитать функцией 42.
2032
Параметры:
2033
  * eax = 44 - номер функции
2034
  * ebx = указатель на массив структур, описывающих по одному порту:
2035
    * +0: word: 0 означает конец массива, иначе номер порта
2036
    * +2: byte: зарезервировано (игнорируется)
2037
    * +3: byte: 1=считывать байт из этого порта, 2=считывать слово
2038
  * ecx = номер IRQ, 0..15
2039
Возвращаемое значение:
2040
  * eax = 0 - успешно
2041
  * eax = 1 - поток не является владельцем указанного IRQ
2042
Замечания:
2043
  * Предварительно поток должен зарезервировать за собой
2044
    указываемый IRQ функцией 45.
2045
  * Принимаются во внимание только первые 16 портов.
2046
  * Текущая реализация рассматривает неправильное значение поля +3
2047
    как сигнал прекращения обработки IRQ.
2048
 
2049
======================================================================
2050
============ Функция 45 - зарезервировать/освободить IRQ. ============
2051
======================================================================
2052
Параметры:
2053
  * eax = 45 - номер функции
2054
  * ebx = 0 - зарезервировать, 1 = освободить
2055
  * ecx = номер IRQ, 0..15
2056
Возвращаемое значение:
2057
  * eax = 0 - успешно
2058
  * eax = 1 - ошибка (неверный номер IRQ или
2059
    попытка зарезервировать несвободный IRQ или освободить IRQ, не
2060
    зарезервированный текущим потоком)
2061
Замечания:
2062
  * Резервирование IRQ нужно для работы функций 42 и 44.
2063
  * Только один поток может зарезервировать конкретный IRQ.
2064
  * IRQ, обрабатываемые системой самостоятельно, резервируются
2065
    системой (потоком 1) при загрузке.
2066
  * При завершении потока автоматически освобождаются
2067
    все зарезервированные им IRQ.
2068
 
2069
======================================================================
1074 Galkov 2070
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
77 diamond 2071
======================================================================
2072
К зарезервированным портам можно обращаться напрямую из приложения
2073
командами in/out (рекомендуемый способ) и вызовом функции 43
2074
(нерекомендуемый способ).
2075
Параметры:
2076
  * eax = 46 - номер функции
2077
  * ebx = 0 - зарезервировать, 1 - освободить
2078
  * ecx = номер начала диапазона портов
2079
  * edx = номер конца диапазона портов (включительно)
2080
Возвращаемое значение:
2081
  * eax = 0 - успешно
2082
  * eax = 1 - ошибка
2083
Замечания:
2084
  * В случае резервирования портов ошибкой считается выполнение
2085
    одного из условий:
2086
    * начальный адрес больше конечного;
2087
    * указанный диапазон содержит некорректный номер порта
2088
      (корректные - от 0 до 0xFFFF);
2089
    * превышено ограничение на общее число зарезервированных областей
2090
      - допускается максимум 255;
2091
    * указанный диапазон пересекается с одним из
2092
      ранее зарезервированных
2093
  * В случае освобождения портов ошибкой считается попытка
2094
    освобождения диапазона, который ранее не был целиком
2095
    зарезервирован этой же функцией (с такими же значениями ecx,edx).
2096
  * При обнаружении ошибки (в обоих случаях) никаких действий
2097
    не производится.
277 diamond 2098
  * При загрузке система резервирует за собой порты
2099
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (включительно).
77 diamond 2100
  * При завершении потока автоматически освобождаются все
2101
    зарезервированные им порты.
2102
 
2103
======================================================================
2104
================= Функция 47 - вывести число в окно. =================
2105
======================================================================
2106
Параметры:
2107
  * eax = 47 - номер функции
2108
  * ebx = параметры преобразования числа в текст:
2109
    * bl = 0 - ecx содержит число
665 diamond 2110
    * bl = 1 - ecx содержит указатель на dword/qword-число
77 diamond 2111
    * bh = 0 - отображать в десятичной системе счисления
2112
    * bh = 1 - отображать в шестнадцатеричной системе
2113
    * bh = 2 - отображать в двоичной системе
2114
    * биты 16-21 = сколько цифр отображать
655 mario79 2115
    * биты 22-29 зарезервированы и должны быть установлены в 0
665 diamond 2116
    * бит 30 установлен = выводить qword (64-битное число);
2117
                              при этом должно быть bl = 1
2118
    * бит 31 установлен = не выводить ведущие нули числа
77 diamond 2119
  * ecx = число (при bl=0) или указатель (при bl=1)
2120
  * edx = [координата по оси x]*65536 + [координата по оси y]
142 diamond 2121
  * esi = 0xX0RRGGBB:
2122
    * RR, GG, BB задают цвет
2123
    * X = ABnn (биты)
2124
    * nn = шрифт (0/1)
2125
    * A игнорируется
2126
    * B=1 - закрашивать фон цветом edi
77 diamond 2127
Возвращаемое значение:
2128
  * функция не возвращает значения
2129
Замечания:
2130
  * Указанная длина не должна превосходить 60.
2131
  * Выводится ровно указанное количество цифр. Если число мало и
2132
    может быть записано меньшим количеством цифр, оно дополняется
2133
    ведущими нулями; если число велико и не может быть записано
2134
    таким количеством цифр, "лишние" ведущие цифры обрезаются.
2135
  * Параметры шрифтов указаны в описании функции 4 (вывода текста).
2136
 
2137
======================================================================
2138
======= Функция 48, подфункция 0 - применить настройки экрана. =======
2139
======================================================================
2140
Параметры:
2141
  * eax = 48 - номер функции
2142
  * ebx = 0 - номер подфункции
2143
  * ecx = 0 - зарезервировано
2144
Возвращаемое значение:
2145
  * функция не возвращает значения
2146
Замечания:
2147
  * Функция перерисовывает экран после изменения параметров
2148
    подфункциями 1 и 2.
2149
  * Вызов функции без предшествующих вызовов указанных подфункций
2150
    игнорируется.
2151
  * Вызов функции с ненулевым ecx игнорируется.
2152
 
2153
======================================================================
2154
========= Функция 48, подфункция 1 - установить стиль кнопок. ========
2155
======================================================================
2156
Параметры:
2157
  * eax = 48 - номер функции
2158
  * ebx = 1 - номер подфункции
2159
  * ecx = тип кнопок:
2160
    * 0 = плоские
131 diamond 2161
    * 1 = объёмные
77 diamond 2162
Возвращаемое значение:
2163
  * функция не возвращает значения
2164
Замечания:
1074 Galkov 2165
  * После вызова описываемой функции следует перерисовать экран
77 diamond 2166
    подфункцией 0.
2167
  * Тип кнопок влияет только на их прорисовку функцией 8.
2168
 
2169
======================================================================
2170
==== Функция 48, подфункция 2 - установить стандартные цвета окон. ===
2171
======================================================================
2172
Параметры:
2173
  * eax = 48 - номер функции
2174
  * ebx = 2 - номер подфункции
2175
  * ecx = указатель на таблицу цветов
2176
  * edx = размер таблицы цветов
2177
    (должен быть 40 байт для будущей совместимости)
2178
Формат таблицы цветов указан в описании подфункции 3.
2179
Возвращаемое значение:
2180
  * функция не возвращает значения
2181
Замечания:
1074 Galkov 2182
  * После вызова описываемой функции следует перерисовать экран
77 diamond 2183
    подфункцией 0.
2184
  * Таблица стандартных цветов влияет только на приложения,
2185
    которые эту таблицу явным образом получают (подфункцией 3) и
131 diamond 2186
    используют (указывая цвета из неё при вызовах функций рисования).
77 diamond 2187
  * Таблица стандартных цветов входит в скин и устанавливается заново
2188
    при установке скина (подфункции 8).
2189
  * Таблицу цветов можно просматривать/изменять интерактивно с помощью
2190
    приложения desktop.
2191
 
2192
======================================================================
2193
===== Функция 48, подфункция 3 - получить стандартные цвета окон. ====
2194
======================================================================
2195
Параметры:
2196
  * eax = 48 - номер функции
2197
  * ebx = 3 - номер подфункции
2198
  * ecx = указатель на буфер размером edx байт,
2199
    куда будет записана таблица
2200
  * edx = размер таблицы цветов
2201
    (должен быть 40 байт для будущей совместимости)
2202
Возвращаемое значение:
2203
  * функция не возвращает значения
2204
Формат таблицы цветов: каждый элемент -
2205
dword-значение цвета 0x00RRGGBB
2206
  * +0: dword: frames - цвет рамки
2207
  * +4: dword: grab - цвет заголовка
2208
  * +8: dword: grab_button - цвет кнопки на полосе заголовка
2209
  * +12 = +0xC: dword: grab_button_text - цвет текста на кнопке
2210
    на полосе заголовка
2211
  * +16 = +0x10: dword: grab_text - цвет текста на заголовке
2212
  * +20 = +0x14: dword: work - цвет рабочей области
2213
  * +24 = +0x18: dword: work_button - цвет кнопки в рабочей области
2214
  * +28 = +0x1C: dword: work_button_text - цвет текста на кнопке
2215
    в рабочей области
2216
  * +32 = +0x20: dword: work_text - цвет текста в рабочей области
2217
  * +36 = +0x24: dword: work_graph - цвет графики в рабочей области
2218
Замечания:
2219
  * Структура таблицы цветов описана в стандартном включаемом файле
2220
    macros.inc под названием system_colors; например, можно писать:
1074 Galkov 2221
        sc      system_colors           ; объявление переменной
2222
        ...                             ; где-то надо вызвать
2223
                                        ; описываемую функцию с ecx=sc
2224
        mov     ecx, [sc.work_button_text]      ; читаем цвет текста
2225
                                        ; на кнопке в рабочей области
77 diamond 2226
  * Использование/неиспользование этих цветов - дело исключительно
2227
    самой программы. Для использования нужно просто при вызове функций
2228
    рисования указывать цвет, взятый из этой таблицы.
2229
  * При изменении таблицы стандартных цветов (подфункцией 2 с
2230
    последующим применением изменений подфункцией 0 или
2231
    при установке скина подфункцией 8) всем окнам посылается сообщение
2232
    о необходимости перерисовки (событие с кодом 1).
2233
  * Стандартные цвета можно просматривать/изменять интерактивно
2234
    с помощью приложения desktop.
2235
 
2236
======================================================================
2237
========== Функция 48, подфункция 4 - получить высоту скина. =========
2238
======================================================================
2239
Параметры:
2240
  * eax = 48 - номер функции
2241
  * ebx = 4 - номер подфункции
2242
Возвращаемое значение:
2243
  * eax = высота скина
2244
Замечания:
2245
  * Высотой скина по определению считается высота заголовка окон,
2246
    использующих скин.
2247
  * Смотри также общую структуру окна в описании функции 0.
2248
 
2249
======================================================================
2250
===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
2251
======================================================================
2252
Параметры:
2253
  * eax = 48 - номер функции
2254
  * ebx = 5 - номер подфункции
2255
Возвращаемое значение:
2256
  * eax = [left]*65536 + [right]
2257
  * ebx = [top]*65536 + [bottom]
2258
Замечания:
2259
  * Рабочая область экрана определяет положение и координаты
2260
    максимизированного окна.
2261
  * Рабочая область экрана при нормальной работе есть весь экран
2262
    за вычетом панели (@panel).
2263
  * (left,top) - координаты левого верхнего угла,
2264
    (right,bottom) - координаты правого нижнего.
2265
    Таким образом, размер рабочей области по оси x определяется
2266
    формулой right-left+1, по оси y - формулой bottom-right+1.
2267
  * Смотри также функцию 14,
2268
    позволяющую определить размеры всего экрана.
2269
  * Есть парная функция установки рабочей области - подфункция 6.
2270
 
2271
======================================================================
2272
==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
2273
======================================================================
2274
Параметры:
2275
  * eax = 48 - номер функции
2276
  * ebx = 6 - номер подфункции
2277
  * ecx = [left]*65536 + [right]
2278
  * edx = [top]*65536 + [bottom]
2279
Возвращаемое значение:
2280
  * функция не возвращает значения
2281
Замечания:
2282
  * Рабочая область экрана определяет положение и координаты
2283
    максимизированного окна.
2284
  * Эта функция используется только приложением @panel,
2285
    устанавливающим рабочей областью весь экран за вычетом панели.
2286
  * (left,top) - координаты левого верхнего угла,
2287
    (right,bottom) - координаты правого нижнего.
2288
    Таким образом, размер рабочей области по оси x определяется
2289
    формулой right-left+1, по оси y - формулой bottom-right+1.
2290
  * Если left>=right, то x-координаты рабочей области не изменяются.
2291
    Если left<0, то left не устанавливается. Если right больше
2292
    или равно ширины экрана, то right не устанавливается.
2293
    Аналогично по оси y.
2294
  * Смотри также функцию 14,
2295
    позволяющую определить размеры всего экрана.
1074 Galkov 2296
  * Есть парная функция получения рабочей области -
77 diamond 2297
    подфункция 5.
2298
  * Эта функция автоматически перерисовывает экран, по ходу дела
118 diamond 2299
    обновляет координаты и размеры максимизированных окон.
77 diamond 2300
    Все окна извещаются о необходимости перерисовки (событие 1).
2301
 
2302
======================================================================
2303
====================== Функция 48, подфункция 7 ======================
2304
============ Получить область скина для текста заголовка. ============
2305
======================================================================
2306
Возвращает область заголовка окна со скином, предназначенную
2307
для вывода текста заголовка.
2308
Параметры:
2309
  * eax = 48 - номер функции
2310
  * ebx = 7 - номер подфункции
2311
Возвращаемое значение:
2312
  * eax = [left]*65536 + [right]
2313
  * ebx = [top]*65536 + [bottom]
2314
Замечания:
2315
  * Использование/неиспользование этой функции -
2316
    личное дело приложения.
2317
  * Рекомендуется учитывать значения, возвращаемые этой функцией,
2318
    при выборе места для рисования текста заголовка (функцией 4) или
2319
    какого-нибудь заменителя текста заголовка
2320
    (по усмотрению приложения).
2321
 
2322
======================================================================
2323
==== Функция 48, подфункция 8 - установить используемый скин окон. ===
2324
======================================================================
2325
Параметры:
2326
  * eax = 48 - номер функции
2327
  * ebx = 8 - номер подфункции
546 diamond 2328
  * ecx = указатель на имя файла скина
77 diamond 2329
Возвращаемое значение:
2330
  * eax = 0 - успешно
546 diamond 2331
  * eax = 1 - не удалось загрузить файл
2332
  * eax = 2 - файл не является файлом скина
77 diamond 2333
Замечания:
2334
  * При успешной загрузке скина все окна извещаются о необходимости
2335
    перерисовки (событие 1).
2336
  * При загрузке система считывает скин из файла default.skn
2337
    на рамдиске.
2338
  * Пользователь может изменять скин статически, создав свой
2339
    default.skn, или динамически с помощью приложения desktop.
2340
 
2341
======================================================================
78 diamond 2342
============ Функция 49 - Advanced Power Management (APM). ===========
2343
======================================================================
2344
Параметры:
2345
  * eax = 49 - номер функции
2346
  * dx = номер функции APM (аналог ax в спецификации)
2347
  * bx, cx = параметры функции APM
2348
Возвращаемое значение:
2349
  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
2350
    установлены в соответствии со спецификацией APM
2351
  * старшие половины 32-битных регистров eax, ebx, ecx,
2352
    edx, esi, edi разрушаются
2353
Замечания:
2354
  * Спецификация APM 1.2 описывается в документе
2355
    "Advanced Power Management (APM) BIOS Specification"
2356
    (Revision 1.2), доступном на
2357
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2358
    кроме того, она включена в известный Interrupt List by Ralf Brown
2359
    (http://www.pobox.com/~ralf/files.html,
2360
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2361
 
2362
======================================================================
77 diamond 2363
================= Функция 50 - установка формы окна. =================
2364
======================================================================
2365
Обычные окна представляют собой прямоугольники. С помощью этой функции
131 diamond 2366
окну можно придать произвольную форму. Форма задаётся набором точек
77 diamond 2367
внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
2368
размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
2369
функцией 67.
2370
 
2371
--------------- Установка данных с информацией о форме ---------------
2372
Параметры:
2373
  * eax = 50 - номер функции
2374
  * ebx = 0 - номер подфункции
2375
  * ecx = указатель на данные формы (массив байт 0/1)
2376
Возвращаемое значение:
2377
  * функция не возвращает значения
2378
 
2379
------------------ Установка масштаба данных формы -------------------
2380
Параметры:
2381
  * eax = 50 - номер функции
2382
  * ebx = 1 - номер подфункции
131 diamond 2383
  * ecx задаёт масштаб: каждый байт данных определяет
77 diamond 2384
    (2^scale)*(2^scale) пикселей
2385
Возвращаемое значение:
2386
  * функция не возвращает значения
2387
Замечания:
2388
  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
2389
    данных формы один байт соответствует одному пикселю, то масштаб
2390
    можно не устанавливать.
2391
  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
2392
    обратите внимание, что они на единицу больше, чем устанавливаемые
2393
    функциями 0, 67.
2394
  * По определению масштаба xsize и ysize должны делиться на 2^scale.
2395
  * Байт данных по смещению a должен быть 0/1 и
2396
    определяет принадлежность окну квадрата со стороной 2^scale
2397
    (при scale=0 получаем пиксель) и координатами левого верхнего угла
2398
    (a mod (xsize shr scale), a div (xsize shr scale))
2399
  * Размер данных: (xsize shr scale)*(ysize shr scale).
2400
  * Данные должны присутствовать в памяти и не меняться
2401
    после установки формы.
2402
  * Система просматривает данные о форме при каждой перерисовке окна
2403
    функцией 0.
2404
  * Вызов подфункции 0 с нулевым указателем приводит к возврату
2405
    к прямоугольной форме.
2406
 
2407
======================================================================
2408
===================== Функция 51 - создать поток. ====================
2409
======================================================================
2410
Параметры:
2411
  * eax = 51 - номер функции
2412
  * ebx = 1 - единственная подфункция
2413
  * ecx = адрес точки входа потока (начальный eip)
2414
  * edx = указатель стэка потока (начальный esp)
2415
Возвращаемое значение:
2416
  * eax = -1 - ошибка (в системе слишком много потоков)
2417
  * иначе eax = TID - идентификатор потока
2418
 
2419
======================================================================
1074 Galkov 2420
= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
77 diamond 2421
======================================================================
2422
Параметры:
2423
  * eax = 52 - номер функции
2424
  * ebx = 0 - номер подфункции
2425
Возвращаемое значение:
2426
  * eax = двойное слово конфигурации
2427
Замечания:
2428
  * Слово конфигурации можно установить подфункцией 2.
2429
  * Ядро не использует соответствующую переменную.
2430
    Ценность этой переменной и работающих с ней подфункций 0 и 2
2431
    представляется сомнительной.
2432
 
2433
======================================================================
2434
======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
2435
======================================================================
2436
Параметры:
2437
  * eax = 52 - номер функции
2438
  * ebx = 1 - номер подфункции
2439
Возвращаемое значение:
2440
  * eax = IP-адрес (4 байта)
2441
Замечания:
2442
  * Локальный IP-адрес устанавливается подфункцией 3.
2443
 
2444
======================================================================
1074 Galkov 2445
 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
77 diamond 2446
======================================================================
2447
Параметры:
2448
  * eax = 52 - номер функции
2449
  * ebx = 2 - номер подфункции
2450
  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
2451
    число 3, это воспринимается как запрос на [пере-]инициализацию
2452
    Ethernet-карты, в противном случае Ethernet выключается
2453
Возвращаемое значение:
2454
  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
2455
    но это может измениться в будущих версиях ядра
2456
  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
2457
    (отсутствие Ethernet-карты), а ненулевое значение - успех
2458
Замечания:
2459
  * Слово конфигурации можно прочитать подфункцией 0.
2460
  * Ядро не использует соответствующую переменную.
2461
    Ценность этой переменной, подфункции 0 и части подфункции 2,
2462
    устанавливающей эту переменную, представляется сомнительной.
2463
 
2464
======================================================================
2465
====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
2466
======================================================================
2467
Параметры:
2468
  * eax = 52 - номер функции
2469
  * ebx = 3 - номер подфункции
2470
  * ecx = IP-адрес (4 байта)
2471
Возвращаемое значение:
2472
  * текущая реализация возвращает eax=3, но это может быть изменено
2473
    в будущих версиях
2474
Замечания:
2475
  * Локальный IP-адрес можно получить подфункцией 1.
2476
 
2477
======================================================================
2478
= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
2479
======================================================================
2480
Параметры:
2481
  * eax = 52 - номер функции
2482
  * ebx = 6 - номер подфункции
2483
  * edx = размер данных
2484
  * esi = указатель на данные
2485
Возвращаемое значение:
2486
  * eax = -1 - ошибка
2487
  * eax = 0 - успешно
2488
Замечания:
2489
  * Эта функция предназначена только для медленных сетевых драйверов
2490
    (PPP, SLIP).
2491
  * Размер данных не должен превосходить 1500 байт,
2492
    хотя проверок корректности не делается.
2493
 
2494
======================================================================
2495
====================== Функция 52, подфункция 8 ======================
2496
============= Прочитать данные из сетевой очереди вывода. ============
2497
======================================================================
2498
Параметры:
2499
  * eax = 52 - номер функции
2500
  * ebx = 8 - номер подфункции
2501
  * esi = указатель на буфер размером 1500 байт
2502
Возвращаемое значение:
2503
  * eax = число прочитанных байт (в текущей реализации
2504
    либо 0 = нет данных, либо 1500)
2505
  * данные скопированы в буфер
2506
Замечания:
2507
  * Эта функция предназначена только для медленных сетевых драйверов
2508
    (PPP, SLIP).
2509
 
2510
======================================================================
2511
=========== Функция 52, подфункция 9 - получить gateway IP. ==========
2512
======================================================================
2513
Параметры:
2514
  * eax = 52 - номер функции
2515
  * ebx = 9 - номер подфункции
2516
Возвращаемое значение:
2517
  * eax = gateway IP (4 байта)
2518
 
2519
======================================================================
2520
========= Функция 52, подфункция 10 - получить маску подсети. ========
2521
======================================================================
2522
Параметры:
2523
  * eax = 52 - номер функции
2524
  * ebx = 10 - номер подфункции
2525
Возвращаемое значение:
2526
  * eax = маска подсети
2527
 
2528
======================================================================
2529
========= Функция 52, подфункция 11 - установить gateway IP. =========
2530
======================================================================
2531
Параметры:
2532
  * eax = 52 - номер функции
2533
  * ebx = 11 - номер подфункции
2534
  * ecx = gateway IP (4 байта)
2535
Возвращаемое значение:
2536
  * текущая реализация возвращает eax=11, но это может быть изменено
2537
    в будущих реализациях
2538
 
2539
======================================================================
2540
======== Функция 52, подфункция 12 - установить маску подсети. =======
2541
======================================================================
2542
Параметры:
2543
  * eax = 52 - номер функции
2544
  * ebx = 12 - номер подфункции
2545
  * ecx = маска подсети
2546
Возвращаемое значение:
2547
  * текущая реализация возвращает eax=12, но это может быть изменено
2548
    в будущих версиях
2549
 
2550
======================================================================
2551
============ Функция 52, подфункция 13 - получить DNS IP. ============
2552
======================================================================
2553
Параметры:
2554
  * eax = 52 - номер функции
2555
  * ebx = 13 - номер подфункции
2556
Возвращаемое значение:
2557
  * eax = DNS IP (4 байта)
2558
 
2559
======================================================================
2560
=========== Функция 52, подфункция 14 - установить DNS IP. ===========
2561
======================================================================
2562
Параметры:
2563
  * eax = 52 - номер функции
2564
  * ebx = 14 - номер подфункции
2565
  * ecx = DNS IP (4 байта)
2566
Возвращаемое значение:
2567
  * текущая реализация возвращает eax=14, но это может быть изменено
2568
    в следующих версиях
2569
 
2570
======================================================================
277 diamond 2571
====== Функция 52, подфункция 15 - получить локальный MAC-адрес. =====
2572
======================================================================
2573
Параметры:
2574
  * eax = 52 - номер функции
2575
  * ebx = 15 - номер подфункции
2576
  * ecx = 0 - читать первые 4 байта,
2577
    ecx = 4 - читать последние 2 байта
2578
Возвращаемое значение:
2579
  * для ecx=0: eax = первые 4 байта MAC-адреса
2580
  * для ecx=4: ax = последние 2 байта MAC-адреса,
2581
               старшая половина eax разрушается
2582
  * для других ecx: eax = -1 как признак ошибки
2583
 
2584
======================================================================
77 diamond 2585
============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========
2586
======================================================================
2587
Параметры:
2588
  * eax = 53 - номер функции
2589
  * ebx = 0 - номер подфункции
2590
  * ecx = локальный порт (учитывается только младшее слово)
131 diamond 2591
  * edx = удалённый порт (учитывается только младшее слово)
2592
  * esi = удалённый IP
77 diamond 2593
Возвращаемое значение:
2594
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2595
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2596
    сокет и имеющее смысл только для системы) - успешно;
2597
    ebx разрушается
2598
 
2599
======================================================================
2600
============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========
2601
======================================================================
2602
Параметры:
2603
  * eax = 53 - номер функции
2604
  * ebx = 1 - номер подфункции
2605
  * ecx = хэндл сокета
2606
Возвращаемое значение:
2607
  * eax = -1 - неверный хэндл
2608
  * eax = 0 - успешно
2609
  * ebx разрушается
2610
Замечания:
2611
  * Текущая реализация не закрывает автоматически все сокеты потока
2612
    при его завершении. В частности, не следует прибивать поток
2613
    с кучей открытых сокетов - будет утечка ресурсов.
2614
 
2615
======================================================================
2616
============== Функция 53, подфункция 2 - опрос сокета. ==============
2617
======================================================================
2618
Параметры:
2619
  * eax = 53 - номер функции
2620
  * ebx = 2 - номер подфункции
2621
  * ecx = хэндл сокета
2622
Возвращаемое значение:
1018 diamond 2623
  * eax = число полученных байт, 0 для неверного хэндла
77 diamond 2624
  * ebx разрушается
2625
 
2626
======================================================================
2627
======== Функция 53, подфункция 3 - прочитать байт из сокета. ========
2628
======================================================================
2629
Параметры:
2630
  * eax = 53 - номер функции
2631
  * ebx = 3 - номер подфункции
2632
  * ecx = хэндл сокета
2633
Возвращаемое значение:
1018 diamond 2634
  * если нет принятых данных или указан неверный хэндл:
2635
    eax=0, bl=0, прочие байты ebx разрушаются
77 diamond 2636
  * если были принятые данные: eax=число оставшихся байт
118 diamond 2637
    (возможно, 0), bl=прочитанный байт, прочие байты ebx разрушаются
77 diamond 2638
 
2639
======================================================================
2640
========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========
2641
======================================================================
2642
Параметры:
2643
  * eax = 53 - номер функции
2644
  * ebx = 4 - номер подфункции
2645
  * ecx = хэндл сокета
2646
  * edx = число байт для записи
2647
  * esi = указатель на данные для записи
2648
Возвращаемое значение:
1018 diamond 2649
  * eax = 0xffffffff - ошибка (неверный хэндл или недостаточно памяти)
77 diamond 2650
  * eax = 0 - успешно
2651
  * ebx разрушается
2652
Замечания:
2653
  * Число байт для записи не может превышать 1500-28, хотя
2654
    соответствующей проверки не делается.
2655
 
2656
======================================================================
2657
============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========
2658
======================================================================
2659
Параметры:
2660
  * eax = 53 - номер функции
2661
  * ebx = 5 - номер подфункции
2662
  * ecx = локальный порт (учитывается только младшее слово)
131 diamond 2663
  * edx = удалённый порт (учитывается только младшее слово)
2664
  * esi = удалённый IP
77 diamond 2665
  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1
2666
Возвращаемое значение:
2667
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2668
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2669
    сокет и имеющее смысл только для системы) - успешно;
2670
    ebx разрушается
2671
 
2672
======================================================================
2673
====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
2674
======================================================================
2675
Параметры:
2676
  * eax = 53 - номер функции
2677
  * ebx = 6 - номер подфункции
2678
  * ecx = хэндл сокета
2679
Возвращаемое значение:
1018 diamond 2680
  * eax = 0 для неверного сокета или статус: одно из
77 diamond 2681
  * TCB_LISTEN = 1
2682
  * TCB_SYN_SENT = 2
2683
  * TCB_SYN_RECEIVED = 3
2684
  * TCB_ESTABLISHED = 4
2685
  * TCB_FIN_WAIT_1 = 5
2686
  * TCB_FIN_WAIT_2 = 6
2687
  * TCB_CLOSE_WAIT = 7
2688
  * TCB_CLOSING = 8
2689
  * TCB_LAST_ASK = 9
2690
  * TCB_TIME_WAIT = 10
2691
  * TCB_CLOSED = 11
2692
  * ebx разрушается
2693
 
2694
======================================================================
2695
========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
2696
======================================================================
2697
Параметры:
2698
  * eax = 53 - номер функции
2699
  * ebx = 7 - номер подфункции
2700
  * ecx = хэндл сокета
2701
  * edx = число байт для записи
2702
  * esi = указатель на данные для записи
2703
Возвращаемое значение:
1018 diamond 2704
  * eax = 0xffffffff - ошибка (неверный хэндл или недостаточно памяти)
77 diamond 2705
  * eax = 0 - успешно
2706
  * ebx разрушается
2707
Замечания:
2708
  * Число байт для записи не может превышать 1500-40,
2709
    хотя соответствующей проверки не делается.
2710
 
2711
======================================================================
2712
============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========
2713
======================================================================
2714
Параметры:
2715
  * eax = 53 - номер функции
2716
  * ebx = 8 - номер подфункции
2717
  * ecx = хэндл сокета
2718
Возвращаемое значение:
1018 diamond 2719
  * eax = -1 - ошибка (неверный хэндл или
2720
    недостаточно памяти для пакета закрытия сокета)
77 diamond 2721
  * eax = 0 - успешно
2722
  * ebx разрушается
2723
Замечания:
2724
  * Текущая реализация не закрывает автоматически все сокеты потока
2725
    при его завершении. В частности, не следует прибивать поток
2726
    с кучей открытых сокетов - будет утечка ресурсов.
2727
 
2728
======================================================================
2729
== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =
2730
======================================================================
2731
Параметры:
2732
  * eax = 53 - номер функции
2733
  * ebx = 9 - номер подфункции
2734
  * ecx = номер локального порта (используются только младшие 16 бит)
2735
Возвращаемое значение:
2736
  * eax = 0 - порт используется
2737
  * eax = 1 - порт свободен
2738
  * ebx разрушается
2739
 
2740
======================================================================
314 diamond 2741
==== Функция 53, подфункция 10 - получить статус кабеля Ethernet. ====
2742
======================================================================
2743
Параметры:
2744
  * eax = 53 - номер функции
2745
  * ebx = 10 - номер подфункции
2746
Возвращаемое значение:
2747
  * al = -1 - драйвер сетевой карты не загружен или
2748
              не поддерживает эту функцию
2749
  * al = 0 - кабель не подключён
2750
  * al = 1 - кабель подключён
346 diamond 2751
  * ebx разрушается
314 diamond 2752
Замечания:
2753
  * Текущая реализация ядра поддерживает эту функцию
2754
    только для сетевых карт RTL8139.
2755
 
2756
======================================================================
346 diamond 2757
==== Функция 53, подфункция 11 - прочитать данные сетевого стека. ====
340 heavyiron 2758
======================================================================
2759
Параметры:
2760
  * eax = 53 - номер функции
2761
  * ebx = 11 - номер подфункции
346 diamond 2762
  * ecx = хэндл сокета
2763
  * edx = указатель на буфер
2764
  * esi = число байт для чтения;
2765
  * esi = 0 - читать все данные (максимум 4096 байт)
2766
Возвращаемое значение:
1018 diamond 2767
  * eax = число прочитанных байт (0 при неверном хэндле)
346 diamond 2768
  * ebx разрушается
340 heavyiron 2769
 
2770
======================================================================
1074 Galkov 2771
 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.
77 diamond 2772
======================================================================
2773
Параметры:
2774
  * eax = 53 - номер функции
2775
  * ebx = 255 - номер подфункции
2776
  * ecx = тип запрашиваемой информации (смотри ниже)
2777
Возвращаемое значение:
2778
  * eax = запрошенная информация
2779
  * ebx разрушается
2780
Возможные значения ecx:
2781
  * 100: длина очереди 0 (empty queue)
2782
  * 101: длина очереди 1 (ip-out queue)
2783
  * 102: длина очереди 2 (ip-in queue)
2784
  * 103: длина очереди 3 (net1out queue)
2785
  * 200: число элементов в таблице ARP
2786
  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)
2787
  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда
2788
    берут информацию 5 последующих типов;
131 diamond 2789
    в этом случае eax неопределён
77 diamond 2790
  * 203: IP-адрес, запомненный типом 202
2791
  * 204: старшее dword MAC-адреса, запомненного типом 202
2792
  * 205: младшее word MAC-адреса, запомненного типом 202
2793
  * 206: слово статуса, запомненное типом 202
2794
  * 207: слово ttl, запомненное типом 202
2795
  * 2: общее число полученных IP-пакетов
2796
  * 3: общее число переданных IP-пакетов
2797
  * 4: общее число сдампленных полученных пакетов
2798
  * 5: общее число полученных ARP-пакетов
2799
  * 6: статус драйвера пакетов, 0=неактивен,
2800
    ненулевое значение=активен
2801
 
2802
======================================================================
2803
====================== Функция 55, подфункция 55 =====================
2804
========== Начать проигрывать данные на встроенном спикере. ==========
2805
======================================================================
2806
Параметры:
2807
  * eax = 55 - номер функции
2808
  * ebx = 55 - номер подфункции
2809
  * esi = указатель на данные
2810
Возвращаемое значение:
2811
  * eax = 0 - успешно
131 diamond 2812
  * eax = 55 - ошибка (спикер отключён или занят)
77 diamond 2813
Данные - это массив элементов переменной длины.
2814
Формат каждого элемента определяется первым байтом:
2815
  * 0 = конец данных
131 diamond 2816
  * 1..0x80 = задаёт длительность звучания в сотых долях секунды
77 diamond 2817
    ноты, определяемой непосредственным значением частоты
2818
    * следующее слово (2 байта) содержит делитель частоты;
2819
      частота определяется как 1193180/divider
2820
  * 0x81 = invalid
2821
  * 0x82..0xFF = нота, определяемая октавой и номером:
2822
    * длительность в сотых долях секунды = (первый байт)-0x81
131 diamond 2823
    * присутствует ещё один байт;
77 diamond 2824
    * (второй байт)=0xFF - пауза
2825
    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
2826
      до 12, a=номер октавы (считая с 0)
2827
Замечания:
2828
  * Пищание спикером может быть запрещено/разрешено подфункцией 8
2829
    функции 18.
2830
  * Функция возвращает управление, сообщив куда следует информацию
131 diamond 2831
    о запросе. Само проигрывание идёт независимо от программы.
77 diamond 2832
  * Данные должны сохраняться в памяти по крайней мере
2833
    до конца проигрывания.
2834
 
2835
======================================================================
641 diamond 2836
======================= Функция 57 - PCI BIOS. =======================
586 serge 2837
======================================================================
2838
Параметры:
641 diamond 2839
  * eax = 57 - номер функции
2840
  * ebp соответствует регистру al в спецификации PCI BIOS
2841
  * остальные регистры - по спецификации PCI BIOS
2842
Возвращаемое значение:
2843
  * CF не определён
2844
  * остальные регистры - по спецификации PCI BIOS
2845
Замечания:
2846
  * Многих результатов этой функции можно также добиться вызовом
2847
    соответствующих подфункций функции 62.
2848
  * Функция вызывает расширение PCI32 BIOS, документированное,
2849
    например, в http://alpha1.dyns.net/files/PCI/bios21.pdf.
2850
  * Если BIOS не поддерживает это расширение, поведение функции
2851
    эмулируется (через аналоги подфункций функции 62 режима ядра).
586 serge 2852
 
2853
======================================================================
77 diamond 2854
============== Функция 58 - работа с файловой системой. ==============
2855
======================================================================
2856
Параметры:
2857
  * eax = 58
2858
  * ebx = указатель на информационную структуру
2859
Возвращаемое значение:
2860
  * eax = 0 - успешно; иначе код ошибки файловой системы
2861
  * в зависимости от подфункции может возвращаться значение и
2862
    в других регистрах
2863
Общий формат информационной структуры:
2864
  * +0: dword: номер подфункции
2865
  * +4: dword: номер блока
2866
  * +8: dword: размер
2867
  * +12 = +0xC: dword: указатель на данные
2868
  * +16 = +0x10: dword: указатель на память для работы системы
2869
    (4096 байт)
2870
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
2871
Уточнения - в документации на соответствующую подфункцию.
2872
Имя файла нечувствительно к регистру латинских букв,
2873
русские буквы должны быть заглавными.
2874
Формат имени файла:
2875
/base/number/dir1/dir2/.../dirn/file,
2876
где /base/number идентифицирует устройство, на котором ищется файл:
2877
одно из
2878
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
2879
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
2880
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
131 diamond 2881
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к жёсткому диску
77 diamond 2882
    (в этом случае база определяется подфункцией 7 функции 21),
2883
    x - номер раздела (считая с 1)
2884
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
2885
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
2886
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2887
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
2888
    (на каждом из винчестеров нумерация начинается с 1)
2889
Замечания:
2890
  * В первых двух случаях допускается использование FIRST вместо 1,
2891
    SECOND вместо 2, но использовать эту возможность
2892
    не рекомендуется для удобства перехода на будущие расширения.
2893
  * Накладывается ограничение n<=39.
2894
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
2895
    имя не более 8 символов, точка, расширение не более 3 символов.
2896
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
2897
    Если имя занимает ровно 8 символов, точку можно опустить
2898
    (хотя пользоваться этим не рекомендуется для удобства перехода
2899
    на будущие расширения).
118 diamond 2900
  * Функция не поддерживает папок на рамдиске.
77 diamond 2901
Примеры:
2902
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2903
    '/rd/1/kernel.asm',0
2904
  * '/HD0/1/kernel.asm',0
2905
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2906
Доступные подфункции:
2907
  * подфункция 0 - чтение файла/папки
2908
  * подфункция 8 - LBA-чтение с устройства
2909
  * подфункция 15 - получение информации о файловой системе
2910
 
2911
======================================================================
2912
========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
2913
======================================================================
2914
Параметры:
2915
  * eax = 58
2916
  * ebx = указатель на информационную структуру
2917
Формат информационной структуры:
2918
  * +0: dword: 0 = номер подфункции
2919
  * +4: dword: номер блока для чтения (считая с 0)
2920
  * +8: dword: число блоков для чтения
2921
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2922
  * +16 = +0x10: dword: указатель на буфер для работы системы
2923
    (4096 байт)
131 diamond 2924
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 2925
    общем описании
2926
Возвращаемое значение:
2927
  * eax = 0 - успешно, иначе код ошибки файловой системы
2928
  * ebx = размер файла (в байтах) или
2929
    -1=0xffffffff, если файл не найден
2930
Замечания:
2931
  * Размер блока - 512 байт.
2932
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
2933
    функции 70, для чтения папок - подфункцию 1 функции 70.
2934
  * Функция позволяет читать содержимое папки. Из файловых систем
2935
    поддерживается только FAT. Формат FAT-папки описан в любой
2936
    документации по FAT.
2937
  * Размер папки определяется по размеру цепочки кластеров в FAT.
2938
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 2939
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 2940
    eax=6 (EOF).
2941
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
2942
    в первых двух случаях текущая реализация не следует
2943
    установленным правилам:
2944
    для /rd/1:
2945
    * если указано 0 блоков для чтения, считается,
2946
      что запрашивается 1;
2947
    * если запрашивается больше 14 блоков или начальный блок
2948
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
2949
    * размер корневого каталога рамдиска = 14 блоков,
2950
      0x1C00=7168 байт; но возвращается ebx=0
2951
      (за исключением случая предыдущего пункта);
2952
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
131 diamond 2953
      мусор - напоминаю, счёт ведётся с 0);
77 diamond 2954
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
2955
      то возвращается eax=6(EOF); иначе eax=0.
2956
    Для /fd/x:
2957
    * если начальный блок не меньше 14-го, то возвращается
2958
      eax=5 (not found) и ebx=0;
2959
    * кстати говоря, формат FAT12 допускает дискеты с размером
2960
      корневого каталога меньше или больше 14 блоков;
2961
    * проверки длины не делается;
2962
    * если удалось прочитать данные с дискеты, возвращается
2963
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
2964
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
2965
    но результат не соответствует ожидаемому
2966
    (по работе с обычными файлами/папками), не следует установленным
2967
    правилам, может измениться в следующих версиях ядра и потому
2968
    не описывается. Для получения информации об оборудовании
2969
    используйте подфункцию 11 функции 18 или
2970
    читайте соответствующие папки подфункцией 1 функции 70.
2971
 
2972
======================================================================
2973
========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
2974
======================================================================
2975
Параметры:
2976
  * eax = 58 - номер функции
2977
  * ebx = указатель на информационную структуру
2978
Формат информационной структуры:
2979
  * +0: dword: 8 = номер подфункции
2980
  * +4: dword: номер блока для чтения (считая с 0)
2981
  * +8: dword: игнорируется (устанавливайте в 1)
2982
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2983
    (512 байт)
2984
  * +16 = +0x10: dword: указатель на буфер для работы системы
2985
    (4096 байт)
2986
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
2987
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
2988
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
2989
    Вместо цифр допускается, хотя и не рекомендуется для удобства
2990
    перехода на будущие расширения,
2991
    использование 'first','second','third','fourth'.
2992
Возвращаемое значение:
2993
  * если указано имя устройства /hd/xxx, где xxx не находится
2994
    в списке выше:
2995
    * eax = ebx = 1
2996
  * если указано неправильное имя устройства
2997
    (за исключением предыдущего случая):
2998
    * eax = 5
2999
    * ebx не меняется
131 diamond 3000
  * если LBA-доступ запрещён подфункцией 11 функции 21:
77 diamond 3001
    * eax = 2
3002
    * ebx разрушается
3003
  * для рамдиска: попытка чтения блока за пределами рамдиска
3004
    (18*2*80 блоков) приводит к
3005
    * eax = 3
3006
    * ebx = 0
3007
  * при успешном чтении:
3008
    * eax = ebx = 0
3009
Замечания:
3010
  * Размер блока - 512 байт; читается один блок.
3011
  * Не следует полагаться на возвращаемое значение,
3012
    оно может измениться в следующих версиях.
1074 Galkov 3013
  * Требуется, чтобы был разрешён LBA-доступ к устройствам
3014
    подфункцией 11 функции 21. Узнать это можно вызовом
77 diamond 3015
    подфункцией 11 функции 26.
3016
  * LBA-чтение дискеты не поддерживается.
131 diamond 3017
  * Функция считывает данные физического жёсткого диска;
77 diamond 3018
    если по каким-то причинам нужны данные конкретного раздела,
131 diamond 3019
    придётся определять начальный сектор этого раздела
77 diamond 3020
    (либо напрямую через MBR, либо из расширенной структуры,
3021
    возвращаемой той же подфункцией 11 функции 18).
131 diamond 3022
  * Функция не проверяет код ошибки жёсткого диска, так что запрос
3023
    несуществующего сектора всё равно что-то прочитает
77 diamond 3024
    (вероятнее всего, нули, но это определяется устройством) и
3025
    это будет считаться успехом (eax=0).
3026
 
3027
======================================================================
1074 Galkov 3028
= Функция 58, подфункция 15 - получить информацию о файловой системе.
77 diamond 3029
======================================================================
3030
Параметры:
3031
  * eax = 58 - номер функции
3032
  * ebx = указатель на информационную структуру
3033
Формат информационной структуры:
118 diamond 3034
  * +0: dword: 15 = номер подфункции
77 diamond 3035
  * +4: dword: игнорируется
3036
  * +8: dword: игнорируется
3037
  * +12 = +0xC: dword: игнорируется
3038
  * +16 = +0x10: dword: игнорируется
3039
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
3040
    /rd=/RAMDISK или /hd=/HARDDISK
3041
Возвращаемое значение:
3042
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
3043
    * eax = 3
3044
    * ebx = ecx = dword [fileinfo] = 0
3045
  * для рамдиска:
3046
    * eax = 0 (успех)
3047
    * ebx = общее число кластеров = 2847
3048
    * ecx = число свободных кластеров
3049
    * dword [fileinfo] = размер кластера = 512
131 diamond 3050
  * для жёсткого диска: база и раздел определяются подфункциями 7 и 8
77 diamond 3051
    функции 21:
3052
    * eax = 0 (успех)
3053
    * ebx = общее число кластеров
3054
    * ecx = число свободных кластеров
3055
    * dword [fileinfo] = размер кластера (в байтах)
3056
Замечания:
3057
  * Не удивляйтесь странному расположению 4-го возвращаемого
3058
    параметра - когда писался этот код, при системных вызовах
3059
    приложению возвращались только регистры eax,ebx,ecx (из
3060
    pushad-структуры, передающейся как аргумент системной функции).
3061
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
3062
    размер кластера в edx, пока эту функцию не начали использовать.
131 diamond 3063
  * Вообще-то ещё существует подфункция 11 функции 18, возвращающая
77 diamond 3064
    информацию о файловой системе. По расширенной таблице дисковой
3065
    подсистемы можно определить размер кластера (там он хранится
131 diamond 3066
    в секторах) и общее число кластеров для жёстких дисков.
77 diamond 3067
 
3068
======================================================================
3069
=========== Функция 60 - Inter Process Communication (IPC). ==========
3070
======================================================================
3071
IPC применяется для посылок сообщений от одного процесса/потока
3072
другому. При этом следует предварительно договориться о том, как
3073
интерпретировать конкретное сообщение.
3074
 
3075
-------- Подфункция 1 - установить область для получения IPC ---------
131 diamond 3076
Вызывается процессом-приёмником.
77 diamond 3077
Параметры:
3078
  * eax = 60 - номер функции
3079
  * ebx = 1 - номер подфункции
3080
  * ecx = указатель на буфер
3081
  * edx = размер буфера
3082
Возвращаемое значение:
3083
  * eax = 0 - всегда успешно
3084
Формат IPC-буфера:
3085
  * +0: dword: если здесь не 0, то буфер считается заблокированным;
3086
    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
3087
    и вам надо, чтобы извне не изменялись данные буфера
3088
    (не поступали новые сообщения)
3089
  * +4: dword: занято места в буфере (в байтах)
3090
  * +8: первое сообщение
3091
  * +8+n: второе сообщение
3092
  * ...
3093
Формат сообщения:
3094
  * +0: dword: PID процесса/потока, пославшего сообщение
3095
  * +4: dword: длина сообщения (не считая этот заголовок)
3096
  * +8: n*byte: данные сообщения
3097
 
3098
--------------- Подфункция 2 - послать сообщение IPC. ----------------
3099
Вызывается процессом-инициатором.
3100
Параметры:
3101
  * eax = 60 - номер функции
3102
  * ebx = 2 - номер подфункции
131 diamond 3103
  * ecx = PID приёмника
77 diamond 3104
  * edx = указатель на данные сообщения
3105
  * esi = длина сообщения (в байтах)
3106
Возвращаемое значение:
3107
  * eax = 0 - успешно
131 diamond 3108
  * eax = 1 - приёмник не определил буфер для IPC-сообщений
3109
    (может быть, ещё не успел, а может быть, это не тот поток,
77 diamond 3110
    который нужен)
131 diamond 3111
  * eax = 2 - приёмник заблокировал IPC-буфер;
77 diamond 3112
    попробуйте немного подождать
131 diamond 3113
  * eax = 3 - переполнение IPC-буфера приёмника
77 diamond 3114
  * eax = 4 - процесса/потока с таким PID не существует
3115
Замечания:
3116
  * Система сразу после записи IPC-сообщения в буфер посылает
131 diamond 3117
    потоку-приёмнику событие с кодом 7 (см. коды событий).
77 diamond 3118
 
3119
======================================================================
3120
=== Функция 61 - получить параметры для прямого доступа к графике. ===
3121
======================================================================
3122
Программе доступны данные графического экрана (область памяти, которая
3123
собственно и отображает содержимое экрана) напрямую без вызовов
3124
системных функций через селектор gs:
1074 Galkov 3125
        mov     eax, [gs:0]
77 diamond 3126
поместит в eax первый dword буфера, содержащий информацию о цвете
3127
левой верхней точки (и, возможно, цвета нескольких следующих).
1074 Galkov 3128
        mov     [gs:0], eax
77 diamond 3129
при работе в режимах VESA c LFB
3130
установит цвет левой верхней точки
3131
(и возможно, цвета нескольких следующих).
3132
Для интерпретации данных графического экрана требуется знание
3133
некоторых параметров, которые возвращаются этой функцией.
3134
Замечания:
3135
  * Параметры графики очень редко меняются при работе системы,
3136
    а именно, только в случаях, когда пользователь работает
3137
    с программой VRR.
3138
  * При изменении видеорежима система перерисовывает все окна
3139
    (событие с кодом 1) и перерисовывает фон (событие 5).
3140
    Эти же события происходят и в других случаях,
3141
    которые встречаются значительно чаще, чем изменение видеорежима.
3142
  * При работе в видеорежимах с LFB селектор gs указывает на
3143
    собственно LFB, так что чтение/запись по gs приводят
3144
    непосредственно к изменению содержимого экрана. При работе в
3145
    видеорежимах без LFB gs указывает на некоторую область данных
131 diamond 3146
    ядра, причём все функции вывода на экран добросовестно выполняют
77 diamond 3147
    двойную работу по записи непосредственно на экран и по записи
3148
    в этот буфер. В результате при чтении содержимого этого буфера
3149
    результаты соответствуют содержимому экрана
3150
    (с, вообще говоря, большим цветовым разрешением),
3151
    а запись игнорируется.
3152
    Исключением является режим 320*200, для которого в главном цикле
3153
    системного потока выполняется обновление экрана в соответствии
3154
    с движениями курсора мыши.
3155
 
3156
------------------------- Разрешение экрана --------------------------
3157
Параметры:
3158
  * eax = 61 - номер функции
3159
  * ebx = 1 - номер подфункции
3160
Возвращаемое значение:
3161
  * eax = [разрешение по оси x]*65536 + [разрешение по оси y]
3162
Замечания:
131 diamond 3163
  * Можно использовать функцию 14 с учётом того, что она возвращает
77 diamond 3164
    размеры на 1 меньше. Это полностью эквивалентный способ.
3165
 
3166
------------------------ Число бит на пиксель ------------------------
3167
Параметры:
3168
  * eax = 61 - номер функции
3169
  * ebx = 2 - номер подфункции
3170
Возвращаемое значение:
3171
  * eax = число бит на пиксель (24 или 32)
3172
 
3173
------------------------ Число байт на строку ------------------------
3174
Параметры:
3175
  * eax = 61 - номер функции
3176
  * ebx = 3 - номер подфункции
3177
Возвращаемое значение:
131 diamond 3178
  * eax = число байт, которое занимает одна строка развёртки
77 diamond 3179
    (горизонтальная линия на экране)
3180
 
3181
======================================================================
3182
===== Функция 62, подфункция 0 - получить версию PCI-интерфейса. =====
3183
======================================================================
3184
Параметры:
3185
  * eax = 62 - номер функции
3186
  * bl = 0 - номер подфункции
3187
Возвращаемое значение:
131 diamond 3188
  * eax = -1 - доступ к PCI запрещён; иначе
77 diamond 3189
  * ah.al = версия PCI-интерфейса (ah=версия, al=подверсия)
3190
  * старшее слово eax обнулено
3191
Замечания:
131 diamond 3192
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3193
    для приложений подфункцией 12 функции 21.
118 diamond 3194
  * Если PCI BIOS не поддерживается, то значение ax неопределено.
77 diamond 3195
 
3196
======================================================================
3197
==== Функция 62, подфункция 1 - получить номер последней PCI-шины. ===
3198
======================================================================
3199
Параметры:
3200
  * eax = 62 - номер функции
3201
  * bl = 1 - номер подфункции
3202
Возвращаемое значение:
131 diamond 3203
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3204
  * al = номер последней PCI-шины; оставшиеся байты eax разрушаются
77 diamond 3205
Замечания:
131 diamond 3206
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3207
    для приложений подфункцией 12 функции 21.
118 diamond 3208
  * Если PCI BIOS не поддерживается, то значение al неопределено.
77 diamond 3209
 
3210
======================================================================
3211
====================== Функция 62, подфункция 2 ======================
3212
== Получить механизм обращения к конфигурационному пространству PCI. =
3213
======================================================================
3214
Параметры:
3215
  * eax = 62 - номер функции
3216
  * bl = 2 - номер подфункции
3217
Возвращаемое значение:
131 diamond 3218
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3219
  * al = механизм (1 или 2); прочие байты eax разрушаются
77 diamond 3220
Замечания:
131 diamond 3221
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3222
    для приложений подфункцией 12 функции 21.
3223
  * Механизм обращения выбирается в соответствии
3224
    с характеристиками оборудования.
3225
  * Подфункции чтения и записи автоматически работают
3226
    с выбранным механизмом.
3227
 
3228
======================================================================
3229
======== Функция 62, подфункции 4,5,6 - прочитать PCI-регистр. =======
3230
======================================================================
3231
Параметры:
3232
  * eax = 62 - номер функции
3233
  * bl = 4 - читать байт
3234
  * bl = 5 - читать слово
3235
  * bl = 6 - читать двойное слово
3236
  * bh = номер PCI-шины
3237
  * ch = dddddfff, где ddddd = номер устройства на шине,
3238
    fff = номер функции устройства
131 diamond 3239
  * cl = номер регистра (должен быть чётным для bl=5,
77 diamond 3240
    делиться на 4 для bl=6)
3241
Возвращаемое значение:
131 diamond 3242
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3243
    неподдерживаемые параметры); иначе
3244
  * al/ax/eax (в зависимости от запрошенного размера) содержит данные;
3245
    оставшаяся часть регистра eax разрушается
3246
Замечания:
131 diamond 3247
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3248
    для приложений подфункцией 12 функции 21.
3249
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3250
    игнорирует номер функции. Получить механизм доступа можно вызовом
3251
    подфункции 2.
3252
  * Некоторые регистры стандартны и существуют для всех устройств,
3253
    некоторые определяются конкретным устройством. Список первых
3254
    входит, например, в известный Interrupt List by Ralf Brown
3255
    (http://www.pobox.com/~ralf/files.html,
3256
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3257
    список вторых должен быть указан в документации по устройству.
3258
 
3259
======================================================================
3260
======= Функция 62, подфункции 8,9,10 - записать в PCI-регистр. ======
3261
======================================================================
3262
Параметры:
3263
  * eax = 62 - номер функции
3264
  * bl = 8 - писать байт
3265
  * bl = 9 - писать слово
3266
  * bl = 10 - писать двойное слово
3267
  * bh = номер PCI-шины
3268
  * ch = dddddfff, где ddddd = номер устройства на шине,
3269
    fff = номер функции устройства
131 diamond 3270
  * cl = номер регистра (должен быть чётным для bl=9,
77 diamond 3271
    делиться на 4 для bl=10)
92 diamond 3272
  * dl/dx/edx (в зависимости от запрошенного размера) содержит
3273
    данные для записи
77 diamond 3274
Возвращаемое значение:
131 diamond 3275
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3276
    неподдерживаемые параметры)
3277
  * eax = 0 - успешно
3278
Замечания:
131 diamond 3279
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3280
    для приложений подфункцией 12 функции 21.
3281
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3282
    игнорирует номер функции. Получить механизм доступа можно вызовом
3283
    подфункции 2.
3284
  * Некоторые регистры стандартны и существуют для всех устройств,
3285
    некоторые определяются конкретным устройством. Список первых
3286
    входит, например, в известный Interrupt List by Ralf Brown;
3287
    список вторых должен быть указан в документации по устройству.
3288
 
3289
======================================================================
3290
================ Функция 63 - работа с доской отладки. ===============
3291
======================================================================
448 diamond 3292
Доска отладки представляет собой системный буфер (на 4096 байт),
77 diamond 3293
в который любая программа может записать (вообще говоря, произвольные)
3294
данные и из которого другая программа может эти данные прочитать.
3295
Есть соглашение, в соответствии с которым записываемые данные -
3296
текстовые строки, интерпретируемые как отладочные сообщения о ходе
131 diamond 3297
выполнения программы. Ядро в определённых ситуациях также записывает
77 diamond 3298
на доску отладки сведения о выполнении некоторых функций;
3299
по соглашению сообщения ядра начинаются с префикса "K : ".
3300
Для просмотра доски отладки создано приложение board,
131 diamond 3301
которое считывает данные из буфера и отображает их в своём окне. board
77 diamond 3302
понимает последовательность кодов 13,10 как переход на новую строку.
3303
Символ с нулевым кодом в конце строки не обязателен, но и не мешает.
3304
В связи с появлением отладчика ценность доски отладки несколько
3305
снизилась, поскольку отладчик позволяет полностью контролировать ход
131 diamond 3306
выполнения программы, причём для этого не требуется никаких усилий
77 diamond 3307
со стороны самой программы. Тем не менее во многих случаях
3308
доска отладки продолжает оставаться полезной.
3309
 
3310
---------------------------- Запись байта ----------------------------
3311
Параметры:
3312
  * eax = 63 - номер функции
3313
  * ebx = 1 - номер подфункции
3314
  * cl = байт данных
3315
Возвращаемое значение:
3316
  * функция не возвращает значения
3317
Замечания:
3318
  * Байт записывается в буфер. Длина буфера - 512 байт.
3319
    При переполнении буфера все полученные данные теряются
3320
    и заполнение начинается снова с нуля.
3321
  * Для вывода на доску отладки более сложных объектов (строк, чисел)
3322
    достаточно этой функции, вызываемой в цикле. Можно не писать
3323
    вручную соответствующий код, а воспользоваться файлом debug.inc,
3324
    входящим в дистрибутив.
3325
 
3326
---------------------------- Чтение байта ----------------------------
3327
Забирает байт из буфера.
3328
Параметры:
3329
  * eax = 63 - номер функции
3330
  * ebx = 2 - номер подфункции
3331
Возвращаемое значение:
3332
  * eax = ebx = 0 - буфер пуст
3333
  * eax = байт, ebx = 1 - байт успешно прочитан
3334
 
3335
======================================================================
3336
========== Функция 64 - перераспределить память приложения. ==========
3337
======================================================================
3338
Параметры:
3339
  * eax = 64 - номер функции
3340
  * ebx = 1 - единственная подфункция
3341
  * ecx = новый размер памяти
3342
Возвращаемое значение:
3343
  * eax = 0 - успешно
3344
  * eax = 1 - недостаточно памяти
3345
Замечания:
172 serge 3346
  * Есть другой способ выделения/освобождения динамической памяти -
3347
    подфункции 11, 12, 13 функции 68.
277 diamond 3348
  * Функция не может использоваться совместно с 68.11, 68.12, 68.13.
3349
    Вызов функции будет игнорироваться, если приложение создаст
3350
    локальную кучу вызовом 68.11.
77 diamond 3351
 
3352
======================================================================
283 diamond 3353
========= Функция 65 - вывести изображение с палитрой в окно. ========
3354
======================================================================
3355
Параметры:
3356
  * eax = 65 - номер функции
3357
  * ebx = указатель на изображение
3358
  * ecx = [размер по оси x]*65536 + [размер по оси y]
3359
  * edx = [координата по оси x]*65536 + [координата по оси y]
1018 diamond 3360
  * esi = число бит на пиксель, должно быть 1,2,4,8,15,16,24 или 32
911 diamond 3361
  * edi = указатель на палитру (2 в степени esi цветов 0x00RRGGBB);
906 diamond 3362
          игнорируется при esi > 8
314 diamond 3363
  * ebp = смещение данных каждой следующей строки изображения
3364
          относительно предыдущей
283 diamond 3365
Возвращаемое значение:
3366
  * функция не возвращает значения
3367
Замечания:
3368
  * Координаты изображения - это координаты верхнего левого угла
3369
    изображения относительно окна.
911 diamond 3370
  * Формат изображения с 1 битом на пиксель: каждый байт изображения,
3371
    за исключением, быть может, последних байтов строк, содержит
3372
    информацию о цвете 8 пикселей, старший бит соответствует первому
3373
    пикселю.
1018 diamond 3374
  * Формат изображения с 2 битами на пиксель: каждый байт изображения,
3375
    за исключением, быть может, последних байтов строк, содержит
3376
    информацию о цвете 4 пикселей, старшие два бита соответствуют
3377
    первому пикселю.
911 diamond 3378
  * Формат изображения с 4 битами на пиксель: каждый байт изображения,
3379
    за исключением последних байтов строк (если ширина изображения
3380
    нечётна), содержит информацию о цвете 2 пикселей, старшая тетрада
3381
    соответствует первому пикселю.
842 diamond 3382
  * Формат изображения с 8 битами на пиксель: каждый байт изображения
3383
    рассматривается как индекс в палитре.
906 diamond 3384
  * Формат изображения с 15 битами на пиксель: цвет каждого пикселя
842 diamond 3385
    кодируется как (в битовом представлении) 0RRRRRGGGGGBBBBB -
3386
    по 5 пикселей на каждый цвет.
906 diamond 3387
  * Формат изображения с 16 битами на пиксель: цвет каждого пикселя
3388
    кодируется как RRRRRGGGGGGBBBBB (схема 5+6+5).
842 diamond 3389
  * Формат изображения с 24 битами на пиксель: цвет каждого пикселя
1018 diamond 3390
    кодируется тремя байтами - последовательно синяя, зелёная, красная
3391
    составляющие цвета.
842 diamond 3392
  * Формат изображения с 32 битами на пиксель: аналогично 24, только
3393
    есть ещё игнорируемый четвёртый байт.
314 diamond 3394
  * Вызов функции 7 эквивалентен вызову этой функции с параметрами
3395
    esi=24, ebp=0.
283 diamond 3396
 
3397
======================================================================
92 diamond 3398
================= Функция 66 - работа с клавиатурой. =================
77 diamond 3399
======================================================================
92 diamond 3400
Режим ввода влияет на результаты чтения клавиш функцией 2.
131 diamond 3401
При загрузке программы для неё устанавливается ASCII-режим ввода.
77 diamond 3402
 
92 diamond 3403
-------- Подфункция 1 - установить режим ввода с клавиатуры. ---------
77 diamond 3404
Параметры:
3405
  * eax = 66 - номер функции
3406
  * ebx = 1 - номер подфункции
3407
  * ecx = режим:
3408
    * 0 = обычный (ASCII-символы)
3409
    * 1 = сканкоды
3410
Возвращаемое значение:
3411
  * функция не возвращает значения
3412
 
92 diamond 3413
--------- Подфункция 2 - получить режим ввода с клавиатуры. ----------
77 diamond 3414
Параметры:
3415
  * eax = 66 - номер функции
3416
  * ebx = 2 - номер подфункции
3417
Возвращаемое значение:
3418
  * eax = текущий режим
3419
 
3420
------- Подфункция 3 - получить состояние управляющих клавиш. --------
3421
Параметры:
3422
  * eax = 66 - номер функции
3423
  * ebx = 3 - номер подфункции
3424
Возвращаемое значение:
3425
  * eax = битовая маска:
3426
  * бит 0 (маска 1): левый Shift нажат
3427
  * бит 1 (маска 2): правый Shift нажат
3428
  * бит 2 (маска 4): левый Ctrl нажат
3429
  * бит 3 (маска 8): правый Ctrl нажат
3430
  * бит 4 (маска 0x10): левый Alt нажат
3431
  * бит 5 (маска 0x20): правый Alt нажат
131 diamond 3432
  * бит 6 (маска 0x40): CapsLock включён
3433
  * бит 7 (маска 0x80): NumLock включён
3434
  * бит 8 (маска 0x100): ScrollLock включён
77 diamond 3435
  * прочие биты сброшены
3436
 
92 diamond 3437
----- Подфункция 4 - установить общесистемную "горячую клавишу". -----
3438
О нажатии "горячей клавиши" извещаются только приложения,
131 diamond 3439
установившие её; активное приложение (к которому поступает
92 diamond 3440
весь нормальный ввод) таких клавиш не получает.
3441
Извещение заключается в посылке события с кодом 2.
3442
Прочитать "горячую клавишу" можно так же, как и обычную, -
3443
функцией 2.
3444
Параметры:
3445
  * eax = 66 - номер функции
3446
  * ebx = 4 - номер подфункции
131 diamond 3447
  * cl задаёт сканкод клавиши;
92 diamond 3448
    используйте cl=0 для задания комбинаций типа Ctrl+Shift
131 diamond 3449
  * edx = 0xXYZ задаёт возможные состояния управляющих клавиш:
3450
    * Z (младшие 4 бита) задаёт состояние клавиш LShift и RShift:
92 diamond 3451
      * 0 = ни одна из клавиш не должна быть нажата;
3452
      * 1 = ровно одна из клавиш должна быть нажата;
3453
      * 2 = обе клавиши должны быть нажаты;
3454
      * 3 = должна быть нажата LShift, но не RShift;
3455
      * 4 = должна быть нажата RShift, но не LShift
3456
    * Y - аналогично для LCtrl и RCtrl;
3457
    * X - аналогично для LAlt и RAlt
3458
Возвращаемое значение:
3459
  * eax=0 - успешно
3460
  * eax=1 - слишком много "горячих клавиш" (допускается максимум 256)
3461
Замечания:
3462
  * Горячая клавиша может срабатывать либо при нажатии,
3463
    либо при отпускании. Сканкод отпускания клавиши на 128 больше,
3464
    чем сканкод нажатия (т.е. установлен старший бит).
3465
  * Несколько приложений могут установить одну и ту же комбинацию;
3466
    о нажатии такой комбинации будут извещаться все такие приложения.
3467
 
3468
------ Подфункция 5 - удалить установленную "горячую клавишу". -------
3469
Параметры:
3470
  * eax = 66 - номер функции
3471
  * ebx = 5 - номер подфункции
3472
  * cl = сканкод клавиши и edx = 0xXYZ такие же, как и в подфункции 4
3473
Возвращаемое значение:
3474
  * eax = 0 - успешно
3475
  * eax = 1 - нет такой горячей клавиши
3476
Замечания:
3477
  * При завершении процесса/потока удаляются все установленные им
3478
    горячие клавиши.
3479
  * Вызов функции не влияет на другие приложения.
3480
    Если другое приложение определило эту же комбинацию,
3481
    оно по-прежнему будет получать уведомления.
3482
 
77 diamond 3483
======================================================================
3484
============ Функция 67 - изменить положение/размеры окна. ===========
3485
======================================================================
3486
Параметры:
3487
  * eax = 67 - номер функции
3488
  * ebx = новая x-координата окна
3489
  * ecx = новая y-координата окна
3490
  * edx = новый x-размер окна
3491
  * esi = новый y-размер окна
3492
Возвращаемое значение:
3493
  * функция не возвращает значения
3494
Замечания:
3495
  * Значение -1 для параметра означает "не изменять"; например, для
3496
    перемещения окна без изменения размеров можно указать edx=esi=-1.
3497
  * Предварительно окно должно быть определено функцией 0.
131 diamond 3498
    Она же задаёт начальные координаты и размеры окна.
77 diamond 3499
  * Размеры окна понимаются в смысле функции 0, т.е.
3500
    на один пиксель меньше, чем реальные размеры.
3501
  * Вызов функции для максимизированных окон просто игнорируется.
3502
  * Для окон соответствующих стилей положение и/или размеры могут быть
3503
    изменены пользователем; текущие положение и размеры могут быть
3504
    получены вызовом функции 9.
3505
  * Функция посылает окну событие перерисовки (с кодом 1).
3506
 
3507
======================================================================
131 diamond 3508
=== Функция 68, подфункция 0 - получить счётчик переключений задач. ==
77 diamond 3509
======================================================================
3510
Параметры:
3511
  * eax = 68 - номер функции
3512
  * ebx = 0 - номер подфункции
3513
Возвращаемое значение:
3514
  * eax = число переключений задач с момента загрузки системы
3515
    (по модулю 2^32)
3516
 
3517
======================================================================
3518
====================== Функция 68, подфункция 1 ======================
3519
============ Переключиться на следующий поток выполнения. ============
3520
======================================================================
3521
Функция завершает текущий квант времени, выделенный потоку,
3522
и переключается на следующий.
3523
(Какой поток какого процесса будет следующим, предсказать нельзя).
131 diamond 3524
Позднее, когда до текущего потока дойдёт очередь,
77 diamond 3525
выполнение возобновится.
3526
Параметры:
3527
  * eax = 68 - номер функции
3528
  * ebx = 1 - номер подфункции
3529
Возвращаемое значение:
3530
  * функция не возвращает значения
3531
 
3532
======================================================================
3533
=============== Функция 68, подфункция 2 - кэш + rdpmc. ==============
3534
======================================================================
3535
Параметры:
3536
  * eax = 68 - номер функции
3537
  * ebx = 2 - номер подфункции
3538
  * ecx = требуемое действие:
3539
    * ecx = 0 - разрешить выполнение инструкции rdpmc
3540
      (ReaD Performance-Monitoring Counters)
131 diamond 3541
    * ecx = 1 - узнать, включён/выключен кэш
77 diamond 3542
    * ecx = 2 - включить кэш
3543
    * ecx = 3 - выключить кэш
3544
Возвращаемое значение:
3545
  * для ecx=0:
3546
    * eax = значение cr4
3547
  * для ecx=1:
3548
    * eax = (cr0 and 0x60000000):
131 diamond 3549
    * eax = 0 - кэш включён
77 diamond 3550
    * eax <> 0 - кэш выключен
3551
  * для ecx=2 и ecx=3:
3552
    * функция не возвращает значения
3553
 
3554
======================================================================
3555
========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
3556
======================================================================
3557
MSR = Model Specific Register; полный список MSR-регистров процессора
3558
содержится в документации по процессору (например, IA-32 Intel
3559
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3560
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3561
Параметры:
3562
  * eax = 68 - номер функции
3563
  * ebx = 3 - номер подфункции
3564
  * ecx игнорируется
3565
  * edx = адрес MSR
3566
Возвращаемое значение:
3567
  * ebx:eax = старший:младший dword результата
3568
Замечания:
3569
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3570
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3571
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3572
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3573
    которое всё равно прибьёт поток.
77 diamond 3574
 
3575
======================================================================
3576
========= Функция 68, подфункция 4 - записать в MSR-регистр. =========
3577
======================================================================
3578
MSR = Model Specific Register; полный список MSR-регистров процессора
3579
содержится в документации по процессору (например, IA-32 Intel
3580
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3581
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3582
Параметры:
3583
  * eax = 68 - номер функции
3584
  * ebx = 4 - номер подфункции
3585
  * ecx игнорируется
3586
  * edx = адрес MSR
3587
  * esi:edi = старший:младший dword
3588
Возвращаемое значение:
499 diamond 3589
  * функция не возвращает значения
77 diamond 3590
Замечания:
3591
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3592
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3593
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3594
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3595
    которое всё равно прибьёт поток.
77 diamond 3596
 
3597
======================================================================
172 serge 3598
===== Функция 68, подфункция 11 - инициализировать кучу процесса. ====
77 diamond 3599
======================================================================
3600
Параметры:
3601
  * eax = 68 - номер функции
172 serge 3602
  * ebx = 11 - номер подфункции
77 diamond 3603
Возвращаемое значение:
172 serge 3604
  * eax = 0 - неуспех
3605
  * иначе размер созданной кучи
77 diamond 3606
Замечания:
172 serge 3607
  * Вызов функции инициализирует кучу, из которой впоследствии можно
3608
    выделять и освобождать блоки памяти подфункциями 12 и 13.
188 serge 3609
    Размер кучи равен размеру всей свободной памяти приложения.
277 diamond 3610
  * При повторном вызове функции тем же процессом функция вернёт
3611
    размер существующей кучи.
3612
  * После создания кучи вызовы функции 64 игнорируются.
77 diamond 3613
 
3614
======================================================================
172 serge 3615
========== Функция 68, подфункция 12 - выделить блок памяти. =========
77 diamond 3616
======================================================================
3617
Параметры:
3618
  * eax = 68 - номер функции
172 serge 3619
  * ebx = 12 - номер подфункции
3620
  * ecx = требуемый размер в байтах
77 diamond 3621
Возвращаемое значение:
172 serge 3622
  * eax = указатель на выделенный блок
77 diamond 3623
Замечания:
172 serge 3624
  * Предварительно следует инициализировать кучу процесса вызовом
3625
    подфункции 11.
3626
  * Функция выделяет целое число страниц (4 Кб) так, что фактический
3627
    размер выделенного блока больше или равен запрошенному.
77 diamond 3628
 
3629
======================================================================
172 serge 3630
========= Функция 68, подфункция 13 - освободить блок памяти. ========
77 diamond 3631
======================================================================
3632
Параметры:
3633
  * eax = 68 - номер функции
172 serge 3634
  * ebx = 13 - номер подфункции
3635
  * ecx = указатель на блок памяти
77 diamond 3636
Возвращаемое значение:
172 serge 3637
  * eax = 1 - успешно
3638
  * eax = 0 - неудача
77 diamond 3639
Замечания:
448 diamond 3640
  * Блок памяти должен быть ранее выделен подфункцией 12
3641
    или подфункцией 20.
77 diamond 3642
 
3643
======================================================================
1074 Galkov 3644
==================== Функция 68, подфункция 14 =======================
3645
===== Ожидать получения сигнала, от других приложений/драйверов. =====
77 diamond 3646
======================================================================
3647
Параметры:
3648
  * eax = 68 - номер функции
172 serge 3649
  * ebx = 14 - номер подфункции
1074 Galkov 3650
  * ecx = указатель на буфер для информации (24 байта)
77 diamond 3651
Возвращаемое значение:
172 serge 3652
  * буфер, на который указывает ecx, содержит следующую информацию:
1074 Galkov 3653
    * +0: dword: идентификатор последующих данных сигнала
3654
    * +4: данные принятого сигнала (20 байт), формат которых
3655
          определяется первым dword-ом
77 diamond 3656
 
3657
======================================================================
1077 Galkov 3658
== Функция 68, подфункция 15 - установить обработчик исключений FPU. =
172 serge 3659
======================================================================
1077 Galkov 3660
Удалена (в текущей реализации посто возвращает 0)
3661
Использовать подфункции 24, 25
172 serge 3662
 
3663
======================================================================
3664
=========== Функция 68, подфункция 16 - загрузить драйвер. ===========
3665
======================================================================
3666
Параметры:
3667
  * eax = 68 - номер функции
3668
  * ebx = 16 - номер подфункции
277 diamond 3669
  * ecx = указатель на ASCIIZ-строку с именем драйвера
172 serge 3670
Возвращаемое значение:
3671
  * eax = 0 - неудача
3672
  * иначе eax = хэндл драйвера
3673
Замечания:
3674
  * Если драйвер ещё не загружен, он загружается;
3675
    если драйвер уже загружен, ничего не меняется.
3676
  * Имя драйвера чувствительно к регистру символов.
277 diamond 3677
    Максимальная длина имени - 16 символов, включая завершающий
3678
    нулевой символ, остальные символы игнорируются.
346 diamond 3679
  * Драйвер с именем ABC загружается из файла /rd/1/drivers/ABC.obj.
172 serge 3680
 
3681
======================================================================
3682
========== Функция 68, подфункция 17 - управление драйвером. =========
3683
======================================================================
3684
Параметры:
3685
  * eax = 68 - номер функции
3686
  * ebx = 17 - номер подфункции
3687
  * ecx = указатель на управляющую структуру:
3688
    * +0: dword: хэндл драйвера
3689
    * +4: dword: код функции драйвера
3690
    * +8: dword: указатель на входные данные
3691
    * +12 = +0xC: dword: размер входных данных
3692
    * +16 = +0x10: dword: указатель на выходные данные
3693
    * +20 = +0x14: dword: размер выходных данных
3694
Возвращаемое значение:
3695
  * eax = определяется драйвером
3696
Замечания:
3697
  * Коды функций и структура входных/выходных данных
3698
    определяются драйвером.
3699
  * Предварительно должен быть получен хэндл драйвера подфункцией 16.
3700
 
3701
======================================================================
1077 Galkov 3702
== Функция 68, подфункция 18 - установить обработчик исключений SSE. =
172 serge 3703
======================================================================
1077 Galkov 3704
Удалена (в текущей реализации посто возвращает 0)
3705
Использовать подфункции 24, 25
172 serge 3706
 
3707
======================================================================
277 diamond 3708
============= Функция 68, подфункция 19 - загрузить DLL. =============
3709
======================================================================
3710
Параметры:
3711
  * eax = 68 - номер функции
3712
  * ebx = 19 - номер подфункции
3713
  * ecx = указатель на ASCIIZ-строку с полным путём к DLL
3714
Возвращаемое значение:
3715
  * eax = 0 - неудача
3716
  * иначе eax = указатель на таблицу экспорта DLL
3717
Замечания:
3718
  * Таблица экспорта представляет собой массив структур по 2 dword'а,
3719
    заканчивающийся нулём. Первый dword в структуре является
3720
    указателем на имя функции, второй содержит адрес функции.
3721
 
3722
======================================================================
448 diamond 3723
====== Функция 68, подфункция 20 - перераспределить блок памяти. =====
3724
======================================================================
3725
Параметры:
3726
  * eax = 68 - номер функции
3727
  * ebx = 20 - номер подфункции
3728
  * ecx = новый размер в байтах
3729
  * edx = указатель на уже выделенный блок памяти
3730
Возвращаемое значение:
3731
  * eax = указатель на перераспределённый блок, 0 при ошибке
3732
Замечания:
3733
  * Предварительно следует инициализировать кучу процесса вызовом
3734
    подфункции 11.
3735
  * Функция выделяет целое число страниц (4 Кб) так, что фактический
3736
    размер выделенного блока больше или равен запрошенному.
3737
  * Если edx=0, то вызов функции эквивалентен выделению памяти
3738
    подфункцией 12. В противном случае блок памяти по адресу edx
3739
    должен быть ранее выделен подфункцией 12 или
3740
    описываемой подфункцией.
3741
  * Если ecx=0, то функция освобождает блок памяти по адресу edx и
3742
    возвращает 0.
3743
  * Содержимое памяти вплоть до наименьшего из старого и нового
3744
    размеров сохраняется.
3745
 
1018 diamond 3746
======================================================================
3747
=== Функция 68, подфункция 22 - открыть именованную область памяти. ==
3748
======================================================================
3749
Параметры:
945 serge 3750
  * eax = 68 - номер функции
3751
  * ebx = 22 - номер подфункции
1018 diamond 3752
  * ecx = имя области. Максимум 31 символ, включая завершающий ноль
945 serge 3753
  * edx = размер области в байтах для SHM_CREATE и SHM_OPEN_ALWAYS
1018 diamond 3754
  * esi = флаги открытия и доступа:
3755
    * SHM_OPEN        = 0x00 - открыть существующую область памяти.
3756
                          Если область с таким именем не существует,
3757
                          функция вернёт код ошибки 5.
3758
    * SHM_OPEN_ALWAYS = 0x04 - открыть существующую или создать новую
3759
                          область памяти.
3760
    * SHM_CREATE      = 0x08 - создать новую область памяти.
3761
                          Если область с таким именем уже существует,
3762
                          функция вернёт код ошибки 10.
3763
    * SHM_READ        = 0x00 - доступ только на чтение
3764
    * SHM_WRITE       = 0x01 - доступ на чтение и запись
3765
Возвращаемое значение:
3766
  * eax = указатель на область памяти, 0 при ошибке
3767
  * при создании новой области (SHM_CREATE или SHM_OPEN_ALWAYS):
3768
    edx = 0 - успех, иначе - код ошибки
3769
  * при открытии существующей области (SHM_OPEN или SHM_OPEN_ALWAYS):
3770
    edx = код ошибки (при eax=0) или размер области в байтах
945 serge 3771
Коды ошибок:
1018 diamond 3772
  * E_NOTFOUND = 5
3773
  * E_ACCESS = 10
3774
  * E_NOMEM = 30
3775
  * E_PARAM = 33
945 serge 3776
Замечания:
1018 diamond 3777
  * Если создаётся новая область, то флаги доступа устанавливают
3778
    максимальные права доступа для остальных процессов. Попытка
3779
    открытия другим потоком с неразрешёнными правами провалится
3780
    с кодом ошибки E_ACCESS.
3781
  * Процесс, создавший область, всегда имеет доступ на запись.
945 serge 3782
 
1018 diamond 3783
======================================================================
3784
=== Функция 68, подфункция 23 - закрыть именованную область памяти. ==
3785
======================================================================
3786
Параметры:
945 serge 3787
  * eax = 68 - номер функции
3788
  * ebx = 23 - номер подфункции
1018 diamond 3789
  * ecx = имя области. Максимум 31 символ, включая завершающий ноль
945 serge 3790
Возвращаемое значение:
1018 diamond 3791
  * eax разрушается
3792
Замечания:
3793
  * Область памяти физически освобождается (с забыванием всех данных
3794
    и высвобождением физической памяти), когда её закроют
3795
    все открывшие потоки.
3796
  * При завершении потока освобождаются все открытые им
3797
    области памяти.
945 serge 3798
 
448 diamond 3799
======================================================================
1077 Galkov 3800
==== Функция 68, подфункция 24 - установить обработчик исключений  ===
3801
======================================================================
3802
Параметры:
3803
  * eax = 68 - номер функции
3804
  * ebx = 24 - номер подфункции
3805
  * ecx = адрес нового обработчика исключений
3806
  * edx = маска обрабатываемых исключений
3807
Возвращаемое значение:
3808
  * eax = адрес старого обработчика исключений
3809
    (0, если он не был установлен)
3810
  * ebx = маска старого обработчика исключений
3811
Замечания:
3812
  * Номер бита в маске исключений соответствуют номеру исключения по
3813
    спецификации на процессор (Intel-PC). Так например, исключения FPU
3814
    имеют номер 16 (#MF), а SSE - 19 (#XF).
3815
  * В данной реализации игнорируется запрос на перехват исключения 7
3816
    - система обрабатывает #NM самостоятельно.
3817
  * Пользовательский обработчик получает номер исключения параметром
3818
    в стеке. Поэтому правильный выход из обработчика: RET 4. Возврат
3819
    при этом производится на команду, вызвавшую исключение.
3820
  * При передаче управления обработчику исключений, сбрасывается
3821
    соответствующий бит в маске исключений. Возникновение этого же
3822
    исключения в последствии - приведет к default-обработке такового.
3823
    А именно: к завершению работы приложения, или приостановке с
3824
    нотификацией отлаживающему приложению.
3825
  * После завершения критических действий в обработчике пользователя,
3826
    восстановление бита маски данного исключения можно сделать
3827
    подфункцией 18. Сброс флагов исключений в модулях FPU и XMM -
3828
    также возлагается на обработчик пользователя.
3829
 
3830
======================================================================
3831
= Функция 68, подфункция 25 - изменение состояния активности сигнала =
3832
======================================================================
3833
Параметры:
3834
  * eax = 68 - номер функции
3835
  * ebx = 25 - номер подфункции
3836
  * ecx = номер сигнала
3837
  * edx = значение устанавливаемой активности (0/1)
3838
Возвращаемое значение:
3839
  * eax = старое значение активности сигнала (0/1)
3840
Замечания:
3841
  * В текущей реализации изменяется только маска пользовательского
3842
    обработчика исключений, установленного подфункцией 15. При этом
3843
    номер сигнала соответствует номеру исключения.
3844
 
3845
======================================================================
77 diamond 3846
======================== Функция 69 - отладка. =======================
3847
======================================================================
3848
Процесс может загрузить другой процесс как отлаживаемый установкой
172 serge 3849
соответствующего бита при вызове подфункции 7 функции 70.
77 diamond 3850
У процесса может быть только один отладчик; один процесс может
3851
отлаживать несколько разных. Система уведомляет отладчик о событиях,
3852
происходящих с отлаживаемым процессом. Сообщения записываются в буфер,
131 diamond 3853
определённый подфункцией 0.
77 diamond 3854
Формат сообщения:
3855
  * +0: dword: код сообщения
3856
  * +4: dword: PID отлаживаемого процесса
3857
  * +8: могут присутствовать дополнительные данные,
3858
    определяемые кодом сообщения
3859
Коды сообщений:
3860
  * 1 = исключение
131 diamond 3861
    * дополнительно передаётся dword-номер исключения
77 diamond 3862
    * процесс приостановлен
3863
  * 2 = процесс завершился
3864
    * приходит при любом завершении: как через системную функцию -1,
3865
      так и при "убийстве" любым другим процессом
3866
      (в том числе самим отладчиком)
3867
  * 3 = отладочное исключение int 1 = #DB
131 diamond 3868
    * дополнительно передаётся dword-образ регистра DR6:
77 diamond 3869
      * биты 0-3: выполнено условие соответствующей точки останова
3870
        (установленной подфункцией 9)
3871
      * бит 14: исключение произошло из-за режима
3872
        пошаговой трассировки (установлен флаг TF)
3873
    * процесс приостановлен
3874
При завершении отладчика прибиваются все отлаживаемые процессы.
3875
Если отладчик этого не хочет, он должен предварительно отключиться
3876
подфункцией 3.
3877
 
1018 diamond 3878
Все подфункции применимы только к процессам/потокам, запущенным
3879
из текущего функцией 70 с установленным флагом отладки.
77 diamond 3880
Отладка многопоточных программ пока не поддерживается.
3881
Полный список подфункций:
3882
  * подфункция 0 - определить область данных для отладочных сообщений
3883
  * подфункция 1 - получить состояние регистров отлаживаемого потока
3884
  * подфункция 2 - установить состояние регистров отлаживаемого потока
3885
  * подфункция 3 - отключиться от отлаживаемого процесса
3886
  * подфункция 4 - приостановить отлаживаемый поток
3887
  * подфункция 5 - возобновить выполнение отлаживаемого потока
3888
  * подфункция 6 - прочитать из памяти отлаживаемого процесса
3889
  * подфункция 7 - записать в память отлаживаемого процесса
3890
  * подфункция 8 - завершить отлаживаемый поток
3891
  * подфункция 9 - установить/снять аппаратную точку останова
3892
 
3893
======================================================================
3894
====================== Функция 69, подфункция 0 ======================
3895
========= Определить область данных для отладочных сообщений. ========
3896
======================================================================
3897
Параметры:
3898
  * eax = 69 - номер функции
3899
  * ebx = 0 - номер подфункции
3900
  * ecx = указатель
3901
Формат области данных:
3902
  * +0: dword: N = размер буфера (не считая этого заголовка)
3903
  * +4: dword: занято в буфере
3904
  * +8: N*byte: буфер
3905
Возвращаемое значение:
3906
  * функция не возвращает значения
3907
Замечания:
3908
  * Если поле размера отрицательно, буфер считается заблокированным
3909
    и при поступлении нового сообщения система будет ждать.
3910
    Для синхронизации обрамляйте всю работу с буфером операциями
3911
    блокировки/разблокировки
1074 Galkov 3912
        neg     [bufsize]
77 diamond 3913
  * Данные в буфере трактуются как массив элементов переменной длины -
3914
    сообщений. Формат сообщения указан в общем описании.
3915
 
3916
======================================================================
3917
====================== Функция 69, подфункция 1 ======================
3918
========= Получить состояние регистров отлаживаемого потока. =========
3919
======================================================================
3920
Параметры:
3921
  * eax = 69 - номер функции
3922
  * ebx = 1 - номер подфункции
3923
  * ecx = идентификатор потока
3924
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3925
  * esi = указатель на структуру контекста
77 diamond 3926
Возвращаемое значение:
3927
  * функция не возвращает значения
3928
Формат структуры контекста: (FPU пока не поддерживается)
3929
  * +0: dword: eip
3930
  * +4: dword: eflags
3931
  * +8: dword: eax
3932
  * +12 = +0xC: dword: ecx
3933
  * +16 = +0x10: dword: edx
3934
  * +20 = +0x14: dword: ebx
3935
  * +24 = +0x18: dword: esp
3936
  * +28 = +0x1C: dword: ebp
3937
  * +32 = +0x20: dword: esi
3938
  * +36 = +0x24: dword: edi
3939
Замечания:
3940
  * Если поток выполняет код 0-кольца, возвращается
3941
    состояние регистров 3-кольца.
3942
  * Процесс должен быть загружен для отладки (как указано в
3943
    общем описании).
3944
 
3945
======================================================================
3946
====================== Функция 69, подфункция 2 ======================
3947
======== Установить состояние регистров отлаживаемого потока. ========
3948
======================================================================
3949
Параметры:
3950
  * eax = 69 - номер функции
3951
  * ebx = 2 - номер подфункции
3952
  * ecx = идентификатор потока
3953
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3954
  * esi = указатель на структуру контекста
77 diamond 3955
Возвращаемое значение:
3956
  * функция не возвращает значения
3957
Формат структуры контекста указан в описании подфункции 1.
3958
Замечания:
3959
  * Если поток выполняет код 0-кольца, устанавливается
3960
    состояние регистров 3-кольца.
3961
  * Процесс должен быть загружен для отладки (как указано в
3962
    общем описании).
3963
 
3964
======================================================================
3965
== Функция 69, подфункция 3 - отключиться от отлаживаемого процесса. =
3966
======================================================================
3967
Параметры:
3968
  * eax = 69 - номер функции
3969
  * ebx = 3 - номер подфункции
3970
  * ecx = идентификатор
3971
Возвращаемое значение:
3972
  * функция не возвращает значения
3973
Замечания:
3974
  * Если процесс был приостановлен, он возобновляет выполнение.
3975
 
3976
======================================================================
1018 diamond 3977
==== Функция 69, подфункция 4 - приостановить отлаживаемый поток. ====
77 diamond 3978
======================================================================
3979
Параметры:
3980
  * eax = 69 - номер процесса
3981
  * ebx = 4 - номер подфункции
3982
  * ecx = идентификатор
3983
Возвращаемое значение:
3984
  * функция не возвращает значения
1018 diamond 3985
Замечания:
3986
  * Процесс должен быть загружен для отладки (как указано в
3987
    общем описании).
77 diamond 3988
 
3989
======================================================================
3990
====================== Функция 69, подфункция 5 ======================
1018 diamond 3991
============ Возобновить выполнение отлаживаемого потока. ============
77 diamond 3992
======================================================================
3993
Параметры:
3994
  * eax = 69 - номер функции
3995
  * ebx = 5 - номер подфункции
3996
  * ecx = идентификатор
3997
Возвращаемое значение:
3998
  * функция не возвращает значения
1018 diamond 3999
Замечания:
4000
  * Процесс должен быть загружен для отладки (как указано в
4001
    общем описании).
77 diamond 4002
 
4003
======================================================================
4004
====================== Функция 69, подфункция 6 ======================
4005
============= Прочитать из памяти отлаживаемого процесса. ============
4006
======================================================================
4007
Параметры:
4008
  * eax = 69 - номер функции
4009
  * ebx = 6 - номер подфункции
4010
  * ecx = идентификатор
4011
  * edx = сколько байт читать
4012
  * esi = адрес памяти отлаживаемого процесса
4013
  * edi = указатель на буфер для данных
4014
Возвращаемое значение:
4015
  * eax = -1 при ошибке (неверный PID или буфер)
4016
  * иначе eax = число прочитанных байт (возможно, 0,
4017
    если в esi слишком большое значение)
4018
Замечания:
4019
  * Процесс должен быть загружен для отладки (как указано в
4020
    общем описании).
4021
 
4022
======================================================================
1074 Galkov 4023
 Функция 69, подфункция 7 - записать в память отлаживаемого процесса.
77 diamond 4024
======================================================================
4025
Параметры:
4026
  * eax = 69 - номер функции
4027
  * ebx = 7 - номер подфункции
4028
  * ecx = идентификатор
4029
  * edx = сколько байт писать
4030
  * esi = адрес памяти в отлаживаемом процессе
4031
  * edi = указатель на данные
4032
Возвращаемое значение:
4033
  * eax = -1 при ошибке (неверный PID или буфер)
4034
  * иначе eax = число записанных байт (возможно, 0,
4035
    если в esi слишком большое значение)
4036
Замечания:
4037
  * Процесс должен быть загружен для отладки (как указано в
4038
    общем описании).
4039
 
4040
======================================================================
4041
====== Функция 69, подфункция 8 - завершить отлаживаемый поток. ======
4042
======================================================================
4043
Параметры:
4044
  * eax = 69 - номер функции
4045
  * ebx = 8 - номер подфункции
4046
  * ecx = идентификатор
4047
Возвращаемое значение:
4048
  * функция не возвращает значения
4049
Замечания:
4050
  * Процесс должен быть загружен для отладки (как указано в
4051
    общем описании).
4052
  * Функция аналогична подфункции 2 функции 18 с двумя отличиями:
4053
    требуется выполнение первого замечания и принимается PID,
4054
    а не номер слота.
4055
 
4056
======================================================================
4057
====================== Функция 69, подфункция 9 ======================
4058
============= Установить/снять аппаратную точку останова. ============
4059
======================================================================
4060
Параметры:
4061
  * eax = 69 - номер функции
4062
  * ebx = 9 - номер подфункции
4063
  * ecx = идентификатор потока
4064
  * dl = индекс точки останова, от 0 до 3 включительно
4065
  * dh = флаги:
4066
    * если старший бит сброшен - установить точку останова:
4067
      * биты 0-1 - условие:
4068
        * 00 = точка останова на выполнение
4069
        * 01 = точка останова на запись
4070
        * 11 = точка останова на чтение/запись
4071
      * биты 2-3 - длина; для точек останова на исполнение должно быть
4072
        00, в противном случае одно из
4073
        * 00 = байт
4074
        * 01 = слово
4075
        * 11 = двойное слово
4076
      * esi = адрес точки останова; должен быть выровнен
131 diamond 4077
        соответственно длине (т.е. должен быть чётным для
77 diamond 4078
        точек останова на слово, кратен 4 для двойного слова)
4079
    * если старший бит установлен - сбросить точку останова
4080
Возвращаемое значение:
4081
  * eax = 0 - успешно
4082
  * eax = 1 - ошибка во входных данных
4083
  * eax = 2 - (зарезервировано, никогда не возвращается
4084
    в текущей реализации) с этим индексом уже установлена
4085
    глобальная точка останова
4086
Замечания:
4087
  * Процесс должен быть загружен для отладки (как указано в
4088
    общем описании).
4089
  * Аппаратные точки останова реализуются через DRx-регистры
4090
    процессора, отсюда все ограничения.
4091
  * Функция может переустановить ранее установленную ей же
4092
    точку останова (никак не сообщая об этом).
4093
    Ведите список установленных точек останова в отладчике.
4094
  * Срабатывание точки останова заключается в генерировании
4095
    отладочного исключения #DB, о котором система сообщает отладчику.
4096
  * Точка останова на запись и чтение/запись срабатывает после
131 diamond 4097
    выполнения вызвавшей её инструкции.
77 diamond 4098
 
4099
======================================================================
131 diamond 4100
= Функция 70 - работа с файловой системой с поддержкой длинных имён. =
77 diamond 4101
======================================================================
4102
Параметры:
4103
  * eax = 70
4104
  * ebx = указатель на информационную структуру
4105
Возвращаемое значение:
4106
  * eax = 0 - успешно; иначе код ошибки файловой системы
4107
  * в зависимости от подфункции может возвращаться значение и
4108
    в других регистрах
4109
Общий формат информационной структуры:
4110
  * +0: dword: номер подфункции
4111
  * +4: dword: смещение в файле
91 diamond 4112
  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
77 diamond 4113
  * +12 = +0xC: dword: размер
4114
  * +16 = +0x10: dword: указатель на данные
4115
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
86 diamond 4116
    или
4117
  * +20 = +0x14: db 0
4118
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4119
Уточнения - в документации на соответствующую подфункцию.
4120
Имя файла нечувствительно к регистру букв. Русские буквы должны быть
4121
записаны в кодировке cp866 (DOS).
4122
Формат имени файла:
4123
/base/number/dir1/dir2/.../dirn/file,
4124
где /base/number идентифицирует устройство, на котором ищется файл:
4125
одно из
4126
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
4127
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
4128
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
4129
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
131 diamond 4130
    к жёстким дискам на IDE0 (Primary Master), IDE1 (Primary Slave),
77 diamond 4131
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4132
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
4133
    (на каждом из винчестеров нумерация начинается с 1)
91 diamond 4134
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 для доступа соответственно
4135
    к CD на IDE0 (Primary Master), IDE1 (Primary Slave),
118 diamond 4136
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
546 diamond 4137
  * /SYS - определяет системную папку; при обычной загрузке системы
4138
    с дискеты эквивалентно /RD/1
77 diamond 4139
Примеры:
83 diamond 4140
  * '/rd/1/kernel.asm',0
77 diamond 4141
  * '/HD0/1/kernel.asm',0
4142
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4143
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
546 diamond 4144
  * '/sys/MySuperApp.ini',0
77 diamond 4145
Доступные подфункции:
4146
  * подфункция 0 - чтение файла
4147
  * подфункция 1 - чтение папки
83 diamond 4148
  * подфункция 2 - создание/перезапись файла
131 diamond 4149
  * подфункция 3 - запись в существующий файл
133 diamond 4150
  * подфункция 4 - установка размера файла
86 diamond 4151
  * подфункция 5 - получение атрибутов файла/папки
4152
  * подфункция 6 - установка атрибутов файла/папки
91 diamond 4153
  * подфункция 7 - запуск программы
172 serge 4154
  * подфункция 8 - удаление файла/папки
321 diamond 4155
  * подфункция 9 - создание папки
118 diamond 4156
Для CD-приводов в связи с аппаратными ограничениями доступны
4157
только подфункции 0,1,5 и 7, вызов других подфункций завершится
4158
ошибкой с кодом 2.
641 diamond 4159
При первом обращении подфункций 0,1,5,7 к устройствам ATAPI
4160
(CD и DVD) производится блокировка ручного управления механизмом
4161
лотка. Это связано с кэшированием данных, полученных от привода.
4162
Разблокировка осуществляется при обращении подфункции 4 функции 24
4163
к соответствующему устройству.
77 diamond 4164
 
4165
======================================================================
131 diamond 4166
= Функция 70, подфункция 0 - чтение файла с поддержкой длинных имён. =
77 diamond 4167
======================================================================
4168
Параметры:
4169
  * eax = 70 - номер функции
4170
  * ebx = указатель на информационную структуру
4171
Формат информационной структуры:
4172
  * +0: dword: 0 = номер подфункции
4173
  * +4: dword: позиция в файле (в байтах)
4174
  * +8: dword: 0 (зарезервировано под старший dword позиции)
4175
  * +12 = +0xC: dword: сколько байт читать
4176
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
131 diamond 4177
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 4178
    общем описании
86 diamond 4179
    или
4180
  * +20 = +0x14: db 0
4181
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4182
Возвращаемое значение:
4183
  * eax = 0 - успешно, иначе код ошибки файловой системы
4184
  * ebx = число прочитанных байт или
4185
    -1=0xffffffff, если файл не найден
4186
Замечания:
4187
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 4188
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 4189
    eax=6 (EOF).
4190
  * Функция не позволяет читать папки
131 diamond 4191
    (вернётся eax=10, access denied).
77 diamond 4192
 
4193
======================================================================
131 diamond 4194
= Функция 70, подфункция 1 - чтение папки с поддержкой длинных имён. =
77 diamond 4195
======================================================================
4196
Параметры:
4197
  * eax = 70 - номер функции
4198
  * ebx = указатель на информационную структуру
4199
Формат информационной структуры:
4200
  * +0: dword: 1 = номер подфункции
4201
  * +4: dword: индекс начального блока (считая с 0)
78 diamond 4202
  * +8: dword: поле флагов:
4203
    * бит 0 (маска 1): в каком формате возвращать имена,
4204
      0=ANSI, 1=UNICODE
4205
    * прочие биты зарезервированы и должны быть установлены в 0
4206
      для будущей совместимости
77 diamond 4207
  * +12 = +0xC: dword: сколько блоков читать
4208
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
4209
    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
131 diamond 4210
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
77 diamond 4211
    общем описании
86 diamond 4212
    или
4213
  * +20 = +0x14: db 0
4214
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4215
Возвращаемое значение:
4216
  * eax = 0 - успешно, иначе код ошибки файловой системы
4217
  * ebx = число файлов, информация о которых была записана в буфер,
4218
    или -1=0xffffffff, если папка не найдена
4219
Структура буфера:
4220
  * +0: 32*byte: заголовок
4221
  * +32 = +0x20: n1*byte: блок с информацией о файле 1
4222
  * +32+n1: n2*byte: блок с информацией о файле 2
4223
  * ...
4224
Структура заголовка:
4225
  * +0: dword: версия структуры (текущая версия = 1)
131 diamond 4226
  * +4: dword: количество размещённых блоков; не больше, чем запрошено
77 diamond 4227
    в поле +12 информационной структуры; может быть меньше,
4228
    если в папке кончились файлы (то же самое, что и в ebx)
4229
  * +8: dword: общее число файлов в папке
4230
  * +12 = +0xC: 20*byte: зарезервировано (нули)
4231
Структура блока данных входа каталога (БДВК):
4232
  * +0: dword: атрибуты файла:
4233
    * бит 0 (маска 1): файл только для чтения
4234
    * бит 1 (маска 2): файл является скрытым
4235
    * бит 2 (маска 4): файл является системным
4236
    * бит 3 (маска 8): это не файл, а метка тома
4237
      (на заданном разделе встречается не более одного раза и
4238
      только в корневой папке)
4239
    * бит 4 (маска 0x10): это папка
4240
    * бит 5 (маска 0x20): файл не архивировался - многие программы
4241
      архивации имеют опцию, по которой архивируются только файлы
4242
      с установленным этим битом, после чего этот бит сбрасывается -
4243
      это может быть полезно для автоматического создания
4244
      backup-архивов, ибо при записи бит обычно устанавливается
4245
      (не в Kolibri, правда)
78 diamond 4246
  * +4: byte: тип данных имени:
4247
    (совпадает с битом 0 флагов информационной структуры)
77 diamond 4248
    * 0 = ASCII = 1-байтное представление каждого символа
4249
    * 1 = UNICODE = 2-байтное представление каждого символа
4250
  * +5: 3*byte: зарезервировано (нули)
4251
  * +8: 4*byte: время создания файла
4252
  * +12 = +0xC: 4*byte: дата создания файла
4253
  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
4254
  * +20 = +0x14: 4*byte: дата последнего доступа
4255
  * +24 = +0x18: 4*byte: время последней модификации
4256
  * +28 = +0x1C: 4*byte: дата последней модификации
4257
  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
4258
  * +40 = +0x28: имя
4259
    * для формата ASCII: максимальная длина имени 263 символа
4260
      (263 байта), байт после имени имеет значение 0
4261
    * для формата UNICODE: максимальная длина имени 259 символов
4262
      (518 байт), два байта после имени имеют значение 0
4263
Формат времени:
4264
  * +0: byte: секунды
4265
  * +1: byte: минуты
4266
  * +2: byte: часы
4267
  * +3: byte: зарезервировано (0)
4268
  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
4269
Формат даты:
4270
  * +0: byte: день
4271
  * +1: byte: месяц
4272
  * +2: word: год
4273
  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
4274
Замечания:
4275
  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
4276
    304 байта, если в UNICODE - 560 байт. Значение длины выравнено
4277
    на целое кратное 16 байт
4278
    (для ускорения обработки в кэш-памяти CPU).
78 diamond 4279
  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
4280
    данные содержат мусор.
77 diamond 4281
  * Если файлы в папке кончились раньше, чем было прочитано
4282
    запрошенное количество, то функция прочитает, сколько сможет,
131 diamond 4283
    после чего вернёт eax=6 (EOF).
77 diamond 4284
  * Любая папка на диске, кроме корневой, содержит два специальных
4285
    входа "." и "..", идентифицирующих соответственно саму папку и
4286
    родительскую папку.
4287
  * Функция позволяет также читать виртуальные папки "/", "/rd",
4288
    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
4289
    0x10, а времена и даты обнулены. Альтернативный способ получения
4290
    информации об оборудовании - подфункция 11 функции 18.
4291
 
4292
======================================================================
83 diamond 4293
====================== Функция 70, подфункция 2 ======================
131 diamond 4294
======== Создание/перезапись файла с поддержкой длинных имён. ========
83 diamond 4295
======================================================================
4296
Параметры:
4297
  * eax = 70 - номер функции
4298
  * ebx = указатель на информационную структуру
4299
Формат информационной структуры:
4300
  * +0: dword: 2 = номер подфункции
4301
  * +4: dword: 0 (зарезервировано)
4302
  * +8: dword: 0 (зарезервировано)
4303
  * +12 = +0xC: dword: сколько байт писать
4304
  * +16 = +0x10: dword: указатель на данные
131 diamond 4305
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
83 diamond 4306
    общем описании
86 diamond 4307
    или
4308
  * +20 = +0x14: db 0
4309
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
83 diamond 4310
Возвращаемое значение:
4311
  * eax = 0 - успешно, иначе код ошибки файловой системы
4312
  * ebx = число записанных байт (возможно, 0)
4313
Замечания:
131 diamond 4314
  * Если файл с таким именем не существовал, он создаётся; если
83 diamond 4315
    существовал, то перезаписывается.
4316
  * Если свободного места на диске недостаточно, то функция запишет,
131 diamond 4317
    сколько сможет, после чего вернёт код ошибки 8.
4318
  * Функция не поддерживается для CD (вернётся код ошибки 2).
83 diamond 4319
 
4320
======================================================================
131 diamond 4321
====================== Функция 70, подфункция 3 ======================
4322
======== Запись в существующий файл с поддержкой длинных имён. =======
4323
======================================================================
4324
Параметры:
4325
  * eax = 70 - номер функции
4326
  * ebx = указатель на информационную структуру
4327
Формат информационной структуры:
4328
  * +0: dword: 3 = номер подфункции
4329
  * +4: dword: позиция в файле (в байтах)
4330
  * +8: dword: старший dword позиции (должен быть 0 для FAT)
4331
  * +12 = +0xC: dword: сколько байт писать
4332
  * +16 = +0x10: dword: указатель на данные
4333
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4334
    общем описании
4335
    или
4336
  * +20 = +0x14: db 0
4337
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4338
Возвращаемое значение:
4339
  * eax = 0 - успешно, иначе код ошибки файловой системы
4340
  * ebx = число записанных байт (возможно, 0)
4341
Замечания:
4342
  * Файл должен уже существовать, иначе вернётся eax=5.
4343
  * Единственным результатом записи 0 байт является установка в
4344
    атрибутах файла даты/времени модификации и доступа в текущую.
4345
  * Если начальная и/или конечная позиция выходит за пределы файла
4346
    (за исключением предыдущего случая), файл расширяется до
4347
    необходимого размера нулевыми символами.
133 diamond 4348
  * Функция не поддерживается для CD (вернётся код ошибки 2).
131 diamond 4349
 
4350
======================================================================
133 diamond 4351
========= Функция 70, подфункция 4 - установка размера файла. ========
4352
======================================================================
4353
Параметры:
4354
  * eax = 70 - номер функции
4355
  * ebx = указатель на информационную структуру
4356
Формат информационной структуры:
4357
  * +0: dword: 4 = номер подфункции
4358
  * +4: dword: младший dword нового размера файла
4359
  * +8: dword: старший dword нового размера файла
4360
                   (должен быть 0 для FAT)
4361
  * +12 = +0xC: dword: 0 (зарезервировано)
4362
  * +16 = +0x10: dword: 0 (зарезервировано)
4363
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4364
    общем описании
4365
    или
4366
  * +20 = +0x14: db 0
4367
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4368
Возвращаемое значение:
4369
  * eax = 0 - успешно, иначе код ошибки файловой системы
4370
  * ebx разрушается
4371
Замечания:
4372
  * Если новый размер файла меньше старого, файл усекается. Если
4373
    новый размер больше старого, файл расширяется нулевыми символами.
4374
    Если новый размер равен старому, единственным результатом вызова
4375
    является установка даты/времени модификации и доступа в текущие.
4376
  * Если свободного места на диске недостаточно для расширения файла,
4377
    то функция расширит насколько возможно, после чего вернёт
4378
    код ошибки 8.
4379
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4380
 
4381
======================================================================
86 diamond 4382
=== Функция 70, подфункция 5 - получение информации о файле/папке. ===
4383
======================================================================
4384
Параметры:
4385
  * eax = 70 - номер функции
4386
  * ebx = указатель на информационную структуру
4387
Формат информационной структуры:
4388
  * +0: dword: 5 = номер подфункции
4389
  * +4: dword: 0 (зарезервировано)
4390
  * +8: dword: 0 (зарезервировано)
4391
  * +12 = +0xC: dword: 0 (зарезервировано)
4392
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
4393
                        (40 байт)
131 diamond 4394
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4395
    общем описании
4396
    или
4397
  * +20 = +0x14: db 0
4398
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4399
Возвращаемое значение:
4400
  * eax = 0 - успешно, иначе код ошибки файловой системы
4401
  * ebx разрушается
4402
Информация о файле возвращается в формате БДВК
4403
(блока данных входа каталога), указанном в описании
4404
подфункции 1, но без имени файла
4405
(то есть первые 40 = 0x28 байт).
4406
Замечания:
4407
  * Функция не поддерживает виртуальные папки типа /, /rd и
4408
    корневые папки типа /rd/1.
4409
 
4410
======================================================================
4411
===== Функция 70, подфункция 6 - установка атрибутов файла/папки. ====
4412
======================================================================
4413
Параметры:
4414
  * eax = 70 - номер функции
4415
  * ebx = указатель на информационную структуру
4416
Формат информационной структуры:
4417
  * +0: dword: 6 = номер подфункции
4418
  * +4: dword: 0 (зарезервировано)
4419
  * +8: dword: 0 (зарезервировано)
4420
  * +12 = +0xC: dword: 0 (зарезервировано)
4421
  * +16 = +0x10: dword: указатель на буфер с атрибутами (32 байта)
131 diamond 4422
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4423
    общем описании
4424
    или
4425
  * +20 = +0x14: db 0
4426
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4427
Возвращаемое значение:
4428
  * eax = 0 - успешно, иначе код ошибки файловой системы
4429
  * ebx разрушается
4430
Атрибуты файла - первые 32 байта в БДВК (блоке данных входа каталога),
4431
формат которого указан в описании подфункции 1
4432
(то есть без имени и размера файла). Атрибут файл/папка/метка тома
4433
(биты 3,4 в dword'е +0) не меняется.
4434
Байт +4 (формат имени) игнорируется.
4435
Замечания:
4436
  * Функция не поддерживает виртуальные папки типа /, /rd и
4437
    корневые папки типа /rd/1.
131 diamond 4438
  * Функция не поддерживается для CD (вернётся код ошибки 2).
86 diamond 4439
 
4440
======================================================================
91 diamond 4441
============ Функция 70, подфункция 7 - запуск программы. ============
4442
======================================================================
4443
Параметры:
4444
  * eax = 70 - номер функции
4445
  * ebx = указатель на информационную структуру
4446
Формат информационной структуры:
4447
  * +0: dword: 7 = номер подфункции
4448
  * +4: dword: поле флагов:
4449
    * бит 0: запустить процесс как отлаживаемый
4450
    * остальные биты зарезервированы и должны быть установлены в 0
4451
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
4452
  * +12 = +0xC: dword: 0 (зарезервировано)
4453
  * +16 = +0x10: dword: 0 (зарезервировано)
131 diamond 4454
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
91 diamond 4455
    общем описании
4456
    или
4457
  * +20 = +0x14: db 0
4458
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4459
Возвращаемое значение:
4460
  * eax > 0 - программа загружена, eax содержит PID
4461
  * eax < 0 - произошла ошибка, -eax содержит
4462
    код ошибки файловой системы
4463
  * ebx разрушается
4464
Замечания:
4465
  * Командная строка должна заканчиваться символом с кодом 0
4466
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
4467
    включительно, либо первые 256 символов, в зависимости от того,
4468
    что меньше.
131 diamond 4469
  * Если процесс запускается как отлаживаемый, он создаётся
91 diamond 4470
    в замороженном состоянии; для запуска используйте
4471
    подфункцию 5 функции 69.
4472
 
4473
======================================================================
172 serge 4474
========== Функция 70, подфункция 8 - удаление файла/папки. ==========
4475
======================================================================
4476
Параметры:
4477
  * eax = 70 - номер функции
4478
  * ebx = указатель на информационную структуру
4479
Формат информационной структуры:
4480
  * +0: dword: 8 = номер подфункции
4481
  * +4: dword: 0 (зарезервировано)
4482
  * +8: dword: 0 (зарезервировано)
4483
  * +12 = +0xC: dword: 0 (зарезервировано)
4484
  * +16 = +0x10: dword: 0 (зарезервировано)
4485
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4486
    общем описании
4487
    или
4488
  * +20 = +0x14: db 0
4489
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4490
Возвращаемое значение:
4491
  * eax = 0 - успешно, иначе код ошибки файловой системы
4492
  * ebx разрушается
4493
Замечания:
4494
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4495
  * Можно удалять только пустые папки (попытка удаления непустой папки
4496
    приведёт к ошибке с кодом 10, "доступ запрещён").
4497
 
4498
======================================================================
321 diamond 4499
============= Функция 70, подфункция 9 - создание папки. =============
4500
======================================================================
4501
Параметры:
4502
  * eax = 70 - номер функции
4503
  * ebx = указатель на информационную структуру
4504
Формат информационной структуры:
4505
  * +0: dword: 9 = номер подфункции
4506
  * +4: dword: 0 (зарезервировано)
4507
  * +8: dword: 0 (зарезервировано)
4508
  * +12 = +0xC: dword: 0 (зарезервировано)
4509
  * +16 = +0x10: dword: 0 (зарезервировано)
4510
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
4511
    общем описании
4512
    или
4513
  * +20 = +0x14: db 0
4514
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем папки
4515
Возвращаемое значение:
4516
  * eax = 0 - успешно, иначе код ошибки файловой системы
4517
  * ebx разрушается
4518
Замечания:
4519
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4520
  * Родительская папка должна уже существовать.
4521
  * Если папка уже существует, функция завершится успешно (eax=0).
4522
 
4523
======================================================================
118 diamond 4524
=== Функция 71, подфункция 1 - установить заголовок окна программы. ==
114 mikedld 4525
======================================================================
4526
Параметры:
4527
  * eax = 71 - номер функции
4528
  * ebx = 1 - номер подфункции
118 diamond 4529
  * ecx = адрес строки заголовка
114 mikedld 4530
Возвращаемое значение:
118 diamond 4531
  * функция не возвращает значения
114 mikedld 4532
Замечания:
4533
  * Строка заголовка должна быть в формате ASCIIZ. В заголовке
118 diamond 4534
    отображается не более 255 символов независимо от полной длины
114 mikedld 4535
    строки.
118 diamond 4536
  * Чтобы убрать заголовок, передайте NULL в ecx.
114 mikedld 4537
 
4538
======================================================================
665 diamond 4539
================ Функция 72 - послать сообщение окну. ================
4540
======================================================================
4541
 
4542
--- Подфункция 1 - послать сообщение с параметром активному окну. ----
4543
Параметры:
4544
  * eax = 72 - номер функции
4545
  * ebx = 1 - номер подфункции
4546
  * ecx = код события: 2 или 3
4547
  * edx = код клавиши для ecx=2, идентификатор кнопки для ecx=3
4548
Возвращаемое значение:
4549
  * eax = 0 - успешно
4550
  * eax = 1 - буфер заполнен
4551
 
4552
======================================================================
77 diamond 4553
========== Функция -1 - завершить выполнение потока/процесса =========
4554
======================================================================
4555
Параметры:
4556
  * eax = -1 - номер функции
4557
Возвращаемое значение:
4558
  * функция не возвращает ни значения, ни управления
4559
Замечания:
4560
  * Если процесс явно не создавал потоков, то у него есть только
4561
    один поток, завершение которого приводит к завершению процесса.
4562
  * Если текущий поток - последний в процессе, то его завершение
4563
    также приводит к завершению процесса.
4564
  * Эта функция завершает текущий поток. Другой поток можно прибить
4565
    вызовом подфункции 2 функции 18.
4566
 
4567
======================================================================
4568
=========================== Список событий ===========================
4569
======================================================================
4570
Очередное событие можно получить вызовом одной из функций 10
4571
(ожидать события), 11 (проверить без ожидания), 23
4572
(ожидать в течение заданного времени).
4573
Эти функции возвращают только те события, которые входят в маску,
4574
устанавливаемую функцией 40. По умолчанию это первые три, чего
4575
вполне достаточно для многих приложений.
4576
Коды событий:
4577
  * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
4578
  * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
92 diamond 4579
    активно) или нажата "горячая клавиша";
4580
    сбрасывается, когда все клавиши из буфера считаны функцией 2
131 diamond 4581
  * 3 = нажата кнопка, определённая ранее функцией 8 (или кнопка
77 diamond 4582
    закрытия, созданная неявно функцией 0; кнопка минимизации
4583
    обрабатывается системой и о ней сообщения не приходит;
4584
    поступает, только когда окно активно; сбрасывается, когда все
4585
    кнопки из буфера считаны функцией 17)
4586
  * 4 = зарезервировано (в текущей реализации никогда не приходит даже
4587
    при размаскировке функцией 40)
4588
  * 5 = перерисовывается фон рабочего стола (сбрасывается
4589
    автоматически после перерисовки, так что если во время перерисовки
131 diamond 4590
    фона программа не ждёт и не проверяет события, то этого события
77 diamond 4591
    она не заметит)
4592
  * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
4593
    или перемещение; сбрасывается при прочтении)
4594
  * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
4595
    Communication; сбрасывается при прочтении)
4596
  * 8 = произошло сетевое событие (сбрасывается при прочтении;
4597
    смотри работу с сетью)
4598
  * 9 = произошло отладочное событие (сбрасывается при прочтении;
4599
    смотри отладочную подсистему)
4600
  * 16..31 = произошло событие с соответствующим IRQ
4601
    (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)
4602
 
4603
======================================================================
4604
==================== Коды ошибок файловой системы ====================
4605
======================================================================
4606
  * 0 = успешно
131 diamond 4607
  * 1 = не определена база и/или раздел жёсткого диска (подфункциями
77 diamond 4608
    7, 8 функции 21)
4609
  * 2 = функция не поддерживается для данной файловой системы
4610
  * 3 = неизвестная файловая система
448 diamond 4611
  * 4 = зарезервировано, никогда не возвращается в текущей реализации
77 diamond 4612
  * 5 = файл не найден
4613
  * 6 = файл закончился
4614
  * 7 = указатель вне памяти приложения
4615
  * 8 = диск заполнен
4616
  * 9 = таблица FAT разрушена
131 diamond 4617
  * 10 = доступ запрещён
83 diamond 4618
  * 11 = ошибка устройства
77 diamond 4619
При запуске программы возможны также следующие коды ошибок:
4620
  * 30 = 0x1E = недостаточно памяти
4621
  * 31 = 0x1F = файл не является исполнимым
172 serge 4622
  * 32 = 0x20 = слишком много процессов