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=utf-8">
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>Syntax</h2>
16<dl><dd><pre class="construction">
17#include &lt;revolution/rso.h&gt;
18
19BOOL RSOLocateObject ( void* newModule, void* bss );
20BOOL RSOLocateObjectFixed ( void* newModule, void* bss );
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<TH>newModule</TH>
27<TD>Pointer to the target dynamic module information.</TD>
28  </tr>
29  <tr>
30<TH>bss</TH>
31<TD>Pointer to the available memory space used for the bss section. (Size is allocated by <CODE>RSOObjectHeader.bssSize</CODE>.)</TD>
32  </tr>
33</TABLE>
34
35<h2>Return Values</h2>
36<p>
37Processing result.<br> Success: <CODE>TRUE</CODE><br> Failure: <CODE>FALSE</CODE><br>
38</p>
39
40<H2>Description</H2>
41<p>
42<code>RSOLocateObject</code> performs the following operations on the target module data.<br>
43</p>
44<UL>
45<LI>Changes the internally referenced address and externally referenced address from offset to virtual addresses.
46<LI>Allocates the BBS section.
47<LI>Sets the externally referenced address to unresolved.
48</UL>
49<p>
50<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 memory space after that, specified by <code><a href="./RSOGetFixedSize.html">RSOGetFixedSize</a></code>, can be used for any purpose (for example, for the BSS area).<br> The release level corresponds to <code><a href="./RSOFixedLevel.html">RSO_FL_INTERNAL</a></code>, where the internal reference information is released.<br><br> The dynamic module memory copy cannot be reused after <code>RSOLocateObjectFixed</code>.
51</p>
52
53<h2>See Also</h2>
54<p class="reference">
55<a href="./RSOStaticLocateObject.html">RSOStaticLocateObject</a><BR><a href="./RSOUnLocateObject.html">RSOUnLocateObject</a><BR><a href="./RSOLink.html">RSOLink</a><BR><a href="./RSOUnLink.html">RSOUnLink</a><BR><a href="./RSOGetFixedSize.html">RSOGetFixedSize</a>
56</p>
57
58<H2>Revision History</H2>
59<p>
602008/07/10 Removed <CODE>RSOLink.h</CODE> from <B>Syntax</B>.<BR> 2006/06/14 Initial version.<BR>
61</p>
62
63<hr><p>CONFIDENTIAL</p></body>
64</html>
65