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 name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<TITLE>MB_FakeSetCompareGGIDCallback</TITLE>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">MB_FakeSetCompareGGIDCallback <IMG src="../../image/NTR.gif" width="24" height="12" border="0" align=middle><IMG src="../../image/TWL.gif" width="24" height="12" border="0" align=middle></h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/mb/mb_fake_child.h&gt;</CODE><BR>
20  <BR>
21  <CODE>void MB_FakeSetCompareGGIDCallback(<a href="./MBFakeCompareGGIDCallbackFunc.html">MBFakeCompareGGIDCallbackFunc</a> callback);</CODE><br>
22  <br>
23  </dd>
24</dl>
25<h2>Arguments</h2>
26<TABLE border="1" width="100%">
27  <TBODY>
28    <TR>
29      <TD width="13%"><EM><STRONG>callback</STRONG></EM></TD>
30      <TD width="87%">Sets the callback function that determines whether the beacon obtained by scanning matches the search target.
31      <br>This callback is called from within the interrupt handler.</TD>
32    </TR>
33  </TBODY>
34</TABLE>
35<h2>Return Values</h2>
36<p>None.</p>
37
38<H2>Description</H2>
39<p>This function sets the callback function for executing the user-specific filtering process when scanning for the beacon of a multiboot parent.<br>Normally, the search target is filtered by only a single GGID set by the <CODE><A href="MB_FakeStartScanParent.html">MB_FakeStartScanParent</A></CODE> function. To specify arbitrary search conditions, this function must be used.
40</p>
41<p>
42If you do not call this function or you explicitly specify <CODE>NULL</CODE>, the beacons to search will be filtered by whether they match the GGID set with the <CODE><A href="MB_FakeStartScanParent.html">MB_FakeStartScanParent</A></CODE> function. This is the default operation.
43</p>
44<p>
45If a callback other than <CODE>NULL</CODE> is specified with this function, that callback's return values will always be accepted as the only results; the GGID set with the <CODE><A href="MB_FakeStartScanParent.html">MB_FakeStartScanParent</A></CODE> function will be ignored.
46</p>
47<h2>See Also</h2>
48<p><CODE><CODE><A href="MB_FakeStartScanParent.html">MB_FakeStartScanParent</A></CODE>, <A href="./MBFakeCompareGGIDCallbackFunc.html">MBFakeCompareGGIDCallbackFunc</A><BR></CODE></P>
49<H2>Revision History</H2>
50<P>
512007/04/18 Initial version.
52</P>
53<hr><p>CONFIDENTIAL</p></body>
54</html>
55