X-Git-Url: http://cloudbase.mooo.com/gitweb/z180-stamp.git/blobdiff_plain/5366852335044c1e68a5c32548d3051cc943552f..7b78a5a287827db9e9b16286f3604aef69b37c5c:/fatfs/doc/ja/mount.html diff --git a/fatfs/doc/ja/mount.html b/fatfs/doc/ja/mount.html index c6bc9f1..d465edb 100644 --- a/fatfs/doc/ja/mount.html +++ b/fatfs/doc/ja/mount.html @@ -1,7 +1,7 @@ - + @@ -13,30 +13,30 @@

f_mount

-

˜_—ƒhƒ‰ƒCƒu‚Ƀtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚ð“o˜^E–•Á‚µ‚Ü‚·B

+

論理ドライブにファイル システム オブジェクトを登録・抹消します。

 FRESULT f_mount (
-  FATFS*       fs,     /* [IN] ƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg */
-  const TCHAR* path,   /* [IN] ˜_—ƒhƒ‰ƒCƒu”ԍ† */
-  BYTE         opt     /* [IN] ƒIƒvƒVƒ‡ƒ“ */
+  FATFS*       fs,     /* [IN] ファイル システム オブジェクト */
+  const TCHAR* path,   /* [IN] 論理ドライブ番号 */
+  BYTE         opt     /* [IN] オプション */
 );
 
-

ˆø”

+

引数

fs
-
“o˜^‚·‚éƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚ւ̃|ƒCƒ“ƒ^B
+
登録するファイル システム オブジェクトへのポインタ。
path
-
‘ΏۂƂȂé˜_—ƒhƒ‰ƒCƒu‚̃pƒX–¼‚ðŽ¦‚·ƒkƒ‹•¶Žš'\0'I’[‚Ì•¶Žš—ñ‚ւ̃|ƒCƒ“ƒ^‚ðŽw’肵‚Ü‚·Bƒhƒ‰ƒCƒu”ԍ†‚ðŠÜ‚Ü‚È‚¢ê‡‚́AƒfƒtƒHƒ‹ƒgEƒhƒ‰ƒCƒu‚ðŽw’肵‚½‚±‚Æ‚É‚È‚è‚Ü‚·B
+
対象となる論理ドライブのパス名を示すヌル文字'\0'終端の文字列へのポインタを指定します。パス名にドライブ番号が含まれない場合は、デフォルト ドライブを指定したことになります。
opt
-
ƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚Ì“o˜^‚Æ“¯Žž‚Ƀ}ƒEƒ“ƒg“®ì‚ðs‚¤‚©‚Ç‚¤‚©‚ðŽw’è‚·‚éƒtƒ‰ƒOB“o˜^–•Á‚Ì‚Æ‚«‚͈Ӗ¡‚ðŽ‚¿‚Ü‚¹‚ñB
+
ファイル システム オブジェクトの登録と同時にマウント動作を行うかどうかを指定するフラグ。登録抹消のときは意味を持ちません。
-

–ß‚è’l

+

戻り値

FR_OK, FR_INVALID_DRIVE, @@ -48,35 +48,35 @@ FRESULT f_mount (

-

‰ðà

-

FatFsƒ‚ƒWƒ…[ƒ‹‚ł́A‚»‚ꂼ‚ê‚̘_—ƒhƒ‰ƒCƒu‚Ƀtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚Æ‚¢‚¤ƒ[ƒNEƒGƒŠƒA‚ª•K—v‚Å‚·B‚±‚̊֐”‚͘_—ƒhƒ‰ƒCƒu‚Ƀtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚ð“o˜^‚µ‚½‚è–•Á‚µ‚½‚肵‚Ü‚·B‰½‚ç‚©‚̃tƒ@ƒCƒ‹ŠÖ”‚ðŽg—p‚·‚é‘O‚ɁA‚±‚̊֐”‚Å‚»‚̘_—ƒhƒ‰ƒCƒu‚̃tƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚ð—^‚¦‚Ä‚¨‚©‚È‚¯‚ê‚΂Ȃè‚Ü‚¹‚ñBfs‚Ƀkƒ‹Eƒ|ƒCƒ“ƒ^‚ðŽw’è‚·‚é‚ƁA‚»‚̘_—ƒhƒ‰ƒCƒu‚̃tƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚Ì“o˜^‚Í–•Á‚³‚ê‚邾‚¯‚Å‚·B“o˜^–•Á‚³‚ꂽƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚̃ƒ‚ƒŠ‚͉ð•ú‚Å‚«‚Ü‚·B‘€ì‘Ώۂ̘_—ƒhƒ‰ƒCƒuã‚ÉŠJ‚©‚ê‚Ä‚¢‚éƒtƒ@ƒCƒ‹‚âƒfƒBƒŒƒNƒgƒŠ‚ª‚ ‚Á‚½ê‡A‚»‚ê‚ç‚Í‘S‚Ä–³Œø‚É‚È‚è‚Ü‚·B‚±‚̊֐”‚Ì“à•”ˆ—‚ÍŽŸ‚̂悤‚ȏ‡‚ɍs‚í‚ê‚Ü‚·B

+

解説

+

FatFsモジュールでは、それぞれの論理ドライブにファイル システム オブジェクトというワーク エリアが必要です。この関数は論理ドライブにファイル システム オブジェクトを登録したり抹消したりします。何らかのファイル関数を使用する前に、この関数でその論理ドライブのファイル システム オブジェクトを与えておかなければなりません。fsにヌル ポインタを指定すると、その論理ドライブのファイル システム オブジェクトの登録は抹消されるだけです。登録抹消されたファイル システム オブジェクトのメモリは解放できます。操作対象の論理ドライブ上に開かれたままのファイルやディレクトリがあった場合、それらに対して作成された構造体は全て無効になります。この関数の内部処理は次のような順に行われます。

    -
  1. ‘Ώۂ̘_—ƒhƒ‰ƒCƒu‚ðpath‚©‚瓾‚éB
  2. -
  3. Šù‚É“o˜^‚³‚ê‚Ä‚¢‚éƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚̓NƒŠƒA‚µA“o˜^‚ð‰ðœ‚·‚éB
  4. -
  5. fs‚ª—LŒø‚ȃ|ƒCƒ“ƒ^‚Ì‚Æ‚«‚́A‚»‚̃tƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚ðƒNƒŠƒA‚µ“o˜^‚·‚éB
  6. -
  7. ƒ}ƒEƒ“ƒg“®ì‚ªŽw’肳‚ê‚Ä‚¢‚é‚Æ‚«‚́A‚»‚ê‚ðŽÀs‚·‚éB
  8. +
  9. 対象の論理ドライブをpathから得る。
  10. +
  11. 既に登録されているファイル システム オブジェクトはクリアし、登録を解除する。
  12. +
  13. fsが有効なポインタのときは、そのファイル システム オブジェクトをクリアし登録する。
  14. +
  15. マウント動作が指定されているときは、それを実行する。
-

opt‚É0‚ðŽw’è‚·‚é‚ƁAƒ}ƒEƒ“ƒg“®ì(•¨—ƒhƒ‰ƒCƒu‚̏‰Šú‰»AFATƒ{ƒŠƒ…[ƒ€‚ÌŒŸõABPB‚ð‰ðÍ‚µƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚ð‰Šú‰»)‚͍s‚í‚ꂸAŠÖ”‚Í•¨—ƒhƒ‰ƒCƒu‚̏ó‘Ô‚ÉŠÖ‚í‚炸í‚ɐ¬Œ÷‚µ‚Ü‚·BŠÖ”“à‚ł͉ºˆÊƒŒƒCƒ„‚ւ̃AƒNƒZƒX‚Í”­¶‚¹‚¸AŽw’肳‚ꂽƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚ðƒNƒŠƒA(–³Œø‰»)‚µA‚»‚̃AƒhƒŒƒX‚ð“à•””z—ñ‚É“o˜^‚·‚邾‚¯‚Å‚·B’P‚É“o˜^Ï‚݂̃tƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚ðƒNƒŠƒA‚·‚é–Ú“I‚É‚àŽg‚¦‚Ü‚·B‚»‚µ‚āA‘±‚¢‚ă{ƒŠƒ…[ƒ€‚ւ̃AƒNƒZƒX‚ªs‚í‚ꂽ‚Æ‚«ŽŸ‚Ì‚¤‚¿‚¢‚¸‚ê‚©‚Å‚à^‚̏ꍇ‚́AŽÀÛ‚̃}ƒEƒ“ƒg“®ì‚ªs‚í‚ê‚Ü‚·B

+

optに0を指定すると、マウント動作(物理ドライブの初期化、FATボリュームの検索、BPBを解析しファイル システム オブジェクトを初期化)は行われず、関数は物理ドライブの状態に関わらず常に成功します。関数内では下位レイヤへのアクセスは発生せず、指定されたファイル システム オブジェクトをクリア(無効化)し、そのアドレスを内部配列に登録するだけです。単に登録済みのファイル システム オブジェクトをクリアする目的にも使えます。実際のマウント動作は、ボリュームへのアクセス(パス名を渡すもの全て)が行われたときに、次のうちいずれかの条件が真の場合に行われます。

-

opt‚É1‚ðŽw’è‚·‚é‚ƁA“o˜^‚É‘±‚¢‚ă}ƒEƒ“ƒg“®ì‚ªs‚í‚ê‚Ü‚·Bƒ}ƒEƒ“ƒg‚ÉŽ¸”s‚·‚é‚ƑΉž‚·‚éƒGƒ‰[‚ð•Ô‚µ‚Ü‚·‚ªA“o˜^‚Í—LŒø‚È‚Ì‚Å‘±‚­ƒ{ƒŠƒ…[ƒ€‚ւ̃AƒNƒZƒX‚ōĂу}ƒEƒ“ƒg“®ì‚ªŽÀs‚³‚ê‚Ü‚·B

-

‰ºˆÊƒŒƒCƒ„‚ÌŽÀ‘•ãƒƒfƒBƒAŒðŠ·‚ÌŒŸo‚ªƒTƒ|[ƒg‚³‚ê‚È‚¢(disk_status()‚É”½‰f‚³‚ê‚È‚¢)‚Æ‚«‚́AƒAƒvƒŠƒP[ƒVƒ‡ƒ“‚̓ƒfƒBƒAŒðŠ·‚̌ケ‚̊֐”‚Ńtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg‚𖾎¦“I‚ɃNƒŠƒA‚µ‚čă}ƒEƒ“ƒg‚ª³í‚ɍs‚¦‚é‚悤‚É‚·‚é•K—v‚ª‚ ‚è‚Ü‚·B

+

optに1を指定すると、ファイル システムオブジェクトの登録に続きマウント動作が行われます。メディアが無いなどの理由でマウント動作に失敗すると対応するエラーを返しファイル システム オブジェクト無効状態のままになりますが、登録自体は有効なので続いてボリュームへのアクセスがあれば再びマウント動作が実行されます。

+

下位レイヤの実装上メディア交換の検出がサポートされない(disk_status()に反映されない)ときは、アプリケーションはメディア交換の後この関数でファイル システム オブジェクトを明示的にクリアし、マウント動作が正常に行えるようにする必要があります。

-

‘Ήžî•ñ

-

‘S‚Ă̍\¬‚ÅŽg—p‰Â”\‚Å‚·B

+

対応情報

+

全ての構成で使用可能です。

-

ŽQÆ

+

参照

f_open, FATFS

-

–ß‚é

+

戻る