_CrtSetDumpClient
Nainstaluje funkci definovanou aplikací na bloky paměti typu výpisu _CLIENT_BLOCK
paměti (pouze ladicí verze).
Syntaxe
_CRT_DUMP_CLIENT _CrtSetDumpClient( _CRT_DUMP_CLIENT dumpClient );
Parametry
dumpClient
Nová funkce výpisu paměti definovaná klientem pro připojení.
Vrácená hodnota
Vrátí dříve definovanou funkci výpisu stavu stavu bloku klienta.
Poznámky
Tato _CrtSetDumpClient
funkce umožňuje aplikaci připojit vlastní funkci k výpisu objektů uložených v _CLIENT_BLOCK
blocích paměti. V důsledku toho se volá také pokaždé, když funkce výpisu stavu ladění, například _CrtMemDumpAllObjectsSince
nebo _CrtDumpMemoryLeaks
vysadí _CLIENT_BLOCK
blok paměti, volá se také funkce výpisu paměti aplikace. _CrtSetDumpClient
poskytuje aplikaci snadnou metodu pro detekci nevracení paměti a ověřování nebo hlášení obsahu dat uložených v _CLIENT_BLOCK
blocích. Pokud _DEBUG
není definováno, volání, která _CrtSetDumpClient
se mají odebrat během předběžného zpracování.
Funkce _CrtSetDumpClient
nainstaluje novou funkci výpisu paměti definovanou aplikací a dumpClient
vrátí dříve definovanou funkci výpisu paměti. Příklad funkce výpisu stavu stavu bloku klienta je následující:
void DumpClientFunction( void *userPortion, size_t blockSize );
Argument userPortion
je ukazatel na začátek části datové části bloku paměti uživatele a blockSize
určuje velikost přiděleného bloku paměti v bajtech. Funkce výpisu stavu paměti bloku klienta musí vrátit void
. Ukazatel na funkci výpisu stavu klienta, která je předána _CrtSetDumpClient
, je typu _CRT_DUMP_CLIENT
, jak je definováno v Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Další informace o funkcích, které pracují s _CLIENT_BLOCK
bloky paměti typu, naleznete v tématu Funkce háku bloku klienta. Funkci _CrtReportBlockType
lze použít k vrácení informací o typech bloků a podtypech.
Požadavky
Rutina | Požadovaný hlavičkový soubor |
---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Další informace o kompatibilitě najdete v tématu Kompatibilita.
Knihovny
Ladění pouze verzí knihoven runtime jazyka C.