# 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 初版