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>DCZeroRange</title>
10</head>
11
12<body>
13
14<h1>DCZeroRange</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/os.h&gt;
19
20void DCZeroRange(void* startAddr, u32 nBytes);
21</pre></dd></dl>
22
23<H2>Arguments</H2>
24<TABLE class="arguments" border="1" >
25  <TBODY>
26    <TR>
27<TH><STRONG><EM><CODE>startAddr</CODE></EM></STRONG></TH>
28<TD>Effective address (not the physical address) .</TD>
29    </TR>
30    <TR>
31<TH><STRONG><EM><CODE>nBytes</CODE></EM></STRONG></TH>
32<TD>Size of region to be cleared.</TD>
33    </TR>
34  </TBODY>
35</TABLE>
36
37<H2>Return Values</H2>
38<P>None.</P>
39
40<h2>Description</h2>
41<p>Loads a range into cache and zeroes out all the cache blocks. 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>
42
43<p>Be aware that even if the cache is frozen using the <code><A href="DCFreeze.html">DCFreeze</A></code> function, this command will still execute. However, if the cache is disabled, an alignment exception will be generated.</p>
44
45<h2>See Also</h2>
46<P class="reference">
47<A href="../toc.html#Cache" target="contents">Cache Functions</A>,
48<a href="DCFlushRange.html">DCFlushRange</a>,
49<a href="DCInvalidateRange.html">DCInvalidateRange</a>,
50<a href="ICInvalidateRange.html">ICInvalidateRange</a>,
51<a href="DCStoreRange.html">DCStoreRange</a>
52</p>
53
54<h2>Revision History</h2>
55<P>
562006/03/01 Initial version.<br>
57</p>
58
59<hr><p>CONFIDENTIAL</p></body>
60</html>