mount.html 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  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=Shift_JIS">
  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/mount.html">
  8. <link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
  9. <title>FatFs - f_mount</title>
  10. </head>
  11. <body>
  12. <div class="para func">
  13. <h2>f_mount</h2>
  14. <p>論理ドライブのワーク・エリアを登録・抹消します。</p>
  15. <pre>
  16. FRESULT f_mount (
  17. BYTE <em>Drive</em>, <span class="c">/* 論理ドライブ番号 */</span>
  18. FATFS* <em>FileSystemObject</em> <span class="c">/* ワーク・エリアへのポインタ */</span>
  19. );
  20. </pre>
  21. </div>
  22. <div class="para arg">
  23. <h4>引数</h4>
  24. <dl class="par">
  25. <dt>Drive</dt>
  26. <dd>論理ドライブ番号(0-9)。</dd>
  27. <dt>FileSystemObject</dt>
  28. <dd>登録するワーク・エリア(ファイル・システム・オブジェクト)へのポインタ。</dd>
  29. </dl>
  30. </div>
  31. <div class="para ret">
  32. <h4>戻り値</h4>
  33. <p>
  34. <a href="rc.html#ok">FR_OK</a>,
  35. <a href="rc.html#id">FR_INVALID_DRIVE</a>
  36. </p>
  37. </div>
  38. <div class="para desc">
  39. <h4>解説</h4>
  40. <p>FatFsモジュールではそれぞれの論理ドライブにファイル・システム・オブジェクトというワーク・エリアが必要です。この関数は論理ドライブにそのワーク・エリアを登録したり抹消したりします。何らかのファイル関数を使用する前にこの関数でその論理ドライブのワーク・エリアを与えておかなければなりません。<tt>FileSystemObject</tt>にヌル・ポインタを指定するとその論理ドライブのワーク・エリアの登録は抹消され、登録されていたワーク・エリアは破棄できます。操作対象のドライブに対して開かれているファイルやディレクトリがあった場合、それらは全て無効になります。</p>
  41. <p>この関数は、ドライブの状態に関わらず常に成功します。関数内では下位レイヤ(物理ドライブ)へのアクセスは発生せず、ワーク・エリアを初期化して内部配列にそのアドレスを登録するだけです。実際のマウント動作は、この関数の実行またはメディア交換発生の後、最初のファイル・アクセスのときに行われます。</p>
  42. </div>
  43. <div class="para comp">
  44. <h4>対応情報</h4>
  45. <p>全ての構成で使用可能です。</p>
  46. </div>
  47. <div class="para ref">
  48. <h4>参照</h4>
  49. <p><tt><a href="sfatfs.html">FATFS</a></tt></p>
  50. </div>
  51. <p class="foot"><a href="../00index_j.html">戻る</a></p>
  52. </body>
  53. </html>