Subversion Repositories Kolibri OS

    * 2 = полная версия, 65536 байт

Формат таблицы: полная версия:

  * +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

  * формат дальнейших данных зависит от файловой системы,

    может меняться с изменениями в ядре и поэтому не описывается

======================================================================

=========== Функция 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, подфункция 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, подфункция 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.

  * Функция влияет только на физический размер изображения

    на мониторе; логический размер (число пикселей) не меняется.

======================================================================

======= Функция 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.

======================================================================

============ Функция 26, подфункция 3 - получить базу CD. ============

======================================================================

Параметры:

  * eax = 26 - номер функции

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

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

  * eax = база CD: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3

Замечания:

  * База CD используется функцией 24.

  * Установить базу CD можно вызовом подфункции 3 функции 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.

======================================================================

============== Функция 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, возвращающая

    информацию о файловой системе. По расширенной таблице дисковой

    подсистемы можно определить размер кластера (там он хранится

    в секторах) и общее число кластеров для жёстких дисков.

Замечания:

  Optstruct: dd level

             dd optionname

             dd optlength

             db options...