70 lines
2.7 KiB
HTML
70 lines
2.7 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
||
<html lang="ja">
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
|
||
<meta http-equiv="Content-Style-Type" content="text/css">
|
||
<link rel="up" title="FatFs" href="../00index_j.html">
|
||
<link rel="alternate" hreflang="en" title="English" href="../en/mount.html">
|
||
<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
|
||
<title>FatFs - f_mount</title>
|
||
</head>
|
||
|
||
<body>
|
||
|
||
<div class="para func">
|
||
<h2>f_mount</h2>
|
||
<p>論理ドライブにファイル・システム・オブジェクトを登録・抹消します。</p>
|
||
<pre>
|
||
FRESULT f_mount (
|
||
BYTE <span class="arg">vol</span>, <span class="c">/* [IN] 論理ドライブ番号 */</span>
|
||
FATFS* <span class="arg">fatfs</span> <span class="c">/* [IN] ワーク・エリアへのポインタ */</span>
|
||
);
|
||
</pre>
|
||
</div>
|
||
|
||
<div class="para arg">
|
||
<h4>引数</h4>
|
||
<dl class="par">
|
||
<dt>vol</dt>
|
||
<dd>論理ドライブ番号(0 ～ <tt>_VOLUMES - 1</tt>)。</dd>
|
||
<dt>fatfs</dt>
|
||
<dd>登録するファイル・システム・オブジェクトへのポインタ。</dd>
|
||
</dl>
|
||
</div>
|
||
|
||
<div class="para ret">
|
||
<h4>戻り値</h4>
|
||
<p>
|
||
<a href="rc.html#ok">FR_OK</a>,
|
||
<a href="rc.html#id">FR_INVALID_DRIVE</a>
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="para desc">
|
||
<h4>解説</h4>
|
||
<p>FatFsモジュールでは、それぞれの論理ドライブにファイル・システム・オブジェクトというワーク・エリアが必要です。この関数は論理ドライブにそのワーク・エリアを登録したり抹消したりします。何らかのファイル関数を使用する前に、この関数でその論理ドライブのワーク・エリアを与えておかなければなりません。<tt class="arg">fatfs</tt>にヌル・ポインタを指定するとワーク・エリアの登録は抹消され、登録されていたワーク・エリアは破棄できます。操作対象のドライブに対して開かれているファイルやディレクトリがあった場合、それらは全て無効になります。</p>
|
||
<p>この関数は、物理ドライブの状態に関わらず常に成功します。関数内では下位レイヤへのアクセスは発生せず、指定されたワーク・エリアをクリア(無効化)し、そのアドレスを内部配列に登録するだけです。単に登録済みのワーク・エリアをクリアする目的にも使えます。ボリュームへのアクセス開始のとき次のうちいずれかまたは両方の条件が真のとき、実際のマウント動作(物理ドライブの初期化、FATボリュームの検索、BPBに従いワーク・エリアを初期化)が行われます。</p>
|
||
<ul>
|
||
<li>ファイル・システム・オブジェクトが未初期化(<tt>f_mount()</tt>による)</li>
|
||
<li>物理ドライブが未初期化(システム・リセットやメディアの取り外しによる)</li>
|
||
</ul>
|
||
<p>下位レイヤがメディア交換の検出をサポートしないときは、アプリケーションはメディア交換のたびに<tt>f_mount()</tt>を実行する必要があります。</p>
|
||
</div>
|
||
|
||
|
||
<div class="para comp">
|
||
<h4>対応情報</h4>
|
||
<p>全ての構成で使用可能です。</p>
|
||
</div>
|
||
|
||
|
||
<div class="para ref">
|
||
<h4>参照</h4>
|
||
<p><tt><a href="sfatfs.html">FATFS</a></tt></p>
|
||
</div>
|
||
|
||
<p class="foot"><a href="../00index_j.html">戻る</a></p>
|
||
</body>
|
||
</html>
|