]> cloudbase.mooo.com Git - z180-stamp.git/blobdiff - fatfs/doc/ja/dwrite.html
Merge branch 'chan-fatfs' into fatfs-integration
[z180-stamp.git] / fatfs / doc / ja / dwrite.html
index 15d4ead45937cfffa91f2624a72e9c2b98764093..fa0de8d1f0a8b48eafa3229b2d19ed3b4a512edb 100644 (file)
@@ -28,13 +28,13 @@ DRESULT disk_write (
 <h4>引数</h4>\r
 <dl class="par">\r
 <dt>pdrv</dt>\r
-<dd>対象のデバイスを示す物理ドライブ番号(0-9)が指定されます。</dd>\r
+<dd>対象のデバイスを識別する物理ドライブ番号(0-9)が指定されます。</dd>\r
 <dt>buff</dt>\r
-<dd>ストレージ デバイスに書き込むセクタ データが格納された<em>バイト配列</em>が指定されます。バイト数は、セクタ サイズ*<tt class="arg">count</tt>となります。</dd>\r
+<dd>ã\82¹ã\83\88ã\83¬ã\83¼ã\82¸ ã\83\87ã\83\90ã\82¤ã\82¹ã\81«æ\9b¸ã\81\8dè¾¼ã\82\80ã\82»ã\82¯ã\82¿ ã\83\87ã\83¼ã\82¿ã\81\8cæ ¼ç´\8dã\81\95ã\82\8cã\81\9f<em>ã\83\90ã\82¤ã\83\88é\85\8då\88\97</em>ã\81\8cæ\8c\87å®\9aã\81\95ã\82\8cã\81¾ã\81\99ã\80\82ã\83\87ã\83¼ã\82¿ã\81®ã\83\90ã\82¤ã\83\88æ\95°ã\81¯ã\80\81ã\82»ã\82¯ã\82¿ ã\82µã\82¤ã\82º*<tt class="arg">count</tt>ã\81¨ã\81ªã\82\8aã\81¾ã\81\99ã\80\82</dd>\r
 <dt>sector</dt>\r
 <dd>書き込みを開始するセクタ番号。32ビットLBAで指定されます。</dd>\r
 <dt>count</dt>\r
-<dd>書き込むセクタ数(1~128)。</dd>\r
+<dd>書き込むセクタ数(1以上の値)が指定されます。</dd>\r
 </dl>\r
 </div>\r
 \r
@@ -45,22 +45,22 @@ DRESULT disk_write (
 <dt>RES_OK (0)</dt>\r
 <dd>正常終了。</dd>\r
 <dt>RES_ERROR</dt>\r
-<dd>書き込み中にエラーが発生し、その回復にも失敗した。</dd>\r
+<dd>回復不能なエラーにより、書き込み操作を完了できなかった。</dd>\r
 <dt>RES_WRPRT</dt>\r
 <dd>メディアが書き込み禁止状態。</dd>\r
 <dt>RES_PARERR</dt>\r
 <dd>パラメータが不正。</dd>\r
 <dt>RES_NOTRDY</dt>\r
-<dd>ã\83\87ã\83\90ã\82¤ã\82¹ã\81\8cå\8b\95ä½\9cå\8f¯è\83½ç\8a¶æ\85\8bã\81§ã\81¯ã\81ªã\81\84ï¼\88å\88\9dæ\9c\9få\8c\96ã\81\95ã\82\8cã\81¦ã\81\84ã\81ªã\81\84ï¼\89。</dd>\r
+<dd>ã\82¹ã\83\88ã\83¬ã\83¼ã\82¸ ã\83\87ã\83\90ã\82¤ã\82¹ã\81\8cå\8b\95ä½\9cå\8f¯è\83½ã\81ªç\8a¶æ\85\8bã\81§ã\81¯ã\81ªã\81\84 (å\88\9dæ\9c\9få\8c\96ã\81\95ã\82\8cã\81¦ã\81\84ã\81ªã\81\84)。</dd>\r
 </dl>\r
 </div>\r
 \r
 \r
 <div class="para desc">\r
 <h4>解説</h4>\r
-<p><tt class="arg">buff</tt>に指定されるアドレスは<em>常にワード アライメントされているとは限りません</em>。詳細は、<a href="dread.html"><tt>disk_read()</tt></a>の解説を参照してください。</p>\r
+<p><tt class="arg">buff</tt>に指定されるアドレスは<em>常にワード アライメントされているとは限りません</em>。これについては、<a href="dread.html"><tt>disk_read</tt></a>関数の解説を参照してください。</p>\r
 <p>一般的に、複数セクタの転送要求は、デバイスに対して可能な限りマルチ セクタ転送しなければなりません。複数のシングル セクタ書き込みに分解された場合、スループットが著しく低下することがあります。</p>\r
-<p>FatFsはディスク関数が遅延書き込み機能を持つことも想定しています。この関数から戻るとき、デバイスが書き込み中とかキャッシュに書き込まれただけなど、必ずしもメディアへの書き込みが完了している必要はありません。ただし、<tt class="arg">buff</tt>のデータは、この関数から戻ると無効となります。書き込み完了の要求は、<tt><a href="dioctl.html">disk_ioctl()</a></tt>の<tt>CTRL_SYNC</tt>コマンドによって行われます。このような遅延書き込み機能が実装された場合、スループットをさらに向上させることができます。</p>\r
+<p>FatFsはディスク制御レイヤが遅延書き込み機能を持つことも想定しています。この関数から戻るとき、デバイスが書き込みを実行中だったり単にライトバック キャッシュに書き込まれただけなど、必ずしもメディアへの書き込みが完了している必要はありません。ただし、<tt class="arg">buff</tt>のデータは、この関数から戻ると無効となります。書き込み完了の要求は、<a href="dioctl.html"><tt>disk_ioctl</tt></a>関数の<tt>CTRL_SYNC</tt>コマンドによって行われます。このような遅延書き込み機能が実装された場合、書き込みスループットを向上させることができます。</p>\r
 <p><em>アプリケーションからはこの関数を呼び出してはなりません。さもないと、FATボリュームが破壊される可能性があります。</em></p>\r
 </div>\r
 \r