_aligned_msize_dbg
Retourne la taille d'un bloc de mémoire alloué dans le tas (version Debug uniquement).
size_t _aligned_msize_dbg(
void *memblock,
size_t alignment,
size_t offset
);
Paramètres
[in] memblock
Pointeur du bloc de mémoire.[in] alignment
La valeur d'alignement, qui doit être une puissance entière de 2.[in] offset
L'offset dans l'allocation de mémoire pour forcer l'alignement.
Valeur de retour
Retourne la taille (en octets) en entier non signé.
Notes
Les valeurs de alignment et offset doivent être identiques aux valeurs passées à la fonction qui a alloué le bloc.
_aligned_msize_dbg est une version Debug de la fonction _aligned_msize. Lorsque _DEBUG n'est pas défini, chaque appel à _aligned_msize_dbg est réduit à un appel à _aligned_msize. _aligned_msize et _aligned_msize_dbg calculent 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. Si memblock est un pointeur Null ou alignment n'est pas une puissance de 2, _msize appelle un gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'erreur est gérée, cette fonction affecte errno à EINVAL et retourne -1.
Pour obtenir des informations sur la façon dont les blocs de mémoire sont alloués, initialisés, et gérés dans la version Debug du tas de base, consultez Détails du tas de débogage CRT. Pour obtenir des informations sur les types de bloc d'allocation et leur utilisation, consultez Types de blocs sur le tas de débogage. Pour obtenir des informations sur les différences entre appeler une fonction standard du tas et sa version Debug dans une version debug d'une application, consultez Versions Debug des fonctions d'allocation du tas.
Configuration requise
Routine |
En-tête requis |
|---|---|
_aligned_msize_dbg |
<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.
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.