# FS_OpenTopLevelDirectory

## Syntax

    #include <nitro/fs.h>

    BOOL FS_OpenTopLevelDirectory(FSFile *dir);

## Arguments

`dir` | The `FSFile` structure where the handle is stored.

## Return Values

This function always succeeds and returns TRUE.

## Description

Opens the top-level directory that contains a list of the usable archive names.
If you call the `FS_ReadDirectory` function for the directory handler retrieved with this function, the archives that are currently mounted into the program are returned one at a time. The name of the mounted archive has a colon appended (for example, rom:).

## Notes

- This function cannot be called from the interrupt handler (IRQ mode). Also note that in some cases processing may not end if interrupts are disabled.

## See Also

`FSFile
FS_ReadDirectory
FS_CloseDirectory`

## Revision History

2008/12/04 Initial version.

CONFIDENTIAL