Subversion Repositories Kolibri OS

xmlns:o="urn:schemas-microsoft-com:office:office"

xmlns:w="urn:schemas-microsoft-com:office:word"

xmlns:m="http://schemas.microsoft.com/office/2004/12/omml"

xmlns="http://www.w3.org/TR/REC-html40">

Back to

main

Function 18

and its sub-functions (1-11, 13-25)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 1 - make the lowest flow window

Options:

  * eax =

18 - function number

  * ebx = 1

- number of subfunction

  * ecx =

stream slot number

Return value:

  * function does not return value

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_UNFOCUS_WINDOW (1)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 2 - complete process / thread by slot

Options:

  * eax =

18 - function number

  * ebx = 2

- subfunction number

  * ecx =

process / thread slot number

Return value:

  * function does not return value

Remarks:

  * You cannot

terminate the OS / IDLE OS thread (slot number 1), you

can terminate any normal thread process.

  * See also 

class=SpellE>subfunction 18 - termination of a process / thread with a

given identifier.

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_TERMINATE_THREAD (2)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 3 - make the specified stream window active

Options:

  * eax =

18 - function number

  * ebx = 3

- subfunction number

  * ecx =

stream slot number

Return value:

  * function does not return value

Remarks:

  * When specifying a

correct, but non-existent slot, a window is activated.

  * You can find out

which window is active by calling subfunction 7.

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_FOCUS_WINDOW (3)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 4 - get the empty clock count per second

Under the empty cycles refers to the time at which the processor is idle

while waiting for an interrupt (in the hlt

instruction).

Options:

  * eax =

18 - function number

  * ebx = 4

- subfunction number

Return value:

  * eax =

empty clock count per second

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_GET_IDLE_COUNT (4)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 5 - get the clock frequency

Options:

  * eax =

18 - function number

  * ebx = 5

- subfunction number

Return value:

  * eax =

clock frequency (modulo 2 ^ 32 clock cycles = 4 GHz)

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_GET_CPU_FREQUENCY (5)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 6 - save ramdisk to a file on the hard disk

lang=EN-US style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'>

Options:

  * eax =

18 - function number

  * ebx = 6

- subfunction number

* ecx = pointer to a

string with the full file name (for example, "/hd0/1/kolibri/

class=SpellE>kolibri.img")

Return value:

  * eax = 0

- successful

  * otherwise eax

= file system error code

Remarks:

  * All folders in the

specified path must exist, otherwise the value 5 will be returned, "

class=GramE>file not found".

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_RD_TO_HDD (6)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 7 - get the number of the active window

Options:

  * eax =

18 - function number

  * ebx = 7

- subfunction number

Return value:

  * eax =

number of the active window (the number of the stream slot, the window of which

    actively)

Remarks:

  * The active window

is at the top of the window stack and receives messages about all input from

the keyboard.

  * You can make the

window active by calling subfunction 3.

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_GET_ACTIVE_WINDOW (7)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 8 - disable / enable speaker sound

When sound is muted, calls to subfunction 55

to function 55 are ignored.

When on, it is sent to the built-in speaker.

Nested

function 1 - get state

Options:

  * eax =

18 - function number

  * ebx = 8

- number of subfunction

  * ecx = 1

- number of sub-function

Return value:

  * eax = 0

- the sound of the speaker is allowed; 1 - not allowed

Nested

function 2 - switch state

Toggles enable / disable states.

Options:

  * eax =

18 - function number

  * ebx = 8

- number of subfunction

  * ecx = 2

- the number of the sub-function

Return 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)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 9 - system shutdown with a parameter

style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>

Options:

  * eax =

18 - function number

  * ebx = 9

- subfunction number

  * ecx =

parameter:

    * 2 = turn off computer

    * 3 = restart computer

    * 4 = restart kernel from kernel.mnt

file on ramdisk

Return value:

  * if ecx

is incorrect, the registers do not change (ie, 

class=SpellE>eax = 18)

  * a correct call always returns a

sign of success eax = 0

Remarks:

  * Do not rely on the

return value for an incorrect call, it may change in

future versions of the kernel.

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_SHUTDOWN (9)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 10 - minimize active window

style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'>

Minimizes the active window.

Options:

  * eax =

18 - function number

  * ebx =

10 - subfunction number

Return value:

  * function does not return value

Remarks:

  * The minimized

window in terms of function 9 saves position and size.

  * Restoration of the

application window occurs when activating the subfunction

3.

  * Usually there is no

need to explicitly minimize / maximize your window: the system minimizes the

window when you press the minimization button (which is automatically

determined for windows with a skin by function 0, for windows without a skin it

can be defined by function 8), recovery by the @taskbar application.

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_MINIMIZE_WINDOW (10)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 11 - get information about the disk subsystem

Options:

  * eax =

18 - function number

  * ebx =

11 - subfunction number

  * ecx =

table type:

    * 1 = short version, 16 bytes

  * edx =

pointer to buffer (in application) for a table

Return value:

  * function does not return value

Table format: short version:

  * +0: byte: information about floppy disk drives, AAAABBBB,

where AAAA specifies the type of the first floppy disk drive, BBBB - the second

one according to the following list:

    * 0 = no drive

    * 1 = 360Kb, 5.25 ''

    * 2 = 1.2Mb, 5.25 ''

    * 3 = 720Kb, 3.5 "

    * 4 = 1.44Mb, 3.5 "

    * 5 = 2.88Mb, 3.5 '' (such diskettes are not

used now). 

For example, for a standard configuration of one 1.44 drive, there will

be 40h here, and for the case of 1.2Mb for A: and 1.44Mb for B: the value is

24h.

First IDE controller

lang=EN-US style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'>:

  * +1: byte: information about hard drives and CD drives,

AABBCCDD,

    where AA corresponds to

the controller IDE0, ..., DD - IDE3:

    * 0 = no device

    * 1 = hard disk

    * 2 = CD drive

    For example, in the case of HD on IDE0 and CD on

IDE2 here it will be 48h.

  * +2: 4 db: the number of

partitions found on hard drives with

    respectively IDE0, ...,

IDE3.

Second IDE controller:

  * +6: byte: information about hard drives and CD drives,

AABBCCDD

    where AA corresponds to

the IDE4 controller, ..., DD - IDE7:

    * 0 = no device

    * 1 = hard disk

    * 2 = CD drive

    For example, in the case of HD on IDE4 and CD on

IDE6 here it will be 48h.

  * +7: 4 db: the number of

partitions found on hard drives with

    respectively IDE4, ...,

IDE7.

Third IDE Controller:

  * +11: byte: information about hard drives and CD drives,

AABBCCDD

    where AA corresponds to

the IDE8 controller, ..., DD - IDE11:

    * 0 = no device

    * 1 = hard disk

    * 2 = CD drive

    For example, in the case of HD on IDE8 and CD on

IDE10 here it will be 48h.

  * +12: 4 db: the number of

partitions found on hard drives with

    respectively IDE8, ...,

IDE11.

If there is no hard disk on IDEx, the

corresponding byte is zero, and if there is, it shows the number of recognized

partitions that may not be (if the media is not formatted or if the file system

is not supported). In the current kernel version for hard disks, only FAT12 /

16/32, NTFS, ext2 / 3/4 and XFS are supported.

Remarks:

  * The table can be

used to obtain information. More about the

supported devices.

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_INFO_DISC_SYS (11)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 13 - get the kernel version

Options:

  * eax =

18 - function number

  * ebx =

13 - number of subfunction

  * ecx =

pointer to the buffer (at least 16 bytes) where the information will be placed

Return value:

  * function does not return value

Buffer structure:

db

lang=EN-US style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'> a,

b, c, d for version a.b.c.d

db

lang=EN-US style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'> 0:

reserved

dd

lang=EN-US style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'>

REV - number of the kernel svn revision

For Kolibri kernel 0.7.7.0+:

db

lang=EN-US style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'>

0,7,0

db

lang=EN-US style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'> 0

dd

lang=EN-US style='font-family:"Arial","sans-serif";mso-ansi-language:EN-US'>

1675

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_KERNEL_VERSION (13)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 14 - wait for the start of the return stroke of the monitor sweep

Options:

  * eax =

18 - function number

  * ebx =

14 - number of subfunction

Return value:

  * eax = 0

as a sign of success

Remarks:

  * The function is

intended exclusively for active high-performance graphics applications; used

for smooth graphics output.

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_WAIT_RETRACE (14)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 15 - place the mouse cursor in the center of the screen

Options:

  * eax =

18 - function number

  * ebx =

15 - subfunction number

Return value:

  * eax = 0

as a sign of success

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_CURSOR_CENTER (15)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 16 - get the size of free RAM

Options:

  * eax =

18 - function number

  * ebx =

16 - number of subfunction

Return value:

  * eax =

free memory in kilobytes

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_GET_FREE_RAM (16)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 17 - get the size of available RAM

Options:

  * eax =

18 - function number

  * ebx =

17 - subfunction number

Return value:

  * eax =

total amount of available memory in kilobytes

Constants for registers:

  eax -

SF_SYSTEM (18)

  ebx -

SSF_GET_TOTAL_RAM (17)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 18 - terminate the process / thread by identifier

Options:

   * eax =

18 - function number

   * ebx =

18 - subfunction number

   * ecx =

process / thread id (PID / TID)

Return value:

   * eax =

   * eax =

-1 - error (process not found or is system)

Remarks:

   * You cannot

terminate the OS / IDLE OS thread (slot number 1), you

can terminate any normal thread / process.

   * See also 

class=SpellE>subfunction 2 - completion of a process / thread at a given

slot.

Constants for registers:

   eax -

SF_SYSTEM (18)

   ebx -

SSF_TERMINATE_THREAD_ID (18)

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'>Subfunction

lang=EN-US style='font-size:14.0pt;font-family:"Arial","sans-serif";mso-ansi-language:

EN-US'> 19 - get / set mouse settings

Nested 

class=SpellE>subfunction 0 - get mouse speed

Options:

  * eax =

18 - function number

  * ebx =

19 - subfunction number

  * ecx = 0

- number of sub-function

Return value:

  * eax =

current speed divider

Nested 

class=SpellE>subfunction 1 - set the speed of the mouse

Options:

  * eax =

18 - function number

  * ebx =

19 - subfunction number

  * ecx = 1

- number of sub-function

  * edx =

new speed divider value

Return value:

  * function does not return value

Note: recommended speed divider =