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<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
8
9<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
10
11	<TITLE>MEMVisitAllocatedForExpHeap</TITLE>
12
13</HEAD>
14
15
16<BODY>
17
18
19<H1>MEMVisitAllocatedForExpHeap</H1>
20
21<H2>Syntax</H2>
22<DL><DD><PRE class="construction">
23#include &lt;revolution/mem.h&gt;
24
25void MEMVisitAllocatedForExpHeap(
26                    	MEMHeapHandle    heap,
27                    	MEMHeapVisitor   visitor,
28                    	u32              userParam );
29</PRE></DD></DL>
30
31<H2>Arguments</H2>
32<TABLE class="arguments" border="1">
33  <TR>
34<TH><STRONG><EM><CODE>heap</CODE></EM></STRONG></TH>
35<TD>Expanded heap handle</TD>
36  </TR>
37  <TR>
38<TH><code><EM><STRONG>visitor</STRONG></EM></code></TH>
39<TD>Function called for each memory block (explained below)</TD>
40  </TR>
41  <TR>
42<TH><code><EM><STRONG>userParam</STRONG></EM></code></TH>
43<TD>User-specified parameters to pass to the <CODE>visitor</CODE> function (explained below)</TD>
44  </TR>
45</TABLE>
46
47<H2>Return Values</H2>
48<P>None.</P>
49
50<H2>Description</H2>
51<P>This function causes the user-specified <SPAN class="argument">visitor</SPAN> function to be called for all memory blocks allocated from the expanded heap.</P>
52<P>The <SPAN class="argument">visitor</SPAN> type, <CODE>MEMHeapVisitor</CODE>, is defined as follows.</P>
53<BLOCKQUOTE>
54<PRE><CODE>typedef void (*MEMHeapVisitor)(
55                    void*           memBlock,
56                    MEMHeapHandle   heap,
57                    u32             userParam );</CODE></PRE>
58</BLOCKQUOTE>
59<P>The first argument is a pointer to the memory block. The second argument is the handle to the heap that allocated the memory block. The value specified by <SPAN class="argument">userParam</SPAN> is passed to the third argument without any changes; any value can be passed. </P>
60<P>The <CODE>visitor</CODE> function is called for memory blocks in the same order in which the blocks were allocated.</P>
61
62<H2>See Also</H2>
63<P class="reference">
64<A href="MEMAllocFromExpHeap.html">MEMAllocFromExpHeap</A>,
65<A href="MEMAllocFromExpHeapEx.html">MEMAllocFromExpHeapEx</A>,
66<A href="MEMCreateExpHeap.html">MEMCreateExpHeap</A>,
67<A href="MEMCreateExpHeapEx.html">MEMCreateExpHeapEx</A>
68</P>
69
70<H2>Revision History</H2>
71<P>
722006/03/01 Initial version.<BR>
73</P>
74
75<hr><p>CONFIDENTIAL</p></body>
76</HTML>
77