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

# PIXRecordMemoryFreeEvent

> PIXRecordMemoryFreeEvent

# PIXRecordMemoryFreeEvent

メモリ解放イベントを記録します。

## 構文

```cpp theme={null}
void PIXRecordMemoryFreeEvent(  
         USHORT allocatorId,  
         void* baseAddress,  
         size_t size,  
         UINT64 metadata  
)  
```

### パラメーター

*allocatorId*   <br />Type: USHORT

メモリ プロファイラーでメモリ割り当てのグループを識別するために使用できる ID です。たとえば、グラフィック、オーディオ、物理演算など、目的別に異なるヒープがある場合、これらの各カテゴリに異なる allocatorID を割り当てることで、PIX でメモリ キャプチャを表示するときに識別しやすくなります。

*baseAddress*   <br />Type: void\*

解放されたメモリの開始アドレスです。

*size*   <br />Type: size\_t

解放されたメモリのサイズ (バイト単位) です。

*metadata*   <br />Type: UINT64

メモリ解放に追加データをタグ付けするために使用できる 64 ビット符号なし整数です。この追加データは PIX の UserData 列に表示されます。この追加データを使用して、たとえば特定のメモリ位置で解放されたタイトル内のオブジェクトの種類を識別できます。`PIXRecordMemoryFreeEvent` に渡す値は、対応する [PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/pixrecordmemoryallocationevent) の呼び出しに渡された値と一致する必要はありません。

### 戻り値

Type: void

## 解説

PIX メモリ追跡イベントは、タイトルのカスタム メモリ アロケーターから行われたすべてのメモリ割り当ておよび解放に関する情報を、メモリ プロファイリング キャプチャで PIX が表示するために必要なデータを提供します。このデータを提供することにより、PIX はカスタム アロケーターについても `VirtualAlloc/VirtualFree` および `HeapAlloc/HeapFree` の呼び出しに対して表示するのと同じデータをすべて表示します。

PIX は、*baseAddress* と *size* パラメーターを使用して対応する割り当てを次のように特定します。*baseAddress* が、対応する [PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/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 本体

## 概念ドキュメント

* [ATG Systems Engagement Checklist](/build/atg-engagement/atg-systems-engagement)

## 関連項目

[PIX カスタム メモリ アロケーター (NDA トピック)](/tools/tools-console/pix/pix-custom-memory-allocators) [PIX API リファレンス](/reference/tools/pix3/pix3_members)<br />[PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/pixrecordmemoryallocationevent)<br />[PIX (NDA トピック)](/tools/tools-console/pix/pix)


## Related topics

- [PIXRecordMemoryAllocationEvent](/ja-jp/reference/tools/pix3/functions/pixrecordmemoryallocationevent.md)
- [PIX3](/ja-jp/reference/tools/pix3/pix3_members.md)
- [game_chat_free_memory_callback](/ja-jp/reference/chat/gamechat2/functions/game_chat_free_memory_callback.md)
- [PartyFreeMemoryCallback](/ja-jp/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md)
- [PFMultiplayerFreeMemoryCallback](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback.md)