`_aligned_msize_dbg`

Article
10/12/2023

Retourne la taille d’un bloc de mémoire alloué dans le tas (version de débogage uniquement).

Syntaxe

size_t _aligned_msize_dbg(
   void *memblock,
   size_t alignment,
   size_t offset
);

Paramètres

memblock
Pointeur désignant le bloc de mémoire.

alignment
Valeur d'alignement, qui doit être un entier à puissance 2.

offset
Décalage dans l'allocation de mémoire pour forcer l'alignement.

Valeur retournée

Retourne la taille (en octets) sous la forme d’un entier non signé.

Notes

Les valeurs alignment et offset doivent être les mêmes que les valeurs passées à la fonction qui a alloué le bloc.

_aligned_msize_dbg est une version de débogage de la _aligned_msize fonction. Lorsqu’il _DEBUG n’est pas défini, chaque appel à est _aligned_msize_dbg réduit à un appel à _aligned_msize. _aligned_msize et _aligned_msize_dbg calculent toutes deux la taille d’un bloc de mémoire dans le tas de base, mais _aligned_msize_dbg ajoute une fonctionnalité de débogage : elle inclut les mémoires tampons de chaque côté de la partie utilisateur du bloc de mémoire dans la taille retournée.

Cette fonction valide son paramètre. S’il memblock s’agit d’un pointeur Null ou alignment n’est pas une puissance de 2, _msize appelle un gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres. Si l’erreur est gérée, la fonction définit errno sur EINVAL et retourne -1.

Pour plus d’informations sur la façon dont les blocs de mémoire sont alloués, initialisés et gérés dans la version de débogage du tas de base, consultez les détails du tas de débogage CRT. Pour plus d’informations sur les types de blocs d’allocation et leur utilisation, consultez Types de blocs sur le tas de débogage. Pour plus d’informations sur les différences entre les fonctions de tas standard et leurs versions de débogage, consultez Les versions de débogage des fonctions d’allocation de tas.

Spécifications

Routine	En-tête requis
`_aligned_msize_dbg`	<crtdbg.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Uniquement les versions de débogage des bibliothèques Runtime C.

Voir aussi

Allocation de mémoire

Partage via