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_HBlankNDmaCopy*</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">MI_HBlankNDmaCopy* <IMG src="../../image/TWL.gif" width="24" height="12" border="0" align=middle></H1>
12<H2>Syntax</H2>
13<DL>
14<DD><CODE>#include &lt;twl/mi.h&gt;</CODE><BR> <BR> <CODE>void MI_HBlankNDmaCopy( u32 ndmaNo,</CODE><BR> <CODE>const void *src,<BR> void *dest,</CODE><BR> <CODE>u32 size );</CODE><BR>
15<DD><CODE>void MI_HBlankNDmaCopyIf( u32 ndmaNo,</CODE><BR> <CODE>const void *src,<BR> void *dest,</CODE><BR> <CODE>u32 size );</CODE>
16</DL>
17<H2>Arguments</H2>
18<TABLE border="1" width="100%">
19  <TBODY>
20    <TR>
21<TD><EM><STRONG>ndmaNo</STRONG></EM></TD>
22<TD>DMA channel used.</TD>
23    </TR>
24    <TR>
25<TD><EM><STRONG>src</STRONG></EM></TD>
26<TD>The transfer source address.</TD>
27    </TR>
28    <TR>
29<TD><EM><STRONG>dest</STRONG></EM></TD>
30<TD>The transfer destination address.</TD>
31    </TR>
32    <TR>
33<TD><EM><STRONG>size</STRONG></EM></TD>
34<TD>Transfer size.</TD>
35    </TR>
36  </TBODY>
37</TABLE>
38<H2>Return Values</H2>
39<P>None.</P>
40<H2>Description</H2>
41<P>This function uses the new DMA to copy a H-Blank. When a H-Blank starts, DMA starts.</P>
42<P>It uses the new DMA to perform copies in word (4-byte) units. Both the transfer source address (<B><I>src</I></B>) and the transfer destination address (<B><I>dest</I></B>) must be 4-byte aligned. The transfer size (<em><strong><code>size</code></strong></em>) needs to be a multiple of 4.</P>
43<P><FONT color="#ff0000">When using this mode, the access right to main memory should be set to &quot;ARM9 Priority.&quot; Otherwise, the screen may not be displayed properly due to the delay of DMA startup caused by ARM7 accessing the main memory. The access right priority can be specified with <CODE><A href="../exmemory/MI_SetMainMemoryPriority.html">MI_SetMainMemoryPriority()</A></CODE>.</P>
44<P>The <CODE>MI_HBlankNDmaCopyIf</CODE> function generates a DMA interrupt when DMA terminates.</P>
45<H2>Internal Operation</H2>
46<P>Accesses the new DMA register.</P>
47<H2>See Also</H2>
48<P><CODE><A href="MI_NDmaCopy.html">MI_NDmaCopy</A><BR> <A href="../exmemory/MI_SetMainMemoryPriority.html">MI_SetMainMemoryPriority</A><BR></CODE></P>
49<H2>Revision History</H2>
50<P>2007/10/04 Initial version.</P>
51<hr><p>CONFIDENTIAL</p></body>
52</HTML>