RSOLocateObject

Syntax

#include <revolution/rso.h>

BOOL RSOLocateObject ( void* newModule, void* bss ); 
BOOL RSOLocateObjectFixed ( void* newModule, void* bss );

Arguments

newModule	Pointer to the target dynamic module information.
bss	Pointer to the available memory space used for the bss section.((Size is allocated by `RSOObjectHeader.bssSize`.)

Return Values

Processing result.
Success: TRUE
Failure: FALSE

Description

RSOLocateObject performs the following operations on the target module data.

Changes the internally referenced address and externally referenced address from offset to virtual addresses.
Allocates the BBS section.
Sets the externally referenced address to unresolved.

RSOLocateObjectFixed releases part of the memory held by the module in addition to the capability of RSOLocateObject.
After RSOLocateObject, the remaining memory space specified by RSOGetFixedSize can be used for any purpose (for example, for the BSS area).
The release level corresponds to RSO_FL_INTERNAL, where the internal reference information is released.

The dynamic module memory copy cannot be reused after RSOLocateObjectFixed.

Revision History

2008/07/10 Removed RSOLink.h from Syntax.
2006/06/14 Initial version.