MFSH SETBOOTDRIVE: Difference between revisions
Created page with "{{DISPLAYTITLE:MFSH_SETBOOTDRIVE}} Change boot drive number kept by the kernel to allow a change in the assignment of boot drive as seen by later processes. ==Syntax== int ..." |
|||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:MFSH_SETBOOTDRIVE}} | {{DISPLAYTITLE:MFSH_SETBOOTDRIVE}} | ||
Change boot drive number kept by the kernel to allow a change in the assignment of boot drive as seen by later processes. | Change boot drive number kept by the kernel to allow a change in the assignment of boot drive as seen by later processes. | ||
==Syntax== | ==Syntax== | ||
int far pascal MFSH_SETBOOTDRIVE(usDrive) | int far pascal MFSH_SETBOOTDRIVE(usDrive) | ||
==Parameters== | ==Parameters== | ||
; usDrive : contains the 0-based drive number that the mini-FSD wants the system to consider as the boot drive. | ;usDrive: contains the 0-based drive number that the mini-FSD wants the system to consider as the boot drive. | ||
==Returns== | ==Returns== | ||
If no error is detected, a zero error code is returned. If an error is detected, on of the following error codes is returned: | If no error is detected, a zero error code is returned. If an error is detected, on of the following error codes is returned: | ||
; ERROR_INVALID_PARAMETER: the supplied drive number is invalid | ;ERROR_INVALID_PARAMETER: the supplied drive number is invalid | ||
==Sample== | ==Sample== | ||
unsigned short usDrive; | unsigned short usDrive; | ||
int far pascal MFSH_SETBOOTDRIVE(usDrive) | int far pascal MFSH_SETBOOTDRIVE(usDrive) | ||
==Remarks== | ==Remarks== | ||
This call changes the boot drive number that is kept in the global info segment of the system. Valid values range from 2 (=C) to 25 (=Z). This function must be called during the call to MFS_INIT to update the info segment correctly. This is routine should be used by RIPL mini-FSDs. | This call changes the boot drive number that is kept in the global info segment of the system. Valid values range from 2 (=C) to 25 (=Z). This function must be called during the call to MFS_INIT to update the info segment correctly. This is routine should be used by RIPL mini-FSDs. | ||
[[Category:IFS]] | [[Category:IFS Interfaces]] | ||
Latest revision as of 21:36, 20 November 2019
Change boot drive number kept by the kernel to allow a change in the assignment of boot drive as seen by later processes.
Syntax
int far pascal MFSH_SETBOOTDRIVE(usDrive)
Parameters
- usDrive
- contains the 0-based drive number that the mini-FSD wants the system to consider as the boot drive.
Returns
If no error is detected, a zero error code is returned. If an error is detected, on of the following error codes is returned:
- ERROR_INVALID_PARAMETER
- the supplied drive number is invalid
Sample
unsigned short usDrive; int far pascal MFSH_SETBOOTDRIVE(usDrive)
Remarks
This call changes the boot drive number that is kept in the global info segment of the system. Valid values range from 2 (=C) to 25 (=Z). This function must be called during the call to MFS_INIT to update the info segment correctly. This is routine should be used by RIPL mini-FSDs.