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 http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<title>RSOLocateObject </title>
9</head>
10
11<body>
12
13<h1>RSOLocateObject </h1>
14
15<h2>C Specification</h2>
16<dl><dd><pre><code>
17#include &lt;revolution/rso.h&gt;
18#include &lt;revolution/RSOLink.h&gt;
19
20BOOL RSOLocateObject ( void* newModule, void* bss );
21BOOL RSOLocateObjectFixed (void* newModule,void* bss );
22
23</code></pre></dd></dl>
24
25<h2>Arguments</h2>
26<p>
27<TABLE border="1" >
28  <tr>
29<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>newRso</EM></STRONG></CODE></TD>
30<TD width="520">Pointer to the target dynamic module information.</TD>
31  </tr>
32
33  <tr>
34<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>bss</EM></STRONG></CODE></TD>
35<TD width="520">Pointer to the available memory space used for the bss section.<br>(Size is allocated by <CODE>RSOObjectHeader.bssSize</CODE>.)</TD>
36  </tr>
37  <tr>
38</TABLE>
39</p>
40
41<h2>Return Values</h2>
42<p>
43Returns success or failure of the operation.<br> Success: TRUE<br> Fail: FALSE<br>
44</p>
45
46
47<H2>Description</H2>
48<p>
49<code>RSOLocateObject</code> performs the following operations on the target module data.
50<ul>
51<li>Changes the internally referenced address and externally referenced address from offset to virtual addresses.</li>
52<li>Allocates the BBS section.</li>
53<li>Sets the externally referenced address to unresolved.</li>
54</ul>
55<code>RSOLocateObjectFixed</code> releases part of the memory held by the module in addition to the capability of <code>RSOLocateObject</code>.<br>After <code>RSOLocateObject</code>, the remaining memory space specified by <code><a href="./RSOGetFixedSize.html">RSOGetFixedSize</a></code> can be used for any purpose (for example, for bss area).<br>The deallocated stage corresponds to <code><a href="./RSOFixedLevel.html">RSO_FL_INTERNAL</a></code>, where the internal reference information is deallocated.<br><bR> The dynamic module memory copy cannot be reused after <code>RSOLocateObjectFixed</code>.
56</p>
57
58<h2>See Also</h2>
59<p>
60<code><a href="./intro.html">RSO API Introduction</a></code><br> <code><a href="./RSOStaticLocateObject.html">RSOStaticLocateObject</a></code>, <code><a href="./RSOUnLocateObject.html">RSOUnLocateObject</a></code>, <code><a href="./RSOLink.html">RSOLink</a></code>, <code><a href="./RSOUnLink.html">RSOUnLink</a></code>, <code><a href="./RSOGetFixedSize.html">RSOGetFixedSize</a></code>
61</p>
62<H2>Revision History</H2>
63<p>2006/06/14 Initial version.</p>
64
65
66<hr><p>CONFIDENTIAL</p></body>
67</html>
68