Subversion Repositories Kolibri OS

Rev

Rev 131 | Rev 142 | 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 (биты)
118 diamond 31
      * A = 1 - у окна есть заголовок; для стиля Y=3 адрес строки
131 diamond 32
                  заголовка задаётся в edi, для прочих стилей
118 diamond 33
                  используется подфункция 1 функции 71
34
      * B = 1 - координаты всех графических примитивов задаются
35
                  относительно клиентской области окна
36
      * C зарезервирован (устанавливайте в 0)
37
      * D = 0 - нормальная заливка рабочей области, 1 - градиентная
77 diamond 38
    Следующие параметры предназначены для окон типа I и II и
39
    игнорируются для стилей Y=1,3:
40
  * esi = 0xXYRRGGBB - цвет заголовка
41
    * RR, GG, BB определяют сам цвет
42
    * Y=0 - обычное окно, Y=1 - неперемещаемое окно
43
    * X определяет градиент заголовка: X=0 - нет градиента,
44
      X=8 - обычный градиент,
45
      для окон типа II X=4 - негативный градиент
46
    * прочие значения X и Y зарезервированы
47
  * edi = 0x00RRGGBB - цвет рамки
48
Возвращаемое значение:
49
  * функция не возвращает значения
50
Замечания:
51
  * Положение и размеры окна устанавливаются при первом вызове
52
    этой функции и игнорируются при последующих; для изменения
53
    положения и/или размеров уже созданного окна используйте
54
    67-ю функцию.
118 diamond 55
  * Для окон стиля Y=3 с заголовком (A=1) строка заголовка
56
    устанавливается при первом вызове этой функции и игнорируется при
57
    последующих (точнее говоря, игнорируется после вызова
58
    подфункции 2 функции 12 - конца перерисовки);
59
    для изменения строки заголовка уже созданного окна используйте
60
    подфункцию 1 функции 71.
77 diamond 61
  * Если использовать окна соответствующих стилей, то положение
62
    и/или размеры окна могут меняться пользователем.
63
    Текущие положение и размеры могут быть получены вызовом функции 9.
64
  * Окно должно умещаться на экране. Если переданные координаты
65
    и размеры не удовлетворяют этому условию, то соответствующая
66
    координата (или, возможно, обе) считается нулем, а если и это
67
    не помогает, то соответствующий размер (или, возможно, оба)
68
    устанавливается в размер экрана.
69
 
70
    Далее обозначим xpos,ypos,xsize,ysize - значения, передаваемые
71
    в ebx,ecx. Координаты приводятся относительно левого верхнего
72
    угла окна, который, таким образом, задается как (0,0), координаты
73
    правого нижнего угла суть (xsize,ysize).
74
  * Размеры окна понимаются в смысле координат правого нижнего угла.
75
    Это же относится и ко всем остальным функциям.
76
    Это означает, что реальные размеры на 1 пиксель больше.
77
  * Вид окна типа I:
78
    * рисуется внешняя рамка цвета, указанного в edi,
79
      шириной 1 пиксель
80
    * рисуется заголовок - прямоугольник с левым верхним углом (1,1)
81
      и правым нижним (xsize-1,min(25,ysize)) цвета, указанного в esi
82
      (с учетом градиента)
83
    * если ysize>=26, то закрашивается рабочая область окна -
84
      прямоугольник с левым верхним углом (1,21) и правым нижним
85
      (xsize-1,ysize-1) (размерами (xsize-1)*(ysize-21)) - цветом,
86
      указанным в edx (с учетом градиента)
118 diamond 87
    * если A=1 и строка заголовка установлена подфункцией 1
88
      функции 71, то она выводится в соответствующем месте заголовка
77 diamond 89
  * Вид окна стиля Y=1:
90
    * полностью определяется приложением
91
  * Вид окна типа II:
131 diamond 92
    * рисуется внешняя рамка шириной 1 пиксель "затенённого" цвета
77 diamond 93
      edi (все составляющие цвета уменьшаются в два раза)
94
    * рисуется промежуточная рамка шириной 3 пикселя цвета edi
95
    * рисуется внутренняя рамка шириной 1 пиксель
131 diamond 96
      "затенённого" цвета edi
77 diamond 97
    * рисуется заголовок - прямоугольник с левым верхним углом (4,4)
98
      и правым нижним (xsize-4,min(20,ysize)) цвета, указанного в esi
99
      (с учетом градиента)
100
    * если ysize>=26, то закрашивается рабочая область окна -
101
      прямоугольник с левым верхним углом (5,20) и правым нижним
102
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
118 diamond 103
    * если A=1 и строка заголовка установлена подфункцией 1
104
      функции 71, то она выводится в соответствующем месте заголовка
77 diamond 105
  * Вид окна со скином:
106
    * рисуется внешняя рамка шириной 1 пиксель
107
      цвета 'outer' из скина
108
    * рисуется промежуточная рамка шириной 3 пикселя
109
      цвета 'frame' из скина
110
    * рисуется внутренняя рамка шириной 1 пиксель
111
      цвета 'inner' из скина
112
    * рисуется заголовок (по картинкам из скина) в прямоугольнике
113
      (0,0) - (xsize,_skinh-1)
114
    * если ysize>=26, то закрашивается рабочая область окна -
115
      прямоугольник с левым верхним углом (5,_skinh) и правым нижним
116
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
117
    * определяются две стандартные кнопки: закрытия и минимизации
118
      (смотри функцию 8)
118 diamond 119
    * если A=1 и в edi (ненулевой) указатель на строку заголовка,
120
      то она выводится в заголовке в месте, определяемом скином
77 diamond 121
    * Значение переменной _skinh доступно как результат вызова
122
      подфункции 4 функции 48
123
 
124
======================================================================
125
================= Функция 1 - поставить точку в окне. ================
126
======================================================================
127
Параметры:
128
  * eax = 1 - номер функции
129
  * ebx = x-координата (относительно окна)
130
  * ecx = y-координата (относительно окна)
131
  * edx = 0x00RRGGBB - цвет точки
132
    edx = 0x01xxxxxx - инвертировать цвет точки
133
          (младшие 24 бита игнорируются)
134
Возвращаемое значение:
135
  * функция не возвращает значения
136
 
137
======================================================================
138
============== Функция 2 - получить код нажатой клавиши. =============
139
======================================================================
140
Забирает код нажатой клавиши из буфера.
141
Параметры:
142
  * eax = 2 - номер функции
143
Возвращаемое значение:
144
  * если буфер пуст, возвращается eax=1
145
  * если буфер непуст, то возвращается al=0, ah=код нажатой клавиши,
146
    старшее слово регистра eax обнулено
92 diamond 147
  * если есть "горячая клавиша", то возвращается
148
    al=2, ah=сканкод нажатой клавиши (0 для управляющих клавиш),
149
    старшее слово регистра eax содержит состояние управляющих клавиш
150
    в момент нажатия горячей клавиши
77 diamond 151
Замечания:
152
  * Существует общесистемный буфер нажатых клавиш размером 120 байт,
153
    организованный как очередь.
131 diamond 154
  * Существует ещё один общесистемный буфер на 120 "горячих клавиш".
77 diamond 155
  * При вызове этой функции приложением с неактивным окном
92 diamond 156
    считается, что буфер нажатых клавиш пуст.
77 diamond 157
  * По умолчанию эта функция возвращает ASCII-коды; переключиться на
158
    режим сканкодов (и назад) можно с использованием функции 66.
92 diamond 159
    Однако, горячие клавиши всегда возвращаются как сканкоды.
77 diamond 160
  * Узнать, какие комбинации клавиш соответствуют каким кодам, можно,
161
    запустив приложения keyascii и scancode.
162
  * Сканкоды возвращаются непосредственно клавиатурой и фиксированы;
163
    ASCII-коды получаются с использованием таблиц преобразования,
164
    которые можно установить подфункцией 2 функции 21 и прочитать
165
    подфункцией 2 функции 26.
166
  * Как следствие, ASCII-коды учитывают текущую раскладку клавиатуры
167
    (rus/en) в отличие от сканкодов.
92 diamond 168
  * Поступает информация только о тех горячих клавишах, которые были
169
    определены этим потоком подфункцией 4 функции 66.
77 diamond 170
 
171
======================================================================
172
================ Функция 3 - получить системное время. ===============
173
======================================================================
174
Параметры:
175
  * eax = 3 - номер функции
176
Возвращаемое значение:
177
  * eax = 0x00SSMMHH, где HH:MM:SS = часы:минуты:секунды
178
  * каждый элемент возвращается как BCD-число, например,
179
    для времени 23:59:59 результат будет 0x00595923
180
Замечания:
181
  * Смотри также подфункцию 9 функции 26 - получение времени
182
    с момента запуска системы; она во многих случаях удобнее,
183
    поскольку возвращает просто DWORD-значение счетчика времени.
184
  * Системное время можно установить функцией 22.
185
 
186
======================================================================
118 diamond 187
============== Функция 4 - вывести строку текста в окно. =============
77 diamond 188
======================================================================
189
Параметры:
190
  * eax = 4 - номер функции
191
  * ebx = [координата по оси x]*65536 + [координата по оси y]
192
  * ecx = 0xX0RRGGBB, где
193
    * RR, GG, BB задают цвет текста
194
    * X задает используемый шрифт: 0=системный моноширинный,
195
      1=системный шрифт переменной ширины
196
  * edx = указатель на начало строки
197
  * esi = длина строки, должна быть не больше 255
198
Возвращаемое значение:
199
  * функция не возвращает значения
200
Замечания:
118 diamond 201
  * Выводятся либо первые (esi and 0xFF) символов,
202
    либо все символы до (но не включая) завершающего нуля
131 diamond 203
    (для ASCIIZ-строк) в зависимости от того, что произойдёт раньше.
77 diamond 204
  * Первый системный шрифт считывается при загрузке из файла char.mt,
205
    второй - из char2.mt.
206
  * Оба шрифта имеют высоту 9 пикселей, ширина моноширинного шрифта
207
    равна 6 пикселей.
208
 
209
======================================================================
210
========================= Функция 5 - пауза. =========================
211
======================================================================
212
Задерживает выполнение программы на заданное время.
213
Параметры:
214
  * eax = 5 - номер функции
215
  * ebx = время в сотых долях секунды
216
Возвращаемое значение:
217
  * функция не возвращает значения
218
Замечания:
219
  * Передача ebx=0 не передает управление следующему процессу и
220
    вообще не производит никаких действий. Если действительно
221
    требуется передать управление следующему процессу
222
    (закончить текущий квант времени), используйте подфункцию 1
223
    функции 68.
224
  * При текущей реализации произойдет немедленный возврат из функции,
225
    если сложение ebx с текущим значением счетчика времени вызовет
226
    32-битное переполнение.
227
 
228
======================================================================
229
=============== Функция 6 - прочитать файл с рамдиска. ===============
230
======================================================================
231
Параметры:
232
  * eax = 6 - номер функции
233
  * ebx = указатель на имя файла
234
  * ecx = номер стартового блока, считая с 1;
235
    ecx=0 - читать с начала файла (то же самое, что и ecx=1)
236
  * edx = число блоков для чтения;
237
    edx=0 - читать один блок (то же самое, что и edx=1)
238
  * esi = указатель на область памяти, куда будут записаны данные
239
Возвращаемое значение:
240
  * eax = длина файла в байтах, если файл успешно прочитан
241
  * eax = -1, если файл не найден
242
Замечания:
243
  * Данная функция является устаревшей; функция 70
244
    позволяет выполнять те же действия с расширенными возможностями.
245
  * Блок = 512 байт.
246
  * Для чтения всего файла можно указать заведомо большое значение
247
    в edx, например, edx = -1; но в этом случае будьте готовы к тому,
248
    что программа "упадет", если файл окажется слишком большим
249
    и "не влезет" в память программы.
250
  * Имя файла должно быть либо в формате 8+3 символов
251
    (первые 8 символов - собственно имя, последние 3 - расширение,
252
    короткие имена и расширения дополняются пробелами),
253
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
254
    (имя не более 8 символов, точка, расширение 3 символа,
255
    дополненное при необходимости пробелами).
256
    Имя файла должно быть записано заглавными буквами.
257
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 258
  * Эта функция не поддерживает папки на рамдиске.
77 diamond 259
 
260
======================================================================
261
=============== Функция 7 - вывести изображение в окно. ==============
262
======================================================================
263
Параметры:
264
  * eax = 7 - номер функции
81 diamond 265
  * ebx = указатель на изображение в формате BBGGRRBBGGRR...
77 diamond 266
  * ecx = [размер по оси x]*65536 + [размер по оси y]
267
  * edx = [координата по оси x]*65536 + [координата по оси y]
268
Возвращаемое значение:
269
  * функция не возвращает значения
270
Замечания:
271
  * Координаты изображения - это координаты верхнего левого угла
272
    изображения относительно окна.
273
  * Размер изображения в байтах есть 3*xsize*ysize.
274
 
275
======================================================================
276
=============== Функция 8 - определить/удалить кнопку. ===============
277
======================================================================
278
Параметры для определения кнопки:
279
  * eax = 8 - номер функции
280
  * ebx = [координата по оси x]*65536 + [размер по оси x]
281
  * ecx = [координата по оси y]*65536 + [размер по оси y]
282
  * edx = 0xXYnnnnnn, где:
283
    * nnnnnn = идентификатор кнопки
284
    * старший (31-й) бит edx сброшен
285
    * если 30-й бит edx установлен - не прорисовывать кнопку
286
    * если 29-й бит edx установлен - не рисовать рамку
287
      при нажатии на кнопку
288
  * esi = 0x00RRGGBB - цвет кнопки
289
Параметры для удаления кнопки:
290
  * eax = 8 - номер функции
291
  * edx = 0x80nnnnnn, где nnnnnn - идентификатор кнопки
292
Возвращаемое значение:
293
  * функция не возвращает значения
294
Замечания:
295
  * Размеры кнопки должны быть больше 0 и меньше 0x8000.
296
  * Для окон со скином при определении окна (вызове 0-й функции)
297
    создаются две стандартные кнопки - закрытия окна
298
    с идентификатором 1 и минимизации окна с идентификатором 0xffff.
299
  * Создание двух кнопок с одинаковыми идентификаторами
300
    вполне допустимо.
301
  * Кнопка с идентификатором 0xffff при нажатии интерпретируется
302
    системой как кнопка минимизации, система обрабатывает такое
303
    нажатие самостоятельно, не обращаясь к приложению.
304
    В остальном это обычная кнопка.
305
  * Общее количество кнопок для всех приложений ограничено
306
    числом 4095.
307
 
308
======================================================================
309
============= Функция 9 - информация о потоке выполнения. ============
310
======================================================================
311
Параметры:
312
  * eax = 9 - номер функции
313
  * ebx = указатель на буфер размера 1 Кб
314
  * ecx = номер слота потока
315
    ecx = -1 - получить информацию о текущем потоке
316
Возвращаемое значение:
317
  * eax = максимальный номер слота потока
318
  * буфер, на который указывает ebx, содержит следующую информацию:
319
    * +0: dword: использование процессора (сколько тактов в секунду
320
      уходит на исполнение именно этого потока)
321
    * +4: word: позиция окна потока в оконном стэке
322
    * +6: word: (не имеет отношения к запрошенному потоку)
323
      номер слота потока, окно которого находится в оконном стэке
324
      в позиции ecx
325
    * +8: word: зарезервировано
326
    * +10 = +0xA: 11 байт: имя процесса
327
      (имя соответствующего исполняемого файла в формате 8+3)
328
    * +21 = +0x15: byte: выравнивание, этот байт не изменяется
329
    * +22 = +0x16: dword: адрес процесса в памяти
330
    * +26 = +0x1A: dword: размер используемой памяти - 1
331
    * +30 = +0x1E: dword: идентификатор (PID/TID)
332
    * +34 = +0x22: dword: координата окна потока по оси x
333
    * +38 = +0x26: dword: координата окна потока по оси y
334
    * +42 = +0x2A: dword: размер окна потока по оси x
335
    * +46 = +0x2E: dword: размер окна потока по оси y
336
    * +50 = +0x32: word: состояние слота потока:
337
      * 0 = поток выполняется
338
      * 1 = поток приостановлен
339
      * 2 = поток приостановлен в момент ожидания события
340
      * 3 = поток завершается в результате вызова функции -1 или
341
        насильственно как следствие вызова подфункции 2 функции 18
342
        или завершения работы системы
343
      * 4 = поток завершается в результате исключения
344
      * 5 = поток ожидает события
345
      * 9 = запрошенный слот свободен, вся остальная информация о
346
        слоте не имеет смысла
347
Замечания:
348
  * Слоты нумеруются с 1.
349
  * Возвращаемое значение не есть общее число потоков, поскольку
350
    бывают свободные слоты.
351
  * При создании процесса автоматически создается поток выполнения.
352
  * Функция выдает информацию о потоке. Каждый процесс имеет
353
    хотя бы один поток. Один процесс может создать несколько потоков,
354
    в этом случае каждый поток получает свой слот, причем поля
355
    +10, +22, +26 в этих слотах совпадают.
356
    Для приложений не существует общего способа определить,
357
    принадлежат ли два потока одному процессу.
358
  * Активное окно - окно, находящееся на вершине оконного стэка,
359
    оно получает сообщения о вводе с клавиатуры. Для него позиция в
360
    оконном стэке совпадает с возвращаемым значением.
361
  * Слот 1 соответствует специальному потоку операционной системы,
362
    для которого:
363
    * окно находится внизу оконного стэка, поля +4 и +6 содержат
364
      значение 1
365
    * имя процесса - "OS/IDLE" (дополненное пробелами)
366
    * адрес процесса в памяти равен 0, размер используемой памяти
367
      16 Mb (0x1000000)
368
    * PID=1
369
    * координаты и размеры окна условно полагаются равными 0
370
    * состояние слота - всегда 0 (выполняется)
371
    * время выполнения складывается из времени, уходящего на
372
      собственно работу, и времени простоя в ожидании прерывания
373
      (которое можно получить вызовом подфункции 4 функции 18).
374
  * Начиная со слота 2, размещаются обычные приложения.
375
  * Обычные приложения размещаются в памяти по адресу 0x10000000
376
    (константа ядра std_application_base_address).
377
    Наложения не происходит, поскольку у каждого процесса своя
378
    таблица страниц.
379
  * При создании потока ему назначаются слот в системной таблице и
380
    идентификатор (Process/Thread IDentifier = PID/TID), которые для
381
    заданного потока не изменяются со временем.
382
    После завершения потока его слот может быть заново использован
383
    для другого потока. Идентификатор потока не может быть назначен
384
    другому потоку даже после завершения первого.
385
    Назначаемые новым потокам идентификаторы монотонно растут.
386
  * Если поток еще не определил свое окно вызовом функции 0, то
387
    положение и размеры этого окна полагаются нулями.
388
  * В данный момент используется только часть буфера размером
389
    52 = 0x34 байта. Тем не менее рекомендуется использовать буфер
390
    размером 1 Кб для будущей совместимости, в будущем могут быть
391
    добавлены некоторые поля.
392
 
393
======================================================================
394
==================== Функция 10 - ожидать события. ===================
395
======================================================================
396
Если очередь сообщений пуста, то ждет появления сообщения в очереди.
397
В таком состоянии поток не получает процессорного времени.
398
Затем считывает сообщение из очереди.
399
 
400
Параметры:
401
  * eax = 10 - номер функции
402
Возвращаемое значение:
403
  * eax = событие (смотри список событий)
404
Замечания:
405
  * Учитываются только те события, которые входят в маску,
406
    устанавливаемую функцией 40. По умолчанию это события
407
    перерисовки, нажатия на клавиши и на кнопки.
408
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
409
    Чтобы ждать не более определенного времени, используйте
410
    функцию 23.
411
 
412
======================================================================
413
======= Функция 11 - проверить, есть ли событие, без ожидания. =======
414
======================================================================
415
Если в очереди сообщений есть какое-то событие, то считывает и
416
возвращает его. Если очередь пуста, возвращает нуль.
417
Параметры:
418
  * eax = 11 - номер функции
419
Возвращаемое значение:
420
  * eax = 0 - очередь сообщений пуста
421
  * иначе eax = событие (смотри список событий)
422
Замечания:
423
  * Учитываются только те события, которые входят в маску,
424
    устанавливаемую функцией 40. По умолчанию это события
425
    перерисовки, нажатия на клавиши и на кнопки.
426
  * Для ожидания появления события в очереди, используйте функцию 10.
427
    Чтобы ждать не более определенного времени, используйте
428
    функцию 23.
429
 
430
======================================================================
431
=========== Функция 12 - начать/закончить перерисовку окна. ==========
432
======================================================================
433
 
434
-------------- Подфункция 1 - начать перерисовку окна. ---------------
435
Параметры:
436
  * eax = 12 - номер функции
437
  * ebx = 1 - номер подфункции
438
Возвращаемое значение:
439
  * функция не возвращает значения
440
 
441
------------- Подфункция 2 - закончить перерисовку окна. -------------
442
Параметры:
443
  * eax = 12 - номер функции
444
  * ebx = 2 - номер подфункции
445
Возвращаемое значение:
446
  * функция не возвращает значения
447
Замечания:
131 diamond 448
  * Функция начала перерисовки удаляет все определённые
77 diamond 449
    функцией 8 кнопки, их следует определить повторно.
450
 
451
======================================================================
452
============ Функция 13 - нарисовать прямоугольник в окне. ===========
453
======================================================================
454
Параметры:
455
  * eax = 13 - номер функции
456
  * ebx = [координата по оси x]*65536 + [размер по оси x]
457
  * ecx = [координата по оси y]*65536 + [размер по оси y]
458
  * edx = цвет 0xRRGGBB или 0x80RRGGBB для градиентной заливки
459
Возвращаемое значение:
460
  * функция не возвращает значения
461
Замечания:
462
  * Под координатами понимаются координаты левого верхнего угла
463
    прямоугольника относительно окна.
464
 
465
======================================================================
466
================ Функция 14 - получить размеры экрана. ===============
467
======================================================================
468
Параметры:
469
  * eax = 14 - номер функции
470
Возвращаемое значение:
471
  * eax = [xsize]*65536 + [ysize], где
472
  * xsize = x-координата правого нижнего угла экрана =
473
            размер по горизонтали - 1
474
  * ysize = y-координата правого нижнего угла экрана =
475
            размер по вертикали - 1
476
Замечания:
477
  * Смотри также подфункцию 5 функции 48 - получить размеры рабочей
478
    области экрана.
479
 
480
======================================================================
481
= Функция 15, подфункция 1 - установить размер фонового изображения. =
482
======================================================================
483
Параметры:
484
  * eax = 15 - номер функции
485
  * ebx = 1 - номер подфункции
486
  * ecx = ширина изображения
487
  * edx = высота изображения
488
Возвращаемое значение:
489
  * функция не возвращает значения
490
Замечания:
491
  * Проверок на корректность не делается. Установка слишком больших
131 diamond 492
    значений приведёт к тому, что в фон войдут данные за границей
77 diamond 493
    буфера фонового изображения. Размер буфера = 0x160000-0x10, что
494
    соответствует максимальным размерам 800*600. (800*600*3=0x15F900)
495
  * Для обновления экрана (после завершения серии команд, работающих с
496
    фоном) вызывайте подфункцию 3 перерисовки фона.
497
  * Есть парная функция получения размеров фонового изображения -
498
    подфункция 1 функции 39.
499
 
500
======================================================================
501
= Функция 15, подфункция 2 - поставить точку на фоновом изображении. =
502
======================================================================
503
Параметры:
504
  * eax = 15 - номер функции
505
  * ebx = 2 - номер подфункции
506
  * ecx = смещение
507
  * edx = цвет точки 0xRRGGBB
508
Возвращаемое значение:
509
  * функция не возвращает значения
510
Замечания:
511
  * Смещение для точки с координатами (x,y) вычисляется как
512
    (x+y*xsize)*3.
513
  * Если указанное смещение превышает 0x160000-16 =
514
    1.375 Mb - 16 bytes, вызов игнорируется.
515
  * Для обновления экрана (после завершения серии команд, работающих с
516
    фоном) вызывайте подфункцию 3 перерисовки фона.
517
  * Есть парная функция получения точки с фонового изображения -
518
    подфункция 2 функции 39.
519
 
520
======================================================================
521
============ Функция 15, подфункция 3 - перерисовать фон. ============
522
======================================================================
523
Параметры:
524
  * eax = 15 - номер функции
525
  * ebx = 3 - номер подфункции
526
Возвращаемое значение:
527
  * функция не возвращает значения
528
 
529
======================================================================
530
===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====
531
======================================================================
532
Параметры:
533
  * eax = 15 - номер функции
534
  * ebx = 4 - номер подфункции
535
  * ecx = режим отрисовки:
536
    * 1 = замостить
537
    * 2 = растянуть
538
Возвращаемое значение:
539
  * функция не возвращает значения
540
Замечания:
541
  * Для обновления экрана (после завершения серии команд, работающих с
542
    фоном) вызывайте подфункцию 3 перерисовки фона.
543
  * Есть парная команда получения режима отрисовки фона -
544
    подфункция 4 функции 39.
545
 
546
======================================================================
547
===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====
548
======================================================================
549
Параметры:
550
  * eax = 15 - номер функции
551
  * ebx = 5 - номер подфункции
81 diamond 552
  * ecx = указатель на данные в формате BBGGRRBBGGRR...
77 diamond 553
  * edx = смещение в данных фонового изображения
554
  * esi = размер данных в байтах = 3 * число пикселей
555
Возвращаемое значение:
556
  * функция не возвращает значения
557
Замечания:
558
  * Если блок вылезает за границу 0x160000-16 = 1.375 Mb - 16 bytes,
559
    то вызов игнорируется.
81 diamond 560
  * Цвет каждого пикселя хранится как 3-байтная величина BBGGRR.
77 diamond 561
  * Пиксели фонового изображения записываются последовательно
562
    слева направо, сверху вниз.
563
  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.
564
  * Для обновления экрана (после завершения серии команд, работающих с
565
    фоном) вызывайте подфункцию 3 перерисовки фона.
566
 
567
======================================================================
568
============= Функция 16 - сохранить рамдиск на дискету. =============
569
======================================================================
570
Параметры:
571
  * eax = 16 - номер функции
572
  * ebx = 1 или ebx = 2 - на какую дискету сохранять
573
Возвращаемое значение:
574
  * eax = 0 - успешно
575
  * eax = 1 - ошибка
576
 
577
======================================================================
578
============== Функция 17 - получить код нажатой кнопки. =============
579
======================================================================
580
Забирает код нажатой кнопки из буфера.
581
Параметры:
582
  * eax = 17 - номер функции
583
Возвращаемое значение:
584
  * если буфер пуст, возвращается eax=1
585
  * если буфер непуст, то возвращается al=0, старшие 24 бита eax
586
    содержат идентификатор кнопки (в частности, в ah оказывается
587
    младший байт идентификатора; если все кнопки имеют идентификатор,
588
    меньший 256, то для различения достаточно ah)
589
Замечания:
590
  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки
591
    информация о старой теряется.
592
  * При вызове этой функции приложением с неактивным окном
593
    возвращается ответ "буфер пуст".
594
 
595
======================================================================
596
======== Функция 18, подфункция 1 - завершить работу системы. ========
597
======================================================================
598
Параметры:
599
  * eax = 18 - номер функции
600
  * ebx = 1 - номер подфункции
601
Возвращаемое значение:
602
  * всегда возвращается eax = 0 как признак успеха
603
Замечания:
604
  * На последнем шаге появляется меню выхода из системы, ожидающее
605
    реакции пользователя.
606
  * Смотри также подфункцию 9, завершение работы системы с параметром,
607
    чтобы форсировать выбор в меню выхода.
608
 
609
======================================================================
91 diamond 610
==== Функция 18, подфункция 2 - завершить процесс/поток по слоту. ====
77 diamond 611
======================================================================
612
Параметры:
613
  * eax = 18 - номер функции
614
  * ebx = 2 - номер подфункции
615
  * ecx = номер слота процесса/потока
616
Возвращаемое значение:
617
  * функция не возвращает значения
618
Замечания:
619
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
620
    1), можно завершить любой обычный поток/процесс.
91 diamond 621
  * Смотри также подфункцию 18 - завершение
622
    процесса/потока с заданным идентификатором.
77 diamond 623
 
624
======================================================================
625
= Функция 18, подфункция 3 - сделать активным окно заданного потока. =
626
======================================================================
627
Параметры:
628
  * eax = 18 - номер функции
629
  * ebx = 3 - номер подфункции
630
  * ecx = номер слота потока
631
Возвращаемое значение:
632
  * функция не возвращает значения
633
Замечания:
634
  * При указании корректного, но несуществующего слота активизируется
635
    какое-то окно.
636
  * Узнать, какое окно является активным, можно вызовом подфункции 7.
637
 
638
======================================================================
131 diamond 639
 Функция 18, подфункция 4 - получить счётчик пустых тактов в секунду.
77 diamond 640
======================================================================
641
Под пустыми тактами понимается время, в которое процессор простаивает
642
в ожидании прерывания (в инструкции hlt).
643
 
644
Параметры:
645
  * eax = 18 - номер функции
646
  * ebx = 4 - номер подфункции
647
Возвращаемое значение:
131 diamond 648
  * eax = значение счётчика пустых тактов в секунду
77 diamond 649
 
650
======================================================================
651
======== Функция 18, подфункция 5 - получить тактовую частоту. =======
652
======================================================================
653
Параметры:
654
  * eax = 18 - номер функции
655
  * ebx = 5 - номер подфункции
656
Возвращаемое значение:
657
  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)
658
 
659
======================================================================
131 diamond 660
 Функция 18, подфункция 6 - сохранить рамдиск в файл на жёстком диске.
77 diamond 661
======================================================================
662
Параметры:
663
  * eax = 18 - номер функции
664
  * ebx = 6 - номер подфункции
665
  * ecx определяет путь к файлу:
666
    * 1 = в папке "/KOLIBRI"
667
    * 2 = в корневом каталоге
668
    * 3 = edx указывает на путь (имена папок в формате 8+3,
131 diamond 669
      разделённые '/')
77 diamond 670
Возвращаемое значение:
671
  * eax = 0 - успешно
672
  * иначе eax = код ошибки файловой системы
673
Замечания:
674
  * Имя файла фиксировано, "menuet.img" (глобальная переменная ядра
675
    image_save из preboot.inc)
131 diamond 676
  * На каком разделе какого диска файл будет сохранён, определяется
77 diamond 677
    подфункцией 7 и подфункцией 8 функции 21.
131 diamond 678
  * Все папки в указанном пути должны существовать, иначе вернётся
77 diamond 679
    значение 5, "файл не найден".
680
 
681
======================================================================
682
====== Функция 18, подфункция 7 - получить номер активного окна. =====
683
======================================================================
684
Параметры:
685
  * eax = 18 - номер функции
686
  * ebx = 7 - номер подфункции
687
Возвращаемое значение:
688
  * eax = номер активного окна (номер слота потока, окно которого
689
    активно)
690
Замечания:
691
  * Активное окно находится вверху оконного стэка и получает
131 diamond 692
    сообщения обо всём вводе с клавиатуры.
77 diamond 693
  * Сделать окно активным можно вызовом подфункции 3.
694
 
695
======================================================================
696
==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====
697
======================================================================
131 diamond 698
При отключённом звуке вызовы подфункции 55 функции 55 игнорируются.
699
При включённом - направляются на встроенный спикер.
77 diamond 700
 
701
--------------- Подподфункция 1 - получить состояние. ----------------
702
Параметры:
703
  * eax = 18 - номер функции
704
  * ebx = 8 - номер подфункции
705
  * ecx = 1 - номер подподфункции
706
Возвращаемое значение:
131 diamond 707
  * eax = 0 - звук спикера разрешён; 1 - запрещён
77 diamond 708
 
709
-------------- Подподфункция 2 - переключить состояние. --------------
710
Переключает состояния разрешения/запрещения.
711
Параметры:
712
  * eax = 18 - номер функции
713
  * ebx = 8 - номер подфункции
714
  * ecx = 2 - номер подподфункции
715
Возвращаемое значение:
716
  * функция не возвращает значения
717
 
718
======================================================================
719
= Функция 18, подфункция 9 - завершение работы системы с параметром. =
720
======================================================================
721
Параметры:
722
  * eax = 18 - номер функции
723
  * ebx = 9 - номер подфункции
724
  * ecx = параметр:
725
    * 1 = на последнем шаге завершения работы сохранить рамдиск на
726
      дискету, после чего вывести меню выхода и запросить у
727
      пользователя дальнейшие действия
728
    * 2 = выключить компьютер
729
    * 3 = перезагрузить компьютер
730
    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске
731
Возвращаемое значение:
732
  * при неверном ecx регистры не меняются (т.е. eax=18)
733
  * при правильном вызове всегда возвращается признак успеха eax=0
734
Замечания:
735
  * Не следует полагаться на возвращаемое значение при неверном
736
    вызове, оно может измениться в последующих версиях ядра.
737
  * Можно использовать подфункцию 1, чтобы на последнем шаге
738
    завершения работы пользователь сам решал, что ему нужно.
739
  * Не рекомендуется использовать значение ecx=1 (чтобы не раздражать
740
    пользователя излишними вопросами); сохранить рамдиск на дискету
741
    можно функцией 16 (которая допускает уточнение, на какую именно
742
    дискету писать), а завершить работу с меню выхода можно уже
743
    упомянутой подфункцией 1.
744
 
745
======================================================================
746
======== Функция 18, подфункция 10 - свернуть окно приложения. =======
747
======================================================================
748
Сворачивает собственное окно.
749
Параметры:
750
  * eax = 18 - номер функции
751
  * ebx = 10 - номер подфункции
752
Возвращаемое значение:
753
  * функция не возвращает значения
754
Замечания:
755
  * Минимизированное окно с точки зрения функции 9 сохраняет положение
756
    и размеры.
757
  * Восстановление окна приложения происходит при активизировании
758
    подфункцией 3.
131 diamond 759
  * Обычно нет необходимости явно сворачивать/разворачивать своё окно:
77 diamond 760
    сворачивание окна осуществляется системой при нажатии на кнопку
761
    минимизации (которая для окон со скином определяется автоматически
131 diamond 762
    функцией 0, для окон без скина её можно определить функцией 8),
77 diamond 763
    восстановление - приложением @panel.
764
 
765
======================================================================
766
====================== Функция 18, подфункция 11 =====================
767
============= Получить информацию о дисковой подсистеме. =============
768
======================================================================
769
Параметры:
770
  * eax = 18 - номер функции
771
  * ebx = 11 - номер подфункции
772
  * ecx = тип таблицы:
773
    * 1 = короткая версия, 10 байт
774
    * 2 = полная версия, 65536 байт
775
  * edx = указатель на буфер (в приложении) для таблицы
776
Возвращаемое значение:
777
  * функция не возвращает значения
778
Формат таблицы: короткая версия:
779
  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,
131 diamond 780
    где AAAA задаёт тип первого дисковода, BBBB - второго согласно
77 diamond 781
    следующему списку:
782
    * 0 = нет дисковода
783
    * 1 = 360Kb, 5.25''
784
    * 2 = 1.2Mb, 5.25''
785
    * 3 = 720Kb, 3.5''
786
    * 4 = 1.44Mb, 3.5''
787
    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)
788
    Например, для стандартной конфигурации из одного 1.44-дисковода
789
    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:
790
    значение оказывается 24h.
131 diamond 791
  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,
77 diamond 792
    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
793
    * 0 = устройство отсутствует
131 diamond 794
    * 1 = жёсткий диск
77 diamond 795
    * 2 = CD-привод
796
    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
131 diamond 797
  * +2: 4 db: число найденных разделов на жёстких дисках с
77 diamond 798
    соответственно IDE0,...,IDE3.
131 diamond 799
    При отсутствии жёсткого диска на IDEx соответствующий байт
77 diamond 800
    нулевой, при наличии показывает число распознанных разделов,
801
    которых может и не быть (если носитель не отформатирован или
802
    если файловая система не поддерживается). В текущей версии ядра
131 diamond 803
    для жёстких дисков поддерживаются только FAT16 и FAT32.
77 diamond 804
  * +6: 4 db: зарезервировано
805
Формат таблицы: полная версия:
806
  * +0: 10 db: такие же, как и в короткой версии
807
  * +10: 100 db: данные для первого раздела
808
  * +110: 100 db: данные для второго раздела
809
  * ...
810
  * +10+100*(n-1): 100 db: данные для последнего раздела
811
Разделы расположены в следующем порядке: сначала последовательно все
812
распознанные разделы на HD на IDE0 (если есть),
813
затем на HD на IDE1 (если есть) и т.д. до IDE3.
814
Формат информации о разделе (пока поддерживается только FAT):
815
  * +0: dword: начальный физический сектор раздела
816
  * +4: dword: последний физический сектор раздела
817
    (принадлежит разделу)
818
  * +8: dword: секторов в одной копии FAT
819
  * +12 = +0xC: dword: число копий FAT
820
  * +16 = +0x10: dword: число секторов в кластере
821
  * +20 = +0x14: dword: байт в секторе; текущая реализация ожидает,
822
    что здесь 0x200 = 512
823
  * +24 = +0x18: dword: первый кластер корневого каталога в FAT32,
824
 
825
  * +28 = +0x1C: dword: начальный физический сектор FAT
826
  * +32 = +0x20: dword: первый физический сектор корневого каталога
827
    для FAT16, игнорируется для FAT32
828
  * +36 = +0x24: dword: число секторов в корневом каталоге для FAT16,
829
 
830
  * +40 = +0x28: dword: физический сектор начала области данных
831
  * +44 = +0x2C: dword: максимальный номер кластера
832
  * +48 = +0x30: dword: физический сектор информации о
833
    файловой системе для FAT32, игнорируется для FAT16
834
  * +52 = +0x34: dword: значение, используемое как граница
835
    специальных значений в FAT
836
  * +56 = +0x38: dword: значение, используемое для плохих кластеров
837
    в FAT
838
  * +60 = +0x3C: dword: значение, используемое как маркер конца
839
    при записи цепочки в FAT
840
  * +64 = +0x40: dword: маска, накладываемая на элемент FAT
841
  * +68 = +0x44: byte: тип файловой системы: 16 или 32
842
  * +69 = +0x45: 31 db: зарезервировано
843
Замечания:
844
  * Короткая таблица может быть использована для получения информации
845
    об имеющихся устройствах.
846
  * Первые два поля информации о разделе в полной версии таблицы
847
    сообщают параметры раздела, оставшиеся - параметры файловой
848
    системы FAT. Для других файловых систем (когда они будут
849
    поддерживаться) специфическая для файловой системы информация,
850
    естественно, будет другой, но первые два поля
851
    сохранятся неизменными.
852
 
853
======================================================================
854
========== Функция 18, подфункция 13 - получить версию ядра. =========
855
======================================================================
856
Параметры:
857
  * eax = 18 - номер функции
858
  * ebx = 13 - номер подфункции
859
  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена
860
    информация
861
Возвращаемое значение:
862
  * функция не возвращает значения
863
Структура буфера:
864
db a,b,c,d для версии a.b.c.d
865
db UID_xxx: одно из UID_NONE=0, UID_MENUET=1, UID_KOLIBRI=2
866
db 'name',0 - ASCIIZ-строка с именем
118 diamond 867
Для ядра Kolibri 0.5.8.1:
868
db 0,5,8,1
77 diamond 869
db 2
870
db 'Kolibri',0
871
 
872
======================================================================
873
====================== Функция 18, подфункция 14 =====================
131 diamond 874
======= Ожидать начала обратного хода луча развёртки монитора. =======
77 diamond 875
======================================================================
876
Параметры:
877
  * eax = 18 - номер функции
878
  * ebx = 14 - номер подфункции
879
Возвращаемое значение:
880
  * eax = 0 как признак успеха
881
Замечания:
882
  * Функция предназначена исключительно для активных
883
    высокопроизводительных графических приложений; используется для
884
    плавного вывода графики.
885
 
886
======================================================================
887
== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =
888
======================================================================
889
Параметры:
890
  * eax = 18 - номер функции
891
  * ebx = 15 - номер подфункции
892
Возвращаемое значение:
893
  * eax = 0 как признак успеха
894
 
895
======================================================================
896
====================== Функция 18, подфункция 16 =====================
897
============ Получить размер свободной оперативной памяти. ===========
898
======================================================================
899
Параметры:
900
  * eax = 18 - номер функции
901
  * ebx = 16 - номер подфункции
902
Возвращаемое значение:
903
  * eax = размер свободной памяти в килобайтах
904
 
905
======================================================================
906
====================== Функция 18, подфункция 17 =====================
907
============ Получить размер имеющейся оперативной памяти. ===========
908
======================================================================
909
Параметры:
910
  * eax = 18 - номер функции
911
  * ebx = 17 - номер подфункции
912
Возвращаемое значение:
913
  * eax = общий размер имеющейся памяти в килобайтах
914
 
915
======================================================================
91 diamond 916
====================== Функция 18, подфункция 18 =====================
917
============= Завершить процесс/поток по идентификатору. =============
85 halyavin 918
======================================================================
919
Параметры:
920
  * eax = 18 - номер функции
921
  * ebx = 18 - номер подфункции
91 diamond 922
  * ecx = идентификатор процесса/потока (PID/TID)
923
Возвращаемое значение:
924
  * eax = 0 - успешно
925
  * eax = -1 - ошибка (процесс не найден или является системным)
926
Замечания:
927
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
928
    1), можно завершить любой обычный поток/процесс.
929
  * Смотри также подфункцию 2 - завершение
930
    процесса/потока по заданному слоту.
85 halyavin 931
 
932
======================================================================
131 diamond 933
=== Функция 18, подфункция 19 - получить/установить настройки мыши. ==
120 mario79 934
======================================================================
131 diamond 935
 
936
------------- Подподфункция 0 - получить скорость мыши. --------------
120 mario79 937
Параметры:
938
  * eax = 18 - номер функции
939
  * ebx = 19 - номер подфункции
131 diamond 940
  * ecx = 0 - номер подподфункции
941
Возвращаемое значение:
942
  * eax = текущая скорость мыши
120 mario79 943
 
131 diamond 944
------------ Подподфункция 1 - установить скорость мыши. -------------
945
Параметры:
946
  * eax = 18 - номер функции
947
  * ebx = 19 - номер подфункции
948
  * ecx = 1 - номер подподфункции
949
  * edx = новое значение скорости
950
Возвращаемое значение:
951
  * функция не возвращает значения
120 mario79 952
 
131 diamond 953
------------- Подподфункция 2 - получить задержку мыши. --------------
954
Параметры:
955
  * eax = 18 - номер функции
956
  * ebx = 19 - номер подфункции
957
  * ecx = 2 - номер подподфункции
958
Возвращаемое значение:
959
  * eax = текущая задержка мыши
120 mario79 960
 
131 diamond 961
------------ Подподфункция 3 - установить задержку мыши. -------------
962
Параметры:
963
  * eax = 18 - номер функции
964
  * ebx = 19 - номер подфункции
965
  * ecx = 3 - номер подподфункции
966
  * edx = новое значение задержки мыши
967
Возвращаемое значение:
968
  * функция не возвращает значения
120 mario79 969
 
131 diamond 970
-------- Подподфункция 4 - установить положение курсора мыши. --------
971
Параметры:
972
  * eax = 18 - номер функции
973
  * ebx = 19 - номер подфункции
974
  * ecx = 4 - номер подподфункции
975
  * edx = [координата по оси x]*65536 + [координата по оси y]
976
Возвращаемое значение:
977
  * функция не возвращает значения
120 mario79 978
Замечания:
131 diamond 979
  * Рекомендуемая скорость мыши (в подподфункции 1) от 1 до 9.
980
    Устанавливаемая величина не проверяется кодом ядра, поэтому
981
    используйте осторожно, при некорректном значении курсор может
982
    "замёрзнуть". Скорость мыши можно регулировать в приложении SETUP.
983
  * Рекомендуемая величина задержки (в подподфункции 3) = 10.
984
    Меньшие значения не обрабатываются COM-мышами. При очень больших
985
    значениях невозможно передвижение мыши на 1 пиксель и курсор будет
986
    прыгать на величину установленной скорости (подподфункция 1).
987
    Устанавливаемая величина не проверяется кодом ядра.
133 diamond 988
    Величину задержки можно менять в приложении SETUP.
131 diamond 989
  * Подподфункция 4 не проверяет переданное значение. Перед вызовом
990
    необходимо узнать текущее разрешение экрана (подфункцией 14)
991
    и проверить, что устанавливаемое положение не выходит за пределы
992
    экрана.
120 mario79 993
 
994
======================================================================
77 diamond 995
============ Функция 19 - запустить программу с рамдиска. ============
996
======================================================================
997
Параметры:
998
  * eax = 19 - номер функции
999
  * ebx = указатель на имя программы в формате, аналогичном функции 6
1000
  * ecx = 0 или ecx = указатель на параметры командной строки
1001
Возвращаемое значение:
1002
  * Если eax > 0, то eax содержит PID созданного процесса
1003
  * Если eax < 0, то -eax - код ошибки файловой системы
1004
Замечания:
91 diamond 1005
  * Эта функция устарела; используйте подфункцию 7 функции 70.
114 mikedld 1006
  * Командная строка должна заканчиваться символом с кодом 0
77 diamond 1007
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
1008
    включительно, либо первые 256 символов, в зависимости от того,
1009
    что меньше.
1010
 
1011
======================================================================
1012
==================== Функция 20 - интерфейс MIDI. ====================
1013
======================================================================
1014
 
1015
------------------------ Подфункция 1 - сброс ------------------------
1016
Параметры:
1017
  * eax = 20 - номер функции
1018
  * ebx = 1 - номер подфункции
1019
 
1020
-------------------- Подфункция 2 - вывести байт ---------------------
1021
Параметры:
1022
  * eax = 20 - номер функции
1023
  * ebx = 2 - номер подфункции
1024
  * cl = байт для вывода
1025
Возвращаемое значение (одинаково для обеих подфункций):
1026
  * eax = 0 - успешно
131 diamond 1027
  * eax = 1 - не определён базовый порт
77 diamond 1028
Замечания:
131 diamond 1029
  * Предварительно должен быть определён базовый порт вызовом
77 diamond 1030
    подфункции 1 функции 21.
1031
 
1032
======================================================================
1033
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
1034
======================================================================
1035
Параметры:
1036
  * eax = 21 - номер функции
1037
  * ebx = 1 - номер подфункции
1038
  * ecx = номер базового порта
1039
Возвращаемое значение:
1040
  * eax = 0 - успешно
1041
  * eax = -1 - ошибочный номер порта
1042
Замечания:
1043
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1044
  * Установка базы нужна для работы функции 20.
1045
  * Получить установленный базовый порт можно вызовом
1046
    подфункции 1 функции 26.
1047
 
1048
======================================================================
1049
===== Функция 21, подфункция 2 - установить раскладку клавиатуры. ====
1050
======================================================================
1051
Раскладка клавиатуры используется для преобразования сканкодов,
1052
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1053
Параметры:
1054
  * eax = 21 - номер функции
1055
  * ebx = 2 - номер подфункции
1056
  * ecx = какую раскладку устанавливать:
1057
    * 1 = нормальную
1058
    * 2 = раскладку при нажатом Shift
1059
    * 3 = раскладку при нажатом Alt
1060
  * edx = указатель на раскладку - таблицу длиной 128 байт
1061
Или:
1062
  * ecx = 9
1063
  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1064
Возвращаемое значение:
1065
  * eax = 0 - успешно
1066
  * eax = 1 - параметр задан неверно
1067
Замечания:
1068
  * Если нажат Alt, то используется раскладка с Alt;
1069
    если не нажат Alt, но нажат Shift, то
1070
    используется раскладка с Shift;
1071
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1072
    нормальная раскладка, после чего из кода вычитается 0x60;
1073
    если не нажата ни одна из управляющих клавиш, то используется
1074
    нормальная раскладка.
1075
  * Получить раскладки и идентификатор страны можно с помощью
1076
    подфункции 2 функции 26.
1077
  * Идентификатор страны - глобальная системная переменная, которая
1078
    самим ядром не используется; однако приложение @panel отображает
1079
    соответствующую текущей стране иконку.
1080
  * Приложение @panel переключает раскладки по запросу пользователя.
1081
 
1082
======================================================================
1083
=========== Функция 21, подфункция 3 - установить базу CD. ===========
1084
======================================================================
1085
Параметры:
1086
  * eax = 21 - номер функции
1087
  * ebx = 3 - номер подфункции
1088
  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1089
Возвращаемое значение:
1090
  * eax = 0
1091
Замечания:
1092
  * База CD используется функцией 24.
1093
  * Получить установленную базу CD можно вызовом
1094
    подфункции 3 функции 26.
1095
 
1096
======================================================================
1097
== Функция 21, подфункция 4 - установить базовый порт Sound Blaster. =
1098
======================================================================
1099
Параметры:
1100
  * eax = 21 - номер функции
1101
  * ebx = 4 - номер подфункции
1102
  * ecx = номер базового порта
1103
Возвращаемое значение:
1104
  * eax = 0 - успешно
1105
  * eax = -1 - ошибочный номер порта
1106
Замечания:
1107
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1108
  * Установка базы нужна для работы функций 25, 28, 55.
1109
  * Получить установленный базовый порт можно вызовом
1110
    подфункции 4 функции 26.
1111
 
1112
======================================================================
1113
========= Функция 21, подфункция 5 - установить язык системы. ========
1114
======================================================================
1115
Параметры:
1116
  * eax = 21 - номер функции
1117
  * ebx = 5 - номер подфункции
1118
  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1119
Возвращаемое значение:
1120
  * eax = 0
1121
Замечания:
1122
  * Язык системы - глобальная системная переменная, никак
1123
    не используемая самим ядром, однако приложение @panel рисует
1124
    соответствующую иконку.
1125
  * Проверок на корректность не делается, поскольку ядро эту
1126
    переменную не использует.
1127
  * Получить язык системы можно вызовом подфункции 5 функции 26.
1128
 
1129
======================================================================
1130
======= Функция 21, подфункция 6 - установить базовый порт WSS. ======
1131
======================================================================
1132
Параметры:
1133
  * eax = 21 - номер функции
1134
  * ebx = 6 - номер подфункции
1135
  * ecx = базовый порт
1136
Возвращаемое значение:
1137
  * eax = 0 - успешно
1138
  * eax = -1 - ошибочный номер порта
1139
Замечания:
1140
  * Номер порта должен удовлетворять условию 0x100<=ecx.
1141
  * База WSS используется функцией 27.
1142
  * Получить установленный базовый порт WSS можно вызовом
1143
    подфункции 6 функции 26.
1144
 
1145
======================================================================
1146
=========== Функция 21, подфункция 7 - установить базу HD. ===========
1147
======================================================================
131 diamond 1148
База HD нужна для определения, на какой жёсткий диск писать, при
77 diamond 1149
использовании устаревших функций работы с файловой системой и функций,
131 diamond 1150
неявно использующих жёсткий диск (типа подфункции 6 функции 18);
77 diamond 1151
при использовании функций 58 и 70 и современного синтаксиса
1152
/HD0,/HD1,/HD2,/HD3 эти функции сами устанавливают базу.
1153
Параметры:
1154
  * eax = 21 - номер функции
1155
  * ebx = 7 - номер подфункции
1156
  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1157
Возвращаемое значение:
1158
  * eax = 0
1159
Замечания:
1160
  * Любое приложение в любой момент времени может изменить базу.
1161
  * Не следует изменять базу, когда какое-нибудь приложение работает
131 diamond 1162
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1163
  * Получить установленную базу можно вызовом подфункции 7 функции 26.
131 diamond 1164
  * Следует также определить используемый раздел жёсткого диска
77 diamond 1165
    подфункцией 8.
1166
 
1167
======================================================================
1168
========== Функция 21, подфункция 8 - установить раздел HD. ==========
1169
======================================================================
131 diamond 1170
Раздел HD нужен для определения, на какой раздел жёсткого диска
77 diamond 1171
писать, при использовании устаревших функций работы с файловой
131 diamond 1172
системой и функций, неявно использующих жёсткий диск (типа
77 diamond 1173
подфункции 6 функции 18); при использовании функций 58 и 70
1174
и современного синтаксиса /HD0,/HD1,/HD2,/HD3 эти функции сами
1175
устанавливают базу и раздел.
1176
Параметры:
1177
  * eax = 21 - номер функции
1178
  * ebx = 8 - номер подфункции
1179
  * ecx = раздел HD (считая с 1)
1180
Возвращаемое значение:
1181
  * eax = 0
1182
Замечания:
1183
  * Любое приложение в любой момент времени может изменить раздел.
1184
  * Не следует изменять раздел, когда какое-нибудь приложение работает
131 diamond 1185
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1186
  * Получить установленный раздел можно вызовом подфункции 8
1187
    функции 26.
1188
  * Проверок на корректность не делается.
131 diamond 1189
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1190
    подфункции 11 функции 18.
131 diamond 1191
  * Следует также определить используемую базу жёсткого диска
77 diamond 1192
    подфункцией 7.
1193
 
1194
======================================================================
1195
===== Функция 21, подфункция 10 - установить канал DMA для звука. ====
1196
======================================================================
1197
Параметры:
1198
  * eax = 21 - номер функции
1199
  * ebx = 10 - номер подфункции
1200
  * ecx = номер канала (от 0 до 3 включительно)
1201
Возвращаемое значение:
1202
  * eax = 0 - успешно
1203
  * eax = -1 - неверный номер канала
1204
Замечания:
1205
  * Номер канала DMA используется в
1206
    подфункции 1 функции 55.
1207
  * Получить канал DMA для звука можно вызовом
1208
    подфункции 10 функции 26.
1209
 
1210
======================================================================
1211
====================== Функция 21, подфункция 11 =====================
1212
=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
1213
======================================================================
1214
Параметры:
1215
  * eax = 21 - номер функции
1216
  * ebx = 11 - номер подфункции
1217
  * ecx = 0/1 - запретить/разрешить
1218
Возвращаемое значение:
1219
  * eax = 0
1220
Замечания:
1221
  * Используется при LBA-чтении (подфункция 8 функции 58).
1222
  * Текущая реализация использует только младший бит ecx.
1223
  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
1224
 
1225
======================================================================
1226
====================== Функция 21, подфункция 12 =====================
1227
========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
1228
======================================================================
1229
Параметры:
1230
  * eax = 21 - номер функции
1231
  * ebx = 12 - номер подфункции
1232
  * ecx = 0/1 - запретить/разрешить
1233
Возвращаемое значение:
1234
  * eax = 0
1235
Замечания:
1236
  * Используется при работе с шиной PCI (функция 62).
1237
  * Текущая реализация использует только младший бит ecx.
1238
  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
1239
 
1240
======================================================================
1241
============= Функция 21, подфункция 13, подподфункция 1 =============
1242
==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
1243
======================================================================
1244
Параметры:
1245
  * eax = 21 - номер функции
1246
  * ebx = 13 - номер подфункции
1247
  * ecx = 1 - номер функции драйвера
1248
  * edx = указатель на буфер размера 512 байт
1249
Возвращаемое значение:
1250
  * если драйвер не загружен (никогда не бывает в текущей реализации):
1251
    * eax = -1
1252
    * ebx, ecx разрушаются
1253
  * если драйвер загружен:
1254
    * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт,
1255
      'Z' - старший) - сигнатура
131 diamond 1256
    * ebx = текущая частота развёртки (в Гц)
77 diamond 1257
    * ecx разрушается
1258
    * буфер, на который указывает edx, заполнен
1259
Формат буфера:
1260
  * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек,
1261
    дополнено пробелами)
1262
  * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как
1263
    y*65536+x), для текущей реализации 1 (1.0)
1264
  * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
1265
  * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое
1266
    слово - номер видеорежима, после собственно списка идут нули)
131 diamond 1267
  * +128 = +0x80: 32*(5*word): список поддерживаемых частот развёрток
77 diamond 1268
    для видеорежимов: для каждого видеорежима, указанного в предыдущем
1269
    поле, указано до 5 поддерживаемых частот
1270
    (в неиспользуемых позициях записаны нули)
1271
Замечания:
131 diamond 1272
  * Функция инициализирует драйвер (если он ещё не инициализирован)
77 diamond 1273
    и должна вызываться первой, перед остальными (иначе они будут
1274
    возвращать -1, ничего не делая).
131 diamond 1275
  * В текущей реализации поддерживается только одна частота развёртки
77 diamond 1276
    на видеорежим.
1277
 
1278
======================================================================
1279
============= Функция 21, подфункция 13, подподфункция 2 =============
1280
============= Получить информацию о текущем видеорежиме. =============
1281
======================================================================
1282
Параметры:
1283
  * eax = 21 - номер функции
1284
  * ebx = 13 - номер подфункции
1285
  * ecx = 2 - номер функции драйвера
1286
Возвращаемое значение:
1287
  * eax = -1 - драйвер не загружен или не инициализирован;
1288
    ebx,ecx разрушаются
1289
  * eax = [ширина]*65536 + [высота]
131 diamond 1290
  * ebx = частота вертикальной развёртки (в Гц)
77 diamond 1291
  * ecx = номер текущего видеорежима
1292
Замечания:
1293
  * Драйвер предварительно должен быть инициализирован вызовом
1294
    функции драйвера 1.
1295
  * Если нужны только размеры экрана, целесообразней использовать
131 diamond 1296
    функцию 14 с учётом того, что она возвращает размеры на 1 меньше.
77 diamond 1297
 
1298
======================================================================
1299
= Функция 21, подфункция 13, подподфункция 3 - установить видеорежим.
1300
======================================================================
1301
Параметры:
1302
  * eax = 21 - номер функции
1303
  * ebx = 13 - номер подфункции
1304
  * ecx = 3 - номер функции драйвера
131 diamond 1305
  * edx = [частота развёртки]*65536 + [номер видеорежима]
77 diamond 1306
Возвращаемое значение:
1307
  * eax = -1 - драйвер не загружен, не инициализирован или
1308
    произошла ошибка
1309
  * eax = 0 - успешно
1310
  * ebx, ecx разрушаются
1311
Замечания:
1312
  * Драйвер предварительно должен быть инициализирован вызовом
1313
    функции драйвера 1.
1314
  * Номер видеорежима и частота должны быть в таблице, возвращаемой
1315
    функцией драйвера 1.
1316
 
1317
======================================================================
1318
============= Функция 21, подфункция 13, подподфункция 4 =============
1319
================= Вернуться к начальному видеорежиму. ================
1320
======================================================================
1321
Возвращает экран в видеорежим, установленный при загрузке системы.
1322
Параметры:
1323
  * eax = 21 - номер функции
1324
  * ebx = 13 - номер подфункции
1325
  * ecx = 4 - номер функции драйвера
1326
Возвращаемое значение:
1327
  * eax = -1 - драйвер не загружен или не инициализирован
1328
  * eax = 0 - успешно
1329
  * ebx, ecx разрушаются
1330
Замечания:
1331
  * Драйвер предварительно должен быть инициализирован вызовом
1332
    функции драйвера 1.
1333
 
1334
======================================================================
1335
============= Функция 21, подфункция 13, подподфункция 5 =============
1336
======== Увеличить/уменьшить размер видимой области монитора. ========
1337
======================================================================
1338
Параметры:
1339
  * eax = 21 - номер функции
1340
  * ebx = 13 - номер подфункции
1341
  * ecx = 5 - номер функции драйвера
1342
  * edx = 0/1 - уменьшить/увеличить размер по горизонтали
1343
    на одну позицию
1344
  * edx = 2/3 - в текущей реализации не поддерживается; планируется
1345
    как уменьшение/увеличение размера по вертикали на одну позицию
1346
Возвращаемое значение:
1347
  * eax = -1 - драйвер не загружен или не инициализирован
1348
  * eax = 0 - успешно
1349
  * ebx, ecx разрушаются
1350
Замечания:
1351
  * Драйвер предварительно должен быть инициализирован вызовом
1352
    функции драйвера 1.
1353
  * Функция влияет только на физический размер изображения
1354
    на мониторе; логический размер (число пикселей) не меняется.
1355
 
1356
======================================================================
1357
============ Функция 22 - установить системную дату/время. ===========
1358
======================================================================
1359
Параметры:
1360
  * eax = 22 - номер функции
1361
  * ebx = 0 - установить время
1362
    * ecx = 0x00SSMMHH - время в двоично-десятичном коде (BCD):
1363
    * HH=час 00..23
1364
    * MM=минута 00..59
1365
    * SS=секунда 00..59
1366
  * ebx = 1 - установить дату
1367
    * ecx = 0x00DDMMYY - дата в двоично-десятичном коде (BCD):
1368
    * DD=день 01..31
1369
    * MM=месяц 01..12
1370
    * YY=год 00..99
1371
  * ebx = 2 - установить день недели
1372
    * ecx = 1 для воскресенья, ..., 7 для субботы
1373
  * ebx = 3 - установить будильник
1374
    * ecx = 0x00SSMMHH
1375
Возвращаемое значение:
1376
  * eax = 0 - успешно
1377
  * eax = 1 - параметр задан неверно
1378
  * eax = 2 - CMOS-батарейки разрядились
1379
Замечания:
1380
  * Ценность установки дня недели представляется сомнительной,
1381
    поскольку он мало где используется
1382
    (день недели можно рассчитать по дате).
1383
  * Будильник можно установить на срабатывание в заданное время
1384
    каждые сутки. При этом отключить его существующими системными
1385
    функциями нельзя.
1386
  * Срабатывание будильника заключается в генерации IRQ8.
1387
  * Вообще-то CMOS поддерживает для будильника установку значения
1388
    0xFF в качестве одного из параметров и означает это, что
1389
    соответствующий параметр игнорируется. Но в текущей реализации
131 diamond 1390
    это не пройдёт (вернётся значение 1).
77 diamond 1391
  * Будильник - глобальный системный ресурс; установка будильника
1392
    автоматически отменяет предыдущую установку. Впрочем, на данный
1393
    момент ни одна программа его не использует.
1394
 
1395
======================================================================
1396
============== Функция 23 - ожидать события с таймаутом. =============
1397
======================================================================
131 diamond 1398
Если очередь сообщений пуста, ждёт появления сообщения в очереди,
77 diamond 1399
но не более указанного времени. Затем считывает сообщение из очереди.
1400
 
1401
Параметры:
1402
  * eax = 23 - номер функции
1403
  * ebx = таймаут (в сотых долях секунды)
1404
Возвращаемое значение:
1405
  * eax = 0 - очередь сообщений пуста
1406
  * иначе eax = событие (смотри список событий)
1407
Замечания:
1408
  * Учитываются только те события, которые входят в маску,
1409
    устанавливаемую функцией 40. По умолчанию это события
1410
    перерисовки, нажатия на клавиши и на кнопки.
1411
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
1412
    Чтобы ждать сколь угодно долго, используйте функцию 10.
1413
  * Передача ebx=0 приводит к моментальному возвращению eax=0.
131 diamond 1414
  * При текущей реализации произойдёт немедленный возврат из функции
1415
    с eax=0, если сложение ebx с текущим значением счётчика времени
77 diamond 1416
    вызовет 32-битное переполнение.
1417
 
1418
======================================================================
1419
======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ======
1420
======================================================================
1421
Параметры:
1422
  * eax = 24 - номер функции
1423
  * ebx = 1 - номер подфункции
1424
  * ecx = 0x00FRSSMM, где
1425
    * MM = начальная минута
1426
    * SS = начальная секунда
1427
    * FR = начальный фрейм
1428
Возвращаемое значение:
1429
  * eax = 0 - успешно
1430
  * eax = 1 - не определена база CD
1431
Замечания:
1432
  * Предварительно нужно определить базовый порт CD вызовом
1433
    подфункции 3 функции 21.
1434
  * В секунде 75 фреймов, в минуте 60 секунд.
1435
  * Функция асинхронна (возвращает управление, когда началось
1436
    проигрывание).
1437
 
1438
======================================================================
1439
===== Функция 24, подфункция 2 - получить информацию о дорожках. =====
1440
======================================================================
1441
Параметры:
1442
  * eax = 24 - номер функции
1443
  * ebx = 2 - номер подфункции
1444
  * ecx = указатель на буфер для таблицы
1445
    (максимум 8*64h+4 байт=100 дорожек)
1446
Возвращаемое значение:
1447
  * eax = 0 - успешно
1448
  * eax = 1 - не определена база CD
1449
Замечания:
1450
  * Формат таблицы с информацией о дорожках такой же, как и для
1451
    ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h).
1452
    Адреса возвращаются в формате MSF.
1453
  * Предварительно нужно определить базовый порт CD вызовом
1454
    подфункции 3 функции 21.
1455
  * Функция возвращает информацию только о не более чем 100
1456
    первых дорожках. В большинстве случаев этого достаточно.
1457
 
1458
======================================================================
1459
==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. ===
1460
======================================================================
1461
Параметры:
1462
  * eax = 24 - номер функции
1463
  * ebx = 1 - номер подфункции
1464
Возвращаемое значение:
1465
  * eax = 0 - успешно
1466
  * eax = 1 - не определена база CD
1467
Замечания:
1468
  * Предварительно нужно определить базовый порт CD вызовом
1469
    подфункции 3 функции 21.
1470
 
1471
======================================================================
1472
============== Функция 25 - установить громкость SBPro. ==============
1473
======================================================================
1474
Параметры:
1475
  * eax = 25 - номер функции
1476
  * ebx = что устанавливать:
1477
    * 1 - установить общую громкость
1478
    * 2 - установить громкость CD-audio
1479
  * cl = уровень громкости: старшие 4 бита для левой колонки,
1480
    младшие 4 - для правой
1481
Возвращаемое значение:
1482
  * eax = 0 - успешно
1483
  * eax = 1 - не определена база SB
1484
  * eax = 2 - неверная подфункция
1485
Замечания:
1486
  * Предварительно нужно определить базовый порт SB вызовом
1487
    подфункции 4 функции 21.
1488
  * Смотри также функцию 28
1489
    установки звука для более позднего стандарта SB16.
1490
 
1491
======================================================================
1492
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
1493
======================================================================
1494
Параметры:
1495
  * eax = 26 - номер функции
1496
  * ebx = 1 - номер подфункции
1497
Возвращаемое значение:
1498
  * eax = номер порта
1499
Замечания:
1500
  * Установить базовый порт можно вызовом
1501
    подфункции 1 функции 21.
1502
 
1503
======================================================================
1504
====== Функция 26, подфункция 2 - получить раскладку клавиатуры. =====
1505
======================================================================
1506
Раскладка клавиатуры используется для преобразования сканкодов,
1507
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1508
Параметры:
1509
  * eax = 26 - номер функции
1510
  * ebx = 2 - номер подфункции
1511
  * ecx = какую раскладку получать:
1512
    * 1 = нормальную
1513
    * 2 = раскладку при нажатом Shift
1514
    * 3 = раскладку при нажатом Alt
1515
  * edx = указатель на буфер длиной 128 байт, куда будет скопирована
1516
    раскладка
1517
Возвращаемое значение:
1518
  * функция не возвращает значения
1519
Или:
1520
  * eax = 26 - номер функции
1521
  * ebx = 2 - номер подфункции
1522
  * ecx = 9
1523
Возвращаемое значение:
1524
  * eax = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1525
Замечания:
1526
  * Если нажат Alt, то используется раскладка с Alt;
1527
    если не нажат Alt, но нажат Shift, то используется
1528
    раскладка с Shift;
1529
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1530
    нормальная раскладка, после чего из кода вычитается 0x60;
1531
    если не нажата ни одна из управляющих клавиш, то используется
1532
    нормальная раскладка.
1533
  * Установить раскладки и идентификатор страны можно с помощью
1534
    подфункции 2 функции 21.
1535
  * Идентификатор страны - глобальная системная переменная, которая
1536
    самим ядром не используется; однако приложение @panel отображает
1537
    соответствующую текущей стране иконку
1538
    (используя описываемую функцию).
1539
  * Приложение @panel переключает раскладки по запросу пользователя.
1540
 
1541
======================================================================
1542
============ Функция 26, подфункция 3 - получить базу CD. ============
1543
======================================================================
1544
Параметры:
1545
  * eax = 26 - номер функции
1546
  * ebx = 3 - номер подфункции
1547
Возвращаемое значение:
1548
  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1549
Замечания:
1550
  * База CD используется функцией 24.
114 mikedld 1551
  * Установить базу CD можно вызовом подфункции 3 функции 21.
77 diamond 1552
 
1553
======================================================================
1554
=== Функция 26, подфункция 4 - получить базовый порт Sound Blaster. ==
1555
======================================================================
1556
Параметры:
1557
  * eax = 26 - номер функции
1558
  * ebx = 4 - номер подфункции
1559
Возвращаемое значение:
1560
  * eax = номер базового порта
1561
Замечания:
1562
  * Установка базы нужна для работы функций 25, 55.
1563
  * Установить базовый порт можно вызовом подфункции 4 функции 21.
1564
 
1565
======================================================================
1566
========== Функция 26, подфункция 5 - получить язык системы. =========
1567
======================================================================
1568
Параметры:
1569
  * eax = 26 - номер функции
1570
  * ebx = 5 - номер подфункции
1571
Возвращаемое значение:
1572
  * eax = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1573
Замечания:
1574
  * Язык системы - глобальная системная переменная, никак
1575
    не используемая самим ядром, однако приложение @panel рисует
1576
    соответствующую иконку (используя описываемую функцию).
1577
  * Установить язык системы можно вызовом подфункции 5 функции 21.
1578
 
1579
======================================================================
1580
======== Функция 26, подфункция 6 - получить базовый порт WSS. =======
1581
======================================================================
1582
Параметры:
1583
  * eax = 26 - номер функции
1584
  * ebx = 6 - номер подфункции
1585
Возвращаемое значение:
1586
  * eax = базовый порт
1587
Замечания:
1588
  * База WSS используется функцией 27.
1589
  * Установить базовый порт WSS можно вызовом подфункции 6 функции 21.
1590
 
1591
======================================================================
1592
============ Функция 26, подфункция 7 - получить базу HD. ============
1593
======================================================================
131 diamond 1594
База HD нужна для определения, на какой жёсткий диск писать, при
77 diamond 1595
использовании устаревших функций работы с файловой системой и функций,
131 diamond 1596
неявно использующих жёсткий диск (типа подфункции 6 функции 18);
77 diamond 1597
при использовании функций 58 и 70 и современного синтаксиса
1598
/HD0,/HD1,/HD2,/HD3 эти функции сами устанавливают базу.
1599
Параметры:
1600
  * eax = 26 - номер функции
1601
  * ebx = 7 - номер подфункции
1602
Возвращаемое значение:
1603
  * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1604
Замечания:
1605
  * Любое приложение в любой момент времени может изменить базу.
1606
  * Установить базу можно вызовом подфункции 7 функции 21.
131 diamond 1607
  * Получить используемый раздел жёсткого диска можно подфункцией 8.
77 diamond 1608
 
1609
======================================================================
1610
=========== Функция 26, подфункция 8 - получить раздел HD. ===========
1611
======================================================================
131 diamond 1612
Раздел HD нужен для определения, на какой раздел жёсткого диска
77 diamond 1613
писать, при использовании устаревших функций работы с файловой
131 diamond 1614
системой и функций, неявно использующих жёсткий диск (типа
77 diamond 1615
подфункции 6 функции 18); при использовании функций 58 и 70 и
1616
современного синтаксиса /HD0,/HD1,/HD2,/HD3 эти функции сами
1617
устанавливают базу и раздел.
1618
Параметры:
1619
  * eax = 26 - номер функции
1620
  * ebx = 8 - номер подфункции
1621
Возвращаемое значение:
1622
  * eax = раздел HD (считая с 1)
1623
Замечания:
1624
  * Любое приложение в любой момент времени может изменить раздел.
1625
  * Установить раздел можно вызовом подфункции 8 функции 21.
131 diamond 1626
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1627
    подфункции 11 функции 18.
131 diamond 1628
  * Получить используемую базу жёсткого диска можно подфункцией 7.
77 diamond 1629
 
1630
======================================================================
131 diamond 1631
=== Функция 26, подфункция 9 - получить значение счётчика времени. ===
77 diamond 1632
======================================================================
1633
Параметры:
1634
  * eax = 26 - номер функции
1635
  * ebx = 9 - номер подфункции
1636
Возвращаемое значение:
1637
  * eax = число сотых долей секунды, прошедших с момента
1638
    запуска системы
1639
Замечания:
131 diamond 1640
  * Счётчик берётся по модулю 2^32, что соответствует немногим более
77 diamond 1641
    497 суток.
1642
  * Системное время можно получить функцией 3.
1643
 
1644
======================================================================
1645
====== Функция 26, подфункция 10 - получить канал DMA для звука. =====
1646
======================================================================
1647
Параметры:
1648
  * eax = 26 - номер функции
1649
  * ebx = 10 - номер подфункции
1650
Возвращаемое значение:
1651
  * eax = номер канала (от 0 до 3 включительно)
1652
Замечания:
1653
  * Номер канала DMA используется в подфункции 1 функции 55.
1654
  * Установить канал DMA для звука можно вызовом
1655
    подфункции 10 функции 21.
1656
 
1657
======================================================================
1658
====================== Функция 26, подфункция 11 =====================
131 diamond 1659
=========== Узнать, разрешён ли низкоуровневый доступ к HD. ==========
77 diamond 1660
======================================================================
1661
Параметры:
1662
  * eax = 26 - номер функции
1663
  * ebx = 11 - номер подфункции
1664
Возвращаемое значение:
131 diamond 1665
  * eax = 0/1 - запрещён/разрешён
77 diamond 1666
Замечания:
1667
  * Используется при LBA-чтении (подфункция 8 функции 58).
1668
  * Установить текущее состояние можно вызовом
1669
    подфункции 11 функции 21.
1670
 
1671
======================================================================
1672
====================== Функция 26, подфункция 12 =====================
131 diamond 1673
========== Узнать, разрешён ли низкоуровневый доступ к PCI. ==========
77 diamond 1674
======================================================================
1675
Параметры:
1676
  * eax = 26 - номер функции
1677
  * ebx = 12 - номер подфункции
1678
Возвращаемое значение:
131 diamond 1679
  * eax = 0/1 - запрещён/разрешён
77 diamond 1680
Замечания:
1681
  * Используется при работе с шиной PCI (функция 62).
1682
  * Текущая реализация использует только младший бит ecx.
1683
  * Установить текущее состояние можно вызовом
1684
    подфункции 12 функции 21.
1685
 
1686
======================================================================
1687
==== Функция 27 - установить громкость Windows Sound System (WSS). ===
1688
======================================================================
1689
Параметры:
1690
  * eax = 27 - номер функции
1691
  * ebx = что устанавливать:
1692
    * 1 - установить общую громкость
1693
    * 2 - установить громкость Line In
1694
  * cl = уровень громкости (0x0=самый высокий, 0x1F=самый низкий,
1695
    установленный бит 0x80=отключить)
1696
Возвращаемое значение:
1697
  * eax = 0 - успешно
1698
  * eax = 1 - не определена база WSS
1699
  * eax = 2 - неверная подфункция
1700
Замечания:
1701
  * Предварительно нужно определить базовый порт WSS вызовом
1702
    подфункции 6 функции 21.
1703
  * Установка общей громкости фактически игнорируется
1704
    (возвращается eax=0).
1705
  * В старой документации и в исходниках ядра подфункция 2
1706
    ошибочно названа громкостью CD-audio.
1707
 
1708
======================================================================
1709
=============== Функция 28 - установить громкость SB16. ==============
1710
======================================================================
1711
Параметры:
1712
  * eax = 28 - номер функции
1713
  * ebx = что устанавливать:
1714
    * 1 - установить общую громкость
1715
    * 2 - установить громкость CD-audio
1716
  * cl = уровень громкости (0=off, 0xFF=max)
1717
Возвращаемое значение:
1718
  * eax = 0 - успешно
1719
  * eax = 1 - не определена база SB
1720
  * eax = 2 - неверная подфункция
1721
Замечания:
1722
  * Предварительно нужно определить базовый порт SB вызовом
1723
    подфункции 4 функции 21.
1724
  * Эта функция предоставляет больше вариантов для громкости,
1725
    чем функция 25.
1726
 
1727
======================================================================
1728
================ Функция 29 - получить системную дату. ===============
1729
======================================================================
1730
Параметры:
1731
  * eax = 29 - номер функции
1732
Возвращаемое значение:
1733
  * eax = 0x00DDMMYY, где
1734
    (используется двоично-десятичное кодирование, BCD)
1735
  * YY = две младшие цифры года (00..99)
1736
  * MM = месяц (01..12)
1737
  * DD = день (01..31)
1738
Замечания:
1739
  * Системную дату можно установить функцией 22.
1740
 
1741
======================================================================
1742
================ Функция 32 - удалить файл с рамдиска. ===============
1743
======================================================================
1744
Параметры:
1745
  * eax = 32 - номер функции
1746
  * ebx = указатель на имя файла
1747
Возвращаемое значение:
1748
  * eax = 0 - успешно; иначе код ошибки файловой системы
1749
Замечания:
1750
  * Эта функция устарела; функция 58 позволяет выполнять
1751
    те же действия с расширенными возможностями.
1752
  * Текущая реализация возвращает только значения 0(успех) и
1753
    5(файл не найден).
1754
  * Имя файла должно быть либо в формате 8+3 символов (первые
1755
    8 символов - собственно имя, последние 3 - расширение,
1756
    короткие имена и расширения дополняются пробелами),
1757
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1758
    (имя не более 8 символов, точка, расширение 3 символа,
1759
    дополненное при необходимости пробелами).
1760
    Имя файла должно быть записано заглавными буквами.
1761
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 1762
  * Эта функция не поддерживает папок на рамдиске.
77 diamond 1763
 
1764
======================================================================
1765
=============== Функция 33 - записать файл на рамдиск. ===============
1766
======================================================================
1767
Параметры:
1768
  * eax = 33 - номер функции
1769
  * ebx = указатель на имя файла
1770
  * ecx = указатель на данные для записи
1771
  * edx = число байт для записи
1772
  * следует устанавливать esi=0
1773
Возвращаемое значение:
1774
  * eax = 0 - успешно, иначе код ошибки файловой системы
1775
Замечания:
118 diamond 1776
  * Эта функция устарела; функция 70 позволяет выполнять
77 diamond 1777
    те же действия с расширенными возможностями.
1778
  * Если указать ненулевое значение в esi и на рамдиске уже есть
131 diamond 1779
    указанный файл, то будет создан ещё один файл с тем же именем.
77 diamond 1780
  * В противном случае файл перезаписывается.
1781
  * Имя файла должно быть либо в формате 8+3 символов
1782
    (первые 8 символов - собственно имя, последние 3 - расширение,
1783
    короткие имена и расширения дополняются пробелами),
1784
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1785
    (имя не более 8 символов, точка, расширение 3 символа,
1786
    дополненное при необходимости пробелами).
1787
    Имя файла должно быть записано заглавными буквами.
1788
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 1789
  * Эта функция не поддерживает папок на рамдиске.
77 diamond 1790
 
1791
======================================================================
1792
============ Функция 35 - прочитать цвет точки на экране. ============
1793
======================================================================
1794
Параметры:
1795
  * eax = 35
1796
  * ebx = y*xsize+x, где
1797
  * (x,y) = координаты точки (считая от 0)
1798
  * xsize = размер экрана по горизонтали
1799
Возвращаемое значение:
1800
  * eax = цвет 0x00RRGGBB
1801
Замечания:
1802
  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
1803
    что она вычитает 1 из обоих размеров.
1804
  * К видеопамяти есть также прямой доступ (без вызовов системных
1805
    функций) через селектор gs. Параметры текущего видеорежима
1806
    можно получить функцией 61.
1807
 
1808
======================================================================
1809
========== Функция 37 - получить координаты/состояние мыши. ==========
1810
======================================================================
1811
 
1812
-------------- Подфункция 0 - экранные координаты мыши ---------------
1813
Параметры:
1814
  * eax = 37 - номер функции
1815
  * ebx = 0 - номер подфункции
1816
Возвращаемое значение:
1817
  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
1818
 
1819
---------- Подфункция 1 - координаты мыши относительно окна ----------
1820
Параметры:
1821
  * eax = 37 - номер функции
1822
  * ebx = 1 - номер подфункции
1823
Возвращаемое значение:
1824
  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
1825
    окна приложения (считая от 0)
1826
Замечания:
1827
  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
1828
    Если y>=ywnd, то младшее слово неотрицательно и содержит
1829
    относительную y-координату, а старшее - относительную x-координату
1830
    (правильного знака). В противном случае младшее слово отрицательно
131 diamond 1831
    и всё равно содержит относительную y-координату,
77 diamond 1832
    а к старшему слову следует прибавить 1.
1833
 
1834
----------------- Подфункция 2 - нажатые кнопки мыши -----------------
1835
Параметры:
1836
  * eax = 37 - номер функции
1837
  * ebx = 2 - номер подфункции
1838
Возвращаемое значение:
1839
  * eax содержит информацию о нажатых кнопках мыши:
1840
  * бит 0 установлен = левая кнопка нажата
1841
  * бит 1 установлен = правая кнопка нажата
1842
  * прочие биты сброшены
1843
 
1844
======================================================================
1845
================== Функция 38 - нарисовать отрезок. ==================
1846
======================================================================
1847
Параметры:
1848
  * eax = 38 - номер функции
1849
  * ebx = [координата начала по оси x]*65536 +
1850
              [координата конца по оси x]
1851
  * ecx = [координата начала по оси y]*65536 +
1852
              [координата конца по оси y]
1853
  * edx = 0x00RRGGBB - цвет
133 diamond 1854
    edx = 0x01xxxxxx - рисовать инверсный отрезок
1855
          (младшие 24 бита игнорируются)
77 diamond 1856
Возвращаемое значение:
1857
  * функция не возвращает значения
1858
Замечания:
1859
  * Координаты берутся относительно окна.
1860
  * Конечная точка также рисуется.
1861
 
1862
======================================================================
1863
== Функция 39, подфункция 1 - получить размер фонового изображения. ==
1864
======================================================================
1865
Параметры:
1866
  * eax = 39 - номер функции
1867
  * ebx = 1 - номер подфункции
1868
Возвращаемое значение:
1869
  * eax = [ширина]*65536 + [высота]
1870
Замечания:
1871
  * Есть парная команда установки размеров фонового изображения -
1872
    подфункция 1 функции 15. После которой, разумеется, следует
1873
    заново определить само изображение.
1874
 
1875
======================================================================
1876
= Функция 39, подфункция 2 - прочитать точку с фонового изображения. =
1877
======================================================================
1878
Параметры:
1879
  * eax = 39 - номер функции
1880
  * ebx = 2 - номер подфункции
1881
  * ecx = смещение
1882
Возвращаемое значение:
1883
  * eax = 0x00RRGGBB - цвет точки, если смещение допустимо
1884
    (меньше 0x160000-16)
1885
  * eax = 2 - иначе
1886
Замечания:
1887
  * Не следует полагаться на возвращаемое значение в случае неверного
1888
    смещения, оно может измениться в следующих версиях ядра.
1889
  * Смещение точки с координатами (x,y) вычисляется как (x+y*xsize)*3.
1890
  * Есть парная функция установки точки на фоновом изображении -
1891
    подфункция 2 функции 15.
1892
 
1893
======================================================================
1894
====== Функция 39, подфункция 4 - получить режим отрисовки фона. =====
1895
======================================================================
1896
Параметры:
1897
  * eax = 39 - номер функции
1898
  * ebx = 4 - номер подфункции
1899
Возвращаемое значение:
1900
  * eax = 1 - замостить
1901
  * eax = 2 - растянуть
1902
Замечания:
1903
  * Есть парная функция установки режима отрисовки фона -
1904
    подфункция 4 функции 15.
1905
 
1906
======================================================================
1907
======== Функция 40 - установить маску для ожидаемых событий. ========
1908
======================================================================
1909
Маска для ожидаемых событий влияет на функции работы с событиями 10,
131 diamond 1910
11, 23 - они сообщают только о событиях, разрешённых этой маской.
77 diamond 1911
Параметры:
1912
  * eax = 40 - номер функции
1913
  * ebx = маска: бит i соответствует событию i+1 (см. список событий)
1914
    (установленный бит разрешает извещение о событии)
1915
Возвращаемое значение:
1916
  * функция не возвращает значения
1917
Замечания:
1918
  * Маска по умолчанию (7=111b) разрешает извещения о перерисовке
1919
    и нажатиях клавиш и кнопок.
1920
    Этого достаточно для большинства приложений.
131 diamond 1921
  * События, запрещённые в маске, всё равно сохраняются, если
77 diamond 1922
    приходят; о них просто не извещают функции работы с событиями.
1923
  * Функции работы с событиями учитывают маску на момент
1924
    вызова функции, а не на момент поступления сообщения.
1925
 
1926
======================================================================
1927
================= Функция 41 - узнать владельца IRQ. =================
1928
======================================================================
1929
Параметры:
1930
  * eax = 41 - номер функции
1931
  * ebx = номер IRQ, 0..15
1932
Возвращаемое значение:
1933
  * eax = PID владельца
1934
  * eax = 0, если владельца нет
1935
  * eax = -1 для некорректного ebx
1936
 
1937
======================================================================
1938
========== Функция 42 - прочитать данные, полученные по IRQ. =========
1939
======================================================================
1940
При возникновении IRQ система может считывать данные из указанных
1941
ранее функцией 44 портов и записывать эти данные в буфер.
1942
Описываемая функция считывает побайтно данные из этого буфера.
1943
Параметры:
1944
  * eax = 42 - номер функции
1945
  * ebx = номер IRQ, 0..15
1946
Возвращаемое значение: (ситуацию можно различить по значению ecx)
1947
  * если поток не является владельцем IRQ
1948
    (или номер IRQ задан неверно):
1949
    * ecx = 2
1950
  * если данных нет:
1951
    * eax = 0
1952
    * ecx = 1
1953
    * ebx разрушается
131 diamond 1954
  * если всё в порядке и данные были:
1955
    * eax = размер данных, ещё не прочитанных из буфера (в байтах)
77 diamond 1956
    * ecx = 0
1957
    * ebx = очередной байт
1958
Замечания:
1959
  * Предварительно поток должен зарезервировать для себя указанный IRQ
1960
    функцией 45.
1961
  * Размер буфера для данных - 4000 байт, при переполнении
1962
    "свежие" данные перестают записываться в буфер.
1963
 
1964
======================================================================
1965
=================== Функция 43 - ввод/вывод в порт. ==================
1966
======================================================================
1967
 
1968
------------------------ Вывод данных в порт -------------------------
1969
Параметры:
1970
  * eax = 43 - номер функции
1971
  * bl = байт для вывода
1972
  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
1973
Возвращаемое значение:
1974
  * eax = 0 - успешно
1975
  * eax = 1 - поток не зарезервировал указанный порт
1976
 
1977
------------------------ Ввод данных из порта ------------------------
1978
Параметры:
1979
  * eax = 43 - номер функции
1980
  * ebx игнорируется
1981
  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
1982
Возвращаемое значение:
131 diamond 1983
  * eax = 0 - успешно, при этом ebx = введённый байт
77 diamond 1984
  * eax = 1 - поток не зарезервировал данный порт
1985
Замечания:
1986
  * Предварительно поток должен зарезервировать за собой
1987
    указанный порт функцией 46.
1988
  * Для зарезервированных портов вместо вызова этих функций
1989
    лучше использовать команды процессора in/out - это значительно
1990
    быстрее и несколько короче и проще. Из незарезервированных
131 diamond 1991
    портов читать всё равно нельзя.
77 diamond 1992
 
1993
======================================================================
1994
======== Функция 44 - определить действия при поступлении IRQ. =======
1995
======================================================================
1996
При возникновении IRQ система может считывать данные из указанных этой
1997
функцией портов и записывать эти данные в буфер, откуда их можно
1998
прочитать функцией 42.
1999
Параметры:
2000
  * eax = 44 - номер функции
2001
  * ebx = указатель на массив структур, описывающих по одному порту:
2002
    * +0: word: 0 означает конец массива, иначе номер порта
2003
    * +2: byte: зарезервировано (игнорируется)
2004
    * +3: byte: 1=считывать байт из этого порта, 2=считывать слово
2005
  * ecx = номер IRQ, 0..15
2006
Возвращаемое значение:
2007
  * eax = 0 - успешно
2008
  * eax = 1 - поток не является владельцем указанного IRQ
2009
Замечания:
2010
  * Предварительно поток должен зарезервировать за собой
2011
    указываемый IRQ функцией 45.
2012
  * Принимаются во внимание только первые 16 портов.
2013
  * Текущая реализация рассматривает неправильное значение поля +3
2014
    как сигнал прекращения обработки IRQ.
2015
 
2016
======================================================================
2017
============ Функция 45 - зарезервировать/освободить IRQ. ============
2018
======================================================================
2019
Параметры:
2020
  * eax = 45 - номер функции
2021
  * ebx = 0 - зарезервировать, 1 = освободить
2022
  * ecx = номер IRQ, 0..15
2023
Возвращаемое значение:
2024
  * eax = 0 - успешно
2025
  * eax = 1 - ошибка (неверный номер IRQ или
2026
    попытка зарезервировать несвободный IRQ или освободить IRQ, не
2027
    зарезервированный текущим потоком)
2028
Замечания:
2029
  * Резервирование IRQ нужно для работы функций 42 и 44.
2030
  * Только один поток может зарезервировать конкретный IRQ.
2031
  * IRQ, обрабатываемые системой самостоятельно, резервируются
2032
    системой (потоком 1) при загрузке.
2033
  * При завершении потока автоматически освобождаются
2034
    все зарезервированные им IRQ.
2035
 
2036
======================================================================
2037
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
2038
======================================================================
2039
К зарезервированным портам можно обращаться напрямую из приложения
2040
командами in/out (рекомендуемый способ) и вызовом функции 43
2041
(нерекомендуемый способ).
2042
Параметры:
2043
  * eax = 46 - номер функции
2044
  * ebx = 0 - зарезервировать, 1 - освободить
2045
  * ecx = номер начала диапазона портов
2046
  * edx = номер конца диапазона портов (включительно)
2047
Возвращаемое значение:
2048
  * eax = 0 - успешно
2049
  * eax = 1 - ошибка
2050
Замечания:
2051
  * В случае резервирования портов ошибкой считается выполнение
2052
    одного из условий:
2053
    * начальный адрес больше конечного;
2054
    * указанный диапазон содержит некорректный номер порта
2055
      (корректные - от 0 до 0xFFFF);
2056
    * превышено ограничение на общее число зарезервированных областей
2057
      - допускается максимум 255;
2058
    * указанный диапазон пересекается с одним из
2059
      ранее зарезервированных
2060
  * В случае освобождения портов ошибкой считается попытка
2061
    освобождения диапазона, который ранее не был целиком
2062
    зарезервирован этой же функцией (с такими же значениями ecx,edx).
2063
  * При обнаружении ошибки (в обоих случаях) никаких действий
2064
    не производится.
2065
  * При загрузке система резервирует за собой порты 0..0xff, а при
2066
    обнаружении COM-мыши - дополнительно диапазон COM-портов
2067
    0x3f0..0x3ff и/или 0x2f0..0x2ff.
2068
  * При завершении потока автоматически освобождаются все
2069
    зарезервированные им порты.
2070
 
2071
======================================================================
2072
================= Функция 47 - вывести число в окно. =================
2073
======================================================================
2074
Параметры:
2075
  * eax = 47 - номер функции
2076
  * ebx = параметры преобразования числа в текст:
2077
    * bl = 0 - ecx содержит число
2078
    * bl = 1 - ecx содержит указатель на dword-число
2079
    * bh = 0 - отображать в десятичной системе счисления
2080
    * bh = 1 - отображать в шестнадцатеричной системе
2081
    * bh = 2 - отображать в двоичной системе
2082
    * биты 16-21 = сколько цифр отображать
2083
    * биты 22-31 зарезервированы и должны быть установлены в 0
2084
  * ecx = число (при bl=0) или указатель (при bl=1)
2085
  * edx = [координата по оси x]*65536 + [координата по оси y]
2086
  * esi = 0xN0RRGGBB, RRGGBB=цвет, N=шрифт (0/1)
2087
Возвращаемое значение:
2088
  * функция не возвращает значения
2089
Замечания:
2090
  * Указанная длина не должна превосходить 60.
2091
  * Выводится ровно указанное количество цифр. Если число мало и
2092
    может быть записано меньшим количеством цифр, оно дополняется
2093
    ведущими нулями; если число велико и не может быть записано
2094
    таким количеством цифр, "лишние" ведущие цифры обрезаются.
2095
  * Параметры шрифтов указаны в описании функции 4 (вывода текста).
2096
 
2097
======================================================================
2098
======= Функция 48, подфункция 0 - применить настройки экрана. =======
2099
======================================================================
2100
Параметры:
2101
  * eax = 48 - номер функции
2102
  * ebx = 0 - номер подфункции
2103
  * ecx = 0 - зарезервировано
2104
Возвращаемое значение:
2105
  * функция не возвращает значения
2106
Замечания:
2107
  * Функция перерисовывает экран после изменения параметров
2108
    подфункциями 1 и 2.
2109
  * Вызов функции без предшествующих вызовов указанных подфункций
2110
    игнорируется.
2111
  * Вызов функции с ненулевым ecx игнорируется.
2112
 
2113
======================================================================
2114
========= Функция 48, подфункция 1 - установить стиль кнопок. ========
2115
======================================================================
2116
Параметры:
2117
  * eax = 48 - номер функции
2118
  * ebx = 1 - номер подфункции
2119
  * ecx = тип кнопок:
2120
    * 0 = плоские
131 diamond 2121
    * 1 = объёмные
77 diamond 2122
Возвращаемое значение:
2123
  * функция не возвращает значения
2124
Замечания:
2125
  * После вызова описываемой функции следует перерисовать экран
2126
    подфункцией 0.
2127
  * Тип кнопок влияет только на их прорисовку функцией 8.
2128
 
2129
======================================================================
2130
==== Функция 48, подфункция 2 - установить стандартные цвета окон. ===
2131
======================================================================
2132
Параметры:
2133
  * eax = 48 - номер функции
2134
  * ebx = 2 - номер подфункции
2135
  * ecx = указатель на таблицу цветов
2136
  * edx = размер таблицы цветов
2137
    (должен быть 40 байт для будущей совместимости)
2138
Формат таблицы цветов указан в описании подфункции 3.
2139
Возвращаемое значение:
2140
  * функция не возвращает значения
2141
Замечания:
2142
  * После вызова описываемой функции следует перерисовать экран
2143
    подфункцией 0.
2144
  * Таблица стандартных цветов влияет только на приложения,
2145
    которые эту таблицу явным образом получают (подфункцией 3) и
131 diamond 2146
    используют (указывая цвета из неё при вызовах функций рисования).
77 diamond 2147
  * Таблица стандартных цветов входит в скин и устанавливается заново
2148
    при установке скина (подфункции 8).
2149
  * Таблицу цветов можно просматривать/изменять интерактивно с помощью
2150
    приложения desktop.
2151
 
2152
======================================================================
2153
===== Функция 48, подфункция 3 - получить стандартные цвета окон. ====
2154
======================================================================
2155
Параметры:
2156
  * eax = 48 - номер функции
2157
  * ebx = 3 - номер подфункции
2158
  * ecx = указатель на буфер размером edx байт,
2159
    куда будет записана таблица
2160
  * edx = размер таблицы цветов
2161
    (должен быть 40 байт для будущей совместимости)
2162
Возвращаемое значение:
2163
  * функция не возвращает значения
2164
Формат таблицы цветов: каждый элемент -
2165
dword-значение цвета 0x00RRGGBB
2166
  * +0: dword: frames - цвет рамки
2167
  * +4: dword: grab - цвет заголовка
2168
  * +8: dword: grab_button - цвет кнопки на полосе заголовка
2169
  * +12 = +0xC: dword: grab_button_text - цвет текста на кнопке
2170
    на полосе заголовка
2171
  * +16 = +0x10: dword: grab_text - цвет текста на заголовке
2172
  * +20 = +0x14: dword: work - цвет рабочей области
2173
  * +24 = +0x18: dword: work_button - цвет кнопки в рабочей области
2174
  * +28 = +0x1C: dword: work_button_text - цвет текста на кнопке
2175
    в рабочей области
2176
  * +32 = +0x20: dword: work_text - цвет текста в рабочей области
2177
  * +36 = +0x24: dword: work_graph - цвет графики в рабочей области
2178
Замечания:
2179
  * Структура таблицы цветов описана в стандартном включаемом файле
2180
    macros.inc под названием system_colors; например, можно писать:
131 diamond 2181
    	sc	system_colors		; объявление переменной
2182
    	...				; где-то надо вызвать
2183
    					; описываемую функцию с ecx=sc
2184
    	mov	ecx, [sc.work_button_text]	; читаем цвет текста
2185
    					; на кнопке в рабочей области
77 diamond 2186
  * Использование/неиспользование этих цветов - дело исключительно
2187
    самой программы. Для использования нужно просто при вызове функций
2188
    рисования указывать цвет, взятый из этой таблицы.
2189
  * При изменении таблицы стандартных цветов (подфункцией 2 с
2190
    последующим применением изменений подфункцией 0 или
2191
    при установке скина подфункцией 8) всем окнам посылается сообщение
2192
    о необходимости перерисовки (событие с кодом 1).
2193
  * Стандартные цвета можно просматривать/изменять интерактивно
2194
    с помощью приложения desktop.
2195
 
2196
======================================================================
2197
========== Функция 48, подфункция 4 - получить высоту скина. =========
2198
======================================================================
2199
Параметры:
2200
  * eax = 48 - номер функции
2201
  * ebx = 4 - номер подфункции
2202
Возвращаемое значение:
2203
  * eax = высота скина
2204
Замечания:
2205
  * Высотой скина по определению считается высота заголовка окон,
2206
    использующих скин.
2207
  * Смотри также общую структуру окна в описании функции 0.
2208
 
2209
======================================================================
2210
===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
2211
======================================================================
2212
Параметры:
2213
  * eax = 48 - номер функции
2214
  * ebx = 5 - номер подфункции
2215
Возвращаемое значение:
2216
  * eax = [left]*65536 + [right]
2217
  * ebx = [top]*65536 + [bottom]
2218
Замечания:
2219
  * Рабочая область экрана определяет положение и координаты
2220
    максимизированного окна.
2221
  * Рабочая область экрана при нормальной работе есть весь экран
2222
    за вычетом панели (@panel).
2223
  * (left,top) - координаты левого верхнего угла,
2224
    (right,bottom) - координаты правого нижнего.
2225
    Таким образом, размер рабочей области по оси x определяется
2226
    формулой right-left+1, по оси y - формулой bottom-right+1.
2227
  * Смотри также функцию 14,
2228
    позволяющую определить размеры всего экрана.
2229
  * Есть парная функция установки рабочей области - подфункция 6.
2230
 
2231
======================================================================
2232
==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
2233
======================================================================
2234
Параметры:
2235
  * eax = 48 - номер функции
2236
  * ebx = 6 - номер подфункции
2237
  * ecx = [left]*65536 + [right]
2238
  * edx = [top]*65536 + [bottom]
2239
Возвращаемое значение:
2240
  * функция не возвращает значения
2241
Замечания:
2242
  * Рабочая область экрана определяет положение и координаты
2243
    максимизированного окна.
2244
  * Эта функция используется только приложением @panel,
2245
    устанавливающим рабочей областью весь экран за вычетом панели.
2246
  * (left,top) - координаты левого верхнего угла,
2247
    (right,bottom) - координаты правого нижнего.
2248
    Таким образом, размер рабочей области по оси x определяется
2249
    формулой right-left+1, по оси y - формулой bottom-right+1.
2250
  * Если left>=right, то x-координаты рабочей области не изменяются.
2251
    Если left<0, то left не устанавливается. Если right больше
2252
    или равно ширины экрана, то right не устанавливается.
2253
    Аналогично по оси y.
2254
  * Смотри также функцию 14,
2255
    позволяющую определить размеры всего экрана.
2256
  * Есть парная функция получения рабочей области -
2257
    подфункция 5.
2258
  * Эта функция автоматически перерисовывает экран, по ходу дела
118 diamond 2259
    обновляет координаты и размеры максимизированных окон.
77 diamond 2260
    Все окна извещаются о необходимости перерисовки (событие 1).
2261
 
2262
======================================================================
2263
====================== Функция 48, подфункция 7 ======================
2264
============ Получить область скина для текста заголовка. ============
2265
======================================================================
2266
Возвращает область заголовка окна со скином, предназначенную
2267
для вывода текста заголовка.
2268
Параметры:
2269
  * eax = 48 - номер функции
2270
  * ebx = 7 - номер подфункции
2271
Возвращаемое значение:
2272
  * eax = [left]*65536 + [right]
2273
  * ebx = [top]*65536 + [bottom]
2274
Замечания:
2275
  * Использование/неиспользование этой функции -
2276
    личное дело приложения.
2277
  * Рекомендуется учитывать значения, возвращаемые этой функцией,
2278
    при выборе места для рисования текста заголовка (функцией 4) или
2279
    какого-нибудь заменителя текста заголовка
2280
    (по усмотрению приложения).
2281
 
2282
======================================================================
2283
==== Функция 48, подфункция 8 - установить используемый скин окон. ===
2284
======================================================================
2285
Параметры:
2286
  * eax = 48 - номер функции
2287
  * ebx = 8 - номер подфункции
2288
  * ecx = указатель на блок для функции 58, в котором установлено
2289
    поле промежуточного буфера и указано имя файла
2290
Возвращаемое значение:
2291
  * eax = 0 - успешно
131 diamond 2292
  * иначе eax = код ошибки файловой системы; если файл не задаёт скин,
77 diamond 2293
    то возвращается ошибка 3 (неизвестная файловая система).
2294
Замечания:
2295
  * При успешной загрузке скина все окна извещаются о необходимости
2296
    перерисовки (событие 1).
2297
  * При загрузке система считывает скин из файла default.skn
2298
    на рамдиске.
2299
  * Пользователь может изменять скин статически, создав свой
2300
    default.skn, или динамически с помощью приложения desktop.
2301
 
2302
======================================================================
78 diamond 2303
============ Функция 49 - Advanced Power Management (APM). ===========
2304
======================================================================
2305
Параметры:
2306
  * eax = 49 - номер функции
2307
  * dx = номер функции APM (аналог ax в спецификации)
2308
  * bx, cx = параметры функции APM
2309
Возвращаемое значение:
2310
  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
2311
    установлены в соответствии со спецификацией APM
2312
  * старшие половины 32-битных регистров eax, ebx, ecx,
2313
    edx, esi, edi разрушаются
2314
Замечания:
2315
  * Спецификация APM 1.2 описывается в документе
2316
    "Advanced Power Management (APM) BIOS Specification"
2317
    (Revision 1.2), доступном на
2318
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2319
    кроме того, она включена в известный Interrupt List by Ralf Brown
2320
    (http://www.pobox.com/~ralf/files.html,
2321
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2322
 
2323
======================================================================
77 diamond 2324
================= Функция 50 - установка формы окна. =================
2325
======================================================================
2326
Обычные окна представляют собой прямоугольники. С помощью этой функции
131 diamond 2327
окну можно придать произвольную форму. Форма задаётся набором точек
77 diamond 2328
внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
2329
размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
2330
функцией 67.
2331
 
2332
--------------- Установка данных с информацией о форме ---------------
2333
Параметры:
2334
  * eax = 50 - номер функции
2335
  * ebx = 0 - номер подфункции
2336
  * ecx = указатель на данные формы (массив байт 0/1)
2337
Возвращаемое значение:
2338
  * функция не возвращает значения
2339
 
2340
------------------ Установка масштаба данных формы -------------------
2341
Параметры:
2342
  * eax = 50 - номер функции
2343
  * ebx = 1 - номер подфункции
131 diamond 2344
  * ecx задаёт масштаб: каждый байт данных определяет
77 diamond 2345
    (2^scale)*(2^scale) пикселей
2346
Возвращаемое значение:
2347
  * функция не возвращает значения
2348
Замечания:
2349
  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
2350
    данных формы один байт соответствует одному пикселю, то масштаб
2351
    можно не устанавливать.
2352
  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
2353
    обратите внимание, что они на единицу больше, чем устанавливаемые
2354
    функциями 0, 67.
2355
  * По определению масштаба xsize и ysize должны делиться на 2^scale.
2356
  * Байт данных по смещению a должен быть 0/1 и
2357
    определяет принадлежность окну квадрата со стороной 2^scale
2358
    (при scale=0 получаем пиксель) и координатами левого верхнего угла
2359
    (a mod (xsize shr scale), a div (xsize shr scale))
2360
  * Размер данных: (xsize shr scale)*(ysize shr scale).
2361
  * Данные должны присутствовать в памяти и не меняться
2362
    после установки формы.
2363
  * Система просматривает данные о форме при каждой перерисовке окна
2364
    функцией 0.
2365
  * Вызов подфункции 0 с нулевым указателем приводит к возврату
2366
    к прямоугольной форме.
2367
 
2368
======================================================================
2369
===================== Функция 51 - создать поток. ====================
2370
======================================================================
2371
Параметры:
2372
  * eax = 51 - номер функции
2373
  * ebx = 1 - единственная подфункция
2374
  * ecx = адрес точки входа потока (начальный eip)
2375
  * edx = указатель стэка потока (начальный esp)
2376
Возвращаемое значение:
2377
  * eax = -1 - ошибка (в системе слишком много потоков)
2378
  * иначе eax = TID - идентификатор потока
2379
 
2380
======================================================================
2381
= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
2382
======================================================================
2383
Параметры:
2384
  * eax = 52 - номер функции
2385
  * ebx = 0 - номер подфункции
2386
Возвращаемое значение:
2387
  * eax = двойное слово конфигурации
2388
Замечания:
2389
  * Слово конфигурации можно установить подфункцией 2.
2390
  * Ядро не использует соответствующую переменную.
2391
    Ценность этой переменной и работающих с ней подфункций 0 и 2
2392
    представляется сомнительной.
2393
 
2394
======================================================================
2395
======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
2396
======================================================================
2397
Параметры:
2398
  * eax = 52 - номер функции
2399
  * ebx = 1 - номер подфункции
2400
Возвращаемое значение:
2401
  * eax = IP-адрес (4 байта)
2402
Замечания:
2403
  * Локальный IP-адрес устанавливается подфункцией 3.
2404
 
2405
======================================================================
2406
 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
2407
======================================================================
2408
Параметры:
2409
  * eax = 52 - номер функции
2410
  * ebx = 2 - номер подфункции
2411
  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
2412
    число 3, это воспринимается как запрос на [пере-]инициализацию
2413
    Ethernet-карты, в противном случае Ethernet выключается
2414
Возвращаемое значение:
2415
  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
2416
    но это может измениться в будущих версиях ядра
2417
  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
2418
    (отсутствие Ethernet-карты), а ненулевое значение - успех
2419
Замечания:
2420
  * Слово конфигурации можно прочитать подфункцией 0.
2421
  * Ядро не использует соответствующую переменную.
2422
    Ценность этой переменной, подфункции 0 и части подфункции 2,
2423
    устанавливающей эту переменную, представляется сомнительной.
2424
 
2425
======================================================================
2426
====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
2427
======================================================================
2428
Параметры:
2429
  * eax = 52 - номер функции
2430
  * ebx = 3 - номер подфункции
2431
  * ecx = IP-адрес (4 байта)
2432
Возвращаемое значение:
2433
  * текущая реализация возвращает eax=3, но это может быть изменено
2434
    в будущих версиях
2435
Замечания:
2436
  * Локальный IP-адрес можно получить подфункцией 1.
2437
 
2438
======================================================================
2439
= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
2440
======================================================================
2441
Параметры:
2442
  * eax = 52 - номер функции
2443
  * ebx = 6 - номер подфункции
2444
  * edx = размер данных
2445
  * esi = указатель на данные
2446
Возвращаемое значение:
2447
  * eax = -1 - ошибка
2448
  * eax = 0 - успешно
2449
Замечания:
2450
  * Эта функция предназначена только для медленных сетевых драйверов
2451
    (PPP, SLIP).
2452
  * Размер данных не должен превосходить 1500 байт,
2453
    хотя проверок корректности не делается.
2454
 
2455
======================================================================
2456
====================== Функция 52, подфункция 8 ======================
2457
============= Прочитать данные из сетевой очереди вывода. ============
2458
======================================================================
2459
Параметры:
2460
  * eax = 52 - номер функции
2461
  * ebx = 8 - номер подфункции
2462
  * esi = указатель на буфер размером 1500 байт
2463
Возвращаемое значение:
2464
  * eax = число прочитанных байт (в текущей реализации
2465
    либо 0 = нет данных, либо 1500)
2466
  * данные скопированы в буфер
2467
Замечания:
2468
  * Эта функция предназначена только для медленных сетевых драйверов
2469
    (PPP, SLIP).
2470
 
2471
======================================================================
2472
=========== Функция 52, подфункция 9 - получить gateway IP. ==========
2473
======================================================================
2474
Параметры:
2475
  * eax = 52 - номер функции
2476
  * ebx = 9 - номер подфункции
2477
Возвращаемое значение:
2478
  * eax = gateway IP (4 байта)
2479
 
2480
======================================================================
2481
========= Функция 52, подфункция 10 - получить маску подсети. ========
2482
======================================================================
2483
Параметры:
2484
  * eax = 52 - номер функции
2485
  * ebx = 10 - номер подфункции
2486
Возвращаемое значение:
2487
  * eax = маска подсети
2488
 
2489
======================================================================
2490
========= Функция 52, подфункция 11 - установить gateway IP. =========
2491
======================================================================
2492
Параметры:
2493
  * eax = 52 - номер функции
2494
  * ebx = 11 - номер подфункции
2495
  * ecx = gateway IP (4 байта)
2496
Возвращаемое значение:
2497
  * текущая реализация возвращает eax=11, но это может быть изменено
2498
    в будущих реализациях
2499
 
2500
======================================================================
2501
======== Функция 52, подфункция 12 - установить маску подсети. =======
2502
======================================================================
2503
Параметры:
2504
  * eax = 52 - номер функции
2505
  * ebx = 12 - номер подфункции
2506
  * ecx = маска подсети
2507
Возвращаемое значение:
2508
  * текущая реализация возвращает eax=12, но это может быть изменено
2509
    в будущих версиях
2510
 
2511
======================================================================
2512
============ Функция 52, подфункция 13 - получить DNS IP. ============
2513
======================================================================
2514
Параметры:
2515
  * eax = 52 - номер функции
2516
  * ebx = 13 - номер подфункции
2517
Возвращаемое значение:
2518
  * eax = DNS IP (4 байта)
2519
 
2520
======================================================================
2521
=========== Функция 52, подфункция 14 - установить DNS IP. ===========
2522
======================================================================
2523
Параметры:
2524
  * eax = 52 - номер функции
2525
  * ebx = 14 - номер подфункции
2526
  * ecx = DNS IP (4 байта)
2527
Возвращаемое значение:
2528
  * текущая реализация возвращает eax=14, но это может быть изменено
2529
    в следующих версиях
2530
 
2531
======================================================================
2532
============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========
2533
======================================================================
2534
Параметры:
2535
  * eax = 53 - номер функции
2536
  * ebx = 0 - номер подфункции
2537
  * ecx = локальный порт (учитывается только младшее слово)
131 diamond 2538
  * edx = удалённый порт (учитывается только младшее слово)
2539
  * esi = удалённый IP
77 diamond 2540
Возвращаемое значение:
2541
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2542
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2543
    сокет и имеющее смысл только для системы) - успешно;
2544
    ebx разрушается
2545
 
2546
======================================================================
2547
============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========
2548
======================================================================
2549
Параметры:
2550
  * eax = 53 - номер функции
2551
  * ebx = 1 - номер подфункции
2552
  * ecx = хэндл сокета
2553
Возвращаемое значение:
2554
  * eax = -1 - неверный хэндл
2555
  * eax = 0 - успешно
2556
  * ebx разрушается
2557
Замечания:
2558
  * Текущая реализация не закрывает автоматически все сокеты потока
2559
    при его завершении. В частности, не следует прибивать поток
2560
    с кучей открытых сокетов - будет утечка ресурсов.
2561
  * Текущая реализация не делает проверок на корректность
2562
    (единственное, на что возвращается ошибка, - попытка закрыть
2563
    неоткрытый сокет с корректным хэндлом).
2564
 
2565
======================================================================
2566
============== Функция 53, подфункция 2 - опрос сокета. ==============
2567
======================================================================
2568
Параметры:
2569
  * eax = 53 - номер функции
2570
  * ebx = 2 - номер подфункции
2571
  * ecx = хэндл сокета
2572
Возвращаемое значение:
2573
  * eax = число полученных байт
2574
  * ebx разрушается
2575
Замечания:
2576
  * Проверки корректности не делается.
2577
 
2578
======================================================================
2579
======== Функция 53, подфункция 3 - прочитать байт из сокета. ========
2580
======================================================================
2581
Параметры:
2582
  * eax = 53 - номер функции
2583
  * ebx = 3 - номер подфункции
2584
  * ecx = хэндл сокета
2585
Возвращаемое значение:
2586
  * если нет принятых данных: eax=0, bl=0,
118 diamond 2587
    прочие байты ebx разрушаются
77 diamond 2588
  * если были принятые данные: eax=число оставшихся байт
118 diamond 2589
    (возможно, 0), bl=прочитанный байт, прочие байты ebx разрушаются
77 diamond 2590
Замечания:
2591
  * Проверки корректности не производится.
2592
 
2593
======================================================================
2594
========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========
2595
======================================================================
2596
Параметры:
2597
  * eax = 53 - номер функции
2598
  * ebx = 4 - номер подфункции
2599
  * ecx = хэндл сокета
2600
  * edx = число байт для записи
2601
  * esi = указатель на данные для записи
2602
Возвращаемое значение:
2603
  * eax = 0xffffffff - неверный хэндл
2604
  * eax = 0xffff - недостаточно памяти
2605
  * eax = 0 - успешно
2606
  * ebx разрушается
2607
Замечания:
114 mikedld 2608
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2609
    не очень неправильные неоткрытые хэндлы.
2610
  * Число байт для записи не может превышать 1500-28, хотя
2611
    соответствующей проверки не делается.
2612
 
2613
======================================================================
2614
============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========
2615
======================================================================
2616
Параметры:
2617
  * eax = 53 - номер функции
2618
  * ebx = 5 - номер подфункции
2619
  * ecx = локальный порт (учитывается только младшее слово)
131 diamond 2620
  * edx = удалённый порт (учитывается только младшее слово)
2621
  * esi = удалённый IP
77 diamond 2622
  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1
2623
Возвращаемое значение:
2624
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2625
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2626
    сокет и имеющее смысл только для системы) - успешно;
2627
    ebx разрушается
2628
 
2629
======================================================================
2630
====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
2631
======================================================================
2632
Параметры:
2633
  * eax = 53 - номер функции
2634
  * ebx = 6 - номер подфункции
2635
  * ecx = хэндл сокета
2636
Возвращаемое значение:
2637
  * eax = статус сокета: одно из
2638
  * TCB_LISTEN = 1
2639
  * TCB_SYN_SENT = 2
2640
  * TCB_SYN_RECEIVED = 3
2641
  * TCB_ESTABLISHED = 4
2642
  * TCB_FIN_WAIT_1 = 5
2643
  * TCB_FIN_WAIT_2 = 6
2644
  * TCB_CLOSE_WAIT = 7
2645
  * TCB_CLOSING = 8
2646
  * TCB_LAST_ASK = 9
2647
  * TCB_TIME_WAIT = 10
2648
  * TCB_CLOSED = 11
2649
  * ebx разрушается
2650
Замечания:
2651
  * Проверок корректности не производится.
2652
 
2653
======================================================================
2654
========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
2655
======================================================================
2656
Параметры:
2657
  * eax = 53 - номер функции
2658
  * ebx = 7 - номер подфункции
2659
  * ecx = хэндл сокета
2660
  * edx = число байт для записи
2661
  * esi = указатель на данные для записи
2662
Возвращаемое значение:
2663
  * eax = 0xffffffff - ошибка
2664
  * eax = 0xffff - недостаточно памяти
2665
  * eax = 0 - успешно
2666
  * ebx разрушается
2667
Замечания:
114 mikedld 2668
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2669
    не очень неправильные неоткрытые хэндлы.
2670
  * Число байт для записи не может превышать 1500-40,
2671
    хотя соответствующей проверки не делается.
2672
 
2673
======================================================================
2674
============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========
2675
======================================================================
2676
Параметры:
2677
  * eax = 53 - номер функции
2678
  * ebx = 8 - номер подфункции
2679
  * ecx = хэндл сокета
2680
Возвращаемое значение:
2681
  * eax = -1 - неверный хэндл
2682
  * eax = 0xffff - недостаточно памяти для пакета закрытия сокета
2683
  * eax = 0 - успешно
2684
  * во многих случаях eax разрушается (возвращается результат функции
2685
    queue) - видимо, это баг, который будет исправлен
2686
  * ebx разрушается
2687
Замечания:
2688
  * Текущая реализация не закрывает автоматически все сокеты потока
2689
    при его завершении. В частности, не следует прибивать поток
2690
    с кучей открытых сокетов - будет утечка ресурсов.
2691
  * Текущая реализация не делает проверок на корректность
2692
    (единственное, на что возвращается ошибка, - попытка закрыть
2693
    неоткрытый сокет с корректным хэндлом).
2694
 
2695
======================================================================
2696
== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =
2697
======================================================================
2698
Параметры:
2699
  * eax = 53 - номер функции
2700
  * ebx = 9 - номер подфункции
2701
  * ecx = номер локального порта (используются только младшие 16 бит)
2702
Возвращаемое значение:
2703
  * eax = 0 - порт используется
2704
  * eax = 1 - порт свободен
2705
  * ebx разрушается
2706
 
2707
======================================================================
2708
 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.
2709
======================================================================
2710
Параметры:
2711
  * eax = 53 - номер функции
2712
  * ebx = 255 - номер подфункции
2713
  * ecx = тип запрашиваемой информации (смотри ниже)
2714
Возвращаемое значение:
2715
  * eax = запрошенная информация
2716
  * ebx разрушается
2717
Возможные значения ecx:
2718
  * 100: длина очереди 0 (empty queue)
2719
  * 101: длина очереди 1 (ip-out queue)
2720
  * 102: длина очереди 2 (ip-in queue)
2721
  * 103: длина очереди 3 (net1out queue)
2722
  * 200: число элементов в таблице ARP
2723
  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)
2724
  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда
2725
    берут информацию 5 последующих типов;
131 diamond 2726
    в этом случае eax неопределён
77 diamond 2727
  * 203: IP-адрес, запомненный типом 202
2728
  * 204: старшее dword MAC-адреса, запомненного типом 202
2729
  * 205: младшее word MAC-адреса, запомненного типом 202
2730
  * 206: слово статуса, запомненное типом 202
2731
  * 207: слово ttl, запомненное типом 202
2732
  * 2: общее число полученных IP-пакетов
2733
  * 3: общее число переданных IP-пакетов
2734
  * 4: общее число сдампленных полученных пакетов
2735
  * 5: общее число полученных ARP-пакетов
2736
  * 6: статус драйвера пакетов, 0=неактивен,
2737
    ненулевое значение=активен
2738
 
2739
======================================================================
2740
======== Функция 55, подфункция 0 - загрузить данные для SB16. =======
2741
======================================================================
2742
Параметры:
2743
  * eax = 55 - номер функции
2744
  * ebx = 0 - номер подфункции
2745
  * ecx = указатель на данные (копируется 64 килобайта, используется
2746
    столько, сколько установлено подфункцией 2)
2747
Возвращаемое значение:
2748
  * функция не возвращает значения
2749
Замечания:
2750
  * Формат и размер данных устанавливаются подфункцией 2.
2751
 
2752
======================================================================
2753
==== Функция 55, подфункция 1 - начать проигрывать данные на SB16. ===
2754
======================================================================
2755
Параметры:
2756
  * eax = 55 - номер функции
2757
  * ebx = 1 - номер подфункции
2758
Возвращаемое значение:
2759
  * функция не возвращает значения
2760
Замечания:
2761
  * Предварительно данные должны быть загружены подфункцией 0 и
131 diamond 2762
    определён их формат подфункцией 2.
77 diamond 2763
  * Функция возвращает управление, когда началось проигрывание данных;
131 diamond 2764
    после этого проигрывание идёт независимо от приложения (и вообще
77 diamond 2765
    не требует загрузки процессора).
2766
  * Предварительно должны быть определены базовый порт SB16
2767
    (подфункцией 4 функции 21) и канал DMA
2768
    (подфункцией 10 функции 21).
2769
 
2770
======================================================================
2771
====== Функция 55, подфункция 2 - установить формат данных SB16. =====
2772
======================================================================
2773
Параметры:
2774
  * eax = 55 - номер функции
2775
  * ebx = 2 - номер подфункции
2776
  * ecx = 0 - установить разрядность
2777
    * edx = 1 - 8бит моно
2778
    * edx = 2 - 8бит стерео
2779
  * ecx = 1 - установить размер данных
2780
    * edx = размер в байтах
2781
  * ecx = 2 - установить частоту проигрывания
2782
    * edx = частота
2783
Возвращаемое значение:
2784
  * функция не возвращает значения
2785
Замечания:
2786
  * При загрузке системы устанавливаются следующие параметры
2787
    по умолчанию: разрядность - 8 бит моно, размер - 64 Кб,
2788
    частота 44100 Гц. Тем не менее рекомендуется явно устанавливать
2789
    необходимые значения, поскольку они могли быть переустановлены
2790
    какой-нибудь программой.
2791
 
2792
======================================================================
2793
====================== Функция 55, подфункция 55 =====================
2794
========== Начать проигрывать данные на встроенном спикере. ==========
2795
======================================================================
2796
Параметры:
2797
  * eax = 55 - номер функции
2798
  * ebx = 55 - номер подфункции
2799
  * esi = указатель на данные
2800
Возвращаемое значение:
2801
  * eax = 0 - успешно
131 diamond 2802
  * eax = 55 - ошибка (спикер отключён или занят)
77 diamond 2803
Данные - это массив элементов переменной длины.
2804
Формат каждого элемента определяется первым байтом:
2805
  * 0 = конец данных
131 diamond 2806
  * 1..0x80 = задаёт длительность звучания в сотых долях секунды
77 diamond 2807
    ноты, определяемой непосредственным значением частоты
2808
    * следующее слово (2 байта) содержит делитель частоты;
2809
      частота определяется как 1193180/divider
2810
  * 0x81 = invalid
2811
  * 0x82..0xFF = нота, определяемая октавой и номером:
2812
    * длительность в сотых долях секунды = (первый байт)-0x81
131 diamond 2813
    * присутствует ещё один байт;
77 diamond 2814
    * (второй байт)=0xFF - пауза
2815
    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
2816
      до 12, a=номер октавы (считая с 0)
2817
Замечания:
2818
  * Пищание спикером может быть запрещено/разрешено подфункцией 8
2819
    функции 18.
2820
  * Функция возвращает управление, сообщив куда следует информацию
131 diamond 2821
    о запросе. Само проигрывание идёт независимо от программы.
77 diamond 2822
  * Данные должны сохраняться в памяти по крайней мере
2823
    до конца проигрывания.
2824
 
2825
======================================================================
131 diamond 2826
============= Функция 56 - записать файл на жёсткий диск. ============
77 diamond 2827
======================================================================
2828
Параметры:
2829
  * eax = 56 - номер функции
2830
  * ebx = указатель на имя файла
2831
  * ecx = размер данных для записи (в байтах)
2832
  * edx = указатель на данные для записи
2833
  * esi = указатель на путь (ASCIIZ-строку)
2834
Возвращаемое значение:
2835
  * eax = 0 - успешно, иначе код ошибки файловой системы
2836
Замечания:
83 diamond 2837
  * Эта функция устарела; функция 70 позволяет выполнять
77 diamond 2838
    те же действия с расширенными возможностями.
131 diamond 2839
  * Данная функция предполагает, что во время её вызова одним
77 diamond 2840
    приложением никакое другое приложение не работает
131 diamond 2841
    с жёстким диском.
77 diamond 2842
  * Путь к файлу - ASCIIZ-строка, которая может быть пустой
131 diamond 2843
    (если файл создаётся в корневом каталоге) или иметь формат
77 diamond 2844
    /d1/d2/.../dn, где все имена папок должны иметь формат 8+3, т.е.
2845
    8 символов имени и 3 символа расширения без разделителя,
2846
    при необходимости дополненные пробелами;
2847
    все буквы должны быть заглавные.
2848
  * Имя к файлу также должно иметь формат 8+3.
2849
 
2850
======================================================================
2851
============== Функция 58 - работа с файловой системой. ==============
2852
======================================================================
2853
Параметры:
2854
  * eax = 58
2855
  * ebx = указатель на информационную структуру
2856
Возвращаемое значение:
2857
  * eax = 0 - успешно; иначе код ошибки файловой системы
2858
  * в зависимости от подфункции может возвращаться значение и
2859
    в других регистрах
2860
Общий формат информационной структуры:
2861
  * +0: dword: номер подфункции
2862
  * +4: dword: номер блока
2863
  * +8: dword: размер
2864
  * +12 = +0xC: dword: указатель на данные
2865
  * +16 = +0x10: dword: указатель на память для работы системы
2866
    (4096 байт)
2867
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
2868
Уточнения - в документации на соответствующую подфункцию.
2869
Имя файла нечувствительно к регистру латинских букв,
2870
русские буквы должны быть заглавными.
2871
Формат имени файла:
2872
/base/number/dir1/dir2/.../dirn/file,
2873
где /base/number идентифицирует устройство, на котором ищется файл:
2874
одно из
2875
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
2876
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
2877
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
131 diamond 2878
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к жёсткому диску
77 diamond 2879
    (в этом случае база определяется подфункцией 7 функции 21),
2880
    x - номер раздела (считая с 1)
2881
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
2882
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
2883
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2884
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
2885
    (на каждом из винчестеров нумерация начинается с 1)
2886
Замечания:
2887
  * В первых двух случаях допускается использование FIRST вместо 1,
2888
    SECOND вместо 2, но использовать эту возможность
2889
    не рекомендуется для удобства перехода на будущие расширения.
2890
  * Накладывается ограничение n<=39.
2891
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
2892
    имя не более 8 символов, точка, расширение не более 3 символов.
2893
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
2894
    Если имя занимает ровно 8 символов, точку можно опустить
2895
    (хотя пользоваться этим не рекомендуется для удобства перехода
2896
    на будущие расширения).
118 diamond 2897
  * Функция не поддерживает папок на рамдиске.
77 diamond 2898
Примеры:
2899
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2900
    '/rd/1/kernel.asm',0
2901
  * '/HD0/1/kernel.asm',0
2902
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2903
Доступные подфункции:
2904
  * подфункция 0 - чтение файла/папки
2905
  * подфункция 1 - перезапись файла
2906
  * подфункция 2 - удаление файла/папки
2907
  * подфункция 4 - создание папки
2908
  * подфункция 5 - переименование/перемещение файла/папки
2909
  * подфункция 8 - LBA-чтение с устройства
2910
  * подфункция 15 - получение информации о файловой системе
2911
  * подфункция 16 - запуск приложения
2912
 
2913
======================================================================
2914
========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
2915
======================================================================
2916
Параметры:
2917
  * eax = 58
2918
  * ebx = указатель на информационную структуру
2919
Формат информационной структуры:
2920
  * +0: dword: 0 = номер подфункции
2921
  * +4: dword: номер блока для чтения (считая с 0)
2922
  * +8: dword: число блоков для чтения
2923
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2924
  * +16 = +0x10: dword: указатель на буфер для работы системы
2925
    (4096 байт)
131 diamond 2926
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 2927
    общем описании
2928
Возвращаемое значение:
2929
  * eax = 0 - успешно, иначе код ошибки файловой системы
2930
  * ebx = размер файла (в байтах) или
2931
    -1=0xffffffff, если файл не найден
2932
Замечания:
2933
  * Размер блока - 512 байт.
2934
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
2935
    функции 70, для чтения папок - подфункцию 1 функции 70.
2936
  * Функция позволяет читать содержимое папки. Из файловых систем
2937
    поддерживается только FAT. Формат FAT-папки описан в любой
2938
    документации по FAT.
2939
  * Размер папки определяется по размеру цепочки кластеров в FAT.
2940
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 2941
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 2942
    eax=6 (EOF).
2943
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
2944
    в первых двух случаях текущая реализация не следует
2945
    установленным правилам:
2946
    для /rd/1:
2947
    * если указано 0 блоков для чтения, считается,
2948
      что запрашивается 1;
2949
    * если запрашивается больше 14 блоков или начальный блок
2950
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
2951
    * размер корневого каталога рамдиска = 14 блоков,
2952
      0x1C00=7168 байт; но возвращается ebx=0
2953
      (за исключением случая предыдущего пункта);
2954
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
131 diamond 2955
      мусор - напоминаю, счёт ведётся с 0);
77 diamond 2956
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
2957
      то возвращается eax=6(EOF); иначе eax=0.
2958
    Для /fd/x:
2959
    * если начальный блок не меньше 14-го, то возвращается
2960
      eax=5 (not found) и ebx=0;
2961
    * кстати говоря, формат FAT12 допускает дискеты с размером
2962
      корневого каталога меньше или больше 14 блоков;
2963
    * проверки длины не делается;
2964
    * если удалось прочитать данные с дискеты, возвращается
2965
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
2966
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
2967
    но результат не соответствует ожидаемому
2968
    (по работе с обычными файлами/папками), не следует установленным
2969
    правилам, может измениться в следующих версиях ядра и потому
2970
    не описывается. Для получения информации об оборудовании
2971
    используйте подфункцию 11 функции 18 или
2972
    читайте соответствующие папки подфункцией 1 функции 70.
2973
 
2974
======================================================================
2975
============ Функция 58, подфункция 1 - перезаписать файл. ===========
2976
======================================================================
131 diamond 2977
Если файл не существует, он создаётся.
77 diamond 2978
Если файл существует, он перезаписывается.
2979
Параметры:
2980
  * eax = 58 - номер функции
2981
  * ebx = указатель на информационную структуру
2982
Формат информационной структуры:
2983
  * +0: dword: 1 = номер подфункции
2984
  * +4: dword: игнорируется (устанавливайте в 0)
2985
  * +8: dword: число байт для записи
2986
  * +12 = +0xC: dword: указатель на данные для записи
2987
  * +16 = +0x10: dword: указатель на буфер для работы системы
2988
    (4096 байт)
131 diamond 2989
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 2990
    общем описании
2991
Возвращаемое значение:
2992
  * eax = 0 - успешно, иначе код ошибки файловой системы
2993
  * ebx разрушается
83 diamond 2994
Замечания:
2995
  * Эта функция устарела, используйте подфункцию 2 функции 70.
77 diamond 2996
 
2997
======================================================================
2998
=========== Функция 58, подфункция 2 - удалить файл/папку. ===========
2999
======================================================================
3000
Параметры:
3001
  * eax = 58 - номер функции
3002
  * ebx = указатель на информационную структуру
3003
Формат информационной структуры:
3004
  * +0: dword: 2 = номер подфункции
3005
  * +4: dword: игнорируется
3006
  * +8: dword: игнорируется
3007
  * +12 = +0xC: dword: игнорируется
3008
  * +16 = +0x10: dword: указатель на буфер для работы системы
3009
    (4096 байт)
131 diamond 3010
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 3011
    общем описании
3012
Возвращаемое значение:
3013
  * eax = 0 - успешно, иначе код ошибки файловой системы
3014
  * ebx разрушается
3015
Замечания:
3016
  * При работе с дискетой не следует удалять непустую папку.
131 diamond 3017
    Код работы с жёстким диском непустые папки удаляет корректно
77 diamond 3018
    (т.е. рекурсивно со всеми файлами и вложенными папками).
3019
    Рамдиск папок не поддерживает.
3020
 
3021
======================================================================
3022
============== Функция 58, подфункция 4 - создать папку. =============
3023
======================================================================
3024
Параметры:
3025
  * eax = 58 - номер функции
3026
  * ebx = указатель на информационную структуру
3027
Формат информационной структуры:
3028
  * +0: dword: 4 = номер подфункции
3029
  * +4: dword: игнорируется
3030
  * +8: dword: игнорируется
3031
  * +12 = +0xC: dword: игнорируется
3032
  * +16 = +0x10: dword: указатель на буфер для работы системы
3033
    (4096 байт)
131 diamond 3034
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 3035
    общем описании
3036
Возвращаемое значение:
3037
  * eax = 0 - успешно, иначе код ошибки файловой системы
3038
  * ebx разрушается
3039
Замечания:
3040
  * Рамдиск и дискеты не поддерживают эту функцию,
131 diamond 3041
    она только для жёстких дисков.
77 diamond 3042
 
3043
======================================================================
3044
== Функция 58, подфункция 5 - переименовать/переместить файл/папку. ==
3045
======================================================================
3046
Параметры:
3047
  * eax = 58 - номер функции
3048
  * ebx = указатель на информационную структуру
3049
Формат информационной структуры:
3050
  * +0: dword: 5 = номер подфункции
3051
  * +4: dword: игнорируется
3052
  * +8: dword: игнорируется
3053
  * +12 = +0xC: dword: игнорируется
3054
  * +16 = +0x10: dword: указатель на буфер для работы системы
3055
    (4096 байт)
131 diamond 3056
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 3057
    общем описании
3058
  * +20+n: (сразу после завершающего нулевого символа) новое
3059
    ASCIIZ-имя, должно начинаться с /hd/1, что интерпретируется как
131 diamond 3060
    жёсткий диск, указанный в первом имени
77 diamond 3061
    (перемещение с одного диска на другой не поддерживается)
3062
Возвращаемое значение:
3063
  * eax = 0 - успешно, иначе код ошибки файловой системы
3064
  * ebx разрушается
3065
Замечания:
3066
  * Рамдиск и дискеты не поддерживают эту функцию,
131 diamond 3067
    она только для жёстких дисков.
77 diamond 3068
  * Если новое ASCIIZ-имя сильно неправильное, т.е. не начинается с
3069
    /hd/1, /hd/first, /harddisk/1, /harddisk/first или после этого
131 diamond 3070
    начала идёт пробел или символ с кодом 0, то функция возвращает,
77 diamond 3071
    как ни странно, код ошибки 4. Это единственная функция, которая
3072
    вообще возвращает этот код.
3073
 
3074
======================================================================
3075
========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
3076
======================================================================
3077
Параметры:
3078
  * eax = 58 - номер функции
3079
  * ebx = указатель на информационную структуру
3080
Формат информационной структуры:
3081
  * +0: dword: 8 = номер подфункции
3082
  * +4: dword: номер блока для чтения (считая с 0)
3083
  * +8: dword: игнорируется (устанавливайте в 1)
3084
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
3085
    (512 байт)
3086
  * +16 = +0x10: dword: указатель на буфер для работы системы
3087
    (4096 байт)
3088
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
3089
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
3090
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
3091
    Вместо цифр допускается, хотя и не рекомендуется для удобства
3092
    перехода на будущие расширения,
3093
    использование 'first','second','third','fourth'.
3094
Возвращаемое значение:
3095
  * если указано имя устройства /hd/xxx, где xxx не находится
3096
    в списке выше:
3097
    * eax = ebx = 1
3098
  * если указано неправильное имя устройства
3099
    (за исключением предыдущего случая):
3100
    * eax = 5
3101
    * ebx не меняется
131 diamond 3102
  * если LBA-доступ запрещён подфункцией 11 функции 21:
77 diamond 3103
    * eax = 2
3104
    * ebx разрушается
3105
  * для рамдиска: попытка чтения блока за пределами рамдиска
3106
    (18*2*80 блоков) приводит к
3107
    * eax = 3
3108
    * ebx = 0
3109
  * при успешном чтении:
3110
    * eax = ebx = 0
3111
Замечания:
3112
  * Размер блока - 512 байт; читается один блок.
3113
  * Не следует полагаться на возвращаемое значение,
3114
    оно может измениться в следующих версиях.
131 diamond 3115
  * Требуется, чтобы был разрешён LBA-доступ к устройствам
77 diamond 3116
    подфункцией 11 функции 21. Узнать это можно вызовом
3117
    подфункцией 11 функции 26.
3118
  * LBA-чтение дискеты не поддерживается.
131 diamond 3119
  * Функция считывает данные физического жёсткого диска;
77 diamond 3120
    если по каким-то причинам нужны данные конкретного раздела,
131 diamond 3121
    придётся определять начальный сектор этого раздела
77 diamond 3122
    (либо напрямую через MBR, либо из расширенной структуры,
3123
    возвращаемой той же подфункцией 11 функции 18).
131 diamond 3124
  * Функция не проверяет код ошибки жёсткого диска, так что запрос
3125
    несуществующего сектора всё равно что-то прочитает
77 diamond 3126
    (вероятнее всего, нули, но это определяется устройством) и
3127
    это будет считаться успехом (eax=0).
3128
 
3129
======================================================================
3130
= Функция 58, подфункция 15 - получить информацию о файловой системе.
3131
======================================================================
3132
Параметры:
3133
  * eax = 58 - номер функции
3134
  * ebx = указатель на информационную структуру
3135
Формат информационной структуры:
118 diamond 3136
  * +0: dword: 15 = номер подфункции
77 diamond 3137
  * +4: dword: игнорируется
3138
  * +8: dword: игнорируется
3139
  * +12 = +0xC: dword: игнорируется
3140
  * +16 = +0x10: dword: игнорируется
3141
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
3142
    /rd=/RAMDISK или /hd=/HARDDISK
3143
Возвращаемое значение:
3144
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
3145
    * eax = 3
3146
    * ebx = ecx = dword [fileinfo] = 0
3147
  * для рамдиска:
3148
    * eax = 0 (успех)
3149
    * ebx = общее число кластеров = 2847
3150
    * ecx = число свободных кластеров
3151
    * dword [fileinfo] = размер кластера = 512
131 diamond 3152
  * для жёсткого диска: база и раздел определяются подфункциями 7 и 8
77 diamond 3153
    функции 21:
3154
    * eax = 0 (успех)
3155
    * ebx = общее число кластеров
3156
    * ecx = число свободных кластеров
3157
    * dword [fileinfo] = размер кластера (в байтах)
3158
Замечания:
3159
  * Не удивляйтесь странному расположению 4-го возвращаемого
3160
    параметра - когда писался этот код, при системных вызовах
3161
    приложению возвращались только регистры eax,ebx,ecx (из
3162
    pushad-структуры, передающейся как аргумент системной функции).
3163
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
3164
    размер кластера в edx, пока эту функцию не начали использовать.
131 diamond 3165
  * Вообще-то ещё существует подфункция 11 функции 18, возвращающая
77 diamond 3166
    информацию о файловой системе. По расширенной таблице дисковой
3167
    подсистемы можно определить размер кластера (там он хранится
131 diamond 3168
    в секторах) и общее число кластеров для жёстких дисков.
77 diamond 3169
 
3170
======================================================================
3171
========== Функция 58, подфункция 16 - запустить программу. ==========
3172
======================================================================
3173
Параметры:
3174
  * eax = 58 - номер функции
3175
  * ebx = указатель на информационную структуру
3176
Формат информационной структуры:
3177
  * +0: dword: 16 = номер подфункции
3178
  * +4: dword: поле флагов:
3179
    * бит 0: запустить процесс как отлаживаемый
3180
    * остальные биты зарезервированы и должны быть установлены в 0
3181
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
3182
  * +12 = +0xC: dword: игнорируется
3183
  * +16 = +0x10: dword: указатель на буфер для работы системы
3184
    (4096 байт)
131 diamond 3185
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 3186
    общем описании
3187
Возвращаемое значение:
3188
  * eax > 0 - программа загружена, eax содержит PID
3189
  * eax < 0 - произошла ошибка, -eax содержит
3190
    код ошибки файловой системы
3191
Замечания:
91 diamond 3192
  * Эта функция устарела, используйте подфункцию 7 функции 70.
118 diamond 3193
  * Комадная строка должна заканчиваться символом с кодом 0
77 diamond 3194
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
3195
    включительно, либо первые 256 символов, в зависимости от того,
3196
    что меньше.
131 diamond 3197
  * Если процесс запускается как отлаживаемый, он создаётся
77 diamond 3198
    в замороженном состоянии; для запуска используйте
3199
    подфункцию 5 функции 69.
3200
 
3201
======================================================================
92 diamond 3202
=== Функция 59 - получить информацию о последних системных вызовах. ==
3203
======================================================================
3204
Получает данные о всех системных вызовах всех процессов.
3205
Параметры:
3206
  * eax = 59 - номер функции
3207
  * ebx = 0 - единственная подфункция
3208
  * ecx = указатель на буфер
3209
  * edx = размер буфера
3210
Возвращаемое значение:
3211
  * eax = общее число системных вызовов,
3212
    сделанных с момента загрузки системы (по модулю 2^32)
3213
  * ebx = 0
3214
Формат информации об одном вызове: (размер = 0x40 = 64 байта)
3215
  * +0: dword: PID процесса/потока
3216
  * +4: 7*dword: мусор
3217
  * +32 = +0x20: dword: значение edi при вызове
3218
  * +36 = +0x24: dword: esi
3219
  * +40 = +0x28: dword: ebp
3220
  * +44 = +0x2C: dword: указатель стэка обработчика ядра
3221
  * +48 = +0x30: dword: ebx
3222
  * +52 = +0x34: dword: edx
3223
  * +56 = +0x38: dword: ecx
3224
  * +60 = +0x3C: dword: eax (=номер системной функции)
3225
Замечания:
3226
  * Функция используется только в приложении systrace.
3227
    Довольно трудно представить ситуацию, в которой это приложение
3228
    или эта функция действительно полезны, а вот все системные вызовы
3229
    для поддержки этой функции несколько замедляются
3230
    (хотя и ненамного)...
3231
  * В связи с этим есть предложение поддержку этой функции
3232
    из ядра убрать совсем, вместе с приложением systrace.
3233
  * Информация о системных вызовах сохраняется в
3234
    системном кольцевом буфере на 0x10 входов.
131 diamond 3235
    Эта функция просто копирует указанный объём данных
92 diamond 3236
    из упомянутого буфера по указанному адресу.
3237
  * Какой из входов в буфере соответствует последнему вызову,
3238
    можно определить по значению eax, а именно,
3239
    вход (eax and 0xF) (по смещению (eax and 0xF)*0x40).
3240
  * В текущей реализации возможны редко встречающиеся
3241
    проблемы рассинхронизации, когда о некоторых вызовах
3242
    информация устаревает.
3243
  * Под системный буфер выделена страница, 4Кб.
3244
    Размер входа = 64 байта.
3245
    Почему используется только 16 входов - непонятно.
3246
  * Значение esp в момент системного вызова
3247
    этой функцией узнать нельзя.
3248
  * Проверки корректности edx в текущей реализации не делается.
3249
 
3250
======================================================================
77 diamond 3251
=========== Функция 60 - Inter Process Communication (IPC). ==========
3252
======================================================================
3253
IPC применяется для посылок сообщений от одного процесса/потока
3254
другому. При этом следует предварительно договориться о том, как
3255
интерпретировать конкретное сообщение.
3256
 
3257
-------- Подфункция 1 - установить область для получения IPC ---------
131 diamond 3258
Вызывается процессом-приёмником.
77 diamond 3259
Параметры:
3260
  * eax = 60 - номер функции
3261
  * ebx = 1 - номер подфункции
3262
  * ecx = указатель на буфер
3263
  * edx = размер буфера
3264
Возвращаемое значение:
3265
  * eax = 0 - всегда успешно
3266
Формат IPC-буфера:
3267
  * +0: dword: если здесь не 0, то буфер считается заблокированным;
3268
    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
3269
    и вам надо, чтобы извне не изменялись данные буфера
3270
    (не поступали новые сообщения)
3271
  * +4: dword: занято места в буфере (в байтах)
3272
  * +8: первое сообщение
3273
  * +8+n: второе сообщение
3274
  * ...
3275
Формат сообщения:
3276
  * +0: dword: PID процесса/потока, пославшего сообщение
3277
  * +4: dword: длина сообщения (не считая этот заголовок)
3278
  * +8: n*byte: данные сообщения
3279
 
3280
--------------- Подфункция 2 - послать сообщение IPC. ----------------
3281
Вызывается процессом-инициатором.
3282
Параметры:
3283
  * eax = 60 - номер функции
3284
  * ebx = 2 - номер подфункции
131 diamond 3285
  * ecx = PID приёмника
77 diamond 3286
  * edx = указатель на данные сообщения
3287
  * esi = длина сообщения (в байтах)
3288
Возвращаемое значение:
3289
  * eax = 0 - успешно
131 diamond 3290
  * eax = 1 - приёмник не определил буфер для IPC-сообщений
3291
    (может быть, ещё не успел, а может быть, это не тот поток,
77 diamond 3292
    который нужен)
131 diamond 3293
  * eax = 2 - приёмник заблокировал IPC-буфер;
77 diamond 3294
    попробуйте немного подождать
131 diamond 3295
  * eax = 3 - переполнение IPC-буфера приёмника
77 diamond 3296
  * eax = 4 - процесса/потока с таким PID не существует
3297
Замечания:
3298
  * Система сразу после записи IPC-сообщения в буфер посылает
131 diamond 3299
    потоку-приёмнику событие с кодом 7 (см. коды событий).
77 diamond 3300
 
3301
======================================================================
3302
=== Функция 61 - получить параметры для прямого доступа к графике. ===
3303
======================================================================
3304
Программе доступны данные графического экрана (область памяти, которая
3305
собственно и отображает содержимое экрана) напрямую без вызовов
3306
системных функций через селектор gs:
131 diamond 3307
	mov	eax, [gs:0]
77 diamond 3308
поместит в eax первый dword буфера, содержащий информацию о цвете
3309
левой верхней точки (и, возможно, цвета нескольких следующих).
131 diamond 3310
	mov	[gs:0], eax
77 diamond 3311
при работе в режимах VESA c LFB
3312
установит цвет левой верхней точки
3313
(и возможно, цвета нескольких следующих).
3314
Для интерпретации данных графического экрана требуется знание
3315
некоторых параметров, которые возвращаются этой функцией.
3316
Замечания:
3317
  * Параметры графики очень редко меняются при работе системы,
3318
    а именно, только в случаях, когда пользователь работает
3319
    с программой VRR.
3320
  * При изменении видеорежима система перерисовывает все окна
3321
    (событие с кодом 1) и перерисовывает фон (событие 5).
3322
    Эти же события происходят и в других случаях,
3323
    которые встречаются значительно чаще, чем изменение видеорежима.
3324
  * При работе в видеорежимах с LFB селектор gs указывает на
3325
    собственно LFB, так что чтение/запись по gs приводят
3326
    непосредственно к изменению содержимого экрана. При работе в
3327
    видеорежимах без LFB gs указывает на некоторую область данных
131 diamond 3328
    ядра, причём все функции вывода на экран добросовестно выполняют
77 diamond 3329
    двойную работу по записи непосредственно на экран и по записи
3330
    в этот буфер. В результате при чтении содержимого этого буфера
3331
    результаты соответствуют содержимому экрана
3332
    (с, вообще говоря, большим цветовым разрешением),
3333
    а запись игнорируется.
3334
    Исключением является режим 320*200, для которого в главном цикле
3335
    системного потока выполняется обновление экрана в соответствии
3336
    с движениями курсора мыши.
3337
 
3338
------------------------- Разрешение экрана --------------------------
3339
Параметры:
3340
  * eax = 61 - номер функции
3341
  * ebx = 1 - номер подфункции
3342
Возвращаемое значение:
3343
  * eax = [разрешение по оси x]*65536 + [разрешение по оси y]
3344
Замечания:
131 diamond 3345
  * Можно использовать функцию 14 с учётом того, что она возвращает
77 diamond 3346
    размеры на 1 меньше. Это полностью эквивалентный способ.
3347
 
3348
------------------------ Число бит на пиксель ------------------------
3349
Параметры:
3350
  * eax = 61 - номер функции
3351
  * ebx = 2 - номер подфункции
3352
Возвращаемое значение:
3353
  * eax = число бит на пиксель (24 или 32)
3354
 
3355
------------------------ Число байт на строку ------------------------
3356
Параметры:
3357
  * eax = 61 - номер функции
3358
  * ebx = 3 - номер подфункции
3359
Возвращаемое значение:
131 diamond 3360
  * eax = число байт, которое занимает одна строка развёртки
77 diamond 3361
    (горизонтальная линия на экране)
3362
 
3363
======================================================================
3364
===== Функция 62, подфункция 0 - получить версию PCI-интерфейса. =====
3365
======================================================================
3366
Параметры:
3367
  * eax = 62 - номер функции
3368
  * bl = 0 - номер подфункции
3369
Возвращаемое значение:
131 diamond 3370
  * eax = -1 - доступ к PCI запрещён; иначе
77 diamond 3371
  * ah.al = версия PCI-интерфейса (ah=версия, al=подверсия)
3372
  * старшее слово eax обнулено
3373
Замечания:
131 diamond 3374
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3375
    для приложений подфункцией 12 функции 21.
118 diamond 3376
  * Если PCI BIOS не поддерживается, то значение ax неопределено.
77 diamond 3377
 
3378
======================================================================
3379
==== Функция 62, подфункция 1 - получить номер последней PCI-шины. ===
3380
======================================================================
3381
Параметры:
3382
  * eax = 62 - номер функции
3383
  * bl = 1 - номер подфункции
3384
Возвращаемое значение:
131 diamond 3385
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3386
  * al = номер последней PCI-шины; оставшиеся байты eax разрушаются
77 diamond 3387
Замечания:
131 diamond 3388
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3389
    для приложений подфункцией 12 функции 21.
118 diamond 3390
  * Если PCI BIOS не поддерживается, то значение al неопределено.
77 diamond 3391
 
3392
======================================================================
3393
====================== Функция 62, подфункция 2 ======================
3394
== Получить механизм обращения к конфигурационному пространству PCI. =
3395
======================================================================
3396
Параметры:
3397
  * eax = 62 - номер функции
3398
  * bl = 2 - номер подфункции
3399
Возвращаемое значение:
131 diamond 3400
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3401
  * al = механизм (1 или 2); прочие байты eax разрушаются
77 diamond 3402
Замечания:
131 diamond 3403
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3404
    для приложений подфункцией 12 функции 21.
3405
  * Механизм обращения выбирается в соответствии
3406
    с характеристиками оборудования.
3407
  * Подфункции чтения и записи автоматически работают
3408
    с выбранным механизмом.
3409
 
3410
======================================================================
3411
======== Функция 62, подфункции 4,5,6 - прочитать PCI-регистр. =======
3412
======================================================================
3413
Параметры:
3414
  * eax = 62 - номер функции
3415
  * bl = 4 - читать байт
3416
  * bl = 5 - читать слово
3417
  * bl = 6 - читать двойное слово
3418
  * bh = номер PCI-шины
3419
  * ch = dddddfff, где ddddd = номер устройства на шине,
3420
    fff = номер функции устройства
131 diamond 3421
  * cl = номер регистра (должен быть чётным для bl=5,
77 diamond 3422
    делиться на 4 для bl=6)
3423
Возвращаемое значение:
131 diamond 3424
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3425
    неподдерживаемые параметры); иначе
3426
  * al/ax/eax (в зависимости от запрошенного размера) содержит данные;
3427
    оставшаяся часть регистра eax разрушается
3428
Замечания:
131 diamond 3429
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3430
    для приложений подфункцией 12 функции 21.
3431
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3432
    игнорирует номер функции. Получить механизм доступа можно вызовом
3433
    подфункции 2.
3434
  * Некоторые регистры стандартны и существуют для всех устройств,
3435
    некоторые определяются конкретным устройством. Список первых
3436
    входит, например, в известный Interrupt List by Ralf Brown
3437
    (http://www.pobox.com/~ralf/files.html,
3438
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3439
    список вторых должен быть указан в документации по устройству.
3440
 
3441
======================================================================
3442
======= Функция 62, подфункции 8,9,10 - записать в PCI-регистр. ======
3443
======================================================================
3444
Параметры:
3445
  * eax = 62 - номер функции
3446
  * bl = 8 - писать байт
3447
  * bl = 9 - писать слово
3448
  * bl = 10 - писать двойное слово
3449
  * bh = номер PCI-шины
3450
  * ch = dddddfff, где ddddd = номер устройства на шине,
3451
    fff = номер функции устройства
131 diamond 3452
  * cl = номер регистра (должен быть чётным для bl=9,
77 diamond 3453
    делиться на 4 для bl=10)
92 diamond 3454
  * dl/dx/edx (в зависимости от запрошенного размера) содержит
3455
    данные для записи
77 diamond 3456
Возвращаемое значение:
131 diamond 3457
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3458
    неподдерживаемые параметры)
3459
  * eax = 0 - успешно
3460
Замечания:
131 diamond 3461
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3462
    для приложений подфункцией 12 функции 21.
3463
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3464
    игнорирует номер функции. Получить механизм доступа можно вызовом
3465
    подфункции 2.
3466
  * Некоторые регистры стандартны и существуют для всех устройств,
3467
    некоторые определяются конкретным устройством. Список первых
3468
    входит, например, в известный Interrupt List by Ralf Brown;
3469
    список вторых должен быть указан в документации по устройству.
3470
 
3471
======================================================================
3472
================ Функция 63 - работа с доской отладки. ===============
3473
======================================================================
3474
Доска отладки представляет собой системный буфер (на 512 байт),
3475
в который любая программа может записать (вообще говоря, произвольные)
3476
данные и из которого другая программа может эти данные прочитать.
3477
Есть соглашение, в соответствии с которым записываемые данные -
3478
текстовые строки, интерпретируемые как отладочные сообщения о ходе
131 diamond 3479
выполнения программы. Ядро в определённых ситуациях также записывает
77 diamond 3480
на доску отладки сведения о выполнении некоторых функций;
3481
по соглашению сообщения ядра начинаются с префикса "K : ".
3482
Для просмотра доски отладки создано приложение board,
131 diamond 3483
которое считывает данные из буфера и отображает их в своём окне. board
77 diamond 3484
понимает последовательность кодов 13,10 как переход на новую строку.
3485
Символ с нулевым кодом в конце строки не обязателен, но и не мешает.
3486
В связи с появлением отладчика ценность доски отладки несколько
3487
снизилась, поскольку отладчик позволяет полностью контролировать ход
131 diamond 3488
выполнения программы, причём для этого не требуется никаких усилий
77 diamond 3489
со стороны самой программы. Тем не менее во многих случаях
3490
доска отладки продолжает оставаться полезной.
3491
 
3492
---------------------------- Запись байта ----------------------------
3493
Параметры:
3494
  * eax = 63 - номер функции
3495
  * ebx = 1 - номер подфункции
3496
  * cl = байт данных
3497
Возвращаемое значение:
3498
  * функция не возвращает значения
3499
Замечания:
3500
  * Байт записывается в буфер. Длина буфера - 512 байт.
3501
    При переполнении буфера все полученные данные теряются
3502
    и заполнение начинается снова с нуля.
3503
  * Для вывода на доску отладки более сложных объектов (строк, чисел)
3504
    достаточно этой функции, вызываемой в цикле. Можно не писать
3505
    вручную соответствующий код, а воспользоваться файлом debug.inc,
3506
    входящим в дистрибутив.
3507
 
3508
---------------------------- Чтение байта ----------------------------
3509
Забирает байт из буфера.
3510
Параметры:
3511
  * eax = 63 - номер функции
3512
  * ebx = 2 - номер подфункции
3513
Возвращаемое значение:
3514
  * eax = ebx = 0 - буфер пуст
3515
  * eax = байт, ebx = 1 - байт успешно прочитан
3516
 
3517
======================================================================
3518
========== Функция 64 - перераспределить память приложения. ==========
3519
======================================================================
3520
Параметры:
3521
  * eax = 64 - номер функции
3522
  * ebx = 1 - единственная подфункция
3523
  * ecx = новый размер памяти
3524
Возвращаемое значение:
3525
  * eax = 0 - успешно
3526
  * eax = 1 - недостаточно памяти
3527
Замечания:
3528
  * На данный момент эта функция является единственным средством для
3529
    динамического выделения/освобождения памяти приложения.
3530
 
3531
======================================================================
92 diamond 3532
================= Функция 66 - работа с клавиатурой. =================
77 diamond 3533
======================================================================
92 diamond 3534
Режим ввода влияет на результаты чтения клавиш функцией 2.
131 diamond 3535
При загрузке программы для неё устанавливается ASCII-режим ввода.
77 diamond 3536
 
92 diamond 3537
-------- Подфункция 1 - установить режим ввода с клавиатуры. ---------
77 diamond 3538
Параметры:
3539
  * eax = 66 - номер функции
3540
  * ebx = 1 - номер подфункции
3541
  * ecx = режим:
3542
    * 0 = обычный (ASCII-символы)
3543
    * 1 = сканкоды
3544
Возвращаемое значение:
3545
  * функция не возвращает значения
3546
 
92 diamond 3547
--------- Подфункция 2 - получить режим ввода с клавиатуры. ----------
77 diamond 3548
Параметры:
3549
  * eax = 66 - номер функции
3550
  * ebx = 2 - номер подфункции
3551
Возвращаемое значение:
3552
  * eax = текущий режим
3553
 
3554
------- Подфункция 3 - получить состояние управляющих клавиш. --------
3555
Параметры:
3556
  * eax = 66 - номер функции
3557
  * ebx = 3 - номер подфункции
3558
Возвращаемое значение:
3559
  * eax = битовая маска:
3560
  * бит 0 (маска 1): левый Shift нажат
3561
  * бит 1 (маска 2): правый Shift нажат
3562
  * бит 2 (маска 4): левый Ctrl нажат
3563
  * бит 3 (маска 8): правый Ctrl нажат
3564
  * бит 4 (маска 0x10): левый Alt нажат
3565
  * бит 5 (маска 0x20): правый Alt нажат
131 diamond 3566
  * бит 6 (маска 0x40): CapsLock включён
3567
  * бит 7 (маска 0x80): NumLock включён
3568
  * бит 8 (маска 0x100): ScrollLock включён
77 diamond 3569
  * прочие биты сброшены
3570
 
92 diamond 3571
----- Подфункция 4 - установить общесистемную "горячую клавишу". -----
3572
О нажатии "горячей клавиши" извещаются только приложения,
131 diamond 3573
установившие её; активное приложение (к которому поступает
92 diamond 3574
весь нормальный ввод) таких клавиш не получает.
3575
Извещение заключается в посылке события с кодом 2.
3576
Прочитать "горячую клавишу" можно так же, как и обычную, -
3577
функцией 2.
3578
Параметры:
3579
  * eax = 66 - номер функции
3580
  * ebx = 4 - номер подфункции
131 diamond 3581
  * cl задаёт сканкод клавиши;
92 diamond 3582
    используйте cl=0 для задания комбинаций типа Ctrl+Shift
131 diamond 3583
  * edx = 0xXYZ задаёт возможные состояния управляющих клавиш:
3584
    * Z (младшие 4 бита) задаёт состояние клавиш LShift и RShift:
92 diamond 3585
      * 0 = ни одна из клавиш не должна быть нажата;
3586
      * 1 = ровно одна из клавиш должна быть нажата;
3587
      * 2 = обе клавиши должны быть нажаты;
3588
      * 3 = должна быть нажата LShift, но не RShift;
3589
      * 4 = должна быть нажата RShift, но не LShift
3590
    * Y - аналогично для LCtrl и RCtrl;
3591
    * X - аналогично для LAlt и RAlt
3592
Возвращаемое значение:
3593
  * eax=0 - успешно
3594
  * eax=1 - слишком много "горячих клавиш" (допускается максимум 256)
3595
Замечания:
3596
  * Горячая клавиша может срабатывать либо при нажатии,
3597
    либо при отпускании. Сканкод отпускания клавиши на 128 больше,
3598
    чем сканкод нажатия (т.е. установлен старший бит).
3599
  * Несколько приложений могут установить одну и ту же комбинацию;
3600
    о нажатии такой комбинации будут извещаться все такие приложения.
3601
 
3602
------ Подфункция 5 - удалить установленную "горячую клавишу". -------
3603
Параметры:
3604
  * eax = 66 - номер функции
3605
  * ebx = 5 - номер подфункции
3606
  * cl = сканкод клавиши и edx = 0xXYZ такие же, как и в подфункции 4
3607
Возвращаемое значение:
3608
  * eax = 0 - успешно
3609
  * eax = 1 - нет такой горячей клавиши
3610
Замечания:
3611
  * При завершении процесса/потока удаляются все установленные им
3612
    горячие клавиши.
3613
  * Вызов функции не влияет на другие приложения.
3614
    Если другое приложение определило эту же комбинацию,
3615
    оно по-прежнему будет получать уведомления.
3616
 
77 diamond 3617
======================================================================
3618
============ Функция 67 - изменить положение/размеры окна. ===========
3619
======================================================================
3620
Параметры:
3621
  * eax = 67 - номер функции
3622
  * ebx = новая x-координата окна
3623
  * ecx = новая y-координата окна
3624
  * edx = новый x-размер окна
3625
  * esi = новый y-размер окна
3626
Возвращаемое значение:
3627
  * функция не возвращает значения
3628
Замечания:
3629
  * Значение -1 для параметра означает "не изменять"; например, для
3630
    перемещения окна без изменения размеров можно указать edx=esi=-1.
3631
  * Предварительно окно должно быть определено функцией 0.
131 diamond 3632
    Она же задаёт начальные координаты и размеры окна.
77 diamond 3633
  * Размеры окна понимаются в смысле функции 0, т.е.
3634
    на один пиксель меньше, чем реальные размеры.
3635
  * Вызов функции для максимизированных окон просто игнорируется.
3636
  * Для окон соответствующих стилей положение и/или размеры могут быть
3637
    изменены пользователем; текущие положение и размеры могут быть
3638
    получены вызовом функции 9.
3639
  * Функция посылает окну событие перерисовки (с кодом 1).
3640
 
3641
======================================================================
131 diamond 3642
=== Функция 68, подфункция 0 - получить счётчик переключений задач. ==
77 diamond 3643
======================================================================
3644
Параметры:
3645
  * eax = 68 - номер функции
3646
  * ebx = 0 - номер подфункции
3647
Возвращаемое значение:
3648
  * eax = число переключений задач с момента загрузки системы
3649
    (по модулю 2^32)
3650
 
3651
======================================================================
3652
====================== Функция 68, подфункция 1 ======================
3653
============ Переключиться на следующий поток выполнения. ============
3654
======================================================================
3655
Функция завершает текущий квант времени, выделенный потоку,
3656
и переключается на следующий.
3657
(Какой поток какого процесса будет следующим, предсказать нельзя).
131 diamond 3658
Позднее, когда до текущего потока дойдёт очередь,
77 diamond 3659
выполнение возобновится.
3660
Параметры:
3661
  * eax = 68 - номер функции
3662
  * ebx = 1 - номер подфункции
3663
Возвращаемое значение:
3664
  * функция не возвращает значения
3665
 
3666
======================================================================
3667
=============== Функция 68, подфункция 2 - кэш + rdpmc. ==============
3668
======================================================================
3669
Параметры:
3670
  * eax = 68 - номер функции
3671
  * ebx = 2 - номер подфункции
3672
  * ecx = требуемое действие:
3673
    * ecx = 0 - разрешить выполнение инструкции rdpmc
3674
      (ReaD Performance-Monitoring Counters)
131 diamond 3675
    * ecx = 1 - узнать, включён/выключен кэш
77 diamond 3676
    * ecx = 2 - включить кэш
3677
    * ecx = 3 - выключить кэш
3678
Возвращаемое значение:
3679
  * для ecx=0:
3680
    * eax = значение cr4
3681
  * для ecx=1:
3682
    * eax = (cr0 and 0x60000000):
131 diamond 3683
    * eax = 0 - кэш включён
77 diamond 3684
    * eax <> 0 - кэш выключен
3685
  * для ecx=2 и ecx=3:
3686
    * функция не возвращает значения
3687
 
3688
======================================================================
3689
========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
3690
======================================================================
3691
MSR = Model Specific Register; полный список MSR-регистров процессора
3692
содержится в документации по процессору (например, IA-32 Intel
3693
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3694
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3695
Параметры:
3696
  * eax = 68 - номер функции
3697
  * ebx = 3 - номер подфункции
3698
  * ecx игнорируется
3699
  * edx = адрес MSR
3700
Возвращаемое значение:
3701
  * ebx:eax = старший:младший dword результата
3702
Замечания:
3703
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3704
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3705
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3706
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3707
    которое всё равно прибьёт поток.
77 diamond 3708
 
3709
======================================================================
3710
========= Функция 68, подфункция 4 - записать в MSR-регистр. =========
3711
======================================================================
3712
MSR = Model Specific Register; полный список MSR-регистров процессора
3713
содержится в документации по процессору (например, IA-32 Intel
3714
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3715
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3716
Параметры:
3717
  * eax = 68 - номер функции
3718
  * ebx = 4 - номер подфункции
3719
  * ecx игнорируется
3720
  * edx = адрес MSR
3721
  * esi:edi = старший:младший dword
3722
Возвращаемое значение:
3723
  * ebx:eax = копия esi:edi
3724
Замечания:
3725
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3726
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3727
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3728
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3729
    которое всё равно прибьёт поток.
77 diamond 3730
 
3731
======================================================================
3732
======= Функция 68, подфункция 5 - выделить физическую память. =======
3733
======================================================================
3734
Параметры:
3735
  * eax = 68 - номер функции
3736
  * ebx = 5 - номер подфункции
3737
  * ecx = размер (в байтах)
3738
Возвращаемое значение:
3739
  * eax = физический адрес выделенной памяти
3740
Замечания:
3741
  * Обычные приложения не должны использовать эту функцию, она
3742
    предназначена для случая, когда при работе с каким-либо
3743
    устройством требуется разместить данные по известному физическому
3744
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3745
  * Число блоков физической памяти ограничено (константой 24,
131 diamond 3746
    причём эта константа включает и несколько блоков памяти
77 diamond 3747
    для надобностей ядра).
3748
  * Освободить выделенную таким образом память можно
3749
    подфункцией 6, копированием данных туда/обратно
3750
    занимаются подфункции 7 и 8.
3751
 
3752
======================================================================
3753
====== Функция 68, подфункция 6 - освободить физическую память. ======
3754
======================================================================
3755
Параметры:
3756
  * eax = 68 - номер функции
3757
  * ebx = 6 - номер подфункции
3758
  * ecx = физический адрес памяти
3759
Возвращаемое значение:
3760
  * функция не возвращает значения
3761
Замечания:
3762
  * Обычные приложения не должны использовать эту функцию, она
3763
    предназначена для случая, когда при работе с каким-либо
3764
    устройством требуется разместить данные по известному физическому
3765
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3766
  * Память должна быть ранее выделена подфункцией 5.
3767
 
3768
======================================================================
3769
=== Функция 68, подфункция 7 - записать данные в физическую память. ==
3770
======================================================================
3771
Параметры:
3772
  * eax = 68 - номер функции
3773
  * ebx = 7 - номер подфункции
3774
  * ecx = физический адрес
3775
  * edx = указатель на данные (в приложении)
3776
  * esi = размер данных (в байтах)
3777
Возвращаемое значение:
3778
  * функция не возвращает значения
3779
Замечания:
3780
  * Обычные приложения не должны использовать эту функцию, она
3781
    предназначена для случая, когда при работе с каким-либо
3782
    устройством требуется разместить данные по известному физическому
3783
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3784
  * Диапазон физических адресов должен лежать внутри ранее выделенного
3785
    подфункцией 5 блока физической памяти.
3786
  * Проверок корректности не производится.
3787
 
3788
======================================================================
3789
== Функция 68, подфункция 8 - прочитать данные из физической памяти. =
3790
======================================================================
3791
Параметры:
3792
  * eax = 68 - номер функции
3793
  * ebx = 8 - номер подфункции
3794
  * ecx = физический адрес
3795
  * edx = указатель на буфер для данных (в приложении)
3796
  * esi = размер данных (в байтах)
3797
Возвращаемое значение:
3798
  * функция не возвращает значения
3799
Замечания:
3800
  * Обычные приложения не должны использовать эту функцию, она
3801
    предназначена для случая, когда при работе с каким-либо
3802
    устройством требуется разместить данные по известному физическому
3803
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3804
  * Диапазон физических адресов должен лежать внутри ранее выделенного
3805
    подфункцией 5 блока физической памяти.
3806
  * Проверок корректности не производится.
3807
 
3808
======================================================================
3809
======================== Функция 69 - отладка. =======================
3810
======================================================================
3811
Процесс может загрузить другой процесс как отлаживаемый установкой
118 diamond 3812
соответствующего бита при вызове подфункции 16 функции 58
3813
или подфункции 7 функции 70.
77 diamond 3814
У процесса может быть только один отладчик; один процесс может
3815
отлаживать несколько разных. Система уведомляет отладчик о событиях,
3816
происходящих с отлаживаемым процессом. Сообщения записываются в буфер,
131 diamond 3817
определённый подфункцией 0.
77 diamond 3818
Формат сообщения:
3819
  * +0: dword: код сообщения
3820
  * +4: dword: PID отлаживаемого процесса
3821
  * +8: могут присутствовать дополнительные данные,
3822
    определяемые кодом сообщения
3823
Коды сообщений:
3824
  * 1 = исключение
131 diamond 3825
    * дополнительно передаётся dword-номер исключения
77 diamond 3826
    * процесс приостановлен
3827
  * 2 = процесс завершился
3828
    * приходит при любом завершении: как через системную функцию -1,
3829
      так и при "убийстве" любым другим процессом
3830
      (в том числе самим отладчиком)
3831
  * 3 = отладочное исключение int 1 = #DB
131 diamond 3832
    * дополнительно передаётся dword-образ регистра DR6:
77 diamond 3833
      * биты 0-3: выполнено условие соответствующей точки останова
3834
        (установленной подфункцией 9)
3835
      * бит 14: исключение произошло из-за режима
3836
        пошаговой трассировки (установлен флаг TF)
3837
    * процесс приостановлен
3838
При завершении отладчика прибиваются все отлаживаемые процессы.
3839
Если отладчик этого не хочет, он должен предварительно отключиться
3840
подфункцией 3.
3841
 
3842
Все подфункции применимы только к процессам/потокам, запущенным
118 diamond 3843
из текущего функцией 58 или 70 с установленным флагом отладки.
77 diamond 3844
Отладка многопоточных программ пока не поддерживается.
3845
Полный список подфункций:
3846
  * подфункция 0 - определить область данных для отладочных сообщений
3847
  * подфункция 1 - получить состояние регистров отлаживаемого потока
3848
  * подфункция 2 - установить состояние регистров отлаживаемого потока
3849
  * подфункция 3 - отключиться от отлаживаемого процесса
3850
  * подфункция 4 - приостановить отлаживаемый поток
3851
  * подфункция 5 - возобновить выполнение отлаживаемого потока
3852
  * подфункция 6 - прочитать из памяти отлаживаемого процесса
3853
  * подфункция 7 - записать в память отлаживаемого процесса
3854
  * подфункция 8 - завершить отлаживаемый поток
3855
  * подфункция 9 - установить/снять аппаратную точку останова
3856
 
3857
======================================================================
3858
====================== Функция 69, подфункция 0 ======================
3859
========= Определить область данных для отладочных сообщений. ========
3860
======================================================================
3861
Параметры:
3862
  * eax = 69 - номер функции
3863
  * ebx = 0 - номер подфункции
3864
  * ecx = указатель
3865
Формат области данных:
3866
  * +0: dword: N = размер буфера (не считая этого заголовка)
3867
  * +4: dword: занято в буфере
3868
  * +8: N*byte: буфер
3869
Возвращаемое значение:
3870
  * функция не возвращает значения
3871
Замечания:
3872
  * Если поле размера отрицательно, буфер считается заблокированным
3873
    и при поступлении нового сообщения система будет ждать.
3874
    Для синхронизации обрамляйте всю работу с буфером операциями
3875
    блокировки/разблокировки
131 diamond 3876
    	neg	[bufsize]
77 diamond 3877
  * Данные в буфере трактуются как массив элементов переменной длины -
3878
    сообщений. Формат сообщения указан в общем описании.
3879
 
3880
======================================================================
3881
====================== Функция 69, подфункция 1 ======================
3882
========= Получить состояние регистров отлаживаемого потока. =========
3883
======================================================================
3884
Параметры:
3885
  * eax = 69 - номер функции
3886
  * ebx = 1 - номер подфункции
3887
  * ecx = идентификатор потока
3888
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3889
  * esi = указатель на структуру контекста
77 diamond 3890
Возвращаемое значение:
3891
  * функция не возвращает значения
3892
Формат структуры контекста: (FPU пока не поддерживается)
3893
  * +0: dword: eip
3894
  * +4: dword: eflags
3895
  * +8: dword: eax
3896
  * +12 = +0xC: dword: ecx
3897
  * +16 = +0x10: dword: edx
3898
  * +20 = +0x14: dword: ebx
3899
  * +24 = +0x18: dword: esp
3900
  * +28 = +0x1C: dword: ebp
3901
  * +32 = +0x20: dword: esi
3902
  * +36 = +0x24: dword: edi
3903
Замечания:
3904
  * Если поток выполняет код 0-кольца, возвращается
3905
    состояние регистров 3-кольца.
3906
  * Процесс должен быть загружен для отладки (как указано в
3907
    общем описании).
3908
 
3909
======================================================================
3910
====================== Функция 69, подфункция 2 ======================
3911
======== Установить состояние регистров отлаживаемого потока. ========
3912
======================================================================
3913
Параметры:
3914
  * eax = 69 - номер функции
3915
  * ebx = 2 - номер подфункции
3916
  * ecx = идентификатор потока
3917
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3918
  * esi = указатель на структуру контекста
77 diamond 3919
Возвращаемое значение:
3920
  * функция не возвращает значения
3921
Формат структуры контекста указан в описании подфункции 1.
3922
Замечания:
3923
  * Если поток выполняет код 0-кольца, устанавливается
3924
    состояние регистров 3-кольца.
3925
  * Процесс должен быть загружен для отладки (как указано в
3926
    общем описании).
3927
 
3928
======================================================================
3929
== Функция 69, подфункция 3 - отключиться от отлаживаемого процесса. =
3930
======================================================================
3931
Параметры:
3932
  * eax = 69 - номер функции
3933
  * ebx = 3 - номер подфункции
3934
  * ecx = идентификатор
3935
Возвращаемое значение:
3936
  * функция не возвращает значения
3937
Замечания:
3938
  * Если процесс был приостановлен, он возобновляет выполнение.
3939
 
3940
======================================================================
3941
==== Функция 69, подфункция 4 - приостановить отлаживаемый поток. ====
3942
======================================================================
3943
Параметры:
3944
  * eax = 69 - номер процесса
3945
  * ebx = 4 - номер подфункции
3946
  * ecx = идентификатор
3947
Возвращаемое значение:
3948
  * функция не возвращает значения
3949
Замечания:
3950
  * Процесс должен быть загружен для отладки (как указано в
3951
    общем описании).
3952
 
3953
======================================================================
3954
====================== Функция 69, подфункция 5 ======================
3955
============ Возобновить выполнение отлаживаемого потока. ============
3956
======================================================================
3957
Параметры:
3958
  * eax = 69 - номер функции
3959
  * ebx = 5 - номер подфункции
3960
  * ecx = идентификатор
3961
Возвращаемое значение:
3962
  * функция не возвращает значения
3963
Замечания:
3964
  * Процесс должен быть загружен для отладки (как указано в
3965
    общем описании).
3966
 
3967
======================================================================
3968
====================== Функция 69, подфункция 6 ======================
3969
============= Прочитать из памяти отлаживаемого процесса. ============
3970
======================================================================
3971
Параметры:
3972
  * eax = 69 - номер функции
3973
  * ebx = 6 - номер подфункции
3974
  * ecx = идентификатор
3975
  * edx = сколько байт читать
3976
  * esi = адрес памяти отлаживаемого процесса
3977
  * edi = указатель на буфер для данных
3978
Возвращаемое значение:
3979
  * eax = -1 при ошибке (неверный PID или буфер)
3980
  * иначе eax = число прочитанных байт (возможно, 0,
3981
    если в esi слишком большое значение)
3982
Замечания:
3983
  * Процесс должен быть загружен для отладки (как указано в
3984
    общем описании).
3985
 
3986
======================================================================
3987
 Функция 69, подфункция 7 - записать в память отлаживаемого процесса.
3988
======================================================================
3989
Параметры:
3990
  * eax = 69 - номер функции
3991
  * ebx = 7 - номер подфункции
3992
  * ecx = идентификатор
3993
  * edx = сколько байт писать
3994
  * esi = адрес памяти в отлаживаемом процессе
3995
  * edi = указатель на данные
3996
Возвращаемое значение:
3997
  * eax = -1 при ошибке (неверный PID или буфер)
3998
  * иначе eax = число записанных байт (возможно, 0,
3999
    если в esi слишком большое значение)
4000
Замечания:
4001
  * Процесс должен быть загружен для отладки (как указано в
4002
    общем описании).
4003
 
4004
======================================================================
4005
====== Функция 69, подфункция 8 - завершить отлаживаемый поток. ======
4006
======================================================================
4007
Параметры:
4008
  * eax = 69 - номер функции
4009
  * ebx = 8 - номер подфункции
4010
  * ecx = идентификатор
4011
Возвращаемое значение:
4012
  * функция не возвращает значения
4013
Замечания:
4014
  * Процесс должен быть загружен для отладки (как указано в
4015
    общем описании).
4016
  * Функция аналогична подфункции 2 функции 18 с двумя отличиями:
4017
    требуется выполнение первого замечания и принимается PID,
4018
    а не номер слота.
4019
 
4020
======================================================================
4021
====================== Функция 69, подфункция 9 ======================
4022
============= Установить/снять аппаратную точку останова. ============
4023
======================================================================
4024
Параметры:
4025
  * eax = 69 - номер функции
4026
  * ebx = 9 - номер подфункции
4027
  * ecx = идентификатор потока
4028
  * dl = индекс точки останова, от 0 до 3 включительно
4029
  * dh = флаги:
4030
    * если старший бит сброшен - установить точку останова:
4031
      * биты 0-1 - условие:
4032
        * 00 = точка останова на выполнение
4033
        * 01 = точка останова на запись
4034
        * 11 = точка останова на чтение/запись
4035
      * биты 2-3 - длина; для точек останова на исполнение должно быть
4036
        00, в противном случае одно из
4037
        * 00 = байт
4038
        * 01 = слово
4039
        * 11 = двойное слово
4040
      * esi = адрес точки останова; должен быть выровнен
131 diamond 4041
        соответственно длине (т.е. должен быть чётным для
77 diamond 4042
        точек останова на слово, кратен 4 для двойного слова)
4043
    * если старший бит установлен - сбросить точку останова
4044
Возвращаемое значение:
4045
  * eax = 0 - успешно
4046
  * eax = 1 - ошибка во входных данных
4047
  * eax = 2 - (зарезервировано, никогда не возвращается
4048
    в текущей реализации) с этим индексом уже установлена
4049
    глобальная точка останова
4050
Замечания:
4051
  * Процесс должен быть загружен для отладки (как указано в
4052
    общем описании).
4053
  * Аппаратные точки останова реализуются через DRx-регистры
4054
    процессора, отсюда все ограничения.
4055
  * Функция может переустановить ранее установленную ей же
4056
    точку останова (никак не сообщая об этом).
4057
    Ведите список установленных точек останова в отладчике.
4058
  * Срабатывание точки останова заключается в генерировании
4059
    отладочного исключения #DB, о котором система сообщает отладчику.
4060
  * Точка останова на запись и чтение/запись срабатывает после
131 diamond 4061
    выполнения вызвавшей её инструкции.
77 diamond 4062
 
4063
======================================================================
131 diamond 4064
= Функция 70 - работа с файловой системой с поддержкой длинных имён. =
77 diamond 4065
======================================================================
4066
Параметры:
4067
  * eax = 70
4068
  * ebx = указатель на информационную структуру
4069
Возвращаемое значение:
4070
  * eax = 0 - успешно; иначе код ошибки файловой системы
4071
  * в зависимости от подфункции может возвращаться значение и
4072
    в других регистрах
4073
Общий формат информационной структуры:
4074
  * +0: dword: номер подфункции
4075
  * +4: dword: смещение в файле
91 diamond 4076
  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
77 diamond 4077
  * +12 = +0xC: dword: размер
4078
  * +16 = +0x10: dword: указатель на данные
4079
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
86 diamond 4080
    или
4081
  * +20 = +0x14: db 0
4082
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4083
Уточнения - в документации на соответствующую подфункцию.
4084
Имя файла нечувствительно к регистру букв. Русские буквы должны быть
4085
записаны в кодировке cp866 (DOS).
4086
Формат имени файла:
4087
/base/number/dir1/dir2/.../dirn/file,
4088
где /base/number идентифицирует устройство, на котором ищется файл:
4089
одно из
4090
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
4091
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
4092
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
4093
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
131 diamond 4094
    к жёстким дискам на IDE0 (Primary Master), IDE1 (Primary Slave),
77 diamond 4095
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4096
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
4097
    (на каждом из винчестеров нумерация начинается с 1)
91 diamond 4098
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 для доступа соответственно
4099
    к CD на IDE0 (Primary Master), IDE1 (Primary Slave),
118 diamond 4100
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
77 diamond 4101
Примеры:
83 diamond 4102
  * '/rd/1/kernel.asm',0
77 diamond 4103
  * '/HD0/1/kernel.asm',0
4104
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4105
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
4106
Доступные подфункции:
4107
  * подфункция 0 - чтение файла
4108
  * подфункция 1 - чтение папки
83 diamond 4109
  * подфункция 2 - создание/перезапись файла
131 diamond 4110
  * подфункция 3 - запись в существующий файл
133 diamond 4111
  * подфункция 4 - установка размера файла
86 diamond 4112
  * подфункция 5 - получение атрибутов файла/папки
4113
  * подфункция 6 - установка атрибутов файла/папки
91 diamond 4114
  * подфункция 7 - запуск программы
118 diamond 4115
Для CD-приводов в связи с аппаратными ограничениями доступны
4116
только подфункции 0,1,5 и 7, вызов других подфункций завершится
4117
ошибкой с кодом 2.
77 diamond 4118
 
4119
======================================================================
131 diamond 4120
= Функция 70, подфункция 0 - чтение файла с поддержкой длинных имён. =
77 diamond 4121
======================================================================
4122
Параметры:
4123
  * eax = 70 - номер функции
4124
  * ebx = указатель на информационную структуру
4125
Формат информационной структуры:
4126
  * +0: dword: 0 = номер подфункции
4127
  * +4: dword: позиция в файле (в байтах)
4128
  * +8: dword: 0 (зарезервировано под старший dword позиции)
4129
  * +12 = +0xC: dword: сколько байт читать
4130
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
131 diamond 4131
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 4132
    общем описании
86 diamond 4133
    или
4134
  * +20 = +0x14: db 0
4135
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4136
Возвращаемое значение:
4137
  * eax = 0 - успешно, иначе код ошибки файловой системы
4138
  * ebx = число прочитанных байт или
4139
    -1=0xffffffff, если файл не найден
4140
Замечания:
4141
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 4142
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 4143
    eax=6 (EOF).
4144
  * Функция не позволяет читать папки
131 diamond 4145
    (вернётся eax=10, access denied).
77 diamond 4146
 
4147
======================================================================
131 diamond 4148
= Функция 70, подфункция 1 - чтение папки с поддержкой длинных имён. =
77 diamond 4149
======================================================================
4150
Параметры:
4151
  * eax = 70 - номер функции
4152
  * ebx = указатель на информационную структуру
4153
Формат информационной структуры:
4154
  * +0: dword: 1 = номер подфункции
4155
  * +4: dword: индекс начального блока (считая с 0)
78 diamond 4156
  * +8: dword: поле флагов:
4157
    * бит 0 (маска 1): в каком формате возвращать имена,
4158
      0=ANSI, 1=UNICODE
4159
    * прочие биты зарезервированы и должны быть установлены в 0
4160
      для будущей совместимости
77 diamond 4161
  * +12 = +0xC: dword: сколько блоков читать
4162
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
4163
    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
131 diamond 4164
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
77 diamond 4165
    общем описании
86 diamond 4166
    или
4167
  * +20 = +0x14: db 0
4168
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4169
Возвращаемое значение:
4170
  * eax = 0 - успешно, иначе код ошибки файловой системы
4171
  * ebx = число файлов, информация о которых была записана в буфер,
4172
    или -1=0xffffffff, если папка не найдена
4173
Структура буфера:
4174
  * +0: 32*byte: заголовок
4175
  * +32 = +0x20: n1*byte: блок с информацией о файле 1
4176
  * +32+n1: n2*byte: блок с информацией о файле 2
4177
  * ...
4178
Структура заголовка:
4179
  * +0: dword: версия структуры (текущая версия = 1)
131 diamond 4180
  * +4: dword: количество размещённых блоков; не больше, чем запрошено
77 diamond 4181
    в поле +12 информационной структуры; может быть меньше,
4182
    если в папке кончились файлы (то же самое, что и в ebx)
4183
  * +8: dword: общее число файлов в папке
4184
  * +12 = +0xC: 20*byte: зарезервировано (нули)
4185
Структура блока данных входа каталога (БДВК):
4186
  * +0: dword: атрибуты файла:
4187
    * бит 0 (маска 1): файл только для чтения
4188
    * бит 1 (маска 2): файл является скрытым
4189
    * бит 2 (маска 4): файл является системным
4190
    * бит 3 (маска 8): это не файл, а метка тома
4191
      (на заданном разделе встречается не более одного раза и
4192
      только в корневой папке)
4193
    * бит 4 (маска 0x10): это папка
4194
    * бит 5 (маска 0x20): файл не архивировался - многие программы
4195
      архивации имеют опцию, по которой архивируются только файлы
4196
      с установленным этим битом, после чего этот бит сбрасывается -
4197
      это может быть полезно для автоматического создания
4198
      backup-архивов, ибо при записи бит обычно устанавливается
4199
      (не в Kolibri, правда)
78 diamond 4200
  * +4: byte: тип данных имени:
4201
    (совпадает с битом 0 флагов информационной структуры)
77 diamond 4202
    * 0 = ASCII = 1-байтное представление каждого символа
4203
    * 1 = UNICODE = 2-байтное представление каждого символа
4204
  * +5: 3*byte: зарезервировано (нули)
4205
  * +8: 4*byte: время создания файла
4206
  * +12 = +0xC: 4*byte: дата создания файла
4207
  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
4208
  * +20 = +0x14: 4*byte: дата последнего доступа
4209
  * +24 = +0x18: 4*byte: время последней модификации
4210
  * +28 = +0x1C: 4*byte: дата последней модификации
4211
  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
4212
  * +40 = +0x28: имя
4213
    * для формата ASCII: максимальная длина имени 263 символа
4214
      (263 байта), байт после имени имеет значение 0
4215
    * для формата UNICODE: максимальная длина имени 259 символов
4216
      (518 байт), два байта после имени имеют значение 0
4217
Формат времени:
4218
  * +0: byte: секунды
4219
  * +1: byte: минуты
4220
  * +2: byte: часы
4221
  * +3: byte: зарезервировано (0)
4222
  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
4223
Формат даты:
4224
  * +0: byte: день
4225
  * +1: byte: месяц
4226
  * +2: word: год
4227
  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
4228
Замечания:
4229
  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
4230
    304 байта, если в UNICODE - 560 байт. Значение длины выравнено
4231
    на целое кратное 16 байт
4232
    (для ускорения обработки в кэш-памяти CPU).
78 diamond 4233
  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
4234
    данные содержат мусор.
77 diamond 4235
  * Если файлы в папке кончились раньше, чем было прочитано
4236
    запрошенное количество, то функция прочитает, сколько сможет,
131 diamond 4237
    после чего вернёт eax=6 (EOF).
77 diamond 4238
  * Любая папка на диске, кроме корневой, содержит два специальных
4239
    входа "." и "..", идентифицирующих соответственно саму папку и
4240
    родительскую папку.
4241
  * Функция позволяет также читать виртуальные папки "/", "/rd",
4242
    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
4243
    0x10, а времена и даты обнулены. Альтернативный способ получения
4244
    информации об оборудовании - подфункция 11 функции 18.
4245
 
4246
======================================================================
83 diamond 4247
====================== Функция 70, подфункция 2 ======================
131 diamond 4248
======== Создание/перезапись файла с поддержкой длинных имён. ========
83 diamond 4249
======================================================================
4250
Параметры:
4251
  * eax = 70 - номер функции
4252
  * ebx = указатель на информационную структуру
4253
Формат информационной структуры:
4254
  * +0: dword: 2 = номер подфункции
4255
  * +4: dword: 0 (зарезервировано)
4256
  * +8: dword: 0 (зарезервировано)
4257
  * +12 = +0xC: dword: сколько байт писать
4258
  * +16 = +0x10: dword: указатель на данные
131 diamond 4259
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
83 diamond 4260
    общем описании
86 diamond 4261
    или
4262
  * +20 = +0x14: db 0
4263
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
83 diamond 4264
Возвращаемое значение:
4265
  * eax = 0 - успешно, иначе код ошибки файловой системы
4266
  * ebx = число записанных байт (возможно, 0)
4267
Замечания:
131 diamond 4268
  * Если файл с таким именем не существовал, он создаётся; если
83 diamond 4269
    существовал, то перезаписывается.
4270
  * Если свободного места на диске недостаточно, то функция запишет,
131 diamond 4271
    сколько сможет, после чего вернёт код ошибки 8.
4272
  * Функция не поддерживается для CD (вернётся код ошибки 2).
83 diamond 4273
 
4274
======================================================================
131 diamond 4275
====================== Функция 70, подфункция 3 ======================
4276
======== Запись в существующий файл с поддержкой длинных имён. =======
4277
======================================================================
4278
Параметры:
4279
  * eax = 70 - номер функции
4280
  * ebx = указатель на информационную структуру
4281
Формат информационной структуры:
4282
  * +0: dword: 3 = номер подфункции
4283
  * +4: dword: позиция в файле (в байтах)
4284
  * +8: dword: старший dword позиции (должен быть 0 для FAT)
4285
  * +12 = +0xC: dword: сколько байт писать
4286
  * +16 = +0x10: dword: указатель на данные
4287
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4288
    общем описании
4289
    или
4290
  * +20 = +0x14: db 0
4291
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4292
Возвращаемое значение:
4293
  * eax = 0 - успешно, иначе код ошибки файловой системы
4294
  * ebx = число записанных байт (возможно, 0)
4295
Замечания:
4296
  * Файл должен уже существовать, иначе вернётся eax=5.
4297
  * Единственным результатом записи 0 байт является установка в
4298
    атрибутах файла даты/времени модификации и доступа в текущую.
4299
  * Если начальная и/или конечная позиция выходит за пределы файла
4300
    (за исключением предыдущего случая), файл расширяется до
4301
    необходимого размера нулевыми символами.
133 diamond 4302
  * Функция не поддерживается для CD (вернётся код ошибки 2).
131 diamond 4303
 
4304
======================================================================
133 diamond 4305
========= Функция 70, подфункция 4 - установка размера файла. ========
4306
======================================================================
4307
Параметры:
4308
  * eax = 70 - номер функции
4309
  * ebx = указатель на информационную структуру
4310
Формат информационной структуры:
4311
  * +0: dword: 4 = номер подфункции
4312
  * +4: dword: младший dword нового размера файла
4313
  * +8: dword: старший dword нового размера файла
4314
                   (должен быть 0 для FAT)
4315
  * +12 = +0xC: dword: 0 (зарезервировано)
4316
  * +16 = +0x10: dword: 0 (зарезервировано)
4317
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4318
    общем описании
4319
    или
4320
  * +20 = +0x14: db 0
4321
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4322
Возвращаемое значение:
4323
  * eax = 0 - успешно, иначе код ошибки файловой системы
4324
  * ebx разрушается
4325
Замечания:
4326
  * Если новый размер файла меньше старого, файл усекается. Если
4327
    новый размер больше старого, файл расширяется нулевыми символами.
4328
    Если новый размер равен старому, единственным результатом вызова
4329
    является установка даты/времени модификации и доступа в текущие.
4330
  * Если свободного места на диске недостаточно для расширения файла,
4331
    то функция расширит насколько возможно, после чего вернёт
4332
    код ошибки 8.
4333
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4334
 
4335
======================================================================
86 diamond 4336
=== Функция 70, подфункция 5 - получение информации о файле/папке. ===
4337
======================================================================
4338
Параметры:
4339
  * eax = 70 - номер функции
4340
  * ebx = указатель на информационную структуру
4341
Формат информационной структуры:
4342
  * +0: dword: 5 = номер подфункции
4343
  * +4: dword: 0 (зарезервировано)
4344
  * +8: dword: 0 (зарезервировано)
4345
  * +12 = +0xC: dword: 0 (зарезервировано)
4346
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
4347
                        (40 байт)
131 diamond 4348
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4349
    общем описании
4350
    или
4351
  * +20 = +0x14: db 0
4352
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4353
Возвращаемое значение:
4354
  * eax = 0 - успешно, иначе код ошибки файловой системы
4355
  * ebx разрушается
4356
Информация о файле возвращается в формате БДВК
4357
(блока данных входа каталога), указанном в описании
4358
подфункции 1, но без имени файла
4359
(то есть первые 40 = 0x28 байт).
4360
Замечания:
4361
  * Функция не поддерживает виртуальные папки типа /, /rd и
4362
    корневые папки типа /rd/1.
4363
 
4364
======================================================================
4365
===== Функция 70, подфункция 6 - установка атрибутов файла/папки. ====
4366
======================================================================
4367
Параметры:
4368
  * eax = 70 - номер функции
4369
  * ebx = указатель на информационную структуру
4370
Формат информационной структуры:
4371
  * +0: dword: 6 = номер подфункции
4372
  * +4: dword: 0 (зарезервировано)
4373
  * +8: dword: 0 (зарезервировано)
4374
  * +12 = +0xC: dword: 0 (зарезервировано)
4375
  * +16 = +0x10: dword: указатель на буфер с атрибутами (32 байта)
131 diamond 4376
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4377
    общем описании
4378
    или
4379
  * +20 = +0x14: db 0
4380
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4381
Возвращаемое значение:
4382
  * eax = 0 - успешно, иначе код ошибки файловой системы
4383
  * ebx разрушается
4384
Атрибуты файла - первые 32 байта в БДВК (блоке данных входа каталога),
4385
формат которого указан в описании подфункции 1
4386
(то есть без имени и размера файла). Атрибут файл/папка/метка тома
4387
(биты 3,4 в dword'е +0) не меняется.
4388
Байт +4 (формат имени) игнорируется.
4389
Замечания:
4390
  * Функция не поддерживает виртуальные папки типа /, /rd и
4391
    корневые папки типа /rd/1.
131 diamond 4392
  * Функция не поддерживается для CD (вернётся код ошибки 2).
86 diamond 4393
 
4394
======================================================================
91 diamond 4395
============ Функция 70, подфункция 7 - запуск программы. ============
4396
======================================================================
4397
Параметры:
4398
  * eax = 70 - номер функции
4399
  * ebx = указатель на информационную структуру
4400
Формат информационной структуры:
4401
  * +0: dword: 7 = номер подфункции
4402
  * +4: dword: поле флагов:
4403
    * бит 0: запустить процесс как отлаживаемый
4404
    * остальные биты зарезервированы и должны быть установлены в 0
4405
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
4406
  * +12 = +0xC: dword: 0 (зарезервировано)
4407
  * +16 = +0x10: dword: 0 (зарезервировано)
131 diamond 4408
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
91 diamond 4409
    общем описании
4410
    или
4411
  * +20 = +0x14: db 0
4412
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4413
Возвращаемое значение:
4414
  * eax > 0 - программа загружена, eax содержит PID
4415
  * eax < 0 - произошла ошибка, -eax содержит
4416
    код ошибки файловой системы
4417
  * ebx разрушается
4418
Замечания:
4419
  * Командная строка должна заканчиваться символом с кодом 0
4420
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
4421
    включительно, либо первые 256 символов, в зависимости от того,
4422
    что меньше.
131 diamond 4423
  * Если процесс запускается как отлаживаемый, он создаётся
91 diamond 4424
    в замороженном состоянии; для запуска используйте