| 82,9 → 82,9 |
|---|
| * The window of type I looks as follows: |
| * draw external frame of color indicated in edi, 1 pixel in width |
| * draw header - rectangle with the left upper corner (1,1) and |
| right lower (xsize-1,min(25,ysize)) color indicated in esi |
| right lower (xsize-1,min(20,ysize-1)) color indicated in esi |
| (taking a gradient into account) |
| * if ysize>=26, fill the working area of the window - |
| * if ysize>21, fill the working area of the window - |
| rectangle with the left upper corner (1,21) and right lower |
| (xsize-1,ysize-1) (sizes (xsize-1)*(ysize-21)) with color |
| indicated in edx (taking a gradient into account) |
| 148,7 → 148,10 |
|---|
| Returned value: |
| * if the buffer is empty, function returns eax=1 |
| * if the buffer is not empty, function returns al=0, |
| ah=code of the pressed key, high word of eax is zero |
| ah=code of the pressed key, |
| bits 16-23 = contain scancode for pressed key in ASCII mode, |
| in the scancodes mode this bits cleared. |
| bits 23-31 = zero |
| * if there is "hotkey", function returns al=2, |
| ah=scancode of the pressed key (0 for control keys), |
| high word of eax contains a status of control keys at the moment |
| 815,9 → 818,9 |
|---|
| changed in future versions of the kernel. |
| |
| ====================================================================== |
| ===== Function 18, subfunction 10 - minimize application window. ===== |
| ======= Function 18, subfunction 10 - minimize topmost window. ======= |
| ====================================================================== |
| Minimizes the own window. |
| Minimizes the topmost (active) window. |
| Parameters: |
| * eax = 18 - function number |
| * ebx = 10 - subfunction number |
| 828,8 → 831,8 |
|---|
| keeps position and sizes. |
| * Restoring of an application window occurs at its activation by |
| subfunction 3. |
| * Usually there is no necessity to minimize/restire a window |
| obviously: minimization of a window is carried out by the system |
| * Usually there is no necessity to minimize/restore a window |
| explicitly: minimization of a window is carried out by the system |
| 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), |
| 842,8 → 845,7 |
|---|
| * eax = 18 - function number |
| * ebx = 11 - subfunction number |
| * ecx = type of the table: |
| * 1 = short version, 10 bytes |
| * 2 = full version, 65536 bytes |
| * 1 = short version, 16 bytes |
| * edx = pointer to the buffer (in the application) for the table |
| Returned value: |
| * function does not return value |
| 860,9 → 862,11 |
|---|
| For example, for the standard configuration from one 1.44-drive |
| here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B: |
| the value is 24h. |
| |
| First IDE controller: |
| * +1: byte: information about hard disks and CD-drives, AABBCCDD, |
| where AA corresponds to the controller IDE0, ..., DD - IDE3: |
| * 0 = device is absent |
| * 0 = device not found |
| * 1 = hard drive |
| * 2 = CD-drive |
| For example, in the case HD on IDE0 and CD on IDE2 |
| 869,32 → 873,37 |
|---|
| this field contains 48h. |
| * +2: 4 db: number of the retrieved partitions on hard disks |
| at accordingly IDE0,...,IDE3. |
| |
| Second IDE controller: |
| * +6: byte: information about hard disks and CD-drives, AABBCCDD, |
| where AA corresponds to the controller IDE4, ..., DD - IDE7: |
| * 0 = device not found |
| * 1 = hard drive |
| * 2 = CD-drive |
| For example, in the case HD on IDE4 and CD on IDE6 |
| this field contains 48h. |
| * +7: 4 db: number of the retrieved partitions on hard disks |
| at accordingly IDE4,...,IDE7. |
| |
| Third IDE controller: |
| * +11: byte: information about hard disks and CD-drives, AABBCCDD, |
| where AA corresponds to the controller IDE8, ..., DD - IDE11: |
| * 0 = device not found |
| * 1 = hard drive |
| * 2 = CD-drive |
| For example, in the case HD on IDE8 and CD on IDE10 |
| this field contains 48h. |
| * +12: 4 db: number of the retrieved partitions on hard disks |
| at accordingly IDE8,...,IDE11. |
| |
| If the hard disk on IDEx is absent, appropriate byte is zero, |
| otherwise it shows number of the recognized partitions, which |
| can be not presented (if the drive is not formatted or if |
| the file system is not supported). Current version of the kernel |
| supports only FAT16, FAT32 and NTFS for hard disks. |
| * +6: 4 db: reserved |
| Format of the table: full version: |
| * +0: 10 db: same as for the short version |
| * +10: 100 db: data for the first partition |
| * +110: 100 db: data for the second partition |
| * ... |
| * +10+100*(n-1): 100 db: data for the last partition |
| The partitions are located as follows: at first sequentially all |
| recoginzed partitions on HD on IDE0 (if present), |
| then on HD on IDE1 (if present) and so on up to IDE3. |
| Format of the information about partition |
| (at moment only FAT is supported): |
| * +0: dword: first physical sector of the partition |
| * +4: dword: last physical sector of the partition |
| (belongs to the partition) |
| * +8: byte: file system type: |
| 16=FAT16, 32=FAT32, 1=NTFS |
| * other data are dependent on file system, are modified with |
| kernel modifications and therefore are not described |
| supports only FAT12/16/32, NTFS, ext2/3/4 and XFS for hard disks. |
| |
| Remarks: |
| * The short table can be used for obtaining the information about |
| * The table can be used for obtaining the information about |
| available devices. |
| |
| ====================================================================== |
| 1209,19 → 1218,6 |
|---|
| * The application @panel switches layouts on user request. |
| |
| ====================================================================== |
| ============== Function 21, subfunction 3 - set CD base. ============= |
| ====================================================================== |
| Parameters: |
| * eax = 21 - function number |
| * ebx = 3 - subfunction number |
| * ecx = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3 |
| Returned value: |
| * eax = 0 |
| Remarks: |
| * CD base is used by function 24. |
| * To get CD base use subfunction 3 of function 26. |
| |
| ====================================================================== |
| ========== Function 21, subfunction 5 - set system language. ========= |
| ====================================================================== |
| Parameters: |
| 1239,49 → 1235,6 |
|---|
| * To get system language use subfunction 5 of function 26. |
| |
| ====================================================================== |
| ============== Function 21, subfunction 7 - set HD base. ============= |
| ====================================================================== |
| The HD base defines hard disk to write with usage of obsolete |
| syntax /HD in obsolete function 58; at usage of modern syntax |
| /HD0,/HD1,/HD2,/HD3 base is set automatically. |
| Parameters: |
| * eax = 21 - function number |
| * ebx = 7 - subfunction number |
| * ecx = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3 |
| Returned value: |
| * eax = 0 |
| Remarks: |
| * Any application at any time can change the base. |
| * Do not change base, when any application works with hard disk. |
| If you do not want system bugs. |
| * To get HD base use subfunction 7 of function 26. |
| * It is also necessary to define used partition of hard disk by |
| subfunction 8. |
| |
| ====================================================================== |
| ========= Function 21, subfunction 8 - set used HD partition. ======== |
| ====================================================================== |
| The HD partition defines partition of the hard disk to write with |
| usage of obsolete syntax /HD and obsolete function 58; |
| at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3 |
| base and partition are set automatically. |
| Parameters: |
| * eax = 21 - function number |
| * ebx = 8 - subfunction number |
| * ecx = HD partition (beginning from 1) |
| Return value: |
| * eax = 0 |
| Remarks: |
| * Any application at any time can change partition. |
| * Do not change partition when any application works with hard disk. |
| If you do not want system bugs. |
| * To get used partition use subfunction 8 of function 26. |
| * There is no correctness checks. |
| * To get the number of partitions of a hard disk use |
| subfunction 11 of function 18. |
| * It is also necessary to define used HD base by subfunction 7. |
| |
| ====================================================================== |
| Function 21, subfunction 11 - enable/disable low-level access to HD. |
| ====================================================================== |
| Parameters: |
| 1310,120 → 1263,6 |
|---|
| * To get current status use subfunction 12 of function 26. |
| |
| ====================================================================== |
| ============ Function 21, subfunction 13, subsubfunction 1 =========== |
| ======== Initialize + get information on the driver vmode.mdr. ======= |
| ====================================================================== |
| Parameters: |
| * eax = 21 - function number |
| * ebx = 13 - subfunction number |
| * ecx = 1 - number of the driver function |
| * edx = pointer to 512-bytes buffer |
| Returned value: |
| * if driver is not loaded |
| (never happens in the current implementation): |
| * eax = -1 |
| * ebx, ecx destroyed |
| * if driver is loaded: |
| * eax = 'MDAZ' (in fasm style, that is 'M' - low byte, 'Z' - high) |
| - signature |
| * ebx = current frequency of the scanning (in Hz) |
| * ecx destroyed |
| * buffer pointed to by edx is filled |
| Format of the buffer: |
| * +0: 32*byte: driver name, "Trans VideoDriver" |
| (without quotes, supplemented by spaces) |
| * +32 = +0x20: dword: driver version (version x.y is encoded as |
| y*65536+x), for the current implementation is 1 (1.0) |
| * +36 = +0x24: 7*dword: reserved (0 in the current implementation) |
| * +64 = +0x40: 32*word: list of supported videomodes (each word |
| is number of a videomode, after list itself there are zeroes) |
| * +128 = +0x80: 32*(5*word): list of supported frequences of the |
| scannings for videomodes: for each videomode listed in the |
| previous field up to 5 supported frequences are given |
| (unused positions contain zeroes) |
| Remarks: |
| * Function initializes the driver (if it is not initialized yet) |
| and must be called first, before others (otherwise they will do |
| nothing and return -1). |
| * The current implementation supports only one frequency |
| of the scanning on videomode. |
| |
| ====================================================================== |
| ============ Function 21, subfunction 13, subsubfunction 2 =========== |
| ================ Get information on current videomode. =============== |
| ====================================================================== |
| Parameters: |
| * eax = 21 - function number |
| * ebx = 13 - subfunction number |
| * ecx = 2 - number of the driver function |
| Returned value: |
| * eax = -1 - driver is not loaded or not initialized; |
| ebx,ecx are destroyed |
| * eax = [width]*65536 + [height] |
| * ebx = frequency of the vertical scanning (in Hz) |
| * ecx = number of current videomode |
| Remarks: |
| * Driver must be initialized by call to |
| driver function 1. |
| * If only screen sizes are required, it is more expedient to use |
| function 14 taking into account that it |
| returns sizes on 1 less. |
| |
| ====================================================================== |
| === Function 21, subfunction 13, subsubfunction 3 - set videomode. === |
| ====================================================================== |
| Parameters: |
| * eax = 21 - function number |
| * ebx = 13 - subfunction number |
| * ecx = 3 - number of the driver function |
| * edx = [scanning frequency]*65536 + [videomode number] |
| Returned value: |
| * eax = -1 - driver is not loaded, not initialized or |
| an error has occured |
| * eax = 0 - success |
| * ebx, ecx destroyed |
| Remarks: |
| * Driver must be initialized by driver function 1. |
| * The videomode number and frequency must be in the table |
| returned by driver function 1. |
| |
| ====================================================================== |
| ============ Function 21, subfunction 13, subsubfunction 4 =========== |
| ================== Return to the initial videomode. ================== |
| ====================================================================== |
| Returns the screen to the videomode set at system boot. |
| Parameters: |
| * eax = 21 - function number |
| * ebx = 13 - subfunction number |
| * ecx = 4 - number of the driver function |
| Returned value: |
| * eax = -1 - driver is not loaded or not initialized |
| * eax = 0 - success |
| * ebx, ecx destroyed |
| Remarks: |
| * Driver must be initialized by call to driver function 1. |
| |
| ====================================================================== |
| ============ Function 21, subfunction 13, subsubfunction 5 =========== |
| ===== Increase/decrease the size of the visible area of monitor. ===== |
| ====================================================================== |
| Parameters: |
| * eax = 21 - function number |
| * ebx = 13 - subfunction number |
| * ecx = 5 - number of the driver function |
| * edx = 0/1 - decrease/increase horizontal size on 1 position |
| * edx = 2/3 - is not supported in the current implementation; |
| is planned as decrease/increase vertical size on 1 position |
| Returned value: |
| * eax = -1 - driver is not loaded or not initialized |
| * eax = 0 - success |
| * ebx, ecx destroyed |
| Remarks: |
| * Driver must be initialized by call to driver function 1. |
| * Function influences only the physical size of the screen image; |
| the logical size (number of pixels) does not change. |
| |
| ====================================================================== |
| ================= Function 22 - set system date/time. ================ |
| ====================================================================== |
| Parameters: |
| 1485,58 → 1324,6 |
|---|
| makes 32-bit overflow. |
| |
| ====================================================================== |
| ======== Function 24, subfunction 1 - begin to play CD-audio. ======== |
| ====================================================================== |
| Parameters: |
| * eax = 24 - function number |
| * ebx = 1 - subfunction number |
| * ecx = 0x00FRSSMM, where |
| * MM = starting minute |
| * SS = starting second |
| * FR = starting frame |
| Returned value: |
| * eax = 0 - success |
| * eax = 1 - CD base is not defined |
| Remarks: |
| * Previously CD base must be defined by the call to |
| subfunction 3 of function 21. |
| * One second includes 75 frames, one minute includes 60 seconds. |
| * The function is asynchronous (returns control, when play begins). |
| |
| ====================================================================== |
| ======= Function 24, subfunction 2 - get information on tracks. ====== |
| ====================================================================== |
| Parameters: |
| * eax = 24 - function number |
| * ebx = 2 - subfunction number |
| * ecx = pointer to the buffer for the table |
| (maximum 8*64h+4 bytes=100 tracks) |
| Returned value: |
| * eax = 0 - success |
| * eax = 1 - CD base is not defined |
| Remarks: |
| * The format of the table with tracks information is the same as |
| for ATAPI-CD command 43h (READ TOC), usual table (subcommand 00h). |
| Function returns addresses in MSF. |
| * Previously CD base port must be set by call to |
| subfunction 3 of function 21. |
| * Function returns information only about no more than 100 |
| first tracks. In most cases it is enough. |
| |
| ====================================================================== |
| ========== Function 24, subfunction 3 - stop play CD-audio. ========== |
| ====================================================================== |
| Parameters: |
| * eax = 24 - function number |
| * ebx = 1 - subfunction number |
| Returned value: |
| * eax = 0 - success |
| * eax = 1 - CD base is not defined |
| Remarks: |
| * Previously CD base port must be defined by call to |
| subfunction 3 of function 21. |
| |
| ====================================================================== |
| ======= Function 24, subfunction 4 - eject tray of disk drive. ======= |
| ====================================================================== |
| Parameters: |
| 1543,7 → 1330,9 |
|---|
| * eax = 24 - function number |
| * ebx = 4 - subfunction number |
| * ecx = position of CD/DVD-drive |
| (from 0=Primary Master to 3=Secondary Slave) |
| from 0=Primary Master to 3=Secondary Slave for first IDE contr. |
| from 4=Primary Master to 7=Secondary Slave for second IDE contr. |
| from 8=Primary Master to 11=Secondary Slave for third IDE contr. |
| Returned value: |
| * function does not return value |
| Remarks: |
| 1561,7 → 1350,9 |
|---|
| * eax = 24 - function number |
| * ebx = 5 - subfunction number |
| * ecx = position of CD/DVD-drive |
| (from 0=Primary Master to 3=Secondary Slave) |
| from 0=Primary Master to 3=Secondary Slave for first IDE contr. |
| from 4=Primary Master to 7=Secondary Slave for second IDE contr. |
| from 8=Primary Master to 11=Secondary Slave for third IDE contr. |
| Returned value: |
| * function does not return value |
| Remarks: |
| 1636,18 → 1427,6 |
|---|
| * The application @panel switches layouts on user request. |
| |
| ====================================================================== |
| ============== Function 26, subfunction 3 - get CD base. ============= |
| ====================================================================== |
| Parameters: |
| * eax = 26 - function number |
| * ebx = 3 - subfunction number |
| Returned value: |
| * eax = CD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3 |
| Remarks: |
| * CD base is used by function 24. |
| * To set CD base use subfunction 3 of function 21. |
| |
| ====================================================================== |
| ========== Function 26, subfunction 5 - get system language. ========= |
| ====================================================================== |
| Parameters: |
| 1662,41 → 1441,6 |
|---|
| * To set system language use subfunction 5 of function 21. |
| |
| ====================================================================== |
| ============== Function 26, subfunction 7 - get HD base. ============= |
| ====================================================================== |
| The HD base defines hard disk to write with usage of obsolete |
| syntax /HD in obsolete function 58; at usage of modern syntax |
| /HD0,/HD1,/HD2,/HD3 base is set automatically. |
| Parameters: |
| * eax = 26 - function number |
| * ebx = 7 - subfunction number |
| Returned value: |
| * eax = HD base: 1=IDE0, 2=IDE1, 3=IDE2, 4=IDE3 |
| Remarks: |
| * Any application in any time can change HD base. |
| * To set base use subfunction 7 of function 21. |
| * To get used partition of hard disk use subfunction 8. |
| |
| ====================================================================== |
| ========= Function 26, subfunction 8 - get used HD partition. ======== |
| ====================================================================== |
| The HD partition defines partition of the hard disk to write with |
| usage of obsolete syntax /HD in obsolete function 58; |
| at usage of functions 58 and 70 and modern syntax /HD0,/HD1,/HD2,/HD3 |
| base and partition are set automatically. |
| Parameters: |
| * eax = 26 - function number |
| * ebx = 8 - subfunction number |
| Returned value: |
| * eax = HD partition (beginning from 1) |
| Remarks: |
| * Any application in any time can change partition. |
| * To set partition use subfunction 8 of function 21. |
| * To get number of partitions on a hard disk use |
| subfunction 11 of function 18. |
| * To get base of used hard disk, use subfunction 7. |
| |
| ====================================================================== |
| === Function 26, subfunction 9 - get the value of the time counter. == |
| ====================================================================== |
| Parameters: |
| 2315,8 → 2059,7 |
|---|
| Parameters: |
| * eax = 48 - function number |
| * ebx = 8 - subfunction number |
| * ecx = pointer to a block for function 58, in |
| which the fields of intermediate buffer and file name are filled |
| * ecx = pointer to filename of the skin |
| Returned value: |
| * eax = 0 - success |
| * otherwise eax = file system error code; if file does not |
| 2527,219 → 2270,6 |
|---|
| (through kernel-mode analogues of subfunctions of function 62). |
| |
| ====================================================================== |
| ================ Function 58 - work with file system. ================ |
| ====================================================================== |
| Parameters: |
| * eax = 58 |
| * ebx = pointer to the information structure |
| Returned value: |
| * eax = 0 - success; otherwise file system error code |
| * some subfunctions return value in other registers too |
| General format of the information structure: |
| * +0: dword: subfunction number |
| * +4: dword: number of block |
| * +8: dword: size |
| * +12 = +0xC: dword: pointer to data |
| * +16 = +0x10: dword: pointer to a memory for system operations |
| (4096 bytes) |
| * +20 = +0x14: n db: ASCIIZ-string with the file name |
| Specifications - in documentation on the appropriate subfunction. |
| Filename is case-insensitive for latin letters, russian letters |
| must be capital. |
| Format of filename: |
| /base/number/dir1/dir2/.../dirn/file, |
| where /base/number identifies device, on which file is located: |
| one of |
| * /RD/1 = /RAMDISK/1 to access ramdisk |
| * /FD/1 = /FLOPPYDISK/1 to access first floppy drive, |
| /FD/2 = /FLOPPYDISK/2 to access second one |
| * /HD/x = /HARDDISK/x - obsolete variant of access to hard disk |
| (in this case base is defined by subfunction 7 of function 21), |
| x - partition number (beginning from 1) |
| * /HD0/x, /HD1/x, /HD2/x, /HD3/x to access accordingly to devices |
| IDE0 (Primary Master), IDE1 (Primary Slave), |
| IDE2 (Secondary Master), IDE3 (Secondary Slave); |
| x - partition number on the selected hard drive, varies from 1 |
| to 255 (on each hard drive the indexing starts from 1) |
| Remarks: |
| * In the first two cases it is also possible to use FIRST |
| instead of 1, SECOND instead of 2, but it is not recommended |
| for convenience of transition to the future extensions. |
| * Limitation n<=39 is imposed. |
| * Names of folders and file dir1,...,dirn,file must have the |
| format 8.3: name no more than 8 characters, dot, extension no |
| more than 3 characters. Trailing spaces are ignored, no other |
| spaces is allowed. If name occupies equally 8 characters, |
| dot may be omitted (though it is not recommended to use this |
| feature for convenience of transition to the future extensions). |
| * This function does not support folders on ramdisk. |
| Examples: |
| * '/RAMDISK/FIRST/KERNEL.ASM',0 |
| '/rd/1/kernel.asm',0 |
| * '/HD0/1/kernel.asm',0 |
| * '/hd0/1/menuet/pics/tanzania.bmp',0 |
| Existing subfunctions: |
| * subfunction 0 - read file/folder |
| * subfunction 8 - LBA-read from device |
| * subfunction 15 - get file system information |
| |
| ====================================================================== |
| =========== Function 58, subfunction 0 - read file/folder. =========== |
| ====================================================================== |
| Parameters: |
| * eax = 58 |
| * ebx = pointer to the information structure |
| Format of the information structure: |
| * +0: dword: 0 = subfunction number |
| * +4: dword: first block to read (beginning from 0) |
| * +8: dword: amount of blocks to read |
| * +12 = +0xC: dword: pointer to buffer for data |
| * +16 = +0x10: dword: pointer to buffer for system operations |
| (4096 bytes) |
| * +20 = +0x14: ASCIIZ-name of file, the rules of names forming are |
| given in the general description |
| Returned value: |
| * eax = 0 - success, otherwise file system error code |
| * ebx = file size (in bytes) or -1=0xffffffff, if file was not found |
| Remarks: |
| * Block size is 512 bytes. |
| * This function is obsolete, for reading files use subfunction 0 |
| of function 70, for reading folders - subfunction 1 of |
| function 70. |
| * Function can read contents of a folder. Only FAT file system is |
| supported. The format of FAT-folder is described |
| in any FAT documentation. |
| * Size of a folder is determined by size of FAT clusters chain. |
| * If file was ended before last requested block was read, |
| the function will read as many as it can, and after that return |
| eax=6 (EOF). |
| * Function can read root folders /rd/1,/fd/x,/hd[n]/x, but |
| in the first two cases the current implementation does not follow |
| to the declared rules: |
| for /rd/1: |
| * if one want to read 0 blocks, function considers, |
| that he requested 1; |
| * if one requests more than 14 blocks or starting block is |
| not less than 14, function returns eax=5 (not found) and ebx=-1; |
| * size of ramdisk root folder is 14 blocks, |
| 0x1C00=7168 bytes; but function returns ebx=0 |
| (except of the case of previous item); |
| * strangely enough, it is possible to read 14th block (which |
| generally contains a garbage - I remind, the indexing begins |
| from 0); |
| * if some block with the number not less than 14 was requested, |
| function returns eax=6(EOF); otherwise eax=0. |
| For /fd/x: |
| * if the start block is not less than 14, function returns |
| eax=5 (not found) and ebx=0; |
| * note that format of FAT12 allows floppies with the root size |
| more or less than 14 blocks; |
| * check for length is not performed; |
| * if data was successful read, function returns |
| eax=0,ebx=0; otherwise eax=10 (access denied), ebx=-1. |
| * The function handles reading of special folders /,/rd,/fd,/hd[n]; |
| but the result does not correspond to expected (on operations with |
| normal files/folders), does not follow the declared rules, |
| may be changed in future versions of the kernel and consequently |
| is not described. To obtain the information about the equipment |
| use subfunction 11 of function 18 or |
| read corresponding folder with subfunction 1 of function 70. |
| |
| ====================================================================== |
| ========= Function 58, subfunction 8 - LBA-read from device. ========= |
| ====================================================================== |
| Parameters: |
| * eax = 58 - function number |
| * ebx = pointer to the information structure |
| Format of the information structure: |
| * +0: dword: 8 = subfunction number |
| * +4: dword: number of block to read (beginning from 0) |
| * +8: dword: ignored (set to 1) |
| * +12 = +0xC: dword: pointer to buffer for data (512 bytes) |
| * +16 = +0x10: dword: pointer to buffer for system operations |
| (4096 bytes) |
| * +20 = +0x14: ASCIIZ-name of device: case-insensitive, one of |
| /rd/1 = /RamDisk/1, /hd/n = /HardDisk/n, |
| 1<=n<=4 - number of device: 1=IDE0, ..., 4=IDE3. |
| Instead of digits it is allowed, though not recommended for |
| convenience of transition to future extensions, to use |
| 'first','second','third','fourth'. |
| Returned value: |
| * for device name /hd/xxx, where xxx is not in the list above: |
| * eax = ebx = 1 |
| * for invalid device name (except for the previous case): |
| * eax = 5 |
| * ebx does not change |
| * if LBA-access is disabled by subfunction 11 of function 21: |
| * eax = 2 |
| * ebx destroyed |
| * for ramdisk: attempt to read block outside ramdisk |
| (18*2*80 blocks) results in |
| * eax = 3 |
| * ebx = 0 |
| * for successful read: |
| * eax = ebx = 0 |
| Remarks: |
| * Block size is 512 bytes; function reads one block. |
| * Do not depend on returned value, it can be changed |
| in future versions. |
| * Function requires that LBA-access to devices is enabled by |
| subfunction 11 of function 21. To check this one can use |
| subfunction 11 of function 26. |
| * LBA-read of floppy is not supported. |
| * Function reads data on physical hard drive; if for any reason |
| data of the concrete partition are required, application must |
| define starting sector of this partition (either directly |
| through MBR, or from the full structure returned by |
| subfunction 11 of function 18). |
| * Function does not check error code of hard disk, so request of |
| nonexisting sector reads something (most probably it will be |
| zeroes, but this is defined by device) and this is considered |
| as success (eax=0). |
| |
| ====================================================================== |
| ==== Function 58, subfunction 15 - get information on file system. === |
| ====================================================================== |
| Parameters: |
| * eax = 58 - function number |
| * ebx = pointer to the information structure |
| Format of the information structure: |
| * +0: dword: 15 = subfunction number |
| * +4: dword: ignored |
| * +8: dword: ignored |
| * +12 = +0xC: dword: ignored |
| * +16 = +0x10: dword: ignored |
| * +20 = +0x14: (only second character is checked) |
| /rd=/RAMDISK or /hd=/HARDDISK |
| Returned value: |
| * if the second character does not belong to set {'r','R','h','H'}: |
| * eax = 3 |
| * ebx = ecx = dword [fileinfo] = 0 |
| * for ramdisk: |
| * eax = 0 (success) |
| * ebx = total number of clusters = 2847 |
| * ecx = number of free clusters |
| * dword [fileinfo] = cluster size = 512 |
| * for hard disk: base and partition are defined by subfunctions |
| 7 and 8 of function 21: |
| * eax = 0 (success) |
| * ebx = total number of clusters |
| * ecx = number of free clusters |
| * dword [fileinfo] = cluster size (in bytes) |
| Remarks: |
| * Be not surprised to strange layout of 4th returned parameter |
| - when this code was writing, at system calls application got |
| only registers eax,ebx,ecx (from pushad-structure transmitted |
| as argument to the system function). Now it is corrected, so, |
| probably, it is meaningful to return cluster size in edx, while |
| this function is not used yet. |
| * There exists also subfunction 11 of function 18, |
| which returns information on file system. From the full table |
| of disk subsystem it is possible to deduce cluster size (there |
| it is stored in sectors) and total number of clusters |
| for hard disks. |
| |
| ====================================================================== |
| ========== Function 60 - Inter Process Communication (IPC). ========== |
| ====================================================================== |
| IPC is used for message dispatching from one process/thread to |
| 4502,13 → 4032,7 |
|---|
| Returned value: |
| * eax = socketnum1, -1 on error |
| * ebx = socketnum2, errorcode on error |
| Remarks: |
| |
| Optstruct: dd level |
| dd optionname |
| dd optlength |
| db options... |
| |
| ====================================================================== |
| =============== Function -1 - terminate thread/process =============== |
| ====================================================================== |