ConfigurePMCs

4 つのハードウェアパフォーマンスモニターカウンター (PMC) を構成し、タイトルがタイトルコードで直接カウンターを読み取れるようにします。

構文

HRESULT ConfigurePMCs(  
         unsigned int eventIndex0,  
         unsigned int eventIndex1,  
         unsigned int eventIndex2,  
         unsigned int eventIndex3  
)  

パラメーター

eventIndex0
Type: unsigned int カウントするイベントのインデックスです。 eventIndex1
Type: unsigned int カウントするイベントのインデックスです。 eventIndex2
Type: unsigned int カウントするイベントのインデックスです。 eventIndex3
Type: unsigned int カウントするイベントのインデックスです。

戻り値

Type: HRESULT 成功またはエラーコードです。

コード	説明
S_OK	成功。
E_INVALIDARG	いずれかのインデックスが範囲外です。
E_ACCESS_DENIED	ドライバーへのアクセスが拒否されました。

解説

イベントをカウントするために直接構成できるハードウェアカウンターが 4 つあります。イベントは以下の表に一覧化されています。イベントのインデックスは、このメソッドで対象イベントを指定するときと、GetPMCValue を使用してカウントを取得するときの両方で使用します。

Index	Event	説明
0	Reserved	予約済み。
1	RetiredSseAvx	リタイアされた SSE/AVX 演算の数。
2	DCacheAccesses	ロードおよびストア参照に対する L1 データキャッシュへのアクセス数。
3	DCacheMisses	L1 データキャッシュでミスした L1 データキャッシュ参照の数。
4	DCacheRefills	キャッシュ不可能なメモリからの L2 キャッシュ (および/またはノースブリッジ) から満たされた L1 データキャッシュのリフィル数。
5	L1DTLBMissL2DTLBHit	L1 DTLB でミスし L2 DTLB でヒットした L1 データキャッシュアクセスの数。
6	DtlbMiss	L1 および L2 DTLB のどちらでもミスした L1 データキャッシュアクセスの数。
7	L1DtlbHit	L1 DTLB でヒットした L1 データキャッシュアクセスの数。
8	L1ITLBMissL2ITLBHit	L1 ITLB でミスし L2 ITLB でヒットした命令フェッチの数。
9	ItlbMiss	4K ITLB と 2M ITLB のどちらでもミスした命令フェッチの数。
10	ItlbInstructionFetchHits	4K ITLB と 2M ITLB でヒットした命令フェッチの数。
11	MisalignedAccess	位置が揃っていない L1 データキャッシュアクセスの数。位置揃えされていないアクセスは、読み取り時に少なくとも余分なキャッシュアクセスと 1 サイクル分のレイテンシを発生させます。
12	IneffectiveSWPrefetches	実際の L1 データキャッシュリフィルを引き起こさなかったソフトウェアプリフェッチの数。
13	CpuClkNotHalted	CPU がホルト状態でないクロックの数。
14	RetiredInstructions	リタイア (実行完了し、アーキテクチャ状態が更新) された命令の数。例外および割り込みも含まれます。
15	BranchInstructions	リタイアされた分岐命令の数。例外や割り込みを含む、あらゆる種類のアーキテクチャ制御フロー変更が含まれます。
16	MispredictedBranch	ターゲットまたは方向のいずれかで正しく予測されなかった、任意の種類のリタイア済み分岐命令の数。予測を試みない分岐 (ファー制御転送、例外、割り込み) も含まれ、リシンクは除外されます。
17	RetiredTakenBranch	リタイアされた分岐成立の数。例外および割り込みを含む、あらゆる種類のアーキテクチャ制御フロー変更が含まれ、リシンクは除外されます。
18	RetiredFarSyscall	リタイアされたファー syscall の数。
19	RetiredNearReturns	リタイアされたニアリターン命令の数。
20	RetiredReturnsMispredicted	ターゲットまたは方向で誤って予測されたニアリターン命令がリタイアしました。
21	MispredictedTakenBranch	分岐先アドレスで誤って予測された (方向は誤りでない) 分岐成立命令がリタイアしました。
22	MmxFPInstructions	浮動小数点 (x87、MMX、または SSE) 命令がリタイアしました。
23	RetiredFPInstructions	リタイアされた SSE/AVX 演算の数。
24	RetiredMmxInstructions	リタイアされた MMX 演算の数。
25	RetiredSseInstructions	リタイアされた SSE 演算の数。
26	InstructionFetchStalls	命令フェッチエンジンがストールしたサイクル数。
27	DataCachePrefetches	L1 データキャッシュのプリフェッチ数。
28	DataCacheReadSize	L1 データキャッシュの読み取り数。
29	DataCacheWriteSize	L1 データキャッシュの書き込み数。
30	ITLBReloadStalls	フェッチエンジンが ITLB リロードのためにストールしたサイクル数。

要件

ヘッダー: pix3.h ライブラリ: pixevt.lib サポートされているプラットフォーム: XBOX One ファミリ本体および XBOX Series 本体

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

ConfigurePMCs

ConfigurePMCs

構文

パラメーター

戻り値

解説

要件

関連項目

​ConfigurePMCs

​構文

​パラメーター

​戻り値

​解説

​要件

​関連項目

ConfigurePMCs

構文

パラメーター

戻り値

解説

要件

関連項目