#include <nitro/ctrdg.h>void CTRDG_DummyInit( void );
None.
None.
Initializes the Game Pak library in special applications.
This function has been prepared as a way to reduce the amount of memory occupied by the Game Pak library. It is designed to be called from inside the weak function, CTRDG_Init, which can be redefined in the application for this specific purpose. There is no other purpose for this function.
The description method is as follows.
void CTRDG_Init(void)
{
CTRDG_DummyInit();
}
By defining the CTRDG_Init function in this way in the application, most of the functions of the Game Pak library will not be linked, and less memory will be occupied.
If you follow the method explained in this reference to reduce the amount of memory occupied by the CTRDG_* functions, you will not be able to access Game Paks, and so you will not be able to call Game Pak-related access functions. For a DEBUG build, assertions are generated by many of the functions.
This method cannot be used for TWL limited ROMs. If you attempt this with a TWL limited ROM, you will generate a compile error. Because the TWL hardware does not have a Game Pak slot, the CTRDG_Init function is initialized in a minimal way, and most of the functions of the Game Pak library will not be linked in the first place for TWL limited ROMs. The method explained here is therefore not required. The CTRDG_Init function is defined as an inline function.
You would use this method when creating NITRO-only and NITRO/TWL hybrid ROMs. In either case, one condition is that the application will not be using the Game Pak slot. All Game Pak access will be ignored, so the removal of a Game Pak will not be detected, either.
2008/01/28 Initial version.
CONFIDENTIAL