projects / z180-stamp.git / blame
| Commit | Line | Data |
|---|---|---|
| 53668523 L |
1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r |
| 2 | <html lang="ja">\r | |
| 3 | <head>\r | |
| 7b78a5a2 | 4 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8">\r |
| 53668523 L |
5 | <meta http-equiv="Content-Style-Type" content="text/css">\r |
| 6 | <link rel="up" title="FatFs" href="../00index_j.html">\r | |
| 7 | <link rel="alternate" hreflang="en" title="English" href="../en/mkfs.html">\r | |
| 8 | <link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">\r | |
| 9 | <title>FatFs - f_mkfs</title>\r | |
| 10 | </head>\r | |
| 11 | \r | |
| 12 | <body>\r | |
| 13 | \r | |
| 14 | <div class="para func">\r | |
| 15 | <h2>f_mkfs</h2>\r | |
| 70702af1 | 16 | <p>論理ドライブ上にFAT/exFATボリュームを作成(フォーマット)します。</p>\r |
| 53668523 L |
17 | <pre>\r |
| 18 | FRESULT f_mkfs (\r | |
| 70702af1 L |
19 | const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 論理ドライブ番号 */</span>\r |
| 20 | BYTE <span class="arg">opt</span>, <span class="c">/* [IN] フォーマット オプション */</span>\r | |
| 21 | DWORD <span class="arg">au</span>, <span class="c">/* [IN] クラスタ サイズ */</span>\r | |
| 22 | void* <span class="arg">work</span>, <span class="c">/* [-] ワーク エリア */</span>\r | |
| 23 | UINT <span class="arg">len</span> <span class="c">/* [IN] ワーク エリアのサイズ */</span>\r | |
| 53668523 L |
24 | );\r |
| 25 | </pre>\r | |
| 26 | </div>\r | |
| 27 | \r | |
| 28 | <div class="para arg">\r | |
| 7b78a5a2 | 29 | <h4>引数</h4>\r |
| 53668523 L |
30 | <dl class="par">\r |
| 31 | <dt>path</dt>\r | |
| 70702af1 L |
32 | <dd>フォーマット対象の論理ドライブを示す<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。ドライブ番号を含まない場合は、デフォルト ドライブを意味します。論理ドライブには<tt>f_mount</tt>関数でワークエリアが与えられている必要はありません。</dd>\r |
| 33 | <dt>opt</dt>\r | |
| 34 | <dd>フォーマット オプション。<tt>FM_FAT, FM_FAT32, FM_EXFAT</tt>の各フラグの組み合わせ(<tt>FM_ANY</tt>は、これらのOR値)で作成するFATボリュームのタイプを指定します。複数のタイプが指定された場合、その中のいずれかが自動選択されます。exFATが無効のときは、<tt>FM_EXFAT</tt>は無視されます。<tt>FM_SFD</tt>フラグを指定すると、SFD形式(後述)でボリュームを配置します。</dd>\r | |
| 53668523 | 35 | <dt>au</dt>\r |
| 70702af1 L |
36 | <dd>クラスタ サイズをバイト単位で指定します。有効値は、セクタ サイズのN倍となります。Nは2の累乗で、FAT/FAT32ボリュームでは1～128、exFATボリュームでは1～32768です。0を指定した場合は、ボリュームのサイズと選択されたFATタイプに応じたデフォルトのクラスタ サイズが選択されます。</dd>\r |
| 37 | <dt>work</dt>\r | |
| 38 | <dd>ワークエリアへのポインタを指定します。</dd>\r | |
| 39 | <dt>len</dt>\r | |
| 40 | <dd>ワークエリアのサイズをバイト単位で指定します。ワークエリアのサイズは少なくとも関連するドライブのセクタサイズは必要です。また、十分に大きなサイズを与えることにより、書き込みトランザクションの回数が減ってフォーマット時間を短縮できます。</dd>\r | |
| 53668523 L |
41 | </dl>\r |
| 42 | </div>\r | |
| 43 | \r | |
| 44 | <div class="para ret">\r | |
| 7b78a5a2 | 45 | <h4>戻り値</h4>\r |
| 53668523 L |
46 | <p>\r |
| 47 | <a href="rc.html#ok">FR_OK</a>,\r | |
| 48 | <a href="rc.html#de">FR_DISK_ERR</a>,\r | |
| 49 | <a href="rc.html#nr">FR_NOT_READY</a>,\r | |
| 53668523 L |
50 | <a href="rc.html#ma">FR_MKFS_ABORTED</a>,\r |
| 51 | <a href="rc.html#ip">FR_INVALID_PARAMETER</a>\r | |
| 52 | </p>\r | |
| 53 | </div>\r | |
| 54 | \r | |
| 55 | <div class="para desc">\r | |
| 7b78a5a2 | 56 | <h4>説明</h4>\r |
| 70702af1 L |
57 | <p>exFAT以外のボリュームのFATタイプ(FAT12/FAT16/FAT32)は、そのボリューム上の<em>クラスタ数によってのみ決定</em>される決まり[FAT仕様書より]になっていて、それ以外の要因はありません。したがって、どのFATタイプになるかはボリューム サイズとクラスタ サイズに依存します。そのボリュームのサイズにおいて、指定されたFATタイプとクラスタ サイズの組み合わせが成立し得ないときは、関数は<tt>FR_MKFS_ABORTED</tt>で失敗します。</p>\r |
| 58 | <p>クラスタとは、データ格納領域の管理の単位のことで、これを単位にファイルにデータ領域が割り当てられます。たとえば、クラスタ サイズが32768のときは、100バイトのファイルも32768バイトのスペースを消費することになります。このように、クラスタ サイズを大きくするほどボリュームの利用効率が悪くなりますが、その一方で読み書きの性能は上がります。クラスタ サイズによる利用効率と性能はトレード オフの関係にあります。GBクラスのストレージでは、極端に多くのファイルを扱わない限り32768バイト以上に(デフォルト指定ではそのようになる)しておくとよいでしょう。</p>\r | |
| 59 | <p>パーテーション形式には、FDISK形式とSFD形式の二通りあります。FDISK形式は、ハードディスク、マルチメディアカード、SDカード、CFカード、USBメモリなどで標準的に使用されます。FDISK形式では一台の物理ドライブ上に一つまたは複数の区画を作成することができ、区画管理情報はMBR(物理ドライブの先頭セクタ)に記録されます。SFD形式は単に何の分割も行わない形式で、ボリュームは物理ドライブの先頭セクタから開始します。SFD形式は、フロッピー ディスク、マイクロドライブ、光学ディスク、およびその他スーパー フロッピー メディアで標準的に使用されています。システムによっては、FDISK形式またはSFD形式のどちらか一方のみをサポートし他方をサポートしません。</p>\r | |
| 60 | <p><tt>FM_SFD</tt>が指定されないときはFDISK形式となり、その物理ドライブ全体を占める1個の基本区画(パーテーション)が作成され、その中にFATボリュームが作成されます。<tt>FM_SFD</tt>が指定されたときはSFD形式となり、FATボリュームがその物理ドライブの先頭セクタからベタで作成されます。</p>\r | |
| 61 | <p>マルチ パーテーション機能(<tt><a href="config.html#multi_partition">_MULTI_PARTITION</a></tt>)により、その論理ドライブが特定の区画(1～4)に結び付けられている場合は、その区画の中にFATボリュームが作成されます。<tt>FM_SFD</tt>の指定は無視され、その物理ドライブはこれに先立ち、<tt>f_fdisk</tt>関数または他のツールで適切に区画設定されている必要があります。</p>\r | |
| 53668523 L |
62 | </div>\r |
| 63 | \r | |
| 53668523 | 64 | <div class="para comp">\r |
| 7b78a5a2 L |
65 | <h4>対応情報</h4>\r |
| 66 | <p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_MKFS == 1</tt>のとき使用可能です。</p>\r | |
| 67 | </div>\r | |
| 68 | \r | |
| 69 | \r | |
| 70 | <div class="para use">\r | |
| 71 | <h4>使用例</h4>\r | |
| 72 | <pre>\r | |
| 70702af1 | 73 | <span class="c">/* Format default drive and create a file */</span>\r |
| 7b78a5a2 L |
74 | int main (void)\r |
| 75 | {\r | |
| 70702af1 L |
76 | FATFS fs; <span class="c">/* File system object */</span>\r |
| 77 | FIL fil; <span class="c">/* File object */</span>\r | |
| 78 | FRESULT res; <span class="c">/* API result code */</span>\r | |
| 79 | UINT bw; <span class="c">/* Bytes written */</span>\r | |
| 80 | BYTE work[_MAX_SS]; <span class="c">/* Work area (larger is better for process time) */</span>\r | |
| 81 | \r | |
| 7b78a5a2 | 82 | \r |
| 70702af1 L |
83 | <span class="c">/* Create FAT volume */</span>\r |
| 84 | res = f_mkfs("", FM_ANY, 0, work, sizeof work);\r | |
| 85 | if (res) ...\r | |
| 7b78a5a2 L |
86 | \r |
| 87 | <span class="c">/* Register work area */</span>\r | |
| 88 | f_mount(&fs, "", 0);\r | |
| 89 | \r | |
| 7b78a5a2 | 90 | <span class="c">/* Create a file as new */</span>\r |
| 70702af1 | 91 | res = f_open(&fil, "hello.txt", FA_CREATE_NEW | FA_WRITE);\r |
| 7b78a5a2 L |
92 | if (res) ...\r |
| 93 | \r | |
| 94 | <span class="c">/* Write a message */</span>\r | |
| 70702af1 | 95 | f_write(&fil, "Hello, World!\r\n", 15, &bw);\r |
| 7b78a5a2 L |
96 | if (bw != 15) ...\r |
| 97 | \r | |
| 98 | <span class="c">/* Close the file */</span>\r | |
| 70702af1 | 99 | f_close(&fil);\r |
| 7b78a5a2 | 100 | \r |
| 70702af1 | 101 | ...\r |
| 7b78a5a2 | 102 | </pre>\r |
| 53668523 L |
103 | </div>\r |
| 104 | \r | |
| 105 | \r | |
| 106 | <div class="para ref">\r | |
| 7b78a5a2 | 107 | <h4>参照</h4>\r |
| 70702af1 | 108 | <p><a href="../res/mkfs.xls">ボリューム サイズとフォーマット パラメータ</a>, <a href="filename.html#vol">ボリューム管理</a>, <tt><a href="fdisk.html">f_fdisk</a></tt></p>\r |
| 53668523 L |
109 | </div>\r |
| 110 | \r | |
| 7b78a5a2 L |
111 | \r |
| 112 | <p class="foot"><a href="../00index_j.html">戻る</a></p>\r | |
| 53668523 L |
113 | </body>\r |
| 114 | </html>\r |