MI_LoadCache

構文

#include <nitro/mi.h>

  

  void MI_LoadCache(MICache *cache, MIDevice *device);

引数

cache	アクセスする`MICache`構造体へのポインタ `MI_InitCache()`で初期化されている必要があります。
device	ロード対象となるデバイスを指す`MIDevice`構造体へのポインタ `MI_InitDevice()`で初期化されている必要があります。

返り値

なし。

説明

キャッシュページリスト内でロード待ち状態にある全てのページのデータをデバイスから読み込みます。
この関数の内部からMI_ReadDevice()が呼び出されてロード済み状態のページとなり、以前呼び出して失敗したMI_ReadCache()は次回の呼び出しから成功するようになります。

この関数はスレッドセーフです。別のスレッドがMI_ReadCache()などを呼び出している間でも使用することが出来ます。

ロード待ち状態のページが存在するかどうかを判定するにはMI_IsCacheLoading()を使用します。
アプリケーションは、この関数を適切なタイミングで呼び出してロード待ち状態のページをロード済み状態にする必要があります。
ロード待ち状態のページが存在しないときにこの関数を呼び出した場合、何も行いません。

この機能は、デバイス読み込みアクセスを効率よく行うためのユーティリティです。
詳細はMICache構造体のリファレンスをご参照ください。

参照

MI_InitCache MI_ReadCache MI_IsCacheLoading MICache

履歴

2007/05/16 初版