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 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>GX_TrySetBankForARM7</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_TrySetBankForARM7 <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/gx/gx_vramcnt.h&gt;</CODE><BR>
20  <BR>
21  <CODE>BOOL GX_TrySetBankForARM7(GXVRamARM7 arm7);</CODE></dd>
22</dl><h2>Arguments</h2>
23
24<table border="1" width="100%">
25  <tr>
26    <td width="13%"><em><strong><font face="Courier New">arm7</font></strong></em></td>
27    <td width="87%">Specifies a VRAM bank to allocate to ARM7 memory space.</td>
28  </tr>
29  </table>
30<h2>Return Values</h2>
31<p>
32Returns TRUE if the VRAM bank is allocated normally. Returns FALSE if the VRAM bank to be allocated is locked by another library.
33</p>
34<H2>Description</H2>
35<P>Attempts to allocate a designated VRAM bank to the ARM7 memory space. If the specified VRAM bank is either disabled or allocated to LCDC, this allocates the VRAM bank to ARM7 memory space. The allocation will fail if the designated VRAM bank is exclusion-locked by another library.
36</P>
37<TABLE border="1">
38  <TBODY>
39    <TR>
40      <TD><CODE>GX_VRAM_ARM7_NONE</CODE></TD>
41      <TD>The VRAM bank is not allocated in the ARM7 memory space.</TD>
42    </TR>
43    <TR>
44      <TD><CODE>GX_VRAM_ARM7_128_C</CODE></TD>
45      <TD>128 kilobytes are reserved in the ARM7 memory space. VRAM-C is allocated.</TD>
46    </TR>
47    <TR>
48      <TD><CODE>GX_VRAM_ARM7_128_D</CODE></TD>
49      <TD>128 kilobytes are reserved in the ARM7 memory space. VRAM-D is allocated.</TD>
50    </TR>
51    <TR>
52      <TD><CODE>GX_VRAM_ARM7_256_CD</CODE></TD>
53      <TD>256 kilobytes are reserved in the ARM7 memory space. VRAM-C and -D are allocated.</TD>
54    </TR>
55  </TBODY>
56</TABLE>
57<P>The following is the type definition for GXVRamARM7 types.</P>
58<PRE><CODE>typedef enum
59{
60    GX_VRAM_ARM7_NONE = 0x0000,
61    GX_VRAM_ARM7_128_C  = GX_VRAM_C, // ARM7: 0x06000000   --&gt;   0x06020000
62    GX_VRAM_ARM7_128_D  = GX_VRAM_D, // ARM7: 0x06000000   --&gt;   0x06020000
63    GX VRAM_ARM7_256_CD = GX_VRAM_C | GX_VRAM_D // ARM7: 0x06000000   --&gt;   0x06040000
64}
65GXVRamARM7;</PRE>
66<h2>See Also</h2>
67<P><code><A href="GX_SetBankForARM7.html">GX_SetBankForARM7</A>, <A href="GX_GetBankForARM7.html">GX_GetBankForARM7</A>, <A href="GX_ResetBankForARM7.html">GX_ResetBankForARM7</A>, <A href="GX_DisableBankForARM7.html">GX_DisableBankForARM7</A>, <A href="GX_GetSizeOfARM7.html">GX_GetSizeOfARM7</A></code></P>
68<H2>Revision History</H2>
69<P>2005/02/15 Initial version.</P>
70<hr><p>CONFIDENTIAL</p></body>
71</html>
72