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/forward.html | 72 +++++++++++++++++++++++------------------------ 1 file changed, 36 insertions(+), 36 deletions(-) (limited to 'fatfs/doc/ja/forward.html') diff --git a/fatfs/doc/ja/forward.html b/fatfs/doc/ja/forward.html index ffb2e60..e9212ce 100644 --- a/fatfs/doc/ja/forward.html +++ b/fatfs/doc/ja/forward.html @@ -1,7 +1,7 @@ - + @@ -13,34 +13,34 @@

f_forward

-

ファイルからデータを読み出し、送信ストリームに直接転送します。

+

繝輔ぃ繧､繝ｫ縺九ｉ繝�繝ｼ繧ｿ繧定ｪｭ縺ｿ蜃ｺ縺励€�騾∽ｿ｡繧ｹ繝医Μ繝ｼ繝縺ｫ逶ｴ謗･霆｢騾√＠縺ｾ縺吶€�

 FRESULT f_forward (
-  FIL* fp,                         /* [IN] ファイル・オブジェクト構造体 */
-  UINT (*func)(const BYTE*,UINT),  /* [IN] データ転送関数 */
-  UINT btf,                        /* [IN] 転送するバイト数 */
-  UINT* bf                         /* [OUT] 転送されたバイト数 */
+  FIL* fp,                         /* [IN] 繝輔ぃ繧､繝ｫ 繧ｪ繝悶ず繧ｧ繧ｯ繝域ｧ矩€菴� */
+  UINT (*func)(const BYTE*,UINT),  /* [IN] 繝�繝ｼ繧ｿ霆｢騾�髢｢謨ｰ */
+  UINT btf,                        /* [IN] 霆｢騾√☆繧九ヰ繧､繝域焚 */
+  UINT* bf                         /* [OUT] 霆｢騾√＆繧後◆繝舌う繝域焚 */
 );
-

引数

+

蠑墓焚

fp
-
ファイル・オブジェクト構造体へのポインタを指定します。
+
繝輔ぃ繧､繝ｫ 繧ｪ繝悶ず繧ｧ繧ｯ繝域ｧ矩€菴薙∈縺ｮ繝昴う繝ｳ繧ｿ繧呈欠螳壹＠縺ｾ縺吶€�
func
-
データを渡すユーザ定義関数へのポインタを指定します。この関数の仕様はサンプルを参照してください。
+
繝�繝ｼ繧ｿ繧呈ｸ｡縺吶Θ繝ｼ繧ｶ螳夂ｾｩ髢｢謨ｰ縺ｸ縺ｮ繝昴う繝ｳ繧ｿ繧呈欠螳壹＠縺ｾ縺吶€ゅ％縺ｮ髢｢謨ｰ縺ｮ莉墓ｧ倥�ｯ繧ｵ繝ｳ繝励Ν繧貞盾辣ｧ縺励※縺上□縺輔＞縲�
btf
-
転送するバイト数(0～UINTの最大値)を指定します。
+
霆｢騾√☆繧九ヰ繧､繝域焚(0�ｽ朸INT縺ｮ譛€螟ｧ蛟､)繧呈欠螳壹＠縺ｾ縺吶€�
bf
-
実際に転送されたバイト数を格納する変数を指すポインタを指定します。
+
螳滄圀縺ｫ霆｢騾√＆繧後◆繝舌う繝域焚繧呈ｼ邏阪☆繧句､画焚繧呈欠縺吶�昴う繝ｳ繧ｿ繧呈欠螳壹＠縺ｾ縺吶€�
-

戻り値

+

謌ｻ繧雁€､

FR_OK, FR_DISK_ERR, @@ -54,40 +54,40 @@ FRESULT f_forward (

-

解説

-

ファイルのデータをバッファに読み出さずに送信ストリームに直接転送します。アプリケーション側でデータ・バッファを必要としないので、メモリの限られた環境で有効です。リード/ライト・ポインタは転送されたバイト数だけ進みます。指定されたバイト数の転送中にファイルの終端に達した場合や送信ストリームがビジーになった場合、*bfはbtfよりも小さくなります。

+

隗｣隱ｬ

+

繝輔ぃ繧､繝ｫ縺ｮ繝�繝ｼ繧ｿ繧偵ヰ繝�繝輔ぃ縺ｫ隱ｭ縺ｿ蜃ｺ縺輔★縺ｫ騾∽ｿ｡繧ｹ繝医Μ繝ｼ繝縺ｫ逶ｴ謗･霆｢騾√＠縺ｾ縺吶€ゅい繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ蛛ｴ縺ｧ繝�繝ｼ繧ｿ 繝舌ャ繝輔ぃ繧貞ｿ�隕√→縺励↑縺�縺ｮ縺ｧ縲√Γ繝｢繝ｪ縺ｮ髯舌ｉ繧後◆迺ｰ蠅�縺ｧ譛牙柑縺ｧ縺吶€ゅΜ繝ｼ繝�/繝ｩ繧､繝� 繝昴う繝ｳ繧ｿ縺ｯ霆｢騾√＆繧後◆繝舌う繝域焚縺縺鷹€ｲ縺ｿ縺ｾ縺吶€よ欠螳壹＆繧後◆繝舌う繝域焚縺ｮ霆｢騾∽ｸｭ縺ｫ繝輔ぃ繧､繝ｫ縺ｮ邨らｫｯ縺ｫ驕斐＠縺溷ｴ蜷医ｄ騾∽ｿ｡繧ｹ繝医Μ繝ｼ繝縺後ン繧ｸ繝ｼ縺ｫ縺ｪ縺｣縺溷ｴ蜷医€�*bf縺ｯbtf繧医ｊ繧ょｰ上＆縺上↑繧翫∪縺吶€�

-

対応情報

-

_USE_FORWARD == 1で、且つ_FS_TINY == 1のときに使用可能です。

+

蟇ｾ蠢懈ュ蝣ｱ

+

_USE_FORWARD == 1縺ｧ縲∽ｸ斐▽_FS_TINY == 1縺ｮ縺ｨ縺阪↓菴ｿ逕ｨ蜿ｯ閭ｽ縺ｧ縺吶€�

-

使用例（オーディオ再生）

+

菴ｿ逕ｨ萓具ｼ医が繝ｼ繝�繧｣繧ｪ蜀咲函�ｼ�

 /*-----------------------------------------------------------------------*/
-/* f_forward関数から呼ばれるデータ送信関数の例                           */
+/* f_forward髢｢謨ｰ縺九ｉ蜻ｼ縺ｰ繧後ｋ繝�繝ｼ繧ｿ騾∽ｿ｡髢｢謨ｰ縺ｮ萓�                           */
 /*-----------------------------------------------------------------------*/
 
-UINT out_stream (   /* 戻り値: 転送されたバイト数またはストリームの状態 */
-    const BYTE *p,  /* 転送するデータを指すポインタ */
-    UINT btf        /* >0: 転送を行う(バイト数). 0: ストリームの状態を調べる */
+UINT out_stream (   /* 謌ｻ繧雁€､: 霆｢騾√＆繧後◆繝舌う繝域焚縺ｾ縺溘�ｯ繧ｹ繝医Μ繝ｼ繝縺ｮ迥ｶ諷� */
+    const BYTE *p,  /* 霆｢騾√☆繧九ョ繝ｼ繧ｿ繧呈欠縺吶�昴う繝ｳ繧ｿ */
+    UINT btf        /* >0: 霆｢騾√ｒ陦後≧(繝舌う繝域焚). 0: 繧ｹ繝医Μ繝ｼ繝縺ｮ迥ｶ諷九ｒ隱ｿ縺ｹ繧� */
 )
 {
     UINT cnt = 0;
 
 
-    if (btf == 0) {     /* センス要求 */
-        /* ストリームの状態を返す (0: ビジー, 1: レディ) */
-        /* 一旦、レディを返したら、続く転送要求で少なくとも1バイトは */
-        /* 転送されないと f_forward関数は FR_INT_ERR となる。 */
+    if (btf == 0) {     /* 繧ｻ繝ｳ繧ｹ隕∵ｱ� */
+        /* 繧ｹ繝医Μ繝ｼ繝縺ｮ迥ｶ諷九ｒ霑斐☆ (0: 繝薙ず繝ｼ, 1: 繝ｬ繝�繧｣) */
+        /* 荳€譌ｦ縲√Ξ繝�繧｣繧定ｿ斐＠縺溘ｉ縲∫ｶ壹￥霆｢騾∬ｦ∵ｱゅ〒蟆代↑縺上→繧�1繝舌う繝医�ｯ */
+        /* 霆｢騾√＆繧後↑縺�縺ｨ f_forward髢｢謨ｰ縺ｯ FR_INT_ERR 縺ｨ縺ｪ繧九€� */
         if (FIFO_READY) cnt = 1;
     }
-    else {              /* 転送要求 */
-        do {    /* 全てのバイトを転送するか、ストリームがビジーになるまで繰り返す */
+    else {              /* 霆｢騾∬ｦ∵ｱ� */
+        do {    /* 蜈ｨ縺ｦ縺ｮ繝舌う繝医ｒ霆｢騾√☆繧九°縲√せ繝医Μ繝ｼ繝縺後ン繧ｸ繝ｼ縺ｫ縺ｪ繧九∪縺ｧ郢ｰ繧願ｿ斐☆ */
             FIFO_PORT = *p++;
             cnt++;
         } while (cnt < btf && FIFO_READY);
@@ -98,31 +98,31 @@ UINT out_stream (   /* 
 
 
 /*-----------------------------------------------------------------------*/
-/* f_forward関数の使用例                                                 */
+/* f_forward髢｢謨ｰ縺ｮ菴ｿ逕ｨ萓�                                                 */
 /*-----------------------------------------------------------------------*/
 
 FRESULT play_file (
-    char *fn        /* 再生するオーディオ・ファイル名を指すポインタ */
+    char *fn        /* 蜀咲函縺吶ｋ繧ｪ繝ｼ繝�繧｣繧ｪ 繝輔ぃ繧､繝ｫ蜷阪ｒ謖�縺吶�昴う繝ｳ繧ｿ */
 )
 {
     FRESULT rc;
     FIL fil;
     UINT dmy;
 
-    /* ファイルを読み出しモードで開く */
+    /* 繝輔ぃ繧､繝ｫ繧定ｪｭ縺ｿ蜃ｺ縺励Δ繝ｼ繝峨〒髢九￥ */
     rc = f_open(&fil, fn, FA_READ);
     if (rc) return rc;
 
-    /* 全てのデータが転送されるかエラーが発生するまで続ける */
+    /* 蜈ｨ縺ｦ縺ｮ繝�繝ｼ繧ｿ縺瑚ｻ｢騾√＆繧後ｋ縺九お繝ｩ繝ｼ縺檎匱逕溘☆繧九∪縺ｧ邯壹￠繧� */
     while (rc == FR_OK && fil.fptr < fil.fsize) {
 
-        /* ほかの処理... */
+        /* 縺ｻ縺九�ｮ蜃ｦ逅�... */
 
-        /* 定期的または要求に応じてデータをストリームに送出する */
+        /* 螳壽悄逧�縺ｾ縺溘�ｯ隕∵ｱゅ↓蠢懊§縺ｦ繝�繝ｼ繧ｿ繧偵せ繝医Μ繝ｼ繝縺ｫ騾∝�ｺ縺吶ｋ */
         rc = f_forward(&fil, out_stream, 1000, &dmy);
     }
 
-    /* ファイルを閉じて戻る */
+    /* 繝輔ぃ繧､繝ｫ繧帝哩縺倥※謌ｻ繧� */
     f_close(&fil);
     return rc;
 }
@@ -131,10 +131,10 @@ FRESULT play_file (
 
 
 

-
参照

+
蜿ら�ｧ

 
f_open, fgets, f_write, f_close, FIL

 

 
-
戻る

+
謌ｻ繧�

 
 
-- 
cgit v1.2.3