# FS_Init

## 構文

  `#include <nitro/fs.h>`
  `void FS_Init( u32 default_dma_no );`

## 引数

default_dma_no | ファイルシステム内部のROM アーカイブが使用するDMAチャンネル 設定内容はFSライブラリ内部で呼び出される`CARD_ReadRomAsync()` の引数としてそのまま使用されます。 有効なDMAチャンネルを指定した場合、`FS_SetDefaultDMA()` で設定を変更するまでこのDMAチャンネルを使用できません。 また、カードアクセスの転送元はIOレジスタなのでDMAチャンネル0を指定することはできません。

## 返り値

なし。

## 説明

ROM ファイルシステムを初期化します。
以下の処理を行います。

- `CARD_Init()`の呼び出しによるCARDライブラリ初期化
- カレントディレクトリをROM アーカイブのルート ("rom:/") に設定
- ROM アーカイブが使用するDMAチャンネルの初期化

ROM アーカイブにDMAチャンネルを割り当てる場合の内部動作については、 `CARD_ReadRomAsync()`の説明も参照ください。

## 注意

この関数で有効なDMAチャンネルを指定した場合、`FS_SetDefaultDMA()`で設定を変更するまでこのDMAチャンネルを使用できません。
FSライブラリはこのDMAチャンネルを使用してカード上のROMファイルシステムへアクセスします。
`CARD_ReadRom()`および`CARD_ReadRomAsync()`の説明も参照ください。

## 参照

`FS_DMA_NOT_USE FS_IsAvailable FS_SetDefaultDMA CARD_ReadRom CARD_ReadRomAsync`

## 履歴

2008/01/24 DMAチャンネルに関する説明を若干修正
2005/08/28 説明文に`CARD_ReadRomAsync()`へのリンクを追加
2005/04/28 DMAチャンネル0が指定できない旨を追記
2005/04/11 `CARD_Init()`を呼び出す旨の説明を追加
2004/09/24 リンク修正
2004/07/23 ROMアーカイブとDMAチャンネルに関する注意を追加
2004/05/14 FS_DMA_NOT_USEについての記述を追加
2004/04/13 `FS_IsAvailable()`への参照を追加
2004/04/08 DMA番号指定の追加による記述修正
2004/04/02 ファイルシステム → ROM ファイルシステム
2004/04/01 初版