Add FatFs module by ChaN.
[bertos.git] / bertos / fs / fatfs / doc / en / mountdrv.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r
2 <html lang="en">\r
3 <head>\r
4 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">\r
5 <meta http-equiv="Content-Style-Type" content="text/css">\r
6 <link rel="up" title="FatFs" href="../00index_e.html">\r
7 <link rel="stylesheet" href="../css_e.css" type="text/css" media="screen" title="ELM Default">\r
8 <title>FatFs - f_mountdrv</title>\r
9 </head>\r
10 \r
11 <body>\r
12 \r
13 <div class="para">\r
14 <h2>f_mountdrv</h2>\r
15 <p>The f_mountdrv forces the partition mounted.</p>\r
16 <pre>\r
17 FRESULT f_mountdrv (void);\r
18 </pre>\r
19 </div>\r
20 \r
21 <div class="para">\r
22 <h4>Return Values</h4>\r
23 <dl class="ret">\r
24 <dt>FR_OK (0)</dt>\r
25 <dd>The function succeeded.</dd>\r
26 <dt>FR_NOT_READY</dt>\r
27 <dd>The disk drive cannot work due to no medium in the drive or any other reason.</dd>\r
28 <dt>FR_RW_ERROR</dt>\r
29 <dd>Any error occured in low level disk I/O.</dd>\r
30 <dt>FR_NOT_ENABLED</dt>\r
31 <dd>FatFs module is not enabled.</dd>\r
32 <dt>FR_NO_FILESYSTEM</dt>\r
33 <dd>There is no valid FAT partition on the disk.</dd>\r
34 </dl>\r
35 </div>\r
36 \r
37 \r
38 <div class="para">\r
39 <h4>Description</h4>\r
40 <p>The f_mountdrv forces the partition mounted (initializes <tt>FATFS</tt> structure). The file system is initialized automatically in accordance with the necessity when any file function is called. This function should not be used except for recovering <tt>FR_INCORRECT_DISK_CHANGE</tt> error. Using this function, while any file is opened, can destroy the file system.</p>\r
41 <p>In this function, following processes are executed.</p><br>\r
42 <ul>\r
43 <li>Initializes lower level layer (disk I/O module).</li>\r
44 <li>Searches a FAT boot record in order of sector 0 (as SFD format) and first primary partition (as FDISK format).</li>\r
45 <li>Initializes file system object (<tt>FATFS</tt> structure).</li>\r
46 </ul>\r
47 </div>\r
48 \r
49 \r
50 <div class="para">\r
51 <h4>References</h4>\r
52 <p><tt><a href="sfatfs.html">FATFS</a></tt></p>\r
53 </div>\r
54 \r
55 <p class="foot"><a href="../00index_e.html">Return</a></p>\r
56 </body>\r
57 </html>\r