SysFn70/ru: Difference between revisions

:* eax = 70

:* ebx = указатель на информационную структуру

:* +20 = +0x14: ?: текстовая строка - путь к файлу, заканчивается нулём

:* +20 = +0x14: byte: 0

:* +21 = +0x15: dword: указатель на строку

Если путь начинается не с '/', то он считается относительным.

'../' в пути означает подъём на одну папку относительно текущей.

Можно указать кодировку строки, поместив в её начале байт со значениями:

:* 1 = cp866

:* 2 = UTF-16LE

:* 3 = UTF-8

Формат абсолютного пути:

где ''base/number'' идентифицирует устройство, на котором ищется файл:

:* '''RD/1''' = рамдиск

:* '''FD/1''' = первый флоппи-дисковод, '''FD/2''' = второй флоппи-дисковод

:* '''HD0/x''', '''HD1/x''', '''HD2/x''', '''HD3/x''' = жёсткие диски соответственно на IDE0 (Primary Master), IDE1 (Primary Slave), IDE2 (Secondary Master), IDE3 (Secondary Slave); x - номер раздела на выбранном винчестере, начиная с 1

:* '''CD0/1''', '''CD1/1''', '''CD2/1''', '''CD3/1''' = аналогично для cd

:* '''SYS''' - системная папка (является ключом, не зависит от кодировки), второй ключ может быть установлен сисфункцией 30.3.

:* '/rd/1/example.asm',0

:* '/HD0/1/folder/file.txt',0

:* '/hd2/2/pics/tanzania.bmp',0

:* 2,'/',0,'sys','/',0,'F',0,'I',0,'L',0,'E',0,0,0

Разблокировка осуществляется при обращении подфункции 4 [[SysFn24/ru|функции 24]]

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

:* ebx = указатель на информационную структуру

:* +0: dword: 0 = номер подфункции

:* +4: dword: позиция в файле (в байтах)

:* +8: dword: старший dword позиции

:* +12 = +0xC: dword: сколько байт читать

:* +16 = +0x10: dword: указатель на буфер, куда будут записаны данные

:* +20 = +0x14: путь, правила формирования имён указаны в общем описании

:* eax = 0 - успешно, иначе код ошибки файловой системы

:* ebx = число прочитанных байт

::eax - SF_FILE (70)

::[ebx] - SSF_READ_FILE (0)

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

:* ebx = указатель на информационную структуру

:* +0: dword: 1 = номер подфункции

:* +4: dword: индекс начального блока (считая с 0)

:* +8: dword: в какой кодировке возвращать имена:

:: 0 = по умолчанию

:: 1 = cp866

:* +12 = +0xC: dword: сколько блоков читать

:* +16 = +0x10: dword: указатель на буфер, куда будут записаны данные

:* +20 = +0x14: путь, правила формирования имён указаны в общем описании

:* eax = 0 - успешно, иначе код ошибки файловой системы

:* ebx = число файлов, информация о которых была записана в буфер

:* заголовок (32 байта)

:* блок с информацией о файле 1

:* блок с информацией о файле 2

:* ...

:* +0: dword: версия структуры (текущая версия = 1)

:* +4: dword: количество размещённых блоков; не больше, чем запрошено в поле +12 информационной структуры; может быть меньше, если в папке кончились файлы (то же самое, что и в ebx)

:* +8: dword: общее число файлов в папке

:* +12 = +0xC: 20*byte: зарезервировано (нули)

:* +0: dword: атрибуты файла:

:** бит 0 (маска 1): файл только для чтения

:** бит 1 (маска 2): файл является скрытым

:** бит 2 (маска 4): файл является системным

:** бит 3 (маска 8): это метка тома (возвращается только подфункцией 5)

:** бит 4 (маска 0x10): это папка

:** бит 5 (маска 0x20): файл не архивировался - многие программы архивации имеют опцию, по которой архивируются только файлы с установленным этим битом, после чего этот бит сбрасывается - это может быть полезно для автоматического создания backup-архивов, ибо при записи бит обычно устанавливается (не в Kolibri, правда)

:* +4: byte: кодировка имени, соответствует полю +8 информационной структуры

:* +5: 3*byte: зарезервировано (нули)

:* +8: 4*byte: время создания файла