1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta http-equiv=
"Content-Type" content=
"text/html; charset=utf-8">
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/dwrite.html">
8 <link rel=
"stylesheet" href=
"../css_j.css" type=
"text/css" media=
"screen" title=
"ELM Default">
9 <title>FatFs - disk_write
</title>
14 <div class=
"para func">
16 <p>ストレージ デバイスにデータを書き込みます。
</p>
19 BYTE
<span class=
"arg">pdrv
</span>,
<span class=
"c">/* [IN] 物理ドライブ番号 */
</span>
20 const BYTE*
<span class=
"arg">buff
</span>,
<span class=
"c">/* [IN] 書き込むデータへのポインタ */
</span>
21 DWORD
<span class=
"arg">sector
</span>,
<span class=
"c">/* [IN] 書き込み開始セクタ番号 */
</span>
22 UINT
<span class=
"arg">count
</span> <span class=
"c">/* [IN] 書き込むセクタ数 */
</span>
27 <div class=
"para arg">
31 <dd>対象のデバイスを示す物理ドライブ番号(
0-
9)が指定されます。
</dd>
33 <dd>ストレージ デバイスに書き込むセクタ データが格納された
<em>バイト配列
</em>が指定されます。バイト数は、セクタ サイズ*
<tt class=
"arg">count
</tt>となります。
</dd>
35 <dd>書き込みを開始するセクタ番号。
32ビットLBAで指定されます。
</dd>
37 <dd>書き込むセクタ数(
1~
128)。
</dd>
42 <div class=
"para ret">
48 <dd>書き込み中にエラーが発生し、その回復にも失敗した。
</dd>
50 <dd>メディアが書き込み禁止状態。
</dd>
54 <dd>デバイスが動作可能状態ではない(初期化されていない)。
</dd>
59 <div class=
"para desc">
61 <p><tt class=
"arg">buff
</tt>に指定されるアドレスは
<em>常にワード アライメントされているとは限りません
</em>。詳細は、
<a href=
"dread.html"><tt>disk_read()
</tt></a>の解説を参照してください。
</p>
62 <p>一般的に、複数セクタの転送要求は、デバイスに対して可能な限りマルチ セクタ転送しなければなりません。複数のシングル セクタ書き込みに分解された場合、スループットが著しく低下することがあります。
</p>
63 <p>FatFsはディスク関数が遅延書き込み機能を持つことも想定しています。この関数から戻るとき、デバイスが書き込み中とかキャッシュに書き込まれただけなど、必ずしもメディアへの書き込みが完了している必要はありません。ただし、
<tt class=
"arg">buff
</tt>のデータは、この関数から戻ると無効となります。書き込み完了の要求は、
<tt><a href=
"dioctl.html">disk_ioctl()
</a></tt>の
<tt>CTRL_SYNC
</tt>コマンドによって行われます。このような遅延書き込み機能が実装された場合、スループットをさらに向上させることができます。
</p>
64 <p><em>アプリケーションからはこの関数を呼び出してはなりません。さもないと、FATボリュームが破壊される可能性があります。
</em></p>
68 <div class=
"para comp">
70 <p>リード オンリー構成(
<tt>_FS_READONLY ==
1</tt>)ではこの関数は必要とされません。
</p>
74 <p class=
"foot"><a href=
"../00index_j.html">戻る
</a></p>