WFS_RequestClientRead

構文

#include <nitro/wfs.h>

void WFS_RequestClientRead(WFSClientContext *context, void *buffer, u32 offset, u32 length,
                                   WFSRequestClientReadDoneCallback callback, void *arg);

引数

context	WFSClientContext構造体のポインタ
buffer	読み込むデータの格納先メモリ
offset	読み込むデータのデバイス内アドレス
length	読み込むデータサイズ
callback	WFSRequestClientReadDoneCallback形式の読み込み完了コールバック不要ならNULLを指定します。
arg	読み込み完了コールバックに与える任意の引数

返り値

なし。

説明

親機(サーバ)へROMイメージ読み込みリクエストを発行します。ライブラリ内部では、これ以降のMP通信フック関数を経由して自動的にブロック転送が実行されます。
リクエストが完了するかリクエスト処理中にWFS_EndClient( )が呼び出されると、 WFSRequestClientReadDoneCallback形式で完了コールバックとして通知されます。

この関数は、クライアントの準備が完了してWFS_EVENT_CLIENT_READYイベント通知が発生した後でないと使用できません。また、前回のリクエストが完了するまでは再びこの関数を呼び出すことはできません。

リクエストの進捗状況を確認するにはWFS_GetClientReadProgress( )を使用します。

参照

WFSEventCallback, WFSEventType,
WFS_GetClientReadProgress

履歴

2007/06/11 引数追加
2007/06/06 初版