#include <nitro/mb.h>BOOL MB_RegisterFile(const MBGameRegistry *game_reg, const void *buf);
| 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. |
This function returns TRUE when the program registers correctly. Otherwise, it returns FALSE.
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.
(Note)
When a DS Single-Card Play child selects a game on the IPL, the game will be downloaded from a parent that is not selected, if the following procedure is performed on the parent side. This bug can be prevented from occuring by having the game application set a different GGID in the MBGameRegistry structure for each game registered using the MB_RegisterFile function. For further details, read the section about clone booting in the document that explains DS Single-Card Play ($NitroSDK/docs/TechnicalNotes/AboutMultiBoot.pdf).
MBGameRegistry, MB_GetSegmentLength, MB_ReadSegment, MB_UnregisterFile
02/22/2005 Added a description of problems with DS single-card play.
04/11/2005 Added a note and link regarding task threads.
09/09/2004 Added a description of MB_UnregisterFile functions.
08/09/2004 Initial version.
CONFIDENTIAL