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>MI_GetUsedWramSlot</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">MI_GetUsedWramSlot* <IMG src="../../image/TWL.gif" align="middle"></h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <twl/mi.h></CODE><BR> <BR> <CODE>u8 MI_GetUsedWramSlot( <A href="../mi_constant.html">MIWramPos</A> wram );</CODE><br> <BR> <CODE>(define)</CODE><br> <CODE>#define MI_GetUsedWramSlot_A();</CODE><br> <CODE>#define MI_GetUsedWramSlot_B();</CODE><br> <CODE>#define MI_GetUsedWramSlot_C();</CODE><br> 20 </dd> 21</dl> 22<h2>Arguments</h2> 23<TABLE border="1"> 24 <TBODY> 25 <TR> 26<TD><B><I>wram</I></B></TD> 27<TD>WRAM to get information about.</TD> 28 </TR> 29 </TBODY> 30</TABLE> 31<h2>Return Values</h2> 32<p>Returns information about the slots within the specified WRAM that are allocated to some processor. Returns slot values ranging from 0 to 3 for WRAM-A, or slot values ranging from 0 to 7 for WRAM-B and WRAM-C.</p> 33<H2>Description</H2> 34<P>Gets information about the slots within the specified WRAM that are allocated to some processor.</P> 35<P>The reservation status of the WRAM slots by the processor is irrelevant.</P> 36<P><BR> <B>About the return values:</B></P> 37<p>The lower bits of the <CODE>u8</CODE> value indicate slot 0, slot 1, and so on (in order). If a given bit is 1, it means that the corresponding slot is allocated.</p> 38<p>For example, if the return value of <CODE>MI_GetFreeWramSlot( MI_WRAM_B )</CODE> is <CODE>0xC0</CODE> (<CODE>11000000</CODE> in binary), it indicates that WRAM-B slots 0, 1, 2, 3, 4, and 5 have not been allocated by any processor (but they may be reserved) and that slots 6 and 7 have been allocated by one of the processors.</p> 39<BLOCKQUOTE><IMG src="image_allocatable1.gif" width="226" height="163" border="0"></BLOCKQUOTE> 40<P><BR> <B>Convenience functions that include the WRAM type in the function name:</B></P> 41<P><CODE>MI_GetUsedWramSlot_A(...)</CODE> is the <CODE>#define</CODE> directive of <CODE>MI_GetUsedWramSlot( MI_WRAM_A, ... )</CODE>.<BR><CODE>MI_GetUsedWramSlot_B(...)</CODE> is the <CODE>#define</CODE> directive of <CODE>MI_GetUsedWramSlot( MI_WRAM_B, ... )</CODE>.<BR><CODE>MI_GetUsedWramSlot_C(...)</CODE> is the <CODE>#define</CODE> directive of <CODE>MI_GetUsedWramSlot( MI_WRAM_C, ... )</CODE>.<BR> 42 43 44<h2>Internal Operation</h2> 45<p>The WRAM manager managed by the ARM9 determines the return value.<BR>The ARM7 gets values from the ARM9 through PXI.</p> 46 47<h2>See Also</h2> 48<P><A href="about_Wram.html">Overview: Work RAM</A><BR> <A href="../mi_constant.html">MI-Related Constants</A><BR> <A href="MI_GetAllocatableWramSlot.html"><CODE>MI_GetAllocatableWramSlot</CODE></A><BR> <A href="MI_GetFreeWramSlot.html"><CODE>MI_GetFreeWramSlot</CODE></A></P> 49 50<H2>Revision History</H2> 51<P>2008/05/29 Initial version.</P> 52<hr><p>CONFIDENTIAL</p></body> 53</html> 54
