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.<br>- Changes the internally referenced address and externally referenced address from offset to virtual addresses.<br>- Allocates the BBS section.<br>- Sets the externally referenced address to unresolved.<br><br> <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 (e.g., 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>.
50</p>
51
52<h2>See Also</h2>
53<p>
54<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>,
55</p>
56<H2>Revision History</H2>
57<p>06/14/2006 Initial version.</p>
58
59<hr>
60<p align="right"><strong>CONFIDENTIAL</strong></p>
61
62</BODY>
63</HTML>
64