diff options
| author | Leo C | 2014-11-17 14:47:05 +0100 |
|---|---|---|
| committer | Leo C | 2014-11-17 14:47:05 +0100 |
| commit | 7b78a5a287827db9e9b16286f3604aef69b37c5c (patch) | |
| tree | 6a3788876f5d701f42663f0a498068f18e39df79 /fatfs/doc/ja/dread.html | |
| parent | 5366852335044c1e68a5c32548d3051cc943552f (diff) | |
| download | z180-stamp-7b78a5a287827db9e9b16286f3604aef69b37c5c.zip | |
Import fatfs R0.10cfatfs-0.10c
Diffstat (limited to 'fatfs/doc/ja/dread.html')
| -rw-r--r-- | fatfs/doc/ja/dread.html | 47 |
1 files changed, 24 insertions, 23 deletions
diff --git a/fatfs/doc/ja/dread.html b/fatfs/doc/ja/dread.html index 18b4238..2dac64e 100644 --- a/fatfs/doc/ja/dread.html +++ b/fatfs/doc/ja/dread.html @@ -1,7 +1,7 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html lang="ja">
<head>
-<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="up" title="FatFs" href="../00index_j.html">
<link rel="alternate" hreflang="en" title="English" href="../en/dread.html">
@@ -13,59 +13,60 @@ <div class="para func">
<h2>disk_read</h2>
-<p>ストレージ・デバイスからデータを読み出します。</p>
+<p>繧ｹ繝医Ξ繝ｼ繧ｸ 繝繝舌う繧ｹ縺九ｉ繝繝ｼ繧ｿ繧定ｪｭ縺ｿ蜃ｺ縺励∪縺吶</p>
<pre>
DRESULT disk_read (
- BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span>
- BYTE* <span class="arg">buff</span>, <span class="c">/* [OUT] 読み出しバッファへのポインタ */</span>
- DWORD <span class="arg">sector</span>, <span class="c">/* [IN] 読み出し開始セクタ番号 */</span>
- UINT <span class="arg">count</span> <span class="c">/* [IN] 読み出すセクタ数 */</span>
+ BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 迚ｩ逅繝峨Λ繧､繝也分蜿ｷ */</span>
+ BYTE* <span class="arg">buff</span>, <span class="c">/* [OUT] 隱ｭ縺ｿ蜃ｺ縺励ヰ繝繝輔ぃ縺ｸ縺ｮ繝昴う繝ｳ繧ｿ */</span>
+ DWORD <span class="arg">sector</span>, <span class="c">/* [IN] 隱ｭ縺ｿ蜃ｺ縺鈴幕蟋九そ繧ｯ繧ｿ逡ｪ蜿ｷ */</span>
+ UINT <span class="arg">count</span> <span class="c">/* [IN] 隱ｭ縺ｿ蜃ｺ縺吶そ繧ｯ繧ｿ謨ｰ */</span>
);
</pre>
</div>
<div class="para arg">
-<h4>引数</h4>
+<h4>蠑墓焚</h4>
<dl class="par">
<dt>pdrv</dt>
-<dd>対象のデバイスを示す物理ドライブ番号(0-9)が指定されます。</dd>
+<dd>蟇ｾ雎｡縺ｮ繝繝舌う繧ｹ繧堤､ｺ縺咏黄逅繝峨Λ繧､繝也分蜿ｷ(0-9)縺梧欠螳壹＆繧後∪縺吶ゅす繝ｳ繧ｰ繝ｫ 繝峨Λ繧､繝 繧ｷ繧ｹ繝繝縺ｧ縺ｯ縲∝ｸｸ縺ｫ0縺梧欠螳壹＆繧後∪縺吶</dd>
<dt>buff</dt>
-<dd>ストレージ・デバイスから読み出したデータを格納する<em>バイト配列</em>が指定されます。</dd>
+<dd>繧ｹ繝医Ξ繝ｼ繧ｸ 繝繝舌う繧ｹ縺九ｉ隱ｭ縺ｿ蜃ｺ縺励◆繝繝ｼ繧ｿ繧呈ｼ邏阪☆繧<em>繝舌う繝磯榊</em>縺梧欠螳壹＆繧後∪縺吶</dd>
<dt>sector</dt>
-<dd>読み出しを開始するセクタ番号。LBAで指定されます。</dd>
+<dd>隱ｭ縺ｿ蜃ｺ縺励ｒ髢句ｧ九☆繧九そ繧ｯ繧ｿ逡ｪ蜿ｷ縲32繝薙ャ繝LBA縺ｧ謖螳壹＆繧後∪縺吶</dd>
<dt>count</dt>
-<dd>読み出すセクタ数。FatFsからの呼び出しでは1〜128の範囲に限られます。</dd>
+<dd>隱ｭ縺ｿ蜃ｺ縺吶そ繧ｯ繧ｿ謨ｰ(1ｽ128)縲</dd>
</dl>
</div>
<div class="para ret">
-<h4>戻り値</h4>
+<h4>謌ｻ繧雁､</h4>
<dl class="ret">
<dt>RES_OK (0)</dt>
-<dd>正常終了。</dd>
+<dd>豁｣蟶ｸ邨ゆｺ縲</dd>
<dt>RES_ERROR</dt>
-<dd>読み込み中にエラーが発生し、その回復にも失敗した。</dd>
+<dd>隱ｭ縺ｿ霎ｼ縺ｿ荳ｭ縺ｫ繧ｨ繝ｩ繝ｼ縺檎匱逕溘＠縲√◎縺ｮ蝗槫ｾｩ縺ｫ繧ょ､ｱ謨励＠縺溘</dd>
<dt>RES_PARERR</dt>
-<dd>パラメータが不正。</dd>
+<dd>繝代Λ繝｡繝ｼ繧ｿ縺御ｸ肴ｭ｣縲</dd>
<dt>RES_NOTRDY</dt>
-<dd>ドライブが動作可能状態ではない（初期化されていない）。</dd>
+<dd>繝峨Λ繧､繝悶′蜍穂ｽ懷庄閭ｽ迥ｶ諷九〒縺ｯ縺ｪ縺(蛻晄悄蛹悶＆繧後※縺縺ｪ縺)縲</dd>
</dl>
</div>
<div class="para desc">
-<h4>解説</h4>
-<p><tt class="arg">buff</tt>は<tt>BYTE</tt>型なので、指定されるアドレスは<em>常にワード・アライメントされているとは限りません</em>。非アライメント・アドレスへの転送は、<a href="appnote.html#fs1">直接転送</a>において発生することがあります。もしも、ハードウェア上の制約でそのような転送が不可能なときは、この関数内で二段転送するなどして解決するか、または別の方法で対応しなければなりません。次にいくつかの対応方法を示します(いずれか一つでOK)。</p>
+<h4>隗｣隱ｬ</h4>
+<p>繧ｹ繝医Ξ繝ｼ繧ｸ 繝繝舌う繧ｹ縺ｫ蟇ｾ縺吶ｋ繝繝ｼ繧ｿ縺ｮ隱ｭ縺ｿ譖ｸ縺阪ｯ縲√そ繧ｯ繧ｿ蜊倅ｽ阪〒陦後ｏ繧後∪縺吶FatFs縺ｧ縺ｯ512ｽ4096繝舌う繝医ｮ繧ｻ繧ｯ繧ｿ 繧ｵ繧､繧ｺ繧偵し繝昴ｼ繝医＠縺ｾ縺吶ょ崋螳壹そ繧ｯ繧ｿ 繧ｵ繧､繧ｺ讒区(<tt>_MIN_SS == MAX_SS</tt>)縺ｮ縺ｨ縺阪ｯ縲∵囓鮟咏噪縺ｫ縺昴ｮ繧ｻ繧ｯ繧ｿ 繧ｵ繧､繧ｺ縺ｧ蜍穂ｽ懊＠縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲ょ庄螟峨そ繧ｯ繧ｿ 繧ｵ繧､繧ｺ讒区(<tt>_MIN_SS < MAX_SS</tt>)</p>縺ｮ縺ｨ縺阪ｯ縲∝晄悄蛹門ｾ<tt>disk_ioctl()</tt>縺ｧ繧ｻ繧ｯ繧ｿ 繧ｵ繧､繧ｺ繧貞撫縺蜷医ｏ縺帙※縺上ｋ縺ｮ縺ｧ縲√◎繧後↓蟇ｾ縺励※豁｣縺励＞蛟､繧定ｿ斐☆蠢隕√′縺ゅｊ縺ｾ縺吶</t>
+<p><tt class="arg">buff</tt>縺ｯ<tt>BYTE</tt>蝙九↑縺ｮ縺ｧ縲∵欠螳壹＆繧後ｋ繧｢繝峨Ξ繧ｹ縺ｯ<em>蟶ｸ縺ｫ繝ｯ繝ｼ繝 繧｢繝ｩ繧､繝｡繝ｳ繝医＆繧後※縺繧九→縺ｯ髯舌ｊ縺ｾ縺帙ｓ</em>縲る撼繧｢繝ｩ繧､繝｡繝ｳ繝 繧｢繝峨Ξ繧ｹ縺ｸ縺ｮ霆｢騾√ｯ縲<a href="appnote.html#fs1">逶ｴ謗･霆｢騾</a>縺ｫ縺翫＞縺ｦ逋ｺ逕溘☆繧九％縺ｨ縺後≠繧翫∪縺吶ゅｂ縺励ｂ縲√ワ繝ｼ繝峨え繧ｧ繧｢荳翫ｮ蛻ｶ邏縺ｧ縺昴ｮ繧医≧縺ｪ霆｢騾√′荳榊庄閭ｽ縺ｪ縺ｨ縺阪ｯ縲√％縺ｮ髢｢謨ｰ蜀縺ｧ莠梧ｮｵ霆｢騾√☆繧九↑縺ｩ縺励※隗｣豎ｺ縺吶ｋ縺九√∪縺溘ｯ蛻･縺ｮ譁ｹ豕輔〒蟇ｾ蠢懊＠縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲よｬ｡縺ｫ縺縺上▽縺九ｮ蟇ｾ蠢懈婿豕輔ｒ遉ｺ縺励∪縺(縺縺壹ｌ縺倶ｸ縺､縺ｧOK)縲</p>
<ul>
-<li>この関数内で解決する - 推奨</li>
-<li><tt>f_read()</tt>において、セクタ全体を含む転送を避ける - 直接転送が発生しない</li>
-<li><tt>f_read(fp, buff, btr, &br)</tt>において、<tt>(((UINT)buff & 3) == (f_tell(fp) & 3))</tt>を満足させる - <tt class="arg">buff</tt>のワード・アライメントが保証される</li>
+<li>縺薙ｮ髢｢謨ｰ蜀縺ｧ隗｣豎ｺ縺吶ｋ - 謗ｨ螂ｨ</li>
+<li><tt>f_read()</tt>縺ｫ縺翫＞縺ｦ縲√そ繧ｯ繧ｿ蜈ｨ菴薙ｒ蜷ｫ繧霆｢騾√ｒ驕ｿ縺代ｋ - 逶ｴ謗･霆｢騾√′逋ｺ逕溘＠縺ｪ縺</li>
+<li><tt>f_read(fp, buff, btr, &br)</tt>縺ｫ縺翫＞縺ｦ縲<tt>(((UINT)buff & 3) == (f_tell(fp) & 3))</tt>繧呈ｺ雜ｳ縺輔○繧 - <tt class="arg">buff</tt>縺ｮ繝ｯ繝ｼ繝 繧｢繝ｩ繧､繝｡繝ｳ繝医′菫晁ｨｼ縺輔ｌ繧</li>
</ul>
-<p>一般的に、複数セクタの転送要求は、ストレージ・デバイスに対して可能な限りマルチ・セクタ転送しなければなりません。複数のシングル・セクタ読み出しに分解された場合、スループットが低下することがあります。</p>
+<p>荳闊ｬ逧縺ｫ縲∬､謨ｰ繧ｻ繧ｯ繧ｿ縺ｮ霆｢騾∬ｦ∵ｱゅｯ縲√せ繝医Ξ繝ｼ繧ｸ 繝繝舌う繧ｹ縺ｫ蟇ｾ縺励※蜿ｯ閭ｽ縺ｪ髯舌ｊ繝槭Ν繝 繧ｻ繧ｯ繧ｿ霆｢騾√＠縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲り､謨ｰ縺ｮ繧ｷ繝ｳ繧ｰ繝ｫ 繧ｻ繧ｯ繧ｿ隱ｭ縺ｿ蜃ｺ縺励↓蛻隗｣縺輔ｌ縺溷ｴ蜷医√せ繝ｫ繝ｼ繝励ャ繝医′菴惹ｸ九☆繧九％縺ｨ縺後≠繧翫∪縺吶</p>
</div>
-<p class="foot"><a href="../00index_j.html">戻る</a></p>
+<p class="foot"><a href="../00index_j.html">謌ｻ繧</a></p>
</body>
</html>
|