| 86,9 → 86,9 |
|---|
| * рисуется внешняя рамка цвета, указанного в edi, |
| шириной 1 пиксель |
| * рисуется заголовок - прямоугольник с левым верхним углом (1,1) |
| и правым нижним (xsize-1,min(25,ysize)) цвета, указанного в esi |
| и правым нижним (xsize-1,min(20,ysize-1)) цвета, указанного в esi |
| (с учетом градиента) |
| * если ysize>=26, то закрашивается рабочая область окна - |
| * если ysize>21, то закрашивается рабочая область окна - |
| прямоугольник с левым верхним углом (1,21) и правым нижним |
| (xsize-1,ysize-1) (размерами (xsize-1)*(ysize-21)) - цветом, |
| указанным в edx (с учетом градиента) |
| 151,7 → 151,9 |
|---|
| Возвращаемое значение: |
| * если буфер пуст, возвращается eax=1 |
| * если буфер непуст, то возвращается al=0, ah=код нажатой клавиши, |
| старшее слово регистра eax обнулено |
| биты 16-23 содержат сканкод нажатой клавиши в режиме ASCII, |
| в режме сканкодов биты обнулены. |
| биты 23-31 обнулены |
| * если есть "горячая клавиша", то возвращается |
| al=2, ah=сканкод нажатой клавиши (0 для управляющих клавиш), |
| старшее слово регистра eax содержит состояние управляющих клавиш |
| 816,9 → 818,9 |
|---|
| вызове, оно может измениться в последующих версиях ядра. |
| |
| ====================================================================== |
| ======== Функция 18, подфункция 10 - свернуть окно приложения. ======= |
| ========= Функция 18, подфункция 10 - свернуть активное окно. ======== |
| ====================================================================== |
| Сворачивает собственное окно. |
| Сворачивает активное окно. |
| Параметры: |
| * eax = 18 - номер функции |
| * ebx = 10 - номер подфункции |
| 843,8 → 845,7 |
|---|
| * eax = 18 - номер функции |
| * ebx = 11 - номер подфункции |
| * ecx = тип таблицы: |
| * 1 = короткая версия, 10 байт |
| * 2 = полная версия, 65536 байт |
| * 1 = короткая версия, 16 байт |
| * edx = указатель на буфер (в приложении) для таблицы |
| Возвращаемое значение: |
| * функция не возвращает значения |
| 861,6 → 862,8 |
|---|
| Например, для стандартной конфигурации из одного 1.44-дисковода |
| здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B: |
| значение оказывается 24h. |
| |
| Первый контроллер IDE: |
| * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD, |
| где AA соответствует контроллеру IDE0, ..., DD - IDE3: |
| * 0 = устройство отсутствует |
| 869,31 → 872,36 |
|---|
| Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h. |
| * +2: 4 db: число найденных разделов на жёстких дисках с |
| соответственно IDE0,...,IDE3. |
| |
| Второй контроллер IDE: |
| * +6: byte: информация о жёстких дисках и CD-приводах, AABBCCDD |
| где AA соответствует контроллеру IDE4, ..., DD - IDE7: |
| * 0 = устройство отсутствует |
| * 1 = жёсткий диск |
| * 2 = CD-привод |
| Например, в случае HD на IDE4 и CD на IDE6 здесь будет 48h. |
| * +7: 4 db: число найденных разделов на жёстких дисках с |
| соответственно IDE4,...,IDE7. |
| |
| Третий контроллер IDE: |
| * +11: byte: информация о жёстких дисках и CD-приводах, AABBCCDD |
| где AA соответствует контроллеру IDE8, ..., DD - IDE11: |
| * 0 = устройство отсутствует |
| * 1 = жёсткий диск |
| * 2 = CD-привод |
| Например, в случае HD на IDE8 и CD на IDE10 здесь будет 48h. |
| * +12: 4 db: число найденных разделов на жёстких дисках с |
| соответственно IDE8,...,IDE11. |
| |
| При отсутствии жёсткого диска на IDEx соответствующий байт |
| нулевой, при наличии показывает число распознанных разделов, |
| которых может и не быть (если носитель не отформатирован или |
| если файловая система не поддерживается). В текущей версии ядра |
| для жёстких дисков поддерживаются только FAT16, FAT32 и NTFS. |
| * +6: 4 db: зарезервировано |
| Формат таблицы: полная версия: |
| * +0: 10 db: такие же, как и в короткой версии |
| * +10: 100 db: данные для первого раздела |
| * +110: 100 db: данные для второго раздела |
| * ... |
| * +10+100*(n-1): 100 db: данные для последнего раздела |
| Разделы расположены в следующем порядке: сначала последовательно все |
| распознанные разделы на HD на IDE0 (если есть), |
| затем на HD на IDE1 (если есть) и т.д. до IDE3. |
| Формат информации о разделе: |
| * +0: dword: начальный физический сектор раздела |
| * +4: dword: последний физический сектор раздела |
| (принадлежит разделу) |
| * +8: byte: тип файловой системы: |
| 16=FAT16, 32=FAT32, 1=NTFS |
| * формат дальнейших данных зависит от файловой системы, |
| может меняться с изменениями в ядре и поэтому не описывается |
| для жёстких дисков поддерживаются только FAT12/16/32, NTFS, |
| ext2/3/4 и XFS. |
| |
| Замечания: |
| * Короткая таблица может быть использована для получения информации |
| * Таблица может быть использована для получения информации |
| об имеющихся устройствах. |
| |
| ====================================================================== |
| 1209,20 → 1217,6 |
|---|
| * Приложение @panel переключает раскладки по запросу пользователя. |
| |
| ====================================================================== |
| =========== Функция 21, подфункция 3 - установить базу CD. =========== |
| ====================================================================== |
| Параметры: |
| * eax = 21 - номер функции |
| * ebx = 3 - номер подфункции |
| * ecx = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3 |
| Возвращаемое значение: |
| * eax = 0 |
| Замечания: |
| * База CD используется функцией 24. |
| * Получить установленную базу CD можно вызовом |
| подфункции 3 функции 26. |
| |
| ====================================================================== |
| ========= Функция 21, подфункция 5 - установить язык системы. ======== |
| ====================================================================== |
| Параметры: |
| 1240,52 → 1234,6 |
|---|
| * Получить язык системы можно вызовом подфункции 5 функции 26. |
| |
| ====================================================================== |
| =========== Функция 21, подфункция 7 - установить базу HD. =========== |
| ====================================================================== |
| База HD нужна для определения, на какой жёсткий диск писать, при |
| использовании устаревшего синтаксиса /HD в устаревшей функции 58; |
| при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3 |
| база устанавливается автоматически. |
| Параметры: |
| * eax = 21 - номер функции |
| * ebx = 7 - номер подфункции |
| * ecx = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3 |
| Возвращаемое значение: |
| * eax = 0 |
| Замечания: |
| * Любое приложение в любой момент времени может изменить базу. |
| * Не следует изменять базу, когда какое-нибудь приложение работает |
| с жёстким диском. Если не хотите глюков системы. |
| * Получить установленную базу можно вызовом подфункции 7 функции 26. |
| * Следует также определить используемый раздел жёсткого диска |
| подфункцией 8. |
| |
| ====================================================================== |
| ========== Функция 21, подфункция 8 - установить раздел HD. ========== |
| ====================================================================== |
| Раздел HD нужен для определения, на какой раздел жёсткого диска |
| писать, при использовании устаревшего синтаксиса /HD в устаревшей |
| функции 58; при использовании современного синтаксиса |
| /HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически. |
| Параметры: |
| * eax = 21 - номер функции |
| * ebx = 8 - номер подфункции |
| * ecx = раздел HD (считая с 1) |
| Возвращаемое значение: |
| * eax = 0 |
| Замечания: |
| * Любое приложение в любой момент времени может изменить раздел. |
| * Не следует изменять раздел, когда какое-нибудь приложение работает |
| с жёстким диском. Если не хотите глюков системы. |
| * Получить установленный раздел можно вызовом подфункции 8 |
| функции 26. |
| * Проверок на корректность не делается. |
| * Узнать число разделов на жёстком диске можно вызовом |
| подфункции 11 функции 18. |
| * Следует также определить используемую базу жёсткого диска |
| подфункцией 7. |
| |
| ====================================================================== |
| ====================== Функция 21, подфункция 11 ===================== |
| =========== Разрешить/запретить низкоуровневый доступ к HD. ========== |
| ====================================================================== |
| 1316,122 → 1264,6 |
|---|
| * Получить текущее состояние можно вызовом подфункции 12 функции 26. |
| |
| ====================================================================== |
| ============= Функция 21, подфункция 13, подподфункция 1 ============= |
| ==== Инициализировать + получить информацию о драйвере vmode.mdr. ==== |
| ====================================================================== |
| Параметры: |
| * eax = 21 - номер функции |
| * ebx = 13 - номер подфункции |
| * ecx = 1 - номер функции драйвера |
| * edx = указатель на буфер размера 512 байт |
| Возвращаемое значение: |
| * если драйвер не загружен (никогда не бывает в текущей реализации): |
| * eax = -1 |
| * ebx, ecx разрушаются |
| * если драйвер загружен: |
| * eax = 'MDAZ' (в стиле fasm'а, т.е. 'M' - младший байт, |
| 'Z' - старший) - сигнатура |
| * ebx = текущая частота развёртки (в Гц) |
| * ecx разрушается |
| * буфер, на который указывает edx, заполнен |
| Формат буфера: |
| * +0: 32*byte: имя драйвера, "Trans VideoDriver" (без кавычек, |
| дополнено пробелами) |
| * +32 = +0x20: dword: версия драйвера (версия x.y кодируется как |
| y*65536+x), для текущей реализации 1 (1.0) |
| * +36 = +0x24: 7*dword: зарезервировано (0 в текущей реализации) |
| * +64 = +0x40: 32*word: список поддерживаемых видеорежимов (каждое |
| слово - номер видеорежима, после собственно списка идут нули) |
| * +128 = +0x80: 32*(5*word): список поддерживаемых частот развёрток |
| для видеорежимов: для каждого видеорежима, указанного в предыдущем |
| поле, указано до 5 поддерживаемых частот |
| (в неиспользуемых позициях записаны нули) |
| Замечания: |
| * Функция инициализирует драйвер (если он ещё не инициализирован) |
| и должна вызываться первой, перед остальными (иначе они будут |
| возвращать -1, ничего не делая). |
| * В текущей реализации поддерживается только одна частота развёртки |
| на видеорежим. |
| |
| ====================================================================== |
| ============= Функция 21, подфункция 13, подподфункция 2 ============= |
| ============= Получить информацию о текущем видеорежиме. ============= |
| ====================================================================== |
| Параметры: |
| * eax = 21 - номер функции |
| * ebx = 13 - номер подфункции |
| * ecx = 2 - номер функции драйвера |
| Возвращаемое значение: |
| * eax = -1 - драйвер не загружен или не инициализирован; |
| ebx,ecx разрушаются |
| * eax = [ширина]*65536 + [высота] |
| * ebx = частота вертикальной развёртки (в Гц) |
| * ecx = номер текущего видеорежима |
| Замечания: |
| * Драйвер предварительно должен быть инициализирован вызовом |
| функции драйвера 1. |
| * Если нужны только размеры экрана, целесообразней использовать |
| функцию 14 с учётом того, что она возвращает размеры на 1 меньше. |
| |
| ====================================================================== |
| = Функция 21, подфункция 13, подподфункция 3 - установить видеорежим. |
| ====================================================================== |
| Параметры: |
| * eax = 21 - номер функции |
| * ebx = 13 - номер подфункции |
| * ecx = 3 - номер функции драйвера |
| * edx = [частота развёртки]*65536 + [номер видеорежима] |
| Возвращаемое значение: |
| * eax = -1 - драйвер не загружен, не инициализирован или |
| произошла ошибка |
| * eax = 0 - успешно |
| * ebx, ecx разрушаются |
| Замечания: |
| * Драйвер предварительно должен быть инициализирован вызовом |
| функции драйвера 1. |
| * Номер видеорежима и частота должны быть в таблице, возвращаемой |
| функцией драйвера 1. |
| |
| ====================================================================== |
| ============= Функция 21, подфункция 13, подподфункция 4 ============= |
| ================= Вернуться к начальному видеорежиму. ================ |
| ====================================================================== |
| Возвращает экран в видеорежим, установленный при загрузке системы. |
| Параметры: |
| * eax = 21 - номер функции |
| * ebx = 13 - номер подфункции |
| * ecx = 4 - номер функции драйвера |
| Возвращаемое значение: |
| * eax = -1 - драйвер не загружен или не инициализирован |
| * eax = 0 - успешно |
| * ebx, ecx разрушаются |
| Замечания: |
| * Драйвер предварительно должен быть инициализирован вызовом |
| функции драйвера 1. |
| |
| ====================================================================== |
| ============= Функция 21, подфункция 13, подподфункция 5 ============= |
| ======== Увеличить/уменьшить размер видимой области монитора. ======== |
| ====================================================================== |
| Параметры: |
| * eax = 21 - номер функции |
| * ebx = 13 - номер подфункции |
| * ecx = 5 - номер функции драйвера |
| * edx = 0/1 - уменьшить/увеличить размер по горизонтали |
| на одну позицию |
| * edx = 2/3 - в текущей реализации не поддерживается; планируется |
| как уменьшение/увеличение размера по вертикали на одну позицию |
| Возвращаемое значение: |
| * eax = -1 - драйвер не загружен или не инициализирован |
| * eax = 0 - успешно |
| * ebx, ecx разрушаются |
| Замечания: |
| * Драйвер предварительно должен быть инициализирован вызовом |
| функции драйвера 1. |
| * Функция влияет только на физический размер изображения |
| на мониторе; логический размер (число пикселей) не меняется. |
| |
| ====================================================================== |
| ============ Функция 22 - установить системную дату/время. =========== |
| ====================================================================== |
| Параметры: |
| 1494,59 → 1326,6 |
|---|
| вызовет 32-битное переполнение. |
| |
| ====================================================================== |
| ======= Функция 24, подфункция 1 - начать проигрывать CD-audio. ====== |
| ====================================================================== |
| Параметры: |
| * eax = 24 - номер функции |
| * ebx = 1 - номер подфункции |
| * ecx = 0x00FRSSMM, где |
| * MM = начальная минута |
| * SS = начальная секунда |
| * FR = начальный фрейм |
| Возвращаемое значение: |
| * eax = 0 - успешно |
| * eax = 1 - не определена база CD |
| Замечания: |
| * Предварительно нужно определить базовый порт CD вызовом |
| подфункции 3 функции 21. |
| * В секунде 75 фреймов, в минуте 60 секунд. |
| * Функция асинхронна (возвращает управление, когда началось |
| проигрывание). |
| |
| ====================================================================== |
| ===== Функция 24, подфункция 2 - получить информацию о дорожках. ===== |
| ====================================================================== |
| Параметры: |
| * eax = 24 - номер функции |
| * ebx = 2 - номер подфункции |
| * ecx = указатель на буфер для таблицы |
| (максимум 8*64h+4 байт=100 дорожек) |
| Возвращаемое значение: |
| * eax = 0 - успешно |
| * eax = 1 - не определена база CD |
| Замечания: |
| * Формат таблицы с информацией о дорожках такой же, как и для |
| ATAPI-CD команды 43h (READ TOC), обычной таблицы (подкоманда 00h). |
| Адреса возвращаются в формате MSF. |
| * Предварительно нужно определить базовый порт CD вызовом |
| подфункции 3 функции 21. |
| * Функция возвращает информацию только о не более чем 100 |
| первых дорожках. В большинстве случаев этого достаточно. |
| |
| ====================================================================== |
| ==== Функция 24, подфункция 3 - остановить проигрываемое CD-audio. === |
| ====================================================================== |
| Параметры: |
| * eax = 24 - номер функции |
| * ebx = 1 - номер подфункции |
| Возвращаемое значение: |
| * eax = 0 - успешно |
| * eax = 1 - не определена база CD |
| Замечания: |
| * Предварительно нужно определить базовый порт CD вызовом |
| подфункции 3 функции 21. |
| |
| ====================================================================== |
| ======= Функция 24, подфункция 4 - извлечь лоток привода диска. ====== |
| ====================================================================== |
| Параметры: |
| 1553,7 → 1332,9 |
|---|
| * eax = 24 - номер функции |
| * ebx = 4 - номер подфункции |
| * ecx = номер CD/DVD-диска |
| (от 0=Primary Master до 3=Secondary Slave) |
| от 0=Primary Master до 3=Secondary Slave для первого IDE контр. |
| от 4=Primary Master до 7=Secondary Slave для второго IDE контр. |
| от 8=Primary Master до 11=Secondary Slave для третьего IDE контр. |
| Возвращаемое значение: |
| * функция не возвращает значения |
| Замечания: |
| 1571,7 → 1352,9 |
|---|
| * eax = 24 - номер функции |
| * ebx = 5 - номер подфункции |
| * ecx = номер CD/DVD-диска |
| (от 0=Primary Master до 3=Secondary Slave) |
| от 0=Primary Master до 3=Secondary Slave для первого IDE контр. |
| от 4=Primary Master до 7=Secondary Slave для второго IDE контр. |
| от 8=Primary Master до 11=Secondary Slave для третьего IDE контр. |
| Возвращаемое значение: |
| * функция не возвращает значения |
| Замечания: |
| 1649,18 → 1432,6 |
|---|
| * Приложение @panel переключает раскладки по запросу пользователя. |
| |
| ====================================================================== |
| ============ Функция 26, подфункция 3 - получить базу CD. ============ |
| ====================================================================== |
| Параметры: |
| * eax = 26 - номер функции |
| * ebx = 3 - номер подфункции |
| Возвращаемое значение: |
| * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3 |
| Замечания: |
| * База CD используется функцией 24. |
| * Установить базу CD можно вызовом подфункции 3 функции 21. |
| |
| ====================================================================== |
| ========== Функция 26, подфункция 5 - получить язык системы. ========= |
| ====================================================================== |
| Параметры: |
| 1675,42 → 1446,6 |
|---|
| * Установить язык системы можно вызовом подфункции 5 функции 21. |
| |
| ====================================================================== |
| ============ Функция 26, подфункция 7 - получить базу HD. ============ |
| ====================================================================== |
| База HD нужна для определения, на какой жёсткий диск писать, при |
| использовании устаревшего синтаксиса /HD в устаревшей функции 58; |
| при использовании современного синтаксиса /HD0,/HD1,/HD2,/HD3 |
| база устанавливается автоматически. |
| Параметры: |
| * eax = 26 - номер функции |
| * ebx = 7 - номер подфункции |
| Возвращаемое значение: |
| * eax = база HD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3 |
| Замечания: |
| * Любое приложение в любой момент времени может изменить базу. |
| * Установить базу можно вызовом подфункции 7 функции 21. |
| * Получить используемый раздел жёсткого диска можно подфункцией 8. |
| |
| ====================================================================== |
| =========== Функция 26, подфункция 8 - получить раздел HD. =========== |
| ====================================================================== |
| Раздел HD нужен для определения, на какой раздел жёсткого диска |
| писать, при использовании устаревшего синтаксиса /HD в устаревшей |
| функции 58; при использовании современного синтаксиса |
| /HD0,/HD1,/HD2,/HD3 база и раздел устанавливаются автоматически. |
| Параметры: |
| * eax = 26 - номер функции |
| * ebx = 8 - номер подфункции |
| Возвращаемое значение: |
| * eax = раздел HD (считая с 1) |
| Замечания: |
| * Любое приложение в любой момент времени может изменить раздел. |
| * Установить раздел можно вызовом подфункции 8 функции 21. |
| * Узнать число разделов на жёстком диске можно вызовом |
| подфункции 11 функции 18. |
| * Получить используемую базу жёсткого диска можно подфункцией 7. |
| |
| ====================================================================== |
| === Функция 26, подфункция 9 - получить значение счётчика времени. === |
| ====================================================================== |
| Параметры: |
| 2544,221 → 2279,6 |
|---|
| эмулируется (через аналоги подфункций функции 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 - получение информации о файловой системе |
| |
| ====================================================================== |
| ========== Функция 58, подфункция 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. |
| |
| ====================================================================== |
| ========= Функция 58, подфункция 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 применяется для посылок сообщений от одного процесса/потока |
| 4544,13 → 4064,7 |
|---|
| Возвращаемое значение: |
| * eax = socketnum1, -1 для ошибки |
| * ebx = socketnum2, код ошибки в случае ошибки |
| Замечания: |
| |
| Optstruct: dd level |
| dd optionname |
| dd optlength |
| db options... |
| |
| ====================================================================== |
| ========== Функция -1 - завершить выполнение потока/процесса ========= |
| ====================================================================== |