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

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

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