https://wikiti.brandonw.net/index.php?action=history&feed=atom&title=83Plus%3ASoftware%3Ausb8x%2FAsm_Interface%2FMSD%2FFAT_getStartingCluster83Plus:Software:usb8x/Asm Interface/MSD/FAT getStartingCluster - Revision history2026-04-08T11:47:15ZRevision history for this page on the wikiMediaWiki 1.23.5https://wikiti.brandonw.net/index.php?title=83Plus:Software:usb8x/Asm_Interface/MSD/FAT_getStartingCluster&diff=5063&oldid=prevBrandonw at 08:53, 17 August 20062006-08-17T08:53:47Z<p></p>
<p><b>New page</b></p><div>== Synopsis ==<br />
'''Name:''' FAT_getStartingCluster<br />
<br />
'''Minimum usb8x version:''' 0.10<br />
<br />
Gets the starting cluster of a directory. It is a necessary input for some routines.<br />
<br />
=== Inputs ===<br />
* HL points to an ASCIIZ string of the directory path<br />
<br />
=== Outputs ===<br />
* HL is the starting cluster of this directory<br />
* C set if problems<br />
<br />
=== Destroys ===<br />
* AF, BC, DE, HL<br />
<br />
== Notes ==<br />
"Starting cluster" is a FAT16 term to represent a directory, but it is used in some routines because it is a much smaller alternative to keeping a large ASCIIZ string of a directory path.<br />
The root directory will always have 0000h as its starting cluster.<br />
Here is example code to get the starting cluster of the "test" directory:<br />
<code><br />
ld hl,sDir<br />
U_CALL FAT_getStartingCluster<br />
;HL is starting cluster (ex. 0002h)<br />
...<br />
sDir: DB "/test",0<br />
</code><br />
If you are writing an application, you must copy the strings you use to RAM first, or else usb8x will not be able to see them.</div>Brandonw