#include <nitro/fs.h>
BOOL FS_LoadOverlayImageAsync(FSOverlayInfo *p_ovi, FSFile *p_file);
p_ovi | FSOverlayInfo structure that holds overlay module information. |
p_file |
Pointer to the FSFile structure used for asynchronous reading. This structure's state must not indicate that a file is already open. Once this function succeeds and the read process ends, you must explicitly close the file using the FS_CloseFile function. |
Returns a value of TRUE if the overlay module's load process started correctly. Otherwise, a value of FALSE is returned.
This function asynchronously loads the image of an overlay module to memory. If this function succeeds, the specified p_file
opens the file and enters the reading state. When it inherits the end of the read process, it takes the same value as FS_LoadOverlayImage.
When loading an overlay whose area conflicts with an existing loaded overlay, you must unload the previous overlay using the FS_UnloadOverlay
function.
For information about the relationship with other overlay functions that perform equivalent processes see the example stated in the reference for the FS_LoadOverlay
function.
FSOverlayInfo, FS_LoadOverlayInfo, FS_GetOverlayTotalSize, FS_GetOverlayAddress, FS_GetOverlayFileID, FS_LoadOverlayImage, FS_StartOverlay, FS_UnloadOverlayImage FS_LoadOverlay,
11/17/2004 Made corrections regarding FS_RegisterOverlayToDebugger
, which is no longer needed.
11/16/2004 Initial version.