Skip to main content

XMemSetWin32HeapTrackingHooks

Win32 ヒープのメモリ割り当て、再割り当て、解放のためのトラッキング コールバック関数を設定します。

Syntax

Parameters

AllocRoutine   _In_
型: PHEAP_TRACK_ALLOC_ROUTINE
メモリ割り当てのためのトラッキング コールバック関数へのポインター。 ReAllocRoutine   _In_
型: PHEAP_TRACK_REALLOC_ROUTINE
メモリ再割り当てのためのトラッキング コールバック関数へのポインター。 FreeRoutine   _In_
型: PHEAP_TRACK_FREE_ROUTINE
メモリ解放のためのトラッキング コールバック関数へのポインター。

Return value

型: VOID なし。

Remarks

この関数を使用すると、これらのヒープ メモリ操作が呼び出されたときに GDK メモリ マネージャーによって呼び出されるコールバック関数を指定することで、Win32 ヒープのメモリ割り当て、再割り当て、および解放を追跡できます。メモリ操作の追跡の詳細については、診断とメモリ トラッキング を参照してください。
CRT は、CRT にリンクされた DLL/EXE の初期化中およびエントリ ポイントで、いくつかのヒープ割り当てを行います。この初期化はこれらのモジュール内のコードを実行するための前提条件であるため、通常、すべての ヒープ割り当てが発生する前に XMemSetWin32HeapTrackingHooks を呼び出すことはできません。コールバック コードはこの動作を認識し、それに応じて処理する必要があります。
この関数を呼び出す前に、次の対応するトラッキング コールバック関数を実装しておく必要があります: 追跡要件に必要なトラッキング コールバック関数のみを実装するだけでかまいません。ヒープ メモリ操作の追跡を停止するには、この関数を呼び出し、追跡を停止する対応するヒープ メモリ操作に NULL を指定します。 次の例は、トラッキング コールバック関数を定義した後、XMemSetWin32HeapTrackingHooks 関数を使用してこれらのトラッキング コールバック関数へのフックを設定およびクリアします。

Requirements

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

See also

Memory
XMem
最終更新日 2026年8月24日