DWC_GetAIDList

構文

#include <dwc.h>
int DWC_GetAIDList(u8 **aidList);

引数

aidList AIDリストへのポインタ

返り値

自分も含めた接続中ホスト数
FriendsMatchライブラリ非動作中に本関数を呼び出した場合は0を返します。

説明

接続中ホストのAIDリストへのポインタを取得します(コピーはしません)。

AIDはマッチメイクされたグループ内の各ホストの識別番号で、0〜(ネットワーク構成台数-1)の数値が用いられます。例えば4人でマッチメイクを完了した場合なら、0,1,2,3の4台が存在し、AID=1の人がネットワークから抜ければ、残りは0,2,3となります。

接続中ホストのAIDをビットマップとして取得したい場合は、DWC_GetAIDBitmap関数を使用してください。

まだ誰とも接続したことが無い状態ではaidListに何も設定せず、0が返ります。DWCMatchedSCCallbackのerrorがDWC_ERROR_NONEで呼び出された後は必ず有効な値が取得できます。

尚、DWC_SetupGameServer関数を呼び出したホストは、DWC_SetupGameServer関数呼び出し後しばらくするとまだ誰とも繋がった事が無い状態で、
・接続人数が一人
・自分のAIDは0
の状態になります。
その他の接続APIでは、実際の接続人数・自分のAIDは、誰かと繋がるまで知ることは出来ません。

履歴

5.1pr2
DWC_SetupGameServerでサーバとして起動したホストについての説明で、重複した内容を削除

5.1pr2より前の変更履歴はこちら