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_FakeStartScanParent</TITLE>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">MB_FakeStartScanParent <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_FakeStartScanParent( <A href="MBFakeScanCallbackFunc.html">MBFakeScanCallbackFunc</A> callback, u32 ggid );</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%">Specifies the callback function that notifies when a parent is discovered or lost.<br>This callback is called from within the interrupt handler.</TD>
31    </TR>
32    <TR>
33      <TD width="13%"><EM><STRONG>ggid</STRONG></EM></TD>
34      <TD width="87%">Specifies a 4-byte game group ID. Only parents with the specified <em>ggid</em> are discovered.</TD>
35    </TR>
36  </TBODY>
37</TABLE>
38<h2>Return Values</h2>
39<p>None.</p>
40
41<H2>Description</H2>
42<P>This function scans for a multiboot parent. If a multiboot parent is discovered with a GGID that matches the <i>ggid</i> argument, the discovery is announced by the callback. Once this function is run, all usable channels will be continuously traversed and scanned for a multiboot parent that matches the specified GGID until the <CODE><A href="MB_FakeEndScan.html">MB_FakeEndScan</A></CODE> function is called. When a parent is discovered, the function returns <code>MB_FAKESCAN_PARENT_FOUND</code> in the callback. When a parent is lost, the callback returns <code>MB_FAKESCAN_PARENT_LOST</code>. If a communication error occurs, the function returns <code>MB_FAKESCAN_API_ERROR</code>.
43</p>
44<h2>See Also</h2>
45<p><code><a href="MB_FakeEndScan.html">MB_FakeEndScan</a>, <a href="MBFakeScanCallbackFunc.html">MBFakeScanCallbackFunc</a></code></P>
46<H2>Revision History</H2>
47<P>
482005/06/01 Added text indicating that the callback is called from the interrupt handler. <br> 2004/11/25 Initial version.
49</P>
50<hr><p>CONFIDENTIAL</p></body>
51</html>
52