[Toc][Index]

MFS_INIT - mini-FSD Initialization

  
Purpose   
Inform the mini-FSD that it should prepare itself for use. 
Calling Sequence   

int far pascal MFS_INIT(pBootData, pucResDrives, pulVectorIPL, pBPB, pMiniFSD,
                        pDumpAddr)

void far * pBootData;
char far * pucResDrives;
long far * pulVectorIPL;
void far * pBPB;
unsigned long far * pMiniFSD;
unsigned long far * pDumpAddr;


Where   
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. 
  
Returns   
If no error is detected, a zero error code is returned. If an error is 
detected, a non-zero error code is returned. 
Remarks   
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