TWLDWC ライブラリ定数

定数

定義


#include <dwc.h>

#define   DWC_COMMONSTR_MAX_KEY_VALUE_LEN         4096
#define   DWC_FRIEND_STATUS_STRING_LEN            (256)
#define   DWC_MAX_PLAYER_NAME                     26
#define   DWC_INVALID_AID                         (0xff)
#define   DWC_MAX_CONNECTIONS                     32
#define   DWC_QR2_GAME_KEY_START                  100
#define   DWC_QR2_RESERVED_KEYS                   (100-50)
#define   DWC_QR2_GAME_RESERVED_KEYS              (DWC_MAX_REGISTERED_KEYS-DWC_QR2_RESERVED_KEYS-DWC_QR2_RESERVED_KEYS)
#define   DWC_CONNECTION_USERDATA_LEN             4
#define   DWC_ND_FILENAME_LEN                     32
#define   DWC_ND_FILEATTR_LEN                     10
#define   DWC_ND_FILEEXPLSIN_LEN                  50
#define   DWC_ND_THREAD_PRIORITY                  17
#define   DWC_ND_LENGTH_GAMECODE                  4
#define   DWC_ND_LENGTH_PASSWORD                  16
#define   DWC_RNK_DATA_MAX                        764
#define   DWC_RNK_CATEGORY_MAX                    1000
#define   DWC_RNK_GET_MAX                         30
#define   DWC_RNK_FRIENDS_MAX                     64
#define   DWC_SVL_HOST_LENGTH                     64
#define   DWC_SVL_TOKEN_LENGTH                    300
#define   DWC_SVL_STATUSDATA_LENGTH               1
#define   DWC_TRANSPORT_MTU_SIZE                  1500
#define   DWC_TRANSPORT_RELIABLE_ALL_HEADER_SIZE  35
#define   DWC_TRANSPORT_UNRELIABLE_ALL_HEADER_SIZE 38
#define   DWC_TRANSPORT_SEND_RELIABLE_MAX         (DWC_TRANSPORT_MTU_SIZE-DWC_TRANSPORT_RELIABLE_ALL_HEADER_SIZE)
#define   DWC_TRANSPORT_SEND_UNRELIABLE_MAX       (DWC_TRANSPORT_MTU_SIZE-DWC_TRANSPORT_UNRELIABLE_ALL_HEADER_SIZE)
#define   DWC_TRANSPORT_SEND_MAX                  DWC_TRANSPORT_SEND_RELIABLE_MAX

				

説明

DWC_COMMONSTR_MAX_KEY_VALUE_LEN 汎用key/value文字列のそれぞれの最大文字列長
DWC_FRIEND_STATUS_STRING_LEN DWC_GetOwnStatusString関数やDWC_SetOwnStatusString関数やDWC_GetFriendStatusSC関数で指定できるステータス文字列の長さ(NULL終端含む)
DWC_MAX_PLAYER_NAME プレイヤー名(ゲーム内スクリーンネーム)の最大長(ワイド文字25文字+"\0\0")
DWC_INVALID_AID 無効なAIDを示す値
DWC_MAX_CONNECTIONS 最大同時接続数
DWC_QR2_GAME_KEY_START ゲーム定義キーの開始値
DWC_QR2_RESERVED_KEYS DWCの予約キー数
DWC_QR2_GAME_RESERVED_KEYS ゲームで最大使用できるキーの数(154)
DWC_CONNECTION_USERDATA_LEN マッチメイク接続条件に使われるバッファ長
DWC_ND_FILENAME_LEN ファイル取得時に指定するファイル名の最大文字列長
DWC_ND_FILEATTR_LEN ファイル取得前に指定する属性の最大文字列長
DWC_ND_FILEEXPLSIN_LEN ファイルに指定されているUTF16LEで表現された説明文の最大文字列長
DWC_ND_THREAD_PRIORITY ダウンロードライブラリ内部で使用するスレッドの優先度
DWC_ND_LENGTH_GAMECODE DLゲームコード(gamecd)のバイト長
DWC_ND_LENGTH_PASSWORD 秘密鍵(passwd)のバイト長
DWC_RNK_DATA_MAX ユーザー定義データに使用できる最大サイズ
DWC_RNK_CATEGORY_MAX カテゴリーとして指定できる最大値
DWC_RNK_GET_MAX 取得するランキングリストの最大数の上限値
DWC_RNK_FRIENDS_MAX 友達の最大数
DWC_SVL_HOST_LENGTH ホスト名の最大文字数
DWC_SVL_TOKEN_LENGTH トークンの最大文字数
DWC_SVL_STATUSDATA_LENGTH ステータスのサイズ
DWC_TRANSPORT_MTU_SIZE Reliable/Unreliable送信で送信できる最大IPパケットサイズ
DWC_TRANSPORT_RELIABLE_ALL_HEADER_SIZE Reliable送信で付加されるヘッダサイズ
DWC_TRANSPORT_UNRELIABLE_ALL_HEADER_SIZE Unreliable送信で付加されるヘッダサイズ
DWC_TRANSPORT_SEND_RELIABLE_MAX Reliable送信で一度に送信できる最大データサイズ。
DWC_TRANSPORT_SEND_UNRELIABLE_MAX Unreliable送信で一度に送信できる最大データサイズ。
DWC_TRANSPORT_SEND_MAX Reliable送信で一度に送信できる最大データサイズ。(互換性のために残されています。DWC_TRANSPORT_SEND_RELIABLE_MAXを使用してください。

列挙型

インターネット接続状態

enum DWCInetResult {
    DWC_CONNECTINET_STATE_NOT_INITIALIZED    =  0,
    DWC_CONNECTINET_STATE_IDLE,
    DWC_CONNECTINET_STATE_OPERATING,
    DWC_CONNECTINET_STATE_OPERATED,
    DWC_CONNECTINET_STATE_CONNECTED,
    DWC_CONNECTINET_STATE_DISCONNECTING,
    DWC_CONNECTINET_STATE_DISCONNECTED,
    DWC_CONNECTINET_STATE_ERROR,
    DWC_CONNECTINET_STATE_FATAL_ERROR,
    DWC_CONNECTINET_STATE_LAST,
};
DWC_CONNECTINET_STATE_NOT_INITIALIZED 初期化されていない
DWC_CONNECTINET_STATE_IDLE 接続開始されていない
DWC_CONNECTINET_STATE_OPERATING 処理中
DWC_CONNECTINET_STATE_OPERATED 処理完了
DWC_CONNECTINET_STATE_CONNECTED インターネットへ接続済み
DWC_CONNECTINET_STATE_DISCONNECTING インターネットから切断中
DWC_CONNECTINET_STATE_DISCONNECTED インターネットから切断された
DWC_CONNECTINET_STATE_ERROR エラーが発生した
DWC_CONNECTINET_STATE_FATAL_ERROR 致命的なエラーが発生した
DWC_CONNECTINET_STATE_LAST

認証サーバの種類

enum DWCInetAuthType {
    DWC_CONNECTINET_AUTH_TEST,
    DWC_CONNECTINET_AUTH_DEVELOP,
    DWC_CONNECTINET_AUTH_RELEASE,
    DWC_CONNECTINET_AUTH_LAST,
};
DWC_CONNECTINET_AUTH_TEST 開発向け認証サーバ
DWC_CONNECTINET_AUTH_DEVELOP ライブラリ開発用認証サーバ(使用しないで下さい)
DWC_CONNECTINET_AUTH_RELEASE 製品向け認証サーバ
DWC_CONNECTINET_AUTH_LAST

履歴

5.2pr1
DWC_CONNECTINET_AUTH_DEVELOP,DWC_CONNECTINET_AUTH_RELEASEの説明が間違っていたので修正

ニンテンドーWi-Fiステーション/NintendoZoneの設置地域を示すエリアコード

enum DWCApInfoArea {
    DWC_APINFO_AREA_JPN        =  0,
    DWC_APINFO_AREA_USA,
    DWC_APINFO_AREA_EUR,
    DWC_APINFO_AREA_AUS,
    DWC_APINFO_AREA_KOR,
    DWC_APINFO_AREA_UNKNOWN    =  0xff,
};
DWC_APINFO_AREA_JPN 日本
DWC_APINFO_AREA_USA 北米
DWC_APINFO_AREA_EUR 欧州
DWC_APINFO_AREA_AUS 豪州
DWC_APINFO_AREA_KOR 韓国
DWC_APINFO_AREA_UNKNOWN 不明(ニンテンドーWi-Fiステーション/NintendoZoneではない)

APタイプ

enum DWCApInfoType {
    DWC_APINFO_TYPE_USER0           =  0,
    DWC_APINFO_TYPE_USER1,
    DWC_APINFO_TYPE_USER2,
    DWC_APINFO_TYPE_USB,
    DWC_APINFO_TYPE_SHOP,
    DWC_APINFO_TYPE_FREESPOT,
    DWC_APINFO_TYPE_WAYPORT,
    DWC_APINFO_TYPE_OTHER,
    DWC_APINFO_TYPE_NINTENDOWFC     =  DWC_APINFO_TYPE_OTHER,
    DWC_APINFO_TYPE_NINTENDOZONE,
    DWC_APINFO_TYPE_USER3           =  0x0a,
    DWC_APINFO_TYPE_USER4,
    DWC_APINFO_TYPE_USER5,
    DWC_APINFO_TYPE_UNKNOWN         =  99,
};
DWC_APINFO_TYPE_USER0 接続先1のアクセスポイント
DWC_APINFO_TYPE_USER1 接続先2のアクセスポイント
DWC_APINFO_TYPE_USER2 接続先3のアクセスポイント
DWC_APINFO_TYPE_USB ニンテンドーWi-FiUSBコネクタ
DWC_APINFO_TYPE_SHOP ニンテンドーWi-Fiステーション
DWC_APINFO_TYPE_FREESPOT FREESPOT(フリースポット)
DWC_APINFO_TYPE_WAYPORT Wayport(北米ホットスポット)※現在は使用できません
DWC_APINFO_TYPE_OTHER (旧定義)
DWC_APINFO_TYPE_NINTENDOWFC (予約)
DWC_APINFO_TYPE_NINTENDOZONE NintendoZone
DWC_APINFO_TYPE_USER3 接続先4のアクセスポイント ※NITROROMではこの定義はありません
DWC_APINFO_TYPE_USER4 接続先5のアクセスポイント ※NITROROMではこの定義はありません
DWC_APINFO_TYPE_USER5 接続先6のアクセスポイント ※NITROROMではこの定義はありません
DWC_APINFO_TYPE_UNKNOWN 不明

履歴

5.1
Wayport(北米ホットスポット)が現在は使用できないことについて追記

無線セキュリティタイプ

enum DWCApInfoSecurity {
    DWC_APINFO_WSEC_NONE             =  0x00,
    DWC_APINFO_WSEC_WEPMODE_40,
    DWC_APINFO_WSEC_WEPMODE_104,
    DWC_APINFO_WSEC_WEPMODE_128,
    DWC_APINFO_WSEC_WPA_PSK_TKIP,
    DWC_APINFO_WSEC_WPA2_PSK_TKIP,
    DWC_APINFO_WSEC_WPA_PSK_AES,
    DWC_APINFO_WSEC_WPA2_PSK_AES,
};
DWC_APINFO_WSEC_NONE 暗号化なし
DWC_APINFO_WSEC_WEPMODE_40 RC4(40ビット)暗号化モード
DWC_APINFO_WSEC_WEPMODE_104 RC4(104ビット)暗号化モード
DWC_APINFO_WSEC_WEPMODE_128 RC4(128ビット)暗号化モード
DWC_APINFO_WSEC_WPA_PSK_TKIP WPA-PSK(TKIP)暗号 ※NITROROMではこの定義はありません
DWC_APINFO_WSEC_WPA2_PSK_TKIP WPA2-PSK(TKIP)暗号 ※NITROROMではこの定義はありません
DWC_APINFO_WSEC_WPA_PSK_AES WPA-PSK(AES)暗号 ※NITROROMではこの定義はありません
DWC_APINFO_WSEC_WPA2_PSK_AES WPA2-PSK(AES)暗号 ※NITROROMではこの定義はありません

インターネットとの接続テストの通信処理結果

enum DWCTestInetResult {
    DWC_TESTINET_NOT_INITIALIZED    =  0,
    DWC_TESTINET_OPERATING,
    DWC_TESTINET_CONNECTED,
    DWC_TESTINET_DISCONNECTED,
};
DWC_TESTINET_NOT_INITIALIZED DWC_TestInetAsync関数が呼び出されていない
DWC_TESTINET_OPERATING 通信処理を実行中
DWC_TESTINET_CONNECTED インターネットに接続されている
DWC_TESTINET_DISCONNECTED インターネットに接続されていない

Proxy認証形式

enum DWCProxyAuthType {
    DWC_PROXY_AUTHTYPE_NONE     =  0x00,
    DWC_PROXY_AUTHTYPE_BASIC,
};
DWC_PROXY_AUTHTYPE_NONE 認証なし
DWC_PROXY_AUTHTYPE_BASIC BASIC認証

Persistentサーバログイン状態

enum  {
    DWC_PERS_STATE_INIT         =  0,
    DWC_PERS_STATE_LOGIN,
    DWC_PERS_STATE_CONNECTED,
    DWC_PERS_STATE_NUM,
};
DWC_PERS_STATE_INIT 初期状態
DWC_PERS_STATE_LOGIN ログイン中
DWC_PERS_STATE_CONNECTED 接続状態
DWC_PERS_STATE_NUM

エラー列挙子

enum DWCError {
    DWC_ERROR_NONE                   =  0,
    DWC_ERROR_DS_MEMORY_ANY,
    DWC_ERROR_AUTH_ANY,
    DWC_ERROR_AUTH_OUT_OF_SERVICE,
    DWC_ERROR_AUTH_STOP_SERVICE,
    DWC_ERROR_AC_ANY,
    DWC_ERROR_NETWORK,
    DWC_ERROR_GHTTP_ANY,
    DWC_ERROR_DISCONNECTED,
    DWC_ERROR_FATAL,
    DWC_ERROR_FRIENDS_SHORTAGE,
    DWC_ERROR_NOT_FRIEND_SERVER,
    DWC_ERROR_SERVER_FULL,
    DWC_ERROR_ND_ANY,
    DWC_ERROR_ND_HTTP,
    DWC_ERROR_SVL_ANY,
    DWC_ERROR_SVL_HTTP,
    DWC_ERROR_PROF_ANY,
    DWC_ERROR_PROF_HTTP,
    DWC_ERROR_GDB_ANY,
    DWC_ERROR_SC_CONNECT_BLOCK,
    DWC_ERROR_NETWORK_LIGHT,
    DWC_ERROR_NUM,
};
DWC_ERROR_NONE エラーなし
DWC_ERROR_DS_MEMORY_ANY 本体セーブデータに関するエラー
DWC_ERROR_AUTH_ANY 認証に関するエラー
DWC_ERROR_AUTH_OUT_OF_SERVICE サービス終了
DWC_ERROR_AUTH_STOP_SERVICE サービス一時中断
DWC_ERROR_AC_ANY 自動接続に関するエラー
DWC_ERROR_NETWORK その他のネットワークエラー
DWC_ERROR_GHTTP_ANY HTTP通信(GameSpyHTTP)のエラー
DWC_ERROR_DISCONNECTED 切断された
DWC_ERROR_FATAL 致命的なエラー
DWC_ERROR_FRIENDS_SHORTAGE 指定の人数の有効な友達がいないのに友達指定ピアマッチメイクを始めようとした
DWC_ERROR_NOT_FRIEND_SERVER サーバクライアントマッチメイクで、サーバに指定した友達が相互に友達ではない、もしくはサーバを立てていない
DWC_ERROR_SERVER_FULL サーバクライアントマッチメイクのサーバが定員オーバー
DWC_ERROR_ND_ANY ダウンロードライブラリのエラー
DWC_ERROR_ND_HTTP ダウンロードライブラリのHTTPエラー
DWC_ERROR_SVL_ANY サービスロケータのエラー
DWC_ERROR_SVL_HTTP サービスロケータ情報取得中のHTTP通信エラー
DWC_ERROR_PROF_ANY 不正文字列チェックでサーバの応答がおかしいときに発生するエラー
DWC_ERROR_PROF_HTTP 不正文字列チェックのHTTPエラー
DWC_ERROR_GDB_ANY GDBライブラリのエラー。通常のDWCでは発生しません。
DWC_ERROR_SC_CONNECT_BLOCK サーバクライアントマッチメイクで、クライアントがサーバから接続を拒否された
DWC_ERROR_NETWORK_LIGHT 軽度として扱うネットワークエラー
DWC_ERROR_NUM

エラー検出時に必要な処理を示すエラータイプ

enum DWCErrorType {
    DWC_ETYPE_NO_ERROR          =  0,
    DWC_ETYPE_LIGHT,
    DWC_ETYPE_SHOW_ERROR,
    DWC_ETYPE_SHUTDOWN_FM,
    DWC_ETYPE_SHUTDOWN_GHTTP,
    DWC_ETYPE_SHUTDOWN_ND,
    DWC_ETYPE_DISCONNECT,
    DWC_ETYPE_FATAL,
    DWC_ETYPE_NUM,
};
DWC_ETYPE_NO_ERROR エラーなし
DWC_ETYPE_LIGHT ゲーム固有の表示のみで、エラーコード表示は必要ありません。
DWC_ClearError関数を呼び出せば、復帰可能です。
DWC_ETYPE_SHOW_ERROR エラーコードを表示してください。
DWC_ClearError関数を呼び出せば、復帰可能です。
DWC_ETYPE_SHUTDOWN_FM DWC_ShutdownFriendsMatch関数を呼び出して、FriendsMatchライブラリを終了する必要があります。エラーコードを表示してください。
DWC_ETYPE_SHUTDOWN_GHTTP 以下の各ライブラリ解放関数を必要に応じて呼び出してください。
DWC_RnkShutdown関数(汎用ランキングライブラリ)
エラーコードを表示してください。
DWC_ETYPE_SHUTDOWN_ND DWC_NdCleanupAsync関数を呼び出して、ダウンロードライブラリを終了する必要があります。エラーコードを表示してください。
DWC_ETYPE_DISCONNECT 以下の各ライブラリ解放関数を必要に応じて呼び出してください。
DWC_ShutdownFriendsMatch関数(FriendsMatchライブラリ)
DWC_NdCleanupAsync関数(ダウンロードライブラリ)
DWC_RnkShutdown関数(汎用ランキングライブラリ)
その後、DWC_CleanupInetあるいはDWC_CleanupInetAsync関数で通信の切断も行う必要があります。エラーコードを表示してください。
DWC_ETYPE_FATAL FatalError相当なので、Nitroでは、電源OFFを促す必要があります。Twlではリセット(ランチャーへの戻り)を促す必要があります。エラーコードを表示してください。
DWC_ETYPE_NUM

友達の通信状態(GPEnumのStatus+αを再定義して使用)

enum  {
    DWC_STATUS_OFFLINE          =  0,
    DWC_STATUS_ONLINE,
    DWC_STATUS_PLAYING,
    DWC_STATUS_MATCH_ANYBODY,
    DWC_STATUS_MATCH_FRIEND,
    DWC_STATUS_MATCH_SC_CL,
    DWC_STATUS_MATCH_SC_SV,
    DWC_STATUS_NUM,
};
DWC_STATUS_OFFLINE オフライン
DWC_STATUS_ONLINE オンライン(GPサーバにログイン済み)
DWC_STATUS_PLAYING ゲームプレイ中
DWC_STATUS_MATCH_ANYBODY 友達無指定ピアマッチメイク中
DWC_STATUS_MATCH_FRIEND 友達指定ピアマッチメイク中
DWC_STATUS_MATCH_SC_CL サーバクライアントマッチメイク中のクライアント
DWC_STATUS_MATCH_SC_SV サーバクライアントマッチメイク中のサーバ
DWC_STATUS_NUM

友達管理処理状態

enum DWCFriendState {
    DWC_FRIEND_STATE_INIT          =  0,
    DWC_FRIEND_STATE_PERS_LOGIN,
    DWC_FRIEND_STATE_LOGON,
    DWC_FRIEND_STATE_NUM,
};
DWC_FRIEND_STATE_INIT 初期状態
DWC_FRIEND_STATE_PERS_LOGIN Persistentサーバログイン&友達リスト同期処理中
DWC_FRIEND_STATE_LOGON Persistentサーバログイン後
DWC_FRIEND_STATE_NUM

ローカル友達リストとGPバディリストとの同期処理状態

enum  {
    DWC_BUDDY_UPDATE_STATE_WAIT        =  0,
    DWC_BUDDY_UPDATE_STATE_CHECK,
    DWC_BUDDY_UPDATE_STATE_PSEARCH,
    DWC_BUDDY_UPDATE_STATE_COMPLETE,
    DWC_BUDDY_UPDATE_STATE_NUM,
};
DWC_BUDDY_UPDATE_STATE_WAIT バディリストダウンロード完了待ち
DWC_BUDDY_UPDATE_STATE_CHECK バディリストチェック中
DWC_BUDDY_UPDATE_STATE_PSEARCH プロファイルサーチ中
DWC_BUDDY_UPDATE_STATE_COMPLETE バディリスト同期処理完了
DWC_BUDDY_UPDATE_STATE_NUM

ログイン進行状況列挙子

enum DWCLoginState {
    DWC_LOGIN_STATE_INIT           =  0,
    DWC_LOGIN_STATE_REMOTE_AUTH,
    DWC_LOGIN_STATE_CONNECTING,
    DWC_LOGIN_STATE_GPGETINFO,
    DWC_LOGIN_STATE_GPSETINFO,
    DWC_LOGIN_STATE_CONNECTED,
    DWC_LOGIN_STATE_NUM,
};
DWC_LOGIN_STATE_INIT 初期状態
DWC_LOGIN_STATE_REMOTE_AUTH リモート認証中
DWC_LOGIN_STATE_CONNECTING GPサーバ接続中
DWC_LOGIN_STATE_GPGETINFO GPにloginしたときのlastname取得時
DWC_LOGIN_STATE_GPSETINFO GPに初めてloginしたときのlastname設定
DWC_LOGIN_STATE_CONNECTED コネクト完了状態
DWC_LOGIN_STATE_NUM

DWCネットワーク状態列挙子

enum DWCState {
    DWC_STATE_INIT               =  0,
    DWC_STATE_AVAILABLE_CHECK,
    DWC_STATE_LOGIN,
    DWC_STATE_ONLINE,
    DWC_STATE_MATCHING,
    DWC_STATE_CONNECTED,
    DWC_STATE_NUM,
};
DWC_STATE_INIT 初期状態
DWC_STATE_AVAILABLE_CHECK ゲームの利用可能状況をチェック中
DWC_STATE_LOGIN ログイン処理中
DWC_STATE_ONLINE ログイン完了後オンライン状態
DWC_STATE_MATCHING マッチメイク処理中
DWC_STATE_CONNECTED マッチメイク完了後、メッシュ型ネットワーク構築済み状態
DWC_STATE_NUM

マッチメイク状態列挙子

enum DWCMatchState {
    DWC_MATCH_STATE_INIT                      =  0,
    DWC_MATCH_STATE_CL_WAITING,
    DWC_MATCH_STATE_CL_SEARCH_HOST,
    DWC_MATCH_STATE_CL_WAIT_RESV,
    DWC_MATCH_STATE_CL_SEARCH_EVAL_HOST,
    DWC_MATCH_STATE_CL_NN,
    DWC_MATCH_STATE_CL_GT2,
    DWC_MATCH_STATE_CL_CANCEL_SYN,
    DWC_MATCH_STATE_CL_SYN,
    DWC_MATCH_STATE_CL_SVDOWN_1,
    DWC_MATCH_STATE_CL_SVDOWN_2,
    DWC_MATCH_STATE_CL_SVDOWN_3,
    DWC_MATCH_STATE_CL_SEARCH_GROUPID_HOST,
    DWC_MATCH_STATE_SV_WAITING,
    DWC_MATCH_STATE_SV_OWN_NN,
    DWC_MATCH_STATE_SV_OWN_GT2,
    DWC_MATCH_STATE_SV_WAIT_CL_LINK,
    DWC_MATCH_STATE_SV_CANCEL_SYN,
    DWC_MATCH_STATE_SV_CANCEL_SYN_WAIT,
    DWC_MATCH_STATE_SV_SYN,
    DWC_MATCH_STATE_SV_SYN_WAIT,
    DWC_MATCH_STATE_WAIT_CLOSE,
    DWC_MATCH_STATE_SEARCH_OWN,
    DWC_MATCH_STATE_SV_SYN_CLOSE_WAIT,
    DWC_MATCH_STATE_NUM,
};
DWC_MATCH_STATE_INIT 初期状態
DWC_MATCH_STATE_CL_WAITING 待ち状態
DWC_MATCH_STATE_CL_SEARCH_HOST 空きホスト検索状態(友達無指定の時のみ)
DWC_MATCH_STATE_CL_WAIT_RESV 予約に対するサーバからの返答待ち
DWC_MATCH_STATE_CL_SEARCH_EVAL_HOST 評価する相手ホストを検索中
DWC_MATCH_STATE_CL_NN NATネゴシエーション中
DWC_MATCH_STATE_CL_GT2 GT2コネクション確立中
DWC_MATCH_STATE_CL_CANCEL_SYN サーバクライアントでマッチメイクキャンセル同期調整中
DWC_MATCH_STATE_CL_SYN マッチメイク完了同期調整中
DWC_MATCH_STATE_CL_SVDOWN_1 サーバダウン検出中
DWC_MATCH_STATE_CL_SVDOWN_2 サーバダウン検出中2
DWC_MATCH_STATE_CL_SVDOWN_3 サーバダウン検出中3
DWC_MATCH_STATE_CL_SEARCH_GROUPID_HOST グループIDからホストを検索
DWC_MATCH_STATE_SV_WAITING 待ち状態
DWC_MATCH_STATE_SV_OWN_NN クライアントとのNATネゴシエーション中
DWC_MATCH_STATE_SV_OWN_GT2 クライアントとのGT2コネクション確立中
DWC_MATCH_STATE_SV_WAIT_CL_LINK クライアント同士の接続完了待ち
DWC_MATCH_STATE_SV_CANCEL_SYN サーバクライアントでマッチメイクキャンセル同期調整SYN-ACK待ち
DWC_MATCH_STATE_SV_CANCEL_SYN_WAIT サーバクライアントでマッチメイクキャンセル同期調整終了待ち
DWC_MATCH_STATE_SV_SYN マッチメイク終了同期調整SYN-ACK待ち
DWC_MATCH_STATE_SV_SYN_WAIT マッチメイク終了同期調整終了待ち
DWC_MATCH_STATE_WAIT_CLOSE コネクションクローズ完了待ち
DWC_MATCH_STATE_SEARCH_OWN 自ホスト情報検索中(以前の名称はDWC_MATCH_STATE_CL_SEARCH_OWN)
DWC_MATCH_STATE_SV_SYN_CLOSE_WAIT CLOSEコマンド送信後の待ち時間
DWC_MATCH_STATE_NUM

マッチメイクタイプ列挙子

enum  {
    DWC_MATCH_TYPE_ANYBODY    =  0,
    DWC_MATCH_TYPE_FRIEND,
    DWC_MATCH_TYPE_SC_SV,
    DWC_MATCH_TYPE_SC_CL,
    DWC_MATCH_TYPE_NUM,
};
DWC_MATCH_TYPE_ANYBODY 友達無指定ピアマッチメイク
DWC_MATCH_TYPE_FRIEND 友達指定ピアマッチメイク
DWC_MATCH_TYPE_SC_SV サーバクライアントマッチメイクのサーバ側
DWC_MATCH_TYPE_SC_CL サーバクライアントマッチメイクのクライアント側
DWC_MATCH_TYPE_NUM

締め切りコールバック列挙子

enum DWCSuspendResult {
    DWC_SUSPEND_SUCCESS    =  0,
    DWC_SUSPEND_TIMEOUT,
    DWC_SUSPEND_NUM,
};
DWC_SUSPEND_SUCCESS 正常終了
DWC_SUSPEND_TIMEOUT タイムアウトした(現在、使用されません)
DWC_SUSPEND_NUM

接続形態列挙子

enum DWCTopologyType {
    DWC_TOPOLOGY_TYPE_HYBRID      =  0,
    DWC_TOPOLOGY_TYPE_STAR,
    DWC_TOPOLOGY_TYPE_FULLMESH,
    DWC_TOPOLOGY_TYPE_NUM,
};
DWC_TOPOLOGY_TYPE_HYBRID ハイブリッド型
DWC_TOPOLOGY_TYPE_STAR スター型
DWC_TOPOLOGY_TYPE_FULLMESH フルメッシュ型
DWC_TOPOLOGY_TYPE_NUM

ingamesnチェック結果列挙子

enum DWCIngamesnCheckResult {
    DWC_INGAMESN_NOT_CHECKED    =  0,
    DWC_INGAMESN_VALID          =  1,
    DWC_INGAMESN_INVALID        =  2,
};
DWC_INGAMESN_NOT_CHECKED 未チェック
DWC_INGAMESN_VALID 有効
DWC_INGAMESN_INVALID 無効

任天堂認証サーバへの認証処理の状況を示す列挙型です。

enum DWCNasLoginState {
    DWC_NASLOGIN_STATE_DIRTY       =  0,
    DWC_NASLOGIN_STATE_IDLE,
    DWC_NASLOGIN_STATE_HTTP,
    DWC_NASLOGIN_STATE_SUCCESS,
    DWC_NASLOGIN_STATE_ERROR,
    DWC_NASLOGIN_STATE_CANCELED,
    DWC_NASLOGIN_STATE_MAX,
};
DWC_NASLOGIN_STATE_DIRTY 認証処理が初期化されていません。
DWC_NASLOGIN_STATE_IDLE 認証処理が開始されていません。待機状態です。
DWC_NASLOGIN_STATE_HTTP 認証処理のためのHTTP通信を実行中です。
DWC_NASLOGIN_STATE_SUCCESS 認証処理が成功しました。
DWC_NASLOGIN_STATE_ERROR 認証処理が失敗しました。
DWC_NASLOGIN_STATE_CANCELED 認証処理がキャンセルされました。
DWC_NASLOGIN_STATE_MAX

ダウンロードライブラリステート

enum DWCNdState {
    DWC_ND_STATE_NOTINITIALIZED,
    DWC_ND_STATE_READY,
    DWC_ND_STATE_BUSY,
    DWC_ND_STATE_COMPLETE,
    DWC_ND_STATE_ERROR,
    DWC_ND_STATE_MAX,
};
DWC_ND_STATE_NOTINITIALIZED ダウンロードライブラリが未初期化
DWC_ND_STATE_READY 初期化が完了し、他のダウンロードライブラリ関数が呼べる状態
DWC_ND_STATE_BUSY 非同期処理を実行中
DWC_ND_STATE_COMPLETE 非同期処理が正常に完了した
DWC_ND_STATE_ERROR 非同期処理中にエラーが発生し、完了した
DWC_ND_STATE_MAX

ダウンロードライブラリエラー列挙子

enum DWCNdError {
    DWC_ND_ERROR_NONE,
    DWC_ND_ERROR_ALLOC,
    DWC_ND_ERROR_BUSY,
    DWC_ND_ERROR_HTTP,
    DWC_ND_ERROR_BUFFULL,
    DWC_ND_ERROR_PARAM,
    DWC_ND_ERROR_CANCELED,
    DWC_ND_ERROR_DLSERVER,
    DWC_ND_ERROR_FATAL,
    DWC_ND_ERROR_MAX,
};
DWC_ND_ERROR_NONE 実行中の処理が完了した
DWC_ND_ERROR_ALLOC メモリ確保に失敗した
DWC_ND_ERROR_BUSY 本来その関数を呼び出せないSTATEで呼び出した
DWC_ND_ERROR_HTTP HTTP通信にエラーが発生した
DWC_ND_ERROR_BUFFULL (内部エラー)ダウンロードバッファが足りない
DWC_ND_ERROR_PARAM 不正なパラメータによるエラーが発生した
DWC_ND_ERROR_CANCELED 処理のキャンセルが完了した
DWC_ND_ERROR_DLSERVER サーバがエラーコードを返してきた
DWC_ND_ERROR_FATAL 未定義の致命的なエラーが発生した
DWC_ND_ERROR_MAX

ダウンロードライブラリ進行列挙子

enum DWCNdCallbackReason {
    DWC_ND_CBREASON_INITIALIZE,
    DWC_ND_CBREASON_GETFILELISTNUM,
    DWC_ND_CBREASON_GETFILELIST,
    DWC_ND_CBREASON_GETFILE,
    DWC_ND_CBREASON_CLEANUP,
    DWC_ND_CBREASON_MAX,
};
DWC_ND_CBREASON_INITIALIZE ダウンロードライブラリ初期化中に通知コールバックが呼び出された
DWC_ND_CBREASON_GETFILELISTNUM ダウンロード可能なファイル総数をダウンロード中に通知コールバックが呼び出された
DWC_ND_CBREASON_GETFILELIST ファイル情報一覧をダウンロード中に通知コールバックが呼び出された
DWC_ND_CBREASON_GETFILE ファイルをダウンロード中に通知コールバックが呼び出された
DWC_ND_CBREASON_CLEANUP クリーンアップ完了時に呼び出された
DWC_ND_CBREASON_MAX

不正ネームチェック中のステート

enum DWCProfState {
    DWC_PROF_STATE_NOT_INITIALIZED    =  0,
    DWC_PROF_STATE_OPERATING,
    DWC_PROF_STATE_SUCCESS,
    DWC_PROF_STATE_FAIL,
};
DWC_PROF_STATE_NOT_INITIALIZED 未初期化
DWC_PROF_STATE_OPERATING HTTP通信中
DWC_PROF_STATE_SUCCESS 名前チェック成功
DWC_PROF_STATE_FAIL 名前チェック失敗

不正文字列チェックのリージョンを示す列挙型

enum DWCProfRegion {
    DWC_PROF_REGION_SELF    =  0x00,
    DWC_PROF_REGION_JP      =  0x01,
    DWC_PROF_REGION_US      =  0x02,
    DWC_PROF_REGION_EU      =  0x04,
    DWC_PROF_REGION_KR      =  0x08,
    DWC_PROF_REGION_CN      =  0x10,
    DWC_PROF_REGION_ALL     =  0x80,
};
DWC_PROF_REGION_SELF 製品コードに従う
DWC_PROF_REGION_JP 日本
DWC_PROF_REGION_US 北米
DWC_PROF_REGION_EU 欧州
DWC_PROF_REGION_KR 韓国
DWC_PROF_REGION_CN 中国
DWC_PROF_REGION_ALL 全リージョン

取得するランキングリストの昇順と降順を示す定数

enum  {
    DWC_RNK_ORDER_ASC    = 	0,
    DWC_RNK_ORDER_DES    = 	1,
};
DWC_RNK_ORDER_ASC 昇順
DWC_RNK_ORDER_DES 降順

エラーコード

enum DWCRnkError {
    DWC_RNK_SUCCESS                            =  0,
    DWC_RNK_IN_ERROR,
    DWC_RNK_ERROR_INVALID_PARAMETER,
    DWC_RNK_ERROR_INIT_ALREADYINITIALIZED,
    DWC_RNK_ERROR_INIT_INVALID_INITDATASIZE,
    DWC_RNK_ERROR_INIT_INVALID_INITDATA,
    DWC_RNK_ERROR_INIT_INVALID_USERDATA,
    DWC_RNK_ERROR_PUT_NOTREADY,
    DWC_RNK_ERROR_PUT_INVALID_KEY,
    DWC_RNK_ERROR_PUT_NOMEMORY,
    DWC_RNK_ERROR_GET_NOTREADY,
    DWC_RNK_ERROR_GET_INVALID_KEY,
    DWC_RNK_ERROR_GET_NOMEMORY,
    DWC_RNK_ERROR_CANCEL_NOTASK,
    DWC_RNK_PROCESS_NOTASK,
    DWC_RNK_PROCESS_TIMEOUT,
    DWC_RNK_ERROR_INVALID_MODE,
    DWC_RNK_ERROR_NOTCOMPLETED,
    DWC_RNK_ERROR_EMPTY_RESPONSE,
};
DWC_RNK_SUCCESS 成功
DWC_RNK_IN_ERROR エラー発生中
DWC_RNK_ERROR_INVALID_PARAMETER 不正なパラメーター
DWC_RNK_ERROR_INIT_ALREADYINITIALIZED 初期化済
DWC_RNK_ERROR_INIT_INVALID_INITDATASIZE 不正な初期化データサイズ
DWC_RNK_ERROR_INIT_INVALID_INITDATA 不正な初期化データ
DWC_RNK_ERROR_INIT_INVALID_USERDATA ユーザー情報が不正
DWC_RNK_ERROR_PUT_NOTREADY 初期化されていない
DWC_RNK_ERROR_PUT_INVALID_KEY 暗号化キーが不正
DWC_RNK_ERROR_PUT_NOMEMORY メモリー不足
DWC_RNK_ERROR_GET_NOTREADY 初期化されていない
DWC_RNK_ERROR_GET_INVALID_KEY 暗号化キーが不正
DWC_RNK_ERROR_GET_NOMEMORY メモリー不足
DWC_RNK_ERROR_CANCEL_NOTASK 非同期処理中の処理なし
DWC_RNK_PROCESS_NOTASK 非同期処理中の処理なし
DWC_RNK_PROCESS_TIMEOUT タイムアウト
DWC_RNK_ERROR_INVALID_MODE 不正なモード
DWC_RNK_ERROR_NOTCOMPLETED 通信未完了
DWC_RNK_ERROR_EMPTY_RESPONSE 空のレスポンス

モジュールステータス

enum DWCRnkState {
    DWC_RNK_STATE_NOTREADY       =  0,
    DWC_RNK_STATE_INITIALIZED,
    DWC_RNK_STATE_PUT_ASYNC,
    DWC_RNK_STATE_GET_ASYNC,
    DWC_RNK_STATE_COMPLETED,
    DWC_RNK_STATE_TIMEOUT,
    DWC_RNK_STATE_ERROR,
};
DWC_RNK_STATE_NOTREADY 未初期化状態
DWC_RNK_STATE_INITIALIZED 初期化完了
DWC_RNK_STATE_PUT_ASYNC PUT非同期処理中
DWC_RNK_STATE_GET_ASYNC GET非同期処理中
DWC_RNK_STATE_COMPLETED 完了
DWC_RNK_STATE_TIMEOUT タイムアウト
DWC_RNK_STATE_ERROR エラー発生

リージョンコード

enum DWCRnkRegion {
    DWC_RNK_REGION_JP     =  0x01,
    DWC_RNK_REGION_US     =  0x02,
    DWC_RNK_REGION_EU     =  0x04,
    DWC_RNK_REGION_KR     =  0x08,
    DWC_RNK_REGION_CH     =  0x10,
    DWC_RNK_REGION_CN     =  0x10,
    DWC_RNK_REGION_ALL    =  0xff,
};
DWC_RNK_REGION_JP Japan
DWC_RNK_REGION_US UnitedStates
DWC_RNK_REGION_EU Europe
DWC_RNK_REGION_KR Korea
DWC_RNK_REGION_CH China(旧定義)
DWC_RNK_REGION_CN China
DWC_RNK_REGION_ALL World

履歴

5.2pr1
中国の定義名を修正。旧定義も残されています。
5.1pr2
中国(DWC_RNK_REGION_CH)を追加

DWC_RnkGetScoreAsync取得モード

enum DWCRnkGetMode {
    DWC_RNK_GET_MODE_ORDER,
    DWC_RNK_GET_MODE_TOPLIST,
    DWC_RNK_GET_MODE_NEAR,
    DWC_RNK_GET_MODE_FRIENDS,
    DWC_RNK_GET_MODE_NEAR_HI,
    DWC_RNK_GET_MODE_NEAR_LOW,
};
DWC_RNK_GET_MODE_ORDER 順位
DWC_RNK_GET_MODE_TOPLIST ハイスコア
DWC_RNK_GET_MODE_NEAR 周辺スコア
DWC_RNK_GET_MODE_FRIENDS 友達指定ランキング
DWC_RNK_GET_MODE_NEAR_HI 周辺スコア(自分よりも順位が高い)
DWC_RNK_GET_MODE_NEAR_LOW 周辺スコア(自分よりも順位が低い)

dwcのデバッグ情報出力用フラグ

enum DWCReportFlag {
    DWC_REPORTFLAG_NONE               =  0x00000000,
    DWC_REPORTFLAG_INFO               =  0x00000001,
    DWC_REPORTFLAG_ERROR              =  0x00000002,
    DWC_REPORTFLAG_DEBUG              =  0x00000004,
    DWC_REPORTFLAG_WARNING            =  0x00000008,
    DWC_REPORTFLAG_ACHECK             =  0x00000010,
    DWC_REPORTFLAG_LOGIN              =  0x00000020,
    DWC_REPORTFLAG_MATCH_NN           =  0x00000040,
    DWC_REPORTFLAG_MATCH_GT2          =  0x00000080,
    DWC_REPORTFLAG_TRANSPORT          =  0x00000100,
    DWC_REPORTFLAG_QR2_REQ            =  0x00000200,
    DWC_REPORTFLAG_SB_UPDATE          =  0x00000400,
    DWC_REPORTFLAG_SEND_INFO          =  0x00008000,
    DWC_REPORTFLAG_RECV_INFO          =  0x00010000,
    DWC_REPORTFLAG_UPDATE_SV          =  0x00020000,
    DWC_REPORTFLAG_CONNECTINET        =  0x00040000,
    DWC_REPORTFLAG_AUTH               =  0x01000000,
    DWC_REPORTFLAG_AC                 =  0x02000000,
    DWC_REPORTFLAG_BM                 =  0x04000000,
    DWC_REPORTFLAG_UTIL               =  0x08000000,
    DWC_REPORTFLAG_OPTION_CF          =  0x10000000,
    DWC_REPORTFLAG_OPTION_CONNTEST    =  0x20000000,
    DWC_REPORTFLAG_GAMESPY            =  0x80000000,
    DWC_REPORTFLAG_TEST               =  0x00100000,
    DWC_REPORTFLAG_ALL                =  0xffffffff,
};
DWC_REPORTFLAG_NONE 出力なし
DWC_REPORTFLAG_INFO 情報
DWC_REPORTFLAG_ERROR エラー
DWC_REPORTFLAG_DEBUG デバッグ情報
DWC_REPORTFLAG_WARNING 警告
DWC_REPORTFLAG_ACHECK GameSpyサーバーの利用可能チェック
DWC_REPORTFLAG_LOGIN ログイン関係
DWC_REPORTFLAG_MATCH_NN マッチング-NN関係
DWC_REPORTFLAG_MATCH_GT2 マッチング-GT2関係
DWC_REPORTFLAG_TRANSPORT 送受信関係
DWC_REPORTFLAG_QR2_REQ QR2関係
DWC_REPORTFLAG_SB_UPDATE SB関係
DWC_REPORTFLAG_SEND_INFO 送信情報
DWC_REPORTFLAG_RECV_INFO 受信情報
DWC_REPORTFLAG_UPDATE_SV サーバ更新関係
DWC_REPORTFLAG_CONNECTINET インターネット接続関係
DWC_REPORTFLAG_AUTH 認証関係
DWC_REPORTFLAG_AC アカウント関係
DWC_REPORTFLAG_BM WiFi設定のセーブ・ロード
DWC_REPORTFLAG_UTIL UTIL関係
DWC_REPORTFLAG_OPTION_CF 未使用
DWC_REPORTFLAG_OPTION_CONNTEST 未使用
DWC_REPORTFLAG_GAMESPY Gamespy関係
DWC_REPORTFLAG_TEST
DWC_REPORTFLAG_ALL すべて

履歴

5.2
デバッグ情報出力用フラグに関する説明を追加しました。

サービスロケータ情報取得中のステートを示す列挙型

enum DWCSvlState {
    DWC_SVL_STATE_DIRTY       =  0,
    DWC_SVL_STATE_IDLE,
    DWC_SVL_STATE_HTTP,
    DWC_SVL_STATE_SUCCESS,
    DWC_SVL_STATE_ERROR,
    DWC_SVL_STATE_CANCELED,
    DWC_SVL_STATE_MAX,
};
DWC_SVL_STATE_DIRTY 未初期化
DWC_SVL_STATE_IDLE 処理実行中ではない
DWC_SVL_STATE_HTTP HTTP通信中
DWC_SVL_STATE_SUCCESS トークン取得成功
DWC_SVL_STATE_ERROR トークン取得失敗
DWC_SVL_STATE_CANCELED トークン取得キャンセル
DWC_SVL_STATE_MAX

型定義

typedef DWCAccUserData DWCUserData ログインIDなどが含まれる、プレイヤーごとの個人データです。

この構造体のメンバには直接アクセスしないようにしてください。

typedef DWCAccFriendData DWCFriendData 友達情報格納用の共用体です。

この共用体のメンバには直接アクセスしないようにしてください。