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.

Note: Pressing RESET does not automatically reset the console hardware. The developer must decide how each game program handles RESET Button input.

Note:With the GameCube, polling of the reset button's state was needed after a reset button interrupt was detected; this is not required in the Revolution SDK.

See Also

Reset Button Functions, OSGetResetButtonState

Revision History

2006/08/10 Revised to match Wii reset specifications.
2006/03/01 Initial version.

CONFIDENTIAL