Exporter (0) Imprimer
Développer tout
div
eof
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

_CrtSetAllocHook

Installe une fonction d'allocation définie par le client en l'accrochant dans le processus d'allocation mémoire de débogage du runtime C (version Debug uniquement).

_CRT_ALLOC_HOOK _CrtSetAllocHook(
   _CRT_ALLOC_HOOK allocHook 
);
allocHook

Nouvelle fonction d'allocation définie par le client pour connecter dans le processus d'allocation mémoire du débogage du runtime C.

Renvoie la fonction définie précédemment de raccordement d'allocation, ou NULL si allocHook est NULL.

_CrtSetAllocHook permet à une application de raccorder sa propre fonction d'allocation dans le processus d'allocation de mémoire de bibliothèque de débogage du runtime C. En conséquence, chaque appel à une fonction d'allocation de débogage pour allouer, réallouer, ou supprimer un bloc de mémoire déclenche un appel à la fonction de raccordement de l'application. _CrtSetAllocHook fournit une application avec une méthode simple pour vérifier comment l'application gère les situations de mémoire insuffisante, la capacité d'examiner les modèles d'allocation, et la possibilité d'enregistrer les informations d'allocations pour l'analyse ultérieure. Lorsque _DEBUG n'est pas défini, Les appels de _CrtSetAllocHook sont supprimés pendant le prétraitement.

La fonction _CrtSetAllocHook installe la nouvelle fonction définie par le client d'allocation spécifiée dans allocHook et renvoie la fonction définie précédemment de raccordement. L'exemple suivant montre comment une allocation définie par le client doit être prototypé:

int YourAllocHook( int allocType, void *userData, size_t size, int 
blockType, long requestNumber, const unsigned char *filename, int 
lineNumber);

L'argument allocType spécifie le type d'opération d'allocation, (_HOOK_ALLOC, _HOOK_REALLOCet _HOOK_FREE) qui a déclenché l'appel à la fonction de raccordement d'allocation. Lorsque le type de déclenchement d'allocation est _HOOK_FREE, userData est un pointeur vers la section des données utilisateur du bloc de mémoire qui va être libéré. Toutefois, lorsque le type de déclenchement d'allocation est _HOOK_ALLOC ou _HOOK_REALLOC, userData est NULL car le bloc de mémoire n'a pas encore été alloué.

size spécifie la taille du bloc de mémoire en octets, blockType indique le type du bloc de mémoire, requestNumber est le numéro de commande d'allocation d'objet du bloc de mémoire, et, si disponible, filename et lineNumber spécifiez le nom du fichier et le numéro de ligne source où l'opération de déclenchement d'allocation a été initialisée.

Une fois que la fonction de raccordement a terminé le traitement, elle doit retourner une valeur booléenne, qui indique au processus d'allocation principal du runtime C comment continuer. Lorsque la fonction de raccordement souhaite que le processus d'allocation principal continue comme si la fonction de raccordement n'a jamais été appelée, la fonction de raccordement doit renvoyer TRUE. Cela provoque l'opération de déclenchement d'origine d'allocation à être exécuté. En utilisant cette implémentation, la fonction de raccordement peut rassembler et enregistrer des informations d'allocation pour l'analyse ultérieure, sans interférer avec l'opération d'allocation ou l'état actuel de la pile de débogage.

Lorsque la fonction de raccordement souhaite le processus d'allocation principal pour continuer comme si l'opération de déclenchement d'allocation a été appelée et il a échoué, la fonction de raccordement doit retourner FALSE. En utilisant cette implémentation, la fonction de raccordement peut simuler une large gamme d'états de mémoire et des états du tas de débogage pour tester comment l'application gère chaque situation.

Pour désactiver la fonction de raccordement, exécutez NULL à _CrtSetAllocHook.

Pour plus d'informations sur la façon dont _CrtSetAllocHook peut être utilisé avec d'autres fonctions de gestion de la mémoire ou comment écrire vos propres fonctions de raccordement définies par le client, consultez Écriture de fonctions de raccordement de débogage.

RemarqueRemarque

_CrtSetAllocHook n'est pas pris en charge sous /clr:pure.

Routine

En-tête requis

_CrtSetAllocHook

<crtdbg.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Bibliothèques

Seulement les versions debug des bibliothèques Runtime C.

Pour un exemple d'utilisation de _CrtSetAllocHook, consultez crt_dbg2.

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.