WebSVN – Kolibri OS – Diff – /kernel/trunk/docs/sysfuncs.txt

     * if A=1 and edi contains (nonzero) pointer to caption string,
       it is drawn in place in header defined in the skin
     * value _skinh is accessible as the result of call
       subfunction 4 of function 48
+---------------------- Constants for registers: ----------------------
   eax - SF_CREATE_WINDOW (0)
 ======================================================================
 ================ Function 1 - put pixel in the window. ===============
 ======================================================================
 Parameters:
     edx = 0x01xxxxxx - invert color of a pixel
           (low 24 bits are ignored)
 Returned value:
   * function does not return value
+---------------------- Constants for registers: ----------------------
   eax - SF_PUT_PIXEL (1)
 ======================================================================
 ============ Function 2 - get the code of the pressed key. ===========
 ======================================================================
 Takes away the code of the pressed key from the buffer.
   * As a consequence, ASCII-codes take into account current
     keyboard layout (rus/en) as opposed to scancodes.
   * This function notifies only about those hotkeys, which were
     defined by this thread by subfunction 4 of function 66.
+---------------------- Constants for registers: ----------------------
   eax - SF_GET_KEY (2)
 ======================================================================
 ==================== Function 3 - get system time. ===================
 ======================================================================
 Parameters:
   * See also subfunction 9 of function 26 - get time from
     the moment of start of the system; it is more convenient, because
     returns simply DWORD-value of the time counter.
   * System time can be set by function 22.
+---------------------- Constants for registers: ----------------------
   eax - SF_GET_SYS_TIME (3)
 ======================================================================
 =================== Function 4 - draw text string. ===================
 ======================================================================
 Parameters:
   * User buffer structure:
 Xsize       dd
 Ysize       dd
 picture     rb  Xsize*Ysize*4  ; 32 bpp
+---------------------- Constants for registers: ----------------------
   eax - SF_DRAW_TEXT (4)
 ======================================================================
 ========================= Function 5 - delay. ========================
 ======================================================================
 Delays execution of the program on the given time.
   * Passing ebx=0 does not transfer control to the next process
     and does not make any operations at all. If it is really required
     to transfer control to the next process (to complete a current
     time slice), use subfunction 1 of function 68.
+---------------------- Constants for registers: ----------------------
   eax - SF_SLEEP (5)
 ======================================================================
 =============== Function 7 - draw image in the window. ===============
 ======================================================================
 Paramters:
 Remarks:
   * Coordinates of the image are coordinates of the upper left corner
     of the image relative to the window.
   * Size of the image in bytes is 3*xsize*ysize.
+---------------------- Constants for registers: ----------------------
   eax - SF_PUT_IMAGE (7)
 ======================================================================
 =============== Function 8 - define/delete the button. ===============
 ======================================================================
 Parameters for button definition:
     by the system as the button of minimization, the system handles
     such pressing independently, not accessing to the application.
     In rest it is usual button.
   * Total number of buttons for all applications is limited to 4095.
+---------------------- Constants for registers: ----------------------
   eax - SF_DEFINE_BUTTON (8)
 ======================================================================
 ============ Function 9 - information on execution thread. ===========
 ======================================================================
 Parameters:
   * At the moment only the part of the buffer by a size
 = 0x4C bytes is used. Nevertheless it is recommended to use
 -Kb buffer for the future compatibility, in the future
     some fields can be added.
+---------------------- Constants for registers: ----------------------
   eax - SF_THREAD_INFO (9)
 ======================================================================
 ==================== Function 10 - wait for event. ===================
 ======================================================================
 If the message queue is empty, waits for appearance of the message
     a mask set by function 40. By default it is
     redraw, key and button events.
   * To check, whether there is a message in queue, use function 11.
     To wait for no more than given time, use function 23.
+---------------------- Constants for registers: ----------------------
   eax - SF_WAIT_EVENT (10)
 ======================================================================
 =============== Function 11 - check for event, no wait. ==============
 ======================================================================
 If the message queue contains event, function reads out
     a mask set by function 40. By default it is
     redraw, key and button events.
   * To wait for event, use function 10.
     To wait for no more than given time, use function 23.
+---------------------- Constants for registers: ----------------------
   eax - SF_CHECK_EVENT (11)
 ======================================================================
 =============== Function 12 - begin/end window redraw. ===============
 ======================================================================
   * function does not return value
 Remarks:
   * Subfunction 1 deletes all buttons defined with
     function 8, they must be defined again.
+---------------------- Constants for registers: ----------------------
+  eax - SF_REDRAW (12)
   ebx - SSF_BEGIN_DRAW (1), SSF_END_DRAW (2)
 ======================================================================
 ============ Function 13 - draw a rectangle in the window. ===========
 ======================================================================
 Parameters:
   * function does not return value
 Remarks:
   * Coordinates are understood as coordinates of the left upper corner
     of a rectangle relative to the window.
+---------------------- Constants for registers: ----------------------
   eax - SF_DRAW_RECT (13)
 ======================================================================
 =================== Function 14 - get screen size. ===================
 ======================================================================
 Parameters:
             vertical size - 1
 Remarks:
   * See also subfunction 5 of function 48 - get sizes of
     working area of the screen.
+---------------------- Constants for registers: ----------------------
   eax - SF_GET_SCREEN_SIZE (14)
 ======================================================================
 == Function 15, subfunction 1 - set a size of the background image. ==
 ======================================================================
 Parameters:
   * For update of the screen (after completion of a series of commands
     working with a background) call subfunction 3.
   * There is a pair function for get size of the background image -
     subfunction 1 of function 39.
+---------------------- Constants for registers: ----------------------
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_SIZE_BG (1)
 ======================================================================
 === Function 15, subfunction 2 - put pixel on the background image. ==
 ======================================================================
 Parameters:
   * For update of the screen (after completion of a series of commands
     working with a background) call subfunction 3.
   * There is a pair function for get pixel on the background image -
     subfunction 2 of function 39.
+---------------------- Constants for registers: ----------------------
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_PIXEL_BG (2)
 ======================================================================
 =========== Function 15, subfunction 3 - redraw background. ==========
 ======================================================================
 Parameters:
   * eax = 15 - function number
   * ebx = 3 - subfunction number
 Returned value:
+  * function does not return value
+---------------------- Constants for registers: ----------------------
-  * function does not return value
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_REDRAW_BG (3)
 ======================================================================
 == Function 15, subfunction 4 - set drawing mode for the background. =
 ======================================================================
   * For update of the screen (after completion of a series of commands
     working with a background) call subfunction 3.
   * There is a pair function for get drawing mode of the background -
     subfunction 4 of function 39.
+---------------------- Constants for registers: ----------------------
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_MODE_BG (4)
 ======================================================================
 ===================== Function 15, subfunction 5 =====================
 ============ Put block of pixels on the background image. ============
 ======================================================================
     from left to right, from up to down.
   * Offset of pixel with coordinates (x,y) is (x+y*xsize)*3.
   * For update of the screen (after completion of a series of commands
     working with a background) call subfunction 3.
+---------------------- Constants for registers: ----------------------
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_IMAGE_BG (5)
 ======================================================================
 ===================== Function 15, subfunction 6 =====================
 ======== Map background data to the address space of process. ========
 ======================================================================
     changes of background sizes while process works with mapped data.
   * Color of each pixel is stored as 3-bytes value BBGGRR.
   * Pixels of the background image are written sequentially
     from left to right, from up to down.
+---------------------- Constants for registers: ----------------------
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_MAP_BG (6)
 ======================================================================
 ===== Function 15, subfunction 7 - close mapped background data. =====
 ======================================================================
 Parameters:
   * eax = 15 - function number
   * ebx = 7 - subfunction number
   * ecx = pointer to mapped data
 Returned value:
+  * eax = 1 - success, 0 - error
+---------------------- Constants for registers: ----------------------
-  * eax = 1 - success, 0 - error
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_UNMAP_BG (7)
 ======================================================================
 ===================== Function 15, subfunction 8 =====================
 ============= Get coordinates of last draw the background ============
     (right,bottom) are coordinates of the right lower one.
   * For receiving more reliable information, call the function
     immediately after the event:
 = kernel finished redrawing of the desktop background
+---------------------- Constants for registers: ----------------------
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_LAST_DRAW (8)
 ======================================================================
 ===================== Function 15, subfunction 9 =====================
 ============= Redraws a rectangular part of the background ===========
 ======================================================================
 Remarks:
   * (left,top) are coordinates of the left upper corner,
     (right,bottom) are coordinates of the right lower one.
   * If parameters are set incorrectly then background is not redrawn.
+---------------------- Constants for registers: ----------------------
+  eax - SF_BACKGROUND_SET (15)
   ebx - SSF_REDRAW_RECT (9)
 ======================================================================
 =============== Function 16 - save ramdisk on a floppy. ==============
 ======================================================================
 Parameters:
   * eax = 16 - function number
   * ebx = 1 or ebx = 2 - on which floppy save
 Returned value:
   * eax = 0 - success
+  * eax = 1 - error
-  * eax = 1 - error
+---------------------- Constants for registers: ----------------------
   eax - SF_RD_TO_FLOPPY (16)
 ======================================================================
 ======= Function 17 - get the identifier of the pressed button. ======
 ======================================================================
     will return answer "buffer is empty".
   * Returned value for al corresponds to the state of mouse buttons
     as in subfunction 2 of function 37 at the beginning
     of button press, excluding lower bit, which is cleared.
+---------------------- Constants for registers: ----------------------
   eax - SF_GET_BUTTON (17)
 ======================================================================
 ===================== Function 18, subfunction 1 =====================
 ============= Make deactive the window of the given thread. ==========
 ======================================================================
   * ebx = 1 - subfunction number
   * ecx = number of the thread slot
 Returned value:
   * function does not return value
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_UNFOCUS_WINDOW (1)
 ======================================================================
 = Function 18, subfunction 2 - terminate process/thread by the slot. =
 ======================================================================
 Parameters:
     number of the slot 1),
     it is possible to terminate any normal process/thread.
   * See also subfunction 18 - terminate
     process/thread by the identifier.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_TERMINATE_THREAD (2)
 ======================================================================
 ===================== Function 18, subfunction 3 =====================
 ============= Make active the window of the given thread. ============
 ======================================================================
 Remarks:
   * If correct, but nonexistent slot is given,
     some window is made active.
   * To find out, which window is active, use subfunction 7.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_FOCUS_WINDOW (3)
 ======================================================================
 ===================== Function 18, subfunction 4 =====================
 =========== Get counter of idle time units per one second. ===========
 ======================================================================
   * eax = 18 - function number
   * ebx = 4 - subfunction number
 Returned value:
   * eax = value of the counter of idle time units per one second
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_GET_IDLE_COUNT (4)
 ======================================================================
 ========== Function 18, subfunction 5 - get CPU clock rate. ==========
 ======================================================================
 Parameters:
   * eax = 18 - function number
   * ebx = 5 - subfunction number
 Returned value:
+  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
+---------------------- Constants for registers: ----------------------
-  * eax = clock rate (modulo 2^32 clock ticks = 4GHz)
+  eax - SF_SYSTEM (18)
   ebx - SSF_GET_CPU_REQUENCY (5)
 ======================================================================
  Function 18, subfunction 6 - save ramdisk to the file on hard drive.
 ======================================================================
   * else eax = error code of the file system
 Remarks:
   * All folders in the given path must exist, otherwise function
     returns value 5, "file not found".
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_RD_TO_HDD (6)
 ======================================================================
 =========== Function 18, subfunction 7 - get active window. ==========
 ======================================================================
 Parameters:
 Remarks:
   * Active window is at the top of the window stack and receives
     messages on all keyboard input.
   * To make a window active, use subfunction 3.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_GET_ACTIVE_WINDOW (7)
 ======================================================================
 == Function 18, subfunction 8 - disable/enable the internal speaker. =
 ======================================================================
 If speaker sound is disabled, all calls to subfunction 55 of
   * ebx = 8 - subfunction number
   * ecx = 2 - number of the subsubfunction
 Returned value:
   * function does not return value
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
+  ebx - SSF_SPEAKER (8)
   ecx - SSSF_GET_STATE (1), SSSF_TOGGLE (2)
 ======================================================================
 == Function 18, subfunction 9 - system shutdown with the parameter. ==
 ======================================================================
 Parameters:
     as the tag of success
 Remarks:
   * Do not rely on returned value by incorrect call, it can be
     changed in future versions of the kernel.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_SHUTDOWN (9)
 ======================================================================
 ======= Function 18, subfunction 10 - minimize topmost window. =======
 ======================================================================
 Minimizes the topmost (active) window.
     at pressing the minimization button (for skinned windows
     it is defined automatically by function 0,
     for other windows it can be defined manually by function 8),
     restore of a window is done by the application '@taskbar'.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_MINIMIZE_WINDOW (10)
 ======================================================================
  Function 18, subfunction 11 - get information on the disk subsystem.
 ======================================================================
 Parameters:
 Remarks:
   * The table can be used for obtaining the information about
+    available devices.
+---------------------- Constants for registers: ----------------------
-    available devices.
+  eax - SF_SYSTEM (18)
   ebx - SSF_INFO_DISC_SYS (11)
 ======================================================================
 ========== Function 18, subfunction 13 - get kernel version. =========
 ======================================================================
 For Kolibri 0.7.7.0+ kernel:
 db 0,7,7,0
 db 0
 dd 1675
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_KERNEL_VERSION (13)
 ======================================================================
 ======= Function 18, subfunction 14 - wait for screen retrace. =======
 ======================================================================
 Waits for the beginning of retrace of the scanning ray of the screen
   * eax = 0 as the tag of success
 Remarks:
   * Function is intended only for active high-efficiency graphics
     applications; is used for smooth output of a graphics.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_WAIT_RETRACE (14)
 ======================================================================
 == Function 18, subfunction 15 - center mouse cursor on the screen. ==
 ======================================================================
 Parameters:
   * eax = 18 - function number
   * ebx = 15 - subfunction number
 Returned value:
+  * eax = 0 as the tag of success
+---------------------- Constants for registers: ----------------------
-  * eax = 0 as the tag of success
+  eax - SF_SYSTEM (18)
   ebx - SSF_CURSOR_CENTER (15)
 ======================================================================
 ========= Function 18, subfunction 16 - get size of free RAM. ========
 ======================================================================
 Parameters:
   * eax = 18 - function number
   * ebx = 16 - subfunction number
+Returned value:
+  * eax = size of free memory in kilobytes
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = size of free memory in kilobytes
+  eax - SF_SYSTEM (18)
   ebx - SSF_GET_FREE_RAM (16)
 ======================================================================
 ======== Function 18, subfunction 17 - get full amount of RAM. =======
 ======================================================================
 Parameters:
   * eax = 18 - function number
+  * ebx = 17 - subfunction number
+Returned value:
+  * eax = total size of existing memory in kilobytes
   * ebx = 17 - subfunction number
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = total size of existing memory in kilobytes
+  eax - SF_SYSTEM (18)
   ebx - SSF_GET_TOTAL_RAM (17)
 ======================================================================
   * It is impossible to terminate system thread OS/IDLE (identifier
 ), it is possible to terminate any normal process/thread.
   * See also subfunction 2 - terminate
     process/thread by given slot.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_TERMINATE_THREAD_ID (18)
 ======================================================================
 ======== Function 18, subfunction 19 - get/set mouse features. =======
 ======================================================================
 Returned value:
   * function does not return value
+Remark: mouse settings can be modified in the application mouse_cfg.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
+  ebx - SSF_MOUSE_SETTINGS (19)
+  ecx - SSSF_GET_SPEED (0), SSSF_SET_SPEED (1), SSSF_GET_SPEEDUP (2),
-Remark: mouse settings can be modified in the application mouse_cfg.
+    SSSF_SET_SPEEDUP (3), SSSF_SET_POS (4), SSSF_SET_BUTTON (5),
     SSSF_GET_DOUBLE_CLICK_DELAY (6), SSSF_SET_DOUBLE_CLICK_DELAY (7)
 ======================================================================
 ======== Function 18, subfunction 20 - get information on RAM. =======
 ======================================================================
     * +28: dword: size of maximum free block in kernel heap
                  (reserved)
     * +32: dword: size of maximum allocated block in kernel heap
                  (reserved)
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_GET_RAM_INFO (20)
 ======================================================================
 ===================== Function 18, subfunction 21 ====================
 ======== Get slot number of process/thread by the identifier. ========
 ======================================================================
   * ecx = identifer of process/thread (PID/TID)
 Returned value:
   * eax = 0 - error (invalid identifier)
   * otherwise eax = slot number
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_GET_THREAD_SLOT (21)
 ======================================================================
 ===================== Function 18, subfunction 22 ====================
 ============== Operations with window of another thread. =============
 ======================================================================
 Remarks:
   * The thread can minimize its window with subfunction 10.
   * One can restore and activate window simultaneously with
     subfunction 3 (which requires slot number).
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
+  ebx - SSF_FOREIGN_WINDOW (22)
+  ecx - SSSF_MINIMIZE (0), SSSF_MINIMIZE_ID (1), SSSF_RESTORE (2),
     SSSF_RESTORE_ID (3)
 ======================================================================
 ======== Function 18, subfunction 23 - minimize all windows. ==========
 ======================================================================
 Parameters:
   * eax = 0 - all windows have been minimized before a function call
   * eax = N - number of windows minimized from function
 Remarks:
   * Window of special thread (name begin to symbol @) is not minimize.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_MINIMIZE_ALL (23)
 ======================================================================
 ======= Function 18, subfunction 24 - set limits of screen. ==========
 ======================================================================
 Parameters:
     partially.
   * The sizes specified in the function should not exceed the sizes
     of the current video mode, otherwise the function will not change
     anything.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
   ebx - SSF_SET_SCREEN_LIMITS (24)
 ======================================================================
 ===================== Function 18, subfunction 25 ====================
 ===== Control position of the window relative to other windows. ======
  ZPOS_DESKTOP     = -2 - on the background
  ZPOS_ALWAYS_BACK = -1 - behind all the windows
  ZPOS_NORMAL      = 0  - normal
  ZPOS_ALWAYS_TOP  = 1  - on top of all windows
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM (18)
+  ebx - SSF_WINDOW_BEHAVIOR (25)
   ecx - SSSF_GET_WB (1), SSSF_SET_WB (2)
 ======================================================================
 ==================== Function 20 - MIDI interface. ===================
 ======================================================================
   * eax = 1 - base port is not defined
 Remarks:
   * Previously the base port must be defined by
     subfunction 1 of function 21.
+---------------------- Constants for registers: ----------------------
+  eax - SF_MIDI (20)
   ebx - SSF_RESET (1), SSF_OUTPUT (2)
 ======================================================================
 ======== Function 21, subfunction 1 - set MPU MIDI base port. ========
 ======================================================================
 Parameters:
 Remarks:
   * Number of a port must satisfy to conditions 0x100<=ecx<=0xFFFF.
   * The installation of base is necessary for function 20.
   * To get base port use subfunction 1 of function 26.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_SET (21)
   ebx - SSF_MPU_MIDI_BASE (1)
 ======================================================================
 ========== Function 21, subfunction 2 - set keyboard layout. =========
 ======================================================================
 Keyboard layout is used to convert keyboard scancodes to ASCII-codes,
   * Country identifier is global system variable, which is not used
     by the kernel itself; however the application '@taskbar' displays
     the corresponding icon.
   * The application @taskbar switches layouts on user request.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_SET (21)
   ebx - SSF_KEYBOARD_LAYOUT (2)
 ======================================================================
 ========== Function 21, subfunction 5 - set system language. =========
 ======================================================================
 Parameters:
     appropriate icon.
   * Function does not check for correctness, as the kernel does not
     use this variable.
   * To get system language use subfunction 5 of function 26.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_SET (21)
   ebx - SSF_SYS_LANG (5)
 ======================================================================
  Function 21, subfunction 11 - enable/disable low-level access to HD.
 ======================================================================
 Parameters:
 Remarks:
   * Is used in LBA-read (subfunction 8 of function 58).
   * The current implementation uses only low bit of ecx.
   * To get current status use subfunction 11 of function 26.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_SET (21)
   ebx - SSF_ACCESS_HD_LBA (11)
 ======================================================================
  Function 21, subfunction 12 - enable/disable low-level access to PCI.
 ======================================================================
 Parameters:
 Remarks:
   * Is used in operations with PCI bus (function 62).
   * The current implementation uses only low bit of ecx.
   * To get current status use subfunction 12 of function 26.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_SET (21)
   ebx - SSF_ACCESS_PCI (12)
 ======================================================================
 ================= Function 22 - set system date/time. ================
 ======================================================================
 Parameters:
     (will return 1).
   * Alarm clock is a global system resource; the set of
     an alarm clock cancels automatically the previous set.
     However, at moment no program uses it.
+---------------------- Constants for registers: ----------------------
   eax - SF_SET_TIME_DATE (22)
 ======================================================================
 ============= Function 23 - wait for event with timeout. =============
 ======================================================================
 If the message queue is empty, waits for new message in the queue,
   * Transmission ebx=0 results in immediate returning eax=0.
   * Current implementation returns immediately with eax=0,
     if the addition of ebx with the current value of time counter
     makes 32-bit overflow.
+---------------------- Constants for registers: ----------------------
   eax - SF_WAIT_EVENT_TIMEOUT (23)
 ======================================================================
 ======= Function 24, subfunction 4 - eject tray of disk drive. =======
 ======================================================================
 Parameters:
     manual control of tray is unlocked.
   * When the tray is being ejected, the code clears the cache for
     corresponding device.
   * An example of usage of the function is the application CD_tray.
+---------------------- Constants for registers: ----------------------
+  eax - SF_CD (24)
   ebx - SSF_EJECT_TRAY (4), SSF_INSERT_TRAY (5)
 ======================================================================
 ======== Function 24, subfunction 5 - load tray of disk drive. =======
 ======================================================================
 Parameters:
   * function does not return value
 Remarks:
   * The function is supported only for ATAPI devices (CD and DVD).
   * An example of usage of the function is the application CD_tray.
+---------------------- Constants for registers: ----------------------
+  eax - SF_CD (24)
   ebx - SSF_EJECT_TRAY (4), SSF_INSERT_TRAY (5)
 ======================================================================
 ======= Function 25 - put image area on the background layer. ========
 ======================================================================
 Paramters:
   * TT - byte pointer of transparency, at current version:
 to FF - opaque, 0 - transparent.
   * The function places the image directly to LFB. It is not for
     background image f.15. Options f.15 to f.25 does not make sense.
+---------------------- Constants for registers: ----------------------
   eax - SF_SCREEN_PUT_IMAGE (25)
 ======================================================================
 ======== Function 26, subfunction 1 - get MPU MIDI base port. ========
 ======================================================================
 Parameters:
 Returned value:
   * eax = port number
 Parameters:
   * To set base port use subfunction 1 of function 21.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_GET (26)
   ebx - SSF_MPU_MIDI_BASE (1)
 ======================================================================
 ========== Function 26, subfunction 2 - get keyboard layout. =========
 ======================================================================
 The keyboard layout is used to convert keyboard scancodes to
   * Country identifier is global system variable, which is not used
     by the kernel itself; however the application '@taskbar' displays
     the corresponding icon (using this function).
   * The application @taskbar switches layouts on user request.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_GET (26)
   ebx - SSF_KEYBOARD_LAYOUT (2)
 ======================================================================
 ========== Function 26, subfunction 5 - get system language. =========
 ======================================================================
 Parameters:
   * System language is global system variable and is not used
     by the kernel itself, however application @taskbar draws the
     appropriate icon (using this function).
   * To set system language use subfunction 5 of function 21.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_GET (26)
   ebx - SSF_SYS_LANG (5)
 ======================================================================
 === Function 26, subfunction 9 - get the value of the time counter. ==
 ======================================================================
 Parameters:
 Remarks:
   * Counter takes modulo 2^32, that correspond to a little more
     than 497 days.
   * To get system time use function 3.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_GET (26)
   ebx - SSF_TIME_COUNT (9)
 ======================================================================
 ===================== Function 26, subfunction 10 ====================
 ========== Get the value of the high precision time counter. =========
 ======================================================================
   * edx = number of nanoseconds since system boot time (high DWORD)
 Remarks:
   * The counter is based on HPET, if HPET is not available, resolution
     will be reduced to 10 000 000 nanoseconds.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_GET (26)
   ebx - SSF_TIME_COUNT_PRO (10)
 ======================================================================
 ===================== Function 26, subfunction 11 ====================
 ========== Find out whether low-level HD access is enabled. ==========
 ======================================================================
   * eax = 0/1 - disabled/enabled
 Remarks:
   * Is used in LBA read (subfunction 8 of function 58).
   * To set current state use subfunction 11 of function 21.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_GET (26)
   ebx - SSF_ACCESS_HD_LBA (11)
 ======================================================================
 ===================== Function 26, subfunction 12 ====================
 ========== Find out whether low-level PCI access is enabled. =========
 ======================================================================
 Remarks:
   * Is used by operations with PCI bus (function 62).
   * The current implementation uses only low bit of ecx.
   * To set the current state use subfunction 12 of function 21.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYSTEM_GET (26)
   ebx - SSF_ACCESS_PCI (12)
 ======================================================================
 =================== Function 29 - get system date. ===================
 ======================================================================
 Parameters:
   * MM = month (01..12)
   * DD = day (01..31)
 Remarks:
   * To set system date use function 22.
+---------------------- Constants for registers: ----------------------
   eax - SF_GET_SYS_DATE (29)
 ======================================================================
 ============= Function 30 - work with the current folder. ============
 ======================================================================
 Returned value:
   * function does not return value
 Remarks:
   * The function can be called only 1 time for 1 session of the OS.
+---------------------- Constants for registers: ----------------------
+  eax - SF_CURRENT_FOLDER (30)
   ebx - SSF_SET_CF (1), SSF_GET_CF (2), SSF_ADD_SYS_FOLDER (3)
 ======================================================================
 ========= Function 34 - who owner the pixel on the screen. ===========
 ======================================================================
 Parameters:
 Returned value:
   * eax = 0x000000XX - owner of pixel the slot window N
     If incorrect values ebx and ecx then function returns 0
   * The function takes the value from the area [_WinMapAddress]
+---------------------- Constants for registers: ----------------------
   eax - SF_GET_PIXEL_OWNER (34)
 ======================================================================
 ======= Function 35 - read the color of a pixel on the screen. =======
 ======================================================================
 Parameters:
     that it subtracts 1 from both sizes.
   * There is also direct access (without any system calls)
     to videomemory through the selector gs. To get parameters of
     the current videomode, use function 61.
+---------------------- Constants for registers: ----------------------
   eax - SF_GET_PIXEL (35)
 ======================================================================
 =================== Function 36 - read screen area. ==================
 ======================================================================
 Paramters:
 Remarks:
   * Coordinates of the image are coordinates of the upper left corner
     of the image relative to the screen.
   * Size of the image in bytes is 3*xsize*ysize.
+---------------------- Constants for registers: ----------------------
   eax - SF_GET_IMAGE (36)
 ======================================================================
 =================== Function 37 - work with mouse. ===================
 ======================================================================
 Remarks:
   * Scroll data is available for active window only.
   * Values are zeroed after reading.
   * Values are signed.
+---------------------- Constants for registers: ----------------------
+  eax - SF_MOUSE_GET (37)
+  ebx - SSF_SCREEN_POSITION (0), SSF_WINDOW_POSITION (1),
+    SSF_BUTTON (2), SSF_BUTTON_EXT (3), SSF_LOAD_CURSOR (4),
     SSF_SET_CURSOR (5), SSF_DEL_CURSOR (6), SSF_SCROLL_DATA (7)
 ======================================================================
 ====================== Function 38 - draw line. ======================
 ======================================================================
 Parameters:
   * function does not return value
 Remarks:
   * Coordinates are relative to the window.
   * End point is also drawn.
+---------------------- Constants for registers: ----------------------
   eax - SF_DRAW_LINE (38)
 ======================================================================
 == Function 39, subfunction 1 - get a size of the background image. ==
 ======================================================================
 Parameters:
 Remarks:
   * There is a pair function to set sizes of background image -
     subfunction 1 of function 15. After which it is necessary,
     of course, anew to define image.
+---------------------- Constants for registers: ----------------------
   eax - SF_BACKGROUND_GET (39)
 ======================================================================
 == Function 39, subfunction 2 - get pixel from the background image. =
 ======================================================================
 Parameters:
   * Offset for pixel with coordinates (x,y)
     is calculated as (x+y*xsize)*3.
   * There is a pair function to set pixel on the background image -
     subfunction 2 of function 15.
+---------------------- Constants for registers: ----------------------
   eax - SF_BACKGROUND_GET (39)
 ======================================================================
 == Function 39, subfunction 4 - get drawing mode for the background. =
 ======================================================================
 Parameters:
   * eax = 2 - stretch
 Remarks:
   * There is a pair function to set drawing mode -
     subfunction 4 of function 15.
+---------------------- Constants for registers: ----------------------
   eax - SF_BACKGROUND_GET (39)
 ======================================================================
 =========== Function 40 - set the mask for expected events. ==========
 ======================================================================
 The mask for expected events affects function working with events
   * Events prohibited in the mask are saved anyway, when come;
     they are simply not informed with event functions.
   * Event functions take into account the mask on moment of
     function call, not on moment of event arrival.
+---------------------- Constants for registers: ----------------------
   eax - SF_SET_EVENTS_MASK (40)
 ======================================================================
 ================ Function 43 - input/output to a port. ===============
 ======================================================================
     for itself by function 46.
   * Instead of call to this function it is better to use
     processor instructions in/out - this is much
     faster and a bit shorter and easier.
+---------------------- Constants for registers: ----------------------
   eax - SF_PORT_IN_OUT (43)
 ======================================================================
 ====== Function 46 - reserve/free a group of input/output ports. =====
 ======================================================================
 To work with reserved ports an application can access directly by
   * At booting the system reserves for itself ports
 ..0x2d, 0x30..0x4d, 0x50..0xdf, 0xe5..0xff (inclusively).
   * When a thread terminates, all reserved by it ports
     are freed automatically.
+---------------------- Constants for registers: ----------------------
   eax - SF_SET_PORTS (46)
 ======================================================================
 ============= Function 47 - draw a number in the window. =============
 ======================================================================
 Parameters:
     by leading zeroes; if the number is big and can not be written by
     given amount of digits, extra digits are not drawn.
   * Parameters of fonts are shown in the description of function 4
     (text output).
+---------------------- Constants for registers: ----------------------
   eax - SF_DRAW_NUMBER (47)
 ======================================================================
 ========= Function 48, subfunction 0 - apply screen settings. ========
 ======================================================================
 Parameters:
     subfunctions 1 and 2.
   * Function call without prior call to one of indicated subfunctions
     is ignored.
   * Function call with nonzero ecx is ignored.
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_APPLY (0)
 ======================================================================
 =========== Function 48, subfunction 1 - set button style. ===========
 ======================================================================
 Parameters:
 Remarks:
   * After call to this function one should redraw the screen by
     subfunction 0.
   * Button style influences only to their draw of function 8.
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_SET_BUTTON_STYLE (1)
 ======================================================================
 ====== Function 48, subfunction 2 - set standard window colors. ======
 ======================================================================
 Parameters:
   * Table of standard colors is included in skin and is installed
     anew with skin installation (by subfunction 8).
   * Color table can be viewed/changed interactively with
     the application 'desktop'.
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_SET_COLORS (2)
 ======================================================================
 ====== Function 48, subfunction 3 - get standard window colors. ======
 ======================================================================
 Parameters:
     at skin set by subfunction 8) the system sends to all windows
     redraw message (the event with code 1).
   * Color table can be viewed/changed interactively with
     the application 'desktop'.
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_GET_COLORS (3)
 ======================================================================
 ============ Function 48, subfunction 4 - get skin height. ===========
 ======================================================================
 Parameters:
   * Skin height is defined as the height of a header
     of skinned windows.
   * See also general structure of window in the description
     of function 0.
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_GET_SKIN_HEIGHT (4)
 ======================================================================
 ======== Function 48, subfunction 5 - get screen working area. =======
 ======================================================================
 Parameters:
     formula right-left+1, on y axis - by formula bottom-right+1.
   * See also function 14,
     to get sizes of all screen.
   * There is a pair function to set working area - subfunction 6.
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_GET_SCREEN_AREA (5)
 ======================================================================
 ======== Function 48, subfunction 6 - set screen working area. =======
 ======================================================================
 Parameters:
   * There is a pair function to get working area - subfunction 5.
   * This function redraws the screen automatically,
     updating coordinates and sizes of maximized windows.
     The system sends to all windows redraw message (the event 1).
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_SET_SCREEN_AREA (6)
 ======================================================================
 =========== Function 48, subfunction 7 - get skin margins. ===========
 ======================================================================
 Returns the area of a header of a skinned window, intended for
   * It is recommended to take into account returned value
     of this function for choice of a place for drawing header text
     (by function 4) or a substitute of header text
     (at the discretion of an application).
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_GET_SKIN_MARGINS (7)
 ======================================================================
 ============= Function 48, subfunction 8 - set used skin. ============
 ======================================================================
 Parameters:
   * At booting the system reads skin from file 'default.skn'
     on ramdisk.
   * User can change the skin statically by creating hisself
     'default.skn' or dynamically with the application 'desktop'.
+---------------------- Constants for registers: ----------------------
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_SET_SKIN (8)
 ======================================================================
 ====== Function 48, subfunction 9 - get font smoothing setting. ======
 ======================================================================
 Parameters:
   * eax = 48 - function number
   * ebx = 9 - subfunction number
 Returned value:
+  * eax = 2 - subpixel, 1 - anti-aliasing, 0 - off
+---------------------- Constants for registers: ----------------------
-  * eax = 2 - subpixel, 1 - anti-aliasing, 0 - off
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_GET_FONT_SMOOTH (9)
 ======================================================================
 ========== Function 48, subfunction 10 - set font smoothing. =========
 ======================================================================
 Parameters:
   * eax = 48 - function number
+  * ebx = 10 - subfunction number
+  * cl  = 2 - subpixel, 1 - anti-aliasing, 0 - off
-  * ebx = 10 - subfunction number
+---------------------- Constants for registers: ----------------------
-  * cl  = 2 - subpixel, 1 - anti-aliasing, 0 - off
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_SET_FONT_SMOOTH (10)
 ======================================================================
 ============ Function 48, subfunction 11 - get font size. ============
 ======================================================================
 Parameters:
   * eax = 48 - function number
+  * ebx = 9 - subfunction number
+Returned value:
+  * eax = current font height in pixels
   * ebx = 9 - subfunction number
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = current font height in pixels
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_GET_FONT_SIZE (11)
 ======================================================================
 ============ Function 48, subfunction 12 - set font size. ============
 ======================================================================
+Parameters:
+  * eax = 48 - function number
+  * ebx = 10 - subfunction number
-Parameters:
+  * cl  = new font height in pixels
   * eax = 48 - function number
-  * ebx = 10 - subfunction number
+---------------------- Constants for registers: ----------------------
-  * cl  = new font height in pixels
+  eax - SF_STYLE_SETTINGS (48)
   ebx - SSF_SET_FONT_SIZE (12)
     http://www.microsoft.com/whdc/archive/amp_12.mspx;
     besides it is included in famous Interrupt List by Ralf Brown
     (http://www.pobox.com/~ralf/files.html,
     ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/).
+---------------------- Constants for registers: ----------------------
   eax - SF_APM (49)
 ======================================================================
 =================== Function 50 - set window shape. ==================
 ======================================================================
 Normal windows have rectangular shape. This function can give to
   * The system views the shape data at every window redraw by
     function 0.
   * The call of subfunction 0 with NULL pointer results in return
     to the rectangular shape.
+---------------------- Constants for registers: ----------------------
   eax - SF_SET_WINDOW_SHAPE (50)
 ======================================================================
 ==================== Function 51 - create thread. ====================
 ======================================================================
 Parameters:
   * ecx = address of thread entry point (starting eip)
   * edx = pointer to thread stack (starting esp)
 Returned value:
   * eax = -1 - error (there is too many threads)
   * otherwise eax = TID - thread identifier
+---------------------- Constants for registers: ----------------------
   eax - SF_CREATE_THREAD (51)
 ======================================================================
 ==================== Function 54, subfunction 0 ======================
 ============== Get the number of slots in the clipboard. =============
 ======================================================================
   * ebx = 0 - subfunction number
 Returned value:
   * eax = slots in the clipboard
   * eax = -1 - main list area not found
+---------------------- Constants for registers: ----------------------
+  eax - SF_CLIPBOARD (54)
   ebx - SSF_GET_SLOT_COUNT (0)
 ======================================================================
 ==================== Function 54, subfunction 1 ======================
 ================= Read the data from the clipboard. ==================
 ======================================================================
 Returned value:
   * eax = if successful - pointer to a memory with data
   * eax = 1 - error
   * eax = -1 - main list area not found
+---------------------- Constants for registers: ----------------------
+  eax - SF_CLIPBOARD (54)
   ebx - SSF_READ_CB (1)
 ======================================================================
 ==================== Function 54, subfunction 2 ======================
 ================= Write the data to the clipboard. ===================
 ======================================================================
 Returned value:
   * eax = 0 - success
   * eax = 1 - error
   * eax = -1 - main list area not found
+---------------------- Constants for registers: ----------------------
+  eax - SF_CLIPBOARD (54)
   ebx - SSF_WRITE_CB (2)
 ======================================================================
 ===================== Function 54, subfunction 3 =====================
 ================ Delete the last slot in the clipboard ===============
 ======================================================================
 Returned value:
   * eax = 0 - success
   * eax = 1 - error
   * eax = -1 - main list area not found
+---------------------- Constants for registers: ----------------------
+  eax - SF_CLIPBOARD (54)
   ebx - SSF_DEL_SLOT (3)
 ======================================================================
 ===================== Function 54, subfunction 4 =====================
 ===================== Alarm reset the lock buffer ====================
 ======================================================================
   * eax = -1 - main list area not found or no blocking
 Remarks:
   * Used in exceptional cases, where no responsible or killed
     application blocked the clipboard operations.
+---------------------- Constants for registers: ----------------------
+  eax - SF_CLIPBOARD (54)
   ebx - SSF_UNLOCK_BUFFER (4)
 ======================================================================
  Function 55, subfunction 55 - begin to play data on built-in speaker.
 ======================================================================
 Parameters:
     an information on request. Play itself goes independently from
     the program.
   * The data must be kept in the memory at least up to the end
     of play.
+---------------------- Constants for registers: ----------------------
   eax - SF_SPEAKER_PLAY (55)
 ======================================================================
 ======================= Function 57 - PCI BIOS. ======================
 ======================================================================
 Parameters:
   * The function calls PCI32 BIOS extension, documented e.g. in
     http://alpha1.dyns.net/files/PCI/bios21.pdf.
   * If BIOS does not support this extension, its behavior is emulated
     (through kernel-mode analogues of subfunctions of function 62).
+---------------------- Constants for registers: ----------------------
   eax - SF_PCI_BIOS (57)
 ======================================================================
 ========== Function 60 - Inter Process Communication (IPC). ==========
 ======================================================================
 IPC is used for message dispatching from one process/thread to
   * eax = 4 - process/thread with such PID does not exist
 Remarks:
   * Immediately after writing of IPC-message to the buffer the system
     sends to the receiver the event with code 7 (see event codes).
+---------------------- Constants for registers: ----------------------
+  eax - SF_IPC (60)
   ebx - SSF_SET_AREA (1), SSF_SEND_MESSAGE (2)
 ======================================================================
 ==== Function 61 - get parameters for the direct graphics access. ====
 ======================================================================
 The data of the graphics screen (the memory area which displays
   * ebx = 3 - subfunction number
 Returned value:
   * eax = number of bytes occupied by one scanline
     (horizontal line on the screen)
+---------------------- Constants for registers: ----------------------
+  eax - SF_GET_GRAPHICAL_PARAMS (61)
+  ebx - SSF_SCREEN_SIZE (1), SSF_BITS_PER_PIXEL (2),
     SSF_BYTES_PER_LINE (3)
 ======================================================================
 ===== Function 62, subfunction 0 - get version of PCI-interface. =====
 ======================================================================
 Parameters:
 Remarks:
   * Previously low-level access to PCI for applications must be
     enabled by subfunction 12 of function 21.
   * If PCI BIOS is not supported, the value of ax is undefined.
+---------------------- Constants for registers: ----------------------
+  eax - SF_PCI (62)
   ebx - SSF_GET_VERSION (0)
 ======================================================================
 ==== Function 62, subfunction 1 - get number of the last PCI-bus. ====
 ======================================================================
 Parameters:
 Remarks:
   * Previously low-level access to PCI for applications must be
     enabled by subfunction 12 of function 21.
   * If PCI BIOS is not supported, the value of ax is undefined.
+---------------------- Constants for registers: ----------------------
+  eax - SF_PCI (62)
   ebx - SSF_GET_LAST_BUS (1)
 ======================================================================
 ===================== Function 62, subfunction 2 =====================
 ===== Get mechanism of addressing to the PCI configuration space. ====
 ======================================================================
   * Addressing mechanism is selected depending on
     equipment characteristics.
   * Subfunctions of read and write work automatically
     with the selected mechanism.
+---------------------- Constants for registers: ----------------------
+  eax - SF_PCI (62)
   ebx - SSF_GET_ADRR_MODE (2)
 ======================================================================
 ======== Function 62, subfunctions 4,5,6 - read PCI-register. ========
 ======================================================================
 Parameters:
     (http://www.pobox.com/~ralf/files.html,
     ftp://ftp.cs.cmu.edu/afs/cs/user/ralf/pub/);
     registers of the second type must be listed
     in the device documentation.
+---------------------- Constants for registers: ----------------------
+  eax - SF_PCI (62)
   ebx - SSF_READ_BYTE (4), SSF_READ_WORD (5), SSF_READ_DWORD (6)
 ======================================================================
 ====== Function 62, subfunctions 8,9,10 - write to PCI-register. =====
 ======================================================================
 Parameters:
     defined by the concrete device. The list of registers of the
     first type can be found e.g. in famous Interrupt List by
     Ralf Brown; registers of the second type must be listed
     in the device documentation.
+---------------------- Constants for registers: ----------------------
+  eax - SF_PCI (62)
   ebx - SSF_WRITE_BYTE (8), SSF_WRITE_WORD (9), SSF_WRITE_DWORD (10)
 ======================================================================
 ============== Function 63 - work with the debug board. ==============
 ======================================================================
 The debug board is the global system buffer (with the size
   * ebx = 2 - subfunction number
 Returned value:
   * eax = ebx = 0 - the buffer is empty
   * eax = byte, ebx = 1 - byte was successfully read
+---------------------- Constants for registers: ----------------------
+  eax - SF_BOARD (63)
   ebx - SSF_DEBUG_WRITE (1), SSF_DEBUG_READ (2)
 ======================================================================
 ============== Function 64 - resize application memory. ==============
 ======================================================================
 Parameters:
     subfunctions 11, 12, 13 of function 68.
   * The function cannot be used together with 68.11, 68.12, 68.13.
     The function call will be ignored after creation of process heap
     with function 68.11.
+---------------------- Constants for registers: ----------------------
   eax - SF_MEMORY_RESIZE (64)
 ======================================================================
 ======== Function 65 - draw image with palette in the window. ========
 ======================================================================
 Parameters:
   * Format of image with 32 bits per pixel: similar to 24, but
     one additional ignored byte is present.
   * The call to function 7 is equivalent to call to this function
     with esi=24, ebp=0.
+---------------------- Constants for registers: ----------------------
   eax - SF_PUT_IMAGE_EXT (65)
 ======================================================================
 ================== Function 66 - work with keyboard. =================
 ======================================================================
 The input mode influences results of reading keys by function 2.
   * function does not return value
 Remarks:
   * Unlocking the results of the f. 66.6
   * To emulate a mouse via the keyboard, the application MOUSEMUL
+---------------------- Constants for registers: ----------------------
+  eax - SF_KEYBOARD (66)
+  ebx - SSF_SET_INPUT_MODE (1), SSF_GET_INPUT_MODE (2),
+    SSF_GET_CONTROL_KEYS (3), SSF_SET_SYS_HOTKEY (4),
     SSF_DEL_SYS_HOTKEY (5),  SSF_LOCK_INPUT (6), SSF_UNLOCK_INPUT (7)
 ======================================================================
 ========= Function 67 - change position/sizes of the window. =========
 ======================================================================
 Parameters:
   * For windows of appropriate styles position and/or sizes can be
     changed by user; current position and sizes can be obtained by
     call to function 9.
   * The function sends to the window redraw event (with the code 1).
+---------------------- Constants for registers: ----------------------
   eax - SF_CHANGE_WINDOW (67)
 ======================================================================
 ====== Function 68, subfunction 0 - get the task switch counter. =====
 ======================================================================
 Parameters:
   * eax = 68 - function number
   * ebx = 0 - subfunction number
 Returned value:
   * eax = number of task switches from the system booting
+    (modulo 2^32)
+---------------------- Constants for registers: ----------------------
-    (modulo 2^32)
+  eax - SF_SYS_MISC (68)
   ebx - SSF_GET_TASK_SWITCH_COUNT (0)
 ======================================================================
 ======= Function 68, subfunction 1 - switch to the next thread. ======
 ======================================================================
   * eax = 68 - function number
   * ebx = 1 - subfunction number
 Returned value:
   * function does not return value
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_SWITCH_TASK (1)
 ======================================================================
 ============= Function 68, subfunction 2 - cache + rdpmc. ============
 ======================================================================
 Parameters:
     * eax = 0 - cache is on
     * eax <> 0 - cache is off
   * for ecx=2 and ecx=3:
     * function does not return value
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
+  ebx - SSF_PERFORMANCE (2)
+  ecx - SSSF_ALLOW_RDPMC (0), SSSF_CACHE_STATUS (1),
     SSSF_CACHE_ON (2), SSSF_CACHE_OFF (3)
 ======================================================================
 =========== Function 68, subfunction 3 - read MSR-register. ==========
 ======================================================================
 MSR = Model Specific Register; the complete list of MSR-registers
   * Previously it is necessary to check, whether MSRs are supported
     as a whole, with the instruction 'cpuid'. Otherwise processor
     will generate other exception in the kernel, which will anyway
     kill the thread.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_READ_MSR (3)
 ======================================================================
 ========= Function 68, subfunction 4 - write to MSR-register. ========
 ======================================================================
 MSR = Model Specific Register; the complete list of MSR-registers
   * Previously it is necessary to check, whether MSRs are supported
     as a whole, with the instruction 'cpuid'. Otherwise processor
     will generate other exception in the kernel, which will anyway
     kill the thread.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_WRITE_MSR (4)
 ======================================================================
 ======= Function 68, subfunction 11 - initialize process heap. =======
 ======================================================================
 Parameters:
     Heap size is equal to total amount of free application memory.
   * The second function call from the same process results in
     returning the size of the existing heap.
   * After creation of the heap calls to function 64 will be ignored.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_HEAP_INIT (11)
 ======================================================================
 ======== Function 68, subfunction 12 - allocate memory block. ========
 ======================================================================
 Parameters:
     subfunction 11.
   * The function allocates an integer number of pages (4 Kb) in such
     way that the real size of allocated block is more than or equal to
     requested size.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_MEM_ALLOC (12)
 ======================================================================
 ========== Function 68, subfunction 13 - free memory block. ==========
 ======================================================================
 Parameters:
   * eax = 0 - failed
 Remarks:
   * The memory block must have been allocated by subfunction 12
     or subfunction 20.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_MEM_FREE (13)
 ======================================================================
 ===================== Function 68, subfunction 14 ====================
 ============ Wait for signal from another program/driver. ============
 ======================================================================
   * buffer pointed to by ecx contains the following information:
     * +0: dword: identifier for following data of signal
     * +4: dword: data of signal (20 bytes), format of which is defined
           by the first dword
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_WAIT_SIGNAL (14)
 ======================================================================
 ============= Function 68, subfunction 16 - load driver. =============
 ======================================================================
 Parameters:
   * Driver name is case-sensitive.
     Maximum length of the name is 16 characters, including
     terminating null character, the rest is ignored.
   * Driver ABC is loaded from file /rd/1/drivers/ABC.obj.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_LOAD_DRIVER (16)
 ======================================================================
 ============ Function 68, subfunction 17 - driver control. ===========
 ======================================================================
 Parameters:
 Remarks:
   * Function codes and the structure of input/output data
     are defined by driver.
   * Previously one must obtain driver handle by subfunction 16.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_CONTROL_DRIVER (17)
 ======================================================================
 =============== Function 68, subfunction 19 - load DLL. ==============
 ======================================================================
 Parameters:
 Remarks:
   * Export table is an array of structures of 2 dword's, terminated
     by zero. The first dword in structure points to function name,
     the second dword contains address of function.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_LOAD_DLL (19)
 ======================================================================
 ======= Function 68, subfunction 20 - reallocate memory block. =======
 ======================================================================
 Parameters:
     must be allocated earlier with subfunction 12 or this subfunction.
   * If ecx=0, the function frees memory block at edx and returns 0.
   * The contents of the block are unchanged up to the shorter of
     the new and old sizes.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_MEM_REALLOC (20)
 ======================================================================
 =========== Function 68, subfunction 21 - load driver PE. ============
 ======================================================================
 Parameters:
   * otherwise eax = driver handle
 Remarks:
   * If the driver was not loaded yet, it is loaded;
     if the driver was loaded yet, nothing happens.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_LOAD_DRIVER_PE (21)
 ======================================================================
 ======== Function 68, subfunction 22 - open named memory area. =======
 ======================================================================
 Parameters:
   * If a new area is created, access flags set maximal rights
     for other processes. An attempt from other process to open
     with denied rights will fail with error code E_ACCESS.
   * The process which has created an area always has write access.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_MEM_OPEN (22)
 ======================================================================
 ======= Function 68, subfunction 23 - close named memory area. =======
 ======================================================================
 Parameters:
   * A memory area is physically freed (with deleting all data and
     freeing physical memory), when all threads which have opened
     this area will close it.
   * When thread is terminating, all opened by it areas are closed.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_MEM_CLOSE (23)
 ======================================================================
 ======== Function 68, subfunction 24 - set exception handler. ========
 ======================================================================
 Parameters:
   * After user handler completes critical operations, it can set
     the corresponding bit in the exception mask with subfunction 25.
     Also user handler is responsible for clearing exceptions flags in
     FPU and/or SSE.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_SET_EXCEPTION_HANDLER (24)
 ======================================================================
 ======== Function 68, subfunction 25 - set exception activity ========
 ======================================================================
 Parameters:
 Remarks:
   * In current implementation only mask for user excepton handler,
     which has been previously set by subfunction 24,
     is changed. Signal number corresponds to exception number.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_SET_EXCEPTION_STATE (25)
 ======================================================================
 ====== Function 68, subfunction 26 - release memory pages ============
 ======================================================================
 Parameters:
   * esi = the size of the region of memory to release, in bytes
 Remarks:
   * function release range of pages from ecx+edx to ecx+edx+esi
     and set virtual memory into reserved state.
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_MEM_FREE_EXT (26)
 ======================================================================
 ========== Function 68, subfunction 27 - load file ===================
 ======================================================================
 Parameters:
   * eax = pointer to the loaded file, or zero
   * edx = size of the loaded file, or zero
 Remarks:
   * function loads file and unpacks, if necessary
+---------------------- Constants for registers: ----------------------
+  eax - SF_SYS_MISC (68)
   ebx - SSF_LOAD_FILE (27)
 ======================================================================
 ====================== Function 69 - debugging. ======================
 ======================================================================
 A process can load other process as debugged by set of corresponding
   * subfunction 6 - read from the memory of debugged process
   * subfunction 7 - write to the memory of debugged process
   * subfunction 8 - terminate debugged thread
   * subfunction 9 - set/clear hardware breakpoint
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
+  ebx - SSF_SET_MESSAGE_AREA (0), SSF_GET_REGISTERS (1),
+    SSF_SET_REGISTERS (2), SSF_DETACH (3), SSF_SUSPEND (4),
+    SSF_RESUME (5), SSF_READ_MEMORY (6), SSF_WRITE_MEMORY (7),
     SSF_TERMINATE (8), SSF_DEFINE_BREAKPOINT (9)
 ======================================================================
 = Function 69, subfunction 0 - define data area fror debug messages. =
 ======================================================================
 Parameters:
         neg     [bufsize]
   * Data in the buffer are considered as array of items with variable
     length - messages. Format of a message is explained in
     general description.
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_SET_MESSAGE_AREA (0)
 ======================================================================
 ===================== Function 69, subfunction 1 =====================
 ============ Get contents of registers of debugged thread. ===========
 ======================================================================
   * If the thread executes code of ring-0, the function returns
     contents of registers of ring-3.
   * Process must be loaded for debugging (as is shown in
     general description).
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_GET_REGISTERS (1)
 ======================================================================
 ===================== Function 69, subfunction 2 =====================
 ============ Set contents of registers of debugged thread. ===========
 ======================================================================
   * If the thread executes code of ring-0, the function returns
     contents of registers of ring-3.
   * Process must be loaded for debugging (as is shown in
     general description).
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_SET_REGISTERS (2)
 ======================================================================
 ===== Function 69, subfunction 3 - detach from debugged process. =====
 ======================================================================
 Parameters:
 Returned value:
   * function does not return value
 Remarks:
   * If the process was suspended, it resumes execution.
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_DETACH (3)
 ======================================================================
 ======== Function 69, subfunction 4 - suspend debugged thread. =======
 ======================================================================
 Parameters:
   * function does not return value
 Remarks:
   * Process must be loaded for debugging (as is shown in
     general description).
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_SUSPEND (4)
 ======================================================================
 ======== Function 69, subfunction 5 - resume debugged thread. ========
 ======================================================================
 Parameters:
   * function does not return value
 Remarks:
   * Process must be loaded for debugging (as is shown in
     general description).
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_RESUME (5)
 ======================================================================
 = Fucntion 69, subfunction 6 - read from memory of debugged process. =
 ======================================================================
 Parameters:
     if esi is too large)
 Remarks:
   * Process must be loaded for debugging (as is shown in
     general description).
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_READ_MEMORY (6)
 ======================================================================
 == Function 69, subfunction 7 - write to memory of debugged process. =
 ======================================================================
 Parameters:
     if esi is too large)
 Remarks:
   * Process must be loaded for debugging (as is shown in
     general description).
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_WRITE_MEMORY (7)
 ======================================================================
 ======= Function 69, subfunction 8 - terminate debugged thread. ======
 ======================================================================
 Parameters:
     general description).
   * The function is similar to subfunction 2 of function 18
     with two differences: it requires first remark and
     accepts PID rather than slot number.
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_TERMINATE (8)
 ======================================================================
 ===== Function 69, subfunction 9 - set/clear hardware breakpoint. ====
 ======================================================================
 Parameters:
   * Breakpoints generate debug exception #DB, on which the system
     notifies debugger.
   * Breakpoints on write and read/write act after
     execution of the caused it instruction.
+---------------------- Constants for registers: ----------------------
+  eax - SF_DEBUG (69)
   ebx - SSF_DEFINE_BREAKPOINT (9)
 ======================================================================
 ==== Function 70 - work with file system with long names support. ====
 ======================================================================
 Parameters:
 At the first call of subfunctions 0,1,5,7 to ATAPI devices
 (CD and DVD) the manual control of tray is locked due to caching
 drive data. Unlocking is made when subfunction 4 of function 24
 is called for corresponding device.
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
+ [ebx] - SSF_READ_FILE (0), SSF_READ_FOLDER (1), SSF_CREATE_FILE (2),
+    SSF_WRITE_FILE (3), SSF_SET_END (4), SSF_GET_INFO (5),
+    SSF_SET_INFO (6), SSF_START_APP (7), SSF_DELETE (8),
     SSF_CREATE_FOLDER (9)
 ======================================================================
 === Function 70, subfunction 0 - read file with long names support. ==
 ======================================================================
 Parameters:
     the function will read as many as it can, and after that return
     eax=6 (EOF).
   * The function does not allow to read folder (returns eax=10,
     access denied).
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_READ_FILE (0)
 ======================================================================
 == Function 70, subfunction 1 - read folder with long names support. =
 ======================================================================
 Parameters:
   * The function allows also to read virtual folders "/", "/rd",
     "/fd", "/hd[n]", thus attributes of subfolders are set to 0x10,
     and times and dates are zeroed. An alternative way to get the
     equipment information - subfunction 11 of function 18.
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_READ_FOLDER (1)
 ======================================================================
 ===================== Function 70, subfunction 2 =====================
 ============ Create/rewrite file with long names support. ============
 ======================================================================
     if it existed, it is rewritten.
   * If there is not enough free space on disk, the function will
     write as many as can and then return error code 8.
   * The function is not supported for CD (returns error code 2).
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_CREATE_FILE (2)
 ======================================================================
 ===================== Function 70, subfunction 3 =====================
 =========== Write to existing file with long names support. ==========
 ======================================================================
   * If beginning and/or ending position is greater than file size
     (except for the previous case), the file is expanded to needed
     size with zero characters.
   * The function is not supported for CD (returns error code 2).
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_WRITE_FILE (3)
 ======================================================================
 ============ Function 70, subfunction 4 - set end of file. ===========
 ======================================================================
 Parameters:
   * If there is not enough free space on disk for expansion, the
     function will expand to maximum possible size and then return
     error code 8.
   * The function is not supported for CD (returns error code 2).
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_SET_END (4)
 ======================================================================
 ==== Function 70, subfunction 5 - get information on file/folder. ====
 ======================================================================
 Parameters:
 (i.e. only first 40 = 0x28 bytes).
 Remarks:
   * The function does not support virtual folders such as /, /rd and
     root folders like /rd/1.
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_GET_INFO (5)
 ======================================================================
 ===== Function 70, subfunction 6 - set attributes of file/folder. ====
 ======================================================================
 Parameters:
 Remarks:
   * The function does not support virtual folders such as /, /rd and
     root folders like /rd/1.
   * The function is not supported for CD (returns error code 2).
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_SET_INFO (6)
 ======================================================================
 =========== Function 70, subfunction 7 - start application. ==========
 ======================================================================
 Parameters:
     up to terminating zero inclusively or first 256 character
     regarding what is less.
   * If the process is started as debugged, it is created in
     the suspended state; to run use subfunction 5 of function 69.
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_START_APP (7)
 ======================================================================
 ========== Function 70, subfunction 8 - delete file/folder. ==========
 ======================================================================
 Parameters:
 Remarks:
   * The function is not supported for CD (returns error code 2).
   * The function can delete only empty folders (attempt to delete
     nonempty folder results in error with code 10, "access denied").
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_DELETE (8)
 ======================================================================
 ============= Function 70, subfunction 9 - create folder. ============
 ======================================================================
 Parameters:
 Remarks:
   * The function is not supported for CD (returns error code 2).
   * The parent folder must already exist.
   * If target folder already exists, function returns success (eax=0).
+---------------------- Constants for registers: ----------------------
+  eax - SF_FILE (70)
  [ebx] - SSF_CREATE_FOLDER (9)
 ======================================================================
 ========== Function 71, subfunction 1 - set window caption. ==========
 ======================================================================
 Parameters:
 = UTF-16LE
 = UTF-8
     otherwise will be used cp866.
   * Pass NULL in ecx to remove caption.
+---------------------- Constants for registers: ----------------------
   eax - SF_SET_CAPTION (71)
 ======================================================================
 =============== Function 72 - send message to a window. ==============
 ======================================================================
   * edx = parameter: key code for ecx=2, button identifier for ecx=3
 Returned value:
   * eax = 0 - success
   * eax = 1 - buffer is full
+---------------------- Constants for registers: ----------------------
   eax - SF_SEND_MESSAGE (72)
 ======================================================================
 ===================== Function 73 - blit bitmap  =====================
 ======================================================================
     +36: dword: size of the bitmap row in bytes
 Returned value:
+  * function does not return value
-  * function does not return value
+---------------------- Constants for registers: ----------------------
   eax - SF_BLITTER (73)
 ======================================================================
 = Function 74, Subfunction 255, Get number of active network devices. =
 ======================================================================
 Parameters:
   * eax = 74 - function number
   * bl = 255 - subfunction number
+Returned value:
+  * eax = number of active network devices
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = number of active network devices
+  eax - SF_NETWORK_GET (74)
    bl - SSF_DEVICE_COUNT (255)
 ======================================================================
 ======== Function 74, Subfunction 0, Get network device type. ========
 ======================================================================
 Parameters:
   * eax = 74 - function number
   * bl = 0 - subfunction number
+  * bh = device number
+Returned value:
+  * eax = device type number
   * bh = device number
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = device type number
+  eax - SF_NETWORK_GET (74)
    bl - SSF_DEVICE_TYPE (0)
 ======================================================================
   * ecx = pointer to 64 byte buffer
 Returned value:
   * eax = -1 on error
   * The network device name is written into the buffer, on success
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_GET (74)
    bl - SSF_DEVICE_NAME (1)
 ======================================================================
 ========= Function 74, Subfunction 2, Reset network device. ==========
 ======================================================================
 Parameters:
   * eax = 74 - function number
   * bl = 2 - subfunction number
   * bh = device number
 Returned value:
+  * eax = -1 on error
+---------------------- Constants for registers: ----------------------
-  * eax = -1 on error
+  eax - SF_NETWORK_GET (74)
    bl - SSF_RESET_DEVICE (2)
 ======================================================================
 ========== Function 74, Subfunction 3, Stop network device. ==========
 ======================================================================
 Parameters:
   * eax = 74 - function number
   * bl = 3 - subfunction number
   * bh = device number
+Returned value:
+  * eax = -1 on error
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = -1 on error
+  eax - SF_NETWORK_GET (74)
    bl - SSF_STOP_DEVICE (3)
 ======================================================================
 =========== Function 74, Subfunction 4, Get device pointer. ==========
 ======================================================================
 Parameters:
   * eax = 74 - function number
   * bl = 4 - subfunction number
+  * bh = device number
+Returned value:
+  * eax = device pointer, -1 on error
   * bh = device number
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = device pointer, -1 on error
+  eax - SF_NETWORK_GET (74)
    bl - SSF_DEVICE_POINER (4)
 ======================================================================
 ========= Function 74, Subfunction 6, Get packet TX counter. =========
 ======================================================================
 Parameters:
   * eax = 74 - function number
+  * bl = 6 - subfunction number
+  * bh = device number
+Returned value:
-  * bl = 6 - subfunction number
+  * eax = Number of packets sent since device start, -1 on error
   * bh = device number
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = Number of packets sent since device start, -1 on error
+  eax - SF_NETWORK_GET (74)
    bl - SSF_TX_PACKET_COUNT (6)
 ======================================================================
 ========= Function 74, Subfunction 7, Get packet RX counter. =========
 ======================================================================
 Parameters:
+  * eax = 74 - function number
+  * bl = 7 - subfunction number
+  * bh = device number
-  * eax = 74 - function number
+Returned value:
-  * bl = 7 - subfunction number
+  * eax = Number of packets received since device start, -1 on error
   * bh = device number
-Returned value:
+---------------------- Constants for registers: ----------------------
-  * eax = Number of packets received since device start, -1 on error
+  eax - SF_NETWORK_GET (74)
 Returned value:
   * eax = Number of bytes sent since device start (lower dword)
                   -1 on error
   * ebx = Number of bytes sent since device start (higher dword)
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_GET (74)
    bl - SSF_TX_BYTE_COUNT (8)
 ======================================================================
 ========== Function 74, Subfunction 9, Get RX byte counter. ==========
 ======================================================================
 Parameters:
 Returned value:
   * eax = Number of bytes received since device start (lower dword)
                   -1 on error
   * ebx = Number of bytes received since device start (higher dword)
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_GET (74)
    bl - SSF_RX_BYTE_COUNT (9)
 ======================================================================
 ========== Function 74, Subfunction 10, Get link status. =============
 ======================================================================
 Parameters:
     ETH_LINK_FD     =   10b         ; full duplex flag
     ETH_LINK_10M    =  100b         ; 10 mbit
     ETH_LINK_100M   = 1000b         ; 100 mbit
     ETH_LINK_1G     = 1100b         ; gigabit
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_GET (74)
    bl - SSF_LINK_STATUS (10)
 ======================================================================
 ============== Function 75, Subfunction 0, Open socket. ==============
 ======================================================================
 Parameters:
   * esi = protocol
 Returned value:
   * eax = socket number, -1 on error
   * ebx = errorcode
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_OPEN (0)
 ======================================================================
 ============= Function 75, Subfunction 1, Close socket. ==============
 ======================================================================
 Parameters:
   * ecx = socket number
 Returned value:
   * eax = -1 on error
   * ebx = errorcode
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_CLOSE (1)
 ======================================================================
 ================== Function 75, Subfunction 2, Bind. =================
 ======================================================================
 Parameters:
   * esi = length of sockaddr structure
 Returned value:
   * eax = -1 on error
   * ebx = errorcode
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_BIND (2)
 ======================================================================
 ================= Function 75, Subfunction 3, Listen. ================
 ======================================================================
 Parameters:
   * edx = backlog
 Returned value:
   * eax = -1 on error
   * ebx = errorcode
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_LISTEN (3)
 ======================================================================
 ================ Function 75, Subfunction 4, Connect. ================
 ======================================================================
 Parameters:
   * esi = length of sockaddr structure
 Returned value:
   * eax = -1 on error
   * ebx = errorcode
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_CONNECT (4)
 ======================================================================
 ================= Function 75, Subfunction 5, Accept. ================
 ======================================================================
 Parameters:
   * esi = length of sockaddr structure
 Returned value:
   * eax = socket number of accepted socket, -1 on error
   * ebx = errorcode
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_ACCEPT (5)
 ======================================================================
 ================== Function 75, Subfunction 6, Send. =================
 ======================================================================
 Parameters:
   * edi = flags
 Returned value:
   * eax = number of bytes copied, -1 on error
   * ebx = errorcode
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_SEND (6)
 ======================================================================
 ================ Function 75, Subfunction 7, Receive. ================
 ======================================================================
 Parameters:
   * edi = flags
 Returned value:
   * eax = number of bytes copied, -1 on error
   * ebx = errorcode
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_RECEIVE (7)
 ======================================================================
 =========== Function 75, Subfunction 8, Set socket options. ==========
 ======================================================================
 Parameters:
     dd level
     dd optionname
     dd optlength
     db options...
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_SET_OPTIONS (8)
 ======================================================================
 =========== Function 75, Subfunction 9, Get socket options. ==========
 ======================================================================
 Parameters:
     dd level
     dd optionname
     dd optlength
     db options...
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_GET_OPTIONS (9)
 ======================================================================
 ============ Function 75, Subfunction 10, Get socketpair. ===========
 ======================================================================
 Parameters:
   * eax = 75 - function number
   * bl = 10 - subfunction number
 Returned value:
   * eax = socketnum1, -1 on error
+  * ebx = socketnum2, errorcode on error
+---------------------- Constants for registers: ----------------------
-  * ebx = socketnum2, errorcode on error
+  eax - SF_NETWORK_SOCKET (75)
    bl - SSF_GET_PAIR (10)
 ======================================================================
 ============ Function 76, Network options and statistics. ============
 ======================================================================
 - Add static ARP entry
 - Remove ARP entry (-1 = remove all)
 - Send ARP announce on specified interface
 - Read # ARP conflicts (IP address conflicts)
+---------------------- Constants for registers: ----------------------
   eax - SF_NETWORK_PROTOCOL (76)
 ======================================================================
 =============== Function -1 - terminate thread/process ===============
 ======================================================================
 Parameters:

Subversion Repositories Kolibri OS

(root)/kernel/trunk/docs/sysfuncs.txt – Rev 6030 → 6057