From 6f5f62650062634f66b3d310a236fb4022b97231 Mon Sep 17 00:00:00 2001 From: Doczom Date: Sat, 16 Mar 2024 22:49:35 +0000 Subject: [PATCH] Update documentation, added wirnings for oldated functions git-svn-id: svn://kolibrios.org@9995 a494cfbc-eb01-0410-851d-a64ba20cac60 --- kernel/trunk/docs/sysfuncr.txt | 66 ++++++++++++++-------------------- kernel/trunk/docs/sysfuncs.txt | 53 +++++++++++---------------- 2 files changed, 48 insertions(+), 71 deletions(-) diff --git a/kernel/trunk/docs/sysfuncr.txt b/kernel/trunk/docs/sysfuncr.txt index b2a5bf636b..c1c78909c8 100644 --- a/kernel/trunk/docs/sysfuncr.txt +++ b/kernel/trunk/docs/sysfuncr.txt @@ -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 - единственная подфункция diff --git a/kernel/trunk/docs/sysfuncs.txt b/kernel/trunk/docs/sysfuncs.txt index 118e8573b0..a70bdef069 100644 --- a/kernel/trunk/docs/sysfuncs.txt +++ b/kernel/trunk/docs/sysfuncs.txt @@ -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