MB_RegisterFile

C Specification

#include <nitro/mb.h>

BOOL MB_RegisterFile(const MBGameRegistry *game_reg, const void *buf);

Arguments

game_reg Pointer to the MBGameRegistry structure where the program information to register is saved.
buf Pointer to the memory where the extracted segment is saved. Get the segment data with the MB_ReadSegment function. When the function succeeds, the memory specified here is used internally until the MB_UnregisterFile function is called.

Return Values

This function returns TRUE when the program registers correctly. Otherwise, it returns FALSE.

Description

This function registers the specified program file on the download program list. The parent can simultaneously download game programs up to MB_MAX_FILE. The specified segment data must be obtained by calling MB_ReadSegment before calling this function. When calling this function using segment data that is set for dynamic reading from an archive, note that the MB library will internally start a single thread automatically. For details, see the "Internal Operation" section of the MB_ReadSegment function.

See Also

MBGameRegistry, MB_GetSegmentLength, MB_ReadSegment, MB_UnregisterFile

Revision History

04/11/2005 Added warning about task thread and link.
09/09/2004 Added description regarding the MB_UnregisterFile function.
08/09/2004 Initial version.