# MBGameRegistry

## 定義

  `#include <nitro/mb.h>`

      typedef	struct
      {
          const char    *romFilePathp;
          u16           *gameNamep;
          u16           *gameIntroductionp;
          const char    *iconCharPathp;
          const char    *iconPalettePathp;
          u32           ggid;
          u8            maxPlayerNum;
          u8            pad[3];
          u8            userParam[MB_DOWNLOAD_PARAMETER_SIZE];
      } MBGameRegistry;

## 説明

`MB_RegistryFile()` によってダウンロードファイルを指定する際に使用する構造体です。
各メンバの意味は以下の通りです。

メンバ | 意味
romFilePathp | プログラムバイナリのファイルパス文字列を指すポインタです。 マルチブートで動作する子機用バイナリは、NITRO ROM、HYBRID ROM です。詳しくは概要をご覧下さい。 MB関数の現在の実装ではこのメンバを参照せずFSFile構造体へのポインタを要求しますが、 将来の拡張のために用意されています。
gameNamep | ゲーム名の文字列を指すポインタです。 文字列は`MB_GAME_NAME_LENGTH`文字以内である必要があります。
gameIntroductionp | ゲーム内容の説明文文字列を指すポインタです。 文字列は`MB_GAME_INTRO_LENGTH`文字以内である必要があります。
iconCharPathp | アイコンキャラデータファイルへのパス文字列を指すポインタです。
iconPalettePathp | アイコンパレットデータファイルへのパス文字列を指すポインタです。

ggid

このゲームのダウンロード時に子機へ渡されるGGID値です。
この値はマルチブート子機が`MB_GetMultiBootParentBssDesc()` で取得する
`MBParentBssDesc`構造体のssid[0], ssid[1], ssid[2], ssid[3] にリトルエンディアンで格納されます。
`MB_ReadMultiBootParentBssDesc()` ではこの値を使用して
親機へ接続するための`WMBssDesc` 情報を生成します。
マルチブート子機側にて上記用途で使用しない場合は、任意のu32値として自由に扱うことができます。

maxPlayerNum | このゲームの親機を含む最大プレイ人数です。最大16台。 ここで設定する値は同時にエントリー可能な最大人数であり、 マルチブート時の最大同時接続子機台数は`MB_SetParentCommParam()` で別に設定する必要があります。`MB_SetParentCommParam()` で設定する値は親機を含まない台数ですので、MBGameRegistryの値よりも１小さくなります。
userParam | このゲームを起動した子機プログラムへ与えることのできるユーザ定義の拡張パラメータです。 最大 MB_DOWNLOAD_PARAMETER_SIZE (=32) バイトまでの自由なデータを設定することができ、 起動した子機プログラムは`MB_GetMultiBootDownloadParameter()` を呼び出してこのデータを参照することができます。

## 参照

`MB_GAME_* MBIconInfo MBParentBssDesc WMBssDesc
MB_GetMultiBootParentBssDesc MB_GetMultiBootDownloadParameter MB_ReadMultiBootParentBssDesc MB_RegisterFile`

## 履歴

2008/09/16 マルチブート子機で使用できるバイナリの ROM について注意追加
2005/08/17 MB_GetMultiBootDownloadParameter()へのリンクを追加
2005/05/20 メンバ userParam を追加
2004/11/02 メンバ名を訂正
2004/10/18 ggidに関する説明を修正
2004/10/05 ggidに関する説明を修正
2004/09/27 リンク追加
2004/09/10 iconCharp, iconPalettepに関する記述を修正。
2004/08/09 初版