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>GXGetGPStatus</title> 10</head> 11 12<body> 13 14<h1 align="left">GXGetGPStatus</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>void GXGetGPStatus( 22<a href="../Enumerated_Types/GXBool.html">GXBool</a>* overhi, 23<a href="../Enumerated_Types/GXBool.html">GXBool</a>* underlow, 24<a href="../Enumerated_Types/GXBool.html">GXBool</a>* readIdle, 25<a href="../Enumerated_Types/GXBool.html">GXBool</a>* cmdIdle, 26<a href="../Enumerated_Types/GXBool.html">GXBool</a>* brkpt );</CODE></pre></dd> 27</dl> 28<h2>Arguments</h2> 29<div align="left"> 30<TABLE border="1" cellpadding="3" cellspacing="0.1"> 31 <tr> 32<TD width="120" valign="top" bgcolor="#ffffe8"><code><strong><em>overhi</em></strong></code></TD> 33<TD width="520">GX_TRUE if high watermark has been passed.</TD> 34 </tr> 35 <tr> 36<TD width="120" valign="top" bgcolor="#ffffe8"><code><strong><em>underlow</em></strong></code></TD> 37<TD width="520">GX_TRUE if low watermark has been passed.</TD> 38 </tr> 39 <tr> 40<TD width="120" valign="top" bgcolor="#ffffe8"><code><strong><em>readIdle</em></strong></code></TD> 41<TD width="520">GX_TRUE if the GP read unit is idle.</TD> 42 </tr> 43 <tr> 44<TD width="120" valign="top" bgcolor="#ffffe8"><code><strong><em>cmdIdle</em></strong></code></TD> 45<TD width="520">GX_TRUE if all commands have been flushed to XF.</TD> 46 </tr> 47 <tr> 48<TD width="120" valign="top" bgcolor="#ffffe8"><code><strong><em>brkpt</em></strong></code></TD> 49<TD width="520"><code>GX_TRUE</code> if FIFO has reached a breakpoint and GP reads have been stopped.</TD> 50 </tr> 51</TABLE> 52</div> 53 54<h2>Return Values</h2> 55 56<p>None.</p> 57<H2>Description</H2> 58<P>Reads the current state of the GP.</P> 59<P><CODE><STRONG><EM>overhi</EM></STRONG></CODE> and <CODE><STRONG><EM>underlow</EM></STRONG></CODE> indicates whether the watermark has been reached. If the CPU and GP FIFO are the same, <CODE><STRONG><EM>overhi</EM></STRONG></CODE> indicates whether the current GX thread is suspended.</P> 60<P>The <STRONG><EM>brkpt</EM></STRONG></CODE> can be used to determine if the break point is in progress (in other words, reading of GP is suspended. It is resumed by calling the <CODE><A href="GXDisableBreakPt.html">GXDisableBreakPt</A></CODE> function.) A callback can also be used to notify the application when a breakpoint has been reached. (See the <CODE><A href="GXSetBreakPtCallback.html">GXSetBreakPtCallback</A></CODE> function.)</P> 61 62<h2>See Also</h2> 63<H2>Revision History</H2> 64<P>03/01/2006 Initial version.</P> 65</BODY> 66</HTML>