fatfs/doc/ja/forward.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html lang="ja">
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   5 <meta http-equiv="Content-Style-Type" content="text/css">
   6 <link rel="up" title="FatFs" href="../00index_j.html">
   7 <link rel="alternate" hreflang="en" title="English" href="../en/forward.html">
   8 <link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
   9 <title>FatFs - f_forward</title>
  10 </head>
  11
  12 <body>
  13
  14 <div class="para func">
  15 <h2>f_forward</h2>
  16 <p>ファイルからデータを読み出し、送信ストリームに直接転送します。</p>
  17 <pre>
  18 FRESULT f_forward (
  19   FIL* <span class="arg">fp</span>,                         <span class="c">/* [IN] ファイル オブジェクト構造体 */</span>
  20   UINT (*<span class="arg">func</span>)(const BYTE*,UINT),  <span class="c">/* [IN] データ転送関数 */</span>
  21   UINT <span class="arg">btf</span>,                        <span class="c">/* [IN] 転送するバイト数 */</span>
  22   UINT* <span class="arg">bf</span>                         <span class="c">/* [OUT] 転送されたバイト数 */</span>
  23 );
  24 </pre>
  25 </div>
  26
  27 <div class="para arg">
  28 <h4>引数</h4>
  29 <dl class="par">
  30 <dt>fp</dt>
  31 <dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>
  32 <dt>func</dt>
  33 <dd>データを渡すユーザ定義関数へのポインタを指定します。この関数の仕様はサンプルを参照してください。</dd>
  34 <dt>btf</dt>
  35 <dd>転送するバイト数(0～UINTの最大値)を指定します。</dd>
  36 <dt>bf</dt>
  37 <dd>実際に転送されたバイト数を格納する変数を指すポインタを指定します。</dd>
  38 </dl>
  39 </div>
  40
  41
  42 <div class="para ret">
  43 <h4>戻り値</h4>
  44 <p>
  45 <a href="rc.html#ok">FR_OK</a>,
  46 <a href="rc.html#de">FR_DISK_ERR</a>,
  47 <a href="rc.html#ie">FR_INT_ERR</a>,
  48 <a href="rc.html#nr">FR_NOT_READY</a>,
  49 <a href="rc.html#de">FR_DENIED</a>,
  50 <a href="rc.html#io">FR_INVALID_OBJECT</a>,
  51 <a href="rc.html#tm">FR_TIMEOUT</a>
  52 </p>
  53 </div>
  54
  55
  56 <div class="para desc">
  57 <h4>解説</h4>
  58 <p>ファイルのデータをバッファに読み出さずに送信ストリームに直接転送します。アプリケーション側でデータ バッファを必要としないので、メモリの限られた環境で有効です。リード/ライト ポインタは転送されたバイト数だけ進みます。指定されたバイト数の転送中にファイルの終端に達した場合や送信ストリームがビジーになった場合、<tt class="arg">*bf</tt>は<tt class="arg">btf</tt>よりも小さくなります。</p>
  59 </div>
  60
  61
  62 <div class="para comp">
  63 <h4>対応情報</h4>
  64 <p><tt>_USE_FORWARD == 1</tt>で、且つ<tt>_FS_TINY == 1</tt>のときに使用可能です。</p>
  65 </div>
  66
  67
  68 <div class="para use">
  69 <h4>使用例（オーディオ再生）</h4>
  70 <pre>
  71 <span class="c">/*-----------------------------------------------------------------------*/</span>
  72 <span class="c">/* f_forward関数から呼ばれるデータ送信関数の例                           */</span>
  73 <span class="c">/*-----------------------------------------------------------------------*/</span>
  74
  75 UINT out_stream (   <span class="c">/* 戻り値: 転送されたバイト数またはストリームの状態 */</span>
  76     const BYTE *p,  <span class="c">/* 転送するデータを指すポインタ */</span>
  77     UINT btf        <span class="c">/* &gt;0: 転送を行う(バイト数). 0: ストリームの状態を調べる */</span>
  78 )
  79 {
  80     UINT cnt = 0;
  81
  82
  83     if (btf == 0) {     <span class="c">/* センス要求 */</span>
  84         <span class="c">/* ストリームの状態を返す (0: ビジー, 1: レディ) */</span>
  85         <span class="c">/* 一旦、レディを返したら、続く転送要求で少なくとも1バイトは */</span>
  86         <span class="c">/* 転送されないと f_forward関数は FR_INT_ERR となる。 */</span>
  87         if (FIFO_READY) cnt = 1;
  88     }
  89     else {              <span class="c">/* 転送要求 */</span>
  90         do {    <span class="c">/* 全てのバイトを転送するか、ストリームがビジーになるまで繰り返す */</span>
  91             FIFO_PORT = *p++;
  92             cnt++;
  93         } while (cnt &lt; btf &amp;&amp; FIFO_READY);
  94     }
  95
  96     return cnt;
  97 }
  98
  99
 100 <span class="c">/*-----------------------------------------------------------------------*/</span>
 101 <span class="c">/* f_forward関数の使用例                                                 */</span>
 102 <span class="c">/*-----------------------------------------------------------------------*/</span>
 103
 104 FRESULT play_file (
 105     char *fn        <span class="c">/* 再生するオーディオ ファイル名を指すポインタ */</span>
 106 )
 107 {
 108     FRESULT rc;
 109     FIL fil;
 110     UINT dmy;
 111
 112     <span class="c">/* ファイルを読み出しモードで開く */</span>
 113     rc = f_open(&amp;fil, fn, FA_READ);
 114     if (rc) return rc;
 115
 116     <span class="c">/* 全てのデータが転送されるかエラーが発生するまで続ける */</span>
 117     while (rc == FR_OK &amp;&amp; fil.fptr &lt; fil.fsize) {
 118
 119         <span class="c">/* ほかの処理... */</span>
 120
 121         <span class="c">/* 定期的または要求に応じてデータをストリームに送出する */</span>
 122         rc = f_forward(&amp;fil, out_stream, 1000, &amp;dmy);
 123     }
 124
 125     <span class="c">/* ファイルを閉じて戻る */</span>
 126     f_close(&amp;fil);
 127     return rc;
 128 }
 129 </pre>
 130 </div>
 131
 132
 133 <div class="para ref">
 134 <h4>参照</h4>
 135 <p><tt><a href="open.html">f_open</a>, <a href="gets.html">fgets</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p>
 136 </div>
 137
 138 <p class="foot"><a href="../00index_j.html">戻る</a></p>
 139 </body>
 140 </html>