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/dwrite.html | 50 ++++++++++++++++++++++++------------------------ 1 file changed, 25 insertions(+), 25 deletions(-) (limited to 'fatfs/doc/ja/dwrite.html') diff --git a/fatfs/doc/ja/dwrite.html b/fatfs/doc/ja/dwrite.html index 41cebeb..15d4ead 100644 --- a/fatfs/doc/ja/dwrite.html +++ b/fatfs/doc/ja/dwrite.html @@ -1,7 +1,7 @@ - + @@ -13,64 +13,64 @@

disk_write

-

ストレージ・デバイスにデータを書き込みます。

+

繧ｹ繝医Ξ繝ｼ繧ｸ 繝�繝舌う繧ｹ縺ｫ繝�繝ｼ繧ｿ繧呈嶌縺崎ｾｼ縺ｿ縺ｾ縺吶€�

 DRESULT disk_write (
-  BYTE pdrv,        /* [IN] 物理ドライブ番号 */
-  const BYTE* buff, /* [IN] 書き込むデータへのポインタ */
-  DWORD sector,     /* [IN] 書き込み開始セクタ番号 */
-  UINT count        /* [IN] 書き込むセクタ数 */
+  BYTE pdrv,        /* [IN] 迚ｩ逅�繝峨Λ繧､繝也分蜿ｷ */
+  const BYTE* buff, /* [IN] 譖ｸ縺崎ｾｼ繧€繝�繝ｼ繧ｿ縺ｸ縺ｮ繝昴う繝ｳ繧ｿ */
+  DWORD sector,     /* [IN] 譖ｸ縺崎ｾｼ縺ｿ髢句ｧ九そ繧ｯ繧ｿ逡ｪ蜿ｷ */
+  UINT count        /* [IN] 譖ｸ縺崎ｾｼ繧€繧ｻ繧ｯ繧ｿ謨ｰ */
 );
-

引数

+

蠑墓焚

pdrv
-
対象のデバイスを示す物理ドライブ番号(0-9)が指定されます。
+
蟇ｾ雎｡縺ｮ繝�繝舌う繧ｹ繧堤､ｺ縺咏黄逅�繝峨Λ繧､繝也分蜿ｷ(0-9)縺梧欠螳壹＆繧後∪縺吶€�
buff
-
ストレージ・デバイスに書き込むセクタ・データが格納されたバイト配列が指定されます。バイト数は、セクタ・サイズ*countとなります。
+
繧ｹ繝医Ξ繝ｼ繧ｸ 繝�繝舌う繧ｹ縺ｫ譖ｸ縺崎ｾｼ繧€繧ｻ繧ｯ繧ｿ 繝�繝ｼ繧ｿ縺梧ｼ邏阪＆繧後◆繝舌う繝磯�榊��縺梧欠螳壹＆繧後∪縺吶€ゅヰ繧､繝域焚縺ｯ縲√そ繧ｯ繧ｿ 繧ｵ繧､繧ｺ*count縺ｨ縺ｪ繧翫∪縺吶€�
sector
-
書き込みを開始するセクタ番号。LBAで指定されます。
+
譖ｸ縺崎ｾｼ縺ｿ繧帝幕蟋九☆繧九そ繧ｯ繧ｿ逡ｪ蜿ｷ縲�32繝薙ャ繝�LBA縺ｧ謖�螳壹＆繧後∪縺吶€�
count
-
書き込むセクタ数。FatFsからの呼び出しでは1～128の範囲に限られます。
+
譖ｸ縺崎ｾｼ繧€繧ｻ繧ｯ繧ｿ謨ｰ(1�ｽ�128)縲�
-

戻り値

+

謌ｻ繧雁€､

RES_OK (0)
-
正常終了。
+
豁｣蟶ｸ邨ゆｺ�縲�
RES_ERROR
-
書き込み中にエラーが発生し、その回復にも失敗した。
+
譖ｸ縺崎ｾｼ縺ｿ荳ｭ縺ｫ繧ｨ繝ｩ繝ｼ縺檎匱逕溘＠縲√◎縺ｮ蝗槫ｾｩ縺ｫ繧ょ､ｱ謨励＠縺溘€�
RES_WRPRT
-
メディアが書き込み禁止状態。
+
繝｡繝�繧｣繧｢縺梧嶌縺崎ｾｼ縺ｿ遖∵ｭ｢迥ｶ諷九€�
RES_PARERR
-
パラメータが不正。
+
繝代Λ繝｡繝ｼ繧ｿ縺御ｸ肴ｭ｣縲�
RES_NOTRDY
-
デバイスが動作可能状態ではない（初期化されていない）。
+
繝�繝舌う繧ｹ縺悟虚菴懷庄閭ｽ迥ｶ諷九〒縺ｯ縺ｪ縺��ｼ亥�晄悄蛹悶＆繧後※縺�縺ｪ縺��ｼ峨€�
-

解説

-

buffに指定されるアドレスは常にワード・アライメントされているとは限りません。詳細は、disk_read()の解説を参照してください。

-

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

-

FatFsはディスク関数が遅延書き込み機能を持つことも想定しています。この関数から戻るとき、デバイスが書き込み中とかキャッシュに書き込まれただけなど、必ずしもデータの書き込みが完了している必要はありません。ただし、buffのデータは、この関数から戻ると無効となります。書き込み完了の要求は、disk_ioctl()のCTRL_SYNCコマンドによって行われます。このような遅延書き込み機能が実装された場合、スループットをさらに向上させることができます。

-

アプリケーションからはこの関数を呼び出してはなりません。さもないと、FATボリュームが破壊される可能性があります。

+

隗｣隱ｬ

+

buff縺ｫ謖�螳壹＆繧後ｋ繧｢繝峨Ξ繧ｹ縺ｯ蟶ｸ縺ｫ繝ｯ繝ｼ繝� 繧｢繝ｩ繧､繝｡繝ｳ繝医＆繧後※縺�繧九→縺ｯ髯舌ｊ縺ｾ縺帙ｓ縲りｩｳ邏ｰ縺ｯ縲�disk_read()縺ｮ隗｣隱ｬ繧貞盾辣ｧ縺励※縺上□縺輔＞縲�

+

荳€闊ｬ逧�縺ｫ縲∬､�謨ｰ繧ｻ繧ｯ繧ｿ縺ｮ霆｢騾∬ｦ∵ｱゅ�ｯ縲√ョ繝舌う繧ｹ縺ｫ蟇ｾ縺励※蜿ｯ閭ｽ縺ｪ髯舌ｊ繝槭Ν繝� 繧ｻ繧ｯ繧ｿ霆｢騾√＠縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲り､�謨ｰ縺ｮ繧ｷ繝ｳ繧ｰ繝ｫ 繧ｻ繧ｯ繧ｿ譖ｸ縺崎ｾｼ縺ｿ縺ｫ蛻�隗｣縺輔ｌ縺溷ｴ蜷医€√せ繝ｫ繝ｼ繝励ャ繝医′闡励＠縺丈ｽ惹ｸ九☆繧九％縺ｨ縺後≠繧翫∪縺吶€�

+

FatFs縺ｯ繝�繧｣繧ｹ繧ｯ髢｢謨ｰ縺碁≦蟒ｶ譖ｸ縺崎ｾｼ縺ｿ讖溯�ｽ繧呈戟縺､縺薙→繧よΦ螳壹＠縺ｦ縺�縺ｾ縺吶€ゅ％縺ｮ髢｢謨ｰ縺九ｉ謌ｻ繧九→縺阪€√ョ繝舌う繧ｹ縺梧嶌縺崎ｾｼ縺ｿ荳ｭ縺ｨ縺九く繝｣繝�繧ｷ繝･縺ｫ譖ｸ縺崎ｾｼ縺ｾ繧後◆縺縺代↑縺ｩ縲∝ｿ�縺壹＠繧ゅΓ繝�繧｣繧｢縺ｸ縺ｮ譖ｸ縺崎ｾｼ縺ｿ縺悟ｮ御ｺ�縺励※縺�繧句ｿ�隕√�ｯ縺ゅｊ縺ｾ縺帙ｓ縲ゅ◆縺縺励€�buff縺ｮ繝�繝ｼ繧ｿ縺ｯ縲√％縺ｮ髢｢謨ｰ縺九ｉ謌ｻ繧九→辟｡蜉ｹ縺ｨ縺ｪ繧翫∪縺吶€よ嶌縺崎ｾｼ縺ｿ螳御ｺ�縺ｮ隕∵ｱゅ�ｯ縲�disk_ioctl()縺ｮCTRL_SYNC繧ｳ繝槭Φ繝峨↓繧医▲縺ｦ陦後ｏ繧後∪縺吶€ゅ％縺ｮ繧医≧縺ｪ驕�蟒ｶ譖ｸ縺崎ｾｼ縺ｿ讖溯�ｽ縺悟ｮ溯｣�縺輔ｌ縺溷ｴ蜷医€√せ繝ｫ繝ｼ繝励ャ繝医ｒ縺輔ｉ縺ｫ蜷台ｸ翫＆縺帙ｋ縺薙→縺後〒縺阪∪縺吶€�

+

繧｢繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺九ｉ縺ｯ縺薙�ｮ髢｢謨ｰ繧貞他縺ｳ蜃ｺ縺励※縺ｯ縺ｪ繧翫∪縺帙ｓ縲ゅ＆繧ゅ↑縺�縺ｨ縲：AT繝懊Μ繝･繝ｼ繝縺檎ｴ螢翫＆繧後ｋ蜿ｯ閭ｽ諤ｧ縺後≠繧翫∪縺吶€�

-

対応情報

-

リード・オンリー構成(_FS_READONLY == 1)ではこの関数は必要とされません。

+

蟇ｾ蠢懈ュ蝣ｱ

+

繝ｪ繝ｼ繝� 繧ｪ繝ｳ繝ｪ繝ｼ讒区��(_FS_READONLY == 1)縺ｧ縺ｯ縺薙�ｮ髢｢謨ｰ縺ｯ蠢�隕√→縺輔ｌ縺ｾ縺帙ｓ縲�

-

戻る

+

謌ｻ繧�

-- cgit v1.2.3