MS-DOS для программиста

6.5. Функция управления устройствами IOCTL

После обзора команд перейдем к описанию функции 44h прерывания INT 21h . Эта функция предназначена для управления вводом/выводом и обладает широкими возможностями.

Мы рассмотрим средства управления устройствами ввода/вывода IOCTL . Использование IOCTL - обычный метод организации связи с устройствами или получения информации об открытых файлах.

Описания будут приводиться в порядке номеров подфункций функции 44h прерывания INT 21h .

Получить конфигурацию устройства (4400h)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Функция возвращает в регистре DX слово конфигурации устройства, которое имеет следующий формат:

Если при вызове этой подфункции регистр BX содержит идентификатор файла, формат информации, получаемой в регистре DX, будет следующий:

Особое внимание следует обратить на бит 5 слова информации об устройстве. Этот бит определяет режим обмена данными между операционной системой и драйвером: двоичный или символьный. В двоичном режиме управляющие символы <Ctrl+C>, <Ctrl+P>, <Ctrl+S>, <Ctrl+Z> интерпретируются как обычные данные.

Установить слово конфигурации устройства (4401h)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Эта подфункция позволяет устанавливать некоторые биты в слове конфигурации устройства.

В зависимости от установки бита 5 драйвер выполняет команды ввода/вывода различным образом.

В режиме ASCII обмен с драйвером символьного устройства выполняется по байтам (содержимое поля count в запросе всегда равно 1). Если вам надо обслуживать быстродействующее устройство ввода/вывода, такой обмен может оказаться слишком медленным. В этом случае вы можете установить бит 5 в единицу и выполнять обмен в двоичном режиме. Разумеется, вам придется самостоятельно отслеживать все управляющие символы.

Чтение управляющей информации для символьных устройств (4402h)
Запись управляющей информации для символьных устройств (4403h)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Эти подфункции позволяют прикладной программе обмениваться произвольной управляющей информацией с драйвером устройства. Они инициируют вызов драйвера с командами 3 и 12, соответственно, для выполнения операций чтения и записи управляющей информации.

Для использования описанных подфункций драйвер должен поддерживать интерфейс IOCTL , что можно проверить с помощью подфункции 0 (чтение слова конфигурации устройства). Если бит 14 установлен, драйвер поддерживает IOCTL.

Чтение управляющей информации для блочных устройств (4404h)
Запись управляющей информации для блочных устройств (4405h)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Для использования этих подфункций драйвер должен поддерживать интерфейс IOCTL .

Определение состояния устройства ввода (4406h)
Определение состояния устройства вывода (4407h)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Эти подфункции предназначены для проверки готовности устройства к вводу или выводу данных, а также для проверки на достижение конца файла.

Проверка возможности замены носителя данных для блочного устройства (4408h)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Эта подфункция проверяет возможность замены носителя данных.

Определение расположения устройства - локальное или удаленное (4409h)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Ошибка 01h может возникнуть, если не загружена программа share.exe

Используя эту подфункцию, программы могут определить расположение диска - на локальной станции или на сервере. Однако обычно работа программы не должна зависеть от этого расположения.

Проверка идентификатора: локальный или удаленный (440Ah)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Ошибка 01h может возникнуть, если не загружена программа share.exe .

Данная подфункция позволяет проверить, является ли открытое устройство или файл локальным или удаленным. Справедливы замечания к предыдущей подфункции о том, что работа программы не всегда должна зависеть от расположения файла или устройства.

Установка количества повторов при обращении к файлу (440Bh)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Код ошибки 01h появляется, если задан недопустимый номер подфункции или не загружена программа share.exe .

Операции, которые могут привести к возникновению конфликтных ситуаций, автоматически повторяются несколько раз до выдачи сообщения об ошибке.

Переключение кодовых страниц (440Ch)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Для подготовки кодовой страницы сначала вызывают эту подфункцию с кодом операции CL=4Ch, затем должна идти серия вызовов подфункции 03h функции 44h прерывания INT 21h (запись через интерфейс IOCTL на символьное устройство).

Формат записываемых данных зависит от типа устройства. Драйверы display.sys и printer.sys, входящие в состав MS-DOS, получают эти данные из файлов с расширением имени .cpi, таких как ega.cpi, lcd.cpi, 4201.cpi и т. д.

Блок параметров имеет различный формат для разных кодов операций:

Из-за ограниченного объема книги мы не можем привести подробную информацию об использовании кодовых страниц. При необходимости обратитесь к руководству программиста, которое поставляется в составе Microsoft Developer Network (MSDN Level 1) на компакт-диске Development Library.

Общее управление вводом/выводом GENERIC IOCTL (440Dh)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Общая схема использования этой подфункции такова:

• сохранить параметры устройства операцией 40h;
• установить нужные параметры;
• выполнить операцию ввода/вывода или форматирования;
• восстановить предыдущие параметры.

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

Получить/установить параметры устройства (CL=40h/60h)

Биты байта специальных функций имеют следующее значение:

• Бит 0

В операции 60h значение этого бита, равное 1, используется для извлечения текущего BPB , как если бы он был получен по команде драйвера с кодом 2 (построить BPB). Значение этого бита, равное 0, говорит о том, что надо извлечь BPB, используемый по умолчанию.

Для операции с кодом 40h значение бита, равное 1, используется для извлечения текущего BPB , значение 0 приводит к использованию BPB, подготовленного в данном блоке параметров.

• Бит 1

Значение этого бита, равное 1, - это указание игнорировать все поля в блоке параметров, кроме поля описания физической структуры дорожки на данном устройстве.

• Бит 2

Значение этого бита, равное 1, говорит о том, что все секторы на этой дорожке имеют одинаковый размер.

Таблица разметки дорожки начинается с двухбайтового слова, содержащего общее количество секторов на дорожке. Затем для каждого сектора в таблице находится по два двухбайтовых слова, содержащих номер сектора (1, 2 и т. д.), а также размер сектора. Таким образом, для каждого сектора в таблице содержится два слова.

Если в поле "специальные функции" бит 2 установлен в 1, размеры всех секторов должны быть одинаковыми.

Записать/прочитать дорожку (CL=41h/61h)

Форматировать/проверить дорожку (CL=42h/62h)

Получение информации о логическом дисководе (440Eh)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Установка текущего логического дисковода (440Fh)

Вызов:

Выполнение без ошибки:

Выполнение с ошибкой:

Последние две команды предназначены для работы с логическими дисководами. На одном физическом дисководе операционная система MS-DOS может образовать несколько логических дисков. Эти команды могут использоваться программами, например, для выдачи сообщения о необходимости заменить дискету при переходе от одного логического устройства к другому, если эти устройства расположены на одном физическом накопителе.