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>GXSetDrawSyncCallback</title>
10</head>
11
12<body>
13
14<h1 align="left">GXSetDrawSyncCallback</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/gx.h&gt;
19
20typedef void (*GXDrawSyncCallback)(u16 token);
21
22GXDrawSyncCallback GXSetDrawSyncCallback( GXDrawSyncCallback cb );
23</pre></dd></dl>
24
25<h2>Arguments</h2>
26<TABLE class="arguments" border="1" >
27  <tr>
28<TH>cb</TH>
29<TD>The callback called when a drawing synchronization token appears in the graphics pipeline.</TD>
30  </tr>
31</TABLE>
32
33<h2>Return Values</h2>
34<p>Returns a pointer to a previously set callback function.</p>
35
36<H2>Description</H2>
37<P>This function installs a callback that is invoked whenever a DrawSync token is encountered by the graphics pipeline.&nbsp;The callback's argument is the value of the most recently encountered token.&nbsp;Because it is possible to miss tokens (graphics processing does not stop while the callback is running), your code should be capable of deducing if any tokens have been missed (e.g. by using monotonically increasing values).</P>
38<P>The callback will be invoked with interrupts disabled, so it is imperative that it return as quickly as possible.&nbsp;</P>
39
40<h2>See Also</h2>
41<P class="reference">
42<a href="GXReadDrawSync.html">GXReadDrawSync</a>,
43<a href="GXSetDrawSync.html">GXSetDrawSync</a>
44</p>
45
46<H2>Revision History</H2>
47<P>
482006/03/01 Initial version.<br>
49</P>
50
51<hr><p>CONFIDENTIAL</p></body>
52</HTML>