Difference between revisions of "83Plus:Software:usb8x/Asm Interface/MSD/DOS getDirEntry"

From WikiTI
Jump to: navigation, search
 
m
Line 4: Line 4:
 
'''Minimum usb8x version:''' 0.10
 
'''Minimum usb8x version:''' 0.10
  
Gets directory entry for a specified file/folder.
+
Gets directory entry for a specified file/folder. A directory entry is useful for certain functions such as [[..DOS_getFileSize|DOS_getFileSize]].
  
 
=== Inputs ===
 
=== Inputs ===

Revision as of 12:08, 17 August 2006

Synopsis

Name: DOS_getDirEntry

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.

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:

ld hl,sDirectory
U_CALL FAT_getStartingCluster
ld bc,-1
U_CALL DOS_getDirEntry
...
sDirectory: DB "/",0

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