DWC_GdbDownloadFileAsync

構文

#include <dwc.h>
DWCGdbError DWC_GdbDownloadFileAsync(int file_id,
                                     int buf_size,
                                     BOOL clear_buf,
                                     DWCGdbDownloadFileCallback callback,
                                     void *user_param);

引数

file_id 取得するファイルのファイルID
buf_size ダウンロードするファイルを格納する受信バッファのサイズを指定します。0を指定すると、2048バイトごとに拡張されますが、処理が重いため、予め最大サイズがわかっている場合はここで指定した方が適切です。
clear_buf コールバック終了後に受信バッファを解放するか否か
callback ダウンロードしたファイルを受け取るコールバック
user_param コールバックに渡される任意の値

返り値

エラーの内容

説明

ファイルをダウンロードする非同期処理を開始します。

処理が成功すると、引数callbackで指定したコールバック関数が呼ばれ、file_idで指定したIDのファイルが取得されます。
処理が失敗した場合はコールバックが呼ばれませんのでご注意ください。

返値としてDWC_GDB_ERROR_NONEが返された場合は、非同期処理が開始しています。DWC_GdbGetState関数がDWC_GDB_STATE_IN_ASYNC_PROCESSを返さなくなくなるまで待ってください。

処理の結果は、DWC_GdbGetAsyncResult関数で取得できます。

簡易データベースライブラリの非同期処理は、通信の切断等により、稀にいつまでたっても終わらなくなる可能性がありますので、必ずアプリケーションでタイムアウトを設定するようにして下さい。

履歴

5.1pr2より前の変更履歴はこちら