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="Microsoft FrontPage 5.0"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 9<title>LCLoadBlocks</title> 10</head> 11 12<body> 13 14<h1>LCLoadBlocks</h1> 15 16 17<h2>C Specification</h2> 18 19<dl> 20<dd><pre><code>#include <revolution/os.h></code></pre> 21 </dd> 22<dd><pre><code>void LCLoadBlocks(void* <em>destTag</em>, void* <em>srcAddr</em>, u32 <em>numBlocks</em>);</code></pre> 23 </dd> 24</dl> 25<H2>Arguments</H2> 26<TABLE border="1" cellpadding="3" cellspacing="0.1"> 27 <TBODY> 28 <TR> 29<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE><STRONG><EM><CODE>destTag</CODE></EM></STRONG></CODE></STRONG></EM></TD> 30<TD width="520">Start address for the locked cache region of the copy destination. Must be 32 byte-aligned.</TD> 31 </TR> 32 <TR> 33<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE><STRONG><EM><CODE>srcAddr</CODE></EM></STRONG></CODE></STRONG></EM></TD> 34<TD width="520">Start address for data in main memory to copy to <CODE><EM><STRONG>destAddr</STRONG></EM></CODE>. Must be 32 byte-aligned.</TD> 35 </TR> 36 <TR> 37<TD width="120" bgcolor="#ffffe8"><STRONG><EM><CODE><STRONG><EM><CODE>numBlocks</CODE></EM></STRONG></CODE></EM></STRONG></TD> 38<TD width="520">Transfer size (number of cache blocks). Must be a value from 0 to 127. If zero is specified, the transfer size is 128 blocks (4 KB).</TD> 39 </TR> 40 </TBODY> 41</TABLE> 42<H2>Return Values</H2> 43<P>None.</P> 44<h2>Description</h2> 45 46<p>Enqueues a single DMA transfer to load data into the locked cache at <code><em><strong>destTag</strong></em></code> from main memory at <code><em><strong>srcAddr</strong></em></code>. This function is more efficient than calling the <code><a href="LCLoadData.html">LCLoadData</a></code> function, but has a maximum transfer limit of 128 cache blocks (4 KB) and performs no error checking. Addresses are assumed to be 32-byte aligned, and <code><em><strong>numBlocks</strong></em></code> is assumed to be a value from 0 to 127. Note that a value of zero for <STRONG><EM><CODE>numBlocks</CODE></EM></STRONG> implies a transfer size of 128 blocks. The range of valid transfer destination addresses is the 16 KB region starting from the value returned by the <a href="LCGetBase.html"><code>LCGetBase</code></a> function.</p> 47 48<p>The only ways to determine if the transfers are complete are to poll the length of the DMA queue with the <code><a href="LCQueueLength.html">LCQueueLength</a></code> function or to wait until the queue length reaches a certain value with the <code><a href="LCQueueWait.html">LCQueueWait</a></code> function. See the <a href="LCStoreBlocks.html"><code>LCStoreBlocks</code></a> function example in the Function Reference . </p> 49 50<p>A maximum of 15 outstanding DMA transfers in the DMA queue is allowed. If the queue overflows, a machine check exception occurs.</p> 51 52<p>The locked cache must be enabled, otherwise a machine check exception will occur during the DMA.</p> 53 54<p>If DMA finds destination addresses in the normal cache, a machine check exception will occur.</p> 55 56 57 58<h2>See Also</h2> 59 60<p><a href="../list.html#Cache" target="contents">Cache Functions</a>, <code><a href="LCEnable.html">LCEnable</a>, <a href="LCStoreBlocks.html">LCStoreBlocks</a>, <a href="LCLoadData.html">LCLoadData</a>, <a href="LCQueueLength.html">LCQueueLength</a>, <a href="LCQueueWait.html">LCQueueWait</a></code></p> 61 62<h2>Revision History</h2> 63<P></P> 64<P>03/01/2006 Initial version.</p> 65</body> 66</html>