# FS_OpenTopLevelDirectory

## 構文

    #include <nitro/fs.h>

    BOOL FS_OpenTopLevelDirectory(FSFile *dir);

## 引数

dir | ハンドルを格納すべきFSFile構造体

## 返り値

この関数は常に成功してTRUEを返します。

## 説明

使用可能なアーカイブ名を列挙できる特殊な最上位ディレクトリを開きます。
この関数で取得したディレクトリハンドルに対して`FS_ReadDirectory( )`を呼び出すと、 プログラムに現在マウントされているアーカイブ名が"rom:"のようなコロン付きの文字列としてひとつずつ返されます。

## 注意

- この関数を割り込みハンドラ(IRQモード)から呼び出すことはできません。
  また、割り込みを禁止したままの状態にあると処理が完了しない場合がある点に注意して下さい。
- 開いたファイルの構造体はシステムリソースに関連付けられるため、 別の構造体にそのままコピーしても情報の移動や複製はできません。 詳細は`FSFile構造体`をご参照ください。

## 参照

`FSFile
FS_ReadDirectory FS_CloseDirectory`

## 履歴

2009/07/29 構造体の値コピーが無保証である旨を追記
2008/12/04 初版