1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="Microsoft FrontPage 5.0">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
9<title>OSFatal</title>
10</head>
11
12<body>
13
14<h1>OSFatal</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/os.h&gt;
19
20void OSFatal ( <a href="../../gx/Structures/GXColor.html">GXColor</a> fg, <a href="../../gx/Structures/GXColor.html">GXColor</a> bg, const char* msg );
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<TH><STRONG><EM><CODE>fg</CODE></EM></STRONG></TH>
27<TD>Foreground (text) color. The value of member <SPAN class="argument">a</SPAN> (the alpha value) in <SPAN class="argument">fg</SPAN> is not used.</TD>
28  </tr>
29  <tr>
30<TH><em><strong><code>bg</code></strong></em>&nbsp;&nbsp;</TH>
31<TD>Background (text) color. The value of member <SPAN class="argument">a</SPAN> (the alpha value) in <SPAN class="argument">bg</SPAN> is not used.</TD>
32  </tr>
33  <tr>
34<TH>msg</TH>
35<TD>Pointer to the last null-terminated string.</TD>
36  </tr>
37</TABLE>
38
39<h2>Return Values</h2>
40<P>None.</P>
41
42<h2>Description</h2>
43<P>The <code>OSFatal</code> function immediately halts program execution and shows the specified text message on the TV screen. This function can even be called inside a callback function.</P>
44<P>The following demo program illustrates how to hook the SDK assertion message to show the assertion failure message on the TV screen with the <code>OSFatal</code> function.</P>
45<dl><dd><pre class="construction">
46$REVOLUTION_SDK_ROOT/build/demos/osdemo/src/panic.c
47</pre></dd></dl>
48
49<P><B><B>Note:</B></B> The <CODE>OSFatal</CODE> function uses the memory space above 18MB for its work area.</P>
50
51<h2>See Also</h2>
52<P class="reference">
53<a href="../toc.html#Error" target="contents">Error Functions</a>,
54<a href="ASSERT.html">ASSERT</a>,
55<a href="ASSERTMSG.html">ASSERTMSG</a>,
56<a href="OSReport.html">OSReport</a>
57</p>
58
59<H2>Revision History</H2>
60<P>
612006/03/01 Initial version.<br>
62</P>
63
64<hr><p>CONFIDENTIAL</p></body>
65</html>