1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.1.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>CTRDG_Enable</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">CTRDG_Enable <IMG src="../image/NTR.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/ctrdg.h&gt;</CODE><BR>
20  <BR>
21  <CODE>void CTRDG_Enable(BOOL enable);</CODE><br>
22  <br>
23  </dd>
24</dl>
25<h2>Arguments</h2>
26<TABLE border="1" width="100%">
27  <TBODY>
28    <TR>
29<TD width="13%"><SPAN class="argument">enable</SPAN></TD>
30<TD width="87%">AGB Cartridge access permission setting.<br> Access is enabled when set to <code>TRUE</code> and disabled when set to <code>FALSE</code>.</TD>
31    </TR>
32  </TBODY>
33</TABLE>
34<h2>Return Values</h2>
35<p>None.</p>
36
37<H2>Description</H2>
38<P>Toggles whether access to the AGB Game Pak is enabled or disabled. The program forcibly halts if an attempt is made to access the AGB Game Pak while access is disabled. The following is a list of the CTRDG library functions which are affected by the access permission setting made using this function. <br></p>
39<ul>
40<li><a href="CTRDG_DmaCopy.html"><CODE>CTRDG_DmaCopy*</CODE></a>
41<li><a href="CTRDG_CpuCopy.html"><CODE>CTRDG_CpuCopy*</CODE></a>
42<li><a href="CTRDG_Read.html"><CODE>CTRDG_Read*</CODE></a>
43<li><a href="CTRDG_Write.html"><CODE>CTRDG_Write*</CODE></a>
44</ul>
45<p>The default value for the access permission status is <CODE>FALSE</CODE>. </p>
46<H2>Note</H2>
47<P>
48If you are going to use this function to enable access, be sure to follow the stipulations in the <I>Programming Guidelines</I>. Confirm that the procedure is correct before calling the function.
49</p>
50<h2>See Also</h2>
51<p>
52<A href="CTRDG_Init.html"><CODE>CTRDG_Init</CODE></A><BR> <A href="CTRDG_IsEnabled.html"><CODE>CTRDG_IsEnabled</CODE></A><BR> <A href="CTRDG_CheckEnabled.html"><CODE>CTRDG_CheckEnabled</CODE></A><BR> <A href="CTRDG_GetAgbMakerCode.html"><CODE>CTRDG_GetAgbMakerCod</CODE>e</A><BR> <A href="CTRDG_GetAgbGameCode.html"><CODE>CTRDG_GetAgbGameCode</CODE></A>
53</P>
54<H2>Revision History</H2>
55<P>
562005/12/01 Initial version.
57</P>
58<hr><p>CONFIDENTIAL</p></body>
59</html>
60