Disk Resource - Revision history

Alexandre Balaban: Categorizing

2012-07-12T22:05:15Z

Categorizing

← Older revision		Revision as of 22:05, 12 July 2012
Line 1:		Line 1:
			{{NeedUpdate}}
	The Disk resource obtains exclusive access to the floppy disk hardware There are four disk/MFM units available, units 0–3.		The Disk resource obtains exclusive access to the floppy disk hardware There are four disk/MFM units available, units 0–3.

Line 44:		Line 45:
	\|resources/disk.i		\|resources/disk.i
	\|-		\|-
	\|AutoDocs\|\|disk.doc		\|AutoDocs\|\|[[disk.doc]]
	\|}		\|}

Alexandre Balaban: Changed layout for Resource Information source

2012-07-12T22:02:56Z

Changed layout for Resource Information source

← Older revision		Revision as of 22:02, 12 July 2012
Line 37:		Line 37:
	Additional programming information on the disk resource can be found in the include files and the Autodocs for the disk resource.		Additional programming information on the disk resource can be found in the include files and the Autodocs for the disk resource.

			{\| class="wikitable"
	~~'''~~Disk Resource Information~~'''<br />~~		!colspan="2"\|Disk Resource Information
⚫	Includes ~~&~~ resources/disk.h~~<br />~~
			\|-
⚫	~~&~~ resources/disk.i~~<br />~~
		⚫	\|rowspan="2"\|Includes\|\|resources/disk.h
⚫	AutoDocs ~~&~~ disk.doc~~<br />~~
			\|-
		⚫	\|resources/disk.i
			\|-
		⚫	\|AutoDocs\|\|disk.doc
			\|}

Steven Solie at 16:37, 2 May 2012

2012-05-02T16:37:29Z

@@ Line 3: / Line 3: @@
 Six functions are available for dealing with the floppy disk hardware.
-c'''Disk Resource Functions'''<br />
+'''Disk Resource Functions'''
 The disk resource provides both a gross and a fine unit allocation scheme. AllocUnit() and FreeUnit() are used to claim a unit for long term use, and GetUnit() and GiveUnit() are used to claim a unit and the disk hardware for shorter periods.
@@ Line 24: / Line 31: @@
 <p>the unit before GetUnit(), update the current track number and CMD_START it after GiveUnit(). This option is only available under V36 and higher versions of the operating system.</p></li></ol>
 It is therefore possible to prevent the trackdisk device from using units that have not yet been mounted by successfully performing an AllocUnit() for that unit. It is also possible to starve trackdisk usage by performing a GetUnit(). The appropriate companion routine (FreeUnit() or GiveUnit()) should be called to restore the resource at the end of its use.
@@ Line 32: / Line 37: @@
 Additional programming information on the disk resource can be found in the include files and the Autodocs for the disk resource.
 Includes &amp; resources/disk.h<br />
 &amp; resources/disk.i<br />

Steven Solie: Created page with "The Disk resource obtains exclusive access to the floppy disk hardware There are four disk/MFM units available, units 0–3. Six functions are available for dealing with the ..."

2012-04-16T21:28:47Z

Created page with "The Disk resource obtains exclusive access to the floppy disk hardware There are four disk/MFM units available, units 0–3. Six functions are available for dealing with the ..."

New page

The Disk resource obtains exclusive access to the floppy disk hardware There are four disk/MFM units available, units 0–3.

Six functions are available for dealing with the floppy disk hardware.

2c'''Disk Resource Functions''' 
AllocUnit() & Allocate one of the units of the disk resource. 
FreeUnit() & Deallocate an allocated disk unit. 
GetUnit() & Allocate the disk for a driver. 
GetUnitID() & Return the drive ID of a specified drive unit. 
GiveUnit() & Free the disk. 
ReadUnitID() & Reread and return the drive ID of a specified unit. 

The disk resource provides both a gross and a fine unit allocation scheme. AllocUnit() and FreeUnit() are used to claim a unit for long term use, and GetUnit() and GiveUnit() are used to claim a unit and the disk hardware for shorter periods.

The trackdisk device uses and abides by both allocation schemes. Because a trackdisk unit is never closed for Amiga 3.5’’ drives (the file system keeps them open) the associated resource units will always be allocated for these drives. GetUnit() and GiveUnit() can still be used, however, by other applications that have not succeeded with AllocUnit().

You must not change the state of of a disk that the trackdisk device is using unless you either

<ol>
<li>force its removal before giving it up, or</li>
<li>return it to the original track (with no changes to the track), or</li>
<li>CMD_STOP
the unit before GetUnit(), update the current track number and CMD_START it after GiveUnit(). This option is only available under V36 and higher versions of the operating system.</li></ol>

ReadUnitID()

is provided to handle drives which use the unit number in a dynamic manner. Subsequent GetUnit() calls will return the value obtained by ReadUnitID().

It is therefore possible to prevent the trackdisk device from using units that have not yet been mounted by successfully performing an AllocUnit() for that unit. It is also possible to starve trackdisk usage by performing a GetUnit(). The appropriate companion routine (FreeUnit() or GiveUnit()) should be called to restore the resource at the end of its use.

Additional programming information on the disk resource can be found in the include files and the Autodocs for the disk resource.

|ll|

2c'''Disk Resource Information''' 
Includes & resources/disk.h 
& resources/disk.i 
AutoDocs & disk.doc