API ядра

From KolibriOS wiki
Jump to navigation Jump to search


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

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

Перечень функций

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Подфункция 1 - сделать неактивным окно потока
  • Подфункция 2 - завершить процесс/поток по слоту.
  • Подфункция 3 - сделать активным окно заданного потока.
  • Подфункция 4 - получить счётчик пустых тактов в секунду.
  • Подфункция 5 - получить тактовую частоту.
  • Подфункция 6 - сохранить рамдиск в файл на жёстком диске.
  • Подфункция 7 - получить номер активного окна.
  • Подфункция 8 - отключить/разрешить звук спикера.
  • Подфункция 9 - завершение работы системы с параметром.
  • Подфункция 10 - свернуть окно приложения.
  • Подфункция 11 - получить информацию о дисковой подсистеме.
  • Подфункция 13 - получить версию ядра.
  • Подфункция 14 - ожидать начала обратного хода луча развёртки монитора.
  • Подфункция 15 - поместить курсор мыши в центр экрана.
  • Подфункция 16 - Получить размер свободной оперативной памяти.
  • Подфункция 17 - получить размер имеющейся оперативной памяти.
  • Подфункция 18 - завершить процесс/поток по идентификатору.
  • Подфункция 19 - получить/установить настройки мыши.
  • Подфункция 20 - получить информацию об оперативной памяти.
  • Подфункция 21 - получить номер слота процесса/потока по идентификатору.
  • Подфункция 22 - операции с окном другого процесса/потока.
  • Подфункция 23 - минимизировать все окна.
  • Подфункция 24 - установить пределы отрисовки.
  • Подфункция 25 - управление положением окна относительно других окон.

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

  • Подфункция 1 - сброс
  • Подфункция 2 - вывести байт

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

  • Подфункция 1 - установить базовый порт MPU MIDI.
  • Подфункция 2 - установить раскладку клавиатуры.
  • Подфункция 5 - установить язык системы.
  • Подфункция 11 - разрешить/запретить низкоуровневый доступ к HD.
  • Подфункция 12 - разрешить/запретить низкоуровневый доступ к PCI.

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

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

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

  • Подфункция 4 - извлечь лоток привода диска.
  • Подфункция 5 - загрузить лоток привода диска.

Функция 25 - записать область на слой фона.

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

  • Подфункция 1 - получить базовый порт MPU MIDI.
  • Подфункция 2 - получить раскладку клавиатуры.
  • Подфункция 5 - получить язык системы.
  • Подфункция 9 - получить значение счётчика времени.
  • Подфункция 10 - получить значение высокоточного счётчика времени.
  • Подфункция 11 - узнать, разрешён ли низкоуровневый доступ к HD.
  • Подфункция 12 - узнать, разрешён ли низкоуровневый доступ к PCI.

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

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

  • Подфункция 1 - установить текущую папку для потока.
  • Подфункция 2 - получить активную папку для потока.
  • Подфункция 3 - установить доп. системную директорию для ядра.
  • Подфункция 4 - установить текущую папку с указанием кодировки.
  • Подфункция 5 - получить текущую папку с указанием кодировки.

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

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

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

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

  • Подфункция 0 - экранные координаты мыши
  • Подфункция 1 - координаты мыши относительно окна
  • Подфункция 2 - состояния кнопок мыши
  • Подфункция 3 - состояния и события кнопок мыши
  • Подфункция 4 - загрузить курсор
  • Подфункция 5 - установить курсор
  • Подфункция 6 - удалить курсор
  • Подфункция 7 - данные прокрутки
  • Подфункция 8 - загрузить курсор с указанием кодировки

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

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

  • Подфункция 1 - получить размер фонового изображения.
  • Подфункция 2 - прочитать точку с фонового изображения.
  • Подфункция 4 - получить режим отрисовки фона.

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

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

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

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

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

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

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

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

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

Функция 54 - работа с буфером обмена

  • Подфункция 0 - узнать количество слотов в буфере обмена.
  • Подфункция 1 - считать данные из буфера обмена.
  • Подфункция 2 - записать данные в буфер обмена.
  • Подфункция 3 - удалить последний слот с данными в буфере обмена
  • Подфункция 4 - аварийный сброс блокировки буфера

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

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

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

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

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

  • Подфункция 1 - разрешение экрана
  • Подфункция 2 - число бит на пиксель
  • Подфункция 3 - число байт на строку

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

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

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

  • Подфункция 1 - запись байта
  • Подфункция 2 - чтение байта

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

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

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

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

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

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

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

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

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

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

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

Функция 71 - параметры окна.

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

Функция 73 - программный блиттер.

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

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

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

  • Подфункция 0 - Open socket (Открыть сокет).
  • Подфункция 1 - Close socket (Закрыть сокет).
  • Подфункция 2 - Bind (Привязка).
  • Подфункция 3 - Listen (Слушать).
  • Подфункция 4 - Connect (Соединение).
  • Подфункция 5 - Accept (Соглашение).
  • Подфункция 6 - Send (Послать).
  • Подфункция 7 - Receive (Получить).
  • Подфункция 8 - Set socket options (Задать опции сокета)
  • Подфункция 9 - Get socket options (Получить опции сокета)
  • Подфункция 10 - Get socketpair (Получить парный сокет).

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

Функция 77 - подсистема POSIX.

  • Подфункция 0 - Создать фьютекс
  • Подфункция 1 - Удалить фьютекс
  • Подфункция 2 - Ожидать
  • Подфункция 3 - Разбудить
  • Подфункция 4 - Зарезервирована
  • Подфункция 5 - Зарезервирована
  • Подфункция 6 - Зарезервирована
  • Подфункция 7 - Зарезервирована
  • Подфункция 8 - open(), пока не реализована
  • Подфункция 9 - close(), пока не реализована
  • Подфункция 10 - read(), чтение из файла в буфер
  • Подфункция 11 - write(), запись данных из буфера в файл
  • Подфункция 12 - dup3(), пока не реализована
  • Подфункция 13 - pipe2(), создание канала

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

Функция -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) (на новых версиях ядра не генерируются)

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

  • 0 = успешно
  • 2 = функция не поддерживается для данной файловой системы
  • 3 = неизвестная файловая система
  • 5 = файл не найден
  • 6 = файл закончился
  • 7 = указатель вне памяти приложения
  • 8 = диск заполнен
  • 9 = ошибка файловой системы
  • 10 = доступ запрещён
  • 11 = ошибка устройства
  • 12 = файловой системе недостаточно оперативной памяти

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

  • 30 = 0x1E = недостаточно памяти
  • 31 = 0x1F = файл не является исполнимым
  • 32 = 0x20 = слишком много процессов