Win32 API 日本語リファレンス
ホーム › System.AssessmentTool › IProvideWinSATResultsInfo

IProvideWinSATResultsInfo

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDf8334d5d-568e-4075-875f-9df341506640継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

評価の結果に関する情報(たとえば基本スコアや評価を実行した日時など)を取得します。

メソッド 5

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT GetAssessmentInfo(WINSAT_ASSESSMENT_TYPE assessment, IProvideWinSATAssessmentInfo** ppinfo)

評価のサブコンポーネントに関する概要情報を取得します。

assessmentWINSAT_ASSESSMENT_TYPEin概要情報を取得する対象となる評価のサブコンポーネント。指定できる値については、WINSAT_ASSESSMENT_TYPE 列挙型を参照してください。
ppinfoIProvideWinSATAssessmentInfo**outサブコンポーネントのスコアを取得するために使用する IProvideWinSATAssessmentInfo インターフェイス。

戻り値

成功した場合は S_OK を返します。

vtbl 8 HRESULT get_AssessmentState(WINSAT_ASSESSMENT_STATE* state)

評価の状態を取得します。

stateWINSAT_ASSESSMENT_STATE*out評価結果の状態を受け取る WINSAT_ASSESSMENT_STATE へのポインタである。
vtbl 9 HRESULT get_AssessmentDateTime(VARIANT* fileTime)

評価を実行した日時を取得します。

fileTimeVARIANT*out評価が実施された日時を受け取る VARIANT へのポインタである。
vtbl 10 HRESULT get_SystemRating(FLOAT* level)

コンピューターの基本スコアを取得します。

levelFLOAT*outシステムの総合評価(基本スコア)を受け取る FLOAT へのポインタである。

解説(Remarks)

Windows エクスペリエンス インデックス機能は、コンピューターのハードウェア構成の性能を測定し、その測定値を基本スコアと呼ばれる数値で表します。一般に、基本スコアが高いほど、特に高度でリソースを多く消費するタスクを実行する場合に、基本スコアが低いコンピューターよりも高速で優れたパフォーマンスを発揮します。

各ハードウェア コンポーネントには、個別のサブスコアが割り当てられます。コンピューターの基本スコアは、最も低いサブスコアによって決まります。たとえば、個々のハードウェア コンポーネントの最も低いサブスコアが 2.6 の場合、基本スコアは 2.6 になります。基本スコアは、各サブスコアを合わせた平均値ではありません。

基本スコアを利用すれば、コンピューターの基本スコアに見合ったプログラムやその他のソフトウェアを安心して購入できます。たとえば、コンピューターの基本スコアが 3.3 の場合、このバージョンの Windows 向けに設計され、基本スコア 3 以下のコンピューターを必要とするソフトウェアであれば、安心して購入できます。

CPU など、評価のサブコンポーネントのスコアを取得するには、IProvideWinSATAssessmentInfo::get_Score メソッドを呼び出します。

例

例については、IQueryRecentWinSATAssessment::Info プロパティを参照してください。

vtbl 11 HRESULT get_RatingStateDesc(LPWSTR* description)

評価が有効かどうかを UI で示すために使用できる文字列を取得します。

descriptionLPWSTR*out評価状態を表す説明文字列を受け取るポインタへのポインタである。

解説(Remarks)

評価が有効な場合、この文字列は "Windows Experience Index" になります。そうでない場合は "Windows Experience Index : Unrated" になります。評価が有効かどうかを判断するには、IProvideWinSATResultsInfo::get_AssessmentState メソッドを呼び出します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

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

出力引数: 
#define global IID_IProvideWinSATResultsInfo "{F8334D5D-568E-4075-875F-9DF341506640}"
#usecom global IProvideWinSATResultsInfo IID_IProvideWinSATResultsInfo "{}"
#comfunc global IProvideWinSATResultsInfo_GetAssessmentInfo       7 int,sptr
#comfunc global IProvideWinSATResultsInfo_get_AssessmentState     8 var
#comfunc global IProvideWinSATResultsInfo_get_AssessmentDateTime  9 var
#comfunc global IProvideWinSATResultsInfo_get_SystemRating        10 var
#comfunc global IProvideWinSATResultsInfo_get_RatingStateDesc     11 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。