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 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 DCZeroRange (void* start Addr, u32 nBytes);</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>startAddr</CODE></EM></STRONG></CODE></STRONG></EM></TD> 30<TD width="520">Effective address (not the physical address) .</TD> 31 </TR> 32 <TR> 33<TD width="120" bgcolor="#ffffe8"><STRONG><EM><CODE><STRONG><EM><CODE>nBytes</CODE></EM></STRONG></CODE></EM></STRONG></TD> 34<TD width="520">Size of range to clear.</TD> 35 </TR> 36 </TBODY> 37</TABLE> 38<H2>Return Values</H2> 39<P>None.</P> 40<h2>Description</h2> 41 42<p>Loads a range into cache and zeroes out all the cache blocks. The <code><strong><em>startAddr</em></strong></code> argument is rounded down to a 32-byte boundary. The end address ( i.e., <code><strong><em>startAddr</em></strong></code><i>+ </i><strong><em><code>nBytes</code></em></strong>) is rounded up to the 32-byte boundary.</p> 43 44<p>If the cache is frozen using <code><a href="DCFreeze.html">DCFreeze</a></code>, this command will still execute. However, if the cache is disabled, an alignment exception will be generated.</p> 45 46 47 48<h2>See Also</h2> 49 50<p><a href="../toc.html#Cache" target="contents">Cache Functions</a>, <code><a href="DCFlushRange.html">DCFlushRange</a></code>, <a href="DCInvalidateRange.html"><code>DCInvalidateRange</code></a>, <code><a href="ICInvalidateRange.html">ICInvalidateRange</a>,<a href="DCStoreRange.html">DCStoreRange</a></code></p> 51 52<h2>Revision History</h2> 53<P></P> 54<P>2006/03/01 Initial version.</p> 55<hr> 56<P>CONFIDENTIAL</p> 57</BODY> 58</HTML>