<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r
<html lang="ja">\r
<head>\r
-<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">\r
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">\r
<meta http-equiv="Content-Style-Type" content="text/css">\r
<link rel="up" title="FatFs" href="../00index_j.html">\r
<link rel="alternate" hreflang="en" title="English" href="../en/dread.html">\r
\r
<div class="para func">\r
<h2>disk_read</h2>\r
-<p>\83X\83g\83\8c\81[\83W\81E\83f\83o\83C\83X\82©\82ç\83f\81[\83^\82ð\93Ç\82Ý\8fo\82µ\82Ü\82·\81B</p>\r
+<p>ストレージ デバイスからデータを読み出します。</p>\r
<pre>\r
DRESULT disk_read (\r
- BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] \95¨\97\9d\83h\83\89\83C\83u\94Ô\8d\86 */</span>\r
- BYTE* <span class="arg">buff</span>, <span class="c">/* [OUT] \93Ç\82Ý\8fo\82µ\83o\83b\83t\83@\82Ö\82Ì\83|\83C\83\93\83^ */</span>\r
- DWORD <span class="arg">sector</span>, <span class="c">/* [IN] \93Ç\82Ý\8fo\82µ\8aJ\8en\83Z\83N\83^\94Ô\8d\86 */</span>\r
- UINT <span class="arg">count</span> <span class="c">/* [IN] \93Ç\82Ý\8fo\82·\83Z\83N\83^\90\94 */</span>\r
+ BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span>\r
+ BYTE* <span class="arg">buff</span>, <span class="c">/* [OUT] 読み出しバッファへのポインタ */</span>\r
+ DWORD <span class="arg">sector</span>, <span class="c">/* [IN] 読み出し開始セクタ番号 */</span>\r
+ UINT <span class="arg">count</span> <span class="c">/* [IN] 読み出すセクタ数 */</span>\r
);\r
</pre>\r
</div>\r
\r
<div class="para arg">\r
-<h4>\88ø\90\94</h4>\r
+<h4>引数</h4>\r
<dl class="par">\r
<dt>pdrv</dt>\r
-<dd>\91Î\8fÛ\82Ì\83f\83o\83C\83X\82ð\8e¦\82·\95¨\97\9d\83h\83\89\83C\83u\94Ô\8d\86(0-9)\82ª\8ew\92è\82³\82ê\82Ü\82·\81B</dd>\r
+<dd>対象のデバイスを示す物理ドライブ番号(0-9)が指定されます。シングル ドライブ システムでは、常に0が指定されます。</dd>\r
<dt>buff</dt>\r
-<dd>\83X\83g\83\8c\81[\83W\81E\83f\83o\83C\83X\82©\82ç\93Ç\82Ý\8fo\82µ\82½\83f\81[\83^\82ð\8ai\94[\82·\82é<em>\83o\83C\83g\94z\97ñ</em>\82ª\8ew\92è\82³\82ê\82Ü\82·\81B</dd>\r
+<dd>ストレージ デバイスから読み出したデータを格納する<em>バイト配列</em>が指定されます。</dd>\r
<dt>sector</dt>\r
-<dd>\93Ç\82Ý\8fo\82µ\82ð\8aJ\8en\82·\82é\83Z\83N\83^\94Ô\8d\86\81BLBA\82Å\8ew\92è\82³\82ê\82Ü\82·\81B</dd>\r
+<dd>読み出しを開始するセクタ番号。32ビットLBAで指定されます。</dd>\r
<dt>count</dt>\r
-<dd>\93Ç\82Ý\8fo\82·\83Z\83N\83^\90\94\81BFatFs\82©\82ç\82Ì\8cÄ\82Ñ\8fo\82µ\82Å\82Í1\81`128\82Ì\94Í\88Í\82É\8cÀ\82ç\82ê\82Ü\82·\81B</dd>\r
+<dd>読み出すセクタ数(1～128)。</dd>\r
</dl>\r
</div>\r
\r
\r
<div class="para ret">\r
-<h4>\96ß\82è\92l</h4>\r
+<h4>戻り値</h4>\r
<dl class="ret">\r
<dt>RES_OK (0)</dt>\r
-<dd>\90³\8fí\8fI\97¹\81B</dd>\r
+<dd>正常終了。</dd>\r
<dt>RES_ERROR</dt>\r
-<dd>\93Ç\82Ý\8d\9e\82Ý\92\86\82É\83G\83\89\81[\82ª\94\90¶\82µ\81A\82»\82Ì\89ñ\95\9c\82É\82à\8e¸\94s\82µ\82½\81B</dd>\r
+<dd>読み込み中にエラーが発生し、その回復にも失敗した。</dd>\r
<dt>RES_PARERR</dt>\r
-<dd>\83p\83\89\83\81\81[\83^\82ª\95s\90³\81B</dd>\r
+<dd>パラメータが不正。</dd>\r
<dt>RES_NOTRDY</dt>\r
-<dd>\83h\83\89\83C\83u\82ª\93®\8dì\89Â\94\\8fó\91Ô\82Å\82Í\82È\82¢\81i\8f\89\8aú\89»\82³\82ê\82Ä\82¢\82È\82¢\81j\81B</dd>\r
+<dd>ドライブが動作可能状態ではない(初期化されていない)。</dd>\r
</dl>\r
</div>\r
\r
\r
<div class="para desc">\r
-<h4>\89ð\90à</h4>\r
-<p><tt class="arg">buff</tt>
\82Í<tt>BYTE</tt>
\8c^
\82È
\82Ì
\82Å
\81A
\8ew
\92è
\82³
\82ê
\82é
\83A
\83h
\83\8c\83X
\82Í<em>
\8fí
\82É
\83\8f\81[
\83h
\81E
\83A
\83\89\83C
\83\81\83\93\83g
\82³
\82ê
\82Ä
\82¢
\82é
\82Æ
\82Í
\8cÀ
\82è
\82Ü
\82¹
\82ñ</em>
\81B
\94ñ
\83A
\83\89\83C
\83\81\83\93\83g
\81E
\83A
\83h
\83\8c\83X
\82Ö
\82Ì
\93]
\91\97\82Í
\81A<a href="appnote.html#fs1">
\92¼
\90Ú
\93]
\91\97</a>
\82É
\82¨
\82¢
\82Ä
\94
\90¶
\82·
\82é
\82±
\82Æ
\82ª
\82 \82è
\82Ü
\82·
\81B
\82à
\82µ
\82à
\81A
\83n
\81[
\83h
\83E
\83F
\83A
\8fã
\82Ì
\90§
\96ñ
\82Å
\82»
\82Ì
\82æ
\82¤
\82È
\93]
\91\97\82ª
\95s
\89Â
\94\
\82È
\82Æ
\82«
\82Í
\81A
\82±
\82Ì
\8aÖ
\90\94\93à
\82Å
\93ñ
\92i
\93]
\91\97\82·
\82é
\82È
\82Ç
\82µ
\82Ä
\89ð
\8c\88\82·
\82é
\82©
\81A
\82Ü
\82½
\82Í
\95Ê
\82Ì
\95û
\96@
\82Å
\91Î
\89\9e\82µ
\82È
\82¯
\82ê
\82Î
\82È
\82è
\82Ü
\82¹
\82ñ
\81B
\8e\9f\82É
\82¢
\82
\82Â
\82©
\82Ì
\91Î
\89\9e\95û
\96@
\82ð
\8e¦
\82µ
\82Ü
\82·(
\82¢
\82¸
\82ê
\82©
\88ê
\82Â
\82ÅOK)
\81B</p>
\r+<h4>解説</h4>\r
+<p>ストレージ デバイスに対するデータの読み書きは、セクタ単位で行われます。FatFsでは512～4096バイトのセクタ サイズをサポートします。固定セクタ サイズ構成(<tt>_MIN_SS == MAX_SS</tt>)のときは、暗黙的にそのセクタ サイズで動作しなければなりません。可変セクタ サイズ構成(<tt>_MIN_SS < MAX_SS</tt>)</p>のときは、初期化後<tt>disk_ioctl()</tt>でセクタ サイズを問い合わせてくるので、それに対して正しい値を返す必要があります。</t>\r
+<p><tt class="arg">buff</tt>は<tt>BYTE</tt>型なので、指定されるアドレスは<em>常にワード アライメントされているとは限りません</em>。非アライメント アドレスへの転送は、<a href="appnote.html#fs1">直接転送</a>において発生することがあります。もしも、ハードウェア上の制約でそのような転送が不可能なときは、この関数内で二段転送するなどして解決するか、または別の方法で対応しなければなりません。次にいくつかの対応方法を示します(いずれか一つでOK)。</p>\r
<ul>\r
-<li>\82±\82Ì\8aÖ\90\94\93à\82Å\89ð\8c\88\82·\82é - \90\84\8f§</li>\r
-<li><tt>f_read()</tt>\82É\82¨\82¢\82Ä\81A\83Z\83N\83^\91S\91Ì\82ð\8aÜ\82Þ\93]\91\97\82ð\94ð\82¯\82é - \92¼\90Ú\93]\91\97\82ª\94\90¶\82µ\82È\82¢</li>\r
-<li><tt>f_read(fp, buff, btr, &br)</tt>\82É\82¨\82¢\82Ä\81A<tt>(((UINT)buff & 3) == (f_tell(fp) & 3))</tt>\82ð\96\9e\91«\82³\82¹\82é - <tt class="arg">buff</tt>\82Ì\83\8f\81[\83h\81E\83A\83\89\83C\83\81\83\93\83g\82ª\95Û\8fØ\82³\82ê\82é</li>\r
+<li>この関数内で解決する - 推奨</li>\r
+<li><tt>f_read()</tt>において、セクタ全体を含む転送を避ける - 直接転送が発生しない</li>\r
+<li><tt>f_read(fp, buff, btr, &br)</tt>において、<tt>(((UINT)buff & 3) == (f_tell(fp) & 3))</tt>を満足させる - <tt class="arg">buff</tt>のワード アライメントが保証される</li>\r
</ul>\r
-<p>\88ê\94Ê\93I\82É\81A\95¡\90\94\83Z\83N\83^\82Ì\93]\91\97\97v\8b\81\82Í\81A\83X\83g\83\8c\81[\83W\81E\83f\83o\83C\83X\82É\91Î\82µ\82Ä\89Â\94\\82È\8cÀ\82è\83}\83\8b\83`\81E\83Z\83N\83^\93]\91\97\82µ\82È\82¯\82ê\82Î\82È\82è\82Ü\82¹\82ñ\81B\95¡\90\94\82Ì\83V\83\93\83O\83\8b\81E\83Z\83N\83^\93Ç\82Ý\8fo\82µ\82É\95ª\89ð\82³\82ê\82½\8fê\8d\87\81A\83X\83\8b\81[\83v\83b\83g\82ª\92á\89º\82·\82é\82±\82Æ\82ª\82 \82è\82Ü\82·\81B</p>\r
+<p>一般的に、複数セクタの転送要求は、ストレージ デバイスに対して可能な限りマルチ セクタ転送しなければなりません。複数のシングル セクタ読み出しに分解された場合、スループットが低下することがあります。</p>\r
</div>\r
\r
\r
-<p class="foot"><a href="../00index_j.html">\96ß\82é</a></p>\r
+<p class="foot"><a href="../00index_j.html">戻る</a></p>\r
</body>\r
</html>\r
projects / z180-stamp.git / blobdiff