Приложение Г Функции DPMI (INT 31h)

Приложение Г Функции DPMI (INT 31h)

DPMI, функция 0000h

Выделить один или несколько дескрипторов в таблице LDT

Вход:

AX=0000h

CX – количество дескрипторов, которые необходимо выделить

Выход:

CF=0, если функция выполнена успешно

AX – базовый селектор

CF=1, если при выполнении функции возникли ошибки

Описание. Выделяет один или несколько дескрипторов в таблице LDT. Созданные дескрипторы должны быть инициализированы создавшим их приложением.

Примечания.

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

DPMI, функция 0001h Освободить дескриптор из таблицы LDT

Вход:

AX=0001h

BX – селектор дескриптора, который нужно освободить

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

Описание. Освобождает дескриптор из таблицы LDT, созданный функцией 0000h.

Примечания.

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

DPMI, функция 0002h Преобразовать сегмент в дескриптор

Вход:

AX=0002h

BX – сегментный адрес реального режима

Выход:

CF=0, если функция выполнена успешно

AX – селектор дескриптора для сегмента реального режима

CF=1, если при выполнении функции возникли ошибки

Описание. Эта функция преобразует сегмент реального режима в дескриптор для адресации к этому сегменту в защищенном режиме.

Примечания.

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

DPMI, функция 0003h Получить приращение до следующего селектора

Вход:

AX=0003h

Выход:

CF=0 (эта функция всегда выполняется успешно)

AX – значение приращения до следующего селектора

Описание.

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

DPMI, функция 0006h Получить базовый адрес сегмента по селектору

Вход:

AX=0006h

BX – селектор

Выход:

CF=0, если функция выполнена успешно

CX:DX – 32-разрядный линейный базовый адрес указанного сегмента

CF=1, если при выполнении функции возникли ошибки

Описание.

Возвращает 32-разрядный базовый адрес сегмента по его селектору.

DPMI, функция 0007h Установить базовый адрес сегмента

Вход:

AX=0007h

BX – селектор сегмента, для которого нужно установить базовый адрес

CX:DX – 32-разрядный линейный базовый адрес

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

Описание. Устанавливает 32-разрядный линейный базовый адрес указанного сегмента.

Примечания.

С помощью этой функции можно изменить базовый адрес только тех сегментов, которые выделены функцией 0000h. Старшие 8 бит (регистр CH) базового адреса игнорируются в 16-разрядных версиях DPMI.

DPMI, функция 0008h Установить предел сегмента

Вход:

AX=0008h

BX – селектор сегмента, для которого надо установить предел

CX:DX – 32-разрядный предел сегмента

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

Описание. Устанавливает 32-разрядный предел указанного сегмента.

Примечания.

С помощью этой функции можно изменить только предел сегментов, выделенных функцией 0000h. В 16-разрядных версиях DPMI предел должен быть не более FFFFh. Если предел более 1Mбайт, то базовый адрес сегмента должен быть выровнен по границе страницы (1000h), а также младшие 12 бит предела должны быть равны нулю.

DPMI, функция 0009h Установить права доступа в дескрипторе

Вход:

AX=0009h

BX – селектор сегмента, для которого надо установить права доступа

CL – значение поля прав доступа

CH – расширенное значение поля прав доступа для i80386 и выше (только в 32-разрядных DPMI)

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

Описание. Устанавливает поле прав доступа в дескрипторе.

Примечания.

С помощью этой функции можно изменить только предел сегментов, выделенных функцией 0000h.

DPMI, функция 000Ah Создать алиасный дескриптор для сегмента кода

Вход:

AX=000Ah

BX – селектор сегмента кода, для которого надо создать алиасный дескриптор.

Выход:

CF=0, если функция выполнена успешно

AX – новый селектор данных

CF=1, если при выполнении функции возникли ошибки

Описание. Создает дескриптор данных с таким же базовым адресом и пределом, как у указанного сегмента кода.

Примечания.

Созданный этой функцией алиасный дескриптор можно удалить функцией 0001h.

DPMI, функция 000Bh Получить дескриптор

Вход:

AX=000Bh

BX – селектор

ES:(E)DI – указатель на 8-байтный буфер, в который нужно скопировать дескриптор.

Выход:

CF=0, если функция выполнена успешно

ES:(E)DI – указатель на 8-байтный буфер, содержащий дескриптор

CF=1, если при выполнении функции возникли ошибки

Описание. Данная функция копирует элемент таблицы дескрипторов LDT, соответствующий указанному селектору, в 8-байтный буфер.

Примечания.

32-битные программы должны использовать ES:EDI для адресации буфера, 16-битные – ES:DI.

DPMI, функция 000Ch Установить дескриптор

Вход:

AX=000Ch

BX – селектор

ES:(E)DI – указатель на 8-байтный буфер, содержащий дескриптор

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

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

Примечания.

32-битные программы должны использовать ES:EDI для адресации буфера, 16-битные – ES:DI. С помощью этой функции можно изменить только те дескрипторы, которые выделены функцией 0000h.

DPMI, функция 000Dh Выделить дескриптор

Вход:

AX=000Dh

BX – селектор

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

Описание. Данная функция выделяет дескриптор, соответствующий указанному селектору.

Примечания.

Созданный этой функцией дескриптор можно удалить функцией 0001h.

DPMI, функция 0100h Выделить блок памяти DOS

Вход:

AX=0100h

BX – количество параграфов (по 16 байт)

Выход:

CF=0, если функция выполнена успешно

AX – сегментный адрес выделенного блока памяти

DX – селектор выделенного блока памяти

CF=1, если при выполнении функции возникли ошибки

AX – код ошибки DOS

BX – размер наибольшего доступного блока (в параграфах)

Описание. Данная функция выделяет память из пула свободной памяти DOS.

Примечания.

Созданный этой функцией дескриптор не может быть изменен или освобожден. В случае, если запрашивается памяти больше, чем 64 Кбайт, функция выделяет несколько дескрипторов. Для доступа к следующему можно пользоваться функцией 0003h.

DPMI, функция 0101h Освободить блок памяти DOS

Вход:

AX=0101h

DX – селектор выделенного блока памяти

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

AX – код ошибки DOS

Описание. Данная функция освобождает память DOS, выделенную функцией 0100h.

Примечания.

Все выделенные при выделении памяти дескрипторы освобождаются.

DPMI, функция 0102h Изменить размер блока памяти DOS

Вход:

AX=0102h

BX – необходимый размер блока памяти

DX – селектор блока памяти

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

AX – код ошибки DOS

BX – размер наибольшего доступного блока (в параграфах)

Описание. Данная функция изменяет размер памяти DOS, выделенной функцией 0100h.

Примечания.

Увеличение размера блока памяти часто может привести к ошибке, если после данного блока был выделен другой блок, если размер увеличиваемого блока больше 64 Кбайт или если после дескриптора этого блока памяти был выделен другой дескриптор.

DPMI, функция 0200h Получить вектор прерывания реального режима

Вход:

AX=0200h

BL – номер прерывания

Выход:

CF=0

CX:DX – сегмент: смещение вектора прерывания реального режима

Описание. Данная функция возвращает вектор прерывания реального режима.

Примечания.

Значение, возвращаемое в CX – сегмент, не селектор. Попытки использовать его как селектор приведут к исключению общей защиты памяти.

DPMI, функция 0201h Установить вектор прерывания реального режима

Вход:

AX=0201h

BL – номер прерывания

CX:DX – сегмент: смещение вектора прерывания реального режима

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

Описание. Данная функция устанавливает вектор прерывания реального режима.

Примечания. Значение в CX должно быть сегментом, а не селектором.

DPMI, функция 0202h Получить вектор обработчика исключения процессора

Вход:

AX=0202h

BL – номер исключения (00h-1Fh)

Выход:

CF=0, если функция выполнена успешно

CX:(E)DX – селектор: смещение

CF=1, если при выполнении функции возникли ошибки

Значение, переданное в BL, некорректно

Описание. Данная функция возвращает вектор обработчика исключения процессора.

Примечания.

Значение в CX – селектор защищенного режима, а не сегмент реального. В 32-битном режиме значение смещения возвращается в регистре EDX.

DPMI, функция 0203h Установить вектор обработчика исключения процессора

Вход:

AX=0203h

BL – номер исключения (00h-1Fh)

CX:(E)DX – селектор: смещение

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

Значение, переданное в BL, некорректно

Описание. Данная функция устанавливает вектор обработчика исключения процессора.

Примечания.

Значение в CX должно быть существующим селектором защищенного режима, а не сегментом реального. В 32-битном режиме значение смещения возвращается в регистре EDX.

DPMI, функция 0204h Получить вектор прерывания защищенного режима

Вход:

AX=0204h

BL – номер прерывания

Выход:

CF=0

CX:(E)DX – селектор: смещение

Описание. Данная функция возвращает вектор обработчика прерывания защищенного режима.

Примечания.

Значение в CX – селектор защищенного режима, а не сегмент реального. В 32-битном режиме значение смещения возвращается в регистре EDX.

DPMI, функция 0205h Установить вектор прерывания защищенного режима

Вход:

AX=0204h

BL – номер прерывания

CX:(E)DX – селектор: смещение

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

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

Примечания.

Значение в CX должно быть существующим селектором защищенного режима, а не сегментом реального. В 32-битном режиме значение смещения возвращается в регистре EDX.

DPMI, функция 0300h Вызвать обработчик прерывания реального режима

Вход:

AX=0300h

BL – номер прерывания

BH – флаги:

бит 0 – сбросить контроллер прерывания и адресную линию A20

биты 1–7 – зарезервированы и должны быть равны нулю

CX – количество слов, которые надо скопировать из стека защищенного режима в стек реального

ES:(E)DI – селектор: смещение структуры вызова реального режима (Таблица Г-1)

Таблица Г-1. Формат структуры вызова реального режима

Выход:

CF=0, если функция выполнена успешно

ES:(E)DI – селектор: смещение модифицированной структуры вызова реального режима

CF=1, если при выполнении функции возникли ошибки

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

Примечания.

Поля CS и IP этой функцией игнорируются. Функция вызывает обработчик, адрес которого указан в таблице прерываний. Если поля SS и SP равны нулю, то стек выделяется DPMI. 32-битные программы должны использовать ES:EDI для адресации структуры.

DPMI, функция 0301h Вызвать процедуру реального режима, заканчивающуюся командой RET FAR

Вход:

AX=0301h

BH – флаги:

бит 0 – сбросить контроллер прерывания и адресную линию A20

биты 1–7 – зарезервированы и должны быть равны нулю

CX – количество слов, которые надо скопировать из стека защищенного режима в стек реального

ES:(E)DI – селектор: смещение структуры вызова реального режима (формат структуры вызова реального режима описан в функции 0300h)

Выход:

CF=0, если функция выполнена успешно

ES:(E)DI – селектор: смещение модифицированной структуры вызова реального режима

CF=1, если при выполнении функции возникли ошибки

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

Примечания.

Адрес процедуры должен быть указан в структуре вызова реального режима. Процедура должна завершать выполнение командой RET FAR. Если поля SS и SP равны нулю, то стек выделяется DPMI. 32-битные программы должны использовать ES:EDI для адресации структуры.

DPMI, функция 0302h Вызвать процедуру реального режима, заканчивающуюся командой IRET

Вход:

AX=0302h

BH – флаги:

бит 0 – сбросить контроллер прерывания и адресную линию A20

биты 1–7 – зарезервированы и должны быть равны нулю

CX – количество слов, которые надо скопировать из стека защищенного режима в стек реального

ES:(E)DI – селектор: смещение структуры вызова реального режима (формат структуры вызова реального режима описан в функции 0300h)

Выход:

CF=0, если функция выполнена успешно

ES:(E)DI – селектор: смещение модифицированной структуры вызова реального режима

CF=1, если при выполнении функции возникли ошибки

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

Примечания.

Адрес процедуры должен быть указан в структуре вызова реального режима. Процедура должна завершать выполнение командой IRET. Если поля SS и SP равны нулю, то стек выделяется DPMI. 32-битные программы должны использовать ES:EDI для адресации структуры.

DPMI, функция 0400h Получить версию DPMI

Вход:

AX=0400h

Выход:

CF=0

AH – версия 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, функция 0500h Получить информацию о свободной памяти

Вход:

AX=0500h

ES:(E)DI – селектор: смещение 30-байтного буфера

Выход:

CF=0, если функция выполнена успешно

ES:(E)DI – селектор: смещение, содержащий структуру (Таблица Г-2).

CF=1, если при выполнении функции возникли ошибки

Описание. Данная функция возвращает информацию о свободной памяти.

Примечания.

32-битные программы должны использовать ES:EDI для адресации буфера. Только первое поле структуры гарантированно содержит правильное значение, остальные поля, в случае, если они не поддерживаются, содержат 0FFFFFFFFh (-1).

Таблица Г-2. Формат структуры информации о свободной памяти

DPMI, функция 0501h Выделить блок памяти

Вход:

AX=0501h

BX:CX – размер блока свободной памяти, который нужно выделить (в байтах)

Выход:

CF=0, если функция выполнена успешно

BX:CX – линейный адрес выделенного блока памяти

SI:DI – индекс блока памяти (используется для изменения размера и освобождения памяти)

CF=1, если при выполнении функции возникли ошибки

Описание. Данная функция выделяет блок памяти.

Примечания.

Данная функция не выделяет никаких дескрипторов.

DPMI, функция 0502h Освободить блок памяти

Вход:

AX=0502h

SI:DI – индекс блока памяти

Выход:

CF=0, если функция выполнена успешно

CF=1, если при выполнении функции возникли ошибки

Описание. Данная функция освобождает блок памяти.

Примечания.

Программа должна освободить все дескрипторы, которые были выделены для адресации этого блока памяти.

DPMI, функция 0503h Изменить размер блока памяти

Вход:

AX=0503h

BX:CX – нужный размер блока памяти (в байтах)

SI:DI – индекс блока памяти

Выход:

CF=0, если функция выполнена успешно

BX:CX – новый линейный адрес выделенного блока памяти

SI:DI – новый индекс блока памяти (используется для изменения размера и освобождения памяти)

CF=1, если при выполнении функции возникли ошибки

Описание. Данная функция изменяет размер блока памяти, выделенного функцией 0501h.

Примечания.

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

DPMI, функция 0900h Получить состояние и запретить виртуальные прерывания

Вход:

AX=0900h

Выход:

CF=0

Виртуальные прерывания запрещены

AL=0 – виртуальные прерывания были запрещены

AL=1 – виртуальные прерывания были разрешены

Описание. Данная функция возвращает текущее состояние виртуальных прерываний, а затем запрещает виртуальные прерывания.

Примечания.

Регистр AH не будет изменен этой функцией. Для возвращения виртуальных прерываний в прежнее состояние нужно выполнить INT 31h.

DPMI, функция 0901h Получить состояние и разрешить виртуальные прерывания

Вход:

AX=0901h

Выход:

CF=0

Виртуальные прерывания разрешены

AL=0 – виртуальные прерывания были запрещены

AL=1 – виртуальные прерывания были разрешены

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

Примечания. Регистр AH не будет изменен этой функцией. Для возвращения виртуальных прерываний в прежнее состояние нужно выполнить INT 31h.

DPMI, функция 0902h Получить состояние виртуальных прерываний

Вход:

AX=0902h

Выход:

CF=0

AL=0 – виртуальные прерывания были запрещены

AL=1 – виртуальные прерывания были разрешены

Описание. Данная функция возвращает текущее состояние виртуальных прерываний.

Данный текст является ознакомительным фрагментом.