Приложение Г
Функции DPMI (INT 31h)
DPMI, функция OOOOh
Выделить один или несколько дескрипторов в
таблице LDT
Вход:
AX=OOOOh
СХ - количество дескрипторов, которые необходимо
выделить
Выход:
CF=0, если функция выполнена успешно
AX - базовый селектор
CF=1, если при выполнении функции возникли ошибки
Описание.
Выделяет один или
несколько дескрипторов в таблице LDT. Созданные
дескрипторы должны быть инициализированы
создавшим их приложе-
нием.
Примечания.
Если создавалось более
одного дескриптора, то регистр АХ содержит
селектор первого из них, и для получения
приращения до следующего
селектора нужно воспользоваться функцией ОООЗЬ.
Созданным дескрип-
торам будет установлен тип данных с нулевыми
базовым адресом
и приращением.
DPMI, функция 0001k
Освободить дескриптор из таблицы LDT
Вход:
AX=0001h
ВХ - селектор дескриптора, который нужно
освободить
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Описание.
Освобождает дескриптор из таблицы LDT, созданный
функцией OOOOh.
Примечания.
Если нужно освободить
несколько дескрипторов, то эту функцию нуж-
но вызвать для каждого из них в отдельности. С
помощью этой функ-
ции программа может освободить только те
дескрипторы, которые были
выделены данной программой.
DPMI, функция 0002Н
Преобразовать сегмент в дескриптор
Вход:
AX=0002h
ВХ - сегментный адрес реального режима
Выход:
CF=0, если функция выполнена успешно
AX - селектор дескриптора
для сегмента реального режима
CF=1, если при выполнении функции возникли ошибки
Описание.
Эта функция преобразует сегмент реального режима в дескриптор для
адресации к этому сегменту в защищенном режиме.
Примечания.
Если эта функция
неоднократно вызывается для одного и того же сег-
мента реального режима, то она возвращает один и
тот же селектор.
Дескрипторы, созданные этой функцией, не могут
быть модифицирова-
ны или удалены.
DPMI, функция 0003k
Получить приращение до следующего селектора
Вход:
AX=0003h
Выход:
CF=0 (эта функция всегда
выполняется успешно)
AX - значение приращения до следующего селектора
Описание.
Возвращает приращение для вычисления следующего селектора в тех
функциях, которые могут возвращать более одного селектора.
DPMI, функция 0006h
Получить базовый адрес сегмента по селектору
Вход:
АХ-ОООбЬ
ВХ - селектор
Выход:
CF=0, если функция выполнена успешно
CX:DX - 32-разрядный линейный
базовый адрес указанного сегмента
CF=1, если при выполнении функции возникли ошибки
Описание.
Возвращает 32-разрядный базовый адрес сегмента по
его селектору.
DPMI, функция 0007k
Установить базовый адрес сегмента
Вход:
AX-OOOTh
ВХ - селектор сегмента, для которого нужно установить базовый адрес
CX:DX - 32-разрядный линейный базовый адрес
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Описание.
Устанавливает 32-разрядный
линейный базовый адрес указанного сег-
мента.
Примечания.
С помощью этой функции
можно изменить базовый адрес только тех
сегментов, которые выделены функцией OOOOh. Старшие
8 бит (регистр
СН) базового адреса игнорируются в 16-разрядных
версиях DPMI.
DPMI, функция 0008k
Установить предел сегмента
Вход:
AX°0008h
ВХ - селектор сегмента, для которого надо установить предел
CX:DX - 32-разрядный предел сегмента
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Описание.
Устанавливает 32-разрядный предел указанного
сегмента.
Примечания.
С помощью этой функции
можно изменить только предел сегментов,
выделенных функцией OOOOh. В 16-разрядных версиях DPMI
предел
должен быть не более FFFFh. Если предел более 1Мбайт,
то базовый
адрес сегмента должен быть выровнен по границе
страницы (lOOOh),
а также младшие 12 бит предела должны быть равны
нулю.
DPMI, функция 0009k
Установить права доступа в дескрипторе
Вход:
AX-OOOQh
ВХ - селектор сегмента, для которого надо установить права доступа
CL - значение поля прав доступа
CF[ - расширенное значение поля прав доступа для i80386 и выше
(только в 32-разрядных DPMI)
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Описание.
Устанавливает поле прав доступа в дескрипторе.
Примечания.
С помощью этой функции можно изменить только предел сегментов,
выделенных функцией OOOOh.
DPMI, функция OOOAh
Создать алиасный дескриптор для сегмента кода
Вход:
AX-OOOAh
ВХ - селектор сегмента кода, для которого надо создать алиасный
дескриптор.
Выход:
CF=0, если функция выполнена успешно
AX - новый селектор данных
CF=1, если при выполнении функции возникли ошибки
Описание.
Создает дескриптор данных с таким же базовым адресом и пределом,
как у указанного сегмента кода.
Примечания.
Созданный этой функцией
алиасный дескриптор можно удалить функ-
цией OOOlh.
DPMI, функция OOOBh
Получить дескриптор
Вход:
AX=OOOBh
ВХ - селектор
ES:(E)DI - указатель на
8-байтный буфер, в который нужно скопиро-
вать дескриптор.
Выход:
CF=0, если функция выполнена успешно
ES:(E)DI - указатель на
8-байтный буфер, содержащий дескриптор
CF=1, если при выполнении функции возникли ошибки
Описание.
Данная функция копирует
элемент таблицы дескрипторов LDT, соот-
ветствующий указанному селектору, в 8-байтный
буфер.
Примечания.
32-битные программы должны
использовать ES:EDI для адресации бу-
фера, 16-битные - ES:DI.
DPMI, функция OOOCh
Установить дескриптор
Вход:
AX-OOOCh
ВХ - селектор
ES:(E)DI - указатель на 8-байтный буфер, содержащий дескриптор
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Описание.
Данная функция заносит
содержимое 8-байтного буфера в элемент таб-
лицы дескрипторов LDT, соответствующий указанному
селектору.
Примечания.
32-битные программы должны
использовать ES:EDI для адресации бу-
фера, 16-битные - ES:DI. С помощью этой функции можно
изменить
только те дескрипторы, которые выделены функцией
OOOOh.
DPMI, функция OOODh
Выделить дескриптор
Вход:
AX°OOODh
ВХ - селектор
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Описание.
Данная функция выделяет дескриптор, соответствующий указанному
селектору.
Примечания.
Созданный этой функцией дескриптор можно
удалить функцией 000 lh.
DPMI, функция 0100k
Выделить блок памяти DOS
Вход:
AX=0100h
ВХ - количество параграфов (по 16 байт)
Выход:
CF=0, если функция выполнена успешно
AX - сегментный адрес выделенного блока памяти
DX - селектор выделенного блока памяти
CF=1, если при выполнении
функции возникли ошибки
AX - код ошибки DOS
ВХ - размер наибольшего доступного блока (в
параграфах)
Описание.
Данная функция выделяет память из пула свободной
памяти DOS.
Примечания.
Созданный этой функцией
дескриптор не может быть изменен или
освобожден. В случае, если запрашивается памяти
больше, чем 64Кбайт,
функция выделяет несколько дескрипторов. Для
доступа к следующему
можно пользоваться функцией ОООЗЬ.
DPMI, функция 0101k
Освободить блок памяти DOS
Вход:
AX°0101h
DX - селектор выделенного блока памяти
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
AX - код ошибки DOS
Описание.
Данная функция освобождает память DOS, выделенную функцией
OlOOh.
Примечания.
Все выделенные при выделении памяти дескрипторы
освобождаются.
DPMI, функция 0102h
Изменить размер блока памяти DOS
Вход:
АХ-0102П
ВХ - необходимый размер блока памяти
DX - селектор блока памяти
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
AX - код ошибки DOS
ВХ - размер наибольшего доступного блока (в
параграфах)
Описание.
Данная функция изменяет размер памяти DOS, выделенной функцией
01 ООН.
Примечания.
Увеличение размера блока
памяти часто может привести к ошибке, если
после данного блока был выделен другой блок, если
размер увеличива-
емого блока больше 64Кбайт или если после
дескриптора этого блока
памяти был выделен другой дескриптор.
DPMI, функция 0200Н
Получить вектор прерывания реального режима
Вход:
AX=0200h
BL - номер прерывания
Выход:
CF-0
CX:DX - сегмент:смещение вектора прерывания
реального режима
Описание.
Данная функция возвращает вектор прерывания
реального режима.
Примечания.
Значение, возвращаемое в
СХ - сегмент, не селектор. Попытки исполь-
зовать его как селектор приведут к исключению
общей защиты памяти.
DPMI, функция 0201k
Установить вектор прерывания реального режима
Вход:
AX°0201h
BL - номер прерывания
CX:DX - сегмент:смещение вектора прерывания реального режима
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Описание.
Данная функция устанавливает вектор прерывания
реального режима.
Примечания.
Значение в СХ должно быть сегментом, а не
селектором.
DPMI, функция 0202k
Получить вектор обработчика исключения
процессора
Вход:
AX=0202h
BL - номер исключения (OOh-lFh)
Выход:
CF=0, если функция выполнена успешно
CX:(E)DX - селекторхмещение
CF=1, если при выполнении функции возникли ошибки
Значение, переданное в BL, некорректно
Описание.
Данная функция возвращает вектор обработчика
исключения процессора.
Примечания.
Значение в СХ - селектор
защищенного режима, а не сегмент реально-
го. В 32-битном режиме значение смещения
возвращается в регистре
EDX.
DPMI, функция 0203k
Установить вектор обработчика исключения
процессора
Вход:
АХ-0203П
BL - номер исключения (OOh-lFh)
CX:(E)DX - селектор:смещение
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Значение, переданное в BL, некорректно
Описание.
Данная функция
устанавливает вектор обработчика исключения
про-
цессора.
Примечания.
Значение в СХ должно быть
существующим селектором защищенного
режима, а не сегментом реального. В 32-битном
режиме значение сме-
щения возвращается в регистре EDX.
DPMI, функция 0204h
Получить вектор прерывания защищенного режима
Вход:
AX°0204h
BL - номер прерывания
Выход:
CF-0
CX:(E)DX - селектор:смещение
Описание.
Данная функция возвращает
вектор обработчика прерывания защищен-
ного режима.
Примечания.
Значение в СХ - селектор защищенного режима, а не сегмент реального.
В 32-битном режиме значение смещения возвращается в регистре EDX.
DPMI, функция 0205k
Установить вектор прерывания защищенного режима
Вход:
АХ-0204П
BL - номер прерывания
CX:(E)DX - селектор:смещение
Выход:
CF=0, если функция выполнена
успешно
CF^l, если при выполнении функции возникли ошибки
Описание.
Данная функция
устанавливает вектор обработчика прерывания
защи-
щенного режима.
Примечания.
Значение в СХ должно быть
существующим селектором защищенного
режима, а не сегментом реального. В 32-битном
режиме значение сме-
щения возвращается в регистре EDX.
DPMI, функция 0300k
Вызвать обработчик прерывания реального режима
Вход:
AX°0300h
BL - номер прерывания
ВН - флаги:
бит 0 - сбросить контроллер
прерывания и адресную линию А20
биты 1-7 - зарезервированы и должны быть равны нулю
СХ - количество слов,
которые надо скопировать из стека защищенно-
го режима в стек реального
ES:(E)DI - селектор:смещение структуры вызова реального режима
(Таблица Г-1)
Таблица Г-1. Формат структуры вызова реального режима.
Смещ. | Описание |
+00h | EDI |
+04h | ESI |
+08h | EBP |
+OCh | Зарезервировано |
+10h | EBX |
+14h | EDX |
+18h | ECX |
+lCh | EAX |
+20h | Флаги |
+22h | ES |
+24h | DS |
+26h | FS |
+28h | GS |
+2Ah | IP |
+2Ch | CS |
+2Eh | SP |
+30h | SS |
Выход:
CF=0, если функция выполнена успешно
ES:(E)DI - селекторхмещение
модифицированной структуры вызо-
ва реального режима
CF=1, если при выполнении функции возникли ошибки
Описание.
Данная функция вызывает обработчик прерывания
реального режима.
Примечания.
Поля CS и IP этой функцией
игнорируются. Функция вызывает обра-
ботчик, адрес которого указан в таблице
прерываний. Если поля SS и
SP равны нулю, то стек выделяется DPMI. 32-битные
программы дол-
жны использовать ES:EDI для адресации структуры.
DPMI, функция 0301k
Вызвать процедуру реального режима, заканчивающуюся
командой RET FAR
Вход:
AX=0301h
ВН - флаги:
бит 0 - сбросить контроллер
прерывания и адресную линию А20
биты 1-7 - зарезервированы и должны быть равны нулю
СХ - количество слов, которые надо скопировать из
стека защищенно-
го режима в стек реального
ES:(E)DI - селекторхмещение
структуры вызова реального режима
(формат структуры вызова реального режима описан
в функции ОЗООЬ)
Выход:
СЕ=0, если функция выполнена успешно
ES:(E)DI - селекторхмещение
модифицированной структуры вызо-
ва реального режима
СЕ=1, если при выполнении функции возникли ошибки
Описание.
Данная функция вызывает
процедуру реального режима, заканчиваю-
щуюся командой RET FAR.
Примечания.
Адрес процедуры должен
быть указан в структуре вызова реального ре-
жима. Процедура должна завершать выполнение
командой RET FAR.
Если поля SS и SP равны нулю,
то стек выделяется DPMI. 32-битные
программы должны использовать ES:EDI для адресации
структуры.
DPMI, функция 0302k
Вызвать процедуру реального режима, заканчивающуюся
командой IRET
Вход:
AX=0302h
ВЫ - флаги:
бит 0 - сбросить контроллер
прерывания и адресную линию А20
биты 1-7 - зарезервированы и должны быть равны нулю
СХ - количество слов, которые надо скопировать из
стека защищенно-
го режима в стек реального
ES:(E)DI - селекторхмещение
структуры вызова реального режима
(формат структуры вызова реального режима описан
в функции ОЗООЬ)
Выход:
CF=0, если функция выполнена успешно
ES:(E)DI - селекторхмещение
модифицированной структуры вызо-
ва реального режима
СЕ=1, если при выполнении функции возникли ошибки
Описание.
Данная функция вызывает
процедуру реального режима, заканчиваю-
щуюся командой IRET.
Примечания.
Адрес процедуры должен
быть указан в структуре вызова реального ре-
жима. Процедура должна завершать выполнение
командой IRET. Если
поля SS и SP равны нулю, то стек выделяется DPMI.
32-битные про-
граммы должны использовать ES:EDI для адресации
структуры.
DPMI, функция 0400h
Получить версию DPMI
Вход:
AX=0400h
Выход:
CF-0
АН - версия DPMI
AL - подверсия DPMI
BX - флаги:
Бит 0=1, если программа запущена под управлением DPMI
для 80386
Бит 1=1, если процессор вернулся в реальный режим для обработки
прерываний
Бит 2=1, если поддерживается виртуальная память
Бит 3 - зарезервирован и не определяется
Остальные биты зарезервированы для использования в будущем
и должны быть равны нулю.
CL - тип процессора:
CL-2 - 80286
CL=3 - 80386
CL-4 - 80486
DL - текущее значение базы
первого контроллера прерываний
DH - текущее значение базы второго контроллера
прерываний
Описание.
Данная функция возвращает версию DPMI.
DPMI, функция 0500k
Получить информацию о свободной памяти
Вход:
AX-0500h
ES:(E)DI - селектор:смещение 30-байтного буфера
Выход:
CF=0, если функция выполнена успешно
ES:(E)DI - селектор:смещение, содержащий структуру
(Таблица Г-2).
CF°1, если при выполнении функции возникли ошибки
Описание.
Данная функция возвращает информацию о
свободной памяти.
Примечания.
32-битные программы должны
использовать ES:EDI для адресации бу-
фера. Только первое поле структуры
гарантированно содержит правиль-
ное значение, остальные поля, в случае, если они
не поддерживаются,
содержат OFFFFFFFFh (-1).
Таблица Г-2. Формат структуры информации о свободной памяти.
Смещ. | Описание. |
+00h | Наибольший доступный блок (в байтах) |
+04h | Максимальное количество доступных незаблокированных страниц |
+08h | Максимальное количество доступных заблокированных страниц |
+OCh | Размер линейного адресного пространства в страницах |
+10h | Общее количество незаблокированных страниц |
+14h | Количество свободных страниц |
+18h | Общее количество физических страниц |
+lCh | Размер свободного линейного адресного пространства в страницах |
+20h | Размер страничного файла или раздела в страницах |
+24h-2Fh | Зарезервировано |
DPMI, функция 0501k
Выделить блок памяти
Вход:
AX=0501h
ВХ:СХ - размер блока свободной памяти, который нужно выделить
(в байтах)
Выход:
CF=0, если функция выполнена успешно
ВХ:СХ - линейный адрес выделенного блока памяти
SI:DI - индекс блока памяти (используется для изменения размера
и освобождения памяти)
CF=1, если при выполнении функции возникли ошибки
Описание.
Данная функция выделяет блок памяти.
Примечания.
Данная функция не выделяет никаких дескрипторов.
DPMI, функция 0502k
Освободить блок памяти
Вход:
AX=0502h
SLDI - индекс блока памяти
Выход:
CF=0, если функция выполнена
успешно
CF=1, если при выполнении функции возникли ошибки
Описание.
Данная функция освобождает блок памяти.
Примечания.
Программа должна
освободить все дескрипторы, которые были выделе-
ны для адресации этого блока памяти.
DPMI, функция 0503k
Изменить размер блока памяти
Вход:
AX=0503h
ВХ:СХ - нужный размер блока памяти (в байтах)
SLDI - индекс блока памяти
Выход:
CF=0, если функция выполнена успешно
ВХ:СХ - новый линейный
адрес выделенного блока памяти
SLDI - новый индекс блока памяти (используется для
изменения
размера и освобождения памяти)
CF=1, если при выполнении функции возникли ошибки
Описание.
Данная функция изменяет
размер блока памяти, выделенного функци-
ей 0501h.
Примечания.
Данная функция может
изменить линейный адрес и индекс блока памя-
ти. Программа должна изменить все дескрипторы,
которые были выде-
лены для адресации этого блока памяти, а также
для дальнейшей
работы с блоком
использовать новый индекс. Эта функция выдаст
ошибку, если размер блока памяти будет нулевым.
DPMI, функция 0900h
Получить состояние и запретить виртуальные
прерывания
Вход:
AX°0900h
Выход:
CF=0
Виртуальные прерывания запрещены
AL=0 - виртуальные прерывания были запрещены
AL=1 - виртуальные прерывания были разрешены
Описание.
Данная функция возвращает
текущее состояние виртуальных прерыва-
ний, а затем запрещает виртуальные прерывания.
Примечания.
Регистр АН не будет
изменен этой функцией. Для возвращения вирту-
альных прерываний в прежнее состояние нужно
выполнить INT 31h.
DPMI, функция 0901k
Получить состояние и разрешить виртуальные
прерывания
Вход:
AX°0901h
Выход:
CF=0
Виртуальные прерывания разрешены
AL=0 - виртуальные прерывания были запрещены
AL=1 - виртуальные прерывания были разрешены
Описание.
Данная функция возвращает
текущее состояние виртуальных прерыва-
ний, а затем разрешает виртуальные прерывания.
Примечания.
Регистр АН не будет
изменен этой функцией. Для возвращения вирту-
альных прерываний в прежнее состояние нужно
выполнить INT 31h.
DPMI, функция 0902k
Получить состояние виртуальных прерываний
Вход:
АХ°0902Ь
Выход:
CF-0
AL^O - виртуальные прерывания были запрещены
AL=1 - виртуальные прерывания были разрешены
Описание.
Данная функция возвращает текущее состояние
виртуальных прерываний.