MFS_INIT - mini-FSD Initialization
Inform the mini-FSD that it should prepare itself for use.
int far pascal MFS_INIT(pBootData, pucResDrives, pulVectorIPL, pBPB, pMiniFSD,
void far * pBootData;
char far * pucResDrives;
long far * pulVectorIPL;
void far * pBPB;
unsigned long far * pMiniFSD;
unsigned long far * pDumpAddr;
pBootData is a pointer to the data passed from the black box to the
mini-FSD (null if not passed).
pucResDrives is a pointer to a byte which may be filled in by the mini-FSD
with the number of drive letters (beginning with 'C') to skip over before
assigning drive letters to local fixed disk drivers (ignored if not remote
IPL). The system will attach the reserved drives to the mini-FSD through a
call to FS_ATTACH just after the call to FS_INIT.
pulVectorIPL is a pointer to a double word which may be filled in by the
mini -FSD with a pointer to a data structure which will be available to
installable device drivers through the standard device helper function
GetDosVar (variable number 12). The first eight bytes of the structure
MUST be a signature which would allow unique identification of the data by
cooperating device drivers (for example, IBMPCNET).
BPB is a pointer to the BPB data structure (see OS2LDR interface).
pMiniFSD is a pointer to a double word which is filled in by the mini-FSD
with data to be passed on to the FSD.
DumpRoutine is a pointer to a double word which is filled in by the
mini-FSD with the address of an alternative stand-alone dump procedure.
If no error is detected, a zero error code is returned. If an error is
detected, a non-zero error code is returned.
The mini-FSD should fill in the data pointed to by pMiniFSD with any
32-bit value it wishes to pass on to the FSD (see FS_INIT). OS/2 makes no
assumptions about the type of data passed. Typically, this will be a
pointer to important data structures within the mini-FSD which the FSD
needs to know about.
OS/2 will not free the segment containing BootData. It should be freed by
the mini-FSD if appropriate.
The DumpProcedure is a routine provided by the mini-FSD which replaces the
diskette-based OS/2 stand-alone dump procedure. This routine is given
control after the OS/2 kernel receives a stand-alone dump request. The
OS/2 kernel places the machine in a stable, real mode state in which most
interrupt vectors contain their original power-up value. If this address
is left at zero, the OS/2 kernel will attempt to initiate a storage dump
to diskette, if a diskette drive exists. The provided routine must handle
the dumping of storage to an acceptable media.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs