_CrtSetDumpClient
Installa una funzione definita dall'applicazione per eseguire il dump dei blocchi di memoria del tipo _CLIENT_BLOCK (solo versione di debug).
_CRT_DUMP_CLIENT _CrtSetDumpClient(
_CRT_DUMP_CLIENT dumpClient
);
Parametri
- dumpClient
Nuova funzione definita dal client del dump della memoria da associare nel processo del dump della memoria di debug CRT.
Valore restituito
Restituisce la funzione definita precedentemente dal client dal dump del blocco.
Note
La funzione _CrtSetDumpClient consente all'applicazione di associare la relativa funzione per eseguire il dump degli oggetti memorizzati in blocchi di memoria _CLIENT_BLOCK nel processo del dump della memoria di debug CRT. Pertanto, ogni volta che una funzione di dump di debug come _CrtMemDumpAllObjectsSince o _CrtDumpMemoryLeaks esegue il dump di un blocco di memoria _CLIENT_BLOCK, viene chiamata la funzione di dump dell'applicazione. _CrtSetDumpClient fornisce un'applicazione con un metodo semplice di rilevamento delle perdite di memoria e di convalida o creazione del contenuto dei dati memorizzati in blocchi _CLIENT_BLOCK. Quando _DEBUG non è definito, le chiamate a _CrtSetDumpClient vengono rimosse durante la pre-elaborazione.
La funzione di _CrtSetDumpClient configura la nuova funzione di dump definita dall'applicazione specificata in dumpClient e restituisce la funzione di dump già definita. Segue un esempio di funzione di dump dei blocchi definita dal client:
void DumpClientFunction( void *userPortion, size_t blockSize );
L'argomento userPortion è un puntatore all'inizio della parte di dati utente del blocco di memoria e blockSize specifica le dimensioni del blocco di memoria allocato in byte. La funzione di dump di blocchi client deve restituire void. Il puntatore alla funzione di dump del client passata a _CrtSetDumpClient è del tipo _CRT_DUMP_CLIENT, come definito in Crtdbg.h:
typedef void (__cdecl *_CRT_DUMP_CLIENT)( void *, size_t );
Per ulteriori informazioni sulle funzioni che operano sui blocchi di memoria di _CLIENT_BLOCK, consultare Funzioni hook del blocco client. La funzione _CrtReportBlockType può essere utilizzata per restituire informazioni sui tipi di blocco e i sottotipi.
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_CrtSetDumpClient |
<crtdbg.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
Librerie
Solo versioni di debug di Librerie di runtime C.
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.