Update documentation, added wirnings for oldated functions

git-svn-id: svn://kolibrios.org@9995 a494cfbc-eb01-0410-851d-a64ba20cac60
This commit is contained in:
Doczom 2024-03-16 22:49:35 +00:00
parent 79337f3c8e
commit 6f5f626500
2 changed files with 48 additions and 71 deletions

View File

@ -882,6 +882,9 @@ picture rb Xsize*Ysize*4 ; 32 бита
====================== Функция 18, подфункция 11 =====================
============= Получить информацию о дисковой подсистеме. =============
======================================================================
!!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
Параметры:
* eax = 18 - номер функции
* ebx = 11 - номер подфункции
@ -1255,8 +1258,8 @@ dd 1675
Параметры:
* eax = 18 - номер функции
* ebx = 25 - номер подфункции
* ecx = 1 - номер подподфункции
* edx = -1(для текущего окна) или PID приложения
* ecx = 1 - номер подподфункции
* edx = -1 (для текущего окна) или PID приложения
Возвращаемое значение:
* eax = одна из констант положения окна
@ -1264,8 +1267,8 @@ dd 1675
Параметры:
* eax = 18 - номер функции
* ebx = 25 - номер подфункции
* ecx = 2 - номер подподфункции
* edx = -1(для текущего окна) или PID приложения
* ecx = 2 - номер подподфункции
* edx = -1 (для текущего окна) или PID приложения
* esi = новое положение окна (одна из констант ниже)
Возвращаемое значение:
* eax = 0 - неудача
@ -1285,15 +1288,17 @@ dd 1675
==================== Функция 20 - интерфейс MIDI. ====================
======================================================================
!!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
------------------------ Подфункция 1 - сброс ------------------------
Параметры:
* eax = 20 - номер функции
* ebx = 1 - номер подфункции
* ebx = 1 - номер подфункции
-------------------- Подфункция 2 - вывести байт ---------------------
Параметры:
* eax = 20 - номер функции
* ebx = 2 - номер подфункции
* ebx = 2 - номер подфункции
* cl = байт для вывода
Возвращаемое значение (одинаково для обеих подфункций):
* eax = 0 - успешно
@ -1308,6 +1313,9 @@ dd 1675
======================================================================
==== Функция 21, подфункция 1 - установить базовый порт MPU MIDI. ====
======================================================================
!!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
Параметры:
* eax = 21 - номер функции
* ebx = 1 - номер подфункции
@ -1486,6 +1494,9 @@ dd 1675
======================================================================
======= Функция 24, подфункция 4 - извлечь лоток привода диска. ======
======================================================================
!!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
Параметры:
* eax = 24 - номер функции
* ebx = 4 - номер подфункции
@ -1509,6 +1520,9 @@ dd 1675
======================================================================
====== Функция 24, подфункция 5 - загрузить лоток привода диска. =====
======================================================================
!!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
Параметры:
* eax = 24 - номер функции
* ebx = 5 - номер подфункции
@ -1550,6 +1564,9 @@ dd 1675
======================================================================
===== Функция 26, подфункция 1 - получить базовый порт MPU MIDI. =====
======================================================================
!!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
Параметры:
* eax = 26 - номер функции
* ebx = 1 - номер подфункции
@ -2091,42 +2108,10 @@ path db 'HD0/1',0
---------------------- Константы для регистров: ----------------------
eax - SF_SET_EVENTS_MASK (40)
======================================================================
=================== Функция 43 - ввод/вывод в порт. ==================
======================================================================
------------------------ Вывод данных в порт -------------------------
Параметры:
* eax = 43 - номер функции
* bl = байт для вывода
* ecx = номер порта 0xnnnn (от 0 до 0xFFFF)
Возвращаемое значение:
* eax = 0 - успешно
* eax = 1 - поток не зарезервировал указанный порт
------------------------ Ввод данных из порта ------------------------
Параметры:
* eax = 43 - номер функции
* ebx игнорируется
* ecx = 0x8000nnnn, где nnnn = номер порта (от 0 до 0xFFFF)
Возвращаемое значение:
* eax = 0 - успешно, при этом ebx = введённый байт
* eax = 1 - поток не зарезервировал данный порт
Замечания:
* Предварительно поток должен зарезервировать за собой
указанный порт функцией 46.
* Для зарезервированных портов вместо вызова этих функций
лучше использовать команды процессора in/out - это значительно
быстрее и несколько короче и проще. Из незарезервированных
портов читать всё равно нельзя.
---------------------- Константы для регистров: ----------------------
eax - SF_PORT_IN_OUT (43)
======================================================================
= Функция 46 - зарезервировать/освободить группу портов ввода/вывода.
======================================================================
К зарезервированным портам можно обращаться напрямую из приложения
командами in/out (рекомендуемый способ) и вызовом функции 43
(нерекомендуемый способ).
командами in/out .
Параметры:
* eax = 46 - номер функции
* ebx = 0 - зарезервировать, 1 - освободить
@ -3017,6 +3002,9 @@ IPC применяется для посылок сообщений от одн
======================================================================
========== Функция 64 - перераспределить память приложения. ==========
======================================================================
!!! ВНИМАНИЕ. Данный интерфейс устарел и не должен использоваться !!!
Параметры:
* eax = 64 - номер функции
* ebx = 1 - единственная подфункция

View File

@ -872,6 +872,9 @@ Remarks:
======================================================================
Function 18, subfunction 11 - get information on the disk subsystem.
======================================================================
!!! WARNING. This interface is outdated and should not be used !!!
Parameters:
* eax = 18 - function number
* ebx = 11 - subfunction number
@ -1277,6 +1280,8 @@ Constant position of the window relative to other windows:
==================== Function 20 - MIDI interface. ===================
======================================================================
!!! WARNING. This interface is outdated and should not be used !!!
----------------------- Subfunction 1 - reset ------------------------
Parameters:
* eax = 20 - function number
@ -1300,6 +1305,9 @@ Remarks:
======================================================================
======== Function 21, subfunction 1 - set MPU MIDI base port. ========
======================================================================
!!! WARNING. This interface is outdated and should not be used !!!
Parameters:
* eax = 21 - function number
* ebx = 1 - subfunction number
@ -1475,6 +1483,9 @@ Remarks:
======================================================================
======= Function 24, subfunction 4 - eject tray of disk drive. =======
======================================================================
!!! WARNING. This interface is outdated and should not be used !!!
Parameters:
* eax = 24 - function number
* ebx = 4 - subfunction number
@ -1498,6 +1509,9 @@ Remarks:
======================================================================
======== Function 24, subfunction 5 - load tray of disk drive. =======
======================================================================
!!! WARNING. This interface is outdated and should not be used !!!
Parameters:
* eax = 24 - function number
* ebx = 5 - subfunction number
@ -1539,6 +1553,9 @@ Remarks:
======================================================================
======== Function 26, subfunction 1 - get MPU MIDI base port. ========
======================================================================
!!! WARNING. This interface is outdated and should not be used !!!
Parameters:
* eax = 26 - function number
* ebx = 1 - subfunction number
@ -2075,41 +2092,10 @@ Remarks:
---------------------- Constants for registers: ----------------------
eax - SF_SET_EVENTS_MASK (40)
======================================================================
================ Function 43 - input/output to a port. ===============
======================================================================
------------------------ Output data to port -------------------------
Parameters:
* eax = 43 - function number
* bl = byte for output
* ecx = port number 0xnnnn (from 0 to 0xFFFF)
Returned value:
* eax = 0 - success
* eax = 1 - the thread has not reserved the selected port
------------------------ Input data from port ------------------------
Parameters:
* eax = 43 - function number
* ebx is ignored
* ecx = 0x8000nnnn, where nnnn = port number (from 0 to 0xFFFF)
Returned value:
* eax = 0 - success, thus ebx = entered byte
* eax = 1 - the thread has not reserved the selected port
Remarks:
* Previously the thread must reserve the selected port
for itself by function 46.
* Instead of call to this function it is better to use
processor instructions in/out - this is much
faster and a bit shorter and easier.
---------------------- Constants for registers: ----------------------
eax - SF_PORT_IN_OUT (43)
======================================================================
====== Function 46 - reserve/free a group of input/output ports. =====
======================================================================
To work with reserved ports an application can access directly by
commands in/out (recommended way) and can use function 43
(not recommended way).
commands in/out .
Parameters:
* eax = 46 - function number
* ebx = 0 - reserve, 1 - free
@ -2987,6 +2973,9 @@ Returned value:
======================================================================
============== Function 64 - resize application memory. ==============
======================================================================
!!! WARNING. This interface is outdated and should not be used !!!
Parameters:
* eax = 64 - function number
* ebx = 1 - unique subfunction