NOT FINALIZED!

The functions in this section exist to support new features of PicoDOS 2.0 and should be considered experimental. Even with the woefully inadequate documentation that currently exists, these may be useful to more complex applications. Be warned that unlike the finalized BIOS and PicoDOS functions, these functions are subject to much change, and you should not use them if you are not prepared to recode your projects as the functions mature.

Quick Reference Table

DBRCalcFATType	DBRDisplayBootRecord
DBRFormat	DBRGetBootParamBlock
DBRGetFatDirDatSectors	DBRPackParamBlock
DBRUnpackParamBlock

enum
    {
      dbrErrorStart = DBR_ERRORS
    , dbrInvalidDOSBootRecord   // not a valid DOS boot sector
    };

DBRGetBootParamBlock -- Get the raw packed parameter block

Description

   

      

         
Prototype:
      
      

         
short
         DBRGetBootParamBlock(short
         logdrv, struct DPBPB *dpbpb);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
logdrv XXXXX

         dpbpb XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

DBRUnpackParamBlock -- Unpack and endian translate a raw parameter block

Description

   

      

         
Prototype:
      
      

         
void
         DBRUnpackParamBlock(struct
         DWBPB *dwbpb, struct DPBPB *dpbpb);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
dpbpb XXXXX

         dwbpb XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

DBRPackParamBlock -- Pack and endian translate a working parameter block

Description

   

      

         
Prototype:
      
      

         
void nnn(struct DPBPB
         *dpbpb, struct DWBPB *dwbpb);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
dpbpb XXXXX

         dwbpb XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

DBRFormat -- Format the DSD drive

Description

   

      

         
Prototype:
      
      

         
short DBRFormat(short
         logdrv);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
logdrv XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

DBRGetFatDirDatSectors -- Fetch the DSD drive starting sectors for the FATs, DIR, and data sectors

Description

   

      

         
Prototype:
      
      

         
short nnn(short logdrv,
         ulong *fatFirst, ulong *dirFirst, ulong *dataFirst, ulong
         *dataLast);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
logdrv XXXXX

         fatFirst XXXXX

         dirFirst XXXXX

         dataFirst XXXXX

         dataLast XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

DBRCalcFATType -- Calculate FAT Type for partitions

Description

   

      

         
Prototype:
      
      

         
short DBRCalcFATType (ulong
         sectors, short nfats, short rsrvdsects);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
sectors XXXXX

         nfats XXXXX

         rsrvdsects XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

DBRDisplayBootRecord -- Display the DOS Boot Record information

Description

   

      

         
Prototype:
      
      

         
void DBRDisplayBootRecord
         (short logdrv);
      
   
   

      

         
Definition:
      
      

         
#include <cf1pico.h>
      
   
   

      

         
Inputs:
      
      

         
logdrv XXXXX
      
   
   

      

         
Returns:
      
      

         
XXXXX
      
   
   

      

         
Notes:
      
      

         
XXXXX
      
   
   

      

         
Timing:
      
      

         
TBD
      
   

Previous

Next

Top

Contents

Glossary

Index

Tel: 508-759-6434		Fax: 508-759-6436
Copyright (C) 1998 Persistor Instruments Inc. - All Rights Reserved