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>MBGameInfo</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">MBGameInfo <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>Definition</h2>
16
17<dl>
18  <dd>
19  <PRE><CODE>/* This parent game information does not change */<BR>
20  typedef struct MBGameInfoFixed
21{<BR>    MBIconInfo icon;                           <BR>    MBUserInfo parent;                         <BR>    u8         maxPlayerNum;                   <BR>    u8         pad[1];<BR>    u16 gameName[ MB_GAME_NAME_LENGTH ];       <BR>    u16 gameIntroduction[ MB_GAME_INTRO_LENGTH ];<BR>} MBGameInfoFixed;<BR>
22<BR>
23<BR>/* This parent information changes dynamically */<BR><BR>typedef struct MBGameInfoVolatile<BR>
24{<BR>    u8  nowPlayerNum;<BR>    u8  pad[1];<BR>    u16 nowPlayerFlag;<BR>    u16 changePlayerFlag;<BR>    MBUserInfo member[ MB_MEMBER_MAX_NUM ];
25    u8  userVolatData[ MB_USER_VOLAT_DATA_SIZE ];<BR>} MBGameInfoVolatile;<BR>
26<BR>/* Parent game information beacon */<BR>
27typedef struct  MBGameInfo
28{<BR>    MBGameInfoFixed fixed;<BR>    MBGameInfoVolatile volat;<BR>    u16 broadcastedPlayerFlag;<BR>    u8 dataAttr;              <BR>    u8 seqNoFixed;            <BR>    u8 seqNoVolat;            <BR>    u8 fileNo;                <BR>    u8 pad[2];<BR>    u32 ggid;                 <BR>    struct MBGameInfo *nextp;<BR>} MBGameInfo;</CODE></PRE>
29  </dd>
30</dl>
31<h2>Elements</h2>
32<P><BR> The members of <b>MBGameInfo</b> are:</P>
33<TABLE border="1">
34  <TBODY>
35    <TR>
36      <TD><B><I>fixed</I></B></TD>
37      <TD colspan="2">Parent game information that does not change.</TD>
38    </TR>
39    <TR>
40      <TD><B><I>volat</I></B></TD>
41      <TD colspan="2">Volatile parent game information that changes dynamically.</TD>
42    </TR>
43    <TR>
44      <TD><B><I>broadcastedPlayerFlag</I></B></TD>
45      <TD colspan="2">Bit indicating that player information has been broadcast.</TD>
46    </TR>
47    <TR>
48      <TD><B><I>dataAttr</I></B></TD>
49      <TD colspan="2">Attributes of beacon broadcast by parent:<br>
50      MB_BEACON_DATA_ATTR_FIXED_NORMAL<BR>
51      MB_BEACON_DATA_ATTR_FIXED_NO_ICON<BR>MB_BEACON_DATA_ATTR_VOLAT</TD>
52    </TR>
53    <TR>
54      <TD><B><I>seqNoFixed</I></B></TD>
55      <TD colspan="2">Sequence number of the fixed region. When this number changes, the data in <i>fixed</i> is received again. (But this is normally fixed and not changed.)</TD>
56    </TR>
57    <TR>
58      <TD><B><I>seqNoVolat</I></B></TD>
59      <TD colspan="2">Sequence number of the volatile region. When this number changes, the data in <i>volat</i> is received again.</TD>
60    </TR>
61    <TR>
62      <TD><B><I>fileNo</I></B></TD>
63      <TD colspan="2">File number.</TD>
64    </TR>
65    <TR>
66      <TD><B><I>ggid</I></B></TD>
67      <TD colspan="2">Game group ID.</TD>
68    </TR>
69    <TR>
70      <TD><B><I>nextp</I></B></TD>
71      <TD colspan="2">Pointer to the next GameInfo (One-directional list).</TD>
72    </TR>
73  </TBODY>
74</TABLE>
75<P>The members of <b>MBGameInfoFixed</b> are:</P>
76<TABLE border="1">
77  <TBODY>
78    <TR>
79      <TD><B><I>icon</I></B></TD>
80      <TD>Icon data.</TD>
81    </TR>
82    <TR>
83      <TD><B><I>parent</I></B></TD>
84      <TD>Parent user information.</TD>
85    </TR>
86    <TR>
87      <TD><B><I>maxPlayerNum</I></B></TD>
88      <TD>Maximum number of players.</TD>
89    </TR>
90    <TR>
91      <TD><B><I>gameName</I></B></TD>
92      <TD>Game title.</TD>
93    </TR>
94    <TR>
95      <TD><B><I>gameIntroduction</I></B></TD>
96      <TD>Description of the game.</TD>
97    </TR>
98  </TBODY>
99</TABLE>
100<P><BR> The members of <b>MBGameInfoVolatile</b> are:</P>
101<TABLE border="1">
102  <TBODY>
103    <TR>
104      <TD><B><I>nowPlayerNum</I></B></TD>
105      <TD>Current number of players.</TD>
106    </TR>
107    <TR>
108      <TD><B><I>nowPlayerFlag</I></B></TD>
109      <TD>Bits indicating the player numbers for all current players.</TD>
110    </TR>
111    <TR>
112      <TD><B><I>changePlayerFlag</I></B></TD>
113      <TD>Flag indicating the number of a player whose information changed with the latest update.</TD>
114    </TR>
115    <TR>
116      <TD><B><I>member</I></B></TD>
117      <TD>Member information.</TD>
118    </TR>
119    <TR>
120      <TD><B><I>userVolatData</I></B></TD>
121      <TD>Contains user settings data that is set by the parent using the <CODE><A href="MB_SetUserVolatData.html">MB_SetUserVolatData</A></CODE> function.</TD>
122    </TR>
123  </TBODY>
124</TABLE>
125<H2>Description</H2>
126<P>This structure stores the information previously returned by the children that the multiboot parent will broadcast in its next beacon to all children.</p>
127<h2>See Also</h2>
128<p><CODE><A href="../fake_child/MB_FakeStartScanParent.html">MB_FakeStartScanParent</A> <BR></CODE></P>
129<H2>Revision History</H2>
130<P>2004/11/25 Initial version.
131</P>
132<hr><p>CONFIDENTIAL</p></body>
133</html>
134