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_SetParentCommParam</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">MB_SetParentCommParam <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.h&gt;</CODE><BR> <BR> <CODE>BOOL MB_SetParentCommParam( u16 sendSize, u16 maxChildren );</CODE><br> <br>
20  </dd>
21</dl>
22<h2>Arguments</h2>
23<TABLE border="1" width="100%">
24  <TBODY>
25    <TR>
26<TD width="13%"><EM><STRONG>sendSize</STRONG></EM></TD>
27<TD width="87%">Send buffer size (MB) for parent MP communication. This size must be greater than <a href="../mb_comm_parent_consts.html"><code>MB_COMM_PARENT_SEND_MIN</code></a> and less than <a href="../mb_comm_parent_consts.html"><code>MB_COMM_PARENT_SEND_MAX</code></a>.</TD>
28    </TR>
29    <TR>
30<TD width="13%"><EM><STRONG>maxChildren</STRONG></EM></TD>
31<TD width="87%">The maximum number of children the MB receives. The maximum is 15 machines. If a number of child devices equal to this or more is configured to be received, calls to the <CODE><a href="MB_RegisterFile.html">MB_RegisterFile</a></CODE> function will fail. The <SPAN class="argument">maxPlayerNum</SPAN> of <code><A href="../mb_game_registry_type.html">MBGameRegistry</A></code> is the number of devices, including the parent. Therefore, to set the same number of devices, this value should be smaller by one than the value of <code><A href="../mb_game_registry_type.html">MBGameRegistry</A></code>.</TD>
32    </TR>
33  </TBODY>
34</TABLE>
35<h2>Return Values</h2>
36<p>Returns <CODE>TRUE</CODE> if values are set in the correct range. Otherwise, returns <CODE>FALSE</CODE>.</p>
37
38<H2>Description</H2>
39<P>Specifies the size of the MB library's send for internally-driven communications, including the maximum number of children. This function can be used to increase the efficiency of the MP communication packets when you already know the maximum number of connected devices. <BR>This function must be called after the <CODE><a href="../common/MB_Init.html">MB_Init</a></CODE> function and before the <CODE><A href="MB_StartParent.html">MB_StartParent</A></CODE> function.<BR><br> This function is the same as the <a href="MB_SetParentCommSize.html"><code>MB_SetParentCommSize</code></a> function except it also includes and specifies the maximum number of connected children. Note that this function cannot set the parent receive size.</p>
40<h2>See Also</h2>
41<p><code><a href="../mb_comm_parent_consts.html">MB_COMM_PARENT_*</a><BR> <a href="../mb_user_info_type.html">MBUserInfo</a><BR> <a href="../common/MB_Init.html">MB_Init</a><BR> <a href="MB_SetParentCommSize.html">MB_SetParentCommSize</a><BR> <a href="MB_StartParent.html">MB_StartParent</a><BR> <a href="MB_RegisterFile.html">MB_RegisterFile</a></code></P>
42<H2>Revision History</H2>
43<P>2004/11/18 Discontinued the <b><i><code>recvSize</code></i></b> argument.<br> 2004/10/05 Initial version.
44</P>
45<hr><p>CONFIDENTIAL</p></body>
46</html>
47