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>WMParentParam</title> 9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13 14<h1 align="left">WMParentParam</h1> 15 16<h2>Definition</h2> 17 18<dl> 19 <dd> 20<CODE>#include <nitro/wm.h></CODE><BR> 21 <PRE><CODE> 22typedef struct WMParentParam 23{ 24 u16* userGameInfo; 25 u16 userGameInfoLength; 26 u16 padding 27 u32 ggid; 28 u16 tgid; 29 u16 entryFlag; 30 u16 maxEntry; 31 u16 multiBootFlag; 32 u16 KS_Flag; 33 u16 CS_Flag; 34 u16 beaconPeriod; 35 u16 rsv1[4]; 36 u16 rsv2[8]; 37 u16 channel; 38 u16 parentMaxSize; 39 u16 childMaxSize; 40 u16 rsv[4]; 41 42} WMParentParam; 43</CODE></PRE> 44 </dd> 45 46</dl><h2>Elements</h2> 47<TABLE border="1" width="100%"> 48 <TBODY> 49 <TR> 50<TD width="200"><CODE>userGameInfo</CODE></TD> 51<TD width="800">Pointer to user game information.</TD> 52 </TR> 53 <TR> 54<TD width="200"><CODE>userGameInfoLength</CODE></TD> 55<TD width="800">Size of user game information in bytes. A maximum of 112 bytes can be specified.</TD> 56 </TR> 57 <TR> 58<TD width="200"><CODE>ggid</CODE></TD> 59<TD width="800">Game group ID that is allocated for each title or series. Specified as 4-byte data.</TD> 60 </TR> 61 <TR> 62<TD width="200"><CODE>tgid</CODE></TD> 63<TD width="800">Temporary group ID. This argument must be a value that is different from the one that begins activity as a parent.</TD> 64 </TR> 65 <TR> 66<TD width="200"><CODE>entryFlag</CODE></TD> 67<TD width="800">Flag that permits a connection from a child. Set to 0 or 1. A connection from the child is permitted when this flag is set to 1.</TD> 68 </TR> 69 <TR> 70<TD width="200"><CODE>maxEntry</CODE></TD> 71<TD width="800">Number of children that are permitted for the connection. Connection is denied once the number of children that are connected exceed this number. Up to 15 children can be connected. Use a value from 1 through 15.</TD> 72 </TR> 73 <TR> 74<TD width="200"><CODE>multiBootFlag</CODE></TD> 75<TD width="800">Flag that indicates a multiboot parent. Set to 0 or 1. When set to 1, the machine will act as a parent that sends multiboot data. When acting as a multiboot parent, this will be set to 1 automatically by the MB library. Therefore, this should usually be set to 0.</TD> 76 </TR> 77 <TR> 78<TD width="200"><CODE>KS_Flag</CODE></TD> 79<TD width="800">Available to maintain compatibility with older versions. Specify 0.</TD> 80 </TR> 81 <TR> 82<TD width="200"><CODE>CS_Flag</CODE></TD> 83<TD width="800">Allows the function to maintain compatibility with previous versions and is no longer used.</TD> 84 </TR> 85 <TR> 86<TD width="200"><CODE>beaconPeriod</CODE></TD> 87<TD width="800">Interval, in milliseconds, for regularly sending the broadcast data (this structure's data) for the child. Set to a value from 10 through 1,000. Normally, the value obtained in the <A href="WM_GetDispersionBeaconPeriod.html"><CODE>WM_GetDispersionBeaconPeriod</CODE></A> function should be designated here.</TD> 88 </TR> 89 <TR> 90<TD width="200"><code>rsv1<br />rsv2</code></TD> 91<TD width="800">Reserved regions. These members may be deleted in the future.</TD> 92 </TR> 93 <TR> 94<TD width="200"><CODE>channel</CODE></TD> 95<TD width="800">Wireless channel to act as parent. Select a channel from 1 through 13 that has been confirmed as available by <A href="WM_GetAllowedChannel.html"><CODE>WM_GetAllowedChannel</CODE></A>.</TD> 96 </TR> 97 <TR> 98<TD width="200"><CODE>parentMaxSize</CODE></TD> 99<TD width="800">Default value of the parent send capacity for MP communication. The send capacity must be a multiple of 2. A maximum size of 512 bytes can be specified for this value. 100 </TD> 101 </TR> 102 <TR> 103<TD width="200"><CODE>childMaxSize</CODE></TD> 104<TD width="800">Default value of the child send capacity for MP communication. The send capacity must be a multiple of 2. Specify a maximum size of 512 bytes for this value. 105 </TD> 106 </TR> 107 </TBODY> 108</TABLE> 109 110<H2>Description</H2> 111<P> 112The structure of the information that should be set when starting activity as a parent. User-defined data can be set in <code>userGameInfo</code>. Change it with the <A href="WM_SetGameInfo.html"><CODE>WM_SetGameInfo</CODE></A> function later. <code>userGameInfoLength</code> is a maximum of <code>WM_SIZE_USER_GAMEINFO</code> bytes (currently 112 bytes). Change the <CODE>entryFlag</CODE> argument with the <A href="WM_SetEntry.html"><CODE>WM_SetEntry</CODE></A> function later. If the <code>beaconPeriod</code> argument is too short, it interferes with MP communication. Normally, it should be set to a few hundred ms. For the <CODE>channel</CODE> argument, select one from the channels that was permitted by <A href="WM_GetAllowedChannel.html"><CODE>WM_GetAllowedChannel</CODE></A>. <code>parentMaxSize</code> and <code>childMaxSize</code> specify the default value for the send capacity for parent and children, respectively, and there are some restrictions as mentioned in the programming guideline. Use the <a href="wm_time_calc.html">wireless communication time calculation sheet</a>, and make sure that the time that is required for one MP communication does not exceed 5600 μs. The <code>KS_Flag</code> field remains in order to maintain compatibility with older versions. Be sure to specify 0. In order to maintain compatibility with older versions, if <code>KS_Flag</code> is set to 1, 36+6 is internally added to <code>parentMaxSize</code> and 2+4 to <code>childMaxSize</code>. 113</P> 114 115<H2>Revision History</H2> 116<P> 1172005/12/08 Deleted a section related to key sharing.<BR>2005/12/08 Clearly stated that the send capacity must be an even number.<BR>2005/12/06 Changed "maximum send size" to "default value for the send capacity."<BR>2005/03/14 Corrected link destination errors.<br />2005/03/02 Added a description of the allowable range for structure members.<br />2004/11/12 Added a statement regarding the unit of <code>userGameInfoLength</code>.<br />2004/10/18 Added a statement regarding a value that needs to be specified to <code>beaconPeriod</code>.<br />2004/10/04 Changed the game group ID to u32 type.<br />2004/09/24 Added <B>Description</B>.<br />2004/09/21 Added <B>Description</B>.<br />2004/08/27 Revised because of changes to structure members.<br />2004/08/02 Standardized structure names.<br />2004/07/29 Initial version. 118</P> 119<hr><p>CONFIDENTIAL</p></body> 120</html> 121