Subversion Repositories Kolibri OS

Rev

Rev 120 | Rev 131 | 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 адрес строки
127 mario79 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:
127 mario79 92
    * рисуется внешняя рамка шириной 1 пиксель "затен+нного" цвета
77 diamond 93
      edi (все составляющие цвета уменьшаются в два раза)
94
    * рисуется промежуточная рамка шириной 3 пикселя цвета edi
95
    * рисуется внутренняя рамка шириной 1 пиксель
127 mario79 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
    организованный как очередь.
127 mario79 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
    либо все символы до (но не включая) завершающего нуля
127 mario79 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
Замечания:
127 mario79 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
  * Проверок на корректность не делается. Установка слишком больших
127 mario79 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
======================================================================
127 mario79 639
 Функция 18, подфункция 4 - получить сч+тчик пустых тактов в секунду.
77 diamond 640
======================================================================
641
Под пустыми тактами понимается время, в которое процессор простаивает
642
в ожидании прерывания (в инструкции hlt).
643
 
644
Параметры:
645
  * eax = 18 - номер функции
646
  * ebx = 4 - номер подфункции
647
Возвращаемое значение:
127 mario79 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
======================================================================
127 mario79 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,
127 mario79 669
      раздел+нные '/')
77 diamond 670
Возвращаемое значение:
671
  * eax = 0 - успешно
672
  * иначе eax = код ошибки файловой системы
673
Замечания:
674
  * Имя файла фиксировано, "menuet.img" (глобальная переменная ядра
675
    image_save из preboot.inc)
127 mario79 676
  * На каком разделе какого диска файл будет сохран+н, определяется
77 diamond 677
    подфункцией 7 и подфункцией 8 функции 21.
127 mario79 678
  * Все папки в указанном пути должны существовать, иначе верн+тся
77 diamond 679
    значение 5, "файл не найден".
680
 
681
======================================================================
682
====== Функция 18, подфункция 7 - получить номер активного окна. =====
683
======================================================================
684
Параметры:
685
  * eax = 18 - номер функции
686
  * ebx = 7 - номер подфункции
687
Возвращаемое значение:
688
  * eax = номер активного окна (номер слота потока, окно которого
689
    активно)
690
Замечания:
691
  * Активное окно находится вверху оконного стэка и получает
127 mario79 692
    сообщения обо вс+м вводе с клавиатуры.
77 diamond 693
  * Сделать окно активным можно вызовом подфункции 3.
694
 
695
======================================================================
696
==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====
697
======================================================================
127 mario79 698
При отключ+нном звуке вызовы подфункции 55 функции 55 игнорируются.
699
При включ+нном - направляются на встроенный спикер.
77 diamond 700
 
701
--------------- Подподфункция 1 - получить состояние. ----------------
702
Параметры:
703
  * eax = 18 - номер функции
704
  * ebx = 8 - номер подфункции
705
  * ecx = 1 - номер подподфункции
706
Возвращаемое значение:
127 mario79 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.
127 mario79 759
  * Обычно нет необходимости явно сворачивать/разворачивать сво+ окно:
77 diamond 760
    сворачивание окна осуществляется системой при нажатии на кнопку
761
    минимизации (которая для окон со скином определяется автоматически
127 mario79 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,
127 mario79 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.
127 mario79 791
  * +1: byte: информация о ж+стких дисках и CD-приводах, AABBCCDD,
77 diamond 792
    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
793
    * 0 = устройство отсутствует
127 mario79 794
    * 1 = ж+сткий диск
77 diamond 795
    * 2 = CD-привод
796
    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
127 mario79 797
  * +2: 4 db: число найденных разделов на ж+стких дисках с
77 diamond 798
    соответственно IDE0,...,IDE3.
127 mario79 799
    При отсутствии ж+сткого диска на IDEx соответствующий байт
77 diamond 800
    нулевой, при наличии показывает число распознанных разделов,
801
    которых может и не быть (если носитель не отформатирован или
802
    если файловая система не поддерживается). В текущей версии ядра
127 mario79 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 =====================
127 mario79 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
======================================================================
120 mario79 933
====================== Функция 18, подфункция 19 =====================
934
============= Получить/установить настройки  мыши. ===================
935
======================================================================
936
Параметры:
937
  * eax = 18 - номер функции
938
  * ebx = 19 - номер подфункции
939
  * ecx = номер пофункции 2-го уровня.
940
 
941
    ecx = 0 - получить скорость мыши
942
    Возвращаемое значение:
943
    * eax = текущая скорость мыши
944
 
945
    ecx = 1 - установить скорость мыши
946
    edx = устанавливаемое значение скорости
947
    Возвращаемое значение:
948
    * функция не возвращает значения
949
 
950
    ecx = 2 - получить задержку ускорения
951
    Возвращаемое значение:
952
    * eax = текущая задержка ускорения
953
 
954
    ecx = 3 - установить задержку ускорения
955
    edx = устанавливаемая задержка ускорения
956
    Возвращаемое значение:
957
    * функция не возвращает значения
958
 
959
    ecx = 4 - установить позицию курсора мыши на экране
960
    edx = [координата по оси x]*65536 + [координата по оси y]
961
    Возвращаемое значение:
962
    * функция не возвращает значения
963
 
964
Замечания:
965
  * Рекомендуемая скорость мыши (в подфункции 1) от 1 до 9.
966
    Устанавливаемая величина не контролируется кодом ядра, по этому
967
    используйте осторожно, при некорректном значении курсор может "замерзнуть".
968
    Скорость мыши можно регулировать через приложение SETUP.
969
  * Рекомендуемая величина задержки (в подфункции 3) = 10. Более низкое
970
    значение не обрабатывается COM мышами. При очень больших значениях
971
    невозможно передвижение мыши на 1 пиксель и курсор будет прыгать
972
    на величину установленной скорости (подфункция 1).
127 mario79 973
    Величину задержки можно регулировать через приложение SETUP.
120 mario79 974
    Устанавливаемая величина не контролируется кодом ядра.
975
  * В подфункции 4 устанавливаемая величина не контролируется кодом ядра.
976
    Перед использованием необходимо узнать текущее разрешение экрана и
977
    при установке позиции следить, чтобы величина позиции не выходила за
978
    пределы экрана.
979
 
980
======================================================================
77 diamond 981
============ Функция 19 - запустить программу с рамдиска. ============
982
======================================================================
983
Параметры:
984
  * eax = 19 - номер функции
985
  * ebx = указатель на имя программы в формате, аналогичном функции 6
986
  * ecx = 0 или ecx = указатель на параметры командной строки
987
Возвращаемое значение:
988
  * Если eax > 0, то eax содержит PID созданного процесса
989
  * Если eax < 0, то -eax - код ошибки файловой системы
990
Замечания:
91 diamond 991
  * Эта функция устарела; используйте подфункцию 7 функции 70.
114 mikedld 992
  * Командная строка должна заканчиваться символом с кодом 0
77 diamond 993
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
994
    включительно, либо первые 256 символов, в зависимости от того,
995
    что меньше.
996
 
997
======================================================================
998
==================== Функция 20 - интерфейс MIDI. ====================
999
======================================================================
1000
 
1001
------------------------ Подфункция 1 - сброс ------------------------
1002
Параметры:
1003
  * eax = 20 - номер функции
1004
  * ebx = 1 - номер подфункции
1005
 
1006
-------------------- Подфункция 2 - вывести байт ---------------------
1007
Параметры:
1008
  * eax = 20 - номер функции
1009
  * ebx = 2 - номер подфункции
1010
  * cl = байт для вывода
1011
Возвращаемое значение (одинаково для обеих подфункций):
1012
  * eax = 0 - успешно
127 mario79 1013
  * eax = 1 - не определ+н базовый порт
77 diamond 1014
Замечания:
127 mario79 1015
  * Предварительно должен быть определ+н базовый порт вызовом
77 diamond 1016
    подфункции 1 функции 21.
1017
 
1018
======================================================================
1019
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
1020
======================================================================
1021
Параметры:
1022
  * eax = 21 - номер функции
1023
  * ebx = 1 - номер подфункции
1024
  * ecx = номер базового порта
1025
Возвращаемое значение:
1026
  * eax = 0 - успешно
1027
  * eax = -1 - ошибочный номер порта
1028
Замечания:
1029
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1030
  * Установка базы нужна для работы функции 20.
1031
  * Получить установленный базовый порт можно вызовом
1032
    подфункции 1 функции 26.
1033
 
1034
======================================================================
1035
===== Функция 21, подфункция 2 - установить раскладку клавиатуры. ====
1036
======================================================================
1037
Раскладка клавиатуры используется для преобразования сканкодов,
1038
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1039
Параметры:
1040
  * eax = 21 - номер функции
1041
  * ebx = 2 - номер подфункции
1042
  * ecx = какую раскладку устанавливать:
1043
    * 1 = нормальную
1044
    * 2 = раскладку при нажатом Shift
1045
    * 3 = раскладку при нажатом Alt
1046
  * edx = указатель на раскладку - таблицу длиной 128 байт
1047
Или:
1048
  * ecx = 9
1049
  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1050
Возвращаемое значение:
1051
  * eax = 0 - успешно
1052
  * eax = 1 - параметр задан неверно
1053
Замечания:
1054
  * Если нажат Alt, то используется раскладка с Alt;
1055
    если не нажат Alt, но нажат Shift, то
1056
    используется раскладка с Shift;
1057
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1058
    нормальная раскладка, после чего из кода вычитается 0x60;
1059
    если не нажата ни одна из управляющих клавиш, то используется
1060
    нормальная раскладка.
1061
  * Получить раскладки и идентификатор страны можно с помощью
1062
    подфункции 2 функции 26.
1063
  * Идентификатор страны - глобальная системная переменная, которая
1064
    самим ядром не используется; однако приложение @panel отображает
1065
    соответствующую текущей стране иконку.
1066
  * Приложение @panel переключает раскладки по запросу пользователя.
1067
 
1068
======================================================================
1069
=========== Функция 21, подфункция 3 - установить базу CD. ===========
1070
======================================================================
1071
Параметры:
1072
  * eax = 21 - номер функции
1073
  * ebx = 3 - номер подфункции
1074
  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1075
Возвращаемое значение:
1076
  * eax = 0
1077
Замечания:
1078
  * База CD используется функцией 24.
1079
  * Получить установленную базу CD можно вызовом
1080
    подфункции 3 функции 26.
1081
 
1082
======================================================================
1083
== Функция 21, подфункция 4 - установить базовый порт Sound Blaster. =
1084
======================================================================
1085
Параметры:
1086
  * eax = 21 - номер функции
1087
  * ebx = 4 - номер подфункции
1088
  * ecx = номер базового порта
1089
Возвращаемое значение:
1090
  * eax = 0 - успешно
1091
  * eax = -1 - ошибочный номер порта
1092
Замечания:
1093
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1094
  * Установка базы нужна для работы функций 25, 28, 55.
1095
  * Получить установленный базовый порт можно вызовом
1096
    подфункции 4 функции 26.
1097
 
1098
======================================================================
1099
========= Функция 21, подфункция 5 - установить язык системы. ========
1100
======================================================================
1101
Параметры:
1102
  * eax = 21 - номер функции
1103
  * ebx = 5 - номер подфункции
1104
  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1105
Возвращаемое значение:
1106
  * eax = 0
1107
Замечания:
1108
  * Язык системы - глобальная системная переменная, никак
1109
    не используемая самим ядром, однако приложение @panel рисует
1110
    соответствующую иконку.
1111
  * Проверок на корректность не делается, поскольку ядро эту
1112
    переменную не использует.
1113
  * Получить язык системы можно вызовом подфункции 5 функции 26.
1114
 
1115
======================================================================
1116
======= Функция 21, подфункция 6 - установить базовый порт WSS. ======
1117
======================================================================
1118
Параметры:
1119
  * eax = 21 - номер функции
1120
  * ebx = 6 - номер подфункции
1121
  * ecx = базовый порт
1122
Возвращаемое значение:
1123
  * eax = 0 - успешно
1124
  * eax = -1 - ошибочный номер порта
1125
Замечания:
1126
  * Номер порта должен удовлетворять условию 0x100<=ecx.
1127
  * База WSS используется функцией 27.
1128
  * Получить установленный базовый порт WSS можно вызовом
1129
    подфункции 6 функции 26.
1130
 
1131
======================================================================
1132
=========== Функция 21, подфункция 7 - установить базу HD. ===========
1133
======================================================================
127 mario79 1134
База HD нужна для определения, на какой ж+сткий диск писать, при
77 diamond 1135
использовании устаревших функций работы с файловой системой и функций,
127 mario79 1136
неявно использующих ж+сткий диск (типа подфункции 6 функции 18);
77 diamond 1137
при использовании функций 58 и 70 и современного синтаксиса
1138
/HD0,/HD1,/HD2,/HD3 эти функции сами устанавливают базу.
1139
Параметры:
1140
  * eax = 21 - номер функции
1141
  * ebx = 7 - номер подфункции
1142
  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1143
Возвращаемое значение:
1144
  * eax = 0
1145
Замечания:
1146
  * Любое приложение в любой момент времени может изменить базу.
1147
  * Не следует изменять базу, когда какое-нибудь приложение работает
127 mario79 1148
    с ж+стким диском. Если не хотите глюков системы.
77 diamond 1149
  * Получить установленную базу можно вызовом подфункции 7 функции 26.
127 mario79 1150
  * Следует также определить используемый раздел ж+сткого диска
77 diamond 1151
    подфункцией 8.
1152
 
1153
======================================================================
1154
========== Функция 21, подфункция 8 - установить раздел HD. ==========
1155
======================================================================
127 mario79 1156
Раздел HD нужен для определения, на какой раздел ж+сткого диска
77 diamond 1157
писать, при использовании устаревших функций работы с файловой
127 mario79 1158
системой и функций, неявно использующих ж+сткий диск (типа
77 diamond 1159
подфункции 6 функции 18); при использовании функций 58 и 70
1160
и современного синтаксиса /HD0,/HD1,/HD2,/HD3 эти функции сами
1161
устанавливают базу и раздел.
1162
Параметры:
1163
  * eax = 21 - номер функции
1164
  * ebx = 8 - номер подфункции
1165
  * ecx = раздел HD (считая с 1)
1166
Возвращаемое значение:
1167
  * eax = 0
1168
Замечания:
1169
  * Любое приложение в любой момент времени может изменить раздел.
1170
  * Не следует изменять раздел, когда какое-нибудь приложение работает
127 mario79 1171
    с ж+стким диском. Если не хотите глюков системы.
77 diamond 1172
  * Получить установленный раздел можно вызовом подфункции 8
1173
    функции 26.
1174
  * Проверок на корректность не делается.
127 mario79 1175
  * Узнать число разделов на ж+стком диске можно вызовом
77 diamond 1176
    подфункции 11 функции 18.
127 mario79 1177
  * Следует также определить используемую базу ж+сткого диска
77 diamond 1178
    подфункцией 7.
1179
 
1180
======================================================================
1181
===== Функция 21, подфункция 10 - установить канал DMA для звука. ====
1182
======================================================================
1183
Параметры:
1184
  * eax = 21 - номер функции
1185
  * ebx = 10 - номер подфункции
1186
  * ecx = номер канала (от 0 до 3 включительно)
1187
Возвращаемое значение:
1188
  * eax = 0 - успешно
1189
  * eax = -1 - неверный номер канала
1190
Замечания:
1191
  * Номер канала DMA используется в
1192
    подфункции 1 функции 55.
1193
  * Получить канал DMA для звука можно вызовом
1194
    подфункции 10 функции 26.
1195
 
1196
======================================================================
1197
====================== Функция 21, подфункция 11 =====================
1198
=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
1199
======================================================================
1200
Параметры:
1201
  * eax = 21 - номер функции
1202
  * ebx = 11 - номер подфункции
1203
  * ecx = 0/1 - запретить/разрешить
1204
Возвращаемое значение:
1205
  * eax = 0
1206
Замечания:
1207
  * Используется при LBA-чтении (подфункция 8 функции 58).
1208
  * Текущая реализация использует только младший бит ecx.
1209
  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
1210
 
1211
======================================================================
1212
====================== Функция 21, подфункция 12 =====================
1213
========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
1214
======================================================================
1215
Параметры:
1216
  * eax = 21 - номер функции
1217
  * ebx = 12 - номер подфункции
1218
  * ecx = 0/1 - запретить/разрешить
1219
Возвращаемое значение:
1220
  * eax = 0
1221
Замечания:
1222
  * Используется при работе с шиной PCI (функция 62).
1223
  * Текущая реализация использует только младший бит ecx.
1224
  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
1225
 
1226
======================================================================
1227
============= Функция 21, подфункция 13, подподфункция 1 =============
1228
==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
1229
======================================================================
1230
Параметры:
1231
  * eax = 21 - номер функции
1232
  * ebx = 13 - номер подфункции
1233
  * ecx = 1 - номер функции драйвера
1234
  * edx = указатель на буфер размера 512 байт
1235
Возвращаемое значение:
1236
  * если драйвер не загружен (никогда не бывает в текущей реализации):
1237
    * eax = -1
1238
    * ebx, ecx разрушаются
1239
  * если драйвер загружен:
1240
    * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт,
1241
      'Z' - старший) - сигнатура
127 mario79 1242
    * ebx = текущая частота разв+ртки (в Гц)
77 diamond 1243
    * ecx разрушается
1244
    * буфер, на который указывает edx, заполнен
1245
Формат буфера:
1246
  * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек,
1247
    дополнено пробелами)
1248
  * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как
1249
    y*65536+x), для текущей реализации 1 (1.0)
1250
  * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
1251
  * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое
1252
    слово - номер видеорежима, после собственно списка идут нули)
127 mario79 1253
  * +128 = +0x80: 32*(5*word): список поддерживаемых частот разв+рток
77 diamond 1254
    для видеорежимов: для каждого видеорежима, указанного в предыдущем
1255
    поле, указано до 5 поддерживаемых частот
1256
    (в неиспользуемых позициях записаны нули)
1257
Замечания:
127 mario79 1258
  * Функция инициализирует драйвер (если он ещ+ не инициализирован)
77 diamond 1259
    и должна вызываться первой, перед остальными (иначе они будут
1260
    возвращать -1, ничего не делая).
127 mario79 1261
  * В текущей реализации поддерживается только одна частота разв+ртки
77 diamond 1262
    на видеорежим.
1263
 
1264
======================================================================
1265
============= Функция 21, подфункция 13, подподфункция 2 =============
1266
============= Получить информацию о текущем видеорежиме. =============
1267
======================================================================
1268
Параметры:
1269
  * eax = 21 - номер функции
1270
  * ebx = 13 - номер подфункции
1271
  * ecx = 2 - номер функции драйвера
1272
Возвращаемое значение:
1273
  * eax = -1 - драйвер не загружен или не инициализирован;
1274
    ebx,ecx разрушаются
1275
  * eax = [ширина]*65536 + [высота]
127 mario79 1276
  * ebx = частота вертикальной разв+ртки (в Гц)
77 diamond 1277
  * ecx = номер текущего видеорежима
1278
Замечания:
1279
  * Драйвер предварительно должен быть инициализирован вызовом
1280
    функции драйвера 1.
1281
  * Если нужны только размеры экрана, целесообразней использовать
127 mario79 1282
    функцию 14 с уч+том того, что она возвращает размеры на 1 меньше.
77 diamond 1283
 
1284
======================================================================
1285
= Функция 21, подфункция 13, подподфункция 3 - установить видеорежим.
1286
======================================================================
1287
Параметры:
1288
  * eax = 21 - номер функции
1289
  * ebx = 13 - номер подфункции
1290
  * ecx = 3 - номер функции драйвера
127 mario79 1291
  * edx = [частота разв+ртки]*65536 + [номер видеорежима]
77 diamond 1292
Возвращаемое значение:
1293
  * eax = -1 - драйвер не загружен, не инициализирован или
1294
    произошла ошибка
1295
  * eax = 0 - успешно
1296
  * ebx, ecx разрушаются
1297
Замечания:
1298
  * Драйвер предварительно должен быть инициализирован вызовом
1299
    функции драйвера 1.
1300
  * Номер видеорежима и частота должны быть в таблице, возвращаемой
1301
    функцией драйвера 1.
1302
 
1303
======================================================================
1304
============= Функция 21, подфункция 13, подподфункция 4 =============
1305
================= Вернуться к начальному видеорежиму. ================
1306
======================================================================
1307
Возвращает экран в видеорежим, установленный при загрузке системы.
1308
Параметры:
1309
  * eax = 21 - номер функции
1310
  * ebx = 13 - номер подфункции
1311
  * ecx = 4 - номер функции драйвера
1312
Возвращаемое значение:
1313
  * eax = -1 - драйвер не загружен или не инициализирован
1314
  * eax = 0 - успешно
1315
  * ebx, ecx разрушаются
1316
Замечания:
1317
  * Драйвер предварительно должен быть инициализирован вызовом
1318
    функции драйвера 1.
1319
 
1320
======================================================================
1321
============= Функция 21, подфункция 13, подподфункция 5 =============
1322
======== Увеличить/уменьшить размер видимой области монитора. ========
1323
======================================================================
1324
Параметры:
1325
  * eax = 21 - номер функции
1326
  * ebx = 13 - номер подфункции
1327
  * ecx = 5 - номер функции драйвера
1328
  * edx = 0/1 - уменьшить/увеличить размер по горизонтали
1329
    на одну позицию
1330
  * edx = 2/3 - в текущей реализации не поддерживается; планируется
1331
    как уменьшение/увеличение размера по вертикали на одну позицию
1332
Возвращаемое значение:
1333
  * eax = -1 - драйвер не загружен или не инициализирован
1334
  * eax = 0 - успешно
1335
  * ebx, ecx разрушаются
1336
Замечания:
1337
  * Драйвер предварительно должен быть инициализирован вызовом
1338
    функции драйвера 1.
1339
  * Функция влияет только на физический размер изображения
1340
    на мониторе; логический размер (число пикселей) не меняется.
1341
 
1342
======================================================================
1343
============ Функция 22 - установить системную дату/время. ===========
1344
======================================================================
1345
Параметры:
1346
  * eax = 22 - номер функции
1347
  * ebx = 0 - установить время
1348
    * ecx = 0x00SSMMHH - время в двоично-десятичном коде (BCD):
1349
    * HH=час 00..23
1350
    * MM=минута 00..59
1351
    * SS=секунда 00..59
1352
  * ebx = 1 - установить дату
1353
    * ecx = 0x00DDMMYY - дата в двоично-десятичном коде (BCD):
1354
    * DD=день 01..31
1355
    * MM=месяц 01..12
1356
    * YY=год 00..99
1357
  * ebx = 2 - установить день недели
1358
    * ecx = 1 для воскресенья, ..., 7 для субботы
1359
  * ebx = 3 - установить будильник
1360
    * ecx = 0x00SSMMHH
1361
Возвращаемое значение:
1362
  * eax = 0 - успешно
1363
  * eax = 1 - параметр задан неверно
1364
  * eax = 2 - CMOS-батарейки разрядились
1365
Замечания:
1366
  * Ценность установки дня недели представляется сомнительной,
1367
    поскольку он мало где используется
1368
    (день недели можно рассчитать по дате).
1369
  * Будильник можно установить на срабатывание в заданное время
1370
    каждые сутки. При этом отключить его существующими системными
1371
    функциями нельзя.
1372
  * Срабатывание будильника заключается в генерации IRQ8.
1373
  * Вообще-то CMOS поддерживает для будильника установку значения
1374
    0xFF в качестве одного из параметров и означает это, что
1375
    соответствующий параметр игнорируется. Но в текущей реализации
127 mario79 1376
    это не пройд+т (верн+тся значение 1).
77 diamond 1377
  * Будильник - глобальный системный ресурс; установка будильника
1378
    автоматически отменяет предыдущую установку. Впрочем, на данный
1379
    момент ни одна программа его не использует.
1380
 
1381
======================================================================
1382
============== Функция 23 - ожидать события с таймаутом. =============
1383
======================================================================
127 mario79 1384
Если очередь сообщений пуста, жд+т появления сообщения в очереди,
77 diamond 1385
но не более указанного времени. Затем считывает сообщение из очереди.
1386
 
1387
Параметры:
1388
  * eax = 23 - номер функции
1389
  * ebx = таймаут (в сотых долях секунды)
1390
Возвращаемое значение:
1391
  * eax = 0 - очередь сообщений пуста
1392
  * иначе eax = событие (смотри список событий)
1393
Замечания:
1394
  * Учитываются только те события, которые входят в маску,
1395
    устанавливаемую функцией 40. По умолчанию это события
1396
    перерисовки, нажатия на клавиши и на кнопки.
1397
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
1398
    Чтобы ждать сколь угодно долго, используйте функцию 10.
1399
  * Передача ebx=0 приводит к моментальному возвращению eax=0.
127 mario79 1400
  * При текущей реализации произойд+т немедленный возврат из функции
1401
    с eax=0, если сложение ebx с текущим значением сч+тчика времени
77 diamond 1402
    вызовет 32-битное переполнение.
1403
 
1404
======================================================================
1405
======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ======
1406
======================================================================
1407
Параметры:
1408
  * eax = 24 - номер функции
1409
  * ebx = 1 - номер подфункции
1410
  * ecx = 0x00FRSSMM, где
1411
    * MM = начальная минута
1412
    * SS = начальная секунда
1413
    * FR = начальный фрейм
1414
Возвращаемое значение:
1415
  * eax = 0 - успешно
1416
  * eax = 1 - не определена база CD
1417
Замечания:
1418
  * Предварительно нужно определить базовый порт CD вызовом
1419
    подфункции 3 функции 21.
1420
  * В секунде 75 фреймов, в минуте 60 секунд.
1421
  * Функция асинхронна (возвращает управление, когда началось
1422
    проигрывание).
1423
 
1424
======================================================================
1425
===== Функция 24, подфункция 2 - получить информацию о дорожках. =====
1426
======================================================================
1427
Параметры:
1428
  * eax = 24 - номер функции
1429
  * ebx = 2 - номер подфункции
1430
  * ecx = указатель на буфер для таблицы
1431
    (максимум 8*64h+4 байт=100 дорожек)
1432
Возвращаемое значение:
1433
  * eax = 0 - успешно
1434
  * eax = 1 - не определена база CD
1435
Замечания:
1436
  * Формат таблицы с информацией о дорожках такой же, как и для
1437
    ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h).
1438
    Адреса возвращаются в формате MSF.
1439
  * Предварительно нужно определить базовый порт CD вызовом
1440
    подфункции 3 функции 21.
1441
  * Функция возвращает информацию только о не более чем 100
1442
    первых дорожках. В большинстве случаев этого достаточно.
1443
 
1444
======================================================================
1445
==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. ===
1446
======================================================================
1447
Параметры:
1448
  * eax = 24 - номер функции
1449
  * ebx = 1 - номер подфункции
1450
Возвращаемое значение:
1451
  * eax = 0 - успешно
1452
  * eax = 1 - не определена база CD
1453
Замечания:
1454
  * Предварительно нужно определить базовый порт CD вызовом
1455
    подфункции 3 функции 21.
1456
 
1457
======================================================================
1458
============== Функция 25 - установить громкость SBPro. ==============
1459
======================================================================
1460
Параметры:
1461
  * eax = 25 - номер функции
1462
  * ebx = что устанавливать:
1463
    * 1 - установить общую громкость
1464
    * 2 - установить громкость CD-audio
1465
  * cl = уровень громкости: старшие 4 бита для левой колонки,
1466
    младшие 4 - для правой
1467
Возвращаемое значение:
1468
  * eax = 0 - успешно
1469
  * eax = 1 - не определена база SB
1470
  * eax = 2 - неверная подфункция
1471
Замечания:
1472
  * Предварительно нужно определить базовый порт SB вызовом
1473
    подфункции 4 функции 21.
1474
  * Смотри также функцию 28
1475
    установки звука для более позднего стандарта SB16.
1476
 
1477
======================================================================
1478
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
1479
======================================================================
1480
Параметры:
1481
  * eax = 26 - номер функции
1482
  * ebx = 1 - номер подфункции
1483
Возвращаемое значение:
1484
  * eax = номер порта
1485
Замечания:
1486
  * Установить базовый порт можно вызовом
1487
    подфункции 1 функции 21.
1488
 
1489
======================================================================
1490
====== Функция 26, подфункция 2 - получить раскладку клавиатуры. =====
1491
======================================================================
1492
Раскладка клавиатуры используется для преобразования сканкодов,
1493
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1494
Параметры:
1495
  * eax = 26 - номер функции
1496
  * ebx = 2 - номер подфункции
1497
  * ecx = какую раскладку получать:
1498
    * 1 = нормальную
1499
    * 2 = раскладку при нажатом Shift
1500
    * 3 = раскладку при нажатом Alt
1501
  * edx = указатель на буфер длиной 128 байт, куда будет скопирована
1502
    раскладка
1503
Возвращаемое значение:
1504
  * функция не возвращает значения
1505
Или:
1506
  * eax = 26 - номер функции
1507
  * ebx = 2 - номер подфункции
1508
  * ecx = 9
1509
Возвращаемое значение:
1510
  * eax = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1511
Замечания:
1512
  * Если нажат Alt, то используется раскладка с Alt;
1513
    если не нажат Alt, но нажат Shift, то используется
1514
    раскладка с Shift;
1515
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1516
    нормальная раскладка, после чего из кода вычитается 0x60;
1517
    если не нажата ни одна из управляющих клавиш, то используется
1518
    нормальная раскладка.
1519
  * Установить раскладки и идентификатор страны можно с помощью
1520
    подфункции 2 функции 21.
1521
  * Идентификатор страны - глобальная системная переменная, которая
1522
    самим ядром не используется; однако приложение @panel отображает
1523
    соответствующую текущей стране иконку
1524
    (используя описываемую функцию).
1525
  * Приложение @panel переключает раскладки по запросу пользователя.
1526
 
1527
======================================================================
1528
============ Функция 26, подфункция 3 - получить базу CD. ============
1529
======================================================================
1530
Параметры:
1531
  * eax = 26 - номер функции
1532
  * ebx = 3 - номер подфункции
1533
Возвращаемое значение:
1534
  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1535
Замечания:
1536
  * База CD используется функцией 24.
114 mikedld 1537
  * Установить базу CD можно вызовом подфункции 3 функции 21.
77 diamond 1538
 
1539
======================================================================
1540
=== Функция 26, подфункция 4 - получить базовый порт Sound Blaster. ==
1541
======================================================================
1542
Параметры:
1543
  * eax = 26 - номер функции
1544
  * ebx = 4 - номер подфункции
1545
Возвращаемое значение:
1546
  * eax = номер базового порта
1547
Замечания:
1548
  * Установка базы нужна для работы функций 25, 55.
1549
  * Установить базовый порт можно вызовом подфункции 4 функции 21.
1550
 
1551
======================================================================
1552
========== Функция 26, подфункция 5 - получить язык системы. =========
1553
======================================================================
1554
Параметры:
1555
  * eax = 26 - номер функции
1556
  * ebx = 5 - номер подфункции
1557
Возвращаемое значение:
1558
  * eax = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1559
Замечания:
1560
  * Язык системы - глобальная системная переменная, никак
1561
    не используемая самим ядром, однако приложение @panel рисует
1562
    соответствующую иконку (используя описываемую функцию).
1563
  * Установить язык системы можно вызовом подфункции 5 функции 21.
1564
 
1565
======================================================================
1566
======== Функция 26, подфункция 6 - получить базовый порт WSS. =======
1567
======================================================================
1568
Параметры:
1569
  * eax = 26 - номер функции
1570
  * ebx = 6 - номер подфункции
1571
Возвращаемое значение:
1572
  * eax = базовый порт
1573
Замечания:
1574
  * База WSS используется функцией 27.
1575
  * Установить базовый порт WSS можно вызовом подфункции 6 функции 21.
1576
 
1577
======================================================================
1578
============ Функция 26, подфункция 7 - получить базу HD. ============
1579
======================================================================
127 mario79 1580
База HD нужна для определения, на какой ж+сткий диск писать, при
77 diamond 1581
использовании устаревших функций работы с файловой системой и функций,
127 mario79 1582
неявно использующих ж+сткий диск (типа подфункции 6 функции 18);
77 diamond 1583
при использовании функций 58 и 70 и современного синтаксиса
1584
/HD0,/HD1,/HD2,/HD3 эти функции сами устанавливают базу.
1585
Параметры:
1586
  * eax = 26 - номер функции
1587
  * ebx = 7 - номер подфункции
1588
Возвращаемое значение:
1589
  * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1590
Замечания:
1591
  * Любое приложение в любой момент времени может изменить базу.
1592
  * Установить базу можно вызовом подфункции 7 функции 21.
127 mario79 1593
  * Получить используемый раздел ж+сткого диска можно подфункцией 8.
77 diamond 1594
 
1595
======================================================================
1596
=========== Функция 26, подфункция 8 - получить раздел HD. ===========
1597
======================================================================
127 mario79 1598
Раздел HD нужен для определения, на какой раздел ж+сткого диска
77 diamond 1599
писать, при использовании устаревших функций работы с файловой
127 mario79 1600
системой и функций, неявно использующих ж+сткий диск (типа
77 diamond 1601
подфункции 6 функции 18); при использовании функций 58 и 70 и
1602
современного синтаксиса /HD0,/HD1,/HD2,/HD3 эти функции сами
1603
устанавливают базу и раздел.
1604
Параметры:
1605
  * eax = 26 - номер функции
1606
  * ebx = 8 - номер подфункции
1607
Возвращаемое значение:
1608
  * eax = раздел HD (считая с 1)
1609
Замечания:
1610
  * Любое приложение в любой момент времени может изменить раздел.
1611
  * Установить раздел можно вызовом подфункции 8 функции 21.
127 mario79 1612
  * Узнать число разделов на ж+стком диске можно вызовом
77 diamond 1613
    подфункции 11 функции 18.
127 mario79 1614
  * Получить используемую базу ж+сткого диска можно подфункцией 7.
77 diamond 1615
 
1616
======================================================================
127 mario79 1617
=== Функция 26, подфункция 9 - получить значение сч+тчика времени. ===
77 diamond 1618
======================================================================
1619
Параметры:
1620
  * eax = 26 - номер функции
1621
  * ebx = 9 - номер подфункции
1622
Возвращаемое значение:
1623
  * eax = число сотых долей секунды, прошедших с момента
1624
    запуска системы
1625
Замечания:
127 mario79 1626
  * Сч+тчик бер+тся по модулю 2^32, что соответствует немногим более
77 diamond 1627
    497 суток.
1628
  * Системное время можно получить функцией 3.
1629
 
1630
======================================================================
1631
====== Функция 26, подфункция 10 - получить канал DMA для звука. =====
1632
======================================================================
1633
Параметры:
1634
  * eax = 26 - номер функции
1635
  * ebx = 10 - номер подфункции
1636
Возвращаемое значение:
1637
  * eax = номер канала (от 0 до 3 включительно)
1638
Замечания:
1639
  * Номер канала DMA используется в подфункции 1 функции 55.
1640
  * Установить канал DMA для звука можно вызовом
1641
    подфункции 10 функции 21.
1642
 
1643
======================================================================
1644
====================== Функция 26, подфункция 11 =====================
127 mario79 1645
=========== Узнать, разреш+н ли низкоуровневый доступ к HD. ==========
77 diamond 1646
======================================================================
1647
Параметры:
1648
  * eax = 26 - номер функции
1649
  * ebx = 11 - номер подфункции
1650
Возвращаемое значение:
127 mario79 1651
  * eax = 0/1 - запрещ+н/разреш+н
77 diamond 1652
Замечания:
1653
  * Используется при LBA-чтении (подфункция 8 функции 58).
1654
  * Установить текущее состояние можно вызовом
1655
    подфункции 11 функции 21.
1656
 
1657
======================================================================
1658
====================== Функция 26, подфункция 12 =====================
127 mario79 1659
========== Узнать, разреш+н ли низкоуровневый доступ к PCI. ==========
77 diamond 1660
======================================================================
1661
Параметры:
1662
  * eax = 26 - номер функции
1663
  * ebx = 12 - номер подфункции
1664
Возвращаемое значение:
127 mario79 1665
  * eax = 0/1 - запрещ+н/разреш+н
77 diamond 1666
Замечания:
1667
  * Используется при работе с шиной PCI (функция 62).
1668
  * Текущая реализация использует только младший бит ecx.
1669
  * Установить текущее состояние можно вызовом
1670
    подфункции 12 функции 21.
1671
 
1672
======================================================================
1673
==== Функция 27 - установить громкость Windows Sound System (WSS). ===
1674
======================================================================
1675
Параметры:
1676
  * eax = 27 - номер функции
1677
  * ebx = что устанавливать:
1678
    * 1 - установить общую громкость
1679
    * 2 - установить громкость Line In
1680
  * cl = уровень громкости (0x0=самый высокий, 0x1F=самый низкий,
1681
    установленный бит 0x80=отключить)
1682
Возвращаемое значение:
1683
  * eax = 0 - успешно
1684
  * eax = 1 - не определена база WSS
1685
  * eax = 2 - неверная подфункция
1686
Замечания:
1687
  * Предварительно нужно определить базовый порт WSS вызовом
1688
    подфункции 6 функции 21.
1689
  * Установка общей громкости фактически игнорируется
1690
    (возвращается eax=0).
1691
  * В старой документации и в исходниках ядра подфункция 2
1692
    ошибочно названа громкостью CD-audio.
1693
 
1694
======================================================================
1695
=============== Функция 28 - установить громкость SB16. ==============
1696
======================================================================
1697
Параметры:
1698
  * eax = 28 - номер функции
1699
  * ebx = что устанавливать:
1700
    * 1 - установить общую громкость
1701
    * 2 - установить громкость CD-audio
1702
  * cl = уровень громкости (0=off, 0xFF=max)
1703
Возвращаемое значение:
1704
  * eax = 0 - успешно
1705
  * eax = 1 - не определена база SB
1706
  * eax = 2 - неверная подфункция
1707
Замечания:
1708
  * Предварительно нужно определить базовый порт SB вызовом
1709
    подфункции 4 функции 21.
1710
  * Эта функция предоставляет больше вариантов для громкости,
1711
    чем функция 25.
1712
 
1713
======================================================================
1714
================ Функция 29 - получить системную дату. ===============
1715
======================================================================
1716
Параметры:
1717
  * eax = 29 - номер функции
1718
Возвращаемое значение:
1719
  * eax = 0x00DDMMYY, где
1720
    (используется двоично-десятичное кодирование, BCD)
1721
  * YY = две младшие цифры года (00..99)
1722
  * MM = месяц (01..12)
1723
  * DD = день (01..31)
1724
Замечания:
1725
  * Системную дату можно установить функцией 22.
1726
 
1727
======================================================================
1728
================ Функция 32 - удалить файл с рамдиска. ===============
1729
======================================================================
1730
Параметры:
1731
  * eax = 32 - номер функции
1732
  * ebx = указатель на имя файла
1733
Возвращаемое значение:
1734
  * eax = 0 - успешно; иначе код ошибки файловой системы
1735
Замечания:
1736
  * Эта функция устарела; функция 58 позволяет выполнять
1737
    те же действия с расширенными возможностями.
1738
  * Текущая реализация возвращает только значения 0(успех) и
1739
    5(файл не найден).
1740
  * Имя файла должно быть либо в формате 8+3 символов (первые
1741
    8 символов - собственно имя, последние 3 - расширение,
1742
    короткие имена и расширения дополняются пробелами),
1743
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1744
    (имя не более 8 символов, точка, расширение 3 символа,
1745
    дополненное при необходимости пробелами).
1746
    Имя файла должно быть записано заглавными буквами.
1747
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 1748
  * Эта функция не поддерживает папок на рамдиске.
77 diamond 1749
 
1750
======================================================================
1751
=============== Функция 33 - записать файл на рамдиск. ===============
1752
======================================================================
1753
Параметры:
1754
  * eax = 33 - номер функции
1755
  * ebx = указатель на имя файла
1756
  * ecx = указатель на данные для записи
1757
  * edx = число байт для записи
1758
  * следует устанавливать esi=0
1759
Возвращаемое значение:
1760
  * eax = 0 - успешно, иначе код ошибки файловой системы
1761
Замечания:
118 diamond 1762
  * Эта функция устарела; функция 70 позволяет выполнять
77 diamond 1763
    те же действия с расширенными возможностями.
1764
  * Если указать ненулевое значение в esi и на рамдиске уже есть
127 mario79 1765
    указанный файл, то будет создан ещ+ один файл с тем же именем.
77 diamond 1766
  * В противном случае файл перезаписывается.
1767
  * Имя файла должно быть либо в формате 8+3 символов
1768
    (первые 8 символов - собственно имя, последние 3 - расширение,
1769
    короткие имена и расширения дополняются пробелами),
1770
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
1771
    (имя не более 8 символов, точка, расширение 3 символа,
1772
    дополненное при необходимости пробелами).
1773
    Имя файла должно быть записано заглавными буквами.
1774
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 1775
  * Эта функция не поддерживает папок на рамдиске.
77 diamond 1776
 
1777
======================================================================
1778
============ Функция 35 - прочитать цвет точки на экране. ============
1779
======================================================================
1780
Параметры:
1781
  * eax = 35
1782
  * ebx = y*xsize+x, где
1783
  * (x,y) = координаты точки (считая от 0)
1784
  * xsize = размер экрана по горизонтали
1785
Возвращаемое значение:
1786
  * eax = цвет 0x00RRGGBB
1787
Замечания:
1788
  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
1789
    что она вычитает 1 из обоих размеров.
1790
  * К видеопамяти есть также прямой доступ (без вызовов системных
1791
    функций) через селектор gs. Параметры текущего видеорежима
1792
    можно получить функцией 61.
1793
 
1794
======================================================================
1795
========== Функция 37 - получить координаты/состояние мыши. ==========
1796
======================================================================
1797
 
1798
-------------- Подфункция 0 - экранные координаты мыши ---------------
1799
Параметры:
1800
  * eax = 37 - номер функции
1801
  * ebx = 0 - номер подфункции
1802
Возвращаемое значение:
1803
  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
1804
 
1805
---------- Подфункция 1 - координаты мыши относительно окна ----------
1806
Параметры:
1807
  * eax = 37 - номер функции
1808
  * ebx = 1 - номер подфункции
1809
Возвращаемое значение:
1810
  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
1811
    окна приложения (считая от 0)
1812
Замечания:
1813
  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
1814
    Если y>=ywnd, то младшее слово неотрицательно и содержит
1815
    относительную y-координату, а старшее - относительную x-координату
1816
    (правильного знака). В противном случае младшее слово отрицательно
127 mario79 1817
    и вс+ равно содержит относительную y-координату,
77 diamond 1818
    а к старшему слову следует прибавить 1.
1819
 
1820
----------------- Подфункция 2 - нажатые кнопки мыши -----------------
1821
Параметры:
1822
  * eax = 37 - номер функции
1823
  * ebx = 2 - номер подфункции
1824
Возвращаемое значение:
1825
  * eax содержит информацию о нажатых кнопках мыши:
1826
  * бит 0 установлен = левая кнопка нажата
1827
  * бит 1 установлен = правая кнопка нажата
1828
  * прочие биты сброшены
1829
 
1830
======================================================================
1831
================== Функция 38 - нарисовать отрезок. ==================
1832
======================================================================
1833
Параметры:
1834
  * eax = 38 - номер функции
1835
  * ebx = [координата начала по оси x]*65536 +
1836
              [координата конца по оси x]
1837
  * ecx = [координата начала по оси y]*65536 +
1838
              [координата конца по оси y]
1839
  * edx = 0x00RRGGBB - цвет
1840
Возвращаемое значение:
1841
  * функция не возвращает значения
1842
Замечания:
1843
  * Координаты берутся относительно окна.
1844
  * Конечная точка также рисуется.
1845
 
1846
======================================================================
1847
== Функция 39, подфункция 1 - получить размер фонового изображения. ==
1848
======================================================================
1849
Параметры:
1850
  * eax = 39 - номер функции
1851
  * ebx = 1 - номер подфункции
1852
Возвращаемое значение:
1853
  * eax = [ширина]*65536 + [высота]
1854
Замечания:
1855
  * Есть парная команда установки размеров фонового изображения -
1856
    подфункция 1 функции 15. После которой, разумеется, следует
1857
    заново определить само изображение.
1858
 
1859
======================================================================
1860
= Функция 39, подфункция 2 - прочитать точку с фонового изображения. =
1861
======================================================================
1862
Параметры:
1863
  * eax = 39 - номер функции
1864
  * ebx = 2 - номер подфункции
1865
  * ecx = смещение
1866
Возвращаемое значение:
1867
  * eax = 0x00RRGGBB - цвет точки, если смещение допустимо
1868
    (меньше 0x160000-16)
1869
  * eax = 2 - иначе
1870
Замечания:
1871
  * Не следует полагаться на возвращаемое значение в случае неверного
1872
    смещения, оно может измениться в следующих версиях ядра.
1873
  * Смещение точки с координатами (x,y) вычисляется как (x+y*xsize)*3.
1874
  * Есть парная функция установки точки на фоновом изображении -
1875
    подфункция 2 функции 15.
1876
 
1877
======================================================================
1878
====== Функция 39, подфункция 4 - получить режим отрисовки фона. =====
1879
======================================================================
1880
Параметры:
1881
  * eax = 39 - номер функции
1882
  * ebx = 4 - номер подфункции
1883
Возвращаемое значение:
1884
  * eax = 1 - замостить
1885
  * eax = 2 - растянуть
1886
Замечания:
1887
  * Есть парная функция установки режима отрисовки фона -
1888
    подфункция 4 функции 15.
1889
 
1890
======================================================================
1891
======== Функция 40 - установить маску для ожидаемых событий. ========
1892
======================================================================
1893
Маска для ожидаемых событий влияет на функции работы с событиями 10,
127 mario79 1894
11, 23 - они сообщают только о событиях, разреш+нных этой маской.
77 diamond 1895
Параметры:
1896
  * eax = 40 - номер функции
1897
  * ebx = маска: бит i соответствует событию i+1 (см. список событий)
1898
    (установленный бит разрешает извещение о событии)
1899
Возвращаемое значение:
1900
  * функция не возвращает значения
1901
Замечания:
1902
  * Маска по умолчанию (7=111b) разрешает извещения о перерисовке
1903
    и нажатиях клавиш и кнопок.
1904
    Этого достаточно для большинства приложений.
127 mario79 1905
  * События, запрещ+нные в маске, вс+ равно сохраняются, если
77 diamond 1906
    приходят; о них просто не извещают функции работы с событиями.
1907
  * Функции работы с событиями учитывают маску на момент
1908
    вызова функции, а не на момент поступления сообщения.
1909
 
1910
======================================================================
1911
================= Функция 41 - узнать владельца IRQ. =================
1912
======================================================================
1913
Параметры:
1914
  * eax = 41 - номер функции
1915
  * ebx = номер IRQ, 0..15
1916
Возвращаемое значение:
1917
  * eax = PID владельца
1918
  * eax = 0, если владельца нет
1919
  * eax = -1 для некорректного ebx
1920
 
1921
======================================================================
1922
========== Функция 42 - прочитать данные, полученные по IRQ. =========
1923
======================================================================
1924
При возникновении IRQ система может считывать данные из указанных
1925
ранее функцией 44 портов и записывать эти данные в буфер.
1926
Описываемая функция считывает побайтно данные из этого буфера.
1927
Параметры:
1928
  * eax = 42 - номер функции
1929
  * ebx = номер IRQ, 0..15
1930
Возвращаемое значение: (ситуацию можно различить по значению ecx)
1931
  * если поток не является владельцем IRQ
1932
    (или номер IRQ задан неверно):
1933
    * ecx = 2
1934
  * если данных нет:
1935
    * eax = 0
1936
    * ecx = 1
1937
    * ebx разрушается
127 mario79 1938
  * если вс+ в порядке и данные были:
1939
    * eax = размер данных, ещ+ не прочитанных из буфера (в байтах)
77 diamond 1940
    * ecx = 0
1941
    * ebx = очередной байт
1942
Замечания:
1943
  * Предварительно поток должен зарезервировать для себя указанный IRQ
1944
    функцией 45.
1945
  * Размер буфера для данных - 4000 байт, при переполнении
1946
    "свежие" данные перестают записываться в буфер.
1947
 
1948
======================================================================
1949
=================== Функция 43 - ввод/вывод в порт. ==================
1950
======================================================================
1951
 
1952
------------------------ Вывод данных в порт -------------------------
1953
Параметры:
1954
  * eax = 43 - номер функции
1955
  * bl = байт для вывода
1956
  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
1957
Возвращаемое значение:
1958
  * eax = 0 - успешно
1959
  * eax = 1 - поток не зарезервировал указанный порт
1960
 
1961
------------------------ Ввод данных из порта ------------------------
1962
Параметры:
1963
  * eax = 43 - номер функции
1964
  * ebx игнорируется
1965
  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
1966
Возвращаемое значение:
127 mario79 1967
  * eax = 0 - успешно, при этом ebx = введ+нный байт
77 diamond 1968
  * eax = 1 - поток не зарезервировал данный порт
1969
Замечания:
1970
  * Предварительно поток должен зарезервировать за собой
1971
    указанный порт функцией 46.
1972
  * Для зарезервированных портов вместо вызова этих функций
1973
    лучше использовать команды процессора in/out - это значительно
1974
    быстрее и несколько короче и проще. Из незарезервированных
127 mario79 1975
    портов читать вс+ равно нельзя.
77 diamond 1976
 
1977
======================================================================
1978
======== Функция 44 - определить действия при поступлении IRQ. =======
1979
======================================================================
1980
При возникновении IRQ система может считывать данные из указанных этой
1981
функцией портов и записывать эти данные в буфер, откуда их можно
1982
прочитать функцией 42.
1983
Параметры:
1984
  * eax = 44 - номер функции
1985
  * ebx = указатель на массив структур, описывающих по одному порту:
1986
    * +0: word: 0 означает конец массива, иначе номер порта
1987
    * +2: byte: зарезервировано (игнорируется)
1988
    * +3: byte: 1=считывать байт из этого порта, 2=считывать слово
1989
  * ecx = номер IRQ, 0..15
1990
Возвращаемое значение:
1991
  * eax = 0 - успешно
1992
  * eax = 1 - поток не является владельцем указанного IRQ
1993
Замечания:
1994
  * Предварительно поток должен зарезервировать за собой
1995
    указываемый IRQ функцией 45.
1996
  * Принимаются во внимание только первые 16 портов.
1997
  * Текущая реализация рассматривает неправильное значение поля +3
1998
    как сигнал прекращения обработки IRQ.
1999
 
2000
======================================================================
2001
============ Функция 45 - зарезервировать/освободить IRQ. ============
2002
======================================================================
2003
Параметры:
2004
  * eax = 45 - номер функции
2005
  * ebx = 0 - зарезервировать, 1 = освободить
2006
  * ecx = номер IRQ, 0..15
2007
Возвращаемое значение:
2008
  * eax = 0 - успешно
2009
  * eax = 1 - ошибка (неверный номер IRQ или
2010
    попытка зарезервировать несвободный IRQ или освободить IRQ, не
2011
    зарезервированный текущим потоком)
2012
Замечания:
2013
  * Резервирование IRQ нужно для работы функций 42 и 44.
2014
  * Только один поток может зарезервировать конкретный IRQ.
2015
  * IRQ, обрабатываемые системой самостоятельно, резервируются
2016
    системой (потоком 1) при загрузке.
2017
  * При завершении потока автоматически освобождаются
2018
    все зарезервированные им IRQ.
2019
 
2020
======================================================================
2021
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
2022
======================================================================
2023
К зарезервированным портам можно обращаться напрямую из приложения
2024
командами in/out (рекомендуемый способ) и вызовом функции 43
2025
(нерекомендуемый способ).
2026
Параметры:
2027
  * eax = 46 - номер функции
2028
  * ebx = 0 - зарезервировать, 1 - освободить
2029
  * ecx = номер начала диапазона портов
2030
  * edx = номер конца диапазона портов (включительно)
2031
Возвращаемое значение:
2032
  * eax = 0 - успешно
2033
  * eax = 1 - ошибка
2034
Замечания:
2035
  * В случае резервирования портов ошибкой считается выполнение
2036
    одного из условий:
2037
    * начальный адрес больше конечного;
2038
    * указанный диапазон содержит некорректный номер порта
2039
      (корректные - от 0 до 0xFFFF);
2040
    * превышено ограничение на общее число зарезервированных областей
2041
      - допускается максимум 255;
2042
    * указанный диапазон пересекается с одним из
2043
      ранее зарезервированных
2044
  * В случае освобождения портов ошибкой считается попытка
2045
    освобождения диапазона, который ранее не был целиком
2046
    зарезервирован этой же функцией (с такими же значениями ecx,edx).
2047
  * При обнаружении ошибки (в обоих случаях) никаких действий
2048
    не производится.
2049
  * При загрузке система резервирует за собой порты 0..0xff, а при
2050
    обнаружении COM-мыши - дополнительно диапазон COM-портов
2051
    0x3f0..0x3ff и/или 0x2f0..0x2ff.
2052
  * При завершении потока автоматически освобождаются все
2053
    зарезервированные им порты.
2054
 
2055
======================================================================
2056
================= Функция 47 - вывести число в окно. =================
2057
======================================================================
2058
Параметры:
2059
  * eax = 47 - номер функции
2060
  * ebx = параметры преобразования числа в текст:
2061
    * bl = 0 - ecx содержит число
2062
    * bl = 1 - ecx содержит указатель на dword-число
2063
    * bh = 0 - отображать в десятичной системе счисления
2064
    * bh = 1 - отображать в шестнадцатеричной системе
2065
    * bh = 2 - отображать в двоичной системе
2066
    * биты 16-21 = сколько цифр отображать
2067
    * биты 22-31 зарезервированы и должны быть установлены в 0
2068
  * ecx = число (при bl=0) или указатель (при bl=1)
2069
  * edx = [координата по оси x]*65536 + [координата по оси y]
2070
  * esi = 0xN0RRGGBB, RRGGBB=цвет, N=шрифт (0/1)
2071
Возвращаемое значение:
2072
  * функция не возвращает значения
2073
Замечания:
2074
  * Указанная длина не должна превосходить 60.
2075
  * Выводится ровно указанное количество цифр. Если число мало и
2076
    может быть записано меньшим количеством цифр, оно дополняется
2077
    ведущими нулями; если число велико и не может быть записано
2078
    таким количеством цифр, "лишние" ведущие цифры обрезаются.
2079
  * Параметры шрифтов указаны в описании функции 4 (вывода текста).
2080
 
2081
======================================================================
2082
======= Функция 48, подфункция 0 - применить настройки экрана. =======
2083
======================================================================
2084
Параметры:
2085
  * eax = 48 - номер функции
2086
  * ebx = 0 - номер подфункции
2087
  * ecx = 0 - зарезервировано
2088
Возвращаемое значение:
2089
  * функция не возвращает значения
2090
Замечания:
2091
  * Функция перерисовывает экран после изменения параметров
2092
    подфункциями 1 и 2.
2093
  * Вызов функции без предшествующих вызовов указанных подфункций
2094
    игнорируется.
2095
  * Вызов функции с ненулевым ecx игнорируется.
2096
 
2097
======================================================================
2098
========= Функция 48, подфункция 1 - установить стиль кнопок. ========
2099
======================================================================
2100
Параметры:
2101
  * eax = 48 - номер функции
2102
  * ebx = 1 - номер подфункции
2103
  * ecx = тип кнопок:
2104
    * 0 = плоские
127 mario79 2105
    * 1 = объ+мные
77 diamond 2106
Возвращаемое значение:
2107
  * функция не возвращает значения
2108
Замечания:
2109
  * После вызова описываемой функции следует перерисовать экран
2110
    подфункцией 0.
2111
  * Тип кнопок влияет только на их прорисовку функцией 8.
2112
 
2113
======================================================================
2114
==== Функция 48, подфункция 2 - установить стандартные цвета окон. ===
2115
======================================================================
2116
Параметры:
2117
  * eax = 48 - номер функции
2118
  * ebx = 2 - номер подфункции
2119
  * ecx = указатель на таблицу цветов
2120
  * edx = размер таблицы цветов
2121
    (должен быть 40 байт для будущей совместимости)
2122
Формат таблицы цветов указан в описании подфункции 3.
2123
Возвращаемое значение:
2124
  * функция не возвращает значения
2125
Замечания:
2126
  * После вызова описываемой функции следует перерисовать экран
2127
    подфункцией 0.
2128
  * Таблица стандартных цветов влияет только на приложения,
2129
    которые эту таблицу явным образом получают (подфункцией 3) и
127 mario79 2130
    используют (указывая цвета из не+ при вызовах функций рисования).
77 diamond 2131
  * Таблица стандартных цветов входит в скин и устанавливается заново
2132
    при установке скина (подфункции 8).
2133
  * Таблицу цветов можно просматривать/изменять интерактивно с помощью
2134
    приложения desktop.
2135
 
2136
======================================================================
2137
===== Функция 48, подфункция 3 - получить стандартные цвета окон. ====
2138
======================================================================
2139
Параметры:
2140
  * eax = 48 - номер функции
2141
  * ebx = 3 - номер подфункции
2142
  * ecx = указатель на буфер размером edx байт,
2143
    куда будет записана таблица
2144
  * edx = размер таблицы цветов
2145
    (должен быть 40 байт для будущей совместимости)
2146
Возвращаемое значение:
2147
  * функция не возвращает значения
2148
Формат таблицы цветов: каждый элемент -
2149
dword-значение цвета 0x00RRGGBB
2150
  * +0: dword: frames - цвет рамки
2151
  * +4: dword: grab - цвет заголовка
2152
  * +8: dword: grab_button - цвет кнопки на полосе заголовка
2153
  * +12 = +0xC: dword: grab_button_text - цвет текста на кнопке
2154
    на полосе заголовка
2155
  * +16 = +0x10: dword: grab_text - цвет текста на заголовке
2156
  * +20 = +0x14: dword: work - цвет рабочей области
2157
  * +24 = +0x18: dword: work_button - цвет кнопки в рабочей области
2158
  * +28 = +0x1C: dword: work_button_text - цвет текста на кнопке
2159
    в рабочей области
2160
  * +32 = +0x20: dword: work_text - цвет текста в рабочей области
2161
  * +36 = +0x24: dword: work_graph - цвет графики в рабочей области
2162
Замечания:
2163
  * Структура таблицы цветов описана в стандартном включаемом файле
2164
    macros.inc под названием system_colors; например, можно писать:
120 mario79 2165
        sc    system_colors        ; объявление переменной
2166
        ...                ; где-то надо вызвать
2167
                        ; описываемую функцию с ecx=sc
2168
        mov    ecx, [sc.work_button_text]    ; читаем цвет текста
2169
                        ; на кнопке в рабочей области
77 diamond 2170
  * Использование/неиспользование этих цветов - дело исключительно
2171
    самой программы. Для использования нужно просто при вызове функций
2172
    рисования указывать цвет, взятый из этой таблицы.
2173
  * При изменении таблицы стандартных цветов (подфункцией 2 с
2174
    последующим применением изменений подфункцией 0 или
2175
    при установке скина подфункцией 8) всем окнам посылается сообщение
2176
    о необходимости перерисовки (событие с кодом 1).
2177
  * Стандартные цвета можно просматривать/изменять интерактивно
2178
    с помощью приложения desktop.
2179
 
2180
======================================================================
2181
========== Функция 48, подфункция 4 - получить высоту скина. =========
2182
======================================================================
2183
Параметры:
2184
  * eax = 48 - номер функции
2185
  * ebx = 4 - номер подфункции
2186
Возвращаемое значение:
2187
  * eax = высота скина
2188
Замечания:
2189
  * Высотой скина по определению считается высота заголовка окон,
2190
    использующих скин.
2191
  * Смотри также общую структуру окна в описании функции 0.
2192
 
2193
======================================================================
2194
===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
2195
======================================================================
2196
Параметры:
2197
  * eax = 48 - номер функции
2198
  * ebx = 5 - номер подфункции
2199
Возвращаемое значение:
2200
  * eax = [left]*65536 + [right]
2201
  * ebx = [top]*65536 + [bottom]
2202
Замечания:
2203
  * Рабочая область экрана определяет положение и координаты
2204
    максимизированного окна.
2205
  * Рабочая область экрана при нормальной работе есть весь экран
2206
    за вычетом панели (@panel).
2207
  * (left,top) - координаты левого верхнего угла,
2208
    (right,bottom) - координаты правого нижнего.
2209
    Таким образом, размер рабочей области по оси x определяется
2210
    формулой right-left+1, по оси y - формулой bottom-right+1.
2211
  * Смотри также функцию 14,
2212
    позволяющую определить размеры всего экрана.
2213
  * Есть парная функция установки рабочей области - подфункция 6.
2214
 
2215
======================================================================
2216
==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
2217
======================================================================
2218
Параметры:
2219
  * eax = 48 - номер функции
2220
  * ebx = 6 - номер подфункции
2221
  * ecx = [left]*65536 + [right]
2222
  * edx = [top]*65536 + [bottom]
2223
Возвращаемое значение:
2224
  * функция не возвращает значения
2225
Замечания:
2226
  * Рабочая область экрана определяет положение и координаты
2227
    максимизированного окна.
2228
  * Эта функция используется только приложением @panel,
2229
    устанавливающим рабочей областью весь экран за вычетом панели.
2230
  * (left,top) - координаты левого верхнего угла,
2231
    (right,bottom) - координаты правого нижнего.
2232
    Таким образом, размер рабочей области по оси x определяется
2233
    формулой right-left+1, по оси y - формулой bottom-right+1.
2234
  * Если left>=right, то x-координаты рабочей области не изменяются.
2235
    Если left<0, то left не устанавливается. Если right больше
2236
    или равно ширины экрана, то right не устанавливается.
2237
    Аналогично по оси y.
2238
  * Смотри также функцию 14,
2239
    позволяющую определить размеры всего экрана.
2240
  * Есть парная функция получения рабочей области -
2241
    подфункция 5.
2242
  * Эта функция автоматически перерисовывает экран, по ходу дела
118 diamond 2243
    обновляет координаты и размеры максимизированных окон.
77 diamond 2244
    Все окна извещаются о необходимости перерисовки (событие 1).
2245
 
2246
======================================================================
2247
====================== Функция 48, подфункция 7 ======================
2248
============ Получить область скина для текста заголовка. ============
2249
======================================================================
2250
Возвращает область заголовка окна со скином, предназначенную
2251
для вывода текста заголовка.
2252
Параметры:
2253
  * eax = 48 - номер функции
2254
  * ebx = 7 - номер подфункции
2255
Возвращаемое значение:
2256
  * eax = [left]*65536 + [right]
2257
  * ebx = [top]*65536 + [bottom]
2258
Замечания:
2259
  * Использование/неиспользование этой функции -
2260
    личное дело приложения.
2261
  * Рекомендуется учитывать значения, возвращаемые этой функцией,
2262
    при выборе места для рисования текста заголовка (функцией 4) или
2263
    какого-нибудь заменителя текста заголовка
2264
    (по усмотрению приложения).
2265
 
2266
======================================================================
2267
==== Функция 48, подфункция 8 - установить используемый скин окон. ===
2268
======================================================================
2269
Параметры:
2270
  * eax = 48 - номер функции
2271
  * ebx = 8 - номер подфункции
2272
  * ecx = указатель на блок для функции 58, в котором установлено
2273
    поле промежуточного буфера и указано имя файла
2274
Возвращаемое значение:
2275
  * eax = 0 - успешно
127 mario79 2276
  * иначе eax = код ошибки файловой системы; если файл не зада+т скин,
77 diamond 2277
    то возвращается ошибка 3 (неизвестная файловая система).
2278
Замечания:
2279
  * При успешной загрузке скина все окна извещаются о необходимости
2280
    перерисовки (событие 1).
2281
  * При загрузке система считывает скин из файла default.skn
2282
    на рамдиске.
2283
  * Пользователь может изменять скин статически, создав свой
2284
    default.skn, или динамически с помощью приложения desktop.
2285
 
2286
======================================================================
78 diamond 2287
============ Функция 49 - Advanced Power Management (APM). ===========
2288
======================================================================
2289
Параметры:
2290
  * eax = 49 - номер функции
2291
  * dx = номер функции APM (аналог ax в спецификации)
2292
  * bx, cx = параметры функции APM
2293
Возвращаемое значение:
2294
  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
2295
    установлены в соответствии со спецификацией APM
2296
  * старшие половины 32-битных регистров eax, ebx, ecx,
2297
    edx, esi, edi разрушаются
2298
Замечания:
2299
  * Спецификация APM 1.2 описывается в документе
2300
    "Advanced Power Management (APM) BIOS Specification"
2301
    (Revision 1.2), доступном на
2302
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2303
    кроме того, она включена в известный Interrupt List by Ralf Brown
2304
    (http://www.pobox.com/~ralf/files.html,
2305
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2306
 
2307
======================================================================
77 diamond 2308
================= Функция 50 - установка формы окна. =================
2309
======================================================================
2310
Обычные окна представляют собой прямоугольники. С помощью этой функции
127 mario79 2311
окну можно придать произвольную форму. Форма зада+тся набором точек
77 diamond 2312
внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
2313
размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
2314
функцией 67.
2315
 
2316
--------------- Установка данных с информацией о форме ---------------
2317
Параметры:
2318
  * eax = 50 - номер функции
2319
  * ebx = 0 - номер подфункции
2320
  * ecx = указатель на данные формы (массив байт 0/1)
2321
Возвращаемое значение:
2322
  * функция не возвращает значения
2323
 
2324
------------------ Установка масштаба данных формы -------------------
2325
Параметры:
2326
  * eax = 50 - номер функции
2327
  * ebx = 1 - номер подфункции
127 mario79 2328
  * ecx зада+т масштаб: каждый байт данных определяет
77 diamond 2329
    (2^scale)*(2^scale) пикселей
2330
Возвращаемое значение:
2331
  * функция не возвращает значения
2332
Замечания:
2333
  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
2334
    данных формы один байт соответствует одному пикселю, то масштаб
2335
    можно не устанавливать.
2336
  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
2337
    обратите внимание, что они на единицу больше, чем устанавливаемые
2338
    функциями 0, 67.
2339
  * По определению масштаба xsize и ysize должны делиться на 2^scale.
2340
  * Байт данных по смещению a должен быть 0/1 и
2341
    определяет принадлежность окну квадрата со стороной 2^scale
2342
    (при scale=0 получаем пиксель) и координатами левого верхнего угла
2343
    (a mod (xsize shr scale), a div (xsize shr scale))
2344
  * Размер данных: (xsize shr scale)*(ysize shr scale).
2345
  * Данные должны присутствовать в памяти и не меняться
2346
    после установки формы.
2347
  * Система просматривает данные о форме при каждой перерисовке окна
2348
    функцией 0.
2349
  * Вызов подфункции 0 с нулевым указателем приводит к возврату
2350
    к прямоугольной форме.
2351
 
2352
======================================================================
2353
===================== Функция 51 - создать поток. ====================
2354
======================================================================
2355
Параметры:
2356
  * eax = 51 - номер функции
2357
  * ebx = 1 - единственная подфункция
2358
  * ecx = адрес точки входа потока (начальный eip)
2359
  * edx = указатель стэка потока (начальный esp)
2360
Возвращаемое значение:
2361
  * eax = -1 - ошибка (в системе слишком много потоков)
2362
  * иначе eax = TID - идентификатор потока
2363
 
2364
======================================================================
2365
= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
2366
======================================================================
2367
Параметры:
2368
  * eax = 52 - номер функции
2369
  * ebx = 0 - номер подфункции
2370
Возвращаемое значение:
2371
  * eax = двойное слово конфигурации
2372
Замечания:
2373
  * Слово конфигурации можно установить подфункцией 2.
2374
  * Ядро не использует соответствующую переменную.
2375
    Ценность этой переменной и работающих с ней подфункций 0 и 2
2376
    представляется сомнительной.
2377
 
2378
======================================================================
2379
======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
2380
======================================================================
2381
Параметры:
2382
  * eax = 52 - номер функции
2383
  * ebx = 1 - номер подфункции
2384
Возвращаемое значение:
2385
  * eax = IP-адрес (4 байта)
2386
Замечания:
2387
  * Локальный IP-адрес устанавливается подфункцией 3.
2388
 
2389
======================================================================
2390
 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
2391
======================================================================
2392
Параметры:
2393
  * eax = 52 - номер функции
2394
  * ebx = 2 - номер подфункции
2395
  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
2396
    число 3, это воспринимается как запрос на [пере-]инициализацию
2397
    Ethernet-карты, в противном случае Ethernet выключается
2398
Возвращаемое значение:
2399
  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
2400
    но это может измениться в будущих версиях ядра
2401
  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
2402
    (отсутствие Ethernet-карты), а ненулевое значение - успех
2403
Замечания:
2404
  * Слово конфигурации можно прочитать подфункцией 0.
2405
  * Ядро не использует соответствующую переменную.
2406
    Ценность этой переменной, подфункции 0 и части подфункции 2,
2407
    устанавливающей эту переменную, представляется сомнительной.
2408
 
2409
======================================================================
2410
====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
2411
======================================================================
2412
Параметры:
2413
  * eax = 52 - номер функции
2414
  * ebx = 3 - номер подфункции
2415
  * ecx = IP-адрес (4 байта)
2416
Возвращаемое значение:
2417
  * текущая реализация возвращает eax=3, но это может быть изменено
2418
    в будущих версиях
2419
Замечания:
2420
  * Локальный IP-адрес можно получить подфункцией 1.
2421
 
2422
======================================================================
2423
= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
2424
======================================================================
2425
Параметры:
2426
  * eax = 52 - номер функции
2427
  * ebx = 6 - номер подфункции
2428
  * edx = размер данных
2429
  * esi = указатель на данные
2430
Возвращаемое значение:
2431
  * eax = -1 - ошибка
2432
  * eax = 0 - успешно
2433
Замечания:
2434
  * Эта функция предназначена только для медленных сетевых драйверов
2435
    (PPP, SLIP).
2436
  * Размер данных не должен превосходить 1500 байт,
2437
    хотя проверок корректности не делается.
2438
 
2439
======================================================================
2440
====================== Функция 52, подфункция 8 ======================
2441
============= Прочитать данные из сетевой очереди вывода. ============
2442
======================================================================
2443
Параметры:
2444
  * eax = 52 - номер функции
2445
  * ebx = 8 - номер подфункции
2446
  * esi = указатель на буфер размером 1500 байт
2447
Возвращаемое значение:
2448
  * eax = число прочитанных байт (в текущей реализации
2449
    либо 0 = нет данных, либо 1500)
2450
  * данные скопированы в буфер
2451
Замечания:
2452
  * Эта функция предназначена только для медленных сетевых драйверов
2453
    (PPP, SLIP).
2454
 
2455
======================================================================
2456
=========== Функция 52, подфункция 9 - получить gateway IP. ==========
2457
======================================================================
2458
Параметры:
2459
  * eax = 52 - номер функции
2460
  * ebx = 9 - номер подфункции
2461
Возвращаемое значение:
2462
  * eax = gateway IP (4 байта)
2463
 
2464
======================================================================
2465
========= Функция 52, подфункция 10 - получить маску подсети. ========
2466
======================================================================
2467
Параметры:
2468
  * eax = 52 - номер функции
2469
  * ebx = 10 - номер подфункции
2470
Возвращаемое значение:
2471
  * eax = маска подсети
2472
 
2473
======================================================================
2474
========= Функция 52, подфункция 11 - установить gateway IP. =========
2475
======================================================================
2476
Параметры:
2477
  * eax = 52 - номер функции
2478
  * ebx = 11 - номер подфункции
2479
  * ecx = gateway IP (4 байта)
2480
Возвращаемое значение:
2481
  * текущая реализация возвращает eax=11, но это может быть изменено
2482
    в будущих реализациях
2483
 
2484
======================================================================
2485
======== Функция 52, подфункция 12 - установить маску подсети. =======
2486
======================================================================
2487
Параметры:
2488
  * eax = 52 - номер функции
2489
  * ebx = 12 - номер подфункции
2490
  * ecx = маска подсети
2491
Возвращаемое значение:
2492
  * текущая реализация возвращает eax=12, но это может быть изменено
2493
    в будущих версиях
2494
 
2495
======================================================================
2496
============ Функция 52, подфункция 13 - получить DNS IP. ============
2497
======================================================================
2498
Параметры:
2499
  * eax = 52 - номер функции
2500
  * ebx = 13 - номер подфункции
2501
Возвращаемое значение:
2502
  * eax = DNS IP (4 байта)
2503
 
2504
======================================================================
2505
=========== Функция 52, подфункция 14 - установить DNS IP. ===========
2506
======================================================================
2507
Параметры:
2508
  * eax = 52 - номер функции
2509
  * ebx = 14 - номер подфункции
2510
  * ecx = DNS IP (4 байта)
2511
Возвращаемое значение:
2512
  * текущая реализация возвращает eax=14, но это может быть изменено
2513
    в следующих версиях
2514
 
2515
======================================================================
2516
============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========
2517
======================================================================
2518
Параметры:
2519
  * eax = 53 - номер функции
2520
  * ebx = 0 - номер подфункции
2521
  * ecx = локальный порт (учитывается только младшее слово)
127 mario79 2522
  * edx = удал+нный порт (учитывается только младшее слово)
2523
  * esi = удал+нный IP
77 diamond 2524
Возвращаемое значение:
2525
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2526
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2527
    сокет и имеющее смысл только для системы) - успешно;
2528
    ebx разрушается
2529
 
2530
======================================================================
2531
============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========
2532
======================================================================
2533
Параметры:
2534
  * eax = 53 - номер функции
2535
  * ebx = 1 - номер подфункции
2536
  * ecx = хэндл сокета
2537
Возвращаемое значение:
2538
  * eax = -1 - неверный хэндл
2539
  * eax = 0 - успешно
2540
  * ebx разрушается
2541
Замечания:
2542
  * Текущая реализация не закрывает автоматически все сокеты потока
2543
    при его завершении. В частности, не следует прибивать поток
2544
    с кучей открытых сокетов - будет утечка ресурсов.
2545
  * Текущая реализация не делает проверок на корректность
2546
    (единственное, на что возвращается ошибка, - попытка закрыть
2547
    неоткрытый сокет с корректным хэндлом).
2548
 
2549
======================================================================
2550
============== Функция 53, подфункция 2 - опрос сокета. ==============
2551
======================================================================
2552
Параметры:
2553
  * eax = 53 - номер функции
2554
  * ebx = 2 - номер подфункции
2555
  * ecx = хэндл сокета
2556
Возвращаемое значение:
2557
  * eax = число полученных байт
2558
  * ebx разрушается
2559
Замечания:
2560
  * Проверки корректности не делается.
2561
 
2562
======================================================================
2563
======== Функция 53, подфункция 3 - прочитать байт из сокета. ========
2564
======================================================================
2565
Параметры:
2566
  * eax = 53 - номер функции
2567
  * ebx = 3 - номер подфункции
2568
  * ecx = хэндл сокета
2569
Возвращаемое значение:
2570
  * если нет принятых данных: eax=0, bl=0,
118 diamond 2571
    прочие байты ebx разрушаются
77 diamond 2572
  * если были принятые данные: eax=число оставшихся байт
118 diamond 2573
    (возможно, 0), bl=прочитанный байт, прочие байты ebx разрушаются
77 diamond 2574
Замечания:
2575
  * Проверки корректности не производится.
2576
 
2577
======================================================================
2578
========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========
2579
======================================================================
2580
Параметры:
2581
  * eax = 53 - номер функции
2582
  * ebx = 4 - номер подфункции
2583
  * ecx = хэндл сокета
2584
  * edx = число байт для записи
2585
  * esi = указатель на данные для записи
2586
Возвращаемое значение:
2587
  * eax = 0xffffffff - неверный хэндл
2588
  * eax = 0xffff - недостаточно памяти
2589
  * eax = 0 - успешно
2590
  * ebx разрушается
2591
Замечания:
114 mikedld 2592
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2593
    не очень неправильные неоткрытые хэндлы.
2594
  * Число байт для записи не может превышать 1500-28, хотя
2595
    соответствующей проверки не делается.
2596
 
2597
======================================================================
2598
============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========
2599
======================================================================
2600
Параметры:
2601
  * eax = 53 - номер функции
2602
  * ebx = 5 - номер подфункции
2603
  * ecx = локальный порт (учитывается только младшее слово)
127 mario79 2604
  * edx = удал+нный порт (учитывается только младшее слово)
2605
  * esi = удал+нный IP
77 diamond 2606
  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1
2607
Возвращаемое значение:
2608
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2609
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2610
    сокет и имеющее смысл только для системы) - успешно;
2611
    ebx разрушается
2612
 
2613
======================================================================
2614
====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
2615
======================================================================
2616
Параметры:
2617
  * eax = 53 - номер функции
2618
  * ebx = 6 - номер подфункции
2619
  * ecx = хэндл сокета
2620
Возвращаемое значение:
2621
  * eax = статус сокета: одно из
2622
  * TCB_LISTEN = 1
2623
  * TCB_SYN_SENT = 2
2624
  * TCB_SYN_RECEIVED = 3
2625
  * TCB_ESTABLISHED = 4
2626
  * TCB_FIN_WAIT_1 = 5
2627
  * TCB_FIN_WAIT_2 = 6
2628
  * TCB_CLOSE_WAIT = 7
2629
  * TCB_CLOSING = 8
2630
  * TCB_LAST_ASK = 9
2631
  * TCB_TIME_WAIT = 10
2632
  * TCB_CLOSED = 11
2633
  * ebx разрушается
2634
Замечания:
2635
  * Проверок корректности не производится.
2636
 
2637
======================================================================
2638
========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
2639
======================================================================
2640
Параметры:
2641
  * eax = 53 - номер функции
2642
  * ebx = 7 - номер подфункции
2643
  * ecx = хэндл сокета
2644
  * edx = число байт для записи
2645
  * esi = указатель на данные для записи
2646
Возвращаемое значение:
2647
  * eax = 0xffffffff - ошибка
2648
  * eax = 0xffff - недостаточно памяти
2649
  * eax = 0 - успешно
2650
  * ebx разрушается
2651
Замечания:
114 mikedld 2652
  * Проверка на правильность хэндла минимальна - исключаются только
77 diamond 2653
    не очень неправильные неоткрытые хэндлы.
2654
  * Число байт для записи не может превышать 1500-40,
2655
    хотя соответствующей проверки не делается.
2656
 
2657
======================================================================
2658
============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========
2659
======================================================================
2660
Параметры:
2661
  * eax = 53 - номер функции
2662
  * ebx = 8 - номер подфункции
2663
  * ecx = хэндл сокета
2664
Возвращаемое значение:
2665
  * eax = -1 - неверный хэндл
2666
  * eax = 0xffff - недостаточно памяти для пакета закрытия сокета
2667
  * eax = 0 - успешно
2668
  * во многих случаях eax разрушается (возвращается результат функции
2669
    queue) - видимо, это баг, который будет исправлен
2670
  * ebx разрушается
2671
Замечания:
2672
  * Текущая реализация не закрывает автоматически все сокеты потока
2673
    при его завершении. В частности, не следует прибивать поток
2674
    с кучей открытых сокетов - будет утечка ресурсов.
2675
  * Текущая реализация не делает проверок на корректность
2676
    (единственное, на что возвращается ошибка, - попытка закрыть
2677
    неоткрытый сокет с корректным хэндлом).
2678
 
2679
======================================================================
2680
== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =
2681
======================================================================
2682
Параметры:
2683
  * eax = 53 - номер функции
2684
  * ebx = 9 - номер подфункции
2685
  * ecx = номер локального порта (используются только младшие 16 бит)
2686
Возвращаемое значение:
2687
  * eax = 0 - порт используется
2688
  * eax = 1 - порт свободен
2689
  * ebx разрушается
2690
 
2691
======================================================================
2692
 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.
2693
======================================================================
2694
Параметры:
2695
  * eax = 53 - номер функции
2696
  * ebx = 255 - номер подфункции
2697
  * ecx = тип запрашиваемой информации (смотри ниже)
2698
Возвращаемое значение:
2699
  * eax = запрошенная информация
2700
  * ebx разрушается
2701
Возможные значения ecx:
2702
  * 100: длина очереди 0 (empty queue)
2703
  * 101: длина очереди 1 (ip-out queue)
2704
  * 102: длина очереди 2 (ip-in queue)
2705
  * 103: длина очереди 3 (net1out queue)
2706
  * 200: число элементов в таблице ARP
2707
  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)
2708
  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда
2709
    берут информацию 5 последующих типов;
127 mario79 2710
    в этом случае eax неопредел+н
77 diamond 2711
  * 203: IP-адрес, запомненный типом 202
2712
  * 204: старшее dword MAC-адреса, запомненного типом 202
2713
  * 205: младшее word MAC-адреса, запомненного типом 202
2714
  * 206: слово статуса, запомненное типом 202
2715
  * 207: слово ttl, запомненное типом 202
2716
  * 2: общее число полученных IP-пакетов
2717
  * 3: общее число переданных IP-пакетов
2718
  * 4: общее число сдампленных полученных пакетов
2719
  * 5: общее число полученных ARP-пакетов
2720
  * 6: статус драйвера пакетов, 0=неактивен,
2721
    ненулевое значение=активен
2722
 
2723
======================================================================
2724
======== Функция 55, подфункция 0 - загрузить данные для SB16. =======
2725
======================================================================
2726
Параметры:
2727
  * eax = 55 - номер функции
2728
  * ebx = 0 - номер подфункции
2729
  * ecx = указатель на данные (копируется 64 килобайта, используется
2730
    столько, сколько установлено подфункцией 2)
2731
Возвращаемое значение:
2732
  * функция не возвращает значения
2733
Замечания:
2734
  * Формат и размер данных устанавливаются подфункцией 2.
2735
 
2736
======================================================================
2737
==== Функция 55, подфункция 1 - начать проигрывать данные на SB16. ===
2738
======================================================================
2739
Параметры:
2740
  * eax = 55 - номер функции
2741
  * ebx = 1 - номер подфункции
2742
Возвращаемое значение:
2743
  * функция не возвращает значения
2744
Замечания:
2745
  * Предварительно данные должны быть загружены подфункцией 0 и
127 mario79 2746
    определ+н их формат подфункцией 2.
77 diamond 2747
  * Функция возвращает управление, когда началось проигрывание данных;
127 mario79 2748
    после этого проигрывание ид+т независимо от приложения (и вообще
77 diamond 2749
    не требует загрузки процессора).
2750
  * Предварительно должны быть определены базовый порт SB16
2751
    (подфункцией 4 функции 21) и канал DMA
2752
    (подфункцией 10 функции 21).
2753
 
2754
======================================================================
2755
====== Функция 55, подфункция 2 - установить формат данных SB16. =====
2756
======================================================================
2757
Параметры:
2758
  * eax = 55 - номер функции
2759
  * ebx = 2 - номер подфункции
2760
  * ecx = 0 - установить разрядность
2761
    * edx = 1 - 8бит моно
2762
    * edx = 2 - 8бит стерео
2763
  * ecx = 1 - установить размер данных
2764
    * edx = размер в байтах
2765
  * ecx = 2 - установить частоту проигрывания
2766
    * edx = частота
2767
Возвращаемое значение:
2768
  * функция не возвращает значения
2769
Замечания:
2770
  * При загрузке системы устанавливаются следующие параметры
2771
    по умолчанию: разрядность - 8 бит моно, размер - 64 Кб,
2772
    частота 44100 Гц. Тем не менее рекомендуется явно устанавливать
2773
    необходимые значения, поскольку они могли быть переустановлены
2774
    какой-нибудь программой.
2775
 
2776
======================================================================
2777
====================== Функция 55, подфункция 55 =====================
2778
========== Начать проигрывать данные на встроенном спикере. ==========
2779
======================================================================
2780
Параметры:
2781
  * eax = 55 - номер функции
2782
  * ebx = 55 - номер подфункции
2783
  * esi = указатель на данные
2784
Возвращаемое значение:
2785
  * eax = 0 - успешно
127 mario79 2786
  * eax = 55 - ошибка (спикер отключ+н или занят)
77 diamond 2787
Данные - это массив элементов переменной длины.
2788
Формат каждого элемента определяется первым байтом:
2789
  * 0 = конец данных
127 mario79 2790
  * 1..0x80 = зада+т длительность звучания в сотых долях секунды
77 diamond 2791
    ноты, определяемой непосредственным значением частоты
2792
    * следующее слово (2 байта) содержит делитель частоты;
2793
      частота определяется как 1193180/divider
2794
  * 0x81 = invalid
2795
  * 0x82..0xFF = нота, определяемая октавой и номером:
2796
    * длительность в сотых долях секунды = (первый байт)-0x81
127 mario79 2797
    * присутствует ещ+ один байт;
77 diamond 2798
    * (второй байт)=0xFF - пауза
2799
    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
2800
      до 12, a=номер октавы (считая с 0)
2801
Замечания:
2802
  * Пищание спикером может быть запрещено/разрешено подфункцией 8
2803
    функции 18.
2804
  * Функция возвращает управление, сообщив куда следует информацию
127 mario79 2805
    о запросе. Само проигрывание ид+т независимо от программы.
77 diamond 2806
  * Данные должны сохраняться в памяти по крайней мере
2807
    до конца проигрывания.
2808
 
2809
======================================================================
127 mario79 2810
============= Функция 56 - записать файл на ж+сткий диск. ============
77 diamond 2811
======================================================================
2812
Параметры:
2813
  * eax = 56 - номер функции
2814
  * ebx = указатель на имя файла
2815
  * ecx = размер данных для записи (в байтах)
2816
  * edx = указатель на данные для записи
2817
  * esi = указатель на путь (ASCIIZ-строку)
2818
Возвращаемое значение:
2819
  * eax = 0 - успешно, иначе код ошибки файловой системы
2820
Замечания:
83 diamond 2821
  * Эта функция устарела; функция 70 позволяет выполнять
77 diamond 2822
    те же действия с расширенными возможностями.
127 mario79 2823
  * Данная функция предполагает, что во время е+ вызова одним
77 diamond 2824
    приложением никакое другое приложение не работает
127 mario79 2825
    с ж+стким диском.
77 diamond 2826
  * Путь к файлу - ASCIIZ-строка, которая может быть пустой
127 mario79 2827
    (если файл созда+тся в корневом каталоге) или иметь формат
77 diamond 2828
    /d1/d2/.../dn, где все имена папок должны иметь формат 8+3, т.е.
2829
    8 символов имени и 3 символа расширения без разделителя,
2830
    при необходимости дополненные пробелами;
2831
    все буквы должны быть заглавные.
2832
  * Имя к файлу также должно иметь формат 8+3.
2833
 
2834
======================================================================
2835
============== Функция 58 - работа с файловой системой. ==============
2836
======================================================================
2837
Параметры:
2838
  * eax = 58
2839
  * ebx = указатель на информационную структуру
2840
Возвращаемое значение:
2841
  * eax = 0 - успешно; иначе код ошибки файловой системы
2842
  * в зависимости от подфункции может возвращаться значение и
2843
    в других регистрах
2844
Общий формат информационной структуры:
2845
  * +0: dword: номер подфункции
2846
  * +4: dword: номер блока
2847
  * +8: dword: размер
2848
  * +12 = +0xC: dword: указатель на данные
2849
  * +16 = +0x10: dword: указатель на память для работы системы
2850
    (4096 байт)
2851
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
2852
Уточнения - в документации на соответствующую подфункцию.
2853
Имя файла нечувствительно к регистру латинских букв,
2854
русские буквы должны быть заглавными.
2855
Формат имени файла:
2856
/base/number/dir1/dir2/.../dirn/file,
2857
где /base/number идентифицирует устройство, на котором ищется файл:
2858
одно из
2859
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
2860
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
2861
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
127 mario79 2862
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к ж+сткому диску
77 diamond 2863
    (в этом случае база определяется подфункцией 7 функции 21),
2864
    x - номер раздела (считая с 1)
2865
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
2866
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
2867
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2868
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
2869
    (на каждом из винчестеров нумерация начинается с 1)
2870
Замечания:
2871
  * В первых двух случаях допускается использование FIRST вместо 1,
2872
    SECOND вместо 2, но использовать эту возможность
2873
    не рекомендуется для удобства перехода на будущие расширения.
2874
  * Накладывается ограничение n<=39.
2875
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
2876
    имя не более 8 символов, точка, расширение не более 3 символов.
2877
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
2878
    Если имя занимает ровно 8 символов, точку можно опустить
2879
    (хотя пользоваться этим не рекомендуется для удобства перехода
2880
    на будущие расширения).
118 diamond 2881
  * Функция не поддерживает папок на рамдиске.
77 diamond 2882
Примеры:
2883
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2884
    '/rd/1/kernel.asm',0
2885
  * '/HD0/1/kernel.asm',0
2886
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2887
Доступные подфункции:
2888
  * подфункция 0 - чтение файла/папки
2889
  * подфункция 1 - перезапись файла
2890
  * подфункция 2 - удаление файла/папки
2891
  * подфункция 3 - запись данных в существующий файл
2892
  * подфункция 4 - создание папки
2893
  * подфункция 5 - переименование/перемещение файла/папки
2894
  * подфункция 8 - LBA-чтение с устройства
2895
  * подфункция 15 - получение информации о файловой системе
2896
  * подфункция 16 - запуск приложения
2897
 
2898
======================================================================
2899
========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
2900
======================================================================
2901
Параметры:
2902
  * eax = 58
2903
  * ebx = указатель на информационную структуру
2904
Формат информационной структуры:
2905
  * +0: dword: 0 = номер подфункции
2906
  * +4: dword: номер блока для чтения (считая с 0)
2907
  * +8: dword: число блоков для чтения
2908
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2909
  * +16 = +0x10: dword: указатель на буфер для работы системы
2910
    (4096 байт)
127 mario79 2911
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 2912
    общем описании
2913
Возвращаемое значение:
2914
  * eax = 0 - успешно, иначе код ошибки файловой системы
2915
  * ebx = размер файла (в байтах) или
2916
    -1=0xffffffff, если файл не найден
2917
Замечания:
2918
  * Размер блока - 512 байт.
2919
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
2920
    функции 70, для чтения папок - подфункцию 1 функции 70.
2921
  * Функция позволяет читать содержимое папки. Из файловых систем
2922
    поддерживается только FAT. Формат FAT-папки описан в любой
2923
    документации по FAT.
2924
  * Размер папки определяется по размеру цепочки кластеров в FAT.
2925
  * Если файл кончился раньше, чем был прочитан последний запрошенный
127 mario79 2926
    блок, то функция прочитает, сколько сможет, после чего верн+т
77 diamond 2927
    eax=6 (EOF).
2928
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
2929
    в первых двух случаях текущая реализация не следует
2930
    установленным правилам:
2931
    для /rd/1:
2932
    * если указано 0 блоков для чтения, считается,
2933
      что запрашивается 1;
2934
    * если запрашивается больше 14 блоков или начальный блок
2935
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
2936
    * размер корневого каталога рамдиска = 14 блоков,
2937
      0x1C00=7168 байт; но возвращается ebx=0
2938
      (за исключением случая предыдущего пункта);
2939
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
127 mario79 2940
      мусор - напоминаю, сч+т вед+тся с 0);
77 diamond 2941
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
2942
      то возвращается eax=6(EOF); иначе eax=0.
2943
    Для /fd/x:
2944
    * если начальный блок не меньше 14-го, то возвращается
2945
      eax=5 (not found) и ebx=0;
2946
    * кстати говоря, формат FAT12 допускает дискеты с размером
2947
      корневого каталога меньше или больше 14 блоков;
2948
    * проверки длины не делается;
2949
    * если удалось прочитать данные с дискеты, возвращается
2950
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
2951
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
2952
    но результат не соответствует ожидаемому
2953
    (по работе с обычными файлами/папками), не следует установленным
2954
    правилам, может измениться в следующих версиях ядра и потому
2955
    не описывается. Для получения информации об оборудовании
2956
    используйте подфункцию 11 функции 18 или
2957
    читайте соответствующие папки подфункцией 1 функции 70.
2958
 
2959
======================================================================
2960
============ Функция 58, подфункция 1 - перезаписать файл. ===========
2961
======================================================================
127 mario79 2962
Если файл не существует, он созда+тся.
77 diamond 2963
Если файл существует, он перезаписывается.
2964
Параметры:
2965
  * eax = 58 - номер функции
2966
  * ebx = указатель на информационную структуру
2967
Формат информационной структуры:
2968
  * +0: dword: 1 = номер подфункции
2969
  * +4: dword: игнорируется (устанавливайте в 0)
2970
  * +8: dword: число байт для записи
2971
  * +12 = +0xC: dword: указатель на данные для записи
2972
  * +16 = +0x10: dword: указатель на буфер для работы системы
2973
    (4096 байт)
127 mario79 2974
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 2975
    общем описании
2976
Возвращаемое значение:
2977
  * eax = 0 - успешно, иначе код ошибки файловой системы
2978
  * ebx разрушается
83 diamond 2979
Замечания:
2980
  * Эта функция устарела, используйте подфункцию 2 функции 70.
77 diamond 2981
 
2982
======================================================================
2983
=========== Функция 58, подфункция 2 - удалить файл/папку. ===========
2984
======================================================================
2985
Параметры:
2986
  * eax = 58 - номер функции
2987
  * ebx = указатель на информационную структуру
2988
Формат информационной структуры:
2989
  * +0: dword: 2 = номер подфункции
2990
  * +4: dword: игнорируется
2991
  * +8: dword: игнорируется
2992
  * +12 = +0xC: dword: игнорируется
2993
  * +16 = +0x10: dword: указатель на буфер для работы системы
2994
    (4096 байт)
127 mario79 2995
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 2996
    общем описании
2997
Возвращаемое значение:
2998
  * eax = 0 - успешно, иначе код ошибки файловой системы
2999
  * ebx разрушается
3000
Замечания:
3001
  * При работе с дискетой не следует удалять непустую папку.
127 mario79 3002
    Код работы с ж+стким диском непустые папки удаляет корректно
77 diamond 3003
    (т.е. рекурсивно со всеми файлами и вложенными папками).
3004
    Рамдиск папок не поддерживает.
3005
 
3006
======================================================================
3007
==== Функция 58, подфункция 3 - запись данных в существующий файл. ===
3008
======================================================================
3009
Параметры:
3010
  * eax = 58 - номер функции
3011
  * ebx = указатель на информационную структуру
3012
Формат информационной структуры:
3013
  * +0: dword: 3 = номер подфункции
3014
  * +4: dword: начальная позиция в файле; -1 = дописывать в конец
3015
  * +8: dword: число байт для записи
3016
  * +12 = +0xC: dword: указатель на данные для записи
3017
  * +16 = +0x10: dword: указатель на буфер для работы системы
3018
    (4096 байт)
127 mario79 3019
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 3020
    общем описании
3021
Возвращаемое значение:
3022
  * eax = 0 - успешно, иначе код ошибки файловой системы
3023
  * ebx разрушается
3024
Замечания:
3025
  * Рамдиск и дискеты не поддерживают эту функцию, она только для
127 mario79 3026
    ж+стких дисков.
77 diamond 3027
  * Файл должен уже существовать (иначе возвращается 5, not found).
3028
    Для создания файлов используйте подфункцию 1.
3029
  * Если начальная позиция больше размера файла, возвращается
3030
    eax=6(EOF). Если конечная позиция больше размера файла,
3031
    файл расширяется.
127 mario79 3032
  * Код обработки записи данных для ж+сткого диска интерпретирует
77 diamond 3033
    нулевое значение поля +8 как указание усечения файла до размера,
3034
    указанного в поле +4. Однако код обработки 58-й функции блокирует
3035
    эту возможность для приложений, сразу возвращая управление
3036
    (с eax=0) в случае нулевого размера.
3037
 
3038
======================================================================
3039
============== Функция 58, подфункция 4 - создать папку. =============
3040
======================================================================
3041
Параметры:
3042
  * eax = 58 - номер функции
3043
  * ebx = указатель на информационную структуру
3044
Формат информационной структуры:
3045
  * +0: dword: 4 = номер подфункции
3046
  * +4: dword: игнорируется
3047
  * +8: dword: игнорируется
3048
  * +12 = +0xC: dword: игнорируется
3049
  * +16 = +0x10: dword: указатель на буфер для работы системы
3050
    (4096 байт)
127 mario79 3051
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 3052
    общем описании
3053
Возвращаемое значение:
3054
  * eax = 0 - успешно, иначе код ошибки файловой системы
3055
  * ebx разрушается
3056
Замечания:
3057
  * Рамдиск и дискеты не поддерживают эту функцию,
127 mario79 3058
    она только для ж+стких дисков.
77 diamond 3059
 
3060
======================================================================
3061
== Функция 58, подфункция 5 - переименовать/переместить файл/папку. ==
3062
======================================================================
3063
Параметры:
3064
  * eax = 58 - номер функции
3065
  * ebx = указатель на информационную структуру
3066
Формат информационной структуры:
3067
  * +0: dword: 5 = номер подфункции
3068
  * +4: dword: игнорируется
3069
  * +8: dword: игнорируется
3070
  * +12 = +0xC: dword: игнорируется
3071
  * +16 = +0x10: dword: указатель на буфер для работы системы
3072
    (4096 байт)
127 mario79 3073
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 3074
    общем описании
3075
  * +20+n: (сразу после завершающего нулевого символа) новое
3076
    ASCIIZ-имя, должно начинаться с /hd/1, что интерпретируется как
127 mario79 3077
    ж+сткий диск, указанный в первом имени
77 diamond 3078
    (перемещение с одного диска на другой не поддерживается)
3079
Возвращаемое значение:
3080
  * eax = 0 - успешно, иначе код ошибки файловой системы
3081
  * ebx разрушается
3082
Замечания:
3083
  * Рамдиск и дискеты не поддерживают эту функцию,
127 mario79 3084
    она только для ж+стких дисков.
77 diamond 3085
  * Если новое ASCIIZ-имя сильно неправильное, т.е. не начинается с
3086
    /hd/1, /hd/first, /harddisk/1, /harddisk/first или после этого
127 mario79 3087
    начала ид+т пробел или символ с кодом 0, то функция возвращает,
77 diamond 3088
    как ни странно, код ошибки 4. Это единственная функция, которая
3089
    вообще возвращает этот код.
3090
 
3091
======================================================================
3092
========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
3093
======================================================================
3094
Параметры:
3095
  * eax = 58 - номер функции
3096
  * ebx = указатель на информационную структуру
3097
Формат информационной структуры:
3098
  * +0: dword: 8 = номер подфункции
3099
  * +4: dword: номер блока для чтения (считая с 0)
3100
  * +8: dword: игнорируется (устанавливайте в 1)
3101
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
3102
    (512 байт)
3103
  * +16 = +0x10: dword: указатель на буфер для работы системы
3104
    (4096 байт)
3105
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
3106
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
3107
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
3108
    Вместо цифр допускается, хотя и не рекомендуется для удобства
3109
    перехода на будущие расширения,
3110
    использование 'first','second','third','fourth'.
3111
Возвращаемое значение:
3112
  * если указано имя устройства /hd/xxx, где xxx не находится
3113
    в списке выше:
3114
    * eax = ebx = 1
3115
  * если указано неправильное имя устройства
3116
    (за исключением предыдущего случая):
3117
    * eax = 5
3118
    * ebx не меняется
127 mario79 3119
  * если LBA-доступ запрещ+н подфункцией 11 функции 21:
77 diamond 3120
    * eax = 2
3121
    * ebx разрушается
3122
  * для рамдиска: попытка чтения блока за пределами рамдиска
3123
    (18*2*80 блоков) приводит к
3124
    * eax = 3
3125
    * ebx = 0
3126
  * при успешном чтении:
3127
    * eax = ebx = 0
3128
Замечания:
3129
  * Размер блока - 512 байт; читается один блок.
3130
  * Не следует полагаться на возвращаемое значение,
3131
    оно может измениться в следующих версиях.
127 mario79 3132
  * Требуется, чтобы был разреш+н LBA-доступ к устройствам
77 diamond 3133
    подфункцией 11 функции 21. Узнать это можно вызовом
3134
    подфункцией 11 функции 26.
3135
  * LBA-чтение дискеты не поддерживается.
127 mario79 3136
  * Функция считывает данные физического ж+сткого диска;
77 diamond 3137
    если по каким-то причинам нужны данные конкретного раздела,
127 mario79 3138
    прид+тся определять начальный сектор этого раздела
77 diamond 3139
    (либо напрямую через MBR, либо из расширенной структуры,
3140
    возвращаемой той же подфункцией 11 функции 18).
127 mario79 3141
  * Функция не проверяет код ошибки ж+сткого диска, так что запрос
3142
    несуществующего сектора вс+ равно что-то прочитает
77 diamond 3143
    (вероятнее всего, нули, но это определяется устройством) и
3144
    это будет считаться успехом (eax=0).
3145
 
3146
======================================================================
3147
= Функция 58, подфункция 15 - получить информацию о файловой системе.
3148
======================================================================
3149
Параметры:
3150
  * eax = 58 - номер функции
3151
  * ebx = указатель на информационную структуру
3152
Формат информационной структуры:
118 diamond 3153
  * +0: dword: 15 = номер подфункции
77 diamond 3154
  * +4: dword: игнорируется
3155
  * +8: dword: игнорируется
3156
  * +12 = +0xC: dword: игнорируется
3157
  * +16 = +0x10: dword: игнорируется
3158
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
3159
    /rd=/RAMDISK или /hd=/HARDDISK
3160
Возвращаемое значение:
3161
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
3162
    * eax = 3
3163
    * ebx = ecx = dword [fileinfo] = 0
3164
  * для рамдиска:
3165
    * eax = 0 (успех)
3166
    * ebx = общее число кластеров = 2847
3167
    * ecx = число свободных кластеров
3168
    * dword [fileinfo] = размер кластера = 512
127 mario79 3169
  * для ж+сткого диска: база и раздел определяются подфункциями 7 и 8
77 diamond 3170
    функции 21:
3171
    * eax = 0 (успех)
3172
    * ebx = общее число кластеров
3173
    * ecx = число свободных кластеров
3174
    * dword [fileinfo] = размер кластера (в байтах)
3175
Замечания:
3176
  * Не удивляйтесь странному расположению 4-го возвращаемого
3177
    параметра - когда писался этот код, при системных вызовах
3178
    приложению возвращались только регистры eax,ebx,ecx (из
3179
    pushad-структуры, передающейся как аргумент системной функции).
3180
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
3181
    размер кластера в edx, пока эту функцию не начали использовать.
127 mario79 3182
  * Вообще-то ещ+ существует подфункция 11 функции 18, возвращающая
77 diamond 3183
    информацию о файловой системе. По расширенной таблице дисковой
3184
    подсистемы можно определить размер кластера (там он хранится
127 mario79 3185
    в секторах) и общее число кластеров для ж+стких дисков.
77 diamond 3186
 
3187
======================================================================
3188
========== Функция 58, подфункция 16 - запустить программу. ==========
3189
======================================================================
3190
Параметры:
3191
  * eax = 58 - номер функции
3192
  * ebx = указатель на информационную структуру
3193
Формат информационной структуры:
3194
  * +0: dword: 16 = номер подфункции
3195
  * +4: dword: поле флагов:
3196
    * бит 0: запустить процесс как отлаживаемый
3197
    * остальные биты зарезервированы и должны быть установлены в 0
3198
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
3199
  * +12 = +0xC: dword: игнорируется
3200
  * +16 = +0x10: dword: указатель на буфер для работы системы
3201
    (4096 байт)
127 mario79 3202
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 3203
    общем описании
3204
Возвращаемое значение:
3205
  * eax > 0 - программа загружена, eax содержит PID
3206
  * eax < 0 - произошла ошибка, -eax содержит
3207
    код ошибки файловой системы
3208
Замечания:
91 diamond 3209
  * Эта функция устарела, используйте подфункцию 7 функции 70.
118 diamond 3210
  * Комадная строка должна заканчиваться символом с кодом 0
77 diamond 3211
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
3212
    включительно, либо первые 256 символов, в зависимости от того,
3213
    что меньше.
127 mario79 3214
  * Если процесс запускается как отлаживаемый, он созда+тся
77 diamond 3215
    в замороженном состоянии; для запуска используйте
3216
    подфункцию 5 функции 69.
3217
 
3218
======================================================================
92 diamond 3219
=== Функция 59 - получить информацию о последних системных вызовах. ==
3220
======================================================================
3221
Получает данные о всех системных вызовах всех процессов.
3222
Параметры:
3223
  * eax = 59 - номер функции
3224
  * ebx = 0 - единственная подфункция
3225
  * ecx = указатель на буфер
3226
  * edx = размер буфера
3227
Возвращаемое значение:
3228
  * eax = общее число системных вызовов,
3229
    сделанных с момента загрузки системы (по модулю 2^32)
3230
  * ebx = 0
3231
Формат информации об одном вызове: (размер = 0x40 = 64 байта)
3232
  * +0: dword: PID процесса/потока
3233
  * +4: 7*dword: мусор
3234
  * +32 = +0x20: dword: значение edi при вызове
3235
  * +36 = +0x24: dword: esi
3236
  * +40 = +0x28: dword: ebp
3237
  * +44 = +0x2C: dword: указатель стэка обработчика ядра
3238
  * +48 = +0x30: dword: ebx
3239
  * +52 = +0x34: dword: edx
3240
  * +56 = +0x38: dword: ecx
3241
  * +60 = +0x3C: dword: eax (=номер системной функции)
3242
Замечания:
3243
  * Функция используется только в приложении systrace.
3244
    Довольно трудно представить ситуацию, в которой это приложение
3245
    или эта функция действительно полезны, а вот все системные вызовы
3246
    для поддержки этой функции несколько замедляются
3247
    (хотя и ненамного)...
3248
  * В связи с этим есть предложение поддержку этой функции
3249
    из ядра убрать совсем, вместе с приложением systrace.
3250
  * Информация о системных вызовах сохраняется в
3251
    системном кольцевом буфере на 0x10 входов.
127 mario79 3252
    Эта функция просто копирует указанный объ+м данных
92 diamond 3253
    из упомянутого буфера по указанному адресу.
3254
  * Какой из входов в буфере соответствует последнему вызову,
3255
    можно определить по значению eax, а именно,
3256
    вход (eax and 0xF) (по смещению (eax and 0xF)*0x40).
3257
  * В текущей реализации возможны редко встречающиеся
3258
    проблемы рассинхронизации, когда о некоторых вызовах
3259
    информация устаревает.
3260
  * Под системный буфер выделена страница, 4Кб.
3261
    Размер входа = 64 байта.
3262
    Почему используется только 16 входов - непонятно.
3263
  * Значение esp в момент системного вызова
3264
    этой функцией узнать нельзя.
3265
  * Проверки корректности edx в текущей реализации не делается.
3266
 
3267
======================================================================
77 diamond 3268
=========== Функция 60 - Inter Process Communication (IPC). ==========
3269
======================================================================
3270
IPC применяется для посылок сообщений от одного процесса/потока
3271
другому. При этом следует предварительно договориться о том, как
3272
интерпретировать конкретное сообщение.
3273
 
3274
-------- Подфункция 1 - установить область для получения IPC ---------
127 mario79 3275
Вызывается процессом-при+мником.
77 diamond 3276
Параметры:
3277
  * eax = 60 - номер функции
3278
  * ebx = 1 - номер подфункции
3279
  * ecx = указатель на буфер
3280
  * edx = размер буфера
3281
Возвращаемое значение:
3282
  * eax = 0 - всегда успешно
3283
Формат IPC-буфера:
3284
  * +0: dword: если здесь не 0, то буфер считается заблокированным;
3285
    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
3286
    и вам надо, чтобы извне не изменялись данные буфера
3287
    (не поступали новые сообщения)
3288
  * +4: dword: занято места в буфере (в байтах)
3289
  * +8: первое сообщение
3290
  * +8+n: второе сообщение
3291
  * ...
3292
Формат сообщения:
3293
  * +0: dword: PID процесса/потока, пославшего сообщение
3294
  * +4: dword: длина сообщения (не считая этот заголовок)
3295
  * +8: n*byte: данные сообщения
3296
 
3297
--------------- Подфункция 2 - послать сообщение IPC. ----------------
3298
Вызывается процессом-инициатором.
3299
Параметры:
3300
  * eax = 60 - номер функции
3301
  * ebx = 2 - номер подфункции
127 mario79 3302
  * ecx = PID при+мника
77 diamond 3303
  * edx = указатель на данные сообщения
3304
  * esi = длина сообщения (в байтах)
3305
Возвращаемое значение:
3306
  * eax = 0 - успешно
127 mario79 3307
  * eax = 1 - при+мник не определил буфер для IPC-сообщений
3308
    (может быть, ещ+ не успел, а может быть, это не тот поток,
77 diamond 3309
    который нужен)
127 mario79 3310
  * eax = 2 - при+мник заблокировал IPC-буфер;
77 diamond 3311
    попробуйте немного подождать
127 mario79 3312
  * eax = 3 - переполнение IPC-буфера при+мника
77 diamond 3313
  * eax = 4 - процесса/потока с таким PID не существует
3314
Замечания:
3315
  * Система сразу после записи IPC-сообщения в буфер посылает
127 mario79 3316
    потоку-при+мнику событие с кодом 7 (см. коды событий).
77 diamond 3317
 
3318
======================================================================
3319
=== Функция 61 - получить параметры для прямого доступа к графике. ===
3320
======================================================================
3321
Программе доступны данные графического экрана (область памяти, которая
3322
собственно и отображает содержимое экрана) напрямую без вызовов
3323
системных функций через селектор gs:
120 mario79 3324
    mov    eax, [gs:0]
77 diamond 3325
поместит в eax первый dword буфера, содержащий информацию о цвете
3326
левой верхней точки (и, возможно, цвета нескольких следующих).
120 mario79 3327
    mov    [gs:0], eax
77 diamond 3328
при работе в режимах VESA c LFB
3329
установит цвет левой верхней точки
3330
(и возможно, цвета нескольких следующих).
3331
Для интерпретации данных графического экрана требуется знание
3332
некоторых параметров, которые возвращаются этой функцией.
3333
Замечания:
3334
  * Параметры графики очень редко меняются при работе системы,
3335
    а именно, только в случаях, когда пользователь работает
3336
    с программой VRR.
3337
  * При изменении видеорежима система перерисовывает все окна
3338
    (событие с кодом 1) и перерисовывает фон (событие 5).
3339
    Эти же события происходят и в других случаях,
3340
    которые встречаются значительно чаще, чем изменение видеорежима.
3341
  * При работе в видеорежимах с LFB селектор gs указывает на
3342
    собственно LFB, так что чтение/запись по gs приводят
3343
    непосредственно к изменению содержимого экрана. При работе в
3344
    видеорежимах без LFB gs указывает на некоторую область данных
127 mario79 3345
    ядра, прич+м все функции вывода на экран добросовестно выполняют
77 diamond 3346
    двойную работу по записи непосредственно на экран и по записи
3347
    в этот буфер. В результате при чтении содержимого этого буфера
3348
    результаты соответствуют содержимому экрана
3349
    (с, вообще говоря, большим цветовым разрешением),
3350
    а запись игнорируется.
3351
    Исключением является режим 320*200, для которого в главном цикле
3352
    системного потока выполняется обновление экрана в соответствии
3353
    с движениями курсора мыши.
3354
 
3355
------------------------- Разрешение экрана --------------------------
3356
Параметры:
3357
  * eax = 61 - номер функции
3358
  * ebx = 1 - номер подфункции
3359
Возвращаемое значение:
3360
  * eax = [разрешение по оси x]*65536 + [разрешение по оси y]
3361
Замечания:
127 mario79 3362
  * Можно использовать функцию 14 с уч+том того, что она возвращает
77 diamond 3363
    размеры на 1 меньше. Это полностью эквивалентный способ.
3364
 
3365
------------------------ Число бит на пиксель ------------------------
3366
Параметры:
3367
  * eax = 61 - номер функции
3368
  * ebx = 2 - номер подфункции
3369
Возвращаемое значение:
3370
  * eax = число бит на пиксель (24 или 32)
3371
 
3372
------------------------ Число байт на строку ------------------------
3373
Параметры:
3374
  * eax = 61 - номер функции
3375
  * ebx = 3 - номер подфункции
3376
Возвращаемое значение:
127 mario79 3377
  * eax = число байт, которое занимает одна строка разв+ртки
77 diamond 3378
    (горизонтальная линия на экране)
3379
 
3380
======================================================================
3381
===== Функция 62, подфункция 0 - получить версию PCI-интерфейса. =====
3382
======================================================================
3383
Параметры:
3384
  * eax = 62 - номер функции
3385
  * bl = 0 - номер подфункции
3386
Возвращаемое значение:
127 mario79 3387
  * eax = -1 - доступ к PCI запрещ+н; иначе
77 diamond 3388
  * ah.al = версия PCI-интерфейса (ah=версия, al=подверсия)
3389
  * старшее слово eax обнулено
3390
Замечания:
127 mario79 3391
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3392
    для приложений подфункцией 12 функции 21.
118 diamond 3393
  * Если PCI BIOS не поддерживается, то значение ax неопределено.
77 diamond 3394
 
3395
======================================================================
3396
==== Функция 62, подфункция 1 - получить номер последней PCI-шины. ===
3397
======================================================================
3398
Параметры:
3399
  * eax = 62 - номер функции
3400
  * bl = 1 - номер подфункции
3401
Возвращаемое значение:
127 mario79 3402
  * eax = -1 - доступ к PCI запрещ+н; иначе
118 diamond 3403
  * al = номер последней PCI-шины; оставшиеся байты eax разрушаются
77 diamond 3404
Замечания:
127 mario79 3405
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3406
    для приложений подфункцией 12 функции 21.
118 diamond 3407
  * Если PCI BIOS не поддерживается, то значение al неопределено.
77 diamond 3408
 
3409
======================================================================
3410
====================== Функция 62, подфункция 2 ======================
3411
== Получить механизм обращения к конфигурационному пространству PCI. =
3412
======================================================================
3413
Параметры:
3414
  * eax = 62 - номер функции
3415
  * bl = 2 - номер подфункции
3416
Возвращаемое значение:
127 mario79 3417
  * eax = -1 - доступ к PCI запрещ+н; иначе
118 diamond 3418
  * al = механизм (1 или 2); прочие байты eax разрушаются
77 diamond 3419
Замечания:
127 mario79 3420
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3421
    для приложений подфункцией 12 функции 21.
3422
  * Механизм обращения выбирается в соответствии
3423
    с характеристиками оборудования.
3424
  * Подфункции чтения и записи автоматически работают
3425
    с выбранным механизмом.
3426
 
3427
======================================================================
3428
======== Функция 62, подфункции 4,5,6 - прочитать PCI-регистр. =======
3429
======================================================================
3430
Параметры:
3431
  * eax = 62 - номер функции
3432
  * bl = 4 - читать байт
3433
  * bl = 5 - читать слово
3434
  * bl = 6 - читать двойное слово
3435
  * bh = номер PCI-шины
3436
  * ch = dddddfff, где ddddd = номер устройства на шине,
3437
    fff = номер функции устройства
127 mario79 3438
  * cl = номер регистра (должен быть ч+тным для bl=5,
77 diamond 3439
    делиться на 4 для bl=6)
3440
Возвращаемое значение:
127 mario79 3441
  * eax = -1 - ошибка (запрещ+н доступ к PCI или
77 diamond 3442
    неподдерживаемые параметры); иначе
3443
  * al/ax/eax (в зависимости от запрошенного размера) содержит данные;
3444
    оставшаяся часть регистра eax разрушается
3445
Замечания:
127 mario79 3446
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3447
    для приложений подфункцией 12 функции 21.
3448
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3449
    игнорирует номер функции. Получить механизм доступа можно вызовом
3450
    подфункции 2.
3451
  * Некоторые регистры стандартны и существуют для всех устройств,
3452
    некоторые определяются конкретным устройством. Список первых
3453
    входит, например, в известный Interrupt List by Ralf Brown
3454
    (http://www.pobox.com/~ralf/files.html,
3455
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3456
    список вторых должен быть указан в документации по устройству.
3457
 
3458
======================================================================
3459
======= Функция 62, подфункции 8,9,10 - записать в PCI-регистр. ======
3460
======================================================================
3461
Параметры:
3462
  * eax = 62 - номер функции
3463
  * bl = 8 - писать байт
3464
  * bl = 9 - писать слово
3465
  * bl = 10 - писать двойное слово
3466
  * bh = номер PCI-шины
3467
  * ch = dddddfff, где ddddd = номер устройства на шине,
3468
    fff = номер функции устройства
127 mario79 3469
  * cl = номер регистра (должен быть ч+тным для bl=9,
77 diamond 3470
    делиться на 4 для bl=10)
92 diamond 3471
  * dl/dx/edx (в зависимости от запрошенного размера) содержит
3472
    данные для записи
77 diamond 3473
Возвращаемое значение:
127 mario79 3474
  * eax = -1 - ошибка (запрещ+н доступ к PCI или
77 diamond 3475
    неподдерживаемые параметры)
3476
  * eax = 0 - успешно
3477
Замечания:
127 mario79 3478
  * Предварительно должен быть разреш+н низкоуровневый доступ к PCI
77 diamond 3479
    для приложений подфункцией 12 функции 21.
3480
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3481
    игнорирует номер функции. Получить механизм доступа можно вызовом
3482
    подфункции 2.
3483
  * Некоторые регистры стандартны и существуют для всех устройств,
3484
    некоторые определяются конкретным устройством. Список первых
3485
    входит, например, в известный Interrupt List by Ralf Brown;
3486
    список вторых должен быть указан в документации по устройству.
3487
 
3488
======================================================================
3489
================ Функция 63 - работа с доской отладки. ===============
3490
======================================================================
3491
Доска отладки представляет собой системный буфер (на 512 байт),
3492
в который любая программа может записать (вообще говоря, произвольные)
3493
данные и из которого другая программа может эти данные прочитать.
3494
Есть соглашение, в соответствии с которым записываемые данные -
3495
текстовые строки, интерпретируемые как отладочные сообщения о ходе
127 mario79 3496
выполнения программы. Ядро в определ+нных ситуациях также записывает
77 diamond 3497
на доску отладки сведения о выполнении некоторых функций;
3498
по соглашению сообщения ядра начинаются с префикса "K : ".
3499
Для просмотра доски отладки создано приложение board,
127 mario79 3500
которое считывает данные из буфера и отображает их в сво+м окне. board
77 diamond 3501
понимает последовательность кодов 13,10 как переход на новую строку.
3502
Символ с нулевым кодом в конце строки не обязателен, но и не мешает.
3503
В связи с появлением отладчика ценность доски отладки несколько
3504
снизилась, поскольку отладчик позволяет полностью контролировать ход
127 mario79 3505
выполнения программы, прич+м для этого не требуется никаких усилий
77 diamond 3506
со стороны самой программы. Тем не менее во многих случаях
3507
доска отладки продолжает оставаться полезной.
3508
 
3509
---------------------------- Запись байта ----------------------------
3510
Параметры:
3511
  * eax = 63 - номер функции
3512
  * ebx = 1 - номер подфункции
3513
  * cl = байт данных
3514
Возвращаемое значение:
3515
  * функция не возвращает значения
3516
Замечания:
3517
  * Байт записывается в буфер. Длина буфера - 512 байт.
3518
    При переполнении буфера все полученные данные теряются
3519
    и заполнение начинается снова с нуля.
3520
  * Для вывода на доску отладки более сложных объектов (строк, чисел)
3521
    достаточно этой функции, вызываемой в цикле. Можно не писать
3522
    вручную соответствующий код, а воспользоваться файлом debug.inc,
3523
    входящим в дистрибутив.
3524
 
3525
---------------------------- Чтение байта ----------------------------
3526
Забирает байт из буфера.
3527
Параметры:
3528
  * eax = 63 - номер функции
3529
  * ebx = 2 - номер подфункции
3530
Возвращаемое значение:
3531
  * eax = ebx = 0 - буфер пуст
3532
  * eax = байт, ebx = 1 - байт успешно прочитан
3533
 
3534
======================================================================
3535
========== Функция 64 - перераспределить память приложения. ==========
3536
======================================================================
3537
Параметры:
3538
  * eax = 64 - номер функции
3539
  * ebx = 1 - единственная подфункция
3540
  * ecx = новый размер памяти
3541
Возвращаемое значение:
3542
  * eax = 0 - успешно
3543
  * eax = 1 - недостаточно памяти
3544
Замечания:
3545
  * На данный момент эта функция является единственным средством для
3546
    динамического выделения/освобождения памяти приложения.
3547
 
3548
======================================================================
92 diamond 3549
================= Функция 66 - работа с клавиатурой. =================
77 diamond 3550
======================================================================
92 diamond 3551
Режим ввода влияет на результаты чтения клавиш функцией 2.
127 mario79 3552
При загрузке программы для не+ устанавливается ASCII-режим ввода.
77 diamond 3553
 
92 diamond 3554
-------- Подфункция 1 - установить режим ввода с клавиатуры. ---------
77 diamond 3555
Параметры:
3556
  * eax = 66 - номер функции
3557
  * ebx = 1 - номер подфункции
3558
  * ecx = режим:
3559
    * 0 = обычный (ASCII-символы)
3560
    * 1 = сканкоды
3561
Возвращаемое значение:
3562
  * функция не возвращает значения
3563
 
92 diamond 3564
--------- Подфункция 2 - получить режим ввода с клавиатуры. ----------
77 diamond 3565
Параметры:
3566
  * eax = 66 - номер функции
3567
  * ebx = 2 - номер подфункции
3568
Возвращаемое значение:
3569
  * eax = текущий режим
3570
 
3571
------- Подфункция 3 - получить состояние управляющих клавиш. --------
3572
Параметры:
3573
  * eax = 66 - номер функции
3574
  * ebx = 3 - номер подфункции
3575
Возвращаемое значение:
3576
  * eax = битовая маска:
3577
  * бит 0 (маска 1): левый Shift нажат
3578
  * бит 1 (маска 2): правый Shift нажат
3579
  * бит 2 (маска 4): левый Ctrl нажат
3580
  * бит 3 (маска 8): правый Ctrl нажат
3581
  * бит 4 (маска 0x10): левый Alt нажат
3582
  * бит 5 (маска 0x20): правый Alt нажат
127 mario79 3583
  * бит 6 (маска 0x40): CapsLock включ+н
3584
  * бит 7 (маска 0x80): NumLock включ+н
3585
  * бит 8 (маска 0x100): ScrollLock включ+н
77 diamond 3586
  * прочие биты сброшены
3587
 
92 diamond 3588
----- Подфункция 4 - установить общесистемную "горячую клавишу". -----
3589
О нажатии "горячей клавиши" извещаются только приложения,
127 mario79 3590
установившие е+; активное приложение (к которому поступает
92 diamond 3591
весь нормальный ввод) таких клавиш не получает.
3592
Извещение заключается в посылке события с кодом 2.
3593
Прочитать "горячую клавишу" можно так же, как и обычную, -
3594
функцией 2.
3595
Параметры:
3596
  * eax = 66 - номер функции
3597
  * ebx = 4 - номер подфункции
127 mario79 3598
  * cl зада+т сканкод клавиши;
92 diamond 3599
    используйте cl=0 для задания комбинаций типа Ctrl+Shift
127 mario79 3600
  * edx = 0xXYZ зада+т возможные состояния управляющих клавиш:
3601
    * Z (младшие 4 бита) зада+т состояние клавиш LShift и RShift:
92 diamond 3602
      * 0 = ни одна из клавиш не должна быть нажата;
3603
      * 1 = ровно одна из клавиш должна быть нажата;
3604
      * 2 = обе клавиши должны быть нажаты;
3605
      * 3 = должна быть нажата LShift, но не RShift;
3606
      * 4 = должна быть нажата RShift, но не LShift
3607
    * Y - аналогично для LCtrl и RCtrl;
3608
    * X - аналогично для LAlt и RAlt
3609
Возвращаемое значение:
3610
  * eax=0 - успешно
3611
  * eax=1 - слишком много "горячих клавиш" (допускается максимум 256)
3612
Замечания:
3613
  * Горячая клавиша может срабатывать либо при нажатии,
3614
    либо при отпускании. Сканкод отпускания клавиши на 128 больше,
3615
    чем сканкод нажатия (т.е. установлен старший бит).
3616
  * Несколько приложений могут установить одну и ту же комбинацию;
3617
    о нажатии такой комбинации будут извещаться все такие приложения.
3618
 
3619
------ Подфункция 5 - удалить установленную "горячую клавишу". -------
3620
Параметры:
3621
  * eax = 66 - номер функции
3622
  * ebx = 5 - номер подфункции
3623
  * cl = сканкод клавиши и edx = 0xXYZ такие же, как и в подфункции 4
3624
Возвращаемое значение:
3625
  * eax = 0 - успешно
3626
  * eax = 1 - нет такой горячей клавиши
3627
Замечания:
3628
  * При завершении процесса/потока удаляются все установленные им
3629
    горячие клавиши.
3630
  * Вызов функции не влияет на другие приложения.
3631
    Если другое приложение определило эту же комбинацию,
3632
    оно по-прежнему будет получать уведомления.
3633
 
77 diamond 3634
======================================================================
3635
============ Функция 67 - изменить положение/размеры окна. ===========
3636
======================================================================
3637
Параметры:
3638
  * eax = 67 - номер функции
3639
  * ebx = новая x-координата окна
3640
  * ecx = новая y-координата окна
3641
  * edx = новый x-размер окна
3642
  * esi = новый y-размер окна
3643
Возвращаемое значение:
3644
  * функция не возвращает значения
3645
Замечания:
3646
  * Значение -1 для параметра означает "не изменять"; например, для
3647
    перемещения окна без изменения размеров можно указать edx=esi=-1.
3648
  * Предварительно окно должно быть определено функцией 0.
127 mario79 3649
    Она же зада+т начальные координаты и размеры окна.
77 diamond 3650
  * Размеры окна понимаются в смысле функции 0, т.е.
3651
    на один пиксель меньше, чем реальные размеры.
3652
  * Вызов функции для максимизированных окон просто игнорируется.
3653
  * Для окон соответствующих стилей положение и/или размеры могут быть
3654
    изменены пользователем; текущие положение и размеры могут быть
3655
    получены вызовом функции 9.
3656
  * Функция посылает окну событие перерисовки (с кодом 1).
3657
 
3658
======================================================================
127 mario79 3659
=== Функция 68, подфункция 0 - получить сч+тчик переключений задач. ==
77 diamond 3660
======================================================================
3661
Параметры:
3662
  * eax = 68 - номер функции
3663
  * ebx = 0 - номер подфункции
3664
Возвращаемое значение:
3665
  * eax = число переключений задач с момента загрузки системы
3666
    (по модулю 2^32)
3667
 
3668
======================================================================
3669
====================== Функция 68, подфункция 1 ======================
3670
============ Переключиться на следующий поток выполнения. ============
3671
======================================================================
3672
Функция завершает текущий квант времени, выделенный потоку,
3673
и переключается на следующий.
3674
(Какой поток какого процесса будет следующим, предсказать нельзя).
127 mario79 3675
Позднее, когда до текущего потока дойд+т очередь,
77 diamond 3676
выполнение возобновится.
3677
Параметры:
3678
  * eax = 68 - номер функции
3679
  * ebx = 1 - номер подфункции
3680
Возвращаемое значение:
3681
  * функция не возвращает значения
3682
 
3683
======================================================================
3684
=============== Функция 68, подфункция 2 - кэш + rdpmc. ==============
3685
======================================================================
3686
Параметры:
3687
  * eax = 68 - номер функции
3688
  * ebx = 2 - номер подфункции
3689
  * ecx = требуемое действие:
3690
    * ecx = 0 - разрешить выполнение инструкции rdpmc
3691
      (ReaD Performance-Monitoring Counters)
127 mario79 3692
    * ecx = 1 - узнать, включ+н/выключен кэш
77 diamond 3693
    * ecx = 2 - включить кэш
3694
    * ecx = 3 - выключить кэш
3695
Возвращаемое значение:
3696
  * для ecx=0:
3697
    * eax = значение cr4
3698
  * для ecx=1:
3699
    * eax = (cr0 and 0x60000000):
127 mario79 3700
    * eax = 0 - кэш включ+н
77 diamond 3701
    * eax <> 0 - кэш выключен
3702
  * для ecx=2 и ecx=3:
3703
    * функция не возвращает значения
3704
 
3705
======================================================================
3706
========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
3707
======================================================================
3708
MSR = Model Specific Register; полный список MSR-регистров процессора
3709
содержится в документации по процессору (например, IA-32 Intel
3710
Architecture Software Developer's Manual, Volume 3, Appendix B);
127 mario79 3711
каждое семейство процессоров имеет сво+ подмножество MSR-регистров.
77 diamond 3712
Параметры:
3713
  * eax = 68 - номер функции
3714
  * ebx = 3 - номер подфункции
3715
  * ecx игнорируется
3716
  * edx = адрес MSR
3717
Возвращаемое значение:
3718
  * ebx:eax = старший:младший dword результата
3719
Замечания:
3720
  * Указание в ecx несуществующего или нереализованного для данного
127 mario79 3721
    процессора MSR повлеч+т исключение в ядре, которое прибь+т поток.
77 diamond 3722
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3723
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
127 mario79 3724
    которое вс+ равно прибь+т поток.
77 diamond 3725
 
3726
======================================================================
3727
========= Функция 68, подфункция 4 - записать в MSR-регистр. =========
3728
======================================================================
3729
MSR = Model Specific Register; полный список MSR-регистров процессора
3730
содержится в документации по процессору (например, IA-32 Intel
3731
Architecture Software Developer's Manual, Volume 3, Appendix B);
127 mario79 3732
каждое семейство процессоров имеет сво+ подмножество MSR-регистров.
77 diamond 3733
Параметры:
3734
  * eax = 68 - номер функции
3735
  * ebx = 4 - номер подфункции
3736
  * ecx игнорируется
3737
  * edx = адрес MSR
3738
  * esi:edi = старший:младший dword
3739
Возвращаемое значение:
3740
  * ebx:eax = копия esi:edi
3741
Замечания:
3742
  * Указание в ecx несуществующего или нереализованного для данного
127 mario79 3743
    процессора MSR повлеч+т исключение в ядре, которое прибь+т поток.
77 diamond 3744
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3745
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
127 mario79 3746
    которое вс+ равно прибь+т поток.
77 diamond 3747
 
3748
======================================================================
3749
======= Функция 68, подфункция 5 - выделить физическую память. =======
3750
======================================================================
3751
Параметры:
3752
  * eax = 68 - номер функции
3753
  * ebx = 5 - номер подфункции
3754
  * ecx = размер (в байтах)
3755
Возвращаемое значение:
3756
  * eax = физический адрес выделенной памяти
3757
Замечания:
3758
  * Обычные приложения не должны использовать эту функцию, она
3759
    предназначена для случая, когда при работе с каким-либо
3760
    устройством требуется разместить данные по известному физическому
3761
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3762
  * Число блоков физической памяти ограничено (константой 24,
127 mario79 3763
    прич+м эта константа включает и несколько блоков памяти
77 diamond 3764
    для надобностей ядра).
3765
  * Освободить выделенную таким образом память можно
3766
    подфункцией 6, копированием данных туда/обратно
3767
    занимаются подфункции 7 и 8.
3768
 
3769
======================================================================
3770
====== Функция 68, подфункция 6 - освободить физическую память. ======
3771
======================================================================
3772
Параметры:
3773
  * eax = 68 - номер функции
3774
  * ebx = 6 - номер подфункции
3775
  * ecx = физический адрес памяти
3776
Возвращаемое значение:
3777
  * функция не возвращает значения
3778
Замечания:
3779
  * Обычные приложения не должны использовать эту функцию, она
3780
    предназначена для случая, когда при работе с каким-либо
3781
    устройством требуется разместить данные по известному физическому
3782
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3783
  * Память должна быть ранее выделена подфункцией 5.
3784
 
3785
======================================================================
3786
=== Функция 68, подфункция 7 - записать данные в физическую память. ==
3787
======================================================================
3788
Параметры:
3789
  * eax = 68 - номер функции
3790
  * ebx = 7 - номер подфункции
3791
  * ecx = физический адрес
3792
  * edx = указатель на данные (в приложении)
3793
  * esi = размер данных (в байтах)
3794
Возвращаемое значение:
3795
  * функция не возвращает значения
3796
Замечания:
3797
  * Обычные приложения не должны использовать эту функцию, она
3798
    предназначена для случая, когда при работе с каким-либо
3799
    устройством требуется разместить данные по известному физическому
3800
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3801
  * Диапазон физических адресов должен лежать внутри ранее выделенного
3802
    подфункцией 5 блока физической памяти.
3803
  * Проверок корректности не производится.
3804
 
3805
======================================================================
3806
== Функция 68, подфункция 8 - прочитать данные из физической памяти. =
3807
======================================================================
3808
Параметры:
3809
  * eax = 68 - номер функции
3810
  * ebx = 8 - номер подфункции
3811
  * ecx = физический адрес
3812
  * edx = указатель на буфер для данных (в приложении)
3813
  * esi = размер данных (в байтах)
3814
Возвращаемое значение:
3815
  * функция не возвращает значения
3816
Замечания:
3817
  * Обычные приложения не должны использовать эту функцию, она
3818
    предназначена для случая, когда при работе с каким-либо
3819
    устройством требуется разместить данные по известному физическому
3820
    адресу. (В сущности, эта функция разрабатывалась для AC97WAV.)
3821
  * Диапазон физических адресов должен лежать внутри ранее выделенного
3822
    подфункцией 5 блока физической памяти.
3823
  * Проверок корректности не производится.
3824
 
3825
======================================================================
3826
======================== Функция 69 - отладка. =======================
3827
======================================================================
3828
Процесс может загрузить другой процесс как отлаживаемый установкой
118 diamond 3829
соответствующего бита при вызове подфункции 16 функции 58
3830
или подфункции 7 функции 70.
77 diamond 3831
У процесса может быть только один отладчик; один процесс может
3832
отлаживать несколько разных. Система уведомляет отладчик о событиях,
3833
происходящих с отлаживаемым процессом. Сообщения записываются в буфер,
127 mario79 3834
определ+нный подфункцией 0.
77 diamond 3835
Формат сообщения:
3836
  * +0: dword: код сообщения
3837
  * +4: dword: PID отлаживаемого процесса
3838
  * +8: могут присутствовать дополнительные данные,
3839
    определяемые кодом сообщения
3840
Коды сообщений:
3841
  * 1 = исключение
127 mario79 3842
    * дополнительно переда+тся dword-номер исключения
77 diamond 3843
    * процесс приостановлен
3844
  * 2 = процесс завершился
3845
    * приходит при любом завершении: как через системную функцию -1,
3846
      так и при "убийстве" любым другим процессом
3847
      (в том числе самим отладчиком)
3848
  * 3 = отладочное исключение int 1 = #DB
127 mario79 3849
    * дополнительно переда+тся dword-образ регистра DR6:
77 diamond 3850
      * биты 0-3: выполнено условие соответствующей точки останова
3851
        (установленной подфункцией 9)
3852
      * бит 14: исключение произошло из-за режима
3853
        пошаговой трассировки (установлен флаг TF)
3854
    * процесс приостановлен
3855
При завершении отладчика прибиваются все отлаживаемые процессы.
3856
Если отладчик этого не хочет, он должен предварительно отключиться
3857
подфункцией 3.
3858
 
3859
Все подфункции применимы только к процессам/потокам, запущенным
118 diamond 3860
из текущего функцией 58 или 70 с установленным флагом отладки.
77 diamond 3861
Отладка многопоточных программ пока не поддерживается.
3862
Полный список подфункций:
3863
  * подфункция 0 - определить область данных для отладочных сообщений
3864
  * подфункция 1 - получить состояние регистров отлаживаемого потока
3865
  * подфункция 2 - установить состояние регистров отлаживаемого потока
3866
  * подфункция 3 - отключиться от отлаживаемого процесса
3867
  * подфункция 4 - приостановить отлаживаемый поток
3868
  * подфункция 5 - возобновить выполнение отлаживаемого потока
3869
  * подфункция 6 - прочитать из памяти отлаживаемого процесса
3870
  * подфункция 7 - записать в память отлаживаемого процесса
3871
  * подфункция 8 - завершить отлаживаемый поток
3872
  * подфункция 9 - установить/снять аппаратную точку останова
3873
 
3874
======================================================================
3875
====================== Функция 69, подфункция 0 ======================
3876
========= Определить область данных для отладочных сообщений. ========
3877
======================================================================
3878
Параметры:
3879
  * eax = 69 - номер функции
3880
  * ebx = 0 - номер подфункции
3881
  * ecx = указатель
3882
Формат области данных:
3883
  * +0: dword: N = размер буфера (не считая этого заголовка)
3884
  * +4: dword: занято в буфере
3885
  * +8: N*byte: буфер
3886
Возвращаемое значение:
3887
  * функция не возвращает значения
3888
Замечания:
3889
  * Если поле размера отрицательно, буфер считается заблокированным
3890
    и при поступлении нового сообщения система будет ждать.
3891
    Для синхронизации обрамляйте всю работу с буфером операциями
3892
    блокировки/разблокировки
120 mario79 3893
        neg    [bufsize]
77 diamond 3894
  * Данные в буфере трактуются как массив элементов переменной длины -
3895
    сообщений. Формат сообщения указан в общем описании.
3896
 
3897
======================================================================
3898
====================== Функция 69, подфункция 1 ======================
3899
========= Получить состояние регистров отлаживаемого потока. =========
3900
======================================================================
3901
Параметры:
3902
  * eax = 69 - номер функции
3903
  * ebx = 1 - номер подфункции
3904
  * ecx = идентификатор потока
3905
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3906
  * esi = указатель на структуру контекста
77 diamond 3907
Возвращаемое значение:
3908
  * функция не возвращает значения
3909
Формат структуры контекста: (FPU пока не поддерживается)
3910
  * +0: dword: eip
3911
  * +4: dword: eflags
3912
  * +8: dword: eax
3913
  * +12 = +0xC: dword: ecx
3914
  * +16 = +0x10: dword: edx
3915
  * +20 = +0x14: dword: ebx
3916
  * +24 = +0x18: dword: esp
3917
  * +28 = +0x1C: dword: ebp
3918
  * +32 = +0x20: dword: esi
3919
  * +36 = +0x24: dword: edi
3920
Замечания:
3921
  * Если поток выполняет код 0-кольца, возвращается
3922
    состояние регистров 3-кольца.
3923
  * Процесс должен быть загружен для отладки (как указано в
3924
    общем описании).
3925
 
3926
======================================================================
3927
====================== Функция 69, подфункция 2 ======================
3928
======== Установить состояние регистров отлаживаемого потока. ========
3929
======================================================================
3930
Параметры:
3931
  * eax = 69 - номер функции
3932
  * ebx = 2 - номер подфункции
3933
  * ecx = идентификатор потока
3934
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3935
  * esi = указатель на структуру контекста
77 diamond 3936
Возвращаемое значение:
3937
  * функция не возвращает значения
3938
Формат структуры контекста указан в описании подфункции 1.
3939
Замечания:
3940
  * Если поток выполняет код 0-кольца, устанавливается
3941
    состояние регистров 3-кольца.
3942
  * Процесс должен быть загружен для отладки (как указано в
3943
    общем описании).
3944
 
3945
======================================================================
3946
== Функция 69, подфункция 3 - отключиться от отлаживаемого процесса. =
3947
======================================================================
3948
Параметры:
3949
  * eax = 69 - номер функции
3950
  * ebx = 3 - номер подфункции
3951
  * ecx = идентификатор
3952
Возвращаемое значение:
3953
  * функция не возвращает значения
3954
Замечания:
3955
  * Если процесс был приостановлен, он возобновляет выполнение.
3956
 
3957
======================================================================
3958
==== Функция 69, подфункция 4 - приостановить отлаживаемый поток. ====
3959
======================================================================
3960
Параметры:
3961
  * eax = 69 - номер процесса
3962
  * ebx = 4 - номер подфункции
3963
  * ecx = идентификатор
3964
Возвращаемое значение:
3965
  * функция не возвращает значения
3966
Замечания:
3967
  * Процесс должен быть загружен для отладки (как указано в
3968
    общем описании).
3969
 
3970
======================================================================
3971
====================== Функция 69, подфункция 5 ======================
3972
============ Возобновить выполнение отлаживаемого потока. ============
3973
======================================================================
3974
Параметры:
3975
  * eax = 69 - номер функции
3976
  * ebx = 5 - номер подфункции
3977
  * ecx = идентификатор
3978
Возвращаемое значение:
3979
  * функция не возвращает значения
3980
Замечания:
3981
  * Процесс должен быть загружен для отладки (как указано в
3982
    общем описании).
3983
 
3984
======================================================================
3985
====================== Функция 69, подфункция 6 ======================
3986
============= Прочитать из памяти отлаживаемого процесса. ============
3987
======================================================================
3988
Параметры:
3989
  * eax = 69 - номер функции
3990
  * ebx = 6 - номер подфункции
3991
  * ecx = идентификатор
3992
  * edx = сколько байт читать
3993
  * esi = адрес памяти отлаживаемого процесса
3994
  * edi = указатель на буфер для данных
3995
Возвращаемое значение:
3996
  * eax = -1 при ошибке (неверный PID или буфер)
3997
  * иначе eax = число прочитанных байт (возможно, 0,
3998
    если в esi слишком большое значение)
3999
Замечания:
4000
  * Процесс должен быть загружен для отладки (как указано в
4001
    общем описании).
4002
 
4003
======================================================================
4004
 Функция 69, подфункция 7 - записать в память отлаживаемого процесса.
4005
======================================================================
4006
Параметры:
4007
  * eax = 69 - номер функции
4008
  * ebx = 7 - номер подфункции
4009
  * ecx = идентификатор
4010
  * edx = сколько байт писать
4011
  * esi = адрес памяти в отлаживаемом процессе
4012
  * edi = указатель на данные
4013
Возвращаемое значение:
4014
  * eax = -1 при ошибке (неверный PID или буфер)
4015
  * иначе eax = число записанных байт (возможно, 0,
4016
    если в esi слишком большое значение)
4017
Замечания:
4018
  * Процесс должен быть загружен для отладки (как указано в
4019
    общем описании).
4020
 
4021
======================================================================
4022
====== Функция 69, подфункция 8 - завершить отлаживаемый поток. ======
4023
======================================================================
4024
Параметры:
4025
  * eax = 69 - номер функции
4026
  * ebx = 8 - номер подфункции
4027
  * ecx = идентификатор
4028
Возвращаемое значение:
4029
  * функция не возвращает значения
4030
Замечания:
4031
  * Процесс должен быть загружен для отладки (как указано в
4032
    общем описании).
4033
  * Функция аналогична подфункции 2 функции 18 с двумя отличиями:
4034
    требуется выполнение первого замечания и принимается PID,
4035
    а не номер слота.
4036
 
4037
======================================================================
4038
====================== Функция 69, подфункция 9 ======================
4039
============= Установить/снять аппаратную точку останова. ============
4040
======================================================================
4041
Параметры:
4042
  * eax = 69 - номер функции
4043
  * ebx = 9 - номер подфункции
4044
  * ecx = идентификатор потока
4045
  * dl = индекс точки останова, от 0 до 3 включительно
4046
  * dh = флаги:
4047
    * если старший бит сброшен - установить точку останова:
4048
      * биты 0-1 - условие:
4049
        * 00 = точка останова на выполнение
4050
        * 01 = точка останова на запись
4051
        * 11 = точка останова на чтение/запись
4052
      * биты 2-3 - длина; для точек останова на исполнение должно быть
4053
        00, в противном случае одно из
4054
        * 00 = байт
4055
        * 01 = слово
4056
        * 11 = двойное слово
4057
      * esi = адрес точки останова; должен быть выровнен
127 mario79 4058
        соответственно длине (т.е. должен быть ч+тным для
77 diamond 4059
        точек останова на слово, кратен 4 для двойного слова)
4060
    * если старший бит установлен - сбросить точку останова
4061
Возвращаемое значение:
4062
  * eax = 0 - успешно
4063
  * eax = 1 - ошибка во входных данных
4064
  * eax = 2 - (зарезервировано, никогда не возвращается
4065
    в текущей реализации) с этим индексом уже установлена
4066
    глобальная точка останова
4067
Замечания:
4068
  * Процесс должен быть загружен для отладки (как указано в
4069
    общем описании).
4070
  * Аппаратные точки останова реализуются через DRx-регистры
4071
    процессора, отсюда все ограничения.
4072
  * Функция может переустановить ранее установленную ей же
4073
    точку останова (никак не сообщая об этом).
4074
    Ведите список установленных точек останова в отладчике.
4075
  * Срабатывание точки останова заключается в генерировании
4076
    отладочного исключения #DB, о котором система сообщает отладчику.
4077
  * Точка останова на запись и чтение/запись срабатывает после
127 mario79 4078
    выполнения вызвавшей е+ инструкции.
77 diamond 4079
 
4080
======================================================================
127 mario79 4081
= Функция 70 - работа с файловой системой с поддержкой длинных им+н. =
77 diamond 4082
======================================================================
4083
Параметры:
4084
  * eax = 70
4085
  * ebx = указатель на информационную структуру
4086
Возвращаемое значение:
4087
  * eax = 0 - успешно; иначе код ошибки файловой системы
4088
  * в зависимости от подфункции может возвращаться значение и
4089
    в других регистрах
4090
Общий формат информационной структуры:
4091
  * +0: dword: номер подфункции
4092
  * +4: dword: смещение в файле
91 diamond 4093
  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
77 diamond 4094
  * +12 = +0xC: dword: размер
4095
  * +16 = +0x10: dword: указатель на данные
4096
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
86 diamond 4097
    или
4098
  * +20 = +0x14: db 0
4099
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4100
Уточнения - в документации на соответствующую подфункцию.
4101
Имя файла нечувствительно к регистру букв. Русские буквы должны быть
4102
записаны в кодировке cp866 (DOS).
4103
Формат имени файла:
4104
/base/number/dir1/dir2/.../dirn/file,
4105
где /base/number идентифицирует устройство, на котором ищется файл:
4106
одно из
4107
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
4108
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
4109
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
4110
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
127 mario79 4111
    к ж+стким дискам на IDE0 (Primary Master), IDE1 (Primary Slave),
77 diamond 4112
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4113
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
4114
    (на каждом из винчестеров нумерация начинается с 1)
91 diamond 4115
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 для доступа соответственно
4116
    к CD на IDE0 (Primary Master), IDE1 (Primary Slave),
118 diamond 4117
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
77 diamond 4118
Примеры:
83 diamond 4119
  * '/rd/1/kernel.asm',0
77 diamond 4120
  * '/HD0/1/kernel.asm',0
4121
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4122
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
4123
Доступные подфункции:
4124
  * подфункция 0 - чтение файла
4125
  * подфункция 1 - чтение папки
83 diamond 4126
  * подфункция 2 - создание/перезапись файла
86 diamond 4127
  * подфункция 5 - получение атрибутов файла/папки
4128
  * подфункция 6 - установка атрибутов файла/папки
91 diamond 4129
  * подфункция 7 - запуск программы
118 diamond 4130
Для CD-приводов в связи с аппаратными ограничениями доступны
4131
только подфункции 0,1,5 и 7, вызов других подфункций завершится
4132
ошибкой с кодом 2.
77 diamond 4133
 
4134
======================================================================
127 mario79 4135
= Функция 70, подфункция 0 - чтение файла с поддержкой длинных им+н. =
77 diamond 4136
======================================================================
4137
Параметры:
4138
  * eax = 70 - номер функции
4139
  * ebx = указатель на информационную структуру
4140
Формат информационной структуры:
4141
  * +0: dword: 0 = номер подфункции
4142
  * +4: dword: позиция в файле (в байтах)
4143
  * +8: dword: 0 (зарезервировано под старший dword позиции)
4144
  * +12 = +0xC: dword: сколько байт читать
4145
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
127 mario79 4146
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
77 diamond 4147
    общем описании
86 diamond 4148
    или
4149
  * +20 = +0x14: db 0
4150
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4151
Возвращаемое значение:
4152
  * eax = 0 - успешно, иначе код ошибки файловой системы
4153
  * ebx = число прочитанных байт или
4154
    -1=0xffffffff, если файл не найден
4155
Замечания:
4156
  * Если файл кончился раньше, чем был прочитан последний запрошенный
127 mario79 4157
    блок, то функция прочитает, сколько сможет, после чего верн+т
77 diamond 4158
    eax=6 (EOF).
4159
  * Функция не позволяет читать папки
127 mario79 4160
    (верн+тся eax=10, access denied).
77 diamond 4161
 
4162
======================================================================
127 mario79 4163
= Функция 70, подфункция 1 - чтение папки с поддержкой длинных им+н. =
77 diamond 4164
======================================================================
4165
Параметры:
4166
  * eax = 70 - номер функции
4167
  * ebx = указатель на информационную структуру
4168
Формат информационной структуры:
4169
  * +0: dword: 1 = номер подфункции
4170
  * +4: dword: индекс начального блока (считая с 0)
78 diamond 4171
  * +8: dword: поле флагов:
4172
    * бит 0 (маска 1): в каком формате возвращать имена,
4173
      0=ANSI, 1=UNICODE
4174
    * прочие биты зарезервированы и должны быть установлены в 0
4175
      для будущей совместимости
77 diamond 4176
  * +12 = +0xC: dword: сколько блоков читать
4177
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
4178
    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
127 mario79 4179
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования им+н указаны в
77 diamond 4180
    общем описании
86 diamond 4181
    или
4182
  * +20 = +0x14: db 0
4183
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4184
Возвращаемое значение:
4185
  * eax = 0 - успешно, иначе код ошибки файловой системы
4186
  * ebx = число файлов, информация о которых была записана в буфер,
4187
    или -1=0xffffffff, если папка не найдена
4188
Структура буфера:
4189
  * +0: 32*byte: заголовок
4190
  * +32 = +0x20: n1*byte: блок с информацией о файле 1
4191
  * +32+n1: n2*byte: блок с информацией о файле 2
4192
  * ...
4193
Структура заголовка:
4194
  * +0: dword: версия структуры (текущая версия = 1)
127 mario79 4195
  * +4: dword: количество размещ+нных блоков; не больше, чем запрошено
77 diamond 4196
    в поле +12 информационной структуры; может быть меньше,
4197
    если в папке кончились файлы (то же самое, что и в ebx)
4198
  * +8: dword: общее число файлов в папке
4199
  * +12 = +0xC: 20*byte: зарезервировано (нули)
4200
Структура блока данных входа каталога (БДВК):
4201
  * +0: dword: атрибуты файла:
4202
    * бит 0 (маска 1): файл только для чтения
4203
    * бит 1 (маска 2): файл является скрытым
4204
    * бит 2 (маска 4): файл является системным
4205
    * бит 3 (маска 8): это не файл, а метка тома
4206
      (на заданном разделе встречается не более одного раза и
4207
      только в корневой папке)
4208
    * бит 4 (маска 0x10): это папка
4209
    * бит 5 (маска 0x20): файл не архивировался - многие программы
4210
      архивации имеют опцию, по которой архивируются только файлы
4211
      с установленным этим битом, после чего этот бит сбрасывается -
4212
      это может быть полезно для автоматического создания
4213
      backup-архивов, ибо при записи бит обычно устанавливается
4214
      (не в Kolibri, правда)
78 diamond 4215
  * +4: byte: тип данных имени:
4216
    (совпадает с битом 0 флагов информационной структуры)
77 diamond 4217
    * 0 = ASCII = 1-байтное представление каждого символа
4218
    * 1 = UNICODE = 2-байтное представление каждого символа
4219
  * +5: 3*byte: зарезервировано (нули)
4220
  * +8: 4*byte: время создания файла
4221
  * +12 = +0xC: 4*byte: дата создания файла
4222
  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
4223
  * +20 = +0x14: 4*byte: дата последнего доступа
4224
  * +24 = +0x18: 4*byte: время последней модификации
4225
  * +28 = +0x1C: 4*byte: дата последней модификации
4226
  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
4227
  * +40 = +0x28: имя
4228
    * для формата ASCII: максимальная длина имени 263 символа
4229
      (263 байта), байт после имени имеет значение 0
4230
    * для формата UNICODE: максимальная длина имени 259 символов
4231
      (518 байт), два байта после имени имеют значение 0
4232
Формат времени:
4233
  * +0: byte: секунды
4234
  * +1: byte: минуты
4235
  * +2: byte: часы
4236
  * +3: byte: зарезервировано (0)
4237
  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
4238
Формат даты:
4239
  * +0: byte: день
4240
  * +1: byte: месяц
4241
  * +2: word: год
4242
  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
4243
Замечания:
4244
  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
4245
    304 байта, если в UNICODE - 560 байт. Значение длины выравнено
4246
    на целое кратное 16 байт
4247
    (для ускорения обработки в кэш-памяти CPU).
78 diamond 4248
  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
4249
    данные содержат мусор.
77 diamond 4250
  * Если файлы в папке кончились раньше, чем было прочитано
4251
    запрошенное количество, то функция прочитает, сколько сможет,
127 mario79 4252
    после чего верн+т eax=6 (EOF).
77 diamond 4253
  * Любая папка на диске, кроме корневой, содержит два специальных
4254
    входа "." и "..", идентифицирующих соответственно саму папку и
4255
    родительскую папку.
4256
  * Функция позволяет также читать виртуальные папки "/", "/rd",
4257
    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
4258
    0x10, а времена и даты обнулены. Альтернативный способ получения
4259
    информации об оборудовании - подфункция 11 функции 18.
4260
 
4261
======================================================================
83 diamond 4262
====================== Функция 70, подфункция 2 ======================
127 mario79 4263
======== Создание/перезапись файла с поддержкой длинных им+н. ========
83 diamond 4264
======================================================================
4265
Параметры:
4266
  * eax = 70 - номер функции
4267
  * ebx = указатель на информационную структуру
4268
Формат информационной структуры:
4269
  * +0: dword: 2 = номер подфункции
4270
  * +4: dword: 0 (зарезервировано)
4271
  * +8: dword: 0 (зарезервировано)
4272
  * +12 = +0xC: dword: сколько байт писать
4273
  * +16 = +0x10: dword: указатель на данные
127 mario79 4274
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
83 diamond 4275
    общем описании
86 diamond 4276
    или
4277
  * +20 = +0x14: db 0
4278
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
83 diamond 4279
Возвращаемое значение:
4280
  * eax = 0 - успешно, иначе код ошибки файловой системы
4281
  * ebx = число записанных байт (возможно, 0)
4282
Замечания:
127 mario79 4283
  * Если файл с таким именем не существовал, он созда+тся; если
83 diamond 4284
    существовал, то перезаписывается.
4285
  * Если свободного места на диске недостаточно, то функция запишет,
127 mario79 4286
    сколько сможет, после чего верн+т код ошибки 8.
4287
  * Функция не поддерживается для CD (верн+тся код ошибки 2).
83 diamond 4288
 
4289
======================================================================
86 diamond 4290
=== Функция 70, подфункция 5 - получение информации о файле/папке. ===
4291
======================================================================
4292
Параметры:
4293
  * eax = 70 - номер функции
4294
  * ebx = указатель на информационную структуру
4295
Формат информационной структуры:
4296
  * +0: dword: 5 = номер подфункции
4297
  * +4: dword: 0 (зарезервировано)
4298
  * +8: dword: 0 (зарезервировано)
4299
  * +12 = +0xC: dword: 0 (зарезервировано)
4300
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
4301
                        (40 байт)
127 mario79 4302
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
86 diamond 4303
    общем описании
4304
    или
4305
  * +20 = +0x14: db 0
4306
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4307
Возвращаемое значение:
4308
  * eax = 0 - успешно, иначе код ошибки файловой системы
4309
  * ebx разрушается
4310
Информация о файле возвращается в формате БДВК
4311
(блока данных входа каталога), указанном в описании
4312
подфункции 1, но без имени файла
4313
(то есть первые 40 = 0x28 байт).
4314
Замечания:
4315
  * Функция не поддерживает виртуальные папки типа /, /rd и
4316
    корневые папки типа /rd/1.
4317
 
4318
======================================================================
4319
===== Функция 70, подфункция 6 - установка атрибутов файла/папки. ====
4320
======================================================================
4321
Параметры:
4322
  * eax = 70 - номер функции
4323
  * ebx = указатель на информационную структуру
4324
Формат информационной структуры:
4325
  * +0: dword: 6 = номер подфункции
4326
  * +4: dword: 0 (зарезервировано)
4327
  * +8: dword: 0 (зарезервировано)
4328
  * +12 = +0xC: dword: 0 (зарезервировано)
4329
  * +16 = +0x10: dword: указатель на буфер с атрибутами (32 байта)
127 mario79 4330
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
86 diamond 4331
    общем описании
4332
    или
4333
  * +20 = +0x14: db 0
4334
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4335
Возвращаемое значение:
4336
  * eax = 0 - успешно, иначе код ошибки файловой системы
4337
  * ebx разрушается
4338
Атрибуты файла - первые 32 байта в БДВК (блоке данных входа каталога),
4339
формат которого указан в описании подфункции 1
4340
(то есть без имени и размера файла). Атрибут файл/папка/метка тома
4341
(биты 3,4 в dword'е +0) не меняется.
4342
Байт +4 (формат имени) игнорируется.
4343
Замечания:
4344
  * Функция не поддерживает виртуальные папки типа /, /rd и
4345
    корневые папки типа /rd/1.
127 mario79 4346
  * Функция не поддерживается для CD (верн+тся код ошибки 2).
86 diamond 4347
 
4348
======================================================================
91 diamond 4349
============ Функция 70, подфункция 7 - запуск программы. ============
4350
======================================================================
4351
Параметры:
4352
  * eax = 70 - номер функции
4353
  * ebx = указатель на информационную структуру
4354
Формат информационной структуры:
4355
  * +0: dword: 7 = номер подфункции
4356
  * +4: dword: поле флагов:
4357
    * бит 0: запустить процесс как отлаживаемый
4358
    * остальные биты зарезервированы и должны быть установлены в 0
4359
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
4360
  * +12 = +0xC: dword: 0 (зарезервировано)
4361
  * +16 = +0x10: dword: 0 (зарезервировано)
127 mario79 4362
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования им+н указаны в
91 diamond 4363
    общем описании
4364
    или
4365
  * +20 = +0x14: db 0
4366
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4367
Возвращаемое значение:
4368
  * eax > 0 - программа загружена, eax содержит PID
4369
  * eax < 0 - произошла ошибка, -eax содержит
4370
    код ошибки файловой системы
4371
  * ebx разрушается
4372
Замечания:
4373
  * Командная строка должна заканчиваться символом с кодом 0
4374
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
4375
    включительно, либо первые 256 символов, в зависимости от того,
4376
    что меньше.
127 mario79 4377
  * Если процесс запускается как отлаживаемый, он созда+тся
91 diamond 4378
    в замороженном состоянии; для запуска используйте
4379
    подфункцию 5 функции 69.
4380
 
4381
======================================================================
118 diamond 4382
=== Функция 71, подфункция 1 - установить заголовок окна программы. ==
114 mikedld 4383
======================================================================
4384
Параметры:
4385
  * eax = 71 - номер функции
4386
  * ebx = 1 - номер подфункции
118 diamond 4387
  * ecx = адрес строки заголовка
114 mikedld 4388
Возвращаемое значение:
118 diamond 4389
  * функция не возвращает значения
114 mikedld 4390
Замечания:
4391
  * Строка заголовка должна быть в формате ASCIIZ. В заголовке
118 diamond 4392
    отображается не более 255 символов независимо от полной длины
114 mikedld 4393
    строки.
118 diamond 4394
  * Чтобы убрать заголовок, передайте NULL в ecx.
114 mikedld 4395
 
4396
======================================================================
77 diamond 4397
========== Функция -1 - завершить выполнение потока/процесса =========
4398
======================================================================
4399
Параметры:
4400
  * eax = -1 - номер функции
4401
Возвращаемое значение:
4402
  * функция не возвращает ни значения, ни управления
4403
Замечания:
4404
  * Если процесс явно не создавал потоков, то у него есть только
4405
    один поток, завершение которого приводит к завершению процесса.
4406
  * Если текущий поток - последний в процессе, то его завершение
4407
    также приводит к завершению процесса.
4408
  * Эта функция завершает текущий поток. Другой поток можно прибить
4409
    вызовом подфункции 2 функции 18.
4410
 
4411
======================================================================
4412
=========================== Список событий ===========================
4413
======================================================================
4414
Очередное событие можно получить вызовом одной из функций 10
4415
(ожидать события), 11 (проверить без ожидания), 23
4416
(ожидать в течение заданного времени).
4417
Эти функции возвращают только те события, которые входят в маску,
4418
устанавливаемую функцией 40. По умолчанию это первые три, чего
4419
вполне достаточно для многих приложений.
4420
Коды событий:
4421
  * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
4422
  * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
92 diamond 4423
    активно) или нажата "горячая клавиша";
4424
    сбрасывается, когда все клавиши из буфера считаны функцией 2
127 mario79 4425
  * 3 = нажата кнопка, определ+нная ранее функцией 8 (или кнопка
77 diamond 4426
    закрытия, созданная неявно функцией 0; кнопка минимизации
4427
    обрабатывается системой и о ней сообщения не приходит;
4428
    поступает, только когда окно активно; сбрасывается, когда все
4429
    кнопки из буфера считаны функцией 17)
4430
  * 4 = зарезервировано (в текущей реализации никогда не приходит даже
4431
    при размаскировке функцией 40)
4432
  * 5 = перерисовывается фон рабочего стола (сбрасывается
4433
    автоматически после перерисовки, так что если во время перерисовки
127 mario79 4434
    фона программа не жд+т и не проверяет события, то этого события
77 diamond 4435
    она не заметит)
4436
  * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
4437
    или перемещение; сбрасывается при прочтении)
4438
  * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
4439
    Communication; сбрасывается при прочтении)
4440
  * 8 = произошло сетевое событие (сбрасывается при прочтении;
4441
    смотри работу с сетью)
4442
  * 9 = произошло отладочное событие (сбрасывается при прочтении;
4443
    смотри отладочную подсистему)
4444
  * 16..31 = произошло событие с соответствующим IRQ
4445
    (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)
4446
 
4447
======================================================================
4448
==================== Коды ошибок файловой системы ====================
4449
======================================================================
4450
  * 0 = успешно
127 mario79 4451
  * 1 = не определена база и/или раздел ж+сткого диска (подфункциями
77 diamond 4452
    7, 8 функции 21)
4453
  * 2 = функция не поддерживается для данной файловой системы
4454
  * 3 = неизвестная файловая система
4455
  * 4 = возвращается только функцией rename при передаче сильно
4456
    неверного параметра и никак не соответствует описанию
4457
    в исходниках ядра "partition not defined at hd"
4458
  * 5 = файл не найден
4459
  * 6 = файл закончился
4460
  * 7 = указатель вне памяти приложения
4461
  * 8 = диск заполнен
4462
  * 9 = таблица FAT разрушена
127 mario79 4463
  * 10 = доступ запрещ+н
83 diamond 4464
  * 11 = ошибка устройства
77 diamond 4465
При запуске программы возможны также следующие коды ошибок:
4466
  * 30 = 0x1E = недостаточно памяти
4467
  * 31 = 0x1F = файл не является исполнимым
4468
  * 32 = 0x20 = слишком много процессов