1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.1.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>CTRDG_DummyInit</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">CTRDG_DummyInit <IMG src="../image/NTR.gif" align="middle"><IMG src="../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15  <PRE><CODE>#include &lt;nitro/ctrdg.h&gt;</CODE></PRE>
16  <PRE><CODE>void CTRDG_DummyInit( void );
17  </CODE></PRE>
18</DL>
19<H2>Arguments</H2>
20<P>None.</P>
21<H2>Return Values</H2>
22<P>None.</P>
23<H2>Description</H2>
24<P>Initializes the Game Pak library in special applications.</P>
25<P>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, <A href="CTRDG_Init.html"><CODE>CTRDG_Init</CODE></A>, which can be redefined in the application for this specific purpose. There is no other purpose for this function.</P>
26
27<P>The description method is as follows.</P>
28<BLOCKQUOTE style="background-color:#ffffcc"><CODE>void CTRDG_Init(void)<BR> {<BR> <FONT color="#ff0000">CTRDG_DummyInit();</FONT><BR> }<BR></CODE></BLOCKQUOTE>
29<P>By defining the <CODE>CTRDG_Init</CODE> 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.</P>
30<H2>Note</H2>
31<P>If you follow the method explained in this reference to reduce the amount of memory occupied by the <CODE>CTRDG_*</CODE> 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.</P>
32<P><FONT color="#ff0000"><B>This method cannot be used for TWL limited ROMs. </B></FONT>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 <A href="CTRDG_Init.html"><CODE>CTRDG_Init</CODE></A> 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 <A href="CTRDG_Init.html"><CODE>CTRDG_Init</CODE></A> function is defined as an inline function.</P>
33<P>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.</P>
34<H2>See Also</H2>
35<P><A href="CTRDG_Init.html"><CODE>CTRDG_Init</CODE></A></P>
36<H2>Revision History</H2>
37<P>2008/01/28 Initial version.</P>
38<hr><p>CONFIDENTIAL</p></body>
39</HTML>
40