a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 hdwrench.library
  FindControllerID
  FindDefaults
  FindDiskName
  FindLastSector
  HDWCloseDevice
  HDWOpenDevice
  InMemMountfile
  InMemRDBStructs
  LowlevelFormat
  OutMemMountfile
  OutMemRDBStructs
  QueryCapacity
  QueryFindValid
  QueryInquiry
  QueryModeSense
  QueryReady
  RawRead
  RawWrite
  ReadMountfile
  ReadRDBStructs
  ReadRDBs
  VerifyDrive
  WriteBlock
  WriteMountfile
  WriteRDBStructs
  WriteRDBs
  ZZexample
  description
Include
GuruMeditation
Docs » Autodocs » hdwrench.library » LowlevelFormat

NAME

    LowlevelFormat

SYNOPSIS

    error = LowlevelFormat (  CallBack )
    D0                           A0
    ULONG LowlevelFormat (  long ( *CallBack)( HDWCallbackMsg *msg ))

FUNCTION

   	Format the currently opened drive.

INPUTS

   	CallBack	A function to accept a HDWCallbackMsg and interact with the
   				user.

RESULT

	error    per rw_success_val in hdwrench.h
	If CallBack is NULL it returns the value no_callback_hook.
	If no device is open it returns the value io_device_not_open.
	If the user confirms the format drive callback request via CallBack
		if the selected	device is the system drive
			return opration_not_permitted.
		else
		if the selected device is mounted
			if the user requests abort via CallBack
				return user_aborted
			endif
		endif
		if format is successful
			inform the user of success via CallBack
			return success
		else
			inform the user of the sad event via CallBack
			return io_command_failure
		endif
	else
		inform the user his drive is safe via CallBack
		return user_aborted
	endif

BUGS

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Fairlight

SPB
PDX
FLT
DC

Comments:
$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se