MFSH DOVOLIO: Difference between revisions
Created page with "{{DISPLAYTITLE:MFSH_DOVOLIO}} Read the specified sectors. ==Syntax== int far pascal MFSH_DOVOLIO(pcData, pcSec, ulSec) ==Parameters== ; pcData: is a pointer to the data area..." |
mNo edit summary |
||
| Line 5: | Line 5: | ||
==Parameters== | ==Parameters== | ||
; pcData: is a pointer to the data area. The data area must be below the 1- Meg boundary. | ;pcData: is a pointer to the data area. The data area must be below the 1-Meg boundary. | ||
; pcSec : is a pointer to the word which specifies the number of sectors to be read. On return, it is filled in by the helper with the number of sectors successfully read. | ;pcSec : is a pointer to the word which specifies the number of sectors to be read. On return, it is filled in by the helper with the number of sectors successfully read. | ||
; ulSec : is the sector number for the beginning of the sector run. | ;ulSec : is the sector number for the beginning of the sector run. | ||
==Returns== | ==Returns== | ||
If no error is detected, a zero error code is returned. | If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned: | ||
;ERROR_PROTECTION_VIOLATION: the supplied address or length is invalid. | |||
; ERROR_PROTECTION_VIOLATION: the supplied address or length is invalid. | ;ERROR_INVALID_FUNCTION: either bit 0 of the boot mode flags was set on entry to OS2LDR or the system is not in stage 1. | ||
;ERROR_INVALID_FUNCTION: either bit 0 of the boot mode flags was set on entry to OS2LDR or the system is not in stage 1. | |||
==Sample== | ==Sample== | ||
| Line 19: | Line 18: | ||
unsigned short far * pcSec; | unsigned short far * pcSec; | ||
unsigned long ulSec; | unsigned long ulSec; | ||
int far pascal MFSH_DOVOLIO(pcData, pcSec, ulSec) | |||
==Remarks== | ==Remarks== | ||
The only media which can be read by this call is the boot volume. The machine's interrupt 13H BIOS function is used to actually do the disk reads. The data area will be locked and unlocked by this helper. Soft errors are retried automatically. Hard errors are reported to the user through a message and the system is stopped. | The only media which can be read by this call is the boot volume. The machine's interrupt 13H BIOS function is used to actually do the disk reads. The data area will be locked and unlocked by this helper. Soft errors are retried automatically. Hard errors are reported to the user through a message and the system is stopped. | ||
Revision as of 20:42, 21 May 2019
Read the specified sectors.
Syntax
int far pascal MFSH_DOVOLIO(pcData, pcSec, ulSec)
Parameters
- pcData
- is a pointer to the data area. The data area must be below the 1-Meg boundary.
- pcSec
- is a pointer to the word which specifies the number of sectors to be read. On return, it is filled in by the helper with the number of sectors successfully read.
- ulSec
- is the sector number for the beginning of the sector run.
Returns
If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned:
- ERROR_PROTECTION_VIOLATION
- the supplied address or length is invalid.
- ERROR_INVALID_FUNCTION
- either bit 0 of the boot mode flags was set on entry to OS2LDR or the system is not in stage 1.
Sample
char far * pcData; unsigned short far * pcSec; unsigned long ulSec; int far pascal MFSH_DOVOLIO(pcData, pcSec, ulSec)
Remarks
The only media which can be read by this call is the boot volume. The machine's interrupt 13H BIOS function is used to actually do the disk reads. The data area will be locked and unlocked by this helper. Soft errors are retried automatically. Hard errors are reported to the user through a message and the system is stopped.