OSSetResetCallback

Syntax

#include <revolution/os.h>

typedef void (*OSResetCallback)(void);

OSResetCallback OSSetResetCallback(OSResetCallback callback);

Arguments

callback	Pointer to the callback function called at the time of reset button input.

Return Values

Returns a pointer to a previously set callback function.

Description

Registers a one-time reset callback. The callback function is called only once when the console's reset button is pressed, and then the callback is automatically unregistered. The callback function must be reinstalled to capture the next RESET Button input.

Note:

The processes to be performed by the application should be as short as possible because the reset callback is called in an interrupt-prohibited state.
Pressing RESET does not automatically reset the console hardware. The developer must decide how each game program handles RESET Button input.
In some circumstances, the registered callback function is not called even when the conditions are fully met. For more information about when this can occur and a workaround, see Notes Regarding Read/Writes to Wii Console NAND Memory.

Comment:
With the GameCube, applications needed to poll for the state of the reset button after a reset interrupt was detected, but this is not required in the Revolution SDK.

Revision History

2010/05/28 Added a link for more information to the note regarding the failure to call the registered callback.
2006/08/10 Revised to match Wii reset specifications.
2006/03/01 Initial version.