#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]; u8 userParam[MB_DOWNLOAD_PARAMETER_SIZE]; } MBGameRegistry;
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 | Description |
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 is 16 machines. 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. |
userParam | These are the user-defined extended parameters, which can be provided to the child program that started up this game. Up to MB_DOWNLOAD_PARAMETER_SIZE (=32) bytes of data can be freely configured. The child program that was started up can reference this data by calling the MB_GetMultiBootDownloadParameter function.
|
MB_GAME_* MBIconInfo MBParentBssDesc WMBssDesc
MB_GetMultiBootParentBssDesc MB_GetMultiBootDownloadParameter MB_ReadMultiBootParentBssDesc MB_RegisterFile
08/17/2005 Added link to MB_GetMultiBootDownloadParameter function.
05/20/2005 Added member userParam.
11/02/2004 Corrected member names.
10/18/2004 Corrected the description of ggid
.
10/05/2004 Corrected description of ggid
.
09/27/2004 Added links.
09/10/2004 Revised the description of iconCharp
and iconPalettep
.
08/09/2004 Initial version.