DWC_RnkResGetRow

構文

#include <dwc.h>
DWCRnkError DWC_RnkResGetRow(DWCRnkData *out,
                             u32 index);

引数

out データを取得するDWCRnkData構造体のポインタ
index 取得するインデックス

返り値

DWC_RNK_SUCCESS 成功
DWC_RNK_IN_ERROR エラー発生中
DWC_RNK_ERROR_INVALID_MODE 不正なモード
DWC_RNK_ERROR_INVALID_PARAMETER 不正なパラメータ
DWC_RNK_ERROR_NOTCOMPLETED 通信未完了
DWC_RNK_ERROR_EMPTY_RESPONSE 空のレスポンス

説明

通信で受信したランキングリストから任意の行を抽出して取得します。

取得したデータのバッファは、DWC_RnkShutdown関数が呼ばれるか、次の非同期処理が開始されると解放されます。必要に応じて退避して下さい。

orderフィールドには自分のスコアの行に限り順位が格納されますが、例外としてトップランキングリスト取得モードでは自分のスコアの行にも0が格納されます。

履歴

5.1pr2
orderフィールドに順位が格納される条件を追記

5.1pr2より前の変更履歴はこちら