1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="Microsoft FrontPage 5.0">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<TITLE>OSSetResetCallback</TITLE>
9</HEAD>
10<BODY>
11<H1>OSSetResetCallback</H1>
12
13<H2>Syntax</H2>
14<dl><dd><pre class="construction">
15#include &lt;revolution/os.h&gt;
16
17typedef void (*OSResetCallback)(void);
18
19OSResetCallback OSSetResetCallback(OSResetCallback callback);
20</pre></dd></dl>
21
22<H2>Arguments</H2>
23<TABLE class="arguments" border="1" >
24  <TBODY>
25    <TR>
26<TH>callback</TH>
27<TD>Pointer to the callback function called at the time of reset button input.</TD>
28    </TR>
29  </TBODY>
30</TABLE>
31
32<H2>Return Values</H2>
33<P>Returns a pointer to a previously set callback function.</P>
34
35<H2>Description</H2>
36<P>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.</P>
37
38<P><B>Note: </B>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.</P>
39
40<P><B>Note: </B>Pressing RESET does not automatically reset the console hardware.&nbsp;The developer must decide how each game program handles RESET Button input.</P>
41
42<P><B>Note:</B>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.</P>
43
44<H2>See Also</H2>
45<P class="reference">
46<A href="../toc.html#Reset Button" target="contents">Reset Button Functions</A>,
47<A href="OSGetResetButtonState.html">OSGetResetButtonState</A>
48</P>
49
50<H2>Revision History</H2>
51<P>
522006/08/10 Revised to match Wii reset specifications.<BR>2006/03/01 Initial version.<br>
53</P>
54
55<hr><p>CONFIDENTIAL</p></body>
56</HTML>