DWC_RegisterMatchStatus

構文

#include <dwc.h>
BOOL DWC_RegisterMatchStatus(void);

引数

なし

返り値

TRUE マッチメイキングサーバにマッチメイクステータスが登録された。
FALSE ログイン前、もしくはエラーのため登録されなかった。

説明

自分のマッチメイクのための情報(以下マッチメイクステータス)をマッチメイキングサーバに登録します。この関数が呼ばれてから最短15秒程で、マッチメイキングサーバにアクセスした他ホストから、自分の状態が見えるようになり、マッチメイクを進められるようになります。

ピアマッチメイクにおいては、マッチメイク開始関数(DWC_ConnectToAnybodyAsync/DWC_ConnectToFriendsAsync)内でこのマッチメイクステータス登録処理が行われているため、本関数の呼び出しは必須ではありません。しかし、マッチメイクが終わったり、キャンセルした時点でマッチメイキングサーバからこのマッチメイクステータスが消去されるため、次回マッチメイク開始時にはまた15秒程の待ち時間が発生します。この待ち時間をできるだけ減らしたい場合に、マッチメイク開始前の適当なタイミングで本関数を呼び出してください。

例えば、ピアマッチメイクが完了した後、1ゲーム遊び終えて、ゲームを続けることを選んだ時点で本関数を呼び出す、といった使い方が考えられます。

なお、マッチメイクステータスはDWC_ShutdownFriendsMatch関数を呼んだ時にも消去されます。また、Wi-Fiコネクション接続後1回目のマッチメイクを早く終わらせるために、Wi-Fiコネクションへの接続が完了した時点で、ライブラリがマッチメイクステータスの登録を行っています。

サーバクライアントマッチメイクでは、ピアマッチメイクと同様にマッチメイク開始関数(DWC_SetupGameServer/DWC_ConnectToGameServerAsync)内でマッチメイクステータス登録処理が行われていますが、DWC_ShutdownFriendsMatch関数が呼ばれるまでマッチメイクステータスが消去されることはありません。そのため、本関数を呼び出す必要はありません。

履歴

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