PIXRecordMemoryFreeEvent
メモリ解放イベントを記録します。構文
パラメーター
allocatorIdType: USHORT メモリ プロファイラーでメモリ割り当てのグループを識別するために使用できる ID です。たとえば、グラフィック、オーディオ、物理演算など、目的別に異なるヒープがある場合、これらの各カテゴリに異なる allocatorID を割り当てることで、PIX でメモリ キャプチャを表示するときに識別しやすくなります。 baseAddress
Type: void* 解放されたメモリの開始アドレスです。 size
Type: size_t 解放されたメモリのサイズ (バイト単位) です。 metadata
Type: UINT64 メモリ解放に追加データをタグ付けするために使用できる 64 ビット符号なし整数です。この追加データは PIX の UserData 列に表示されます。この追加データを使用して、たとえば特定のメモリ位置で解放されたタイトル内のオブジェクトの種類を識別できます。
PIXRecordMemoryFreeEvent に渡す値は、対応する PIXRecordMemoryAllocationEvent の呼び出しに渡された値と一致する必要はありません。
戻り値
Type: void解説
PIX メモリ追跡イベントは、タイトルのカスタム メモリ アロケーターから行われたすべてのメモリ割り当ておよび解放に関する情報を、メモリ プロファイリング キャプチャで PIX が表示するために必要なデータを提供します。このデータを提供することにより、PIX はカスタム アロケーターについてもVirtualAlloc/VirtualFree および HeapAlloc/HeapFree の呼び出しに対して表示するのと同じデータをすべて表示します。
PIX は、baseAddress と size パラメーターを使用して対応する割り当てを次のように特定します。baseAddress が、対応する PIXRecordMemoryAllocationEvent の呼び出しに渡された baseAddress と一致する場合、PIX は単にアドレスを比較して割り当てと解放を対応付けます。この場合、size パラメーターには 0 を渡すことができます。baseAddress が対応する割り当てで指定された値と異なる場合、size パラメーターは 0 以外を指定する必要があります。この場合、PIX は baseAddress と size の両方を使用して対応する割り当てを見つけます。
同時に多数のイベントが発生していたり、システムが高負荷状態にあると、メモリ イベントが Event Tracing for Windows (ETW) によって失われる可能性があります。イベントの損失は、データ分析の不完全性につながります。PIX のメモリ キャプチャ UI にはイベント損失を示す警告が表示されます。
要件
ヘッダー: pixmemory.h ライブラリ: pixevt.lib サポートされているプラットフォーム: XBOX One ファミリ本体および XBOX Series 本体概念ドキュメント
関連項目
PIX カスタム メモリ アロケーター (NDA トピック) PIX API リファレンスPIXRecordMemoryAllocationEvent
PIX (NDA トピック)