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の値よりも1小さくなります。
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 初版