1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
6<title>AIRegisterDMACallback</title>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META name="GENERATOR" content="Microsoft FrontPage 5.0">
9<META http-equiv="Content-Style-Type" content="text/css">
10</head>
11
12<body>
13
14<h1 align="left">AIRegisterDMACallback</h1>
15
16
17<h2>C Specification</h2>
18
19<dl>
20<dd><pre><CODE>#include &lt;revolution.h&gt;</CODE></pre>
21  </dd>
22<dd><pre><CODE>typedef void (*AIDCallback)(void);</CODE></pre>
23<pre><CODE>AIDCallback AIRegisterDMACallback(AIDCallback callback);</CODE></pre>
24  </dd>
25</dl>
26<h2>Arguments</h2>
27
28<table border="1" cellpadding="3" cellspacing="0.1">
29  <tr>
30<td width="120" bgcolor="#ffffe8"><font face="Courier New"><em><strong><STRONG><EM><CODE>callback</CODE></EM></STRONG></strong></em></font></td>
31<td width="520">Callback function for the AI DMA interrupt (<code>AIDINT</code>). </td>
32  </tr>
33</table>
34
35<h2>Return Values</h2>
36
37<p>Returns a pointer to the old callback function that is already registered. Returns <code>NULL</code> if a callback function has not been registered. </p>
38
39<h2>Description</h2>
40
41<p>The <code>AIRegisterDMACallback</code> function registers the callback function to call when an AI DMA interrupt (<code>AIDINT</code>) occurs. The new callback function unconditionally replaces the existing callback function. The callback function is deleted if <code>NULL</code> is specified and no callback function will ever be called in response to an AI DMA interrupt.
42</P>
43<H2>See Also</H2>
44
45<H2>Revision History</H2>
46
47<P>2006/03/01 Initial version.</P>
48</BODY></HTML>