#include <nitro/os.h>
void OS_SetUserExceptionHandler(
OSExceptionHandler handler
void* arg );
handler | Function to be called when an exception is generated |
arg | Argument used when calling the user function |
None.
This function sets the user function that will be called when an exception is generated.
The user function handler
is of the type OSExceptionHandler
.
typedef void (*OSExceptionHandler)( u32, void* );
This function is called when interrupts are prohibited.
When calling the user function, the first argument is a pointer address (u32
) to the structure the holds the context for the generated exception. For the second argument, arg
, which is specified by the second argument of OS_SetUserExceptionHandler()
, is passed as-is.
Additionally, the following are stored at the destination specified by the first argument, in addition to the OSContext that is specified by OS_InitContext(), etc: coprocessor state (u32), SPSR (u32 - Non-SPSR modes not decided), reset or exception (u32 - 0 = exception, non-0 = reset).
OS_InitException, OS_InitContext
03/08/2005 Standardized the Japanese term for "interrupt"
02/19/2004 Initial version