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>DCTouchRange</title>
10</head>
11
12<body>
13
14<h1>DCTouchRange</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/os.h&gt;
19
20void DCTouchRange(void* startAddr, u32 nBytes);
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<TH><STRONG><EM><CODE>startAddr</CODE></EM></STRONG></TH>
27<TD>Effective address (not the physical address) .</TD>
28  </tr>
29  <tr>
30<TH><STRONG><EM><CODE>nBytes</CODE></EM></STRONG></TH>
31<TD>Size of the region to be loaded.</TD>
32  </tr>
33</TABLE>
34
35<h2>Return Values</h2>
36<p>None.</p>
37
38<h2>Description</h2>
39<p>Loads a memory range into cache. The <SPAN class="argument">startAddr</SPAN> argument will be rounded down to the closest 32-byte boundary, while the end address (<SPAN class="argument">startAddr</SPAN> + <SPAN class="argument">nBytes</SPAN>) will be rounded up to the closest 32-byte boundary.</p>
40
41<p>Note that if the cache is frozen (via the <code><a href="DCFreeze.html">DCFreeze</a></code> function) or disabled, this routine will behave like a no-op. &nbsp;Any part of the range where cache is prohibited or invalid will be ignored.</p>
42
43<h2>See Also</h2>
44<P class="reference">
45<A href="../toc.html#Cache" target="contents">Cache Functions</A>,
46<a href="DCFlushRange.html">DCFlushRange</a>,
47<a href="DCInvalidateRange.html">DCInvalidateRange</a>,
48<a href="ICInvalidateRange.html">ICInvalidateRange</a>,
49<a href="DCStoreRange.html">DCStoreRange</a>,
50<a href="DCZeroRange.html">DCZeroRange</a>
51</p>
52
53<h2>Revision History</h2>
54<P>
552006/03/01 Initial version.<br>
56</p>
57
58<hr><p>CONFIDENTIAL</p></body>
59</html>