> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ConfigurePMCs

> ConfigurePMCs

# ConfigurePMCs

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

## 構文

```cpp theme={null}
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](https://docs.xbox.com/ja-jp/reference/tools/pix3/functions/getpmcvalue.md) を使用してカウントを取得するときの両方で使用します。

| 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 本体

## 関連項目

[ConfigureL2IPMCs](https://docs.xbox.com/ja-jp/reference/tools/pix3/functions/configurel2ipmcs.md)\
[ConfigureNBPMCs](https://docs.xbox.com/ja-jp/reference/tools/pix3/functions/configurenbpmcs.md)\
[GetPMCValue](https://docs.xbox.com/ja-jp/reference/tools/pix3/functions/getpmcvalue.md)\
[PIX (NDA トピック)](https://docs.xbox.com/ja-jp/tools/tools-console/pix/pix.md)\
[XBOX 上の PIX3](https://docs.xbox.com/ja-jp/reference/tools/pix3/pix3_members.md)


## Related topics

- [ConfigureNBPMCs](https://docs.xbox.com/ja-jp/reference/tools/pix3/functions/configurenbpmcs.md)
- [ConfigureL2IPMCs](https://docs.xbox.com/ja-jp/reference/tools/pix3/functions/configurel2ipmcs.md)
- [GetPMCValue](https://docs.xbox.com/ja-jp/reference/tools/pix3/functions/getpmcvalue.md)
- [PIX3 (API の内容)](https://docs.xbox.com/ja-jp/reference/tools/pix3/pix3_members.md)
- [GET (/ext/unattendedsetup/configure)](https://docs.xbox.com/ja-jp/reference/deviceportal/unattendedsetup/uri-extunattendedsetupconfigure-get.md)