1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//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>GXSetCurrentGXThread</title> 10</head> 11 12<body> 13 14<h1 align="left">GXSetCurrentGXThread</h1> 15 16 17<h2>C Specification</h2> 18 19<dl> 20<dd><PRE><CODE>#include <revolution/gx.h></CODE></PRE></dd> 21<dd><pre><CODE>OSThread* GXSetCurrentGXThread ( void );</CODE></pre> 22 </dd> 23</dl> 24 25<h2>Arguments</h2> 26 27<p>None</p> 28 29<h2>Return Values</h2> 30 31<p>The previous GX thread.</p> 32<H2>Description</H2> 33<P>This function will set the current GX thread to the calling thread. The current thread should be the thread responsible for generating graphics data.</P> 34<P>By default, the GX thread is the thread that invokes <code><a href="../Management/GXInit.html">GXInit</a></code>. However, it may be changed by calling <code>GXSetCurrentGXThread</code>.</P> 35<P><B>Note:</B> You will create a programming error if you change a GX thread while the current GX thread is suspended by a high water mark interrupt. This indicates that you have two threads about to generate GX data. An assertion failure will occur in this case.</P> 36<P>When graphics data is generated in immediate mode (that is, the CPU FIFO = GP FIFO, and the GP is actively consuming data), the high watermark may be triggered. When this happens, the high watermark interrupt handler will suspend the GX thread, thus preventing any further graphics data from being generated. The low watermark interrupt handler will resume the thread.</P> 37 38 39 40 41<h2>See Also</h2> 42 43<p><code><a href="../Management/GXInit.html">GXInit</a><a href="GXGetCurrentGXThread.html"><br> GXGetCurrentGXThread</a></code></p> 44 45<h2>Revision History</h2> 46<P>03/01/2006 Initial version.</P></body> 47</html>