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>CTRDG_DmaCopy*</TITLE> 8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 9</HEAD> 10<BODY> 11<H1 align="left">CTRDG_DmaCopy* <IMG src="../image/NTR.gif" align="middle"></H1> 12<H2>Syntax</H2> 13<DL> 14 <DD> 15 <PRE><CODE>#include <nitro/ctrdg.h></CODE></PRE> 16 <PRE><CODE>BOOL CTRDG_DmaCopy16( u32 dmaNo, const void* src, void* dest, u32 size ); 17BOOL CTRDG_DmaCopy32( u32 dmaNo, const void* src, void* dest, u32 size ); 18 </CODE></PRE> 19</DL> 20<H2>Arguments</H2> 21<TABLE border="1"> 22 <TBODY> 23 <TR> 24 <TD><B><I>dmaNo</I></B></TD> 25 <TD>The DMA number (0-3) that is used in the transfer.</TD> 26 </TR> 27 <TR> 28 <TD><B><I>src</I></B></TD> 29 <TD>The transfer source address.</TD> 30 </TR> 31 <TR> 32 <TD><B><I>dest</I></B></TD> 33 <TD>The transfer destination address.</TD> 34 </TR> 35 <TR> 36 <TD><B><I>size</I></B></TD> 37 <TD>The transfer size (in bytes).</TD> 38 </TR> 39 </TBODY> 40</TABLE> 41<H2>Return Values</H2> 42<P>Returns a value of TRUE if the transfer succeeds. Returns a value of FALSE when there is no Game Pak or if the transfer fails.</P> 43<H2>Description</H2> 44<P>These functions transfer data that is on the Game Pak using DMA.</P> 45<P><CODE>CTRDG_DmaCopy16()</CODE> transfers data using <A href="../mi/dma/MI_DmaCopy.html">MI_DmaCopy16()</A>.<BR><CODE>CTRDG_DmaCopy32()</CODE> transfers data using <A href="../mi/dma/MI_DmaCopy.html">MI_DmaCopy32()</A>.</P> 46<P>These functions do not set the access cycle. The access cycle must be set in advance.</P> 47<H2>See Also</H2> 48<P><A href="CTRDG_Init.html"><code>CTRDG_Init</code></A>, <A href="CTRDG_CpuCopy.html"><code>CTRDG_CpuCopy*</code></A>, <A href="CTRDG_Read.html"><code>CTRDG_Read*</code></A>, <A href="CTRDG_Write.html"><code>CTRDG_Write*</code></A><BR></P> 49<H2>Revision History</H2> 50<P>2004/09/17 Initial version.</P> 51<hr><p>CONFIDENTIAL</p></body> 52</HTML> 53