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>DC_StoreAll</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">DC_StoreAll <IMG src="../../image/NTR.gif" align="middle"><IMG src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15  <PRE><CODE>#include &lt;nitro/os.h&gt;</CODE></PRE>
16  <PRE><CODE>void DC_StoreAll( void );
17
18void DC_CleanAll( void );</CODE></PRE>
19</DL>
20<H2>Arguments</H2>
21<P>None.</P>
22<H2>Return Values</H2>
23<P>None.</P>
24<H2>Description</H2>
25<P>Stores all data from data cache regions to memory.</P>
26<P>This function performs a cache writeback in a dirty state (state when a write to data cache is not reflected in main memory), and places it in an clean state (state where all stored values in cache match memory contents).</P>
27<P>Call this function when completing data transmission data blocks that use the main memory of other devices, such as when performing DMA transfers or creating graphics commands.</P>
28<P><CODE>DC_CleanAll()</CODE> is another name for <CODE>DC_StoreAll()</CODE> and operates exactly the same way.   <code>DC_Clean*/DC_CleanAndInvalidate*</code> were prepared for porting from the prototype SDK version. In most cases, use <code>DC_Store*/DC_Flush*</code>.</P>
29<P><BR> <B>Note</B></P>
30<P>The official documentation for the ARM processor sometimes describes <strong>Flush</strong> as the operation that invalidates the data cache, <strong>Clean</strong> as the operation that writes back the data cache and puts it into a clean state, and <strong>Clean and Flush</strong> as the operation that writes back and then invalidates. However, this SDK follows the conventions of the Nintendo&nbsp;GameCube and Nintendo64 by using <strong>Invalidate</strong> for invalidation, <strong>Store</strong> for writeback, and <strong>Flush</strong> for writeback and invalidate operations. &nbsp;</P>
31<H2>Internal Operation</H2>
32<P>Operates register 7 of the system control coprocessor.</P>
33<H2>See Also</H2>
34<P><CODE><A href="IC_InvalidateAll.html">IC_InvalidateAll</A> <A href="IC_InvalidateRange.html">IC_InvalidateRange</A><BR> <A href="DC_InvalidateAll.html">DC_InvalidateAll</A> <A href="DC_InvalidateRange.html">DC_InvalidateRange</A><BR> <A href="DC_StoreRange.html">DC_StoreRange</A><BR> <A href="DC_FlushAll.html">DC_FlushAll</A> <A href="DC_FlushRange.html">DC_FlushRange</A></CODE></P>
35<H2>Revision History</H2>
36<P>2003/12/22 Initial version.</P>
37<hr><p>CONFIDENTIAL</p></body>
38</HTML>