Partilhar via

_aligned_msize

  • Artigo

Retorna o tamanho de um bloco de memória alocado no heap.

Sintaxe

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

Parâmetros

memblock
Ponteiro para o bloco de memória.

alignment
O valor de alinhamento, que deve ser um inteiro elevado à segunda potência.

offset
O deslocamento na alocação de memória para forçar o alinhamento.

Valor retornado

Retorna o tamanho (em bytes) como um inteiro sem sinal.

Comentários

A _aligned_msize função retorna o tamanho, em bytes, do bloco de memória alocado por uma chamada para _aligned_malloc ou _aligned_realloc. Os valores alignment e offset devem ser os mesmos que os valores passados para a função que alocou o bloco.

Quando o aplicativo estiver vinculado a uma versão de depuração das bibliotecas de runtime do C, _aligned_msize será resolvido como _aligned_msize_dbg. Para obter mais informações sobre como o heap é gerenciado durante o processo de depuração, consulte O heap de depuração do CRT.

Esta função valida seu parâmetro. Se memblock for um ponteiro nulo ou alignment não for uma potência de 2, _aligned_msize invocará um manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se o erro for tratado, a função definirá errno como EINVAL e retornará –1.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Rotina Cabeçalho necessário
_aligned_msize <malloc.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas

Todas as versões das bibliotecas em tempo de execução C.

Confira também

Alocação de memória