Skip to main content

XMemSetWin32HeapTrackingHooks

Win32 힙의 메모리 할당, 재할당 및 할당 해제에 대한 추적 콜백 함수를 설정합니다.

구문

매개 변수

AllocRoutine   _In_
형식: PHEAP_TRACK_ALLOC_ROUTINE
메모리 할당에 대한 추적 콜백 함수에 대한 포인터입니다. ReAllocRoutine   _In_
형식: PHEAP_TRACK_REALLOC_ROUTINE
메모리 재할당에 대한 추적 콜백 함수에 대한 포인터입니다. FreeRoutine   _In_
형식: PHEAP_TRACK_FREE_ROUTINE
메모리 할당 해제에 대한 추적 콜백 함수에 대한 포인터입니다.

반환 값

형식: VOID 없음.

설명

이 함수를 사용하면 이러한 힙 메모리 작업이 호출될 때 GDK 메모리 관리자에 의해 호출되는 콜백 함수를 지정하여 Win32 힙 메모리 할당, 재할당 및 할당 해제를 추적할 수 있습니다. 메모리 작업 추적에 대한 자세한 내용은 진단 및 메모리 추적을 참조하세요.
CRT는 CRT와 연결된 DLL/EXE의 초기화 및 진입점 동안 여러 힙 할당을 수행합니다. 이 초기화는 이러한 모듈 내의 코드 실행에 대한 전제 조건이므로, 모든 힙 할당이 발생하기 전에 XMemSetWin32HeapTrackingHooks를 호출하는 것은 일반적으로 불가능합니다. 콜백 코드는 이 동작을 인식하고 이에 따라 적절히 처리해야 합니다.
이 함수를 호출하기 전에 먼저 다음 해당 추적 콜백 함수를 구현해야 합니다. 추적 요구 사항에 필요한 추적 콜백 함수만 구현하면 됩니다. 힙 메모리 작업 추적을 중지하려면 이 함수를 호출하고 추적을 중지하려는 해당 힙 메모리 작업에 대해 NULL을 지정합니다. 다음 예제에서는 추적 콜백 함수를 정의한 다음 XMemSetWin32HeapTrackingHooks 함수를 사용하여 해당 추적 콜백 함수에 대한 후크를 설정하고 지웁니다.

요구 사항

헤더: xmem.h 라이브러리: xmem.lib 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

메모리
XMem
마지막 수정일 2026년 8월 24일