DIZero

Prepare formatted disk to receive files

#include <DiskInit.h> Disk Initialization Package

OSErr DIZero(drvNum, volName );

short drvNum ; drive to prepare (1=internal floppy)

Str255 volName ; address of p-string containing volume name

returns Error Code; 0=no error

DIZero writes the volume information ( including the volume name), a block

map, and an empty directory onto a specified disk. It then attempts to mount the

volume.

drvNum identifies which drive contains the disk to verify. Historically,

1=internal, 2=external, and numbers higher than 3 are hard disks.

See GetDrvQHdr for a way to get a list of "hard" drive numbers.

Returns: an operating system Error Code. It will be one of:

noErr (0) No error

badMDBErr (-60) Bad master directory block

extFSErr (-58) External file system

ioErr (-36) I/O error

memFulErr (-108) Not enough room in heap

noMacDskErr (-57) Not a Mac diskette (bad signature bytes)

nsDrvErr (-56) No such drive

paramErr (-50) Error in user parameter list

volOnLinErr (-55) Drive volume already on-line at MountVol

firstDskErr (-84) ... through ...

lastDskErr (-64) (low-level disk errors)

Notes: DIZero destroys all existing information on a disk. Use it with extreme

caution.

This function is performed automatically by DIBadMount as the final step

in initializing a disk. It would be unusual to need this in an application

program.

Referenced by (5):