Ru/api/kernel: Difference between revisions

From KolibriOS wiki
Jump to navigation Jump to search
Line 350: Line 350:
== Функция 58 - работа с файловой системой. ==
== Функция 58 - работа с файловой системой. ==


Параметры:
Описание функции перенесено в отдельную статью: [[SysFn58/ru | Функция 58]]
  * eax = 58
  * ebx = указатель на информационную структуру
Возвращаемое значение:
  * eax = 0 - успешно; иначе код ошибки файловой системы
  * в зависимости от подфункции может возвращаться значение и
    в других регистрах
Общий формат информационной структуры:
  * +0: dword: номер подфункции
  * +4: dword: номер блока
  * +8: dword: размер
  * +12 = +0xC: dword: указатель на данные
  * +16 = +0x10: dword: указатель на память для работы системы
    (4096 байт)
  * +20 = +0x14: n db: ASCIIZ-строка с именем файла
Уточнения - в документации на соответствующую подфункцию.
Имя файла нечувствительно к регистру латинских букв,
русские буквы должны быть заглавными.
Формат имени файла:
/base/number/dir1/dir2/.../dirn/file,
где /base/number идентифицирует устройство, на котором ищется файл:
одно из
  * /RD/1 = /RAMDISK/1 для доступа к рамдиску
  * /FD/1 = /FLOPPYDISK/1 для доступа к первому флоппи-дисководу,
    /FD/2 = /FLOPPYDISK/2 для второго флоппи-дисковода
  * /HD/x = /HARDDISK/x - устаревший вариант доступа к жёсткому диску
    (в этом случае база определяется подфункцией 7 функции 21),
    x - номер раздела (считая с 1)
  * /HD0/x, /HD1/x, /HD2/x, /HD3/x для доступа соответственно
    к устройствам IDE0 (Primary Master), IDE1 (Primary Slave),
    IDE2 (Secondary Master), IDE3 (Secondary Slave);
    x - номер раздела на выбранном винчестере, изменяется от 1 до 255
    (на каждом из винчестеров нумерация начинается с 1)
Замечания:
  * В первых двух случаях допускается использование FIRST вместо 1,
    SECOND вместо 2, но использовать эту возможность
    не рекомендуется для удобства перехода на будущие расширения.
  * Накладывается ограничение n<=39.
  * Имена папок и файла dir1,...,dirn,file должны быть в формате 8.3:
    имя не более 8 символов, точка, расширение не более 3 символов.
    Хвостовые пробелы игнорируются. Других пробелов быть не должно.
    Если имя занимает ровно 8 символов, точку можно опустить
    (хотя пользоваться этим не рекомендуется для удобства перехода
    на будущие расширения).
  * Функция не поддерживает папок на рамдиске.
Примеры:
  * '/RAMDISK/FIRST/KERNEL.ASM',0
    '/rd/1/kernel.asm',0
  * '/HD0/1/kernel.asm',0
  * '/hd0/1/menuet/pics/tanzania.bmp',0
Доступные подфункции:
  * подфункция 0 - чтение файла/папки
  * подфункция 8 - LBA-чтение с устройства
  * подфункция 15 - получение информации о файловой системе
 
 
=== Подфункция 0 - прочитать файл/папку. ===
 
Параметры:
  * eax = 58
  * ebx = указатель на информационную структуру
Формат информационной структуры:
  * +0: dword: 0 = номер подфункции
  * +4: dword: номер блока для чтения (считая с 0)
  * +8: dword: число блоков для чтения
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
  * +16 = +0x10: dword: указатель на буфер для работы системы
    (4096 байт)
  * +20 = +0x14: ASCIIZ-имя файла, правила формирования имён указаны в
    общем описании
Возвращаемое значение:
  * eax = 0 - успешно, иначе код ошибки файловой системы
  * ebx = размер файла (в байтах) или
    -1=0xffffffff, если файл не найден
Замечания:
  * Размер блока - 512 байт.
  * Эта функция устарела, для чтения файлов используйте подфункцию 0
    функции 70, для чтения папок - подфункцию 1 функции 70.
  * Функция позволяет читать содержимое папки. Из файловых систем
    поддерживается только FAT. Формат FAT-папки описан в любой
    документации по FAT.
  * Размер папки определяется по размеру цепочки кластеров в FAT.
  * Если файл кончился раньше, чем был прочитан последний запрошенный
    блок, то функция прочитает, сколько сможет, после чего вернёт
    eax=6 (EOF).
  * Функция позволяет читать корневые папки /rd/1,/fd/x,/hd[n]/x, но
    в первых двух случаях текущая реализация не следует
    установленным правилам:
    для /rd/1:
    * если указано 0 блоков для чтения, считается,
      что запрашивается 1;
    * если запрашивается больше 14 блоков или начальный блок
      не меньше 14-го, то возвращается eax=5 (not found) и ebx=-1;
    * размер корневого каталога рамдиска = 14 блоков,
      0x1C00=7168 байт; но возвращается ebx=0
      (за исключением случая предыдущего пункта);
    * как ни странно, можно прочитать 14-й блок (там, вообще говоря,
      мусор - напоминаю, счёт ведётся с 0);
    * если был запрошен хотя бы один блок с номером, не меньшим 14,
      то возвращается eax=6(EOF); иначе eax=0.
    Для /fd/x:
    * если начальный блок не меньше 14-го, то возвращается
      eax=5 (not found) и ebx=0;
    * кстати говоря, формат FAT12 допускает дискеты с размером
      корневого каталога меньше или больше 14 блоков;
    * проверки длины не делается;
    * если удалось прочитать данные с дискеты, возвращается
      eax=0,ebx=0; в противном случае eax=10 (access denied), ebx=-1.
  * Функция обрабатывает чтение специальных папок /,/rd,/fd,/hd[n];
    но результат не соответствует ожидаемому
    (по работе с обычными файлами/папками), не следует установленным
    правилам, может измениться в следующих версиях ядра и потому
    не описывается. Для получения информации об оборудовании
    используйте подфункцию 11 функции 18 или
    читайте соответствующие папки подфункцией 1 функции 70.
 
 
=== Подфункция 8 - LBA-чтение с устройства. ===
 
Параметры:
  * eax = 58 - номер функции
  * ebx = указатель на информационную структуру
Формат информационной структуры:
  * +0: dword: 8 = номер подфункции
  * +4: dword: номер блока для чтения (считая с 0)
  * +8: dword: игнорируется (устанавливайте в 1)
  * +12 = +0xC: dword: указатель на буфер, куда будут записаны данные
    (512 байт)
  * +16 = +0x10: dword: указатель на буфер для работы системы
    (4096 байт)
  * +20 = +0x14: ASCIIZ-имя устройства: нечувствительно к регистру,
    одно из /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n,
    1<=n<=4 - номер устройства: 1=IDE0, ..., 4=IDE3.
    Вместо цифр допускается, хотя и не рекомендуется для удобства
    перехода на будущие расширения,
    использование 'first','second','third','fourth'.
Возвращаемое значение:
  * если указано имя устройства /hd/xxx, где xxx не находится
    в списке выше:
    * eax = ebx = 1
  * если указано неправильное имя устройства
    (за исключением предыдущего случая):
    * eax = 5
    * ebx не меняется
  * если LBA-доступ запрещён подфункцией 11 функции 21:
    * eax = 2
    * ebx разрушается
  * для рамдиска: попытка чтения блока за пределами рамдиска
    (18*2*80 блоков) приводит к
    * eax = 3
    * ebx = 0
  * при успешном чтении:
    * eax = ebx = 0
Замечания:
  * Размер блока - 512 байт; читается один блок.
  * Не следует полагаться на возвращаемое значение,
    оно может измениться в следующих версиях.
  * Требуется, чтобы был разрешён LBA-доступ к устройствам
    подфункцией 11 функции 21. Узнать это можно вызовом
    подфункцией 11 функции 26.
  * LBA-чтение дискеты не поддерживается.
  * Функция считывает данные физического жёсткого диска;
    если по каким-то причинам нужны данные конкретного раздела,
    придётся определять начальный сектор этого раздела
    (либо напрямую через MBR, либо из расширенной структуры,
    возвращаемой той же подфункцией 11 функции 18).
  * Функция не проверяет код ошибки жёсткого диска, так что запрос
    несуществующего сектора всё равно что-то прочитает
    (вероятнее всего, нули, но это определяется устройством) и
    это будет считаться успехом (eax=0).
 
 
= Функция 58, подфункция 15 - получить информацию о файловой системе.
 
Параметры:
  * eax = 58 - номер функции
  * ebx = указатель на информационную структуру
Формат информационной структуры:
  * +0: dword: 15 = номер подфункции
  * +4: dword: игнорируется
  * +8: dword: игнорируется
  * +12 = +0xC: dword: игнорируется
  * +16 = +0x10: dword: игнорируется
  * +20 = +0x14: (проверяется только второй символ, сразу после слэша)
    /rd=/RAMDISK или /hd=/HARDDISK
Возвращаемое значение:
  * если второй символ не принадлежит множеству {'r','R','h','H'}:
    * eax = 3
    * ebx = ecx = dword [fileinfo] = 0
  * для рамдиска:
    * eax = 0 (успех)
    * ebx = общее число кластеров = 2847
    * ecx = число свободных кластеров
    * dword [fileinfo] = размер кластера = 512
  * для жёсткого диска: база и раздел определяются подфункциями 7 и 8
    функции 21:
    * eax = 0 (успех)
    * ebx = общее число кластеров
    * ecx = число свободных кластеров
    * dword [fileinfo] = размер кластера (в байтах)
Замечания:
  * Не удивляйтесь странному расположению 4-го возвращаемого
    параметра - когда писался этот код, при системных вызовах
    приложению возвращались только регистры eax,ebx,ecx (из
    pushad-структуры, передающейся как аргумент системной функции).
    Теперь это исправлено, так что, возможно, имеет смысл возвращать
    размер кластера в edx, пока эту функцию не начали использовать.
  * Вообще-то ещё существует подфункция 11 функции 18, возвращающая
    информацию о файловой системе. По расширенной таблице дисковой
    подсистемы можно определить размер кластера (там он хранится
    в секторах) и общее число кластеров для жёстких дисков.
 


== Функция 60 - Inter Process Communication (IPC). ==
== Функция 60 - Inter Process Communication (IPC). ==

Revision as of 15:47, 10 April 2010

СИСТЕМНЫЕ ФУНКЦИИ KolibriOS 0.7.7.0

Номер функции помещается в регистр eax. Вызов системной функции осуществляется командой "int 0x40". Все регистры, кроме явно указанных в возвращаемом значении, включая регистр флагов eflags, сохраняются.


Функция 0 - определить и нарисовать окно.

Определяет окно приложения. Рисует рамку окна, заголовок и рабочую область. Для окон со скином определяет стандартные кнопки закрытия и минимизации.

Описание функции перенесено в отдельную статью: Функция 0

Функция 1 - поставить точку в окне.

Описание функции перенесено в отдельную статью: Функция 1

Функция 2 - получить код нажатой клавиши.

Извлекает из буфера код нажатой клавиши.

Описание функции перенесено в отдельную статью: Функция 2

Функция 3 - получить системное время.

Описание функции перенесено в отдельную статью: Функция 3

Функция 4 - вывести строку текста в окно.

Описание функции перенесено в отдельную статью: Функция 4

Функция 5 - пауза.

Задерживает выполнение программы на заданное время.

Описание функции перенесено в отдельную статью: Функция 5

Функция 6 - прочитать файл с рамдиска.

Описание функции перенесено в отдельную статью: Функция 6

Функция 7 - вывести изображение в окно.

Описание функции перенесено в отдельную статью: Функция 7

Функция 8 - определить/удалить кнопку.

Описание функции перенесено в отдельную статью: Функция 8

Функция 9 - информация о потоке выполнения.

Описание функции перенесено в отдельную статью: Функция 9

Функция 10 - ожидать события.

Если очередь сообщений пуста, то ждет появления сообщения в очереди. В таком состоянии поток не получает процессорного времени. Затем считывает сообщение из очереди.

Описание функции перенесено в отдельную статью: Функция 10

Функция 11 - проверить, есть ли событие, без ожидания.

Если в очереди сообщений есть какое-то событие, то считывает и возвращает его. Если очередь пуста, возвращает нуль.

Описание функции перенесено в отдельную статью: Функция 11

Функция 12 - начать/закончить перерисовку окна.

Подфункция 1 - начать перерисовку окна. Подфункция 2 - закончить перерисовку окна.

Перенесены в отдельную статью: Функция 12

Функция 13 - нарисовать прямоугольник в окне.

Функция перенесена в статью Функция 13

Функция 14 - получить размеры экрана.

Описание функции перенесено в отдельную статью: Функция 14

Функция 15 - работа с фоновой графикой

Описание функции перенесено в отдельную статью: Функция 15

Функция 16 - сохранить рамдиск на дискету.

Описание функции перенесено в отдельную статью: Функция 16

Функция 17 - получить код нажатой кнопки.

Описание функции перенесено в отдельную статью: Функция 17

Функция 18 - системные настройки и информация

Описание функции перенесено в отдельную статью: Функция 18

Функция 20 - интерфейс MIDI.

Описание функции перенесено в отдельную статью: Функция 20

Функция 21 - установка системных параметров

Описание функции перенесено в отдельную статью: Функция 21

Функция 22 - установить системную дату/время.

Описание функции перенесено в отдельную статью: Функция 22

Функция 23 - ожидать события с таймаутом.

Описание функции перенесено в отдельную статью: Функция 23

Функция 24 - работа с проигрывателем компакт-дисков

Описание функции перенесено в отдельную статью: Функция 24

Функция 25 - установить громкость SBPro.

Удалена

Функция 26 - аппаратный сервис

Описание функции перенесено в отдельную статью: Функция 26

Функция 27

сведения об этой функции отсутствуют

Функция 28 - установить громкость SB16.

Удалена

Функция 29 - получить системную дату.

Описание функции перенесено в отдельную статью: Функция 29

Функция 30 - работа с текущей папкой.

Описание функции перенесено в отдельную статью: Функция 30

Функция 31

сведения об этой функции отсутствуют

Функция 32

Системная функция с этим номером использовалась в ранних версиях КОС для удаления файла с рамдиска. удалена

Функция 33

Системная функция с этим номером использовалась в ранних версиях КОС для записи файла на рамдиск. удалена

Функция 34

сведения об этой функции отсутствуют

Функция 35 - прочитать цвет точки на экране.

Описание функции перенесено в отдельную статью: Функция 35

Функция 36 - прочитать область экрана.

Описание функции перенесено в отдельную статью: Функция 36

Функция 37 - работа с мышью.

Описание функции перенесено в отдельную статью: Функция 37

Функция 38 - нарисовать отрезок.

Описание функции перенесено в отдельную статью: Функция 38

Функция 39 - чтение фона.

Описание функции перенесено в отдельную статью: Функция 39

Функция 40 - установить маску для ожидаемых событий.

Описание функции перенесено в отдельную статью: Функция 40

Функция 41 - узнать владельца IRQ.

Описание функции перенесено в отдельную статью: Функция 41

Функция 42 - работа с данными, полученными по IRQ.

Описание функции перенесено в отдельную статью: Функция 42

Функция 43 - ввод/вывод в порт.

Описание функции перенесено в отдельную статью: Функция 43

Функция 44 - определить действия при поступлении IRQ.

Описание функции перенесено в отдельную статью: Функция 44

Функция 45 - зарезервировать/освободить IRQ.

Описание функции перенесено в отдельную статью: Функция 45

Функция 46 - зарезервировать/освободить группу портов ввода/вывода.

Внимание: Эта функция устарела и может быть удалена в следующих версиях ядра.

Описание функции перенесено в отдельную статью: Функция 46

Функция 47 - вывести число в окно.

Описание функции перенесено в отдельную статью: Функция 47

Функция 48 - стили отображения окон

Описание функции перенесено в отдельную статью: Функция 48

Функция 49 - Advanced Power Management (APM).

Описание функции перенесено в отдельную статью: Функция 49

Функция 50 - установка формы окна.

Описание функции перенесено в отдельную статью: Функция 50

Функция 51 - создать поток.

Описание функции перенесено в отдельную статью: Функция 51

Функция 52 - сетевой сервис.

Описание функции перенесено в отдельную статью: Функция 52

Функция 53 - работа с сетевым сокетами.

Описание функции перенесено в отдельную статью: Функция 53

Функция 54

Описание сисфункции с этим номером отсутствует.

Функция 55 - аудио сервис.

Подфункция 0 - загрузить данные для SB16.

Параметры: 

 * eax = 55 - номер функции
 * ebx = 0 - номер подфункции
 * ecx = указатель на данные (копируется 64 килобайта, используется
   столько, сколько установлено подфункцией 2)

Возвращаемое значение: 

 * функция не возвращает значения

Замечания: 

 * Формат и размер данных устанавливаются подфункцией 2.


Подфункция 1 - начать проигрывать данные на SB16.

Параметры: 

 * eax = 55 - номер функции
 * ebx = 1 - номер подфункции

Возвращаемое значение: 

 * функция не возвращает значения

Замечания: 

 * Предварительно данные должны быть загружены подфункцией 0 и
   определён их формат подфункцией 2.
 * Функция возвращает управление, когда началось проигрывание данных;
   после этого проигрывание идёт независимо от приложения (и вообще
   не требует загрузки процессора).
 * Предварительно должны быть определены базовый порт SB16
   (подфункцией 4 функции 21) и канал DMA
   (подфункцией 10 функции 21).


Подфункция 2 - установить формат данных SB16.

Параметры: 

 * eax = 55 - номер функции
 * ebx = 2 - номер подфункции
 * ecx = 0 - установить разрядность
   * edx = 1 - 8бит моно
   * edx = 2 - 8бит стерео
 * ecx = 1 - установить размер данных
   * edx = размер в байтах
 * ecx = 2 - установить частоту проигрывания
   * edx = частота

Возвращаемое значение: 

 * функция не возвращает значения

Замечания: 

 * При загрузке системы устанавливаются следующие параметры
   по умолчанию: разрядность - 8 бит моно, размер - 64 Кб,
   частота 44100 Гц. Тем не менее рекомендуется явно устанавливать
   необходимые значения, поскольку они могли быть переустановлены
   какой-нибудь программой.


Подфункция 55 - начать проигрывать данные на встроенном спикере.

Параметры: 

 * eax = 55 - номер функции
 * ebx = 55 - номер подфункции
 * esi = указатель на данные

Возвращаемое значение: 

 * eax = 0 - успешно
 * eax = 55 - ошибка (спикер отключён или занят)

Данные - это массив элементов переменной длины. Формат каждого элемента определяется первым байтом: 

 * 0 = конец данных
 * 1..0x80 = задаёт длительность звучания в сотых долях секунды
   ноты, определяемой непосредственным значением частоты
   * следующее слово (2 байта) содержит делитель частоты;
     частота определяется как 1193180/divider
 * 0x81 = invalid
 * 0x82..0xFF = нота, определяемая октавой и номером:
   * длительность в сотых долях секунды = (первый байт)-0x81
   * присутствует ещё один байт;
   * (второй байт)=0xFF - пауза
   * иначе он имеет вид a*0x10+b, где b=номер ноты в октаве от 1
     до 12, a=номер октавы (считая с 0)

Замечания: 

 * Пищание спикером может быть запрещено/разрешено подфункцией 8
   функции 18.
 * Функция возвращает управление, сообщив куда следует информацию
   о запросе. Само проигрывание идёт независимо от программы.
 * Данные должны сохраняться в памяти по крайней мере
   до конца проигрывания.


Функция 57 - PCI BIOS.

Параметры: 

 * eax = 57 - номер функции
 * ebp соответствует регистру al в спецификации PCI BIOS
 * остальные регистры - по спецификации PCI BIOS

Возвращаемое значение: 

 * CF не определён
 * остальные регистры - по спецификации PCI BIOS

Замечания: 

 * Многих результатов этой функции можно также добиться вызовом
   соответствующих подфункций функции 62.
 * Функция вызывает расширение PCI32 BIOS, документированное,
   например, в http://alpha1.dyns.net/files/PCI/bios21.pdf.
 * Если BIOS не поддерживает это расширение, поведение функции
   эмулируется (через аналоги подфункций функции 62 режима ядра).


Функция 58 - работа с файловой системой.

Описание функции перенесено в отдельную статью: Функция 58

Функция 60 - Inter Process Communication (IPC).

Описание функции перенесено в отдельную статью: Функция 60

Подфункция 1 - установить область для получения IPC

Функция 61 - получить параметры для прямого доступа к графике.

Описание функции перенесено в отдельную статью: Функция 61

Функция 62 - пользовательский доступ к PCI.

Описание функции перенесено в отдельную статью: Функция 62

  • Подфункция 0 - получить версию PCI-интерфейса.
  • Подфункция 1 - получить номер последней PCI-шины.
  • Подфункция 2 - Получить механизм обращения к конфигурационному пространству PCI.
  • подфункции 4,5,6 - прочитать PCI-регистр.
  • подфункции 8,9,10 - записать в PCI-регистр.
  • подфункция 11 - инициализировать доступ к MMIO
  • подфункция 12 - получить линейный адрес MMIO-блока
  • подфункция 13 - освободить линейные адреса MMIO

Функция 63 - работа с доской отладки.

Описание функции перенесено в отдельную статью: Функция 63

Функция 64 - перераспределить память приложения.

Описание функции перенесено в отдельную статью: Функция 64

Функция 65 - вывести изображение с палитрой в окно.

Описание функции перенесено в отдельную статью: Функция 65

Функция 66 - работа с клавиатурой.

Описание функции перенесено в отдельную статью: Функция 66

  • Подфункция 1 - установить режим ввода с клавиатуры.
  • Подфункция 2 - получить режим ввода с клавиатуры.
  • Подфункция 3 - получить состояние управляющих клавиш.
  • Подфункция 4 - установить общесистемную "горячую клавишу".
  • Подфункция 5 - удалить установленную "горячую клавишу".

Функция 67 - изменить положение/размеры окна.

Описание функции перенесено в отдельную статью: Функция 67

Функция 68 - внутренние системные службы

Описание функции перенесено в отдельную статью: Функция 68

  • Подфункция 0 - получить счётчик переключений задач.
  • Подфункция 1 - переключиться на следующий поток выполнения.
  • Подфункция 2 - кэш + rdpmc.
  • Подфункция 3 - прочитать MSR-регистр.
  • Подфункция 4 - записать в MSR-регистр.
  • Подфункция 11 - инициализировать кучу процесса.
  • Подфункция 12 - выделить блок памяти.
  • Подфункция 13 - освободить блок памяти.
  • Подфункция 14 - ожидать извещения от драйвера.
  • Подфункция 15 - установить обработчик исключений FPU.
  • Подфункция 16 - загрузить драйвер.
  • Подфункция 17 - управление драйвером.
  • Подфункция 18 - установить обработчик исключений SSE.
  • Подфункция 19 - загрузить DLL.
  • Подфункция 20 - перераспределить блок памяти.
  • Подфункция 22 - открыть именованую область памяти.
  • Подфункция 23 - закрыть именованую область памяти.

Функция 69 - отладка.

Описание функции перенесено в отдельную статью: Функция 69

  • Подфункция 0 - определить область данных для отладочных сообщений.
  • Подфункция 1 - получить состояние регистров отлаживаемого потока.
  • Подфункция 2 - установить состояние регистров отлаживаемого потока.
  • Подфункция 3 - отключиться от отлаживаемого процесса.
  • Подфункция 4 - приостановить поток.
  • Подфункция 5 - возобновить выполнение потока.
  • Подфункция 6 - прочитать из памяти отлаживаемого процесса.
  • Подфункция 7 - записать в память отлаживаемого процесса.
  • Подфункция 8 - завершить отлаживаемый поток.
  • Подфункция 9 - установить/снять аппаратную точку останова.

Функция 70 - работа с файловой системой с поддержкой длинных имён.

Описание функции перенесено в отдельную статью: Функция 70

  • Подфункция 0 - чтение файла с поддержкой длинных имён.
  • Подфункция 1 - чтение папки с поддержкой длинных имён.
  • Подфункция 2 - создание/перезапись файла с поддержкой длинных имён.
  • Подфункция 3 - запись в существующий файл с поддержкой длинных имён.
  • Подфункция 4 - установка размера файла.
  • Подфункция 5 - получение информации о файле/папке.
  • Подфункция 6 - установка атрибутов файла/папки.
  • Подфункция 7 - запуск программы.
  • Подфункция 8 - удаление файла/папки.
  • Подфункция 9 - создание папки.

Функция 72 - послать сообщение окну.

Описание функции перенесено в отдельную статью: Функция 72

Подфункция 1 - послать сообщение с параметром активному окну.

Функция -1 - завершить выполнение потока/процесса

Описание функции перенесено в отдельную статью: Функция -1

Список событий

Очередное событие можно получить вызовом одной из функций 10 (ожидать события), 11 (проверить без ожидания), 23 (ожидать в течение заданного времени). Эти функции возвращают только те события, которые входят в маску, устанавливаемую функцией 40. По умолчанию это первые три, чего вполне достаточно для многих приложений. Коды событий: 

 * 1 = сообщение о перерисовке (сбрасывается при вызове функции 0)
 * 2 = нажата клавиша на клавиатуре (поступает, только когда окно
   активно) или нажата "горячая клавиша";
   сбрасывается, когда все клавиши из буфера считаны функцией 2
 * 3 = нажата кнопка, определённая ранее функцией 8 (или кнопка
   закрытия, созданная неявно функцией 0; кнопка минимизации
   обрабатывается системой и о ней сообщения не приходит;
   поступает, только когда окно активно; сбрасывается, когда все
   кнопки из буфера считаны функцией 17)
 * 4 = зарезервировано (в текущей реализации никогда не приходит даже
   при размаскировке функцией 40)
 * 5 = перерисовывается фон рабочего стола (сбрасывается
   автоматически после перерисовки, так что если во время перерисовки
   фона программа не ждёт и не проверяет события, то этого события
   она не заметит)
 * 6 = событие от мыши (что-то случилось - нажатие на кнопку мыши
   или перемещение; сбрасывается при прочтении)
 * 7 = произошло событие IPC (смотри функцию 60 - Inter Process
   Communication; сбрасывается при прочтении)
 * 8 = произошло сетевое событие (сбрасывается при прочтении;
   смотри работу с сетью)
 * 9 = произошло отладочное событие (сбрасывается при прочтении;
   смотри отладочную подсистему)
 * 16..31 = произошло событие с соответствующим IRQ
   (16=IRQ0, 31=IRQ15) (сбрасывается при считывании всех данных IRQ)


Коды ошибок файловой системы

 * 0 = успешно
 * 1 = не определена база и/или раздел жёсткого диска (подфункциями
   7, 8 функции 21)
 * 2 = функция не поддерживается для данной файловой системы
 * 3 = неизвестная файловая система
 * 4 = зарезервировано, никогда не возвращается в текущей реализации
 * 5 = файл не найден
 * 6 = файл закончился
 * 7 = указатель вне памяти приложения
 * 8 = диск заполнен
 * 9 = таблица FAT разрушена
 * 10 = доступ запрещён
 * 11 = ошибка устройства

При запуске программы возможны также следующие коды ошибок: 

 * 30 = 0x1E = недостаточно памяти
 * 31 = 0x1F = файл не является исполнимым
 * 32 = 0x20 = слишком много процессов
Retrieved from "http://wiki.kolibrios.org/index.php?title=Ru/api/kernel&oldid=2646"