XMemSetWin32HeapTrackingHooks
設定 Win32 堆積之記憶體配置、重新配置和解除配置的追蹤回呼函式。語法
參數
AllocRoutine _In_類型:PHEAP_TRACK_ALLOC_ROUTINE 記憶體配置之追蹤回呼函式的指標。 ReAllocRoutine _In_
類型:PHEAP_TRACK_REALLOC_ROUTINE 記憶體重新配置之追蹤回呼函式的指標。 FreeRoutine _In_
類型:PHEAP_TRACK_FREE_ROUTINE 記憶體解除配置之追蹤回呼函式的指標。
傳回值
類型:VOID 無。備註
此函式可讓您追蹤 Win32 堆積記憶體的配置、重新配置和解除配置,方法是指定回呼函式,在呼叫這些堆積記憶體作業時由 GDK 記憶體管理員叫用。如需追蹤記憶體作業的詳細資訊,請參閱診斷與記憶體追蹤。CRT 會在初始化期間以及與 CRT 連結之 DLL/EXE 的進入點進行數次堆積配置。由於此初始化是執行這些模組內任何程式碼的先決條件,因此通常無法在所有堆積配置發生之前呼叫 XMemSetWin32HeapTrackingHooks。回呼程式碼應留意此行為並適當處理。
- 若要在叫用
HeapAlloc時追蹤配置,請實作 PHEAP_TRACK_ALLOC_ROUTINE 回呼函式。 - 若要在叫用
HeapReAlloc時追蹤重新配置,請實作 PHEAP_TRACK_REALLOC_ROUTINE 回呼函式。 - 若要在叫用
HeapFree時追蹤解除配置,請實作 PHEAP_TRACK_FREE_ROUTINE 回呼函式。
NULL。
下列範例會定義追蹤回呼函式,然後使用 XMemSetWin32HeapTrackingHooks 函式來設定和清除這些追蹤回呼函式的攔截。
需求
標頭: xmem.h 程式庫: xmem.lib 支援的平台: XBOX One 系列主機和 XBOX Series 主機另請參閱
記憶體XMem
