_aligned_msize

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.

Retornar valor

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 CRT.

Esta função valida seu parâmetro. Se memblock for um ponteiro nulo ou alignment não for um poder de 2, invocará um manipulador de parâmetros inválido, _aligned_msize 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, consulte Estado global na 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