mirror of
https://github.com/wiiu-env/wut.git
synced 2024-12-13 11:12:37 +01:00
f281be50ab
RPL files are shared libraries (like a .dll file), as opposed to the RPX files which are executables (like a .exe file). Use rpl_main as defined in dynload.h like one would DllMain on Windows.
120 lines
2.8 KiB
C
120 lines
2.8 KiB
C
#pragma once
|
|
#include <wut.h>
|
|
#include "thread.h"
|
|
#include "time.h"
|
|
|
|
/**
|
|
* \defgroup coreinit_dynload Dynamic Loading
|
|
* \ingroup coreinit
|
|
* @{
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum OSDynLoad_Error
|
|
{
|
|
OS_DYNLOAD_OK = 0,
|
|
OS_DYNLOAD_OUT_OF_MEMORY = 0xBAD10002,
|
|
OS_DYNLOAD_INVALID_NOTIFY_PTR = 0xBAD1000E,
|
|
OS_DYNLOAD_INVALID_MODULE_NAME_PTR = 0xBAD1000F,
|
|
OS_DYNLOAD_INVALID_MODULE_NAME = 0xBAD10010,
|
|
OS_DYNLOAD_INVALID_ACQUIRE_PTR = 0xBAD10011,
|
|
OS_DYNLOAD_EMPTY_MODULE_NAME = 0xBAD10012,
|
|
OS_DYNLOAD_INVALID_ALLOCATOR_PTR = 0xBAD10017,
|
|
OS_DYNLOAD_OUT_OF_SYSTEM_MEMORY = 0xBAD1002F,
|
|
OS_DYNLOAD_TLS_ALLOCATOR_LOCKED = 0xBAD10031,
|
|
} OSDynLoad_Error;
|
|
|
|
typedef enum OSDynLoad_EntryReason
|
|
{
|
|
OS_DYNLOAD_LOADED = 0,
|
|
OS_DYNLOAD_UNLOADED = 1,
|
|
} OSDynLoad_EntryReason;
|
|
|
|
typedef void *OSDynLoad_Module;
|
|
|
|
typedef OSDynLoad_Error (*OSDynLoadAllocFn)(int32_t size, int32_t align, void **outAddr);
|
|
typedef void (*OSDynLoadFreeFn)(void *addr);
|
|
|
|
|
|
/**
|
|
* Load a module.
|
|
*
|
|
* If the module is already loaded, increase reference count.
|
|
* Similar to LoadLibrary on Windows.
|
|
*/
|
|
OSDynLoad_Error
|
|
OSDynLoad_Acquire(char const *name,
|
|
OSDynLoad_Module *outModule);
|
|
|
|
|
|
/**
|
|
* Retrieve the address of a function or data export from a module.
|
|
*
|
|
* Similar to GetProcAddress on Windows.
|
|
*/
|
|
OSDynLoad_Error
|
|
OSDynLoad_FindExport(OSDynLoad_Module module,
|
|
BOOL isData,
|
|
char const *name,
|
|
void **outAddr);
|
|
|
|
|
|
/**
|
|
* Free a module handle returned from OSDynLoad_Acquire.
|
|
*
|
|
* Will decrease reference count and only unload the module if count reaches 0.
|
|
* Similar to FreeLibrary on Windows.
|
|
*/
|
|
void
|
|
OSDynLoad_Release(OSDynLoad_Module module);
|
|
|
|
|
|
/**
|
|
* Set the allocator functions to use for dynamic loading.
|
|
*/
|
|
OSDynLoad_Error
|
|
OSDynLoad_SetAllocator(OSDynLoadAllocFn allocFn,
|
|
OSDynLoadFreeFn freeFn);
|
|
|
|
|
|
/**
|
|
* Get the allocator functions used for dynamic loading.
|
|
*/
|
|
OSDynLoad_Error
|
|
OSDynLoad_GetAllocator(OSDynLoadAllocFn *outAllocFn,
|
|
OSDynLoadFreeFn *outFreeFn);
|
|
|
|
|
|
/**
|
|
* Set the allocator functions to use for thread local storage.
|
|
*/
|
|
OSDynLoad_Error
|
|
OSDynLoad_SetTLSAllocator(OSDynLoadAllocFn allocFn,
|
|
OSDynLoadFreeFn freeFn);
|
|
|
|
|
|
/**
|
|
* Get the allocator functions used for thread local storage.
|
|
*/
|
|
OSDynLoad_Error
|
|
OSDynLoad_GetTLSAllocator(OSDynLoadAllocFn *outAllocFn,
|
|
OSDynLoadFreeFn *outFreeFn);
|
|
|
|
/**
|
|
* The prototype for an RPL entry point.
|
|
*
|
|
* Use this instead of main when creating .rpl files
|
|
*/
|
|
int
|
|
rpl_main(OSDynLoad_Module module,
|
|
OSDynLoad_EntryReason reason);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/** @} */
|