Ru/api/kernel
СИСТЕМНЫЕ ФУНКЦИИ KolibriOS 0.7.7.0
Номер функции помещается в регистр eax. Вызов системной функции осуществляется командой "int 0x40". Все регистры, кроме явно указанных в возвращаемом значении, включая регистр флагов eflags, сохраняются.
Перечень функций
Функция 0 - определить и нарисовать окно.
Функция 1 - поставить точку в окне.
Функция 2 - получить код нажатой клавиши.
Функция 3 - получить системное время.
Функция 4 - вывести строку текста в окно.
Функция 5 - пауза.
Функция 6 - прочитать файл с рамдиска.
Функция 7 - вывести изображение в окно.
Функция 8 - определить/удалить кнопку.
Функция 9 - информация о потоке выполнения.
Функция 10 - ожидать события.
Функция 11 - проверить, есть ли событие, без ожидания.
Функция 12 - начать/закончить перерисовку окна.
Функция 13 - нарисовать прямоугольник в окне.
Функция 14 - получить размеры экрана.
Функция 15 - работа с фоновой графикой
Функция 16 - сохранить рамдиск на дискету.
Функция 17 - получить код нажатой кнопки.
Функция 18 - системные настройки и информация
Функция 20 - интерфейс MIDI.
Функция 21 - установка системных параметров
Функция 22 - установить системную дату/время.
Функция 23 - ожидать события с таймаутом.
Функция 24 - работа с проигрывателем компакт-дисков
Функция 25 - установить громкость SBPro. - Удалена
Функция 26 - аппаратный сервис
Функция 27 - сведения об этой функции отсутствуют
Функция 28 - установить громкость SB16. - Удалена
Функция 29 - получить системную дату.
Функция 30 - работа с текущей папкой.
Функция 31 - сведения об этой функции отсутствуют
Функция 32 - использовалась в ранних версиях КОС для удаления файла с рамдиска.- удалена
Функция 33 - использовалась в ранних версиях КОС для записи файла на рамдиск.-удалена
Функция 34 - сведения об этой функции отсутствуют
Функция 35 - прочитать цвет точки на экране.
Функция 36 - прочитать область экрана.
Функция 37 - работа с мышью.
Функция 38 - нарисовать отрезок.
Функция 39 - чтение фона.
Функция 40 - установить маску для ожидаемых событий.
Функция 41 - узнать владельца IRQ. - Удалена
Функция 42 - работа с данными, полученными по IRQ. - Удалена
Функция 43 - ввод/вывод в порт.
Функция 44 - определить действия при поступлении IRQ. - Удалена
Функция 45 - зарезервировать/освободить IRQ. - Удалена
Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
Функция 47 - вывести число в окно.
Функция 48 - стили отображения окон
Функция 49 - Advanced Power Management (APM).
Функция 50 - установка формы окна.
Функция 51 - создать поток.
Функция 52 - сетевой сервис.удалена
Функция 53 - работа с сетевым сокетами.удалена
Функция 54 - работа с буфером обмена
- Подфункция 0 - узнать количество слотов в буфере обмена.
- Подфункция 1 - считать данные из буфера обмена.
- Подфункция 2 - записать данные в буфер обмена.
- Подфункция 3 - удалить последний слот с данными в буфере обмена
- Подфункция 4 - аварийный сброс блокировки буфера
Функция 55 - аудио сервис.
- Подфункция 0 - загрузить данные для SB16.
- Подфункция 1 - начать проигрывать данные на SB16.
- Подфункция 2 - установить формат данных SB16.
- Подфункция 55 - начать проигрывать данные на встроенном спикере.
Функция 56 - Зарезервирована.
Функция 57 - PCI BIOS.
Функция 58 - работа с файловой системой.
- Подфункция 0 - прочитать файл/папку.
- Подфункция 8 - LBA-чтение с устройства.
- Подфункция 15 - получить информацию о файловой системе.
Функция 59 - Зарезервирована.
Функция 60 - Inter Process Communication (IPC).
- Подфункция 1 - установить область для получения IPC
Функция 61 - получить параметры для прямого доступа к графике.
Функция 62 - пользовательский доступ к PCI.
- Подфункция 0 - получить версию PCI-интерфейса.
- Подфункция 1 - получить номер последней PCI-шины.
- Подфункция 2 - Получить механизм обращения к конфигурационному пространству PCI.
- подфункции 4,5,6 - прочитать PCI-регистр.
- подфункции 8,9,10 - записать в PCI-регистр.
- подфункция 11 - инициализировать доступ к MMIO
- подфункция 12 - получить линейный адрес MMIO-блока
- подфункция 13 - освободить линейные адреса MMIO
Функция 63 - работа с доской отладки.
Функция 64 - перераспределить память приложения.
Функция 65 - вывести изображение с палитрой в окно.
Функция 66 - работа с клавиатурой.
- Подфункция 1 - установить режим ввода с клавиатуры.
- Подфункция 2 - получить режим ввода с клавиатуры.
- Подфункция 3 - получить состояние управляющих клавиш.
- Подфункция 4 - установить общесистемную "горячую клавишу".
- Подфункция 5 - удалить установленную "горячую клавишу".
Функция 67 - изменить положение/размеры окна.
Функция 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 - отладка.
- Подфункция 0 - определить область данных для отладочных сообщений.
- Подфункция 1 - получить состояние регистров отлаживаемого потока.
- Подфункция 2 - установить состояние регистров отлаживаемого потока.
- Подфункция 3 - отключиться от отлаживаемого процесса.
- Подфункция 4 - приостановить поток.
- Подфункция 5 - возобновить выполнение потока.
- Подфункция 6 - прочитать из памяти отлаживаемого процесса.
- Подфункция 7 - записать в память отлаживаемого процесса.
- Подфункция 8 - завершить отлаживаемый поток.
- Подфункция 9 - установить/снять аппаратную точку останова.
Функция 70 - работа с файловой системой с поддержкой длинных имён.
- Подфункция 0 - чтение файла с поддержкой длинных имён.
- Подфункция 1 - чтение папки с поддержкой длинных имён.
- Подфункция 2 - создание/перезапись файла с поддержкой длинных имён.
- Подфункция 3 - запись в существующий файл с поддержкой длинных имён.
- Подфункция 4 - установка размера файла.
- Подфункция 5 - получение информации о файле/папке.
- Подфункция 6 - установка атрибутов файла/папки.
- Подфункция 7 - запуск программы.
- Подфункция 8 - удаление файла/папки.
- Подфункция 9 - создание папки.
Описание функции перенесено в отдельную статью: Функция 71 - параметры окна
- Подфункция 1 - установить заголовок окна программы.
Функция 72 - послать сообщение окну.
- Подфункция 1 - послать сообщение с параметром активному окну.
Функция 73 - программный блиттер.
- Подфункция -1 - получить количество активных сетевых устройств.
- Подфункция 0 - получить тип сетевого устройства.
- Подфункция 1 - получить имя сетевого устройства.
- Подфункция 2 - сброс сетевого устройства.
- Подфункция 3 - остановить сетевое устройство.
Функция 75 - работа с сетевым сокетами.
- Подфункция 0 - Open socket (Открыть сокет).
- Подфункция 1 - Close socket (Закрыть сокет).
- Подфункция 2 - Bind (Привязка).
- Подфункция 3 - Listen (Слушать).
- Подфункция 4 - Connect (Соединение).
- Функция 75, подфункция 5, Accept (Соглашение).
- Функция 75, подфункция 6, Send (Послать).
- Функция 75, подфункция 7, Receive (Получить).
- Подфункция 8 - Set socket options (Задать опции сокета)
- Подфункция 9 - Get socket options(Получить опции сокета)
- Подфункция 10 - Get socketpair (Получить парный сокет).
Функция -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 = успешно
- 1 = не определена база и/или раздел жёсткого диска (подфункциями 7, 8 функции 21)
- 2 = функция не поддерживается для данной файловой системы
- 3 = неизвестная файловая система
- 4 = зарезервировано, никогда не возвращается в текущей реализации
- 5 = файл не найден
- 6 = файл закончился
- 7 = указатель вне памяти приложения
- 8 = диск заполнен
- 9 = таблица FAT разрушена
- 10 = доступ запрещён
- 11 = ошибка устройства
При запуске программы возможны также следующие коды ошибок:
- 30 = 0x1E = недостаточно памяти
- 31 = 0x1F = файл не является исполнимым
- 32 = 0x20 = слишком много процессов