WebSVN – Kolibri OS – Diff – /kernel/branches/Kolibri-acpi/docs/sysfuncr.txt

 ;; Copyright (C) KolibriOS team 2004-2012. All rights reserved. ;;
 ;; Distributed under terms of the GNU General Public License    ;;
 ;;                                                              ;;
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-      æ¢¥â  'inner' ¨§ áª¨
+      цвета 'inner' из скина
-    à ¢  6 ¯¨ªá¥«¥©.
+    равна 6 пикселей.
-  * C=1, £«ã¡¨  â®çª¨ = 32 ¡¨â , ®¡« áâì ¯®«ì§®¢ â¥«ï ¢ë£«ï¤¨â â ª:
+  * C=1, глубина точки = 32 бита, область пользователя выглядит так:
-    * ¨¬ï ¯à®æ¥áá  - "OS/IDLE" (¤®¯®«¥®¥ ¯à®¡¥« ¬¨)
+    * имя процесса - "OS/IDLE" (дополненное пробелами)
-    *  ¤à¥á ¯à®æ¥áá  ¢ ¯ ¬ïâ¨ à ¢¥ 0, à §¬¥à ¨á¯®«ì§ã¥¬®© ¯ ¬ïâ¨
+    * адрес процесса в памяти равен 0, размер используемой памяти
- ¬¥ç ¨ï:
+Замечания:
-  * ¬¥é¥¨¥ ¤«ï â®çª¨ á ª®®à¤¨ â ¬¨ (x,y) ¢ëç¨á«ï¥âáï ª ª
+  * Смещение для точки с координатами (x,y) вычисляется как
     (x+y*xsize)*3.
-  * á«¨ ãª § ®¥ á¬¥é¥¨¥ ¯à¥¢ëè ¥â ãáâ ®¢«¥ë© ¯®¤äãªæ¨¥© 1
+  * Если указанное смещение превышает установленный подфункцией 1
-    à §¬¥à, ¢ë§®¢ ¨£®à¨àã¥âáï.
+    размер, вызов игнорируется.
-  * «ï ®¡®¢«¥¨ï íªà   (¯®á«¥ § ¢¥àè¥¨ï á¥à¨¨ ª®¬ ¤, à ¡®â îé¨å á
+  * Для обновления экрана (после завершения серии команд, работающих с
-    ä®®¬) ¢ë§ë¢ ©â¥ ¯®¤äãªæ¨î 3 ¯¥à¥à¨á®¢ª¨ ä® .
+    фоном) вызывайте подфункцию 3 перерисовки фона.
-  * áâì ¯ à ï äãªæ¨ï ¯®«ãç¥¨ï â®çª¨ á ä®®¢®£® ¨§®¡à ¦¥¨ï -
+  * Есть парная функция получения точки с фонового изображения -
-    ¯®¤äãªæ¨ï 2 äãªæ¨¨ 39.
+    подфункция 2 функции 39.
 ======================================================================
-============ ãªæ¨ï 15, ¯®¤äãªæ¨ï 3 - ¯¥à¥à¨á®¢ âì ä®. ============
+============ Функция 15, подфункция 3 - перерисовать фон. ============
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 15 - ®¬¥à äãªæ¨¨
+  * eax = 15 - номер функции
-  * ebx = 3 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 3 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
 ======================================================================
-===== ãªæ¨ï 15, ¯®¤äãªæ¨ï 4 - ãáâ ®¢¨âì à¥¦¨¬ ®âà¨á®¢ª¨ ä® . ====
+===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 15 - ®¬¥à äãªæ¨¨
+  * eax = 15 - номер функции
-  * ebx = 4 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 4 - номер подфункции
-  * ecx = à¥¦¨¬ ®âà¨á®¢ª¨:
+  * ecx = режим отрисовки:
-    * 1 = § ¬®áâ¨âì
+    * 1 = замостить
-    * 2 = à áâïãâì
+    * 2 = растянуть
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
- ¬¥ç ¨ï:
+Замечания:
-  * «ï ®¡®¢«¥¨ï íªà   (¯®á«¥ § ¢¥àè¥¨ï á¥à¨¨ ª®¬ ¤, à ¡®â îé¨å á
+  * Для обновления экрана (после завершения серии команд, работающих с
-    ä®®¬) ¢ë§ë¢ ©â¥ ¯®¤äãªæ¨î 3 ¯¥à¥à¨á®¢ª¨ ä® .
+    фоном) вызывайте подфункцию 3 перерисовки фона.
-  * áâì ¯ à ï ª®¬ ¤  ¯®«ãç¥¨ï à¥¦¨¬  ®âà¨á®¢ª¨ ä®  -
+  * Есть парная команда получения режима отрисовки фона -
-    ¯®¤äãªæ¨ï 4 äãªæ¨¨ 39.
+    подфункция 4 функции 39.
 ======================================================================
-===== ãªæ¨ï 15, ¯®¤äãªæ¨ï 5 - ¯®¬¥áâ¨âì ¡«®ª ¯¨ªá¥«¥©   ä®. =====
+===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 15 - ®¬¥à äãªæ¨¨
+  * eax = 15 - номер функции
-  * ebx = 5 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 5 - номер подфункции
-  * ecx = ãª § â¥«ì   ¤ ë¥ ¢ ä®à¬ â¥ BBGGRRBBGGRR...
+  * ecx = указатель на данные в формате BBGGRRBBGGRR...
-  * edx = á¬¥é¥¨¥ ¢ ¤ ëå ä®®¢®£® ¨§®¡à ¦¥¨ï
+  * edx = смещение в данных фонового изображения
-  * esi = à §¬¥à ¤ ëå ¢ ¡ ©â å = 3 * ç¨á«® ¯¨ªá¥«¥©
+  * esi = размер данных в байтах = 3 * число пикселей
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
- ¬¥ç ¨ï:
+Замечания:
-  * à®¢¥àª¨ ª®àà¥ªâ®áâ¨ á¬¥é¥¨ï ¨ à §¬¥à  ¥ ¯à®¨§¢®¤¨âáï.
+  * Проверки корректности смещения и размера не производится.
-  * ¢¥â ª ¦¤®£® ¯¨ªá¥«ï åà ¨âáï ª ª 3-¡ ©â ï ¢¥«¨ç¨  BBGGRR.
+  * Цвет каждого пикселя хранится как 3-байтная величина BBGGRR.
-  * ¨ªá¥«¨ ä®®¢®£® ¨§®¡à ¦¥¨ï § ¯¨áë¢ îâáï ¯®á«¥¤®¢ â¥«ì®
+  * Пиксели фонового изображения записываются последовательно
-    á«¥¢   ¯à ¢®, á¢¥àåã ¢¨§.
+    слева направо, сверху вниз.
-  * ¬¥é¥¨¥ ¯¨ªá¥«ï á ª®®à¤¨ â ¬¨ (x,y) ¥áâì (x+y*xsize)*3.
+  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.
-  * «ï ®¡®¢«¥¨ï íªà   (¯®á«¥ § ¢¥àè¥¨ï á¥à¨¨ ª®¬ ¤, à ¡®â îé¨å á
+  * Для обновления экрана (после завершения серии команд, работающих с
-    ä®®¬) ¢ë§ë¢ ©â¥ ¯®¤äãªæ¨î 3 ¯¥à¥à¨á®¢ª¨ ä® .
+    фоном) вызывайте подфункцию 3 перерисовки фона.
 ======================================================================
-====================== ãªæ¨ï 15, ¯®¤äãªæ¨ï 6 ======================
+====================== Функция 15, подфункция 6 ======================
-==== ¯à®¥æ¨à®¢ âì ¤ ë¥ ä®     ¤à¥á®¥ ¯à®áâà áâ¢® ¯à®æ¥áá . ====
+==== Спроецировать данные фона на адресное пространство процесса. ====
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 15 - ®¬¥à äãªæ¨¨
+  * eax = 15 - номер функции
-  * ebx = 6 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 6 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = ãª § â¥«ì   ¤ ë¥ ä® , 0 ¯à¨ ®è¨¡ª¥
+  * eax = указатель на данные фона, 0 при ошибке
- ¬¥ç ¨ï:
+Замечания:
-  * ¯à®¥æ¨à®¢ ë¥ ¤ ë¥ ¤®áâã¯ë   çâ¥¨¥ ¨ § ¯¨áì.
+  * Спроецированные данные доступны на чтение и запись.
-  *  §¬¥à ¤ ëå ä®  à ¢¥ 3*xsize*ysize. §¬¥¥¨¥ à §¬¥à®¢ ä®
+  * Размер данных фона равен 3*xsize*ysize. Изменение размеров фона
-    ¡«®ª¨àã¥âáï   ¢à¥¬ï à ¡®âë á á¯à®¥æ¨à®¢ ë¬¨ ¤ ë¬¨.
+    блокируется на время работы с спроецированными данными.
-  * ¢¥â ª ¦¤®£® ¯¨ªá¥«ï åà ¨âáï ª ª 3-¡ ©â®¢ ï ¢¥«¨ç¨  BBGGRR.
+  * Цвет каждого пикселя хранится как 3-байтовая величина BBGGRR.
-  * ¨ªá¥«¨ ä®®¢®£® ¨§®¡à ¦¥¨ï § ¯¨áë¢ îâáï ¯®á«¥¤®¢ â¥«ì®
+  * Пиксели фонового изображения записываются последовательно
-    á«¥¢   ¯à ¢®, á¢¥àåã ¢¨§.
+    слева направо, сверху вниз.
 ======================================================================
-====================== ãªæ¨ï 15, ¯®¤äãªæ¨ï 7 ======================
+====================== Функция 15, подфункция 7 ======================
-===  ªàëâì ¯à®¥ªæ¨î ¤ ëå ä®     ¤à¥á®¥ ¯à®áâà áâ¢® ¯à®æ¥áá . ==
+=== Закрыть проекцию данных фона на адресное пространство процесса. ==
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 15 - ®¬¥à äãªæ¨¨
+  * eax = 15 - номер функции
-  * ebx = 7 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 7 - номер подфункции
-  * ecx = ãª § â¥«ì   ¤ ë¥ ä®
+  * ecx = указатель на данные фона
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 1 ¯à¨ ãá¯¥å¥, 0 ¯à¨ ®è¨¡ª¥
+  * eax = 1 при успехе, 0 при ошибке
 ======================================================================
-====================== ãªæ¨ï 15, ¯®¤äãªæ¨ï 8 ======================
+====================== Функция 15, подфункция 8 ======================
-=========== ®«ãç¨âì ª®®à¤¨ âë ¯®á«¥¤¥© ®âà¨á®¢ª¨ ä® . ============
+=========== Получить координаты последней отрисовки фона. ============
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 15 - ®¬¥à äãªæ¨¨
+  * eax = 15 - номер функции
-  * ebx = 8 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 8 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = [left]*65536 + [right]
   * ebx = [top]*65536 + [bottom]
- ¬¥ç ¨ï:
+Замечания:
-  * (left,top) - ª®®à¤¨ âë «¥¢®£® ¢¥àå¥£® ã£« ,
+  * (left,top) - координаты левого верхнего угла,
-    (right,bottom) - ª®®à¤¨ âë ¯à ¢®£® ¨¦¥£®.
+    (right,bottom) - координаты правого нижнего.
-  * «ï ¯®«ãç¥¨ï ¡®«¥¥ ¤®áâ®¢¥àëå á¢¥¤¥¨©, ¥®¡å®¤¨¬® ¢ë§¢ âì
+  * Для получения более достоверных сведений, необходимо вызвать
-    äãªæ¨î áà §ã ¯®á«¥ ¯®«ãç¥¨ï á®¡ëâ¨ï:
+    функцию сразу после получения события:
-= § ¢¥àè¨« áì ¯¥à¥à¨á®¢ª  ä®  à ¡®ç¥£® áâ®«
+= завершилась перерисовка фона рабочего стола
 ======================================================================
-====================== ãªæ¨ï 15, ¯®¤äãªæ¨ï 9 ======================
+====================== Функция 15, подфункция 9 ======================
-=============== ¥à¥à¨á®¢ âì ¯àï¬®ã£®«ìãî ç áâì ä® . ===============
+=============== Перерисовать прямоугольную часть фона. ===============
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 15 - ®¬¥à äãªæ¨¨
+  * eax = 15 - номер функции
-    £¤¥ AAAA § ¤ ñâ â¨¯ ¯¥à¢®£® ¤¨áª®¢®¤ , BBBB - ¢â®à®£® á®£« á®
+    где AAAA задаёт тип первого дисковода, BBBB - второго согласно
-    á«¥¤ãîé¥¬ã á¯¨áªã:
+    следующему списку:
-    * 0 = ¥â ¤¨áª®¢®¤
+    * 0 = нет дисковода
     * 1 = 360Kb, 5.25''
     * 2 = 1.2Mb, 5.25''
     * 3 = 720Kb, 3.5''
     * 4 = 1.44Mb, 3.5''
-    * 5 = 2.88Mb, 3.5'' (â ª¨¥ ¤¨áª¥âë á¥©ç á ã¦¥ ¥ ¨á¯®«ì§ãîâáï)
+    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)
-     ¯à¨¬¥à, ¤«ï áâ ¤ àâ®© ª®ä¨£ãà æ¨¨ ¨§ ®¤®£® 1.44-¤¨áª®¢®¤
+    Например, для стандартной конфигурации из одного 1.44-дисковода
-    §¤¥áì ¡ã¤¥â 40h,   ¤«ï á«ãç ï 1.2Mb   A: ¨ 1.44Mb   B:
+    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:
-    § ç¥¨¥ ®ª §ë¢ ¥âáï 24h.
+    значение оказывается 24h.
-  * +1: byte: ¨ä®à¬ æ¨ï ® ¦ñáâª¨å ¤¨áª å ¨ CD-¯à¨¢®¤ å, AABBCCDD,
+  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,
-    £¤¥ AA á®®â¢¥âáâ¢ã¥â ª®âà®««¥àã IDE0, ..., DD - IDE3:
+    где AA соответствует контроллеру IDE0, ..., DD - IDE3:
-    * 0 = ãáâà®©áâ¢® ®âáãâáâ¢ã¥â
+    * 0 = устройство отсутствует
-    * 1 = ¦ñáâª¨© ¤¨áª
+    * 1 = жёсткий диск
-    * 2 = CD-¯à¨¢®¤
+    * 2 = CD-привод
-     ¯à¨¬¥à, ¢ á«ãç ¥ HD   IDE0 ¨ CD   IDE2 §¤¥áì ¡ã¤¥â 48h.
+    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.
-  * +2: 4 db: ç¨á«®  ©¤¥ëå à §¤¥«®¢   ¦ñáâª¨å ¤¨áª å á
+  * +2: 4 db: число найденных разделов на жёстких дисках с
-    á®®â¢¥âáâ¢¥® IDE0,...,IDE3.
+    соответственно IDE0,...,IDE3.
-    à¨ ®âáãâáâ¢¨¨ ¦ñáâª®£® ¤¨áª    IDEx á®®â¢¥âáâ¢ãîé¨© ¡ ©â
+    При отсутствии жёсткого диска на IDEx соответствующий байт
-    ã«¥¢®©, ¯à¨  «¨ç¨¨ ¯®ª §ë¢ ¥â ç¨á«® à á¯®§ ëå à §¤¥«®¢,
+    нулевой, при наличии показывает число распознанных разделов,
-    ª®â®àëå ¬®¦¥â ¨ ¥ ¡ëâì (¥á«¨ ®á¨â¥«ì ¥ ®âä®à¬ â¨à®¢  ¨«¨
+    которых может и не быть (если носитель не отформатирован или
-    ¥á«¨ ä ©«®¢ ï á¨áâ¥¬  ¥ ¯®¤¤¥à¦¨¢ ¥âáï).  â¥ªãé¥© ¢¥àá¨¨ ï¤à
+    если файловая система не поддерживается). В текущей версии ядра
-    ¤«ï ¦ñáâª¨å ¤¨áª®¢ ¯®¤¤¥à¦¨¢ îâáï â®«ìª® FAT16, FAT32 ¨ NTFS.
+    для жёстких дисков поддерживаются только FAT16, FAT32 и NTFS.
-  * +6: 4 db: § à¥§¥à¢¨à®¢ ®
+  * +6: 4 db: зарезервировано
-®à¬ â â ¡«¨æë: ¯®« ï ¢¥àá¨ï:
+Формат таблицы: полная версия:
-  * +0: 10 db: â ª¨¥ ¦¥, ª ª ¨ ¢ ª®à®âª®© ¢¥àá¨¨
+  * +0: 10 db: такие же, как и в короткой версии
-  * +10: 100 db: ¤ ë¥ ¤«ï ¯¥à¢®£® à §¤¥«
+  * +10: 100 db: данные для первого раздела
-  * +110: 100 db: ¤ ë¥ ¤«ï ¢â®à®£® à §¤¥«
+  * +110: 100 db: данные для второго раздела
   * ...
-  * +10+100*(n-1): 100 db: ¤ ë¥ ¤«ï ¯®á«¥¤¥£® à §¤¥«
+  * +10+100*(n-1): 100 db: данные для последнего раздела
- §¤¥«ë à á¯®«®¦¥ë ¢ á«¥¤ãîé¥¬ ¯®àï¤ª¥: á ç «  ¯®á«¥¤®¢ â¥«ì® ¢á¥
+Разделы расположены в следующем порядке: сначала последовательно все
-à á¯®§ ë¥ à §¤¥«ë   HD   IDE0 (¥á«¨ ¥áâì),
+распознанные разделы на HD на IDE0 (если есть),
-§ â¥¬   HD   IDE1 (¥á«¨ ¥áâì) ¨ â.¤. ¤® IDE3.
+затем на HD на IDE1 (если есть) и т.д. до IDE3.
-®à¬ â ¨ä®à¬ æ¨¨ ® à §¤¥«¥:
+Формат информации о разделе:
-  * +0: dword:  ç «ìë© ä¨§¨ç¥áª¨© á¥ªâ®à à §¤¥«
+  * +0: dword: начальный физический сектор раздела
-  * +4: dword: ¯®á«¥¤¨© ä¨§¨ç¥áª¨© á¥ªâ®à à §¤¥«
+  * +4: dword: последний физический сектор раздела
-    (¯à¨ ¤«¥¦¨â à §¤¥«ã)
+    (принадлежит разделу)
-  * +8: byte: â¨¯ ä ©«®¢®© á¨áâ¥¬ë:
+  * +8: byte: тип файловой системы:
 =FAT16, 32=FAT32, 1=NTFS
-  * ä®à¬ â ¤ «ì¥©è¨å ¤ ëå § ¢¨á¨â ®â ä ©«®¢®© á¨áâ¥¬ë,
+  * формат дальнейших данных зависит от файловой системы,
-    ¬®¦¥â ¬¥ïâìáï á ¨§¬¥¥¨ï¬¨ ¢ ï¤à¥ ¨ ¯®íâ®¬ã ¥ ®¯¨áë¢ ¥âáï
+    может меняться с изменениями в ядре и поэтому не описывается
- ¬¥ç ¨ï:
+Замечания:
-  * ®à®âª ï â ¡«¨æ  ¬®¦¥â ¡ëâì ¨á¯®«ì§®¢   ¤«ï ¯®«ãç¥¨ï ¨ä®à¬ æ¨¨
+  * Короткая таблица может быть использована для получения информации
-    ®¡ ¨¬¥îé¨åáï ãáâà®©áâ¢ å.
+    об имеющихся устройствах.
 ======================================================================
-========== ãªæ¨ï 18, ¯®¤äãªæ¨ï 13 - ¯®«ãç¨âì ¢¥àá¨î ï¤à . =========
+========== Функция 18, подфункция 13 - получить версию ядра. =========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 18 - ®¬¥à äãªæ¨¨
+  * eax = 18 - номер функции
-  * ebx = 13 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 13 - номер подфункции
-  * ecx = ãª § â¥«ì   ¡ãä¥à (¥ ¬¥¥¥ 16 ¡ ©â), ªã¤  ¡ã¤¥â ¯®¬¥é¥
+  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена
-    ¨ä®à¬ æ¨ï
+    информация
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
-âàãªâãà  ¡ãä¥à :
+Структура буфера:
-db a,b,c,d ¤«ï ¢¥àá¨¨ a.b.c.d
+db a,b,c,d для версии a.b.c.d
-db 0: § à¥§¥à¢¨à®¢ ®
+db 0: зарезервировано
-dd REV - ®¬¥à svn-à¥¢¨§¨¨ ï¤à
+dd REV - номер svn-ревизии ядра
-«ï ï¤à  Kolibri 0.7.7.0+:
+Для ядра Kolibri 0.7.7.0+:
 db 0,7,7,0
 db 0
 dd 1675
-    * 2 = à áª« ¤ªã ¯à¨  ¦ â®¬ Shift
+    * 2 = раскладку при нажатом Shift
-    * 3 = à áª« ¤ªã ¯à¨  ¦ â®¬ Alt
+    * 3 = раскладку при нажатом Alt
-  * edx = ãª § â¥«ì   à áª« ¤ªã - â ¡«¨æã ¤«¨®© 128 ¡ ©â
+  * edx = указатель на раскладку - таблицу длиной 128 байт
-«¨:
+Или:
   * ecx = 9
-  * dx = ¨¤¥â¨ä¨ª â®à áâà ë (1=eng, 2=fi, 3=ger, 4=rus)
+  * dx = идентификатор страны (1=eng, 2=fi, 3=ger, 4=rus)
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®
+  * eax = 0 - успешно
-  * eax = 1 - ¯ à ¬¥âà § ¤  ¥¢¥à®
+  * eax = 1 - параметр задан неверно
- ¬¥ç ¨ï:
+Замечания:
-  * á«¨  ¦ â Alt, â® ¨á¯®«ì§ã¥âáï à áª« ¤ª  á Alt;
+  * Если нажат Alt, то используется раскладка с Alt;
-    ¥á«¨ ¥  ¦ â Alt, ®  ¦ â Shift, â®
+    если не нажат Alt, но нажат Shift, то
-    ¨á¯®«ì§ã¥âáï à áª« ¤ª  á Shift;
+    используется раскладка с Shift;
-    ¥á«¨ ¥  ¦ âë Alt ¨ Shift, ®  ¦ â Ctrl, â® ¨á¯®«ì§ã¥âáï
+    если не нажаты Alt и Shift, но нажат Ctrl, то используется
-    ®à¬ «ì ï à áª« ¤ª , ¯®á«¥ ç¥£® ¨§ ª®¤  ¢ëç¨â ¥âáï 0x60;
+    нормальная раскладка, после чего из кода вычитается 0x60;
-    ¥á«¨ ¥  ¦ â  ¨ ®¤  ¨§ ã¯à ¢«ïîé¨å ª« ¢¨è, â® ¨á¯®«ì§ã¥âáï
+    если не нажата ни одна из управляющих клавиш, то используется
-    ®à¬ «ì ï à áª« ¤ª .
+    нормальная раскладка.
-  * ®«ãç¨âì à áª« ¤ª¨ ¨ ¨¤¥â¨ä¨ª â®à áâà ë ¬®¦® á ¯®¬®éìî
+  * Получить раскладки и идентификатор страны можно с помощью
-    ¯®¤äãªæ¨¨ 2 äãªæ¨¨ 26.
+    подфункции 2 функции 26.
-  * ¤¥â¨ä¨ª â®à áâà ë - £«®¡ «ì ï á¨áâ¥¬ ï ¯¥à¥¬¥ ï, ª®â®à ï
+  * Идентификатор страны - глобальная системная переменная, которая
-    á ¬¨¬ ï¤à®¬ ¥ ¨á¯®«ì§ã¥âáï; ®¤ ª® ¯à¨«®¦¥¨¥ @panel ®â®¡à ¦ ¥â
+    самим ядром не используется; однако приложение @panel отображает
-    á®®â¢¥âáâ¢ãîéãî â¥ªãé¥© áâà ¥ ¨ª®ªã.
+    соответствующую текущей стране иконку.
-  * à¨«®¦¥¨¥ @panel ¯¥à¥ª«îç ¥â à áª« ¤ª¨ ¯® § ¯à®áã ¯®«ì§®¢ â¥«ï.
+  * Приложение @panel переключает раскладки по запросу пользователя.
 ======================================================================
-=========== ãªæ¨ï 21, ¯®¤äãªæ¨ï 3 - ãáâ ®¢¨âì ¡ §ã CD. ===========
+=========== Функция 21, подфункция 3 - установить базу CD. ===========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 21 - ®¬¥à äãªæ¨¨
+  * eax = 21 - номер функции
-  * ebx = 3 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 3 - номер подфункции
-  * ecx = ¡ §  CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
+  * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = 0
- ¬¥ç ¨ï:
+Замечания:
-  *  §  CD ¨á¯®«ì§ã¥âáï äãªæ¨¥© 24.
+  * База CD используется функцией 24.
-  * ®«ãç¨âì ãáâ ®¢«¥ãî ¡ §ã CD ¬®¦® ¢ë§®¢®¬
+  * Получить установленную базу CD можно вызовом
-    ¯®¤äãªæ¨¨ 3 äãªæ¨¨ 26.
+    подфункции 3 функции 26.
 ======================================================================
-========= ãªæ¨ï 21, ¯®¤äãªæ¨ï 5 - ãáâ ®¢¨âì ï§ëª á¨áâ¥¬ë. ========
+========= Функция 21, подфункция 5 - установить язык системы. ========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 21 - ®¬¥à äãªæ¨¨
+  * eax = 21 - номер функции
-  * ebx = 5 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 5 - номер подфункции
-  * ecx = ï§ëª á¨áâ¥¬ë (1=eng, 2=fi, 3=ger, 4=rus)
+  * ecx = язык системы (1=eng, 2=fi, 3=ger, 4=rus)
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = 0
- ¬¥ç ¨ï:
+Замечания:
-  * §ëª á¨áâ¥¬ë - £«®¡ «ì ï á¨áâ¥¬ ï ¯¥à¥¬¥ ï, ¨ª ª
+  * Язык системы - глобальная системная переменная, никак
-    ¥ ¨á¯®«ì§ã¥¬ ï á ¬¨¬ ï¤à®¬, ®¤ ª® ¯à¨«®¦¥¨¥ @panel à¨áã¥â
+    не используемая самим ядром, однако приложение @panel рисует
-    á®®â¢¥âáâ¢ãîéãî ¨ª®ªã.
+    соответствующую иконку.
-  * à®¢¥à®ª   ª®àà¥ªâ®áâì ¥ ¤¥« ¥âáï, ¯®áª®«ìªã ï¤à® íâã
+  * Проверок на корректность не делается, поскольку ядро эту
-    ¯¥à¥¬¥ãî ¥ ¨á¯®«ì§ã¥â.
+    переменную не использует.
-  * ®«ãç¨âì ï§ëª á¨áâ¥¬ë ¬®¦® ¢ë§®¢®¬ ¯®¤äãªæ¨¨ 5 äãªæ¨¨ 26.
+  * Получить язык системы можно вызовом подфункции 5 функции 26.
 ======================================================================
-=========== ãªæ¨ï 21, ¯®¤äãªæ¨ï 7 - ãáâ ®¢¨âì ¡ §ã HD. ===========
+=========== Функция 21, подфункция 7 - установить базу HD. ===========
 ======================================================================
- §  HD ã¦  ¤«ï ®¯à¥¤¥«¥¨ï,   ª ª®© ¦ñáâª¨© ¤¨áª ¯¨á âì, ¯à¨
+База HD нужна для определения, на какой жёсткий диск писать, при
-¨á¯®«ì§®¢ ¨¨ ãáâ à¥¢è¥£® á¨â ªá¨á  /HD ¢ ãáâ à¥¢è¥© äãªæ¨¨ 58;
+использовании устаревшего синтаксиса /HD в устаревшей функции 58;
-¯à¨ ¨á¯®«ì§®¢ ¨¨ á®¢à¥¬¥®£® á¨â ªá¨á  /HD0,/HD1,/HD2,/HD3
+при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3
-¡ §  ãáâ  ¢«¨¢ ¥âáï  ¢â®¬ â¨ç¥áª¨.
+база устанавливается автоматически.
- à ¬¥âàë:
+Параметры:
-  * eax = 21 - ®¬¥à äãªæ¨¨
+  * eax = 21 - номер функции
-  * ebx = 7 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 7 - номер подфункции
-  * ecx = ¡ §  HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
+  * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = 0
- ¬¥ç ¨ï:
+Замечания:
-  * î¡®¥ ¯à¨«®¦¥¨¥ ¢ «î¡®© ¬®¬¥â ¢à¥¬¥¨ ¬®¦¥â ¨§¬¥¨âì ¡ §ã.
+  * Любое приложение в любой момент времени может изменить базу.
-  * ¥ á«¥¤ã¥â ¨§¬¥ïâì ¡ §ã, ª®£¤  ª ª®¥-¨¡ã¤ì ¯à¨«®¦¥¨¥ à ¡®â ¥â
+  * Не следует изменять базу, когда какое-нибудь приложение работает
-    á ¦ñáâª¨¬ ¤¨áª®¬. á«¨ ¥ å®â¨â¥ £«îª®¢ á¨áâ¥¬ë.
+    с жёстким диском. Если не хотите глюков системы.
-  * ®«ãç¨âì ãáâ ®¢«¥ãî ¡ §ã ¬®¦® ¢ë§®¢®¬ ¯®¤äãªæ¨¨ 7 äãªæ¨¨ 26.
+  * Получить установленную базу можно вызовом подфункции 7 функции 26.
-  * «¥¤ã¥â â ª¦¥ ®¯à¥¤¥«¨âì ¨á¯®«ì§ã¥¬ë© à §¤¥« ¦ñáâª®£® ¤¨áª
+  * Следует также определить используемый раздел жёсткого диска
-    ¯®¤äãªæ¨¥© 8.
+    подфункцией 8.
 ======================================================================
-========== ãªæ¨ï 21, ¯®¤äãªæ¨ï 8 - ãáâ ®¢¨âì à §¤¥« HD. ==========
+========== Функция 21, подфункция 8 - установить раздел HD. ==========
 ======================================================================
- §¤¥« HD ã¦¥ ¤«ï ®¯à¥¤¥«¥¨ï,   ª ª®© à §¤¥« ¦ñáâª®£® ¤¨áª
+Раздел HD нужен для определения, на какой раздел жёсткого диска
-¯¨á âì, ¯à¨ ¨á¯®«ì§®¢ ¨¨ ãáâ à¥¢è¥£® á¨â ªá¨á  /HD ¢ ãáâ à¥¢è¥©
+писать, при использовании устаревшего синтаксиса /HD в устаревшей
-äãªæ¨¨ 58; ¯à¨ ¨á¯®«ì§®¢ ¨¨ á®¢à¥¬¥®£® á¨â ªá¨á
+функции 58; при использовании современного синтаксиса
-/HD0,/HD1,/HD2,/HD3 ¡ §  ¨ à §¤¥« ãáâ  ¢«¨¢ îâáï  ¢â®¬ â¨ç¥áª¨.
+/HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически.
- à ¬¥âàë:
+Параметры:
-  * eax = 21 - ®¬¥à äãªæ¨¨
+  * eax = 21 - номер функции
-  * ebx = 8 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 8 - номер подфункции
-  * ecx = à §¤¥« HD (áç¨â ï á 1)
+  * ecx = раздел HD (считая с 1)
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = 0
- ¬¥ç ¨ï:
+Замечания:
-  * î¡®¥ ¯à¨«®¦¥¨¥ ¢ «î¡®© ¬®¬¥â ¢à¥¬¥¨ ¬®¦¥â ¨§¬¥¨âì à §¤¥«.
+  * Любое приложение в любой момент времени может изменить раздел.
-  * ¥ á«¥¤ã¥â ¨§¬¥ïâì à §¤¥«, ª®£¤  ª ª®¥-¨¡ã¤ì ¯à¨«®¦¥¨¥ à ¡®â ¥â
+  * Не следует изменять раздел, когда какое-нибудь приложение работает
-    á ¦ñáâª¨¬ ¤¨áª®¬. á«¨ ¥ å®â¨â¥ £«îª®¢ á¨áâ¥¬ë.
+    с жёстким диском. Если не хотите глюков системы.
-  * ®«ãç¨âì ãáâ ®¢«¥ë© à §¤¥« ¬®¦® ¢ë§®¢®¬ ¯®¤äãªæ¨¨ 8
+  * Получить установленный раздел можно вызовом подфункции 8
-    äãªæ¨¨ 26.
+    функции 26.
-  * à®¢¥à®ª   ª®àà¥ªâ®áâì ¥ ¤¥« ¥âáï.
+  * Проверок на корректность не делается.
-  * § âì ç¨á«® à §¤¥«®¢   ¦ñáâª®¬ ¤¨áª¥ ¬®¦® ¢ë§®¢®¬
+  * Узнать число разделов на жёстком диске можно вызовом
-    ¯®¤äãªæ¨¨ 11 äãªæ¨¨ 18.
+    подфункции 11 функции 18.
-  * «¥¤ã¥â â ª¦¥ ®¯à¥¤¥«¨âì ¨á¯®«ì§ã¥¬ãî ¡ §ã ¦ñáâª®£® ¤¨áª
+  * Следует также определить используемую базу жёсткого диска
-    ¯®¤äãªæ¨¥© 7.
+    подфункцией 7.
 ======================================================================
-====================== ãªæ¨ï 21, ¯®¤äãªæ¨ï 11 =====================
+====================== Функция 21, подфункция 11 =====================
-===========  §à¥è¨âì/§ ¯à¥â¨âì ¨§ª®ãà®¢¥¢ë© ¤®áâã¯ ª HD. ==========
+=========== Разрешить/запретить низкоуровневый доступ к HD. ==========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 21 - ®¬¥à äãªæ¨¨
+  * eax = 21 - номер функции
-  * ebx = 11 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 11 - номер подфункции
-  * ecx = 0/1 - § ¯à¥â¨âì/à §à¥è¨âì
+  * ecx = 0/1 - запретить/разрешить
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = 0
- ¬¥ç ¨ï:
+Замечания:
-  * á¯®«ì§ã¥âáï ¯à¨ LBA-çâ¥¨¨ (¯®¤äãªæ¨ï 8 äãªæ¨¨ 58).
+  * Используется при LBA-чтении (подфункция 8 функции 58).
-  * ¥ªãé ï à¥ «¨§ æ¨ï ¨á¯®«ì§ã¥â â®«ìª® ¬« ¤è¨© ¡¨â ecx.
+  * Текущая реализация использует только младший бит ecx.
-  * ®«ãç¨âì â¥ªãé¥¥ á®áâ®ï¨¥ ¬®¦® ¢ë§®¢®¬ ¯®¤äãªæ¨¨ 11 äãªæ¨¨ 26.
+  * Получить текущее состояние можно вызовом подфункции 11 функции 26.
 ======================================================================
-====================== ãªæ¨ï 21, ¯®¤äãªæ¨ï 12 =====================
+====================== Функция 21, подфункция 12 =====================
-==========  §à¥è¨âì/§ ¯à¥â¨âì ¨§ª®ãà®¢¥¢ë© ¤®áâã¯ ª PCI. ==========
+========== Разрешить/запретить низкоуровневый доступ к PCI. ==========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 21 - ®¬¥à äãªæ¨¨
+  * eax = 21 - номер функции
-  * ebx = 12 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 12 - номер подфункции
-  * ecx = 0/1 - § ¯à¥â¨âì/à §à¥è¨âì
+  * ecx = 0/1 - запретить/разрешить
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = 0
- ¬¥ç ¨ï:
+Замечания:
-  * á¯®«ì§ã¥âáï ¯à¨ à ¡®â¥ á è¨®© PCI (äãªæ¨ï 62).
+  * Используется при работе с шиной PCI (функция 62).
-  * ¥ªãé ï à¥ «¨§ æ¨ï ¨á¯®«ì§ã¥â â®«ìª® ¬« ¤è¨© ¡¨â ecx.
+  * Текущая реализация использует только младший бит ecx.
-  * ®«ãç¨âì â¥ªãé¥¥ á®áâ®ï¨¥ ¬®¦® ¢ë§®¢®¬ ¯®¤äãªæ¨¨ 12 äãªæ¨¨ 26.
+  * Получить текущее состояние можно вызовом подфункции 12 функции 26.
 ======================================================================
-============= ãªæ¨ï 21, ¯®¤äãªæ¨ï 13, ¯®¤¯®¤äãªæ¨ï 1 =============
+============= Функция 21, подфункция 13, подподфункция 1 =============
-==== ¨æ¨ «¨§¨à®¢ âì + ¯®«ãç¨âì ¨ä®à¬ æ¨î ® ¤à ©¢¥à¥ vmode.mdr. ====
+==== Инициализировать + получить информацию о драйвере vmode.mdr. ====
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 21 - ®¬¥à äãªæ¨¨
+  * eax = 21 - номер функции
-    * DD=¤¥ì 01..31
+    * DD=день 01..31
-    à áª« ¤ª
+    раскладка
-  * ecx = y-ª®®à¤¨ â  (®â®á¨â¥«ì® íªà  )
+  * ecx = y-координата (относительно экрана)
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0x000000XX - â®çª  ¯à¨ ¤«¥¦¨â á«®âã ®ª  N
+  * eax = 0x000000XX - точка принадлежит слоту окна N
-    à¨ ¥ª®àà¥ªâëå § ç¥¨ïå ebx ¨ ecx äãªæ¨ï ¢®§¢à é ¥â 0
+    При некорректных значениях ebx и ecx функция возвращает 0
-  * ãªæ¨ï ¡¥à¥â § ç¥¨ï ¨§ ®¡« áâ¨ [_WinMapAddress]
+  * Функция берет значения из области [_WinMapAddress]
 ======================================================================
-============ ãªæ¨ï 35 - ¯à®ç¨â âì æ¢¥â â®çª¨   íªà ¥. ============
+============ Функция 35 - прочитать цвет точки на экране. ============
 ======================================================================
- à ¬¥âàë:
+Параметры:
   * eax = 35
-  * ebx = y*xsize+x, £¤¥
+  * ebx = y*xsize+x, где
-  * (x,y) = ª®®à¤¨ âë â®çª¨ (áç¨â ï ®â 0)
+  * (x,y) = координаты точки (считая от 0)
-  * xsize = à §¬¥à íªà   ¯® £®à¨§®â «¨
+  * xsize = размер экрана по горизонтали
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = æ¢¥â 0x00RRGGBB
+  * eax = цвет 0x00RRGGBB
- ¬¥ç ¨ï:
+Замечания:
-  * § âì à §¬¥àë íªà   ¬®¦® ¢ë§®¢®¬ äãªæ¨¨ 14. ¡à â¨â¥ ¢¨¬ ¨¥,
+  * Узнать размеры экрана можно вызовом функции 14. Обратите внимание,
-    çâ® ®  ¢ëç¨â ¥â 1 ¨§ ®¡®¨å à §¬¥à®¢.
+    что она вычитает 1 из обоих размеров.
-  *  ¢¨¤¥®¯ ¬ïâ¨ ¥áâì â ª¦¥ ¯àï¬®© ¤®áâã¯ (¡¥§ ¢ë§®¢®¢ á¨áâ¥¬ëå
+  * К видеопамяти есть также прямой доступ (без вызовов системных
-    äãªæ¨©) ç¥à¥§ á¥«¥ªâ®à gs.  à ¬¥âàë â¥ªãé¥£® ¢¨¤¥®à¥¦¨¬
+    функций) через селектор gs. Параметры текущего видеорежима
-    ¬®¦® ¯®«ãç¨âì äãªæ¨¥© 61.
+    можно получить функцией 61.
 ======================================================================
-=============== ãªæ¨ï 36 - ¯à®ç¨â âì ®¡« áâì íªà  . ===============
+=============== Функция 36 - прочитать область экрана. ===============
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 36 - ®¬¥à äãªæ¨¨
+  * eax = 36 - номер функции
-  * ebx = ãª § â¥«ì   ¯à¥¤¢ à¨â¥«ì® ¢ë¤¥«¥ãî ®¡« áâì ¯ ¬ïâ¨,
+  * ebx = указатель на предварительно выделенную область памяти,
-            ªã¤  ¡ã¤¥â ¯®¬¥é¥® ¨§®¡à ¦¥¨¥ ¢ ä®à¬ â¥ BBGGRRBBGGRR...
+            куда будет помещено изображение в формате BBGGRRBBGGRR...
-  * ecx = [à §¬¥à ¯® ®á¨ x]*65536 + [à §¬¥à ¯® ®á¨ y]
+  * ecx = [размер по оси x]*65536 + [размер по оси y]
-  * edx = [ª®®à¤¨ â  ¯® ®á¨ x]*65536 + [ª®®à¤¨ â  ¯® ®á¨ y]
+  * edx = [координата по оси x]*65536 + [координата по оси y]
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
- ¬¥ç ¨ï:
+Замечания:
-  * ®®à¤¨ âë ®¡« áâ¨ - íâ® ª®®à¤¨ âë ¢¥àå¥£® «¥¢®£® ã£«
+  * Координаты области - это координаты верхнего левого угла
-    ®¡« áâ¨ ®â®á¨â¥«ì® íªà  .
+    области относительно экрана.
-  *  §¬¥à ¨§®¡à ¦¥¨ï ¢ ¡ ©â å ¥áâì 3*xsize*ysize.
+  * Размер изображения в байтах есть 3*xsize*ysize.
 ======================================================================
-==================== ãªæ¨ï 37 - à ¡®â  á ¬ëèìî. ====================
+==================== Функция 37 - работа с мышью. ====================
 ======================================================================
--------------- ®¤äãªæ¨ï 0 - íªà ë¥ ª®®à¤¨ âë ¬ëè¨ ---------------
+-------------- Подфункция 0 - экранные координаты мыши ---------------
- à ¬¥âàë:
+Параметры:
-  * eax = 37 - ®¬¥à äãªæ¨¨
+  * eax = 37 - номер функции
-  * ebx = 0 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 0 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = x*65536 + y, (x,y)=ª®®à¤¨ âë ªãàá®à  ¬ëè¨ (áç¨â ï ®â 0)
+  * eax = x*65536 + y, (x,y)=координаты курсора мыши (считая от 0)
----------- ®¤äãªæ¨ï 1 - ª®®à¤¨ âë ¬ëè¨ ®â®á¨â¥«ì® ®ª  ----------
+---------- Подфункция 1 - координаты мыши относительно окна ----------
- à ¬¥âàë:
+Параметры:
-  * eax = 37 - ®¬¥à äãªæ¨¨
+  * eax = 37 - номер функции
-  * ebx = 1 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 1 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = x*65536 + y, (x,y)=ª®®à¤¨ âë ªãàá®à  ¬ëè¨ ®â®á¨â¥«ì®
+  * eax = x*65536 + y, (x,y)=координаты курсора мыши относительно
-    ®ª  ¯à¨«®¦¥¨ï (áç¨â ï ®â 0)
+    окна приложения (считая от 0)
- ¬¥ç ¨ï:
+Замечания:
-  *  ç¥¨¥ ¢ëç¨á«ï¥âáï ¯® ä®à¬ã«¥ (x-xwnd)*65536 + (y-ywnd).
+  * Значение вычисляется по формуле (x-xwnd)*65536 + (y-ywnd).
-    á«¨ y>=ywnd, â® ¬« ¤è¥¥ á«®¢® ¥®âà¨æ â¥«ì® ¨ á®¤¥à¦¨â
+    Если y>=ywnd, то младшее слово неотрицательно и содержит
-    ®â®á¨â¥«ìãî y-ª®®à¤¨ âã,   áâ àè¥¥ - ®â®á¨â¥«ìãî x-ª®®à¤¨ âã
+    относительную y-координату, а старшее - относительную x-координату
-    (¯à ¢¨«ì®£® § ª ).  ¯à®â¨¢®¬ á«ãç ¥ ¬« ¤è¥¥ á«®¢® ®âà¨æ â¥«ì®
+    (правильного знака). В противном случае младшее слово отрицательно
-    ¨ ¢áñ à ¢® á®¤¥à¦¨â ®â®á¨â¥«ìãî y-ª®®à¤¨ âã,
+    и всё равно содержит относительную y-координату,
-      ª áâ àè¥¬ã á«®¢ã á«¥¤ã¥â ¯à¨¡ ¢¨âì 1.
+    а к старшему слову следует прибавить 1.
------------------ ®¤äãªæ¨ï 2 -  ¦ âë¥ ª®¯ª¨ ¬ëè¨ -----------------
+----------------- Подфункция 2 - нажатые кнопки мыши -----------------
- à ¬¥âàë:
+Параметры:
-  * eax = 37 - ®¬¥à äãªæ¨¨
+  * eax = 37 - номер функции
-  * ebx = 2 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 2 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax á®¤¥à¦¨â ¨ä®à¬ æ¨î ®  ¦ âëå ª®¯ª å ¬ëè¨:
+  * eax содержит информацию о нажатых кнопках мыши:
-  * ¡¨â 0 ãáâ ®¢«¥ = «¥¢ ï ª®¯ª   ¦ â
+  * бит 0 установлен = левая кнопка нажата
-  * ¡¨â 1 ãáâ ®¢«¥ = ¯à ¢ ï ª®¯ª   ¦ â
+  * бит 1 установлен = правая кнопка нажата
-  * ¡¨â 2 ãáâ ®¢«¥ = áà¥¤ïï ª®¯ª   ¦ â
+  * бит 2 установлен = средняя кнопка нажата
-  * ¡¨â 3 ãáâ ®¢«¥ = 4-ï ª®¯ª   ¦ â
+  * бит 3 установлен = 4-я кнопка нажата
-  * ¡¨â 4 ãáâ ®¢«¥ = 5-ï ª®¯ª   ¦ â
+  * бит 4 установлен = 5-я кнопка нажата
-  * ¯à®ç¨¥ ¡¨âë á¡à®è¥ë
+  * прочие биты сброшены
------------------- ®¤äãªæ¨ï 4 - § £àã§¨âì ªãàá®à -------------------
+------------------ Подфункция 4 - загрузить курсор -------------------
- à ¬¥âàë:
+Параметры:
-  * eax = 37 - ®¬¥à äãªæ¨¨
+  * eax = 37 - номер функции
-  * ebx = 4 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 4 - номер подфункции
-  * dx = ¨áâ®ç¨ª ¤ ëå:
+  * dx = источник данных:
-  * dx = LOAD_FROM_FILE = 0 - ¤ ë¥ ¢ ä ©«¥
+  * dx = LOAD_FROM_FILE = 0 - данные в файле
-    * ecx = ãª § â¥«ì   ¯®«ë© ¯ãâì ª ä ©«ã ªãàá®à
+    * ecx = указатель на полный путь к файлу курсора
-    * ä ©« ªãàá®à  ¤®«¦¥ ¡ëâì ¢ ä®à¬ â¥ .cur, áâ ¤ àâ®¬ ¤«ï
+    * файл курсора должен быть в формате .cur, стандартном для
-      MS Windows, ¯à¨çñ¬ à §¬¥à®¬ 32*32 ¯¨ªá¥«ï
+      MS Windows, причём размером 32*32 пикселя
-  * dx = LOAD_FROM_MEM = 1 - ¤ ë¥ ä ©«  ã¦¥ § £àã¦¥ë ¢ ¯ ¬ïâì
+  * dx = LOAD_FROM_MEM = 1 - данные файла уже загружены в память
-    * ecx = ãª § â¥«ì   ¤ ë¥ ä ©«  ªãàá®à
+    * ecx = указатель на данные файла курсора
-    * ä®à¬ â ¤ ëå â ª®© ¦¥, ª ª ¨ ¢ ¯à¥¤ë¤ãé¥¬ á«ãç ¥
+    * формат данных такой же, как и в предыдущем случае
-  * dx = LOAD_INDIRECT = 2 - ¤ ë¥ ¢ ¯ ¬ïâ¨
+  * dx = LOAD_INDIRECT = 2 - данные в памяти
-    * ecx = ãª § â¥«ì   ®¡à § ªãàá®à  ¢ ä®à¬ â¥ ARGB 32*32 ¯¨ªá¥«ï
+    * ecx = указатель на образ курсора в формате ARGB 32*32 пикселя
-    * edx = 0xXXYY0002, £¤¥
+    * edx = 0xXXYY0002, где
-      * XX = x-ª®®à¤¨ â  "£®àïç¥© â®çª¨" ªãàá®à
+      * XX = x-координата "горячей точки" курсора
-      * YY = y-ª®®à¤¨ â
+      * YY = y-координата
       * 0 <= XX, YY <= 31
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ¥ã¤ ç
+  * eax = 0 - неудача
-  * ¨ ç¥ eax = åí¤« ªãàá®à
+  * иначе eax = хэндл курсора
------------------- ®¤äãªæ¨ï 5 - ãáâ ®¢¨âì ªãàá®à ------------------
+------------------ Подфункция 5 - установить курсор ------------------
-áâ  ¢«¨¢ ¥â ®¢ë© ªãàá®à ¤«ï ®ª  â¥ªãé¥£® ¯®â®ª .
+Устанавливает новый курсор для окна текущего потока.
- à ¬¥âàë:
+Параметры:
-  * eax = 37 - ®¬¥à äãªæ¨¨
+  * eax = 37 - номер функции
-  * ebx = 5 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 5 - номер подфункции
-  * ecx = åí¤« ªãàá®à
+  * ecx = хэндл курсора
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = åí¤« ¯à¥¤ë¤ãé¥£® ãáâ ®¢«¥®£® ªãàá®à
+  * eax = хэндл предыдущего установленного курсора
- ¬¥ç ¨ï:
+Замечания:
-  * á«¨ ¯¥à¥¤  ¥ª®àà¥ªâë© åí¤«, â® äãªæ¨ï ¢®ááâ ®¢¨â ªãàá®à
+  * Если передан некорректный хэндл, то функция восстановит курсор
-    ¯® ã¬®«ç ¨î (áâ ¤ àâãî áâà¥«ªã).  ç áâ®áâ¨, ª ¢®ááâ ®¢«¥¨î
+    по умолчанию (стандартную стрелку). В частности, к восстановлению
-    ªãàá®à  ¯® ã¬®«ç ¨î ¯à¨¢®¤¨â ¯¥à¥¤ ç  ecx=0.
+    курсора по умолчанию приводит передача ecx=0.
-------------------- ®¤äãªæ¨ï 6 - ã¤ «¨âì ªãàá®à --------------------
+------------------- Подфункция 6 - удалить курсор --------------------
- à ¬¥âàë:
+Параметры:
-  * eax = 37 - ®¬¥à äãªæ¨¨
+  * eax = 37 - номер функции
-  * ebx = 6 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 6 - номер подфункции
-  * ecx = åí¤« ªãàá®à
+  * ecx = хэндл курсора
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax à §àãè ¥âáï
+  * eax разрушается
- ¬¥ç ¨ï:
+Замечания:
-  * ãàá®à ¤®«¦¥ ¡ë« ¡ëâì à ¥¥ § £àã¦¥ â¥ªãé¨¬ ¯®â®ª®¬
+  * Курсор должен был быть ранее загружен текущим потоком
-    (¢ë§®¢®¬ ¯®¤äãªæ¨¨ 4). ãªæ¨ï ¥ ã¤ «ï¥â á¨áâ¥¬ë¥ ªãàá®àë ¨
+    (вызовом подфункции 4). Функция не удаляет системные курсоры и
-    ªãàá®àë, § £àã¦¥ë¥ ¤àã£¨¬¨ ¯à¨«®¦¥¨ï¬¨.
+    курсоры, загруженные другими приложениями.
-  * á«¨ ã¤ «ï¥âáï  ªâ¨¢ë© (ãáâ ®¢«¥ë© ¯®¤äãªæ¨¥© 5) ªãàá®à, â®
+  * Если удаляется активный (установленный подфункцией 5) курсор, то
-    ¢®ááâ  ¢«¨¢ ¥âáï ªãàá®à ¯® ã¬®«ç ¨î (áâ ¤ àâ ï áâà¥«ª ).
+    восстанавливается курсор по умолчанию (стандартная стрелка).
-    * ¡¨âë 16-21 = áª®«ìª® æ¨äà ®â®¡à ¦ âì
+    * биты 16-21 = сколько цифр отображать
 ======================================================================
-===== ãªæ¨ï 48, ¯®¤äãªæ¨ï 5 - ¯®«ãç¨âì à ¡®çãî ®¡« áâì íªà  . ====
+===== Функция 48, подфункция 5 - получить рабочую область экрана. ====
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 48 - ®¬¥à äãªæ¨¨
+  * eax = 48 - номер функции
-  * ebx = 5 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 5 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = [left]*65536 + [right]
   * ebx = [top]*65536 + [bottom]
- ¬¥ç ¨ï:
+Замечания:
-  *  ¡®ç ï ®¡« áâì íªà   ®¯à¥¤¥«ï¥â ¯®«®¦¥¨¥ ¨ ª®®à¤¨ âë
+  * Рабочая область экрана определяет положение и координаты
-    ¬ ªá¨¬¨§¨à®¢ ®£® ®ª .
+    максимизированного окна.
-  *  ¡®ç ï ®¡« áâì íªà   ¯à¨ ®à¬ «ì®© à ¡®â¥ ¥áâì ¢¥áì íªà
+  * Рабочая область экрана при нормальной работе есть весь экран
-    §  ¢ëç¥â®¬ ¯ ¥«¨ (@panel).
+    за вычетом панели (@panel).
-  * (left,top) - ª®®à¤¨ âë «¥¢®£® ¢¥àå¥£® ã£« ,
+  * (left,top) - координаты левого верхнего угла,
-    (right,bottom) - ª®®à¤¨ âë ¯à ¢®£® ¨¦¥£®.
+    (right,bottom) - координаты правого нижнего.
-     ª¨¬ ®¡à §®¬, à §¬¥à à ¡®ç¥© ®¡« áâ¨ ¯® ®á¨ x ®¯à¥¤¥«ï¥âáï
+    Таким образом, размер рабочей области по оси x определяется
-    ä®à¬ã«®© right-left+1, ¯® ®á¨ y - ä®à¬ã«®© bottom-right+1.
+    формулой right-left+1, по оси y - формулой bottom-right+1.
-  * ¬®âà¨ â ª¦¥ äãªæ¨î 14,
+  * Смотри также функцию 14,
-    ¯®§¢®«ïîéãî ®¯à¥¤¥«¨âì à §¬¥àë ¢á¥£® íªà  .
+    позволяющую определить размеры всего экрана.
-  * áâì ¯ à ï äãªæ¨ï ãáâ ®¢ª¨ à ¡®ç¥© ®¡« áâ¨ - ¯®¤äãªæ¨ï 6.
+  * Есть парная функция установки рабочей области - подфункция 6.
 ======================================================================
-==== ãªæ¨ï 48, ¯®¤äãªæ¨ï 6 - ãáâ ®¢¨âì à ¡®çãî ®¡« áâì íªà  . ===
+==== Функция 48, подфункция 6 - установить рабочую область экрана. ===
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 48 - ®¬¥à äãªæ¨¨
+  * eax = 48 - номер функции
-  * ebx = 6 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 6 - номер подфункции
   * ecx = [left]*65536 + [right]
   * edx = [top]*65536 + [bottom]
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
- ¬¥ç ¨ï:
+Замечания:
-  *  ¡®ç ï ®¡« áâì íªà   ®¯à¥¤¥«ï¥â ¯®«®¦¥¨¥ ¨ ª®®à¤¨ âë
+  * Рабочая область экрана определяет положение и координаты
-    ¬ ªá¨¬¨§¨à®¢ ®£® ®ª .
+    максимизированного окна.
-  * â  äãªæ¨ï ¨á¯®«ì§ã¥âáï â®«ìª® ¯à¨«®¦¥¨¥¬ @panel,
+  * Эта функция используется только приложением @panel,
-    ãáâ  ¢«¨¢ îé¨¬ à ¡®ç¥© ®¡« áâìî ¢¥áì íªà  §  ¢ëç¥â®¬ ¯ ¥«¨.
+    устанавливающим рабочей областью весь экран за вычетом панели.
-  * (left,top) - ª®®à¤¨ âë «¥¢®£® ¢¥àå¥£® ã£« ,
+  * (left,top) - координаты левого верхнего угла,
-    (right,bottom) - ª®®à¤¨ âë ¯à ¢®£® ¨¦¥£®.
+    (right,bottom) - координаты правого нижнего.
-     ª¨¬ ®¡à §®¬, à §¬¥à à ¡®ç¥© ®¡« áâ¨ ¯® ®á¨ x ®¯à¥¤¥«ï¥âáï
+    Таким образом, размер рабочей области по оси x определяется
-    ä®à¬ã«®© right-left+1, ¯® ®á¨ y - ä®à¬ã«®© bottom-right+1.
+    формулой right-left+1, по оси y - формулой bottom-right+1.
-  * á«¨ left>=right, â® x-ª®®à¤¨ âë à ¡®ç¥© ®¡« áâ¨ ¥ ¨§¬¥ïîâáï.
+  * Если left>=right, то x-координаты рабочей области не изменяются.
-    á«¨ left<0, â® left ¥ ãáâ  ¢«¨¢ ¥âáï. á«¨ right ¡®«ìè¥
+    Если left<0, то left не устанавливается. Если right больше
-    ¨«¨ à ¢® è¨à¨ë íªà  , â® right ¥ ãáâ  ¢«¨¢ ¥âáï.
+    или равно ширины экрана, то right не устанавливается.
-     «®£¨ç® ¯® ®á¨ y.
+    Аналогично по оси y.
-  * ¬®âà¨ â ª¦¥ äãªæ¨î 14,
+  * Смотри также функцию 14,
-    ¯®§¢®«ïîéãî ®¯à¥¤¥«¨âì à §¬¥àë ¢á¥£® íªà  .
+    позволяющую определить размеры всего экрана.
-  * áâì ¯ à ï äãªæ¨ï ¯®«ãç¥¨ï à ¡®ç¥© ®¡« áâ¨ -
+  * Есть парная функция получения рабочей области -
-    ¯®¤äãªæ¨ï 5.
+    подфункция 5.
-  * â  äãªæ¨ï  ¢â®¬ â¨ç¥áª¨ ¯¥à¥à¨á®¢ë¢ ¥â íªà , ¯® å®¤ã ¤¥«
+  * Эта функция автоматически перерисовывает экран, по ходу дела
-    ®¡®¢«ï¥â ª®®à¤¨ âë ¨ à §¬¥àë ¬ ªá¨¬¨§¨à®¢ ëå ®ª®.
+    обновляет координаты и размеры максимизированных окон.
-    á¥ ®ª  ¨§¢¥é îâáï ® ¥®¡å®¤¨¬®áâ¨ ¯¥à¥à¨á®¢ª¨ (á®¡ëâ¨¥ 1).
+    Все окна извещаются о необходимости перерисовки (событие 1).
 ======================================================================
-====================== ãªæ¨ï 48, ¯®¤äãªæ¨ï 7 ======================
+====================== Функция 48, подфункция 7 ======================
-============ ®«ãç¨âì ®¡« áâì áª¨  ¤«ï â¥ªáâ  § £®«®¢ª . ============
+============ Получить область скина для текста заголовка. ============
 ======================================================================
-®§¢à é ¥â ®¡« áâì § £®«®¢ª  ®ª  á® áª¨®¬, ¯à¥¤ § ç¥ãî
+Возвращает область заголовка окна со скином, предназначенную
-¤«ï ¢ë¢®¤  â¥ªáâ  § £®«®¢ª .
+для вывода текста заголовка.
- à ¬¥âàë:
+Параметры:
-  * eax = 48 - ®¬¥à äãªæ¨¨
+  * eax = 48 - номер функции
-  * ebx = 7 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 7 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
   * eax = [left]*65536 + [right]
   * ebx = [top]*65536 + [bottom]
- ¬¥ç ¨ï:
+Замечания:
-  * á¯®«ì§®¢ ¨¥/¥¨á¯®«ì§®¢ ¨¥ íâ®© äãªæ¨¨ -
+  * Использование/неиспользование этой функции -
-    «¨ç®¥ ¤¥«® ¯à¨«®¦¥¨ï.
+    личное дело приложения.
-  * ¥ª®¬¥¤ã¥âáï ãç¨âë¢ âì § ç¥¨ï, ¢®§¢à é ¥¬ë¥ íâ®© äãªæ¨¥©,
+  * Рекомендуется учитывать значения, возвращаемые этой функцией,
-    ¯à¨ ¢ë¡®à¥ ¬¥áâ  ¤«ï à¨á®¢ ¨ï â¥ªáâ  § £®«®¢ª  (äãªæ¨¥© 4) ¨«¨
+    при выборе места для рисования текста заголовка (функцией 4) или
-    ª ª®£®-¨¡ã¤ì § ¬¥¨â¥«ï â¥ªáâ  § £®«®¢ª
+    какого-нибудь заменителя текста заголовка
-    (¯® ãá¬®âà¥¨î ¯à¨«®¦¥¨ï).
+    (по усмотрению приложения).
 ======================================================================
-==== ãªæ¨ï 48, ¯®¤äãªæ¨ï 8 - ãáâ ®¢¨âì ¨á¯®«ì§ã¥¬ë© áª¨ ®ª®. ===
+==== Функция 48, подфункция 8 - установить используемый скин окон. ===
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 48 - ®¬¥à äãªæ¨¨
+  * eax = 48 - номер функции
-  * ebx = 8 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 8 - номер подфункции
-  * ecx = ãª § â¥«ì   ¨¬ï ä ©«  áª¨
+  * ecx = указатель на имя файла скина
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®
+  * eax = 0 - успешно
-  * eax = 1 - ¥ ã¤ «®áì § £àã§¨âì ä ©«
+  * eax = 1 - не удалось загрузить файл
-  * eax = 2 - ä ©« ¥ ï¢«ï¥âáï ä ©«®¬ áª¨
+  * eax = 2 - файл не является файлом скина
- ¬¥ç ¨ï:
+Замечания:
-  * à¨ ãá¯¥è®© § £àã§ª¥ áª¨  ¢á¥ ®ª  ¨§¢¥é îâáï ® ¥®¡å®¤¨¬®áâ¨
+  * При успешной загрузке скина все окна извещаются о необходимости
-    ¯¥à¥à¨á®¢ª¨ (á®¡ëâ¨¥ 1).
+    перерисовки (событие 1).
-  * à¨ § £àã§ª¥ á¨áâ¥¬  áç¨âë¢ ¥â áª¨ ¨§ ä ©«  default.skn
+  * При загрузке система считывает скин из файла default.skn
-      à ¬¤¨áª¥.
+    на рамдиске.
-  * ®«ì§®¢ â¥«ì ¬®¦¥â ¨§¬¥ïâì áª¨ áâ â¨ç¥áª¨, á®§¤ ¢ á¢®©
+  * Пользователь может изменять скин статически, создав свой
-    default.skn, ¨«¨ ¤¨ ¬¨ç¥áª¨ á ¯®¬®éìî ¯à¨«®¦¥¨ï desktop.
+    default.skn, или динамически с помощью приложения desktop.
 ======================================================================
-============ ãªæ¨ï 49 - Advanced Power Management (APM). ===========
+============ Функция 49 - Advanced Power Management (APM). ===========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 49 - ®¬¥à äãªæ¨¨
+  * eax = 49 - номер функции
-  * dx = ®¬¥à äãªæ¨¨ APM (  «®£ ax ¢ á¯¥æ¨ä¨ª æ¨¨)
+  * dx = номер функции APM (аналог ax в спецификации)
-  * bx, cx = ¯ à ¬¥âàë äãªæ¨¨ APM
+  * bx, cx = параметры функции APM
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * 16-¡¨âë¥ à¥£¨áâàë ax, bx, cx, dx, si, di ¨ ä« £ CF
+  * 16-битные регистры ax, bx, cx, dx, si, di и флаг CF
-    ãáâ ®¢«¥ë ¢ á®®â¢¥âáâ¢¨¨ á® á¯¥æ¨ä¨ª æ¨¥© APM
+    установлены в соответствии со спецификацией APM
-  * áâ àè¨¥ ¯®«®¢¨ë 32-¡¨âëå à¥£¨áâà®¢ eax, ebx, ecx,
+  * старшие половины 32-битных регистров eax, ebx, ecx,
-    edx, esi, edi à §àãè îâáï
+    edx, esi, edi разрушаются
- ¬¥ç ¨ï:
+Замечания:
-  * ¯¥æ¨ä¨ª æ¨ï APM 1.2 ®¯¨áë¢ ¥âáï ¢ ¤®ªã¬¥â¥
+  * Спецификация APM 1.2 описывается в документе
     "Advanced Power Management (APM) BIOS Specification"
-    (Revision 1.2), ¤®áâã¯®¬
+    (Revision 1.2), доступном на
     http://www.microsoft.com/whdc/archive/amp_12.mspx;
-    ªà®¬¥ â®£®, ®  ¢ª«îç¥  ¢ ¨§¢¥áâë© Interrupt List by Ralf Brown
+    кроме того, она включена в известный Interrupt List by Ralf Brown
     (http://www.pobox.com/~ralf/files.html,
     ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
 ======================================================================
-================= ãªæ¨ï 50 - ãáâ ®¢ª  ä®à¬ë ®ª . =================
+================= Функция 50 - установка формы окна. =================
 ======================================================================
-¡ëçë¥ ®ª  ¯à¥¤áâ ¢«ïîâ á®¡®© ¯àï¬®ã£®«ì¨ª¨.  ¯®¬®éìî íâ®© äãªæ¨¨
+Обычные окна представляют собой прямоугольники. С помощью этой функции
-®ªã ¬®¦® ¯à¨¤ âì ¯à®¨§¢®«ìãî ä®à¬ã. ®à¬  § ¤ ñâáï  ¡®à®¬ â®ç¥ª
+окну можно придать произвольную форму. Форма задаётся набором точек
-¢ãâà¨ ®¡à ¬«ïîé¥£® ¯àï¬®ã£®«ì¨ª , ¯à¨ ¤«¥¦ é¨å ®ªã. ®«®¦¥¨¥ ¨
+внутри обрамляющего прямоугольника, принадлежащих окну. Положение и
-à §¬¥àë ®¡à ¬«ïîé¥£® ¯àï¬®ã£®«ì¨ª  § ¤ îâáï äãªæ¨¥© 0 ¨ ¨§¬¥ïîâáï
+размеры обрамляющего прямоугольника задаются функцией 0 и изменяются
-äãªæ¨¥© 67.
+функцией 67.
---------------- áâ ®¢ª  ¤ ëå á ¨ä®à¬ æ¨¥© ® ä®à¬¥ ---------------
+--------------- Установка данных с информацией о форме ---------------
- à ¬¥âàë:
+Параметры:
-  * eax = 50 - ®¬¥à äãªæ¨¨
+  * eax = 50 - номер функции
-  * ebx = 0 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 0 - номер подфункции
-  * ecx = ãª § â¥«ì   ¤ ë¥ ä®à¬ë (¬ áá¨¢ ¡ ©â 0/1)
+  * ecx = указатель на данные формы (массив байт 0/1)
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
------------------- áâ ®¢ª  ¬ áèâ ¡  ¤ ëå ä®à¬ë -------------------
+------------------ Установка масштаба данных формы -------------------
- à ¬¥âàë:
+Параметры:
-  * eax = 50 - ®¬¥à äãªæ¨¨
+  * eax = 50 - номер функции
-  * ebx = 1 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 1 - номер подфункции
-  * ecx § ¤ ñâ ¬ áèâ ¡: ª ¦¤ë© ¡ ©â ¤ ëå ®¯à¥¤¥«ï¥â
+  * ecx задаёт масштаб: каждый байт данных определяет
-    (2^scale)*(2^scale) ¯¨ªá¥«¥©
+    (2^scale)*(2^scale) пикселей
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
- ¬¥ç ¨ï:
+Замечания:
-  *  áèâ ¡ ¯® ã¬®«ç ¨î à ¢¥ 0 (¬ áèâ ¡¨àãîé¨© ¬®¦¨â¥«ì 1). á«¨ ¢
+  * Масштаб по умолчанию равен 0 (масштабирующий множитель 1). Если в
-    ¤ ëå ä®à¬ë ®¤¨ ¡ ©â á®®â¢¥âáâ¢ã¥â ®¤®¬ã ¯¨ªá¥«î, â® ¬ áèâ ¡
+    данных формы один байт соответствует одному пикселю, то масштаб
-    ¬®¦® ¥ ãáâ  ¢«¨¢ âì.
+    можно не устанавливать.
-  * ¡®§ ç¨¬ xsize = è¨à¨  ®ª  (¢ ¯¨ªá¥«ïå), ysize = ¢ëá®â ;
+  * Обозначим xsize = ширина окна (в пикселях), ysize = высота;
-    ®¡à â¨â¥ ¢¨¬ ¨¥, çâ® ®¨   ¥¤¨¨æã ¡®«ìè¥, ç¥¬ ãáâ  ¢«¨¢ ¥¬ë¥
+    обратите внимание, что они на единицу больше, чем устанавливаемые
-    äãªæ¨ï¬¨ 0, 67.
+    функциями 0, 67.
-  * ® ®¯à¥¤¥«¥¨î ¬ áèâ ¡  xsize ¨ ysize ¤®«¦ë ¤¥«¨âìáï   2^scale.
+  * По определению масштаба xsize и ysize должны делиться на 2^scale.
-  *  ©â ¤ ëå ¯® á¬¥é¥¨î a ¤®«¦¥ ¡ëâì 0/1 ¨
+  * Байт данных по смещению a должен быть 0/1 и
-    ®¯à¥¤¥«ï¥â ¯à¨ ¤«¥¦®áâì ®ªã ª¢ ¤à â  á® áâ®à®®© 2^scale
+    определяет принадлежность окну квадрата со стороной 2^scale
-    (¯à¨ scale=0 ¯®«ãç ¥¬ ¯¨ªá¥«ì) ¨ ª®®à¤¨ â ¬¨ «¥¢®£® ¢¥àå¥£® ã£«
+    (при scale=0 получаем пиксель) и координатами левого верхнего угла
     (a mod (xsize shr scale), a div (xsize shr scale))
-  *  §¬¥à ¤ ëå: (xsize shr scale)*(ysize shr scale).
+  * Размер данных: (xsize shr scale)*(ysize shr scale).
-  *  ë¥ ¤®«¦ë ¯à¨áãâáâ¢®¢ âì ¢ ¯ ¬ïâ¨ ¨ ¥ ¬¥ïâìáï
+  * Данные должны присутствовать в памяти и не меняться
-    ¯®á«¥ ãáâ ®¢ª¨ ä®à¬ë.
+    после установки формы.
-  * ¨áâ¥¬  ¯à®á¬ âà¨¢ ¥â ¤ ë¥ ® ä®à¬¥ ¯à¨ ª ¦¤®© ¯¥à¥à¨á®¢ª¥ ®ª
+  * Система просматривает данные о форме при каждой перерисовке окна
-    äãªæ¨¥© 0.
+    функцией 0.
-  * ë§®¢ ¯®¤äãªæ¨¨ 0 á ã«¥¢ë¬ ãª § â¥«¥¬ ¯à¨¢®¤¨â ª ¢®§¢à âã
+  * Вызов подфункции 0 с нулевым указателем приводит к возврату
-    ª ¯àï¬®ã£®«ì®© ä®à¬¥.
+    к прямоугольной форме.
 ======================================================================
-===================== ãªæ¨ï 51 - á®§¤ âì ¯®â®ª. ====================
+===================== Функция 51 - создать поток. ====================
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 51 - ®¬¥à äãªæ¨¨
+  * eax = 51 - номер функции
-  * ebx = 1 - ¥¤¨áâ¢¥ ï ¯®¤äãªæ¨ï
+  * ebx = 1 - единственная подфункция
-  * ecx =  ¤à¥á â®çª¨ ¢å®¤  ¯®â®ª  ( ç «ìë© eip)
+  * ecx = адрес точки входа потока (начальный eip)
-  * edx = ãª § â¥«ì áâíª  ¯®â®ª  ( ç «ìë© esp)
+  * edx = указатель стэка потока (начальный esp)
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = -1 - ®è¨¡ª  (¢ á¨áâ¥¬¥ á«¨èª®¬ ¬®£® ¯®â®ª®¢)
+  * eax = -1 - ошибка (в системе слишком много потоков)
-  * ¨ ç¥ eax = TID - ¨¤¥â¨ä¨ª â®à ¯®â®ª
+  * иначе eax = TID - идентификатор потока
 ======================================================================
-= ãªæ¨ï 52, ¯®¤äãªæ¨ï 0 - ¯®«ãç¨âì ª®ä¨£ãà æ¨î á¥â¥¢®£® ¤à ©¢¥à .
+= Функция 52, подфункция 0 - получить конфигурацию сетевого драйвера.
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 52 - ®¬¥à äãªæ¨¨
+  * eax = 52 - номер функции
-  * ebx = 0 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 0 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = ¤¢®©®¥ á«®¢® ª®ä¨£ãà æ¨¨
+  * eax = двойное слово конфигурации
- ¬¥ç ¨ï:
+Замечания:
-  * «®¢® ª®ä¨£ãà æ¨¨ ¬®¦® ãáâ ®¢¨âì ¯®¤äãªæ¨¥© 2.
+  * Слово конфигурации можно установить подфункцией 2.
-  * ¤à® ¥ ¨á¯®«ì§ã¥â á®®â¢¥âáâ¢ãîéãî ¯¥à¥¬¥ãî.
+  * Ядро не использует соответствующую переменную.
-    ¥®áâì íâ®© ¯¥à¥¬¥®© ¨ à ¡®â îé¨å á ¥© ¯®¤äãªæ¨© 0 ¨ 2
+    Ценность этой переменной и работающих с ней подфункций 0 и 2
-    ¯à¥¤áâ ¢«ï¥âáï á®¬¨â¥«ì®©.
+    представляется сомнительной.
 ======================================================================
-======= ãªæ¨ï 52, ¯®¤äãªæ¨ï 1 - ¯®«ãç¨âì «®ª «ìë© IP- ¤à¥á. ======
+======= Функция 52, подфункция 1 - получить локальный IP-адрес. ======
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 52 - ®¬¥à äãªæ¨¨
+  * eax = 52 - номер функции
-  * ebx = 1 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 1 - номер подфункции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = IP- ¤à¥á (4 ¡ ©â )
+  * eax = IP-адрес (4 байта)
- ¬¥ç ¨ï:
+Замечания:
-  * ®ª «ìë© IP- ¤à¥á ãáâ  ¢«¨¢ ¥âáï ¯®¤äãªæ¨¥© 3.
+  * Локальный IP-адрес устанавливается подфункцией 3.
 ======================================================================
- ãªæ¨ï 52, ¯®¤äãªæ¨ï 2 - ãáâ ®¢¨âì ª®ä¨£ãà æ¨î á¥â¥¢®£® ¤à ©¢¥à .
+ Функция 52, подфункция 2 - установить конфигурацию сетевого драйвера.
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 52 - ®¬¥à äãªæ¨¨
+  * eax = 52 - номер функции
-  * ebx = 2 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 2 - номер подфункции
-  * ecx = ¤¢®©®¥ á«®¢® ª®ä¨£ãà æ¨¨; ¥á«¨ ¬« ¤è¨¥ 7 ¡¨â ®¡à §ãîâ
+  * ecx = двойное слово конфигурации; если младшие 7 бит образуют
-    ç¨á«® 3, íâ® ¢®á¯à¨¨¬ ¥âáï ª ª § ¯à®á   [¯¥à¥-]¨¨æ¨ «¨§ æ¨î
+    число 3, это воспринимается как запрос на [пере-]инициализацию
-    Ethernet-ª àâë, ¢ ¯à®â¨¢®¬ á«ãç ¥ Ethernet ¢ëª«îç ¥âáï
+    Ethernet-карты, в противном случае Ethernet выключается
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * ¥á«¨ ¥ § ¯à®è¥ Ethernet-¨â¥àä¥©á, â® ¢®§¢à é ¥âáï eax=2,
+  * если не запрошен Ethernet-интерфейс, то возвращается eax=2,
-    ® íâ® ¬®¦¥â ¨§¬¥¨âìáï ¢ ¡ã¤ãé¨å ¢¥àá¨ïå ï¤à
+    но это может измениться в будущих версиях ядра
-  * ¥á«¨ § ¯à®è¥ Ethernet-¨â¥àä¥©á, â® eax=0 ®§ ç ¥â ®è¨¡ªã
+  * если запрошен Ethernet-интерфейс, то eax=0 означает ошибку
-    (®âáãâáâ¢¨¥ Ethernet-ª àâë),   ¥ã«¥¢®¥ § ç¥¨¥ - ãá¯¥å
+    (отсутствие Ethernet-карты), а ненулевое значение - успех
- ¬¥ç ¨ï:
+Замечания:
-  * «®¢® ª®ä¨£ãà æ¨¨ ¬®¦® ¯à®ç¨â âì ¯®¤äãªæ¨¥© 0.
+  * Слово конфигурации можно прочитать подфункцией 0.
-  * ¤à® ¥ ¨á¯®«ì§ã¥â á®®â¢¥âáâ¢ãîéãî ¯¥à¥¬¥ãî.
+  * Ядро не использует соответствующую переменную.
-    ¥®áâì íâ®© ¯¥à¥¬¥®©, ¯®¤äãªæ¨¨ 0 ¨ ç áâ¨ ¯®¤äãªæ¨¨ 2,
+    Ценность этой переменной, подфункции 0 и части подфункции 2,
-    ãáâ  ¢«¨¢ îé¥© íâã ¯¥à¥¬¥ãî, ¯à¥¤áâ ¢«ï¥âáï á®¬¨â¥«ì®©.
+    устанавливающей эту переменную, представляется сомнительной.
 ======================================================================
-====== ãªæ¨ï 52, ¯®¤äãªæ¨ï 3 - ãáâ ®¢¨âì «®ª «ìë© IP- ¤à¥á. =====
+====== Функция 52, подфункция 3 - установить локальный IP-адрес. =====
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 52 - ®¬¥à äãªæ¨¨
+  * eax = 52 - номер функции
-  * ebx = 3 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 3 - номер подфункции
-  * ecx = IP- ¤à¥á (4 ¡ ©â )
+  * ecx = IP-адрес (4 байта)
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * â¥ªãé ï à¥ «¨§ æ¨ï ¢®§¢à é ¥â eax=3, ® íâ® ¬®¦¥â ¡ëâì ¨§¬¥¥®
+  * текущая реализация возвращает eax=3, но это может быть изменено
-    ¢ ¡ã¤ãé¨å ¢¥àá¨ïå
+    в будущих версиях
- ¬¥ç ¨ï:
+Замечания:
-  * ®ª «ìë© IP- ¤à¥á ¬®¦® ¯®«ãç¨âì ¯®¤äãªæ¨¥© 1.
+  * Локальный IP-адрес можно получить подфункцией 1.
 ======================================================================
-= ãªæ¨ï 52, ¯®¤äãªæ¨ï 6 - ¤®¡ ¢¨âì ¤ ë¥ ¢ áâ¥ª ¢å®¤®© ®ç¥à¥¤¨. =
+= Функция 52, подфункция 6 - добавить данные в стек входной очереди. =
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 52 - ®¬¥à äãªæ¨¨
+  * eax = 52 - номер функции
-  * ebx = 6 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 6 - номер подфункции
-  * edx = à §¬¥à ¤ ëå
+  * edx = размер данных
-  * esi = ãª § â¥«ì   ¤ ë¥
+  * esi = указатель на данные
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = -1 - ®è¨¡ª
+  * eax = -1 - ошибка
-  * eax = 0 - ãá¯¥è®
+  * eax = 0 - успешно
- ¬¥ç ¨ï:
+Замечания:
-  * â  äãªæ¨ï ¯à¥¤ § ç¥  â®«ìª® ¤«ï ¬¥¤«¥ëå á¥â¥¢ëå ¤à ©¢¥à®¢
+  * Эта функция предназначена только для медленных сетевых драйверов
     (PPP, SLIP).
-  *  §¬¥à ¤ ëå ¥ ¤®«¦¥ ¯à¥¢®áå®¤¨âì 1500 ¡ ©â,
+  * Размер данных не должен превосходить 1500 байт,
-    å®âï ¯à®¢¥à®ª ª®àà¥ªâ®áâ¨ ¥ ¤¥« ¥âáï.
+    хотя проверок корректности не делается.
 ======================================================================
-====================== ãªæ¨ï 52, ¯®¤äãªæ¨ï 8 ======================
+====================== Функция 52, подфункция 8 ======================
-============= à®ç¨â âì ¤ ë¥ ¨§ á¥â¥¢®© ®ç¥à¥¤¨ ¢ë¢®¤ . ============
+============= Прочитать данные из сетевой очереди вывода. ============
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 52 - ®¬¥à äãªæ¨¨
+  * eax = 52 - номер функции
-  * ebx = 8 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 8 - номер подфункции
-  * esi = ãª § â¥«ì   ¡ãä¥à à §¬¥à®¬ 1500 ¡ ©â
+  * esi = указатель на буфер размером 1500 байт
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
 ======================================================================
-====== ãªæ¨ï 53, ¯®¤äãªæ¨ï 6 - ¯®«ãç¨âì á®áâ®ï¨¥ TCP-á®ª¥â . =====
+====== Функция 53, подфункция 6 - получить состояние TCP-сокета. =====
 ======================================================================
- à ¬¥âàë:
+Параметры:
   * TCB_CLOSE_WAIT = 7
   * TCB_CLOSING = 8
   * TCB_LAST_ASK = 9
   * TCB_TIME_WAIT = 10
   * TCB_CLOSED = 11
-  * ebx à §àãè ¥âáï
+  * ebx разрушается
 ======================================================================
-========== ãªæ¨ï 53, ¯®¤äãªæ¨ï 7 - § ¯¨á âì ¢ TCP-á®ª¥â. ==========
+========== Функция 53, подфункция 7 - записать в TCP-сокет. ==========
-      ç áâ®â  ®¯à¥¤¥«ï¥âáï ª ª 1193180/divider
+      частота определяется как 1193180/divider
   * 0x81 = invalid
-  * 0x82..0xFF = ®â , ®¯à¥¤¥«ï¥¬ ï ®ªâ ¢®© ¨ ®¬¥à®¬:
+  * 0x82..0xFF = нота, определяемая октавой и номером:
-    * ¤«¨â¥«ì®áâì ¢ á®âëå ¤®«ïå á¥ªã¤ë = (¯¥à¢ë© ¡ ©â)-0x81
+    * длительность в сотых долях секунды = (первый байт)-0x81
-    * ¯à¨áãâáâ¢ã¥â ¥éñ ®¤¨ ¡ ©â;
+    * присутствует ещё один байт;
-    * (¢â®à®© ¡ ©â)=0xFF - ¯ ã§
+    * (второй байт)=0xFF - пауза
-    * ¨ ç¥ ® ¨¬¥¥â ¢¨¤ a*0x10+b, £¤¥ b=®¬¥à ®âë ¢ ®ªâ ¢¥ ®â 1
+    * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
-      ¤® 12, a=®¬¥à ®ªâ ¢ë (áç¨â ï á 0)
+      до 12, a=номер октавы (считая с 0)
- ¬¥ç ¨ï:
+Замечания:
-  * ¨é ¨¥ á¯¨ª¥à®¬ ¬®¦¥â ¡ëâì § ¯à¥é¥®/à §à¥è¥® ¯®¤äãªæ¨¥© 8
+  * Пищание спикером может быть запрещено/разрешено подфункцией 8
-    äãªæ¨¨ 18.
+    функции 18.
-  * ãªæ¨ï ¢®§¢à é ¥â ã¯à ¢«¥¨¥, á®®¡é¨¢ ªã¤  á«¥¤ã¥â ¨ä®à¬ æ¨î
+  * Функция возвращает управление, сообщив куда следует информацию
-    ® § ¯à®á¥.  ¬® ¯à®¨£àë¢ ¨¥ ¨¤ñâ ¥§ ¢¨á¨¬® ®â ¯à®£à ¬¬ë.
+    о запросе. Само проигрывание идёт независимо от программы.
-  *  ë¥ ¤®«¦ë á®åà ïâìáï ¢ ¯ ¬ïâ¨ ¯® ªà ©¥© ¬¥à¥
+  * Данные должны сохраняться в памяти по крайней мере
-    ¤® ª®æ  ¯à®¨£àë¢ ¨ï.
+    до конца проигрывания.
 ======================================================================
-======================= ãªæ¨ï 57 - PCI BIOS. =======================
+======================= Функция 57 - PCI BIOS. =======================
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 57 - ®¬¥à äãªæ¨¨
+  * eax = 57 - номер функции
-  * ebp á®®â¢¥âáâ¢ã¥â à¥£¨áâàã al ¢ á¯¥æ¨ä¨ª æ¨¨ PCI BIOS
+  * ebp соответствует регистру al в спецификации PCI BIOS
-  * ®áâ «ìë¥ à¥£¨áâàë - ¯® á¯¥æ¨ä¨ª æ¨¨ PCI BIOS
+  * остальные регистры - по спецификации PCI BIOS
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * CF ¥ ®¯à¥¤¥«ñ
+  * CF не определён
-  * ®áâ «ìë¥ à¥£¨áâàë - ¯® á¯¥æ¨ä¨ª æ¨¨ PCI BIOS
+  * остальные регистры - по спецификации PCI BIOS
- ¬¥ç ¨ï:
+Замечания:
-  * ®£¨å à¥§ã«ìâ â®¢ íâ®© äãªæ¨¨ ¬®¦® â ª¦¥ ¤®¡¨âìáï ¢ë§®¢®¬
+  * Многих результатов этой функции можно также добиться вызовом
-    á®®â¢¥âáâ¢ãîé¨å ¯®¤äãªæ¨© äãªæ¨¨ 62.
+    соответствующих подфункций функции 62.
-  * ãªæ¨ï ¢ë§ë¢ ¥â à áè¨à¥¨¥ PCI32 BIOS, ¤®ªã¬¥â¨à®¢ ®¥,
+  * Функция вызывает расширение PCI32 BIOS, документированное,
-     ¯à¨¬¥à, ¢ http://alpha1.dyns.net/files/PCI/bios21.pdf.
+    например, в http://alpha1.dyns.net/files/PCI/bios21.pdf.
-  * á«¨ BIOS ¥ ¯®¤¤¥à¦¨¢ ¥â íâ® à áè¨à¥¨¥, ¯®¢¥¤¥¨¥ äãªæ¨¨
+  * Если BIOS не поддерживает это расширение, поведение функции
-    í¬ã«¨àã¥âáï (ç¥à¥§   «®£¨ ¯®¤äãªæ¨© äãªæ¨¨ 62 à¥¦¨¬  ï¤à ).
+    эмулируется (через аналоги подфункций функции 62 режима ядра).
 ======================================================================
-============== ãªæ¨ï 58 - à ¡®â  á ä ©«®¢®© á¨áâ¥¬®©. ==============
+============== Функция 58 - работа с файловой системой. ==============
 ======================================================================
- à ¬¥âàë:
+Параметры:
   * eax = 58
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®; ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно; иначе код ошибки файловой системы
-  * ¢ § ¢¨á¨¬®áâ¨ ®â ¯®¤äãªæ¨¨ ¬®¦¥â ¢®§¢à é âìáï § ç¥¨¥ ¨
+  * в зависимости от подфункции может возвращаться значение и
-    ¢ ¤àã£¨å à¥£¨áâà å
+    в других регистрах
-¡é¨© ä®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Общий формат информационной структуры:
-  * +0: dword: ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: номер подфункции
-  * +4: dword: ®¬¥à ¡«®ª
+  * +4: dword: номер блока
-  * +8: dword: à §¬¥à
+  * +8: dword: размер
-  * +12 = +0xC: dword: ãª § â¥«ì   ¤ ë¥
+  * +12 = +0xC: dword: указатель на данные
-  * +16 = +0x10: dword: ãª § â¥«ì   ¯ ¬ïâì ¤«ï à ¡®âë á¨áâ¥¬ë
+  * +16 = +0x10: dword: указатель на память для работы системы
-    (4096 ¡ ©â)
+    (4096 байт)
-  * +20 = +0x14: n db: ASCIIZ-áâà®ª  á ¨¬¥¥¬ ä ©«
+  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
-â®ç¥¨ï - ¢ ¤®ªã¬¥â æ¨¨   á®®â¢¥âáâ¢ãîéãî ¯®¤äãªæ¨î.
+Уточнения - в документации на соответствующую подфункцию.
-¬ï ä ©«  ¥çã¢áâ¢¨â¥«ì® ª à¥£¨áâàã « â¨áª¨å ¡ãª¢,
+Имя файла нечувствительно к регистру латинских букв,
-àãááª¨¥ ¡ãª¢ë ¤®«¦ë ¡ëâì § £« ¢ë¬¨.
+русские буквы должны быть заглавными.
-®à¬ â ¨¬¥¨ ä ©« :
+Формат имени файла:
 /base/number/dir1/dir2/.../dirn/file,
-£¤¥ /base/number ¨¤¥â¨ä¨æ¨àã¥â ãáâà®©áâ¢®,   ª®â®à®¬ ¨é¥âáï ä ©«:
+где /base/number идентифицирует устройство, на котором ищется файл:
-®¤® ¨§
+одно из
-  * /RD/1 = /RAMDISK/1 ¤«ï ¤®áâã¯  ª à ¬¤¨áªã
+  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
-  * /FD/1 = /FLOPPYDISK/1 ¤«ï ¤®áâã¯  ª ¯¥à¢®¬ã ä«®¯¯¨-¤¨áª®¢®¤ã,
+  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
-    /FD/2 = /FLOPPYDISK/2 ¤«ï ¢â®à®£® ä«®¯¯¨-¤¨áª®¢®¤
+    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
-  * /HD/x = /HARDDISK/x - ãáâ à¥¢è¨© ¢ à¨ â ¤®áâã¯  ª ¦ñáâª®¬ã ¤¨áªã
+  * /HD/x = /HARDDISK/x - устаревший вариант доступа к жёсткому диску
-    (¢ íâ®¬ á«ãç ¥ ¡ §  ®¯à¥¤¥«ï¥âáï ¯®¤äãªæ¨¥© 7 äãªæ¨¨ 21),
+    (в этом случае база определяется подфункцией 7 функции 21),
-    x - ®¬¥à à §¤¥«  (áç¨â ï á 1)
+    x - номер раздела (считая с 1)
-  * /HD0/x, /HD1/x, /HD2/x, /HD3/x ¤«ï ¤®áâã¯  á®®â¢¥âáâ¢¥®
+  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
-    ª ãáâà®©áâ¢ ¬ IDE0 (Primary Master), IDE1 (Primary Slave),
+    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
     IDE2 (Secondary Master), IDE3 (Secondary Slave);
-    x - ®¬¥à à §¤¥«    ¢ë¡à ®¬ ¢¨ç¥áâ¥à¥, ¨§¬¥ï¥âáï ®â 1 ¤® 255
+    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
-    (  ª ¦¤®¬ ¨§ ¢¨ç¥áâ¥à®¢ ã¬¥à æ¨ï  ç¨ ¥âáï á 1)
+    (на каждом из винчестеров нумерация начинается с 1)
- ¬¥ç ¨ï:
+Замечания:
-  *  ¯¥à¢ëå ¤¢ãå á«ãç ïå ¤®¯ãáª ¥âáï ¨á¯®«ì§®¢ ¨¥ FIRST ¢¬¥áâ® 1,
+  * В первых двух случаях допускается использование FIRST вместо 1,
-    SECOND ¢¬¥áâ® 2, ® ¨á¯®«ì§®¢ âì íâã ¢®§¬®¦®áâì
+    SECOND вместо 2, но использовать эту возможность
-    ¥ à¥ª®¬¥¤ã¥âáï ¤«ï ã¤®¡áâ¢  ¯¥à¥å®¤    ¡ã¤ãé¨¥ à áè¨à¥¨ï.
+    не рекомендуется для удобства перехода на будущие расширения.
-  *  ª« ¤ë¢ ¥âáï ®£à ¨ç¥¨¥ n<=39.
+  * Накладывается ограничение n<=39.
-  * ¬¥  ¯ ¯®ª ¨ ä ©«  dir1,...,dirn,file ¤®«¦ë ¡ëâì ¢ ä®à¬ â¥ 8.3:
+  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
-    ¨¬ï ¥ ¡®«¥¥ 8 á¨¬¢®«®¢, â®çª , à áè¨à¥¨¥ ¥ ¡®«¥¥ 3 á¨¬¢®«®¢.
+    имя не более 8 символов, точка, расширение не более 3 символов.
-    ¢®áâ®¢ë¥ ¯à®¡¥«ë ¨£®à¨àãîâáï. àã£¨å ¯à®¡¥«®¢ ¡ëâì ¥ ¤®«¦®.
+    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
-    á«¨ ¨¬ï § ¨¬ ¥â à®¢® 8 á¨¬¢®«®¢, â®çªã ¬®¦® ®¯ãáâ¨âì
+    Если имя занимает ровно 8 символов, точку можно опустить
-    (å®âï ¯®«ì§®¢ âìáï íâ¨¬ ¥ à¥ª®¬¥¤ã¥âáï ¤«ï ã¤®¡áâ¢  ¯¥à¥å®¤
+    (хотя пользоваться этим не рекомендуется для удобства перехода
-      ¡ã¤ãé¨¥ à áè¨à¥¨ï).
+    на будущие расширения).
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥â ¯ ¯®ª   à ¬¤¨áª¥.
+  * Функция не поддерживает папок на рамдиске.
-à¨¬¥àë:
+Примеры:
   * '/RAMDISK/FIRST/KERNEL.ASM',0
     '/rd/1/kernel.asm',0
   * '/HD0/1/kernel.asm',0
   * '/hd0/1/menuet/pics/tanzania.bmp',0
-®áâã¯ë¥ ¯®¤äãªæ¨¨:
+Доступные подфункции:
-  * ¯®¤äãªæ¨ï 0 - çâ¥¨¥ ä ©« /¯ ¯ª¨
+  * подфункция 0 - чтение файла/папки
-  * ¯®¤äãªæ¨ï 8 - LBA-çâ¥¨¥ á ãáâà®©áâ¢
+  * подфункция 8 - LBA-чтение с устройства
-  * ¯®¤äãªæ¨ï 15 - ¯®«ãç¥¨¥ ¨ä®à¬ æ¨¨ ® ä ©«®¢®© á¨áâ¥¬¥
+  * подфункция 15 - получение информации о файловой системе
 ======================================================================
-========== ãªæ¨ï 58, ¯®¤äãªæ¨ï 0 - ¯à®ç¨â âì ä ©«/¯ ¯ªã. ==========
+========== Функция 58, подфункция 0 - прочитать файл/папку. ==========
 ======================================================================
- à ¬¥âàë:
+Параметры:
   * eax = 58
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 0 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 0 = номер подфункции
-  * +4: dword: ®¬¥à ¡«®ª  ¤«ï çâ¥¨ï (áç¨â ï á 0)
+  * +4: dword: номер блока для чтения (считая с 0)
-  * +8: dword: ç¨á«® ¡«®ª®¢ ¤«ï çâ¥¨ï
+  * +8: dword: число блоков для чтения
-  * +12 = +0xC: dword: ãª § â¥«ì   ¡ãä¥à, ªã¤  ¡ã¤ãâ § ¯¨á ë ¤ ë¥
+  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
-  * +16 = +0x10: dword: ãª § â¥«ì   ¡ãä¥à ¤«ï à ¡®âë á¨áâ¥¬ë
+  * +16 = +0x10: dword: указатель на буфер для работы системы
-    (4096 ¡ ©â)
+    (4096 байт)
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx = à §¬¥à ä ©«  (¢ ¡ ©â å) ¨«¨
+  * ebx = размер файла (в байтах) или
-    -1=0xffffffff, ¥á«¨ ä ©« ¥  ©¤¥
+    -1=0xffffffff, если файл не найден
- ¬¥ç ¨ï:
+Замечания:
-  *  §¬¥à ¡«®ª  - 512 ¡ ©â.
+  * Размер блока - 512 байт.
-  * â  äãªæ¨ï ãáâ à¥« , ¤«ï çâ¥¨ï ä ©«®¢ ¨á¯®«ì§ã©â¥ ¯®¤äãªæ¨î 0
+  * Эта функция устарела, для чтения файлов используйте подфункцию 0
-    äãªæ¨¨ 70, ¤«ï çâ¥¨ï ¯ ¯®ª - ¯®¤äãªæ¨î 1 äãªæ¨¨ 70.
+    функции 70, для чтения папок - подфункцию 1 функции 70.
-  * ãªæ¨ï ¯®§¢®«ï¥â ç¨â âì á®¤¥à¦¨¬®¥ ¯ ¯ª¨. § ä ©«®¢ëå á¨áâ¥¬
+  * Функция позволяет читать содержимое папки. Из файловых систем
-    ¯®¤¤¥à¦¨¢ ¥âáï â®«ìª® FAT. ®à¬ â FAT-¯ ¯ª¨ ®¯¨á  ¢ «î¡®©
+    поддерживается только FAT. Формат FAT-папки описан в любой
-    ¤®ªã¬¥â æ¨¨ ¯® FAT.
+    документации по FAT.
-  *  §¬¥à ¯ ¯ª¨ ®¯à¥¤¥«ï¥âáï ¯® à §¬¥àã æ¥¯®çª¨ ª« áâ¥à®¢ ¢ FAT.
+  * Размер папки определяется по размеру цепочки кластеров в FAT.
-  * á«¨ ä ©« ª®ç¨«áï à ìè¥, ç¥¬ ¡ë« ¯à®ç¨â  ¯®á«¥¤¨© § ¯à®è¥ë©
+  * Если файл кончился раньше, чем был прочитан последний запрошенный
-    ¡«®ª, â® äãªæ¨ï ¯à®ç¨â ¥â, áª®«ìª® á¬®¦¥â, ¯®á«¥ ç¥£® ¢¥àñâ
+    блок, то функция прочитает, сколько сможет, после чего вернёт
     eax=6 (EOF).
-  * ãªæ¨ï ¯®§¢®«ï¥â ç¨â âì ª®à¥¢ë¥ ¯ ¯ª¨ /rd/1,/fd/x,/hd[n]/x, ®
+  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
-    ¢ ¯¥à¢ëå ¤¢ãå á«ãç ïå â¥ªãé ï à¥ «¨§ æ¨ï ¥ á«¥¤ã¥â
+    в первых двух случаях текущая реализация не следует
-    ãáâ ®¢«¥ë¬ ¯à ¢¨« ¬:
+    установленным правилам:
-    ¤«ï /rd/1:
+    для /rd/1:
-    * ¥á«¨ ãª § ® 0 ¡«®ª®¢ ¤«ï çâ¥¨ï, áç¨â ¥âáï,
+    * если указано 0 блоков для чтения, считается,
-      çâ® § ¯à è¨¢ ¥âáï 1;
+      что запрашивается 1;
-    * ¥á«¨ § ¯à è¨¢ ¥âáï ¡®«ìè¥ 14 ¡«®ª®¢ ¨«¨  ç «ìë© ¡«®ª
+    * если запрашивается больше 14 блоков или начальный блок
-      ¥ ¬¥ìè¥ 14-£®, â® ¢®§¢à é ¥âáï eax=5 (not found) ¨ ebx=-1;
+      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
-    * à §¬¥à ª®à¥¢®£® ª â «®£  à ¬¤¨áª  = 14 ¡«®ª®¢,
+    * размер корневого каталога рамдиска = 14 блоков,
-x1C00=7168 ¡ ©â; ® ¢®§¢à é ¥âáï ebx=0
+x1C00=7168 байт; но возвращается ebx=0
-      (§  ¨áª«îç¥¨¥¬ á«ãç ï ¯à¥¤ë¤ãé¥£® ¯ãªâ );
+      (за исключением случая предыдущего пункта);
-    * ª ª ¨ áâà ®, ¬®¦® ¯à®ç¨â âì 14-© ¡«®ª (â ¬, ¢®®¡é¥ £®¢®àï,
+    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
-      ¬ãá®à -  ¯®¬¨ î, áçñâ ¢¥¤ñâáï á 0);
+      мусор - напоминаю, счёт ведётся с 0);
-    * ¥á«¨ ¡ë« § ¯à®è¥ å®âï ¡ë ®¤¨ ¡«®ª á ®¬¥à®¬, ¥ ¬¥ìè¨¬ 14,
+    * если был запрошен хотя бы один блок с номером, не меньшим 14,
-      â® ¢®§¢à é ¥âáï eax=6(EOF); ¨ ç¥ eax=0.
+      то возвращается eax=6(EOF); иначе eax=0.
-    «ï /fd/x:
+    Для /fd/x:
-    * ¥á«¨  ç «ìë© ¡«®ª ¥ ¬¥ìè¥ 14-£®, â® ¢®§¢à é ¥âáï
+    * если начальный блок не меньше 14-го, то возвращается
-      eax=5 (not found) ¨ ebx=0;
+      eax=5 (not found) и ebx=0;
-    * ªáâ â¨ £®¢®àï, ä®à¬ â FAT12 ¤®¯ãáª ¥â ¤¨áª¥âë á à §¬¥à®¬
+    * кстати говоря, формат FAT12 допускает дискеты с размером
-      ª®à¥¢®£® ª â «®£  ¬¥ìè¥ ¨«¨ ¡®«ìè¥ 14 ¡«®ª®¢;
+      корневого каталога меньше или больше 14 блоков;
-    * ¯à®¢¥àª¨ ¤«¨ë ¥ ¤¥« ¥âáï;
+    * проверки длины не делается;
-    * ¥á«¨ ã¤ «®áì ¯à®ç¨â âì ¤ ë¥ á ¤¨áª¥âë, ¢®§¢à é ¥âáï
+    * если удалось прочитать данные с дискеты, возвращается
-      eax=0,ebx=0; ¢ ¯à®â¨¢®¬ á«ãç ¥ eax=10 (access denied), ebx=-1.
+      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
-  * ãªæ¨ï ®¡à ¡ âë¢ ¥â çâ¥¨¥ á¯¥æ¨ «ìëå ¯ ¯®ª /,/rd,/fd,/hd[n];
+  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
-    ® à¥§ã«ìâ â ¥ á®®â¢¥âáâ¢ã¥â ®¦¨¤ ¥¬®¬ã
+    но результат не соответствует ожидаемому
-    (¯® à ¡®â¥ á ®¡ëçë¬¨ ä ©« ¬¨/¯ ¯ª ¬¨), ¥ á«¥¤ã¥â ãáâ ®¢«¥ë¬
+    (по работе с обычными файлами/папками), не следует установленным
-    ¯à ¢¨« ¬, ¬®¦¥â ¨§¬¥¨âìáï ¢ á«¥¤ãîé¨å ¢¥àá¨ïå ï¤à  ¨ ¯®â®¬ã
+    правилам, может измениться в следующих версиях ядра и потому
-    ¥ ®¯¨áë¢ ¥âáï. «ï ¯®«ãç¥¨ï ¨ä®à¬ æ¨¨ ®¡ ®¡®àã¤®¢ ¨¨
+    не описывается. Для получения информации об оборудовании
-    ¨á¯®«ì§ã©â¥ ¯®¤äãªæ¨î 11 äãªæ¨¨ 18 ¨«¨
+    используйте подфункцию 11 функции 18 или
-    ç¨â ©â¥ á®®â¢¥âáâ¢ãîé¨¥ ¯ ¯ª¨ ¯®¤äãªæ¨¥© 1 äãªæ¨¨ 70.
+    читайте соответствующие папки подфункцией 1 функции 70.
 ======================================================================
-========= ãªæ¨ï 58, ¯®¤äãªæ¨ï 8 - LBA-çâ¥¨¥ á ãáâà®©áâ¢ . ========
+========= Функция 58, подфункция 8 - LBA-чтение с устройства. ========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 58 - ®¬¥à äãªæ¨¨
+  * eax = 58 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 8 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 8 = номер подфункции
-  * +4: dword: ®¬¥à ¡«®ª  ¤«ï çâ¥¨ï (áç¨â ï á 0)
+  * +4: dword: номер блока для чтения (считая с 0)
-  * +8: dword: ¨£®à¨àã¥âáï (ãáâ  ¢«¨¢ ©â¥ ¢ 1)
+  * +8: dword: игнорируется (устанавливайте в 1)
-  * +12 = +0xC: dword: ãª § â¥«ì   ¡ãä¥à, ªã¤  ¡ã¤ãâ § ¯¨á ë ¤ ë¥
+  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
-    (512 ¡ ©â)
+    (512 байт)
-  * +16 = +0x10: dword: ãª § â¥«ì   ¡ãä¥à ¤«ï à ¡®âë á¨áâ¥¬ë
+  * +16 = +0x10: dword: указатель на буфер для работы системы
-    (4096 ¡ ©â)
+    (4096 байт)
-  * +20 = +0x14: ASCIIZ-¨¬ï ãáâà®©áâ¢ : ¥çã¢áâ¢¨â¥«ì® ª à¥£¨áâàã,
+  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
-    ®¤® ¨§ /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
+    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
-<=n<=4 - ®¬¥à ãáâà®©áâ¢ : 1=IDE0, ..., 4=IDE3.
+<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
-    ¬¥áâ® æ¨äà ¤®¯ãáª ¥âáï, å®âï ¨ ¥ à¥ª®¬¥¤ã¥âáï ¤«ï ã¤®¡áâ¢
+    Вместо цифр допускается, хотя и не рекомендуется для удобства
-    ¯¥à¥å®¤    ¡ã¤ãé¨¥ à áè¨à¥¨ï,
+    перехода на будущие расширения,
-    ¨á¯®«ì§®¢ ¨¥ 'first','second','third','fourth'.
+    использование 'first','second','third','fourth'.
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * ¥á«¨ ãª § ® ¨¬ï ãáâà®©áâ¢  /hd/xxx, £¤¥ xxx ¥  å®¤¨âáï
+  * если указано имя устройства /hd/xxx, где xxx не находится
-    ¢ á¯¨áª¥ ¢ëè¥:
+    в списке выше:
     * eax = ebx = 1
-  * ¥á«¨ ãª § ® ¥¯à ¢¨«ì®¥ ¨¬ï ãáâà®©áâ¢
+  * если указано неправильное имя устройства
-    (§  ¨áª«îç¥¨¥¬ ¯à¥¤ë¤ãé¥£® á«ãç ï):
+    (за исключением предыдущего случая):
     * eax = 5
-    * ebx ¥ ¬¥ï¥âáï
+    * ebx не меняется
-  * ¥á«¨ LBA-¤®áâã¯ § ¯à¥éñ ¯®¤äãªæ¨¥© 11 äãªæ¨¨ 21:
+  * если LBA-доступ запрещён подфункцией 11 функции 21:
     * eax = 2
-    * ebx à §àãè ¥âáï
+    * ebx разрушается
-  * ¤«ï à ¬¤¨áª : ¯®¯ëâª  çâ¥¨ï ¡«®ª  §  ¯à¥¤¥« ¬¨ à ¬¤¨áª
+  * для рамдиска: попытка чтения блока за пределами рамдиска
-    (18*2*80 ¡«®ª®¢) ¯à¨¢®¤¨â ª
+    (18*2*80 блоков) приводит к
     * eax = 3
     * ebx = 0
-  * ¯à¨ ãá¯¥è®¬ çâ¥¨¨:
+  * при успешном чтении:
     * eax = ebx = 0
- ¬¥ç ¨ï:
+Замечания:
-  *  §¬¥à ¡«®ª  - 512 ¡ ©â; ç¨â ¥âáï ®¤¨ ¡«®ª.
+  * Размер блока - 512 байт; читается один блок.
-  * ¥ á«¥¤ã¥â ¯®« £ âìáï   ¢®§¢à é ¥¬®¥ § ç¥¨¥,
+  * Не следует полагаться на возвращаемое значение,
-    ®® ¬®¦¥â ¨§¬¥¨âìáï ¢ á«¥¤ãîé¨å ¢¥àá¨ïå.
+    оно может измениться в следующих версиях.
-  * à¥¡ã¥âáï, çâ®¡ë ¡ë« à §à¥èñ LBA-¤®áâã¯ ª ãáâà®©áâ¢ ¬
+  * Требуется, чтобы был разрешён LBA-доступ к устройствам
-    ¯®¤äãªæ¨¥© 11 äãªæ¨¨ 21. § âì íâ® ¬®¦® ¢ë§®¢®¬
+    подфункцией 11 функции 21. Узнать это можно вызовом
-    ¯®¤äãªæ¨¥© 11 äãªæ¨¨ 26.
+    подфункцией 11 функции 26.
-  * LBA-çâ¥¨¥ ¤¨áª¥âë ¥ ¯®¤¤¥à¦¨¢ ¥âáï.
+  * LBA-чтение дискеты не поддерживается.
-  * ãªæ¨ï áç¨âë¢ ¥â ¤ ë¥ ä¨§¨ç¥áª®£® ¦ñáâª®£® ¤¨áª ;
+  * Функция считывает данные физического жёсткого диска;
-    ¥á«¨ ¯® ª ª¨¬-â® ¯à¨ç¨ ¬ ã¦ë ¤ ë¥ ª®ªà¥â®£® à §¤¥« ,
+    если по каким-то причинам нужны данные конкретного раздела,
-    ¯à¨¤ñâáï ®¯à¥¤¥«ïâì  ç «ìë© á¥ªâ®à íâ®£® à §¤¥«
+    придётся определять начальный сектор этого раздела
-    («¨¡®  ¯àï¬ãî ç¥à¥§ MBR, «¨¡® ¨§ à áè¨à¥®© áâàãªâãàë,
+    (либо напрямую через MBR, либо из расширенной структуры,
-    ¢®§¢à é ¥¬®© â®© ¦¥ ¯®¤äãªæ¨¥© 11 äãªæ¨¨ 18).
+    возвращаемой той же подфункцией 11 функции 18).
-  * ãªæ¨ï ¥ ¯à®¢¥àï¥â ª®¤ ®è¨¡ª¨ ¦ñáâª®£® ¤¨áª , â ª çâ® § ¯à®á
+  * Функция не проверяет код ошибки жёсткого диска, так что запрос
-    ¥áãé¥áâ¢ãîé¥£® á¥ªâ®à  ¢áñ à ¢® çâ®-â® ¯à®ç¨â ¥â
+    несуществующего сектора всё равно что-то прочитает
-    (¢¥à®ïâ¥¥ ¢á¥£®, ã«¨, ® íâ® ®¯à¥¤¥«ï¥âáï ãáâà®©áâ¢®¬) ¨
+    (вероятнее всего, нули, но это определяется устройством) и
-    íâ® ¡ã¤¥â áç¨â âìáï ãá¯¥å®¬ (eax=0).
+    это будет считаться успехом (eax=0).
 ======================================================================
-= ãªæ¨ï 58, ¯®¤äãªæ¨ï 15 - ¯®«ãç¨âì ¨ä®à¬ æ¨î ® ä ©«®¢®© á¨áâ¥¬¥.
+= Функция 58, подфункция 15 - получить информацию о файловой системе.
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 58 - ®¬¥à äãªæ¨¨
+  * eax = 58 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 15 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 15 = номер подфункции
-  * +4: dword: ¨£®à¨àã¥âáï
+  * +4: dword: игнорируется
-  * +8: dword: ¨£®à¨àã¥âáï
+  * +8: dword: игнорируется
-  * +12 = +0xC: dword: ¨£®à¨àã¥âáï
+  * +12 = +0xC: dword: игнорируется
-  * +16 = +0x10: dword: ¨£®à¨àã¥âáï
+  * +16 = +0x10: dword: игнорируется
-  * +20 = +0x14: (¯à®¢¥àï¥âáï â®«ìª® ¢â®à®© á¨¬¢®«, áà §ã ¯®á«¥ á«íè )
+  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
-    /rd=/RAMDISK ¨«¨ /hd=/HARDDISK
+    /rd=/RAMDISK или /hd=/HARDDISK
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * ¥á«¨ ¢â®à®© á¨¬¢®« ¥ ¯à¨ ¤«¥¦¨â ¬®¦¥áâ¢ã {'r','R','h','H'}:
+  * если второй символ не принадлежит множеству {'r','R','h','H'}:
     * eax = 3
     * ebx = ecx = dword [fileinfo] = 0
-  * ¤«ï à ¬¤¨áª :
+  * для рамдиска:
-    * eax = 0 (ãá¯¥å)
+    * eax = 0 (успех)
-    * ebx = ®¡é¥¥ ç¨á«® ª« áâ¥à®¢ = 2847
+    * ebx = общее число кластеров = 2847
-    * ecx = ç¨á«® á¢®¡®¤ëå ª« áâ¥à®¢
+    * ecx = число свободных кластеров
-    * dword [fileinfo] = à §¬¥à ª« áâ¥à  = 512
+    * dword [fileinfo] = размер кластера = 512
-  * ¤«ï ¦ñáâª®£® ¤¨áª : ¡ §  ¨ à §¤¥« ®¯à¥¤¥«ïîâáï ¯®¤äãªæ¨ï¬¨ 7 ¨ 8
+  * для жёсткого диска: база и раздел определяются подфункциями 7 и 8
-    äãªæ¨¨ 21:
+    функции 21:
-    * eax = 0 (ãá¯¥å)
+    * eax = 0 (успех)
-    * ebx = ®¡é¥¥ ç¨á«® ª« áâ¥à®¢
+    * ebx = общее число кластеров
-    * ecx = ç¨á«® á¢®¡®¤ëå ª« áâ¥à®¢
+    * ecx = число свободных кластеров
-    * dword [fileinfo] = à §¬¥à ª« áâ¥à  (¢ ¡ ©â å)
+    * dword [fileinfo] = размер кластера (в байтах)
- ¬¥ç ¨ï:
+Замечания:
-  * ¥ ã¤¨¢«ï©â¥áì áâà ®¬ã à á¯®«®¦¥¨î 4-£® ¢®§¢à é ¥¬®£®
+  * Не удивляйтесь странному расположению 4-го возвращаемого
-    ¯ à ¬¥âà  - ª®£¤  ¯¨á «áï íâ®â ª®¤, ¯à¨ á¨áâ¥¬ëå ¢ë§®¢ å
+    параметра - когда писался этот код, при системных вызовах
-    ¯à¨«®¦¥¨î ¢®§¢à é «¨áì â®«ìª® à¥£¨áâàë eax,ebx,ecx (¨§
+    приложению возвращались только регистры eax,ebx,ecx (из
-    pushad-áâàãªâãàë, ¯¥à¥¤ îé¥©áï ª ª  à£ã¬¥â á¨áâ¥¬®© äãªæ¨¨).
+    pushad-структуры, передающейся как аргумент системной функции).
-    ¥¯¥àì íâ® ¨á¯à ¢«¥®, â ª çâ®, ¢®§¬®¦®, ¨¬¥¥â á¬ëá« ¢®§¢à é âì
+    Теперь это исправлено, так что, возможно, имеет смысл возвращать
-    à §¬¥à ª« áâ¥à  ¢ edx, ¯®ª  íâã äãªæ¨î ¥  ç «¨ ¨á¯®«ì§®¢ âì.
+    размер кластера в edx, пока эту функцию не начали использовать.
-  * ®®¡é¥-â® ¥éñ áãé¥áâ¢ã¥â ¯®¤äãªæ¨ï 11 äãªæ¨¨ 18, ¢®§¢à é îé ï
+  * Вообще-то ещё существует подфункция 11 функции 18, возвращающая
-    ¨ä®à¬ æ¨î ® ä ©«®¢®© á¨áâ¥¬¥. ® à áè¨à¥®© â ¡«¨æ¥ ¤¨áª®¢®©
+    информацию о файловой системе. По расширенной таблице дисковой
-    ¯®¤á¨áâ¥¬ë ¬®¦® ®¯à¥¤¥«¨âì à §¬¥à ª« áâ¥à  (â ¬ ® åà ¨âáï
+    подсистемы можно определить размер кластера (там он хранится
-    ¢ á¥ªâ®à å) ¨ ®¡é¥¥ ç¨á«® ª« áâ¥à®¢ ¤«ï ¦ñáâª¨å ¤¨áª®¢.
+    в секторах) и общее число кластеров для жёстких дисков.
 ======================================================================
-=========== ãªæ¨ï 60 - Inter Process Communication (IPC). ==========
+=========== Функция 60 - Inter Process Communication (IPC). ==========
 ======================================================================
-IPC ¯à¨¬¥ï¥âáï ¤«ï ¯®áë«®ª á®®¡é¥¨© ®â ®¤®£® ¯à®æ¥áá /¯®â®ª
+IPC применяется для посылок сообщений от одного процесса/потока
-¤àã£®¬ã. à¨ íâ®¬ á«¥¤ã¥â ¯à¥¤¢ à¨â¥«ì® ¤®£®¢®à¨âìáï ® â®¬, ª ª
+другому. При этом следует предварительно договориться о том, как
-¨â¥à¯à¥â¨à®¢ âì ª®ªà¥â®¥ á®®¡é¥¨¥.
+интерпретировать конкретное сообщение.
--------- ®¤äãªæ¨ï 1 - ãáâ ®¢¨âì ®¡« áâì ¤«ï ¯®«ãç¥¨ï IPC ---------
+-------- Подфункция 1 - установить область для получения IPC ---------
-ë§ë¢ ¥âáï ¯à®æ¥áá®¬-¯à¨ñ¬¨ª®¬.
+Вызывается процессом-приёмником.
- à ¬¥âàë:
+Параметры:
-  * eax = 60 - ®¬¥à äãªæ¨¨
+  * eax = 60 - номер функции
-  * ebx = 1 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 1 - номер подфункции
-  * ecx = ãª § â¥«ì   ¡ãä¥à
+  * ecx = указатель на буфер
-  * edx = à §¬¥à ¡ãä¥à
+  * edx = размер буфера
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ¢á¥£¤  ãá¯¥è®
+  * eax = 0 - всегда успешно
-®à¬ â IPC-¡ãä¥à :
+Формат IPC-буфера:
-  * +0: dword: ¥á«¨ §¤¥áì ¥ 0, â® ¡ãä¥à áç¨â ¥âáï § ¡«®ª¨à®¢ ë¬;
+  * +0: dword: если здесь не 0, то буфер считается заблокированным;
-    ¡«®ª¨àã©â¥/à §¡«®ª¨àã©â¥ ¡ãä¥à, ª®£¤  ¢ë á ¨¬  ªâ¨¢® à ¡®â ¥â¥
+    блокируйте/разблокируйте буфер, когда вы с ним активно работаете
-    ¨ ¢ ¬  ¤®, çâ®¡ë ¨§¢¥ ¥ ¨§¬¥ï«¨áì ¤ ë¥ ¡ãä¥à
+    и вам надо, чтобы извне не изменялись данные буфера
-    (¥ ¯®áâã¯ «¨ ®¢ë¥ á®®¡é¥¨ï)
+    (не поступали новые сообщения)
-  * +4: dword: § ïâ® ¬¥áâ  ¢ ¡ãä¥à¥ (¢ ¡ ©â å)
+  * +4: dword: занято места в буфере (в байтах)
-  * +8: ¯¥à¢®¥ á®®¡é¥¨¥
+  * +8: первое сообщение
-  * +8+n: ¢â®à®¥ á®®¡é¥¨¥
+  * +8+n: второе сообщение
   * ...
-®à¬ â á®®¡é¥¨ï:
+Формат сообщения:
-  * +0: dword: PID ¯à®æ¥áá /¯®â®ª , ¯®á« ¢è¥£® á®®¡é¥¨¥
+  * +0: dword: PID процесса/потока, пославшего сообщение
-  * +4: dword: ¤«¨  á®®¡é¥¨ï (¥ áç¨â ï íâ®â § £®«®¢®ª)
+  * +4: dword: длина сообщения (не считая этот заголовок)
-  * +8: n*byte: ¤ ë¥ á®®¡é¥¨ï
+  * +8: n*byte: данные сообщения
---------------- ®¤äãªæ¨ï 2 - ¯®á« âì á®®¡é¥¨¥ IPC. ----------------
+--------------- Подфункция 2 - послать сообщение IPC. ----------------
-ë§ë¢ ¥âáï ¯à®æ¥áá®¬-¨¨æ¨ â®à®¬.
+Вызывается процессом-инициатором.
- à ¬¥âàë:
+Параметры:
-  * eax = 60 - ®¬¥à äãªæ¨¨
+  * eax = 60 - номер функции
-  * ebx = 2 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 2 - номер подфункции
-  * ecx = PID ¯à¨ñ¬¨ª
+  * ecx = PID приёмника
-  * edx = ãª § â¥«ì   ¤ ë¥ á®®¡é¥¨ï
+  * edx = указатель на данные сообщения
-  * esi = ¤«¨  á®®¡é¥¨ï (¢ ¡ ©â å)
+  * esi = длина сообщения (в байтах)
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®
+  * eax = 0 - успешно
-  * eax = 1 - ¯à¨ñ¬¨ª ¥ ®¯à¥¤¥«¨« ¡ãä¥à ¤«ï IPC-á®®¡é¥¨©
+  * eax = 1 - приёмник не определил буфер для IPC-сообщений
-    (¬®¦¥â ¡ëâì, ¥éñ ¥ ãá¯¥«,   ¬®¦¥â ¡ëâì, íâ® ¥ â®â ¯®â®ª,
+    (может быть, ещё не успел, а может быть, это не тот поток,
-    ª®â®àë© ã¦¥)
+    который нужен)
-  * eax = 2 - ¯à¨ñ¬¨ª § ¡«®ª¨à®¢ « IPC-¡ãä¥à;
+  * eax = 2 - приёмник заблокировал IPC-буфер;
-    ¯®¯à®¡ã©â¥ ¥¬®£® ¯®¤®¦¤ âì
+    попробуйте немного подождать
-  * eax = 3 - ¯¥à¥¯®«¥¨¥ IPC-¡ãä¥à  ¯à¨ñ¬¨ª
+  * eax = 3 - переполнение IPC-буфера приёмника
-  * eax = 4 - ¯à®æ¥áá /¯®â®ª  á â ª¨¬ PID ¥ áãé¥áâ¢ã¥â
+  * eax = 4 - процесса/потока с таким PID не существует
- ¬¥ç ¨ï:
+Замечания:
-  * ¨áâ¥¬  áà §ã ¯®á«¥ § ¯¨á¨ IPC-á®®¡é¥¨ï ¢ ¡ãä¥à ¯®áë« ¥â
+  * Система сразу после записи IPC-сообщения в буфер посылает
-    ¯®â®ªã-¯à¨ñ¬¨ªã á®¡ëâ¨¥ á ª®¤®¬ 7 (á¬. ª®¤ë á®¡ëâ¨©).
+    потоку-приёмнику событие с кодом 7 (см. коды событий).
 ======================================================================
-=== ãªæ¨ï 61 - ¯®«ãç¨âì ¯ à ¬¥âàë ¤«ï ¯àï¬®£® ¤®áâã¯  ª £à ä¨ª¥. ===
+=== Функция 61 - получить параметры для прямого доступа к графике. ===
 ======================================================================
-à®£à ¬¬¥ ¤®áâã¯ë ¤ ë¥ £à ä¨ç¥áª®£® íªà   (®¡« áâì ¯ ¬ïâ¨, ª®â®à ï
+Программе доступны данные графического экрана (область памяти, которая
-á®¡áâ¢¥® ¨ ®â®¡à ¦ ¥â á®¤¥à¦¨¬®¥ íªà  )  ¯àï¬ãî ¡¥§ ¢ë§®¢®¢
+собственно и отображает содержимое экрана) напрямую без вызовов
-á¨áâ¥¬ëå äãªæ¨© ç¥à¥§ á¥«¥ªâ®à gs:
+системных функций через селектор gs:
 	mov	eax, [gs:0]
-  * ¥ª®â®àë¥ à¥£¨áâàë áâ ¤ àâë ¨ áãé¥áâ¢ãîâ ¤«ï ¢á¥å ãáâà®©áâ¢,
+  * Некоторые регистры стандартны и существуют для всех устройств,
-    ¥ª®â®àë¥ ®¯à¥¤¥«ïîâáï ª®ªà¥âë¬ ãáâà®©áâ¢®¬. ¯¨á®ª ¯¥à¢ëå
+    некоторые определяются конкретным устройством. Список первых
-    ¢å®¤¨â,  ¯à¨¬¥à, ¢ ¨§¢¥áâë© Interrupt List by Ralf Brown
+    входит, например, в известный Interrupt List by Ralf Brown
     (http://www.pobox.com/~ralf/files.html,
     ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
-    á¯¨á®ª ¢â®àëå ¤®«¦¥ ¡ëâì ãª §  ¢ ¤®ªã¬¥â æ¨¨ ¯® ãáâà®©áâ¢ã.
+    список вторых должен быть указан в документации по устройству.
-    á®áâ ¢«ïîé¨¥ æ¢¥â .
+    составляющие цвета.
-  * ®à¬ â ¨§®¡à ¦¥¨ï á 32 ¡¨â ¬¨   ¯¨ªá¥«ì:   «®£¨ç® 24, â®«ìª®
+  * Формат изображения с 32 битами на пиксель: аналогично 24, только
-    ¥áâì ¥éñ ¨£®à¨àã¥¬ë© ç¥â¢ñàâë© ¡ ©â.
+    есть ещё игнорируемый четвёртый байт.
-  * ë§®¢ äãªæ¨¨ 7 íª¢¨¢ «¥â¥ ¢ë§®¢ã íâ®© äãªæ¨¨ á ¯ à ¬¥âà ¬¨
+  * Вызов функции 7 эквивалентен вызову этой функции с параметрами
     esi=24, ebp=0.
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 68 - ®¬¥à äãªæ¨¨
+  * eax = 68 - номер функции
-  * ebx = 2 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 2 - номер подфункции
-  * ecx = âà¥¡ã¥¬®¥ ¤¥©áâ¢¨¥:
+  * ecx = требуемое действие:
-    * ecx = 0 - à §à¥è¨âì ¢ë¯®«¥¨¥ ¨áâàãªæ¨¨ rdpmc
+    * ecx = 0 - разрешить выполнение инструкции rdpmc
       (ReaD Performance-Monitoring Counters)
-    * ecx = 1 - ã§ âì, ¢ª«îçñ/¢ëª«îç¥ ªíè
+    * ecx = 1 - узнать, включён/выключен кэш
-    * ecx = 2 - ¢ª«îç¨âì ªíè
+    * ecx = 2 - включить кэш
-    * ecx = 3 - ¢ëª«îç¨âì ªíè
+    * ecx = 3 - выключить кэш
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * ¤«ï ecx=0:
+  * для ecx=0:
-    * eax = § ç¥¨¥ cr4
+    * eax = значение cr4
-  * ¤«ï ecx=1:
+  * для ecx=1:
     * eax = (cr0 and 0x60000000):
-    * eax = 0 - ªíè ¢ª«îçñ
+    * eax = 0 - кэш включён
-    * eax <> 0 - ªíè ¢ëª«îç¥
+    * eax <> 0 - кэш выключен
-  * ¤«ï ecx=2 ¨ ecx=3:
+  * для ecx=2 и ecx=3:
-    * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+    * функция не возвращает значения
 ======================================================================
-========== ãªæ¨ï 68, ¯®¤äãªæ¨ï 3 - ¯à®ç¨â âì MSR-à¥£¨áâà. =========
+========== Функция 68, подфункция 3 - прочитать MSR-регистр. =========
 ======================================================================
-MSR = Model Specific Register; ¯®«ë© á¯¨á®ª MSR-à¥£¨áâà®¢ ¯à®æ¥áá®à
+MSR = Model Specific Register; полный список MSR-регистров процессора
-á®¤¥à¦¨âáï ¢ ¤®ªã¬¥â æ¨¨ ¯® ¯à®æ¥áá®àã ( ¯à¨¬¥à, IA-32 Intel
+содержится в документации по процессору (например, IA-32 Intel
 Architecture Software Developer's Manual, Volume 3, Appendix B);
-ª ¦¤®¥ á¥¬¥©áâ¢® ¯à®æ¥áá®à®¢ ¨¬¥¥â á¢®ñ ¯®¤¬®¦¥áâ¢® MSR-à¥£¨áâà®¢.
+каждое семейство процессоров имеет своё подмножество MSR-регистров.
- à ¬¥âàë:
+Параметры:
-  * eax = 68 - ®¬¥à äãªæ¨¨
+  * eax = 68 - номер функции
-  * ebx = 3 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 3 - номер подфункции
-  * ecx ¨£®à¨àã¥âáï
+  * ecx игнорируется
-  * edx =  ¤à¥á MSR
+  * edx = адрес MSR
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * ebx:eax = áâ àè¨©:¬« ¤è¨© dword à¥§ã«ìâ â
+  * ebx:eax = старший:младший dword результата
- ¬¥ç ¨ï:
+Замечания:
-  * ª § ¨¥ ¢ ecx ¥áãé¥áâ¢ãîé¥£® ¨«¨ ¥à¥ «¨§®¢ ®£® ¤«ï ¤ ®£®
+  * Указание в ecx несуществующего или нереализованного для данного
-    ¯à®æ¥áá®à  MSR ¯®¢«¥çñâ ¨áª«îç¥¨¥ ¢ ï¤à¥, ª®â®à®¥ ¯à¨¡ìñâ ¯®â®ª.
+    процессора MSR повлечёт исключение в ядре, которое прибьёт поток.
-  * à¥¤¢ à¨â¥«ì® á«¥¤ã¥â ®¯à¥¤¥«¨âì, ¯®¤¤¥à¦¨¢ îâáï «¨ MSR ¢ æ¥«®¬,
+  * Предварительно следует определить, поддерживаются ли MSR в целом,
-    ª®¬ ¤®© cpuid.  ç¥ ¢®§¨ª¥â ã¦¥ ¤àã£®¥ ¨áª«îç¥¨¥ ¢ ï¤à¥,
+    командой cpuid. Иначе возникнет уже другое исключение в ядре,
-    * SHM_WRITE       = 0x01 - ¤®áâã¯   çâ¥¨¥ ¨ § ¯¨áì
+    * SHM_WRITE       = 0x01 - доступ на чтение и запись
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = ãª § â¥«ì   ®¡« áâì ¯ ¬ïâ¨, 0 ¯à¨ ®è¨¡ª¥
+  * eax = указатель на область памяти, 0 при ошибке
-  * ¯à¨ á®§¤ ¨¨ ®¢®© ®¡« áâ¨ (SHM_CREATE ¨«¨ SHM_OPEN_ALWAYS):
+  * при создании новой области (SHM_CREATE или SHM_OPEN_ALWAYS):
-  * +8: N*byte: ¡ãä¥à
+  * +8: N*byte: буфер
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
- ¬¥ç ¨ï:
+Замечания:
-  * á«¨ ¯®«¥ à §¬¥à  ®âà¨æ â¥«ì®, ¡ãä¥à áç¨â ¥âáï § ¡«®ª¨à®¢ ë¬
+  * Если поле размера отрицательно, буфер считается заблокированным
-    ¨ ¯à¨ ¯®áâã¯«¥¨¨ ®¢®£® á®®¡é¥¨ï á¨áâ¥¬  ¡ã¤¥â ¦¤ âì.
+    и при поступлении нового сообщения система будет ждать.
-    «ï á¨åà®¨§ æ¨¨ ®¡à ¬«ï©â¥ ¢áî à ¡®âã á ¡ãä¥à®¬ ®¯¥à æ¨ï¬¨
+    Для синхронизации обрамляйте всю работу с буфером операциями
-    ¡«®ª¨à®¢ª¨/à §¡«®ª¨à®¢ª¨
+    блокировки/разблокировки
     	neg	[bufsize]
-  *  ë¥ ¢ ¡ãä¥à¥ âà ªâãîâáï ª ª ¬ áá¨¢ í«¥¬¥â®¢ ¯¥à¥¬¥®© ¤«¨ë -
+  * Данные в буфере трактуются как массив элементов переменной длины -
-    á®®¡é¥¨©. ®à¬ â á®®¡é¥¨ï ãª §  ¢ ®¡é¥¬ ®¯¨á ¨¨.
+    сообщений. Формат сообщения указан в общем описании.
 ======================================================================
-====================== ãªæ¨ï 69, ¯®¤äãªæ¨ï 1 ======================
+====================== Функция 69, подфункция 1 ======================
-========= ®«ãç¨âì á®áâ®ï¨¥ à¥£¨áâà®¢ ®â« ¦¨¢ ¥¬®£® ¯®â®ª . =========
+========= Получить состояние регистров отлаживаемого потока. =========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 69 - ®¬¥à äãªæ¨¨
+  * eax = 69 - номер функции
-  * ebx = 1 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 1 - номер подфункции
-  * ecx = ¨¤¥â¨ä¨ª â®à ¯®â®ª
+  * ecx = идентификатор потока
-  * edx = ¤«¨  áâàãªâãàë ª®â¥ªáâ , ¤®«¦® ¡ëâì 0x28=40 ¡ ©â
+  * edx = длина структуры контекста, должно быть 0x28=40 байт
-  * esi = ãª § â¥«ì   áâàãªâãàã ª®â¥ªáâ
+  * esi = указатель на структуру контекста
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
-®à¬ â áâàãªâãàë ª®â¥ªáâ : (FPU ¯®ª  ¥ ¯®¤¤¥à¦¨¢ ¥âáï)
+Формат структуры контекста: (FPU пока не поддерживается)
   * +0: dword: eip
-  * ¯¯ à âë¥ â®çª¨ ®áâ ®¢  à¥ «¨§ãîâáï ç¥à¥§ DRx-à¥£¨áâàë
+  * Аппаратные точки останова реализуются через DRx-регистры
-    ¯à®æ¥áá®à , ®âáî¤  ¢á¥ ®£à ¨ç¥¨ï.
+    процессора, отсюда все ограничения.
-  * ãªæ¨ï ¬®¦¥â ¯¥à¥ãáâ ®¢¨âì à ¥¥ ãáâ ®¢«¥ãî ¥© ¦¥
+  * Функция может переустановить ранее установленную ей же
-    â®çªã ®áâ ®¢  (¨ª ª ¥ á®®¡é ï ®¡ íâ®¬).
+    точку останова (никак не сообщая об этом).
-    ¥¤¨â¥ á¯¨á®ª ãáâ ®¢«¥ëå â®ç¥ª ®áâ ®¢  ¢ ®â« ¤ç¨ª¥.
+    Ведите список установленных точек останова в отладчике.
-  * à ¡ âë¢ ¨¥ â®çª¨ ®áâ ®¢  § ª«îç ¥âáï ¢ £¥¥à¨à®¢ ¨¨
+  * Срабатывание точки останова заключается в генерировании
-    ®â« ¤®ç®£® ¨áª«îç¥¨ï #DB, ® ª®â®à®¬ á¨áâ¥¬  á®®¡é ¥â ®â« ¤ç¨ªã.
+    отладочного исключения #DB, о котором система сообщает отладчику.
-  * ®çª  ®áâ ®¢    § ¯¨áì ¨ çâ¥¨¥/§ ¯¨áì áà ¡ âë¢ ¥â ¯®á«¥
+  * Точка останова на запись и чтение/запись срабатывает после
-    ¢ë¯®«¥¨ï ¢ë§¢ ¢è¥© ¥ñ ¨áâàãªæ¨¨.
+    выполнения вызвавшей её инструкции.
 ======================================================================
-= ãªæ¨ï 70 - à ¡®â  á ä ©«®¢®© á¨áâ¥¬®© á ¯®¤¤¥à¦ª®© ¤«¨ëå ¨¬ñ. =
+= Функция 70 - работа с файловой системой с поддержкой длинных имён. =
 ======================================================================
- à ¬¥âàë:
+Параметры:
   * eax = 70
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®; ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно; иначе код ошибки файловой системы
-  * ¢ § ¢¨á¨¬®áâ¨ ®â ¯®¤äãªæ¨¨ ¬®¦¥â ¢®§¢à é âìáï § ç¥¨¥ ¨
+  * в зависимости от подфункции может возвращаться значение и
-    ¢ ¤àã£¨å à¥£¨áâà å
+    в других регистрах
-¡é¨© ä®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Общий формат информационной структуры:
-  * +0: dword: ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: номер подфункции
-  * +4: dword: á¬¥é¥¨¥ ¢ ä ©«¥
+  * +4: dword: смещение в файле
-  * +8: dword: áâ àè¨© dword á¬¥é¥¨ï (¤®«¦¥ ¡ëâì 0) ¨«¨ ¯®«¥ ä« £®¢
+  * +8: dword: старший dword смещения (должен быть 0) или поле флагов
-  * +12 = +0xC: dword: à §¬¥à
+  * +12 = +0xC: dword: размер
-  * +16 = +0x10: dword: ãª § â¥«ì   ¤ ë¥
+  * +16 = +0x10: dword: указатель на данные
-  * +20 = +0x14: n db: ASCIIZ-áâà®ª  á ¨¬¥¥¬ ä ©«
+  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-â®ç¥¨ï - ¢ ¤®ªã¬¥â æ¨¨   á®®â¢¥âáâ¢ãîéãî ¯®¤äãªæ¨î.
+Уточнения - в документации на соответствующую подфункцию.
-¬ï ä ©«  ¥çã¢áâ¢¨â¥«ì® ª à¥£¨áâàã ¡ãª¢. ãááª¨¥ ¡ãª¢ë ¤®«¦ë ¡ëâì
+Имя файла нечувствительно к регистру букв. Русские буквы должны быть
-§ ¯¨á ë ¢ ª®¤¨à®¢ª¥ cp866 (DOS).
+записаны в кодировке cp866 (DOS).
-®à¬ â ¨¬¥¨ ä ©« :
+Формат имени файла:
 /base/number/dir1/dir2/.../dirn/file,
-£¤¥ /base/number ¨¤¥â¨ä¨æ¨àã¥â ãáâà®©áâ¢®,   ª®â®à®¬ ¨é¥âáï ä ©«:
+где /base/number идентифицирует устройство, на котором ищется файл:
-®¤® ¨§
+одно из
-  * /RD/1 = /RAMDISK/1 ¤«ï ¤®áâã¯  ª à ¬¤¨áªã
+  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
-  * /FD/1 = /FLOPPYDISK/1 ¤«ï ¤®áâã¯  ª ¯¥à¢®¬ã ä«®¯¯¨-¤¨áª®¢®¤ã,
+  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
-    /FD/2 = /FLOPPYDISK/2 ¤«ï ¢â®à®£® ä«®¯¯¨-¤¨áª®¢®¤
+    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
-  * /HD0/x, /HD1/x, /HD2/x, /HD3/x ¤«ï ¤®áâã¯  á®®â¢¥âáâ¢¥®
+  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
-    ª ¦ñáâª¨¬ ¤¨áª ¬   IDE0 (Primary Master), IDE1 (Primary Slave),
+    к жёстким дискам на IDE0 (Primary Master), IDE1 (Primary Slave),
     IDE2 (Secondary Master), IDE3 (Secondary Slave);
-    x - ®¬¥à à §¤¥«    ¢ë¡à ®¬ ¢¨ç¥áâ¥à¥, ¨§¬¥ï¥âáï ®â 1 ¤® 255
+    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
-    (  ª ¦¤®¬ ¨§ ¢¨ç¥áâ¥à®¢ ã¬¥à æ¨ï  ç¨ ¥âáï á 1)
+    (на каждом из винчестеров нумерация начинается с 1)
-  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 ¤«ï ¤®áâã¯  á®®â¢¥âáâ¢¥®
+  * /CD0/1, /CD1/1, /CD2/1, /CD3/1 для доступа соответственно
-    ª CD   IDE0 (Primary Master), IDE1 (Primary Slave),
+    к CD на IDE0 (Primary Master), IDE1 (Primary Slave),
     IDE2 (Secondary Master), IDE3 (Secondary Slave)
-  * /SYS - ®¯à¥¤¥«ï¥â á¨áâ¥¬ãî ¯ ¯ªã; ¯à¨ ®¡ëç®© § £àã§ª¥ á¨áâ¥¬ë
+  * /SYS - определяет системную папку; при обычной загрузке системы
-    á ¤¨áª¥âë íª¢¨¢ «¥â® /RD/1
+    с дискеты эквивалентно /RD/1
-à¨¬¥àë:
+Примеры:
   * '/rd/1/kernel.asm',0
   * '/HD0/1/kernel.asm',0
   * '/hd0/2/menuet/pics/tanzania.bmp',0
   * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
   * '/sys/MySuperApp.ini',0
- ª¦¥ äãªæ¨ï ¯®¤¤¥à¦¨¢ ¥â ®â®á¨â¥«ìë¥ ¨¬¥ . á«¨ ¯ãâì  ç¨ ¥âáï
+Также функция поддерживает относительные имена. Если путь начинается
-¥ á '/', â® ® áç¨â ¥âáï ®â®á¨â¥«ì® â¥ªãé¥© ¯ ¯ª¨. ®«ãç¨âì ¨«¨
+не с '/', то он считается относительно текущей папки. Получить или
-ãáâ ®¢¨âì â¥ªãéãî ¯ ¯ªã ¬®¦® á ¯®¬®éìî á¨áäãªæ¨¨ 30.
+установить текущую папку можно с помощью сисфункции 30.
-®áâã¯ë¥ ¯®¤äãªæ¨¨:
+Доступные подфункции:
-  * ¯®¤äãªæ¨ï 0 - çâ¥¨¥ ä ©«
+  * подфункция 0 - чтение файла
-  * ¯®¤äãªæ¨ï 1 - çâ¥¨¥ ¯ ¯ª¨
+  * подфункция 1 - чтение папки
-  * ¯®¤äãªæ¨ï 2 - á®§¤ ¨¥/¯¥à¥§ ¯¨áì ä ©«
+  * подфункция 2 - создание/перезапись файла
-  * ¯®¤äãªæ¨ï 3 - § ¯¨áì ¢ áãé¥áâ¢ãîé¨© ä ©«
+  * подфункция 3 - запись в существующий файл
-  * ¯®¤äãªæ¨ï 4 - ãáâ ®¢ª  à §¬¥à  ä ©«
+  * подфункция 4 - установка размера файла
-  * ¯®¤äãªæ¨ï 5 - ¯®«ãç¥¨¥  âà¨¡ãâ®¢ ä ©« /¯ ¯ª¨
+  * подфункция 5 - получение атрибутов файла/папки
-  * ¯®¤äãªæ¨ï 6 - ãáâ ®¢ª   âà¨¡ãâ®¢ ä ©« /¯ ¯ª¨
+  * подфункция 6 - установка атрибутов файла/папки
-  * ¯®¤äãªæ¨ï 7 - § ¯ãáª ¯à®£à ¬¬ë
+  * подфункция 7 - запуск программы
-  * ¯®¤äãªæ¨ï 8 - ã¤ «¥¨¥ ä ©« /¯ ¯ª¨
+  * подфункция 8 - удаление файла/папки
-  * ¯®¤äãªæ¨ï 9 - á®§¤ ¨¥ ¯ ¯ª¨
+  * подфункция 9 - создание папки
-«ï CD-¯à¨¢®¤®¢ ¢ á¢ï§¨ á  ¯¯ à âë¬¨ ®£à ¨ç¥¨ï¬¨ ¤®áâã¯ë
+Для CD-приводов в связи с аппаратными ограничениями доступны
-â®«ìª® ¯®¤äãªæ¨¨ 0,1,5 ¨ 7, ¢ë§®¢ ¤àã£¨å ¯®¤äãªæ¨© § ¢¥àè¨âáï
+только подфункции 0,1,5 и 7, вызов других подфункций завершится
-®è¨¡ª®© á ª®¤®¬ 2.
+ошибкой с кодом 2.
-à¨ ¯¥à¢®¬ ®¡à é¥¨¨ ¯®¤äãªæ¨© 0,1,5,7 ª ãáâà®©áâ¢ ¬ ATAPI
+При первом обращении подфункций 0,1,5,7 к устройствам ATAPI
-(CD ¨ DVD) ¯à®¨§¢®¤¨âáï ¡«®ª¨à®¢ª  àãç®£® ã¯à ¢«¥¨ï ¬¥å ¨§¬®¬
+(CD и DVD) производится блокировка ручного управления механизмом
-«®âª . â® á¢ï§ ® á ªíè¨à®¢ ¨¥¬ ¤ ëå, ¯®«ãç¥ëå ®â ¯à¨¢®¤ .
+лотка. Это связано с кэшированием данных, полученных от привода.
- §¡«®ª¨à®¢ª  ®áãé¥áâ¢«ï¥âáï ¯à¨ ®¡à é¥¨¨ ¯®¤äãªæ¨¨ 4 äãªæ¨¨ 24
+Разблокировка осуществляется при обращении подфункции 4 функции 24
-ª á®®â¢¥âáâ¢ãîé¥¬ã ãáâà®©áâ¢ã.
+к соответствующему устройству.
 ======================================================================
-= ãªæ¨ï 70, ¯®¤äãªæ¨ï 0 - çâ¥¨¥ ä ©«  á ¯®¤¤¥à¦ª®© ¤«¨ëå ¨¬ñ. =
+= Функция 70, подфункция 0 - чтение файла с поддержкой длинных имён. =
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 0 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 0 = номер подфункции
-  * +4: dword: ¯®§¨æ¨ï ¢ ä ©«¥ (¢ ¡ ©â å)
+  * +4: dword: позиция в файле (в байтах)
-  * +8: dword: 0 (§ à¥§¥à¢¨à®¢ ® ¯®¤ áâ àè¨© dword ¯®§¨æ¨¨)
+  * +8: dword: 0 (зарезервировано под старший dword позиции)
-  * +12 = +0xC: dword: áª®«ìª® ¡ ©â ç¨â âì
+  * +12 = +0xC: dword: сколько байт читать
-  * +16 = +0x10: dword: ãª § â¥«ì   ¡ãä¥à, ªã¤  ¡ã¤ãâ § ¯¨á ë ¤ ë¥
+  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx = ç¨á«® ¯à®ç¨â ëå ¡ ©â ¨«¨
+  * ebx = число прочитанных байт или
-    -1=0xffffffff, ¥á«¨ ä ©« ¥  ©¤¥
+    -1=0xffffffff, если файл не найден
- ¬¥ç ¨ï:
+Замечания:
-  * á«¨ ä ©« ª®ç¨«áï à ìè¥, ç¥¬ ¡ë« ¯à®ç¨â  ¯®á«¥¤¨© § ¯à®è¥ë©
+  * Если файл кончился раньше, чем был прочитан последний запрошенный
-    ¡«®ª, â® äãªæ¨ï ¯à®ç¨â ¥â, áª®«ìª® á¬®¦¥â, ¯®á«¥ ç¥£® ¢¥àñâ
+    блок, то функция прочитает, сколько сможет, после чего вернёт
     eax=6 (EOF).
-  * ãªæ¨ï ¥ ¯®§¢®«ï¥â ç¨â âì ¯ ¯ª¨
+  * Функция не позволяет читать папки
-    (¢¥àñâáï eax=10, access denied).
+    (вернётся eax=10, access denied).
 ======================================================================
-= ãªæ¨ï 70, ¯®¤äãªæ¨ï 1 - çâ¥¨¥ ¯ ¯ª¨ á ¯®¤¤¥à¦ª®© ¤«¨ëå ¨¬ñ. =
+= Функция 70, подфункция 1 - чтение папки с поддержкой длинных имён. =
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 1 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 1 = номер подфункции
-  * +4: dword: ¨¤¥ªá  ç «ì®£® ¡«®ª  (áç¨â ï á 0)
+  * +4: dword: индекс начального блока (считая с 0)
-  * +8: dword: ¯®«¥ ä« £®¢:
+  * +8: dword: поле флагов:
-    * ¡¨â 0 (¬ áª  1): ¢ ª ª®¬ ä®à¬ â¥ ¢®§¢à é âì ¨¬¥ ,
+    * бит 0 (маска 1): в каком формате возвращать имена,
 =ANSI, 1=UNICODE
-    * ¯à®ç¨¥ ¡¨âë § à¥§¥à¢¨à®¢ ë ¨ ¤®«¦ë ¡ëâì ãáâ ®¢«¥ë ¢ 0
+    * прочие биты зарезервированы и должны быть установлены в 0
-      ¤«ï ¡ã¤ãé¥© á®¢¬¥áâ¨¬®áâ¨
+      для будущей совместимости
-  * +12 = +0xC: dword: áª®«ìª® ¡«®ª®¢ ç¨â âì
+  * +12 = +0xC: dword: сколько блоков читать
-  * +16 = +0x10: dword: ãª § â¥«ì   ¡ãä¥à, ªã¤  ¡ã¤ãâ § ¯¨á ë
+  * +16 = +0x10: dword: указатель на буфер, куда будут записаны
-    ¤ ë¥, à §¬¥à ¡ãä¥à  ¤®«¦¥ ¡ëâì ¥ ¬¥ìè¥ 32 + [+12]*560 ¡ ©â
+    данные, размер буфера должен быть не меньше 32 + [+12]*560 байт
-  * +20 = +0x14: ASCIIZ-¨¬ï ¯ ¯ª¨, ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx = ç¨á«® ä ©«®¢, ¨ä®à¬ æ¨ï ® ª®â®àëå ¡ë«  § ¯¨á   ¢ ¡ãä¥à,
+  * ebx = число файлов, информация о которых была записана в буфер,
-    ¨«¨ -1=0xffffffff, ¥á«¨ ¯ ¯ª  ¥  ©¤¥
+    или -1=0xffffffff, если папка не найдена
-âàãªâãà  ¡ãä¥à :
+Структура буфера:
-  * +0: 32*byte: § £®«®¢®ª
+  * +0: 32*byte: заголовок
-  * +32 = +0x20: n1*byte: ¡«®ª á ¨ä®à¬ æ¨¥© ® ä ©«¥ 1
+  * +32 = +0x20: n1*byte: блок с информацией о файле 1
-  * +32+n1: n2*byte: ¡«®ª á ¨ä®à¬ æ¨¥© ® ä ©«¥ 2
+  * +32+n1: n2*byte: блок с информацией о файле 2
   * ...
-âàãªâãà  § £®«®¢ª :
+Структура заголовка:
-  * +0: dword: ¢¥àá¨ï áâàãªâãàë (â¥ªãé ï ¢¥àá¨ï = 1)
+  * +0: dword: версия структуры (текущая версия = 1)
-  * +4: dword: ª®«¨ç¥áâ¢® à §¬¥éñëå ¡«®ª®¢; ¥ ¡®«ìè¥, ç¥¬ § ¯à®è¥®
+  * +4: dword: количество размещённых блоков; не больше, чем запрошено
-    ¢ ¯®«¥ +12 ¨ä®à¬ æ¨®®© áâàãªâãàë; ¬®¦¥â ¡ëâì ¬¥ìè¥,
+    в поле +12 информационной структуры; может быть меньше,
-    ¥á«¨ ¢ ¯ ¯ª¥ ª®ç¨«¨áì ä ©«ë (â® ¦¥ á ¬®¥, çâ® ¨ ¢ ebx)
+    если в папке кончились файлы (то же самое, что и в ebx)
-  * +8: dword: ®¡é¥¥ ç¨á«® ä ©«®¢ ¢ ¯ ¯ª¥
+  * +8: dword: общее число файлов в папке
-  * +12 = +0xC: 20*byte: § à¥§¥à¢¨à®¢ ® (ã«¨)
+  * +12 = +0xC: 20*byte: зарезервировано (нули)
-âàãªâãà  ¡«®ª  ¤ ëå ¢å®¤  ª â «®£  ():
+Структура блока данных входа каталога (БДВК):
-  * +0: dword:  âà¨¡ãâë ä ©« :
+  * +0: dword: атрибуты файла:
-    * ¡¨â 0 (¬ áª  1): ä ©« â®«ìª® ¤«ï çâ¥¨ï
+    * бит 0 (маска 1): файл только для чтения
-    * ¡¨â 1 (¬ áª  2): ä ©« ï¢«ï¥âáï áªàëâë¬
+    * бит 1 (маска 2): файл является скрытым
-    * ¡¨â 2 (¬ áª  4): ä ©« ï¢«ï¥âáï á¨áâ¥¬ë¬
+    * бит 2 (маска 4): файл является системным
-    * ¡¨â 3 (¬ áª  8): íâ® ¥ ä ©«,   ¬¥âª  â®¬
+    * бит 3 (маска 8): это не файл, а метка тома
-      (  § ¤ ®¬ à §¤¥«¥ ¢áâà¥ç ¥âáï ¥ ¡®«¥¥ ®¤®£® à §  ¨
+      (на заданном разделе встречается не более одного раза и
-      â®«ìª® ¢ ª®à¥¢®© ¯ ¯ª¥)
+      только в корневой папке)
-    * ¡¨â 4 (¬ áª  0x10): íâ® ¯ ¯ª
+    * бит 4 (маска 0x10): это папка
-    * ¡¨â 5 (¬ áª  0x20): ä ©« ¥  àå¨¢¨à®¢ «áï - ¬®£¨¥ ¯à®£à ¬¬ë
+    * бит 5 (маска 0x20): файл не архивировался - многие программы
-       àå¨¢ æ¨¨ ¨¬¥îâ ®¯æ¨î, ¯® ª®â®à®©  àå¨¢¨àãîâáï â®«ìª® ä ©«ë
+      архивации имеют опцию, по которой архивируются только файлы
-      á ãáâ ®¢«¥ë¬ íâ¨¬ ¡¨â®¬, ¯®á«¥ ç¥£® íâ®â ¡¨â á¡à áë¢ ¥âáï -
+      с установленным этим битом, после чего этот бит сбрасывается -
-      íâ® ¬®¦¥â ¡ëâì ¯®«¥§® ¤«ï  ¢â®¬ â¨ç¥áª®£® á®§¤ ¨ï
+      это может быть полезно для автоматического создания
-      backup- àå¨¢®¢, ¨¡® ¯à¨ § ¯¨á¨ ¡¨â ®¡ëç® ãáâ  ¢«¨¢ ¥âáï
+      backup-архивов, ибо при записи бит обычно устанавливается
-      (¥ ¢ Kolibri, ¯à ¢¤ )
+      (не в Kolibri, правда)
-  * +4: byte: â¨¯ ¤ ëå ¨¬¥¨:
+  * +4: byte: тип данных имени:
-    (á®¢¯ ¤ ¥â á ¡¨â®¬ 0 ä« £®¢ ¨ä®à¬ æ¨®®© áâàãªâãàë)
+    (совпадает с битом 0 флагов информационной структуры)
-    * 0 = ASCII = 1-¡ ©â®¥ ¯à¥¤áâ ¢«¥¨¥ ª ¦¤®£® á¨¬¢®«
+    * 0 = ASCII = 1-байтное представление каждого символа
-    * 1 = UNICODE = 2-¡ ©â®¥ ¯à¥¤áâ ¢«¥¨¥ ª ¦¤®£® á¨¬¢®«
+    * 1 = UNICODE = 2-байтное представление каждого символа
-  * +5: 3*byte: § à¥§¥à¢¨à®¢ ® (ã«¨)
+  * +5: 3*byte: зарезервировано (нули)
-  * +8: 4*byte: ¢à¥¬ï á®§¤ ¨ï ä ©«
+  * +8: 4*byte: время создания файла
-  * +12 = +0xC: 4*byte: ¤ â  á®§¤ ¨ï ä ©«
+  * +12 = +0xC: 4*byte: дата создания файла
-  * +16 = +0x10: 4*byte: ¢à¥¬ï ¯®á«¥¤¥£® ¤®áâã¯  (çâ¥¨¥ ¨«¨ § ¯¨áì)
+  * +16 = +0x10: 4*byte: время последнего доступа (чтение или запись)
-  * +20 = +0x14: 4*byte: ¤ â  ¯®á«¥¤¥£® ¤®áâã¯
+  * +20 = +0x14: 4*byte: дата последнего доступа
-  * +24 = +0x18: 4*byte: ¢à¥¬ï ¯®á«¥¤¥© ¬®¤¨ä¨ª æ¨¨
+  * +24 = +0x18: 4*byte: время последней модификации
-  * +28 = +0x1C: 4*byte: ¤ â  ¯®á«¥¤¥© ¬®¤¨ä¨ª æ¨¨
+  * +28 = +0x1C: 4*byte: дата последней модификации
-  * +32 = +0x20: qword: à §¬¥à ä ©«  ¢ ¡ ©â å (¤® 16777216 ¡)
+  * +32 = +0x20: qword: размер файла в байтах (до 16777216 Тб)
-  * +40 = +0x28: ¨¬ï
+  * +40 = +0x28: имя
-    * ¤«ï ä®à¬ â  ASCII: ¬ ªá¨¬ «ì ï ¤«¨  ¨¬¥¨ 263 á¨¬¢®«
+    * для формата ASCII: максимальная длина имени 263 символа
-      (263 ¡ ©â ), ¡ ©â ¯®á«¥ ¨¬¥¨ ¨¬¥¥â § ç¥¨¥ 0
+      (263 байта), байт после имени имеет значение 0
-    * ¤«ï ä®à¬ â  UNICODE: ¬ ªá¨¬ «ì ï ¤«¨  ¨¬¥¨ 259 á¨¬¢®«®¢
+    * для формата UNICODE: максимальная длина имени 259 символов
-      (518 ¡ ©â), ¤¢  ¡ ©â  ¯®á«¥ ¨¬¥¨ ¨¬¥îâ § ç¥¨¥ 0
+      (518 байт), два байта после имени имеют значение 0
-®à¬ â ¢à¥¬¥¨:
+Формат времени:
-  * +0: byte: á¥ªã¤ë
+  * +0: byte: секунды
-  * +1: byte: ¬¨ãâë
+  * +1: byte: минуты
-  * +2: byte: ç áë
+  * +2: byte: часы
-  * +3: byte: § à¥§¥à¢¨à®¢ ® (0)
+  * +3: byte: зарезервировано (0)
-  *  ¯à¨¬¥à, 23.59.59 § ¯¨áë¢ ¥âáï ª ª (¢ hex) 3B 3B 17 00
+  * например, 23.59.59 записывается как (в hex) 3B 3B 17 00
-®à¬ â ¤ âë:
+Формат даты:
-  * +0: byte: ¤¥ì
+  * +0: byte: день
-  * +1: byte: ¬¥áïæ
+  * +1: byte: месяц
-  * +2: word: £®¤
+  * +2: word: год
-  *  ¯à¨¬¥à, 25.11.1979 § ¯¨áë¢ ¥âáï ª ª (¢ hex) 19 0B BB 07
+  * например, 25.11.1979 записывается как (в hex) 19 0B BB 07
- ¬¥ç ¨ï:
+Замечания:
-  * á«¨ ¢  ¯à¨áãâáâ¢ã¥â ¨¬ï ¢ ASCII, â® ¤«¨   á®áâ ¢«ï¥â
+  * Если в БДВК присутствует имя в ASCII, то длина БДВК составляет
-¡ ©â , ¥á«¨ ¢ UNICODE - 560 ¡ ©â.  ç¥¨¥ ¤«¨ë ¢ëà ¢¥®
+байта, если в UNICODE - 560 байт. Значение длины выравнено
-      æ¥«®¥ ªà â®¥ 16 ¡ ©â
+    на целое кратное 16 байт
-    (¤«ï ãáª®à¥¨ï ®¡à ¡®âª¨ ¢ ªíè-¯ ¬ïâ¨ CPU).
+    (для ускорения обработки в кэш-памяти CPU).
-  * ¥à¢ë© á¨¬¢®« ¯®á«¥ ¨¬¥¨ ã«¥¢®© (ASCIIZ-áâà®ª ).  «ì¥©è¨¥
+  * Первый символ после имени нулевой (ASCIIZ-строка). Дальнейшие
-    ¤ ë¥ á®¤¥à¦ â ¬ãá®à.
+    данные содержат мусор.
-  * á«¨ ä ©«ë ¢ ¯ ¯ª¥ ª®ç¨«¨áì à ìè¥, ç¥¬ ¡ë«® ¯à®ç¨â ®
+  * Если файлы в папке кончились раньше, чем было прочитано
-    § ¯à®è¥®¥ ª®«¨ç¥áâ¢®, â® äãªæ¨ï ¯à®ç¨â ¥â, áª®«ìª® á¬®¦¥â,
+    запрошенное количество, то функция прочитает, сколько сможет,
-    ¯®á«¥ ç¥£® ¢¥àñâ eax=6 (EOF).
+    после чего вернёт eax=6 (EOF).
-  * î¡ ï ¯ ¯ª    ¤¨áª¥, ªà®¬¥ ª®à¥¢®©, á®¤¥à¦¨â ¤¢  á¯¥æ¨ «ìëå
+  * Любая папка на диске, кроме корневой, содержит два специальных
-    ¢å®¤  "." ¨ "..", ¨¤¥â¨ä¨æ¨àãîé¨å á®®â¢¥âáâ¢¥® á ¬ã ¯ ¯ªã ¨
+    входа "." и "..", идентифицирующих соответственно саму папку и
-    à®¤¨â¥«ìáªãî ¯ ¯ªã.
+    родительскую папку.
-  * ãªæ¨ï ¯®§¢®«ï¥â â ª¦¥ ç¨â âì ¢¨àâã «ìë¥ ¯ ¯ª¨ "/", "/rd",
+  * Функция позволяет также читать виртуальные папки "/", "/rd",
-    "/fd", "/hd[n]", ¯à¨ íâ®¬  âà¨¡ãâë ¯®¤¯ ¯®ª ¯®« £ îâáï à ¢ë¬¨
+    "/fd", "/hd[n]", при этом атрибуты подпапок полагаются равными
-x10,   ¢à¥¬¥  ¨ ¤ âë ®¡ã«¥ë. «ìâ¥à â¨¢ë© á¯®á®¡ ¯®«ãç¥¨ï
+x10, а времена и даты обнулены. Альтернативный способ получения
-    ¨ä®à¬ æ¨¨ ®¡ ®¡®àã¤®¢ ¨¨ - ¯®¤äãªæ¨ï 11 äãªæ¨¨ 18.
+    информации об оборудовании - подфункция 11 функции 18.
 ======================================================================
-====================== ãªæ¨ï 70, ¯®¤äãªæ¨ï 2 ======================
+====================== Функция 70, подфункция 2 ======================
-======== ®§¤ ¨¥/¯¥à¥§ ¯¨áì ä ©«  á ¯®¤¤¥à¦ª®© ¤«¨ëå ¨¬ñ. ========
+======== Создание/перезапись файла с поддержкой длинных имён. ========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 2 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 2 = номер подфункции
-  * +4: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +4: dword: 0 (зарезервировано)
-  * +8: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +8: dword: 0 (зарезервировано)
-  * +12 = +0xC: dword: áª®«ìª® ¡ ©â ¯¨á âì
+  * +12 = +0xC: dword: сколько байт писать
-  * +16 = +0x10: dword: ãª § â¥«ì   ¤ ë¥
+  * +16 = +0x10: dword: указатель на данные
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx = ç¨á«® § ¯¨á ëå ¡ ©â (¢®§¬®¦®, 0)
+  * ebx = число записанных байт (возможно, 0)
- ¬¥ç ¨ï:
+Замечания:
-  * á«¨ ä ©« á â ª¨¬ ¨¬¥¥¬ ¥ áãé¥áâ¢®¢ «, ® á®§¤ ñâáï; ¥á«¨
+  * Если файл с таким именем не существовал, он создаётся; если
-    áãé¥áâ¢®¢ «, â® ¯¥à¥§ ¯¨áë¢ ¥âáï.
+    существовал, то перезаписывается.
-  * á«¨ á¢®¡®¤®£® ¬¥áâ    ¤¨áª¥ ¥¤®áâ â®ç®, â® äãªæ¨ï § ¯¨è¥â,
+  * Если свободного места на диске недостаточно, то функция запишет,
-    áª®«ìª® á¬®¦¥â, ¯®á«¥ ç¥£® ¢¥àñâ ª®¤ ®è¨¡ª¨ 8.
+    сколько сможет, после чего вернёт код ошибки 8.
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥âáï ¤«ï CD (¢¥àñâáï ª®¤ ®è¨¡ª¨ 2).
+  * Функция не поддерживается для CD (вернётся код ошибки 2).
 ======================================================================
-====================== ãªæ¨ï 70, ¯®¤äãªæ¨ï 3 ======================
+====================== Функция 70, подфункция 3 ======================
-========  ¯¨áì ¢ áãé¥áâ¢ãîé¨© ä ©« á ¯®¤¤¥à¦ª®© ¤«¨ëå ¨¬ñ. =======
+======== Запись в существующий файл с поддержкой длинных имён. =======
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 3 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 3 = номер подфункции
-  * +4: dword: ¯®§¨æ¨ï ¢ ä ©«¥ (¢ ¡ ©â å)
+  * +4: dword: позиция в файле (в байтах)
-  * +8: dword: áâ àè¨© dword ¯®§¨æ¨¨ (¤®«¦¥ ¡ëâì 0 ¤«ï FAT)
+  * +8: dword: старший dword позиции (должен быть 0 для FAT)
-  * +12 = +0xC: dword: áª®«ìª® ¡ ©â ¯¨á âì
+  * +12 = +0xC: dword: сколько байт писать
-  * +16 = +0x10: dword: ãª § â¥«ì   ¤ ë¥
+  * +16 = +0x10: dword: указатель на данные
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx = ç¨á«® § ¯¨á ëå ¡ ©â (¢®§¬®¦®, 0)
+  * ebx = число записанных байт (возможно, 0)
- ¬¥ç ¨ï:
+Замечания:
-  *  ©« ¤®«¦¥ ã¦¥ áãé¥áâ¢®¢ âì, ¨ ç¥ ¢¥àñâáï eax=5.
+  * Файл должен уже существовать, иначе вернётся eax=5.
-  * ¤¨áâ¢¥ë¬ à¥§ã«ìâ â®¬ § ¯¨á¨ 0 ¡ ©â ï¢«ï¥âáï ãáâ ®¢ª  ¢
+  * Единственным результатом записи 0 байт является установка в
-     âà¨¡ãâ å ä ©«  ¤ âë/¢à¥¬¥¨ ¬®¤¨ä¨ª æ¨¨ ¨ ¤®áâã¯  ¢ â¥ªãéãî.
+    атрибутах файла даты/времени модификации и доступа в текущую.
-  * á«¨  ç «ì ï ¨/¨«¨ ª®¥ç ï ¯®§¨æ¨ï ¢ëå®¤¨â §  ¯à¥¤¥«ë ä ©«
+  * Если начальная и/или конечная позиция выходит за пределы файла
-    (§  ¨áª«îç¥¨¥¬ ¯à¥¤ë¤ãé¥£® á«ãç ï), ä ©« à áè¨àï¥âáï ¤®
+    (за исключением предыдущего случая), файл расширяется до
-    ¥®¡å®¤¨¬®£® à §¬¥à  ã«¥¢ë¬¨ á¨¬¢®« ¬¨.
+    необходимого размера нулевыми символами.
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥âáï ¤«ï CD (¢¥àñâáï ª®¤ ®è¨¡ª¨ 2).
+  * Функция не поддерживается для CD (вернётся код ошибки 2).
 ======================================================================
-========= ãªæ¨ï 70, ¯®¤äãªæ¨ï 4 - ãáâ ®¢ª  à §¬¥à  ä ©« . ========
+========= Функция 70, подфункция 4 - установка размера файла. ========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 4 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 4 = номер подфункции
-  * +4: dword: ¬« ¤è¨© dword ®¢®£® à §¬¥à  ä ©«
+  * +4: dword: младший dword нового размера файла
-  * +8: dword: áâ àè¨© dword ®¢®£® à §¬¥à  ä ©«
+  * +8: dword: старший dword нового размера файла
-                   (¤®«¦¥ ¡ëâì 0 ¤«ï FAT)
+                   (должен быть 0 для FAT)
-  * +12 = +0xC: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +12 = +0xC: dword: 0 (зарезервировано)
-  * +16 = +0x10: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +16 = +0x10: dword: 0 (зарезервировано)
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx à §àãè ¥âáï
+  * ebx разрушается
- ¬¥ç ¨ï:
+Замечания:
-  * á«¨ ®¢ë© à §¬¥à ä ©«  ¬¥ìè¥ áâ à®£®, ä ©« ãá¥ª ¥âáï. á«¨
+  * Если новый размер файла меньше старого, файл усекается. Если
-    ®¢ë© à §¬¥à ¡®«ìè¥ áâ à®£®, ä ©« à áè¨àï¥âáï ã«¥¢ë¬¨ á¨¬¢®« ¬¨.
+    новый размер больше старого, файл расширяется нулевыми символами.
-    á«¨ ®¢ë© à §¬¥à à ¢¥ áâ à®¬ã, ¥¤¨áâ¢¥ë¬ à¥§ã«ìâ â®¬ ¢ë§®¢
+    Если новый размер равен старому, единственным результатом вызова
-    ï¢«ï¥âáï ãáâ ®¢ª  ¤ âë/¢à¥¬¥¨ ¬®¤¨ä¨ª æ¨¨ ¨ ¤®áâã¯  ¢ â¥ªãé¨¥.
+    является установка даты/времени модификации и доступа в текущие.
-  * á«¨ á¢®¡®¤®£® ¬¥áâ    ¤¨áª¥ ¥¤®áâ â®ç® ¤«ï à áè¨à¥¨ï ä ©« ,
+  * Если свободного места на диске недостаточно для расширения файла,
-    â® äãªæ¨ï à áè¨à¨â  áª®«ìª® ¢®§¬®¦®, ¯®á«¥ ç¥£® ¢¥àñâ
+    то функция расширит насколько возможно, после чего вернёт
-    ª®¤ ®è¨¡ª¨ 8.
+    код ошибки 8.
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥âáï ¤«ï CD (¢¥àñâáï ª®¤ ®è¨¡ª¨ 2).
+  * Функция не поддерживается для CD (вернётся код ошибки 2).
 ======================================================================
-=== ãªæ¨ï 70, ¯®¤äãªæ¨ï 5 - ¯®«ãç¥¨¥ ¨ä®à¬ æ¨¨ ® ä ©«¥/¯ ¯ª¥. ===
+=== Функция 70, подфункция 5 - получение информации о файле/папке. ===
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 5 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 5 = номер подфункции
-  * +4: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +4: dword: 0 (зарезервировано)
-  * +8: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +8: dword: 0 (зарезервировано)
-  * +12 = +0xC: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +12 = +0xC: dword: 0 (зарезервировано)
-  * +16 = +0x10: dword: ãª § â¥«ì   ¡ãä¥à, ªã¤  ¡ã¤ãâ § ¯¨á ë ¤ ë¥
+  * +16 = +0x10: dword: указатель на буфер, куда будут записаны данные
-                        (40 ¡ ©â)
+                        (40 байт)
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx à §àãè ¥âáï
+  * ebx разрушается
-ä®à¬ æ¨ï ® ä ©«¥ ¢®§¢à é ¥âáï ¢ ä®à¬ â¥
+Информация о файле возвращается в формате БДВК
-(¡«®ª  ¤ ëå ¢å®¤  ª â «®£ ), ãª § ®¬ ¢ ®¯¨á ¨¨
+(блока данных входа каталога), указанном в описании
-¯®¤äãªæ¨¨ 1, ® ¡¥§ ¨¬¥¨ ä ©«
+подфункции 1, но без имени файла
-(â® ¥áâì ¯¥à¢ë¥ 40 = 0x28 ¡ ©â).
+(то есть первые 40 = 0x28 байт).
- ¬¥ç ¨ï:
+Замечания:
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥â ¢¨àâã «ìë¥ ¯ ¯ª¨ â¨¯  /, /rd ¨
+  * Функция не поддерживает виртуальные папки типа /, /rd и
-    ª®à¥¢ë¥ ¯ ¯ª¨ â¨¯  /rd/1.
+    корневые папки типа /rd/1.
 ======================================================================
-===== ãªæ¨ï 70, ¯®¤äãªæ¨ï 6 - ãáâ ®¢ª   âà¨¡ãâ®¢ ä ©« /¯ ¯ª¨. ====
+===== Функция 70, подфункция 6 - установка атрибутов файла/папки. ====
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 6 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 6 = номер подфункции
-  * +4: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +4: dword: 0 (зарезервировано)
-  * +8: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +8: dword: 0 (зарезервировано)
-  * +12 = +0xC: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +12 = +0xC: dword: 0 (зарезервировано)
-  * +16 = +0x10: dword: ãª § â¥«ì   ¡ãä¥à á  âà¨¡ãâ ¬¨ (32 ¡ ©â )
+  * +16 = +0x10: dword: указатель на буфер с атрибутами (32 байта)
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx à §àãè ¥âáï
+  * ebx разрушается
-âà¨¡ãâë ä ©«  - ¯¥à¢ë¥ 32 ¡ ©â  ¢  (¡«®ª¥ ¤ ëå ¢å®¤  ª â «®£ ),
+Атрибуты файла - первые 32 байта в БДВК (блоке данных входа каталога),
-ä®à¬ â ª®â®à®£® ãª §  ¢ ®¯¨á ¨¨ ¯®¤äãªæ¨¨ 1
+формат которого указан в описании подфункции 1
-(â® ¥áâì ¡¥§ ¨¬¥¨ ¨ à §¬¥à  ä ©« ). âà¨¡ãâ ä ©«/¯ ¯ª /¬¥âª  â®¬
+(то есть без имени и размера файла). Атрибут файл/папка/метка тома
-(¡¨âë 3,4 ¢ dword'¥ +0) ¥ ¬¥ï¥âáï.
+(биты 3,4 в dword'е +0) не меняется.
- ©â +4 (ä®à¬ â ¨¬¥¨) ¨£®à¨àã¥âáï.
+Байт +4 (формат имени) игнорируется.
- ¬¥ç ¨ï:
+Замечания:
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥â ¢¨àâã «ìë¥ ¯ ¯ª¨ â¨¯  /, /rd ¨
+  * Функция не поддерживает виртуальные папки типа /, /rd и
-    ª®à¥¢ë¥ ¯ ¯ª¨ â¨¯  /rd/1.
+    корневые папки типа /rd/1.
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥âáï ¤«ï CD (¢¥àñâáï ª®¤ ®è¨¡ª¨ 2).
+  * Функция не поддерживается для CD (вернётся код ошибки 2).
 ======================================================================
-============ ãªæ¨ï 70, ¯®¤äãªæ¨ï 7 - § ¯ãáª ¯à®£à ¬¬ë. ============
+============ Функция 70, подфункция 7 - запуск программы. ============
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 7 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 7 = номер подфункции
-  * +4: dword: ¯®«¥ ä« £®¢:
+  * +4: dword: поле флагов:
-    * ¡¨â 0: § ¯ãáâ¨âì ¯à®æ¥áá ª ª ®â« ¦¨¢ ¥¬ë©
+    * бит 0: запустить процесс как отлаживаемый
-    * ®áâ «ìë¥ ¡¨âë § à¥§¥à¢¨à®¢ ë ¨ ¤®«¦ë ¡ëâì ãáâ ®¢«¥ë ¢ 0
+    * остальные биты зарезервированы и должны быть установлены в 0
-  * +8: dword: 0 ¨«¨ ãª § â¥«ì   ASCIIZ-áâà®ªã á ¯ à ¬¥âà ¬¨
+  * +8: dword: 0 или указатель на ASCIIZ-строку с параметрами
-  * +12 = +0xC: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +12 = +0xC: dword: 0 (зарезервировано)
-  * +16 = +0x10: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +16 = +0x10: dword: 0 (зарезервировано)
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax > 0 - ¯à®£à ¬¬  § £àã¦¥ , eax á®¤¥à¦¨â PID
+  * eax > 0 - программа загружена, eax содержит PID
-  * eax < 0 - ¯à®¨§®è«  ®è¨¡ª , -eax á®¤¥à¦¨â
+  * eax < 0 - произошла ошибка, -eax содержит
-    ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+    код ошибки файловой системы
-  * ebx à §àãè ¥âáï
+  * ebx разрушается
- ¬¥ç ¨ï:
+Замечания:
-  * ®¬ ¤ ï áâà®ª  ¤®«¦  § ª ç¨¢ âìáï á¨¬¢®«®¬ á ª®¤®¬ 0
+  * Командная строка должна заканчиваться символом с кодом 0
-    (ASCIIZ-áâà®ª ); ãç¨âë¢ îâáï «¨¡® ¢á¥ á¨¬¢®«ë ¤® § ¢¥àè îé¥£® ã«ï
+    (ASCIIZ-строка); учитываются либо все символы до завершающего нуля
-    ¢ª«îç¨â¥«ì®, «¨¡® ¯¥à¢ë¥ 256 á¨¬¢®«®¢, ¢ § ¢¨á¨¬®áâ¨ ®â â®£®,
+    включительно, либо первые 256 символов, в зависимости от того,
-    çâ® ¬¥ìè¥.
+    что меньше.
-  * á«¨ ¯à®æ¥áá § ¯ãáª ¥âáï ª ª ®â« ¦¨¢ ¥¬ë©, ® á®§¤ ñâáï
+  * Если процесс запускается как отлаживаемый, он создаётся
-    ¢ § ¬®à®¦¥®¬ á®áâ®ï¨¨; ¤«ï § ¯ãáª  ¨á¯®«ì§ã©â¥
+    в замороженном состоянии; для запуска используйте
-    ¯®¤äãªæ¨î 5 äãªæ¨¨ 69.
+    подфункцию 5 функции 69.
 ======================================================================
-========== ãªæ¨ï 70, ¯®¤äãªæ¨ï 8 - ã¤ «¥¨¥ ä ©« /¯ ¯ª¨. ==========
+========== Функция 70, подфункция 8 - удаление файла/папки. ==========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 8 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 8 = номер подфункции
-  * +4: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +4: dword: 0 (зарезервировано)
-  * +8: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +8: dword: 0 (зарезервировано)
-  * +12 = +0xC: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +12 = +0xC: dword: 0 (зарезервировано)
-  * +16 = +0x10: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +16 = +0x10: dword: 0 (зарезервировано)
-  * +20 = +0x14: ASCIIZ-¨¬ï ä ©« , ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ä ©«
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем файла
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx à §àãè ¥âáï
+  * ebx разрушается
- ¬¥ç ¨ï:
+Замечания:
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥âáï ¤«ï CD (¢¥àñâáï ª®¤ ®è¨¡ª¨ 2).
+  * Функция не поддерживается для CD (вернётся код ошибки 2).
-  * ®¦® ã¤ «ïâì â®«ìª® ¯ãáâë¥ ¯ ¯ª¨ (¯®¯ëâª  ã¤ «¥¨ï ¥¯ãáâ®© ¯ ¯ª¨
+  * Можно удалять только пустые папки (попытка удаления непустой папки
-    ¯à¨¢¥¤ñâ ª ®è¨¡ª¥ á ª®¤®¬ 10, "¤®áâã¯ § ¯à¥éñ").
+    приведёт к ошибке с кодом 10, "доступ запрещён").
 ======================================================================
-============= ãªæ¨ï 70, ¯®¤äãªæ¨ï 9 - á®§¤ ¨¥ ¯ ¯ª¨. =============
+============= Функция 70, подфункция 9 - создание папки. =============
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 70 - ®¬¥à äãªæ¨¨
+  * eax = 70 - номер функции
-  * ebx = ãª § â¥«ì   ¨ä®à¬ æ¨®ãî áâàãªâãàã
+  * ebx = указатель на информационную структуру
-®à¬ â ¨ä®à¬ æ¨®®© áâàãªâãàë:
+Формат информационной структуры:
-  * +0: dword: 9 = ®¬¥à ¯®¤äãªæ¨¨
+  * +0: dword: 9 = номер подфункции
-  * +4: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +4: dword: 0 (зарезервировано)
-  * +8: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +8: dword: 0 (зарезервировано)
-  * +12 = +0xC: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +12 = +0xC: dword: 0 (зарезервировано)
-  * +16 = +0x10: dword: 0 (§ à¥§¥à¢¨à®¢ ®)
+  * +16 = +0x10: dword: 0 (зарезервировано)
-  * +20 = +0x14: ASCIIZ-¨¬ï ¯ ¯ª¨, ¯à ¢¨«  ä®à¬¨à®¢ ¨ï ¨¬ñ ãª § ë ¢
+  * +20 = +0x14: ASCIIZ-имя папки, правила формирования имён указаны в
-    ®¡é¥¬ ®¯¨á ¨¨
+    общем описании
-    ¨«¨
+    или
   * +20 = +0x14: db 0
-  * +21 = +0x15: dd ãª § â¥«ì   ASCIIZ-áâà®ªã á ¨¬¥¥¬ ¯ ¯ª¨
+  * +21 = +0x15: dd указатель на ASCIIZ-строку с именем папки
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®, ¨ ç¥ ª®¤ ®è¨¡ª¨ ä ©«®¢®© á¨áâ¥¬ë
+  * eax = 0 - успешно, иначе код ошибки файловой системы
-  * ebx à §àãè ¥âáï
+  * ebx разрушается
- ¬¥ç ¨ï:
+Замечания:
-  * ãªæ¨ï ¥ ¯®¤¤¥à¦¨¢ ¥âáï ¤«ï CD (¢¥àñâáï ª®¤ ®è¨¡ª¨ 2).
+  * Функция не поддерживается для CD (вернётся код ошибки 2).
-  * ®¤¨â¥«ìáª ï ¯ ¯ª  ¤®«¦  ã¦¥ áãé¥áâ¢®¢ âì.
+  * Родительская папка должна уже существовать.
-  * á«¨ ¯ ¯ª  ã¦¥ áãé¥áâ¢ã¥â, äãªæ¨ï § ¢¥àè¨âáï ãá¯¥è® (eax=0).
+  * Если папка уже существует, функция завершится успешно (eax=0).
 ======================================================================
-=== ãªæ¨ï 71, ¯®¤äãªæ¨ï 1 - ãáâ ®¢¨âì § £®«®¢®ª ®ª  ¯à®£à ¬¬ë. ==
+=== Функция 71, подфункция 1 - установить заголовок окна программы. ==
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = 71 - ®¬¥à äãªæ¨¨
+  * eax = 71 - номер функции
-  * ebx = 1 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 1 - номер подфункции
-  * ecx =  ¤à¥á áâà®ª¨ § £®«®¢ª
+  * ecx = адрес строки заголовка
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
- ¬¥ç ¨ï:
+Замечания:
-  * âà®ª  § £®«®¢ª  ¤®«¦  ¡ëâì ¢ ä®à¬ â¥ ASCIIZ.  § £®«®¢ª¥
+  * Строка заголовка должна быть в формате ASCIIZ. В заголовке
-    ®â®¡à ¦ ¥âáï ¥ ¡®«¥¥ 255 á¨¬¢®«®¢ ¥§ ¢¨á¨¬® ®â ¯®«®© ¤«¨ë
+    отображается не более 255 символов независимо от полной длины
-    áâà®ª¨.
+    строки.
-  * â®¡ë ã¡à âì § £®«®¢®ª, ¯¥à¥¤ ©â¥ NULL ¢ ecx.
+  * Чтобы убрать заголовок, передайте NULL в ecx.
 ======================================================================
-================ ãªæ¨ï 72 - ¯®á« âì á®®¡é¥¨¥ ®ªã. ================
+================ Функция 72 - послать сообщение окну. ================
 ======================================================================
---- ®¤äãªæ¨ï 1 - ¯®á« âì á®®¡é¥¨¥ á ¯ à ¬¥âà®¬  ªâ¨¢®¬ã ®ªã. ----
+--- Подфункция 1 - послать сообщение с параметром активному окну. ----
- à ¬¥âàë:
+Параметры:
-  * eax = 72 - ®¬¥à äãªæ¨¨
+  * eax = 72 - номер функции
-  * ebx = 1 - ®¬¥à ¯®¤äãªæ¨¨
+  * ebx = 1 - номер подфункции
-  * ecx = ª®¤ á®¡ëâ¨ï: 2 ¨«¨ 3
+  * ecx = код события: 2 или 3
-  * edx = ª®¤ ª« ¢¨è¨ ¤«ï ecx=2, ¨¤¥â¨ä¨ª â®à ª®¯ª¨ ¤«ï ecx=3
+  * edx = код клавиши для ecx=2, идентификатор кнопки для ecx=3
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * eax = 0 - ãá¯¥è®
+  * eax = 0 - успешно
-  * eax = 1 - ¡ãä¥à § ¯®«¥
+  * eax = 1 - буфер заполнен
 ======================================================================
-===================== ãªæ¨ï 73 - blit bitmap  =====================
+===================== Функция 73 - blit bitmap  =====================
 ======================================================================
-¡«¨â - ª®¯¨à®¢ ¨¥ ¡¨â®¢®£® ¬ áá¨¢
+блит - копирование битового массив
- à ¬¥âàë:
+Параметры:
-  * eax = 73 - ®¬¥à äãªæ¨¨
+  * eax = 73 - номер функции
-  * ebx = ROP ¨ ®¯æ¨® «ìë¥ ä« £¨
+  * ebx = ROP и опциональные флаги
 6 5  4 3   0
      [  reserved  ][T][B][ROP]
-     ROP - ª®¤ à áâà®¢ëå ®¯¥à æ¨©
+     ROP - код растровых операций
-: ª®¯¨à®¢ âì
+: копировать
--15:  à¥§¥à¢¨à®¢ ®
+-15: Зарезервировано
-     B   - ¡«¨â   ä®®¢ãî ¯®ä¥àå®áâì
+     B   - блит на фоновую поферхность
-     T   - ¡«¨â á ¯à®§à ç®áâìî
+     T   - блит с прозрачностью
-  * ecx = ãª § â¥«ì   ¯ à ¬¥âàë äãªæ¨¨
+  * ecx = указатель на параметры функции
-        á¬¥é¥¨¥ æ¥«¨ÿ¨ ®âá¥ç¥¨¥
+        смещение цели и отсечение
-     +0 signed dword: á¬¥é¥¨¥ ¯® X ®ª , ¤«ï æ¥«¥¢®£® ¯àï¬®ã£®«ì¨ª
+     +0 signed dword: смещение по X окна, для целевого прямоугольника
-                      ¢¥àå¨© «¥¢ë© ã£®«
+                      верхний левый угол
-     +4 signed dword: á¬¥é¥¨¥ ¯® Y ®ª , ¤«ï æ¥«¥¢®£® ¯àï¬®ã£®«ì¨ª
+     +4 signed dword: смещение по Y окна, для целевого прямоугольника
-                      ¢¥àå¨© «¥¢ë© ã£®«
+                      верхний левый угол
-     +8 dword:        è¨à¨  æ¥«¥¢®£® ¯àï¬®ã£®«ì¨ª
+     +8 dword:        ширина целевого прямоугольника
-    +12 dword:        ¢ëá®â  æ¥«¥¢®£® ¯àï¬®ã£®«ì¨ª
+    +12 dword:        высота целевого прямоугольника
-        á¬¥é¥¨¥ ¨áå®¤¨ª ÿ¨ ®âá¥ç¥¨¥
+        смещение исходника и отсечение
-    +16 signed dword: á¬¥é¥¨¥ ¯® X bitmap, ¤«ï ¨áå®¤®£® ¯àï¬®ã£®«ì¨ª
+    +16 signed dword: смещение по X bitmap, для исходного прямоугольника
-                      ¢¥àå¨© «¥¢ë© ã£®«
+                      верхний левый угол
-    +20 signed dword: á¬¥é¥¨¥ ¯® Y bitmap, ¤«ï ¨áå®¤®£® ¯àï¬®ã£®«ì¨ª
+    +20 signed dword: смещение по Y bitmap, для исходного прямоугольника
-                      ¢¥àå¨© «¥¢ë© ã£®«
+                      верхний левый угол
-    +24 dword:        è¨à¨  ¨áå®¤®£® ¯àï¬®ã£®«ì¨ª
+    +24 dword:        ширина исходного прямоугольника
-    +28 dword:        ¢ëá®â  ¨áå®¤®£® ¯àï¬®ã£®«ì¨ª
+    +28 dword:        высота исходного прямоугольника
-    +32: dword: ¤ ë¥ bitmap - ¤®«¦ë ¡ëâì 32bpp
+    +32: dword: данные bitmap - должны быть 32bpp
-    +36: dword: à §¬¥à áâà®ª¨ bitmap ¢ ¡ ©â å
+    +36: dword: размер строки bitmap в байтах
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â § ç¥¨ï
+  * функция не возвращает значения
 ======================================================================
-========== ãªæ¨ï -1 - § ¢¥àè¨âì ¢ë¯®«¥¨¥ ¯®â®ª /¯à®æ¥áá  =========
+========== Функция -1 - завершить выполнение потока/процесса =========
 ======================================================================
- à ¬¥âàë:
+Параметры:
-  * eax = -1 - ®¬¥à äãªæ¨¨
+  * eax = -1 - номер функции
-®§¢à é ¥¬®¥ § ç¥¨¥:
+Возвращаемое значение:
-  * äãªæ¨ï ¥ ¢®§¢à é ¥â ¨ § ç¥¨ï, ¨ ã¯à ¢«¥¨ï
+  * функция не возвращает ни значения, ни управления
- ¬¥ç ¨ï:
+Замечания:
-  * á«¨ ¯à®æ¥áá ï¢® ¥ á®§¤ ¢ « ¯®â®ª®¢, â® ã ¥£® ¥áâì â®«ìª®
+  * Если процесс явно не создавал потоков, то у него есть только
-    ®¤¨ ¯®â®ª, § ¢¥àè¥¨¥ ª®â®à®£® ¯à¨¢®¤¨â ª § ¢¥àè¥¨î ¯à®æ¥áá .
+    один поток, завершение которого приводит к завершению процесса.
-  * á«¨ â¥ªãé¨© ¯®â®ª - ¯®á«¥¤¨© ¢ ¯à®æ¥áá¥, â® ¥£® § ¢¥àè¥¨¥
+  * Если текущий поток - последний в процессе, то его завершение
-    â ª¦¥ ¯à¨¢®¤¨â ª § ¢¥àè¥¨î ¯à®æ¥áá .
+    также приводит к завершению процесса.
-  * â  äãªæ¨ï § ¢¥àè ¥â â¥ªãé¨© ¯®â®ª. àã£®© ¯®â®ª ¬®¦® ¯à¨¡¨âì
+  * Эта функция завершает текущий поток. Другой поток можно прибить
-    ¢ë§®¢®¬ ¯®¤äãªæ¨¨ 2 äãªæ¨¨ 18.
+    вызовом подфункции 2 функции 18.
 ======================================================================
-=========================== ¯¨á®ª á®¡ëâ¨© ===========================
+=========================== Список событий ===========================
 ======================================================================
-ç¥à¥¤®¥ á®¡ëâ¨¥ ¬®¦® ¯®«ãç¨âì ¢ë§®¢®¬ ®¤®© ¨§ äãªæ¨© 10
+Очередное событие можно получить вызовом одной из функций 10
-(®¦¨¤ âì á®¡ëâ¨ï), 11 (¯à®¢¥à¨âì ¡¥§ ®¦¨¤ ¨ï), 23
+(ожидать события), 11 (проверить без ожидания), 23
-(®¦¨¤ âì ¢ â¥ç¥¨¥ § ¤ ®£® ¢à¥¬¥¨).
+(ожидать в течение заданного времени).
-â¨ äãªæ¨¨ ¢®§¢à é îâ â®«ìª® â¥ á®¡ëâ¨ï, ª®â®àë¥ ¢å®¤ïâ ¢ ¬ áªã,
+Эти функции возвращают только те события, которые входят в маску,
-ãáâ  ¢«¨¢ ¥¬ãî äãªæ¨¥© 40. ® ã¬®«ç ¨î íâ® ¯¥à¢ë¥ âà¨, ç¥£®
+устанавливаемую функцией 40. По умолчанию это первые три, чего
-¢¯®«¥ ¤®áâ â®ç® ¤«ï ¬®£¨å ¯à¨«®¦¥¨©.
+вполне достаточно для многих приложений.
-®¤ë á®¡ëâ¨©:
+Коды событий:
-  * 1 = á®®¡é¥¨¥ ® ¯¥à¥à¨á®¢ª¥ (á¡à áë¢ ¥âáï ¯à¨ ¢ë§®¢¥ äãªæ¨¨ 0)
+  * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
-  * 2 =  ¦ â  ª« ¢¨è    ª« ¢¨ âãà¥ (¯®áâã¯ ¥â, â®«ìª® ª®£¤  ®ª®
+  * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
-     ªâ¨¢®) ¨«¨  ¦ â  "£®àïç ï ª« ¢¨è ";
+    активно) или нажата "горячая клавиша";
-    á¡à áë¢ ¥âáï, ª®£¤  ¢á¥ ª« ¢¨è¨ ¨§ ¡ãä¥à  áç¨â ë äãªæ¨¥© 2
+    сбрасывается, когда все клавиши из буфера считаны функцией 2
-  * 3 =  ¦ â  ª®¯ª , ®¯à¥¤¥«ñ ï à ¥¥ äãªæ¨¥© 8 (¨«¨ ª®¯ª
+  * 3 = нажата кнопка, определённая ранее функцией 8 (или кнопка
-    § ªàëâ¨ï, á®§¤  ï ¥ï¢® äãªæ¨¥© 0; ª®¯ª  ¬¨¨¬¨§ æ¨¨
+    закрытия, созданная неявно функцией 0; кнопка минимизации
-    ®¡à ¡ âë¢ ¥âáï á¨áâ¥¬®© ¨ ® ¥© á®®¡é¥¨ï ¥ ¯à¨å®¤¨â;
+    обрабатывается системой и о ней сообщения не приходит;
-    ¯®áâã¯ ¥â, â®«ìª® ª®£¤  ®ª®  ªâ¨¢®; á¡à áë¢ ¥âáï, ª®£¤  ¢á¥
+    поступает, только когда окно активно; сбрасывается, когда все
-    ª®¯ª¨ ¨§ ¡ãä¥à  áç¨â ë äãªæ¨¥© 17)
+    кнопки из буфера считаны функцией 17)
-  * 4 = § à¥§¥à¢¨à®¢ ® (¢ â¥ªãé¥© à¥ «¨§ æ¨¨ ¨ª®£¤  ¥ ¯à¨å®¤¨â ¤ ¦¥
+  * 4 = зарезервировано (в текущей реализации никогда не приходит даже
-    ¯à¨ à §¬ áª¨à®¢ª¥ äãªæ¨¥© 40)
+    при размаскировке функцией 40)
-  * 5 = § ¢¥àè¨« áì ¯¥à¥à¨á®¢ª  ä®  à ¡®ç¥£® áâ®«
+  * 5 = завершилась перерисовка фона рабочего стола
-  * 6 = á®¡ëâ¨¥ ®â ¬ëè¨ (çâ®-â® á«ãç¨«®áì -  ¦ â¨¥   ª®¯ªã ¬ëè¨
+  * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
-    ¨«¨ ¯¥à¥¬¥é¥¨¥; á¡à áë¢ ¥âáï ¯à¨ ¯à®çâ¥¨¨)
+    или перемещение; сбрасывается при прочтении)
-  * 7 = ¯à®¨§®è«® á®¡ëâ¨¥ IPC (á¬®âà¨ äãªæ¨î 60 - Inter Process
+  * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
-    Communication; á¡à áë¢ ¥âáï ¯à¨ ¯à®çâ¥¨¨)
+    Communication; сбрасывается при прочтении)
-  * 8 = ¯à®¨§®è«® á¥â¥¢®¥ á®¡ëâ¨¥ (á¡à áë¢ ¥âáï ¯à¨ ¯à®çâ¥¨¨;
+  * 8 = произошло сетевое событие (сбрасывается при прочтении;
-    á¬®âà¨ à ¡®âã á á¥âìî)
+    смотри работу с сетью)
-  * 9 = ¯à®¨§®è«® ®â« ¤®ç®¥ á®¡ëâ¨¥ (á¡à áë¢ ¥âáï ¯à¨ ¯à®çâ¥¨¨;
+  * 9 = произошло отладочное событие (сбрасывается при прочтении;
-    á¬®âà¨ ®â« ¤®çãî ¯®¤á¨áâ¥¬ã)
+    смотри отладочную подсистему)
-  * 16..31 = ¯à®¨§®è«® á®¡ëâ¨¥ á á®®â¢¥âáâ¢ãîé¨¬ IRQ
+  * 16..31 = произошло событие с соответствующим IRQ
-    (16=IRQ0, 31=IRQ15) (á¡à áë¢ ¥âáï ¯à¨ áç¨âë¢ ¨¨ ¢á¥å ¤ ëå IRQ)
+    (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)
 ======================================================================
-==================== ®¤ë ®è¨¡®ª ä ©«®¢®© á¨áâ¥¬ë ====================
+==================== Коды ошибок файловой системы ====================
 ======================================================================

Subversion Repositories Kolibri OS

(root)/kernel/branches/Kolibri-acpi/docs/sysfuncr.txt – Rev 3500 → 3555