Subversion Repositories Kolibri OS

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;;                                                              ;;

;;                                                              ;;

;; Copyright (C) KolibriOS team 2004-2012. All rights reserved. ;;

;; Copyright (C) KolibriOS team 2004-2012. All rights reserved. ;;

;; Distributed under terms of the GNU General Public License    ;;

;; Distributed under terms of the GNU General Public License    ;;

;;                                                              ;;

;;                                                              ;;

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

СИСТЕМНЫЕ ФУНКЦИИ ОПЕРАЦИОННОЙ СИСТЕМЫ Kolibri 0.7.7.0

СИСТЕМНЫЕ ФУНКЦИИ ОПЕРАЦИОННОЙ СИСТЕМЫ Kolibri 0.7.7.0

Номер функции помещается в регистр eax.

Номер функции помещается в регистр eax.

Вызов системной функции осуществляется командой "int 0x40".

Вызов системной функции осуществляется командой "int 0x40".

Все регистры, кроме явно указанных в возвращаемом значении,

Все регистры, кроме явно указанных в возвращаемом значении,

    включая регистр флагов eflags, сохраняются.

    включая регистр флагов eflags, сохраняются.

======================================================================

======================================================================

============== Функция 0 - определить и нарисовать окно. =============

============== Функция 0 - определить и нарисовать окно. =============

======================================================================

======================================================================

Определяет окно приложения. Рисует рамку окна, заголовок и рабочую

Определяет окно приложения. Рисует рамку окна, заголовок и рабочую

область. Для окон со скином определяет стандартные кнопки закрытия и

область. Для окон со скином определяет стандартные кнопки закрытия и

минимизации.

минимизации.

Параметры:

Параметры:

  * eax = 0 - номер функции

  * eax = 0 - номер функции

  * ebx = [координата по оси x]*65536 + [размер по оси x]

  * ebx = [координата по оси x]*65536 + [размер по оси x]

  * ecx = [координата по оси y]*65536 + [размер по оси y]

  * ecx = [координата по оси y]*65536 + [размер по оси y]

  * edx = 0xXYRRGGBB, где:

  * edx = 0xXYRRGGBB, где:

    * Y = стиль окна:

    * Y = стиль окна:

      * Y=0 - тип I - окно фиксированных размеров

      * Y=0 - тип I - окно фиксированных размеров

      * Y=1 - только определить область окна, ничего не рисовать

      * Y=1 - только определить область окна, ничего не рисовать

      * Y=2 - тип II - окно изменяемых размеров

      * Y=2 - тип II - окно изменяемых размеров

      * Y=3 - окно со скином

      * Y=3 - окно со скином

      * Y=4 - окно со скином фиксированных размеров

      * Y=4 - окно со скином фиксированных размеров

      * остальные возможные значения (от 5 до 15) зарезервированы,

      * остальные возможные значения (от 5 до 15) зарезервированы,

        вызов функции с такими Y игнорируется

        вызов функции с такими Y игнорируется

    * RR, GG, BB = соответственно красная, зеленая, синяя

    * RR, GG, BB = соответственно красная, зеленая, синяя

      составляющие цвета рабочей области окна

      составляющие цвета рабочей области окна

      (игнорируется для стиля Y=1)

      (игнорируется для стиля Y=1)

    * X = DCBA (биты)

    * X = DCBA (биты)

      * A = 1 - у окна есть заголовок; для стилей Y=3,4 адрес строки

      * A = 1 - у окна есть заголовок; для стилей Y=3,4 адрес строки

                  заголовка задаётся в edi, для прочих стилей

                  заголовка задаётся в edi, для прочих стилей

                  используется подфункция 1 функции 71

                  используется подфункция 1 функции 71

      * B = 1 - координаты всех графических примитивов задаются

      * B = 1 - координаты всех графических примитивов задаются

                  относительно клиентской области окна

                  относительно клиентской области окна

      * C = 1 - не закрашивать рабочую область при отрисовке окна

      * C = 1 - не закрашивать рабочую область при отрисовке окна

      * D = 0 - нормальная заливка рабочей области, 1 - градиентная

      * D = 0 - нормальная заливка рабочей области, 1 - градиентная

    Следующие параметры предназначены для окон типа I и II и

    Следующие параметры предназначены для окон типа I и II и

    игнорируются для стилей Y=1,3:

    игнорируются для стилей Y=1,3:

  * esi = 0xXYRRGGBB - цвет заголовка

  * esi = 0xXYRRGGBB - цвет заголовка

    * RR, GG, BB определяют сам цвет

    * RR, GG, BB определяют сам цвет

    * Y=0 - обычное окно, Y=1 - неперемещаемое окно (работает для всех стилей окон)

    * Y=0 - обычное окно, Y=1 - неперемещаемое окно (работает для всех стилей окон)

    * X определяет градиент заголовка: X=0 - нет градиента,

    * X определяет градиент заголовка: X=0 - нет градиента,

      X=8 - обычный градиент,

      X=8 - обычный градиент,

      для окон типа II X=4 - негативный градиент

      для окон типа II X=4 - негативный градиент

    * прочие значения X и Y зарезервированы

    * прочие значения X и Y зарезервированы

  * edi = 0x00RRGGBB - цвет рамки

  * edi = 0x00RRGGBB - цвет рамки

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Положение и размеры окна устанавливаются при первом вызове

  * Положение и размеры окна устанавливаются при первом вызове

    этой функции и игнорируются при последующих; для изменения

    этой функции и игнорируются при последующих; для изменения

    положения и/или размеров уже созданного окна используйте

    положения и/или размеров уже созданного окна используйте

    67-ю функцию.

    67-ю функцию.

  * Для окон стилей Y=3,4 с заголовком (A=1) строка заголовка

  * Для окон стилей Y=3,4 с заголовком (A=1) строка заголовка

    устанавливается при первом вызове этой функции и игнорируется при

    устанавливается при первом вызове этой функции и игнорируется при

    последующих (точнее говоря, игнорируется после вызова

    последующих (точнее говоря, игнорируется после вызова

    подфункции 2 функции 12 - конца перерисовки);

    подфункции 2 функции 12 - конца перерисовки);

    для изменения строки заголовка уже созданного окна используйте

    для изменения строки заголовка уже созданного окна используйте

    подфункцию 1 функции 71.

    подфункцию 1 функции 71.

  * Если использовать окна соответствующих стилей, то положение

  * Если использовать окна соответствующих стилей, то положение

    и/или размеры окна могут меняться пользователем.

    и/или размеры окна могут меняться пользователем.

    Текущие положение и размеры могут быть получены вызовом функции 9.

    Текущие положение и размеры могут быть получены вызовом функции 9.

  * Окно должно умещаться на экране. Если переданные координаты

  * Окно должно умещаться на экране. Если переданные координаты

    и размеры не удовлетворяют этому условию, то соответствующая

    и размеры не удовлетворяют этому условию, то соответствующая

    координата (или, возможно, обе) считается нулем, а если и это

    координата (или, возможно, обе) считается нулем, а если и это

    не помогает, то соответствующий размер (или, возможно, оба)

    не помогает, то соответствующий размер (или, возможно, оба)

    устанавливается в размер экрана.

    устанавливается в размер экрана.

    Далее обозначим xpos,ypos,xsize,ysize - значения, передаваемые

    Далее обозначим xpos,ypos,xsize,ysize - значения, передаваемые

    в ebx,ecx. Координаты приводятся относительно левого верхнего

    в ebx,ecx. Координаты приводятся относительно левого верхнего

    угла окна, который, таким образом, задается как (0,0), координаты

    угла окна, который, таким образом, задается как (0,0), координаты

    правого нижнего угла суть (xsize,ysize).

    правого нижнего угла суть (xsize,ysize).

  * Размеры окна понимаются в смысле координат правого нижнего угла.

  * Размеры окна понимаются в смысле координат правого нижнего угла.

    Это же относится и ко всем остальным функциям.

    Это же относится и ко всем остальным функциям.

    Это означает, что реальные размеры на 1 пиксель больше.

    Это означает, что реальные размеры на 1 пиксель больше.

  * Вид окна типа I:

  * Вид окна типа I:

    * рисуется внешняя рамка цвета, указанного в edi,

    * рисуется внешняя рамка цвета, указанного в edi,

      шириной 1 пиксель

      шириной 1 пиксель

    * рисуется заголовок - прямоугольник с левым верхним углом (1,1)

    * рисуется заголовок - прямоугольник с левым верхним углом (1,1)

      и правым нижним (xsize-1,min(20,ysize-1)) цвета, указанного в esi

      и правым нижним (xsize-1,min(20,ysize-1)) цвета, указанного в esi

      (с учетом градиента)

      (с учетом градиента)

    * если ysize>21, то закрашивается рабочая область окна -

    * если ysize>21, то закрашивается рабочая область окна -

      прямоугольник с левым верхним углом (1,21) и правым нижним

      прямоугольник с левым верхним углом (1,21) и правым нижним

      (xsize-1,ysize-1) (размерами (xsize-1)*(ysize-21)) - цветом,

      (xsize-1,ysize-1) (размерами (xsize-1)*(ysize-21)) - цветом,

      указанным в edx (с учетом градиента)

      указанным в edx (с учетом градиента)

    * если A=1 и строка заголовка установлена подфункцией 1

    * если A=1 и строка заголовка установлена подфункцией 1

      функции 71, то она выводится в соответствующем месте заголовка

      функции 71, то она выводится в соответствующем месте заголовка

  * Вид окна стиля Y=1:

  * Вид окна стиля Y=1:

    * полностью определяется приложением

    * полностью определяется приложением

  * Вид окна типа II:

  * Вид окна типа II:

    * рисуется внешняя рамка шириной 1 пиксель "затенённого" цвета

    * рисуется внешняя рамка шириной 1 пиксель "затенённого" цвета

      edi (все составляющие цвета уменьшаются в два раза)

      edi (все составляющие цвета уменьшаются в два раза)

    * рисуется промежуточная рамка шириной 3 пикселя цвета edi

    * рисуется промежуточная рамка шириной 3 пикселя цвета edi

    * рисуется внутренняя рамка шириной 1 пиксель

    * рисуется внутренняя рамка шириной 1 пиксель

      "затенённого" цвета edi

      "затенённого" цвета edi

    * рисуется заголовок - прямоугольник с левым верхним углом (4,4)

    * рисуется заголовок - прямоугольник с левым верхним углом (4,4)

      и правым нижним (xsize-4,min(20,ysize)) цвета, указанного в esi

      и правым нижним (xsize-4,min(20,ysize)) цвета, указанного в esi

      (с учетом градиента)

      (с учетом градиента)

    * если ysize>=26, то закрашивается рабочая область окна -

    * если ysize>=26, то закрашивается рабочая область окна -

      прямоугольник с левым верхним углом (5,20) и правым нижним

      прямоугольник с левым верхним углом (5,20) и правым нижним

      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)

      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)

    * если A=1 и строка заголовка установлена подфункцией 1

    * если A=1 и строка заголовка установлена подфункцией 1

      функции 71, то она выводится в соответствующем месте заголовка

      функции 71, то она выводится в соответствующем месте заголовка

  * Вид окна со скином:

  * Вид окна со скином:

    * рисуется внешняя рамка шириной 1 пиксель

    * рисуется внешняя рамка шириной 1 пиксель

      цвета 'outer' из скина

      цвета 'outer' из скина

    * рисуется промежуточная рамка шириной 3 пикселя

    * рисуется промежуточная рамка шириной 3 пикселя

      цвета 'frame' из скина

      цвета 'frame' из скина

    * рисуется внутренняя рамка шириной 1 пиксель

    * рисуется внутренняя рамка шириной 1 пиксель

      цвета 'inner' из скина

      цвета 'inner' из скина

    * рисуется заголовок (по картинкам из скина) в прямоугольнике

    * рисуется заголовок (по картинкам из скина) в прямоугольнике

      (0,0) - (xsize,_skinh-1)

      (0,0) - (xsize,_skinh-1)

    * если ysize>=26, то закрашивается рабочая область окна -

    * если ysize>=26, то закрашивается рабочая область окна -

      прямоугольник с левым верхним углом (5,_skinh) и правым нижним

      прямоугольник с левым верхним углом (5,_skinh) и правым нижним

      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)

      (xsize-5,ysize-5) - цветом, указанным в edx (с учетом градиента)

    * определяются две стандартные кнопки: закрытия и минимизации

    * определяются две стандартные кнопки: закрытия и минимизации

      (смотри функцию 8)

      (смотри функцию 8)

    * если A=1 и в edi (ненулевой) указатель на строку заголовка,

    * если A=1 и в edi (ненулевой) указатель на строку заголовка,

      то она выводится в заголовке в месте, определяемом скином

      то она выводится в заголовке в месте, определяемом скином

    * Значение переменной _skinh доступно как результат вызова

    * Значение переменной _skinh доступно как результат вызова

      подфункции 4 функции 48

      подфункции 4 функции 48

  eax - SF_CREATE_WINDOW (0)

======================================================================

======================================================================

================= Функция 1 - поставить точку в окне. ================

================= Функция 1 - поставить точку в окне. ================

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 1 - номер функции

  * eax = 1 - номер функции

  * ebx = x-координата (относительно окна)

  * ebx = x-координата (относительно окна)

  * ecx = y-координата (относительно окна)

  * ecx = y-координата (относительно окна)

  * edx = 0x00RRGGBB - цвет точки

  * edx = 0x00RRGGBB - цвет точки

    edx = 0x01xxxxxx - инвертировать цвет точки

    edx = 0x01xxxxxx - инвертировать цвет точки

          (младшие 24 бита игнорируются)

          (младшие 24 бита игнорируются)

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

  eax - SF_PUT_PIXEL (1)

======================================================================

======================================================================

============== Функция 2 - получить код нажатой клавиши. =============

============== Функция 2 - получить код нажатой клавиши. =============

======================================================================

======================================================================

Забирает код нажатой клавиши из буфера.

Забирает код нажатой клавиши из буфера.

Параметры:

Параметры:

  * eax = 2 - номер функции

  * eax = 2 - номер функции

Возвращаемое значение:

Возвращаемое значение:

  * если буфер пуст, возвращается eax=1

  * если буфер пуст, возвращается eax=1

  * если буфер непуст, то возвращается al=0, ah=код нажатой клавиши,

  * если буфер непуст, то возвращается al=0, ah=код нажатой клавиши,

    биты 16-23 содержат сканкод нажатой клавиши в режиме ASCII,

    биты 16-23 содержат сканкод нажатой клавиши в режиме ASCII,

               в режме сканкодов биты обнулены.

               в режме сканкодов биты обнулены.

    биты 23-31 обнулены

    биты 23-31 обнулены

  * если есть "горячая клавиша", то возвращается

  * если есть "горячая клавиша", то возвращается

    al=2, ah=сканкод нажатой клавиши (0 для управляющих клавиш),

    al=2, ah=сканкод нажатой клавиши (0 для управляющих клавиш),

    старшее слово регистра eax содержит состояние управляющих клавиш

    старшее слово регистра eax содержит состояние управляющих клавиш

    в момент нажатия горячей клавиши

    в момент нажатия горячей клавиши

Замечания:

Замечания:

  * Существует общесистемный буфер нажатых клавиш размером 120 байт,

  * Существует общесистемный буфер нажатых клавиш размером 120 байт,

    организованный как очередь.

    организованный как очередь.

  * Существует ещё один общесистемный буфер на 120 "горячих клавиш".

  * Существует ещё один общесистемный буфер на 120 "горячих клавиш".

  * При вызове этой функции приложением с неактивным окном

  * При вызове этой функции приложением с неактивным окном

    считается, что буфер нажатых клавиш пуст.

    считается, что буфер нажатых клавиш пуст.

  * По умолчанию эта функция возвращает ASCII-коды; переключиться на

  * По умолчанию эта функция возвращает ASCII-коды; переключиться на

    режим сканкодов (и назад) можно с использованием функции 66.

    режим сканкодов (и назад) можно с использованием функции 66.

    Однако, горячие клавиши всегда возвращаются как сканкоды.

    Однако, горячие клавиши всегда возвращаются как сканкоды.

  * Узнать, какие комбинации клавиш соответствуют каким кодам, можно,

  * Узнать, какие комбинации клавиш соответствуют каким кодам, можно,

    запустив приложения keyascii и scancode.

    запустив приложения keyascii и scancode.

  * Сканкоды возвращаются непосредственно клавиатурой и фиксированы;

  * Сканкоды возвращаются непосредственно клавиатурой и фиксированы;

    ASCII-коды получаются с использованием таблиц преобразования,

    ASCII-коды получаются с использованием таблиц преобразования,

    которые можно установить подфункцией 2 функции 21 и прочитать

    которые можно установить подфункцией 2 функции 21 и прочитать

    подфункцией 2 функции 26.

    подфункцией 2 функции 26.

  * Как следствие, ASCII-коды учитывают текущую раскладку клавиатуры

  * Как следствие, ASCII-коды учитывают текущую раскладку клавиатуры

    (rus/en) в отличие от сканкодов.

    (rus/en) в отличие от сканкодов.

  * Поступает информация только о тех горячих клавишах, которые были

  * Поступает информация только о тех горячих клавишах, которые были

    определены этим потоком подфункцией 4 функции 66.

    определены этим потоком подфункцией 4 функции 66.

  eax - SF_GET_KEY (2)

======================================================================

======================================================================

================ Функция 3 - получить системное время. ===============

================ Функция 3 - получить системное время. ===============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 3 - номер функции

  * eax = 3 - номер функции

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0x00SSMMHH, где HH:MM:SS = часы:минуты:секунды

  * eax = 0x00SSMMHH, где HH:MM:SS = часы:минуты:секунды

  * каждый элемент возвращается как BCD-число, например,

  * каждый элемент возвращается как BCD-число, например,

    для времени 23:59:59 результат будет 0x00595923

    для времени 23:59:59 результат будет 0x00595923

Замечания:

Замечания:

  * Смотри также подфункцию 9 функции 26 - получение времени

  * Смотри также подфункцию 9 функции 26 - получение времени

    с момента запуска системы; она во многих случаях удобнее,

    с момента запуска системы; она во многих случаях удобнее,

    поскольку возвращает просто DWORD-значение счетчика времени.

    поскольку возвращает просто DWORD-значение счетчика времени.

  * Системное время можно установить функцией 22.

  * Системное время можно установить функцией 22.

  eax - SF_GET_SYS_TIME (3)

======================================================================

======================================================================

================ Функция 4 - нарисовать строку текста. ===============

================ Функция 4 - нарисовать строку текста. ===============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 4 - номер функции

  * eax = 4 - номер функции

  * ebx = X*65536+Y, координаты в окне или буфере

  * ebx = X*65536+Y, координаты в окне или буфере

  * ecx = 0xXXRRGGBB, где

  * ecx = 0xXXRRGGBB, где

    * RR, GG, BB задают цвет текста

    * RR, GG, BB задают цвет текста

    * XX=ABFFCSSS (биты):

    * XX=ABFFCSSS (биты):

      * A=1 - рисуемая строка заканчивается нулём

      * A=1 - рисуемая строка заканчивается нулём

      * B=1 - закрашивать фон (цвет = edi)

      * B=1 - закрашивать фон (цвет = edi)

      * FF задает шрифт и кодировку:

      * FF задает шрифт и кодировку:

        0 = 6x9  cp866

        0 = 6x9  cp866

        1 = 8x16 cp866

        1 = 8x16 cp866

        2 = 8x16 UTF-16LE

        2 = 8x16 UTF-16LE

        3 = 8x16 UTF-8

        3 = 8x16 UTF-8

      * C=0 - рисовать в окно,

      * C=0 - рисовать в окно,

        С=1 - рисовать в буфер (edi)

        С=1 - рисовать в буфер (edi)

      * SSS = (множитель размера)-1, то-есть 0 = x1, 7 = x8

      * SSS = (множитель размера)-1, то-есть 0 = x1, 7 = x8

  * edx = указатель на начало строки

  * edx = указатель на начало строки

  * esi = для A=0 длина строки, для A=1 игнорируется

  * esi = для A=0 длина строки, для A=1 игнорируется

  * edi = если B=1 - цвет для закраски фона,

  * edi = если B=1 - цвет для закраски фона,

          если C=1 - указатель на буфер

          если C=1 - указатель на буфер

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Нельзя одновременно использовать B=1 и C=1,

  * Нельзя одновременно использовать B=1 и C=1,

    поскольку в обоих случаях используется регистр edi.

    поскольку в обоих случаях используется регистр edi.

  * Если SSS=0, шрифт может сглаживаться,

  * Если SSS=0, шрифт может сглаживаться,

    в зависимости от системной настройки.

    в зависимости от системной настройки.

  * Структура буфера:

  * Структура буфера:

Xsize       dd

Xsize       dd

Ysize       dd

Ysize       dd

picture     rb  Xsize*Ysize*4  ; 32 бита

picture     rb  Xsize*Ysize*4  ; 32 бита

  eax - SF_DRAW_TEXT (4)

======================================================================

======================================================================

========================= Функция 5 - пауза. =========================

========================= Функция 5 - пауза. =========================

======================================================================

======================================================================

Задерживает выполнение программы на заданное время.

Задерживает выполнение программы на заданное время.

Параметры:

Параметры:

  * eax = 5 - номер функции

  * eax = 5 - номер функции

  * ebx = время в сотых долях секунды

  * ebx = время в сотых долях секунды

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Передача ebx=0 не передает управление следующему процессу и

  * Передача ebx=0 не передает управление следующему процессу и

    вообще не производит никаких действий. Если действительно

    вообще не производит никаких действий. Если действительно

    требуется передать управление следующему процессу

    требуется передать управление следующему процессу

    (закончить текущий квант времени), используйте подфункцию 1

    (закончить текущий квант времени), используйте подфункцию 1

    функции 68.

    функции 68.

  eax - SF_SLEEP (5)

======================================================================

======================================================================

=============== Функция 7 - вывести изображение в окно. ==============

=============== Функция 7 - вывести изображение в окно. ==============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 7 - номер функции

  * eax = 7 - номер функции

  * ebx = указатель на изображение в формате BBGGRRBBGGRR...

  * ebx = указатель на изображение в формате BBGGRRBBGGRR...

  * ecx = [размер по оси x]*65536 + [размер по оси y]

  * ecx = [размер по оси x]*65536 + [размер по оси y]

  * edx = [координата по оси x]*65536 + [координата по оси y]

  * edx = [координата по оси x]*65536 + [координата по оси y]

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Координаты изображения - это координаты верхнего левого угла

  * Координаты изображения - это координаты верхнего левого угла

    изображения относительно окна.

    изображения относительно окна.

  * Размер изображения в байтах есть 3*xsize*ysize.

  * Размер изображения в байтах есть 3*xsize*ysize.

  eax - SF_PUT_IMAGE (7)

======================================================================

======================================================================

=============== Функция 8 - определить/удалить кнопку. ===============

=============== Функция 8 - определить/удалить кнопку. ===============

======================================================================

======================================================================

Параметры для определения кнопки:

Параметры для определения кнопки:

  * eax = 8 - номер функции

  * eax = 8 - номер функции

  * ebx = [координата по оси x]*65536 + [размер по оси x]

  * ebx = [координата по оси x]*65536 + [размер по оси x]

  * ecx = [координата по оси y]*65536 + [размер по оси y]

  * ecx = [координата по оси y]*65536 + [размер по оси y]

  * edx = 0xXYnnnnnn, где:

  * edx = 0xXYnnnnnn, где:

    * nnnnnn = идентификатор кнопки

    * nnnnnn = идентификатор кнопки

    * старший (31-й) бит edx сброшен

    * старший (31-й) бит edx сброшен

    * если 30-й бит edx установлен - не прорисовывать кнопку

    * если 30-й бит edx установлен - не прорисовывать кнопку

    * если 29-й бит edx установлен - не рисовать рамку

    * если 29-й бит edx установлен - не рисовать рамку

      при нажатии на кнопку

      при нажатии на кнопку

  * esi = 0x00RRGGBB - цвет кнопки

  * esi = 0x00RRGGBB - цвет кнопки

Параметры для удаления кнопки:

Параметры для удаления кнопки:

  * eax = 8 - номер функции

  * eax = 8 - номер функции

  * edx = 0x80nnnnnn, где nnnnnn - идентификатор кнопки

  * edx = 0x80nnnnnn, где nnnnnn - идентификатор кнопки

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Размеры кнопки должны быть больше 0 и меньше 0x8000.

  * Размеры кнопки должны быть больше 0 и меньше 0x8000.

  * Для окон со скином при определении окна (вызове 0-й функции)

  * Для окон со скином при определении окна (вызове 0-й функции)

    создаются две стандартные кнопки - закрытия окна

    создаются две стандартные кнопки - закрытия окна

    с идентификатором 1 и минимизации окна с идентификатором 0xffff.

    с идентификатором 1 и минимизации окна с идентификатором 0xffff.

  * Создание двух кнопок с одинаковыми идентификаторами

  * Создание двух кнопок с одинаковыми идентификаторами

    вполне допустимо.

    вполне допустимо.

  * Кнопка с идентификатором 0xffff при нажатии интерпретируется

  * Кнопка с идентификатором 0xffff при нажатии интерпретируется

    системой как кнопка минимизации, система обрабатывает такое

    системой как кнопка минимизации, система обрабатывает такое

    нажатие самостоятельно, не обращаясь к приложению.

    нажатие самостоятельно, не обращаясь к приложению.

    В остальном это обычная кнопка.

    В остальном это обычная кнопка.

  * Общее количество кнопок для всех приложений ограничено

  * Общее количество кнопок для всех приложений ограничено

    числом 4095.

    числом 4095.

  eax - SF_DEFINE_BUTTON (8)

======================================================================

======================================================================

============= Функция 9 - информация о потоке выполнения. ============

============= Функция 9 - информация о потоке выполнения. ============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 9 - номер функции

  * eax = 9 - номер функции

  * ebx = указатель на буфер размера 1 Кб

  * ebx = указатель на буфер размера 1 Кб

  * ecx = номер слота потока

  * ecx = номер слота потока

    ecx = -1 - получить информацию о текущем потоке

    ecx = -1 - получить информацию о текущем потоке

Возвращаемое значение:

Возвращаемое значение:

  * eax = максимальный номер слота потока

  * eax = максимальный номер слота потока

  * буфер, на который указывает ebx, содержит следующую информацию:

  * буфер, на который указывает ebx, содержит следующую информацию:

    * +0: dword: использование процессора (сколько тактов в секунду

    * +0: dword: использование процессора (сколько тактов в секунду

      уходит на исполнение именно этого потока)

      уходит на исполнение именно этого потока)

    * +4: word: позиция окна потока в оконном стэке

    * +4: word: позиция окна потока в оконном стэке

    * +6: word: (не имеет отношения к запрошенному потоку)

    * +6: word: (не имеет отношения к запрошенному потоку)

      номер слота потока, окно которого находится в оконном стэке

      номер слота потока, окно которого находится в оконном стэке

      в позиции ecx

      в позиции ecx

    * +8: word: зарезервировано

    * +8: word: зарезервировано

    * +10 = +0xA: 11 байт: имя процесса

    * +10 = +0xA: 11 байт: имя процесса

      (имя запущенного файла - исполняемый файл без расширения)

      (имя запущенного файла - исполняемый файл без расширения)

    * +21 = +0x15: byte: зарезервировано, этот байт не изменяется

    * +21 = +0x15: byte: зарезервировано, этот байт не изменяется

    * +22 = +0x16: dword: адрес процесса в памяти

    * +22 = +0x16: dword: адрес процесса в памяти

    * +26 = +0x1A: dword: размер используемой памяти - 1

    * +26 = +0x1A: dword: размер используемой памяти - 1

    * +30 = +0x1E: dword: идентификатор (PID/TID)

    * +30 = +0x1E: dword: идентификатор (PID/TID)

    * +34 = +0x22: dword: координата окна потока по оси x

    * +34 = +0x22: dword: координата окна потока по оси x

    * +38 = +0x26: dword: координата окна потока по оси y

    * +38 = +0x26: dword: координата окна потока по оси y

    * +42 = +0x2A: dword: размер окна потока по оси x

    * +42 = +0x2A: dword: размер окна потока по оси x

    * +46 = +0x2E: dword: размер окна потока по оси y

    * +46 = +0x2E: dword: размер окна потока по оси y

    * +50 = +0x32: word: состояние слота потока:

    * +50 = +0x32: word: состояние слота потока:

      * 0 = поток выполняется

      * 0 = поток выполняется

      * 1 = поток приостановлен

      * 1 = поток приостановлен

      * 2 = поток приостановлен в момент ожидания события

      * 2 = поток приостановлен в момент ожидания события

      * 3 = поток завершается в результате вызова функции -1 или

      * 3 = поток завершается в результате вызова функции -1 или

        насильственно как следствие вызова подфункции 2 функции 18

        насильственно как следствие вызова подфункции 2 функции 18

        или завершения работы системы

        или завершения работы системы

      * 4 = поток завершается в результате исключения

      * 4 = поток завершается в результате исключения

      * 5 = поток ожидает события

      * 5 = поток ожидает события

      * 9 = запрошенный слот свободен, вся остальная информация о

      * 9 = запрошенный слот свободен, вся остальная информация о

        слоте не имеет смысла

        слоте не имеет смысла

    * +52 = +0x34: word: зарезервировано, это слово не изменяется

    * +52 = +0x34: word: зарезервировано, это слово не изменяется

    * +54 = +0x36: dword: координата начала клиентской области

    * +54 = +0x36: dword: координата начала клиентской области

                          по оси x

                          по оси x

    * +58 = +0x3A: dword: координата начала клиентской области

    * +58 = +0x3A: dword: координата начала клиентской области

                          по оси y

                          по оси y

    * +62 = +0x3E: dword: ширина клиентской области

    * +62 = +0x3E: dword: ширина клиентской области

    * +66 = +0x42: dword: высота клиентской области

    * +66 = +0x42: dword: высота клиентской области

    * +70 = +0x46: byte: состояние окна - битовое поле

    * +70 = +0x46: byte: состояние окна - битовое поле

      * бит 0 (маска 1): окно максимизировано

      * бит 0 (маска 1): окно максимизировано

      * бит 1 (маска 2): окно минимизировано в панель задач

      * бит 1 (маска 2): окно минимизировано в панель задач

      * бит 2 (маска 4): окно свёрнуто в заголовок

      * бит 2 (маска 4): окно свёрнуто в заголовок

    * +71 = +0x47: dword: маска событий

    * +71 = +0x47: dword: маска событий

    * +75 = +0x4B: byte: режим ввода с клавиатуры(ASCII = 0; SCAN = 1)

    * +75 = +0x4B: byte: режим ввода с клавиатуры(ASCII = 0; SCAN = 1)

Замечания:

Замечания:

  * Слоты нумеруются с 1.

  * Слоты нумеруются с 1.

  * Возвращаемое значение не есть общее число потоков, поскольку

  * Возвращаемое значение не есть общее число потоков, поскольку

    бывают свободные слоты.

    бывают свободные слоты.

  * При создании процесса автоматически создается поток выполнения.

  * При создании процесса автоматически создается поток выполнения.

  * Функция выдает информацию о потоке. Каждый процесс имеет

  * Функция выдает информацию о потоке. Каждый процесс имеет

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

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

    в этом случае каждый поток получает свой слот, причем поля

    в этом случае каждый поток получает свой слот, причем поля

    +10, +22, +26 в этих слотах совпадают.

    +10, +22, +26 в этих слотах совпадают.

    Для приложений не существует общего способа определить,

    Для приложений не существует общего способа определить,

    принадлежат ли два потока одному процессу.

    принадлежат ли два потока одному процессу.

  * Активное окно - окно, находящееся на вершине оконного стэка,

  * Активное окно - окно, находящееся на вершине оконного стэка,

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

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

    оконном стэке совпадает с возвращаемым значением.

    оконном стэке совпадает с возвращаемым значением.

  * Слот 1 соответствует специальному потоку операционной системы,

  * Слот 1 соответствует специальному потоку операционной системы,

    для которого:

    для которого:

    * окно находится внизу оконного стэка, поля +4 и +6 содержат

    * окно находится внизу оконного стэка, поля +4 и +6 содержат

      значение 1

      значение 1

    * имя процесса - "OS/IDLE" (дополненное пробелами)

    * имя процесса - "OS/IDLE" (дополненное пробелами)

    * адрес процесса в памяти равен 0, размер используемой памяти

    * адрес процесса в памяти равен 0, размер используемой памяти

      16 Mb (0x1000000)

      16 Mb (0x1000000)

    * PID=1

    * PID=1

    * координаты и размеры окна, равно как и клиентской области,

    * координаты и размеры окна, равно как и клиентской области,

      условно полагаются равными 0

      условно полагаются равными 0

    * состояние слота - всегда 0 (выполняется)

    * состояние слота - всегда 0 (выполняется)

    * время выполнения складывается из времени, уходящего на

    * время выполнения складывается из времени, уходящего на

      собственно работу, и времени простоя в ожидании прерывания

      собственно работу, и времени простоя в ожидании прерывания

      (которое можно получить вызовом подфункции 4 функции 18).

      (которое можно получить вызовом подфункции 4 функции 18).

  * Начиная со слота 2, размещаются обычные приложения.

  * Начиная со слота 2, размещаются обычные приложения.

  * Обычные приложения размещаются в памяти по адресу 0

  * Обычные приложения размещаются в памяти по адресу 0

    (константа ядра std_application_base_address).

    (константа ядра std_application_base_address).

    Наложения не происходит, поскольку у каждого процесса своя

    Наложения не происходит, поскольку у каждого процесса своя

    таблица страниц.

    таблица страниц.

  * При создании потока ему назначаются слот в системной таблице и

  * При создании потока ему назначаются слот в системной таблице и

    идентификатор (Process/Thread IDentifier = PID/TID), которые для

    идентификатор (Process/Thread IDentifier = PID/TID), которые для

    заданного потока не изменяются со временем.

    заданного потока не изменяются со временем.

    После завершения потока его слот может быть заново использован

    После завершения потока его слот может быть заново использован

    для другого потока. Идентификатор потока не может быть назначен

    для другого потока. Идентификатор потока не может быть назначен

    другому потоку даже после завершения первого.

    другому потоку даже после завершения первого.

    Назначаемые новым потокам идентификаторы монотонно растут.

    Назначаемые новым потокам идентификаторы монотонно растут.

  * Если поток еще не определил свое окно вызовом функции 0, то

  * Если поток еще не определил свое окно вызовом функции 0, то

    положение и размеры этого окна полагаются нулями.

    положение и размеры этого окна полагаются нулями.

  * Координаты клиентской области окна берутся относительно окна.

  * Координаты клиентской области окна берутся относительно окна.

  * В данный момент используется только часть буфера размером

  * В данный момент используется только часть буфера размером

    76 = 0x4C байта. Тем не менее рекомендуется использовать буфер

    76 = 0x4C байта. Тем не менее рекомендуется использовать буфер

    размером 1 Кб для будущей совместимости, в будущем могут быть

    размером 1 Кб для будущей совместимости, в будущем могут быть

    добавлены некоторые поля.

    добавлены некоторые поля.

  eax - SF_THREAD_INFO (9)

======================================================================

======================================================================

==================== Функция 10 - ожидать события. ===================

==================== Функция 10 - ожидать события. ===================

======================================================================

======================================================================

Если очередь сообщений пуста, то ждет появления сообщения в очереди.

Если очередь сообщений пуста, то ждет появления сообщения в очереди.

В таком состоянии поток не получает процессорного времени.

В таком состоянии поток не получает процессорного времени.

Затем считывает сообщение из очереди.

Затем считывает сообщение из очереди.

Параметры:

Параметры:

  * eax = 10 - номер функции

  * eax = 10 - номер функции

Возвращаемое значение:

Возвращаемое значение:

  * eax = событие (смотри список событий)

  * eax = событие (смотри список событий)

Замечания:

Замечания:

  * Учитываются только те события, которые входят в маску,

  * Учитываются только те события, которые входят в маску,

    устанавливаемую функцией 40. По умолчанию это события

    устанавливаемую функцией 40. По умолчанию это события

    перерисовки, нажатия на клавиши и на кнопки.

    перерисовки, нажатия на клавиши и на кнопки.

  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.

  * Для проверки, есть ли сообщение в очереди, используйте функцию 11.

    Чтобы ждать не более определенного времени, используйте

    Чтобы ждать не более определенного времени, используйте

    функцию 23.

    функцию 23.

  eax - SF_WAIT_EVENT (10)

======================================================================

======================================================================

======= Функция 11 - проверить, есть ли событие, без ожидания. =======

======= Функция 11 - проверить, есть ли событие, без ожидания. =======

======================================================================

======================================================================

Если в очереди сообщений есть какое-то событие, то считывает и

Если в очереди сообщений есть какое-то событие, то считывает и

возвращает его. Если очередь пуста, возвращает нуль.

возвращает его. Если очередь пуста, возвращает нуль.

Параметры:

Параметры:

  * eax = 11 - номер функции

  * eax = 11 - номер функции

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0 - очередь сообщений пуста

  * eax = 0 - очередь сообщений пуста

  * иначе eax = событие (смотри список событий)

  * иначе eax = событие (смотри список событий)

Замечания:

Замечания:

  * Учитываются только те события, которые входят в маску,

  * Учитываются только те события, которые входят в маску,

    устанавливаемую функцией 40. По умолчанию это события

    устанавливаемую функцией 40. По умолчанию это события

    перерисовки, нажатия на клавиши и на кнопки.

    перерисовки, нажатия на клавиши и на кнопки.

  * Для ожидания появления события в очереди, используйте функцию 10.

  * Для ожидания появления события в очереди, используйте функцию 10.

    Чтобы ждать не более определенного времени, используйте

    Чтобы ждать не более определенного времени, используйте

    функцию 23.

    функцию 23.

  eax - SF_CHECK_EVENT (11)

======================================================================

======================================================================

=========== Функция 12 - начать/закончить перерисовку окна. ==========

=========== Функция 12 - начать/закончить перерисовку окна. ==========

======================================================================

======================================================================

-------------- Подфункция 1 - начать перерисовку окна. ---------------

-------------- Подфункция 1 - начать перерисовку окна. ---------------

Параметры:

Параметры:

  * eax = 12 - номер функции

  * eax = 12 - номер функции

  * ebx = 1 - номер подфункции

  * ebx = 1 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

------------- Подфункция 2 - закончить перерисовку окна. -------------

------------- Подфункция 2 - закончить перерисовку окна. -------------

Параметры:

Параметры:

  * eax = 12 - номер функции

  * eax = 12 - номер функции

  * ebx = 2 - номер подфункции

  * ebx = 2 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Функция начала перерисовки удаляет все определённые

  * Функция начала перерисовки удаляет все определённые

    функцией 8 кнопки, их следует определить повторно.

    функцией 8 кнопки, их следует определить повторно.

  ebx - SSF_BEGIN_DRAW (1), SSF_END_DRAW (2)

======================================================================

======================================================================

============ Функция 13 - нарисовать прямоугольник в окне. ===========

============ Функция 13 - нарисовать прямоугольник в окне. ===========

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 13 - номер функции

  * eax = 13 - номер функции

  * ebx = [координата по оси x]*65536 + [размер по оси x]

  * ebx = [координата по оси x]*65536 + [размер по оси x]

  * ecx = [координата по оси y]*65536 + [размер по оси y]

  * ecx = [координата по оси y]*65536 + [размер по оси y]

  * edx = цвет 0xRRGGBB или 0x80RRGGBB для градиентной заливки

  * edx = цвет 0xRRGGBB или 0x80RRGGBB для градиентной заливки

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Под координатами понимаются координаты левого верхнего угла

  * Под координатами понимаются координаты левого верхнего угла

    прямоугольника относительно окна.

    прямоугольника относительно окна.

  eax - SF_DRAW_RECT (13)

======================================================================

======================================================================

================ Функция 14 - получить размеры экрана. ===============

================ Функция 14 - получить размеры экрана. ===============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 14 - номер функции

  * eax = 14 - номер функции

Возвращаемое значение:

Возвращаемое значение:

  * eax = [xsize]*65536 + [ysize], где

  * eax = [xsize]*65536 + [ysize], где

  * xsize = x-координата правого нижнего угла экрана =

  * xsize = x-координата правого нижнего угла экрана =

            размер по горизонтали - 1

            размер по горизонтали - 1

  * ysize = y-координата правого нижнего угла экрана =

  * ysize = y-координата правого нижнего угла экрана =

            размер по вертикали - 1

            размер по вертикали - 1

Замечания:

Замечания:

  * Смотри также подфункцию 5 функции 48 - получить размеры рабочей

  * Смотри также подфункцию 5 функции 48 - получить размеры рабочей

    области экрана.

    области экрана.

  eax - SF_GET_SCREEN_SIZE (14)

======================================================================

======================================================================

= Функция 15, подфункция 1 - установить размер фонового изображения. =

= Функция 15, подфункция 1 - установить размер фонового изображения. =

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 1 - номер подфункции

  * ebx = 1 - номер подфункции

  * ecx = ширина изображения

  * ecx = ширина изображения

  * edx = высота изображения

  * edx = высота изображения

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Вызов функции обязателен перед вызовом подфункций 2 и 5.

  * Вызов функции обязателен перед вызовом подфункций 2 и 5.

  * Для обновления экрана (после завершения серии команд, работающих с

  * Для обновления экрана (после завершения серии команд, работающих с

    фоном) вызывайте подфункцию 3 перерисовки фона.

    фоном) вызывайте подфункцию 3 перерисовки фона.

  * Есть парная функция получения размеров фонового изображения -

  * Есть парная функция получения размеров фонового изображения -

    подфункция 1 функции 39.

    подфункция 1 функции 39.

  ebx - SSF_SIZE_BG (1)

======================================================================

======================================================================

= Функция 15, подфункция 2 - поставить точку на фоновом изображении. =

= Функция 15, подфункция 2 - поставить точку на фоновом изображении. =

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 2 - номер подфункции

  * ebx = 2 - номер подфункции

  * ecx = смещение

  * ecx = смещение

  * edx = цвет точки 0xRRGGBB

  * edx = цвет точки 0xRRGGBB

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Смещение для точки с координатами (x,y) вычисляется как

  * Смещение для точки с координатами (x,y) вычисляется как

    (x+y*xsize)*3.

    (x+y*xsize)*3.

  * Если указанное смещение превышает установленный подфункцией 1

  * Если указанное смещение превышает установленный подфункцией 1

    размер, вызов игнорируется.

    размер, вызов игнорируется.

  * Для обновления экрана (после завершения серии команд, работающих с

  * Для обновления экрана (после завершения серии команд, работающих с

    фоном) вызывайте подфункцию 3 перерисовки фона.

    фоном) вызывайте подфункцию 3 перерисовки фона.

  * Есть парная функция получения точки с фонового изображения -

  * Есть парная функция получения точки с фонового изображения -

    подфункция 2 функции 39.

    подфункция 2 функции 39.

  ebx - SSF_PIXEL_BG (2)

======================================================================

======================================================================

============ Функция 15, подфункция 3 - перерисовать фон. ============

============ Функция 15, подфункция 3 - перерисовать фон. ============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 3 - номер подфункции

  * ebx = 3 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

  ebx - SSF_REDRAW_BG (3)

======================================================================

======================================================================

===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====

===== Функция 15, подфункция 4 - установить режим отрисовки фона. ====

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 4 - номер подфункции

  * ebx = 4 - номер подфункции

  * ecx = режим отрисовки:

  * ecx = режим отрисовки:

    * 1 = замостить

    * 1 = замостить

    * 2 = растянуть

    * 2 = растянуть

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Для обновления экрана (после завершения серии команд, работающих с

  * Для обновления экрана (после завершения серии команд, работающих с

    фоном) вызывайте подфункцию 3 перерисовки фона.

    фоном) вызывайте подфункцию 3 перерисовки фона.

  * Есть парная команда получения режима отрисовки фона -

  * Есть парная команда получения режима отрисовки фона -

    подфункция 4 функции 39.

    подфункция 4 функции 39.

  ebx - SSF_MODE_BG (4)

======================================================================

======================================================================

===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====

===== Функция 15, подфункция 5 - поместить блок пикселей на фон. =====

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 5 - номер подфункции

  * ebx = 5 - номер подфункции

  * ecx = указатель на данные в формате BBGGRRBBGGRR...

  * ecx = указатель на данные в формате BBGGRRBBGGRR...

  * edx = смещение в данных фонового изображения

  * edx = смещение в данных фонового изображения

  * esi = размер данных в байтах = 3 * число пикселей

  * esi = размер данных в байтах = 3 * число пикселей

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Проверки корректности смещения и размера не производится.

  * Проверки корректности смещения и размера не производится.

  * Цвет каждого пикселя хранится как 3-байтная величина BBGGRR.

  * Цвет каждого пикселя хранится как 3-байтная величина BBGGRR.

  * Пиксели фонового изображения записываются последовательно

  * Пиксели фонового изображения записываются последовательно

    слева направо, сверху вниз.

    слева направо, сверху вниз.

  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.

  * Смещение пикселя с координатами (x,y) есть (x+y*xsize)*3.

  * Для обновления экрана (после завершения серии команд, работающих с

  * Для обновления экрана (после завершения серии команд, работающих с

    фоном) вызывайте подфункцию 3 перерисовки фона.

    фоном) вызывайте подфункцию 3 перерисовки фона.

  ebx - SSF_IMAGE_BG (5)

======================================================================

======================================================================

====================== Функция 15, подфункция 6 ======================

====================== Функция 15, подфункция 6 ======================

==== Спроецировать данные фона на адресное пространство процесса. ====

==== Спроецировать данные фона на адресное пространство процесса. ====

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 6 - номер подфункции

  * ebx = 6 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = указатель на данные фона, 0 при ошибке

  * eax = указатель на данные фона, 0 при ошибке

Замечания:

Замечания:

  * Спроецированные данные доступны на чтение и запись.

  * Спроецированные данные доступны на чтение и запись.

  * Размер данных фона равен 3*xsize*ysize. Изменение размеров фона

  * Размер данных фона равен 3*xsize*ysize. Изменение размеров фона

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

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

  * Цвет каждого пикселя хранится как 3-байтовая величина BBGGRR.

  * Цвет каждого пикселя хранится как 3-байтовая величина BBGGRR.

  * Пиксели фонового изображения записываются последовательно

  * Пиксели фонового изображения записываются последовательно

    слева направо, сверху вниз.

    слева направо, сверху вниз.

  ebx - SSF_MAP_BG (6)

======================================================================

======================================================================

====================== Функция 15, подфункция 7 ======================

====================== Функция 15, подфункция 7 ======================

=== Закрыть проекцию данных фона на адресное пространство процесса. ==

=== Закрыть проекцию данных фона на адресное пространство процесса. ==

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 7 - номер подфункции

  * ebx = 7 - номер подфункции

  * ecx = указатель на данные фона

  * ecx = указатель на данные фона

Возвращаемое значение:

Возвращаемое значение:

  * eax = 1 при успехе, 0 при ошибке

  * eax = 1 при успехе, 0 при ошибке

  ebx - SSF_UNMAP_BG (7)

======================================================================

======================================================================

====================== Функция 15, подфункция 8 ======================

====================== Функция 15, подфункция 8 ======================

=========== Получить координаты последней отрисовки фона. ============

=========== Получить координаты последней отрисовки фона. ============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 8 - номер подфункции

  * ebx = 8 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = [left]*65536 + [right]

  * eax = [left]*65536 + [right]

  * ebx = [top]*65536 + [bottom]

  * ebx = [top]*65536 + [bottom]

Замечания:

Замечания:

  * (left,top) - координаты левого верхнего угла,

  * (left,top) - координаты левого верхнего угла,

    (right,bottom) - координаты правого нижнего.

    (right,bottom) - координаты правого нижнего.

  * Для получения более достоверных сведений, необходимо вызвать

  * Для получения более достоверных сведений, необходимо вызвать

    функцию сразу после получения события:

    функцию сразу после получения события:

             5 = завершилась перерисовка фона рабочего стола

             5 = завершилась перерисовка фона рабочего стола

  ebx - SSF_LAST_DRAW (8)

======================================================================

======================================================================

====================== Функция 15, подфункция 9 ======================

====================== Функция 15, подфункция 9 ======================

=============== Перерисовать прямоугольную часть фона. ===============

=============== Перерисовать прямоугольную часть фона. ===============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 15 - номер функции

  * eax = 15 - номер функции

  * ebx = 9 - номер подфункции

  * ebx = 9 - номер подфункции

  * ecx = [left]*65536 + [right]

  * ecx = [left]*65536 + [right]

  * edx = [top]*65536 + [bottom]

  * edx = [top]*65536 + [bottom]

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * (left,top) - координаты левого верхнего угла,

  * (left,top) - координаты левого верхнего угла,

    (right,bottom) - координаты правого нижнего.

    (right,bottom) - координаты правого нижнего.

  * Если параметры установлены некорректно - фон не перерисовывается.

  * Если параметры установлены некорректно - фон не перерисовывается.

  ebx - SSF_REDRAW_RECT (9)

======================================================================

======================================================================

============= Функция 16 - сохранить рамдиск на дискету. =============

============= Функция 16 - сохранить рамдиск на дискету. =============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 16 - номер функции

  * eax = 16 - номер функции

  * ebx = 1 или ebx = 2 - на какую дискету сохранять

  * ebx = 1 или ebx = 2 - на какую дискету сохранять

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0 - успешно

  * eax = 0 - успешно

  * eax = 1 - ошибка

  * eax = 1 - ошибка

  eax - SF_RD_TO_FLOPPY (16)

======================================================================

======================================================================

============== Функция 17 - получить код нажатой кнопки. =============

============== Функция 17 - получить код нажатой кнопки. =============

======================================================================

======================================================================

Забирает код нажатой кнопки из буфера.

Забирает код нажатой кнопки из буфера.

Параметры:

Параметры:

  * eax = 17 - номер функции

  * eax = 17 - номер функции

Возвращаемое значение:

Возвращаемое значение:

  * если буфер пуст, возвращается eax=1

  * если буфер пуст, возвращается eax=1

  * если буфер непуст:

  * если буфер непуст:

    * старшие 24 бита eax содержат идентификатор кнопки

    * старшие 24 бита eax содержат идентификатор кнопки

      (в частности, в ah оказывается младший байт идентификатора;

      (в частности, в ah оказывается младший байт идентификатора;

      если все кнопки имеют идентификатор, меньший 256,

      если все кнопки имеют идентификатор, меньший 256,

      то для различения достаточно ah)

      то для различения достаточно ah)

    * al = 0 - кнопка была нажата левой кнопкой мыши

    * al = 0 - кнопка была нажата левой кнопкой мыши

    * al = бит, соответствующий нажавшей кнопке мыши, если не левой

    * al = бит, соответствующий нажавшей кнопке мыши, если не левой

Замечания:

Замечания:

  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки

  * "Буфер" хранит только одну кнопку, при нажатии новой кнопки

    информация о старой теряется.

    информация о старой теряется.

  * При вызове этой функции приложением с неактивным окном

  * При вызове этой функции приложением с неактивным окном

    возвращается ответ "буфер пуст".

    возвращается ответ "буфер пуст".

  * Возвращаемое значение al соответствует состоянию кнопок мыши

  * Возвращаемое значение al соответствует состоянию кнопок мыши

    в формате подфункции 2 функции 37 в момент начала нажатия

    в формате подфункции 2 функции 37 в момент начала нажатия

    на кнопку, за исключением младшего бита (соответствующего левой

    на кнопку, за исключением младшего бита (соответствующего левой

    кнопке мыши), который сбрасывается.

    кнопке мыши), который сбрасывается.

======================================================================

======================================================================

= Функция 18, подфункция 1 - сделать самым нижним окно потока. =======

= Функция 18, подфункция 1 - сделать самым нижним окно потока. =======

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 1 - номер подфункции

  * ebx = 1 - номер подфункции

  * ecx = номер слота потока

  * ecx = номер слота потока

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

  ebx - SSF_UNFOCUS_WINDOW (1)

======================================================================

======================================================================

==== Функция 18, подфункция 2 - завершить процесс/поток по слоту. ====

==== Функция 18, подфункция 2 - завершить процесс/поток по слоту. ====

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 2 - номер подфункции

  * ebx = 2 - номер подфункции

  * ecx = номер слота процесса/потока

  * ecx = номер слота процесса/потока

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Нельзя завершить поток операционной системы OS/IDLE (номер слота

  * Нельзя завершить поток операционной системы OS/IDLE (номер слота

    1), можно завершить любой обычный поток/процесс.

    1), можно завершить любой обычный поток/процесс.

  * Смотри также подфункцию 18 - завершение

  * Смотри также подфункцию 18 - завершение

    процесса/потока с заданным идентификатором.

    процесса/потока с заданным идентификатором.

  ebx - SSF_TERMINATE_THREAD (2)

======================================================================

======================================================================

= Функция 18, подфункция 3 - сделать активным окно заданного потока. =

= Функция 18, подфункция 3 - сделать активным окно заданного потока. =

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 3 - номер подфункции

  * ebx = 3 - номер подфункции

  * ecx = номер слота потока

  * ecx = номер слота потока

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * При указании корректного, но несуществующего слота активизируется

  * При указании корректного, но несуществующего слота активизируется

    какое-то окно.

    какое-то окно.

  * Узнать, какое окно является активным, можно вызовом подфункции 7.

  * Узнать, какое окно является активным, можно вызовом подфункции 7.

  ebx - SSF_FOCUS_WINDOW (3)

======================================================================

======================================================================

 Функция 18, подфункция 4 - получить счётчик пустых тактов в секунду.

 Функция 18, подфункция 4 - получить счётчик пустых тактов в секунду.

======================================================================

======================================================================

Под пустыми тактами понимается время, в которое процессор простаивает

Под пустыми тактами понимается время, в которое процессор простаивает

в ожидании прерывания (в инструкции hlt).

в ожидании прерывания (в инструкции hlt).

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 4 - номер подфункции

  * ebx = 4 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = значение счётчика пустых тактов в секунду

  * eax = значение счётчика пустых тактов в секунду

  ebx - SSF_GET_IDLE_COUNT (4)

======================================================================

======================================================================

======== Функция 18, подфункция 5 - получить тактовую частоту. =======

======== Функция 18, подфункция 5 - получить тактовую частоту. =======

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 5 - номер подфункции

  * ebx = 5 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)

  * eax = тактовая частота (по модулю 2^32 тактов = 4ГГц)

  ebx - SSF_GET_CPU_REQUENCY (5)

======================================================================

======================================================================

 Функция 18, подфункция 6 - сохранить рамдиск в файл на жёстком диске.

 Функция 18, подфункция 6 - сохранить рамдиск в файл на жёстком диске.

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 6 - номер подфункции

  * ebx = 6 - номер подфункции

  * ecx = указатель на строку с полным именем файла

  * ecx = указатель на строку с полным именем файла

    (например, "/hd0/1/kolibri/kolibri.img")

    (например, "/hd0/1/kolibri/kolibri.img")

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0 - успешно

  * eax = 0 - успешно

  * иначе eax = код ошибки файловой системы

  * иначе eax = код ошибки файловой системы

Замечания:

Замечания:

  * Все папки в указанном пути должны существовать, иначе вернётся

  * Все папки в указанном пути должны существовать, иначе вернётся

    значение 5, "файл не найден".

    значение 5, "файл не найден".

  ebx - SSF_RD_TO_HDD (6)

======================================================================

======================================================================

====== Функция 18, подфункция 7 - получить номер активного окна. =====

====== Функция 18, подфункция 7 - получить номер активного окна. =====

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 7 - номер подфункции

  * ebx = 7 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = номер активного окна (номер слота потока, окно которого

  * eax = номер активного окна (номер слота потока, окно которого

    активно)

    активно)

Замечания:

Замечания:

  * Активное окно находится вверху оконного стэка и получает

  * Активное окно находится вверху оконного стэка и получает

    сообщения обо всём вводе с клавиатуры.

    сообщения обо всём вводе с клавиатуры.

  * Сделать окно активным можно вызовом подфункции 3.

  * Сделать окно активным можно вызовом подфункции 3.

  ebx - SSF_GET_ACTIVE_WINDOW (7)

======================================================================

======================================================================

==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====

==== Функция 18, подфункция 8 - отключить/разрешить звук спикера. ====

======================================================================

======================================================================

При отключённом звуке вызовы подфункции 55 функции 55 игнорируются.

При отключённом звуке вызовы подфункции 55 функции 55 игнорируются.

При включённом - направляются на встроенный спикер.

При включённом - направляются на встроенный спикер.

--------------- Подподфункция 1 - получить состояние. ----------------

--------------- Подподфункция 1 - получить состояние. ----------------

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 8 - номер подфункции

  * ebx = 8 - номер подфункции

  * ecx = 1 - номер подподфункции

  * ecx = 1 - номер подподфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0 - звук спикера разрешён; 1 - запрещён

  * eax = 0 - звук спикера разрешён; 1 - запрещён

-------------- Подподфункция 2 - переключить состояние. --------------

-------------- Подподфункция 2 - переключить состояние. --------------

Переключает состояния разрешения/запрещения.

Переключает состояния разрешения/запрещения.

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 8 - номер подфункции

  * ebx = 8 - номер подфункции

  * ecx = 2 - номер подподфункции

  * ecx = 2 - номер подподфункции

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

  ecx - SSSF_GET_STATE (1), SSSF_TOGGLE (2)

======================================================================

======================================================================

= Функция 18, подфункция 9 - завершение работы системы с параметром. =

= Функция 18, подфункция 9 - завершение работы системы с параметром. =

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 9 - номер подфункции

  * ebx = 9 - номер подфункции

  * ecx = параметр:

  * ecx = параметр:

    * 2 = выключить компьютер

    * 2 = выключить компьютер

    * 3 = перезагрузить компьютер

    * 3 = перезагрузить компьютер

    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске

    * 4 = перезапустить ядро из файла kernel.mnt на рамдиске

Возвращаемое значение:

Возвращаемое значение:

  * при неверном ecx регистры не меняются (т.е. eax=18)

  * при неверном ecx регистры не меняются (т.е. eax=18)

  * при правильном вызове всегда возвращается признак успеха eax=0

  * при правильном вызове всегда возвращается признак успеха eax=0

Замечания:

Замечания:

  * Не следует полагаться на возвращаемое значение при неверном

  * Не следует полагаться на возвращаемое значение при неверном

    вызове, оно может измениться в последующих версиях ядра.

    вызове, оно может измениться в последующих версиях ядра.

  ebx - SSF_SHUTDOWN (9)

======================================================================

======================================================================

========= Функция 18, подфункция 10 - свернуть активное окно. ========

========= Функция 18, подфункция 10 - свернуть активное окно. ========

======================================================================

======================================================================

Сворачивает активное окно.

Сворачивает активное окно.

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 10 - номер подфункции

  * ebx = 10 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечания:

Замечания:

  * Минимизированное окно с точки зрения функции 9 сохраняет положение

  * Минимизированное окно с точки зрения функции 9 сохраняет положение

    и размеры.

    и размеры.

  * Восстановление окна приложения происходит при активизировании

  * Восстановление окна приложения происходит при активизировании

    подфункцией 3.

    подфункцией 3.

  * Обычно нет необходимости явно сворачивать/разворачивать своё окно:

  * Обычно нет необходимости явно сворачивать/разворачивать своё окно:

    сворачивание окна осуществляется системой при нажатии на кнопку

    сворачивание окна осуществляется системой при нажатии на кнопку

    минимизации (которая для окон со скином определяется автоматически

    минимизации (которая для окон со скином определяется автоматически

    функцией 0, для окон без скина её можно определить функцией 8),

    функцией 0, для окон без скина её можно определить функцией 8),

    восстановление - приложением @taskbar.

    восстановление - приложением @taskbar.

  ebx - SSF_MINIMIZE_WINDOW (10)

======================================================================

======================================================================

====================== Функция 18, подфункция 11 =====================

====================== Функция 18, подфункция 11 =====================

============= Получить информацию о дисковой подсистеме. =============

============= Получить информацию о дисковой подсистеме. =============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 11 - номер подфункции

  * ebx = 11 - номер подфункции

  * ecx = тип таблицы:

  * ecx = тип таблицы:

    * 1 = короткая версия, 16 байт

    * 1 = короткая версия, 16 байт

  * edx = указатель на буфер (в приложении) для таблицы

  * edx = указатель на буфер (в приложении) для таблицы

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Формат таблицы: короткая версия:

Формат таблицы: короткая версия:

  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,

  * +0: byte: информация о НГМД (дисководах для дискет), AAAABBBB,

    где AAAA задаёт тип первого дисковода, BBBB - второго согласно

    где AAAA задаёт тип первого дисковода, BBBB - второго согласно

    следующему списку:

    следующему списку:

    * 0 = нет дисковода

    * 0 = нет дисковода

    * 1 = 360Kb, 5.25''

    * 1 = 360Kb, 5.25''

    * 2 = 1.2Mb, 5.25''

    * 2 = 1.2Mb, 5.25''

    * 3 = 720Kb, 3.5''

    * 3 = 720Kb, 3.5''

    * 4 = 1.44Mb, 3.5''

    * 4 = 1.44Mb, 3.5''

    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)

    * 5 = 2.88Mb, 3.5'' (такие дискеты сейчас уже не используются)

    Например, для стандартной конфигурации из одного 1.44-дисковода

    Например, для стандартной конфигурации из одного 1.44-дисковода

    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:

    здесь будет 40h, а для случая 1.2Mb на A: и 1.44Mb на B:

    значение оказывается 24h.

    значение оказывается 24h.

  Первый контроллер IDE:

  Первый контроллер IDE:

  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,

  * +1: byte: информация о жёстких дисках и CD-приводах, AABBCCDD,

    где AA соответствует контроллеру IDE0, ..., DD - IDE3:

    где AA соответствует контроллеру IDE0, ..., DD - IDE3:

    * 0 = устройство отсутствует

    * 0 = устройство отсутствует

    * 1 = жёсткий диск

    * 1 = жёсткий диск

    * 2 = CD-привод

    * 2 = CD-привод

    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.

    Например, в случае HD на IDE0 и CD на IDE2 здесь будет 48h.

  * +2: 4 db: число найденных разделов на жёстких дисках с

  * +2: 4 db: число найденных разделов на жёстких дисках с

    соответственно IDE0,...,IDE3.

    соответственно IDE0,...,IDE3.

  Второй контроллер IDE:

  Второй контроллер IDE:

  * +6: byte: информация о жёстких дисках и CD-приводах, AABBCCDD

  * +6: byte: информация о жёстких дисках и CD-приводах, AABBCCDD

    где AA соответствует контроллеру IDE4, ..., DD - IDE7:

    где AA соответствует контроллеру IDE4, ..., DD - IDE7:

    * 0 = устройство отсутствует

    * 0 = устройство отсутствует

    * 1 = жёсткий диск

    * 1 = жёсткий диск

    * 2 = CD-привод

    * 2 = CD-привод

    Например, в случае HD на IDE4 и CD на IDE6 здесь будет 48h.

    Например, в случае HD на IDE4 и CD на IDE6 здесь будет 48h.

  * +7: 4 db: число найденных разделов на жёстких дисках с

  * +7: 4 db: число найденных разделов на жёстких дисках с

    соответственно IDE4,...,IDE7.

    соответственно IDE4,...,IDE7.

  Третий контроллер IDE:

  Третий контроллер IDE:

  * +11: byte: информация о жёстких дисках и CD-приводах, AABBCCDD

  * +11: byte: информация о жёстких дисках и CD-приводах, AABBCCDD

    где AA соответствует контроллеру IDE8, ..., DD - IDE11:

    где AA соответствует контроллеру IDE8, ..., DD - IDE11:

    * 0 = устройство отсутствует

    * 0 = устройство отсутствует

    * 1 = жёсткий диск

    * 1 = жёсткий диск

    * 2 = CD-привод

    * 2 = CD-привод

    Например, в случае HD на IDE8 и CD на IDE10 здесь будет 48h.

    Например, в случае HD на IDE8 и CD на IDE10 здесь будет 48h.

  * +12: 4 db: число найденных разделов на жёстких дисках с

  * +12: 4 db: число найденных разделов на жёстких дисках с

    соответственно IDE8,...,IDE11.

    соответственно IDE8,...,IDE11.

    При отсутствии жёсткого диска на IDEx соответствующий байт

    При отсутствии жёсткого диска на IDEx соответствующий байт

    нулевой, при наличии показывает число распознанных разделов,

    нулевой, при наличии показывает число распознанных разделов,

    которых может и не быть (если носитель не отформатирован или

    которых может и не быть (если носитель не отформатирован или

    если файловая система не поддерживается). В текущей версии ядра

    если файловая система не поддерживается). В текущей версии ядра

    для жёстких дисков поддерживаются только FAT12/16/32, NTFS,

    для жёстких дисков поддерживаются только FAT12/16/32, NTFS,

    ext2/3/4 и XFS.

    ext2/3/4 и XFS.

Замечания:

Замечания:

  * Таблица может быть использована для получения информации

  * Таблица может быть использована для получения информации

    об имеющихся устройствах.

    об имеющихся устройствах.

  ebx - SSF_INFO_DISC_SYS (11)

======================================================================

======================================================================

========== Функция 18, подфункция 13 - получить версию ядра. =========

========== Функция 18, подфункция 13 - получить версию ядра. =========

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 13 - номер подфункции

  * ebx = 13 - номер подфункции

  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена

  * ecx = указатель на буфер (не менее 16 байт), куда будет помещена

    информация

    информация

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Структура буфера:

Структура буфера:

db a,b,c,d для версии a.b.c.d

db a,b,c,d для версии a.b.c.d

db 0: зарезервировано

db 0: зарезервировано

dd REV - номер svn-ревизии ядра

dd REV - номер svn-ревизии ядра

Для ядра Kolibri 0.7.7.0+:

Для ядра Kolibri 0.7.7.0+:

db 0,7,7,0

db 0,7,7,0

db 0

db 0

dd 1675

dd 1675

  ebx - SSF_KERNEL_VERSION (13)

======================================================================

======================================================================

====================== Функция 18, подфункция 14 =====================

====================== Функция 18, подфункция 14 =====================

======= Ожидать начала обратного хода луча развёртки монитора. =======

======= Ожидать начала обратного хода луча развёртки монитора. =======

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 14 - номер подфункции

  * ebx = 14 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0 как признак успеха

  * eax = 0 как признак успеха

Замечания:

Замечания:

  * Функция предназначена исключительно для активных

  * Функция предназначена исключительно для активных

    высокопроизводительных графических приложений; используется для

    высокопроизводительных графических приложений; используется для

    плавного вывода графики.

    плавного вывода графики.

  ebx - SSF_WAIT_RETRACE (14)

======================================================================

======================================================================

== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =

== Функция 18, подфункция 15 - поместить курсор мыши в центр экрана. =

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 15 - номер подфункции

  * ebx = 15 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0 как признак успеха

  * eax = 0 как признак успеха

  ebx - SSF_CURSOR_CENTER (15)

======================================================================

======================================================================

====================== Функция 18, подфункция 16 =====================

====================== Функция 18, подфункция 16 =====================

============ Получить размер свободной оперативной памяти. ===========

============ Получить размер свободной оперативной памяти. ===========

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 16 - номер подфункции

  * ebx = 16 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = размер свободной памяти в килобайтах

  * eax = размер свободной памяти в килобайтах

  ebx - SSF_GET_FREE_RAM (16)

======================================================================

======================================================================

====================== Функция 18, подфункция 17 =====================

====================== Функция 18, подфункция 17 =====================

============ Получить размер имеющейся оперативной памяти. ===========

============ Получить размер имеющейся оперативной памяти. ===========

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 17 - номер подфункции

  * ebx = 17 - номер подфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = общий размер имеющейся памяти в килобайтах

  * eax = общий размер имеющейся памяти в килобайтах

  ebx - SSF_GET_TOTAL_RAM (17)

======================================================================

======================================================================

====================== Функция 18, подфункция 18 =====================

====================== Функция 18, подфункция 18 =====================

============= Завершить процесс/поток по идентификатору. =============

============= Завершить процесс/поток по идентификатору. =============

======================================================================

======================================================================

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 18 - номер подфункции

  * ebx = 18 - номер подфункции

  * ecx = идентификатор процесса/потока (PID/TID)

  * ecx = идентификатор процесса/потока (PID/TID)

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0 - успешно

  * eax = 0 - успешно

  * eax = -1 - ошибка (процесс не найден или является системным)

  * eax = -1 - ошибка (процесс не найден или является системным)

Замечания:

Замечания:

  * Нельзя завершить поток операционной системы OS/IDLE (номер слота

  * Нельзя завершить поток операционной системы OS/IDLE (номер слота

    1), можно завершить любой обычный поток/процесс.

    1), можно завершить любой обычный поток/процесс.

  * Смотри также подфункцию 2 - завершение

  * Смотри также подфункцию 2 - завершение

    процесса/потока по заданному слоту.

    процесса/потока по заданному слоту.

  ebx - SSF_TERMINATE_THREAD_ID (18)

======================================================================

======================================================================

=== Функция 18, подфункция 19 - получить/установить настройки мыши. ==

=== Функция 18, подфункция 19 - получить/установить настройки мыши. ==

======================================================================

======================================================================

------------- Подподфункция 0 - получить скорость мыши. --------------

------------- Подподфункция 0 - получить скорость мыши. --------------

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 19 - номер подфункции

  * ebx = 19 - номер подфункции

  * ecx = 0 - номер подподфункции

  * ecx = 0 - номер подподфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = текущая скорость мыши

  * eax = текущая скорость мыши

------------ Подподфункция 1 - установить скорость мыши. -------------

------------ Подподфункция 1 - установить скорость мыши. -------------

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 19 - номер подфункции

  * ebx = 19 - номер подфункции

  * ecx = 1 - номер подподфункции

  * ecx = 1 - номер подподфункции

  * edx = новое значение скорости

  * edx = новое значение скорости

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

Замечание: рекомендуемая скорость = 1, 0 = заблокировать курсор.

Замечание: рекомендуемая скорость = 1, 0 = заблокировать курсор.

------------- Подподфункция 2 - получить ускорение мыши. -------------

------------- Подподфункция 2 - получить ускорение мыши. -------------

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 19 - номер подфункции

  * ebx = 19 - номер подфункции

  * ecx = 2 - номер подподфункции

  * ecx = 2 - номер подподфункции

Возвращаемое значение:

Возвращаемое значение:

  * eax = 0 - выключить, 1 - слабое, 2 - среднее, 3 - сильное

  * eax = 0 - выключить, 1 - слабое, 2 - среднее, 3 - сильное

------------ Подподфункция 3 - установить ускорение мыши. ------------

------------ Подподфункция 3 - установить ускорение мыши. ------------

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 19 - номер подфункции

  * ebx = 19 - номер подфункции

  * ecx = 3 - номер подподфункции

  * ecx = 3 - номер подподфункции

  * edx = 0 - выключить, 1 - слабое, 2 - среднее, 3 - сильное

  * edx = 0 - выключить, 1 - слабое, 2 - среднее, 3 - сильное

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

-------- Подподфункция 4 - установить положение курсора мыши. --------

-------- Подподфункция 4 - установить положение курсора мыши. --------

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 19 - номер подфункции

  * ebx = 19 - номер подфункции

  * ecx = 4 - номер подподфункции

  * ecx = 4 - номер подподфункции

  * edx = [координата по оси x]*65536 + [координата по оси y]

  * edx = [координата по оси x]*65536 + [координата по оси y]

Возвращаемое значение:

Возвращаемое значение:

  * функция не возвращает значения

  * функция не возвращает значения

------- Подподфункция 5 - симулировать состояние клавиш мыши. --------

------- Подподфункция 5 - симулировать состояние клавиш мыши. --------

Параметры:

Параметры:

  * eax = 18 - номер функции

  * eax = 18 - номер функции

  * ebx = 19 - номер подфункции

  * ebx = 19 - номер подфункции

  * ecx = 5 - номер подподфункции

  * ecx = 5 - номер подподфункции

  * edx = информация о эмулируемом состоянии кнопок мыши:

  * edx = информация о эмулируемом состоянии кнопок мыши:

    (соответствует возвращаемому значению подфункции 2 функции 37)

    (соответствует возвращаемому значению подфункции 2 функции 37)

    * бит 0 установлен = левая кнопка нажата

    * бит 0 установлен = левая кнопка нажата

    * бит 1 установлен = правая кнопка нажата

    * бит 1 установлен = правая кнопка нажата

    * бит 2 установлен = средняя кнопка нажата

    * бит 2 установлен = средняя кнопка нажата

    * бит 3 установлен = 4-я кнопка нажата

    * бит 3 установлен = 4-я кнопка нажата