WebSVN – Kolibri OS – Diff – /kernel/branches/Kolibri-acpi/docs/sysfuncr.txt

     с момента запуска системы; она во многих случаях удобнее,
     поскольку возвращает просто DWORD-значение счетчика времени.
   * Системное время можно установить функцией 22.
 ======================================================================
-============== Функция 4 - вывести строку текста в окно. =============
+================ Функция 4 - нарисовать строку текста. ===============
 ======================================================================
 Параметры:
   * eax = 4 - номер функции
-  * ebx = [координата по оси x]*65536 + [координата по оси y]
+  * ebx = X*65536+Y, координаты в окне или буфере
-  * ecx = 0xXYRRGGBB, где
+  * ecx = 0xXXRRGGBB, где
     * RR, GG, BB задают цвет текста
-    * X=ABnn (биты):
+    * XX=ABFFCSSS (биты):
-        * nn задает используемый шрифт: 0=системный моноширинный,
+      * A=1 - рисуемая строка заканчивается нулём
-=системный шрифт переменной ширины
+      * B=1 - закрашивать фон (цвет = edi)
+      * FF задает шрифт и кодировку:
+= 6x9  cp866
-      * A=0 - выводить esi символов, A=1 - выводить ASCIIZ-строку
+= 8x16 cp866
-      * B=1 - закрашивать фон цветом edi
+= 8x16 UTF-16LE
+= 8x16 UTF-8
-    * Y=Cnnn (биты):
+      * C=0 - рисовать в окно,
-      * C=1 перенаправить вывод в область пользователя, задано в edi
+        С=1 - рисовать в буфер (edi)
-      * nnn - не используется в текущем виде, должно быть 0 (zero)
+      * SSS = (множитель размера)-1, то-есть 0 = x1, 7 = x8
   * edx = указатель на начало строки
-  * esi = для A=0 длина строки, должна быть не больше 255;
-          для A=1 игнорируется
+  * esi = для A=0 длина строки, для A=1 игнорируется
-  * edi = цвет для закраски фона, если B=1
+  * edi = если B=1 - цвет для закраски фона,
+          если C=1 - указатель на буфер
   * edi = указатель на область пользователя, если C=1
 Возвращаемое значение:
   * функция не возвращает значения
+Замечания:
-Замечания:
+  * Нельзя одновременно использовать B=1 и C=1,
-  * Первый системный шрифт считывается при загрузке из файла char.mt,
+    поскольку в обоих случаях используется регистр edi.
-    второй - из char2.mt.
+  * Если SSS=0, шрифт может сглаживаться,
-  * Оба шрифта имеют высоту 9 пикселей, ширина моноширинного шрифта
+    в зависимости от системной настройки.
-    равна 6 пикселей.
-  * C=1, глубина точки = 32 бита, область пользователя выглядит так:
+  * Структура буфера:
-    dword Xsize
+Xsize       dd
-    dword Ysize
+Ysize       dd
-    остаток области = Xsize * Y size * 4
-  * Нельзя одновременно использовать B=1 и C=1, поскольку в обоих
+picture     rb  Xsize*Ysize*4  ; 32 бита
     случаях использован регистр edi для разных целей.
 ======================================================================
 ========================= Функция 5 - пауза. =========================
 ======================================================================
 Задерживает выполнение программы на заданное время.
     требуется передать управление следующему процессу
     (закончить текущий квант времени), используйте подфункцию 1
     функции 68.
-======================================================================
-=============== Функция 6 - прочитать файл с рамдиска. ===============
-======================================================================
-Параметры:
-  * eax = 6 - номер функции
-  * ebx = указатель на имя файла
-  * ecx = номер стартового блока, считая с 1;
-    ecx=0 - читать с начала файла (то же самое, что и ecx=1)
-  * edx = число блоков для чтения;
-    edx=0 - читать один блок (то же самое, что и edx=1)
-  * esi = указатель на область памяти, куда будут записаны данные
-Возвращаемое значение:
-  * eax = длина файла в байтах, если файл успешно прочитан
-  * eax = -1, если файл не найден
-Замечания:
-  * Данная функция является устаревшей; функция 70
-    позволяет выполнять те же действия с расширенными возможностями.
-  * Блок = 512 байт.
-  * Для чтения всего файла можно указать заведомо большое значение
-    в edx, например, edx = -1; но в этом случае будьте готовы к тому,
-    что программа "упадет", если файл окажется слишком большим
-    и "не влезет" в память программы.
-  * Имя файла должно быть либо в формате 8+3 символов
-    (первые 8 символов - собственно имя, последние 3 - расширение,
-    короткие имена и расширения дополняются пробелами),
-    либо в формате 8.3 символов "FILE.EXT"/"FILE.EX "
-    (имя не более 8 символов, точка, расширение 3 символа,
-    дополненное при необходимости пробелами).
-    Имя файла должно быть записано заглавными буквами.
-    Завершающий символ с кодом 0 не нужен (не ASCIIZ-строка).
-  * Эта функция не поддерживает папки на рамдиске.
 ======================================================================
 =============== Функция 7 - вывести изображение в окно. ==============
 ======================================================================
 Параметры:
   * eax = 7 - номер функции
   * ecx = 1 - номер подподфункции
   * edx = новое значение скорости
 Возвращаемое значение:
   * функция не возвращает значения
+Замечание: рекомендуемая скорость = 1, 0 = заблокировать курсор.
-------------- Подподфункция 2 - получить задержку мыши. --------------
+------------- Подподфункция 2 - получить ускорение мыши. -------------
 Параметры:
   * eax = 18 - номер функции
   * ebx = 19 - номер подфункции
   * ecx = 2 - номер подподфункции
 Возвращаемое значение:
-  * eax = текущая задержка мыши
+  * eax = 0 - выключить, 1 - слабое, 2 - среднее, 3 - сильное
------------- Подподфункция 3 - установить задержку мыши. -------------
+------------ Подподфункция 3 - установить ускорение мыши. ------------
 Параметры:
   * eax = 18 - номер функции
   * ebx = 19 - номер подфункции
   * ecx = 3 - номер подподфункции
-  * edx = новое значение задержки мыши
+  * edx = 0 - выключить, 1 - слабое, 2 - среднее, 3 - сильное
 Возвращаемое значение:
   * функция не возвращает значения
     * бит 2 установлен = средняя кнопка нажата
     * бит 3 установлен = 4-я кнопка нажата
     * бит 4 установлен = 5-я кнопка нажата
 Возвращаемое значение:
   * функция не возвращает значения
+-------- Подподфункция 6 - получить задержку двойного щелчка. --------
-Замечания:
+Параметры:
-  * Рекомендуемая скорость мыши (в подподфункции 1) от 1 до 9.
+  * eax = 18 - номер функции
-    Устанавливаемая величина не проверяется кодом ядра, поэтому
+  * ebx = 19 - номер подфункции
-    используйте осторожно, при некорректном значении курсор может
+  * ecx = 6 - номер подподфункции
-    "замёрзнуть". Скорость мыши можно регулировать в приложении SETUP.
+Возвращаемое значение:
-  * Рекомендуемая величина задержки (в подподфункции 3) = 10.
+  * eax = текущая задержка двойного щелчка (100 = секунда)
-    Меньшие значения не обрабатываются COM-мышами. При очень больших
+------- Подподфункция 7 - установить задержку двойного щелчка. -------
+Параметры:
-    значениях невозможно передвижение мыши на 1 пиксель и курсор будет
+  * eax = 18 - номер функции
-    прыгать на величину установленной скорости (подподфункция 1).
+  * ebx = 19 - номер подфункции
-    Устанавливаемая величина не проверяется кодом ядра.
+  * ecx = 7 - номер подподфункции
-    Величину задержки можно менять в приложении SETUP.
+  * dl  = новое значение задержки двойного щелчка (100 = секунда)
-  * Подподфункция 4 не проверяет переданное значение. Перед вызовом
+Возвращаемое значение:
-    необходимо узнать текущее разрешение экрана (подфункцией 14)
+  * функция не возвращает значения
-    и проверить, что устанавливаемое положение не выходит за пределы
+Замечание: настройки мыши можно регулировать в приложении mouse_cfg.
-    экрана.
 ======================================================================
 ====================== Функция 18, подфункция 20 =====================
 ============= Получить информацию об оперативной памяти. =============
     для нестандартных дисплеев, отображающих изображение частично.
   * Размеры указываемые в функции не должны превышать размеры текущего
     видеорежима, иначе функция ничего не изменит.
+======================================================================
+===================== Функция 18, подфункция 25 ======================
+======== Управление положением окна относительно других окон. ========
+======================================================================
+------------- Подподфункция 1 - получить положение  ------------------
+Параметры:
+  * eax = 18 - номер функции
+  * ebx = 25 - номер подфункции
+  * ecx = 1 - номер подподфункции
+  * edx = -1(для текущего окна) или PID приложения
+Возвращаемое значение:
+  * eax = одна из констант положения окна
+------------- Подподфункция 2 - установить положение  ----------------
+Параметры:
+  * eax = 18 - номер функции
+  * ebx = 25 - номер подфункции
+  * ecx = 2 - номер подподфункции
+  * edx = -1(для текущего окна) или PID приложения
+  * esi = новое положение окна (одна из констант ниже)
+Возвращаемое значение:
+  * eax = 0 - неудача
+  * eax = 1 - успех
+Константы положения окна относительно других окон:
+ ZPOS_DESKTOP     = -2 - на самом заднем плане
+ ZPOS_ALWAYS_BACK = -1 - позади всех окон
+ ZPOS_NORMAL      = 0  - обычное
+ ZPOS_ALWAYS_TOP  = 1  - поверх всех окон
 ======================================================================
 ==================== Функция 20 - интерфейс MIDI. ====================
 ======================================================================
   * Счётчик берётся по модулю 2^32, что соответствует немногим более
 суток.
   * Системное время можно получить функцией 3.
+======================================================================
+===================== Функция 26, подфункция 10 ======================
+========== Получить значение высокоточного счётчика времени. =========
+======================================================================
+Parameters:
+  * eax = 26 - номер функции
+  * ebx = 10 - номер подфункции
+Returned value:
+  * edx:eax = число наносекунд с момента загрузки ядра
+  * eax = младшее двойное слово
+  * edx = старшее двойное слово
+Remarks:
+  * функция использует счётчик HPET, если HPET не доступен используется
+    счётчик PIT. В этом случае точность будет уменьшена до 10 000 000
+    наносекунд.
 ======================================================================
 ====================== Функция 26, подфункция 11 =====================
 =========== Узнать, разрешён ли низкоуровневый доступ к HD. ==========
 ======================================================================
 Параметры:
     относительную y-координату, а старшее - относительную x-координату
     (правильного знака). В противном случае младшее слово отрицательно
     и всё равно содержит относительную y-координату,
     а к старшему слову следует прибавить 1.
------------------ Подфункция 2 - нажатые кнопки мыши -----------------
+---------------- Подфункция 2 - состояния кнопок мыши ----------------
 Параметры:
   * eax = 37 - номер функции
   * ebx = 2 - номер подфункции
+Возвращаемое значение:
+  * eax = биты 0-4 соответствуют подфункции 3
+----------- Подфункция 3 - состояния и события кнопок мыши -----------
+Параметры:
+  * eax = 37 - номер функции
+  * ebx = 3 - номер подфункции
 Возвращаемое значение:
+  * eax содержит следующую информацию:
+состояния:
+  * бит 0 установлен = удерживается левая кнопка
+  * бит 1 установлен = удерживается правая кнопка
+  * бит 2 установлен = удерживается средняя кнопка
+  * бит 3 установлен = удерживается 4-я кнопка
+  * бит 4 установлен = удерживается 5-я кнопка
-  * eax содержит информацию о нажатых кнопках мыши:
+события:
-  * бит 0 установлен = левая кнопка нажата
+  * бит 8 установлен  = нажата левая кнопка
-  * бит 1 установлен = правая кнопка нажата
+  * бит 9 установлен  = нажата правая кнопка
+  * бит 10 установлен = нажата средняя кнопка
+  * бит 15 установлен = используется вертикальная прокрутка
-  * бит 2 установлен = средняя кнопка нажата
-  * бит 3 установлен = 4-я кнопка нажата
+  * бит 16 установлен = отпущена левая кнопка
-  * бит 4 установлен = 5-я кнопка нажата
+  * бит 17 установлен = отпущена правая кнопка
+  * бит 18 установлен = отпущена средняя кнопка
+  * бит 23 установлен = используется горизонтальная прокрутка
-  * прочие биты сброшены
+  * бит 24 установлен = двойной щелчёк левой кнопкой
 ------------------ Подфункция 4 - загрузить курсор -------------------
 Параметры:
     на рамдиске.
   * Пользователь может изменять скин статически, создав свой
     default.skn, или динамически с помощью приложения desktop.
+======================================================================
+= Функция 48, подфункция 9 - получить настройку сглаживания шрифтов. =
+======================================================================
+Параметры:
+  * eax = 48 - номер функции
+  * ebx = 9 - номер подфункции
+Возвращаемое значение:
+  * eax = 2 - субпиксельное, 1 - обычное, 0 - выключить
+======================================================================
+===== Функция 48, подфункция 10 - настроить сглаживание шрифтов. =====
+======================================================================
+Параметры:
+  * eax = 48 - номер функции
+  * ebx = 10 - номер подфункции
+  * cl  = 2 - субпиксельное, 1 - обычное, 0 - выключить
+======================================================================
+======== Функция 48, подфункция 11 - получить размер шрифтов. ========
+======================================================================
+Параметры:
+  * eax = 48 - номер функции
+  * ebx = 9 - номер подфункции
+Возвращаемое значение:
+  * eax = текущая высота шрифта в пикселях
+======================================================================
+======= Функция 48, подфункция 12 - установить размер шрифтов. =======
+======================================================================
+Параметры:
+  * eax = 48 - номер функции
+  * ebx = 10 - номер подфункции
+  * cl  = новая высота шрифта в пикселях
 ======================================================================
 ============ Функция 49 - Advanced Power Management (APM). ===========
 ======================================================================
 Параметры:
   * eax = 49 - номер функции
   * ebx = 1 - номер подфункции
   * ecx = адрес строки заголовка
 Возвращаемое значение:
   * функция не возвращает значения
 Замечания:
-  * Строка заголовка должна быть в формате ASCIIZ. В заголовке
+  * Строка заголовка должна заканчиваться нулём.
+  * Можно указать кодировку заголовка,
-    отображается не более 255 символов независимо от полной длины
+    поместив в начале строки байт со значениями:
+= cp866
-    строки.
+= UTF-16LE
+= UTF-8
+    иначе будет использоваться cp866.
   * Чтобы убрать заголовок, передайте NULL в ecx.
 ======================================================================
 ================ Функция 72 - послать сообщение окну. ================
   * bh = номер устройства
 Возвращаемое значение:
   * eax = -1 для ошибки
+======================================================================
+===== Функция 74, подфункция 4, Получить указатель на устройство =====
+======================================================================
+Параметры:
+  * eax = 74 - номер функции
+  * bl = 4 - номер подфункции
+  * bh = номер устройства
+Возвращаемое значение:
+  * eax = указатель, -1 для ошибки
+======================================================================
+=== Функция 74, подфункция 6, Получить количество посланых пакетов ===
+======================================================================
+Параметры:
+  * eax = 74 - номер функции
+  * bl = 6 - номер подфункции
+  * bh = номер устройства
+Возвращаемое значение:
+  * eax = количество с момента старта устройства, -1 для ошибки
+======================================================================
+=== Функция 74, подфункция 7, Получить количество принятых пакетов ===
+======================================================================
+Параметры:
+  * eax = 74 - номер функции
+  * bl = 7 - номер подфункции
+  * bh = номер устройства
+Возвращаемое значение:
+  * eax = количество с момента старта устройства, -1 для ошибки
+======================================================================
+==== Функция 74, подфункция 8, Получить количество посланых байт. ====
+======================================================================
+Параметры:
+  * eax = 74 - номер функции
+  * bl = 8 - номер подфункции
+  * bh = номер устройства
+Возвращаемое значение:
+  * eax = количество с момента старта устройства, -1 для ошибки
+  * ebx = старшая часть
+======================================================================
+==== Функция 74, подфункция 9, Получить количество принятых байт. ====
+======================================================================
+Параметры:
+  * eax = 74 - номер функции
+  * bl = 9 - номер подфункции
+  * bh = номер устройства
+Возвращаемое значение:
+  * eax = количество с момента старта устройства, -1 для ошибки
+  * ebx = старшая часть
+======================================================================
+======= Функция 74, подфункция 10, Получить статус соединения. =======
+======================================================================
+Параметры:
+  * eax = 74 - номер функции
+  * bl = 10 - номер подфункции
+  * bh = номер устройства
+Возвращаемое значение:
+  * eax = статус соединения, -1 для ошибки
+Статусы:
+= нет соединения
+= неизвестное соединение
+= 10 Мбит
+= 100 Мбит
+= 1 Гбит
+b = флаг полного дуплекса
 ======================================================================
 ======= Функция 75, подфункция 0, Open socket (Открыть сокет). =======
 ======================================================================
 Параметры:
   * eax = 75 - номер функции

Subversion Repositories Kolibri OS

(root)/kernel/branches/Kolibri-acpi/docs/sysfuncr.txt – Rev 5565 → 5984