MBGameRegistry


C Specification

#include <nitro/mb.h>

typedef struct
{
    const char      *romFilePathp;
          u16       *gameNamep;
          u16       *gameIntroductionp;
    const char      *iconCharPathp;
    const char      *iconPalettePathp;
          u32       ggid;
          u8        maxPlayerNum;
          u8        pad[3];
} MBGameRegistry;

Description

This file defines the structure used when specifying the download file with the MB_RegistryFile function.

The meaning of each member is shown in the following table:

Member Meaning
romFilePathp Pointer to the file path string of the program binary.
The current implementation of the MB function requests the pointer to the FSFile structure that does not reference this member.
Note: romFilePathp is provided for future enhancements.
gameNamep Pointer to the game name string. The string must be less than MB_GAME_NAME_LENGTH.
gameIntroductionp Pointer to the introduction string of the game content. The string must be less than MB_GAME_INTRO_LENGTH.
iconCharPathp Pointer that indicates path character string to icon character data file.
iconPalettePathp Pointer that indicates path character string to icon palette data file.
ggid GGID value that is passed to a child when this game is downloaded.
This value is stored in little endian format in ssid[0], ssid[1], ssid[2], and ssid[3] of the MBParentBssDesc structure which the multiboot child obtained with the MB_GetMultiBootParentBssDesc function.
The MB_ReadMultiBootParentBssDesc function uses this value to create the WMBssDesc information that is used to connect to the parent.
When not used for another purpose, GGID can be used as a random u32 value.
maxPlayerNum The maximum number of simultaneous players for this game, including the parent. The maximum number of children that can be connected via multiboot is set with MB_SetParentCommParam, which does not include the parent. So MB_SetParentCommParam is 1 less than the MBGameRegistry value.

See Also

MB_GAME_*, MBIconInfo, MBParentBssDesc, WMBssDesc, MB_GetMultiBootParentBssDesc, MB_ReadMultiBootParentBssDesc, MB_RegisterFile

Revision History

11/02/2004 Corrected 2 member names.
10/18/2004 Corrected the descriptions of ggid and maxPlayerNum.
10/05/2004 Corrected description regarding ggid.
09/27/2004 Added links.
09/10/2004 Revised the description of iconCharp and iconPalettep.
08/09/2004 Initial version.