DWCMatchedSCCallback

構文

#include <dwc.h>
typedef void(*) DWCMatchedSCCallback(DWCError error,
             BOOL cancel,
             BOOL self,
             BOOL isServer,
             int index,
             void *param);

引数

error DWCエラー種別。内容の詳細は、DWC_GetLastErrorExを参照してください。
cancel TRUE:キャンセルでマッチメイク終了
FALSE:キャンセルではない
self TRUE:自分がサーバへの接続に成功、もしくは接続をキャンセルした。
FALSE:他のホストがサーバへの接続に成功、もしくは接続をキャンセルした。
isServer TRUE:self=FALSEの時に上記の動作を完了したホストがサーバである
FALSE:self=FALSEの時に上記の動作を完了したホストがクライアントであるか、self=TRUE
index self=FALSEの時に、上記の動作を完了したホストの友達リストインデックス。
ホストが友達でないか、self=TRUEの時は-1となる。
param コールバック用パラメータ

返り値

なし

説明

DWC_ConnectToAnybodyAsync/DWC_ConnectToFriendsAsync/DWC_SetupGameServer/DWC_ConnectToGameServerAsync/DWC_ConnectToGameServerByGroupID関数呼出し後、1つのコネクションが確立された時、またはエラー、キャンセルが発生した時に呼ばれます。

エラー発生時は、error,param以外の各引数の値は不定です。

本コールバック関数はDWC_ConnectToAnybodyAsync/DWC_ConnectToFriendsAsync/DWC_SetupGameServer/DWC_ConnectToGameServerAsync/DWC_ConnectToGameServerByGroupID関数によって設定することができます。

引数の取り得る値の組み合わせ

・error==DWC_ERROR_NONE&&cancel==FALSEの場合
self isServer 内容
TRUE TRUE なし
TRUE FALSE 自分がクライアントで、サーバとそのネットワークへの接続に成功した。indexは-1。
FALSE TRUE なし
FALSE FALSE 自分はサーバかクライアントで、他のクライアントがサーバとそのネットワークへの接続に成功した。
indexはそのクライアントの友達リストインデックスで、友達でなければ-1。

・error==DWC_ERROR_NONE&&cancel==TRUEの場合
self isServer 内容
TRUE TRUE 自分がサーバで、自分でマッチメイクをキャンセルした。indexは-1。
TRUE FALSE 自分がクライアントで、自分でマッチメイクをキャンセルした。indexは-1。
FALSE TRUE 自分がクライアントで、サーバがマッチメイクをキャンセルした。indexはサーバの友達リストインデックス。
FALSE FALSE 自分はサーバかクライアントで、他のクライアントがマッチメイクをキャンセルした。
indexはそのクライアントの友達リストインデックスで、友達でなければ-1。

※文章中のサーバ/クライアントは、GameSpyサーバではなくWii/DS端末のことを指します。

参照

DWC_ConnectToAnybodyAsync DWC_ConnectToFriendsAsync DWC_SetupGameServer DWC_ConnectToGameServerAsync DWC_ConnectToGameServerByGroupID

履歴

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