\r
<body>\r
<h1>ファイル関数の戻り値</h1>\r
-<p>FatFsのAPIでは、一部の関数を除き結果に応じた共通のリザルト コード(FRESULT型(enum))を返します。関数が成功した場合は0を返します。失敗した場合は0以外の値を返し、値はエラーの種類を示します。</p>\r
+<p>FatFsのAPIでは、一部の関数を除き結果に応じた共通のリザルト コード(FRESULT型(enum))を返します。関数が成功した場合は0 (<tt>FR_OK</tt>)を返します。失敗した場合は0以外の値を返し、値はエラーの種類を示します。</p>\r
\r
<dl class="ret">\r
<dt id="ok">FR_OK (0)</dt>\r
<dd>関数は成功した。</dd>\r
<dt id="de">FR_DISK_ERR</dt>\r
-<dd>下位レイヤ(<tt>disk_read(), disk_write(), disk_ioctl()</tt>関数)で回復不能なエラーが発生した。<br>※開かれたファイルの操作においてこのエラーが発生すると、そのファイル オブジェクトはアボート状態となり、クローズ以外のの操作ができなくなります。</dd>\r
+<dd>下位レイヤ(<tt>disk_read/disk_write/disk_ioctl</tt>関数)で回復不能なエラーが発生した。<br>※開かれたファイルの操作においてこのエラーが発生すると、そのファイル オブジェクトはアボート状態となり、クローズ以外の操作ができなくなります。</dd>\r
<dt id="ie">FR_INT_ERR</dt>\r
-<dd>å\86\85é\83¨å\87¦ç\90\86ã\81®å\81¥å\85¨æ\80§ã\81«異常が検出された。原因としては次のようなことが考えられます。\r
+<dd>å\86\85é\83¨å\87¦ç\90\86ã\81®å\81¥å\85¨æ\80§ã\83\81ã\82§ã\83\83ã\82¯ã\81§ä½\95ã\82\89ã\81\8bã\81®異常が検出された。原因としては次のようなことが考えられます。\r
<ul>\r
-<li>ボリューム上のFAT構造にエラーがある。</li>\r
<li>スタック不足や不正なメモリ操作等によるワーク エリアの破壊。多くはこれが原因。</li>\r
+<li>ボリューム上のFAT構造にエラーがある。</li>\r
+<li>FatFsモジュール自体のバグ。</li>\r
</ul>\r
※開かれたファイルの操作においてこのエラーが発生すると、そのファイル オブジェクトはアボート状態となり、クローズ以外の操作ができなくなります。</dd>\r
<dt id="nr">FR_NOT_READY</dt>\r
-<dd>物理ドライブが動作可能な状態にない。または、ドライブの初期化に失敗した。</dd>\r
+<dd>下位レイヤ(<tt>disk_initialize</tt>関数)の失敗。つまり、物理ドライブが動作可能な状態にない。</dd>\r
<dt id="nf">FR_NO_FILE</dt>\r
<dd>指定されたファイルが見つからなかった。</dd>\r
<dt id="np">FR_NO_PATH</dt>\r
<dd>そのオブジェクトに対する操作の拒否。原因としては次のようなことが考えられます。\r
<ul>\r
<li>書き込み禁止属性(<tt>AM_RDO</tt>)を持つファイルを書き込みモードで開こうとした。</li>\r
-<li>æ\9b¸ã\81\8dè¾¼ã\81¿ç¦\81æ¢å±\9eæ\80§ã\82\92æ\8c\81ã\81¤ã\83\95ã\82¡ã\82¤ã\83«ã\82\84ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ªを削除しようとした。</li>\r
+<li>æ\9b¸ã\81\8dè¾¼ã\81¿ç¦\81æ¢å±\9eæ\80§ã\82\92æ\8c\81ã\81¤ã\82ªã\83\96ã\82¸ã\82§ã\82¯ã\83\88を削除しようとした。</li>\r
<li>空でないディレクトリまたはカレント ディレクトリを削除しようとした。</li>\r
<li><tt>FA_READ</tt>フラグを付けずに開いたファイルに対して読み出しを行った。</li>\r
-<li><tt>FA_WRITE</tt>フラグを付けずに開いたファイルに対して書き込みまたはそれに類する操作を行った。</li>\r
-<li>ボリュームまたはディレクトリ テーブルが満杯でファイルやディレクトリを作成できなかった。</li>\r
+<li><tt>FA_WRITE</tt>フラグを付けずに開いたファイルに対して変更を加えようとした。</li>\r
+<li>ボリュームまたは静的ディレクトリ(FAT12/16のルート)が満杯でディレクトリ エントリの新規作成ができなかった。</li>\r
+<li>ファイルに割り当てる連続領域が見つからなかった。</li>\r
</ul>\r
</dd>\r
<dt id="ex">FR_EXIST</dt>\r
<dd>新しく作成しようとしたオブジェクトと同じ名前のオブジェクトが既に存在する。</dd>\r
<dt id="io">FR_INVALID_OBJECT</dt>\r
-<dd>指定されたファイル オブジェクトやディレクトリ オブジェクトが無効(オープンされていない、既に閉じられた、破損しているなど)、またはヌル ポインタが渡された。また、開かれたままのオブジェクトは、それの属するボリュームのマウント動作により無効となります。</dd>\r
+<dd>指定されたファイル オブジェクトやディレクトリ オブジェクトが無効、またはヌル ポインタが渡された。無効になる理由は次のことが考えられます。\r
+<ul>\r
+<li>オープンされていない、既に閉じられた、破損しているなど。</li>\r
+<li>そのボリュームでマウント動作があり、ボリューム上の開かれたオブジェクトが全て無効化された。</li>\r
+<li>物理ドライブがメディアの取り外しで動作不可能になっている。</li>\r
+</ul>\r
+</dd>\r
<dt id="wp">FR_WRITE_PROTECTED</dt>\r
<dd>物理ドライブが書き込み禁止状態のとき、書き込みを伴う操作を行おうとした。</dd>\r
<dt id="id">FR_INVALID_DRIVE</dt>\r
-<dd>パス名中に指定されたドライブ番号が無効、またはパス名にヌル ポインタが渡された。(関連オプション: <tt>_VOLUMES</tt>)</dd>\r
+<dd>パス名中に指定されたドライブ番号が無効、またはパス名にヌル ポインタが渡された。(関連オプション: <tt><a href="config.html#volumes">_VOLUMES</a></tt>)</dd>\r
<dt id="ne">FR_NOT_ENABLED</dt>\r
<dd>そのボリュームの操作に必要なワーク エリア(ファイル システム オブジェクト構造体)が与えられていない。</dd>\r
<dt id="ns">FR_NO_FILESYSTEM</dt>\r
<dd>物理ドライブ上に有効なFATボリュームが見つからなかった。</dd>\r
<dt id="ma">FR_MKFS_ABORTED</dt>\r
-<dd><tt>f_mkfs()</tt>の処理が開始前に中断された。原因としては次のようなことが考えられます。\r
+<dd><tt>f_mkfs</tt>関数の処理が開始前に中断された。原因としては次のようなことが考えられます。\r
<ul>\r
-<li>ボリュームが小さすぎる。</li>\r
-<li>FATタイプの計算に矛盾が見つかった。クラスタ数がFATタイプの境界付近になるときに発生する場合があります。</li>\r
-<li>その論理ドライブに対応する区画が見つからなかった。(関連オプション: <tt>_MULTI_PARTITION</tt>)</li>\r
+<li>指定されたパラメータでのフォーマットが不可能。</li>\r
+<li>ボリュームのサイズが小さすぎる。</li>\r
+<li>与えられたワークエリアが小さすぎる。</li>\r
+<li>その論理ドライブに対応する区画が見つからなかった。(関連オプション: <tt><a href="config.html#multi_partition">_MULTI_PARTITION</a></tt>)</li>\r
</ul>\r
</dd>\r
<dt id="tm">FR_TIMEOUT</dt>\r
-<dd><a href="appnote.html#reentrant">再入制御</a>による待ち時間が定義された時間を越えたため、関数は実行されなかった。(関連オプション: <tt>_TIMEOUT</tt>)</dd>\r
+<dd><a href="appnote.html#reentrant">再入制御</a>による待ち時間が定義された時間を越えたため、関数は実行されなかった。(関連オプション: <tt><a href="config.html#timeout">_TIMEOUT</a></tt>)</dd>\r
<dt id="lo">FR_LOCKED</dt>\r
-<dd><a href="appnote.html#dup">多重アクセス排他機能</a>により、そのファイルやディレクトリに対して行おうとしたアクセスが拒否された。(関連オプション: <tt>_FS_LOCK</tt>)</dd>\r
+<dd><a href="appnote.html#dup">多重アクセス排他機能</a>により、そのファイルやディレクトリに対して行おうとしたアクセスが拒否された。(関連オプション: <tt><a href="config.html#fs_lock">_FS_LOCK</a></tt>)</dd>\r
<dt id="nc">FR_NOT_ENOUGH_CORE</dt>\r
<dd>メモリ不足による失敗。原因としては次のようなことが考えられます。\r
<ul>\r
-<li>LFN操作バッファの動的確保に失敗した。(関連オプション: <tt>_USE_LFN</tt>)</li>\r
+<li>LFN操作バッファの動的確保に失敗した。(関連オプション: <tt><a href="config.html#use_lfn">_USE_LFN</a></tt>)</li>\r
<li>与えられた配列のサイズが実際に必要なサイズに対して不足している。</li>\r
</ul>\r
</dd>\r
<dt id="tf">FR_TOO_MANY_OPEN_FILES</dt>\r
-<dd>同時オープン可能なファイル数を越えてファイルを開こうとした。(関連オプション: <tt>_FS_LOCK</tt>)</dd>\r
+<dd>同時オープン可能なファイル数を越えてファイルを開こうとした。(関連オプション: <tt><a href="config.html#fs_lock">_FS_LOCK</a></tt>)</dd>\r
<dt id="ip">FR_INVALID_PARAMETER</dt>\r
<dd>与えられたパラメータが無効または矛盾している。</dd>\r
</dl>\r
\r
+<p class="foot"><a href="../00index_j.html">戻る</a></p>\r
</body>\r
</html>\r
projects / z180-stamp.git / blobdiff