Dos7book

Приложение А.05: Структуры данных для драйверов

Примечание 6: установление в единицу бита 11 означает, что драйвер способен обслуживать накопители на сменных носителях, в частности, передавая сигналы блокировки и разблокировки сменных дисков.

Примечание 7: установление в единицу бита 14 означает, что драйвер способен принимать управляющие параметры, посланные через прерывания

INT 21\AX=4403h или INT 21\AX=4405h (8.02-41).

A.05-3 Избранные запросы к драйверам устройств

Взаимодействие между DOS и драйвером любого устройства осуществляется посылкой в регистрах ES:BX адреса блока данных запроса при вызове программы стратегии драйвера командой CALL FAR. Драйвер принимает код операции в блоке данных запроса и инициирует ее исполнение. Потом DOS вызывает программу прерывания драйвера, которая заполняет тот же блок полученными данными. DOS принимает результат, если байт статуса в возвращенном блоке данных подтверждает успешное завершение запрошенной операции (A.05-4).

Такие же формы блоков данных запроса принимает обработчик прерывания INT 2F\AX=0802h (8.03-03), который неявно обращается к тем драйверам дисководов, которые входят в состав ядра DOS. Этими драйверами обслуживаются дисководы, для которых имеются соответствующие таблицы DDT (A.03-2). Только к этим логическим дискам можно обращаться посредством INT 2F\AX=0802h.

1-я колонка приведенной ниже таблицы показывает размер блока данных запроса в байтах, 2-я колонка – код запрашиваемой операции, 4-я колонка – тип драйверов, к которым данная операция может быть адресована. В 5-й колонке показано, может ли данная операция быть запрошена через прерывание INT 2F\AX=0802h. Знаками "звездочка" отмечены ссылки на примечания.

Приложение А.05: Структуры данных для драйверов

Примечание 1: с запросами на посылку и возврат строк IOCTL можно обращаться только к тем драйверам (как дисковым, так и канальным), у которых в слове атрибутов (A.05-2) установлен в единицу бит 14.

Примечание 2: в блоке данных запроса на проверку носителя драйвер принимает идентификатор носителя в байте со смещением 0Dh и возвращает байт статуса в ячейке со смещением 0Eh. Байт статуса значит:

FFh – носитель не был сменен 01h – носитель был сменен

00h – состояние носителя не определено.

Примечание 3: в блоке данных запроса на копирование байта (неразрушающее считывание) возвращается один байт данных в ячейке со смещением 0Dh, при условии, что в возвращаемом байте статуса со смещением 04h (A.05-4) бит BUSY ("занято") не установлен.

A.05-4 Формат заголовка блока данных запроса

Описываемый формат заголовка используется при вызовах драйверов командой CALL FAR (A.05-3), а также при обращениях к ним через прерывание INT 2F\AX=0802h (8.03-03). В обоих случаях регистры ES:BX должны содержать указатель на блок данных запроса, в котором заголовок представлен байтами 00h – 0Ch. Для многих операций (06h, 07h, 0Ah, 0Bh, 0Dh, 0Eh, 0Fh, 17h) блок данных запроса не содержит ничего кроме заголовка. Структура заголовка, одинаковая для всех операций, показана в приведенной ниже таблице.

Примечание 1: здесь логический диск определяется своим номером в списке дисков, обслуживаемых тем драйвером, к которому происходит обращение. При обращениях через прерывание INT 2F\AX=0802h

– 620 –

Приложение А.05: Структуры данных для драйверов

(8.03-03) номера совпадают с номерами логических дисков: 00h = A:, 02h = C: и т.д., но только в пределах начальной группы дисков, для которых имеются соответствующие таблицы DDT (A.03-2).

Примечание 2: если операция 0Fh (Сменный ли диск?) возвращает статус 02h ("занято"), то адресуемый диск – несменный жесткий диск.

Примечание 3: код ошибки выдается только если статус имеет значение 80h, то есть подтверждает факт ошибки. Тогда расшифровывать код ошибки следует по записям для прерывания INT 2F в таблице A.06-1.

Примечание 4: операция 17h ("определить логический диск") возвращает абсолютный номер логического диска в ячейке со смещением 03h. Тип диска и его наличие в дисководе не проверяются. Если запрашиваемый номер диска выходит за рамки списка дисков, обслуживаемых данным драйвером, то возвращается значение 00h.

A.05-5 Блок данных для запроса операции инициализации

Только однажды, сразу после загрузки драйвера, DOS вызывает его командой CALL FAR (7.03-08) с запросом на инициализацию. При вызове в регистрах ES:BX указывается адрес блока данных, а его заголовке (A.05-4) – код 00h операции инициализации. Получив такой запрос, драйвер проверяет наличие и фактическое состояние всех тех аппаратных средств, которые он должен обслуживать. При этом и исходные данные, и возвращаемые результаты выходят за рамки заголовка блока данных (A.05-4). Формат выходящей за пределы заголовка части блока данных (со смещениями 0Dh – 18h) показан в приведенной ниже таблице.

Примечание 1: канальные драйверы перед возвратом данных должны обнулять четырехбайтовое слово, начинающееся со смещения 12h.

– 621 –

Приложение А.05: Структуры данных для драйверов

Примечание 2: когда возвращаемый драйвером флаг сообщения об ошибке имеет значение 0000h, то никакое сообщение не выдается, а когда этот флаг имеет значение 0001h, то DOS выводит на экран сообщение: "There is an error in your CONFIG.SYS file in line..." ( = В Вашем файле CONFIG.SYS имеется ошибка в строке...).

A.05-6 Блок запроса на пересылку данных

Описываемая форма блока данных запроса используется при прямом вызове драйверов (A.05-3) командой CALL FAR (7.03-08), а также при вызове посредством прерывания INT 2F\AX=0802h (8.03-03) с целью пересылки данных. При вызове в регистрах ES:BX указывается адрес блока данных запроса, а его заголовке (A.05-4)

– код запрашиваемой операции: 04h, 08h или 09h. Когда запрошена операция считывания (код 04h), принимаемые данные записываются в предварительно выделенную буферную область в памяти компьютера. Операции записи (коды 08h и 09h) напротив, посылают данные из буферной области на диск или в канал вывода. Для всех упомянутых операций блоки данных запроса включают заголовок (A.05-4) и остальную часть с параметрами доступа к данным. Размещение параметров за пределами заголовка показано в приведенной ниже таблице.

Примечание 1: при обращении к драйверам каналов длина считываемого или записываемого пакета данных выражается в байтах, а при обращении к дисковым драйверам – в количестве секторов.

Примечание 2: в других DOS может использоваться иной формат с четырехбайтовым номером начального сектора в ячейке 14h;

отличительным признаком такого формата является длина блока данных 18h, указываемая в первом байте заголовка (A.05-4). MS-DOS7 использует 4-байтовый номер начального сектора только если драйвер поддерживает 32-битную адресацию, о чем свидетельствует установленный в единицу бит 1 в слове атрибутов драйвера (A.05-2). В таких случаях начальный номер сектора указывается в ячейке со смещением 1Ah, а в ячейку со смещением 14h записывается слово FFFFh.

– 622 –

Приложение А.05: Структуры данных для драйверов

Примечание 3: адрес идентификатора тома возвращается в случае возникновения ошибки 0Fh (неправомерная смена носителя записи).

A.05-7 Блок данных запроса для строковых операций

Описываемая форма блока данных запроса используется при вызове драйверов (A.05-3) командой CALL FAR (7.03-08) с целью посылки или приема строки байтов. При вызове в регистрах ES:BX указывается адрес блока данных запроса, а его заголовке (A.05-4) – код запрашиваемой операции: 03h, 0Ch или 10h. Операция 10h посылает данные в канал. Операции посылки и приема строк управляющих параметров (03h, 0Ch) могут быть адресованы только тем драйверам, которые способны пользоваться механизмом программного управления (IOCTL), о чем свидетельствует установление в единицу бита 14 в слове атрибутов (A.05-2). Запрос с кодом операции 03h "предлагает" драйверу "принять к сведению" новые значения управляющих параметров, посланные посредством функций INT 21\AX=4403h и INT 21\AX=4405h (8.02-41). Запрос с кодом операции 0Ch выдается операционной системой с тем, чтобы драйвер выдал действующие значения параметров,

запрашиваемые функциями INT 21\AX=4402h и INT 21\AX=4404h (8.02-41).

Блоки данных запроса упомянутых операций имеют одинаковую структуру, включающую заголовок (A.05-4) и остальную часть. Размещение данных за пределами заголовка показано в приведенной ниже таблице.

A.06 Коды ошибок

A.06-1 Сводная таблица кодов завершения

Почти все обработчики прерываний возвращают код завершения (код ошибки). Прерывания MS-DOS обычно возвращают его в регистре AL. Операции системы BIOS могут возвращать его в регистре AH. Интерпретации кодов завершения от разных обработчиков нередко не совпадают. В приведенной ниже таблице сведены вместе почти все значения кодов завершения, которые могут встретиться при работе в MS-DOS7. Правильную интерпретацию несложно выбрать по номеру того прерывания, которое возвратило данный код завершения, или по названию резидентного модуля драйвера.

– 623 –

– 624 –

– 625 –

– 626 –

– 627 –

– 628 –