83Plus:Software:usb8x/Asm Interface/MSD/DOS getDirEntry - Revision history

Brandonw: Typo and clarification

2006-09-25T21:52:59Z

Typo and clarification

Brandonw: Broken DOS_getFileSize link

2006-09-12T00:30:03Z

Broken DOS_getFileSize link

Brandonw at 19:08, 17 August 2006

2006-08-17T19:08:27Z

Brandonw at 19:07, 17 August 2006

2006-08-17T19:07:17Z

New page

== Synopsis ==
'''Name:''' DOS_getDirEntry

'''Minimum usb8x version:''' 0.10

Gets directory entry for a specified file/folder.

=== Inputs ===
* HL is the stating cluster of a directory (obtained with [[../FAT_getStartingCluster|FAT_getStartingCluster]])
* BC is the entry number of a file

=== Outputs ===
* HL points to the directory entry of the file/directory
* C set if problems

=== Destroys ===
* AF, BC, DE, HL

== Notes ==
This works with both file and folder names. It also works especially well with DOS_getNextFile. This function is useful if you need to get the directory entry for a file just found with [[../DOS_getNextFile|DOS_getNextFile]].
Example code to get directory entry for first file in the root directory:
<code>
ld hl,sDirectory
U_CALL FAT_getStartingCluster
ld bc,-1
U_CALL DOS_getDirEntry
...
sDirectory: DB "/",0
</code>
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.

== See Also ==
* [[../FAT_lookupPath|FAT_lookupPath]] - Find whether specified file/directory exists
* [[../DOS_getNextFile|DOS_getNextFile]] - Get first/next file in a specified directory

@@ Line 4: / Line 4: @@
 '''Minimum usb8x version:''' 0.10
-Gets directory entry for a specified file/folder. A directory entry is useful for certain functions such as [[..DOS_getFileSize|DOS_getFileSize]].
+Gets directory entry for a specified file/folder. A directory entry is useful for certain functions such as [[../DOS_getFileSize|DOS_getFileSize]].
 === Inputs ===

@@ Line 7: / Line 7: @@
 === Inputs ===
-* HL is the stating cluster of a directory (obtained with [[../FAT_getStartingCluster|FAT_getStartingCluster]])
+* HL is the starting cluster of a directory (obtained with [[../FAT_getStartingCluster|FAT_getStartingCluster]])
 * BC is the entry number of a file
@@ Line 18: / Line 18: @@
 == Notes ==
-This works with both file and folder names. It also works especially well with DOS_getNextFile. This function is useful if you need to get the directory entry for a file just found with [[../DOS_getNextFile|DOS_getNextFile]].
+The "directory entry" for a file is a 32-byte block of memory containing all the good stuff about a file/directory, such as file size, where it's located, the dates/times for various actions and other attributes. It is sometimes used as an input and output for mass storage entry points.
 Example code to get directory entry for first file in the root directory:
 <code>
   ld hl,sDirectory