DWC_RnkGetScoreAsync

構文

#include <dwc.h>
DWCRnkError DWC_RnkGetScoreAsync(DWCRnkGetMode mode,
                                 u32 category,
                                 DWCRnkRegion region,
                                 DWCRnkGetParam *param);

引数

mode 取得モード
category ランキングを識別するためのカテゴリーID(0〜DWC_RNK_CATEGORY_MAXまでの数値)
region リージョンコード。DWCRnkRegionの中から指定します。国をまたいで集計する場合はOR値を指定します(例:日本と欧州の場合(DWC_RNK_REGION_JP|DWC_RNK_REGION_EU))。
param 取得するための詳細情報を指定するパラメータ。取得モードによって構造体に指定する値が異なります。詳細はDWCRnkGetParam構造体を参照してください。

返り値

DWC_RNK_SUCCESS 成功
DWC_RNK_IN_ERROR エラー発生中
DWC_RNK_ERROR_GET_NOTREADY 通信準備ができていない
DWC_RNK_ERROR_INVALID_PARAMETER 不正なパラメータ
DWC_RNK_ERROR_GET_INVALID_KEY 暗号化キーが不正
DWC_RNK_ERROR_GET_NOMEMORY メモリー不足

説明

スコアを取得する非同期処理を開始します。同時に実行できる非同期処理は1つのみです。複数の非同期処理を実行しようとした場合はDWC_RNK_ERROR_PUT_NOTREADYが返されます。

非同期処理中は、定期的にDWC_RnkProcess関数を呼び出してください。処理中はDWC_RnkProcess関数がDWC_RNK_SUCCESSを返します。

非同期処理中の進行状況を取得するには、DWC_RnkGetState関数を呼び出してください。

DWC_RnkResGetRow関数で取得するDWCRnkData構造体内のメンバの一部は受信バッファを直接参照しているため、続けて非同期処理を行う場合は必要に応じて退避してください。

引数modeに指定する値と取得できる情報
DWC_RNK_GET_MODE_ORDER順位を取得します。結果はDWC_RnkResGetOrder関数で取得します。
DWC_RNK_GET_MODE_TOPLISTランキング上位のリストを取得します。DWC_RnkResGetRowCount関数で取得したリストの行数を取得し、行ごとにDWC_RnkResGetRow関数を呼び出してスコア情報を取得します。
DWC_RNK_GET_MODE_NEAR_HI順位が自分よりも高い周辺のランキングのリストを取得します。DWC_RnkResGetRowCount関数で取得したリストの行数を取得し、行ごとにDWC_RnkResGetRow関数を呼び出してスコア情報を取得します。自分のデータはリストの先頭に付加されます。
DWC_RNK_GET_MODE_NEAR_LOW順位が自分よりも低い周辺のランキングのリストを取得します。DWC_RnkResGetRowCount関数で取得したリストの行数を取得し、行ごとにDWC_RnkResGetRow関数を呼び出してスコア情報を取得します。自分のデータはリストの先頭に付加されます。
DWC_RNK_GET_MODE_NEAR自分のスコアに近い順に指定数のランキングリストを取得します。DWC_RnkResGetRowCount関数で取得したリストの行数を取得し、行ごとにDWC_RnkResGetRow関数を呼び出してスコア情報を取得します。自分のデータはリストの先頭に付加されます。
DWC_RNK_GET_MODE_FRIENDS友達の中(最大DWC_RNK_FRIENDS_MAX(64)個のPIDを指定)でのランキングのリストを取得します。DWC_RnkResGetRowCount関数で取得したリストの行数を取得し、行ごとにDWC_RnkResGetRow関数を呼び出してスコア情報を取得します。自分のデータはリストの先頭に付加されます。

ユーザー定義データを利用して、フリーワードなどの友達同士限定の情報のやり取りをする場合は、ガイドラインに準拠し、友達関係が成立しているか確認した上で表示させる必要があります。

履歴

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