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 http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<title>VFInit(Ex)</title>
9</head>
10
11<body>
12
13<h1>VFInit</h1>
14
15<h2>C Specification</h2>
16<dl><dd><pre><code>
17#include &lt;revolution/vf.h&gt;
18
19#define	VF_DRIVE_WORKSIZE		(16 * 1024)
20
21void VFInit();
22void VFInitEx( void* heapStartAddress, u32 size );
23</code></pre></dd></dl>
24
25<h2>Arguments</h2>
26<p>
27<TABLE border="1" >
28  <tr>
29<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>heapStartAddress</EM></STRONG></CODE></TD>
30<TD width="520">Work region (16 kilobytes required for each drive).</TD>
31  </tr>
32  <tr>
33<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>size</EM></STRONG></CODE></TD>
34<TD width="520">The size of the work region.</TD>
35  </tr>
36</p></TABLE>
37
38<h2>Return Values</h2>
39<p>
40None.</p>
41
42
43<H2>Description</H2>
44<p>
45Initializes the VF library.<br><br> When you use the <CODE>VFInit()</CODE> function, static memory equal to 26 drives in size is used as the internal work region for the VF library.<br> If you use the <CODE>VFInitEx()</CODE> function instead, the size of this internal work region can be specified explicitly. Minimize the size and avoid having a large resident static memory by specifying the following for the value: <br>     <I>The necessary number of drives x <CODE>VF_DRIVE_WORKSIZE</CODE> (16KBytes)</I>.<br> <br>Be sure to call <code><a href="./VFFinalize.html">VFFinalize</a></code> before destroying the region passed by <CODE>VFInitEx</CODE>. If <CODE>VFInit</CODE> is called multiple times, calls following the first one are ignored. If <code><a href="./VFFinalize.html">VFFinalize</a></code> is called, only the first <CODE>VFInit</CODE> call after it is enabled. To check whether VFInit has already been called, use <code><a href="./VFIsAvailable.html">VF IsAvailable</a></code>.<br>
46</p>
47
48<h2>See Also</h2>
49<code><a href="./VFFinalize.html">VFFinalize</a></code>, <code><a href="./VFIsAvailable.html">VFIsAvailable</a></code>
50
51<H2>Revision History</H2>
52<p>2006/09/11</p>
53
54
55<hr><p>CONFIDENTIAL</p></body>
56</html>
57