#include <nitro/mb.h>
int MB_Init(void *work, const MBUserInfo *user, u32 ggid, u32 tgid, u32 dma);
work | Pointer to memory allocated for the internal state management of the MB library. This size must equal or exceed the byte size in MB_SYSTEM_BUF_SIZE . (If you can ensure that MB_StartParentFromIdle is called after MB_Init , you can reduce the size by WM_SYSTEM_BUF_SIZE bytes.) The allocated memory is used internally until MB_End is called. |
user | Pointer to the structure in which user data is saved. The content specified by this pointer is referenced only in the MB_Init function. |
ggid | Specifies a 4-byte game group ID. |
tgid | A 16-bit value from 0x0000 to 0xFFFF that indicates the TGID value. When MB_TGID_AUTO is assigned to this value, the TGID will be automatically obtained by internally calling WM_GetNextTgid . At the initial program launch (IPL), the display information is not updated when the tgid , ggid , and MAC address are the same (a single parent is assumed). After a parent terminates, the user information displayed in the child IPL may not be updated if the user name was updated and restarted as an MB parent.When not specifying MB_TGID_AUTO, use OS_GetVBlankCount or RTC like a random number generator to set a different value whenever a restart occurs. |
dma | The DMA channel allocated for MB internal processing. The DMA channel is used internally until the MB_End function is called. |
Returns MB_SUCCESS if the initialization completes successfully.
This function initializes the multi-boot (MB) library. The MB_Init
function must be called once before any MB function is called. However, if you call MB_Init
more than once, nothing happens. After calling this function, but before calling MB_StartParent
, use MB_SetParentCommParam
to set the maximum number of connected children.
MBUserInfo, MB_StartParent, MB_StartParentFromIdle, MB_SetParentCommParam, MB_End, OS_GetVBlankCount
04/11/2005 Expanded the type of the tgid
argument to u32 and added description for MB_TGID_AUTO
.
11/24/2004 Changed name: MB_StartParentEx
to MB_StartParentFromIdle
.
10/18/2004 Added a description of MB_StartParentEx
and several links.
10/05/2004 Corrected an error in the description of internal operation.
09/30/2004 Added argument.
08/09/2004 Initial version.