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>OS_EnableIrqMask</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">OS_EnableIrqMask <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 <nitro/os.h></CODE><BR> 20 <BR> 21 <CODE>OSIrqMask OS_EnableIrqMask( OSIrqMask intr );</CODE></dd> 22</dl><h2>Arguments</h2> 23<TABLE border="1"> 24 <TBODY> 25 <TR> 26 <TD><B><I>intr</I></B></TD> 27 <TD>The IRQ interrupt causes to be enabled (expressed as a logical sum).</TD> 28 </TR> 29 </TBODY> 30</TABLE> 31 32<h2>Return Values</h2> 33<p>Returns the IRQ interrupt cause parameters from before this function was called. See below for information about causes. The return value is the logical sum of the causes that were formerly set.</p> 34<p>? <A href="interrupts_list.html">Types of Interrupts</A></p> 35<H2>Description</H2> 36<P>Sets IRQ interrupt parameters. This function enables the designated causes in addition to the currently enabled parameters.</P> 37<H3><B><BR> Types of Interrupts</B></H3> 38<P>Specify the interrupt causes to enable using the <B><I>intr</I></B> argument. See below for information on the types of interrupts.</P> 39<P>? <A href="interrupts_list.html">Types of Interrupts</A></P> 40<H3><B><BR> Example</B></H3> 41<BLOCKQUOTE style="background-color:#ffffd0;"><CODE>// Enable V-Blank interrupts and DMA0 interrupts in addition to the current settings.<BR> OS_EnableIrqMask( OS_IE_V_BLANK | OS_IE_DMA0 );<BR></CODE></BLOCKQUOTE> 42<H3><BR> Note:</H3> 43<P>This function <FONT color="#ff0000">adds the specified causes in addition to the current settings</FONT>. <a href="OS_SetIrqMask.html"><code>OS_SetIrqMask</code></a> is used to overwrite and set a specific cause. However, because there may be interrupt cause settings defined by the system that we do not want to change, it is best not to use the <a href="OS_SetIrqMask.html"><code>OS_SetIrqMask</code></a> function, because that overwrites all settings. In nearly all cases, the <CODE>OS_EnableIrqMask()</CODE> function should be used to set only the specified causes.</P> 44<h2>Internal Operation</h2> 45<P>Operates on one of the I/O registers, IE (Interrupt Enable).</P> 46 47<h2>See Also</h2> 48<p><a href="OS_DisableIrqMask.html"><code>OS_DisableIrqMask</code></a>, <a href="OS_SetIrqMask.html"><code>OS_SetIrqMask</code></a></p> 49<H2>Revision History</H2> 50<P>2008/05/30 Moved the types of interrupts to a separate page.<BR>2005/03/08 Standardized the Japanese term for of "interrupt."<br>2004/03/12 Emphasized the differences with <CODE>OS_SetIrqMask()</CODE>. <BR> 2003/12/01 Initial version.</P> 51<hr><p>CONFIDENTIAL</p></body> 52</html> 53
