_msize_dbg
Calcule la taille d'un bloc de mémoire dans le tas (version debug uniquement).
size_t _msize_dbg(
void *userData,
int blockType
);
Paramètres
userData
Pointeur vers le bloc de mémoire pour lequel détermine la taille.type de bloc
Type de bloc de mémoire spécifié : _CLIENT_BLOCK ou _NORMAL_BLOCK.
Valeur de retour
En cas de réussite, _msize_dbg retourne la taille (en octets) du bloc de mémoire spécifié ; sinon il retourne NULL.
Notes
_msize_dbg est une version debug de la fonction demsize _.Lorsque _DEBUG n'est pas défini, chaque appel à _msize_dbg est réduit à un appel à _msize._msize et _msize_dbg calculent la taille d'un bloc de mémoire dans le tas de base, mais _msize_dbg ajoute deux fonctionnalités de débogage : Il inclut les mémoires tampons de chaque côté de la partie utilisateur du bloc de mémoire dans la taille retournée et permet des calculs de taille pour des types spécifiques de bloc.
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.Pour plus d'informations sur les différences entre appeler une fonction standard du tas et sa version debug dans une version debug d'une application, consultez À l'aide de la version debug ou la version de base.
Cette fonction valide paramètre.si memblock est un pointeur null, _msize appelle un gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si l'erreur est gérée, la fonction définit errno à EINVAL et retourne -1.
Configuration requise
routine |
en-tête requis |
|---|---|
_msize_dbg |
<crtdbg.h> |
Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.
bibliothèques
Versions debug de Bibliothèques runtime C uniquement.
Exemple
// crt_msize_dbg.c
// compile with: /MTd
/*
* This program allocates a block of memory using _malloc_dbg
* and then calls _msize_dbg to display the size of that block.
* Next, it uses _realloc_dbg to expand the amount of
* memory used by the buffer and then calls _msize_dbg again to
* display the new amount of memory allocated to the buffer.
*/
#include <stdio.h>
#include <malloc.h>
#include <stdlib.h>
#include <crtdbg.h>
int main( void )
{
long *buffer, *newbuffer;
size_t size;
/*
* Call _malloc_dbg to include the filename and line number
* of our allocation request in the header
*/
buffer = (long *)_malloc_dbg( 40 * sizeof(long), _NORMAL_BLOCK, __FILE__, __LINE__ );
if( buffer == NULL )
exit( 1 );
/*
* Get the size of the buffer by calling _msize_dbg
*/
size = _msize_dbg( buffer, _NORMAL_BLOCK );
printf( "Size of block after _malloc_dbg of 40 longs: %u\n", size );
/*
* Reallocate the buffer using _realloc_dbg and show the new size
*/
newbuffer = _realloc_dbg( buffer, size + (40 * sizeof(long)), _NORMAL_BLOCK, __FILE__, __LINE__ );
if( newbuffer == NULL )
exit( 1 );
buffer = newbuffer;
size = _msize_dbg( buffer, _NORMAL_BLOCK );
printf( "Size of block after _realloc_dbg of 40 more longs: %u\n", size );
free( buffer );
exit( 0 );
}
Sortie
Size of block after _malloc_dbg of 40 longs: 160
Size of block after _realloc_dbg of 40 more longs: 320
É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é.