#include <dwc.h>
DWCRnkError DWC_RnkPutScoreAsync(u32 category,
DWCRnkRegion region,
s32 score,
void *data,
u32 size);| category | ランキングを識別するためのカテゴリーID(0〜DWC_RNK_CATEGORY_MAXまでの数値) |
| region | リージョンコード。DWCRnkRegionの中から一つ指定します。 |
| score | スコア。任意の数値を指定します。 |
| data | ユーザー定義データのバッファへのポインタ |
| size | dataのサイズ(DWC_RNK_DATA_MAX以下) |
| DWC_RNK_SUCCESS | 成功 |
| DWC_RNK_IN_ERROR | エラー発生中 |
| DWC_RNK_ERROR_PUT_NOTREADY | 通信準備ができていない |
| DWC_RNK_ERROR_INVALID_PARAMETER | 不正なパラメータ |
| DWC_RNK_ERROR_PUT_INVALID_KEY | 暗号化キーが不正 |
| DWC_RNK_ERROR_PUT_NOMEMORY | メモリー不足 |
スコアを登録する非同期処理を開始します。同時に実行できる非同期処理は1つのみです。複数の非同期処理を実行しようとした場合はDWC_RNK_ERROR_PUT_NOTREADYが返されます。
非同期処理中は、定期的にDWC_RnkProcess関数を呼び出してください。処理中はDWC_RnkProcess関数がDWC_RNK_SUCCESSを返します。
非同期処理中の進行状況を取得するには、DWC_RnkGetState関数を呼び出してください。
DWC_RnkResGetRow関数で取得するDWCRnkData構造体内のメンバの一部は受信バッファを直接参照しているため、続けて非同期処理を行う場合は必要に応じて退避してください。
ユーザー定義データを使用しない場合は、dataにNULL、sizeに0を指定してください。
dataに指定したユーザー定義データのサイズはサーバ上で4の倍数のサイズに補正されます。例えばsizeに3バイトと指定した場合はダミーデータが1バイト追加され4バイトで記録されます。DWC_RnkResGetRow関数で取得するデータサイズはこの補正後のサイズになります。
5.1pr2より前の変更履歴はこちら