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
17<h2>C Specification</h2>
18
19<dl>
20<dd><PRE><CODE>#include &lt;revolution/gx.h&gt;</CODE></PRE>
21  </dd>
22<dd><pre>typedef void (*GXDrawSyncCallback)(u16 token);
23
24GXDrawSyncCallback GXSetDrawSyncCallback( GXDrawSyncCallback cb );</pre>
25  </dd>
26</dl>
27
28<h2>Arguments</h2>
29<div align="left">
30<TABLE border="1" cellpadding="3" cellspacing="0.1">
31  <tr>
32<TD width="120" bgcolor="#ffffe8"><code><em><strong>cb</strong></em></code></TD>
33<TD width="520">The callback that is called when a drawing synchronization token appears in the graphics pipeline</TD>
34    </tr>
35</TABLE>
36</div>
37
38<h2>Return Values</h2>
39
40<p>Returns a pointer to a previously set callback function.</p>
41<H2>Description</H2>
42<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>
43<P>The callback will be invoked with interrupts disabled, so it is imperative that it return as quickly as possible.&nbsp;</P>
44
45
46
47
48<h2>See Also</h2>
49
50<p><a href="GXReadDrawSync.html"><CODE>GXReadDrawSync</CODE></a><BR> <CODE><a href="GXSetDrawSync.html">GXSetDrawSync</a></CODE></p>
51<H2>Revision History</H2>
52<P>03/01/2006 Initial version.</P>
53</BODY>
54</HTML>