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="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>RTC_SetAlarmInterrupt</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">RTC_SetAlarmInterrupt <img src="../image/NTR.gif" align="middle"><img src="../image/TWL.gif" align="middle"></h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/rtc.h&gt;</CODE><BR>
20  <PRE><CODE>void RTC_SetAlarmInterrupt( <A href="RTCInterrupt.html">RTCInterrupt</A> interrupt );</CODE></PRE>
21  </dd>
22</dl><h2>Arguments</h2>
23<TABLE border="1" width="100%">
24  <TBODY>
25    <TR>
26      <TD width="300"><em><strong><font face="Courier New">interrupt</font></strong></em></TD>
27      <TD width="700">Pointer to the callback function. This callback is called from within the interrupt handler.</TD>
28    </TR>
29  </TBODY>
30</TABLE>
31<h2>Return Values</h2>
32<p>None.</p>
33<H2>Description</H2>
34<P>This specifies the user callback function that will be called when a real-time clock alarm interrupt is generated. Interrupts will be ignored if no callback function is specified by this function. There are two alarm channels. However, because interrupts are shared there will only be one interrupt.</P>
35<h2>See Also</h2>
36<P><CODE><A href="RTCInterrupt.html">RTCInterrupt</A>, <A href="RTC_GetAlarmStatus.html">RTC_GetAlarmStatus</A>, <A href="RTC_GetAlarmParam.html">RTC_GetAlarmParam</A>, <A href="RTC_SetAlarmStatus.html">RTC_SetAlarmStatus</A>, <A href="RTC_SetAlarmParam.html">RTC_SetAlarmParam</A></CODE></P>
37<H2>Revision History</H2>
38<P>
392005/06/27 Added a statement about callbacks being invoked from the interrupt handler. <br>2005/03/08 Standardized use of the term &quot;interrupt&quot; in Japanese. <br>2004/05/18 Initial version.</P>
40<hr><p>CONFIDENTIAL</p></body>
41</html>
42