#include <dwc.h>
BOOL DWC_RegisterMatchingStatus( void );
This function registers user's own matchmaking information (henceforth referred to as "matchmaking status") in the matchmaking server. For at least 15 seconds after this function is called, the status of user's own host can be seen by other hosts, and matchmaking can proceed.
Because this matchmaking status registration process is carried out inside the matchmaking start functions (DWC_ConnectToAnybodyAsync and DWC_ConnectToFriendsAsync), calling this function in peer matchmaking is unnecessary. However, because this matchmaking status is erased from the matchmaking server when matchmaking ends or is canceled, another 15-second wait is required when matchmaking is started again. To decrease this wait time as much as possible, call this function at an appropriate time before starting matchmaking.
For example, call this function after peer matchmaking has completed, one game has been played, and the selection has been made to continue the game.
The matchmaking status is also erased when DWC_ShutdownFriendsMatch is called. The library registers the matchmaking status when the connection to Wi-Fi Connection completes; this allows for a quick completion of the first matchmaking after a connection to the Wi-Fi Connection is established.
For server-client matchmaking, the matchmaking status registration process is conducted inside the matchmaking start functions (DWC_SetupGameServer and DWC_ConnectToGameServerAsync) in the same way as in peer matchmaking. However, the matchmaking status is not deleted until the DWC_ShutdownFriendsMatch function is called. Therefore, there is no need to call this function.
None.
TRUE |
Matchmaking status is registered with the matchmaking server. |
FALSE |
Matchmaking status not registered because not logged in or error occurred. |
DWC_ConnectToAnybodyAsync
DWC_ConnectToFriendsAsync
DWC_SetupGameServer
DWC_ConnectToGameServerAsync
DWC_ShutdownFriendsMatch
2005/12/16 Described the function in detail.
2005/11/01 Initial version.
CONFIDENTIAL