1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>MI_HBlankDmaCopy*</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">MI_HBlankDmaCopy* <IMG src="../../image/NTR.gif" align="middle"><IMG src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD><CODE>#include &lt;nitro/mi.h&gt;</CODE><BR>
15  <BR>
16  <CODE>void MI_HBlankDmaCopy32( u32 dmaNo, const void* src, void* dest, u32 size
17  );</CODE><BR>
18  <CODE>void MI_HBlankDmaCopy16( u32 dmaNo, const void* src, void* dest, u32 size
19  );</CODE><BR>
20  <BR>
21  <CODE>void MI_HBlankDmaCopy32If( u32 dmaNo, const void* src, void* dest, u32
22  size );</CODE><BR>
23  <CODE>void MI_HBlankDmaCopy16If( u32 dmaNo, const void* src, void* dest, u32
24  size );</CODE><BR>
25</DL>
26<H2>Arguments</H2>
27<TABLE border="1" width="100%">
28  <TBODY>
29    <TR>
30      <TD width="13%"><EM><STRONG>dmaNo</STRONG></EM></TD>
31      <TD width="87%">DMA channel used.</TD>
32    </TR>
33    <TR>
34      <TD width="13%"><EM><STRONG>src</STRONG></EM></TD>
35      <TD width="87%">The transfer source address.</TD>
36    </TR>
37    <TR>
38      <TD width="13%"><EM><STRONG>dest</STRONG></EM></TD>
39      <TD width="87%">The transfer destination address.</TD>
40    </TR>
41    <TR>
42      <TD><EM><STRONG>size</STRONG></EM></TD>
43      <TD>Transfer size.</TD>
44    </TR>
45  </TBODY>
46</TABLE>
47<H2>Return Values</H2>
48<P>None.</P>
49<H2>Description</H2>
50<P>This function uses DMA to copy a H-Blank. When a H-Blank starts, DMA starts.</P>
51<P><FONT color="#ff0000">When using this mode, set the access right to main memory to <CODE>ARM9</CODE> priority. Otherwise, the screen may not display properly because of a delay as ARM7 accesses main memory and starts up DMA memory. The access right priority can be specified with <CODE><A href="../exmemory/MI_SetMainMemoryPriority.html">MI_SetMainMemoryPriority()</A></CODE>.</P>
52<P>The functions <CODE>MI_HBlankDmaCopy32If</CODE> and <CODE>MI_HBlankDmaCopy16If</CODE> generate DMA interrupts when DMA terminates.</P>
53<H2>Internal Operation</H2>
54<P>Uses the following IO registers: DMA<i>n</i> source register (0x40000B0 + 12<i>n</i>), DMA<i>n</i> destination register (0x40000B4 + 12<i>n</i>), and DMA<i>n</i> control register (0x40000B8 + 12<i>n</i>). (<i>n</i> is the DMA channel used.))</P>
55<H2>See Also</H2>
56<P><CODE><A href="MI_DmaCopy.html">MI_DmaCopy*</A><BR> </CODE><CODE><A href="../exmemory/MI_SetMainMemoryPriority.html">MI_SetMainMemoryPriority</A><BR></CODE></P>
57<H2>Revision History</H2>
58<P>2004/08/26 Added description about the setting of the ARM9 priority to access the main memory when using DMA memory.<br> 2003/12/01 Initial version.</P>
59<hr><p>CONFIDENTIAL</p></body>
60</HTML>
61