1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7<title>InitializeLatencyEmulation</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../nn/Overview.html">nn</a>::<a href="../../nn/fs/Overview.html">fs</a>::InitializeLatencyEmulation</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14void InitializeLatencyEmulation(
15     void
16);
17</pre>
18    </div>
19<h2>Parameters</h2>
20    <div class="section">
21<p>None.</p>
22    </div>
23<h2>Return Values</h2>
24    <div class="section">
25None.
26               </div>
27<h2>Description</h2>
28    <div class="section">
29<p>Initializes the feature for emulating the behavior of a non-volatile memory device that has become degraded, and the behavior when a conflict arises for FS resources with a process in the background.</p><p>
30Be absolutely sure to call this initialization function because the emulation feature cannot be enabled unless you do.<br />You can enable/disable this feature in the Config settings.<br />In the retail product environment, this feature is invariably disabled, so there is no problem including a call to this function in the product code.
31            </p><p>
32Total latency is the sum of the routinely-applied delay time plus a random delay time determined separately for each access event.<br />A randomly determined delay time is enabled only if the debug mode setting is enabled by <CODE>Config</CODE>.<br />For each <CODE>Read/TryRead</CODE>, the range is 0 ms to 100 ms. For each <CODE>Write/TryWrite</CODE>, the range is 0 ms to 380 ms. If disabled, it is 0. <br />The routinely-applied delay time takes the value configured in the <CODE>FS Latency Emulation</CODE> settings in <CODE>Config</CODE>.
33            </p><p>
34The table shows latency times in the development environment.
35</p><table><thead><tr><th colspan="2">Config settings</th><th rowspan="2">Delay time</th></tr><tr><th>Debug Mode</th><th>FS Latency Emulation</th></tr></thead><tbody><tr><td>enable</td><td>Some time other than 0 ms</td><td>Random delay + routine delay</td></tr><tr><td>enable</td><td>0 ms</td><td>Random delay only</td></tr><tr><td>disable</td><td>Some time other than 0 ms</td><td>Routine delay only</td></tr><tr><td>disable</td><td>0 ms</td><td>None</td></tr></tbody></table></div>
36<h2>Revision History</h2>
37    <div class="section">
38      <dl class="history">
39        <dt>2012/09/05</dt>
40<dd>Described the range of the randomly-determined delay times.
41        </dd>
42        <dt>2012/04/16</dt>
43<dd>Added description of the relationship between Config settings and the behavior of latency emulation.<br />
44        </dd>
45        <dt>2011/10/27</dt>
46<dd>Initial version.<br />
47        </dd>
48      </dl>
49    </div>
50  <hr><p>CONFIDENTIAL</p></body>
51</html>