Приложение Г Функции 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