Win32 API 日本語リファレンス
ホーム › Gaming › IGameStatistics

IGameStatistics

COM
IID3887c9ca-04a0-42ae-bc4c-5fa6c7721145継承元IUnknown自前メソッド開始 vtbl3

メソッド 12

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetMaxCategoryLength(DWORD* cch)
cchDWORD*outカテゴリタイトルの最大文字数を受け取る出力先である。
vtbl 4 HRESULT GetMaxNameLength(DWORD* cch)
cchDWORD*out統計名の最大文字数を受け取る出力先である。
vtbl 5 HRESULT GetMaxValueLength(DWORD* cch)
cchDWORD*out統計値の最大文字数を受け取る出力先である。
vtbl 6 HRESULT GetMaxCategories(WORD* pMax)
pMaxWORD*outサポートされるカテゴリの最大数を受け取る出力先である。
vtbl 7 HRESULT GetMaxStatsPerCategory(WORD* pMax)
pMaxWORD*out1カテゴリあたりの統計項目の最大数を受け取る出力先である。
vtbl 8 HRESULT SetCategoryTitle(WORD categoryIndex, LPWSTR title)
categoryIndexWORDinタイトルを設定するカテゴリの0始まりインデックスを指定する。
titleLPWSTRin設定するカテゴリタイトル文字列を指定する。
vtbl 9 HRESULT GetCategoryTitle(WORD categoryIndex, LPWSTR* pTitle)
categoryIndexWORDinタイトルを取得するカテゴリの0始まりインデックスを指定する。
pTitleLPWSTR*outカテゴリタイトル文字列を受け取る出力先である。呼出側で解放する。
vtbl 10 HRESULT GetStatistic(WORD categoryIndex, WORD statIndex, LPWSTR* pName, LPWSTR* pValue)
categoryIndexWORDin対象カテゴリの0始まりインデックスを指定する。
statIndexWORDinカテゴリ内の統計項目の0始まりインデックスを指定する。
pNameLPWSTR*inoutoptional統計項目の名前文字列を受け取る出力先である。
pValueLPWSTR*inoutoptional統計項目の値文字列を受け取る出力先である。
vtbl 11 HRESULT SetStatistic(WORD categoryIndex, WORD statIndex, LPWSTR name, LPWSTR value)
categoryIndexWORDin対象カテゴリの0始まりインデックスを指定する。
statIndexWORDinカテゴリ内の統計項目の0始まりインデックスを指定する。
nameLPWSTRin設定する統計項目の名前文字列を指定する。
valueLPWSTRin設定する統計項目の値文字列を指定する。
vtbl 12 HRESULT Save(BOOL trackChanges)
trackChangesBOOLin保存後も変更追跡を継続するかどうかを示す真偽値である。
vtbl 13 HRESULT SetLastPlayedCategory(DWORD categoryIndex)
categoryIndexDWORDin最後にプレイしたカテゴリとして記録するインデックスを指定する。
vtbl 14 HRESULT GetLastPlayedCategory(DWORD* pCategoryIndex)
pCategoryIndexDWORD*out最後にプレイしたカテゴリのインデックスを受け取る出力先である。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IGameStatistics "{3887C9CA-04A0-42AE-BC4C-5FA6C7721145}"
#usecom global IGameStatistics IID_IGameStatistics "{DBC85A2C-C0DC-4961-B6E2-D28B62C11AD4}"
#comfunc global IGameStatistics_GetMaxCategoryLength    3 var
#comfunc global IGameStatistics_GetMaxNameLength        4 var
#comfunc global IGameStatistics_GetMaxValueLength       5 var
#comfunc global IGameStatistics_GetMaxCategories        6 var
#comfunc global IGameStatistics_GetMaxStatsPerCategory  7 var
#comfunc global IGameStatistics_SetCategoryTitle        8 int,wstr
#comfunc global IGameStatistics_GetCategoryTitle        9 int,var
#comfunc global IGameStatistics_GetStatistic            10 int,int,var,var
#comfunc global IGameStatistics_SetStatistic            11 int,int,wstr,wstr
#comfunc global IGameStatistics_Save                    12 int
#comfunc global IGameStatistics_SetLastPlayedCategory   13 int
#comfunc global IGameStatistics_GetLastPlayedCategory   14 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。