rc.html 6.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
  2. <html lang="ja">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  5. <meta http-equiv="Content-Style-Type" content="text/css">
  6. <link rel="up" title="FatFs" href="../00index_j.html">
  7. <link rel="alternate" hreflang="en" title="English" href="../en/rc.html">
  8. <link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
  9. <title>FatFs - 戻り値</title>
  10. </head>
  11. <body>
  12. <h1>ファイル関数の戻り値</h1>
  13. <p>FatFsのAPIでは、一部の関数を除き結果に応じた共通のリザルト・コード(FRESULT型(enum))を返します。関数が成功した場合は0を返します。失敗した場合は0以外の値を返し、値はエラーの種類を示します。</p>
  14. <dl class="ret">
  15. <dt id="ok">FR_OK (0)</dt>
  16. <dd>関数は成功した。</dd>
  17. <dt id="de">FR_DISK_ERR</dt>
  18. <dd>下位レイヤ(<tt>disk_read(), disk_write(), disk_ioctl()</tt>関数)で回復不能なエラーが発生した。<br>※開かれたファイルの操作においてこのエラーが発生すると、そのファイル・オブジェクトはアボート状態となり、クローズ以外のの操作ができなくなります。</dd>
  19. <dt id="ie">FR_INT_ERR</dt>
  20. <dd>内部処理の健全性に異常が検出された。原因としては次のようなことが考えられます。
  21. <ul>
  22. <li>ボリューム上のFAT構造にエラーがある。</li>
  23. <li>スタック不足や不正なメモリ操作等によるワーク・エリアの破壊。多くはこれが原因。</li>
  24. </ul>
  25. ※開かれたファイルの操作においてこのエラーが発生すると、そのファイル・オブジェクトはアボート状態となり、クローズ以外の操作ができなくなります。</dd>
  26. <dt id="nr">FR_NOT_READY</dt>
  27. <dd>物理ドライブが動作可能な状態にない。または、ドライブの初期化に失敗した。</dd>
  28. <dt id="nf">FR_NO_FILE</dt>
  29. <dd>指定されたファイルが見つからなかった。</dd>
  30. <dt id="np">FR_NO_PATH</dt>
  31. <dd>指定されたパスが見つからなかった。</dd>
  32. <dt id="in">FR_INVALID_NAME</dt>
  33. <dd>指定された文字列が<a href="filename.html">パス名のフォーマット</a>として無効。</dd>
  34. <dt id="dn">FR_DENIED</dt>
  35. <dd>そのオブジェクトに対する操作の拒否。原因としては次のようなことが考えられます。
  36. <ul>
  37. <li>書き込み禁止属性(<tt>AM_RDO</tt>)を持つファイルを書き込みモードで開こうとした。</li>
  38. <li>書き込み禁止属性を持つファイルやディレクトリを削除しようとした。</li>
  39. <li>空でないディレクトリまたはカレント・ディレクトリを削除しようとした。</li>
  40. <li><tt>FA_READ</tt>フラグを付けずに開いたファイルに対して読み出しを行った。</li>
  41. <li><tt>FA_WRITE</tt>フラグを付けずに開いたファイルに対して書き込みまたはそれに類する操作を行った。</li>
  42. <li>ボリュームまたはディレクトリ・テーブルが満杯でファイルやディレクトリを作成できなかった。</li>
  43. </ul>
  44. </dd>
  45. <dt id="ex">FR_EXIST</dt>
  46. <dd>新しく作成しようとしたオブジェクトと同じ名前のオブジェクトが既に存在する。</dd>
  47. <dt id="io">FR_INVALID_OBJECT</dt>
  48. <dd>指定されたファイル・オブジェクトやディレクトリ・オブジェクトが無効(オープンされていない、既に閉じられた、破損しているなど)、またはヌル・ポインタが渡された。また、開かれたままのオブジェクトは、それの属するボリュームのマウント動作により無効となります。</dd>
  49. <dt id="wp">FR_WRITE_PROTECTED</dt>
  50. <dd>物理ドライブが書き込み禁止状態のとき、書き込みを伴う操作を行おうとした。</dd>
  51. <dt id="id">FR_INVALID_DRIVE</dt>
  52. <dd>パス名中に指定されたドライブ番号が無効、またはパス名にヌル・ポインタが渡された。(関連オプション: <tt>_VOLUMES</tt>)</dd>
  53. <dt id="ne">FR_NOT_ENABLED</dt>
  54. <dd>そのボリュームの操作に必要なワーク・エリア(ファイル・システム・オブジェクト構造体)が与えられていない。</dd>
  55. <dt id="ns">FR_NO_FILESYSTEM</dt>
  56. <dd>物理ドライブ上に有効なFATボリュームが見つからなかった。</dd>
  57. <dt id="ma">FR_MKFS_ABORTED</dt>
  58. <dd><tt>f_mkfs()</tt>の処理が開始前に中断された。原因としては次のようなことが考えられます。
  59. <ul>
  60. <li>ボリュームが小さすぎる。</li>
  61. <li>FATタイプの計算に矛盾が見つかった。クラスタ数がFATタイプの境界付近になるときに発生する場合があります。</li>
  62. <li>その論理ドライブに対応する区画が見つからなかった。(関連オプション: <tt>_MULTI_PARTITION</tt>)</li>
  63. </ul>
  64. </dd>
  65. <dt id="tm">FR_TIMEOUT</dt>
  66. <dd><a href="appnote.html#reentrant">再入制御</a>による待ち時間が定義された時間を越えたため、関数は実行されなかった。(関連オプション: <tt>_TIMEOUT</tt>)</dd>
  67. <dt id="lo">FR_LOCKED</dt>
  68. <dd><a href="appnote.html#dup">多重アクセス排他機能</a>により、そのファイルやディレクトリに対して行おうとしたアクセスが拒否された。(関連オプション: <tt>_FS_LOCK</tt>)</dd>
  69. <dt id="nc">FR_NOT_ENOUGH_CORE</dt>
  70. <dd>メモリ不足による失敗。原因としては次のようなことが考えられます。
  71. <ul>
  72. <li>LFN操作バッファの動的確保に失敗した。(関連オプション: <tt>_USE_LFN</tt>)</li>
  73. <li>与えられた配列のサイズが実際に必要なサイズに対して不足している。</li>
  74. </ul>
  75. </dd>
  76. <dt id="tf">FR_TOO_MANY_OPEN_FILES</dt>
  77. <dd>同時オープン可能なファイル数を越えてファイルを開こうとした。(関連オプション: <tt>_FS_LOCK</tt>)</dd>
  78. <dt id="ip">FR_INVALID_PARAMETER</dt>
  79. <dd>与えられたパラメータが無効または矛盾している。</dd>
  80. </dl>
  81. </body>
  82. </html>