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>MI_LoadCache</title>
8<link rel="stylesheet" href="../../css/nitro.css" type="text/css" />
9</head>
10<body>
11<h1>MI_LoadCache <IMG src="../../image/NTR.gif" align="middle"><IMG src="../../image/TWL.gif" align="middle"></h1>
12<h2>Syntax</h2>
13<dl>
14  <dd>
15<code>#include &lt;nitro/mi.h&gt;<br />
16  <br />
17  void MI_LoadCache(<A href="MICache.html">MICache</A> *cache, <a href="../device/MIDevice.html">MIDevice</a> *device);</code></dd>
18</dl>
19
20<h2>Arguments</h2>
21<table border="1" width="100%">
22  <tbody>
23    <tr>
24      <td width="13%"><em><strong>cache</strong></em></td>
25      <td width="87%">Pointer to the <A href="MICache.html"><CODE>MICache</CODE></A> structure to access.<br />
26      The cache must have been initialized using <A href="MI_InitCache.html"><CODE>MI_InitCache()</CODE></A>.</td>
27    </tr>
28    <tr>
29      <td width="13%"><em><strong>device</strong></em></td>
30      <td width="87%">Pointer to the <a href="../device/MIDevice.html"><CODE>MIDevice</CODE></a> structure that indicates the device to load.<br />
31      The device must have been initialized using <a href="../device/MI_InitDevice.html"><CODE>MI_InitDevice()</CODE></a>.</td>
32    </tr>
33  </TBODY>
34</table>
35
36<h2>Return Values</h2>
37<p>None.</p>
38
39<h2>Description</h2>
40<p>
41Loads data from the device for all pages waiting to be loaded on the cache page list. From within this function, <a href="../device/MI_ReadDevice.html"><CODE>MI_ReadDevice()</CODE></a> is called and the page will be in the loaded state. <a href="MI_ReadCache.html"><CODE>MI_ReadCache()</CODE></a>, which failed previously after called, will succeed when it is called the next time.<br />
42</p>
43<p>
44This function is thread-safe. Other threads can use it even while <a href="MI_ReadCache.html"><CODE>MI_ReadCache()</CODE></a> is being called.
45</p>
46<p>
47Use <a href="MI_IsCacheLoading.html"><CODE>MI_IsCacheLoading()</CODE></a> in order to determine whether there are any pages waiting to be loaded.<br />The application must call this function at the appropriate time to load pages waiting to be loaded. If there are no pages waiting to be loaded, this function will do nothing when it is called.
48</p>
49<p>
50This feature is a utility that enables efficient read access to devices. For more information, see the reference for the <a href="MICache.html"><CODE>MICache</CODE></a> structure.
51</p>
52
53<h2>See Also</h2>
54<p><code><a href="MI_InitCache.html">MI_InitCache</a> <a href="MI_ReadCache.html">MI_ReadCache</a> <a href="MI_IsCacheLoading.html">MI_IsCacheLoading</a><br /> <a href="MICache.html">MICache</a></code></p>
55<h2>Revision History</h2>
56<p>
572007/05/16 Initial version.
58</p>
59<hr><p>CONFIDENTIAL</p></body>
60</html>
61