_aligned_malloc_dbg
Alloue de la mémoire sur une limite d'alignement spécifiée avec l'espace supplémentaire pour un en-tête de débogage et les mémoires tampons de remplacer (version debug uniquement).
void * _aligned_malloc_dbg(
size_t size,
size_t alignment,
const char *filename,
int linenumber
);
Paramètres
[in] size
taille de l'allocation de mémoire demandée.[in] alignment
La valeur d'inscription, qui doit être une puissance entière à 2.[in] filename
Pointeur vers le nom du fichier source qui a demandé l'opération ou NULL d'allocation.[in] linenumber
Numéro de ligne dans le fichier source où l'opération d'allocation a été demandée ou NULL.
Valeur de retour
Un pointeur vers le bloc de mémoire alloué ou à NULL si l'opération a échoué.
Notes
_aligned_malloc_dbg est une version debug de la fonction de _aligned_malloc .Lorsque _DEBUG n'est pas défini, chaque appel à _aligned_malloc_dbg est réduit à un appel à _aligned_malloc._aligned_malloc et _aligned_malloc_dbg allouent un bloc de mémoire dans le tas de base, mais offre d' _aligned_malloc_dbg plusieurs fonctionnalités de débogage : mémoires tampons de chaque côté de la partie utilisateur du bloc à déterminer des fuites, et filename/informations d'linenumber pour déterminer l'origine des demandes d'allocation.
_aligned_malloc_dbg alloue le bloc de mémoire avec un peu plus d'espace que sizedemandé.L'espace supplémentaire est utilisé par le gestionnaire du tas de débogage pour lier les blocs de mémoire de débogage et pour fournir à l'application les informations d'en-tête du débogage et remplacer des mémoires tampons.Lorsque le bloc est alloué, la partie utilisateur du bloc est remplie avec la valeur 0xCD et chacune des mémoires tampons de remplacer est remplie avec 0xFD.
_aligned_malloc_dbg définit errno à ENOMEM si une allocation de mémoire échoue ou si la quantité de mémoire nécessaire (charge mémoire y compris mentionnée précédemment) dépasse _HEAP_MAXREQ.Pour plus d'informations sur ce point et d'autres codes d'erreur, consultez errno, _doserrno, _sys_errlist, et _sys_nerr.en outre, _aligned_malloc_dbg valide ses paramètres.Si alignment n'est pas une puissance de 2 ou size est zéro, cette fonction appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, retourne NULL de cette fonction et définit errno à EINVAL.
Pour plus d'informations sur la manière dont les blocs de mémoire sont alloués, initialisés, et gérés dans la version debug de tas de base, consultez gestion de la mémoire et le tas de débogage.
Pour plus d'informations sur les types de bloc d'allocation et leur utilisation, consultez types de blocs sur le tas de débogage.
Configuration requise
routine |
en-tête requis |
|---|---|
_aligned_malloc_dbg |
<crtdbg.h> |
Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.
bibliothèques
Versions debug de Bibliothèques runtime C uniquement.
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' exemples d'appel de code non managé.