DWC_RnkPutScoreAsync

構文

#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より前の変更履歴はこちら