Subversion Repositories Kolibri OS

Rev

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

Rev Author Line No. Line
2465 Serge 1 
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
2 
;;                                                              ;;
3 
;; Copyright (C) KolibriOS team 2004-2012. All rights reserved. ;;
4 
;; Distributed under terms of the GNU General Public License    ;;
5 
;;                                                              ;;
6 
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
7 
 
2010 serge 8 
СИСТЕМНЫЕ ФУНКЦИИ ОПЕРАЦИОННОЙ СИСТЕМЫ Kolibri 0.7.7.0
77 diamond 9 
 
10 
Номер функции помещается в регистр eax.
11 
Вызов системной функции осуществляется командой "int 0x40".
12 
Все регистры, кроме явно указанных в возвращаемом значении,
13 
    включая регистр флагов eflags, сохраняются.
14 
 
15 
 
16 
======================================================================
17 
============== Функция 0 - определить и нарисовать окно. =============
18 
======================================================================
19 
Определяет окно приложения. Рисует рамку окна, заголовок и рабочую
20 
область. Для окон со скином определяет стандартные кнопки закрытия и
21 
минимизации.
22 
Параметры:
23 
  * eax = 0 - номер функции
24 
  * ebx = [координата по оси x]*65536 + [размер по оси x]
25 
  * ecx = [координата по оси y]*65536 + [размер по оси y]
26 
  * edx = 0xXYRRGGBB, где:
27 
    * Y = стиль окна:
28 
      * Y=0 - тип I - окно фиксированных размеров
29 
      * Y=1 - только определить область окна, ничего не рисовать
30 
      * Y=2 - тип II - окно изменяемых размеров
31 
      * Y=3 - окно со скином
641 diamond 32 
      * Y=4 - окно со скином фиксированных размеров
33 
      * остальные возможные значения (от 5 до 15) зарезервированы,
77 diamond 34 
        вызов функции с такими Y игнорируется
35 
    * RR, GG, BB = соответственно красная, зеленая, синяя
36 
      составляющие цвета рабочей области окна
37 
      (игнорируется для стиля Y=2)
114 mikedld 38 
    * X = DCBA (биты)
641 diamond 39 
      * A = 1 - у окна есть заголовок; для стилей Y=3,4 адрес строки
131 diamond 40 
                  заголовка задаётся в edi, для прочих стилей
118 diamond 41 
                  используется подфункция 1 функции 71
42 
      * B = 1 - координаты всех графических примитивов задаются
43 
                  относительно клиентской области окна
303 mikedld 44 
      * C = 1 - не закрашивать рабочую область при отрисовке окна
118 diamond 45 
      * D = 0 - нормальная заливка рабочей области, 1 - градиентная
77 diamond 46 
    Следующие параметры предназначены для окон типа I и II и
47 
    игнорируются для стилей Y=1,3:
48 
  * esi = 0xXYRRGGBB - цвет заголовка
49 
    * RR, GG, BB определяют сам цвет
50 
    * Y=0 - обычное окно, Y=1 - неперемещаемое окно
2010 serge 51 
    * X определяет градиент заголовка: X=0 - нет градиента,
77 diamond 52 
      X=8 - обычный градиент,
53 
      для окон типа II X=4 - негативный градиент
54 
    * прочие значения X и Y зарезервированы
55 
  * edi = 0x00RRGGBB - цвет рамки
56 
Возвращаемое значение:
57 
  * функция не возвращает значения
58 
Замечания:
59 
  * Положение и размеры окна устанавливаются при первом вызове
60 
    этой функции и игнорируются при последующих; для изменения
61 
    положения и/или размеров уже созданного окна используйте
62 
    67-ю функцию.
641 diamond 63 
  * Для окон стилей Y=3,4 с заголовком (A=1) строка заголовка
118 diamond 64 
    устанавливается при первом вызове этой функции и игнорируется при
65 
    последующих (точнее говоря, игнорируется после вызова
66 
    подфункции 2 функции 12 - конца перерисовки);
67 
    для изменения строки заголовка уже созданного окна используйте
68 
    подфункцию 1 функции 71.
77 diamond 69 
  * Если использовать окна соответствующих стилей, то положение
70 
    и/или размеры окна могут меняться пользователем.
71 
    Текущие положение и размеры могут быть получены вызовом функции 9.
72 
  * Окно должно умещаться на экране. Если переданные координаты
73 
    и размеры не удовлетворяют этому условию, то соответствующая
74 
    координата (или, возможно, обе) считается нулем, а если и это
75 
    не помогает, то соответствующий размер (или, возможно, оба)
76 
    устанавливается в размер экрана.
1018 diamond 77 
 
77 diamond 78 
    Далее обозначим xpos,ypos,xsize,ysize - значения, передаваемые
79 
    в ebx,ecx. Координаты приводятся относительно левого верхнего
80 
    угла окна, который, таким образом, задается как (0,0), координаты
81 
    правого нижнего угла суть (xsize,ysize).
82 
  * Размеры окна понимаются в смысле координат правого нижнего угла.
83 
    Это же относится и ко всем остальным функциям.
84 
    Это означает, что реальные размеры на 1 пиксель больше.
85 
  * Вид окна типа I:
86 
    * рисуется внешняя рамка цвета, указанного в edi,
87 
      шириной 1 пиксель
88 
    * рисуется заголовок - прямоугольник с левым верхним углом (1,1)
89 
      и правым нижним (xsize-1,min(25,ysize)) цвета, указанного в esi
90 
      (с учетом градиента)
91 
    * если ysize>=26, то закрашивается рабочая область окна -
92 
      прямоугольник с левым верхним углом (1,21) и правым нижним
93 
      (xsize-1,ysize-1) (размерами (xsize-1)*(ysize-21)) - цветом,
94 
      указанным в edx (с учетом градиента)
118 diamond 95 
    * если A=1 и строка заголовка установлена подфункцией 1
96 
      функции 71, то она выводится в соответствующем месте заголовка
77 diamond 97 
  * Вид окна стиля Y=1:
98 
    * полностью определяется приложением
99 
  * Вид окна типа II:
131 diamond 100 
    * рисуется внешняя рамка шириной 1 пиксель "затенённого" цвета
77 diamond 101 
      edi (все составляющие цвета уменьшаются в два раза)
102 
    * рисуется промежуточная рамка шириной 3 пикселя цвета edi
103 
    * рисуется внутренняя рамка шириной 1 пиксель
131 diamond 104 
      "затенённого" цвета edi
77 diamond 105 
    * рисуется заголовок - прямоугольник с левым верхним углом (4,4)
106 
      и правым нижним (xsize-4,min(20,ysize)) цвета, указанного в esi
107 
      (с учетом градиента)
108 
    * если ysize>=26, то закрашивается рабочая область окна -
109 
      прямоугольник с левым верхним углом (5,20) и правым нижним
110 
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
118 diamond 111 
    * если A=1 и строка заголовка установлена подфункцией 1
112 
      функции 71, то она выводится в соответствующем месте заголовка
77 diamond 113 
  * Вид окна со скином:
114 
    * рисуется внешняя рамка шириной 1 пиксель
115 
      цвета 'outer' из скина
116 
    * рисуется промежуточная рамка шириной 3 пикселя
117 
      цвета 'frame' из скина
118 
    * рисуется внутренняя рамка шириной 1 пиксель
119 
      цвета 'inner' из скина
120 
    * рисуется заголовок (по картинкам из скина) в прямоугольнике
121 
      (0,0) - (xsize,_skinh-1)
122 
    * если ysize>=26, то закрашивается рабочая область окна -
123 
      прямоугольник с левым верхним углом (5,_skinh) и правым нижним
124 
      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)
125 
    * определяются две стандартные кнопки: закрытия и минимизации
126 
      (смотри функцию 8)
118 diamond 127 
    * если A=1 и в edi (ненулевой) указатель на строку заголовка,
128 
      то она выводится в заголовке в месте, определяемом скином
77 diamond 129 
    * Значение переменной _skinh доступно как результат вызова
130 
      подфункции 4 функции 48
131 
 
132 
======================================================================
133 
================= Функция 1 - поставить точку в окне. ================
134 
======================================================================
135 
Параметры:
136 
  * eax = 1 - номер функции
137 
  * ebx = x-координата (относительно окна)
138 
  * ecx = y-координата (относительно окна)
139 
  * edx = 0x00RRGGBB - цвет точки
140 
    edx = 0x01xxxxxx - инвертировать цвет точки
141 
          (младшие 24 бита игнорируются)
142 
Возвращаемое значение:
143 
  * функция не возвращает значения
144 
 
145 
======================================================================
146 
============== Функция 2 - получить код нажатой клавиши. =============
147 
======================================================================
148 
Забирает код нажатой клавиши из буфера.
149 
Параметры:
150 
  * eax = 2 - номер функции
151 
Возвращаемое значение:
152 
  * если буфер пуст, возвращается eax=1
153 
  * если буфер непуст, то возвращается al=0, ah=код нажатой клавиши,
154 
    старшее слово регистра eax обнулено
92 diamond 155 
  * если есть "горячая клавиша", то возвращается
156 
    al=2, ah=сканкод нажатой клавиши (0 для управляющих клавиш),
157 
    старшее слово регистра eax содержит состояние управляющих клавиш
158 
    в момент нажатия горячей клавиши
77 diamond 159 
Замечания:
160 
  * Существует общесистемный буфер нажатых клавиш размером 120 байт,
161 
    организованный как очередь.
131 diamond 162 
  * Существует ещё один общесистемный буфер на 120 "горячих клавиш".
77 diamond 163 
  * При вызове этой функции приложением с неактивным окном
92 diamond 164 
    считается, что буфер нажатых клавиш пуст.
77 diamond 165 
  * По умолчанию эта функция возвращает ASCII-коды; переключиться на
166 
    режим сканкодов (и назад) можно с использованием функции 66.
92 diamond 167 
    Однако, горячие клавиши всегда возвращаются как сканкоды.
77 diamond 168 
  * Узнать, какие комбинации клавиш соответствуют каким кодам, можно,
169 
    запустив приложения keyascii и scancode.
170 
  * Сканкоды возвращаются непосредственно клавиатурой и фиксированы;
171 
    ASCII-коды получаются с использованием таблиц преобразования,
172 
    которые можно установить подфункцией 2 функции 21 и прочитать
173 
    подфункцией 2 функции 26.
174 
  * Как следствие, ASCII-коды учитывают текущую раскладку клавиатуры
175 
    (rus/en) в отличие от сканкодов.
92 diamond 176 
  * Поступает информация только о тех горячих клавишах, которые были
177 
    определены этим потоком подфункцией 4 функции 66.
77 diamond 178 
 
179 
======================================================================
180 
================ Функция 3 - получить системное время. ===============
181 
======================================================================
182 
Параметры:
183 
  * eax = 3 - номер функции
184 
Возвращаемое значение:
185 
  * eax = 0x00SSMMHH, где HH:MM:SS = часы:минуты:секунды
186 
  * каждый элемент возвращается как BCD-число, например,
187 
    для времени 23:59:59 результат будет 0x00595923
188 
Замечания:
189 
  * Смотри также подфункцию 9 функции 26 - получение времени
190 
    с момента запуска системы; она во многих случаях удобнее,
191 
    поскольку возвращает просто DWORD-значение счетчика времени.
192 
  * Системное время можно установить функцией 22.
193 
 
194 
======================================================================
118 diamond 195 
============== Функция 4 - вывести строку текста в окно. =============
77 diamond 196 
======================================================================
197 
Параметры:
198 
  * eax = 4 - номер функции
199 
  * ebx = [координата по оси x]*65536 + [координата по оси y]
2987 Serge 200 
  * ecx = 0xXYRRGGBB, где
77 diamond 201 
    * RR, GG, BB задают цвет текста
142 diamond 202 
    * X=ABnn (биты):
3500 Serge 203 
        * nn задает используемый шрифт: 0=системный моноширинный,
204 
        1=системный шрифт переменной ширины
205 
      * A=0 - выводить esi символов, A=1 - выводить ASCIIZ-строку
206 
      * B=1 - закрашивать фон цветом edi
2987 Serge 207 
    * Y=Cnnn (биты):
208 
      * C=1 перенаправить вывод в область пользователя, задано в edi
209 
      * nnn - не используется в текущем виде, должно быть 0 (zero)
77 diamond 210 
  * edx = указатель на начало строки
142 diamond 211 
  * esi = для A=0 длина строки, должна быть не больше 255;
212 
          для A=1 игнорируется
2987 Serge 213 
  * edi = цвет для закраски фона, если B=1
214 
  * edi = указатель на область пользователя, если C=1
77 diamond 215 
Возвращаемое значение:
216 
  * функция не возвращает значения
217 
Замечания:
218 
  * Первый системный шрифт считывается при загрузке из файла char.mt,
219 
    второй - из char2.mt.
220 
  * Оба шрифта имеют высоту 9 пикселей, ширина моноширинного шрифта
221 
    равна 6 пикселей.
2987 Serge 222 
  * C=1, глубина точки = 32 бита, область пользователя выглядит так:
223 
    dword Xsize
224 
    dword Ysize
225 
    остаток области = Xsize * Y size * 4
226 
  * Нельзя одновременно использовать B=1 и C=1, поскольку в обоих
227 
    случаях использован регистр edi для разных целей.
77 diamond 228 
======================================================================
229 
========================= Функция 5 - пауза. =========================
230 
======================================================================
231 
Задерживает выполнение программы на заданное время.
232 
Параметры:
233 
  * eax = 5 - номер функции
234 
  * ebx = время в сотых долях секунды
235 
Возвращаемое значение:
236 
  * функция не возвращает значения
237 
Замечания:
238 
  * Передача ebx=0 не передает управление следующему процессу и
239 
    вообще не производит никаких действий. Если действительно
240 
    требуется передать управление следующему процессу
241 
    (закончить текущий квант времени), используйте подфункцию 1
242 
    функции 68.
243 
 
244 
======================================================================
245 
=============== Функция 6 - прочитать файл с рамдиска. ===============
246 
======================================================================
247 
Параметры:
248 
  * eax = 6 - номер функции
249 
  * ebx = указатель на имя файла
250 
  * ecx = номер стартового блока, считая с 1;
251 
    ecx=0 - читать с начала файла (то же самое, что и ecx=1)
252 
  * edx = число блоков для чтения;
253 
    edx=0 - читать один блок (то же самое, что и edx=1)
254 
  * esi = указатель на область памяти, куда будут записаны данные
255 
Возвращаемое значение:
256 
  * eax = длина файла в байтах, если файл успешно прочитан
257 
  * eax = -1, если файл не найден
258 
Замечания:
259 
  * Данная функция является устаревшей; функция 70
260 
    позволяет выполнять те же действия с расширенными возможностями.
261 
  * Блок = 512 байт.
262 
  * Для чтения всего файла можно указать заведомо большое значение
263 
    в edx, например, edx = -1; но в этом случае будьте готовы к тому,
264 
    что программа "упадет", если файл окажется слишком большим
265 
    и "не влезет" в память программы.
266 
  * Имя файла должно быть либо в формате 8+3 символов
267 
    (первые 8 символов - собственно имя, последние 3 - расширение,
268 
    короткие имена и расширения дополняются пробелами),
269 
    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
270 
    (имя не более 8 символов, точка, расширение 3 символа,
271 
    дополненное при необходимости пробелами).
272 
    Имя файла должно быть записано заглавными буквами.
273 
    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
118 diamond 274 
  * Эта функция не поддерживает папки на рамдиске.
77 diamond 275 
 
276 
======================================================================
277 
=============== Функция 7 - вывести изображение в окно. ==============
278 
======================================================================
279 
Параметры:
280 
  * eax = 7 - номер функции
81 diamond 281 
  * ebx = указатель на изображение в формате BBGGRRBBGGRR...
77 diamond 282 
  * ecx = [размер по оси x]*65536 + [размер по оси y]
283 
  * edx = [координата по оси x]*65536 + [координата по оси y]
284 
Возвращаемое значение:
285 
  * функция не возвращает значения
286 
Замечания:
287 
  * Координаты изображения - это координаты верхнего левого угла
288 
    изображения относительно окна.
289 
  * Размер изображения в байтах есть 3*xsize*ysize.
290 
 
291 
======================================================================
292 
=============== Функция 8 - определить/удалить кнопку. ===============
293 
======================================================================
294 
Параметры для определения кнопки:
295 
  * eax = 8 - номер функции
296 
  * ebx = [координата по оси x]*65536 + [размер по оси x]
297 
  * ecx = [координата по оси y]*65536 + [размер по оси y]
298 
  * edx = 0xXYnnnnnn, где:
299 
    * nnnnnn = идентификатор кнопки
300 
    * старший (31-й) бит edx сброшен
301 
    * если 30-й бит edx установлен - не прорисовывать кнопку
302 
    * если 29-й бит edx установлен - не рисовать рамку
303 
      при нажатии на кнопку
304 
  * esi = 0x00RRGGBB - цвет кнопки
305 
Параметры для удаления кнопки:
306 
  * eax = 8 - номер функции
307 
  * edx = 0x80nnnnnn, где nnnnnn - идентификатор кнопки
308 
Возвращаемое значение:
309 
  * функция не возвращает значения
310 
Замечания:
311 
  * Размеры кнопки должны быть больше 0 и меньше 0x8000.
312 
  * Для окон со скином при определении окна (вызове 0-й функции)
313 
    создаются две стандартные кнопки - закрытия окна
314 
    с идентификатором 1 и минимизации окна с идентификатором 0xffff.
315 
  * Создание двух кнопок с одинаковыми идентификаторами
316 
    вполне допустимо.
317 
  * Кнопка с идентификатором 0xffff при нажатии интерпретируется
318 
    системой как кнопка минимизации, система обрабатывает такое
319 
    нажатие самостоятельно, не обращаясь к приложению.
320 
    В остальном это обычная кнопка.
321 
  * Общее количество кнопок для всех приложений ограничено
322 
    числом 4095.
323 
 
324 
======================================================================
325 
============= Функция 9 - информация о потоке выполнения. ============
326 
======================================================================
327 
Параметры:
328 
  * eax = 9 - номер функции
329 
  * ebx = указатель на буфер размера 1 Кб
330 
  * ecx = номер слота потока
331 
    ecx = -1 - получить информацию о текущем потоке
332 
Возвращаемое значение:
333 
  * eax = максимальный номер слота потока
334 
  * буфер, на который указывает ebx, содержит следующую информацию:
335 
    * +0: dword: использование процессора (сколько тактов в секунду
336 
      уходит на исполнение именно этого потока)
337 
    * +4: word: позиция окна потока в оконном стэке
338 
    * +6: word: (не имеет отношения к запрошенному потоку)
339 
      номер слота потока, окно которого находится в оконном стэке
340 
      в позиции ecx
341 
    * +8: word: зарезервировано
342 
    * +10 = +0xA: 11 байт: имя процесса
2987 Serge 343 
      (имя запущенного файла - исполняемый файл без расширения)
142 diamond 344 
    * +21 = +0x15: byte: зарезервировано, этот байт не изменяется
77 diamond 345 
    * +22 = +0x16: dword: адрес процесса в памяти
346 
    * +26 = +0x1A: dword: размер используемой памяти - 1
347 
    * +30 = +0x1E: dword: идентификатор (PID/TID)
348 
    * +34 = +0x22: dword: координата окна потока по оси x
349 
    * +38 = +0x26: dword: координата окна потока по оси y
350 
    * +42 = +0x2A: dword: размер окна потока по оси x
351 
    * +46 = +0x2E: dword: размер окна потока по оси y
352 
    * +50 = +0x32: word: состояние слота потока:
353 
      * 0 = поток выполняется
354 
      * 1 = поток приостановлен
355 
      * 2 = поток приостановлен в момент ожидания события
356 
      * 3 = поток завершается в результате вызова функции -1 или
357 
        насильственно как следствие вызова подфункции 2 функции 18
358 
        или завершения работы системы
359 
      * 4 = поток завершается в результате исключения
360 
      * 5 = поток ожидает события
361 
      * 9 = запрошенный слот свободен, вся остальная информация о
362 
        слоте не имеет смысла
142 diamond 363 
    * +52 = +0x34: word: зарезервировано, это слово не изменяется
364 
    * +54 = +0x36: dword: координата начала клиентской области
365 
                          по оси x
366 
    * +58 = +0x3A: dword: координата начала клиентской области
367 
                          по оси y
368 
    * +62 = +0x3E: dword: ширина клиентской области
369 
    * +66 = +0x42: dword: высота клиентской области
370 
    * +70 = +0x46: byte: состояние окна - битовое поле
371 
      * бит 0 (маска 1): окно максимизировано
372 
      * бит 1 (маска 2): окно минимизировано в панель задач
373 
      * бит 2 (маска 4): окно свёрнуто в заголовок
2010 serge 374 
    * +71 = +0x47: dword: маска событий
77 diamond 375 
Замечания:
376 
  * Слоты нумеруются с 1.
377 
  * Возвращаемое значение не есть общее число потоков, поскольку
378 
    бывают свободные слоты.
379 
  * При создании процесса автоматически создается поток выполнения.
380 
  * Функция выдает информацию о потоке. Каждый процесс имеет
381 
    хотя бы один поток. Один процесс может создать несколько потоков,
382 
    в этом случае каждый поток получает свой слот, причем поля
383 
    +10, +22, +26 в этих слотах совпадают.
384 
    Для приложений не существует общего способа определить,
385 
    принадлежат ли два потока одному процессу.
386 
  * Активное окно - окно, находящееся на вершине оконного стэка,
387 
    оно получает сообщения о вводе с клавиатуры. Для него позиция в
388 
    оконном стэке совпадает с возвращаемым значением.
389 
  * Слот 1 соответствует специальному потоку операционной системы,
390 
    для которого:
391 
    * окно находится внизу оконного стэка, поля +4 и +6 содержат
392 
      значение 1
393 
    * имя процесса - "OS/IDLE" (дополненное пробелами)
394 
    * адрес процесса в памяти равен 0, размер используемой памяти
395 
      16 Mb (0x1000000)
396 
    * PID=1
142 diamond 397 
    * координаты и размеры окна, равно как и клиентской области,
398 
      условно полагаются равными 0
77 diamond 399 
    * состояние слота - всегда 0 (выполняется)
400 
    * время выполнения складывается из времени, уходящего на
401 
      собственно работу, и времени простоя в ожидании прерывания
402 
      (которое можно получить вызовом подфункции 4 функции 18).
403 
  * Начиная со слота 2, размещаются обычные приложения.
2010 serge 404 
  * Обычные приложения размещаются в памяти по адресу 0
77 diamond 405 
    (константа ядра std_application_base_address).
406 
    Наложения не происходит, поскольку у каждого процесса своя
407 
    таблица страниц.
408 
  * При создании потока ему назначаются слот в системной таблице и
409 
    идентификатор (Process/Thread IDentifier = PID/TID), которые для
410 
    заданного потока не изменяются со временем.
411 
    После завершения потока его слот может быть заново использован
412 
    для другого потока. Идентификатор потока не может быть назначен
413 
    другому потоку даже после завершения первого.
414 
    Назначаемые новым потокам идентификаторы монотонно растут.
415 
  * Если поток еще не определил свое окно вызовом функции 0, то
416 
    положение и размеры этого окна полагаются нулями.
142 diamond 417 
  * Координаты клиентской области окна берутся относительно окна.
77 diamond 418 
  * В данный момент используется только часть буфера размером
142 diamond 419 
    71 = 0x47 байта. Тем не менее рекомендуется использовать буфер
77 diamond 420 
    размером 1 Кб для будущей совместимости, в будущем могут быть
421 
    добавлены некоторые поля.
422 
 
423 
======================================================================
424 
==================== Функция 10 - ожидать события. ===================
425 
======================================================================
426 
Если очередь сообщений пуста, то ждет появления сообщения в очереди.
427 
В таком состоянии поток не получает процессорного времени.
428 
Затем считывает сообщение из очереди.
429 
 
430 
Параметры:
431 
  * eax = 10 - номер функции
432 
Возвращаемое значение:
433 
  * eax = событие (смотри список событий)
434 
Замечания:
435 
  * Учитываются только те события, которые входят в маску,
436 
    устанавливаемую функцией 40. По умолчанию это события
437 
    перерисовки, нажатия на клавиши и на кнопки.
438 
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
439 
    Чтобы ждать не более определенного времени, используйте
440 
    функцию 23.
441 
 
442 
======================================================================
443 
======= Функция 11 - проверить, есть ли событие, без ожидания. =======
444 
======================================================================
445 
Если в очереди сообщений есть какое-то событие, то считывает и
446 
возвращает его. Если очередь пуста, возвращает нуль.
447 
Параметры:
448 
  * eax = 11 - номер функции
449 
Возвращаемое значение:
450 
  * eax = 0 - очередь сообщений пуста
451 
  * иначе eax = событие (смотри список событий)
452 
Замечания:
453 
  * Учитываются только те события, которые входят в маску,
454 
    устанавливаемую функцией 40. По умолчанию это события
455 
    перерисовки, нажатия на клавиши и на кнопки.
456 
  * Для ожидания появления события в очереди, используйте функцию 10.
457 
    Чтобы ждать не более определенного времени, используйте
458 
    функцию 23.
459 
 
460 
======================================================================
461 
=========== Функция 12 - начать/закончить перерисовку окна. ==========
462 
======================================================================
463 
 
464 
-------------- Подфункция 1 - начать перерисовку окна. ---------------
465 
Параметры:
466 
  * eax = 12 - номер функции
467 
  * ebx = 1 - номер подфункции
468 
Возвращаемое значение:
469 
  * функция не возвращает значения
470 
 
471 
------------- Подфункция 2 - закончить перерисовку окна. -------------
472 
Параметры:
473 
  * eax = 12 - номер функции
474 
  * ebx = 2 - номер подфункции
475 
Возвращаемое значение:
476 
  * функция не возвращает значения
477 
Замечания:
131 diamond 478 
  * Функция начала перерисовки удаляет все определённые
77 diamond 479 
    функцией 8 кнопки, их следует определить повторно.
480 
 
481 
======================================================================
482 
============ Функция 13 - нарисовать прямоугольник в окне. ===========
483 
======================================================================
484 
Параметры:
485 
  * eax = 13 - номер функции
486 
  * ebx = [координата по оси x]*65536 + [размер по оси x]
487 
  * ecx = [координата по оси y]*65536 + [размер по оси y]
488 
  * edx = цвет 0xRRGGBB или 0x80RRGGBB для градиентной заливки
489 
Возвращаемое значение:
490 
  * функция не возвращает значения
491 
Замечания:
492 
  * Под координатами понимаются координаты левого верхнего угла
493 
    прямоугольника относительно окна.
494 
 
495 
======================================================================
496 
================ Функция 14 - получить размеры экрана. ===============
497 
======================================================================
498 
Параметры:
499 
  * eax = 14 - номер функции
500 
Возвращаемое значение:
501 
  * eax = [xsize]*65536 + [ysize], где
502 
  * xsize = x-координата правого нижнего угла экрана =
503 
            размер по горизонтали - 1
504 
  * ysize = y-координата правого нижнего угла экрана =
505 
            размер по вертикали - 1
506 
Замечания:
507 
  * Смотри также подфункцию 5 функции 48 - получить размеры рабочей
508 
    области экрана.
509 
 
510 
======================================================================
511 
= Функция 15, подфункция 1 - установить размер фонового изображения. =
512 
======================================================================
513 
Параметры:
514 
  * eax = 15 - номер функции
515 
  * ebx = 1 - номер подфункции
516 
  * ecx = ширина изображения
517 
  * edx = высота изображения
518 
Возвращаемое значение:
519 
  * функция не возвращает значения
520 
Замечания:
499 diamond 521 
  * Вызов функции обязателен перед вызовом подфункций 2 и 5.
77 diamond 522 
  * Для обновления экрана (после завершения серии команд, работающих с
523 
    фоном) вызывайте подфункцию 3 перерисовки фона.
524 
  * Есть парная функция получения размеров фонового изображения -
525 
    подфункция 1 функции 39.
526 
 
527 
======================================================================
528 
= Функция 15, подфункция 2 - поставить точку на фоновом изображении. =
529 
======================================================================
530 
Параметры:
531 
  * eax = 15 - номер функции
532 
  * ebx = 2 - номер подфункции
533 
  * ecx = смещение
534 
  * edx = цвет точки 0xRRGGBB
535 
Возвращаемое значение:
536 
  * функция не возвращает значения
537 
Замечания:
538 
  * Смещение для точки с координатами (x,y) вычисляется как
539 
    (x+y*xsize)*3.
499 diamond 540 
  * Если указанное смещение превышает установленный подфункцией 1
541 
    размер, вызов игнорируется.
77 diamond 542 
  * Для обновления экрана (после завершения серии команд, работающих с
543 
    фоном) вызывайте подфункцию 3 перерисовки фона.
544 
  * Есть парная функция получения точки с фонового изображения -
545 
    подфункция 2 функции 39.
546 
 
547 
======================================================================
548 
============ Функция 15, подфункция 3 - перерисовать фон. ============
549 
======================================================================
550 
Параметры:
551 
  * eax = 15 - номер функции
552 
  * ebx = 3 - номер подфункции
553 
Возвращаемое значение:
554 
  * функция не возвращает значения
555 
 
556 
======================================================================
557 
===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====
558 
======================================================================
559 
Параметры:
560 
  * eax = 15 - номер функции
561 
  * ebx = 4 - номер подфункции
562 
  * ecx = режим отрисовки:
563 
    * 1 = замостить
564 
    * 2 = растянуть
565 
Возвращаемое значение:
566 
  * функция не возвращает значения
567 
Замечания:
568 
  * Для обновления экрана (после завершения серии команд, работающих с
569 
    фоном) вызывайте подфункцию 3 перерисовки фона.
570 
  * Есть парная команда получения режима отрисовки фона -
571 
    подфункция 4 функции 39.
572 
 
573 
======================================================================
574 
===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====
575 
======================================================================
576 
Параметры:
577 
  * eax = 15 - номер функции
578 
  * ebx = 5 - номер подфункции
81 diamond 579 
  * ecx = указатель на данные в формате BBGGRRBBGGRR...
77 diamond 580 
  * edx = смещение в данных фонового изображения
581 
  * esi = размер данных в байтах = 3 * число пикселей
582 
Возвращаемое значение:
583 
  * функция не возвращает значения
584 
Замечания:
499 diamond 585 
  * Проверки корректности смещения и размера не производится.
81 diamond 586 
  * Цвет каждого пикселя хранится как 3-байтная величина BBGGRR.
77 diamond 587 
  * Пиксели фонового изображения записываются последовательно
588 
    слева направо, сверху вниз.
589 
  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.
590 
  * Для обновления экрана (после завершения серии команд, работающих с
591 
    фоном) вызывайте подфункцию 3 перерисовки фона.
592 
 
593 
======================================================================
546 diamond 594 
====================== Функция 15, подфункция 6 ======================
595 
==== Спроецировать данные фона на адресное пространство процесса. ====
596 
======================================================================
597 
Параметры:
598 
  * eax = 15 - номер функции
599 
  * ebx = 6 - номер подфункции
600 
Возвращаемое значение:
601 
  * eax = указатель на данные фона, 0 при ошибке
602 
Замечания:
603 
  * Спроецированные данные доступны на чтение и запись.
604 
  * Размер данных фона равен 3*xsize*ysize. Изменение размеров фона
605 
    блокируется на время работы с спроецированными данными.
606 
  * Цвет каждого пикселя хранится как 3-байтовая величина BBGGRR.
607 
  * Пиксели фонового изображения записываются последовательно
608 
    слева направо, сверху вниз.
609 
 
610 
======================================================================
611 
====================== Функция 15, подфункция 7 ======================
612 
=== Закрыть проекцию данных фона на адресное пространство процесса. ==
613 
======================================================================
614 
Параметры:
615 
  * eax = 15 - номер функции
616 
  * ebx = 7 - номер подфункции
617 
  * ecx = указатель на данные фона
618 
Возвращаемое значение:
619 
  * eax = 1 при успехе, 0 при ошибке
620 
 
621 
======================================================================
2987 Serge 622 
====================== Функция 15, подфункция 8 ======================
623 
=========== Получить координаты последней отрисовки фона. ============
624 
======================================================================
625 
Параметры:
626 
  * eax = 15 - номер функции
627 
  * ebx = 8 - номер подфункции
628 
Возвращаемое значение:
629 
  * eax = [left]*65536 + [right]
630 
  * ebx = [top]*65536 + [bottom]
631 
Замечания:
632 
  * (left,top) - координаты левого верхнего угла,
633 
    (right,bottom) - координаты правого нижнего.
634 
  * Для получения более достоверных сведений, необходимо вызвать
635 
    функцию сразу после получения события:
636 
             5 = завершилась перерисовка фона рабочего стола
637 
 
638 
======================================================================
639 
====================== Функция 15, подфункция 9 ======================
640 
=============== Перерисовать прямоугольную часть фона. ===============
641 
======================================================================
642 
Параметры:
643 
  * eax = 15 - номер функции
644 
  * ebx = 9 - номер подфункции
645 
  * ecx = [left]*65536 + [right]
646 
  * edx = [top]*65536 + [bottom]
647 
Возвращаемое значение:
648 
  * функция не возвращает значения
649 
Замечания:
650 
  * (left,top) - координаты левого верхнего угла,
651 
    (right,bottom) - координаты правого нижнего.
652 
  * Если параметры установлены некорректно - фон не перерисовывается.
653 
 
654 
======================================================================
77 diamond 655 
============= Функция 16 - сохранить рамдиск на дискету. =============
656 
======================================================================
657 
Параметры:
658 
  * eax = 16 - номер функции
659 
  * ebx = 1 или ebx = 2 - на какую дискету сохранять
660 
Возвращаемое значение:
661 
  * eax = 0 - успешно
662 
  * eax = 1 - ошибка
663 
 
664 
======================================================================
665 
============== Функция 17 - получить код нажатой кнопки. =============
666 
======================================================================
667 
Забирает код нажатой кнопки из буфера.
668 
Параметры:
669 
  * eax = 17 - номер функции
670 
Возвращаемое значение:
671 
  * если буфер пуст, возвращается eax=1
1018 diamond 672 
  * если буфер непуст:
673 
    * старшие 24 бита eax содержат идентификатор кнопки
674 
      (в частности, в ah оказывается младший байт идентификатора;
675 
      если все кнопки имеют идентификатор, меньший 256,
676 
      то для различения достаточно ah)
677 
    * al = 0 - кнопка была нажата левой кнопкой мыши
678 
    * al = бит, соответствующий нажавшей кнопке мыши, если не левой
77 diamond 679 
Замечания:
680 
  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки
681 
    информация о старой теряется.
682 
  * При вызове этой функции приложением с неактивным окном
683 
    возвращается ответ "буфер пуст".
1018 diamond 684 
  * Возвращаемое значение al соответствует состоянию кнопок мыши
685 
    в формате подфункции 2 функции 37 в момент начала нажатия
686 
    на кнопку, за исключением младшего бита (соответствующего левой
687 
    кнопке мыши), который сбрасывается.
2268 Serge 688 
======================================================================
689 
= Функция 18, подфункция 1 - сделать самым нижним окно потока. =======
690 
======================================================================
691 
Параметры:
692 
  * eax = 18 - номер функции
693 
  * ebx = 1 - номер подфункции
694 
  * ecx = номер слота потока
695 
Возвращаемое значение:
696 
  * функция не возвращает значения
77 diamond 697 
 
698 
======================================================================
91 diamond 699 
==== Функция 18, подфункция 2 - завершить процесс/поток по слоту. ====
77 diamond 700 
======================================================================
701 
Параметры:
702 
  * eax = 18 - номер функции
703 
  * ebx = 2 - номер подфункции
704 
  * ecx = номер слота процесса/потока
705 
Возвращаемое значение:
706 
  * функция не возвращает значения
707 
Замечания:
708 
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
709 
    1), можно завершить любой обычный поток/процесс.
91 diamond 710 
  * Смотри также подфункцию 18 - завершение
711 
    процесса/потока с заданным идентификатором.
77 diamond 712 
 
713 
======================================================================
714 
= Функция 18, подфункция 3 - сделать активным окно заданного потока. =
715 
======================================================================
716 
Параметры:
717 
  * eax = 18 - номер функции
718 
  * ebx = 3 - номер подфункции
719 
  * ecx = номер слота потока
720 
Возвращаемое значение:
721 
  * функция не возвращает значения
722 
Замечания:
723 
  * При указании корректного, но несуществующего слота активизируется
724 
    какое-то окно.
725 
  * Узнать, какое окно является активным, можно вызовом подфункции 7.
726 
 
727 
======================================================================
2010 serge 728 
 Функция 18, подфункция 4 - получить счётчик пустых тактов в секунду.
77 diamond 729 
======================================================================
730 
Под пустыми тактами понимается время, в которое процессор простаивает
731 
в ожидании прерывания (в инструкции hlt).
732 
 
733 
Параметры:
734 
  * eax = 18 - номер функции
735 
  * ebx = 4 - номер подфункции
736 
Возвращаемое значение:
131 diamond 737 
  * eax = значение счётчика пустых тактов в секунду
77 diamond 738 
 
739 
======================================================================
740 
======== Функция 18, подфункция 5 - получить тактовую частоту. =======
741 
======================================================================
742 
Параметры:
743 
  * eax = 18 - номер функции
744 
  * ebx = 5 - номер подфункции
745 
Возвращаемое значение:
746 
  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)
747 
 
748 
======================================================================
2010 serge 749 
 Функция 18, подфункция 6 - сохранить рамдиск в файл на жёстком диске.
77 diamond 750 
======================================================================
751 
Параметры:
752 
  * eax = 18 - номер функции
753 
  * ebx = 6 - номер подфункции
341 heavyiron 754 
  * ecx = указатель на строку с полным именем файла
755 
    (например, "/hd0/1/kolibri/kolibri.img")
77 diamond 756 
Возвращаемое значение:
757 
  * eax = 0 - успешно
758 
  * иначе eax = код ошибки файловой системы
759 
Замечания:
131 diamond 760 
  * Все папки в указанном пути должны существовать, иначе вернётся
77 diamond 761 
    значение 5, "файл не найден".
762 
 
763 
======================================================================
764 
====== Функция 18, подфункция 7 - получить номер активного окна. =====
765 
======================================================================
766 
Параметры:
767 
  * eax = 18 - номер функции
768 
  * ebx = 7 - номер подфункции
769 
Возвращаемое значение:
770 
  * eax = номер активного окна (номер слота потока, окно которого
771 
    активно)
772 
Замечания:
773 
  * Активное окно находится вверху оконного стэка и получает
131 diamond 774 
    сообщения обо всём вводе с клавиатуры.
77 diamond 775 
  * Сделать окно активным можно вызовом подфункции 3.
776 
 
777 
======================================================================
778 
==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====
779 
======================================================================
131 diamond 780 
При отключённом звуке вызовы подфункции 55 функции 55 игнорируются.
781 
При включённом - направляются на встроенный спикер.
77 diamond 782 
 
783 
--------------- Подподфункция 1 - получить состояние. ----------------
784 
Параметры:
785 
  * eax = 18 - номер функции
786 
  * ebx = 8 - номер подфункции
787 
  * ecx = 1 - номер подподфункции
788 
Возвращаемое значение:
131 diamond 789 
  * eax = 0 - звук спикера разрешён; 1 - запрещён
77 diamond 790 
 
791 
-------------- Подподфункция 2 - переключить состояние. --------------
792 
Переключает состояния разрешения/запрещения.
793 
Параметры:
794 
  * eax = 18 - номер функции
795 
  * ebx = 8 - номер подфункции
796 
  * ecx = 2 - номер подподфункции
797 
Возвращаемое значение:
798 
  * функция не возвращает значения
799 
 
800 
======================================================================
1018 diamond 801 
= Функция 18, подфункция 9 - завершение работы системы с параметром. =
77 diamond 802 
======================================================================
803 
Параметры:
804 
  * eax = 18 - номер функции
805 
  * ebx = 9 - номер подфункции
806 
  * ecx = параметр:
807 
    * 2 = выключить компьютер
808 
    * 3 = перезагрузить компьютер
809 
    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске
810 
Возвращаемое значение:
811 
  * при неверном ecx регистры не меняются (т.е. eax=18)
812 
  * при правильном вызове всегда возвращается признак успеха eax=0
813 
Замечания:
814 
  * Не следует полагаться на возвращаемое значение при неверном
815 
    вызове, оно может измениться в последующих версиях ядра.
1018 diamond 816 
 
77 diamond 817 
======================================================================
818 
======== Функция 18, подфункция 10 - свернуть окно приложения. =======
819 
======================================================================
820 
Сворачивает собственное окно.
821 
Параметры:
822 
  * eax = 18 - номер функции
823 
  * ebx = 10 - номер подфункции
824 
Возвращаемое значение:
825 
  * функция не возвращает значения
826 
Замечания:
827 
  * Минимизированное окно с точки зрения функции 9 сохраняет положение
828 
    и размеры.
2010 serge 829 
  * Восстановление окна приложения происходит при активизировании
77 diamond 830 
    подфункцией 3.
131 diamond 831 
  * Обычно нет необходимости явно сворачивать/разворачивать своё окно:
77 diamond 832 
    сворачивание окна осуществляется системой при нажатии на кнопку
833 
    минимизации (которая для окон со скином определяется автоматически
131 diamond 834 
    функцией 0, для окон без скина её можно определить функцией 8),
77 diamond 835 
    восстановление - приложением @panel.
836 
 
837 
======================================================================
838 
====================== Функция 18, подфункция 11 =====================
839 
============= Получить информацию о дисковой подсистеме. =============
840 
======================================================================
841 
Параметры:
842 
  * eax = 18 - номер функции
843 
  * ebx = 11 - номер подфункции
844 
  * ecx = тип таблицы:
845 
    * 1 = короткая версия, 10 байт
846 
    * 2 = полная версия, 65536 байт
847 
  * edx = указатель на буфер (в приложении) для таблицы
848 
Возвращаемое значение:
849 
  * функция не возвращает значения
850 
Формат таблицы: короткая версия:
851 
  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,
131 diamond 852 
    где AAAA задаёт тип первого дисковода, BBBB - второго согласно
77 diamond 853 
    следующему списку:
854 
    * 0 = нет дисковода
855 
    * 1 = 360Kb, 5.25''
856 
    * 2 = 1.2Mb, 5.25''
857 
    * 3 = 720Kb, 3.5''
858 
    * 4 = 1.44Mb, 3.5''
859 
    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)
860 
    Например, для стандартной конфигурации из одного 1.44-дисковода
861 
    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:
862 
    значение оказывается 24h.
131 diamond 863 
  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,
77 diamond 864 
    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
865 
    * 0 = устройство отсутствует
131 diamond 866 
    * 1 = жёсткий диск
77 diamond 867 
    * 2 = CD-привод
868 
    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
131 diamond 869 
  * +2: 4 db: число найденных разделов на жёстких дисках с
77 diamond 870 
    соответственно IDE0,...,IDE3.
131 diamond 871 
    При отсутствии жёсткого диска на IDEx соответствующий байт
77 diamond 872 
    нулевой, при наличии показывает число распознанных разделов,
873 
    которых может и не быть (если носитель не отформатирован или
874 
    если файловая система не поддерживается). В текущей версии ядра
277 diamond 875 
    для жёстких дисков поддерживаются только FAT16, FAT32 и NTFS.
77 diamond 876 
  * +6: 4 db: зарезервировано
877 
Формат таблицы: полная версия:
878 
  * +0: 10 db: такие же, как и в короткой версии
879 
  * +10: 100 db: данные для первого раздела
880 
  * +110: 100 db: данные для второго раздела
881 
  * ...
882 
  * +10+100*(n-1): 100 db: данные для последнего раздела
883 
Разделы расположены в следующем порядке: сначала последовательно все
884 
распознанные разделы на HD на IDE0 (если есть),
885 
затем на HD на IDE1 (если есть) и т.д. до IDE3.
277 diamond 886 
Формат информации о разделе:
77 diamond 887 
  * +0: dword: начальный физический сектор раздела
888 
  * +4: dword: последний физический сектор раздела
889 
    (принадлежит разделу)
277 diamond 890 
  * +8: byte: тип файловой системы:
891 
    16=FAT16, 32=FAT32, 1=NTFS
892 
  * формат дальнейших данных зависит от файловой системы,
893 
    может меняться с изменениями в ядре и поэтому не описывается
77 diamond 894 
Замечания:
895 
  * Короткая таблица может быть использована для получения информации
896 
    об имеющихся устройствах.
897 
 
898 
======================================================================
899 
========== Функция 18, подфункция 13 - получить версию ядра. =========
900 
======================================================================
901 
Параметры:
902 
  * eax = 18 - номер функции
903 
  * ebx = 13 - номер подфункции
904 
  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена
905 
    информация
906 
Возвращаемое значение:
907 
  * функция не возвращает значения
908 
Структура буфера:
909 
db a,b,c,d для версии a.b.c.d
2010 serge 910 
db 0: зарезервировано
546 diamond 911 
dd REV - номер svn-ревизии ядра
2010 serge 912 
Для ядра Kolibri 0.7.7.0+:
913 
db 0,7,7,0
914 
db 0
915 
dd 1675
77 diamond 916 
 
917 
======================================================================
918 
====================== Функция 18, подфункция 14 =====================
131 diamond 919 
======= Ожидать начала обратного хода луча развёртки монитора. =======
77 diamond 920 
======================================================================
921 
Параметры:
922 
  * eax = 18 - номер функции
923 
  * ebx = 14 - номер подфункции
924 
Возвращаемое значение:
925 
  * eax = 0 как признак успеха
926 
Замечания:
927 
  * Функция предназначена исключительно для активных
928 
    высокопроизводительных графических приложений; используется для
929 
    плавного вывода графики.
930 
 
931 
======================================================================
932 
== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =
933 
======================================================================
934 
Параметры:
935 
  * eax = 18 - номер функции
936 
  * ebx = 15 - номер подфункции
937 
Возвращаемое значение:
938 
  * eax = 0 как признак успеха
939 
 
940 
======================================================================
941 
====================== Функция 18, подфункция 16 =====================
942 
============ Получить размер свободной оперативной памяти. ===========
943 
======================================================================
944 
Параметры:
945 
  * eax = 18 - номер функции
946 
  * ebx = 16 - номер подфункции
947 
Возвращаемое значение:
948 
  * eax = размер свободной памяти в килобайтах
949 
 
950 
======================================================================
951 
====================== Функция 18, подфункция 17 =====================
952 
============ Получить размер имеющейся оперативной памяти. ===========
953 
======================================================================
954 
Параметры:
955 
  * eax = 18 - номер функции
956 
  * ebx = 17 - номер подфункции
957 
Возвращаемое значение:
958 
  * eax = общий размер имеющейся памяти в килобайтах
959 
 
960 
======================================================================
91 diamond 961 
====================== Функция 18, подфункция 18 =====================
962 
============= Завершить процесс/поток по идентификатору. =============
85 halyavin 963 
======================================================================
964 
Параметры:
965 
  * eax = 18 - номер функции
966 
  * ebx = 18 - номер подфункции
91 diamond 967 
  * ecx = идентификатор процесса/потока (PID/TID)
968 
Возвращаемое значение:
969 
  * eax = 0 - успешно
970 
  * eax = -1 - ошибка (процесс не найден или является системным)
971 
Замечания:
972 
  * Нельзя завершить поток операционной системы OS/IDLE (номер слота
973 
    1), можно завершить любой обычный поток/процесс.
974 
  * Смотри также подфункцию 2 - завершение
975 
    процесса/потока по заданному слоту.
85 halyavin 976 
 
977 
======================================================================
131 diamond 978 
=== Функция 18, подфункция 19 - получить/установить настройки мыши. ==
120 mario79 979 
======================================================================
131 diamond 980 
 
981 
------------- Подподфункция 0 - получить скорость мыши. --------------
120 mario79 982 
Параметры:
983 
  * eax = 18 - номер функции
984 
  * ebx = 19 - номер подфункции
131 diamond 985 
  * ecx = 0 - номер подподфункции
986 
Возвращаемое значение:
987 
  * eax = текущая скорость мыши
120 mario79 988 
 
131 diamond 989 
------------ Подподфункция 1 - установить скорость мыши. -------------
990 
Параметры:
991 
  * eax = 18 - номер функции
992 
  * ebx = 19 - номер подфункции
993 
  * ecx = 1 - номер подподфункции
994 
  * edx = новое значение скорости
995 
Возвращаемое значение:
996 
  * функция не возвращает значения
120 mario79 997 
 
131 diamond 998 
------------- Подподфункция 2 - получить задержку мыши. --------------
999 
Параметры:
1000 
  * eax = 18 - номер функции
1001 
  * ebx = 19 - номер подфункции
1002 
  * ecx = 2 - номер подподфункции
1003 
Возвращаемое значение:
1004 
  * eax = текущая задержка мыши
120 mario79 1005 
 
131 diamond 1006 
------------ Подподфункция 3 - установить задержку мыши. -------------
1007 
Параметры:
1008 
  * eax = 18 - номер функции
1009 
  * ebx = 19 - номер подфункции
1010 
  * ecx = 3 - номер подподфункции
1011 
  * edx = новое значение задержки мыши
1012 
Возвращаемое значение:
1013 
  * функция не возвращает значения
120 mario79 1014 
 
131 diamond 1015 
-------- Подподфункция 4 - установить положение курсора мыши. --------
1016 
Параметры:
1017 
  * eax = 18 - номер функции
1018 
  * ebx = 19 - номер подфункции
1019 
  * ecx = 4 - номер подподфункции
1020 
  * edx = [координата по оси x]*65536 + [координата по оси y]
1021 
Возвращаемое значение:
1022 
  * функция не возвращает значения
621 mario79 1023 
 
641 diamond 1024 
------- Подподфункция 5 - симулировать состояние клавиш мыши. --------
621 mario79 1025 
Параметры:
1026 
  * eax = 18 - номер функции
1027 
  * ebx = 19 - номер подфункции
1028 
  * ecx = 5 - номер подподфункции
641 diamond 1029 
  * edx = информация о эмулируемом состоянии кнопок мыши:
1030 
    (соответствует возвращаемому значению подфункции 2 функции 37)
1031 
    * бит 0 установлен = левая кнопка нажата
1032 
    * бит 1 установлен = правая кнопка нажата
1033 
    * бит 2 установлен = средняя кнопка нажата
1034 
    * бит 3 установлен = 4-я кнопка нажата
1035 
    * бит 4 установлен = 5-я кнопка нажата
621 mario79 1036 
Возвращаемое значение:
1037 
  * функция не возвращает значения
120 mario79 1038 
Замечания:
131 diamond 1039 
  * Рекомендуемая скорость мыши (в подподфункции 1) от 1 до 9.
1040 
    Устанавливаемая величина не проверяется кодом ядра, поэтому
1041 
    используйте осторожно, при некорректном значении курсор может
1042 
    "замёрзнуть". Скорость мыши можно регулировать в приложении SETUP.
1043 
  * Рекомендуемая величина задержки (в подподфункции 3) = 10.
1044 
    Меньшие значения не обрабатываются COM-мышами. При очень больших
1045 
    значениях невозможно передвижение мыши на 1 пиксель и курсор будет
1046 
    прыгать на величину установленной скорости (подподфункция 1).
1047 
    Устанавливаемая величина не проверяется кодом ядра.
133 diamond 1048 
    Величину задержки можно менять в приложении SETUP.
131 diamond 1049 
  * Подподфункция 4 не проверяет переданное значение. Перед вызовом
1050 
    необходимо узнать текущее разрешение экрана (подфункцией 14)
1051 
    и проверить, что устанавливаемое положение не выходит за пределы
1052 
    экрана.
120 mario79 1053 
 
1054 
======================================================================
172 serge 1055 
====================== Функция 18, подфункция 20 =====================
1056 
============= Получить информацию об оперативной памяти. =============
1057 
======================================================================
1058 
Параметры:
1059 
  * eax = 18 - номер функции
1060 
  * ebx = 20 - номер подфункции
1061 
  * ecx = указатель на буфер для информации (36 байт)
1062 
Возвращаемое значение:
1063 
  * eax = общий размер имеющейся оперативной памяти в байтах
1064 
    или -1 в случае ошибки
1065 
  * буфер, на который указывает ecx, содержит следующую информацию:
277 diamond 1066 
    * +0: dword: общий размер имеющейся оперативной памяти в страницах
172 serge 1067 
    * +4:  dword: размер свободной оперативной памяти в страницах
1068 
    * +8:  dword: число страничных ошибок (исключений #PF)
1069 
                 в приложениях
1070 
    * +12: dword: размер кучи ядра в байтах
277 diamond 1071 
    * +16: dword: размер свободной памяти в куче ядра в байтах
172 serge 1072 
    * +20: dword: общее количество блоков памяти в куче ядра
277 diamond 1073 
    * +24: dword: количество свободных блоков памяти в куче ядра
172 serge 1074 
    * +28: dword: размер наибольшего свободного блока в куче ядра
277 diamond 1075 
                 (зарезервировано)
1076 
    * +32: dword: размер наибольшего выделенного блока в куче ядра
1077 
                 (зарезервировано)
172 serge 1078 
 
1079 
======================================================================
608 alver 1080 
====================== Функция 18, подфункция 21 =====================
641 diamond 1081 
======= Получить номер слота процесса/потока по идентификатору. ======
608 alver 1082 
======================================================================
1083 
Параметры:
1084 
  * eax = 18 - номер функции
1085 
  * ebx = 21 - номер подфункции
641 diamond 1086 
  * ecx = идентификатор процесса/потока (PID/TID)
608 alver 1087 
Возвращаемое значение:
641 diamond 1088 
  * eax = 0 - ошибка (неверный идентификатор)
1089 
  * иначе eax = номер слота
608 alver 1090 
 
1091 
======================================================================
2010 serge 1092 
 Функция 18, подфункция 22 - операции с окном другого процесса/потока.
608 alver 1093 
======================================================================
1094 
Параметры:
1095 
  * eax = 18 - номер функции
1096 
  * ebx = 22 - номер подфункции
641 diamond 1097 
  * ecx = тип операции:
1098 
    * 0 = минимизация окна, поток задан номером слота
1099 
    * 1 = минимизация окна, поток задан идентификатором
1100 
    * 2 = восстановление окна, поток задан номером слота
1101 
    * 3 = восстановление окна, поток задан идентификатором
1102 
  * edx = параметр операции (номер слота или PID/TID)
608 alver 1103 
Возвращаемое значение:
641 diamond 1104 
  * eax = 0 - успешно
1105 
  * eax = -1 - ошибка (неправильный параметр)
1106 
Замечания:
1107 
  * Поток может свернуть своё окно вызовом подфункции 10.
1108 
  * Восстановление окна с одновременной активизацией осуществляется
1109 
    подфункции 3 (принимающей номер слота).
608 alver 1110 
 
1111 
======================================================================
2987 Serge 1112 
======= Функция 18, подфункция 23 - минимизировать все окна. =========
1113 
======================================================================
1114 
Параметры:
1115 
  * eax = 18 - номер функции
1116 
  * ebx = 23 - номер подфункции
1117 
Возвращаемое значение:
1118 
  * eax = 0 - все окна были минимизированы до вызова функции
1119 
  * eax = N - количество окон свернутых функцией
1120 
Замечания:
1121 
  * Окна спец. потоков (имя начинается с символа @) не сворачиваются.
1122 
 
1123 
======================================================================
1124 
===== Функция 18, подфункция 24 - установить пределы отрисовки. ======
1125 
======================================================================
1126 
Параметры:
1127 
  * eax = 18 - номер функции
1128 
  * ebx = 24 - номер подфункции
1129 
  * ecx = новый размер по X
1130 
  * edx = новый размер по Y
1131 
Возвращаемое значение:
1132 
  * функция не возвращает значения
1133 
Замечания:
1134 
  * Функция не меняет физический размер видеорежима. Она предназначена
1135 
    для нестандартных дисплеев, отображающих изображение частично.
1136 
  * Размеры указываемые в функции не должны превышать размеры текущего
1137 
    видеорежима, иначе функция ничего не изменит.
1138 
 
1139 
======================================================================
77 diamond 1140 
==================== Функция 20 - интерфейс MIDI. ====================
1141 
======================================================================
1142 
 
1143 
------------------------ Подфункция 1 - сброс ------------------------
1144 
Параметры:
1145 
  * eax = 20 - номер функции
1146 
  * ebx = 1 - номер подфункции
1147 
 
1148 
-------------------- Подфункция 2 - вывести байт ---------------------
1149 
Параметры:
1150 
  * eax = 20 - номер функции
1151 
  * ebx = 2 - номер подфункции
1152 
  * cl = байт для вывода
1153 
Возвращаемое значение (одинаково для обеих подфункций):
1154 
  * eax = 0 - успешно
131 diamond 1155 
  * eax = 1 - не определён базовый порт
77 diamond 1156 
Замечания:
2010 serge 1157 
  * Предварительно должен быть определён базовый порт вызовом
77 diamond 1158 
    подфункции 1 функции 21.
1159 
 
1160 
======================================================================
1161 
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
1162 
======================================================================
1163 
Параметры:
1164 
  * eax = 21 - номер функции
1165 
  * ebx = 1 - номер подфункции
1166 
  * ecx = номер базового порта
1167 
Возвращаемое значение:
1168 
  * eax = 0 - успешно
1169 
  * eax = -1 - ошибочный номер порта
1170 
Замечания:
1171 
  * Номер порта должен удовлетворять условиям 0x100<=ecx<=0xFFFF.
1172 
  * Установка базы нужна для работы функции 20.
2010 serge 1173 
  * Получить установленный базовый порт можно вызовом
77 diamond 1174 
    подфункции 1 функции 26.
1175 
 
1176 
======================================================================
1177 
===== Функция 21, подфункция 2 - установить раскладку клавиатуры. ====
1178 
======================================================================
1179 
Раскладка клавиатуры используется для преобразования сканкодов,
1180 
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1181 
Параметры:
1182 
  * eax = 21 - номер функции
1183 
  * ebx = 2 - номер подфункции
1184 
  * ecx = какую раскладку устанавливать:
1185 
    * 1 = нормальную
1186 
    * 2 = раскладку при нажатом Shift
1187 
    * 3 = раскладку при нажатом Alt
1188 
  * edx = указатель на раскладку - таблицу длиной 128 байт
1189 
Или:
1190 
  * ecx = 9
1191 
  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1192 
Возвращаемое значение:
1193 
  * eax = 0 - успешно
1194 
  * eax = 1 - параметр задан неверно
1195 
Замечания:
1196 
  * Если нажат Alt, то используется раскладка с Alt;
1197 
    если не нажат Alt, но нажат Shift, то
1198 
    используется раскладка с Shift;
1199 
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1200 
    нормальная раскладка, после чего из кода вычитается 0x60;
1201 
    если не нажата ни одна из управляющих клавиш, то используется
1202 
    нормальная раскладка.
2010 serge 1203 
  * Получить раскладки и идентификатор страны можно с помощью
77 diamond 1204 
    подфункции 2 функции 26.
1205 
  * Идентификатор страны - глобальная системная переменная, которая
1206 
    самим ядром не используется; однако приложение @panel отображает
1207 
    соответствующую текущей стране иконку.
1208 
  * Приложение @panel переключает раскладки по запросу пользователя.
1209 
 
1210 
======================================================================
1211 
=========== Функция 21, подфункция 3 - установить базу CD. ===========
1212 
======================================================================
1213 
Параметры:
1214 
  * eax = 21 - номер функции
1215 
  * ebx = 3 - номер подфункции
1216 
  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1217 
Возвращаемое значение:
1218 
  * eax = 0
1219 
Замечания:
1220 
  * База CD используется функцией 24.
2010 serge 1221 
  * Получить установленную базу CD можно вызовом
77 diamond 1222 
    подфункции 3 функции 26.
1223 
 
1224 
======================================================================
1225 
========= Функция 21, подфункция 5 - установить язык системы. ========
1226 
======================================================================
1227 
Параметры:
1228 
  * eax = 21 - номер функции
1229 
  * ebx = 5 - номер подфункции
1230 
  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1231 
Возвращаемое значение:
1232 
  * eax = 0
1233 
Замечания:
1234 
  * Язык системы - глобальная системная переменная, никак
1235 
    не используемая самим ядром, однако приложение @panel рисует
1236 
    соответствующую иконку.
1237 
  * Проверок на корректность не делается, поскольку ядро эту
1238 
    переменную не использует.
1239 
  * Получить язык системы можно вызовом подфункции 5 функции 26.
1240 
 
1241 
======================================================================
1242 
=========== Функция 21, подфункция 7 - установить базу HD. ===========
1243 
======================================================================
131 diamond 1244 
База HD нужна для определения, на какой жёсткий диск писать, при
346 diamond 1245 
использовании устаревшего синтаксиса /HD в устаревшей функции 58;
1246 
при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
1247 
база устанавливается автоматически.
77 diamond 1248 
Параметры:
1249 
  * eax = 21 - номер функции
1250 
  * ebx = 7 - номер подфункции
1251 
  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1252 
Возвращаемое значение:
1253 
  * eax = 0
1254 
Замечания:
1255 
  * Любое приложение в любой момент времени может изменить базу.
1256 
  * Не следует изменять базу, когда какое-нибудь приложение работает
131 diamond 1257 
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1258 
  * Получить установленную базу можно вызовом подфункции 7 функции 26.
2010 serge 1259 
  * Следует также определить используемый раздел жёсткого диска
77 diamond 1260 
    подфункцией 8.
1261 
 
1262 
======================================================================
1263 
========== Функция 21, подфункция 8 - установить раздел HD. ==========
1264 
======================================================================
131 diamond 1265 
Раздел HD нужен для определения, на какой раздел жёсткого диска
346 diamond 1266 
писать, при использовании устаревшего синтаксиса /HD в устаревшей
1267 
функции 58; при использовании современного синтаксиса
1268 
/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
77 diamond 1269 
Параметры:
1270 
  * eax = 21 - номер функции
1271 
  * ebx = 8 - номер подфункции
1272 
  * ecx = раздел HD (считая с 1)
1273 
Возвращаемое значение:
1274 
  * eax = 0
1275 
Замечания:
1276 
  * Любое приложение в любой момент времени может изменить раздел.
1277 
  * Не следует изменять раздел, когда какое-нибудь приложение работает
131 diamond 1278 
    с жёстким диском. Если не хотите глюков системы.
77 diamond 1279 
  * Получить установленный раздел можно вызовом подфункции 8
1280 
    функции 26.
1281 
  * Проверок на корректность не делается.
2010 serge 1282 
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1283 
    подфункции 11 функции 18.
2010 serge 1284 
  * Следует также определить используемую базу жёсткого диска
77 diamond 1285 
    подфункцией 7.
1286 
 
1287 
======================================================================
1288 
====================== Функция 21, подфункция 11 =====================
1289 
=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
1290 
======================================================================
1291 
Параметры:
1292 
  * eax = 21 - номер функции
1293 
  * ebx = 11 - номер подфункции
1294 
  * ecx = 0/1 - запретить/разрешить
1295 
Возвращаемое значение:
1296 
  * eax = 0
1297 
Замечания:
1298 
  * Используется при LBA-чтении (подфункция 8 функции 58).
1299 
  * Текущая реализация использует только младший бит ecx.
1300 
  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
1301 
 
1302 
======================================================================
1303 
====================== Функция 21, подфункция 12 =====================
1304 
========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
1305 
======================================================================
1306 
Параметры:
1307 
  * eax = 21 - номер функции
1308 
  * ebx = 12 - номер подфункции
1309 
  * ecx = 0/1 - запретить/разрешить
1310 
Возвращаемое значение:
1311 
  * eax = 0
1312 
Замечания:
1313 
  * Используется при работе с шиной PCI (функция 62).
1314 
  * Текущая реализация использует только младший бит ecx.
1315 
  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
1316 
 
1317 
======================================================================
1318 
============= Функция 21, подфункция 13, подподфункция 1 =============
1319 
==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
1320 
======================================================================
1321 
Параметры:
1322 
  * eax = 21 - номер функции
1323 
  * ebx = 13 - номер подфункции
1324 
  * ecx = 1 - номер функции драйвера
1325 
  * edx = указатель на буфер размера 512 байт
1326 
Возвращаемое значение:
1327 
  * если драйвер не загружен (никогда не бывает в текущей реализации):
1328 
    * eax = -1
1329 
    * ebx, ecx разрушаются
1330 
  * если драйвер загружен:
1331 
    * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт,
1332 
      'Z' - старший) - сигнатура
131 diamond 1333 
    * ebx = текущая частота развёртки (в Гц)
77 diamond 1334 
    * ecx разрушается
1335 
    * буфер, на который указывает edx, заполнен
1336 
Формат буфера:
1337 
  * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек,
1338 
    дополнено пробелами)
1339 
  * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как
1340 
    y*65536+x), для текущей реализации 1 (1.0)
1341 
  * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации)
1342 
  * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое
1343 
    слово - номер видеорежима, после собственно списка идут нули)
131 diamond 1344 
  * +128 = +0x80: 32*(5*word): список поддерживаемых частот развёрток
77 diamond 1345 
    для видеорежимов: для каждого видеорежима, указанного в предыдущем
1346 
    поле, указано до 5 поддерживаемых частот
1347 
    (в неиспользуемых позициях записаны нули)
1348 
Замечания:
131 diamond 1349 
  * Функция инициализирует драйвер (если он ещё не инициализирован)
77 diamond 1350 
    и должна вызываться первой, перед остальными (иначе они будут
1351 
    возвращать -1, ничего не делая).
131 diamond 1352 
  * В текущей реализации поддерживается только одна частота развёртки
77 diamond 1353 
    на видеорежим.
1354 
 
1355 
======================================================================
1356 
============= Функция 21, подфункция 13, подподфункция 2 =============
1357 
============= Получить информацию о текущем видеорежиме. =============
1358 
======================================================================
1359 
Параметры:
1360 
  * eax = 21 - номер функции
1361 
  * ebx = 13 - номер подфункции
1362 
  * ecx = 2 - номер функции драйвера
1363 
Возвращаемое значение:
1364 
  * eax = -1 - драйвер не загружен или не инициализирован;
1365 
    ebx,ecx разрушаются
1366 
  * eax = [ширина]*65536 + [высота]
131 diamond 1367 
  * ebx = частота вертикальной развёртки (в Гц)
77 diamond 1368 
  * ecx = номер текущего видеорежима
1369 
Замечания:
2010 serge 1370 
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1371 
    функции драйвера 1.
1372 
  * Если нужны только размеры экрана, целесообразней использовать
131 diamond 1373 
    функцию 14 с учётом того, что она возвращает размеры на 1 меньше.
77 diamond 1374 
 
1375 
======================================================================
2010 serge 1376 
= Функция 21, подфункция 13, подподфункция 3 - установить видеорежим.
77 diamond 1377 
======================================================================
1378 
Параметры:
1379 
  * eax = 21 - номер функции
1380 
  * ebx = 13 - номер подфункции
1381 
  * ecx = 3 - номер функции драйвера
131 diamond 1382 
  * edx = [частота развёртки]*65536 + [номер видеорежима]
77 diamond 1383 
Возвращаемое значение:
1384 
  * eax = -1 - драйвер не загружен, не инициализирован или
1385 
    произошла ошибка
1386 
  * eax = 0 - успешно
1387 
  * ebx, ecx разрушаются
1388 
Замечания:
2010 serge 1389 
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1390 
    функции драйвера 1.
1391 
  * Номер видеорежима и частота должны быть в таблице, возвращаемой
1392 
    функцией драйвера 1.
1393 
 
1394 
======================================================================
1395 
============= Функция 21, подфункция 13, подподфункция 4 =============
1396 
================= Вернуться к начальному видеорежиму. ================
1397 
======================================================================
1398 
Возвращает экран в видеорежим, установленный при загрузке системы.
1399 
Параметры:
1400 
  * eax = 21 - номер функции
1401 
  * ebx = 13 - номер подфункции
1402 
  * ecx = 4 - номер функции драйвера
1403 
Возвращаемое значение:
1404 
  * eax = -1 - драйвер не загружен или не инициализирован
1405 
  * eax = 0 - успешно
1406 
  * ebx, ecx разрушаются
1407 
Замечания:
2010 serge 1408 
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1409 
    функции драйвера 1.
1410 
 
1411 
======================================================================
1412 
============= Функция 21, подфункция 13, подподфункция 5 =============
1413 
======== Увеличить/уменьшить размер видимой области монитора. ========
1414 
======================================================================
1415 
Параметры:
1416 
  * eax = 21 - номер функции
1417 
  * ebx = 13 - номер подфункции
1418 
  * ecx = 5 - номер функции драйвера
1419 
  * edx = 0/1 - уменьшить/увеличить размер по горизонтали
1420 
    на одну позицию
1421 
  * edx = 2/3 - в текущей реализации не поддерживается; планируется
1422 
    как уменьшение/увеличение размера по вертикали на одну позицию
1423 
Возвращаемое значение:
1424 
  * eax = -1 - драйвер не загружен или не инициализирован
1425 
  * eax = 0 - успешно
1426 
  * ebx, ecx разрушаются
1427 
Замечания:
2010 serge 1428 
  * Драйвер предварительно должен быть инициализирован вызовом
77 diamond 1429 
    функции драйвера 1.
1430 
  * Функция влияет только на физический размер изображения
1431 
    на мониторе; логический размер (число пикселей) не меняется.
1432 
 
1433 
======================================================================
1434 
============ Функция 22 - установить системную дату/время. ===========
1435 
======================================================================
1436 
Параметры:
1437 
  * eax = 22 - номер функции
1438 
  * ebx = 0 - установить время
1439 
    * ecx = 0x00SSMMHH - время в двоично-десятичном коде (BCD):
1440 
    * HH=час 00..23
1441 
    * MM=минута 00..59
1442 
    * SS=секунда 00..59
1443 
  * ebx = 1 - установить дату
1444 
    * ecx = 0x00DDMMYY - дата в двоично-десятичном коде (BCD):
1445 
    * DD=день 01..31
1446 
    * MM=месяц 01..12
1447 
    * YY=год 00..99
1448 
  * ebx = 2 - установить день недели
1449 
    * ecx = 1 для воскресенья, ..., 7 для субботы
1450 
  * ebx = 3 - установить будильник
1451 
    * ecx = 0x00SSMMHH
1452 
Возвращаемое значение:
1453 
  * eax = 0 - успешно
1454 
  * eax = 1 - параметр задан неверно
1455 
  * eax = 2 - CMOS-батарейки разрядились
1456 
Замечания:
1457 
  * Ценность установки дня недели представляется сомнительной,
1458 
    поскольку он мало где используется
1459 
    (день недели можно рассчитать по дате).
1460 
  * Будильник можно установить на срабатывание в заданное время
1461 
    каждые сутки. При этом отключить его существующими системными
1462 
    функциями нельзя.
1463 
  * Срабатывание будильника заключается в генерации IRQ8.
1464 
  * Вообще-то CMOS поддерживает для будильника установку значения
1465 
    0xFF в качестве одного из параметров и означает это, что
1466 
    соответствующий параметр игнорируется. Но в текущей реализации
131 diamond 1467 
    это не пройдёт (вернётся значение 1).
77 diamond 1468 
  * Будильник - глобальный системный ресурс; установка будильника
1469 
    автоматически отменяет предыдущую установку. Впрочем, на данный
1470 
    момент ни одна программа его не использует.
1471 
 
1472 
======================================================================
1473 
============== Функция 23 - ожидать события с таймаутом. =============
1474 
======================================================================
131 diamond 1475 
Если очередь сообщений пуста, ждёт появления сообщения в очереди,
77 diamond 1476 
но не более указанного времени. Затем считывает сообщение из очереди.
1477 
 
1478 
Параметры:
1479 
  * eax = 23 - номер функции
1480 
  * ebx = таймаут (в сотых долях секунды)
1481 
Возвращаемое значение:
1482 
  * eax = 0 - очередь сообщений пуста
1483 
  * иначе eax = событие (смотри список событий)
1484 
Замечания:
1485 
  * Учитываются только те события, которые входят в маску,
1486 
    устанавливаемую функцией 40. По умолчанию это события
1487 
    перерисовки, нажатия на клавиши и на кнопки.
1488 
  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.
1489 
    Чтобы ждать сколь угодно долго, используйте функцию 10.
1490 
  * Передача ebx=0 приводит к моментальному возвращению eax=0.
131 diamond 1491 
  * При текущей реализации произойдёт немедленный возврат из функции
1492 
    с eax=0, если сложение ebx с текущим значением счётчика времени
77 diamond 1493 
    вызовет 32-битное переполнение.
1494 
 
1495 
======================================================================
1496 
======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ======
1497 
======================================================================
1498 
Параметры:
1499 
  * eax = 24 - номер функции
1500 
  * ebx = 1 - номер подфункции
1501 
  * ecx = 0x00FRSSMM, где
1502 
    * MM = начальная минута
1503 
    * SS = начальная секунда
1504 
    * FR = начальный фрейм
1505 
Возвращаемое значение:
1506 
  * eax = 0 - успешно
1507 
  * eax = 1 - не определена база CD
1508 
Замечания:
2010 serge 1509 
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1510 
    подфункции 3 функции 21.
1511 
  * В секунде 75 фреймов, в минуте 60 секунд.
1512 
  * Функция асинхронна (возвращает управление, когда началось
1513 
    проигрывание).
1514 
 
1515 
======================================================================
1516 
===== Функция 24, подфункция 2 - получить информацию о дорожках. =====
1517 
======================================================================
1518 
Параметры:
1519 
  * eax = 24 - номер функции
1520 
  * ebx = 2 - номер подфункции
1521 
  * ecx = указатель на буфер для таблицы
1522 
    (максимум 8*64h+4 байт=100 дорожек)
1523 
Возвращаемое значение:
1524 
  * eax = 0 - успешно
1525 
  * eax = 1 - не определена база CD
1526 
Замечания:
1527 
  * Формат таблицы с информацией о дорожках такой же, как и для
1528 
    ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h).
1529 
    Адреса возвращаются в формате MSF.
2010 serge 1530 
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1531 
    подфункции 3 функции 21.
1532 
  * Функция возвращает информацию только о не более чем 100
1533 
    первых дорожках. В большинстве случаев этого достаточно.
1534 
 
1535 
======================================================================
1536 
==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. ===
1537 
======================================================================
1538 
Параметры:
1539 
  * eax = 24 - номер функции
1540 
  * ebx = 1 - номер подфункции
1541 
Возвращаемое значение:
1542 
  * eax = 0 - успешно
1543 
  * eax = 1 - не определена база CD
1544 
Замечания:
2010 serge 1545 
  * Предварительно нужно определить базовый порт CD вызовом
77 diamond 1546 
    подфункции 3 функции 21.
1547 
 
1548 
======================================================================
641 diamond 1549 
======= Функция 24, подфункция 4 - извлечь лоток привода диска. ======
588 diamond 1550 
======================================================================
1551 
Параметры:
1552 
  * eax = 24 - номер функции
1553 
  * ebx = 4 - номер подфункции
641 diamond 1554 
  * ecx = номер CD/DVD-диска
1555 
      (от 0=Primary Master до 3=Secondary Slave)
588 diamond 1556 
Возвращаемое значение:
641 diamond 1557 
  * функция не возвращает значения
588 diamond 1558 
Замечания:
641 diamond 1559 
  * Функция поддерживается только для ATAPI-устройств (CD и DVD).
1560 
  * При извлечении лотка производится разблокировка ручного управления
1561 
    механизмом лотка.
1562 
  * При извлечении лотка код производит очистку кэша соответствующего
1563 
    устройства.
588 diamond 1564 
  * Примером использования функции является приложение CD_tray.
1565 
 
1566 
======================================================================
641 diamond 1567 
====== Функция 24, подфункция 5 - загрузить лоток привода диска. =====
588 diamond 1568 
======================================================================
1569 
Параметры:
1570 
  * eax = 24 - номер функции
1571 
  * ebx = 5 - номер подфункции
641 diamond 1572 
  * ecx = номер CD/DVD-диска
1573 
      (от 0=Primary Master до 3=Secondary Slave)
588 diamond 1574 
Возвращаемое значение:
641 diamond 1575 
  * функция не возвращает значения
588 diamond 1576 
Замечания:
641 diamond 1577 
  * Функция поддерживается только для ATAPI-устройств (CD и DVD).
588 diamond 1578 
  * Примером использования функции является приложение CD_tray.
1579 
 
1580 
======================================================================
2987 Serge 1581 
========== Функция 25 - записать область на слой фона. ===============
1582 
======================================================================
1583 
Параметры:
1584 
  * eax = 25 - номер функции
1585 
  * ebx = указатель на предварительно выделенную область памяти,
1586 
      где размещено исходное изображение в формате BBGGRRTTBBGGRRTT...
1587 
  * ecx = [размер по оси x]*65536 + [размер по оси y]
1588 
  * edx = [координата по оси x]*65536 + [координата по оси y]
1589 
Возвращаемое значение:
1590 
  * функция не возвращает значения
1591 
Замечания:
1592 
  * Координаты области - это координаты верхнего левого угла
1593 
    области относительно экрана.
1594 
  * Размер изображения в байтах есть 4*xsize*ysize.
1595 
  * TT - байт указатель прозрачности, в настоящее время:
1596 
         от 1 до FF - непрозрачно, от 0 - прозрачно.
1597 
  * Функция размещает изображение не на фоновое изображение (ф.15),
1598 
    а напрямую в LFB. Опции ф.15 для ф. 25 не имеют смысла.
1599 
 
1600 
======================================================================
77 diamond 1601 
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
1602 
======================================================================
1603 
Параметры:
1604 
  * eax = 26 - номер функции
1605 
  * ebx = 1 - номер подфункции
1606 
Возвращаемое значение:
1607 
  * eax = номер порта
1608 
Замечания:
2010 serge 1609 
  * Установить базовый порт можно вызовом
77 diamond 1610 
    подфункции 1 функции 21.
1611 
 
1612 
======================================================================
1613 
====== Функция 26, подфункция 2 - получить раскладку клавиатуры. =====
1614 
======================================================================
1615 
Раскладка клавиатуры используется для преобразования сканкодов,
1616 
поступающих от клавиатуры, в ASCII-коды, считываемые функцией 2.
1617 
Параметры:
1618 
  * eax = 26 - номер функции
1619 
  * ebx = 2 - номер подфункции
1620 
  * ecx = какую раскладку получать:
1621 
    * 1 = нормальную
1622 
    * 2 = раскладку при нажатом Shift
1623 
    * 3 = раскладку при нажатом Alt
1624 
  * edx = указатель на буфер длиной 128 байт, куда будет скопирована
1625 
    раскладка
1626 
Возвращаемое значение:
1627 
  * функция не возвращает значения
1628 
Или:
1629 
  * eax = 26 - номер функции
1630 
  * ebx = 2 - номер подфункции
1631 
  * ecx = 9
1632 
Возвращаемое значение:
1633 
  * eax = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
1634 
Замечания:
1635 
  * Если нажат Alt, то используется раскладка с Alt;
1636 
    если не нажат Alt, но нажат Shift, то используется
1637 
    раскладка с Shift;
1638 
    если не нажаты Alt и Shift, но нажат Ctrl, то используется
1639 
    нормальная раскладка, после чего из кода вычитается 0x60;
1640 
    если не нажата ни одна из управляющих клавиш, то используется
1641 
    нормальная раскладка.
2010 serge 1642 
  * Установить раскладки и идентификатор страны можно с помощью
77 diamond 1643 
    подфункции 2 функции 21.
1644 
  * Идентификатор страны - глобальная системная переменная, которая
1645 
    самим ядром не используется; однако приложение @panel отображает
1646 
    соответствующую текущей стране иконку
1647 
    (используя описываемую функцию).
1648 
  * Приложение @panel переключает раскладки по запросу пользователя.
1649 
 
1650 
======================================================================
1651 
============ Функция 26, подфункция 3 - получить базу CD. ============
1652 
======================================================================
1653 
Параметры:
1654 
  * eax = 26 - номер функции
1655 
  * ebx = 3 - номер подфункции
1656 
Возвращаемое значение:
1657 
  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1658 
Замечания:
1659 
  * База CD используется функцией 24.
114 mikedld 1660 
  * Установить базу CD можно вызовом подфункции 3 функции 21.
77 diamond 1661 
 
1662 
======================================================================
1663 
========== Функция 26, подфункция 5 - получить язык системы. =========
1664 
======================================================================
1665 
Параметры:
1666 
  * eax = 26 - номер функции
1667 
  * ebx = 5 - номер подфункции
1668 
Возвращаемое значение:
1669 
  * eax = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
1670 
Замечания:
1671 
  * Язык системы - глобальная системная переменная, никак
1672 
    не используемая самим ядром, однако приложение @panel рисует
1673 
    соответствующую иконку (используя описываемую функцию).
1674 
  * Установить язык системы можно вызовом подфункции 5 функции 21.
1675 
 
1676 
======================================================================
1677 
============ Функция 26, подфункция 7 - получить базу HD. ============
1678 
======================================================================
131 diamond 1679 
База HD нужна для определения, на какой жёсткий диск писать, при
346 diamond 1680 
использовании устаревшего синтаксиса /HD в устаревшей функции 58;
1681 
при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
1682 
база устанавливается автоматически.
77 diamond 1683 
Параметры:
1684 
  * eax = 26 - номер функции
1685 
  * ebx = 7 - номер подфункции
1686 
Возвращаемое значение:
1687 
  * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
1688 
Замечания:
1689 
  * Любое приложение в любой момент времени может изменить базу.
1690 
  * Установить базу можно вызовом подфункции 7 функции 21.
131 diamond 1691 
  * Получить используемый раздел жёсткого диска можно подфункцией 8.
77 diamond 1692 
 
1693 
======================================================================
1694 
=========== Функция 26, подфункция 8 - получить раздел HD. ===========
1695 
======================================================================
131 diamond 1696 
Раздел HD нужен для определения, на какой раздел жёсткого диска
346 diamond 1697 
писать, при использовании устаревшего синтаксиса /HD в устаревшей
1698 
функции 58; при использовании современного синтаксиса
1699 
/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
77 diamond 1700 
Параметры:
1701 
  * eax = 26 - номер функции
1702 
  * ebx = 8 - номер подфункции
1703 
Возвращаемое значение:
1704 
  * eax = раздел HD (считая с 1)
1705 
Замечания:
1706 
  * Любое приложение в любой момент времени может изменить раздел.
1707 
  * Установить раздел можно вызовом подфункции 8 функции 21.
131 diamond 1708 
  * Узнать число разделов на жёстком диске можно вызовом
77 diamond 1709 
    подфункции 11 функции 18.
131 diamond 1710 
  * Получить используемую базу жёсткого диска можно подфункцией 7.
77 diamond 1711 
 
1712 
======================================================================
131 diamond 1713 
=== Функция 26, подфункция 9 - получить значение счётчика времени. ===
77 diamond 1714 
======================================================================
1715 
Параметры:
1716 
  * eax = 26 - номер функции
1717 
  * ebx = 9 - номер подфункции
1718 
Возвращаемое значение:
1719 
  * eax = число сотых долей секунды, прошедших с момента
1720 
    запуска системы
1721 
Замечания:
131 diamond 1722 
  * Счётчик берётся по модулю 2^32, что соответствует немногим более
77 diamond 1723 
    497 суток.
1724 
  * Системное время можно получить функцией 3.
1725 
 
1726 
======================================================================
1727 
====================== Функция 26, подфункция 11 =====================
131 diamond 1728 
=========== Узнать, разрешён ли низкоуровневый доступ к HD. ==========
77 diamond 1729 
======================================================================
1730 
Параметры:
1731 
  * eax = 26 - номер функции
1732 
  * ebx = 11 - номер подфункции
1733 
Возвращаемое значение:
131 diamond 1734 
  * eax = 0/1 - запрещён/разрешён
77 diamond 1735 
Замечания:
1736 
  * Используется при LBA-чтении (подфункция 8 функции 58).
2010 serge 1737 
  * Установить текущее состояние можно вызовом
77 diamond 1738 
    подфункции 11 функции 21.
1739 
 
1740 
======================================================================
1741 
====================== Функция 26, подфункция 12 =====================
131 diamond 1742 
========== Узнать, разрешён ли низкоуровневый доступ к PCI. ==========
77 diamond 1743 
======================================================================
1744 
Параметры:
1745 
  * eax = 26 - номер функции
1746 
  * ebx = 12 - номер подфункции
1747 
Возвращаемое значение:
131 diamond 1748 
  * eax = 0/1 - запрещён/разрешён
77 diamond 1749 
Замечания:
1750 
  * Используется при работе с шиной PCI (функция 62).
1751 
  * Текущая реализация использует только младший бит ecx.
2010 serge 1752 
  * Установить текущее состояние можно вызовом
77 diamond 1753 
    подфункции 12 функции 21.
1754 
 
1755 
======================================================================
1756 
================ Функция 29 - получить системную дату. ===============
1757 
======================================================================
1758 
Параметры:
1759 
  * eax = 29 - номер функции
1760 
Возвращаемое значение:
1761 
  * eax = 0x00DDMMYY, где
1762 
    (используется двоично-десятичное кодирование, BCD)
1763 
  * YY = две младшие цифры года (00..99)
1764 
  * MM = месяц (01..12)
1765 
  * DD = день (01..31)
1766 
Замечания:
1767 
  * Системную дату можно установить функцией 22.
1768 
 
1769 
======================================================================
521 diamond 1770 
================ Функция 30 - работа с текущей папкой. ===============
1771 
======================================================================
1772 
 
1773 
-------- Подфункция 1 - установить текущую папку для потока. ---------
1774 
Параметры:
1775 
  * eax = 30 - номер функции
1776 
  * ebx = 1 - номер подфункции
1777 
  * ecx = указатель на ASCIIZ-строку с путём к новой текущей папке
1778 
Возвращаемое значение:
1779 
  * функция не возвращает значения
1780 
 
1781 
--------- Подфункция 2 - получить текущую папку для потока. ----------
1782 
Параметры:
1783 
  * eax = 30 - номер функции
1784 
  * ebx = 2 - номер подфункции
1785 
  * ecx = указатель на буфер
1786 
  * edx = размер буфера
1787 
Возвращаемое значение:
1788 
  * eax = длина имени текущей папки (включая завершающий 0)
1789 
Замечания:
1790 
  * Если размера буфера недостаточно для копирования всего имени,
2010 serge 1791 
    копируются только первые (edx-1) байт и в конце ставится
1792 
    завершающий 0.
1793 
  * По умолчанию, текущая папка для потока - "/rd/1".
1794 
  * При создании процесса/потока текущая папка наследуется от
1795 
    родителя.
521 diamond 1796 
 
1797 
======================================================================
2987 Serge 1798 
========= Функция 34 - узнать кому принадлежит точка экрана. =========
1799 
======================================================================
1800 
Параметры:
1801 
  * eax = 34 - номер функции
1802 
  * ebx = x-координата (относительно экрана)
1803 
  * ecx = y-координата (относительно экрана)
1804 
 
1805 
Возвращаемое значение:
1806 
  * eax = 0x000000XX - точка принадлежит слоту окна N
1807 
    При некорректных значениях ebx и ecx функция возвращает 0
1808 
  * Функция берет значения из области [_WinMapAddress]
1809 
 
1810 
======================================================================
77 diamond 1811 
============ Функция 35 - прочитать цвет точки на экране. ============
1812 
======================================================================
1813 
Параметры:
1814 
  * eax = 35
1815 
  * ebx = y*xsize+x, где
1816 
  * (x,y) = координаты точки (считая от 0)
1817 
  * xsize = размер экрана по горизонтали
1818 
Возвращаемое значение:
1819 
  * eax = цвет 0x00RRGGBB
1820 
Замечания:
1821 
  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
1822 
    что она вычитает 1 из обоих размеров.
1823 
  * К видеопамяти есть также прямой доступ (без вызовов системных
1824 
    функций) через селектор gs. Параметры текущего видеорежима
1825 
    можно получить функцией 61.
1826 
 
1827 
======================================================================
1018 diamond 1828 
=============== Функция 36 - прочитать область экрана. ===============
921 mario79 1829 
======================================================================
1830 
Параметры:
1831 
  * eax = 36 - номер функции
1832 
  * ebx = указатель на предварительно выделенную область памяти,
1018 diamond 1833 
            куда будет помещено изображение в формате BBGGRRBBGGRR...
921 mario79 1834 
  * ecx = [размер по оси x]*65536 + [размер по оси y]
1835 
  * edx = [координата по оси x]*65536 + [координата по оси y]
1836 
Возвращаемое значение:
1837 
  * функция не возвращает значения
1838 
Замечания:
1018 diamond 1839 
  * Координаты области - это координаты верхнего левого угла
1840 
    области относительно экрана.
921 mario79 1841 
  * Размер изображения в байтах есть 3*xsize*ysize.
1842 
 
1843 
======================================================================
277 diamond 1844 
==================== Функция 37 - работа с мышью. ====================
77 diamond 1845 
======================================================================
1846 
 
1847 
-------------- Подфункция 0 - экранные координаты мыши ---------------
1848 
Параметры:
1849 
  * eax = 37 - номер функции
1850 
  * ebx = 0 - номер подфункции
1851 
Возвращаемое значение:
1852 
  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
1853 
 
1854 
---------- Подфункция 1 - координаты мыши относительно окна ----------
1855 
Параметры:
1856 
  * eax = 37 - номер функции
1857 
  * ebx = 1 - номер подфункции
1858 
Возвращаемое значение:
1859 
  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
1860 
    окна приложения (считая от 0)
1861 
Замечания:
1862 
  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
1863 
    Если y>=ywnd, то младшее слово неотрицательно и содержит
1864 
    относительную y-координату, а старшее - относительную x-координату
1865 
    (правильного знака). В противном случае младшее слово отрицательно
131 diamond 1866 
    и всё равно содержит относительную y-координату,
77 diamond 1867 
    а к старшему слову следует прибавить 1.
1868 
 
1869 
----------------- Подфункция 2 - нажатые кнопки мыши -----------------
1870 
Параметры:
1871 
  * eax = 37 - номер функции
1872 
  * ebx = 2 - номер подфункции
1873 
Возвращаемое значение:
1874 
  * eax содержит информацию о нажатых кнопках мыши:
1875 
  * бит 0 установлен = левая кнопка нажата
1876 
  * бит 1 установлен = правая кнопка нажата
486 kastigar 1877 
  * бит 2 установлен = средняя кнопка нажата
1878 
  * бит 3 установлен = 4-я кнопка нажата
1879 
  * бит 4 установлен = 5-я кнопка нажата
77 diamond 1880 
  * прочие биты сброшены
1881 
 
277 diamond 1882 
------------------ Подфункция 4 - загрузить курсор -------------------
221 serge 1883 
Параметры:
1884 
  * eax = 37 - номер функции
1885 
  * ebx = 4 - номер подфункции
277 diamond 1886 
  * dx = источник данных:
1887 
  * dx = LOAD_FROM_FILE = 0 - данные в файле
1888 
    * ecx = указатель на полный путь к файлу курсора
1889 
    * файл курсора должен быть в формате .cur, стандартном для
1890 
      MS Windows, причём размером 32*32 пикселя
1891 
  * dx = LOAD_FROM_MEM = 1 - данные файла уже загружены в память
1892 
    * ecx = указатель на данные файла курсора
1893 
    * формат данных такой же, как и в предыдущем случае
1894 
  * dx = LOAD_INDIRECT = 2 - данные в памяти
1895 
    * ecx = указатель на образ курсора в формате ARGB 32*32 пикселя
1896 
    * edx = 0xXXYY0002, где
1897 
      * XX = x-координата "горячей точки" курсора
1898 
      * YY = y-координата
1899 
      * 0 <= XX, YY <= 31
221 serge 1900 
Возвращаемое значение:
277 diamond 1901 
  * eax = 0 - неудача
1902 
  * иначе eax = хэндл курсора
221 serge 1903 
 
277 diamond 1904 
------------------ Подфункция 5 - установить курсор ------------------
1905 
Устанавливает новый курсор для окна текущего потока.
221 serge 1906 
Параметры:
1907 
  * eax = 37 - номер функции
1908 
  * ebx = 5 - номер подфункции
277 diamond 1909 
  * ecx = хэндл курсора
221 serge 1910 
Возвращаемое значение:
277 diamond 1911 
  * eax = хэндл предыдущего установленного курсора
1912 
Замечания:
1913 
  * Если передан некорректный хэндл, то функция восстановит курсор
1914 
    по умолчанию (стандартную стрелку). В частности, к восстановлению
1915 
    курсора по умолчанию приводит передача ecx=0.
221 serge 1916 
 
277 diamond 1917 
------------------- Подфункция 6 - удалить курсор --------------------
221 serge 1918 
Параметры:
1919 
  * eax = 37 - номер функции
1920 
  * ebx = 6 - номер подфункции
277 diamond 1921 
  * ecx = хэндл курсора
221 serge 1922 
Возвращаемое значение:
277 diamond 1923 
  * eax разрушается
1924 
Замечания:
1925 
  * Курсор должен был быть ранее загружен текущим потоком
1926 
    (вызовом подфункции 4). Функция не удаляет системные курсоры и
1927 
    курсоры, загруженные другими приложениями.
1928 
  * Если удаляется активный (установленный подфункцией 5) курсор, то
1929 
    восстанавливается курсор по умолчанию (стандартная стрелка).
221 serge 1930 
 
499 diamond 1931 
------------------ Подфункция 7 - данные прокрутки -------------------
486 kastigar 1932 
Параметры:
1933 
  * eax = 37 - номер функции
2010 serge 1934 
  * ebx = 7 - номер подфункции
486 kastigar 1935 
Возвращаемое значение:
499 diamond 1936 
  * eax = [horizontal offset]*65536 + [vertical offset]
486 kastigar 1937 
Замечания:
499 diamond 1938 
  * Данные доступны только активному окну.
1939 
  * После прочтения значения обнуляются.
1940 
  * Данные имеют знаковые значения.
486 kastigar 1941 
 
77 diamond 1942 
======================================================================
1943 
================== Функция 38 - нарисовать отрезок. ==================
1944 
======================================================================
1945 
Параметры:
1946 
  * eax = 38 - номер функции
1947 
  * ebx = [координата начала по оси x]*65536 +
1948 
              [координата конца по оси x]
1949 
  * ecx = [координата начала по оси y]*65536 +
1950 
              [координата конца по оси y]
1951 
  * edx = 0x00RRGGBB - цвет
133 diamond 1952 
    edx = 0x01xxxxxx - рисовать инверсный отрезок
1953 
          (младшие 24 бита игнорируются)
77 diamond 1954 
Возвращаемое значение:
1955 
  * функция не возвращает значения
1956 
Замечания:
1957 
  * Координаты берутся относительно окна.
1958 
  * Конечная точка также рисуется.
1959 
 
1960 
======================================================================
1961 
== Функция 39, подфункция 1 - получить размер фонового изображения. ==
1962 
======================================================================
1963 
Параметры:
1964 
  * eax = 39 - номер функции
1965 
  * ebx = 1 - номер подфункции
1966 
Возвращаемое значение:
1967 
  * eax = [ширина]*65536 + [высота]
1968 
Замечания:
2010 serge 1969 
  * Есть парная команда установки размеров фонового изображения -
77 diamond 1970 
    подфункция 1 функции 15. После которой, разумеется, следует
1971 
    заново определить само изображение.
1972 
 
1973 
======================================================================
1974 
= Функция 39, подфункция 2 - прочитать точку с фонового изображения. =
1975 
======================================================================
1976 
Параметры:
1977 
  * eax = 39 - номер функции
1978 
  * ebx = 2 - номер подфункции
1979 
  * ecx = смещение
1980 
Возвращаемое значение:
1981 
  * eax = 0x00RRGGBB - цвет точки, если смещение допустимо
1982 
    (меньше 0x160000-16)
1983 
  * eax = 2 - иначе
1984 
Замечания:
1985 
  * Не следует полагаться на возвращаемое значение в случае неверного
1986 
    смещения, оно может измениться в следующих версиях ядра.
1987 
  * Смещение точки с координатами (x,y) вычисляется как (x+y*xsize)*3.
2010 serge 1988 
  * Есть парная функция установки точки на фоновом изображении -
77 diamond 1989 
    подфункция 2 функции 15.
1990 
 
1991 
======================================================================
1992 
====== Функция 39, подфункция 4 - получить режим отрисовки фона. =====
1993 
======================================================================
1994 
Параметры:
1995 
  * eax = 39 - номер функции
1996 
  * ebx = 4 - номер подфункции
1997 
Возвращаемое значение:
1998 
  * eax = 1 - замостить
1999 
  * eax = 2 - растянуть
2000 
Замечания:
2010 serge 2001 
  * Есть парная функция установки режима отрисовки фона -
77 diamond 2002 
    подфункция 4 функции 15.
2003 
 
2004 
======================================================================
2005 
======== Функция 40 - установить маску для ожидаемых событий. ========
2006 
======================================================================
2007 
Маска для ожидаемых событий влияет на функции работы с событиями 10,
131 diamond 2008 
11, 23 - они сообщают только о событиях, разрешённых этой маской.
77 diamond 2009 
Параметры:
2010 
  * eax = 40 - номер функции
2011 
  * ebx = маска: бит i соответствует событию i+1 (см. список событий)
2012 
    (установленный бит разрешает извещение о событии)
2013 
Возвращаемое значение:
1153 clevermous 2014 
  * eax = предыдущее значение маски
77 diamond 2015 
Замечания:
2016 
  * Маска по умолчанию (7=111b) разрешает извещения о перерисовке
2017 
    и нажатиях клавиш и кнопок.
2018 
    Этого достаточно для большинства приложений.
131 diamond 2019 
  * События, запрещённые в маске, всё равно сохраняются, если
77 diamond 2020 
    приходят; о них просто не извещают функции работы с событиями.
2021 
  * Функции работы с событиями учитывают маску на момент
2022 
    вызова функции, а не на момент поступления сообщения.
2023 
 
2024 
 
2025 
======================================================================
2026 
=================== Функция 43 - ввод/вывод в порт. ==================
2027 
======================================================================
2028 
 
2029 
------------------------ Вывод данных в порт -------------------------
2030 
Параметры:
2031 
  * eax = 43 - номер функции
2032 
  * bl = байт для вывода
2033 
  * ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
2034 
Возвращаемое значение:
2035 
  * eax = 0 - успешно
2036 
  * eax = 1 - поток не зарезервировал указанный порт
2037 
 
2038 
------------------------ Ввод данных из порта ------------------------
2039 
Параметры:
2040 
  * eax = 43 - номер функции
2041 
  * ebx игнорируется
2042 
  * ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
2043 
Возвращаемое значение:
131 diamond 2044 
  * eax = 0 - успешно, при этом ebx = введённый байт
77 diamond 2045 
  * eax = 1 - поток не зарезервировал данный порт
2046 
Замечания:
2047 
  * Предварительно поток должен зарезервировать за собой
2048 
    указанный порт функцией 46.
2049 
  * Для зарезервированных портов вместо вызова этих функций
2050 
    лучше использовать команды процессора in/out - это значительно
2051 
    быстрее и несколько короче и проще. Из незарезервированных
131 diamond 2052 
    портов читать всё равно нельзя.
77 diamond 2053 
 
2054 
 
2055 
======================================================================
2010 serge 2056 
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
77 diamond 2057 
======================================================================
2058 
К зарезервированным портам можно обращаться напрямую из приложения
2059 
командами in/out (рекомендуемый способ) и вызовом функции 43
2060 
(нерекомендуемый способ).
2061 
Параметры:
2062 
  * eax = 46 - номер функции
2063 
  * ebx = 0 - зарезервировать, 1 - освободить
2064 
  * ecx = номер начала диапазона портов
2065 
  * edx = номер конца диапазона портов (включительно)
2066 
Возвращаемое значение:
2067 
  * eax = 0 - успешно
2068 
  * eax = 1 - ошибка
2069 
Замечания:
2070 
  * В случае резервирования портов ошибкой считается выполнение
2071 
    одного из условий:
2072 
    * начальный адрес больше конечного;
2073 
    * указанный диапазон содержит некорректный номер порта
2074 
      (корректные - от 0 до 0xFFFF);
2075 
    * превышено ограничение на общее число зарезервированных областей
2076 
      - допускается максимум 255;
2077 
    * указанный диапазон пересекается с одним из
2078 
      ранее зарезервированных
2079 
  * В случае освобождения портов ошибкой считается попытка
2080 
    освобождения диапазона, который ранее не был целиком
2081 
    зарезервирован этой же функцией (с такими же значениями ecx,edx).
2082 
  * При обнаружении ошибки (в обоих случаях) никаких действий
2083 
    не производится.
277 diamond 2084 
  * При загрузке система резервирует за собой порты
2085 
    0..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (включительно).
77 diamond 2086 
  * При завершении потока автоматически освобождаются все
2087 
    зарезервированные им порты.
2088 
 
2089 
======================================================================
2090 
================= Функция 47 - вывести число в окно. =================
2091 
======================================================================
2092 
Параметры:
2093 
  * eax = 47 - номер функции
2094 
  * ebx = параметры преобразования числа в текст:
2095 
    * bl = 0 - ecx содержит число
665 diamond 2096 
    * bl = 1 - ecx содержит указатель на dword/qword-число
77 diamond 2097 
    * bh = 0 - отображать в десятичной системе счисления
2098 
    * bh = 1 - отображать в шестнадцатеричной системе
2099 
    * bh = 2 - отображать в двоичной системе
2100 
    * биты 16-21 = сколько цифр отображать
655 mario79 2101 
    * биты 22-29 зарезервированы и должны быть установлены в 0
665 diamond 2102 
    * бит 30 установлен = выводить qword (64-битное число);
2103 
                              при этом должно быть bl = 1
2104 
    * бит 31 установлен = не выводить ведущие нули числа
77 diamond 2105 
  * ecx = число (при bl=0) или указатель (при bl=1)
2106 
  * edx = [координата по оси x]*65536 + [координата по оси y]
142 diamond 2107 
  * esi = 0xX0RRGGBB:
2108 
    * RR, GG, BB задают цвет
2109 
    * X = ABnn (биты)
2110 
    * nn = шрифт (0/1)
2111 
    * A игнорируется
2112 
    * B=1 - закрашивать фон цветом edi
77 diamond 2113 
Возвращаемое значение:
2114 
  * функция не возвращает значения
2115 
Замечания:
2116 
  * Указанная длина не должна превосходить 60.
2117 
  * Выводится ровно указанное количество цифр. Если число мало и
2118 
    может быть записано меньшим количеством цифр, оно дополняется
2119 
    ведущими нулями; если число велико и не может быть записано
2120 
    таким количеством цифр, "лишние" ведущие цифры обрезаются.
2121 
  * Параметры шрифтов указаны в описании функции 4 (вывода текста).
2122 
 
2123 
======================================================================
2124 
======= Функция 48, подфункция 0 - применить настройки экрана. =======
2125 
======================================================================
2126 
Параметры:
2127 
  * eax = 48 - номер функции
2128 
  * ebx = 0 - номер подфункции
2129 
  * ecx = 0 - зарезервировано
2130 
Возвращаемое значение:
2131 
  * функция не возвращает значения
2132 
Замечания:
2133 
  * Функция перерисовывает экран после изменения параметров
2134 
    подфункциями 1 и 2.
2135 
  * Вызов функции без предшествующих вызовов указанных подфункций
2136 
    игнорируется.
2137 
  * Вызов функции с ненулевым ecx игнорируется.
2138 
 
2139 
======================================================================
2140 
========= Функция 48, подфункция 1 - установить стиль кнопок. ========
2141 
======================================================================
2142 
Параметры:
2143 
  * eax = 48 - номер функции
2144 
  * ebx = 1 - номер подфункции
2145 
  * ecx = тип кнопок:
2146 
    * 0 = плоские
131 diamond 2147 
    * 1 = объёмные
77 diamond 2148 
Возвращаемое значение:
2149 
  * функция не возвращает значения
2150 
Замечания:
2010 serge 2151 
  * После вызова описываемой функции следует перерисовать экран
77 diamond 2152 
    подфункцией 0.
2153 
  * Тип кнопок влияет только на их прорисовку функцией 8.
2154 
 
2155 
======================================================================
2156 
==== Функция 48, подфункция 2 - установить стандартные цвета окон. ===
2157 
======================================================================
2158 
Параметры:
2159 
  * eax = 48 - номер функции
2160 
  * ebx = 2 - номер подфункции
2161 
  * ecx = указатель на таблицу цветов
2162 
  * edx = размер таблицы цветов
2163 
    (должен быть 40 байт для будущей совместимости)
2164 
Формат таблицы цветов указан в описании подфункции 3.
2165 
Возвращаемое значение:
2166 
  * функция не возвращает значения
2167 
Замечания:
2010 serge 2168 
  * После вызова описываемой функции следует перерисовать экран
77 diamond 2169 
    подфункцией 0.
2170 
  * Таблица стандартных цветов влияет только на приложения,
2171 
    которые эту таблицу явным образом получают (подфункцией 3) и
131 diamond 2172 
    используют (указывая цвета из неё при вызовах функций рисования).
77 diamond 2173 
  * Таблица стандартных цветов входит в скин и устанавливается заново
2174 
    при установке скина (подфункции 8).
2175 
  * Таблицу цветов можно просматривать/изменять интерактивно с помощью
2176 
    приложения desktop.
2177 
 
2178 
======================================================================
2179 
===== Функция 48, подфункция 3 - получить стандартные цвета окон. ====
2180 
======================================================================
2181 
Параметры:
2182 
  * eax = 48 - номер функции
2183 
  * ebx = 3 - номер подфункции
2184 
  * ecx = указатель на буфер размером edx байт,
2185 
    куда будет записана таблица
2186 
  * edx = размер таблицы цветов
2187 
    (должен быть 40 байт для будущей совместимости)
2188 
Возвращаемое значение:
2189 
  * функция не возвращает значения
2190 
Формат таблицы цветов: каждый элемент -
2191 
dword-значение цвета 0x00RRGGBB
2192 
  * +0: dword: frames - цвет рамки
2193 
  * +4: dword: grab - цвет заголовка
2194 
  * +8: dword: grab_button - цвет кнопки на полосе заголовка
2195 
  * +12 = +0xC: dword: grab_button_text - цвет текста на кнопке
2196 
    на полосе заголовка
2197 
  * +16 = +0x10: dword: grab_text - цвет текста на заголовке
2198 
  * +20 = +0x14: dword: work - цвет рабочей области
2199 
  * +24 = +0x18: dword: work_button - цвет кнопки в рабочей области
2200 
  * +28 = +0x1C: dword: work_button_text - цвет текста на кнопке
2201 
    в рабочей области
2202 
  * +32 = +0x20: dword: work_text - цвет текста в рабочей области
2203 
  * +36 = +0x24: dword: work_graph - цвет графики в рабочей области
2204 
Замечания:
2205 
  * Структура таблицы цветов описана в стандартном включаемом файле
2206 
    macros.inc под названием system_colors; например, можно писать:
2010 serge 2207 
    	sc	system_colors		; объявление переменной
2208 
    	...				; где-то надо вызвать
2209 
    					; описываемую функцию с ecx=sc
2210 
    	mov	ecx, [sc.work_button_text]	; читаем цвет текста
2211 
    					; на кнопке в рабочей области
77 diamond 2212 
  * Использование/неиспользование этих цветов - дело исключительно
2213 
    самой программы. Для использования нужно просто при вызове функций
2214 
    рисования указывать цвет, взятый из этой таблицы.
2215 
  * При изменении таблицы стандартных цветов (подфункцией 2 с
2216 
    последующим применением изменений подфункцией 0 или
2217 
    при установке скина подфункцией 8) всем окнам посылается сообщение
2218 
    о необходимости перерисовки (событие с кодом 1).
2219 
  * Стандартные цвета можно просматривать/изменять интерактивно
2220 
    с помощью приложения desktop.
2221 
 
2222 
======================================================================
2223 
========== Функция 48, подфункция 4 - получить высоту скина. =========
2224 
======================================================================
2225 
Параметры:
2226 
  * eax = 48 - номер функции
2227 
  * ebx = 4 - номер подфункции
2228 
Возвращаемое значение:
2229 
  * eax = высота скина
2230 
Замечания:
2231 
  * Высотой скина по определению считается высота заголовка окон,
2232 
    использующих скин.
2233 
  * Смотри также общую структуру окна в описании функции 0.
2234 
 
2235 
======================================================================
2236 
===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
2237 
======================================================================
2238 
Параметры:
2239 
  * eax = 48 - номер функции
2240 
  * ebx = 5 - номер подфункции
2241 
Возвращаемое значение:
2242 
  * eax = [left]*65536 + [right]
2243 
  * ebx = [top]*65536 + [bottom]
2244 
Замечания:
2245 
  * Рабочая область экрана определяет положение и координаты
2246 
    максимизированного окна.
2247 
  * Рабочая область экрана при нормальной работе есть весь экран
2248 
    за вычетом панели (@panel).
2249 
  * (left,top) - координаты левого верхнего угла,
2250 
    (right,bottom) - координаты правого нижнего.
2251 
    Таким образом, размер рабочей области по оси x определяется
2252 
    формулой right-left+1, по оси y - формулой bottom-right+1.
2253 
  * Смотри также функцию 14,
2254 
    позволяющую определить размеры всего экрана.
2255 
  * Есть парная функция установки рабочей области - подфункция 6.
2256 
 
2257 
======================================================================
2258 
==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
2259 
======================================================================
2260 
Параметры:
2261 
  * eax = 48 - номер функции
2262 
  * ebx = 6 - номер подфункции
2263 
  * ecx = [left]*65536 + [right]
2264 
  * edx = [top]*65536 + [bottom]
2265 
Возвращаемое значение:
2266 
  * функция не возвращает значения
2267 
Замечания:
2268 
  * Рабочая область экрана определяет положение и координаты
2269 
    максимизированного окна.
2270 
  * Эта функция используется только приложением @panel,
2271 
    устанавливающим рабочей областью весь экран за вычетом панели.
2272 
  * (left,top) - координаты левого верхнего угла,
2273 
    (right,bottom) - координаты правого нижнего.
2274 
    Таким образом, размер рабочей области по оси x определяется
2275 
    формулой right-left+1, по оси y - формулой bottom-right+1.
2276 
  * Если left>=right, то x-координаты рабочей области не изменяются.
2277 
    Если left<0, то left не устанавливается. Если right больше
2278 
    или равно ширины экрана, то right не устанавливается.
2279 
    Аналогично по оси y.
2280 
  * Смотри также функцию 14,
2281 
    позволяющую определить размеры всего экрана.
2010 serge 2282 
  * Есть парная функция получения рабочей области -
77 diamond 2283 
    подфункция 5.
2284 
  * Эта функция автоматически перерисовывает экран, по ходу дела
118 diamond 2285 
    обновляет координаты и размеры максимизированных окон.
77 diamond 2286 
    Все окна извещаются о необходимости перерисовки (событие 1).
2287 
 
2288 
======================================================================
2289 
====================== Функция 48, подфункция 7 ======================
2290 
============ Получить область скина для текста заголовка. ============
2291 
======================================================================
2292 
Возвращает область заголовка окна со скином, предназначенную
2293 
для вывода текста заголовка.
2294 
Параметры:
2295 
  * eax = 48 - номер функции
2296 
  * ebx = 7 - номер подфункции
2297 
Возвращаемое значение:
2298 
  * eax = [left]*65536 + [right]
2299 
  * ebx = [top]*65536 + [bottom]
2300 
Замечания:
2301 
  * Использование/неиспользование этой функции -
2302 
    личное дело приложения.
2303 
  * Рекомендуется учитывать значения, возвращаемые этой функцией,
2304 
    при выборе места для рисования текста заголовка (функцией 4) или
2305 
    какого-нибудь заменителя текста заголовка
2306 
    (по усмотрению приложения).
2307 
 
2308 
======================================================================
2309 
==== Функция 48, подфункция 8 - установить используемый скин окон. ===
2310 
======================================================================
2311 
Параметры:
2312 
  * eax = 48 - номер функции
2313 
  * ebx = 8 - номер подфункции
546 diamond 2314 
  * ecx = указатель на имя файла скина
77 diamond 2315 
Возвращаемое значение:
2316 
  * eax = 0 - успешно
546 diamond 2317 
  * eax = 1 - не удалось загрузить файл
2318 
  * eax = 2 - файл не является файлом скина
77 diamond 2319 
Замечания:
2320 
  * При успешной загрузке скина все окна извещаются о необходимости
2321 
    перерисовки (событие 1).
2322 
  * При загрузке система считывает скин из файла default.skn
2323 
    на рамдиске.
2324 
  * Пользователь может изменять скин статически, создав свой
2325 
    default.skn, или динамически с помощью приложения desktop.
2326 
 
2327 
======================================================================
78 diamond 2328 
============ Функция 49 - Advanced Power Management (APM). ===========
2329 
======================================================================
2330 
Параметры:
2331 
  * eax = 49 - номер функции
2332 
  * dx = номер функции APM (аналог ax в спецификации)
2333 
  * bx, cx = параметры функции APM
2334 
Возвращаемое значение:
2335 
  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
2336 
    установлены в соответствии со спецификацией APM
2337 
  * старшие половины 32-битных регистров eax, ebx, ecx,
2338 
    edx, esi, edi разрушаются
2339 
Замечания:
2340 
  * Спецификация APM 1.2 описывается в документе
2341 
    "Advanced Power Management (APM) BIOS Specification"
2342 
    (Revision 1.2), доступном на
2343 
    http://www.microsoft.com/whdc/archive/amp_12.mspx;
2344 
    кроме того, она включена в известный Interrupt List by Ralf Brown
2345 
    (http://www.pobox.com/~ralf/files.html,
2346 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
2347 
 
2348 
======================================================================
77 diamond 2349 
================= Функция 50 - установка формы окна. =================
2350 
======================================================================
2351 
Обычные окна представляют собой прямоугольники. С помощью этой функции
131 diamond 2352 
окну можно придать произвольную форму. Форма задаётся набором точек
77 diamond 2353 
внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
2354 
размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
2355 
функцией 67.
2356 
 
2357 
--------------- Установка данных с информацией о форме ---------------
2358 
Параметры:
2359 
  * eax = 50 - номер функции
2360 
  * ebx = 0 - номер подфункции
2361 
  * ecx = указатель на данные формы (массив байт 0/1)
2362 
Возвращаемое значение:
2363 
  * функция не возвращает значения
2364 
 
2365 
------------------ Установка масштаба данных формы -------------------
2366 
Параметры:
2367 
  * eax = 50 - номер функции
2368 
  * ebx = 1 - номер подфункции
131 diamond 2369 
  * ecx задаёт масштаб: каждый байт данных определяет
77 diamond 2370 
    (2^scale)*(2^scale) пикселей
2371 
Возвращаемое значение:
2372 
  * функция не возвращает значения
2373 
Замечания:
2374 
  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
2375 
    данных формы один байт соответствует одному пикселю, то масштаб
2376 
    можно не устанавливать.
2377 
  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
2378 
    обратите внимание, что они на единицу больше, чем устанавливаемые
2379 
    функциями 0, 67.
2380 
  * По определению масштаба xsize и ysize должны делиться на 2^scale.
2381 
  * Байт данных по смещению a должен быть 0/1 и
2382 
    определяет принадлежность окну квадрата со стороной 2^scale
2383 
    (при scale=0 получаем пиксель) и координатами левого верхнего угла
2384 
    (a mod (xsize shr scale), a div (xsize shr scale))
2385 
  * Размер данных: (xsize shr scale)*(ysize shr scale).
2386 
  * Данные должны присутствовать в памяти и не меняться
2387 
    после установки формы.
2388 
  * Система просматривает данные о форме при каждой перерисовке окна
2389 
    функцией 0.
2390 
  * Вызов подфункции 0 с нулевым указателем приводит к возврату
2391 
    к прямоугольной форме.
2392 
 
2393 
======================================================================
2394 
===================== Функция 51 - создать поток. ====================
2395 
======================================================================
2396 
Параметры:
2397 
  * eax = 51 - номер функции
2398 
  * ebx = 1 - единственная подфункция
2399 
  * ecx = адрес точки входа потока (начальный eip)
2400 
  * edx = указатель стэка потока (начальный esp)
2401 
Возвращаемое значение:
2402 
  * eax = -1 - ошибка (в системе слишком много потоков)
2403 
  * иначе eax = TID - идентификатор потока
2404 
 
2405 
======================================================================
2010 serge 2406 
= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
77 diamond 2407 
======================================================================
2408 
Параметры:
2409 
  * eax = 52 - номер функции
2410 
  * ebx = 0 - номер подфункции
2411 
Возвращаемое значение:
2412 
  * eax = двойное слово конфигурации
2413 
Замечания:
2414 
  * Слово конфигурации можно установить подфункцией 2.
2415 
  * Ядро не использует соответствующую переменную.
2416 
    Ценность этой переменной и работающих с ней подфункций 0 и 2
2417 
    представляется сомнительной.
2418 
 
2419 
======================================================================
2420 
======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
2421 
======================================================================
2422 
Параметры:
2423 
  * eax = 52 - номер функции
2424 
  * ebx = 1 - номер подфункции
2425 
Возвращаемое значение:
2426 
  * eax = IP-адрес (4 байта)
2427 
Замечания:
2428 
  * Локальный IP-адрес устанавливается подфункцией 3.
2429 
 
2430 
======================================================================
2010 serge 2431 
 Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
77 diamond 2432 
======================================================================
2433 
Параметры:
2434 
  * eax = 52 - номер функции
2435 
  * ebx = 2 - номер подфункции
2436 
  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
2437 
    число 3, это воспринимается как запрос на [пере-]инициализацию
2438 
    Ethernet-карты, в противном случае Ethernet выключается
2439 
Возвращаемое значение:
2440 
  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
2441 
    но это может измениться в будущих версиях ядра
2442 
  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
2443 
    (отсутствие Ethernet-карты), а ненулевое значение - успех
2444 
Замечания:
2445 
  * Слово конфигурации можно прочитать подфункцией 0.
2446 
  * Ядро не использует соответствующую переменную.
2447 
    Ценность этой переменной, подфункции 0 и части подфункции 2,
2448 
    устанавливающей эту переменную, представляется сомнительной.
2449 
 
2450 
======================================================================
2451 
====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
2452 
======================================================================
2453 
Параметры:
2454 
  * eax = 52 - номер функции
2455 
  * ebx = 3 - номер подфункции
2456 
  * ecx = IP-адрес (4 байта)
2457 
Возвращаемое значение:
2458 
  * текущая реализация возвращает eax=3, но это может быть изменено
2459 
    в будущих версиях
2460 
Замечания:
2461 
  * Локальный IP-адрес можно получить подфункцией 1.
2462 
 
2463 
======================================================================
2464 
= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
2465 
======================================================================
2466 
Параметры:
2467 
  * eax = 52 - номер функции
2468 
  * ebx = 6 - номер подфункции
2469 
  * edx = размер данных
2470 
  * esi = указатель на данные
2471 
Возвращаемое значение:
2472 
  * eax = -1 - ошибка
2473 
  * eax = 0 - успешно
2474 
Замечания:
2475 
  * Эта функция предназначена только для медленных сетевых драйверов
2476 
    (PPP, SLIP).
2477 
  * Размер данных не должен превосходить 1500 байт,
2478 
    хотя проверок корректности не делается.
2479 
 
2480 
======================================================================
2481 
====================== Функция 52, подфункция 8 ======================
2482 
============= Прочитать данные из сетевой очереди вывода. ============
2483 
======================================================================
2484 
Параметры:
2485 
  * eax = 52 - номер функции
2486 
  * ebx = 8 - номер подфункции
2487 
  * esi = указатель на буфер размером 1500 байт
2488 
Возвращаемое значение:
2489 
  * eax = число прочитанных байт (в текущей реализации
2490 
    либо 0 = нет данных, либо 1500)
2491 
  * данные скопированы в буфер
2492 
Замечания:
2493 
  * Эта функция предназначена только для медленных сетевых драйверов
2494 
    (PPP, SLIP).
2495 
 
2496 
======================================================================
2497 
=========== Функция 52, подфункция 9 - получить gateway IP. ==========
2498 
======================================================================
2499 
Параметры:
2500 
  * eax = 52 - номер функции
2501 
  * ebx = 9 - номер подфункции
2502 
Возвращаемое значение:
2503 
  * eax = gateway IP (4 байта)
2504 
 
2505 
======================================================================
2506 
========= Функция 52, подфункция 10 - получить маску подсети. ========
2507 
======================================================================
2508 
Параметры:
2509 
  * eax = 52 - номер функции
2510 
  * ebx = 10 - номер подфункции
2511 
Возвращаемое значение:
2512 
  * eax = маска подсети
2513 
 
2514 
======================================================================
2515 
========= Функция 52, подфункция 11 - установить gateway IP. =========
2516 
======================================================================
2517 
Параметры:
2518 
  * eax = 52 - номер функции
2519 
  * ebx = 11 - номер подфункции
2520 
  * ecx = gateway IP (4 байта)
2521 
Возвращаемое значение:
2522 
  * текущая реализация возвращает eax=11, но это может быть изменено
2523 
    в будущих реализациях
2524 
 
2525 
======================================================================
2526 
======== Функция 52, подфункция 12 - установить маску подсети. =======
2527 
======================================================================
2528 
Параметры:
2529 
  * eax = 52 - номер функции
2530 
  * ebx = 12 - номер подфункции
2531 
  * ecx = маска подсети
2532 
Возвращаемое значение:
2533 
  * текущая реализация возвращает eax=12, но это может быть изменено
2534 
    в будущих версиях
2535 
 
2536 
======================================================================
2537 
============ Функция 52, подфункция 13 - получить DNS IP. ============
2538 
======================================================================
2539 
Параметры:
2540 
  * eax = 52 - номер функции
2541 
  * ebx = 13 - номер подфункции
2542 
Возвращаемое значение:
2543 
  * eax = DNS IP (4 байта)
2544 
 
2545 
======================================================================
2546 
=========== Функция 52, подфункция 14 - установить DNS IP. ===========
2547 
======================================================================
2548 
Параметры:
2549 
  * eax = 52 - номер функции
2550 
  * ebx = 14 - номер подфункции
2551 
  * ecx = DNS IP (4 байта)
2552 
Возвращаемое значение:
2553 
  * текущая реализация возвращает eax=14, но это может быть изменено
2554 
    в следующих версиях
2555 
 
2556 
======================================================================
277 diamond 2557 
====== Функция 52, подфункция 15 - получить локальный MAC-адрес. =====
2558 
======================================================================
2559 
Параметры:
2560 
  * eax = 52 - номер функции
2561 
  * ebx = 15 - номер подфункции
2562 
  * ecx = 0 - читать первые 4 байта,
2563 
    ecx = 4 - читать последние 2 байта
2564 
Возвращаемое значение:
2565 
  * для ecx=0: eax = первые 4 байта MAC-адреса
2566 
  * для ecx=4: ax = последние 2 байта MAC-адреса,
2567 
               старшая половина eax разрушается
2568 
  * для других ecx: eax = -1 как признак ошибки
2569 
 
2570 
======================================================================
77 diamond 2571 
============ Функция 53, подфункция 0 - открыть UDP-сокет. ===========
2572 
======================================================================
2573 
Параметры:
2574 
  * eax = 53 - номер функции
2575 
  * ebx = 0 - номер подфункции
1154 clevermous 2576 
  * ecx = локальный порт (учитывается только младшее слово),
2577 
    ecx = 0 - предоставить системе выбор локального порта
131 diamond 2578 
  * edx = удалённый порт (учитывается только младшее слово)
2579 
  * esi = удалённый IP
77 diamond 2580 
Возвращаемое значение:
2581 
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2582 
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2583 
    сокет и имеющее смысл только для системы) - успешно;
2584 
    ebx разрушается
2585 
 
2586 
======================================================================
2587 
============ Функция 53, подфункция 1 - закрыть UDP-сокет. ===========
2588 
======================================================================
2589 
Параметры:
2590 
  * eax = 53 - номер функции
2591 
  * ebx = 1 - номер подфункции
2592 
  * ecx = хэндл сокета
2593 
Возвращаемое значение:
2594 
  * eax = -1 - неверный хэндл
2595 
  * eax = 0 - успешно
2596 
  * ebx разрушается
2597 
Замечания:
2598 
  * Текущая реализация не закрывает автоматически все сокеты потока
2599 
    при его завершении. В частности, не следует прибивать поток
2600 
    с кучей открытых сокетов - будет утечка ресурсов.
2601 
 
2602 
======================================================================
2603 
============== Функция 53, подфункция 2 - опрос сокета. ==============
2604 
======================================================================
2605 
Параметры:
2606 
  * eax = 53 - номер функции
2607 
  * ebx = 2 - номер подфункции
2608 
  * ecx = хэндл сокета
2609 
Возвращаемое значение:
1018 diamond 2610 
  * eax = число полученных байт, 0 для неверного хэндла
77 diamond 2611 
  * ebx разрушается
2612 
 
2613 
======================================================================
2614 
======== Функция 53, подфункция 3 - прочитать байт из сокета. ========
2615 
======================================================================
2616 
Параметры:
2617 
  * eax = 53 - номер функции
2618 
  * ebx = 3 - номер подфункции
2619 
  * ecx = хэндл сокета
2620 
Возвращаемое значение:
1018 diamond 2621 
  * если нет принятых данных или указан неверный хэндл:
2622 
    eax=0, bl=0, прочие байты ebx разрушаются
77 diamond 2623 
  * если были принятые данные: eax=число оставшихся байт
118 diamond 2624 
    (возможно, 0), bl=прочитанный байт, прочие байты ebx разрушаются
77 diamond 2625 
 
2626 
======================================================================
2627 
========== Функция 53, подфункция 4 - записать в UDP-сокет. ==========
2628 
======================================================================
2629 
Параметры:
2630 
  * eax = 53 - номер функции
2631 
  * ebx = 4 - номер подфункции
2632 
  * ecx = хэндл сокета
2633 
  * edx = число байт для записи
2634 
  * esi = указатель на данные для записи
2635 
Возвращаемое значение:
1018 diamond 2636 
  * eax = 0xffffffff - ошибка (неверный хэндл или недостаточно памяти)
77 diamond 2637 
  * eax = 0 - успешно
2638 
  * ebx разрушается
2639 
Замечания:
2640 
  * Число байт для записи не может превышать 1500-28, хотя
2641 
    соответствующей проверки не делается.
2642 
 
2643 
======================================================================
2644 
============ Функция 53, подфункция 5 - открыть TCP-сокет. ===========
2645 
======================================================================
2646 
Параметры:
2647 
  * eax = 53 - номер функции
2648 
  * ebx = 5 - номер подфункции
1154 clevermous 2649 
  * ecx = локальный порт (учитывается только младшее слово),
2650 
    ecx = 0 - предоставить системе выбор локального порта
131 diamond 2651 
  * edx = удалённый порт (учитывается только младшее слово)
2652 
  * esi = удалённый IP
77 diamond 2653 
  * edi = режим открытия: SOCKET_PASSIVE=0 или SOCKET_ACTIVE=1
2654 
Возвращаемое значение:
2655 
  * eax = -1 = 0xFFFFFFFF - ошибка; ebx разрушается
2656 
  * eax = хэндл сокета (некоторое число, однозначно идентифицирующее
2657 
    сокет и имеющее смысл только для системы) - успешно;
2658 
    ebx разрушается
2659 
 
2660 
======================================================================
2661 
====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
2662 
======================================================================
2663 
Параметры:
2664 
  * eax = 53 - номер функции
2665 
  * ebx = 6 - номер подфункции
2666 
  * ecx = хэндл сокета
2667 
Возвращаемое значение:
1018 diamond 2668 
  * eax = 0 для неверного сокета или статус: одно из
77 diamond 2669 
  * TCB_LISTEN = 1
2670 
  * TCB_SYN_SENT = 2
2671 
  * TCB_SYN_RECEIVED = 3
2672 
  * TCB_ESTABLISHED = 4
2673 
  * TCB_FIN_WAIT_1 = 5
2674 
  * TCB_FIN_WAIT_2 = 6
2675 
  * TCB_CLOSE_WAIT = 7
2676 
  * TCB_CLOSING = 8
2677 
  * TCB_LAST_ASK = 9
2678 
  * TCB_TIME_WAIT = 10
2679 
  * TCB_CLOSED = 11
2680 
  * ebx разрушается
2681 
 
2682 
======================================================================
2683 
========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
2684 
======================================================================
2685 
Параметры:
2686 
  * eax = 53 - номер функции
2687 
  * ebx = 7 - номер подфункции
2688 
  * ecx = хэндл сокета
2689 
  * edx = число байт для записи
2690 
  * esi = указатель на данные для записи
2691 
Возвращаемое значение:
1018 diamond 2692 
  * eax = 0xffffffff - ошибка (неверный хэндл или недостаточно памяти)
77 diamond 2693 
  * eax = 0 - успешно
2694 
  * ebx разрушается
2695 
Замечания:
2696 
  * Число байт для записи не может превышать 1500-40,
2697 
    хотя соответствующей проверки не делается.
2698 
 
2699 
======================================================================
2700 
============ Функция 53, подфункция 8 - закрыть TCP-сокет. ===========
2701 
======================================================================
2702 
Параметры:
2703 
  * eax = 53 - номер функции
2704 
  * ebx = 8 - номер подфункции
2705 
  * ecx = хэндл сокета
2706 
Возвращаемое значение:
1018 diamond 2707 
  * eax = -1 - ошибка (неверный хэндл или
2708 
    недостаточно памяти для пакета закрытия сокета)
77 diamond 2709 
  * eax = 0 - успешно
2710 
  * ebx разрушается
2711 
Замечания:
2712 
  * Текущая реализация не закрывает автоматически все сокеты потока
2713 
    при его завершении. В частности, не следует прибивать поток
2714 
    с кучей открытых сокетов - будет утечка ресурсов.
2715 
 
2716 
======================================================================
2717 
== Функция 53, подфункция 9 - проверить, свободен ли локальный порт. =
2718 
======================================================================
2719 
Параметры:
2720 
  * eax = 53 - номер функции
2721 
  * ebx = 9 - номер подфункции
2722 
  * ecx = номер локального порта (используются только младшие 16 бит)
2723 
Возвращаемое значение:
2724 
  * eax = 0 - порт используется
2725 
  * eax = 1 - порт свободен
2726 
  * ebx разрушается
2727 
 
2728 
======================================================================
314 diamond 2729 
==== Функция 53, подфункция 10 - получить статус кабеля Ethernet. ====
2730 
======================================================================
2731 
Параметры:
2732 
  * eax = 53 - номер функции
2733 
  * ebx = 10 - номер подфункции
2734 
Возвращаемое значение:
2735 
  * al = -1 - драйвер сетевой карты не загружен или
2736 
              не поддерживает эту функцию
2737 
  * al = 0 - кабель не подключён
2738 
  * al = 1 - кабель подключён
346 diamond 2739 
  * ebx разрушается
314 diamond 2740 
Замечания:
2741 
  * Текущая реализация ядра поддерживает эту функцию
2742 
    только для сетевых карт RTL8139.
2743 
 
2744 
======================================================================
346 diamond 2745 
==== Функция 53, подфункция 11 - прочитать данные сетевого стека. ====
340 heavyiron 2746 
======================================================================
2747 
Параметры:
2748 
  * eax = 53 - номер функции
2749 
  * ebx = 11 - номер подфункции
346 diamond 2750 
  * ecx = хэндл сокета
2751 
  * edx = указатель на буфер
2752 
  * esi = число байт для чтения;
2753 
  * esi = 0 - читать все данные (максимум 4096 байт)
2754 
Возвращаемое значение:
1018 diamond 2755 
  * eax = число прочитанных байт (0 при неверном хэндле)
346 diamond 2756 
  * ebx разрушается
340 heavyiron 2757 
 
2758 
======================================================================
2010 serge 2759 
 Функция 53, подфункция 255 - отладочная информация сетевого драйвера.
77 diamond 2760 
======================================================================
2761 
Параметры:
2762 
  * eax = 53 - номер функции
2763 
  * ebx = 255 - номер подфункции
2764 
  * ecx = тип запрашиваемой информации (смотри ниже)
2765 
Возвращаемое значение:
2766 
  * eax = запрошенная информация
2767 
  * ebx разрушается
2768 
Возможные значения ecx:
2769 
  * 100: длина очереди 0 (empty queue)
2770 
  * 101: длина очереди 1 (ip-out queue)
2771 
  * 102: длина очереди 2 (ip-in queue)
2772 
  * 103: длина очереди 3 (net1out queue)
2773 
  * 200: число элементов в таблице ARP
2774 
  * 201: размер таблицы ARP (в элементах) (20 в текущей версии)
2775 
  * 202: прочитать элемент edx таблицы ARP во временный буфер, откуда
2776 
    берут информацию 5 последующих типов;
131 diamond 2777 
    в этом случае eax неопределён
77 diamond 2778 
  * 203: IP-адрес, запомненный типом 202
2779 
  * 204: старшее dword MAC-адреса, запомненного типом 202
2780 
  * 205: младшее word MAC-адреса, запомненного типом 202
2781 
  * 206: слово статуса, запомненное типом 202
2782 
  * 207: слово ttl, запомненное типом 202
2783 
  * 2: общее число полученных IP-пакетов
2784 
  * 3: общее число переданных IP-пакетов
2785 
  * 4: общее число сдампленных полученных пакетов
2786 
  * 5: общее число полученных ARP-пакетов
2787 
  * 6: статус драйвера пакетов, 0=неактивен,
2788 
    ненулевое значение=активен
2789 
 
2790 
======================================================================
2791 
====================== Функция 55, подфункция 55 =====================
2792 
========== Начать проигрывать данные на встроенном спикере. ==========
2793 
======================================================================
2794 
Параметры:
2795 
  * eax = 55 - номер функции
2796 
  * ebx = 55 - номер подфункции
2797 
  * esi = указатель на данные
2798 
Возвращаемое значение:
2799 
  * eax = 0 - успешно
131 diamond 2800 
  * eax = 55 - ошибка (спикер отключён или занят)
77 diamond 2801 
Данные - это массив элементов переменной длины.
2802 
Формат каждого элемента определяется первым байтом:
2803 
  * 0 = конец данных
131 diamond 2804 
  * 1..0x80 = задаёт длительность звучания в сотых долях секунды
77 diamond 2805 
    ноты, определяемой непосредственным значением частоты
2806 
    * следующее слово (2 байта) содержит делитель частоты;
2807 
      частота определяется как 1193180/divider
2808 
  * 0x81 = invalid
2809 
  * 0x82..0xFF = нота, определяемая октавой и номером:
2810 
    * длительность в сотых долях секунды = (первый байт)-0x81
131 diamond 2811 
    * присутствует ещё один байт;
77 diamond 2812 
    * (второй байт)=0xFF - пауза
2813 
    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
2814 
      до 12, a=номер октавы (считая с 0)
2815 
Замечания:
2816 
  * Пищание спикером может быть запрещено/разрешено подфункцией 8
2817 
    функции 18.
2818 
  * Функция возвращает управление, сообщив куда следует информацию
131 diamond 2819 
    о запросе. Само проигрывание идёт независимо от программы.
77 diamond 2820 
  * Данные должны сохраняться в памяти по крайней мере
2821 
    до конца проигрывания.
2822 
 
2823 
======================================================================
641 diamond 2824 
======================= Функция 57 - PCI BIOS. =======================
586 serge 2825 
======================================================================
2826 
Параметры:
641 diamond 2827 
  * eax = 57 - номер функции
2828 
  * ebp соответствует регистру al в спецификации PCI BIOS
2829 
  * остальные регистры - по спецификации PCI BIOS
2830 
Возвращаемое значение:
2831 
  * CF не определён
2832 
  * остальные регистры - по спецификации PCI BIOS
2833 
Замечания:
2834 
  * Многих результатов этой функции можно также добиться вызовом
2835 
    соответствующих подфункций функции 62.
2836 
  * Функция вызывает расширение PCI32 BIOS, документированное,
2837 
    например, в http://alpha1.dyns.net/files/PCI/bios21.pdf.
2838 
  * Если BIOS не поддерживает это расширение, поведение функции
2839 
    эмулируется (через аналоги подфункций функции 62 режима ядра).
586 serge 2840 
 
2841 
======================================================================
77 diamond 2842 
============== Функция 58 - работа с файловой системой. ==============
2843 
======================================================================
2844 
Параметры:
2845 
  * eax = 58
2846 
  * ebx = указатель на информационную структуру
2847 
Возвращаемое значение:
2848 
  * eax = 0 - успешно; иначе код ошибки файловой системы
2849 
  * в зависимости от подфункции может возвращаться значение и
2850 
    в других регистрах
2851 
Общий формат информационной структуры:
2852 
  * +0: dword: номер подфункции
2853 
  * +4: dword: номер блока
2854 
  * +8: dword: размер
2855 
  * +12 = +0xC: dword: указатель на данные
2856 
  * +16 = +0x10: dword: указатель на память для работы системы
2857 
    (4096 байт)
2858 
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
2859 
Уточнения - в документации на соответствующую подфункцию.
2860 
Имя файла нечувствительно к регистру латинских букв,
2861 
русские буквы должны быть заглавными.
2862 
Формат имени файла:
2863 
/base/number/dir1/dir2/.../dirn/file,
2864 
где /base/number идентифицирует устройство, на котором ищется файл:
2865 
одно из
2866 
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
2867 
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
2868 
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
131 diamond 2869 
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к жёсткому диску
77 diamond 2870 
    (в этом случае база определяется подфункцией 7 функции 21),
2871 
    x - номер раздела (считая с 1)
2872 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
2873 
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
2874 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
2875 
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
2876 
    (на каждом из винчестеров нумерация начинается с 1)
2877 
Замечания:
2878 
  * В первых двух случаях допускается использование FIRST вместо 1,
2879 
    SECOND вместо 2, но использовать эту возможность
2880 
    не рекомендуется для удобства перехода на будущие расширения.
2881 
  * Накладывается ограничение n<=39.
2882 
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
2883 
    имя не более 8 символов, точка, расширение не более 3 символов.
2884 
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
2885 
    Если имя занимает ровно 8 символов, точку можно опустить
2886 
    (хотя пользоваться этим не рекомендуется для удобства перехода
2887 
    на будущие расширения).
118 diamond 2888 
  * Функция не поддерживает папок на рамдиске.
77 diamond 2889 
Примеры:
2890 
  * '/RAMDISK/FIRST/KERNEL.ASM',0
2891 
    '/rd/1/kernel.asm',0
2892 
  * '/HD0/1/kernel.asm',0
2893 
  * '/hd0/1/menuet/pics/tanzania.bmp',0
2894 
Доступные подфункции:
2895 
  * подфункция 0 - чтение файла/папки
2896 
  * подфункция 8 - LBA-чтение с устройства
2897 
  * подфункция 15 - получение информации о файловой системе
2898 
 
2899 
======================================================================
2900 
========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
2901 
======================================================================
2902 
Параметры:
2903 
  * eax = 58
2904 
  * ebx = указатель на информационную структуру
2905 
Формат информационной структуры:
2906 
  * +0: dword: 0 = номер подфункции
2907 
  * +4: dword: номер блока для чтения (считая с 0)
2908 
  * +8: dword: число блоков для чтения
2909 
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2910 
  * +16 = +0x10: dword: указатель на буфер для работы системы
2911 
    (4096 байт)
131 diamond 2912 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 2913 
    общем описании
2914 
Возвращаемое значение:
2915 
  * eax = 0 - успешно, иначе код ошибки файловой системы
2916 
  * ebx = размер файла (в байтах) или
2917 
    -1=0xffffffff, если файл не найден
2918 
Замечания:
2919 
  * Размер блока - 512 байт.
2920 
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
2921 
    функции 70, для чтения папок - подфункцию 1 функции 70.
2922 
  * Функция позволяет читать содержимое папки. Из файловых систем
2923 
    поддерживается только FAT. Формат FAT-папки описан в любой
2924 
    документации по FAT.
2925 
  * Размер папки определяется по размеру цепочки кластеров в FAT.
2926 
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 2927 
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 2928 
    eax=6 (EOF).
2929 
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
2930 
    в первых двух случаях текущая реализация не следует
2931 
    установленным правилам:
2932 
    для /rd/1:
2933 
    * если указано 0 блоков для чтения, считается,
2934 
      что запрашивается 1;
2935 
    * если запрашивается больше 14 блоков или начальный блок
2936 
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
2937 
    * размер корневого каталога рамдиска = 14 блоков,
2938 
      0x1C00=7168 байт; но возвращается ebx=0
2939 
      (за исключением случая предыдущего пункта);
2940 
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
131 diamond 2941 
      мусор - напоминаю, счёт ведётся с 0);
77 diamond 2942 
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
2943 
      то возвращается eax=6(EOF); иначе eax=0.
2944 
    Для /fd/x:
2945 
    * если начальный блок не меньше 14-го, то возвращается
2946 
      eax=5 (not found) и ebx=0;
2947 
    * кстати говоря, формат FAT12 допускает дискеты с размером
2948 
      корневого каталога меньше или больше 14 блоков;
2949 
    * проверки длины не делается;
2950 
    * если удалось прочитать данные с дискеты, возвращается
2951 
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
2952 
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
2953 
    но результат не соответствует ожидаемому
2954 
    (по работе с обычными файлами/папками), не следует установленным
2955 
    правилам, может измениться в следующих версиях ядра и потому
2956 
    не описывается. Для получения информации об оборудовании
2957 
    используйте подфункцию 11 функции 18 или
2958 
    читайте соответствующие папки подфункцией 1 функции 70.
2959 
 
2960 
======================================================================
2961 
========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
2962 
======================================================================
2963 
Параметры:
2964 
  * eax = 58 - номер функции
2965 
  * ebx = указатель на информационную структуру
2966 
Формат информационной структуры:
2967 
  * +0: dword: 8 = номер подфункции
2968 
  * +4: dword: номер блока для чтения (считая с 0)
2969 
  * +8: dword: игнорируется (устанавливайте в 1)
2970 
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
2971 
    (512 байт)
2972 
  * +16 = +0x10: dword: указатель на буфер для работы системы
2973 
    (4096 байт)
2974 
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
2975 
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
2976 
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
2977 
    Вместо цифр допускается, хотя и не рекомендуется для удобства
2978 
    перехода на будущие расширения,
2979 
    использование 'first','second','third','fourth'.
2980 
Возвращаемое значение:
2981 
  * если указано имя устройства /hd/xxx, где xxx не находится
2982 
    в списке выше:
2983 
    * eax = ebx = 1
2984 
  * если указано неправильное имя устройства
2985 
    (за исключением предыдущего случая):
2986 
    * eax = 5
2987 
    * ebx не меняется
131 diamond 2988 
  * если LBA-доступ запрещён подфункцией 11 функции 21:
77 diamond 2989 
    * eax = 2
2990 
    * ebx разрушается
2991 
  * для рамдиска: попытка чтения блока за пределами рамдиска
2992 
    (18*2*80 блоков) приводит к
2993 
    * eax = 3
2994 
    * ebx = 0
2995 
  * при успешном чтении:
2996 
    * eax = ebx = 0
2997 
Замечания:
2998 
  * Размер блока - 512 байт; читается один блок.
2999 
  * Не следует полагаться на возвращаемое значение,
3000 
    оно может измениться в следующих версиях.
2010 serge 3001 
  * Требуется, чтобы был разрешён LBA-доступ к устройствам
3002 
    подфункцией 11 функции 21. Узнать это можно вызовом
77 diamond 3003 
    подфункцией 11 функции 26.
3004 
  * LBA-чтение дискеты не поддерживается.
131 diamond 3005 
  * Функция считывает данные физического жёсткого диска;
77 diamond 3006 
    если по каким-то причинам нужны данные конкретного раздела,
131 diamond 3007 
    придётся определять начальный сектор этого раздела
77 diamond 3008 
    (либо напрямую через MBR, либо из расширенной структуры,
3009 
    возвращаемой той же подфункцией 11 функции 18).
131 diamond 3010 
  * Функция не проверяет код ошибки жёсткого диска, так что запрос
3011 
    несуществующего сектора всё равно что-то прочитает
77 diamond 3012 
    (вероятнее всего, нули, но это определяется устройством) и
3013 
    это будет считаться успехом (eax=0).
3014 
 
3015 
======================================================================
2010 serge 3016 
= Функция 58, подфункция 15 - получить информацию о файловой системе.
77 diamond 3017 
======================================================================
3018 
Параметры:
3019 
  * eax = 58 - номер функции
3020 
  * ebx = указатель на информационную структуру
3021 
Формат информационной структуры:
118 diamond 3022 
  * +0: dword: 15 = номер подфункции
77 diamond 3023 
  * +4: dword: игнорируется
3024 
  * +8: dword: игнорируется
3025 
  * +12 = +0xC: dword: игнорируется
3026 
  * +16 = +0x10: dword: игнорируется
3027 
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
3028 
    /rd=/RAMDISK или /hd=/HARDDISK
3029 
Возвращаемое значение:
3030 
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
3031 
    * eax = 3
3032 
    * ebx = ecx = dword [fileinfo] = 0
3033 
  * для рамдиска:
3034 
    * eax = 0 (успех)
3035 
    * ebx = общее число кластеров = 2847
3036 
    * ecx = число свободных кластеров
3037 
    * dword [fileinfo] = размер кластера = 512
131 diamond 3038 
  * для жёсткого диска: база и раздел определяются подфункциями 7 и 8
77 diamond 3039 
    функции 21:
3040 
    * eax = 0 (успех)
3041 
    * ebx = общее число кластеров
3042 
    * ecx = число свободных кластеров
3043 
    * dword [fileinfo] = размер кластера (в байтах)
3044 
Замечания:
3045 
  * Не удивляйтесь странному расположению 4-го возвращаемого
3046 
    параметра - когда писался этот код, при системных вызовах
3047 
    приложению возвращались только регистры eax,ebx,ecx (из
3048 
    pushad-структуры, передающейся как аргумент системной функции).
3049 
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
3050 
    размер кластера в edx, пока эту функцию не начали использовать.
131 diamond 3051 
  * Вообще-то ещё существует подфункция 11 функции 18, возвращающая
77 diamond 3052 
    информацию о файловой системе. По расширенной таблице дисковой
3053 
    подсистемы можно определить размер кластера (там он хранится
131 diamond 3054 
    в секторах) и общее число кластеров для жёстких дисков.
77 diamond 3055 
 
3056 
======================================================================
3057 
=========== Функция 60 - Inter Process Communication (IPC). ==========
3058 
======================================================================
3059 
IPC применяется для посылок сообщений от одного процесса/потока
3060 
другому. При этом следует предварительно договориться о том, как
3061 
интерпретировать конкретное сообщение.
3062 
 
3063 
-------- Подфункция 1 - установить область для получения IPC ---------
131 diamond 3064 
Вызывается процессом-приёмником.
77 diamond 3065 
Параметры:
3066 
  * eax = 60 - номер функции
3067 
  * ebx = 1 - номер подфункции
3068 
  * ecx = указатель на буфер
3069 
  * edx = размер буфера
3070 
Возвращаемое значение:
3071 
  * eax = 0 - всегда успешно
3072 
Формат IPC-буфера:
3073 
  * +0: dword: если здесь не 0, то буфер считается заблокированным;
3074 
    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
3075 
    и вам надо, чтобы извне не изменялись данные буфера
3076 
    (не поступали новые сообщения)
3077 
  * +4: dword: занято места в буфере (в байтах)
3078 
  * +8: первое сообщение
3079 
  * +8+n: второе сообщение
3080 
  * ...
3081 
Формат сообщения:
3082 
  * +0: dword: PID процесса/потока, пославшего сообщение
3083 
  * +4: dword: длина сообщения (не считая этот заголовок)
3084 
  * +8: n*byte: данные сообщения
3085 
 
3086 
--------------- Подфункция 2 - послать сообщение IPC. ----------------
3087 
Вызывается процессом-инициатором.
3088 
Параметры:
3089 
  * eax = 60 - номер функции
3090 
  * ebx = 2 - номер подфункции
131 diamond 3091 
  * ecx = PID приёмника
77 diamond 3092 
  * edx = указатель на данные сообщения
3093 
  * esi = длина сообщения (в байтах)
3094 
Возвращаемое значение:
3095 
  * eax = 0 - успешно
131 diamond 3096 
  * eax = 1 - приёмник не определил буфер для IPC-сообщений
3097 
    (может быть, ещё не успел, а может быть, это не тот поток,
77 diamond 3098 
    который нужен)
131 diamond 3099 
  * eax = 2 - приёмник заблокировал IPC-буфер;
77 diamond 3100 
    попробуйте немного подождать
131 diamond 3101 
  * eax = 3 - переполнение IPC-буфера приёмника
77 diamond 3102 
  * eax = 4 - процесса/потока с таким PID не существует
3103 
Замечания:
3104 
  * Система сразу после записи IPC-сообщения в буфер посылает
131 diamond 3105 
    потоку-приёмнику событие с кодом 7 (см. коды событий).
77 diamond 3106 
 
3107 
======================================================================
3108 
=== Функция 61 - получить параметры для прямого доступа к графике. ===
3109 
======================================================================
3110 
Программе доступны данные графического экрана (область памяти, которая
3111 
собственно и отображает содержимое экрана) напрямую без вызовов
3112 
системных функций через селектор gs:
2010 serge 3113 
	mov	eax, [gs:0]
77 diamond 3114 
поместит в eax первый dword буфера, содержащий информацию о цвете
3115 
левой верхней точки (и, возможно, цвета нескольких следующих).
2010 serge 3116 
	mov	[gs:0], eax
77 diamond 3117 
при работе в режимах VESA c LFB
3118 
установит цвет левой верхней точки
3119 
(и возможно, цвета нескольких следующих).
3120 
Для интерпретации данных графического экрана требуется знание
3121 
некоторых параметров, которые возвращаются этой функцией.
3122 
Замечания:
3123 
  * Параметры графики очень редко меняются при работе системы,
3124 
    а именно, только в случаях, когда пользователь работает
3125 
    с программой VRR.
3126 
  * При изменении видеорежима система перерисовывает все окна
3127 
    (событие с кодом 1) и перерисовывает фон (событие 5).
3128 
    Эти же события происходят и в других случаях,
3129 
    которые встречаются значительно чаще, чем изменение видеорежима.
3130 
  * При работе в видеорежимах с LFB селектор gs указывает на
3131 
    собственно LFB, так что чтение/запись по gs приводят
3132 
    непосредственно к изменению содержимого экрана. При работе в
3133 
    видеорежимах без LFB gs указывает на некоторую область данных
131 diamond 3134 
    ядра, причём все функции вывода на экран добросовестно выполняют
77 diamond 3135 
    двойную работу по записи непосредственно на экран и по записи
3136 
    в этот буфер. В результате при чтении содержимого этого буфера
3137 
    результаты соответствуют содержимому экрана
3138 
    (с, вообще говоря, большим цветовым разрешением),
3139 
    а запись игнорируется.
3140 
    Исключением является режим 320*200, для которого в главном цикле
3141 
    системного потока выполняется обновление экрана в соответствии
3142 
    с движениями курсора мыши.
3143 
 
3144 
------------------------- Разрешение экрана --------------------------
3145 
Параметры:
3146 
  * eax = 61 - номер функции
3147 
  * ebx = 1 - номер подфункции
3148 
Возвращаемое значение:
3149 
  * eax = [разрешение по оси x]*65536 + [разрешение по оси y]
3150 
Замечания:
131 diamond 3151 
  * Можно использовать функцию 14 с учётом того, что она возвращает
77 diamond 3152 
    размеры на 1 меньше. Это полностью эквивалентный способ.
3153 
 
3154 
------------------------ Число бит на пиксель ------------------------
3155 
Параметры:
3156 
  * eax = 61 - номер функции
3157 
  * ebx = 2 - номер подфункции
3158 
Возвращаемое значение:
3159 
  * eax = число бит на пиксель (24 или 32)
3160 
 
3161 
------------------------ Число байт на строку ------------------------
3162 
Параметры:
3163 
  * eax = 61 - номер функции
3164 
  * ebx = 3 - номер подфункции
3165 
Возвращаемое значение:
131 diamond 3166 
  * eax = число байт, которое занимает одна строка развёртки
77 diamond 3167 
    (горизонтальная линия на экране)
3168 
 
3169 
======================================================================
3170 
===== Функция 62, подфункция 0 - получить версию PCI-интерфейса. =====
3171 
======================================================================
3172 
Параметры:
3173 
  * eax = 62 - номер функции
3174 
  * bl = 0 - номер подфункции
3175 
Возвращаемое значение:
131 diamond 3176 
  * eax = -1 - доступ к PCI запрещён; иначе
77 diamond 3177 
  * ah.al = версия PCI-интерфейса (ah=версия, al=подверсия)
3178 
  * старшее слово eax обнулено
3179 
Замечания:
131 diamond 3180 
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3181 
    для приложений подфункцией 12 функции 21.
118 diamond 3182 
  * Если PCI BIOS не поддерживается, то значение ax неопределено.
77 diamond 3183 
 
3184 
======================================================================
3185 
==== Функция 62, подфункция 1 - получить номер последней PCI-шины. ===
3186 
======================================================================
3187 
Параметры:
3188 
  * eax = 62 - номер функции
3189 
  * bl = 1 - номер подфункции
3190 
Возвращаемое значение:
131 diamond 3191 
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3192 
  * al = номер последней PCI-шины; оставшиеся байты eax разрушаются
77 diamond 3193 
Замечания:
131 diamond 3194 
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3195 
    для приложений подфункцией 12 функции 21.
118 diamond 3196 
  * Если PCI BIOS не поддерживается, то значение al неопределено.
77 diamond 3197 
 
3198 
======================================================================
3199 
====================== Функция 62, подфункция 2 ======================
3200 
== Получить механизм обращения к конфигурационному пространству PCI. =
3201 
======================================================================
3202 
Параметры:
3203 
  * eax = 62 - номер функции
3204 
  * bl = 2 - номер подфункции
3205 
Возвращаемое значение:
131 diamond 3206 
  * eax = -1 - доступ к PCI запрещён; иначе
118 diamond 3207 
  * al = механизм (1 или 2); прочие байты eax разрушаются
77 diamond 3208 
Замечания:
131 diamond 3209 
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3210 
    для приложений подфункцией 12 функции 21.
3211 
  * Механизм обращения выбирается в соответствии
3212 
    с характеристиками оборудования.
3213 
  * Подфункции чтения и записи автоматически работают
3214 
    с выбранным механизмом.
3215 
 
3216 
======================================================================
3217 
======== Функция 62, подфункции 4,5,6 - прочитать PCI-регистр. =======
3218 
======================================================================
3219 
Параметры:
3220 
  * eax = 62 - номер функции
3221 
  * bl = 4 - читать байт
3222 
  * bl = 5 - читать слово
3223 
  * bl = 6 - читать двойное слово
3224 
  * bh = номер PCI-шины
3225 
  * ch = dddddfff, где ddddd = номер устройства на шине,
3226 
    fff = номер функции устройства
131 diamond 3227 
  * cl = номер регистра (должен быть чётным для bl=5,
77 diamond 3228 
    делиться на 4 для bl=6)
3229 
Возвращаемое значение:
131 diamond 3230 
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3231 
    неподдерживаемые параметры); иначе
3232 
  * al/ax/eax (в зависимости от запрошенного размера) содержит данные;
3233 
    оставшаяся часть регистра eax разрушается
3234 
Замечания:
131 diamond 3235 
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3236 
    для приложений подфункцией 12 функции 21.
3237 
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3238 
    игнорирует номер функции. Получить механизм доступа можно вызовом
3239 
    подфункции 2.
3240 
  * Некоторые регистры стандартны и существуют для всех устройств,
3241 
    некоторые определяются конкретным устройством. Список первых
3242 
    входит, например, в известный Interrupt List by Ralf Brown
3243 
    (http://www.pobox.com/~ralf/files.html,
3244 
    ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
3245 
    список вторых должен быть указан в документации по устройству.
3246 
 
3247 
======================================================================
3248 
======= Функция 62, подфункции 8,9,10 - записать в PCI-регистр. ======
3249 
======================================================================
3250 
Параметры:
3251 
  * eax = 62 - номер функции
3252 
  * bl = 8 - писать байт
3253 
  * bl = 9 - писать слово
3254 
  * bl = 10 - писать двойное слово
3255 
  * bh = номер PCI-шины
3256 
  * ch = dddddfff, где ddddd = номер устройства на шине,
3257 
    fff = номер функции устройства
131 diamond 3258 
  * cl = номер регистра (должен быть чётным для bl=9,
77 diamond 3259 
    делиться на 4 для bl=10)
92 diamond 3260 
  * dl/dx/edx (в зависимости от запрошенного размера) содержит
3261 
    данные для записи
77 diamond 3262 
Возвращаемое значение:
131 diamond 3263 
  * eax = -1 - ошибка (запрещён доступ к PCI или
77 diamond 3264 
    неподдерживаемые параметры)
3265 
  * eax = 0 - успешно
3266 
Замечания:
131 diamond 3267 
  * Предварительно должен быть разрешён низкоуровневый доступ к PCI
77 diamond 3268 
    для приложений подфункцией 12 функции 21.
3269 
  * Механизм доступа 2 поддерживает только 16 устройств на шине и
3270 
    игнорирует номер функции. Получить механизм доступа можно вызовом
3271 
    подфункции 2.
3272 
  * Некоторые регистры стандартны и существуют для всех устройств,
3273 
    некоторые определяются конкретным устройством. Список первых
3274 
    входит, например, в известный Interrupt List by Ralf Brown;
3275 
    список вторых должен быть указан в документации по устройству.
3276 
 
3277 
======================================================================
3278 
================ Функция 63 - работа с доской отладки. ===============
3279 
======================================================================
448 diamond 3280 
Доска отладки представляет собой системный буфер (на 4096 байт),
77 diamond 3281 
в который любая программа может записать (вообще говоря, произвольные)
3282 
данные и из которого другая программа может эти данные прочитать.
3283 
Есть соглашение, в соответствии с которым записываемые данные -
3284 
текстовые строки, интерпретируемые как отладочные сообщения о ходе
131 diamond 3285 
выполнения программы. Ядро в определённых ситуациях также записывает
77 diamond 3286 
на доску отладки сведения о выполнении некоторых функций;
3287 
по соглашению сообщения ядра начинаются с префикса "K : ".
3288 
Для просмотра доски отладки создано приложение board,
131 diamond 3289 
которое считывает данные из буфера и отображает их в своём окне. board
77 diamond 3290 
понимает последовательность кодов 13,10 как переход на новую строку.
3291 
Символ с нулевым кодом в конце строки не обязателен, но и не мешает.
3292 
В связи с появлением отладчика ценность доски отладки несколько
3293 
снизилась, поскольку отладчик позволяет полностью контролировать ход
131 diamond 3294 
выполнения программы, причём для этого не требуется никаких усилий
77 diamond 3295 
со стороны самой программы. Тем не менее во многих случаях
3296 
доска отладки продолжает оставаться полезной.
3297 
 
3298 
---------------------------- Запись байта ----------------------------
3299 
Параметры:
3300 
  * eax = 63 - номер функции
3301 
  * ebx = 1 - номер подфункции
3302 
  * cl = байт данных
3303 
Возвращаемое значение:
3304 
  * функция не возвращает значения
3305 
Замечания:
3306 
  * Байт записывается в буфер. Длина буфера - 512 байт.
3307 
    При переполнении буфера все полученные данные теряются
3308 
    и заполнение начинается снова с нуля.
3309 
  * Для вывода на доску отладки более сложных объектов (строк, чисел)
3310 
    достаточно этой функции, вызываемой в цикле. Можно не писать
3311 
    вручную соответствующий код, а воспользоваться файлом debug.inc,
3312 
    входящим в дистрибутив.
3313 
 
3314 
---------------------------- Чтение байта ----------------------------
3315 
Забирает байт из буфера.
3316 
Параметры:
3317 
  * eax = 63 - номер функции
3318 
  * ebx = 2 - номер подфункции
3319 
Возвращаемое значение:
3320 
  * eax = ebx = 0 - буфер пуст
3321 
  * eax = байт, ebx = 1 - байт успешно прочитан
3322 
 
3323 
======================================================================
3324 
========== Функция 64 - перераспределить память приложения. ==========
3325 
======================================================================
3326 
Параметры:
3327 
  * eax = 64 - номер функции
3328 
  * ebx = 1 - единственная подфункция
3329 
  * ecx = новый размер памяти
3330 
Возвращаемое значение:
3331 
  * eax = 0 - успешно
3332 
  * eax = 1 - недостаточно памяти
3333 
Замечания:
172 serge 3334 
  * Есть другой способ выделения/освобождения динамической памяти -
3335 
    подфункции 11, 12, 13 функции 68.
277 diamond 3336 
  * Функция не может использоваться совместно с 68.11, 68.12, 68.13.
3337 
    Вызов функции будет игнорироваться, если приложение создаст
3338 
    локальную кучу вызовом 68.11.
77 diamond 3339 
 
3340 
======================================================================
283 diamond 3341 
========= Функция 65 - вывести изображение с палитрой в окно. ========
3342 
======================================================================
3343 
Параметры:
3344 
  * eax = 65 - номер функции
3345 
  * ebx = указатель на изображение
3346 
  * ecx = [размер по оси x]*65536 + [размер по оси y]
3347 
  * edx = [координата по оси x]*65536 + [координата по оси y]
2987 Serge 3348 
  * esi = число бит на пиксель, должно быть 1,2,4,8,9,15,16,24 или 32
911 diamond 3349 
  * edi = указатель на палитру (2 в степени esi цветов 0x00RRGGBB);
906 diamond 3350 
          игнорируется при esi > 8
314 diamond 3351 
  * ebp = смещение данных каждой следующей строки изображения
3352 
          относительно предыдущей
283 diamond 3353 
Возвращаемое значение:
3354 
  * функция не возвращает значения
3355 
Замечания:
3356 
  * Координаты изображения - это координаты верхнего левого угла
3357 
    изображения относительно окна.
911 diamond 3358 
  * Формат изображения с 1 битом на пиксель: каждый байт изображения,
3359 
    за исключением, быть может, последних байтов строк, содержит
3360 
    информацию о цвете 8 пикселей, старший бит соответствует первому
3361 
    пикселю.
1018 diamond 3362 
  * Формат изображения с 2 битами на пиксель: каждый байт изображения,
3363 
    за исключением, быть может, последних байтов строк, содержит
3364 
    информацию о цвете 4 пикселей, старшие два бита соответствуют
3365 
    первому пикселю.
911 diamond 3366 
  * Формат изображения с 4 битами на пиксель: каждый байт изображения,
3367 
    за исключением последних байтов строк (если ширина изображения
3368 
    нечётна), содержит информацию о цвете 2 пикселей, старшая тетрада
3369 
    соответствует первому пикселю.
842 diamond 3370 
  * Формат изображения с 8 битами на пиксель: каждый байт изображения
3371 
    рассматривается как индекс в палитре.
2987 Serge 3372 
  * Формат изображения с 9 битами на пиксель: каждый байт изображения
3373 
    (8 бит) обозначает интенсивность серого для одного пикселя, т.о.
3374 
    этот тип изображения идентичен 8 бит на пиксель без палитры.
906 diamond 3375 
  * Формат изображения с 15 битами на пиксель: цвет каждого пикселя
842 diamond 3376 
    кодируется как (в битовом представлении) 0RRRRRGGGGGBBBBB -
3377 
    по 5 пикселей на каждый цвет.
906 diamond 3378 
  * Формат изображения с 16 битами на пиксель: цвет каждого пикселя
3379 
    кодируется как RRRRRGGGGGGBBBBB (схема 5+6+5).
842 diamond 3380 
  * Формат изображения с 24 битами на пиксель: цвет каждого пикселя
1018 diamond 3381 
    кодируется тремя байтами - последовательно синяя, зелёная, красная
3382 
    составляющие цвета.
842 diamond 3383 
  * Формат изображения с 32 битами на пиксель: аналогично 24, только
3384 
    есть ещё игнорируемый четвёртый байт.
314 diamond 3385 
  * Вызов функции 7 эквивалентен вызову этой функции с параметрами
3386 
    esi=24, ebp=0.
283 diamond 3387 
 
3388 
======================================================================
92 diamond 3389 
================= Функция 66 - работа с клавиатурой. =================
77 diamond 3390 
======================================================================
92 diamond 3391 
Режим ввода влияет на результаты чтения клавиш функцией 2.
131 diamond 3392 
При загрузке программы для неё устанавливается ASCII-режим ввода.
77 diamond 3393 
 
92 diamond 3394 
-------- Подфункция 1 - установить режим ввода с клавиатуры. ---------
77 diamond 3395 
Параметры:
3396 
  * eax = 66 - номер функции
3397 
  * ebx = 1 - номер подфункции
3398 
  * ecx = режим:
3399 
    * 0 = обычный (ASCII-символы)
3400 
    * 1 = сканкоды
3401 
Возвращаемое значение:
3402 
  * функция не возвращает значения
3403 
 
92 diamond 3404 
--------- Подфункция 2 - получить режим ввода с клавиатуры. ----------
77 diamond 3405 
Параметры:
3406 
  * eax = 66 - номер функции
3407 
  * ebx = 2 - номер подфункции
3408 
Возвращаемое значение:
3409 
  * eax = текущий режим
3410 
 
3411 
------- Подфункция 3 - получить состояние управляющих клавиш. --------
3412 
Параметры:
3413 
  * eax = 66 - номер функции
3414 
  * ebx = 3 - номер подфункции
3415 
Возвращаемое значение:
3416 
  * eax = битовая маска:
3500 Serge 3417 
  * бит 0  (маска 1): левый Shift нажат
3418 
  * бит 1  (маска 2): правый Shift нажат
3419 
  * бит 2  (маска 4): левый Ctrl нажат
3420 
  * бит 3  (маска 8): правый Ctrl нажат
3421 
  * бит 4  (маска 0x10): левый Alt нажат
3422 
  * бит 5  (маска 0x20): правый Alt нажат
3423 
  * бит 6  (маска 0x40): CapsLock включён
3424 
  * бит 7  (маска 0x80): NumLock включён
3425 
  * бит 8  (маска 0x100): ScrollLock включён
3426 
  * бит 9  (маска 0x200): левый Win нажат
3427 
  * бит 10 (маска 0x400): правый Win нажат
77 diamond 3428 
  * прочие биты сброшены
3429 
 
92 diamond 3430 
----- Подфункция 4 - установить общесистемную "горячую клавишу". -----
3431 
О нажатии "горячей клавиши" извещаются только приложения,
131 diamond 3432 
установившие её; активное приложение (к которому поступает
92 diamond 3433 
весь нормальный ввод) таких клавиш не получает.
3434 
Извещение заключается в посылке события с кодом 2.
3435 
Прочитать "горячую клавишу" можно так же, как и обычную, -
3436 
функцией 2.
3437 
Параметры:
3438 
  * eax = 66 - номер функции
3439 
  * ebx = 4 - номер подфункции
131 diamond 3440 
  * cl задаёт сканкод клавиши;
92 diamond 3441 
    используйте cl=0 для задания комбинаций типа Ctrl+Shift
131 diamond 3442 
  * edx = 0xXYZ задаёт возможные состояния управляющих клавиш:
3443 
    * Z (младшие 4 бита) задаёт состояние клавиш LShift и RShift:
92 diamond 3444 
      * 0 = ни одна из клавиш не должна быть нажата;
3445 
      * 1 = ровно одна из клавиш должна быть нажата;
3446 
      * 2 = обе клавиши должны быть нажаты;
3447 
      * 3 = должна быть нажата LShift, но не RShift;
3448 
      * 4 = должна быть нажата RShift, но не LShift
3449 
    * Y - аналогично для LCtrl и RCtrl;
3450 
    * X - аналогично для LAlt и RAlt
3451 
Возвращаемое значение:
3452 
  * eax=0 - успешно
3453 
  * eax=1 - слишком много "горячих клавиш" (допускается максимум 256)
3454 
Замечания:
3455 
  * Горячая клавиша может срабатывать либо при нажатии,
3456 
    либо при отпускании. Сканкод отпускания клавиши на 128 больше,
3457 
    чем сканкод нажатия (т.е. установлен старший бит).
3458 
  * Несколько приложений могут установить одну и ту же комбинацию;
3459 
    о нажатии такой комбинации будут извещаться все такие приложения.
3460 
 
3461 
------ Подфункция 5 - удалить установленную "горячую клавишу". -------
3462 
Параметры:
3463 
  * eax = 66 - номер функции
3464 
  * ebx = 5 - номер подфункции
3465 
  * cl = сканкод клавиши и edx = 0xXYZ такие же, как и в подфункции 4
3466 
Возвращаемое значение:
3467 
  * eax = 0 - успешно
3468 
  * eax = 1 - нет такой горячей клавиши
3469 
Замечания:
3470 
  * При завершении процесса/потока удаляются все установленные им
3471 
    горячие клавиши.
3472 
  * Вызов функции не влияет на другие приложения.
3473 
    Если другое приложение определило эту же комбинацию,
3474 
    оно по-прежнему будет получать уведомления.
3475 
 
2987 Serge 3476 
------------- Подфункция 6 - заблокировать обычный ввод. -------------
3477 
Параметры:
3478 
  * eax = 66 - номер функции
3479 
  * ebx = 6 - номер подфункции
3480 
Возвращаемое значение:
3481 
  * функция не возвращает значения
3482 
Замечания:
3483 
  * Блокируется обычный ввод данных с клавиатуры для установленных
3484 
    "горячих" клавиш
3485 
  * Для эмуляции мыши через клавиатуру, приложение MOUSEMUL
3486 
 
3487 
--------- Подфункция 7 - разблокировать обычный ввод. ----------------
3488 
Параметры:
3489 
  * eax = 66 - номер функции
3490 
  * ebx = 7 - номер подфункции
3491 
Возвращаемое значение:
3492 
  * функция не возвращает значения
3493 
Замечания:
3494 
  * Разблокирование результатов ф. 66.6
3495 
  * Для эмуляции мыши через клавиатуру, приложение MOUSEMUL
3496 
 
77 diamond 3497 
======================================================================
3498 
============ Функция 67 - изменить положение/размеры окна. ===========
3499 
======================================================================
3500 
Параметры:
3501 
  * eax = 67 - номер функции
3502 
  * ebx = новая x-координата окна
3503 
  * ecx = новая y-координата окна
3504 
  * edx = новый x-размер окна
3505 
  * esi = новый y-размер окна
3506 
Возвращаемое значение:
3507 
  * функция не возвращает значения
3508 
Замечания:
3509 
  * Значение -1 для параметра означает "не изменять"; например, для
3510 
    перемещения окна без изменения размеров можно указать edx=esi=-1.
3511 
  * Предварительно окно должно быть определено функцией 0.
131 diamond 3512 
    Она же задаёт начальные координаты и размеры окна.
77 diamond 3513 
  * Размеры окна понимаются в смысле функции 0, т.е.
3514 
    на один пиксель меньше, чем реальные размеры.
3515 
  * Вызов функции для максимизированных окон просто игнорируется.
3516 
  * Для окон соответствующих стилей положение и/или размеры могут быть
3517 
    изменены пользователем; текущие положение и размеры могут быть
3518 
    получены вызовом функции 9.
3519 
  * Функция посылает окну событие перерисовки (с кодом 1).
3520 
 
3521 
======================================================================
131 diamond 3522 
=== Функция 68, подфункция 0 - получить счётчик переключений задач. ==
77 diamond 3523 
======================================================================
3524 
Параметры:
3525 
  * eax = 68 - номер функции
3526 
  * ebx = 0 - номер подфункции
3527 
Возвращаемое значение:
3528 
  * eax = число переключений задач с момента загрузки системы
3529 
    (по модулю 2^32)
3530 
 
3531 
======================================================================
3532 
====================== Функция 68, подфункция 1 ======================
3533 
============ Переключиться на следующий поток выполнения. ============
3534 
======================================================================
3535 
Функция завершает текущий квант времени, выделенный потоку,
3536 
и переключается на следующий.
3537 
(Какой поток какого процесса будет следующим, предсказать нельзя).
131 diamond 3538 
Позднее, когда до текущего потока дойдёт очередь,
77 diamond 3539 
выполнение возобновится.
3540 
Параметры:
3541 
  * eax = 68 - номер функции
3542 
  * ebx = 1 - номер подфункции
3543 
Возвращаемое значение:
3544 
  * функция не возвращает значения
3545 
 
3546 
======================================================================
3547 
=============== Функция 68, подфункция 2 - кэш + rdpmc. ==============
3548 
======================================================================
3549 
Параметры:
3550 
  * eax = 68 - номер функции
3551 
  * ebx = 2 - номер подфункции
3552 
  * ecx = требуемое действие:
3553 
    * ecx = 0 - разрешить выполнение инструкции rdpmc
3554 
      (ReaD Performance-Monitoring Counters)
131 diamond 3555 
    * ecx = 1 - узнать, включён/выключен кэш
77 diamond 3556 
    * ecx = 2 - включить кэш
3557 
    * ecx = 3 - выключить кэш
3558 
Возвращаемое значение:
3559 
  * для ecx=0:
3560 
    * eax = значение cr4
3561 
  * для ecx=1:
3562 
    * eax = (cr0 and 0x60000000):
131 diamond 3563 
    * eax = 0 - кэш включён
77 diamond 3564 
    * eax <> 0 - кэш выключен
3565 
  * для ecx=2 и ecx=3:
3566 
    * функция не возвращает значения
3567 
 
3568 
======================================================================
3569 
========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
3570 
======================================================================
3571 
MSR = Model Specific Register; полный список MSR-регистров процессора
3572 
содержится в документации по процессору (например, IA-32 Intel
3573 
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3574 
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3575 
Параметры:
3576 
  * eax = 68 - номер функции
3577 
  * ebx = 3 - номер подфункции
3578 
  * ecx игнорируется
3579 
  * edx = адрес MSR
3580 
Возвращаемое значение:
3581 
  * ebx:eax = старший:младший dword результата
3582 
Замечания:
3583 
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3584 
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3585 
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3586 
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3587 
    которое всё равно прибьёт поток.
77 diamond 3588 
 
3589 
======================================================================
3590 
========= Функция 68, подфункция 4 - записать в MSR-регистр. =========
3591 
======================================================================
3592 
MSR = Model Specific Register; полный список MSR-регистров процессора
3593 
содержится в документации по процессору (например, IA-32 Intel
3594 
Architecture Software Developer's Manual, Volume 3, Appendix B);
131 diamond 3595 
каждое семейство процессоров имеет своё подмножество MSR-регистров.
77 diamond 3596 
Параметры:
3597 
  * eax = 68 - номер функции
3598 
  * ebx = 4 - номер подфункции
3599 
  * ecx игнорируется
3600 
  * edx = адрес MSR
3601 
  * esi:edi = старший:младший dword
3602 
Возвращаемое значение:
499 diamond 3603 
  * функция не возвращает значения
77 diamond 3604 
Замечания:
3605 
  * Указание в ecx несуществующего или нереализованного для данного
131 diamond 3606 
    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
77 diamond 3607 
  * Предварительно следует определить, поддерживаются ли MSR в целом,
3608 
    командой cpuid. Иначе возникнет уже другое исключение в ядре,
131 diamond 3609 
    которое всё равно прибьёт поток.
77 diamond 3610 
 
3611 
======================================================================
172 serge 3612 
===== Функция 68, подфункция 11 - инициализировать кучу процесса. ====
77 diamond 3613 
======================================================================
3614 
Параметры:
3615 
  * eax = 68 - номер функции
172 serge 3616 
  * ebx = 11 - номер подфункции
77 diamond 3617 
Возвращаемое значение:
172 serge 3618 
  * eax = 0 - неуспех
3619 
  * иначе размер созданной кучи
77 diamond 3620 
Замечания:
172 serge 3621 
  * Вызов функции инициализирует кучу, из которой впоследствии можно
3622 
    выделять и освобождать блоки памяти подфункциями 12 и 13.
188 serge 3623 
    Размер кучи равен размеру всей свободной памяти приложения.
277 diamond 3624 
  * При повторном вызове функции тем же процессом функция вернёт
3625 
    размер существующей кучи.
3626 
  * После создания кучи вызовы функции 64 игнорируются.
77 diamond 3627 
 
3628 
======================================================================
172 serge 3629 
========== Функция 68, подфункция 12 - выделить блок памяти. =========
77 diamond 3630 
======================================================================
3631 
Параметры:
3632 
  * eax = 68 - номер функции
172 serge 3633 
  * ebx = 12 - номер подфункции
3634 
  * ecx = требуемый размер в байтах
77 diamond 3635 
Возвращаемое значение:
172 serge 3636 
  * eax = указатель на выделенный блок
77 diamond 3637 
Замечания:
172 serge 3638 
  * Предварительно следует инициализировать кучу процесса вызовом
3639 
    подфункции 11.
3640 
  * Функция выделяет целое число страниц (4 Кб) так, что фактический
3641 
    размер выделенного блока больше или равен запрошенному.
77 diamond 3642 
 
3643 
======================================================================
172 serge 3644 
========= Функция 68, подфункция 13 - освободить блок памяти. ========
77 diamond 3645 
======================================================================
3646 
Параметры:
3647 
  * eax = 68 - номер функции
172 serge 3648 
  * ebx = 13 - номер подфункции
3649 
  * ecx = указатель на блок памяти
77 diamond 3650 
Возвращаемое значение:
172 serge 3651 
  * eax = 1 - успешно
3652 
  * eax = 0 - неудача
77 diamond 3653 
Замечания:
448 diamond 3654 
  * Блок памяти должен быть ранее выделен подфункцией 12
3655 
    или подфункцией 20.
77 diamond 3656 
 
3657 
======================================================================
2010 serge 3658 
====================== Функция 68, подфункция 14 =====================
3659 
====== Ожидать получения сигнала от других приложений/драйверов. =====
77 diamond 3660 
======================================================================
3661 
Параметры:
3662 
  * eax = 68 - номер функции
172 serge 3663 
  * ebx = 14 - номер подфункции
1074 Galkov 3664 
  * ecx = указатель на буфер для информации (24 байта)
77 diamond 3665 
Возвращаемое значение:
2010 serge 3666 
  * eax разрушается
172 serge 3667 
  * буфер, на который указывает ecx, содержит следующую информацию:
1074 Galkov 3668 
    * +0: dword: идентификатор последующих данных сигнала
3669 
    * +4: данные принятого сигнала (20 байт), формат которых
3670 
          определяется первым dword-ом
77 diamond 3671 
 
3672 
======================================================================
172 serge 3673 
=========== Функция 68, подфункция 16 - загрузить драйвер. ===========
3674 
======================================================================
3675 
Параметры:
3676 
  * eax = 68 - номер функции
3677 
  * ebx = 16 - номер подфункции
277 diamond 3678 
  * ecx = указатель на ASCIIZ-строку с именем драйвера
172 serge 3679 
Возвращаемое значение:
3680 
  * eax = 0 - неудача
3681 
  * иначе eax = хэндл драйвера
3682 
Замечания:
3683 
  * Если драйвер ещё не загружен, он загружается;
3684 
    если драйвер уже загружен, ничего не меняется.
3685 
  * Имя драйвера чувствительно к регистру символов.
277 diamond 3686 
    Максимальная длина имени - 16 символов, включая завершающий
3687 
    нулевой символ, остальные символы игнорируются.
346 diamond 3688 
  * Драйвер с именем ABC загружается из файла /rd/1/drivers/ABC.obj.
172 serge 3689 
 
3690 
======================================================================
3691 
========== Функция 68, подфункция 17 - управление драйвером. =========
3692 
======================================================================
3693 
Параметры:
3694 
  * eax = 68 - номер функции
3695 
  * ebx = 17 - номер подфункции
3696 
  * ecx = указатель на управляющую структуру:
3697 
    * +0: dword: хэндл драйвера
3698 
    * +4: dword: код функции драйвера
3699 
    * +8: dword: указатель на входные данные
3700 
    * +12 = +0xC: dword: размер входных данных
3701 
    * +16 = +0x10: dword: указатель на выходные данные
3702 
    * +20 = +0x14: dword: размер выходных данных
3703 
Возвращаемое значение:
3704 
  * eax = определяется драйвером
3705 
Замечания:
3706 
  * Коды функций и структура входных/выходных данных
3707 
    определяются драйвером.
3708 
  * Предварительно должен быть получен хэндл драйвера подфункцией 16.
3709 
 
3710 
======================================================================
277 diamond 3711 
============= Функция 68, подфункция 19 - загрузить DLL. =============
3712 
======================================================================
3713 
Параметры:
3714 
  * eax = 68 - номер функции
3715 
  * ebx = 19 - номер подфункции
3716 
  * ecx = указатель на ASCIIZ-строку с полным путём к DLL
3717 
Возвращаемое значение:
3718 
  * eax = 0 - неудача
3719 
  * иначе eax = указатель на таблицу экспорта DLL
3720 
Замечания:
3721 
  * Таблица экспорта представляет собой массив структур по 2 dword'а,
3722 
    заканчивающийся нулём. Первый dword в структуре является
3723 
    указателем на имя функции, второй содержит адрес функции.
3724 
 
3725 
======================================================================
448 diamond 3726 
====== Функция 68, подфункция 20 - перераспределить блок памяти. =====
3727 
======================================================================
3728 
Параметры:
3729 
  * eax = 68 - номер функции
3730 
  * ebx = 20 - номер подфункции
3731 
  * ecx = новый размер в байтах
3732 
  * edx = указатель на уже выделенный блок памяти
3733 
Возвращаемое значение:
3734 
  * eax = указатель на перераспределённый блок, 0 при ошибке
3735 
Замечания:
3736 
  * Предварительно следует инициализировать кучу процесса вызовом
3737 
    подфункции 11.
3738 
  * Функция выделяет целое число страниц (4 Кб) так, что фактический
3739 
    размер выделенного блока больше или равен запрошенному.
3740 
  * Если edx=0, то вызов функции эквивалентен выделению памяти
3741 
    подфункцией 12. В противном случае блок памяти по адресу edx
3742 
    должен быть ранее выделен подфункцией 12 или
3743 
    описываемой подфункцией.
3744 
  * Если ecx=0, то функция освобождает блок памяти по адресу edx и
3745 
    возвращает 0.
3746 
  * Содержимое памяти вплоть до наименьшего из старого и нового
3747 
    размеров сохраняется.
3748 
 
1018 diamond 3749 
======================================================================
2987 Serge 3750 
========= Функция 68, подфункция 21 - загрузить драйвер PE. ==========
3751 
======================================================================
3752 
Параметры:
3753 
  * eax = 68 - номер функции
3754 
  * ebx = 21 - номер подфункции
3755 
  * ecx = указатель на ASCIIZ-строку с именем драйвера
3756 
  * edx = указатель на командную строку
3757 
Возвращаемое значение:
3758 
  * eax = 0 - неудача
3759 
  * иначе eax = хэндл драйвера
3760 
Замечания:
3761 
  * Если драйвер ещё не загружен, он загружается;
3762 
    если драйвер уже загружен, ничего не меняется.
3763 
 
3764 
======================================================================
1018 diamond 3765 
=== Функция 68, подфункция 22 - открыть именованную область памяти. ==
3766 
======================================================================
3767 
Параметры:
945 serge 3768 
  * eax = 68 - номер функции
3769 
  * ebx = 22 - номер подфункции
1018 diamond 3770 
  * ecx = имя области. Максимум 31 символ, включая завершающий ноль
945 serge 3771 
  * edx = размер области в байтах для SHM_CREATE и SHM_OPEN_ALWAYS
1018 diamond 3772 
  * esi = флаги открытия и доступа:
3773 
    * SHM_OPEN        = 0x00 - открыть существующую область памяти.
3774 
                          Если область с таким именем не существует,
3775 
                          функция вернёт код ошибки 5.
3776 
    * SHM_OPEN_ALWAYS = 0x04 - открыть существующую или создать новую
3777 
                          область памяти.
3778 
    * SHM_CREATE      = 0x08 - создать новую область памяти.
3779 
                          Если область с таким именем уже существует,
3780 
                          функция вернёт код ошибки 10.
3781 
    * SHM_READ        = 0x00 - доступ только на чтение
3782 
    * SHM_WRITE       = 0x01 - доступ на чтение и запись
3783 
Возвращаемое значение:
3784 
  * eax = указатель на область памяти, 0 при ошибке
3785 
  * при создании новой области (SHM_CREATE или SHM_OPEN_ALWAYS):
3786 
    edx = 0 - успех, иначе - код ошибки
3787 
  * при открытии существующей области (SHM_OPEN или SHM_OPEN_ALWAYS):
3788 
    edx = код ошибки (при eax=0) или размер области в байтах
945 serge 3789 
Коды ошибок:
1018 diamond 3790 
  * E_NOTFOUND = 5
3791 
  * E_ACCESS = 10
3792 
  * E_NOMEM = 30
3793 
  * E_PARAM = 33
945 serge 3794 
Замечания:
1220 serge 3795 
  * Предварительно следует инициализировать кучу процесса вызовом
3796 
    подфункции 11.
1018 diamond 3797 
  * Если создаётся новая область, то флаги доступа устанавливают
3798 
    максимальные права доступа для остальных процессов. Попытка
3799 
    открытия другим потоком с неразрешёнными правами провалится
3800 
    с кодом ошибки E_ACCESS.
3801 
  * Процесс, создавший область, всегда имеет доступ на запись.
945 serge 3802 
 
1018 diamond 3803 
======================================================================
3804 
=== Функция 68, подфункция 23 - закрыть именованную область памяти. ==
3805 
======================================================================
3806 
Параметры:
945 serge 3807 
  * eax = 68 - номер функции
3808 
  * ebx = 23 - номер подфункции
1018 diamond 3809 
  * ecx = имя области. Максимум 31 символ, включая завершающий ноль
945 serge 3810 
Возвращаемое значение:
1018 diamond 3811 
  * eax разрушается
3812 
Замечания:
3813 
  * Область памяти физически освобождается (с забыванием всех данных
3814 
    и высвобождением физической памяти), когда её закроют
3815 
    все открывшие потоки.
3816 
  * При завершении потока освобождаются все открытые им
3817 
    области памяти.
945 serge 3818 
 
448 diamond 3819 
======================================================================
2010 serge 3820 
==== Функция 68, подфункция 24 - установить обработчик исключений. ===
1077 Galkov 3821 
======================================================================
3822 
Параметры:
3823 
  * eax = 68 - номер функции
3824 
  * ebx = 24 - номер подфункции
3825 
  * ecx = адрес нового обработчика исключений
3826 
  * edx = маска обрабатываемых исключений
3827 
Возвращаемое значение:
1078 Galkov 3828 
  * eax = адрес старого обработчика исключений (0, если не установлен)
1077 Galkov 3829 
  * ebx = маска старого обработчика исключений
3830 
Замечания:
2010 serge 3831 
  * Номер бита в маске исключений соответствует номеру исключения по
3832 
    спецификации на процессор (Intel-PC). Так, например, исключения
3833 
    FPU имеют номер 16 (#MF), а SSE - 19 (#XF).
1077 Galkov 3834 
  * В данной реализации игнорируется запрос на перехват исключения 7
3835 
    - система обрабатывает #NM самостоятельно.
3836 
  * Пользовательский обработчик получает номер исключения параметром
3837 
    в стеке. Поэтому правильный выход из обработчика: RET 4. Возврат
3838 
    при этом производится на команду, вызвавшую исключение.
2010 serge 3839 
  * При передаче управления обработчику исключений сбрасывается
1077 Galkov 3840 
    соответствующий бит в маске исключений. Возникновение этого же
2010 serge 3841 
    исключения впоследствии приведёт к умолчальной обработке такового.
3842 
    А именно: к завершению работы приложения в отсутствии отладчика,
3843 
    приостановка с уведомлением отлаживающего приложения иначе.
3844 
  * После завершения критических действий в обработчике пользователя
1077 Galkov 3845 
    восстановление бита маски данного исключения можно сделать
2010 serge 3846 
    подфункцией 25. Сброс флагов исключений в модулях FPU и XMM также
3847 
    возлагается на обработчик пользователя.
1077 Galkov 3848 
 
3849 
======================================================================
2010 serge 3850 
= Функция 68, подфункция 25 - изменить состояние активности сигнала. =
1077 Galkov 3851 
======================================================================
3852 
Параметры:
3853 
  * eax = 68 - номер функции
3854 
  * ebx = 25 - номер подфункции
3855 
  * ecx = номер сигнала
3856 
  * edx = значение устанавливаемой активности (0/1)
3857 
Возвращаемое значение:
2010 serge 3858 
  * eax = -1 - задан неверный номер сигнала
3859 
  * иначе eax = старое значение активности сигнала (0/1)
1077 Galkov 3860 
Замечания:
3861 
  * В текущей реализации изменяется только маска пользовательского
2010 serge 3862 
    обработчика исключений, установленного подфункцией 24. При этом
1077 Galkov 3863 
    номер сигнала соответствует номеру исключения.
3864 
 
3865 
======================================================================
77 diamond 3866 
======================== Функция 69 - отладка. =======================
3867 
======================================================================
3868 
Процесс может загрузить другой процесс как отлаживаемый установкой
172 serge 3869 
соответствующего бита при вызове подфункции 7 функции 70.
77 diamond 3870 
У процесса может быть только один отладчик; один процесс может
3871 
отлаживать несколько разных. Система уведомляет отладчик о событиях,
3872 
происходящих с отлаживаемым процессом. Сообщения записываются в буфер,
131 diamond 3873 
определённый подфункцией 0.
77 diamond 3874 
Формат сообщения:
3875 
  * +0: dword: код сообщения
3876 
  * +4: dword: PID отлаживаемого процесса
3877 
  * +8: могут присутствовать дополнительные данные,
3878 
    определяемые кодом сообщения
3879 
Коды сообщений:
3880 
  * 1 = исключение
131 diamond 3881 
    * дополнительно передаётся dword-номер исключения
77 diamond 3882 
    * процесс приостановлен
3883 
  * 2 = процесс завершился
3884 
    * приходит при любом завершении: как через системную функцию -1,
3885 
      так и при "убийстве" любым другим процессом
3886 
      (в том числе самим отладчиком)
3887 
  * 3 = отладочное исключение int 1 = #DB
131 diamond 3888 
    * дополнительно передаётся dword-образ регистра DR6:
77 diamond 3889 
      * биты 0-3: выполнено условие соответствующей точки останова
3890 
        (установленной подфункцией 9)
3891 
      * бит 14: исключение произошло из-за режима
3892 
        пошаговой трассировки (установлен флаг TF)
3893 
    * процесс приостановлен
3894 
При завершении отладчика прибиваются все отлаживаемые процессы.
3895 
Если отладчик этого не хочет, он должен предварительно отключиться
3896 
подфункцией 3.
3897 
 
1018 diamond 3898 
Все подфункции применимы только к процессам/потокам, запущенным
3899 
из текущего функцией 70 с установленным флагом отладки.
77 diamond 3900 
Отладка многопоточных программ пока не поддерживается.
3901 
Полный список подфункций:
3902 
  * подфункция 0 - определить область данных для отладочных сообщений
3903 
  * подфункция 1 - получить состояние регистров отлаживаемого потока
3904 
  * подфункция 2 - установить состояние регистров отлаживаемого потока
3905 
  * подфункция 3 - отключиться от отлаживаемого процесса
3906 
  * подфункция 4 - приостановить отлаживаемый поток
3907 
  * подфункция 5 - возобновить выполнение отлаживаемого потока
3908 
  * подфункция 6 - прочитать из памяти отлаживаемого процесса
3909 
  * подфункция 7 - записать в память отлаживаемого процесса
3910 
  * подфункция 8 - завершить отлаживаемый поток
3911 
  * подфункция 9 - установить/снять аппаратную точку останова
3912 
 
3913 
======================================================================
3914 
====================== Функция 69, подфункция 0 ======================
3915 
========= Определить область данных для отладочных сообщений. ========
3916 
======================================================================
3917 
Параметры:
3918 
  * eax = 69 - номер функции
3919 
  * ebx = 0 - номер подфункции
3920 
  * ecx = указатель
3921 
Формат области данных:
3922 
  * +0: dword: N = размер буфера (не считая этого заголовка)
3923 
  * +4: dword: занято в буфере
3924 
  * +8: N*byte: буфер
3925 
Возвращаемое значение:
3926 
  * функция не возвращает значения
3927 
Замечания:
3928 
  * Если поле размера отрицательно, буфер считается заблокированным
3929 
    и при поступлении нового сообщения система будет ждать.
3930 
    Для синхронизации обрамляйте всю работу с буфером операциями
3931 
    блокировки/разблокировки
2010 serge 3932 
    	neg	[bufsize]
77 diamond 3933 
  * Данные в буфере трактуются как массив элементов переменной длины -
3934 
    сообщений. Формат сообщения указан в общем описании.
3935 
 
3936 
======================================================================
3937 
====================== Функция 69, подфункция 1 ======================
3938 
========= Получить состояние регистров отлаживаемого потока. =========
3939 
======================================================================
3940 
Параметры:
3941 
  * eax = 69 - номер функции
3942 
  * ebx = 1 - номер подфункции
3943 
  * ecx = идентификатор потока
3944 
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3945 
  * esi = указатель на структуру контекста
77 diamond 3946 
Возвращаемое значение:
3947 
  * функция не возвращает значения
3948 
Формат структуры контекста: (FPU пока не поддерживается)
3949 
  * +0: dword: eip
3950 
  * +4: dword: eflags
3951 
  * +8: dword: eax
3952 
  * +12 = +0xC: dword: ecx
3953 
  * +16 = +0x10: dword: edx
3954 
  * +20 = +0x14: dword: ebx
3955 
  * +24 = +0x18: dword: esp
3956 
  * +28 = +0x1C: dword: ebp
3957 
  * +32 = +0x20: dword: esi
3958 
  * +36 = +0x24: dword: edi
3959 
Замечания:
3960 
  * Если поток выполняет код 0-кольца, возвращается
3961 
    состояние регистров 3-кольца.
3962 
  * Процесс должен быть загружен для отладки (как указано в
3963 
    общем описании).
3964 
 
3965 
======================================================================
3966 
====================== Функция 69, подфункция 2 ======================
3967 
======== Установить состояние регистров отлаживаемого потока. ========
3968 
======================================================================
3969 
Параметры:
3970 
  * eax = 69 - номер функции
3971 
  * ebx = 2 - номер подфункции
3972 
  * ecx = идентификатор потока
3973 
  * edx = длина структуры контекста, должно быть 0x28=40 байт
118 diamond 3974 
  * esi = указатель на структуру контекста
77 diamond 3975 
Возвращаемое значение:
3976 
  * функция не возвращает значения
3977 
Формат структуры контекста указан в описании подфункции 1.
3978 
Замечания:
3979 
  * Если поток выполняет код 0-кольца, устанавливается
3980 
    состояние регистров 3-кольца.
3981 
  * Процесс должен быть загружен для отладки (как указано в
3982 
    общем описании).
3983 
 
3984 
======================================================================
3985 
== Функция 69, подфункция 3 - отключиться от отлаживаемого процесса. =
3986 
======================================================================
3987 
Параметры:
3988 
  * eax = 69 - номер функции
3989 
  * ebx = 3 - номер подфункции
3990 
  * ecx = идентификатор
3991 
Возвращаемое значение:
3992 
  * функция не возвращает значения
3993 
Замечания:
3994 
  * Если процесс был приостановлен, он возобновляет выполнение.
3995 
 
3996 
======================================================================
1018 diamond 3997 
==== Функция 69, подфункция 4 - приостановить отлаживаемый поток. ====
77 diamond 3998 
======================================================================
3999 
Параметры:
4000 
  * eax = 69 - номер процесса
4001 
  * ebx = 4 - номер подфункции
4002 
  * ecx = идентификатор
4003 
Возвращаемое значение:
4004 
  * функция не возвращает значения
1018 diamond 4005 
Замечания:
4006 
  * Процесс должен быть загружен для отладки (как указано в
4007 
    общем описании).
77 diamond 4008 
 
4009 
======================================================================
4010 
====================== Функция 69, подфункция 5 ======================
1018 diamond 4011 
============ Возобновить выполнение отлаживаемого потока. ============
77 diamond 4012 
======================================================================
4013 
Параметры:
4014 
  * eax = 69 - номер функции
4015 
  * ebx = 5 - номер подфункции
4016 
  * ecx = идентификатор
4017 
Возвращаемое значение:
4018 
  * функция не возвращает значения
1018 diamond 4019 
Замечания:
4020 
  * Процесс должен быть загружен для отладки (как указано в
4021 
    общем описании).
77 diamond 4022 
 
4023 
======================================================================
4024 
====================== Функция 69, подфункция 6 ======================
4025 
============= Прочитать из памяти отлаживаемого процесса. ============
4026 
======================================================================
4027 
Параметры:
4028 
  * eax = 69 - номер функции
4029 
  * ebx = 6 - номер подфункции
4030 
  * ecx = идентификатор
4031 
  * edx = сколько байт читать
4032 
  * esi = адрес памяти отлаживаемого процесса
4033 
  * edi = указатель на буфер для данных
4034 
Возвращаемое значение:
4035 
  * eax = -1 при ошибке (неверный PID или буфер)
4036 
  * иначе eax = число прочитанных байт (возможно, 0,
4037 
    если в esi слишком большое значение)
4038 
Замечания:
4039 
  * Процесс должен быть загружен для отладки (как указано в
4040 
    общем описании).
4041 
 
4042 
======================================================================
2010 serge 4043 
 Функция 69, подфункция 7 - записать в память отлаживаемого процесса.
77 diamond 4044 
======================================================================
4045 
Параметры:
4046 
  * eax = 69 - номер функции
4047 
  * ebx = 7 - номер подфункции
4048 
  * ecx = идентификатор
4049 
  * edx = сколько байт писать
4050 
  * esi = адрес памяти в отлаживаемом процессе
4051 
  * edi = указатель на данные
4052 
Возвращаемое значение:
4053 
  * eax = -1 при ошибке (неверный PID или буфер)
4054 
  * иначе eax = число записанных байт (возможно, 0,
4055 
    если в esi слишком большое значение)
4056 
Замечания:
4057 
  * Процесс должен быть загружен для отладки (как указано в
4058 
    общем описании).
4059 
 
4060 
======================================================================
4061 
====== Функция 69, подфункция 8 - завершить отлаживаемый поток. ======
4062 
======================================================================
4063 
Параметры:
4064 
  * eax = 69 - номер функции
4065 
  * ebx = 8 - номер подфункции
4066 
  * ecx = идентификатор
4067 
Возвращаемое значение:
4068 
  * функция не возвращает значения
4069 
Замечания:
4070 
  * Процесс должен быть загружен для отладки (как указано в
4071 
    общем описании).
4072 
  * Функция аналогична подфункции 2 функции 18 с двумя отличиями:
4073 
    требуется выполнение первого замечания и принимается PID,
4074 
    а не номер слота.
4075 
 
4076 
======================================================================
4077 
====================== Функция 69, подфункция 9 ======================
4078 
============= Установить/снять аппаратную точку останова. ============
4079 
======================================================================
4080 
Параметры:
4081 
  * eax = 69 - номер функции
4082 
  * ebx = 9 - номер подфункции
4083 
  * ecx = идентификатор потока
4084 
  * dl = индекс точки останова, от 0 до 3 включительно
4085 
  * dh = флаги:
4086 
    * если старший бит сброшен - установить точку останова:
4087 
      * биты 0-1 - условие:
4088 
        * 00 = точка останова на выполнение
4089 
        * 01 = точка останова на запись
4090 
        * 11 = точка останова на чтение/запись
4091 
      * биты 2-3 - длина; для точек останова на исполнение должно быть
4092 
        00, в противном случае одно из
4093 
        * 00 = байт
4094 
        * 01 = слово
4095 
        * 11 = двойное слово
4096 
      * esi = адрес точки останова; должен быть выровнен
131 diamond 4097 
        соответственно длине (т.е. должен быть чётным для
77 diamond 4098 
        точек останова на слово, кратен 4 для двойного слова)
4099 
    * если старший бит установлен - сбросить точку останова
4100 
Возвращаемое значение:
4101 
  * eax = 0 - успешно
4102 
  * eax = 1 - ошибка во входных данных
4103 
  * eax = 2 - (зарезервировано, никогда не возвращается
4104 
    в текущей реализации) с этим индексом уже установлена
4105 
    глобальная точка останова
4106 
Замечания:
4107 
  * Процесс должен быть загружен для отладки (как указано в
4108 
    общем описании).
4109 
  * Аппаратные точки останова реализуются через DRx-регистры
4110 
    процессора, отсюда все ограничения.
4111 
  * Функция может переустановить ранее установленную ей же
4112 
    точку останова (никак не сообщая об этом).
4113 
    Ведите список установленных точек останова в отладчике.
4114 
  * Срабатывание точки останова заключается в генерировании
4115 
    отладочного исключения #DB, о котором система сообщает отладчику.
4116 
  * Точка останова на запись и чтение/запись срабатывает после
131 diamond 4117 
    выполнения вызвавшей её инструкции.
77 diamond 4118 
 
4119 
======================================================================
131 diamond 4120 
= Функция 70 - работа с файловой системой с поддержкой длинных имён. =
77 diamond 4121 
======================================================================
4122 
Параметры:
4123 
  * eax = 70
4124 
  * ebx = указатель на информационную структуру
4125 
Возвращаемое значение:
4126 
  * eax = 0 - успешно; иначе код ошибки файловой системы
4127 
  * в зависимости от подфункции может возвращаться значение и
4128 
    в других регистрах
4129 
Общий формат информационной структуры:
4130 
  * +0: dword: номер подфункции
4131 
  * +4: dword: смещение в файле
91 diamond 4132 
  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
77 diamond 4133 
  * +12 = +0xC: dword: размер
4134 
  * +16 = +0x10: dword: указатель на данные
4135 
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
86 diamond 4136 
    или
4137 
  * +20 = +0x14: db 0
4138 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4139 
Уточнения - в документации на соответствующую подфункцию.
4140 
Имя файла нечувствительно к регистру букв. Русские буквы должны быть
4141 
записаны в кодировке cp866 (DOS).
4142 
Формат имени файла:
4143 
/base/number/dir1/dir2/.../dirn/file,
4144 
где /base/number идентифицирует устройство, на котором ищется файл:
4145 
одно из
4146 
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
4147 
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
4148 
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
4149 
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
131 diamond 4150 
    к жёстким дискам на IDE0 (Primary Master), IDE1 (Primary Slave),
77 diamond 4151 
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
4152 
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
4153 
    (на каждом из винчестеров нумерация начинается с 1)
91 diamond 4154 
  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 для доступа соответственно
4155 
    к CD на IDE0 (Primary Master), IDE1 (Primary Slave),
118 diamond 4156 
    IDE2 (Secondary Master), IDE3 (Secondary Slave)
546 diamond 4157 
  * /SYS - определяет системную папку; при обычной загрузке системы
4158 
    с дискеты эквивалентно /RD/1
77 diamond 4159 
Примеры:
83 diamond 4160 
  * '/rd/1/kernel.asm',0
77 diamond 4161 
  * '/HD0/1/kernel.asm',0
4162 
  * '/hd0/2/menuet/pics/tanzania.bmp',0
4163 
  * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
546 diamond 4164 
  * '/sys/MySuperApp.ini',0
2010 serge 4165 
Также функция поддерживает относительные имена. Если путь начинается
4166 
не с '/', то он считается относительно текущей папки. Получить или
4167 
установить текущую папку можно с помощью сисфункции 30.
4168 
 
77 diamond 4169 
Доступные подфункции:
4170 
  * подфункция 0 - чтение файла
4171 
  * подфункция 1 - чтение папки
83 diamond 4172 
  * подфункция 2 - создание/перезапись файла
131 diamond 4173 
  * подфункция 3 - запись в существующий файл
133 diamond 4174 
  * подфункция 4 - установка размера файла
86 diamond 4175 
  * подфункция 5 - получение атрибутов файла/папки
4176 
  * подфункция 6 - установка атрибутов файла/папки
91 diamond 4177 
  * подфункция 7 - запуск программы
172 serge 4178 
  * подфункция 8 - удаление файла/папки
321 diamond 4179 
  * подфункция 9 - создание папки
118 diamond 4180 
Для CD-приводов в связи с аппаратными ограничениями доступны
4181 
только подфункции 0,1,5 и 7, вызов других подфункций завершится
4182 
ошибкой с кодом 2.
641 diamond 4183 
При первом обращении подфункций 0,1,5,7 к устройствам ATAPI
4184 
(CD и DVD) производится блокировка ручного управления механизмом
4185 
лотка. Это связано с кэшированием данных, полученных от привода.
4186 
Разблокировка осуществляется при обращении подфункции 4 функции 24
4187 
к соответствующему устройству.
77 diamond 4188 
 
4189 
======================================================================
131 diamond 4190 
= Функция 70, подфункция 0 - чтение файла с поддержкой длинных имён. =
77 diamond 4191 
======================================================================
4192 
Параметры:
4193 
  * eax = 70 - номер функции
4194 
  * ebx = указатель на информационную структуру
4195 
Формат информационной структуры:
4196 
  * +0: dword: 0 = номер подфункции
4197 
  * +4: dword: позиция в файле (в байтах)
4198 
  * +8: dword: 0 (зарезервировано под старший dword позиции)
4199 
  * +12 = +0xC: dword: сколько байт читать
4200 
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
131 diamond 4201 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
77 diamond 4202 
    общем описании
86 diamond 4203 
    или
4204 
  * +20 = +0x14: db 0
4205 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4206 
Возвращаемое значение:
4207 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4208 
  * ebx = число прочитанных байт или
4209 
    -1=0xffffffff, если файл не найден
4210 
Замечания:
4211 
  * Если файл кончился раньше, чем был прочитан последний запрошенный
131 diamond 4212 
    блок, то функция прочитает, сколько сможет, после чего вернёт
77 diamond 4213 
    eax=6 (EOF).
4214 
  * Функция не позволяет читать папки
131 diamond 4215 
    (вернётся eax=10, access denied).
77 diamond 4216 
 
4217 
======================================================================
131 diamond 4218 
= Функция 70, подфункция 1 - чтение папки с поддержкой длинных имён. =
77 diamond 4219 
======================================================================
4220 
Параметры:
4221 
  * eax = 70 - номер функции
4222 
  * ebx = указатель на информационную структуру
4223 
Формат информационной структуры:
4224 
  * +0: dword: 1 = номер подфункции
4225 
  * +4: dword: индекс начального блока (считая с 0)
78 diamond 4226 
  * +8: dword: поле флагов:
4227 
    * бит 0 (маска 1): в каком формате возвращать имена,
4228 
      0=ANSI, 1=UNICODE
4229 
    * прочие биты зарезервированы и должны быть установлены в 0
4230 
      для будущей совместимости
77 diamond 4231 
  * +12 = +0xC: dword: сколько блоков читать
4232 
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
4233 
    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
131 diamond 4234 
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
77 diamond 4235 
    общем описании
86 diamond 4236 
    или
4237 
  * +20 = +0x14: db 0
4238 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
77 diamond 4239 
Возвращаемое значение:
4240 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4241 
  * ebx = число файлов, информация о которых была записана в буфер,
4242 
    или -1=0xffffffff, если папка не найдена
4243 
Структура буфера:
4244 
  * +0: 32*byte: заголовок
4245 
  * +32 = +0x20: n1*byte: блок с информацией о файле 1
4246 
  * +32+n1: n2*byte: блок с информацией о файле 2
4247 
  * ...
4248 
Структура заголовка:
4249 
  * +0: dword: версия структуры (текущая версия = 1)
131 diamond 4250 
  * +4: dword: количество размещённых блоков; не больше, чем запрошено
77 diamond 4251 
    в поле +12 информационной структуры; может быть меньше,
4252 
    если в папке кончились файлы (то же самое, что и в ebx)
4253 
  * +8: dword: общее число файлов в папке
4254 
  * +12 = +0xC: 20*byte: зарезервировано (нули)
4255 
Структура блока данных входа каталога (БДВК):
4256 
  * +0: dword: атрибуты файла:
4257 
    * бит 0 (маска 1): файл только для чтения
4258 
    * бит 1 (маска 2): файл является скрытым
4259 
    * бит 2 (маска 4): файл является системным
4260 
    * бит 3 (маска 8): это не файл, а метка тома
4261 
      (на заданном разделе встречается не более одного раза и
4262 
      только в корневой папке)
4263 
    * бит 4 (маска 0x10): это папка
4264 
    * бит 5 (маска 0x20): файл не архивировался - многие программы
4265 
      архивации имеют опцию, по которой архивируются только файлы
4266 
      с установленным этим битом, после чего этот бит сбрасывается -
4267 
      это может быть полезно для автоматического создания
4268 
      backup-архивов, ибо при записи бит обычно устанавливается
4269 
      (не в Kolibri, правда)
78 diamond 4270 
  * +4: byte: тип данных имени:
4271 
    (совпадает с битом 0 флагов информационной структуры)
77 diamond 4272 
    * 0 = ASCII = 1-байтное представление каждого символа
4273 
    * 1 = UNICODE = 2-байтное представление каждого символа
4274 
  * +5: 3*byte: зарезервировано (нули)
4275 
  * +8: 4*byte: время создания файла
4276 
  * +12 = +0xC: 4*byte: дата создания файла
4277 
  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
4278 
  * +20 = +0x14: 4*byte: дата последнего доступа
4279 
  * +24 = +0x18: 4*byte: время последней модификации
4280 
  * +28 = +0x1C: 4*byte: дата последней модификации
4281 
  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
4282 
  * +40 = +0x28: имя
4283 
    * для формата ASCII: максимальная длина имени 263 символа
4284 
      (263 байта), байт после имени имеет значение 0
4285 
    * для формата UNICODE: максимальная длина имени 259 символов
4286 
      (518 байт), два байта после имени имеют значение 0
4287 
Формат времени:
4288 
  * +0: byte: секунды
4289 
  * +1: byte: минуты
4290 
  * +2: byte: часы
4291 
  * +3: byte: зарезервировано (0)
4292 
  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
4293 
Формат даты:
4294 
  * +0: byte: день
4295 
  * +1: byte: месяц
4296 
  * +2: word: год
4297 
  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
4298 
Замечания:
4299 
  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
4300 
    304 байта, если в UNICODE - 560 байт. Значение длины выравнено
4301 
    на целое кратное 16 байт
4302 
    (для ускорения обработки в кэш-памяти CPU).
78 diamond 4303 
  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
4304 
    данные содержат мусор.
77 diamond 4305 
  * Если файлы в папке кончились раньше, чем было прочитано
4306 
    запрошенное количество, то функция прочитает, сколько сможет,
131 diamond 4307 
    после чего вернёт eax=6 (EOF).
77 diamond 4308 
  * Любая папка на диске, кроме корневой, содержит два специальных
4309 
    входа "." и "..", идентифицирующих соответственно саму папку и
4310 
    родительскую папку.
4311 
  * Функция позволяет также читать виртуальные папки "/", "/rd",
4312 
    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
4313 
    0x10, а времена и даты обнулены. Альтернативный способ получения
4314 
    информации об оборудовании - подфункция 11 функции 18.
4315 
 
4316 
======================================================================
83 diamond 4317 
====================== Функция 70, подфункция 2 ======================
131 diamond 4318 
======== Создание/перезапись файла с поддержкой длинных имён. ========
83 diamond 4319 
======================================================================
4320 
Параметры:
4321 
  * eax = 70 - номер функции
4322 
  * ebx = указатель на информационную структуру
4323 
Формат информационной структуры:
4324 
  * +0: dword: 2 = номер подфункции
4325 
  * +4: dword: 0 (зарезервировано)
4326 
  * +8: dword: 0 (зарезервировано)
4327 
  * +12 = +0xC: dword: сколько байт писать
4328 
  * +16 = +0x10: dword: указатель на данные
131 diamond 4329 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
83 diamond 4330 
    общем описании
86 diamond 4331 
    или
4332 
  * +20 = +0x14: db 0
4333 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
83 diamond 4334 
Возвращаемое значение:
4335 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4336 
  * ebx = число записанных байт (возможно, 0)
4337 
Замечания:
131 diamond 4338 
  * Если файл с таким именем не существовал, он создаётся; если
83 diamond 4339 
    существовал, то перезаписывается.
4340 
  * Если свободного места на диске недостаточно, то функция запишет,
131 diamond 4341 
    сколько сможет, после чего вернёт код ошибки 8.
4342 
  * Функция не поддерживается для CD (вернётся код ошибки 2).
83 diamond 4343 
 
4344 
======================================================================
131 diamond 4345 
====================== Функция 70, подфункция 3 ======================
4346 
======== Запись в существующий файл с поддержкой длинных имён. =======
4347 
======================================================================
4348 
Параметры:
4349 
  * eax = 70 - номер функции
4350 
  * ebx = указатель на информационную структуру
4351 
Формат информационной структуры:
4352 
  * +0: dword: 3 = номер подфункции
4353 
  * +4: dword: позиция в файле (в байтах)
4354 
  * +8: dword: старший dword позиции (должен быть 0 для FAT)
4355 
  * +12 = +0xC: dword: сколько байт писать
4356 
  * +16 = +0x10: dword: указатель на данные
4357 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4358 
    общем описании
4359 
    или
4360 
  * +20 = +0x14: db 0
4361 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4362 
Возвращаемое значение:
4363 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4364 
  * ebx = число записанных байт (возможно, 0)
4365 
Замечания:
4366 
  * Файл должен уже существовать, иначе вернётся eax=5.
4367 
  * Единственным результатом записи 0 байт является установка в
4368 
    атрибутах файла даты/времени модификации и доступа в текущую.
4369 
  * Если начальная и/или конечная позиция выходит за пределы файла
4370 
    (за исключением предыдущего случая), файл расширяется до
4371 
    необходимого размера нулевыми символами.
133 diamond 4372 
  * Функция не поддерживается для CD (вернётся код ошибки 2).
131 diamond 4373 
 
4374 
======================================================================
133 diamond 4375 
========= Функция 70, подфункция 4 - установка размера файла. ========
4376 
======================================================================
4377 
Параметры:
4378 
  * eax = 70 - номер функции
4379 
  * ebx = указатель на информационную структуру
4380 
Формат информационной структуры:
4381 
  * +0: dword: 4 = номер подфункции
4382 
  * +4: dword: младший dword нового размера файла
4383 
  * +8: dword: старший dword нового размера файла
4384 
                   (должен быть 0 для FAT)
4385 
  * +12 = +0xC: dword: 0 (зарезервировано)
4386 
  * +16 = +0x10: dword: 0 (зарезервировано)
4387 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4388 
    общем описании
4389 
    или
4390 
  * +20 = +0x14: db 0
4391 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4392 
Возвращаемое значение:
4393 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4394 
  * ebx разрушается
4395 
Замечания:
4396 
  * Если новый размер файла меньше старого, файл усекается. Если
4397 
    новый размер больше старого, файл расширяется нулевыми символами.
4398 
    Если новый размер равен старому, единственным результатом вызова
4399 
    является установка даты/времени модификации и доступа в текущие.
4400 
  * Если свободного места на диске недостаточно для расширения файла,
4401 
    то функция расширит насколько возможно, после чего вернёт
4402 
    код ошибки 8.
4403 
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4404 
 
4405 
======================================================================
86 diamond 4406 
=== Функция 70, подфункция 5 - получение информации о файле/папке. ===
4407 
======================================================================
4408 
Параметры:
4409 
  * eax = 70 - номер функции
4410 
  * ebx = указатель на информационную структуру
4411 
Формат информационной структуры:
4412 
  * +0: dword: 5 = номер подфункции
4413 
  * +4: dword: 0 (зарезервировано)
4414 
  * +8: dword: 0 (зарезервировано)
4415 
  * +12 = +0xC: dword: 0 (зарезервировано)
4416 
  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
4417 
                        (40 байт)
131 diamond 4418 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4419 
    общем описании
4420 
    или
4421 
  * +20 = +0x14: db 0
4422 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4423 
Возвращаемое значение:
4424 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4425 
  * ebx разрушается
4426 
Информация о файле возвращается в формате БДВК
4427 
(блока данных входа каталога), указанном в описании
4428 
подфункции 1, но без имени файла
4429 
(то есть первые 40 = 0x28 байт).
4430 
Замечания:
4431 
  * Функция не поддерживает виртуальные папки типа /, /rd и
4432 
    корневые папки типа /rd/1.
4433 
 
4434 
======================================================================
4435 
===== Функция 70, подфункция 6 - установка атрибутов файла/папки. ====
4436 
======================================================================
4437 
Параметры:
4438 
  * eax = 70 - номер функции
4439 
  * ebx = указатель на информационную структуру
4440 
Формат информационной структуры:
4441 
  * +0: dword: 6 = номер подфункции
4442 
  * +4: dword: 0 (зарезервировано)
4443 
  * +8: dword: 0 (зарезервировано)
4444 
  * +12 = +0xC: dword: 0 (зарезервировано)
4445 
  * +16 = +0x10: dword: указатель на буфер с атрибутами (32 байта)
131 diamond 4446 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
86 diamond 4447 
    общем описании
4448 
    или
4449 
  * +20 = +0x14: db 0
4450 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4451 
Возвращаемое значение:
4452 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4453 
  * ebx разрушается
4454 
Атрибуты файла - первые 32 байта в БДВК (блоке данных входа каталога),
4455 
формат которого указан в описании подфункции 1
4456 
(то есть без имени и размера файла). Атрибут файл/папка/метка тома
4457 
(биты 3,4 в dword'е +0) не меняется.
4458 
Байт +4 (формат имени) игнорируется.
4459 
Замечания:
4460 
  * Функция не поддерживает виртуальные папки типа /, /rd и
4461 
    корневые папки типа /rd/1.
131 diamond 4462 
  * Функция не поддерживается для CD (вернётся код ошибки 2).
86 diamond 4463 
 
4464 
======================================================================
91 diamond 4465 
============ Функция 70, подфункция 7 - запуск программы. ============
4466 
======================================================================
4467 
Параметры:
4468 
  * eax = 70 - номер функции
4469 
  * ebx = указатель на информационную структуру
4470 
Формат информационной структуры:
4471 
  * +0: dword: 7 = номер подфункции
4472 
  * +4: dword: поле флагов:
4473 
    * бит 0: запустить процесс как отлаживаемый
4474 
    * остальные биты зарезервированы и должны быть установлены в 0
4475 
  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
4476 
  * +12 = +0xC: dword: 0 (зарезервировано)
4477 
  * +16 = +0x10: dword: 0 (зарезервировано)
131 diamond 4478 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
91 diamond 4479 
    общем описании
4480 
    или
4481 
  * +20 = +0x14: db 0
4482 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4483 
Возвращаемое значение:
4484 
  * eax > 0 - программа загружена, eax содержит PID
4485 
  * eax < 0 - произошла ошибка, -eax содержит
4486 
    код ошибки файловой системы
4487 
  * ebx разрушается
4488 
Замечания:
4489 
  * Командная строка должна заканчиваться символом с кодом 0
4490 
    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
4491 
    включительно, либо первые 256 символов, в зависимости от того,
4492 
    что меньше.
131 diamond 4493 
  * Если процесс запускается как отлаживаемый, он создаётся
91 diamond 4494 
    в замороженном состоянии; для запуска используйте
4495 
    подфункцию 5 функции 69.
4496 
 
4497 
======================================================================
172 serge 4498 
========== Функция 70, подфункция 8 - удаление файла/папки. ==========
4499 
======================================================================
4500 
Параметры:
4501 
  * eax = 70 - номер функции
4502 
  * ebx = указатель на информационную структуру
4503 
Формат информационной структуры:
4504 
  * +0: dword: 8 = номер подфункции
4505 
  * +4: dword: 0 (зарезервировано)
4506 
  * +8: dword: 0 (зарезервировано)
4507 
  * +12 = +0xC: dword: 0 (зарезервировано)
4508 
  * +16 = +0x10: dword: 0 (зарезервировано)
4509 
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
4510 
    общем описании
4511 
    или
4512 
  * +20 = +0x14: db 0
4513 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
4514 
Возвращаемое значение:
4515 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4516 
  * ebx разрушается
4517 
Замечания:
4518 
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4519 
  * Можно удалять только пустые папки (попытка удаления непустой папки
4520 
    приведёт к ошибке с кодом 10, "доступ запрещён").
4521 
 
4522 
======================================================================
321 diamond 4523 
============= Функция 70, подфункция 9 - создание папки. =============
4524 
======================================================================
4525 
Параметры:
4526 
  * eax = 70 - номер функции
4527 
  * ebx = указатель на информационную структуру
4528 
Формат информационной структуры:
4529 
  * +0: dword: 9 = номер подфункции
4530 
  * +4: dword: 0 (зарезервировано)
4531 
  * +8: dword: 0 (зарезервировано)
4532 
  * +12 = +0xC: dword: 0 (зарезервировано)
4533 
  * +16 = +0x10: dword: 0 (зарезервировано)
4534 
  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
4535 
    общем описании
4536 
    или
4537 
  * +20 = +0x14: db 0
4538 
  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем папки
4539 
Возвращаемое значение:
4540 
  * eax = 0 - успешно, иначе код ошибки файловой системы
4541 
  * ebx разрушается
4542 
Замечания:
4543 
  * Функция не поддерживается для CD (вернётся код ошибки 2).
4544 
  * Родительская папка должна уже существовать.
4545 
  * Если папка уже существует, функция завершится успешно (eax=0).
4546 
 
4547 
======================================================================
118 diamond 4548 
=== Функция 71, подфункция 1 - установить заголовок окна программы. ==
114 mikedld 4549 
======================================================================
4550 
Параметры:
4551 
  * eax = 71 - номер функции
4552 
  * ebx = 1 - номер подфункции
118 diamond 4553 
  * ecx = адрес строки заголовка
114 mikedld 4554 
Возвращаемое значение:
118 diamond 4555 
  * функция не возвращает значения
114 mikedld 4556 
Замечания:
4557 
  * Строка заголовка должна быть в формате ASCIIZ. В заголовке
118 diamond 4558 
    отображается не более 255 символов независимо от полной длины
114 mikedld 4559 
    строки.
118 diamond 4560 
  * Чтобы убрать заголовок, передайте NULL в ecx.
114 mikedld 4561 
 
4562 
======================================================================
665 diamond 4563 
================ Функция 72 - послать сообщение окну. ================
4564 
======================================================================
4565 
 
4566 
--- Подфункция 1 - послать сообщение с параметром активному окну. ----
4567 
Параметры:
4568 
  * eax = 72 - номер функции
4569 
  * ebx = 1 - номер подфункции
4570 
  * ecx = код события: 2 или 3
4571 
  * edx = код клавиши для ecx=2, идентификатор кнопки для ecx=3
4572 
Возвращаемое значение:
4573 
  * eax = 0 - успешно
4574 
  * eax = 1 - буфер заполнен
4575 
 
4576 
======================================================================
3500 Serge 4577 
===================== Функция 73 - blit bitmap  =====================
4578 
======================================================================
4579 
блит - копирование битового массив
4580 
 
4581 
Параметры:
4582 
  * eax = 73 - номер функции
4583 
 
4584 
  * ebx = ROP и опциональные флаги
4585 
     31           6 5  4 3   0
4586 
     [  reserved  ][T][B][ROP]
4587 
     ROP - код растровых операций
4588 
        0: копировать
4589 
     1-15: Зарезервировано
4590 
     B   - блит на фоновую поферхность
4591 
     T   - блит с прозрачностью
4592 
 
4593 
  * ecx = указатель на параметры функции
4594 
        смещение цели и отсечение
4595 
     +0 signed dword: смещение по X окна, для целевого прямоугольника
4596 
                      верхний левый угол
4597 
     +4 signed dword: смещение по Y окна, для целевого прямоугольника
4598 
                      верхний левый угол
4599 
     +8 dword:        ширина целевого прямоугольника
4600 
    +12 dword:        высота целевого прямоугольника
4601 
 
4602 
        смещение исходника и отсечение
4603 
    +16 signed dword: смещение по X bitmap, для исходного прямоугольника
4604 
                      верхний левый угол
4605 
    +20 signed dword: смещение по Y bitmap, для исходного прямоугольника
4606 
                      верхний левый угол
4607 
    +24 dword:        ширина исходного прямоугольника
4608 
    +28 dword:        высота исходного прямоугольника
4609 
 
4610 
    +32: dword: данные bitmap - должны быть 32bpp
4611 
    +36: dword: размер строки bitmap в байтах
4612 
 
4613 
Возвращаемое значение:
4614 
  * функция не возвращает значения
4615 
 
4616 
======================================================================
77 diamond 4617 
========== Функция -1 - завершить выполнение потока/процесса =========
4618 
======================================================================
4619 
Параметры:
4620 
  * eax = -1 - номер функции
4621 
Возвращаемое значение:
4622 
  * функция не возвращает ни значения, ни управления
4623 
Замечания:
4624 
  * Если процесс явно не создавал потоков, то у него есть только
4625 
    один поток, завершение которого приводит к завершению процесса.
4626 
  * Если текущий поток - последний в процессе, то его завершение
4627 
    также приводит к завершению процесса.
4628 
  * Эта функция завершает текущий поток. Другой поток можно прибить
4629 
    вызовом подфункции 2 функции 18.
4630 
 
4631 
======================================================================
4632 
=========================== Список событий ===========================
4633 
======================================================================
4634 
Очередное событие можно получить вызовом одной из функций 10
4635 
(ожидать события), 11 (проверить без ожидания), 23
4636 
(ожидать в течение заданного времени).
4637 
Эти функции возвращают только те события, которые входят в маску,
4638 
устанавливаемую функцией 40. По умолчанию это первые три, чего
4639 
вполне достаточно для многих приложений.
4640 
Коды событий:
4641 
  * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
4642 
  * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
92 diamond 4643 
    активно) или нажата "горячая клавиша";
4644 
    сбрасывается, когда все клавиши из буфера считаны функцией 2
131 diamond 4645 
  * 3 = нажата кнопка, определённая ранее функцией 8 (или кнопка
77 diamond 4646 
    закрытия, созданная неявно функцией 0; кнопка минимизации
4647 
    обрабатывается системой и о ней сообщения не приходит;
4648 
    поступает, только когда окно активно; сбрасывается, когда все
4649 
    кнопки из буфера считаны функцией 17)
4650 
  * 4 = зарезервировано (в текущей реализации никогда не приходит даже
4651 
    при размаскировке функцией 40)
2987 Serge 4652 
  * 5 = завершилась перерисовка фона рабочего стола
77 diamond 4653 
  * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
4654 
    или перемещение; сбрасывается при прочтении)
4655 
  * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
4656 
    Communication; сбрасывается при прочтении)
4657 
  * 8 = произошло сетевое событие (сбрасывается при прочтении;
4658 
    смотри работу с сетью)
4659 
  * 9 = произошло отладочное событие (сбрасывается при прочтении;
4660 
    смотри отладочную подсистему)
4661 
  * 16..31 = произошло событие с соответствующим IRQ
4662 
    (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)
4663 
 
4664 
======================================================================
4665 
==================== Коды ошибок файловой системы ====================
4666 
======================================================================
4667 
  * 0 = успешно
131 diamond 4668 
  * 1 = не определена база и/или раздел жёсткого диска (подфункциями
77 diamond 4669 
    7, 8 функции 21)
4670 
  * 2 = функция не поддерживается для данной файловой системы
4671 
  * 3 = неизвестная файловая система
448 diamond 4672 
  * 4 = зарезервировано, никогда не возвращается в текущей реализации
77 diamond 4673 
  * 5 = файл не найден
4674 
  * 6 = файл закончился
4675 
  * 7 = указатель вне памяти приложения
4676 
  * 8 = диск заполнен
4677 
  * 9 = таблица FAT разрушена
131 diamond 4678 
  * 10 = доступ запрещён
83 diamond 4679 
  * 11 = ошибка устройства
77 diamond 4680 
При запуске программы возможны также следующие коды ошибок:
4681 
  * 30 = 0x1E = недостаточно памяти
4682 
  * 31 = 0x1F = файл не является исполнимым
172 serge 4683 
  * 32 = 0x20 = слишком много процессов