Subversion Repositories Kolibri OS

Rev

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

Rev Author Line No. Line
114 mikedld 1
СИСТЕМНЫЕ ФУНКЦИИ ОПЕРАЦИОННОЙ СИСТЕМЫ Kolibri 0.5.8.1
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 - окно со скином
25
      * остальные возможные значения (от 4 до 15) зарезервированы,
26
        вызов функции с такими Y игнорируется
27
    * RR, GG, BB = соответственно красная, зеленая, синяя
28
      составляющие цвета рабочей области окна
29
      (игнорируется для стиля Y=2)
114 mikedld 30
    * X = DCBA (биты)
31
      * A = 1 - у окна есть заголовок; если Y=3, адрес строки заголовка может быть задан
32
                в edi, иначе - использованием подфункции 1 функции 71
33
      * B = 1 - рисовать все примитивы относитльно клиентской области окна
34
      * C - зарезервирован
35
      * D = 8 - градиентная заливка клиентской области
77 diamond 36
    Следующие параметры предназначены для окон типа I и II и
37
    игнорируются для стилей Y=1,3:
38
  * esi = 0xXYRRGGBB - цвет заголовка
39
    * RR, GG, BB определяют сам цвет
40
    * Y=0 - обычное окно, Y=1 - неперемещаемое окно
41
    * X определяет градиент заголовка: X=0 - нет градиента,
42
      X=8 - обычный градиент,
43
      для окон типа II X=4 - негативный градиент
44
    * прочие значения X и Y зарезервированы
45
  * edi = 0x00RRGGBB - цвет рамки
46
Возвращаемое значение:
47
  * функция не возвращает значения
48
Замечания:
49
  * Положение и размеры окна устанавливаются при первом вызове
50
    этой функции и игнорируются при последующих; для изменения
51
    положения и/или размеров уже созданного окна используйте
52
    67-ю функцию.
53
  * Если использовать окна соответствующих стилей, то положение
54
    и/или размеры окна могут меняться пользователем.
55
    Текущие положение и размеры могут быть получены вызовом функции 9.
56
  * Окно должно умещаться на экране. Если переданные координаты
57
    и размеры не удовлетворяют этому условию, то соответствующая
58
    координата (или, возможно, обе) считается нулем, а если и это
59
    не помогает, то соответствующий размер (или, возможно, оба)
60
    устанавливается в размер экрана.
61
 
62
    Далее обозначим xpos,ypos,xsize,ysize - значения, передаваемые
63
    в ebx,ecx. Координаты приводятся относительно левого верхнего
64
    угла окна, который, таким образом, задается как (0,0), координаты
65
    правого нижнего угла суть (xsize,ysize).
66
  * Размеры окна понимаются в смысле координат правого нижнего угла.
67
    Это же относится и ко всем остальным функциям.
68
    Это означает, что реальные размеры на 1 пиксель больше.
69
  * Вид окна типа I:
70
    * рисуется внешняя рамка цвета, указанного в edi,
71
      шириной 1 пиксель
72
    * рисуется заголовок - прямоугольник с левым верхним углом (1,1)
73
      и правым нижним (xsize-1,min(25,ysize)) цвета, указанного в esi
74
      (с учетом градиента)
75
    * если ysize>=26, то закрашивается рабочая область окна -
76
      прямоугольник с левым верхним углом (1,21) и правым нижним
77
      (xsize-1,ysize-1) (размерами (xsize-1)*(ysize-21)) - цветом,
78
      указанным в edx (с учетом градиента)
79
  * Вид окна стиля Y=1:
80
    * полностью определяется приложением
81
  * Вид окна типа II:
114 mikedld 82
    * рисуется внешняя рамка шириной 1 пиксель "затен+нного" цвета
77 diamond 83
      edi (все составляющие цвета уменьшаются в два раза)
84
    * рисуется промежуточная рамка шириной 3 пикселя цвета edi
85
    * рисуется внутренняя рамка шириной 1 пиксель
114 mikedld 86
      "затен+нного" цвета edi
77 diamond 87
    * рисуется заголовок - прямоугольник с левым верхним углом (4,4)
88
      и правым нижним (xsize-4,min(20,ysize)) цвета, указанного в esi
89
      (с учетом градиента)
90
    * если ysize>=26, то закрашивается рабочая область окна -
91
      прямоугольник с левым верхним углом (5,20) и правым нижним
92
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
93
  * Вид окна со скином:
94
    * рисуется внешняя рамка шириной 1 пиксель
95
      цвета 'outer' из скина
96
    * рисуется промежуточная рамка шириной 3 пикселя
97
      цвета 'frame' из скина
98
    * рисуется внутренняя рамка шириной 1 пиксель
99
      цвета 'inner' из скина
100
    * рисуется заголовок (по картинкам из скина) в прямоугольнике
101
      (0,0) - (xsize,_skinh-1)
102
    * если ysize>=26, то закрашивается рабочая область окна -
103
      прямоугольник с левым верхним углом (5,_skinh) и правым нижним
104
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
105
    * определяются две стандартные кнопки: закрытия и минимизации
106
      (смотри функцию 8)
107
    * Значение переменной _skinh доступно как результат вызова
108
      подфункции 4 функции 48
109
 
110
======================================================================
111
================= Функция 1 - поставить точку в окне. ================
112
======================================================================
113
Параметры:
114
  * eax = 1 - номер функции
115
  * ebx = x-координата (относительно окна)
116
  * ecx = y-координата (относительно окна)
117
  * edx = 0x00RRGGBB - цвет точки
118
    edx = 0x01xxxxxx - инвертировать цвет точки
119
          (младшие 24 бита игнорируются)
120
Возвращаемое значение:
121
  * функция не возвращает значения
122
 
123
======================================================================
124
============== Функция 2 - получить код нажатой клавиши. =============
125
======================================================================
126
Забирает код нажатой клавиши из буфера.
127
Параметры:
128
  * eax = 2 - номер функции
129
Возвращаемое значение:
130
  * если буфер пуст, возвращается eax=1
131
  * если буфер непуст, то возвращается al=0, ah=код нажатой клавиши,
132
    старшее слово регистра eax обнулено
92 diamond 133
  * если есть "горячая клавиша", то возвращается
134
    al=2, ah=сканкод нажатой клавиши (0 для управляющих клавиш),
135
    старшее слово регистра eax содержит состояние управляющих клавиш
136
    в момент нажатия горячей клавиши
77 diamond 137
Замечания:
138
  * Существует общесистемный буфер нажатых клавиш размером 120 байт,
139
    организованный как очередь.
114 mikedld 140
  * Существует ещ+ один общесистемный буфер на 120 "горячих клавиш".
77 diamond 141
  * При вызове этой функции приложением с неактивным окном
92 diamond 142
    считается, что буфер нажатых клавиш пуст.
77 diamond 143
  * По умолчанию эта функция возвращает ASCII-коды; переключиться на
144
    режим сканкодов (и назад) можно с использованием функции 66.
92 diamond 145
    Однако, горячие клавиши всегда возвращаются как сканкоды.
77 diamond 146
  * Узнать, какие комбинации клавиш соответствуют каким кодам, можно,
147
    запустив приложения keyascii и scancode.
148
  * Сканкоды возвращаются непосредственно клавиатурой и фиксированы;
149
    ASCII-коды получаются с использованием таблиц преобразования,
150
    которые можно установить подфункцией 2 функции 21 и прочитать
151
    подфункцией 2 функции 26.
152
  * Как следствие, ASCII-коды учитывают текущую раскладку клавиатуры
153
    (rus/en) в отличие от сканкодов.
92 diamond 154
  * Поступает информация только о тех горячих клавишах, которые были
155
    определены этим потоком подфункцией 4 функции 66.
77 diamond 156
 
157
======================================================================
158
================ Функция 3 - получить системное время. ===============
159
======================================================================
160
Параметры:
161
  * eax = 3 - номер функции
162
Возвращаемое значение:
163
  * eax = 0x00SSMMHH, где HH:MM:SS = часы:минуты:секунды
164
  * каждый элемент возвращается как BCD-число, например,
165
    для времени 23:59:59 результат будет 0x00595923
166
Замечания:
167
  * Смотри также подфункцию 9 функции 26 - получение времени
168
    с момента запуска системы; она во многих случаях удобнее,
169
    поскольку возвращает просто DWORD-значение счетчика времени.
170
  * Системное время можно установить функцией 22.
171
 
172
======================================================================
173
================== Функция 4 - вывести текст в окно. =================
174
======================================================================
114 mikedld 175
Может выводить как строку заданной длины, так и строку, оканчивающуюся
176
NULL-символом(0x0) - ASCIIZ(string  db  'text',0). Чтобы вывести
177
ASCIIZ-строку поместите в esi -1 (mov esi,-1).
77 diamond 178
Параметры:
179
  * eax = 4 - номер функции
180
  * ebx = [координата по оси x]*65536 + [координата по оси y]
181
  * ecx = 0xX0RRGGBB, где
182
    * RR, GG, BB задают цвет текста
183
    * X задает используемый шрифт: 0=системный моноширинный,
184
      1=системный шрифт переменной ширины
185
  * edx = указатель на начало строки
186
  * esi = длина строки, должна быть не больше 255
187
Возвращаемое значение:
188
  * функция не возвращает значения
189
Замечания:
190
  * Первый системный шрифт считывается при загрузке из файла char.mt,
191
    второй - из char2.mt.
192
  * Оба шрифта имеют высоту 9 пикселей, ширина моноширинного шрифта
193
    равна 6 пикселей.
194
 
195
======================================================================
196
========================= Функция 5 - пауза. =========================
197
======================================================================
198
Задерживает выполнение программы на заданное время.
199
Параметры:
200
  * eax = 5 - номер функции
201
  * ebx = время в сотых долях секунды
202
Возвращаемое значение:
203
  * функция не возвращает значения
204
Замечания:
205
  * Передача ebx=0 не передает управление следующему процессу и
206
    вообще не производит никаких действий. Если действительно
207
    требуется передать управление следующему процессу
208
    (закончить текущий квант времени), используйте подфункцию 1
209
    функции 68.
210
  * При текущей реализации произойдет немедленный возврат из функции,
211
    если сложение ebx с текущим значением счетчика времени вызовет
212
    32-битное переполнение.
213
 
214
======================================================================
215
=============== Функция 6 - прочитать файл с рамдиска. ===============
216
======================================================================
217
Параметры:
218
  * eax = 6 - номер функции
219
  * ebx = указатель на имя файла
220
  * ecx = номер стартового блока, считая с 1;
221
    ecx=0 - читать с начала файла (то же самое, что и ecx=1)
222
  * edx = число блоков для чтения;
223
    edx=0 - читать один блок (то же самое, что и edx=1)
224
  * esi = указатель на область памяти, куда будут записаны данные
225
Возвращаемое значение:
226
  * eax = длина файла в байтах, если файл успешно прочитан
227
  * eax = -1, если файл не найден
228
Замечания:
229
  * Данная функция является устаревшей; функция 70
230
    позволяет выполнять те же действия с расширенными возможностями.
231
  * Блок = 512 байт.
232
  * Для чтения всего файла можно указать заведомо большое значение
233
    в edx, например, edx = -1; но в этом случае будьте готовы к тому,
234
    что программа "упадет", если файл окажется слишком большим
235
    и "не влезет" в память программы.
236
  * Имя файла должно быть либо в формате 8+3 символов
237
    (первые 8 символов - собственно имя, последние 3 - расширение,
238
    короткие имена и расширения дополняются пробелами),
239
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
240
    (имя не более 8 символов, точка, расширение 3 символа,
241
    дополненное при необходимости пробелами).
242
    Имя файла должно быть записано заглавными буквами.
243
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
244
  * Текущая реализация рамдиска не поддерживает директории.
245
 
246
======================================================================
247
=============== Функция 7 - вывести изображение в окно. ==============
248
======================================================================
249
Параметры:
250
  * eax = 7 - номер функции
81 diamond 251
  * ebx = указатель на изображение в формате BBGGRRBBGGRR...
77 diamond 252
  * ecx = [размер по оси x]*65536 + [размер по оси y]
253
  * edx = [координата по оси x]*65536 + [координата по оси y]
254
Возвращаемое значение:
255
  * функция не возвращает значения
256
Замечания:
257
  * Координаты изображения - это координаты верхнего левого угла
258
    изображения относительно окна.
259
  * Размер изображения в байтах есть 3*xsize*ysize.
260
 
261
======================================================================
262
=============== Функция 8 - определить/удалить кнопку. ===============
263
======================================================================
264
Параметры для определения кнопки:
265
  * eax = 8 - номер функции
266
  * ebx = [координата по оси x]*65536 + [размер по оси x]
267
  * ecx = [координата по оси y]*65536 + [размер по оси y]
268
  * edx = 0xXYnnnnnn, где:
269
    * nnnnnn = идентификатор кнопки
270
    * старший (31-й) бит edx сброшен
271
    * если 30-й бит edx установлен - не прорисовывать кнопку
272
    * если 29-й бит edx установлен - не рисовать рамку
273
      при нажатии на кнопку
274
  * esi = 0x00RRGGBB - цвет кнопки
275
Параметры для удаления кнопки:
276
  * eax = 8 - номер функции
277
  * edx = 0x80nnnnnn, где nnnnnn - идентификатор кнопки
278
Возвращаемое значение:
279
  * функция не возвращает значения
280
Замечания:
281
  * Размеры кнопки должны быть больше 0 и меньше 0x8000.
282
  * Для окон со скином при определении окна (вызове 0-й функции)
283
    создаются две стандартные кнопки - закрытия окна
284
    с идентификатором 1 и минимизации окна с идентификатором 0xffff.
285
  * Создание двух кнопок с одинаковыми идентификаторами
286
    вполне допустимо.
287
  * Кнопка с идентификатором 0xffff при нажатии интерпретируется
288
    системой как кнопка минимизации, система обрабатывает такое
289
    нажатие самостоятельно, не обращаясь к приложению.
290
    В остальном это обычная кнопка.
291
  * Общее количество кнопок для всех приложений ограничено
292
    числом 4095.
293
 
294
======================================================================
295
============= Функция 9 - информация о потоке выполнения. ============
296
======================================================================
297
Параметры:
298
  * eax = 9 - номер функции
299
  * ebx = указатель на буфер размера 1 Кб
300
  * ecx = номер слота потока
301
    ecx = -1 - получить информацию о текущем потоке
302
Возвращаемое значение:
303
  * eax = максимальный номер слота потока
304
  * буфер, на который указывает ebx, содержит следующую информацию:
305
    * +0: dword: использование процессора (сколько тактов в секунду
306
      уходит на исполнение именно этого потока)
307
    * +4: word: позиция окна потока в оконном стэке
308
    * +6: word: (не имеет отношения к запрошенному потоку)
309
      номер слота потока, окно которого находится в оконном стэке
310
      в позиции ecx
311
    * +8: word: зарезервировано
312
    * +10 = +0xA: 11 байт: имя процесса
313
      (имя соответствующего исполняемого файла в формате 8+3)
314
    * +21 = +0x15: byte: выравнивание, этот байт не изменяется
315
    * +22 = +0x16: dword: адрес процесса в памяти
316
    * +26 = +0x1A: dword: размер используемой памяти - 1
317
    * +30 = +0x1E: dword: идентификатор (PID/TID)
318
    * +34 = +0x22: dword: координата окна потока по оси x
319
    * +38 = +0x26: dword: координата окна потока по оси y
320
    * +42 = +0x2A: dword: размер окна потока по оси x
321
    * +46 = +0x2E: dword: размер окна потока по оси y
322
    * +50 = +0x32: word: состояние слота потока:
323
      * 0 = поток выполняется
324
      * 1 = поток приостановлен
325
      * 2 = поток приостановлен в момент ожидания события
326
      * 3 = поток завершается в результате вызова функции -1 или
327
        насильственно как следствие вызова подфункции 2 функции 18
328
        или завершения работы системы
329
      * 4 = поток завершается в результате исключения
330
      * 5 = поток ожидает события
331
      * 9 = запрошенный слот свободен, вся остальная информация о
332
        слоте не имеет смысла
333
Замечания:
334
  * Слоты нумеруются с 1.
335
  * Возвращаемое значение не есть общее число потоков, поскольку
336
    бывают свободные слоты.
337
  * При создании процесса автоматически создается поток выполнения.
338
  * Функция выдает информацию о потоке. Каждый процесс имеет
339
    хотя бы один поток. Один процесс может создать несколько потоков,
340
    в этом случае каждый поток получает свой слот, причем поля
341
    +10, +22, +26 в этих слотах совпадают.
342
    Для приложений не существует общего способа определить,
343
    принадлежат ли два потока одному процессу.
344
  * Активное окно - окно, находящееся на вершине оконного стэка,
345
    оно получает сообщения о вводе с клавиатуры. Для него позиция в
346
    оконном стэке совпадает с возвращаемым значением.
347
  * Слот 1 соответствует специальному потоку операционной системы,
348
    для которого:
349
    * окно находится внизу оконного стэка, поля +4 и +6 содержат
350
      значение 1
351
    * имя процесса - "OS/IDLE" (дополненное пробелами)
352
    * адрес процесса в памяти равен 0, размер используемой памяти
353
      16 Mb (0x1000000)
354
    * PID=1
355
    * координаты и размеры окна условно полагаются равными 0
356
    * состояние слота - всегда 0 (выполняется)
357
    * время выполнения складывается из времени, уходящего на
358
      собственно работу, и времени простоя в ожидании прерывания
359
      (которое можно получить вызовом подфункции 4 функции 18).
360
  * Начиная со слота 2, размещаются обычные приложения.
361
  * Обычные приложения размещаются в памяти по адресу 0x10000000
362
    (константа ядра std_application_base_address).
363
    Наложения не происходит, поскольку у каждого процесса своя
364
    таблица страниц.
365
  * При создании потока ему назначаются слот в системной таблице и
366
    идентификатор (Process/Thread IDentifier = PID/TID), которые для
367
    заданного потока не изменяются со временем.
368
    После завершения потока его слот может быть заново использован
369
    для другого потока. Идентификатор потока не может быть назначен
370
    другому потоку даже после завершения первого.
371
    Назначаемые новым потокам идентификаторы монотонно растут.
372
  * Если поток еще не определил свое окно вызовом функции 0, то
373
    положение и размеры этого окна полагаются нулями.
374
  * В данный момент используется только часть буфера размером
375
    52 = 0x34 байта. Тем не менее рекомендуется использовать буфер
376
    размером 1 Кб для будущей совместимости, в будущем могут быть
377
    добавлены некоторые поля.
378
 
379
======================================================================
380
==================== Функция 10 - ожидать события. ===================
381
======================================================================
382
Если очередь сообщений пуста, то ждет появления сообщения в очереди.
383
В таком состоянии поток не получает процессорного времени.
384
Затем считывает сообщение из очереди.
385
 
386
Параметры:
387
  * eax = 10 - номер функции
388
Возвращаемое значение:
389
  * eax = событие (смотри список событий)
390
Замечания:
391
  * Учитываются только те события, которые входят в маску,
392
    устанавливаемую функцией 40. По умолчанию это события
393
    перерисовки, нажатия на клавиши и на кнопки.
394
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
395
    Чтобы ждать не более определенного времени, используйте
396
    функцию 23.
397
 
398
======================================================================
399
======= Функция 11 - проверить, есть ли событие, без ожидания. =======
400
======================================================================
401
Если в очереди сообщений есть какое-то событие, то считывает и
402
возвращает его. Если очередь пуста, возвращает нуль.
403
Параметры:
404
  * eax = 11 - номер функции
405
Возвращаемое значение:
406
  * eax = 0 - очередь сообщений пуста
407
  * иначе eax = событие (смотри список событий)
408
Замечания:
409
  * Учитываются только те события, которые входят в маску,
410
    устанавливаемую функцией 40. По умолчанию это события
411
    перерисовки, нажатия на клавиши и на кнопки.
412
  * Для ожидания появления события в очереди, используйте функцию 10.
413
    Чтобы ждать не более определенного времени, используйте
414
    функцию 23.
415
 
416
======================================================================
417
=========== Функция 12 - начать/закончить перерисовку окна. ==========
418
======================================================================
419
 
420
-------------- Подфункция 1 - начать перерисовку окна. ---------------
421
Параметры:
422
  * eax = 12 - номер функции
423
  * ebx = 1 - номер подфункции
424
Возвращаемое значение:
425
  * функция не возвращает значения
426
 
427
------------- Подфункция 2 - закончить перерисовку окна. -------------
428
Параметры:
429
  * eax = 12 - номер функции
430
  * ebx = 2 - номер подфункции
431
Возвращаемое значение:
432
  * функция не возвращает значения
433
Замечания:
114 mikedld 434
  * Функция начала перерисовки удаляет все определ+нные
77 diamond 435
    функцией 8 кнопки, их следует определить повторно.
436
 
437
======================================================================
438
============ Функция 13 - нарисовать прямоугольник в окне. ===========
439
======================================================================
440
Параметры:
441
  * eax = 13 - номер функции
442
  * ebx = [координата по оси x]*65536 + [размер по оси x]
443
  * ecx = [координата по оси y]*65536 + [размер по оси y]
444
  * edx = цвет 0xRRGGBB или 0x80RRGGBB для градиентной заливки
445
Возвращаемое значение:
446
  * функция не возвращает значения
447
Замечания:
448
  * Под координатами понимаются координаты левого верхнего угла
449
    прямоугольника относительно окна.
450
 
451
======================================================================
452
================ Функция 14 - получить размеры экрана. ===============
453
======================================================================
454
Параметры:
455
  * eax = 14 - номер функции
456
Возвращаемое значение:
457
  * eax = [xsize]*65536 + [ysize], где
458
  * xsize = x-координата правого нижнего угла экрана =
459
            размер по горизонтали - 1
460
  * ysize = y-координата правого нижнего угла экрана =
461
            размер по вертикали - 1
462
Замечания:
463
  * Смотри также подфункцию 5 функции 48 - получить размеры рабочей
464
    области экрана.
465
 
466
======================================================================
467
= Функция 15, подфункция 1 - установить размер фонового изображения. =
468
======================================================================
469
Параметры:
470
  * eax = 15 - номер функции
471
  * ebx = 1 - номер подфункции
472
  * ecx = ширина изображения
473
  * edx = высота изображения
474
Возвращаемое значение:
475
  * функция не возвращает значения
476
Замечания:
477
  * Проверок на корректность не делается. Установка слишком больших
114 mikedld 478
    значений привед+т к тому, что в фон войдут данные за границей
77 diamond 479
    буфера фонового изображения. Размер буфера = 0x160000-0x10, что
480
    соответствует максимальным размерам 800*600. (800*600*3=0x15F900)
481
  * Для обновления экрана (после завершения серии команд, работающих с
482
    фоном) вызывайте подфункцию 3 перерисовки фона.
483
  * Есть парная функция получения размеров фонового изображения -
484
    подфункция 1 функции 39.
485
 
486
======================================================================
487
= Функция 15, подфункция 2 - поставить точку на фоновом изображении. =
488
======================================================================
489
Параметры:
490
  * eax = 15 - номер функции
491
  * ebx = 2 - номер подфункции
492
  * ecx = смещение
493
  * edx = цвет точки 0xRRGGBB
494
Возвращаемое значение:
495
  * функция не возвращает значения
496
Замечания:
497
  * Смещение для точки с координатами (x,y) вычисляется как
498
    (x+y*xsize)*3.
499
  * Если указанное смещение превышает 0x160000-16 =
500
    1.375 Mb - 16 bytes, вызов игнорируется.
501
  * Для обновления экрана (после завершения серии команд, работающих с
502
    фоном) вызывайте подфункцию 3 перерисовки фона.
503
  * Есть парная функция получения точки с фонового изображения -
504
    подфункция 2 функции 39.
505
 
506
======================================================================
507
============ Функция 15, подфункция 3 - перерисовать фон. ============
508
======================================================================
509
Параметры:
510
  * eax = 15 - номер функции
511
  * ebx = 3 - номер подфункции
512
Возвращаемое значение:
513
  * функция не возвращает значения
514
 
515
======================================================================
516
===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====
517
======================================================================
518
Параметры:
519
  * eax = 15 - номер функции
520
  * ebx = 4 - номер подфункции
521
  * ecx = режим отрисовки:
522
    * 1 = замостить
523
    * 2 = растянуть
524
Возвращаемое значение:
525
  * функция не возвращает значения
526
Замечания:
527
  * Для обновления экрана (после завершения серии команд, работающих с
528
    фоном) вызывайте подфункцию 3 перерисовки фона.
529
  * Есть парная команда получения режима отрисовки фона -
530
    подфункция 4 функции 39.
531
 
532
======================================================================
533
===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====
534
======================================================================
535
Параметры:
536
  * eax = 15 - номер функции
537
  * ebx = 5 - номер подфункции
81 diamond 538
  * ecx = указатель на данные в формате BBGGRRBBGGRR...
77 diamond 539
  * edx = смещение в данных фонового изображения
540
  * esi = размер данных в байтах = 3 * число пикселей
541
Возвращаемое значение:
542
  * функция не возвращает значения
543
Замечания:
544
  * Если блок вылезает за границу 0x160000-16 = 1.375 Mb - 16 bytes,
545
    то вызов игнорируется.
81 diamond 546
  * Цвет каждого пикселя хранится как 3-байтная величина BBGGRR.
77 diamond 547
  * Пиксели фонового изображения записываются последовательно
548
    слева направо, сверху вниз.
549
  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.
550
  * Для обновления экрана (после завершения серии команд, работающих с
551
    фоном) вызывайте подфункцию 3 перерисовки фона.
552
 
553
======================================================================
554
============= Функция 16 - сохранить рамдиск на дискету. =============
555
======================================================================
556
Параметры:
557
  * eax = 16 - номер функции
558
  * ebx = 1 или ebx = 2 - на какую дискету сохранять
559
Возвращаемое значение:
560
  * eax = 0 - успешно
561
  * eax = 1 - ошибка
562
 
563
======================================================================
564
============== Функция 17 - получить код нажатой кнопки. =============
565
======================================================================
566
Забирает код нажатой кнопки из буфера.
567
Параметры:
568
  * eax = 17 - номер функции
569
Возвращаемое значение:
570
  * если буфер пуст, возвращается eax=1
571
  * если буфер непуст, то возвращается al=0, старшие 24 бита eax
572
    содержат идентификатор кнопки (в частности, в ah оказывается
573
    младший байт идентификатора; если все кнопки имеют идентификатор,
574
    меньший 256, то для различения достаточно ah)
575
Замечания:
576
  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки
577
    информация о старой теряется.
578
  * При вызове этой функции приложением с неактивным окном
579
    возвращается ответ "буфер пуст".
580
 
581
======================================================================
582
======== Функция 18, подфункция 1 - завершить работу системы. ========
583
======================================================================
584
Параметры:
585
  * eax = 18 - номер функции
586
  * ebx = 1 - номер подфункции
587
Возвращаемое значение:
588
  * всегда возвращается eax = 0 как признак успеха
589
Замечания:
590
  * На последнем шаге появляется меню выхода из системы, ожидающее
591
    реакции пользователя.
592
  * Смотри также подфункцию 9, завершение работы системы с параметром,
593
    чтобы форсировать выбор в меню выхода.
594
 
595
======================================================================
91 diamond 596
==== Функция 18, подфункция 2 - завершить процесс/поток по слоту. ====
77 diamond 597
======================================================================
598
Параметры:
599
  * eax = 18 - номер функции
600
  * ebx = 2 - номер подфункции
601
  * ecx = номер слота процесса/потока
602
Возвращаемое значение:
603
  * функция не возвращает значения
604
Замечания:
605
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
606
    1), можно завершить любой обычный поток/процесс.
91 diamond 607
  * Смотри также подфункцию 18 - завершение
608
    процесса/потока с заданным идентификатором.
77 diamond 609
 
610
======================================================================
611
= Функция 18, подфункция 3 - сделать активным окно заданного потока. =
612
======================================================================
613
Параметры:
614
  * eax = 18 - номер функции
615
  * ebx = 3 - номер подфункции
616
  * ecx = номер слота потока
617
Возвращаемое значение:
618
  * функция не возвращает значения
619
Замечания:
620
  * При указании корректного, но несуществующего слота активизируется
621
    какое-то окно.
622
  * Узнать, какое окно является активным, можно вызовом подфункции 7.
623
 
624
======================================================================
114 mikedld 625
 Функция 18, подфункция 4 - получить сч+тчик пустых тактов в секунду.
77 diamond 626
======================================================================
627
Под пустыми тактами понимается время, в которое процессор простаивает
628
в ожидании прерывания (в инструкции hlt).
629
 
630
Параметры:
631
  * eax = 18 - номер функции
632
  * ebx = 4 - номер подфункции
633
Возвращаемое значение:
114 mikedld 634
  * eax = значение сч+тчика пустых тактов в секунду
77 diamond 635
 
636
======================================================================
637
======== Функция 18, подфункция 5 - получить тактовую частоту. =======
638
======================================================================
639
Параметры:
640
  * eax = 18 - номер функции
641
  * ebx = 5 - номер подфункции
642
Возвращаемое значение:
643
  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)
644
 
645
======================================================================
114 mikedld 646
 Функция 18, подфункция 6 - сохранить рамдиск в файл на ж+стком диске.
77 diamond 647
======================================================================
648
Параметры:
649
  * eax = 18 - номер функции
650
  * ebx = 6 - номер подфункции
651
  * ecx определяет путь к файлу:
652
    * 1 = в папке "/KOLIBRI"
653
    * 2 = в корневом каталоге
654
    * 3 = edx указывает на путь (имена папок в формате 8+3,
114 mikedld 655
      раздел+нные '/')
77 diamond 656
Возвращаемое значение:
657
  * eax = 0 - успешно
658
  * иначе eax = код ошибки файловой системы
659
Замечания:
660
  * Имя файла фиксировано, "menuet.img" (глобальная переменная ядра
661
    image_save из preboot.inc)
114 mikedld 662
  * На каком разделе какого диска файл будет сохран+н, определяется
77 diamond 663
    подфункцией 7 и подфункцией 8 функции 21.
114 mikedld 664
  * Все папки в указанном пути должны существовать, иначе верн+тся
77 diamond 665
    значение 5, "файл не найден".
666
 
667
======================================================================
668
====== Функция 18, подфункция 7 - получить номер активного окна. =====
669
======================================================================
670
Параметры:
671
  * eax = 18 - номер функции
672
  * ebx = 7 - номер подфункции
673
Возвращаемое значение:
674
  * eax = номер активного окна (номер слота потока, окно которого
675
    активно)
676
Замечания:
677
  * Активное окно находится вверху оконного стэка и получает
114 mikedld 678
    сообщения обо вс+м вводе с клавиатуры.
77 diamond 679
  * Сделать окно активным можно вызовом подфункции 3.
680
 
681
======================================================================
682
==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====
683
======================================================================
114 mikedld 684
При отключ+нном звуке вызовы подфункции 55 функции 55 игнорируются.
685
При включ+нном - направляются на встроенный спикер.
77 diamond 686
 
687
--------------- Подподфункция 1 - получить состояние. ----------------
688
Параметры:
689
  * eax = 18 - номер функции
690
  * ebx = 8 - номер подфункции
691
  * ecx = 1 - номер подподфункции
692
Возвращаемое значение:
114 mikedld 693
  * eax = 0 - звук спикера разреш+н; 1 - запрещ+н
77 diamond 694
 
695
-------------- Подподфункция 2 - переключить состояние. --------------
696
Переключает состояния разрешения/запрещения.
697
Параметры:
698
  * eax = 18 - номер функции
699
  * ebx = 8 - номер подфункции
700
  * ecx = 2 - номер подподфункции
701
Возвращаемое значение:
702
  * функция не возвращает значения
703
 
704
======================================================================
705
= Функция 18, подфункция 9 - завершение работы системы с параметром. =
706
======================================================================
707
Параметры:
708
  * eax = 18 - номер функции
709
  * ebx = 9 - номер подфункции
710
  * ecx = параметр:
711
    * 1 = на последнем шаге завершения работы сохранить рамдиск на
712
      дискету, после чего вывести меню выхода и запросить у
713
      пользователя дальнейшие действия
714
    * 2 = выключить компьютер
715
    * 3 = перезагрузить компьютер
716
    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске
717
Возвращаемое значение:
718
  * при неверном ecx регистры не меняются (т.е. eax=18)
719
  * при правильном вызове всегда возвращается признак успеха eax=0
720
Замечания:
721
  * Не следует полагаться на возвращаемое значение при неверном
722
    вызове, оно может измениться в последующих версиях ядра.
723
  * Можно использовать подфункцию 1, чтобы на последнем шаге
724
    завершения работы пользователь сам решал, что ему нужно.
725
  * Не рекомендуется использовать значение ecx=1 (чтобы не раздражать
726
    пользователя излишними вопросами); сохранить рамдиск на дискету
727
    можно функцией 16 (которая допускает уточнение, на какую именно
728
    дискету писать), а завершить работу с меню выхода можно уже
729
    упомянутой подфункцией 1.
730
 
731
======================================================================
732
======== Функция 18, подфункция 10 - свернуть окно приложения. =======
733
======================================================================
734
Сворачивает собственное окно.
735
Параметры:
736
  * eax = 18 - номер функции
737
  * ebx = 10 - номер подфункции
738
Возвращаемое значение:
739
  * функция не возвращает значения
740
Замечания:
741
  * Минимизированное окно с точки зрения функции 9 сохраняет положение
742
    и размеры.
743
  * Восстановление окна приложения происходит при активизировании
744
    подфункцией 3.
114 mikedld 745
  * Обычно нет необходимости явно сворачивать/разворачивать сво+ окно:
77 diamond 746
    сворачивание окна осуществляется системой при нажатии на кнопку
747
    минимизации (которая для окон со скином определяется автоматически
114 mikedld 748
    функцией 0, для окон без скина е+ можно определить функцией 8),
77 diamond 749
    восстановление - приложением @panel.
750
 
751
======================================================================
752
====================== Функция 18, подфункция 11 =====================
753
============= Получить информацию о дисковой подсистеме. =============
754
======================================================================
755
Параметры:
756
  * eax = 18 - номер функции
757
  * ebx = 11 - номер подфункции
758
  * ecx = тип таблицы:
759
    * 1 = короткая версия, 10 байт
760
    * 2 = полная версия, 65536 байт
761
  * edx = указатель на буфер (в приложении) для таблицы
762
Возвращаемое значение:
763
  * функция не возвращает значения
764
Формат таблицы: короткая версия:
765
  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,
114 mikedld 766
    где AAAA зада+т тип первого дисковода, BBBB - второго согласно
77 diamond 767
    следующему списку:
768
    * 0 = нет дисковода
769
    * 1 = 360Kb, 5.25''
770
    * 2 = 1.2Mb, 5.25''
771
    * 3 = 720Kb, 3.5''
772
    * 4 = 1.44Mb, 3.5''
773
    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)
774
    Например, для стандартной конфигурации из одного 1.44-дисковода
775
    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:
776
    значение оказывается 24h.
114 mikedld 777
  * +1: byte: информация о ж+стких дисках и CD-приводах, AABBCCDD,
77 diamond 778
    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
779
    * 0 = устройство отсутствует
114 mikedld 780
    * 1 = ж+сткий диск
77 diamond 781
    * 2 = CD-привод
782
    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
114 mikedld 783
  * +2: 4 db: число найденных разделов на ж+стких дисках с
77 diamond 784
    соответственно IDE0,...,IDE3.
114 mikedld 785
    При отсутствии ж+сткого диска на IDEx соответствующий байт
77 diamond 786
    нулевой, при наличии показывает число распознанных разделов,
787
    которых может и не быть (если носитель не отформатирован или
788
    если файловая система не поддерживается). В текущей версии ядра
114 mikedld 789
    для ж+стких дисков поддерживаются только FAT16 и FAT32.
77 diamond 790
  * +6: 4 db: зарезервировано
791
Формат таблицы: полная версия:
792
  * +0: 10 db: такие же, как и в короткой версии
793
  * +10: 100 db: данные для первого раздела
794
  * +110: 100 db: данные для второго раздела
795
  * ...
796
  * +10+100*(n-1): 100 db: данные для последнего раздела
797
Разделы расположены в следующем порядке: сначала последовательно все
798
распознанные разделы на HD на IDE0 (если есть),
799
затем на HD на IDE1 (если есть) и т.д. до IDE3.
800
Формат информации о разделе (пока поддерживается только FAT):
801
  * +0: dword: начальный физический сектор раздела
802
  * +4: dword: последний физический сектор раздела
803
    (принадлежит разделу)
804
  * +8: dword: секторов в одной копии FAT
805
  * +12 = +0xC: dword: число копий FAT
806
  * +16 = +0x10: dword: число секторов в кластере
807
  * +20 = +0x14: dword: байт в секторе; текущая реализация ожидает,
808
    что здесь 0x200 = 512
809
  * +24 = +0x18: dword: первый кластер корневого каталога в FAT32,
810
 
811
  * +28 = +0x1C: dword: начальный физический сектор FAT
812
  * +32 = +0x20: dword: первый физический сектор корневого каталога
813
    для FAT16, игнорируется для FAT32
814
  * +36 = +0x24: dword: число секторов в корневом каталоге для FAT16,
815
 
816
  * +40 = +0x28: dword: физический сектор начала области данных
817
  * +44 = +0x2C: dword: максимальный номер кластера
818
  * +48 = +0x30: dword: физический сектор информации о
819
    файловой системе для FAT32, игнорируется для FAT16
820
  * +52 = +0x34: dword: значение, используемое как граница
821
    специальных значений в FAT
822
  * +56 = +0x38: dword: значение, используемое для плохих кластеров
823
    в FAT
824
  * +60 = +0x3C: dword: значение, используемое как маркер конца
825
    при записи цепочки в FAT
826
  * +64 = +0x40: dword: маска, накладываемая на элемент FAT
827
  * +68 = +0x44: byte: тип файловой системы: 16 или 32
828
  * +69 = +0x45: 31 db: зарезервировано
829
Замечания:
830
  * Короткая таблица может быть использована для получения информации
831
    об имеющихся устройствах.
832
  * Первые два поля информации о разделе в полной версии таблицы
833
    сообщают параметры раздела, оставшиеся - параметры файловой
834
    системы FAT. Для других файловых систем (когда они будут
835
    поддерживаться) специфическая для файловой системы информация,
836
    естественно, будет другой, но первые два поля
837
    сохранятся неизменными.
838
 
839
======================================================================
840
========== Функция 18, подфункция 13 - получить версию ядра. =========
841
======================================================================
842
Параметры:
843
  * eax = 18 - номер функции
844
  * ebx = 13 - номер подфункции
845
  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена
846
    информация
847
Возвращаемое значение:
848
  * функция не возвращает значения
849
Структура буфера:
850
db a,b,c,d для версии a.b.c.d
851
db UID_xxx: одно из UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
852
db 'name',0 - ASCIIZ-строка с именем
853
Для ядра Kolibri 0.5.3.1:
854
db 0,5,3,1
855
db 2
856
db 'Kolibri',0
857
 
858
======================================================================
859
====================== Функция 18, подфункция 14 =====================
114 mikedld 860
======= Ожидать начала обратного хода луча разв+ртки монитора. =======
77 diamond 861
======================================================================
862
Параметры:
863
  * eax = 18 - номер функции
864
  * ebx = 14 - номер подфункции
865
Возвращаемое значение:
866
  * eax = 0 как признак успеха
867
Замечания:
868
  * Функция предназначена исключительно для активных
869
    высокопроизводительных графических приложений; используется для
870
    плавного вывода графики.
871
 
872
======================================================================
873
== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =
874
======================================================================
875
Параметры:
876
  * eax = 18 - номер функции
877
  * ebx = 15 - номер подфункции
878
Возвращаемое значение:
879
  * eax = 0 как признак успеха
880
 
881
======================================================================
882
====================== Функция 18, подфункция 16 =====================
883
============ Получить размер свободной оперативной памяти. ===========
884
======================================================================
885
Параметры:
886
  * eax = 18 - номер функции
887
  * ebx = 16 - номер подфункции
888
Возвращаемое значение:
889
  * eax = размер свободной памяти в килобайтах
890
 
891
======================================================================
892
====================== Функция 18, подфункция 17 =====================
893
============ Получить размер имеющейся оперативной памяти. ===========
894
======================================================================
895
Параметры:
896
  * eax = 18 - номер функции
897
  * ebx = 17 - номер подфункции
898
Возвращаемое значение:
899
  * eax = общий размер имеющейся памяти в килобайтах
900
 
901
======================================================================
91 diamond 902
====================== Функция 18, подфункция 18 =====================
903
============= Завершить процесс/поток по идентификатору. =============
85 halyavin 904
======================================================================
905
Параметры:
906
  * eax = 18 - номер функции
907
  * ebx = 18 - номер подфункции
91 diamond 908
  * ecx = идентификатор процесса/потока (PID/TID)
909
Возвращаемое значение:
910
  * eax = 0 - успешно
911
  * eax = -1 - ошибка (процесс не найден или является системным)
912
Замечания:
913
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
914
    1), можно завершить любой обычный поток/процесс.
915
  * Смотри также подфункцию 2 - завершение
916
    процесса/потока по заданному слоту.
85 halyavin 917
 
918
======================================================================
77 diamond 919
============ Функция 19 - запустить программу с рамдиска. ============
920
======================================================================
921
Параметры:
922
  * eax = 19 - номер функции
923
  * ebx = указатель на имя программы в формате, аналогичном функции 6
924
  * ecx = 0 или ecx = указатель на параметры командной строки
925
Возвращаемое значение:
926
  * Если eax > 0, то eax содержит PID созданного процесса
927
  * Если eax < 0, то -eax - код ошибки файловой системы
928
Замечания:
91 diamond 929
  * Эта функция устарела; используйте подфункцию 7 функции 70.
114 mikedld 930
  * Командная строка должна заканчиваться символом с кодом 0
77 diamond 931
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
932
    включительно, либо первые 256 символов, в зависимости от того,
933
    что меньше.
934
 
935
======================================================================
936
==================== Функция 20 - интерфейс MIDI. ====================
937
======================================================================
938
 
939
------------------------ Подфункция 1 - сброс ------------------------
940
Параметры:
941
  * eax = 20 - номер функции
942
  * ebx = 1 - номер подфункции
943
 
944
-------------------- Подфункция 2 - вывести байт ---------------------
945
Параметры:
946
  * eax = 20 - номер функции
947
  * ebx = 2 - номер подфункции
948
  * cl = байт для вывода
949
Возвращаемое значение (одинаково для обеих подфункций):
950
  * eax = 0 - успешно
114 mikedld 951
  * eax = 1 - не определ+н базовый порт
77 diamond 952
Замечания:
114 mikedld 953
  * Предварительно должен быть определ+н базовый порт вызовом
77 diamond 954
    подфункции 1 функции 21.
955
 
956
======================================================================
957
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
958
======================================================================
959
Параметры:
960
  * eax = 21 - номер функции
961
  * ebx = 1 - номер подфункции
962
  * ecx = номер базового порта
963
Возвращаемое значение:
964
  * eax = 0 - успешно
965
  * eax = -1 - ошибочный номер порта
966
Замечания:
967
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
968
  * Установка базы нужна для работы функции 20.
969
  * Получить установленный базовый порт можно вызовом
970
    подфункции 1 функции 26.
971
 
972
======================================================================
973
===== Функция 21, подфункция 2 - установить раскладку клавиатуры. ====
974
======================================================================
975
Раскладка клавиатуры используется для преобразования сканкодов,
976
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
977
Параметры:
978
  * eax = 21 - номер функции
979
  * ebx = 2 - номер подфункции
980
  * ecx = какую раскладку устанавливать:
981
    * 1 = нормальную
982
    * 2 = раскладку при нажатом Shift
983
    * 3 = раскладку при нажатом Alt
984
  * edx = указатель на раскладку - таблицу длиной 128 байт
985
Или:
986
  * ecx = 9
987
  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
988
Возвращаемое значение:
989
  * eax = 0 - успешно
990
  * eax = 1 - параметр задан неверно
991
Замечания:
992
  * Если нажат Alt, то используется раскладка с Alt;
993
    если не нажат Alt, но нажат Shift, то
994
    используется раскладка с Shift;
995
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
996
    нормальная раскладка, после чего из кода вычитается 0x60;
997
    если не нажата ни одна из управляющих клавиш, то используется
998
    нормальная раскладка.
999
  * Получить раскладки и идентификатор страны можно с помощью
1000
    подфункции 2 функции 26.
1001
  * Идентификатор страны - глобальная системная переменная, которая
1002
    самим ядром не используется; однако приложение @panel отображает
1003
    соответствующую текущей стране иконку.
1004
  * Приложение @panel переключает раскладки по запросу пользователя.
1005
 
1006
======================================================================
1007
=========== Функция 21, подфункция 3 - установить базу CD. ===========
1008
======================================================================
1009
Параметры:
1010
  * eax = 21 - номер функции
1011
  * ebx = 3 - номер подфункции
1012
  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1013
Возвращаемое значение:
1014
  * eax = 0
1015
Замечания:
1016
  * База CD используется функцией 24.
1017
  * Получить установленную базу CD можно вызовом
1018
    подфункции 3 функции 26.
1019
 
1020
======================================================================
1021
== Функция 21, подфункция 4 - установить базовый порт Sound Blaster. =
1022
======================================================================
1023
Параметры:
1024
  * eax = 21 - номер функции
1025
  * ebx = 4 - номер подфункции
1026
  * ecx = номер базового порта
1027
Возвращаемое значение:
1028
  * eax = 0 - успешно
1029
  * eax = -1 - ошибочный номер порта
1030
Замечания:
1031
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1032
  * Установка базы нужна для работы функций 25, 28, 55.
1033
  * Получить установленный базовый порт можно вызовом
1034
    подфункции 4 функции 26.
1035
 
1036
======================================================================
1037
========= Функция 21, подфункция 5 - установить язык системы. ========
1038
======================================================================
1039
Параметры:
1040
  * eax = 21 - номер функции
1041
  * ebx = 5 - номер подфункции
1042
  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1043
Возвращаемое значение:
1044
  * eax = 0
1045
Замечания:
1046
  * Язык системы - глобальная системная переменная, никак
1047
    не используемая самим ядром, однако приложение @panel рисует
1048
    соответствующую иконку.
1049
  * Проверок на корректность не делается, поскольку ядро эту
1050
    переменную не использует.
1051
  * Получить язык системы можно вызовом подфункции 5 функции 26.
1052
 
1053
======================================================================
1054
======= Функция 21, подфункция 6 - установить базовый порт WSS. ======
1055
======================================================================
1056
Параметры:
1057
  * eax = 21 - номер функции
1058
  * ebx = 6 - номер подфункции
1059
  * ecx = базовый порт
1060
Возвращаемое значение:
1061
  * eax = 0 - успешно
1062
  * eax = -1 - ошибочный номер порта
1063
Замечания:
1064
  * Номер порта должен удовлетворять условию 0x100<=ecx.
1065
  * База WSS используется функцией 27.
1066
  * Получить установленный базовый порт WSS можно вызовом
1067
    подфункции 6 функции 26.
1068
 
1069
======================================================================
1070
=========== Функция 21, подфункция 7 - установить базу HD. ===========
1071
======================================================================
114 mikedld 1072
База HD нужна для определения, на какой ж+сткий диск писать, при
77 diamond 1073
использовании устаревших функций работы с файловой системой и функций,
114 mikedld 1074
неявно использующих ж+сткий диск (типа подфункции 6 функции 18);
77 diamond 1075
при использовании функций 58 и 70 и современного синтаксиса
1076
/HD0,/HD1,/HD2,/HD3 эти функции сами устанавливают базу.
1077
Параметры:
1078
  * eax = 21 - номер функции
1079
  * ebx = 7 - номер подфункции
1080
  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1081
Возвращаемое значение:
1082
  * eax = 0
1083
Замечания:
1084
  * Любое приложение в любой момент времени может изменить базу.
1085
  * Не следует изменять базу, когда какое-нибудь приложение работает
114 mikedld 1086
    с ж+стким диском. Если не хотите глюков системы.
77 diamond 1087
  * Получить установленную базу можно вызовом подфункции 7 функции 26.
114 mikedld 1088
  * Следует также определить используемый раздел ж+сткого диска
77 diamond 1089
    подфункцией 8.
1090
 
1091
======================================================================
1092
========== Функция 21, подфункция 8 - установить раздел HD. ==========
1093
======================================================================
114 mikedld 1094
Раздел HD нужен для определения, на какой раздел ж+сткого диска
77 diamond 1095
писать, при использовании устаревших функций работы с файловой
114 mikedld 1096
системой и функций, неявно использующих ж+сткий диск (типа
77 diamond 1097
подфункции 6 функции 18); при использовании функций 58 и 70
1098
и современного синтаксиса /HD0,/HD1,/HD2,/HD3 эти функции сами
1099
устанавливают базу и раздел.
1100
Параметры:
1101
  * eax = 21 - номер функции
1102
  * ebx = 8 - номер подфункции
1103
  * ecx = раздел HD (считая с 1)
1104
Возвращаемое значение:
1105
  * eax = 0
1106
Замечания:
1107
  * Любое приложение в любой момент времени может изменить раздел.
1108
  * Не следует изменять раздел, когда какое-нибудь приложение работает
114 mikedld 1109
    с ж+стким диском. Если не хотите глюков системы.
77 diamond 1110
  * Получить установленный раздел можно вызовом подфункции 8
1111
    функции 26.
1112
  * Проверок на корректность не делается.
114 mikedld 1113
  * Узнать число разделов на ж+стком диске можно вызовом
77 diamond 1114
    подфункции 11 функции 18.
114 mikedld 1115
  * Следует также определить используемую базу ж+сткого диска
77 diamond 1116
    подфункцией 7.
1117
 
1118
======================================================================
1119
===== Функция 21, подфункция 10 - установить канал DMA для звука. ====
1120
======================================================================
1121
Параметры:
1122
  * eax = 21 - номер функции
1123
  * ebx = 10 - номер подфункции
1124
  * ecx = номер канала (от 0 до 3 включительно)
1125
Возвращаемое значение:
1126
  * eax = 0 - успешно
1127
  * eax = -1 - неверный номер канала
1128
Замечания:
1129
  * Номер канала DMA используется в
1130
    подфункции 1 функции 55.
1131
  * Получить канал DMA для звука можно вызовом
1132
    подфункции 10 функции 26.
1133
 
1134
======================================================================
1135
====================== Функция 21, подфункция 11 =====================
1136
=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
1137
======================================================================
1138
Параметры:
1139
  * eax = 21 - номер функции
1140
  * ebx = 11 - номер подфункции
1141
  * ecx = 0/1 - запретить/разрешить
1142
Возвращаемое значение:
1143
  * eax = 0
1144
Замечания:
1145
  * Используется при LBA-чтении (подфункция 8 функции 58).
1146
  * Текущая реализация использует только младший бит ecx.
1147
  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
1148
 
1149
======================================================================
1150
====================== Функция 21, подфункция 12 =====================
1151
========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
1152
======================================================================
1153
Параметры:
1154
  * eax = 21 - номер функции
1155
  * ebx = 12 - номер подфункции
1156
  * ecx = 0/1 - запретить/разрешить
1157
Возвращаемое значение:
1158
  * eax = 0
1159
Замечания:
1160
  * Используется при работе с шиной PCI (функция 62).
1161
  * Текущая реализация использует только младший бит ecx.
1162
  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
1163
 
1164
======================================================================
1165
============= Функция 21, подфункция 13, подподфункция 1 =============
1166
==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
1167
======================================================================
1168
Параметры:
1169
  * eax = 21 - номер функции
1170
  * ebx = 13 - номер подфункции
1171
  * ecx = 1 - номер функции драйвера
1172
  * edx = указатель на буфер размера 512 байт
1173
Возвращаемое значение:
1174
  * если драйвер не загружен (никогда не бывает в текущей реализации):
1175
    * eax = -1
1176
    * ebx, ecx разрушаются
1177
  * если драйвер загружен:
1178
    * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт,
1179
      'Z' - старший) - сигнатура
114 mikedld 1180
    * ebx = текущая частота разв+ртки (в Гц)
77 diamond 1181
    * ecx разрушается
1182
    * буфер, на который указывает edx, заполнен
1183
Формат буфера:
1184
  * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек,
1185
    дополнено пробелами)
1186
  * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как
1187
    y*65536+x), для текущей реализации 1 (1.0)
1188
  * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
1189
  * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое
1190
    слово - номер видеорежима, после собственно списка идут нули)
114 mikedld 1191
  * +128 = +0x80: 32*(5*word): список поддерживаемых частот разв+рток
77 diamond 1192
    для видеорежимов: для каждого видеорежима, указанного в предыдущем
1193
    поле, указано до 5 поддерживаемых частот
1194
    (в неиспользуемых позициях записаны нули)
1195
Замечания:
114 mikedld 1196
  * Функция инициализирует драйвер (если он ещ+ не инициализирован)
77 diamond 1197
    и должна вызываться первой, перед остальными (иначе они будут
1198
    возвращать -1, ничего не делая).
114 mikedld 1199
  * В текущей реализации поддерживается только одна частота разв+ртки
77 diamond 1200
    на видеорежим.
1201
 
1202
======================================================================
1203
============= Функция 21, подфункция 13, подподфункция 2 =============
1204
============= Получить информацию о текущем видеорежиме. =============
1205
======================================================================
1206
Параметры:
1207
  * eax = 21 - номер функции
1208
  * ebx = 13 - номер подфункции
1209
  * ecx = 2 - номер функции драйвера
1210
Возвращаемое значение:
1211
  * eax = -1 - драйвер не загружен или не инициализирован;
1212
    ebx,ecx разрушаются
1213
  * eax = [ширина]*65536 + [высота]
114 mikedld 1214
  * ebx = частота вертикальной разв+ртки (в Гц)
77 diamond 1215
  * ecx = номер текущего видеорежима
1216
Замечания:
1217
  * Драйвер предварительно должен быть инициализирован вызовом
1218
    функции драйвера 1.
1219
  * Если нужны только размеры экрана, целесообразней использовать
114 mikedld 1220
    функцию 14 с уч+том того, что она возвращает размеры на 1 меньше.
77 diamond 1221
 
1222
======================================================================
1223
= Функция 21, подфункция 13, подподфункция 3 - установить видеорежим.
1224
======================================================================
1225
Параметры:
1226
  * eax = 21 - номер функции
1227
  * ebx = 13 - номер подфункции
1228
  * ecx = 3 - номер функции драйвера
114 mikedld 1229
  * edx = [частота разв+ртки]*65536 + [номер видеорежима]
77 diamond 1230
Возвращаемое значение:
1231
  * eax = -1 - драйвер не загружен, не инициализирован или
1232
    произошла ошибка
1233
  * eax = 0 - успешно
1234
  * ebx, ecx разрушаются
1235
Замечания:
1236
  * Драйвер предварительно должен быть инициализирован вызовом
1237
    функции драйвера 1.
1238
  * Номер видеорежима и частота должны быть в таблице, возвращаемой
1239
    функцией драйвера 1.
1240
 
1241
======================================================================
1242
============= Функция 21, подфункция 13, подподфункция 4 =============
1243
================= Вернуться к начальному видеорежиму. ================
1244
======================================================================
1245
Возвращает экран в видеорежим, установленный при загрузке системы.
1246
Параметры:
1247
  * eax = 21 - номер функции
1248
  * ebx = 13 - номер подфункции
1249
  * ecx = 4 - номер функции драйвера
1250
Возвращаемое значение:
1251
  * eax = -1 - драйвер не загружен или не инициализирован
1252
  * eax = 0 - успешно
1253
  * ebx, ecx разрушаются
1254
Замечания:
1255
  * Драйвер предварительно должен быть инициализирован вызовом
1256
    функции драйвера 1.
1257
 
1258
======================================================================
1259
============= Функция 21, подфункция 13, подподфункция 5 =============
1260
======== Увеличить/уменьшить размер видимой области монитора. ========
1261
======================================================================
1262
Параметры:
1263
  * eax = 21 - номер функции
1264
  * ebx = 13 - номер подфункции
1265
  * ecx = 5 - номер функции драйвера
1266
  * edx = 0/1 - уменьшить/увеличить размер по горизонтали
1267
    на одну позицию
1268
  * edx = 2/3 - в текущей реализации не поддерживается; планируется
1269
    как уменьшение/увеличение размера по вертикали на одну позицию
1270
Возвращаемое значение:
1271
  * eax = -1 - драйвер не загружен или не инициализирован
1272
  * eax = 0 - успешно
1273
  * ebx, ecx разрушаются
1274
Замечания:
1275
  * Драйвер предварительно должен быть инициализирован вызовом
1276
    функции драйвера 1.
1277
  * Функция влияет только на физический размер изображения
1278
    на мониторе; логический размер (число пикселей) не меняется.
1279
 
1280
======================================================================
1281
============ Функция 22 - установить системную дату/время. ===========
1282
======================================================================
1283
Параметры:
1284
  * eax = 22 - номер функции
1285
  * ebx = 0 - установить время
1286
    * ecx = 0x00SSMMHH - время в двоично-десятичном коде (BCD):
1287
    * HH=час 00..23
1288
    * MM=минута 00..59
1289
    * SS=секунда 00..59
1290
  * ebx = 1 - установить дату
1291
    * ecx = 0x00DDMMYY - дата в двоично-десятичном коде (BCD):
1292
    * DD=день 01..31
1293
    * MM=месяц 01..12
1294
    * YY=год 00..99
1295
  * ebx = 2 - установить день недели
1296
    * ecx = 1 для воскресенья, ..., 7 для субботы
1297
  * ebx = 3 - установить будильник
1298
    * ecx = 0x00SSMMHH
1299
Возвращаемое значение:
1300
  * eax = 0 - успешно
1301
  * eax = 1 - параметр задан неверно
1302
  * eax = 2 - CMOS-батарейки разрядились
1303
Замечания:
1304
  * Ценность установки дня недели представляется сомнительной,
1305
    поскольку он мало где используется
1306
    (день недели можно рассчитать по дате).
1307
  * Будильник можно установить на срабатывание в заданное время
1308
    каждые сутки. При этом отключить его существующими системными
1309
    функциями нельзя.
1310
  * Срабатывание будильника заключается в генерации IRQ8.
1311
  * Вообще-то CMOS поддерживает для будильника установку значения
1312
    0xFF в качестве одного из параметров и означает это, что
1313
    соответствующий параметр игнорируется. Но в текущей реализации
114 mikedld 1314
    это не пройд+т (верн+тся значение 1).
77 diamond 1315
  * Будильник - глобальный системный ресурс; установка будильника
1316
    автоматически отменяет предыдущую установку. Впрочем, на данный
1317
    момент ни одна программа его не использует.
1318
 
1319
======================================================================
1320
============== Функция 23 - ожидать события с таймаутом. =============
1321
======================================================================
114 mikedld 1322
Если очередь сообщений пуста, жд+т появления сообщения в очереди,
77 diamond 1323
но не более указанного времени. Затем считывает сообщение из очереди.
1324
 
1325
Параметры:
1326
  * eax = 23 - номер функции
1327
  * ebx = таймаут (в сотых долях секунды)
1328
Возвращаемое значение:
1329
  * eax = 0 - очередь сообщений пуста
1330
  * иначе eax = событие (смотри список событий)
1331
Замечания:
1332
  * Учитываются только те события, которые входят в маску,
1333
    устанавливаемую функцией 40. По умолчанию это события
1334
    перерисовки, нажатия на клавиши и на кнопки.
1335
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
1336
    Чтобы ждать сколь угодно долго, используйте функцию 10.
1337
  * Передача ebx=0 приводит к моментальному возвращению eax=0.
114 mikedld 1338
  * При текущей реализации произойд+т немедленный возврат из функции
1339
    с eax=0, если сложение ebx с текущим значением сч+тчика времени
77 diamond 1340
    вызовет 32-битное переполнение.
1341
 
1342
======================================================================
1343
======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ======
1344
======================================================================
1345
Параметры:
1346
  * eax = 24 - номер функции
1347
  * ebx = 1 - номер подфункции
1348
  * ecx = 0x00FRSSMM, где
1349
    * MM = начальная минута
1350
    * SS = начальная секунда
1351
    * FR = начальный фрейм
1352
Возвращаемое значение:
1353
  * eax = 0 - успешно
1354
  * eax = 1 - не определена база CD
1355
Замечания:
1356
  * Предварительно нужно определить базовый порт CD вызовом
1357
    подфункции 3 функции 21.
1358
  * В секунде 75 фреймов, в минуте 60 секунд.
1359
  * Функция асинхронна (возвращает управление, когда началось
1360
    проигрывание).
1361
 
1362
======================================================================
1363
===== Функция 24, подфункция 2 - получить информацию о дорожках. =====
1364
======================================================================
1365
Параметры:
1366
  * eax = 24 - номер функции
1367
  * ebx = 2 - номер подфункции
1368
  * ecx = указатель на буфер для таблицы
1369
    (максимум 8*64h+4 байт=100 дорожек)
1370
Возвращаемое значение:
1371
  * eax = 0 - успешно
1372
  * eax = 1 - не определена база CD
1373
Замечания:
1374
  * Формат таблицы с информацией о дорожках такой же, как и для
1375
    ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h).
1376
    Адреса возвращаются в формате MSF.
1377
  * Предварительно нужно определить базовый порт CD вызовом
1378
    подфункции 3 функции 21.
1379
  * Функция возвращает информацию только о не более чем 100
1380
    первых дорожках. В большинстве случаев этого достаточно.
1381
 
1382
======================================================================
1383
==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. ===
1384
======================================================================
1385
Параметры:
1386
  * eax = 24 - номер функции
1387
  * ebx = 1 - номер подфункции
1388
Возвращаемое значение:
1389
  * eax = 0 - успешно
1390
  * eax = 1 - не определена база CD
1391
Замечания:
1392
  * Предварительно нужно определить базовый порт CD вызовом
1393
    подфункции 3 функции 21.
1394
 
1395
======================================================================
1396
============== Функция 25 - установить громкость SBPro. ==============
1397
======================================================================
1398
Параметры:
1399
  * eax = 25 - номер функции
1400
  * ebx = что устанавливать:
1401
    * 1 - установить общую громкость
1402
    * 2 - установить громкость CD-audio
1403
  * cl = уровень громкости: старшие 4 бита для левой колонки,
1404
    младшие 4 - для правой
1405
Возвращаемое значение:
1406
  * eax = 0 - успешно
1407
  * eax = 1 - не определена база SB
1408
  * eax = 2 - неверная подфункция
1409
Замечания:
1410
  * Предварительно нужно определить базовый порт SB вызовом
1411
    подфункции 4 функции 21.
1412
  * Смотри также функцию 28
1413
    установки звука для более позднего стандарта SB16.
1414
 
1415
======================================================================
1416
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
1417
======================================================================
1418
Параметры:
1419
  * eax = 26 - номер функции
1420
  * ebx = 1 - номер подфункции
1421
Возвращаемое значение:
1422
  * eax = номер порта
1423
Замечания:
1424
  * Установить базовый порт можно вызовом
1425
    подфункции 1 функции 21.
1426
 
1427
======================================================================
1428
====== Функция 26, подфункция 2 - получить раскладку клавиатуры. =====
1429
======================================================================
1430
Раскладка клавиатуры используется для преобразования сканкодов,
1431
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1432
Параметры:
1433
  * eax = 26 - номер функции
1434
  * ebx = 2 - номер подфункции
1435
  * ecx = какую раскладку получать:
1436
    * 1 = нормальную
1437
    * 2 = раскладку при нажатом Shift
1438
    * 3 = раскладку при нажатом Alt
1439
  * edx = указатель на буфер длиной 128 байт, куда будет скопирована
1440
    раскладка
1441
Возвращаемое значение:
1442
  * функция не возвращает значения
1443
Или:
1444
  * eax = 26 - номер функции
1445
  * ebx = 2 - номер подфункции
1446
  * ecx = 9
1447
Возвращаемое значение:
1448
  * eax = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1449
Замечания:
1450
  * Если нажат Alt, то используется раскладка с Alt;
1451
    если не нажат Alt, но нажат Shift, то используется
1452
    раскладка с Shift;
1453
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1454
    нормальная раскладка, после чего из кода вычитается 0x60;
1455
    если не нажата ни одна из управляющих клавиш, то используется
1456
    нормальная раскладка.
1457
  * Установить раскладки и идентификатор страны можно с помощью
1458
    подфункции 2 функции 21.
1459
  * Идентификатор страны - глобальная системная переменная, которая
1460
    самим ядром не используется; однако приложение @panel отображает
1461
    соответствующую текущей стране иконку
1462
    (используя описываемую функцию).
1463
  * Приложение @panel переключает раскладки по запросу пользователя.
1464
 
1465
======================================================================
1466
============ Функция 26, подфункция 3 - получить базу CD. ============
1467
======================================================================
1468
Параметры:
1469
  * eax = 26 - номер функции
1470
  * ebx = 3 - номер подфункции
1471
Возвращаемое значение:
1472
  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1473
Замечания:
1474
  * База CD используется функцией 24.
114 mikedld 1475
  * Установить базу CD можно вызовом подфункции 3 функции 21.
77 diamond 1476
 
1477
======================================================================
1478
=== Функция 26, подфункция 4 - получить базовый порт Sound Blaster. ==
1479
======================================================================
1480
Параметры:
1481
  * eax = 26 - номер функции
1482
  * ebx = 4 - номер подфункции
1483
Возвращаемое значение:
1484
  * eax = номер базового порта
1485
Замечания:
1486
  * Установка базы нужна для работы функций 25, 55.
1487
  * Установить базовый порт можно вызовом подфункции 4 функции 21.
1488
 
1489
======================================================================
1490
========== Функция 26, подфункция 5 - получить язык системы. =========
1491
======================================================================
1492
Параметры:
1493
  * eax = 26 - номер функции
1494
  * ebx = 5 - номер подфункции
1495
Возвращаемое значение:
1496
  * eax = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1497
Замечания:
1498
  * Язык системы - глобальная системная переменная, никак
1499
    не используемая самим ядром, однако приложение @panel рисует
1500
    соответствующую иконку (используя описываемую функцию).
1501
  * Установить язык системы можно вызовом подфункции 5 функции 21.
1502
 
1503
======================================================================
1504
======== Функция 26, подфункция 6 - получить базовый порт WSS. =======
1505
======================================================================
1506
Параметры:
1507
  * eax = 26 - номер функции
1508
  * ebx = 6 - номер подфункции
1509
Возвращаемое значение:
1510
  * eax = базовый порт
1511
Замечания:
1512
  * База WSS используется функцией 27.
1513
  * Установить базовый порт WSS можно вызовом подфункции 6 функции 21.
1514
 
1515
======================================================================
1516
============ Функция 26, подфункция 7 - получить базу HD. ============
1517
======================================================================
114 mikedld 1518
База HD нужна для определения, на какой ж+сткий диск писать, при
77 diamond 1519
использовании устаревших функций работы с файловой системой и функций,
114 mikedld 1520
неявно использующих ж+сткий диск (типа подфункции 6 функции 18);
77 diamond 1521
при использовании функций 58 и 70 и современного синтаксиса
1522
/HD0,/HD1,/HD2,/HD3 эти функции сами устанавливают базу.
1523
Параметры:
1524
  * eax = 26 - номер функции
1525
  * ebx = 7 - номер подфункции
1526
Возвращаемое значение:
1527
  * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1528
Замечания:
1529
  * Любое приложение в любой момент времени может изменить базу.
1530
  * Установить базу можно вызовом подфункции 7 функции 21.
114 mikedld 1531
  * Получить используемый раздел ж+сткого диска можно подфункцией 8.
77 diamond 1532
 
1533
======================================================================
1534
=========== Функция 26, подфункция 8 - получить раздел HD. ===========
1535
======================================================================
114 mikedld 1536
Раздел HD нужен для определения, на какой раздел ж+сткого диска
77 diamond 1537
писать, при использовании устаревших функций работы с файловой
114 mikedld 1538
системой и функций, неявно использующих ж+сткий диск (типа
77 diamond 1539
подфункции 6 функции 18); при использовании функций 58 и 70 и
1540
современного синтаксиса /HD0,/HD1,/HD2,/HD3 эти функции сами
1541
устанавливают базу и раздел.
1542
Параметры:
1543
  * eax = 26 - номер функции
1544
  * ebx = 8 - номер подфункции
1545
Возвращаемое значение:
1546
  * eax = раздел HD (считая с 1)
1547
Замечания:
1548
  * Любое приложение в любой момент времени может изменить раздел.
1549
  * Установить раздел можно вызовом подфункции 8 функции 21.
114 mikedld 1550
  * Узнать число разделов на ж+стком диске можно вызовом
77 diamond 1551
    подфункции 11 функции 18.
114 mikedld 1552
  * Получить используемую базу ж+сткого диска можно подфункцией 7.
77 diamond 1553
 
1554
======================================================================
114 mikedld 1555
=== Функция 26, подфункция 9 - получить значение сч+тчика времени. ===
77 diamond 1556
======================================================================
1557
Параметры:
1558
  * eax = 26 - номер функции
1559
  * ebx = 9 - номер подфункции
1560
Возвращаемое значение:
1561
  * eax = число сотых долей секунды, прошедших с момента
1562
    запуска системы
1563
Замечания:
114 mikedld 1564
  * Сч+тчик бер+тся по модулю 2^32, что соответствует немногим более
77 diamond 1565
    497 суток.
1566
  * Системное время можно получить функцией 3.
1567
 
1568
======================================================================
1569
====== Функция 26, подфункция 10 - получить канал DMA для звука. =====
1570
======================================================================
1571
Параметры:
1572
  * eax = 26 - номер функции
1573
  * ebx = 10 - номер подфункции
1574
Возвращаемое значение:
1575
  * eax = номер канала (от 0 до 3 включительно)
1576
Замечания:
1577
  * Номер канала DMA используется в подфункции 1 функции 55.
1578
  * Установить канал DMA для звука можно вызовом
1579
    подфункции 10 функции 21.
1580
 
1581
======================================================================
1582
====================== Функция 26, подфункция 11 =====================
114 mikedld 1583
=========== Узнать, разреш+н ли низкоуровневый доступ к HD. ==========
77 diamond 1584
======================================================================
1585
Параметры:
1586
  * eax = 26 - номер функции
1587
  * ebx = 11 - номер подфункции
1588
Возвращаемое значение:
114 mikedld 1589
  * eax = 0/1 - запрещ+н/разреш+н
77 diamond 1590
Замечания:
1591
  * Используется при LBA-чтении (подфункция 8 функции 58).
1592
  * Установить текущее состояние можно вызовом
1593
    подфункции 11 функции 21.
1594
 
1595
======================================================================
1596
====================== Функция 26, подфункция 12 =====================
114 mikedld 1597
========== Узнать, разреш+н ли низкоуровневый доступ к PCI. ==========
77 diamond 1598
======================================================================
1599
Параметры:
1600
  * eax = 26 - номер функции
1601
  * ebx = 12 - номер подфункции
1602
Возвращаемое значение:
114 mikedld 1603
  * eax = 0/1 - запрещ+н/разреш+н
77 diamond 1604
Замечания:
1605
  * Используется при работе с шиной PCI (функция 62).
1606
  * Текущая реализация использует только младший бит ecx.
1607
  * Установить текущее состояние можно вызовом
1608
    подфункции 12 функции 21.
1609
 
1610
======================================================================
1611
==== Функция 27 - установить громкость Windows Sound System (WSS). ===
1612
======================================================================
1613
Параметры:
1614
  * eax = 27 - номер функции
1615
  * ebx = что устанавливать:
1616
    * 1 - установить общую громкость
1617
    * 2 - установить громкость Line In
1618
  * cl = уровень громкости (0x0=самый высокий, 0x1F=самый низкий,
1619
    установленный бит 0x80=отключить)
1620
Возвращаемое значение:
1621
  * eax = 0 - успешно
1622
  * eax = 1 - не определена база WSS
1623
  * eax = 2 - неверная подфункция
1624
Замечания:
1625
  * Предварительно нужно определить базовый порт WSS вызовом
1626
    подфункции 6 функции 21.
1627
  * Установка общей громкости фактически игнорируется
1628
    (возвращается eax=0).
1629
  * В старой документации и в исходниках ядра подфункция 2
1630
    ошибочно названа громкостью CD-audio.
1631
 
1632
======================================================================
1633
=============== Функция 28 - установить громкость SB16. ==============
1634
======================================================================
1635
Параметры:
1636
  * eax = 28 - номер функции
1637
  * ebx = что устанавливать:
1638
    * 1 - установить общую громкость
1639
    * 2 - установить громкость CD-audio
1640
  * cl = уровень громкости (0=off, 0xFF=max)
1641
Возвращаемое значение:
1642
  * eax = 0 - успешно
1643
  * eax = 1 - не определена база SB
1644
  * eax = 2 - неверная подфункция
1645
Замечания:
1646
  * Предварительно нужно определить базовый порт SB вызовом
1647
    подфункции 4 функции 21.
1648
  * Эта функция предоставляет больше вариантов для громкости,
1649
    чем функция 25.
1650
 
1651
======================================================================
1652
================ Функция 29 - получить системную дату. ===============
1653
======================================================================
1654
Параметры:
1655
  * eax = 29 - номер функции
1656
Возвращаемое значение:
1657
  * eax = 0x00DDMMYY, где
1658
    (используется двоично-десятичное кодирование, BCD)
1659
  * YY = две младшие цифры года (00..99)
1660
  * MM = месяц (01..12)
1661
  * DD = день (01..31)
1662
Замечания:
1663
  * Системную дату можно установить функцией 22.
1664
 
1665
======================================================================
1666
================ Функция 32 - удалить файл с рамдиска. ===============
1667
======================================================================
1668
Параметры:
1669
  * eax = 32 - номер функции
1670
  * ebx = указатель на имя файла
1671
Возвращаемое значение:
1672
  * eax = 0 - успешно; иначе код ошибки файловой системы
1673
Замечания:
1674
  * Эта функция устарела; функция 58 позволяет выполнять
1675
    те же действия с расширенными возможностями.
1676
  * Текущая реализация возвращает только значения 0(успех) и
1677
    5(файл не найден).
1678
  * Имя файла должно быть либо в формате 8+3 символов (первые
1679
    8 символов - собственно имя, последние 3 - расширение,
1680
    короткие имена и расширения дополняются пробелами),
1681
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1682
    (имя не более 8 символов, точка, расширение 3 символа,
1683
    дополненное при необходимости пробелами).
1684
    Имя файла должно быть записано заглавными буквами.
1685
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
1686
 
1687
======================================================================
1688
=============== Функция 33 - записать файл на рамдиск. ===============
1689
======================================================================
1690
Параметры:
1691
  * eax = 33 - номер функции
1692
  * ebx = указатель на имя файла
1693
  * ecx = указатель на данные для записи
1694
  * edx = число байт для записи
1695
  * следует устанавливать esi=0
1696
Возвращаемое значение:
1697
  * eax = 0 - успешно, иначе код ошибки файловой системы
1698
Замечания:
1699
  * Эта функция устарела; функция 58 позволяет выполнять
1700
    те же действия с расширенными возможностями.
1701
  * Если указать ненулевое значение в esi и на рамдиске уже есть
114 mikedld 1702
    указанный файл, то будет создан ещ+ один файл с тем же именем.
77 diamond 1703
  * В противном случае файл перезаписывается.
1704
  * Имя файла должно быть либо в формате 8+3 символов
1705
    (первые 8 символов - собственно имя, последние 3 - расширение,
1706
    короткие имена и расширения дополняются пробелами),
1707
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1708
    (имя не более 8 символов, точка, расширение 3 символа,
1709
    дополненное при необходимости пробелами).
1710
    Имя файла должно быть записано заглавными буквами.
1711
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
1712
 
1713
======================================================================
1714
============ Функция 35 - прочитать цвет точки на экране. ============
1715
======================================================================
1716
Параметры:
1717
  * eax = 35
1718
  * ebx = y*xsize+x, где
1719
  * (x,y) = координаты точки (считая от 0)
1720
  * xsize = размер экрана по горизонтали
1721
Возвращаемое значение:
1722
  * eax = цвет 0x00RRGGBB
1723
Замечания:
1724
  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
1725
    что она вычитает 1 из обоих размеров.
1726
  * К видеопамяти есть также прямой доступ (без вызовов системных
1727
    функций) через селектор gs. Параметры текущего видеорежима
1728
    можно получить функцией 61.
1729
 
1730
======================================================================
1731
========== Функция 37 - получить координаты/состояние мыши. ==========
1732
======================================================================
1733
 
1734
-------------- Подфункция 0 - экранные координаты мыши ---------------
1735
Параметры:
1736
  * eax = 37 - номер функции
1737
  * ebx = 0 - номер подфункции
1738
Возвращаемое значение:
1739
  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
1740
 
1741
---------- Подфункция 1 - координаты мыши относительно окна ----------
1742
Параметры:
1743
  * eax = 37 - номер функции
1744
  * ebx = 1 - номер подфункции
1745
Возвращаемое значение:
1746
  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
1747
    окна приложения (считая от 0)
1748
Замечания:
1749
  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
1750
    Если y>=ywnd, то младшее слово неотрицательно и содержит
1751
    относительную y-координату, а старшее - относительную x-координату
1752
    (правильного знака). В противном случае младшее слово отрицательно
114 mikedld 1753
    и вс+ равно содержит относительную y-координату,
77 diamond 1754
    а к старшему слову следует прибавить 1.
1755
 
1756
----------------- Подфункция 2 - нажатые кнопки мыши -----------------
1757
Параметры:
1758
  * eax = 37 - номер функции
1759
  * ebx = 2 - номер подфункции
1760
Возвращаемое значение:
1761
  * eax содержит информацию о нажатых кнопках мыши:
1762
  * бит 0 установлен = левая кнопка нажата
1763
  * бит 1 установлен = правая кнопка нажата
1764
  * прочие биты сброшены
1765
 
1766
======================================================================
1767
================== Функция 38 - нарисовать отрезок. ==================
1768
======================================================================
1769
Параметры:
1770
  * eax = 38 - номер функции
1771
  * ebx = [координата начала по оси x]*65536 +
1772
              [координата конца по оси x]
1773
  * ecx = [координата начала по оси y]*65536 +
1774
              [координата конца по оси y]
1775
  * edx = 0x00RRGGBB - цвет
1776
Возвращаемое значение:
1777
  * функция не возвращает значения
1778
Замечания:
1779
  * Координаты берутся относительно окна.
1780
  * Конечная точка также рисуется.
1781
 
1782
======================================================================
1783
== Функция 39, подфункция 1 - получить размер фонового изображения. ==
1784
======================================================================
1785
Параметры:
1786
  * eax = 39 - номер функции
1787
  * ebx = 1 - номер подфункции
1788
Возвращаемое значение:
1789
  * eax = [ширина]*65536 + [высота]
1790
Замечания:
1791
  * Есть парная команда установки размеров фонового изображения -
1792
    подфункция 1 функции 15. После которой, разумеется, следует
1793
    заново определить само изображение.
1794
 
1795
======================================================================
1796
= Функция 39, подфункция 2 - прочитать точку с фонового изображения. =
1797
======================================================================
1798
Параметры:
1799
  * eax = 39 - номер функции
1800
  * ebx = 2 - номер подфункции
1801
  * ecx = смещение
1802
Возвращаемое значение:
1803
  * eax = 0x00RRGGBB - цвет точки, если смещение допустимо
1804
    (меньше 0x160000-16)
1805
  * eax = 2 - иначе
1806
Замечания:
1807
  * Не следует полагаться на возвращаемое значение в случае неверного
1808
    смещения, оно может измениться в следующих версиях ядра.
1809
  * Смещение точки с координатами (x,y) вычисляется как (x+y*xsize)*3.
1810
  * Есть парная функция установки точки на фоновом изображении -
1811
    подфункция 2 функции 15.
1812
 
1813
======================================================================
1814
====== Функция 39, подфункция 4 - получить режим отрисовки фона. =====
1815
======================================================================
1816
Параметры:
1817
  * eax = 39 - номер функции
1818
  * ebx = 4 - номер подфункции
1819
Возвращаемое значение:
1820
  * eax = 1 - замостить
1821
  * eax = 2 - растянуть
1822
Замечания:
1823
  * Есть парная функция установки режима отрисовки фона -
1824
    подфункция 4 функции 15.
1825
 
1826
======================================================================
1827
======== Функция 40 - установить маску для ожидаемых событий. ========
1828
======================================================================
1829
Маска для ожидаемых событий влияет на функции работы с событиями 10,
114 mikedld 1830
11, 23 - они сообщают только о событиях, разреш+нных этой маской.
77 diamond 1831
Параметры:
1832
  * eax = 40 - номер функции
1833
  * ebx = маска: бит i соответствует событию i+1 (см. список событий)
1834
    (установленный бит разрешает извещение о событии)
1835
Возвращаемое значение:
1836
  * функция не возвращает значения
1837
Замечания:
1838
  * Маска по умолчанию (7=111b) разрешает извещения о перерисовке
1839
    и нажатиях клавиш и кнопок.
1840
    Этого достаточно для большинства приложений.
114 mikedld 1841
  * События, запрещ+нные в маске, вс+ равно сохраняются, если
77 diamond 1842
    приходят; о них просто не извещают функции работы с событиями.
1843
  * Функции работы с событиями учитывают маску на момент
1844
    вызова функции, а не на момент поступления сообщения.
1845
 
1846
======================================================================
1847
================= Функция 41 - узнать владельца IRQ. =================
1848
======================================================================
1849
Параметры:
1850
  * eax = 41 - номер функции
1851
  * ebx = номер IRQ, 0..15
1852
Возвращаемое значение:
1853
  * eax = PID владельца
1854
  * eax = 0, если владельца нет
1855
  * eax = -1 для некорректного ebx
1856
 
1857
======================================================================
1858
========== Функция 42 - прочитать данные, полученные по IRQ. =========
1859
======================================================================
1860
При возникновении IRQ система может считывать данные из указанных
1861
ранее функцией 44 портов и записывать эти данные в буфер.
1862
Описываемая функция считывает побайтно данные из этого буфера.
1863
Параметры:
1864
  * eax = 42 - номер функции
1865
  * ebx = номер IRQ, 0..15
1866
Возвращаемое значение: (ситуацию можно различить по значению ecx)
1867
  * если поток не является владельцем IRQ
1868
    (или номер IRQ задан неверно):
1869
    * ecx = 2
1870
  * если данных нет:
1871
    * eax = 0
1872
    * ecx = 1
1873
    * ebx разрушается
114 mikedld 1874
  * если вс+ в порядке и данные были:
1875
    * eax = размер данных, ещ+ не прочитанных из буфера (в байтах)
77 diamond 1876
    * ecx = 0
1877
    * ebx = очередной байт
1878
Замечания:
1879
  * Предварительно поток должен зарезервировать для себя указанный IRQ
1880
    функцией 45.
1881
  * Размер буфера для данных - 4000 байт, при переполнении
1882
    "свежие" данные перестают записываться в буфер.
1883
 
1884
======================================================================
1885
=================== Функция 43 - ввод/вывод в порт. ==================
1886
======================================================================
1887
 
1888
------------------------ Вывод данных в порт -------------------------
1889
Параметры:
1890
  * eax = 43 - номер функции
1891
  * bl = байт для вывода
1892
  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
1893
Возвращаемое значение:
1894
  * eax = 0 - успешно
1895
  * eax = 1 - поток не зарезервировал указанный порт
1896
 
1897
------------------------ Ввод данных из порта ------------------------
1898
Параметры:
1899
  * eax = 43 - номер функции
1900
  * ebx игнорируется
1901
  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
1902
Возвращаемое значение:
114 mikedld 1903
  * eax = 0 - успешно, при этом ebx = введ+нный байт
77 diamond 1904
  * eax = 1 - поток не зарезервировал данный порт
1905
Замечания:
1906
  * Предварительно поток должен зарезервировать за собой
1907
    указанный порт функцией 46.
1908
  * Для зарезервированных портов вместо вызова этих функций
1909
    лучше использовать команды процессора in/out - это значительно
1910
    быстрее и несколько короче и проще. Из незарезервированных
114 mikedld 1911
    портов читать вс+ равно нельзя.
77 diamond 1912
 
1913
======================================================================
1914
======== Функция 44 - определить действия при поступлении IRQ. =======
1915
======================================================================
1916
При возникновении IRQ система может считывать данные из указанных этой
1917
функцией портов и записывать эти данные в буфер, откуда их можно
1918
прочитать функцией 42.
1919
Параметры:
1920
  * eax = 44 - номер функции
1921
  * ebx = указатель на массив структур, описывающих по одному порту:
1922
    * +0: word: 0 означает конец массива, иначе номер порта
1923
    * +2: byte: зарезервировано (игнорируется)
1924
    * +3: byte: 1=считывать байт из этого порта, 2=считывать слово
1925
  * ecx = номер IRQ, 0..15
1926
Возвращаемое значение:
1927
  * eax = 0 - успешно
1928
  * eax = 1 - поток не является владельцем указанного IRQ
1929
Замечания:
1930
  * Предварительно поток должен зарезервировать за собой
1931
    указываемый IRQ функцией 45.
1932
  * Принимаются во внимание только первые 16 портов.
1933
  * Текущая реализация рассматривает неправильное значение поля +3
1934
    как сигнал прекращения обработки IRQ.
1935
 
1936
======================================================================
1937
============ Функция 45 - зарезервировать/освободить IRQ. ============
1938
======================================================================
1939
Параметры:
1940
  * eax = 45 - номер функции
1941
  * ebx = 0 - зарезервировать, 1 = освободить
1942
  * ecx = номер IRQ, 0..15
1943
Возвращаемое значение:
1944
  * eax = 0 - успешно
1945
  * eax = 1 - ошибка (неверный номер IRQ или
1946
    попытка зарезервировать несвободный IRQ или освободить IRQ, не
1947
    зарезервированный текущим потоком)
1948
Замечания:
1949
  * Резервирование IRQ нужно для работы функций 42 и 44.
1950
  * Только один поток может зарезервировать конкретный IRQ.
1951
  * IRQ, обрабатываемые системой самостоятельно, резервируются
1952
    системой (потоком 1) при загрузке.
1953
  * При завершении потока автоматически освобождаются
1954
    все зарезервированные им IRQ.
1955
 
1956
======================================================================
1957
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
1958
======================================================================
1959
К зарезервированным портам можно обращаться напрямую из приложения
1960
командами in/out (рекомендуемый способ) и вызовом функции 43
1961
(нерекомендуемый способ).
1962
Параметры:
1963
  * eax = 46 - номер функции
1964
  * ebx = 0 - зарезервировать, 1 - освободить
1965
  * ecx = номер начала диапазона портов
1966
  * edx = номер конца диапазона портов (включительно)
1967
Возвращаемое значение:
1968
  * eax = 0 - успешно
1969
  * eax = 1 - ошибка
1970
Замечания:
1971
  * В случае резервирования портов ошибкой считается выполнение
1972
    одного из условий:
1973
    * начальный адрес больше конечного;
1974
    * указанный диапазон содержит некорректный номер порта
1975
      (корректные - от 0 до 0xFFFF);
1976
    * превышено ограничение на общее число зарезервированных областей
1977
      - допускается максимум 255;
1978
    * указанный диапазон пересекается с одним из
1979
      ранее зарезервированных
1980
  * В случае освобождения портов ошибкой считается попытка
1981
    освобождения диапазона, который ранее не был целиком
1982
    зарезервирован этой же функцией (с такими же значениями ecx,edx).
1983
  * При обнаружении ошибки (в обоих случаях) никаких действий
1984
    не производится.
1985
  * При загрузке система резервирует за собой порты 0..0xff, а при
1986
    обнаружении COM-мыши - дополнительно диапазон COM-портов
1987
    0x3f0..0x3ff и/или 0x2f0..0x2ff.
1988
  * При завершении потока автоматически освобождаются все
1989
    зарезервированные им порты.
1990
 
1991
======================================================================
1992
================= Функция 47 - вывести число в окно. =================
1993
======================================================================
1994
Параметры:
1995
  * eax = 47 - номер функции
1996
  * ebx = параметры преобразования числа в текст:
1997
    * bl = 0 - ecx содержит число
1998
    * bl = 1 - ecx содержит указатель на dword-число
1999
    * bh = 0 - отображать в десятичной системе счисления
2000
    * bh = 1 - отображать в шестнадцатеричной системе
2001
    * bh = 2 - отображать в двоичной системе
2002
    * биты 16-21 = сколько цифр отображать
2003
    * биты 22-31 зарезервированы и должны быть установлены в 0
2004
  * ecx = число (при bl=0) или указатель (при bl=1)
2005
  * edx = [координата по оси x]*65536 + [координата по оси y]
2006
  * esi = 0xN0RRGGBB, RRGGBB=цвет, N=шрифт (0/1)
2007
Возвращаемое значение:
2008
  * функция не возвращает значения
2009
Замечания:
2010
  * Указанная длина не должна превосходить 60.
2011
  * Выводится ровно указанное количество цифр. Если число мало и
2012
    может быть записано меньшим количеством цифр, оно дополняется
2013
    ведущими нулями; если число велико и не может быть записано
2014
    таким количеством цифр, "лишние" ведущие цифры обрезаются.
2015
  * Параметры шрифтов указаны в описании функции 4 (вывода текста).
2016
 
2017
======================================================================
2018
======= Функция 48, подфункция 0 - применить настройки экрана. =======
2019
======================================================================
2020
Параметры:
2021
  * eax = 48 - номер функции
2022
  * ebx = 0 - номер подфункции
2023
  * ecx = 0 - зарезервировано
2024
Возвращаемое значение:
2025
  * функция не возвращает значения
2026
Замечания:
2027
  * Функция перерисовывает экран после изменения параметров
2028
    подфункциями 1 и 2.
2029
  * Вызов функции без предшествующих вызовов указанных подфункций
2030
    игнорируется.
2031
  * Вызов функции с ненулевым ecx игнорируется.
2032
 
2033
======================================================================
2034
========= Функция 48, подфункция 1 - установить стиль кнопок. ========
2035
======================================================================
2036
Параметры:
2037
  * eax = 48 - номер функции
2038
  * ebx = 1 - номер подфункции
2039
  * ecx = тип кнопок:
2040
    * 0 = плоские
114 mikedld 2041
    * 1 = объ+мные
77 diamond 2042
Возвращаемое значение:
2043
  * функция не возвращает значения
2044
Замечания:
2045
  * После вызова описываемой функции следует перерисовать экран
2046
    подфункцией 0.
2047
  * Тип кнопок влияет только на их прорисовку функцией 8.
2048
 
2049
======================================================================
2050
==== Функция 48, подфункция 2 - установить стандартные цвета окон. ===
2051
======================================================================
2052
Параметры:
2053
  * eax = 48 - номер функции
2054
  * ebx = 2 - номер подфункции
2055
  * ecx = указатель на таблицу цветов
2056
  * edx = размер таблицы цветов
2057
    (должен быть 40 байт для будущей совместимости)
2058
Формат таблицы цветов указан в описании подфункции 3.
2059
Возвращаемое значение:
2060
  * функция не возвращает значения
2061
Замечания:
2062
  * После вызова описываемой функции следует перерисовать экран
2063
    подфункцией 0.
2064
  * Таблица стандартных цветов влияет только на приложения,
2065
    которые эту таблицу явным образом получают (подфункцией 3) и
114 mikedld 2066
    используют (указывая цвета из не+ при вызовах функций рисования).
77 diamond 2067
  * Таблица стандартных цветов входит в скин и устанавливается заново
2068
    при установке скина (подфункции 8).
2069
  * Таблицу цветов можно просматривать/изменять интерактивно с помощью
2070
    приложения desktop.
2071
 
2072
======================================================================
2073
===== Функция 48, подфункция 3 - получить стандартные цвета окон. ====
2074
======================================================================
2075
Параметры:
2076
  * eax = 48 - номер функции
2077
  * ebx = 3 - номер подфункции
2078
  * ecx = указатель на буфер размером edx байт,
2079
    куда будет записана таблица
2080
  * edx = размер таблицы цветов
2081
    (должен быть 40 байт для будущей совместимости)
2082
Возвращаемое значение:
2083
  * функция не возвращает значения
2084
Формат таблицы цветов: каждый элемент -
2085
dword-значение цвета 0x00RRGGBB
2086
  * +0: dword: frames - цвет рамки
2087
  * +4: dword: grab - цвет заголовка
2088
  * +8: dword: grab_button - цвет кнопки на полосе заголовка
2089
  * +12 = +0xC: dword: grab_button_text - цвет текста на кнопке
2090
    на полосе заголовка
2091
  * +16 = +0x10: dword: grab_text - цвет текста на заголовке
2092
  * +20 = +0x14: dword: work - цвет рабочей области
2093
  * +24 = +0x18: dword: work_button - цвет кнопки в рабочей области
2094
  * +28 = +0x1C: dword: work_button_text - цвет текста на кнопке
2095
    в рабочей области
2096
  * +32 = +0x20: dword: work_text - цвет текста в рабочей области
2097
  * +36 = +0x24: dword: work_graph - цвет графики в рабочей области
2098
Замечания:
2099
  * Структура таблицы цветов описана в стандартном включаемом файле
2100
    macros.inc под названием system_colors; например, можно писать:
114 mikedld 2101
        sc    system_colors        ; объявление переменной
2102
        ...                ; где-то надо вызвать
2103
                        ; описываемую функцию с ecx=sc
2104
        mov    ecx, [sc.work_button_text]    ; читаем цвет текста
2105
                        ; на кнопке в рабочей области
77 diamond 2106
  * Использование/неиспользование этих цветов - дело исключительно
2107
    самой программы. Для использования нужно просто при вызове функций
2108
    рисования указывать цвет, взятый из этой таблицы.
2109
  * При изменении таблицы стандартных цветов (подфункцией 2 с
2110
    последующим применением изменений подфункцией 0 или
2111
    при установке скина подфункцией 8) всем окнам посылается сообщение
2112
    о необходимости перерисовки (событие с кодом 1).
2113
  * Стандартные цвета можно просматривать/изменять интерактивно
2114
    с помощью приложения desktop.
2115
 
2116
======================================================================
2117
========== Функция 48, подфункция 4 - получить высоту скина. =========
2118
======================================================================
2119
Параметры:
2120
  * eax = 48 - номер функции
2121
  * ebx = 4 - номер подфункции
2122
Возвращаемое значение:
2123
  * eax = высота скина
2124
Замечания:
2125
  * Высотой скина по определению считается высота заголовка окон,
2126
    использующих скин.
2127
  * Смотри также общую структуру окна в описании функции 0.
2128
 
2129
======================================================================
2130
===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
2131
======================================================================
2132
Параметры:
2133
  * eax = 48 - номер функции
2134
  * ebx = 5 - номер подфункции
2135
Возвращаемое значение:
2136
  * eax = [left]*65536 + [right]
2137
  * ebx = [top]*65536 + [bottom]
2138
Замечания:
2139
  * Рабочая область экрана определяет положение и координаты
2140
    максимизированного окна.
2141
  * Рабочая область экрана при нормальной работе есть весь экран
2142
    за вычетом панели (@panel).
2143
  * (left,top) - координаты левого верхнего угла,
2144
    (right,bottom) - координаты правого нижнего.
2145
    Таким образом, размер рабочей области по оси x определяется
2146
    формулой right-left+1, по оси y - формулой bottom-right+1.
2147
  * Смотри также функцию 14,
2148
    позволяющую определить размеры всего экрана.
2149
  * Есть парная функция установки рабочей области - подфункция 6.
2150
 
2151
======================================================================
2152
==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
2153
======================================================================
2154
Параметры:
2155
  * eax = 48 - номер функции
2156
  * ebx = 6 - номер подфункции
2157
  * ecx = [left]*65536 + [right]
2158
  * edx = [top]*65536 + [bottom]
2159
Возвращаемое значение:
2160
  * функция не возвращает значения
2161
Замечания:
2162
  * Рабочая область экрана определяет положение и координаты
2163
    максимизированного окна.
2164
  * Эта функция используется только приложением @panel,
2165
    устанавливающим рабочей областью весь экран за вычетом панели.
2166
  * (left,top) - координаты левого верхнего угла,
2167
    (right,bottom) - координаты правого нижнего.
2168
    Таким образом, размер рабочей области по оси x определяется
2169
    формулой right-left+1, по оси y - формулой bottom-right+1.
2170
  * Если left>=right, то x-координаты рабочей области не изменяются.
2171
    Если left<0, то left не устанавливается. Если right больше
2172
    или равно ширины экрана, то right не устанавливается.
2173
    Аналогично по оси y.
2174
  * Смотри также функцию 14,
2175
    позволяющую определить размеры всего экрана.
2176
  * Есть парная функция получения рабочей области -
2177
    подфункция 5.
2178
  * Эта функция автоматически перерисовывает экран, по ходу дела
2179
    обновляет координаты и положение максимизированных окон.
2180
    Все окна извещаются о необходимости перерисовки (событие 1).
2181
 
2182
======================================================================
2183
====================== Функция 48, подфункция 7 ======================
2184
============ Получить область скина для текста заголовка. ============
2185
======================================================================
2186
Возвращает область заголовка окна со скином, предназначенную
2187
для вывода текста заголовка.
2188
Параметры:
2189
  * eax = 48 - номер функции
2190
  * ebx = 7 - номер подфункции
2191
Возвращаемое значение:
2192
  * eax = [left]*65536 + [right]
2193
  * ebx = [top]*65536 + [bottom]
2194
Замечания:
2195
  * Использование/неиспользование этой функции -
2196
    личное дело приложения.
2197
  * Рекомендуется учитывать значения, возвращаемые этой функцией,
2198
    при выборе места для рисования текста заголовка (функцией 4) или
2199
    какого-нибудь заменителя текста заголовка
2200
    (по усмотрению приложения).
2201
 
2202
======================================================================
2203
==== Функция 48, подфункция 8 - установить используемый скин окон. ===
2204
======================================================================
2205
Параметры:
2206
  * eax = 48 - номер функции
2207
  * ebx = 8 - номер подфункции
2208
  * ecx = указатель на блок для функции 58, в котором установлено
2209
    поле промежуточного буфера и указано имя файла
2210
Возвращаемое значение:
2211
  * eax = 0 - успешно
114 mikedld 2212
  * иначе eax = код ошибки файловой системы; если файл не зада+т скин,
77 diamond 2213
    то возвращается ошибка 3 (неизвестная файловая система).
2214
Замечания:
2215
  * При успешной загрузке скина все окна извещаются о необходимости
2216
    перерисовки (событие 1).
2217
  * При загрузке система считывает скин из файла default.skn
2218
    на рамдиске.
2219
  * Пользователь может изменять скин статически, создав свой
2220
    default.skn, или динамически с помощью приложения desktop.
2221
 
2222
======================================================================
78 diamond 2223
============ Функция 49 - Advanced Power Management (APM). ===========
2224
======================================================================
2225
Параметры:
2226
  * eax = 49 - номер функции
2227
  * dx = номер функции APM (аналог ax в спецификации)
2228
  * bx, cx = параметры функции APM
2229
Возвращаемое значение:
2230
  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
2231
    установлены в соответствии со спецификацией APM
2232
  * старшие половины 32-битных регистров eax, ebx, ecx,
2233
    edx, esi, edi разрушаются
2234
Замечания:
2235
  * Спецификация APM 1.2 описывается в документе
2236
    "Advanced Power Management (APM) BIOS Specification"
2237
    (Revision 1.2), доступном на
2238
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2239
    кроме того, она включена в известный Interrupt List by Ralf Brown
2240
    (http://www.pobox.com/~ralf/files.html,
2241
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2242
 
2243
======================================================================
77 diamond 2244
================= Функция 50 - установка формы окна. =================
2245
======================================================================
2246
Обычные окна представляют собой прямоугольники. С помощью этой функции
114 mikedld 2247
окну можно придать произвольную форму. Форма зада+тся набором точек
77 diamond 2248
внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
2249
размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
2250
функцией 67.
2251
 
2252
--------------- Установка данных с информацией о форме ---------------
2253
Параметры:
2254
  * eax = 50 - номер функции
2255
  * ebx = 0 - номер подфункции
2256
  * ecx = указатель на данные формы (массив байт 0/1)
2257
Возвращаемое значение:
2258
  * функция не возвращает значения
2259
 
2260
------------------ Установка масштаба данных формы -------------------
2261
Параметры:
2262
  * eax = 50 - номер функции
2263
  * ebx = 1 - номер подфункции
114 mikedld 2264
  * ecx зада+т масштаб: каждый байт данных определяет
77 diamond 2265
    (2^scale)*(2^scale) пикселей
2266
Возвращаемое значение:
2267
  * функция не возвращает значения
2268
Замечания:
2269
  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
2270
    данных формы один байт соответствует одному пикселю, то масштаб
2271
    можно не устанавливать.
2272
  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
2273
    обратите внимание, что они на единицу больше, чем устанавливаемые
2274
    функциями 0, 67.
2275
  * По определению масштаба xsize и ysize должны делиться на 2^scale.
2276
  * Байт данных по смещению a должен быть 0/1 и
2277
    определяет принадлежность окну квадрата со стороной 2^scale
2278
    (при scale=0 получаем пиксель) и координатами левого верхнего угла
2279
    (a mod (xsize shr scale), a div (xsize shr scale))
2280
  * Размер данных: (xsize shr scale)*(ysize shr scale).
2281
  * Данные должны присутствовать в памяти и не меняться
2282
    после установки формы.
2283
  * Система просматривает данные о форме при каждой перерисовке окна
2284
    функцией 0.
2285
  * Вызов подфункции 0 с нулевым указателем приводит к возврату
2286
    к прямоугольной форме.
2287
 
2288
======================================================================
2289
===================== Функция 51 - создать поток. ====================
2290
======================================================================
2291
Параметры:
2292
  * eax = 51 - номер функции
2293
  * ebx = 1 - единственная подфункция
2294
  * ecx = адрес точки входа потока (начальный eip)
2295
  * edx = указатель стэка потока (начальный esp)
2296
Возвращаемое значение:
2297
  * eax = -1 - ошибка (в системе слишком много потоков)
2298
  * иначе eax = TID - идентификатор потока
2299
 
2300
======================================================================
2301
= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
2302
======================================================================
2303
Параметры:
2304
  * eax = 52 - номер функции
2305
  * ebx = 0 - номер подфункции
2306
Возвращаемое значение:
2307
  * eax = двойное слово конфигурации
2308
Замечания:
2309
  * Слово конфигурации можно установить подфункцией 2.
2310
  * Ядро не использует соответствующую переменную.
2311
    Ценность этой переменной и работающих с ней подфункций 0 и 2
2312
    представляется сомнительной.
2313
 
2314
======================================================================
2315
======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
2316
======================================================================
2317
Параметры:
2318
  * eax = 52 - номер функции
2319
  * ebx = 1 - номер подфункции
2320
Возвращаемое значение:
2321
  * eax = IP-адрес (4 байта)
2322
Замечания:
2323
  * Локальный IP-адрес устанавливается подфункцией 3.
2324
 
2325
======================================================================
2326
 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
2327
======================================================================
2328
Параметры:
2329
  * eax = 52 - номер функции
2330
  * ebx = 2 - номер подфункции
2331
  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
2332
    число 3, это воспринимается как запрос на [пере-]инициализацию
2333
    Ethernet-карты, в противном случае Ethernet выключается
2334
Возвращаемое значение:
2335
  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
2336
    но это может измениться в будущих версиях ядра
2337
  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
2338
    (отсутствие Ethernet-карты), а ненулевое значение - успех
2339
Замечания:
2340
  * Слово конфигурации можно прочитать подфункцией 0.
2341
  * Ядро не использует соответствующую переменную.
2342
    Ценность этой переменной, подфункции 0 и части подфункции 2,
2343
    устанавливающей эту переменную, представляется сомнительной.
2344
 
2345
======================================================================
2346
====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
2347
======================================================================
2348
Параметры:
2349
  * eax = 52 - номер функции
2350
  * ebx = 3 - номер подфункции
2351
  * ecx = IP-адрес (4 байта)
2352
Возвращаемое значение:
2353
  * текущая реализация возвращает eax=3, но это может быть изменено
2354
    в будущих версиях
2355
Замечания:
2356
  * Локальный IP-адрес можно получить подфункцией 1.
2357
 
2358
======================================================================
2359
= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
2360
======================================================================
2361
Параметры:
2362
  * eax = 52 - номер функции
2363
  * ebx = 6 - номер подфункции
2364
  * edx = размер данных
2365
  * esi = указатель на данные
2366
Возвращаемое значение:
2367
  * eax = -1 - ошибка
2368
  * eax = 0 - успешно
2369
Замечания:
2370
  * Эта функция предназначена только для медленных сетевых драйверов
2371
    (PPP, SLIP).
2372
  * Размер данных не должен превосходить 1500 байт,
2373
    хотя проверок корректности не делается.
2374
 
2375
======================================================================
2376
====================== Функция 52, подфункция 8 ======================
2377
============= Прочитать данные из сетевой очереди вывода. ============
2378
======================================================================
2379
Параметры:
2380
  * eax = 52 - номер функции
2381
  * ebx = 8 - номер подфункции
2382
  * esi = указатель на буфер размером 1500 байт
2383
Возвращаемое значение:
2384
  * eax = число прочитанных байт (в текущей реализации
2385
    либо 0 = нет данных, либо 1500)
2386
  * данные скопированы в буфер
2387
Замечания:
2388
  * Эта функция предназначена только для медленных сетевых драйверов
2389
    (PPP, SLIP).
2390
 
2391
======================================================================
2392
=========== Функция 52, подфункция 9 - получить gateway IP. ==========
2393
======================================================================
2394
Параметры:
2395
  * eax = 52 - номер функции
2396
  * ebx = 9 - номер подфункции
2397
Возвращаемое значение:
2398
  * eax = gateway IP (4 байта)
2399
 
2400
======================================================================
2401
========= Функция 52, подфункция 10 - получить маску подсети. ========
2402
======================================================================
2403
Параметры:
2404
  * eax = 52 - номер функции
2405
  * ebx = 10 - номер подфункции
2406
Возвращаемое значение:
2407
  * eax = маска подсети
2408
 
2409
======================================================================
2410
========= Функция 52, подфункция 11 - установить gateway IP. =========
2411
======================================================================
2412
Параметры:
2413
  * eax = 52 - номер функции
2414
  * ebx = 11 - номер подфункции
2415
  * ecx = gateway IP (4 байта)
2416
Возвращаемое значение:
2417
  * текущая реализация возвращает eax=11, но это может быть изменено
2418
    в будущих реализациях
2419
 
2420
======================================================================
2421
======== Функция 52, подфункция 12 - установить маску подсети. =======
2422
======================================================================
2423
Параметры:
2424
  * eax = 52 - номер функции
2425
  * ebx = 12 - номер подфункции
2426
  * ecx = маска подсети
2427
Возвращаемое значение:
2428
  * текущая реализация возвращает eax=12, но это может быть изменено
2429
    в будущих версиях
2430
 
2431
======================================================================
2432
============ Функция 52, подфункция 13 - получить DNS IP. ============
2433
======================================================================
2434
Параметры:
2435
  * eax = 52 - номер функции
2436
  * ebx = 13 - номер подфункции
2437
Возвращаемое значение:
2438
  * eax = DNS IP (4 байта)
2439
 
2440
======================================================================
2441
=========== Функция 52, подфункция 14 - установить DNS IP. ===========
2442
======================================================================
2443
Параметры:
2444
  * eax = 52 - номер функции
2445
  * ebx = 14 - номер подфункции
2446
  * ecx = DNS IP (4 байта)
2447
Возвращаемое значение:
2448
  * текущая реализация возвращает eax=14, но это может быть изменено
2449
    в следующих версиях
2450
 
2451
======================================================================
2452
============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========
2453
======================================================================
2454
Параметры:
2455
  * eax = 53 - номер функции
2456
  * ebx = 0 - номер подфункции
2457
  * ecx = локальный порт (учитывается только младшее слово)
114 mikedld 2458
  * edx = удал+нный порт (учитывается только младшее слово)
2459
  * esi = удал+нный IP
77 diamond 2460
Возвращаемое значение:
2461
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2462
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2463
    сокет и имеющее смысл только для системы) - успешно;
2464
    ebx разрушается
2465
 
2466
======================================================================
2467
============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========
2468
======================================================================
2469
Параметры:
2470
  * eax = 53 - номер функции
2471
  * ebx = 1 - номер подфункции
2472
  * ecx = хэндл сокета
2473
Возвращаемое значение:
2474
  * eax = -1 - неверный хэндл
2475
  * eax = 0 - успешно
2476
  * ebx разрушается
2477
Замечания:
2478
  * Текущая реализация не закрывает автоматически все сокеты потока
2479
    при его завершении. В частности, не следует прибивать поток
2480
    с кучей открытых сокетов - будет утечка ресурсов.
2481
  * Текущая реализация не делает проверок на корректность
2482
    (единственное, на что возвращается ошибка, - попытка закрыть
2483
    неоткрытый сокет с корректным хэндлом).
2484
 
2485
======================================================================
2486
============== Функция 53, подфункция 2 - опрос сокета. ==============
2487
======================================================================
2488
Параметры:
2489
  * eax = 53 - номер функции
2490
  * ebx = 2 - номер подфункции
2491
  * ecx = хэндл сокета
2492
Возвращаемое значение:
2493
  * eax = число полученных байт
2494
  * ebx разрушается
2495
Замечания:
2496
  * Проверки корректности не делается.
2497
 
2498
======================================================================
2499
======== Функция 53, подфункция 3 - прочитать байт из сокета. ========
2500
======================================================================
2501
Параметры:
2502
  * eax = 53 - номер функции
2503
  * ebx = 3 - номер подфункции
2504
  * ecx = хэндл сокета
2505
Возвращаемое значение:
2506
  * если нет принятых данных: eax=0, bl=0,
114 mikedld 2507
    прочие биты ebx разрушаются
77 diamond 2508
  * если были принятые данные: eax=число оставшихся байт
114 mikedld 2509
    (возможно, 0), bl=прочитанный байт, прочие биты ebx разрушаются
77 diamond 2510
Замечания:
2511
  * Проверки корректности не производится.
2512
 
2513
======================================================================
2514
========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========
2515
======================================================================
2516
Параметры:
2517
  * eax = 53 - номер функции
2518
  * ebx = 4 - номер подфункции
2519
  * ecx = хэндл сокета
2520
  * edx = число байт для записи
2521
  * esi = указатель на данные для записи
2522
Возвращаемое значение:
2523
  * eax = 0xffffffff - неверный хэндл
2524
  * eax = 0xffff - недостаточно памяти
2525
  * eax = 0 - успешно
2526
  * ebx разрушается
2527
Замечания:
114 mikedld 2528
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2529
    не очень неправильные неоткрытые хэндлы.
2530
  * Число байт для записи не может превышать 1500-28, хотя
2531
    соответствующей проверки не делается.
2532
 
2533
======================================================================
2534
============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========
2535
======================================================================
2536
Параметры:
2537
  * eax = 53 - номер функции
2538
  * ebx = 5 - номер подфункции
2539
  * ecx = локальный порт (учитывается только младшее слово)
114 mikedld 2540
  * edx = удал+нный порт (учитывается только младшее слово)
2541
  * esi = удал+нный IP
77 diamond 2542
  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1
2543
Возвращаемое значение:
2544
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2545
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2546
    сокет и имеющее смысл только для системы) - успешно;
2547
    ebx разрушается
2548
 
2549
======================================================================
2550
====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
2551
======================================================================
2552
Параметры:
2553
  * eax = 53 - номер функции
2554
  * ebx = 6 - номер подфункции
2555
  * ecx = хэндл сокета
2556
Возвращаемое значение:
2557
  * eax = статус сокета: одно из
2558
  * TCB_LISTEN = 1
2559
  * TCB_SYN_SENT = 2
2560
  * TCB_SYN_RECEIVED = 3
2561
  * TCB_ESTABLISHED = 4
2562
  * TCB_FIN_WAIT_1 = 5
2563
  * TCB_FIN_WAIT_2 = 6
2564
  * TCB_CLOSE_WAIT = 7
2565
  * TCB_CLOSING = 8
2566
  * TCB_LAST_ASK = 9
2567
  * TCB_TIME_WAIT = 10
2568
  * TCB_CLOSED = 11
2569
  * ebx разрушается
2570
Замечания:
2571
  * Проверок корректности не производится.
2572
 
2573
======================================================================
2574
========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
2575
======================================================================
2576
Параметры:
2577
  * eax = 53 - номер функции
2578
  * ebx = 7 - номер подфункции
2579
  * ecx = хэндл сокета
2580
  * edx = число байт для записи
2581
  * esi = указатель на данные для записи
2582
Возвращаемое значение:
2583
  * eax = 0xffffffff - ошибка
2584
  * eax = 0xffff - недостаточно памяти
2585
  * eax = 0 - успешно
2586
  * ebx разрушается
2587
Замечания:
114 mikedld 2588
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2589
    не очень неправильные неоткрытые хэндлы.
2590
  * Число байт для записи не может превышать 1500-40,
2591
    хотя соответствующей проверки не делается.
2592
 
2593
======================================================================
2594
============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========
2595
======================================================================
2596
Параметры:
2597
  * eax = 53 - номер функции
2598
  * ebx = 8 - номер подфункции
2599
  * ecx = хэндл сокета
2600
Возвращаемое значение:
2601
  * eax = -1 - неверный хэндл
2602
  * eax = 0xffff - недостаточно памяти для пакета закрытия сокета
2603
  * eax = 0 - успешно
2604
  * во многих случаях eax разрушается (возвращается результат функции
2605
    queue) - видимо, это баг, который будет исправлен
2606
  * ebx разрушается
2607
Замечания:
2608
  * Текущая реализация не закрывает автоматически все сокеты потока
2609
    при его завершении. В частности, не следует прибивать поток
2610
    с кучей открытых сокетов - будет утечка ресурсов.
2611
  * Текущая реализация не делает проверок на корректность
2612
    (единственное, на что возвращается ошибка, - попытка закрыть
2613
    неоткрытый сокет с корректным хэндлом).
2614
 
2615
======================================================================
2616
== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =
2617
======================================================================
2618
Параметры:
2619
  * eax = 53 - номер функции
2620
  * ebx = 9 - номер подфункции
2621
  * ecx = номер локального порта (используются только младшие 16 бит)
2622
Возвращаемое значение:
2623
  * eax = 0 - порт используется
2624
  * eax = 1 - порт свободен
2625
  * ebx разрушается
2626
 
2627
======================================================================
2628
 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.
2629
======================================================================
2630
Параметры:
2631
  * eax = 53 - номер функции
2632
  * ebx = 255 - номер подфункции
2633
  * ecx = тип запрашиваемой информации (смотри ниже)
2634
Возвращаемое значение:
2635
  * eax = запрошенная информация
2636
  * ebx разрушается
2637
Возможные значения ecx:
2638
  * 100: длина очереди 0 (empty queue)
2639
  * 101: длина очереди 1 (ip-out queue)
2640
  * 102: длина очереди 2 (ip-in queue)
2641
  * 103: длина очереди 3 (net1out queue)
2642
  * 200: число элементов в таблице ARP
2643
  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)
2644
  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда
2645
    берут информацию 5 последующих типов;
114 mikedld 2646
    в этом случае eax неопредел+н
77 diamond 2647
  * 203: IP-адрес, запомненный типом 202
2648
  * 204: старшее dword MAC-адреса, запомненного типом 202
2649
  * 205: младшее word MAC-адреса, запомненного типом 202
2650
  * 206: слово статуса, запомненное типом 202
2651
  * 207: слово ttl, запомненное типом 202
2652
  * 2: общее число полученных IP-пакетов
2653
  * 3: общее число переданных IP-пакетов
2654
  * 4: общее число сдампленных полученных пакетов
2655
  * 5: общее число полученных ARP-пакетов
2656
  * 6: статус драйвера пакетов, 0=неактивен,
2657
    ненулевое значение=активен
2658
 
2659
======================================================================
2660
======== Функция 55, подфункция 0 - загрузить данные для SB16. =======
2661
======================================================================
2662
Параметры:
2663
  * eax = 55 - номер функции
2664
  * ebx = 0 - номер подфункции
2665
  * ecx = указатель на данные (копируется 64 килобайта, используется
2666
    столько, сколько установлено подфункцией 2)
2667
Возвращаемое значение:
2668
  * функция не возвращает значения
2669
Замечания:
2670
  * Формат и размер данных устанавливаются подфункцией 2.
2671
 
2672
======================================================================
2673
==== Функция 55, подфункция 1 - начать проигрывать данные на SB16. ===
2674
======================================================================
2675
Параметры:
2676
  * eax = 55 - номер функции
2677
  * ebx = 1 - номер подфункции
2678
Возвращаемое значение:
2679
  * функция не возвращает значения
2680
Замечания:
2681
  * Предварительно данные должны быть загружены подфункцией 0 и
114 mikedld 2682
    определ+н их формат подфункцией 2.
77 diamond 2683
  * Функция возвращает управление, когда началось проигрывание данных;
114 mikedld 2684
    после этого проигрывание ид+т независимо от приложения (и вообще
77 diamond 2685
    не требует загрузки процессора).
2686
  * Предварительно должны быть определены базовый порт SB16
2687
    (подфункцией 4 функции 21) и канал DMA
2688
    (подфункцией 10 функции 21).
2689
 
2690
======================================================================
2691
====== Функция 55, подфункция 2 - установить формат данных SB16. =====
2692
======================================================================
2693
Параметры:
2694
  * eax = 55 - номер функции
2695
  * ebx = 2 - номер подфункции
2696
  * ecx = 0 - установить разрядность
2697
    * edx = 1 - 8бит моно
2698
    * edx = 2 - 8бит стерео
2699
  * ecx = 1 - установить размер данных
2700
    * edx = размер в байтах
2701
  * ecx = 2 - установить частоту проигрывания
2702
    * edx = частота
2703
Возвращаемое значение:
2704
  * функция не возвращает значения
2705
Замечания:
2706
  * При загрузке системы устанавливаются следующие параметры
2707
    по умолчанию: разрядность - 8 бит моно, размер - 64 Кб,
2708
    частота 44100 Гц. Тем не менее рекомендуется явно устанавливать
2709
    необходимые значения, поскольку они могли быть переустановлены
2710
    какой-нибудь программой.
2711
 
2712
======================================================================
2713
====================== Функция 55, подфункция 55 =====================
2714
========== Начать проигрывать данные на встроенном спикере. ==========
2715
======================================================================
2716
Параметры:
2717
  * eax = 55 - номер функции
2718
  * ebx = 55 - номер подфункции
2719
  * esi = указатель на данные
2720
Возвращаемое значение:
2721
  * eax = 0 - успешно
114 mikedld 2722
  * eax = 55 - ошибка (спикер отключ+н или занят)
77 diamond 2723
Данные - это массив элементов переменной длины.
2724
Формат каждого элемента определяется первым байтом:
2725
  * 0 = конец данных
114 mikedld 2726
  * 1..0x80 = зада+т длительность звучания в сотых долях секунды
77 diamond 2727
    ноты, определяемой непосредственным значением частоты
2728
    * следующее слово (2 байта) содержит делитель частоты;
2729
      частота определяется как 1193180/divider
2730
  * 0x81 = invalid
2731
  * 0x82..0xFF = нота, определяемая октавой и номером:
2732
    * длительность в сотых долях секунды = (первый байт)-0x81
114 mikedld 2733
    * присутствует ещ+ один байт;
77 diamond 2734
    * (второй байт)=0xFF - пауза
2735
    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
2736
      до 12, a=номер октавы (считая с 0)
2737
Замечания:
2738
  * Пищание спикером может быть запрещено/разрешено подфункцией 8
2739
    функции 18.
2740
  * Функция возвращает управление, сообщив куда следует информацию
114 mikedld 2741
    о запросе. Само проигрывание ид+т независимо от программы.
77 diamond 2742
  * Данные должны сохраняться в памяти по крайней мере
2743
    до конца проигрывания.
2744
 
2745
======================================================================
114 mikedld 2746
============= Функция 56 - записать файл на ж+сткий диск. ============
77 diamond 2747
======================================================================
2748
Параметры:
2749
  * eax = 56 - номер функции
2750
  * ebx = указатель на имя файла
2751
  * ecx = размер данных для записи (в байтах)
2752
  * edx = указатель на данные для записи
2753
  * esi = указатель на путь (ASCIIZ-строку)
2754
Возвращаемое значение:
2755
  * eax = 0 - успешно, иначе код ошибки файловой системы
2756
Замечания:
83 diamond 2757
  * Эта функция устарела; функция 70 позволяет выполнять
77 diamond 2758
    те же действия с расширенными возможностями.
114 mikedld 2759
  * Данная функция предполагает, что во время е+ вызова одним
77 diamond 2760
    приложением никакое другое приложение не работает
114 mikedld 2761
    с ж+стким диском.
77 diamond 2762
  * Путь к файлу - ASCIIZ-строка, которая может быть пустой
114 mikedld 2763
    (если файл созда+тся в корневом каталоге) или иметь формат
77 diamond 2764
    /d1/d2/.../dn, где все имена папок должны иметь формат 8+3, т.е.
2765
    8 символов имени и 3 символа расширения без разделителя,
2766
    при необходимости дополненные пробелами;
2767
    все буквы должны быть заглавные.
2768
  * Имя к файлу также должно иметь формат 8+3.
2769
 
2770
======================================================================
2771
============== Функция 58 - работа с файловой системой. ==============
2772
======================================================================
2773
Параметры:
2774
  * eax = 58
2775
  * ebx = указатель на информационную структуру
2776
Возвращаемое значение:
2777
  * eax = 0 - успешно; иначе код ошибки файловой системы
2778
  * в зависимости от подфункции может возвращаться значение и
2779
    в других регистрах
2780
Общий формат информационной структуры:
2781
  * +0: dword: номер подфункции
2782
  * +4: dword: номер блока
2783
  * +8: dword: размер
2784
  * +12 = +0xC: dword: указатель на данные
2785
  * +16 = +0x10: dword: указатель на память для работы системы
2786
    (4096 байт)
2787
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
2788
Уточнения - в документации на соответствующую подфункцию.
2789
Имя файла нечувствительно к регистру латинских букв,
2790
русские буквы должны быть заглавными.
2791
Формат имени файла:
2792
/base/number/dir1/dir2/.../dirn/file,
2793
где /base/number идентифицирует устройство, на котором ищется файл:
2794
одно из
2795
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
2796
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
2797
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
114 mikedld 2798
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к ж+сткому диску
77 diamond 2799
    (в этом случае база определяется подфункцией 7 функции 21),
2800
    x - номер раздела (считая с 1)
2801
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
2802
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
2803
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2804
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
2805
    (на каждом из винчестеров нумерация начинается с 1)
2806
Замечания:
2807
  * В первых двух случаях допускается использование FIRST вместо 1,
2808
    SECOND вместо 2, но использовать эту возможность
2809
    не рекомендуется для удобства перехода на будущие расширения.
2810
  * Накладывается ограничение n<=39.
2811
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
2812
    имя не более 8 символов, точка, расширение не более 3 символов.
2813
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
2814
    Если имя занимает ровно 8 символов, точку можно опустить
2815
    (хотя пользоваться этим не рекомендуется для удобства перехода
2816
    на будущие расширения).
2817
Примеры:
2818
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2819
    '/rd/1/kernel.asm',0
2820
  * '/HD0/1/kernel.asm',0
2821
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2822
Доступные подфункции:
2823
  * подфункция 0 - чтение файла/папки
2824
  * подфункция 1 - перезапись файла
2825
  * подфункция 2 - удаление файла/папки
2826
  * подфункция 3 - запись данных в существующий файл
2827
  * подфункция 4 - создание папки
2828
  * подфункция 5 - переименование/перемещение файла/папки
2829
  * подфункция 8 - LBA-чтение с устройства
2830
  * подфункция 12 - определение размера файла
2831
  * подфункция 13 - определение атрибутов файла/папки
2832
  * подфункция 14 - определение даты/времени файла/папки
2833
  * подфункция 15 - получение информации о файловой системе
2834
  * подфункция 16 - запуск приложения
2835
 
2836
======================================================================
2837
========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
2838
======================================================================
2839
Параметры:
2840
  * eax = 58
2841
  * ebx = указатель на информационную структуру
2842
Формат информационной структуры:
2843
  * +0: dword: 0 = номер подфункции
2844
  * +4: dword: номер блока для чтения (считая с 0)
2845
  * +8: dword: число блоков для чтения
2846
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2847
  * +16 = +0x10: dword: указатель на буфер для работы системы
2848
    (4096 байт)
114 mikedld 2849
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 2850
    общем описании
2851
Возвращаемое значение:
2852
  * eax = 0 - успешно, иначе код ошибки файловой системы
2853
  * ebx = размер файла (в байтах) или
2854
    -1=0xffffffff, если файл не найден
2855
Замечания:
2856
  * Размер блока - 512 байт.
2857
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
2858
    функции 70, для чтения папок - подфункцию 1 функции 70.
2859
  * Функция позволяет читать содержимое папки. Из файловых систем
2860
    поддерживается только FAT. Формат FAT-папки описан в любой
2861
    документации по FAT.
2862
  * Размер папки определяется по размеру цепочки кластеров в FAT.
2863
  * Если файл кончился раньше, чем был прочитан последний запрошенный
114 mikedld 2864
    блок, то функция прочитает, сколько сможет, после чего верн+т
77 diamond 2865
    eax=6 (EOF).
2866
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
2867
    в первых двух случаях текущая реализация не следует
2868
    установленным правилам:
2869
    для /rd/1:
2870
    * если указано 0 блоков для чтения, считается,
2871
      что запрашивается 1;
2872
    * если запрашивается больше 14 блоков или начальный блок
2873
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
2874
    * размер корневого каталога рамдиска = 14 блоков,
2875
      0x1C00=7168 байт; но возвращается ebx=0
2876
      (за исключением случая предыдущего пункта);
2877
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
114 mikedld 2878
      мусор - напоминаю, сч+т вед+тся с 0);
77 diamond 2879
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
2880
      то возвращается eax=6(EOF); иначе eax=0.
2881
    Для /fd/x:
2882
    * если начальный блок не меньше 14-го, то возвращается
2883
      eax=5 (not found) и ebx=0;
2884
    * кстати говоря, формат FAT12 допускает дискеты с размером
2885
      корневого каталога меньше или больше 14 блоков;
2886
    * проверки длины не делается;
2887
    * если удалось прочитать данные с дискеты, возвращается
2888
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
2889
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
2890
    но результат не соответствует ожидаемому
2891
    (по работе с обычными файлами/папками), не следует установленным
2892
    правилам, может измениться в следующих версиях ядра и потому
2893
    не описывается. Для получения информации об оборудовании
2894
    используйте подфункцию 11 функции 18 или
2895
    читайте соответствующие папки подфункцией 1 функции 70.
2896
 
2897
======================================================================
2898
============ Функция 58, подфункция 1 - перезаписать файл. ===========
2899
======================================================================
114 mikedld 2900
Если файл не существует, он созда+тся.
77 diamond 2901
Если файл существует, он перезаписывается.
2902
Параметры:
2903
  * eax = 58 - номер функции
2904
  * ebx = указатель на информационную структуру
2905
Формат информационной структуры:
2906
  * +0: dword: 1 = номер подфункции
2907
  * +4: dword: игнорируется (устанавливайте в 0)
2908
  * +8: dword: число байт для записи
2909
  * +12 = +0xC: dword: указатель на данные для записи
2910
  * +16 = +0x10: dword: указатель на буфер для работы системы
2911
    (4096 байт)
114 mikedld 2912
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 2913
    общем описании
2914
Возвращаемое значение:
2915
  * eax = 0 - успешно, иначе код ошибки файловой системы
2916
  * ebx разрушается
83 diamond 2917
Замечания:
2918
  * Эта функция устарела, используйте подфункцию 2 функции 70.
77 diamond 2919
 
2920
======================================================================
2921
=========== Функция 58, подфункция 2 - удалить файл/папку. ===========
2922
======================================================================
2923
Параметры:
2924
  * eax = 58 - номер функции
2925
  * ebx = указатель на информационную структуру
2926
Формат информационной структуры:
2927
  * +0: dword: 2 = номер подфункции
2928
  * +4: dword: игнорируется
2929
  * +8: dword: игнорируется
2930
  * +12 = +0xC: dword: игнорируется
2931
  * +16 = +0x10: dword: указатель на буфер для работы системы
2932
    (4096 байт)
114 mikedld 2933
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 2934
    общем описании
2935
Возвращаемое значение:
2936
  * eax = 0 - успешно, иначе код ошибки файловой системы
2937
  * ebx разрушается
2938
Замечания:
2939
  * При работе с дискетой не следует удалять непустую папку.
114 mikedld 2940
    Код работы с ж+стким диском непустые папки удаляет корректно
77 diamond 2941
    (т.е. рекурсивно со всеми файлами и вложенными папками).
2942
    Рамдиск папок не поддерживает.
2943
 
2944
======================================================================
2945
==== Функция 58, подфункция 3 - запись данных в существующий файл. ===
2946
======================================================================
2947
Параметры:
2948
  * eax = 58 - номер функции
2949
  * ebx = указатель на информационную структуру
2950
Формат информационной структуры:
2951
  * +0: dword: 3 = номер подфункции
2952
  * +4: dword: начальная позиция в файле; -1 = дописывать в конец
2953
  * +8: dword: число байт для записи
2954
  * +12 = +0xC: dword: указатель на данные для записи
2955
  * +16 = +0x10: dword: указатель на буфер для работы системы
2956
    (4096 байт)
114 mikedld 2957
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 2958
    общем описании
2959
Возвращаемое значение:
2960
  * eax = 0 - успешно, иначе код ошибки файловой системы
2961
  * ebx разрушается
2962
Замечания:
2963
  * Рамдиск и дискеты не поддерживают эту функцию, она только для
114 mikedld 2964
    ж+стких дисков.
77 diamond 2965
  * Файл должен уже существовать (иначе возвращается 5, not found).
2966
    Для создания файлов используйте подфункцию 1.
2967
  * Если начальная позиция больше размера файла, возвращается
2968
    eax=6(EOF). Если конечная позиция больше размера файла,
2969
    файл расширяется.
114 mikedld 2970
  * Код обработки записи данных для ж+сткого диска интерпретирует
77 diamond 2971
    нулевое значение поля +8 как указание усечения файла до размера,
2972
    указанного в поле +4. Однако код обработки 58-й функции блокирует
2973
    эту возможность для приложений, сразу возвращая управление
2974
    (с eax=0) в случае нулевого размера.
2975
 
2976
======================================================================
2977
============== Функция 58, подфункция 4 - создать папку. =============
2978
======================================================================
2979
Параметры:
2980
  * eax = 58 - номер функции
2981
  * ebx = указатель на информационную структуру
2982
Формат информационной структуры:
2983
  * +0: dword: 4 = номер подфункции
2984
  * +4: dword: игнорируется
2985
  * +8: dword: игнорируется
2986
  * +12 = +0xC: dword: игнорируется
2987
  * +16 = +0x10: dword: указатель на буфер для работы системы
2988
    (4096 байт)
114 mikedld 2989
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 2990
    общем описании
2991
Возвращаемое значение:
2992
  * eax = 0 - успешно, иначе код ошибки файловой системы
2993
  * ebx разрушается
2994
Замечания:
2995
  * Рамдиск и дискеты не поддерживают эту функцию,
114 mikedld 2996
    она только для ж+стких дисков.
77 diamond 2997
 
2998
======================================================================
2999
== Функция 58, подфункция 5 - переименовать/переместить файл/папку. ==
3000
======================================================================
3001
Параметры:
3002
  * eax = 58 - номер функции
3003
  * ebx = указатель на информационную структуру
3004
Формат информационной структуры:
3005
  * +0: dword: 5 = номер подфункции
3006
  * +4: dword: игнорируется
3007
  * +8: dword: игнорируется
3008
  * +12 = +0xC: dword: игнорируется
3009
  * +16 = +0x10: dword: указатель на буфер для работы системы
3010
    (4096 байт)
114 mikedld 3011
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 3012
    общем описании
3013
  * +20+n: (сразу после завершающего нулевого символа) новое
3014
    ASCIIZ-имя, должно начинаться с /hd/1, что интерпретируется как
114 mikedld 3015
    ж+сткий диск, указанный в первом имени
77 diamond 3016
    (перемещение с одного диска на другой не поддерживается)
3017
Возвращаемое значение:
3018
  * eax = 0 - успешно, иначе код ошибки файловой системы
3019
  * ebx разрушается
3020
Замечания:
3021
  * Рамдиск и дискеты не поддерживают эту функцию,
114 mikedld 3022
    она только для ж+стких дисков.
77 diamond 3023
  * Если новое ASCIIZ-имя сильно неправильное, т.е. не начинается с
3024
    /hd/1, /hd/first, /harddisk/1, /harddisk/first или после этого
114 mikedld 3025
    начала ид+т пробел или символ с кодом 0, то функция возвращает,
77 diamond 3026
    как ни странно, код ошибки 4. Это единственная функция, которая
3027
    вообще возвращает этот код.
3028
 
3029
======================================================================
3030
========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
3031
======================================================================
3032
Параметры:
3033
  * eax = 58 - номер функции
3034
  * ebx = указатель на информационную структуру
3035
Формат информационной структуры:
3036
  * +0: dword: 8 = номер подфункции
3037
  * +4: dword: номер блока для чтения (считая с 0)
3038
  * +8: dword: игнорируется (устанавливайте в 1)
3039
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
3040
    (512 байт)
3041
  * +16 = +0x10: dword: указатель на буфер для работы системы
3042
    (4096 байт)
3043
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
3044
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
3045
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
3046
    Вместо цифр допускается, хотя и не рекомендуется для удобства
3047
    перехода на будущие расширения,
3048
    использование 'first','second','third','fourth'.
3049
Возвращаемое значение:
3050
  * если указано имя устройства /hd/xxx, где xxx не находится
3051
    в списке выше:
3052
    * eax = ebx = 1
3053
  * если указано неправильное имя устройства
3054
    (за исключением предыдущего случая):
3055
    * eax = 5
3056
    * ebx не меняется
114 mikedld 3057
  * если LBA-доступ запрещ+н подфункцией 11 функции 21:
77 diamond 3058
    * eax = 2
3059
    * ebx разрушается
3060
  * для рамдиска: попытка чтения блока за пределами рамдиска
3061
    (18*2*80 блоков) приводит к
3062
    * eax = 3
3063
    * ebx = 0
3064
  * при успешном чтении:
3065
    * eax = ebx = 0
3066
Замечания:
3067
  * Размер блока - 512 байт; читается один блок.
3068
  * Не следует полагаться на возвращаемое значение,
3069
    оно может измениться в следующих версиях.
114 mikedld 3070
  * Требуется, чтобы был разреш+н LBA-доступ к устройствам
77 diamond 3071
    подфункцией 11 функции 21. Узнать это можно вызовом
3072
    подфункцией 11 функции 26.
3073
  * LBA-чтение дискеты не поддерживается.
114 mikedld 3074
  * Функция считывает данные физического ж+сткого диска;
77 diamond 3075
    если по каким-то причинам нужны данные конкретного раздела,
114 mikedld 3076
    прид+тся определять начальный сектор этого раздела
77 diamond 3077
    (либо напрямую через MBR, либо из расширенной структуры,
3078
    возвращаемой той же подфункцией 11 функции 18).
114 mikedld 3079
  * Функция не проверяет код ошибки ж+сткого диска, так что запрос
3080
    несуществующего сектора вс+ равно что-то прочитает
77 diamond 3081
    (вероятнее всего, нули, но это определяется устройством) и
3082
    это будет считаться успехом (eax=0).
3083
 
3084
======================================================================
3085
= Функция 58, подфункция 15 - получить информацию о файловой системе.
3086
======================================================================
3087
Параметры:
3088
  * eax = 58 - номер функции
3089
  * ebx = указатель на информационную структуру
3090
Формат информационной структуры:
3091
  * +0: dword: 15 = номер функции
3092
  * +4: dword: игнорируется
3093
  * +8: dword: игнорируется
3094
  * +12 = +0xC: dword: игнорируется
3095
  * +16 = +0x10: dword: игнорируется
3096
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
3097
    /rd=/RAMDISK или /hd=/HARDDISK
3098
Возвращаемое значение:
3099
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
3100
    * eax = 3
3101
    * ebx = ecx = dword [fileinfo] = 0
3102
  * для рамдиска:
3103
    * eax = 0 (успех)
3104
    * ebx = общее число кластеров = 2847
3105
    * ecx = число свободных кластеров
3106
    * dword [fileinfo] = размер кластера = 512
114 mikedld 3107
  * для ж+сткого диска: база и раздел определяются подфункциями 7 и 8
77 diamond 3108
    функции 21:
3109
    * eax = 0 (успех)
3110
    * ebx = общее число кластеров
3111
    * ecx = число свободных кластеров
3112
    * dword [fileinfo] = размер кластера (в байтах)
3113
Замечания:
3114
  * Не удивляйтесь странному расположению 4-го возвращаемого
3115
    параметра - когда писался этот код, при системных вызовах
3116
    приложению возвращались только регистры eax,ebx,ecx (из
3117
    pushad-структуры, передающейся как аргумент системной функции).
3118
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
3119
    размер кластера в edx, пока эту функцию не начали использовать.
114 mikedld 3120
  * Вообще-то ещ+ существует подфункция 11 функции 18, возвращающая
77 diamond 3121
    информацию о файловой системе. По расширенной таблице дисковой
3122
    подсистемы можно определить размер кластера (там он хранится
114 mikedld 3123
    в секторах) и общее число кластеров для ж+стких дисков.
77 diamond 3124
 
3125
======================================================================
3126
========== Функция 58, подфункция 16 - запустить программу. ==========
3127
======================================================================
3128
Параметры:
3129
  * eax = 58 - номер функции
3130
  * ebx = указатель на информационную структуру
3131
Формат информационной структуры:
3132
  * +0: dword: 16 = номер подфункции
3133
  * +4: dword: поле флагов:
3134
    * бит 0: запустить процесс как отлаживаемый
3135
    * остальные биты зарезервированы и должны быть установлены в 0
3136
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
3137
  * +12 = +0xC: dword: игнорируется
3138
  * +16 = +0x10: dword: указатель на буфер для работы системы
3139
    (4096 байт)
114 mikedld 3140
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 3141
    общем описании
3142
Возвращаемое значение:
3143
  * eax > 0 - программа загружена, eax содержит PID
3144
  * eax < 0 - произошла ошибка, -eax содержит
3145
    код ошибки файловой системы
3146
Замечания:
91 diamond 3147
  * Эта функция устарела, используйте подфункцию 7 функции 70.
114 mikedld 3148
  * Командная строка должна заканчиваться символом с кодом 0
77 diamond 3149
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
3150
    включительно, либо первые 256 символов, в зависимости от того,
3151
    что меньше.
114 mikedld 3152
  * Если процесс запускается как отлаживаемый, он созда+тся
77 diamond 3153
    в замороженном состоянии; для запуска используйте
3154
    подфункцию 5 функции 69.
3155
 
3156
======================================================================
92 diamond 3157
=== Функция 59 - получить информацию о последних системных вызовах. ==
3158
======================================================================
3159
Получает данные о всех системных вызовах всех процессов.
3160
Параметры:
3161
  * eax = 59 - номер функции
3162
  * ebx = 0 - единственная подфункция
3163
  * ecx = указатель на буфер
3164
  * edx = размер буфера
3165
Возвращаемое значение:
3166
  * eax = общее число системных вызовов,
3167
    сделанных с момента загрузки системы (по модулю 2^32)
3168
  * ebx = 0
3169
Формат информации об одном вызове: (размер = 0x40 = 64 байта)
3170
  * +0: dword: PID процесса/потока
3171
  * +4: 7*dword: мусор
3172
  * +32 = +0x20: dword: значение edi при вызове
3173
  * +36 = +0x24: dword: esi
3174
  * +40 = +0x28: dword: ebp
3175
  * +44 = +0x2C: dword: указатель стэка обработчика ядра
3176
  * +48 = +0x30: dword: ebx
3177
  * +52 = +0x34: dword: edx
3178
  * +56 = +0x38: dword: ecx
3179
  * +60 = +0x3C: dword: eax (=номер системной функции)
3180
Замечания:
3181
  * Функция используется только в приложении systrace.
3182
    Довольно трудно представить ситуацию, в которой это приложение
3183
    или эта функция действительно полезны, а вот все системные вызовы
3184
    для поддержки этой функции несколько замедляются
3185
    (хотя и ненамного)...
3186
  * В связи с этим есть предложение поддержку этой функции
3187
    из ядра убрать совсем, вместе с приложением systrace.
3188
  * Информация о системных вызовах сохраняется в
3189
    системном кольцевом буфере на 0x10 входов.
114 mikedld 3190
    Эта функция просто копирует указанный объ+м данных
92 diamond 3191
    из упомянутого буфера по указанному адресу.
3192
  * Какой из входов в буфере соответствует последнему вызову,
3193
    можно определить по значению eax, а именно,
3194
    вход (eax and 0xF) (по смещению (eax and 0xF)*0x40).
3195
  * В текущей реализации возможны редко встречающиеся
3196
    проблемы рассинхронизации, когда о некоторых вызовах
3197
    информация устаревает.
3198
  * Под системный буфер выделена страница, 4Кб.
3199
    Размер входа = 64 байта.
3200
    Почему используется только 16 входов - непонятно.
3201
  * Значение esp в момент системного вызова
3202
    этой функцией узнать нельзя.
3203
  * Проверки корректности edx в текущей реализации не делается.
3204
 
3205
======================================================================
77 diamond 3206
=========== Функция 60 - Inter Process Communication (IPC). ==========
3207
======================================================================
3208
IPC применяется для посылок сообщений от одного процесса/потока
3209
другому. При этом следует предварительно договориться о том, как
3210
интерпретировать конкретное сообщение.
3211
 
3212
-------- Подфункция 1 - установить область для получения IPC ---------
114 mikedld 3213
Вызывается процессом-при+мником.
77 diamond 3214
Параметры:
3215
  * eax = 60 - номер функции
3216
  * ebx = 1 - номер подфункции
3217
  * ecx = указатель на буфер
3218
  * edx = размер буфера
3219
Возвращаемое значение:
3220
  * eax = 0 - всегда успешно
3221
Формат IPC-буфера:
3222
  * +0: dword: если здесь не 0, то буфер считается заблокированным;
3223
    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
3224
    и вам надо, чтобы извне не изменялись данные буфера
3225
    (не поступали новые сообщения)
3226
  * +4: dword: занято места в буфере (в байтах)
3227
  * +8: первое сообщение
3228
  * +8+n: второе сообщение
3229
  * ...
3230
Формат сообщения:
3231
  * +0: dword: PID процесса/потока, пославшего сообщение
3232
  * +4: dword: длина сообщения (не считая этот заголовок)
3233
  * +8: n*byte: данные сообщения
3234
 
3235
--------------- Подфункция 2 - послать сообщение IPC. ----------------
3236
Вызывается процессом-инициатором.
3237
Параметры:
3238
  * eax = 60 - номер функции
3239
  * ebx = 2 - номер подфункции
114 mikedld 3240
  * ecx = PID при+мника
77 diamond 3241
  * edx = указатель на данные сообщения
3242
  * esi = длина сообщения (в байтах)
3243
Возвращаемое значение:
3244
  * eax = 0 - успешно
114 mikedld 3245
  * eax = 1 - при+мник не определил буфер для IPC-сообщений
3246
    (может быть, ещ+ не успел, а может быть, это не тот поток,
77 diamond 3247
    который нужен)
114 mikedld 3248
  * eax = 2 - при+мник заблокировал IPC-буфер;
77 diamond 3249
    попробуйте немного подождать
114 mikedld 3250
  * eax = 3 - переполнение IPC-буфера при+мника
77 diamond 3251
  * eax = 4 - процесса/потока с таким PID не существует
3252
Замечания:
3253
  * Система сразу после записи IPC-сообщения в буфер посылает
114 mikedld 3254
    потоку-при+мнику событие с кодом 7 (см. коды событий).
77 diamond 3255
 
3256
======================================================================
3257
=== Функция 61 - получить параметры для прямого доступа к графике. ===
3258
======================================================================
3259
Программе доступны данные графического экрана (область памяти, которая
3260
собственно и отображает содержимое экрана) напрямую без вызовов
3261
системных функций через селектор gs:
114 mikedld 3262
    mov    eax, [gs:0]
77 diamond 3263
поместит в eax первый dword буфера, содержащий информацию о цвете
3264
левой верхней точки (и, возможно, цвета нескольких следующих).
114 mikedld 3265
    mov    [gs:0], eax
77 diamond 3266
при работе в режимах VESA c LFB
3267
установит цвет левой верхней точки
3268
(и возможно, цвета нескольких следующих).
3269
Для интерпретации данных графического экрана требуется знание
3270
некоторых параметров, которые возвращаются этой функцией.
3271
Замечания:
3272
  * Параметры графики очень редко меняются при работе системы,
3273
    а именно, только в случаях, когда пользователь работает
3274
    с программой VRR.
3275
  * При изменении видеорежима система перерисовывает все окна
3276
    (событие с кодом 1) и перерисовывает фон (событие 5).
3277
    Эти же события происходят и в других случаях,
3278
    которые встречаются значительно чаще, чем изменение видеорежима.
3279
  * При работе в видеорежимах с LFB селектор gs указывает на
3280
    собственно LFB, так что чтение/запись по gs приводят
3281
    непосредственно к изменению содержимого экрана. При работе в
3282
    видеорежимах без LFB gs указывает на некоторую область данных
114 mikedld 3283
    ядра, прич+м все функции вывода на экран добросовестно выполняют
77 diamond 3284
    двойную работу по записи непосредственно на экран и по записи
3285
    в этот буфер. В результате при чтении содержимого этого буфера
3286
    результаты соответствуют содержимому экрана
3287
    (с, вообще говоря, большим цветовым разрешением),
3288
    а запись игнорируется.
3289
    Исключением является режим 320*200, для которого в главном цикле
3290
    системного потока выполняется обновление экрана в соответствии
3291
    с движениями курсора мыши.
3292
 
3293
------------------------- Разрешение экрана --------------------------
3294
Параметры:
3295
  * eax = 61 - номер функции
3296
  * ebx = 1 - номер подфункции
3297
Возвращаемое значение:
3298
  * eax = [разрешение по оси x]*65536 + [разрешение по оси y]
3299
Замечания:
114 mikedld 3300
  * Можно использовать функцию 14 с уч+том того, что она возвращает
77 diamond 3301
    размеры на 1 меньше. Это полностью эквивалентный способ.
3302
 
3303
------------------------ Число бит на пиксель ------------------------
3304
Параметры:
3305
  * eax = 61 - номер функции
3306
  * ebx = 2 - номер подфункции
3307
Возвращаемое значение:
3308
  * eax = число бит на пиксель (24 или 32)
3309
 
3310
------------------------ Число байт на строку ------------------------
3311
Параметры:
3312
  * eax = 61 - номер функции
3313
  * ebx = 3 - номер подфункции
3314
Возвращаемое значение:
114 mikedld 3315
  * eax = число байт, которое занимает одна строка разв+ртки
77 diamond 3316
    (горизонтальная линия на экране)
3317
 
3318
======================================================================
3319
===== Функция 62, подфункция 0 - получить версию PCI-интерфейса. =====
3320
======================================================================
3321
Параметры:
3322
  * eax = 62 - номер функции
3323
  * bl = 0 - номер подфункции
3324
Возвращаемое значение:
114 mikedld 3325
  * eax = -1 - доступ к PCI запрещ+н; иначе
77 diamond 3326
  * ah.al = версия PCI-интерфейса (ah=версия, al=подверсия)
3327
  * старшее слово eax обнулено
3328
Замечания:
114 mikedld 3329
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3330
    для приложений подфункцией 12 функции 21.
114 mikedld 3331
  * Если PCI BIOS не поддерживается, то значение ax не определено.
77 diamond 3332
 
3333
======================================================================
3334
==== Функция 62, подфункция 1 - получить номер последней PCI-шины. ===
3335
======================================================================
3336
Параметры:
3337
  * eax = 62 - номер функции
3338
  * bl = 1 - номер подфункции
3339
Возвращаемое значение:
114 mikedld 3340
  * eax = -1 - доступ к PCI запрещ+н; иначе
3341
  * al = номер последней PCI-шины; оставшиеся биты eax разрушаются
77 diamond 3342
Замечания:
114 mikedld 3343
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3344
    для приложений подфункцией 12 функции 21.
114 mikedld 3345
  * Если PCI BIOS не поддерживается, то значение al не определено.
77 diamond 3346
 
3347
======================================================================
3348
====================== Функция 62, подфункция 2 ======================
3349
== Получить механизм обращения к конфигурационному пространству PCI. =
3350
======================================================================
3351
Параметры:
3352
  * eax = 62 - номер функции
3353
  * bl = 2 - номер подфункции
3354
Возвращаемое значение:
114 mikedld 3355
  * eax = -1 - доступ к PCI запрещ+н; иначе
3356
  * al = механизм (1 или 2); прочие биты eax разрушаются
77 diamond 3357
Замечания:
114 mikedld 3358
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3359
    для приложений подфункцией 12 функции 21.
3360
  * Механизм обращения выбирается в соответствии
3361
    с характеристиками оборудования.
3362
  * Подфункции чтения и записи автоматически работают
3363
    с выбранным механизмом.
3364
 
3365
======================================================================
3366
======== Функция 62, подфункции 4,5,6 - прочитать PCI-регистр. =======
3367
======================================================================
3368
Параметры:
3369
  * eax = 62 - номер функции
3370
  * bl = 4 - читать байт
3371
  * bl = 5 - читать слово
3372
  * bl = 6 - читать двойное слово
3373
  * bh = номер PCI-шины
3374
  * ch = dddddfff, где ddddd = номер устройства на шине,
3375
    fff = номер функции устройства
114 mikedld 3376
  * cl = номер регистра (должен быть ч+тным для bl=5,
77 diamond 3377
    делиться на 4 для bl=6)
3378
Возвращаемое значение:
114 mikedld 3379
  * eax = -1 - ошибка (запрещ+н доступ к PCI или
77 diamond 3380
    неподдерживаемые параметры); иначе
3381
  * al/ax/eax (в зависимости от запрошенного размера) содержит данные;
3382
    оставшаяся часть регистра eax разрушается
3383
Замечания:
114 mikedld 3384
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3385
    для приложений подфункцией 12 функции 21.
3386
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3387
    игнорирует номер функции. Получить механизм доступа можно вызовом
3388
    подфункции 2.
3389
  * Некоторые регистры стандартны и существуют для всех устройств,
3390
    некоторые определяются конкретным устройством. Список первых
3391
    входит, например, в известный Interrupt List by Ralf Brown
3392
    (http://www.pobox.com/~ralf/files.html,
3393
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3394
    список вторых должен быть указан в документации по устройству.
3395
 
3396
======================================================================
3397
======= Функция 62, подфункции 8,9,10 - записать в PCI-регистр. ======
3398
======================================================================
3399
Параметры:
3400
  * eax = 62 - номер функции
3401
  * bl = 8 - писать байт
3402
  * bl = 9 - писать слово
3403
  * bl = 10 - писать двойное слово
3404
  * bh = номер PCI-шины
3405
  * ch = dddddfff, где ddddd = номер устройства на шине,
3406
    fff = номер функции устройства
114 mikedld 3407
  * cl = номер регистра (должен быть ч+тным для bl=9,
77 diamond 3408
    делиться на 4 для bl=10)
92 diamond 3409
  * dl/dx/edx (в зависимости от запрошенного размера) содержит
3410
    данные для записи
77 diamond 3411
Возвращаемое значение:
114 mikedld 3412
  * eax = -1 - ошибка (запрещ+н доступ к PCI или
77 diamond 3413
    неподдерживаемые параметры)
3414
  * eax = 0 - успешно
3415
Замечания:
114 mikedld 3416
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3417
    для приложений подфункцией 12 функции 21.
3418
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3419
    игнорирует номер функции. Получить механизм доступа можно вызовом
3420
    подфункции 2.
3421
  * Некоторые регистры стандартны и существуют для всех устройств,
3422
    некоторые определяются конкретным устройством. Список первых
3423
    входит, например, в известный Interrupt List by Ralf Brown;
3424
    список вторых должен быть указан в документации по устройству.
3425
 
3426
======================================================================
3427
================ Функция 63 - работа с доской отладки. ===============
3428
======================================================================
3429
Доска отладки представляет собой системный буфер (на 512 байт),
3430
в который любая программа может записать (вообще говоря, произвольные)
3431
данные и из которого другая программа может эти данные прочитать.
3432
Есть соглашение, в соответствии с которым записываемые данные -
3433
текстовые строки, интерпретируемые как отладочные сообщения о ходе
114 mikedld 3434
выполнения программы. Ядро в определ+нных ситуациях также записывает
77 diamond 3435
на доску отладки сведения о выполнении некоторых функций;
3436
по соглашению сообщения ядра начинаются с префикса "K : ".
3437
Для просмотра доски отладки создано приложение board,
114 mikedld 3438
которое считывает данные из буфера и отображает их в сво+м окне. board
77 diamond 3439
понимает последовательность кодов 13,10 как переход на новую строку.
3440
Символ с нулевым кодом в конце строки не обязателен, но и не мешает.
3441
В связи с появлением отладчика ценность доски отладки несколько
3442
снизилась, поскольку отладчик позволяет полностью контролировать ход
114 mikedld 3443
выполнения программы, прич+м для этого не требуется никаких усилий
77 diamond 3444
со стороны самой программы. Тем не менее во многих случаях
3445
доска отладки продолжает оставаться полезной.
3446
 
3447
---------------------------- Запись байта ----------------------------
3448
Параметры:
3449
  * eax = 63 - номер функции
3450
  * ebx = 1 - номер подфункции
3451
  * cl = байт данных
3452
Возвращаемое значение:
3453
  * функция не возвращает значения
3454
Замечания:
3455
  * Байт записывается в буфер. Длина буфера - 512 байт.
3456
    При переполнении буфера все полученные данные теряются
3457
    и заполнение начинается снова с нуля.
3458
  * Для вывода на доску отладки более сложных объектов (строк, чисел)
3459
    достаточно этой функции, вызываемой в цикле. Можно не писать
3460
    вручную соответствующий код, а воспользоваться файлом debug.inc,
3461
    входящим в дистрибутив.
3462
 
3463
---------------------------- Чтение байта ----------------------------
3464
Забирает байт из буфера.
3465
Параметры:
3466
  * eax = 63 - номер функции
3467
  * ebx = 2 - номер подфункции
3468
Возвращаемое значение:
3469
  * eax = ebx = 0 - буфер пуст
3470
  * eax = байт, ebx = 1 - байт успешно прочитан
3471
 
3472
======================================================================
3473
========== Функция 64 - перераспределить память приложения. ==========
3474
======================================================================
3475
Параметры:
3476
  * eax = 64 - номер функции
3477
  * ebx = 1 - единственная подфункция
3478
  * ecx = новый размер памяти
3479
Возвращаемое значение:
3480
  * eax = 0 - успешно
3481
  * eax = 1 - недостаточно памяти
3482
Замечания:
3483
  * На данный момент эта функция является единственным средством для
3484
    динамического выделения/освобождения памяти приложения.
3485
 
3486
======================================================================
92 diamond 3487
================= Функция 66 - работа с клавиатурой. =================
77 diamond 3488
======================================================================
92 diamond 3489
Режим ввода влияет на результаты чтения клавиш функцией 2.
114 mikedld 3490
При загрузке программы для не+ устанавливается ASCII-режим ввода.
77 diamond 3491
 
92 diamond 3492
-------- Подфункция 1 - установить режим ввода с клавиатуры. ---------
77 diamond 3493
Параметры:
3494
  * eax = 66 - номер функции
3495
  * ebx = 1 - номер подфункции
3496
  * ecx = режим:
3497
    * 0 = обычный (ASCII-символы)
3498
    * 1 = сканкоды
3499
Возвращаемое значение:
3500
  * функция не возвращает значения
3501
 
92 diamond 3502
--------- Подфункция 2 - получить режим ввода с клавиатуры. ----------
77 diamond 3503
Параметры:
3504
  * eax = 66 - номер функции
3505
  * ebx = 2 - номер подфункции
3506
Возвращаемое значение:
3507
  * eax = текущий режим
3508
 
3509
------- Подфункция 3 - получить состояние управляющих клавиш. --------
3510
Параметры:
3511
  * eax = 66 - номер функции
3512
  * ebx = 3 - номер подфункции
3513
Возвращаемое значение:
3514
  * eax = битовая маска:
3515
  * бит 0 (маска 1): левый Shift нажат
3516
  * бит 1 (маска 2): правый Shift нажат
3517
  * бит 2 (маска 4): левый Ctrl нажат
3518
  * бит 3 (маска 8): правый Ctrl нажат
3519
  * бит 4 (маска 0x10): левый Alt нажат
3520
  * бит 5 (маска 0x20): правый Alt нажат
114 mikedld 3521
  * бит 6 (маска 0x40): CapsLock включ+н
3522
  * бит 7 (маска 0x80): NumLock включ+н
3523
  * бит 8 (маска 0x100): ScrollLock включ+н
77 diamond 3524
  * прочие биты сброшены
3525
 
92 diamond 3526
----- Подфункция 4 - установить общесистемную "горячую клавишу". -----
3527
О нажатии "горячей клавиши" извещаются только приложения,
114 mikedld 3528
установившие е+; активное приложение (к которому поступает
92 diamond 3529
весь нормальный ввод) таких клавиш не получает.
3530
Извещение заключается в посылке события с кодом 2.
3531
Прочитать "горячую клавишу" можно так же, как и обычную, -
3532
функцией 2.
3533
Параметры:
3534
  * eax = 66 - номер функции
3535
  * ebx = 4 - номер подфункции
114 mikedld 3536
  * cl зада+т сканкод клавиши;
92 diamond 3537
    используйте cl=0 для задания комбинаций типа Ctrl+Shift
114 mikedld 3538
  * edx = 0xXYZ зада+т возможные состояния управляющих клавиш:
3539
    * Z (младшие 4 бита) зада+т состояние клавиш LShift и RShift:
92 diamond 3540
      * 0 = ни одна из клавиш не должна быть нажата;
3541
      * 1 = ровно одна из клавиш должна быть нажата;
3542
      * 2 = обе клавиши должны быть нажаты;
3543
      * 3 = должна быть нажата LShift, но не RShift;
3544
      * 4 = должна быть нажата RShift, но не LShift
3545
    * Y - аналогично для LCtrl и RCtrl;
3546
    * X - аналогично для LAlt и RAlt
3547
Возвращаемое значение:
3548
  * eax=0 - успешно
3549
  * eax=1 - слишком много "горячих клавиш" (допускается максимум 256)
3550
Замечания:
3551
  * Горячая клавиша может срабатывать либо при нажатии,
3552
    либо при отпускании. Сканкод отпускания клавиши на 128 больше,
3553
    чем сканкод нажатия (т.е. установлен старший бит).
3554
  * Несколько приложений могут установить одну и ту же комбинацию;
3555
    о нажатии такой комбинации будут извещаться все такие приложения.
3556
 
3557
------ Подфункция 5 - удалить установленную "горячую клавишу". -------
3558
Параметры:
3559
  * eax = 66 - номер функции
3560
  * ebx = 5 - номер подфункции
3561
  * cl = сканкод клавиши и edx = 0xXYZ такие же, как и в подфункции 4
3562
Возвращаемое значение:
3563
  * eax = 0 - успешно
3564
  * eax = 1 - нет такой горячей клавиши
3565
Замечания:
3566
  * При завершении процесса/потока удаляются все установленные им
3567
    горячие клавиши.
3568
  * Вызов функции не влияет на другие приложения.
3569
    Если другое приложение определило эту же комбинацию,
3570
    оно по-прежнему будет получать уведомления.
3571
 
77 diamond 3572
======================================================================
3573
============ Функция 67 - изменить положение/размеры окна. ===========
3574
======================================================================
3575
Параметры:
3576
  * eax = 67 - номер функции
3577
  * ebx = новая x-координата окна
3578
  * ecx = новая y-координата окна
3579
  * edx = новый x-размер окна
3580
  * esi = новый y-размер окна
3581
Возвращаемое значение:
3582
  * функция не возвращает значения
3583
Замечания:
3584
  * Значение -1 для параметра означает "не изменять"; например, для
3585
    перемещения окна без изменения размеров можно указать edx=esi=-1.
3586
  * Предварительно окно должно быть определено функцией 0.
114 mikedld 3587
    Она же зада+т начальные координаты и размеры окна.
77 diamond 3588
  * Размеры окна понимаются в смысле функции 0, т.е.
3589
    на один пиксель меньше, чем реальные размеры.
3590
  * Вызов функции для максимизированных окон просто игнорируется.
3591
  * Для окон соответствующих стилей положение и/или размеры могут быть
3592
    изменены пользователем; текущие положение и размеры могут быть
3593
    получены вызовом функции 9.
3594
  * Функция посылает окну событие перерисовки (с кодом 1).
3595
 
3596
======================================================================
114 mikedld 3597
=== Функция 68, подфункция 0 - получить сч+тчик переключений задач. ==
77 diamond 3598
======================================================================
3599
Параметры:
3600
  * eax = 68 - номер функции
3601
  * ebx = 0 - номер подфункции
3602
Возвращаемое значение:
3603
  * eax = число переключений задач с момента загрузки системы
3604
    (по модулю 2^32)
3605
 
3606
======================================================================
3607
====================== Функция 68, подфункция 1 ======================
3608
============ Переключиться на следующий поток выполнения. ============
3609
======================================================================
3610
Функция завершает текущий квант времени, выделенный потоку,
3611
и переключается на следующий.
3612
(Какой поток какого процесса будет следующим, предсказать нельзя).
114 mikedld 3613
Позднее, когда до текущего потока дойд+т очередь,
77 diamond 3614
выполнение возобновится.
3615
Параметры:
3616
  * eax = 68 - номер функции
3617
  * ebx = 1 - номер подфункции
3618
Возвращаемое значение:
3619
  * функция не возвращает значения
3620
 
3621
======================================================================
3622
=============== Функция 68, подфункция 2 - кэш + rdpmc. ==============
3623
======================================================================
3624
Параметры:
3625
  * eax = 68 - номер функции
3626
  * ebx = 2 - номер подфункции
3627
  * ecx = требуемое действие:
3628
    * ecx = 0 - разрешить выполнение инструкции rdpmc
3629
      (ReaD Performance-Monitoring Counters)
114 mikedld 3630
    * ecx = 1 - узнать, включ+н/выключен кэш
77 diamond 3631
    * ecx = 2 - включить кэш
3632
    * ecx = 3 - выключить кэш
3633
Возвращаемое значение:
3634
  * для ecx=0:
3635
    * eax = значение cr4
3636
  * для ecx=1:
3637
    * eax = (cr0 and 0x60000000):
114 mikedld 3638
    * eax = 0 - кэш включ+н
77 diamond 3639
    * eax <> 0 - кэш выключен
3640
  * для ecx=2 и ecx=3:
3641
    * функция не возвращает значения
3642
 
3643
======================================================================
3644
========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
3645
======================================================================
3646
MSR = Model Specific Register; полный список MSR-регистров процессора
3647
содержится в документации по процессору (например, IA-32 Intel
3648
Architecture Software Developer's Manual, Volume 3, Appendix B);
114 mikedld 3649
каждое семейство процессоров имеет сво+ подмножество MSR-регистров.
77 diamond 3650
Параметры:
3651
  * eax = 68 - номер функции
3652
  * ebx = 3 - номер подфункции
3653
  * ecx игнорируется
3654
  * edx = адрес MSR
3655
Возвращаемое значение:
3656
  * ebx:eax = старший:младший dword результата
3657
Замечания:
3658
  * Указание в ecx несуществующего или нереализованного для данного
114 mikedld 3659
    процессора MSR повлеч+т исключение в ядре, которое прибь+т поток.
77 diamond 3660
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3661
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
114 mikedld 3662
    которое вс+ равно прибь+т поток.
77 diamond 3663
 
3664
======================================================================
3665
========= Функция 68, подфункция 4 - записать в MSR-регистр. =========
3666
======================================================================
3667
MSR = Model Specific Register; полный список MSR-регистров процессора
3668
содержится в документации по процессору (например, IA-32 Intel
3669
Architecture Software Developer's Manual, Volume 3, Appendix B);
114 mikedld 3670
каждое семейство процессоров имеет сво+ подмножество MSR-регистров.
77 diamond 3671
Параметры:
3672
  * eax = 68 - номер функции
3673
  * ebx = 4 - номер подфункции
3674
  * ecx игнорируется
3675
  * edx = адрес MSR
3676
  * esi:edi = старший:младший dword
3677
Возвращаемое значение:
3678
  * ebx:eax = копия esi:edi
3679
Замечания:
3680
  * Указание в ecx несуществующего или нереализованного для данного
114 mikedld 3681
    процессора MSR повлеч+т исключение в ядре, которое прибь+т поток.
77 diamond 3682
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3683
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
114 mikedld 3684
    которое вс+ равно прибь+т поток.
77 diamond 3685
 
3686
======================================================================
3687
======= Функция 68, подфункция 5 - выделить физическую память. =======
3688
======================================================================
3689
Параметры:
3690
  * eax = 68 - номер функции
3691
  * ebx = 5 - номер подфункции
3692
  * ecx = размер (в байтах)
3693
Возвращаемое значение:
3694
  * eax = физический адрес выделенной памяти
3695
Замечания:
3696
  * Обычные приложения не должны использовать эту функцию, она
3697
    предназначена для случая, когда при работе с каким-либо
3698
    устройством требуется разместить данные по известному физическому
3699
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3700
  * Число блоков физической памяти ограничено (константой 24,
114 mikedld 3701
    прич+м эта константа включает и несколько блоков памяти
77 diamond 3702
    для надобностей ядра).
3703
  * Освободить выделенную таким образом память можно
3704
    подфункцией 6, копированием данных туда/обратно
3705
    занимаются подфункции 7 и 8.
3706
 
3707
======================================================================
3708
====== Функция 68, подфункция 6 - освободить физическую память. ======
3709
======================================================================
3710
Параметры:
3711
  * eax = 68 - номер функции
3712
  * ebx = 6 - номер подфункции
3713
  * ecx = физический адрес памяти
3714
Возвращаемое значение:
3715
  * функция не возвращает значения
3716
Замечания:
3717
  * Обычные приложения не должны использовать эту функцию, она
3718
    предназначена для случая, когда при работе с каким-либо
3719
    устройством требуется разместить данные по известному физическому
3720
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3721
  * Память должна быть ранее выделена подфункцией 5.
3722
 
3723
======================================================================
3724
=== Функция 68, подфункция 7 - записать данные в физическую память. ==
3725
======================================================================
3726
Параметры:
3727
  * eax = 68 - номер функции
3728
  * ebx = 7 - номер подфункции
3729
  * ecx = физический адрес
3730
  * edx = указатель на данные (в приложении)
3731
  * esi = размер данных (в байтах)
3732
Возвращаемое значение:
3733
  * функция не возвращает значения
3734
Замечания:
3735
  * Обычные приложения не должны использовать эту функцию, она
3736
    предназначена для случая, когда при работе с каким-либо
3737
    устройством требуется разместить данные по известному физическому
3738
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3739
  * Диапазон физических адресов должен лежать внутри ранее выделенного
3740
    подфункцией 5 блока физической памяти.
3741
  * Проверок корректности не производится.
3742
 
3743
======================================================================
3744
== Функция 68, подфункция 8 - прочитать данные из физической памяти. =
3745
======================================================================
3746
Параметры:
3747
  * eax = 68 - номер функции
3748
  * ebx = 8 - номер подфункции
3749
  * ecx = физический адрес
3750
  * edx = указатель на буфер для данных (в приложении)
3751
  * esi = размер данных (в байтах)
3752
Возвращаемое значение:
3753
  * функция не возвращает значения
3754
Замечания:
3755
  * Обычные приложения не должны использовать эту функцию, она
3756
    предназначена для случая, когда при работе с каким-либо
3757
    устройством требуется разместить данные по известному физическому
3758
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3759
  * Диапазон физических адресов должен лежать внутри ранее выделенного
3760
    подфункцией 5 блока физической памяти.
3761
  * Проверок корректности не производится.
3762
 
3763
======================================================================
3764
======================== Функция 69 - отладка. =======================
3765
======================================================================
3766
Процесс может загрузить другой процесс как отлаживаемый установкой
3767
соответствующего бита при вызове подфункции 16 функции 58.
3768
У процесса может быть только один отладчик; один процесс может
3769
отлаживать несколько разных. Система уведомляет отладчик о событиях,
3770
происходящих с отлаживаемым процессом. Сообщения записываются в буфер,
114 mikedld 3771
определ+нный подфункцией 0.
77 diamond 3772
Формат сообщения:
3773
  * +0: dword: код сообщения
3774
  * +4: dword: PID отлаживаемого процесса
3775
  * +8: могут присутствовать дополнительные данные,
3776
    определяемые кодом сообщения
3777
Коды сообщений:
3778
  * 1 = исключение
114 mikedld 3779
    * дополнительно переда+тся dword-номер исключения
77 diamond 3780
    * процесс приостановлен
3781
  * 2 = процесс завершился
3782
    * приходит при любом завершении: как через системную функцию -1,
3783
      так и при "убийстве" любым другим процессом
3784
      (в том числе самим отладчиком)
3785
  * 3 = отладочное исключение int 1 = #DB
114 mikedld 3786
    * дополнительно переда+тся dword-образ регистра DR6:
77 diamond 3787
      * биты 0-3: выполнено условие соответствующей точки останова
3788
        (установленной подфункцией 9)
3789
      * бит 14: исключение произошло из-за режима
3790
        пошаговой трассировки (установлен флаг TF)
3791
    * процесс приостановлен
3792
При завершении отладчика прибиваются все отлаживаемые процессы.
3793
Если отладчик этого не хочет, он должен предварительно отключиться
3794
подфункцией 3.
3795
 
3796
Все подфункции применимы только к процессам/потокам, запущенным
3797
из текущего функцией 58 с установленным флагом отладки.
3798
Отладка многопоточных программ пока не поддерживается.
3799
Полный список подфункций:
3800
  * подфункция 0 - определить область данных для отладочных сообщений
3801
  * подфункция 1 - получить состояние регистров отлаживаемого потока
3802
  * подфункция 2 - установить состояние регистров отлаживаемого потока
3803
  * подфункция 3 - отключиться от отлаживаемого процесса
3804
  * подфункция 4 - приостановить отлаживаемый поток
3805
  * подфункция 5 - возобновить выполнение отлаживаемого потока
3806
  * подфункция 6 - прочитать из памяти отлаживаемого процесса
3807
  * подфункция 7 - записать в память отлаживаемого процесса
3808
  * подфункция 8 - завершить отлаживаемый поток
3809
  * подфункция 9 - установить/снять аппаратную точку останова
3810
 
3811
======================================================================
3812
====================== Функция 69, подфункция 0 ======================
3813
========= Определить область данных для отладочных сообщений. ========
3814
======================================================================
3815
Параметры:
3816
  * eax = 69 - номер функции
3817
  * ebx = 0 - номер подфункции
3818
  * ecx = указатель
3819
Формат области данных:
3820
  * +0: dword: N = размер буфера (не считая этого заголовка)
3821
  * +4: dword: занято в буфере
3822
  * +8: N*byte: буфер
3823
Возвращаемое значение:
3824
  * функция не возвращает значения
3825
Замечания:
3826
  * Если поле размера отрицательно, буфер считается заблокированным
3827
    и при поступлении нового сообщения система будет ждать.
3828
    Для синхронизации обрамляйте всю работу с буфером операциями
3829
    блокировки/разблокировки
114 mikedld 3830
        neg    [bufsize]
77 diamond 3831
  * Данные в буфере трактуются как массив элементов переменной длины -
3832
    сообщений. Формат сообщения указан в общем описании.
3833
 
3834
======================================================================
3835
====================== Функция 69, подфункция 1 ======================
3836
========= Получить состояние регистров отлаживаемого потока. =========
3837
======================================================================
3838
Параметры:
3839
  * eax = 69 - номер функции
3840
  * ebx = 1 - номер подфункции
3841
  * ecx = идентификатор потока
3842
  * edx = длина структуры контекста, должно быть 0x28=40 байт
3843
Возвращаемое значение:
3844
  * функция не возвращает значения
3845
Формат структуры контекста: (FPU пока не поддерживается)
3846
  * +0: dword: eip
3847
  * +4: dword: eflags
3848
  * +8: dword: eax
3849
  * +12 = +0xC: dword: ecx
3850
  * +16 = +0x10: dword: edx
3851
  * +20 = +0x14: dword: ebx
3852
  * +24 = +0x18: dword: esp
3853
  * +28 = +0x1C: dword: ebp
3854
  * +32 = +0x20: dword: esi
3855
  * +36 = +0x24: dword: edi
3856
Замечания:
3857
  * Если поток выполняет код 0-кольца, возвращается
3858
    состояние регистров 3-кольца.
3859
  * Процесс должен быть загружен для отладки (как указано в
3860
    общем описании).
3861
 
3862
======================================================================
3863
====================== Функция 69, подфункция 2 ======================
3864
======== Установить состояние регистров отлаживаемого потока. ========
3865
======================================================================
3866
Параметры:
3867
  * eax = 69 - номер функции
3868
  * ebx = 2 - номер подфункции
3869
  * ecx = идентификатор потока
3870
  * edx = длина структуры контекста, должно быть 0x28=40 байт
3871
Возвращаемое значение:
3872
  * функция не возвращает значения
3873
Формат структуры контекста указан в описании подфункции 1.
3874
Замечания:
3875
  * Если поток выполняет код 0-кольца, устанавливается
3876
    состояние регистров 3-кольца.
3877
  * Процесс должен быть загружен для отладки (как указано в
3878
    общем описании).
3879
 
3880
======================================================================
3881
== Функция 69, подфункция 3 - отключиться от отлаживаемого процесса. =
3882
======================================================================
3883
Параметры:
3884
  * eax = 69 - номер функции
3885
  * ebx = 3 - номер подфункции
3886
  * ecx = идентификатор
3887
Возвращаемое значение:
3888
  * функция не возвращает значения
3889
Замечания:
3890
  * Если процесс был приостановлен, он возобновляет выполнение.
3891
 
3892
======================================================================
3893
==== Функция 69, подфункция 4 - приостановить отлаживаемый поток. ====
3894
======================================================================
3895
Параметры:
3896
  * eax = 69 - номер процесса
3897
  * ebx = 4 - номер подфункции
3898
  * ecx = идентификатор
3899
Возвращаемое значение:
3900
  * функция не возвращает значения
3901
Замечания:
3902
  * Процесс должен быть загружен для отладки (как указано в
3903
    общем описании).
3904
 
3905
======================================================================
3906
====================== Функция 69, подфункция 5 ======================
3907
============ Возобновить выполнение отлаживаемого потока. ============
3908
======================================================================
3909
Параметры:
3910
  * eax = 69 - номер функции
3911
  * ebx = 5 - номер подфункции
3912
  * ecx = идентификатор
3913
Возвращаемое значение:
3914
  * функция не возвращает значения
3915
Замечания:
3916
  * Процесс должен быть загружен для отладки (как указано в
3917
    общем описании).
3918
 
3919
======================================================================
3920
====================== Функция 69, подфункция 6 ======================
3921
============= Прочитать из памяти отлаживаемого процесса. ============
3922
======================================================================
3923
Параметры:
3924
  * eax = 69 - номер функции
3925
  * ebx = 6 - номер подфункции
3926
  * ecx = идентификатор
3927
  * edx = сколько байт читать
3928
  * esi = адрес памяти отлаживаемого процесса
3929
  * edi = указатель на буфер для данных
3930
Возвращаемое значение:
3931
  * eax = -1 при ошибке (неверный PID или буфер)
3932
  * иначе eax = число прочитанных байт (возможно, 0,
3933
    если в esi слишком большое значение)
3934
Замечания:
3935
  * Процесс должен быть загружен для отладки (как указано в
3936
    общем описании).
3937
 
3938
======================================================================
3939
 Функция 69, подфункция 7 - записать в память отлаживаемого процесса.
3940
======================================================================
3941
Параметры:
3942
  * eax = 69 - номер функции
3943
  * ebx = 7 - номер подфункции
3944
  * ecx = идентификатор
3945
  * edx = сколько байт писать
3946
  * esi = адрес памяти в отлаживаемом процессе
3947
  * edi = указатель на данные
3948
Возвращаемое значение:
3949
  * eax = -1 при ошибке (неверный PID или буфер)
3950
  * иначе eax = число записанных байт (возможно, 0,
3951
    если в esi слишком большое значение)
3952
Замечания:
3953
  * Процесс должен быть загружен для отладки (как указано в
3954
    общем описании).
3955
 
3956
======================================================================
3957
====== Функция 69, подфункция 8 - завершить отлаживаемый поток. ======
3958
======================================================================
3959
Параметры:
3960
  * eax = 69 - номер функции
3961
  * ebx = 8 - номер подфункции
3962
  * ecx = идентификатор
3963
Возвращаемое значение:
3964
  * функция не возвращает значения
3965
Замечания:
3966
  * Процесс должен быть загружен для отладки (как указано в
3967
    общем описании).
3968
  * Функция аналогична подфункции 2 функции 18 с двумя отличиями:
3969
    требуется выполнение первого замечания и принимается PID,
3970
    а не номер слота.
3971
 
3972
======================================================================
3973
====================== Функция 69, подфункция 9 ======================
3974
============= Установить/снять аппаратную точку останова. ============
3975
======================================================================
3976
Параметры:
3977
  * eax = 69 - номер функции
3978
  * ebx = 9 - номер подфункции
3979
  * ecx = идентификатор потока
3980
  * dl = индекс точки останова, от 0 до 3 включительно
3981
  * dh = флаги:
3982
    * если старший бит сброшен - установить точку останова:
3983
      * биты 0-1 - условие:
3984
        * 00 = точка останова на выполнение
3985
        * 01 = точка останова на запись
3986
        * 11 = точка останова на чтение/запись
3987
      * биты 2-3 - длина; для точек останова на исполнение должно быть
3988
        00, в противном случае одно из
3989
        * 00 = байт
3990
        * 01 = слово
3991
        * 11 = двойное слово
3992
      * esi = адрес точки останова; должен быть выровнен
114 mikedld 3993
        соответственно длине (т.е. должен быть ч+тным для
77 diamond 3994
        точек останова на слово, кратен 4 для двойного слова)
3995
    * если старший бит установлен - сбросить точку останова
3996
Возвращаемое значение:
3997
  * eax = 0 - успешно
3998
  * eax = 1 - ошибка во входных данных
3999
  * eax = 2 - (зарезервировано, никогда не возвращается
4000
    в текущей реализации) с этим индексом уже установлена
4001
    глобальная точка останова
4002
Замечания:
4003
  * Процесс должен быть загружен для отладки (как указано в
4004
    общем описании).
4005
  * Аппаратные точки останова реализуются через DRx-регистры
4006
    процессора, отсюда все ограничения.
4007
  * Функция может переустановить ранее установленную ей же
4008
    точку останова (никак не сообщая об этом).
4009
    Ведите список установленных точек останова в отладчике.
4010
  * Срабатывание точки останова заключается в генерировании
4011
    отладочного исключения #DB, о котором система сообщает отладчику.
4012
  * Точка останова на запись и чтение/запись срабатывает после
114 mikedld 4013
    выполнения вызвавшей е+ инструкции.
77 diamond 4014
 
4015
======================================================================
114 mikedld 4016
= Функция 70 - работа с файловой системой с поддержкой длинных им+н. =
77 diamond 4017
======================================================================
4018
Параметры:
4019
  * eax = 70
4020
  * ebx = указатель на информационную структуру
4021
Возвращаемое значение:
4022
  * eax = 0 - успешно; иначе код ошибки файловой системы
4023
  * в зависимости от подфункции может возвращаться значение и
4024
    в других регистрах
4025
Общий формат информационной структуры:
4026
  * +0: dword: номер подфункции
4027
  * +4: dword: смещение в файле
91 diamond 4028
  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
77 diamond 4029
  * +12 = +0xC: dword: размер
4030
  * +16 = +0x10: dword: указатель на данные
4031
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
86 diamond 4032
    или
4033
  * +20 = +0x14: db 0
4034
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4035
Уточнения - в документации на соответствующую подфункцию.
4036
Имя файла нечувствительно к регистру букв. Русские буквы должны быть
4037
записаны в кодировке cp866 (DOS).
4038
Формат имени файла:
4039
/base/number/dir1/dir2/.../dirn/file,
4040
где /base/number идентифицирует устройство, на котором ищется файл:
4041
одно из
4042
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
4043
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
4044
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
4045
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
114 mikedld 4046
    к ж+стким дискам на IDE0 (Primary Master), IDE1 (Primary Slave),
77 diamond 4047
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4048
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
4049
    (на каждом из винчестеров нумерация начинается с 1)
91 diamond 4050
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 для доступа соответственно
4051
    к CD на IDE0 (Primary Master), IDE1 (Primary Slave),
4052
    IDE2 (Secondary Master), IDE3 (Secondary Slace)
77 diamond 4053
Примеры:
83 diamond 4054
  * '/rd/1/kernel.asm',0
77 diamond 4055
  * '/HD0/1/kernel.asm',0
4056
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4057
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
4058
Доступные подфункции:
4059
  * подфункция 0 - чтение файла
4060
  * подфункция 1 - чтение папки
83 diamond 4061
  * подфункция 2 - создание/перезапись файла
86 diamond 4062
  * подфункция 5 - получение атрибутов файла/папки
4063
  * подфункция 6 - установка атрибутов файла/папки
91 diamond 4064
  * подфункция 7 - запуск программы
77 diamond 4065
 
4066
======================================================================
114 mikedld 4067
= Функция 70, подфункция 0 - чтение файла с поддержкой длинных им+н. =
77 diamond 4068
======================================================================
4069
Параметры:
4070
  * eax = 70 - номер функции
4071
  * ebx = указатель на информационную структуру
4072
Формат информационной структуры:
4073
  * +0: dword: 0 = номер подфункции
4074
  * +4: dword: позиция в файле (в байтах)
4075
  * +8: dword: 0 (зарезервировано под старший dword позиции)
4076
  * +12 = +0xC: dword: сколько байт читать
4077
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
114 mikedld 4078
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 4079
    общем описании
86 diamond 4080
    или
4081
  * +20 = +0x14: db 0
4082
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4083
Возвращаемое значение:
4084
  * eax = 0 - успешно, иначе код ошибки файловой системы
4085
  * ebx = число прочитанных байт или
4086
    -1=0xffffffff, если файл не найден
4087
Замечания:
4088
  * Если файл кончился раньше, чем был прочитан последний запрошенный
114 mikedld 4089
    блок, то функция прочитает, сколько сможет, после чего верн+т
77 diamond 4090
    eax=6 (EOF).
4091
  * Функция не позволяет читать папки
114 mikedld 4092
    (верн+тся eax=10, access denied).
77 diamond 4093
 
4094
======================================================================
114 mikedld 4095
= Функция 70, подфункция 1 - чтение папки с поддержкой длинных им+н. =
77 diamond 4096
======================================================================
4097
Параметры:
4098
  * eax = 70 - номер функции
4099
  * ebx = указатель на информационную структуру
4100
Формат информационной структуры:
4101
  * +0: dword: 1 = номер подфункции
4102
  * +4: dword: индекс начального блока (считая с 0)
78 diamond 4103
  * +8: dword: поле флагов:
4104
    * бит 0 (маска 1): в каком формате возвращать имена,
4105
      0=ANSI, 1=UNICODE
4106
    * прочие биты зарезервированы и должны быть установлены в 0
4107
      для будущей совместимости
77 diamond 4108
  * +12 = +0xC: dword: сколько блоков читать
4109
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
4110
    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
114 mikedld 4111
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования им+н указаны в
77 diamond 4112
    общем описании
86 diamond 4113
    или
4114
  * +20 = +0x14: db 0
4115
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4116
Возвращаемое значение:
4117
  * eax = 0 - успешно, иначе код ошибки файловой системы
4118
  * ebx = число файлов, информация о которых была записана в буфер,
4119
    или -1=0xffffffff, если папка не найдена
4120
Структура буфера:
4121
  * +0: 32*byte: заголовок
4122
  * +32 = +0x20: n1*byte: блок с информацией о файле 1
4123
  * +32+n1: n2*byte: блок с информацией о файле 2
4124
  * ...
4125
Структура заголовка:
4126
  * +0: dword: версия структуры (текущая версия = 1)
114 mikedld 4127
  * +4: dword: количество размещ+нных блоков; не больше, чем запрошено
77 diamond 4128
    в поле +12 информационной структуры; может быть меньше,
4129
    если в папке кончились файлы (то же самое, что и в ebx)
4130
  * +8: dword: общее число файлов в папке
4131
  * +12 = +0xC: 20*byte: зарезервировано (нули)
4132
Структура блока данных входа каталога (БДВК):
4133
  * +0: dword: атрибуты файла:
4134
    * бит 0 (маска 1): файл только для чтения
4135
    * бит 1 (маска 2): файл является скрытым
4136
    * бит 2 (маска 4): файл является системным
4137
    * бит 3 (маска 8): это не файл, а метка тома
4138
      (на заданном разделе встречается не более одного раза и
4139
      только в корневой папке)
4140
    * бит 4 (маска 0x10): это папка
4141
    * бит 5 (маска 0x20): файл не архивировался - многие программы
4142
      архивации имеют опцию, по которой архивируются только файлы
4143
      с установленным этим битом, после чего этот бит сбрасывается -
4144
      это может быть полезно для автоматического создания
4145
      backup-архивов, ибо при записи бит обычно устанавливается
4146
      (не в Kolibri, правда)
78 diamond 4147
  * +4: byte: тип данных имени:
4148
    (совпадает с битом 0 флагов информационной структуры)
77 diamond 4149
    * 0 = ASCII = 1-байтное представление каждого символа
4150
    * 1 = UNICODE = 2-байтное представление каждого символа
4151
  * +5: 3*byte: зарезервировано (нули)
4152
  * +8: 4*byte: время создания файла
4153
  * +12 = +0xC: 4*byte: дата создания файла
4154
  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
4155
  * +20 = +0x14: 4*byte: дата последнего доступа
4156
  * +24 = +0x18: 4*byte: время последней модификации
4157
  * +28 = +0x1C: 4*byte: дата последней модификации
4158
  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
4159
  * +40 = +0x28: имя
4160
    * для формата ASCII: максимальная длина имени 263 символа
4161
      (263 байта), байт после имени имеет значение 0
4162
    * для формата UNICODE: максимальная длина имени 259 символов
4163
      (518 байт), два байта после имени имеют значение 0
4164
Формат времени:
4165
  * +0: byte: секунды
4166
  * +1: byte: минуты
4167
  * +2: byte: часы
4168
  * +3: byte: зарезервировано (0)
4169
  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
4170
Формат даты:
4171
  * +0: byte: день
4172
  * +1: byte: месяц
4173
  * +2: word: год
4174
  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
4175
Замечания:
4176
  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
4177
    304 байта, если в UNICODE - 560 байт. Значение длины выравнено
4178
    на целое кратное 16 байт
4179
    (для ускорения обработки в кэш-памяти CPU).
78 diamond 4180
  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
4181
    данные содержат мусор.
77 diamond 4182
  * Если файлы в папке кончились раньше, чем было прочитано
4183
    запрошенное количество, то функция прочитает, сколько сможет,
114 mikedld 4184
    после чего верн+т eax=6 (EOF).
77 diamond 4185
  * Любая папка на диске, кроме корневой, содержит два специальных
4186
    входа "." и "..", идентифицирующих соответственно саму папку и
4187
    родительскую папку.
4188
  * Функция позволяет также читать виртуальные папки "/", "/rd",
4189
    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
4190
    0x10, а времена и даты обнулены. Альтернативный способ получения
4191
    информации об оборудовании - подфункция 11 функции 18.
4192
 
4193
======================================================================
83 diamond 4194
====================== Функция 70, подфункция 2 ======================
114 mikedld 4195
======== Создание/перезапись файла с поддержкой длинных им+н. ========
83 diamond 4196
======================================================================
4197
Параметры:
4198
  * eax = 70 - номер функции
4199
  * ebx = указатель на информационную структуру
4200
Формат информационной структуры:
4201
  * +0: dword: 2 = номер подфункции
4202
  * +4: dword: 0 (зарезервировано)
4203
  * +8: dword: 0 (зарезервировано)
4204
  * +12 = +0xC: dword: сколько байт писать
4205
  * +16 = +0x10: dword: указатель на данные
114 mikedld 4206
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
83 diamond 4207
    общем описании
86 diamond 4208
    или
4209
  * +20 = +0x14: db 0
4210
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
83 diamond 4211
Возвращаемое значение:
4212
  * eax = 0 - успешно, иначе код ошибки файловой системы
4213
  * ebx = число записанных байт (возможно, 0)
4214
Замечания:
114 mikedld 4215
  * Если файл с таким именем не существовал, он созда+тся; если
83 diamond 4216
    существовал, то перезаписывается.
4217
  * Если свободного места на диске недостаточно, то функция запишет,
114 mikedld 4218
    сколько сможет, после чего верн+т код ошибки 8.
83 diamond 4219
 
4220
======================================================================
86 diamond 4221
=== Функция 70, подфункция 5 - получение информации о файле/папке. ===
4222
======================================================================
4223
Параметры:
4224
  * eax = 70 - номер функции
4225
  * ebx = указатель на информационную структуру
4226
Формат информационной структуры:
4227
  * +0: dword: 5 = номер подфункции
4228
  * +4: dword: 0 (зарезервировано)
4229
  * +8: dword: 0 (зарезервировано)
4230
  * +12 = +0xC: dword: 0 (зарезервировано)
4231
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
4232
                        (40 байт)
114 mikedld 4233
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
86 diamond 4234
    общем описании
4235
    или
4236
  * +20 = +0x14: db 0
4237
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4238
Возвращаемое значение:
4239
  * eax = 0 - успешно, иначе код ошибки файловой системы
4240
  * ebx разрушается
4241
Информация о файле возвращается в формате БДВК
4242
(блока данных входа каталога), указанном в описании
4243
подфункции 1, но без имени файла
4244
(то есть первые 40 = 0x28 байт).
4245
Замечания:
4246
  * Функция не поддерживает виртуальные папки типа /, /rd и
4247
    корневые папки типа /rd/1.
4248
 
4249
======================================================================
4250
===== Функция 70, подфункция 6 - установка атрибутов файла/папки. ====
4251
======================================================================
4252
Параметры:
4253
  * eax = 70 - номер функции
4254
  * ebx = указатель на информационную структуру
4255
Формат информационной структуры:
4256
  * +0: dword: 6 = номер подфункции
4257
  * +4: dword: 0 (зарезервировано)
4258
  * +8: dword: 0 (зарезервировано)
4259
  * +12 = +0xC: dword: 0 (зарезервировано)
4260
  * +16 = +0x10: dword: указатель на буфер с атрибутами (32 байта)
114 mikedld 4261
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
86 diamond 4262
    общем описании
4263
    или
4264
  * +20 = +0x14: db 0
4265
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4266
Возвращаемое значение:
4267
  * eax = 0 - успешно, иначе код ошибки файловой системы
4268
  * ebx разрушается
4269
Атрибуты файла - первые 32 байта в БДВК (блоке данных входа каталога),
4270
формат которого указан в описании подфункции 1
4271
(то есть без имени и размера файла). Атрибут файл/папка/метка тома
4272
(биты 3,4 в dword'е +0) не меняется.
4273
Байт +4 (формат имени) игнорируется.
4274
Замечания:
4275
  * Функция не поддерживает виртуальные папки типа /, /rd и
4276
    корневые папки типа /rd/1.
4277
 
4278
======================================================================
91 diamond 4279
============ Функция 70, подфункция 7 - запуск программы. ============
4280
======================================================================
4281
Параметры:
4282
  * eax = 70 - номер функции
4283
  * ebx = указатель на информационную структуру
4284
Формат информационной структуры:
4285
  * +0: dword: 7 = номер подфункции
4286
  * +4: dword: поле флагов:
4287
    * бит 0: запустить процесс как отлаживаемый
4288
    * остальные биты зарезервированы и должны быть установлены в 0
4289
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
4290
  * +12 = +0xC: dword: 0 (зарезервировано)
4291
  * +16 = +0x10: dword: 0 (зарезервировано)
114 mikedld 4292
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
91 diamond 4293
    общем описании
4294
    или
4295
  * +20 = +0x14: db 0
4296
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4297
Возвращаемое значение:
4298
  * eax > 0 - программа загружена, eax содержит PID
4299
  * eax < 0 - произошла ошибка, -eax содержит
4300
    код ошибки файловой системы
4301
  * ebx разрушается
4302
Замечания:
4303
  * Командная строка должна заканчиваться символом с кодом 0
4304
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
4305
    включительно, либо первые 256 символов, в зависимости от того,
4306
    что меньше.
114 mikedld 4307
  * Если процесс запускается как отлаживаемый, он созда+тся
91 diamond 4308
    в замороженном состоянии; для запуска используйте
4309
    подфункцию 5 функции 69.
4310
 
4311
======================================================================
114 mikedld 4312
====== Функция 71, подфункция 1 - установить заголовок программы =====
4313
======================================================================
4314
Параметры:
4315
  * eax = 71 - номер функции
4316
  * ebx = 1 - номер подфункции
4317
  * eсx = адрес строки заголовка
4318
Возвращаемое значение:
4319
  * eax = 0 - заголовок установлен успешно
4320
  * eax = 1 - произошла ошибка
4321
Замечания:
4322
  * Строка заголовка должна быть в формате ASCIIZ. В заголовке
4323
    отображается не более 255 символовб независимо от реальной длины
4324
    строки.
4325
  * Чтобы убрать заголовок, передайте NULL в ecx
4326
 
4327
======================================================================
77 diamond 4328
========== Функция -1 - завершить выполнение потока/процесса =========
4329
======================================================================
4330
Параметры:
4331
  * eax = -1 - номер функции
4332
Возвращаемое значение:
4333
  * функция не возвращает ни значения, ни управления
4334
Замечания:
4335
  * Если процесс явно не создавал потоков, то у него есть только
4336
    один поток, завершение которого приводит к завершению процесса.
4337
  * Если текущий поток - последний в процессе, то его завершение
4338
    также приводит к завершению процесса.
4339
  * Эта функция завершает текущий поток. Другой поток можно прибить
4340
    вызовом подфункции 2 функции 18.
4341
 
4342
======================================================================
4343
=========================== Список событий ===========================
4344
======================================================================
4345
Очередное событие можно получить вызовом одной из функций 10
4346
(ожидать события), 11 (проверить без ожидания), 23
4347
(ожидать в течение заданного времени).
4348
Эти функции возвращают только те события, которые входят в маску,
4349
устанавливаемую функцией 40. По умолчанию это первые три, чего
4350
вполне достаточно для многих приложений.
4351
Коды событий:
4352
  * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
4353
  * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
92 diamond 4354
    активно) или нажата "горячая клавиша";
4355
    сбрасывается, когда все клавиши из буфера считаны функцией 2
114 mikedld 4356
  * 3 = нажата кнопка, определ+нная ранее функцией 8 (или кнопка
77 diamond 4357
    закрытия, созданная неявно функцией 0; кнопка минимизации
4358
    обрабатывается системой и о ней сообщения не приходит;
4359
    поступает, только когда окно активно; сбрасывается, когда все
4360
    кнопки из буфера считаны функцией 17)
4361
  * 4 = зарезервировано (в текущей реализации никогда не приходит даже
4362
    при размаскировке функцией 40)
4363
  * 5 = перерисовывается фон рабочего стола (сбрасывается
4364
    автоматически после перерисовки, так что если во время перерисовки
114 mikedld 4365
    фона программа не жд+т и не проверяет события, то этого события
77 diamond 4366
    она не заметит)
4367
  * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
4368
    или перемещение; сбрасывается при прочтении)
4369
  * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
4370
    Communication; сбрасывается при прочтении)
4371
  * 8 = произошло сетевое событие (сбрасывается при прочтении;
4372
    смотри работу с сетью)
4373
  * 9 = произошло отладочное событие (сбрасывается при прочтении;
4374
    смотри отладочную подсистему)
4375
  * 16..31 = произошло событие с соответствующим IRQ
4376
    (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)
4377
 
4378
======================================================================
4379
==================== Коды ошибок файловой системы ====================
4380
======================================================================
4381
  * 0 = успешно
114 mikedld 4382
  * 1 = не определена база и/или раздел ж+сткого диска (подфункциями
77 diamond 4383
    7, 8 функции 21)
4384
  * 2 = функция не поддерживается для данной файловой системы
114 mikedld 4385
    (возвращается в случае попытки LBA-чтения при запрещ+нном LBA)
77 diamond 4386
  * 3 = неизвестная файловая система
4387
  * 4 = возвращается только функцией rename при передаче сильно
4388
    неверного параметра и никак не соответствует описанию
4389
    в исходниках ядра "partition not defined at hd"
4390
  * 5 = файл не найден
4391
  * 6 = файл закончился
4392
  * 7 = указатель вне памяти приложения
4393
  * 8 = диск заполнен
4394
  * 9 = таблица FAT разрушена
114 mikedld 4395
  * 10 = доступ запрещ+н
83 diamond 4396
  * 11 = ошибка устройства
77 diamond 4397
При запуске программы возможны также следующие коды ошибок:
4398
  * 30 = 0x1E = недостаточно памяти
4399
  * 31 = 0x1F = файл не является исполнимым
4400
  * 32 = 0x20 = слишком много процессов
114 mikedld 4401