#include <dwc.h>
typedef void (*DWCFriendStatusCallback)( int index,
u8 status,
const char* statusString,
void* param );
This is called when a friend's communications status changes.
The player's communication status is a product of the status flag displayed by "status" and the status character string displayed by the argument statusString. It is managed on the GameSpy server. The status flag is automatically set by the DWC library, but the status character string can be configured by the application using the DWC_SetOwnStatusString or DWC_SetOwnStatusData function.
This callback function can be set using DWC_SetBuddyFriendCallback.
index |
Friend roster index of the friend whose status has changed. |
status |
Friend status. DWC_STATUS_* enumerator. |
statusString |
Friend's status string. The maximum length of the character string is 255 characters + the NULL terminator. |
param |
Parameter for the callback specified by DWC_UpdateServersAsync. |
status can take any of the following values.
DWC_STATUS_OFFLINE |
Offline (indicates that the DWC is offline or that friendship with the partner has not yet been established). |
DWC_STATUS_ONLINE |
Online (logged in to a Wi-Fi Connection server). |
DWC_STATUS_PLAYING |
In-game (after matchmaking has completed). |
DWC_STATUS_MATCH_ANYBODY |
In connect-to-anybody peer matchmaking. |
DWC_STATUS_MATCH_FRIEND |
In connect-to-friends peer matchmaking. |
DWC_STATUS_MATCH_SC_CL |
Client DS undergoing server-client matchmaking. |
DWC_STATUS_MATCH_SC_SV |
Server DS undergoing server-client matchmaking. |
None.
DWC_UpdateServersAsync
DWC_SetOwnStatusString
DWC_SetOwnStatusData
2005/12/16 Added a description of the communications status and the callback select function.
2005/11/01 Initial version
CONFIDENTIAL