From 7b78a5a287827db9e9b16286f3604aef69b37c5c Mon Sep 17 00:00:00 2001 From: Leo C Date: Mon, 17 Nov 2014 14:47:05 +0100 Subject: Import fatfs R0.10c --- fatfs/doc/ja/dread.html | 47 ++++++++++++++++++++++++----------------------- 1 file changed, 24 insertions(+), 23 deletions(-) (limited to 'fatfs/doc/ja/dread.html') 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 @@ - + @@ -13,59 +13,60 @@

disk_read

-

ストレージ・デバイスからデータを読み出します。

+

繧ケ繝医Ξ繝シ繧ク 繝繝舌う繧ケ縺九i繝繝シ繧ソ繧定ェュ縺ソ蜃コ縺励∪縺吶

 DRESULT disk_read (
-  BYTE pdrv,     /* [IN] 物理ドライブ番号 */
-  BYTE* buff,    /* [OUT] 読み出しバッファへのポインタ */
-  DWORD sector,  /* [IN] 読み出し開始セクタ番号 */
-  UINT count     /* [IN] 読み出すセクタ数 */
+  BYTE pdrv,     /* [IN] 迚ゥ逅繝峨Λ繧、繝也分蜿キ */
+  BYTE* buff,    /* [OUT] 隱ュ縺ソ蜃コ縺励ヰ繝繝輔ぃ縺ク縺ョ繝昴う繝ウ繧ソ */
+  DWORD sector,  /* [IN] 隱ュ縺ソ蜃コ縺鈴幕蟋九そ繧ッ繧ソ逡ェ蜿キ */
+  UINT count     /* [IN] 隱ュ縺ソ蜃コ縺吶そ繧ッ繧ソ謨ー */
 );
 
-

引数

+

蠑墓焚

pdrv
-
対象のデバイスを示す物理ドライブ番号(0-9)が指定されます。
+
蟇セ雎。縺ョ繝繝舌う繧ケ繧堤、コ縺咏黄逅繝峨Λ繧、繝也分蜿キ(0-9)縺梧欠螳壹&繧後∪縺吶ゅす繝ウ繧ー繝ォ 繝峨Λ繧、繝 繧キ繧ケ繝繝縺ァ縺ッ縲∝クク縺ォ0縺梧欠螳壹&繧後∪縺吶
buff
-
ストレージ・デバイスから読み出したデータを格納するバイト配列が指定されます。
+
繧ケ繝医Ξ繝シ繧ク 繝繝舌う繧ケ縺九i隱ュ縺ソ蜃コ縺励◆繝繝シ繧ソ繧呈シ邏阪☆繧繝舌う繝磯榊縺梧欠螳壹&繧後∪縺吶
sector
-
読み出しを開始するセクタ番号。LBAで指定されます。
+
隱ュ縺ソ蜃コ縺励r髢句ァ九☆繧九そ繧ッ繧ソ逡ェ蜿キ縲32繝薙ャ繝LBA縺ァ謖螳壹&繧後∪縺吶
count
-
読み出すセクタ数。FatFsからの呼び出しでは1〜128の範囲に限られます。
+
隱ュ縺ソ蜃コ縺吶そ繧ッ繧ソ謨ー(1ス128)縲
-

戻り値

+

謌サ繧雁、

RES_OK (0)
-
正常終了。
+
豁」蟶ク邨ゆコ縲
RES_ERROR
-
読み込み中にエラーが発生し、その回復にも失敗した。
+
隱ュ縺ソ霎シ縺ソ荳ュ縺ォ繧ィ繝ゥ繝シ縺檎匱逕溘@縲√◎縺ョ蝗槫セゥ縺ォ繧ょ、ア謨励@縺溘
RES_PARERR
-
パラメータが不正。
+
繝代Λ繝。繝シ繧ソ縺御ク肴ュ」縲
RES_NOTRDY
-
ドライブが動作可能状態ではない(初期化されていない)。
+
繝峨Λ繧、繝悶′蜍穂ス懷庄閭ス迥カ諷九〒縺ッ縺ェ縺(蛻晄悄蛹悶&繧後※縺縺ェ縺)縲
-

解説

-

buffBYTE型なので、指定されるアドレスは常にワード・アライメントされているとは限りません。非アライメント・アドレスへの転送は、直接転送において発生することがあります。もしも、ハードウェア上の制約でそのような転送が不可能なときは、この関数内で二段転送するなどして解決するか、または別の方法で対応しなければなりません。次にいくつかの対応方法を示します(いずれか一つでOK)。

+

隗」隱ャ

+

繧ケ繝医Ξ繝シ繧ク 繝繝舌う繧ケ縺ォ蟇セ縺吶k繝繝シ繧ソ縺ョ隱ュ縺ソ譖ク縺阪ッ縲√そ繧ッ繧ソ蜊倅ス阪〒陦後o繧後∪縺吶FatFs縺ァ縺ッ512ス4096繝舌う繝医ョ繧サ繧ッ繧ソ 繧オ繧、繧コ繧偵し繝昴シ繝医@縺セ縺吶ょ崋螳壹そ繧ッ繧ソ 繧オ繧、繧コ讒区(_MIN_SS == MAX_SS)縺ョ縺ィ縺阪ッ縲∵囓鮟咏噪縺ォ縺昴ョ繧サ繧ッ繧ソ 繧オ繧、繧コ縺ァ蜍穂ス懊@縺ェ縺代l縺ー縺ェ繧翫∪縺帙s縲ょ庄螟峨そ繧ッ繧ソ 繧オ繧、繧コ讒区(_MIN_SS < MAX_SS)

縺ョ縺ィ縺阪ッ縲∝晄悄蛹門セdisk_ioctl()縺ァ繧サ繧ッ繧ソ 繧オ繧、繧コ繧貞撫縺蜷医o縺帙※縺上k縺ョ縺ァ縲√◎繧後↓蟇セ縺励※豁」縺励>蛟、繧定ソ斐☆蠢隕√′縺ゅj縺セ縺吶 +

buff縺ッBYTE蝙九↑縺ョ縺ァ縲∵欠螳壹&繧後k繧「繝峨Ξ繧ケ縺ッ蟶ク縺ォ繝ッ繝シ繝 繧「繝ゥ繧、繝。繝ウ繝医&繧後※縺繧九→縺ッ髯舌j縺セ縺帙s縲る撼繧「繝ゥ繧、繝。繝ウ繝 繧「繝峨Ξ繧ケ縺ク縺ョ霆「騾√ッ縲逶エ謗・霆「騾縺ォ縺翫>縺ヲ逋コ逕溘☆繧九%縺ィ縺後≠繧翫∪縺吶ゅb縺励b縲√ワ繝シ繝峨え繧ァ繧「荳翫ョ蛻カ邏縺ァ縺昴ョ繧医≧縺ェ霆「騾√′荳榊庄閭ス縺ェ縺ィ縺阪ッ縲√%縺ョ髢「謨ー蜀縺ァ莠梧ョオ霆「騾√☆繧九↑縺ゥ縺励※隗」豎コ縺吶k縺九√∪縺溘ッ蛻・縺ョ譁ケ豕輔〒蟇セ蠢懊@縺ェ縺代l縺ー縺ェ繧翫∪縺帙s縲よャ。縺ォ縺縺上▽縺九ョ蟇セ蠢懈婿豕輔r遉コ縺励∪縺(縺縺壹l縺倶ク縺、縺ァOK)縲

-

一般的に、複数セクタの転送要求は、ストレージ・デバイスに対して可能な限りマルチ・セクタ転送しなければなりません。複数のシングル・セクタ読み出しに分解された場合、スループットが低下することがあります。

+

荳闊ャ逧縺ォ縲∬、謨ー繧サ繧ッ繧ソ縺ョ霆「騾∬ヲ∵アゅッ縲√せ繝医Ξ繝シ繧ク 繝繝舌う繧ケ縺ォ蟇セ縺励※蜿ッ閭ス縺ェ髯舌j繝槭Ν繝 繧サ繧ッ繧ソ霆「騾√@縺ェ縺代l縺ー縺ェ繧翫∪縺帙s縲り、謨ー縺ョ繧キ繝ウ繧ー繝ォ 繧サ繧ッ繧ソ隱ュ縺ソ蜃コ縺励↓蛻隗」縺輔l縺溷エ蜷医√せ繝ォ繝シ繝励ャ繝医′菴惹ク九☆繧九%縺ィ縺後≠繧翫∪縺吶

-

戻る

+

謌サ繧

-- cgit v1.2.3