FS_LoadOverlayImageAsync

構文

#include <nitro/fs.h>

BOOL FS_LoadOverlayImageAsync(FSOverlayInfo *p_ovi, FSFile *p_file);

引数

p_ovi オーバーレイモジュールの情報が格納されたFSOverlayInfo構造体
p_file 非同期リードのために使用するFSFile構造体へのポインタ
この構造体はすでに何らかのファイルを開いた状態であってはなりません。
また、この関数が成功してリード処理が完了した後、FS_CloseFile()で明示的にクローズする必要があります。

返り値

オーバーレイモジュールのロード処理が正しく開始されれば TRUE を返し、そうでない場合は、FALSE を返します。

説明

オーバーレイモジュールのイメージをメモリへ非同期にロードします。
この関数が成功すると、指定されたp_fileはファイルを開いてリード中の状態になります。
このリード処理の完了を待つと FS_LoadOverlayImage() と等価になります。

ロードされた既存のオーバーレイと領域を競合する他のオーバーレイをロードする場合、
必ず以前のオーバーレイを FS_UnloadOverlay() でアンロードする必要があります。


同等の処理を行う他のオーバーレイ関数との関係については
FS_LoadOverlay() のリファレンスに記載された例を参照ください。

参照

FSOverlayInfo
FS_LoadOverlayInfo FS_GetOverlayTotalSize FS_GetOverlayAddress FS_GetOverlayFileID FS_LoadOverlayImage FS_StartOverlay FS_UnloadOverlayImage FS_LoadOverlay

履歴

2004/11/17 FS_RegisterOverlayToDebugger()廃止に関する記述修正
2004/11/16 初版