Ru/api/kernel
СИСТЕМНЫЕ ФУНКЦИИ 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 - работа с файловой системой.
Параметры:
* 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).
IPC применяется для посылок сообщений от одного процесса/потока другому. При этом следует предварительно договориться о том, как интерпретировать конкретное сообщение.
Подфункция 1 - установить область для получения IPC
Вызывается процессом-приёмником. Параметры:
* eax = 60 - номер функции * ebx = 1 - номер подфункции * ecx = указатель на буфер * edx = размер буфера
Возвращаемое значение:
* eax = 0 - всегда успешно
Формат IPC-буфера:
* +0: dword: если здесь не 0, то буфер считается заблокированным; блокируйте/разблокируйте буфер, когда вы с ним активно работаете и вам надо, чтобы извне не изменялись данные буфера (не поступали новые сообщения) * +4: dword: занято места в буфере (в байтах) * +8: первое сообщение * +8+n: второе сообщение * ...
Формат сообщения:
* +0: dword: PID процесса/потока, пославшего сообщение * +4: dword: длина сообщения (не считая этот заголовок) * +8: n*byte: данные сообщения
=== Подфункция 2 - послать сообщение IPC. ===- Вызывается процессом-инициатором. Параметры:
* eax = 60 - номер функции * ebx = 2 - номер подфункции * ecx = PID приёмника * edx = указатель на данные сообщения * esi = длина сообщения (в байтах)
Возвращаемое значение:
* eax = 0 - успешно * eax = 1 - приёмник не определил буфер для IPC-сообщений (может быть, ещё не успел, а может быть, это не тот поток, который нужен) * eax = 2 - приёмник заблокировал IPC-буфер; попробуйте немного подождать * eax = 3 - переполнение IPC-буфера приёмника * eax = 4 - процесса/потока с таким PID не существует
Замечания:
* Система сразу после записи IPC-сообщения в буфер посылает потоку-приёмнику событие с кодом 7 (см. коды событий).
Функция 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 = слишком много процессов